The Output of the results - kaemco/CitySim-Solver GitHub Wiki
Exporting the results is the very last step in the process if we refer to the general flow chart of the code. Here is a reminder of the steps involved :
-
Reading the xml file
-
Creation of scenes
-
Pre-simulation
-
Start of the simulation
-
Output of the results
When the results are exported as a .TSV file, 15 files are created. Here is their description.
Contains a summary by building of all areas by type and also shows the eco indicators.
Contains all the data in the .cli file, nothing was calculated by CitySim.
Contains the MRT and comfort indices ITS and Comfa*
Contains the illuminance in the building in [lux] due to the window. Near 1.5 meters and far about 4.5 meters
Contains the evapotranspiration results. It represents the water to be supplied to the green area.
Contains the convective heat transfer coefficients for the surfaces.
Contains the thermal inertia. This is calculated during the pre-simulation.
Contains the longwave (infrared) balance of the surfaces in W/m2.
Contains the shortwave irradiance of the surfaces in W/m2.
Contains the illuminance of the surfaces in lx.
Contains all the results about District Energy Center. The TH-file is an interesting file that contains a lot of information.
-
timeStep the results are provided on an hourly basis.
-
DEC:TotalThermalLose is the total thermal lose [W].
-
DEC:ThermalstationNodePair1 provides information about ThermalStationNodePair id=1.
-
DEC:SubstationNodePair1 provides information about SubstationNodePair id=1.
-
DEC:NodePair1 provides information about NodePair id=1.
-
DEC:PipePair1 provides information about PiePair id=1. Supply and Return MassFlow always have opposite signs. A PipePair1:ReturnThermalLoss result that is negative means that the return pipe id=1 is gaining energy.
After the District Energy Center comes the results by building. 4(Swimming_Pool):48473294:Heating(Wh) means that this is the building id=4, its name is Swimming_Pool, its key is 48473294 and the name of the result. For each Building who contains a key number there is :
- Ta (°C) the indoor air temperature.
- Heating (Wh) the ideal heating needs to reach the heating setpoint temperature.
- Cooling (Wh) the ideal cooling needs to reach the cooling setpoint temperature.
- Qi (Wh) the internal gains comprising occupants, appliances and solar heat gains.
- Qs (Wh) the satisfied heating (positive) or cooling (negative) needs - this is the column to take into account for ideal loads calculation.
- VdotVent (mᶟ/h) the natural ventilation flow rate by window openings.
- HeatStockTemperature (°C) the temperature of the heat tank.
- DHWStockTemperature (°C) the temperature of the domestic hot water tank (if applicable).
- ColdStockTemperature (°C) the temperature of the cold tank.
- MachinePower (W) the power necessary for the energy conversion system to provide heating or cooling.
- FuelConsumption (MJ) the energy consumed by the energy conversion system in terms of fuel.
- ElectricConsumption (kWh) the energy consumed by the energy conversion system and the appliances in terms of electricity.
- SolarPVProduction (kWh) the energy provided by the photovoltaic panels.
- SolarThermalProduction (J) the energy provided to the heat stock by solar thermal panels.
When it is marked 4(Piscine_patinoire):FuelConsumption(Mj) means that it is the building id=4, its name is Pisicine_patinoire and as there is no key it gives us information about the building in general.
Contains the surface temperature given in celsius. Ke is the total convective heat transfert coefficient in watts/(m2K) that represents the sum of the coefficients for the walls in a zone.
Contains the Sky View Factor and Ground View Factor of the surfaces (-).
Contains the yearly summarised results about the scene.
Contains the yearly summarised results about the scene on a building basis.