:orphan:


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.py``
             is run
:Origin:     All files originate from ``CityEnergyAnalyst\cea\demand\demand_writers.py``


``<BUILDINGNAME>.csv`` file has a header row and one row for each hour of the your.
 It has 46 columns corresponding to the following fields:

- ``DATE``
- ``Name``
- ``people``
- ``QEf_kWh``
- ``QHf_kWh``
- ``QCf_kWh``
- ``Ef_kWh``
- ``Qhsf_kWh``
- ``Qhs_kWh``
- ``Qhsf_lat_kWh``
- ``Qwwf_kWh``
- ``Qww_kWh``
- ``Qcsf_kWh``
- ``Qcs_kWh``
- ``Qcsf_lat_kWh``
- ``Qcdataf_kWh``
- ``Qcref_kWh``
- ``Qcprof_kWh``
- ``Qhprof_kWh``
- ``Edataf_kWh``
- ``Ealf_kWh``
- ``Eaf_kWh``
- ``Elf_kWh``
- ``Eref_kWh``
- ``Eauxf_kWh``
- ``Eauxf_ve_kWh``
- ``Eauxf_hs_kWh``
- ``Eauxf_cs_kWh``
- ``Eauxf_ww_kWh``
- ``Eauxf_fw_kWh``
- ``Eprof_kWh``
- ``Ecaf_kWh``
- ``mcphsf_kWperC``
- ``mcpcsf_kWperC``
- ``mcpwwf_kWperC``
- ``mcpdataf_kWperC``
- ``mcpref_kWperC``
- ``Twwf_sup_C``
- ``Twwf_re_C``
- ``Thsf_sup_C``
- ``Thsf_re_C``
- ``Tcsf_sup_C``
- ``Tcsf_re_C``
- ``Tcdataf_re_C``
- ``Tcdataf_sup_C``
- ``Tcref_re_C``
- ``Tcref_sup_C``


``Total_demand.csv`` has a header row and one row for each building involved in simulation.
 It has 61 columns corresponding to the following fields:

- ``Name``
- ``Af_m2``
- ``Aroof_m2``
- ``GFA_m2``
- ``people0``
- ``Eref_MWhyr``
- ``Eauxf_cs0_kW``
- ``Eauxf_ve0_kW``
- ``Edataf0_kW``
- ``Qcprof_MWhyr``
- ``Qhprof_MWhyr``
- ``Ecaf0_kW``
- ``Qhsf0_kW``
- ``Qww0_kW``
- ``QHf0_kW``
- ``Eauxf_hs0_kW``
- ``Eprof_MWhyr``
- ``Eauxf_ve_MWhyr``
- ``Qcs0_kW``
- ``Qcsf_lat0_kW``
- ``Qcprof0_kW``
- ``Qhprof0_kW``
- ``QEf_MWhyr``
- ``Ef0_kW``
- ``Eauxf_hs_MWhyr``
- ``Eprof0_kW``
- ``Ealf_MWhyr``
- ``Qhsf_lat0_kW``
- ``Qhsf_MWhyr``
- ``Qwwf_MWhyr``
- ``Ecaf_MWhyr``
- ``Qcs_MWhyr``
- ``Qhs_MWhyr``
- ``Eauxf_cs_MWhyr``
- ``Eaf0_kW``
- ``Qcref0_kW``
- ``Edataf_MWhyr``
- ``Ealf0_kW``
- ``Eauxf_fw_MWhyr``
- ``Eauxf_MWhyr``
- ``Qhs0_kW``
- ``Eauxf_ww_MWhyr``
- ``Qcsf_MWhyr``
- ``Qwwf0_kW``
- ``QCf0_kW``
- ``Qww_MWhyr``
- ``Qcsf_lat_MWhyr``
- ``Qcdataf0_kW``
- ``Qcsf0_kW``
- ``Qcdataf_MWhyr``
- ``Eauxf_fw0_kW``
- ``QCf_MWhyr``
- ``Eauxf0_kW``
- ``QEf0_kW``
- ``Elf0_kW``
- ``Eaf_MWhyr``
- ``QHf_MWhyr``
- ``Qhsf_lat_MWhyr``
- ``Eauxf_ww0_kW``
- ``Qcref_MWhyr``
- ``Eref0_kW``
- ``Elf_MWhyr``
- ``Ef_MWhyr``


