Three zones ideal heating

The previous sections primarily addressed the simulation of the building envelope without a system, providing insight into how to structure the YAML input for Trano. In this section, we will focus on simulating a building equipped with a heating system. This example involves a three-zone building with an ideal heating setup.

Below is a description of the YAML configuration file for a building with a heating system. The key distinction between this configuration and previous ones is the incorporation of a heating system in one of the building's spaces. The relevant YAML code snippet is as follows:

emissions:
- radiator:
    id: RADIATOR:001
    variant: ideal
    parameters:
      nominal_heating_power_positive_for_heating: 2500
    control:
      emission_control:
        id: EMISSION_CONTROL:001
        parameters:
          schedule: 3600*{10, 20}
          temperature_heating_setpoint: 295.15
          temperature_heating_setback: 291.15

The emissions field indicates that the space is connected to an emission system. The variant field specifies the type of radiator—in this case, an ideal radiator. The control settings for the radiator are detailed within the control field, which includes parameters such as setpoints and schedules, as well as the heating power of the ideal radiator.

Input configuration file

The described building is a multi-room structure featuring distinct spaces, including a smaller room (SPACE:001) and two larger, similarly sized rooms (SPACE:002 and SPACE:003). The external walls are constructed using multiple layers of materials with varying thermal properties, suggesting good insulation. It includes windows made from high-performance glazing with low thermal conductivity and air-filled spaces to enhance energy efficiency. The building has a nominal heating system using radiators, which is controlled to maintain specific temperature settings. Overall, this configuration indicates a well-insulated, energy-efficient building designed for comfort.

material:
  - id: MATERIAL:001
    thermal_conductivity: 0.045
    density: 2100.0
    specific_heat_capacity: 900.0
  - id: MATERIAL:002
    thermal_conductivity: 0.04
    density: 1950.0
    specific_heat_capacity: 950.0
  - id: MATERIAL:003
    thermal_conductivity: 0.038
    density: 2050.0
    specific_heat_capacity: 920.0

constructions:
  - id: CONSTRUCTION:001
    layers:
      - material: MATERIAL:001
        thickness: 0.12
      - material: MATERIAL:002
        thickness: 0.08
      - material: MATERIAL:003
        thickness: 0.1

glass_material:
  - density: 2500.0
    id: GLASS:001
    longwave_emissivity: 0.82
    shortwave_emissivity: 0.65
    specific_heat_capacity: 860.0
    thermal_conductivity: 1.1

gas:
  - density: 1.18
    id: AIR:001
    longwave_emissivity: 0.0
    shortwave_emissivity: 0.0
    specific_heat_capacity: 1005.0
    thermal_conductivity: 0.026

glazings:
  - id: INS2AR2020:001
    layers:
      - glass: GLASS:001
        thickness: 0.005
      - gas: AIR:001
        thickness: 0.014
      - glass: GLASS:001
        thickness: 0.005

spaces:
  - parameters:
      floor_area: 80.0  # Smaller room
      average_room_height: 2.5
    id: SPACE:001
    external_boundaries:
      external_walls:
        - surface: 90.0
          azimuth: 180.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 70.0
          azimuth: 90.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 160.0
          azimuth: 270.0
          tilt: wall
          construction: CONSTRUCTION:001
      floor_on_grounds:
        - surface: 80.0
          construction: CONSTRUCTION:001
      windows:
        - surface: 1.5
          azimuth: 180.0
          tilt: wall
          construction: INS2AR2020:001
          width: 1.5
          height: 1.0

  - parameters:
      floor_area: 120.0  # Larger room with different shape
      average_room_height: 2.7
    id: SPACE:002
    external_boundaries:
      external_walls:
        - surface: 120.0
          azimuth: 180.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 100.0
          azimuth: 90.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 220.0
          azimuth: 0.0
          tilt: wall
          construction: CONSTRUCTION:001
      floor_on_grounds:
        - surface: 120.0
          construction: CONSTRUCTION:001
      windows:
        - surface: 2.0
          azimuth: 180.0
          tilt: wall
          construction: INS2AR2020:001
          width: 2.0
          height: 1.2
  - parameters:
      floor_area: 120.0  # Larger room with different shape
      average_room_height: 2.7
    id: SPACE:003
    external_boundaries:
      external_walls:
        - surface: 120.0
          azimuth: 180.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 100.0
          azimuth: 90.0
          tilt: wall
          construction: CONSTRUCTION:001
        - surface: 220.0
          azimuth: 0.0
          tilt: wall
          construction: CONSTRUCTION:001
      floor_on_grounds:
        - surface: 120.0
          construction: CONSTRUCTION:001
      windows:
        - surface: 2.0
          azimuth: 180.0
          tilt: wall
          construction: INS2AR2020:001
          width: 2.0
          height: 1.2

    emissions:
      - radiator:
          id: RADIATOR:001
          variant: ideal
          parameters:
              nominal_heating_power_positive_for_heating: 2500
          control:
            emission_control:
              id: EMISSION_CONTROL:001
              parameters:
                schedule: 3600*{10, 20}
                temperature_heating_setpoint: 295.15
                temperature_heating_setback: 291.15

