Input Output Reference — EnergyPlus 24.1

<< Prev | Table of Contents | Object Index | Next >>

Group – Hybrid Model[LINK]

HybridModel:Zone[LINK]

This object provides a hybrid model feature to enhance energy simulations for existing buildings by inversely solving hard-to-measure model input parameters. More specifically, zone internal thermal mass, air infiltration rate (ACH), and people count are usually hard to be measured directly yet important in building energy simulations. The hybrid model takes measured zone air temperature, humidity ratio, or CO2 concentration as inputs and inversely solve those unknown parameters based on the zone air heat, moisture, or CO2 balance algorithms. The inversely solved internal thermal mass, air infiltration rate, and people count can then be used to substitute the original simplified assumptions to enhance the energy simulation.

Inputs[LINK]

Field: Name[LINK]

The name of the HybridModel:Zone object.

Field: Zone Name[LINK]

This field is the name of the thermal zone (ref: Zone) and attaches a particular hybrid model input to a thermal zone in the building.

Field: Calculate Zone Internal Thermal Mass[LINK]

This field is used to provide an option to calculate the temperature capacity multiplier (Ref: ZoneCapacitanceMultiplier:ResearchSpecial). The temperature capacity multiplier is represented as internal thermal mass multiplier in the hybrid model. When YES is selected, the hybrid model calculates the multiplier based on the inverse heat balance algorithm using the measured zone air temperature.

Field: Calculate Zone Air Infiltration Rate[LINK]

This field is used to provide an option to calculate the zone air infiltration rate - air change per hour (ACH). When YES is selected, the hybrid model calculates the zone air infiltration rate based on one of the following balance equations: 1. Heat balance equations, 2. Moisture balance equations, 3. CO2 balance equations when the corresponding data requirements are met. The HybridModel will be activated with the following options:

1. When Zone Measured Air Temperature Schedule Name is provided, it will calculate the zone air infiltration rate assuming the HVAC system is free-floating using the zone sensible heat balance algorithms;

2. When Zone Measured Air Temperature Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air Temperature Schedule Name are provided, it will calculate the zone air infiltration rate assuming the HVAC is on. In this case, the zone air supply air temperature and mass flow rate in the zone sensible heat balance algorithms will be overwritten by the input data;

3. When Zone Measured Air Humidity Ratio Schedule Name is provided, it will calculate the zone air infiltration rate assuming the HVAC system is free-floating using the zone moisture balance algorithms;

4. When Zone Measured Air Humidity Ratio Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air Humidity Ratio Schedule Name are provided, it will calculate the zone air infiltration rate assuming the HVAC is on. In this case, the zone air supply air humidity ratio and mass flow rate in the zone moisture balance algorithms will be overwritten by the input data;

5. When Zone Measured Air CO2 concentration Schedule Name is provided, it will calculate the zone air infiltration rate assuming the HVAC system is free-floating using the zone CO2 balance algorithms;

6. When Zone Measured Air CO2 concentration Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air CO2 Concentration Schedule Name are provided, it will calculate the zone air infiltration rate assuming the HVAC is on. In this case, the zone air supply air CO2 concentration and mass flow rate in the zone CO2 balance algorithms will be overwritten by the input data;

When YES is selected for Calculate Zone Internal Thermal Mass, this field will be treated as NO.

Field: Calculate Zone People Count[LINK]

This field is used to provide an option to calculate the zone people count. When YES is selected, the hybrid model calculates the zone people count based on one of the following balance equations: 1. heat balance equations, 2. Moisture balance equations, 3. CO2 balance equations when the corresponding data requirements are met. The HybridModel will be activated with the following options:

1. When Zone Measured Air Temperature Schedule Name is provided, it will calculate the zone people count assuming the HVAC system is free-floating using the zone sensible heat balance algorithms. The default people activity level is 130 W. The default sensible heat fraction is 0.6.The default radiant heat fraction is 0.7. Zone Input People Activity Level Schedule Name, Zone Input People Sensible Heat Fraction Schedule Name, and Zone Input People Radiant Heat Fraction Schedule Name are optional. When provided, the default values will be overwritten.

2. When Zone Measured Air Temperature Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air Temperature Schedule Name are provided, it will calculate the zone people count assuming the HVAC is on. In this case, the zone air supply air temperature and mass flow rate in the zone sensible heat balance algorithms will be overwritten by the input data.The default people activity level is 130 W. The default sensible heat fraction is 0.6.The default radiant heat fraction is 0.7. Zone Input People Activity Level Schedule Name, Zone Input People Sensible Heat Fraction Schedule Name, and Zone Input People Radiant Heat Fraction Schedule Name are optional. When provided, the default values will be overwritten.