Optimization
------------

This section deals with the different files saved in ``<SCENARIO>\outputs\data\optimization``.
The folders present inside this are:

1. disconnected
2. master
3. network

   1. totals

4. slave
5. 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 |        | ``001111111000000000010001`` corresponds|
|               |        | to which buildings are connected to DHN |
|               |        | This is the <BUILDINGNETWORK>           |
+---------------+--------+-----------------------------------------+

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 configuration``
- ``BoilerBG Share``
- ``BoilerNG Share``
- ``CO2 Emissions [kgCO2-eq]``
- ``EforGHP``
- ``FC Share``
- ``GHP Share``
- ``Nominal Power``
- ``Operation Costs [CHF]``
- ``Primary Energy Needs [MJoil-eq]``
- ``QfromBG``
- ``QfromGHP``
- ``QfromNG``
- ``Total 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_fitness``
- ``epsIndicator``
- ``generation``
- ``testedPop``
- ``population``


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_kWh``
- ``Electr_netw_total_W``
- ``Q_DC_building_netw_total_W``
- ``Q_DC_losses_W``
- ``Q_DH_building_netw_total_W``
- ``Q_DH_losses_W``
- ``Qcdata_netw_total_kWh``
- ``T_sst_cool_return_netw_total_K``
- ``T_sst_cool_supply_netw_total_K``
- ``T_sst_heat_return_netw_total_K``
- ``T_sst_heat_supply_netw_total_K``
- ``day_of_max_heatmassflow``
- ``mdot_DH_netw_total_kgpers``
- ``mdot_cool_netw_total_kgpers``
- ``mdotdata_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_kWh``
- ``Electr_netw_total_W``
- ``Q_DC_building_netw_total_W``
- ``Q_DC_losses_W``
- ``Q_DH_building_netw_total_W``
- ``Q_DH_losses_W``
- ``Qcdata_netw_total_kWh``
- ``T_sst_cool_return_netw_total_K``
- ``T_sst_cool_supply_netw_total_K``
- ``T_sst_heat_return_netw_total_K``
- ``T_sst_heat_supply_netw_total_K``
- ``day_of_max_heatmassflow``
- ``mdot_DH_netw_total_kgpers``
- ``mdot_cool_netw_total_kgpers``
- ``mdotdata_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:

