[TOC]
This project man target is to translate an old Fortran77 application, to a new Python language. OOP technology need to be used in the final project output. Source code for Fortran77 is included in this application documents.
Fortran source code
| Folder | Files Count | Lines Count |
|---|---|---|
| Cab | 19 | 4,636 |
| Cycle | 17 | 9,112 |
| Menu | 39 | 20,656 |
| cyc600a | 1 | 173 |
| User Manual | 1 | 1 |
| Total | 77 | 34,578 |
- Convert an application, from old Fortran77 to Python.
- Translate the source-code language of CERA from Fortran to Python. This should include testing and verification of the translation to ensure that source code operates effectively under the new version. Deliverable: A source code of CERA converted to python
- Improve and change the source-code architecture to Object-Oriented Programing Deliverable: A source code converted to an object-oriented programming
- Develop a simplified text input interface using simplified text editors or Microsoft Excel and a simplified output format using a comma- or tab-delimited format that can be read in different tools (text editors or Microsoft Excel) Deliverable: The text input and output interfaces using simplified text editors or Microsoft Excel completed
Cycle Solver is a solver in Python for refrigerator cycle. it contains a group of class as shown in graph:
To make the output of Python application debug is more simple, the main function names and variable name will be the same in Python application. It is not normal to use caps for variable names in Python, but we used caps variables name, to be similar as the Fortran source. Methods name was set in small letters, but the same as function names in Fortran.
CoolProb utility is used as an alternative to Fortran library which do the same task.
Some other Python classes was created as an alternative to old dos function, for example Python FileAcccess class.
Fortran source has some issue, that was clear after transfer application to Python :-
-
Some variables is not used
-
Some calculated values is not used nor printed in reports.
The application is divided into two main parts, namely Cab and Cycle application. Each has its own OOP structure, and inputs and outputs. Some class is used in both application (see /common_classes)
Analyses of the cabinet loads. The steady-state heat inputs to the cabinet section are determined for various configuration refrigerator/freezers, alternative insulation system designs, and specified environment and usage conditions.
| Cab Application OOP structure |
|---|
 |
Determination of the steady-state, instantaneous, refrigeration cycle capacity and power draws. The hourly average cabinet loads and instantaneous refrigeration capacities determine the compressor duty cycle and the corresponding fan powers.
| Cycle Application OOP structure |
|---|
 |
Both application inputs is a CSV file, to make the thing more easy an Excel Sheet(s) was made to each application to enter the inputs, later user will save file as CSV for application to run. Output also is a CSV files that is created by application and could be browsed by simple text editor or by Excel.
Folder (data) was created as the preferred location for data inputs/output for both application, but user can select his/her preferred folder name and file name. User has to follow the given structure for the inputs file as the sample in data folder, or application will raise an error.
| Function | File Name / Location | Folder | Comment |
|---|---|---|---|
| Cab Input | cab_dat.csv | data | cab_input_R13.xlsx, in folder (input_intertface) |
| Cab Output | cab_out.csv | data | |
| cab4cyc_out.csv | data | created as an input for Cycle | |
| Cycle Input | cycle_dat.csv | data | cyc_input_R11.xlsx, in folder (input_interface) |
| and cab4cyc_out.csv | data | came from Cab output. | |
| Cycle Output | cycle_out.csv | data |
Step 01: Check folder input_interface and adjust the input for Cab or/and Cycle application using cab_input.xlsx for Cab, or cyc_input.xlsx for cycle application.
Step 02: Save file as *.csv file in data folder, with name as listed in the above table.
Step 03: Alterative option is to use Excel or normal some text editor to edit csv files. In case it is required to use another file name in another folder other than the default, you need to edit the running script to point to the required file and/or folder (see below).
Step 04: Run the related script.
Step 05: If no error in input data, Cab and Cycle or (app to run both in one script) application will create csv for output. default name for output csv files will be as listed in the above table, or other name if user edit the running script as mentioned in Step 03.
Edit Running application
Edit app_start script to point to input and output files for both Cab and Cycle application, the variable is found in other scripts cab_start or Run Cycle application cycle_start
FILE_CAB_INPUT = "cab_dat.csv" # input file for cabinit module
FILE_CAB_OUTPUT = "cab_out.csv" # output file for cabinit module
FILE_CAB2CYC = "cab2cyc_out.csv" # output file for cabinit module
FILE_CYC_INPUT = "cycle_dat.csv" # input file for cycle module
FILE_CYC_OUTPUT = "cycle_out.csv" # output file for cycle module
# rest script code There is tow applications, and one script to run both application is sequence. so it takes the output of Cab application and send it as an input to Cycle application.
Run application: use cab_start or Run Cycle application cycle_start
Run both by one script use app_start
List of all application files with approximate 14,573 lines count .
| File Name | Class Description | Lines Count (approximate) |
|---|---|---|
| CabData.py | Reads data from input file, and save it in QData object (in common classes) | 417 |
| CabUtils.py | Utility to Cab calculation | 131 |
| DoorOpen.py | Utility to Cab calculation for Qlxxx classes | 427 |
| QCtrl.py | Class to select the required class to use according to inputs flag | 736 |
| Ql13.py | Cab calculation for types mode 1 & 3 | 526 |
| Ql2.py | Cab calculation for types mode 2 | 745 |
| Ql467.py | Cab calculation for types mode 1, 4, 6, 7 | 493 |
| Ql5.py | Cab calculation for types mode 5 | 275 |
| Ql8.py | Cab calculation for types mode 8 | 501 |
| Start.py | Start class for Cab application | 237 |
| View.py | Cab reporter | 1,218 |
| Volume.py | Cab calculation for Volume | 292 |
| Total | 5,998 |
| File Name | Class Description | Lines Count (approximate) |
|---|---|---|
| CabData.py | Read input data for cycle, came from Cab application | 383 |
| CompMap.py | Compressor Map utility | 420 |
| Compressor.py | Compressor calculations | 468 |
| Condenser.py | Condenser calculations | 1,077 |
| CoolPrp.py | Call CoolProp utility | 238 |
| CoolPrpUtil.py | Utility function for CoolPrp class | 83 |
| CycData.py | Read input data for cycle | 383 |
| CycleSolver.py | Main cycle solver | 1,290 |
| CycleType.py | Cycle solver utility | 447 |
| CycleUtils.py | Cycle solver utility | 893 |
| ErrorException.py | Error handler | 20 |
| Evaporator.py | Evaporator calculations | 834 |
| exf4Cond_Evap.py | Utility for heat exchanger | 106 |
| ShowInput.py | Print information, input, PID and others | 264 |
| Start.py | Start class for Cycle application | 176 |
| Trace.py | Used to select to print or not a group(s) of point, that print data in a selected places | 196 |
| View.py | Cycle reporter | 645 |
| Total | 7,540 |
| File Name | Class Description | Lines Count (approximate) |
|---|---|---|
| DataModelBuiler.py | Parent class from other class to read csv files and save data to python QDATA class | 325 |
| FileAccess.py | Read & writes to csv files. | 242 |
| Unit.py | Control to convert between Britch and SI units. | 194 |
| QData.py | Class to save data from csv file(s). | 274 |
| Total | 1,035 |