3. When Zone Measured Air Humidity Ratio Schedule Name is provided, it will calculate the zone people count assuming the HVAC system is free-floating using the zone moisture balance algorithms.The default people activity level is 130 W. The default sensible heat fraction is 0.6.The default radiant heat fraction is 0.7. Zone Input People Activity Level Schedule Name, Zone Input People Sensible Heat Fraction Schedule Name, and Zone Input People Radiant Heat Fraction Schedule Name are optional. When provided, the default values will be overwritten.

4. When Zone Measured Air Humidity Ratio Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air Humidity Ratio Schedule Name are provided, it will calculate the zone people count assuming the HVAC is on. In this case, the zone air supply air humidity ratio and mass flow rate in the zone moisture balance algorithms will be overwritten by the input data.The default people activity level is 130 W. The default sensible heat fraction is 0.6.The default radiant heat fraction is 0.7. Zone Input People Activity Level Schedule Name, Zone Input People Sensible Heat Fraction Schedule Name, and Zone Input People Radiant Heat Fraction Schedule Name are optional. When provided, the default values will be overwritten.

5. When Zone Measured Air CO2 concentration Schedule Name is provided, it will calculate the zone people count assuming the HVAC system is free-floating using the zone CO2 balance algorithms. The default people activity level is 130 W. The default single person CO2 generation is 0.0000000382 [m3/(s*W)]. Zone Input People Activity Level Schedule Name, Zone Input People CO2 Generation Rate Schedule Name are optional. When provided, the default values will be overwritten.

6. When Zone Measured Air CO2 concentration Schedule Name, Zone Input Supply Air Mass Flow Rate Schedule Name, and Zone Input Supply Air CO2 Concentration Schedule Name are provided, it will calculate the zone people count assuming the HVAC is on. In this case, the zone air supply air CO2 concentration and mass flow rate in the zone CO2 balance algorithms will be overwritten by the input data. The default people activity level is 130 W. The default single person CO2 generation is 0.0000000382 [m3/(s*W)]. Zone Input People Activity Level Schedule Name, Zone Input People CO2 Generation Rate Schedule Name are optional. When provided, the default values will be overwritten.

When YES is selected for Calculate Zone Internal Thermal Mass or Calculate Zone Air Infiltration Rate, this field will be treated as NO.

Field: Zone Measured Air Temperature Schedule Name[LINK]

This field is the name of the schedule object which contains the zone air temperature measurement data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Measured Air Humidity Ratio Schedule Name[LINK]

This field is the name of the schedule object which contains the zone air humidity ration measurement data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Measured Air CO2 concentration Schedule Name[LINK]

This field is the name of the schedule object which contains the zone air CO2 concentration measurement data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Input People Activity Level Schedule Name[LINK]

This field is the name of the schedule referenced by a Schedule object which contains the people activity level data. The date range of the schedule should cover the start and end date of the HybridModel.

Field: Zone Input People Sensible Heat Fraction Schedule Name[LINK]

This field is the name of the schedule referenced by a Schedule object which contains the people sensible heat fraction data. The date range of the schedule should cover the start and end date of the HybridModel.

Field: Zone Input People Radiant Heat Fraction Schedule Name[LINK]

This field is the name of the schedule referenced by a Schedule object which contains the radiant heat fraction of the sensible heat data. The date range of the schedule should cover the start and end date of the HybridModel.

Field: Zone Input People CO2 Generation Rate Schedule Name[LINK]

This field is the name of the schedule referenced by a Schedule object which contains a single person’s CO2 generation rate data. The date range of the schedule should cover the start and end date of the HybridModel.

Field: Zone Input Supply Air Temperature Schedule Name[LINK]

This field is the name of the schedule object which contains the measured supply air temperature data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Input Supply Air Mass Flow Rate Schedule Name[LINK]

This field is the name of the schedule object which contains the measured supply air mass flow rate data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Input Supply Air Humidity Ratio Schedule Name[LINK]

This field is the name of the schedule object which contains the measured supply air humidity ratio data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Zone Input Supply Air CO2 Concentration Schedule Name[LINK]

This field is the name of the schedule object which contains the measured supply air CO2 concentration data. The date range of the schedule should cover the start and end date of the HybridModel. A Schedule:File object is recommended for inputting the time-series measurements. When a schedule:file object is provided, all the rows for a whole year should be in the file, the rows outside of the start and end date range of the HybridModel should be zeros.

Field: Begin Month[LINK]

This numeric field should contain the starting month number (1 = January, 2 = February, etc.) for the period of the measured data during which the hybrid model will be active.

Field: Begin Day of Month[LINK]

This numeric field should contain the starting day of the starting month (must be valid for month) for the period of the measured data during which the hybrid model will be active.

Field: End Month[LINK]

This numeric field should contain the ending month number (1 = January, 2 = February, etc.) for the period of the measured data during which the hybrid model will be active.

Field: End Day of Month[LINK]

This numeric field should contain the ending day of the ending month (must be valid for month) for the period of the measured data during which the hybrid model will be active.