- ``Name``
- ``Af_m2``
- ``Aroof_m2``
- ``GFA_m2``
- ``people0``
- ``Eref_MWhyr``
- ``Eauxf_cs0_kW``
- ``Eauxf_ve0_kW``
- ``Edataf0_kW``
- ``Qcprof_MWhyr``
- ``Qhprof_MWhyr``
- ``Ecaf0_kW``
- ``Qhsf0_kW``
- ``Qww0_kW``
- ``QHf0_kW``
- ``Eauxf_hs0_kW``
- ``Eprof_MWhyr``
- ``Eauxf_ve_MWhyr``
- ``Qcs0_kW``
- ``Qcsf_lat0_kW``
- ``Qcprof0_kW``
- ``Qhprof0_kW``
- ``QEf_MWhyr``
- ``Ef0_kW``
- ``Eauxf_hs_MWhyr``
- ``Eprof0_kW``
- ``Ealf_MWhyr``
- ``Qhsf_lat0_kW``
- ``Qhsf_MWhyr``
- ``Qwwf_MWhyr``
- ``Ecaf_MWhyr``
- ``Qcs_MWhyr``
- ``Qhs_MWhyr``
- ``Eauxf_cs_MWhyr``
- ``Eaf0_kW``
- ``Qcref0_kW``
- ``Edataf_MWhyr``
- ``Ealf0_kW``
- ``Eauxf_fw_MWhyr``
- ``Eauxf_MWhyr``
- ``Qhs0_kW``
- ``Eauxf_ww_MWhyr``
- ``Qcsf_MWhyr``
- ``Qwwf0_kW``
- ``QCf0_kW``
- ``Qww_MWhyr``
- ``Qcsf_lat_MWhyr``
- ``Qcdataf0_kW``
- ``Qcsf0_kW``
- ``Qcdataf_MWhyr``
- ``Eauxf_fw0_kW``
- ``QCf_MWhyr``
- ``Eauxf0_kW``
- ``QEf0_kW``
- ``Elf0_kW``
- ``Eaf_MWhyr``
- ``QHf_MWhyr``
- ``Qhsf_lat_MWhyr``
- ``Eauxf_ww0_kW``
- ``Qcref_MWhyr``
- ``Eref0_kW``
- ``Elf_MWhyr``
- ``Ef_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>_AveragedCostData``                | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_InvestmentCostDetailed``          | ``CityEnergyAnalyst\cea\optimization\master\cost_model.py``                       |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_PrimaryEnergyBySource``           | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_SlaveCostData``                   | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_SlaveToMasterCostEmissionsPrimE`` | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_PPActivationPattern``             | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_SlaveDetailedEmissionData``       | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_SlaveDetailedEprimData``          | ``CityEnergyAnalyst\cea\optimization\slave\least_cost.py``                        |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_Storage_Sizing_Parameters``       | ``CityEnergyAnalyst\cea\optimization\slave\seasonal_storage\storage_main.py``     |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+
    | ``<CONFIGURATION>_StorageOperationData``            | ``CityEnergyAnalyst\cea\optimization\slave\seasonal_storage\design_operation.py`` |
    +-----------------------------------------------------+-----------------------------------------------------------------------------------+


``<CONFIGURATION>_AveragedCostData.csv`` has two rows (including header) and 10 columns corresponding to
the following fields:

- ``avgCostAddBoiler``
- ``avgCostBoilerBaseRpkWh``
- ``avgCostBoilerPeakRpkWh``
- ``avgCostCCRpkWh``
- ``avgCostFurnaceRpkWh``
- ``avgCostGHPRpkWh``
- ``avgCostHPLakeRpkWh``
- ``avgCostHPSewRpkWh``
- ``avgCostStorageOperation``
- ``avgCostUncontrollableSources``


``<CONFIGURATION>_InvestmentCostDetailed.csv`` has two rows (including header) and 23 columns
corresponding to the following fields:

- ``BoilerAddInvC``
- ``BoilerBInvCost``
- ``BoilerPInvCost``
- ``CO2DiscBuild``
- ``CostDiscBuild``
- ``DHNInvestCost``
- ``FurnaceInvCost``
- ``GasConnectionInvCa``
- ``HPLakeInvC``
- ``HPSewInvC``
- ``NetworkCost``
- ``PVTHEXCost``
- ``PVTInvC``
- ``PrimDiscBuild``
- ``SCHEXCost``
- ``SCInvC``
- ``StorageCostSum``
- ``StorageHEXCost``
- ``StorageHPCost``
- ``StorageInvC``
- ``SubstHEXCost``
- ``SumInvestCost``
- ``pumpCosts``


``<CONFIGURATION>_PrimaryEnergyBySource.csv`` has two rows (including header)
It has an index column and 8 columns corresponding to the following fields:

- ``EelExport``
- ``EelectrImportSlave``
- ``EgasPrimary``
- ``EgasPrimaryPeakPower``
- ``Egroundheat``
- ``EsolarUsed``
- ``EwoodPrimary``
- ``costBenefitNotUsedHPs``


``<CONFIGURATION>_SlaveCostData.csv`` has two rows (including header).
 It has an index column and 15 columns corresponding to the following fields:

