Files generated by the CEA
- Author:
Sreepathi Bhargava Krishna
- Date:
04-May-2017
This guide provides information about the files generated by the CEA. The files generated by CEA are saved
in the following location <SCENARIO>\outputs\data. In this folder, there are individual folders
corresponding to demand, optimization, potentials, solar-radiation, uncertainty. These folders
are generated during every successful run corresponding to the function, i.e. demand folder is generated
when CityEnergyAnalyst\cea\demand\demand_main.py file is run.
The variable <SCENARIO> is used throughout this document to reference the path to a CEA scenario folder, e.g. the
folder baseline in the sample reference case shipped with the CEA.
The variable <BUILDINGNAME> is used throughout this document to reference the name of a single building in the
scenario.
Demand
This section deals with the files saved in <SCENARIO>\outputs\data\demand
- File Names:
<BUILDINGNAME>.csv,Total_demand.csv- Rewritten:
These files are only rewritten when the
CityEnergyAnalyst\cea\demand\demand_file.pyis run- Origin:
All files originate from
CityEnergyAnalyst\cea\demand\demand_writers.py
<BUILDINGNAME>.csvfile has a header row and one row for each hour of the your.It has 46 columns corresponding to the following fields:
DATENamepeopleQEf_kWhQHf_kWhQCf_kWhEf_kWhQhsf_kWhQhs_kWhQhsf_lat_kWhQwwf_kWhQww_kWhQcsf_kWhQcs_kWhQcsf_lat_kWhQcdataf_kWhQcref_kWhQcprof_kWhQhprof_kWhEdataf_kWhEalf_kWhEaf_kWhElf_kWhEref_kWhEauxf_kWhEauxf_ve_kWhEauxf_hs_kWhEauxf_cs_kWhEauxf_ww_kWhEauxf_fw_kWhEprof_kWhEcaf_kWhmcphsf_kWperCmcpcsf_kWperCmcpwwf_kWperCmcpdataf_kWperCmcpref_kWperCTwwf_sup_CTwwf_re_CThsf_sup_CThsf_re_CTcsf_sup_CTcsf_re_CTcdataf_re_CTcdataf_sup_CTcref_re_CTcref_sup_C
Total_demand.csvhas a header row and one row for each building involved in simulation.It has 61 columns corresponding to the following fields:
NameAf_m2Aroof_m2GFA_m2people0Eref_MWhyrEauxf_cs0_kWEauxf_ve0_kWEdataf0_kWQcprof_MWhyrQhprof_MWhyrEcaf0_kWQhsf0_kWQww0_kWQHf0_kWEauxf_hs0_kWEprof_MWhyrEauxf_ve_MWhyrQcs0_kWQcsf_lat0_kWQcprof0_kWQhprof0_kWQEf_MWhyrEf0_kWEauxf_hs_MWhyrEprof0_kWEalf_MWhyrQhsf_lat0_kWQhsf_MWhyrQwwf_MWhyrEcaf_MWhyrQcs_MWhyrQhs_MWhyrEauxf_cs_MWhyrEaf0_kWQcref0_kWEdataf_MWhyrEalf0_kWEauxf_fw_MWhyrEauxf_MWhyrQhs0_kWEauxf_ww_MWhyrQcsf_MWhyrQwwf0_kWQCf0_kWQww_MWhyrQcsf_lat_MWhyrQcdataf0_kWQcsf0_kWQcdataf_MWhyrEauxf_fw0_kWQCf_MWhyrEauxf0_kWQEf0_kWElf0_kWEaf_MWhyrQHf_MWhyrQhsf_lat_MWhyrEauxf_ww0_kWQcref_MWhyrEref0_kWElf_MWhyrEf_MWhyr
Optimization
This section deals with the different files saved in <SCENARIO>\outputs\data\optimization.
The folders present inside this are:
disconnected
master
network
totals
slave
substations
The variable <GENERATIONNUMBER> refers to the unique generation number assigned during the optimization process.
The variable <CONFIGURATION> refers to the unique configuration assigned during the optimization process.
The encoding of the <CONFIGURATION> represents the following:
+===============+========+=========================================+
| Index in list | Value | Description |
+===============+========+=========================================+
| 0 | 0 | CHP off |
| +——–+—————————————–+
| | 1 | Furnace wet ON |
| +——–+—————————————–+
| | 2 | Furnace dry ON |
| +——–+—————————————–+
| | 3 | CHP NG ON |
| +——–+—————————————–+
| | 4 | CHP BG ON |
+—————+——–+—————————————–+
| 1 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘0’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 2 | 0 | Base boiler OFF |
| +——–+—————————————–+
| | 1 | Base boiler ON |
+—————+——–+—————————————–+
| 3 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘2’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 4 | 0 | Peak boiler OFF |
| +——–+—————————————–+
| | 1 | Peak boiler ON |
+—————+——–+—————————————–+
| 5 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘4’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 6 | 0 | HP Lake OFF |
| +——–+—————————————–+
| | 1 | HP Lake ON |
+—————+——–+—————————————–+
| 7 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘6’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 8 | 0 | HP Sewage OFF |
| +——–+—————————————–+
| | 1 | HP Sewage ON |
+—————+——–+—————————————–+
| 9 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘8’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 10 | 0 | GHP OFF |
| +——–+—————————————–+
| | 1 | GHP ON |
+—————+——–+—————————————–+
| 11 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘10’, truncated to two |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 12 | 0 | Heat Recovery Data Centre OFF |
| +——–+—————————————–+
| | 1 | Heat Recovery Data Centre ON |
+—————+——–+—————————————–+
| 13 | 0 to 1 | Capacity share (of overall requirement) |
| | | of index ‘12’, truncated to two | |
| | | decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 14 | 0 | PV OFF |
| +——–+—————————————–+
| | 1 | PV ON |
+—————+——–+—————————————–+
| 15 | 0 to 1 | Area share (of the total allocated area |
| | | for solar) of index ‘14’, truncated to |
| | | two decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 16 | 0 | PVT OFF |
| +——–+—————————————–+
| | 1 | PVT ON |
+—————+——–+—————————————–+
| 17 | 0 to 1 | Area share (of the total allocated area |
| | | for solar) of index ‘16’, truncated to |
| | | two decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 18 | 0 | SC OFF |
| +——–+—————————————–+
| | 1 | SC ON |
+—————+——–+—————————————–+
| 19 | 0 to 1 | Area share (of the total allocated area |
| | | for solar) of index ‘18’, truncated to |
| | | two decimals. ‘0’ meaning OFF |
+—————+——–+—————————————–+
| 20 | 0 to 1 | Area share allocated to solar in the |
| | | total available built area |
+—————+——–+—————————————–+
| 21 onwards | 0 or 1 | For all buildings (following the order |
| | | given in Total_demand.csv), ‘0’ if |
| | | the building is disconnected from DHN, |
| | | ‘1’ if connected. |
| | | This is the <BUILDINGNETWORK> |
+—————+——–+—————————————–+
For example 40.1910.3410.36000000001100000.23001111111000000000010001_PPActivationPattern
Index in list |
Value |
Description |
|---|---|---|
0 |
4 |
CHP BG ON |
1 |
0.19 |
19% of overall heat requirement of network is satisfied by ‘CHP BG’ |
2 |
1 |
Base boiler ON |
3 |
0.34 |
34% of overall heat requirement of network is satisfied by ‘Base Boiler’ |
4 |
1 |
Peak boiler ON |
5 |
0.36 |
36% of overall heat requirement of network is satisfied by ‘Peak Boiler’ |
6 |
0 |
HP Lake OFF |
7 |
0 |
No Share |
8 |
0 |
HP Sewage OFF |
9 |
0 |
No Share |
10 |
0 |
GHP OFF |
11 |
0 |
No Share |
12 |
0 |
Heat Recovery Data Centre OFF |
13 |
0 |
Heat Recovery Compressed Air OFF |
14 |
1 |
PV ON |
15 |
1 |
100% of allocated area is PV i.e 1 * 0.23 * Built Area |
16 |
0 |
PVT OFF |
17 |
0 |
No Share |
18 |
0 |
SC OFF |
19 |
0 |
No Share |
20 |
0.23 |
23% of Built Area is allocated for Solar |
21 onwards |
|
1. Disconnected
- File Names:
DiscOp_<BUILDINGNAME>_result.csv- Rewritten:
Not rewritten
- Origin:
They are being shipped along with the reference case
- Notes:
All the files have a header and 13 rows corresponding to a combination of resources to be used. The combinations are Boiler(Biogas), Boiler(Natural gas), Fuel Cell and 10 combinations of (GHP and Boiler), like 10% GHP and 90% Boiler. It has one column for index and 15 columns corresponding to the following fields:
Annualized Investment Costs [CHF]Best configurationBoilerBG ShareBoilerNG ShareCO2 Emissions [kgCO2-eq]EforGHPFC ShareGHP ShareNominal PowerOperation Costs [CHF]Primary Energy Needs [MJoil-eq]QfromBGQfromGHPQfromNGTotal Costs [CHF]
2. Master
- File Names:
CheckPoint_Initial.file,CheckPoint_<GENERATIONNUMBER>.file,CheckPoint_Final.file- Rewritten:
The files present in this folder are rewritten. If the optimization is run multiple times, the files are constantly replaced with new ones.
- Origin:
All the files in this folder are created in the script
CityEnergyAnalyst\cea\optimization\master\non_dominated_sorting_genetic_algorithm.py
Each of these files have the following fields:
population_fitnessepsIndicatorgenerationtestedPoppopulation
3. Network
- File Names:
Network_summary_result_<BUILDINGNETWORK>.csv,Network_summary_result_all.csv<BUILDINGNETWORK> is the connection between buildings. It is represented with either ‘1’ or ‘0’ per building- Rewritten:
Each file is associated with a <BUILDINGNETWORK>, which in most cases make the file names unique. But there is a probability where the file names match when two <CONFIGURATION>s have the same network
- Origin:
Both the files originate in
CityEnergyAnalyst\cea\optimization\master\summarize_network.py
All the Network_summary_result_<BUILDINGNETWORK>.csv Each of these files has a header plus one row per hour in the
simulated year. Each have an index column and 15 columns corresponding to the following fields:
Ecaf_netw_total_kWhElectr_netw_total_WQ_DC_building_netw_total_WQ_DC_losses_WQ_DH_building_netw_total_WQ_DH_losses_WQcdata_netw_total_kWhT_sst_cool_return_netw_total_KT_sst_cool_supply_netw_total_KT_sst_heat_return_netw_total_KT_sst_heat_supply_netw_total_Kday_of_max_heatmassflowmdot_DH_netw_total_kgpersmdot_cool_netw_total_kgpersmdotdata_netw_total_kWperC
The file Network_summary_result_all.csv has a header row plus one row for each hour in the simulated year.
It has an index column and 15 columns corresponding to the following fields:
Ecaf_netw_total_kWhElectr_netw_total_WQ_DC_building_netw_total_WQ_DC_losses_WQ_DH_building_netw_total_WQ_DH_losses_WQcdata_netw_total_kWhT_sst_cool_return_netw_total_KT_sst_cool_supply_netw_total_KT_sst_heat_return_netw_total_KT_sst_heat_supply_netw_total_Kday_of_max_heatmassflowmdot_DH_netw_total_kgpersmdot_cool_netw_total_kgpersmdotdata_netw_total_kWperC
3.1 Network/Totals
- File Names:
Total_<BUILDINGNETWORK>.csv- Rewritten:
Each file is associated with a <BUILDINGNETWORK>, which in most cases make the file names unique. But there is a probability where the file names match when two <CONFIGURATION>s have the same network
- Origin:
Both the files originate in
CityEnergyAnalyst\cea\optimization\supportFn.py
Total_<BUILDINGNETWORK>.csv has a variable number of rows (based on DHN) and 62 columns (including one for index) with
the following fields:
NameAf_m2Aroof_m2GFA_m2people0Eref_MWhyrEauxf_cs0_kWEauxf_ve0_kWEdataf0_kWQcprof_MWhyrQhprof_MWhyrEcaf0_kWQhsf0_kWQww0_kWQHf0_kWEauxf_hs0_kWEprof_MWhyrEauxf_ve_MWhyrQcs0_kWQcsf_lat0_kWQcprof0_kWQhprof0_kWQEf_MWhyrEf0_kWEauxf_hs_MWhyrEprof0_kWEalf_MWhyrQhsf_lat0_kWQhsf_MWhyrQwwf_MWhyrEcaf_MWhyrQcs_MWhyrQhs_MWhyrEauxf_cs_MWhyrEaf0_kWQcref0_kWEdataf_MWhyrEalf0_kWEauxf_fw_MWhyrEauxf_MWhyrQhs0_kWEauxf_ww_MWhyrQcsf_MWhyrQwwf0_kWQCf0_kWQww_MWhyrQcsf_lat_MWhyrQcdataf0_kWQcsf0_kWQcdataf_MWhyrEauxf_fw0_kWQCf_MWhyrEauxf0_kWQEf0_kWElf0_kWEaf_MWhyrQHf_MWhyrQhsf_lat_MWhyrEauxf_ww0_kWQcref_MWhyrEref0_kWElf_MWhyrEf_MWhyr
4. Slave
- File Names:
<CONFIGURATION>_AveragedCostData.csv,<CONFIGURATION>_InvestmentCostDetailed.csv,<CONFIGURATION>_PrimaryEnergyBySource.csv,<CONFIGURATION>_PPActivationPattern.csv,<CONFIGURATION>_SlaveCostData.csv,<CONFIGURATION>_SlaveDetailedEmissionData.csv,<CONFIGURATION>_SlaveDetailedEprimData.csv,<CONFIGURATION>_SlaveToMasterCostEmissionsPrimE.csv,<CONFIGURATION>_Storage_Sizing_Parameters.csv,<CONFIGURATION>_StorageOperationData.csv- Rewritten:
Highly unlikely to be rewritten as
<CONFIGURATION>is associated with each saved file. Over time this folder will get cluttered with files if the simulations are run multiple times- Origin:
File Name
Originates from
<CONFIGURATION>_AveragedCostDataCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_InvestmentCostDetailedCityEnergyAnalyst\cea\optimization\master\cost_model.py<CONFIGURATION>_PrimaryEnergyBySourceCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_SlaveCostDataCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_SlaveToMasterCostEmissionsPrimECityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_PPActivationPatternCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_SlaveDetailedEmissionDataCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_SlaveDetailedEprimDataCityEnergyAnalyst\cea\optimization\slave\least_cost.py<CONFIGURATION>_Storage_Sizing_ParametersCityEnergyAnalyst\cea\optimization\slave\seasonal_storage\storage_main.py<CONFIGURATION>_StorageOperationDataCityEnergyAnalyst\cea\optimization\slave\seasonal_storage\design_operation.py
<CONFIGURATION>_AveragedCostData.csv has two rows (including header) and 10 columns corresponding to
the following fields:
avgCostAddBoileravgCostBoilerBaseRpkWhavgCostBoilerPeakRpkWhavgCostCCRpkWhavgCostFurnaceRpkWhavgCostGHPRpkWhavgCostHPLakeRpkWhavgCostHPSewRpkWhavgCostStorageOperationavgCostUncontrollableSources
<CONFIGURATION>_InvestmentCostDetailed.csv has two rows (including header) and 23 columns
corresponding to the following fields:
BoilerAddInvCBoilerBInvCostBoilerPInvCostCO2DiscBuildCostDiscBuildDHNInvestCostFurnaceInvCostGasConnectionInvCaHPLakeInvCHPSewInvCNetworkCostPVTHEXCostPVTInvCPrimDiscBuildSCHEXCostSCInvCStorageCostSumStorageHEXCostStorageHPCostStorageInvCSubstHEXCostSumInvestCostpumpCosts
<CONFIGURATION>_PrimaryEnergyBySource.csv has two rows (including header)
It has an index column and 8 columns corresponding to the following fields:
EelExportEelectrImportSlaveEgasPrimaryEgasPrimaryPeakPowerEgroundheatEsolarUsedEwoodPrimarycostBenefitNotUsedHPs
<CONFIGURATION>_SlaveCostData.csvhas two rows (including header).It has an index column and 15 columns corresponding to the following fields:
KEV_RemunerationPPoperation_exclAddBackupcostAddBackup_totalcostBackup_sumcostBoiler_sumcostCC_sumcostFurnace_sumcostGHP_sumcostHPLake_sumcostHPSew_sumcost_Boiler_for_Storage_reHeat_at_seasonendcost_CC_maintenancecost_HP_aux_uncontrollablecost_HP_storage_operationtotal cost
<CONFIGURATION>_SlaveToMasterCostEmissionsPrimE.csv has two rows (including header).
It has an index column and 3 columns corresponding to the following fields:
CO2_kg_eqE_oil_eq_MJcost_sum
<CONFIGURATION>_PPActivationPattern Each of these files has a header plus one row per hour in the simulated year. It has an index column and 35 columns corresponding to the following fields:
BoilerBase_StatusBoilerPeak_StatusCC_StatusCost_AddBoilerCost_BoilerBaseCost_BoilerPeakCost_CCCost_FurnaceCost_GHPCost_HPLakeCost_HPSewESolarProducedPVandPVTE_GHPE_PP_and_storageE_aux_HP_uncontrollableE_consumed_without_buildingdemandE_produced_totalFurnace_StatusGHP_StatusHPLake_StatusHPSew_StatusQ_AddBoilerQ_BoilerBaseQ_BoilerPeakQ_CCQ_FurnaceQ_GHPQ_HPLakeQ_HPSewQ_Network_Demand_after_StorageQ_excessQ_primaryAddBackupSumQ_uncontrollableQ_uncoveredQcold_HPLake
<CONFIGURATION>_SlaveDetailedEmissionData has 2 rows (including header). It has an index column and 14 columns corresponding to the following fields:
CO2_from_AddBoiler_gasCO2_from_BaseBoiler_gasCO2_from_CC_gasCO2_from_GHPCO2_from_HPLakeCO2_from_HPSolarandHearRecoveryCO2_from_HP_StorageOperationChDeChCO2_from_PeakBoiler_gasCO2_from_SCandPVTCO2_from_SewageCO2_from_elec_soldCO2_from_elec_usedAuxBoilersAllCO2_from_fictiveBoilerStorageCO2_from_wood
<CONFIGURATION>_SlaveDetailedEprimData has two rows (including header) It has an index column and 15 columns corresponding to the following fields:
E_prim_from_AddBoiler_gasE_prim_from_BaseBoiler_gasE_prim_from_CC_gasE_prim_from_FictiveBoiler_gasE_prim_from_PeakBoiler_gasEprimSaved_from_elec_sold_CCEprimSaved_from_elec_sold_FurnaceEprimSaved_from_elec_sold_SolarEprim_from_GHPEprim_from_HPLakeEprim_from_HPSolarandHearRecoveryEprim_from_HP_StorageOperationChDeChEprim_from_SewageEprim_from_elec_usedAuxBoilersAllEprim_from_wood
<CONFIGURATION>_Storage_Sizing_fields has two rows (including header) It has an index column and 3 columns corresponding to the following fields:
Q_initialStorage_Size_optT_initial
<CONFIGURATION>_StorageOperationData Each of these files has a header plus one row per hour in the simulated year.It has an index column and 20 columns corresponding to the following fields. This file has few missing values. Reason needs to be investigated
E_PVT_WhE_PV_WhE_aux_HP_uncontrollableE_aux_chE_aux_dechE_consumed_total_without_buildingdemandE_produced_totalHPCompAirDesignArrayHPScDesignArrayHPServerHeatDesignArrayHPpvt_designArrayP_HPCharge_maxQ_DH_networkloadQ_SCandPVT_coldstreamQ_from_storage_usedQ_missingQ_rejected_finQ_storage_content_WhQ_to_storageQ_uncontrollable_hotStorage_Sizemdot_DH_fin
5. Substations
File Names:
<BUILDINGNAME>_resultTotal_linkedbuildings
Rewritten: Most of the files are rewritten in every iteration
Origin:
<BUILDINGNAME>_result originates from CityEnergyAnalyst\cea\technologies\substation.py
Total_linkedbuildings originates from CityEnergyAnalyst\cea\optimization\supportFn.py
Information:
<BUILDINGNAME>_result Each of these files has a header plus one row per hour in the simulated year. It has 20 columns corresponding to the following fields:
A_hex_cool_designA_hex_dhw_designA_hex_heating_designElectr_array_all_flatQ_coolQ_dhwQ_heatingT_heating_max_all_buildings_internT_hotwater_max_all_buildings_internT_r1_dhw_resultT_r1_heating_resultT_return_DC_resultT_return_DH_resultT_supply_DC_resultT_supply_DH_resultT_total_supply_max_all_buildings_internmdot_DC_resultmdot_DH_resultmdot_dhw_resultmdot_heating_result
Total_linkedbuildings a csv file has two rows (including header) and
62 columns (first column corresponding to index) which include the following fields:
NameAf_m2Aroof_m2GFA_m2people0Eref_MWhyrEauxf_cs0_kWEauxf_ve0_kWEdataf0_kWQcprof_MWhyrQhprof_MWhyrEcaf0_kWQhsf0_kWQww0_kWQHf0_kWEauxf_hs0_kWEprof_MWhyrEauxf_ve_MWhyrQcs0_kWQcsf_lat0_kWQcprof0_kWQhprof0_kWQEf_MWhyrEf0_kWEauxf_hs_MWhyrEprof0_kWEalf_MWhyrQhsf_lat0_kWQhsf_MWhyrQwwf_MWhyrEcaf_MWhyrQcs_MWhyrQhs_MWhyrEauxf_cs_MWhyrEaf0_kWQcref0_kWEdataf_MWhyrEalf0_kWEauxf_fw_MWhyrEauxf_MWhyrQhs0_kWEauxf_ww_MWhyrQcsf_MWhyrQwwf0_kWQCf0_kWQww_MWhyrQcsf_lat_MWhyrQcdataf0_kWQcsf0_kWQcdataf_MWhyrEauxf_fw0_kWQCf_MWhyrEauxf0_kWQEf0_kWElf0_kWEaf_MWhyrQHf_MWhyrQhsf_lat_MWhyrEauxf_ww0_kWQcref_MWhyrEref0_kWElf_MWhyrEf_MWhyr
Uncertainty
This section deals with the files in ``<SCENARIO>\outputs\data\uncertainty
File Names: uncertainty.csv, CheckPoint_uncertainty_number.file
Rewritten: The files are rewritten only when CityEnergyAnalyst\cea\analysis\uncertainty\Individual_Evaluation.py,
or CityEnergyAnalyst\cea\analysis\uncertainty\Uncertainty_parameters.py are run
Origin:
uncertainty.csv originates from CityEnergyAnalyst\cea\analysis\uncertainty\Uncertainty_parameters.py
CheckPoint_uncertainty_number originates from CityEnergyAnalyst\cea\analysis\uncertainty\Individual_Evaluation.py
Information:
uncertainty.csvhas the values for parameters that are changed in uncertainty analysis
CheckPoint_uncertainty_numberhas the following parameters:
|
|
|