Examples of the object in an IDF are:

HybridModel:Zone,
    ZONE 1 HybridModel,      !- Name
    ZONE 1,                  !- Zone Name
    Yes,                      !- Calculate Zone Internal Thermal Mass
    No,                     !- Calculate Zone Air Infiltration Rate
    No,                      !- Calculate Zone People Count
    ,                        !- Zone Measured Air Temperature Schedule Name
    ,                        !- Zone Measured Air Humidity Ratio Schedule Name
    ZONE 1_MeasuredCO2Concentration,  !- Zone Measured Air CO2 Concentration Schedule Name
    ,                        !- Zone Input People Activity Schedule Name
    ,                        !- Zone Input People Sensible Heat Fraction Schedule Name
    ,                        !- Zone Input People Radiant Heat Fraction Schedule Name
    ,                        !- Zone Input People CO2 Generation Rate Schedule Name
    ,                        !- Zone Input Supply Air Temperature Schedule Name
    ,                        !- Zone Input Supply Air Mass Flow Rate Schedule Name
    ,                        !- Zone Input Supply Air Humidity Ratio Schedule Name
    ,                        !- Zone Input Supply Air CO2 Concentration Schedule Name
    1,                       !- Begin Month
    1,                       !- Begin Day of Month
    12,                      !- End Month
    31;                      !- End Day of Month


HybridModel:Zone,
    ZONE 1 HybridModel,      !- Name
    ZONE 1,                  !- Zone Name
    No,                      !- Calculate Zone Internal Thermal Mass
    Yes,                     !- Calculate Zone Air Infiltration Rate
    No,                      !- Calculate Zone People Count
    ,                        !- Zone Measured Air Temperature Schedule Name
    ,                        !- Zone Measured Air Humidity Ratio Schedule Name
    ZONE 1_MeasuredCO2Concentration,  !- Zone Measured Air CO2 Concentration Schedule Name
    ,                        !- Zone Input People Activity Schedule Name
    ,                        !- Zone Input People Sensible Heat Fraction Schedule Name
    ,                        !- Zone Input People Radiant Heat Fraction Schedule Name
    ,                        !- Zone Input People CO2 Generation Rate Schedule Name
    ,                        !- Zone Input Supply Air Temperature Schedule Name
    ,                        !- Zone Input Supply Air Mass Flow Rate Schedule Name
    ,                        !- Zone Input Supply Air Humidity Ratio Schedule Name
    ,                        !- Zone Input Supply Air CO2 Concentration Schedule Name
    1,                       !- Begin Month
    1,                       !- Begin Day of Month
    12,                      !- End Month
    31;                      !- End Day of Month


HybridModel:Zone,
    ZONE 2 HybridModel,      !- Name
    ZONE 2,                  !- Zone Name
    No,                      !- Calculate Zone Internal Thermal Mass
    No,                      !- Calculate Zone Air Infiltration Rate
    Yes,                     !- Calculate Zone People Count
    ,                        !- Zone Measured Air Temperature Schedule Name
    ,                        !- Zone Measured Air Humidity Ratio Schedule Name
    ZONE 2_MeasuredCO2Concentration,     !- Zone Measured Air CO2 Concentration Schedule Name
    OfficeSmall ACTIVITY_SCH,            !- Zone Input People Activity Schedule Name
    People Sensible Heat Fraction Sch,   !- Zone Input People Sensible Heat Fraction Schedule Name
    People Radiation Heat Fraction Sch,  !- Zone Input People Radiant Heat Fraction Schedule Name
    People CO2 Generation Rate Sch,      !- Zone Input People CO2 Generation Rate Schedule Name
    ,                        !- Zone Input Supply Air Temperature Schedule Name
    ZONE 2_Inlet_MassFlow,   !- Zone Input Supply Air Mass Flow Rate Schedule Name
    ,                        !- Zone Input Supply Air Humidity Ratio Schedule Name
    ZONE 2_Inlet_CO2,        !- Zone Input Supply Air CO2 Concentration Schedule Name
    1,                       !- Begin Month
    1,                       !- Begin Day of Month
    12,                      !- End Month
    31;                      !- End Day of Month

Outputs[LINK]

Zone,Average,Zone Infiltration Hybrid Model Air Change Rate [ACH]
Zone,Average,Zone Infiltration Hybrid Model Mass Flow Rate [kg/s]
Zone,Average,Zone Hybrid Model People Count

Zone Infiltration Hybrid Model Air Change Rate [ACH][LINK]

The zone infiltration air change rate calculated by the hybrid model.

Zone Infiltration Hybrid Model Mass Flow Rate [kg/s][LINK]

The zone infiltration air mass flow rate calculated by the hybrid model.

Zone Hybrid Model People Count[LINK]

The zone people count calculated by the hybrid model.