- ``KEV_Remuneration``
- ``PPoperation_exclAddBackup``
- ``costAddBackup_total``
- ``costBackup_sum``
- ``costBoiler_sum``
- ``costCC_sum``
- ``costFurnace_sum``
- ``costGHP_sum``
- ``costHPLake_sum``
- ``costHPSew_sum``
- ``cost_Boiler_for_Storage_reHeat_at_seasonend``
- ``cost_CC_maintenance``
- ``cost_HP_aux_uncontrollable``
- ``cost_HP_storage_operation``
- ``total cost``


``<CONFIGURATION>_SlaveToMasterCostEmissionsPrimE.csv`` has two rows (including header).
It has an index column and 3 columns corresponding to the following fields:

- ``CO2_kg_eq``
- ``E_oil_eq_MJ``
- ``cost_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_Status``
- ``BoilerPeak_Status``
- ``CC_Status``
- ``Cost_AddBoiler``
- ``Cost_BoilerBase``
- ``Cost_BoilerPeak``
- ``Cost_CC``
- ``Cost_Furnace``
- ``Cost_GHP``
- ``Cost_HPLake``
- ``Cost_HPSew``
- ``ESolarProducedPVandPVT``
- ``E_GHP``
- ``E_PP_and_storage``
- ``E_aux_HP_uncontrollable``
- ``E_consumed_without_buildingdemand``
- ``E_produced_total``
- ``Furnace_Status``
- ``GHP_Status``
- ``HPLake_Status``
- ``HPSew_Status``
- ``Q_AddBoiler``
- ``Q_BoilerBase``
- ``Q_BoilerPeak``
- ``Q_CC``
- ``Q_Furnace``
- ``Q_GHP``
- ``Q_HPLake``
- ``Q_HPSew``
- ``Q_Network_Demand_after_Storage``
- ``Q_excess``
- ``Q_primaryAddBackupSum``
- ``Q_uncontrollable``
- ``Q_uncovered``
- ``Qcold_HPLake``


**<CONFIGURATION>_SlaveDetailedEmissionData** has 2 rows (including header).
It has an index column and 14 columns corresponding to the following fields:

- ``CO2_from_AddBoiler_gas``
- ``CO2_from_BaseBoiler_gas``
- ``CO2_from_CC_gas``
- ``CO2_from_GHP``
- ``CO2_from_HPLake``
- ``CO2_from_HPSolarandHearRecovery``
- ``CO2_from_HP_StorageOperationChDeCh``
- ``CO2_from_PeakBoiler_gas``
- ``CO2_from_SCandPVT``
- ``CO2_from_Sewage``
- ``CO2_from_elec_sold``
- ``CO2_from_elec_usedAuxBoilersAll``
- ``CO2_from_fictiveBoilerStorage``
- ``CO2_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_gas``
- ``E_prim_from_BaseBoiler_gas``
- ``E_prim_from_CC_gas``
- ``E_prim_from_FictiveBoiler_gas``
- ``E_prim_from_PeakBoiler_gas``
- ``EprimSaved_from_elec_sold_CC``
- ``EprimSaved_from_elec_sold_Furnace``
- ``EprimSaved_from_elec_sold_Solar``
- ``Eprim_from_GHP``
- ``Eprim_from_HPLake``
- ``Eprim_from_HPSolarandHearRecovery``
- ``Eprim_from_HP_StorageOperationChDeCh``
- ``Eprim_from_Sewage``
- ``Eprim_from_elec_usedAuxBoilersAll``
- ``Eprim_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_initial``
- ``Storage_Size_opt``
- ``T_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_Wh``
- ``E_PV_Wh``
- ``E_aux_HP_uncontrollable``
- ``E_aux_ch``
- ``E_aux_dech``
- ``E_consumed_total_without_buildingdemand``
- ``E_produced_total``
- ``HPCompAirDesignArray``
- ``HPScDesignArray``
- ``HPServerHeatDesignArray``
- ``HPpvt_designArray``
- ``P_HPCharge_max``
- ``Q_DH_networkload``
- ``Q_SCandPVT_coldstream``
- ``Q_from_storage_used``
- ``Q_missing``
- ``Q_rejected_fin``
- ``Q_storage_content_Wh``
- ``Q_to_storage``
- ``Q_uncontrollable_hot``
- ``Storage_Size``
- ``mdot_DH_fin``


