The Output of the results - kaemco/CitySim-Solver GitHub Wiki

Introduction

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.

_Area

Contains a summary by building of all areas by type and also shows the eco indicators.

_ClimatData

Contains all the data in the .cli file, nothing was calculated by CitySim.

_CM

Contains the MRT and comfort indices ITS and Comfa*

_DL

Contains the illuminance in the building in [lux] due to the window. Near 1.5 meters and far about 4.5 meters

_ET

Contains the evapotranspiration results. It represents the water to be supplied to the green area.

_HC

Contains the convective heat transfer coefficients for the surfaces.

_Inertia

Contains the thermal inertia. This is calculated during the pre-simulation.

_LW

Contains the longwave (infrared) balance of the surfaces in W/m2.

_SW

Contains the shortwave irradiance of the surfaces in W/m2.

_SWv

Contains the illuminance of the surfaces in lx.

_TH

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.

_TS

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.

_VF

Contains the Sky View Factor and Ground View Factor of the surfaces (-).

_YearlyResults

Contains the yearly summarised results about the scene.

_YearlyResultsPerBuilding

Contains the yearly summarised results about the scene on a building basis.

⚠️ **GitHub.com Fallback** ⚠️