internal_walls:
  - space_1: SPACE:002
    space_2: SPACE:001
    construction: CONSTRUCTION:001
    surface: 18.0

Code

This code snippet demonstrates how to simulate a multizone house using Trano. It leverages the same code as the previous tutorial, making it straightforward to implement.

Test tutorials

    from trano.main import simulate_model
    from trano.simulate.simulate import SimulationLibraryOptions

    simulate_model(
        path_to_yaml_configuration_folder / "three_zones_ideal_heating.yaml",
        SimulationLibraryOptions(
            start_time=0,
            end_time=2 * 3600 * 24 * 7,
            tolerance=1e-4,
            library_name="Buildings",
        ),
    )

General Explanation

This code snippet is used to simulate a model defined in a YAML configuration file. It utilizes a simulation library to specify parameters such as time range and tolerances for the simulation process.

General Description and Parameters

• Function Call: simulate_model
• Parameters:
  • path_to_yaml_configuration_folder / "three_zones_ideal_heating.yaml"
  • Description: Path to the YAML file that contains the model configuration.
  • SimulationLibraryOptions
  • Parameters:
    • start_time
    • Type: Integer
    • Description: Simulation start time in seconds.
    • end_time
    • Type: Integer
    • Description: Simulation end time in seconds (2 weeks in this case).
    • tolerance
    • Type: Float
    • Description: Acceptable tolerance level for the simulation results.
    • library_name
    • Type: String
    • Description: Name of the simulation library to use (e.g., "Buildings").

Outputs

The following report is generated by Trano after simulating a three-zone building equipped with an ideal heating system.

Spaces

hRoo	AFlo	linearizeRadiation	m_flow_nominal	mSenFac	T_start	volume
2.5	80.0	true	0.01	1.0	294.15	200.0

gain	k	occupancy	name
[40; 75; 40]	1/7/3	3600*{9, 17}	occupancy_1

Name	Azimuth	Construction Name	Surface	Tilt
externalwall_12	180.0	construction_001	90.0	wall
externalwall_13	90.0	construction_001	70.0	wall
externalwall_14	270.0	construction_001	160.0	wall
window_4	180.0	ins2ar2020_001	1.5	wall
flooronground_4	90.0	construction_001	80.0	floor
internal_space_002_space_001_construction	10.0	construction_001	18.0	wall

hRoo	AFlo	linearizeRadiation	m_flow_nominal	mSenFac	T_start	volume
2.7	120.0	true	0.01	1.0	294.15	324.0

gain	k	occupancy	name
[40; 75; 40]	1/7/3	3600*{9, 17}	occupancy_2

Name	Azimuth	Construction Name	Surface	Tilt
externalwall_15	180.0	construction_001	120.0	wall
externalwall_16	90.0	construction_001	100.0	wall
externalwall_17	0.0	construction_001	220.0	wall
window_5	180.0	ins2ar2020_001	2.0	wall
flooronground_5	90.0	construction_001	120.0	floor
internal_space_002_space_001_construction	10.0	construction_001	18.0	wall

hRoo	AFlo	linearizeRadiation	m_flow_nominal	mSenFac	T_start	volume
2.7	120.0	true	0.01	1.0	294.15	324.0

gain	k	occupancy	name
[40; 75; 40]	1/7/3	3600*{9, 17}	occupancy_3

Name	Azimuth	Construction Name	Surface	Tilt
externalwall_18	180.0	construction_001	120.0	wall
externalwall_19	90.0	construction_001	100.0	wall
externalwall_20	0.0	construction_001	220.0	wall
window_6	180.0	ins2ar2020_001	2.0	wall
flooronground_6	90.0	construction_001	120.0	floor

TAir_nominal	dp_nominal	n	deltaM	fraRad	Q_flow_nominal	nEle	TRad_nominal	linearized	from_dp	T_a_nominal	T_b_nominal	mDry	VWat	name
293.15	0.0	1.24	0.01	0.3	2500.0	1	293.15	false	false	363.15	353.15	65.75	0.145	radiator_001

Construction

Layers for construction_001

Name	c	epsLw	epsSw	k	rho	Thickness
material_001	900.0	0.85	0.85	0.045	2100.0	0.12
material_002	950.0	0.85	0.85	0.04	1950.0	0.08
material_003	920.0	0.85	0.85	0.038	2050.0	0.1

Layers for ins2ar2020_001

Name	c	epsLw	epsSw	k	rho	Thickness
glass_001	860.0	0.82	0.65	1.1	2500.0	0.005
air_001	1005.0	0.0	0.0	0.026	1.18	0.014
glass_001	860.0	0.82	0.65	1.1	2500.0	0.005