5. Substations
~~~~~~~~~~~~~~

**File Names:**

1. ``<BUILDINGNAME>_result``
2. ``Total_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_design``
- ``A_hex_dhw_design``
- ``A_hex_heating_design``
- ``Electr_array_all_flat``
- ``Q_cool``
- ``Q_dhw``
- ``Q_heating``
- ``T_heating_max_all_buildings_intern``
- ``T_hotwater_max_all_buildings_intern``
- ``T_r1_dhw_result``
- ``T_r1_heating_result``
- ``T_return_DC_result``
- ``T_return_DH_result``
- ``T_supply_DC_result``
- ``T_supply_DH_result``
- ``T_total_supply_max_all_buildings_intern``
- ``mdot_DC_result``
- ``mdot_DH_result``
- ``mdot_dhw_result``
- ``mdot_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:

- ``Name``
- ``Af_m2``
- ``Aroof_m2``
- ``GFA_m2``
- ``people0``
- ``Eref_MWhyr``
- ``Eauxf_cs0_kW``
- ``Eauxf_ve0_kW``
- ``Edataf0_kW``
- ``Qcprof_MWhyr``
- ``Qhprof_MWhyr``
- ``Ecaf0_kW``
- ``Qhsf0_kW``
- ``Qww0_kW``
- ``QHf0_kW``
- ``Eauxf_hs0_kW``
- ``Eprof_MWhyr``
- ``Eauxf_ve_MWhyr``
- ``Qcs0_kW``
- ``Qcsf_lat0_kW``
- ``Qcprof0_kW``
- ``Qhprof0_kW``
- ``QEf_MWhyr``
- ``Ef0_kW``
- ``Eauxf_hs_MWhyr``
- ``Eprof0_kW``
- ``Ealf_MWhyr``
- ``Qhsf_lat0_kW``
- ``Qhsf_MWhyr``
- ``Qwwf_MWhyr``
- ``Ecaf_MWhyr``
- ``Qcs_MWhyr``
- ``Qhs_MWhyr``
- ``Eauxf_cs_MWhyr``
- ``Eaf0_kW``
- ``Qcref0_kW``
- ``Edataf_MWhyr``
- ``Ealf0_kW``
- ``Eauxf_fw_MWhyr``
- ``Eauxf_MWhyr``
- ``Qhs0_kW``
- ``Eauxf_ww_MWhyr``
- ``Qcsf_MWhyr``
- ``Qwwf0_kW``
- ``QCf0_kW``
- ``Qww_MWhyr``
- ``Qcsf_lat_MWhyr``
- ``Qcdataf0_kW``
- ``Qcsf0_kW``
- ``Qcdataf_MWhyr``
- ``Eauxf_fw0_kW``
- ``QCf_MWhyr``
- ``Eauxf0_kW``
- ``QEf0_kW``
- ``Elf0_kW``
- ``Eaf_MWhyr``
- ``QHf_MWhyr``
- ``Qhsf_lat_MWhyr``
- ``Eauxf_ww0_kW``
- ``Qcref_MWhyr``
- ``Eref0_kW``
- ``Elf_MWhyr``
- ``Ef_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.csv`` has the values for parameters that are changed in uncertainty analysis

 ``CheckPoint_uncertainty_number`` has the following parameters:

+------------------------+-----------------------+----------------+
| ``population_fitness`` | ``uncertainty_level`` | ``population`` |
+------------------------+-----------------------+----------------+