Input Output Reference — EnergyPlus 22.1

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

Input Output Reference

Group Demand Limiting Controls[LINK]

Demand limiting, or demand management, is a strategy for reducing a building’s demand for utilities, e.g., electricity. Utility companies typically charge a monthly fee for “demand charges” that is based on the peak demand during a certain time period. Often the peak demand charge is set by one exceptional day that is much higher than the peak demand for an average day during the month. Therefore, to save utility costs, it is in the interest of building owners to find ways to manage the demand on peak days. While demand management is generally concerned with the demand for electricity, the future will likely see demand management of other utilities, such as natural gas or water.

Demand limiting controls shut off or reduce the power to non-essential loads in order to reduce the overall building demand. Some typical controls:

  • shut off or dim electric lights, equipment, or HVAC systems

  • reset the thermostatic set points on HVAC systems

  • reduce the load of a set of similar components by rotating one or more components “off” for a short time interval

  • turn on generators to meet some or all of the building’s demand.

The demand limiting controls implemented in EnergyPlus are intended to allow some of the more common demand limiting strategies. Currently, only Exterior:Lights, Lights, ElectricEquipment, ZoneControl:Thermostat, and Controller:OutdoorAir objects can be demand limited. Additional components will be demand limited in future releases.

DemandManagerAssignmentList[LINK]

The DemandManagerAssignmentList object is a high level control that makes demand limiting decisions based on a list of possible demand limiting strategies. Each demand limiting strategy is described in a separate DemandManager object. (This is structured like the relationship between the AvailabilityManagerAssignmentList and the AvailabilityManager objects.)

Each DemandManagerAssignmentList monitors and demand limits one meter. Only electricity meters are currently allowed. In many cases, the meter will be Electricity:Facility. A schedule and safety factor are used to set the demand limit above which the DemandManagers become activated. The billing month schedule and demand window are also taken into account when calculating the demand limit.

DemandManagers in the list are activated based on the Demand Manager Priority. If the Sequential option is used, each manager in the list is activated in sequence from first to last until demand is reduced below the limit or until all managers are activated. If the All option is used, all managers are activated simultaneously to achieve the maximum demand reduction.

A DemandManager is skipped if it cannot reduce the demand. Possible reasons that a manager cannot reduce demand include:

  • not enough load to limit

  • not available because of its Availability Schedule

  • already activated; load limited during a previous timestep.

Inputs[LINK]

Field: Name[LINK]

The name of the DemandManagerAssignmentList object.

Field: Meter Name[LINK]

This field references the meter that is to be monitored and demand limited. Only electricity meters are currently allowed.

Field: Demand Limit Schedule Name[LINK]

The reference to the schedule object specifying the target demand limits [schedule values should be in Watts].

Field: Demand Limit Safety Fraction[LINK]

This field is a multiplier that is applied to the target demand limit (above). When the metered demand exceeds (target demand limit * safety fraction), the DemandManagers begin to limit the demand. This helps to ensure that the target limit is not exceeded.

Field: Billing Period Schedule Name[LINK]

The reference to the schedule object that defines the monthly billing periods. The peak demand during the peak period of the billing period typically determines the demand charge. This should reference the same schedule that is used in the Month Schedule Name field of the UtilityCost:Tariff object. If left blank, it defaults to the regular divisions between months.

Field: Peak Period Schedule Name[LINK]

The reference to the schedule object that defines the peak/off-peak time-of-use periods. The peak demand during the peak period of the billing period typically determines the demand charge. This should reference the same schedule that is used in the Time of Use Period Schedule Name field of the UtilityCost:Tariff object. A value of 1 indicates the peak period; any other value is off-peak. If left blank, it defaults to always on the peak period. The DemandManagerAssignmentList only attempts to demand limit during peak periods.

Field: Demand Window Length[LINK]

This field is similar to the field of the same name in the UtilityCost:Tariff object. However, the user may not want to limit using the same demand window as the utility company. This field allows the user to input the number of minutes over which to calculate the current demand. The minutes are rounded to match the nearest multiple of time steps.

Field: Demand Manager Priority[LINK]

This field indicates what logic should be used to activate the individual DemandManagers in the list. Sequential treats the list of DemandManagers as a sequential priority list, i.e., the first DemandManager in the list is activated first, then the second, etc., until the demand falls below the limit. All activates all demand managers to achieve the maximum demand reduction.

Field: Demand Manager <#> Type[LINK]

The key word defining the type of DemandManager.

Field: Demand Manager <#> Name[LINK]

The name of a DemandManager object defined elsewhere in the input file.

DemandManagers are listed by pairs of data items: Demand Manager Type and Demand Manager Name. This object is extensible, so additional pairs of these last two fields can be added to the end of this object.

An example IDF showing how this object is used is provided below:

DemandManagerAssignmentList,
  Demand Manager,                   !- Name
  Electricity:Facility,       !- Meter Name
  Limit Schedule,                   !- Demand Limit Schedule Name
  1.0,                                         !- Demand Limit Safety Fraction
  ,                                               !- Billing Period Schedule Name
  ,                                               !- Peak Period Schedule Name
  15,                                           !- Demand Window Length {minutes}
  Sequential,                           !- Demand Manager Priority
  DemandManager:ExteriorLights,   !- DemandManager 1 Object Type
  Ext Lights Manager,           !- DemandManager 1 Name
  DemandManager:ElectricEquipment,   !- DemandManager 2 Object Type
  Eq Mgr Stage 1,                   !- DemandManager 2 Name
  DemandManager:ElectricEquipment,   !- DemandManager 3 Object Type
  Eq Mgr Stage 2,                   !- DemandManager 3 Name
  DemandManager:ElectricEquipment,   !- DemandManager 4 Object Type
  Eq Mgr Stage 3,                   !- DemandManager 4 Name
  DemandManager:Lights,       !- DemandManager 5 Object Type
  Lights Manager,                   !- DemandManager 5 Name
  DemandManager:Thermostats,   !- DemandManager 6 Object Type
  Thermostats Manager;         !- DemandManager 6 Name

Outputs[LINK]

The following output variables are reported for the DemandManagerAssignmentList object:

  • Zone,Average,Demand Manager Meter Demand Power [W]

  • Zone,Average,Demand Manager Average Demand Power [W]

  • Zone,Average,Demand Manager Peak Demand Power [W]

  • Zone,Average,Demand Manager Scheduled Limit Power [W]

  • Zone,Average,Demand Manager Demand Limit Power [W]

  • Zone,Average,Demand Manager Avoided Demand [W]

  • Zone,Average,Demand Manager Over Limit Power [W]

  • Zone,Sum,Demand Manager Over Limit Time [hr]

  • Zone,Sum,Demand Manager Exterior Energy Iteration Count []

  • Zone,Sum,Demand Manager Heat Balance Iteration Count []

  • Zone,Sum,Demand Manager HVAC Iteration Count []

Demand Manager Meter Demand Power [W][LINK]

The current demand for the designated meter.

Demand Manager Average Demand Power [W][LINK]

The current demand for the designated meter averaged over the Demand Window Length.

Demand Manager Peak Demand Power [W][LINK]

The peak demand in the billing month so far.

Demand Manager Scheduled Limit Power [W][LINK]

The scheduled target demand limit from the Demand Limit Schedule.

Demand Manager Demand Limit Power [W][LINK]

The actual demand limit after multiplication by the Demand Limit Safety Fraction.

Demand Manager Avoided Demand [W][LINK]

The demand that was avoided by the active DemandManagers.

Demand Manager Over Limit Power [W][LINK]

The difference between the demand limit and the average demand.

Demand Manager Over Limit Time [hr][LINK]

The number of hours that the demand limit was exceeded.

Demand Manager Exterior Energy Iteration Count [][LINK]

The number times that the exterior energy use was resimulated for demand limiting.

Demand Manager Heat Balance Iteration Count [][LINK]

The number times that the zone heat balance was resimulated for demand limiting.

Demand Manager HVAC Iteration Count [][LINK]

The number times that the HVAC system was resimulated for demand limiting.

DemandManager:ExteriorLights[LINK]

The DemandManager:ExteriorLights object is used for demand limiting Exterior:Lights objects.

Inputs[LINK]

Field: Name[LINK]

The name of the DemandManager:ExteriorLights object.

Field: Availability Schedule Name[LINK]

The reference to the schedule object specifying the availability of this DemandManager. A schedule value of 0 indicates that the unit is off for that time period. A schedule value greater than 0 indicates that the unit can operate during the time period. If this field is blank, the schedule has values of 1 for all time periods.

Field: Limit Control[LINK]

This field specifies the type of limiting control. The Fixed option reduces the power to the controlled loads by a fixed amount determined by the Maximum Limit Fraction field. The Off option disables the DemandManager in the simulation.

Field: Minimum Limit Duration[LINK]

The minimum amount of time [minutes] that the DemandManager will continue to demand limit after being activated. This prevents loads from turning on and off every time step.

Field: Maximum Limit Fraction[LINK]

This field specifies a fraction of the Design Level power for the load that determines the lowest allowable power level. With Limit Control set to Fixed, the power is reduced to Maximum Limit Fraction * Design Level whenever the manager is activated. For example, if the Maximum Limit Fraction is 0.8, then a 100 W design level load is reduced to 80 W when limiting. A Maximum Limit Fraction of zero means that the load can be shut off entirely.

Field: Limit Step Change[LINK]

NOT YET IMPLEMENTED.

Field: Selection Control[LINK]

This field specifies which loads are selected to be limited. The All option simultaneously limits all of the loads listed in this DemandManager. The RotateMany option limits all loads except for one which rotates sequentially through the loads listed. The RotateOne limits only one load which rotates sequentially through the loads listed. The time interval between rotations is set by the Rotation Duration field.

Field: Rotation Duration[LINK]

If the RotateOne or RotateMany option is used for Selection Control, this field sets the time interval [minutes] between rotations.

Field: Exterior Lights <#> Name[LINK]

The names of Exterior:Lights objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager. This field is extensible, so additional fields of this type can be added to the end of this object.

An example IDF showing how this object is used is provided below:

DemandManager:ExteriorLights,
  Ext Lights Manager,           !- Name
  ,                                               !- Availability Schedule Name
  Fixed,                                     !- Limit Control
  60,                                           !- Minimum Limit Duration {minutes}
  0.0,                                         !- Maximum Limit Fraction
  ,                                               !- Limit Step Change
  All,                                         !- Selection Control
  ,                                               !- Rotation Duration {minutes}
  Exterior Lights;                 !- Exterior Lights 1 Name

Outputs[LINK]

There are no output variables reported for the DemandManager:ExteriorLights object.

DemandManager:Lights[LINK]

The DemandManager:Lights object is used for demand limiting Lights objects.

Inputs[LINK]

Field: Name[LINK]

The name of the DemandManager:Lights object.

Field: Availability Schedule Name[LINK]

The reference to the schedule object specifying the availability of this DemandManager. A schedule value of 0 indicates that the unit is off for that time period. A schedule value greater than 0 indicates that the unit can operate during the time period. If this field is blank, the schedule has values of 1 for all time periods.

Field: Limit Control[LINK]

This field specifies the type of limiting control. The Fixed option reduces the power to the controlled loads by a fixed amount determined by the Maximum Limit Fraction field. The Off option disables the DemandManager in the simulation.

Field: Minimum Limit Duration[LINK]

The minimum amount of time [minutes] that the DemandManager will continue to demand limit after being activated. This prevents loads from turning on and off every time step.

Field: Maximum Limit Fraction[LINK]

This field specifies a fraction of the Design Level power for the load that determines the lowest allowable power level. With Limit Control set to Fixed, the power is reduced to Maximum Limit Fraction * Design Level whenever the manager is activated. For example, if the Maximum Limit Fraction is 0.8, then a 100 W design level load is reduced to 80 W when limiting. A Maximum Limit Fraction of zero means that the load can be shut off entirely.

Field: Limit Step Change[LINK]

NOT YET IMPLEMENTED.

Field: Selection Control[LINK]

This field specifies which loads are selected to be limited. The All option simultaneously limits all of the loads listed in this DemandManager. The RotateMany option limits all loads except for one which rotates sequentially through the loads listed. The RotateOne limits only one load which rotates sequentially through the loads listed. The time interval between rotations is set by the Rotation Duration field.

Field: Rotation Duration[LINK]

If the RotateOne or RotateMany option is used for Selection Control, this field sets the time interval [minutes] between rotations.

Field: Lights <#> Name[LINK]

The names of Lights objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager. This field is extensible, so additional fields of this type can be added to the end of this object.

If a global lights statement is used (Ref: Lights), then only that name need be entered and the demand limiting will be applied to all the zones for that lighting. If only one of a set of zones from a global lights statement is desired, then the name to be entered is: <Zone Name> <Name of Lights Global Object>.

An example IDF showing how this object is used is provided below:

DemandManager:Lights,
  Lights Manager,                   !- Name
  ,                                               !- Availability Schedule Name
  Fixed,                                     !- Limit Control
  60,                                           !- Minimum Limit Duration {minutes}
  0.5,                                         !- Maximum Limit Fraction
  ,                                               !- Limit Step Change
  All,                                         !- Selection Control
  ,                                               !- Rotation Duration {minutes}
  Space1-1 Lights 1,             !- Lights 1 Name
  Space2-1 Lights 1,             !- Lights 2 Name
  Space3-1 Lights 1,             !- Lights 3 Name
  Space4-1 Lights 1,             !- Lights 4 Name
  Space5-1 Lights 1;             !- Lights 5 Name

Outputs[LINK]

There are no output variables reported for the DemandManager:Lights object.

DemandManager:ElectricEquipment[LINK]

The DemandManager:ElectricEquipment object is used for demand limiting ElectricEquipment objects.

Inputs[LINK]

Field: Name[LINK]

The name of the DemandManager:ElectricEquipment object.

Field: Availability Schedule Name[LINK]

The reference to the schedule object specifying the availability of this DemandManager. A schedule value of 0 indicates that the unit is off for that time period. A schedule value greater than 0 indicates that the unit can operate during the time period. If this field is blank, the schedule has values of 1 for all time periods.

Field: Limit Control[LINK]

This field specifies the type of limiting control. The Fixed option reduces the power to the controlled loads by a fixed amount determined by the Maximum Limit Fraction field. The Off option disables the DemandManager in the simulation.

Field: Minimum Limit Duration[LINK]

The minimum amount of time [minutes] that the DemandManager will continue to demand limit after being activated. This prevents loads from turning on and off every time step.

Field: Maximum Limit Fraction[LINK]

This field specifies a fraction of the Design Level power for the load that determines the lowest allowable power level. With Limit Control set to Fixed, the power is reduced to Maximum Limit Fraction * Design Level whenever the manager is activated. For example, if the Maximum Limit Fraction is 0.8, then a 100 W design level load is reduced to 80 W when limiting. A Maximum Limit Fraction of zero means that the load can be shut off entirely.

Field: Limit Step Change[LINK]

NOT YET IMPLEMENTED.

Field: Selection Control[LINK]

This field specifies which loads are selected to be limited. The All option simultaneously limits all of the loads listed in this DemandManager. The RotateMany option limits all loads except for one which rotates sequentially through the loads listed. The RotateOne limits only one load which rotates sequentially through the loads listed. The time interval between rotations is set by the Rotation Duration field.

Field: Rotation Duration[LINK]

If the RotateOne or RotateMany option is used for Selection Control, this field sets the time interval [minutes] between rotations.

Field: Electric Equipment <#> Name[LINK]

The names of ElectricEquipment objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager. This field is extensible, so additional fields of this type can be added to the end of this object.

If a global Electric Equipment statement is used (Ref: ElectricEquipment), then only that name need be entered and the demand limiting will be applied to all the zones for that equipment. If only one of a set of zones from a global electric equipment statement is desired, then the name to be entered is: <Zone Name> <Name of ElectricEquipment Global Object>.

An example IDF showing how this object is used is provided below:

DemandManager:ElectricEquipment,
  Eq Mgr Stage 3,                   !- Name
  ,                                               !- Availability Schedule Name
  Fixed,                                     !- Limit Control
  60,                                           !- Minimum Limit Duration {minutes}
  0.0,                                         !- Maximum Limit Fraction
  ,                                               !- Limit Step Change
  All,                                         !- Selection Control
  ,                                               !- Rotation Duration {minutes}
  Space5-1 ElecEq 1;             !- Electric Equipment 1 Name

Outputs[LINK]

There are no output variables reported for the DemandManager:ElectricEquipment object.

DemandManager:Thermostats[LINK]

The DemandManager:Thermostats object is used for demand limiting ZoneControl:Thermostat objects.

Inputs[LINK]

Field: Name[LINK]

The name of the DemandManager:Thermostats object.

Field: Availability Schedule Name[LINK]

The reference to the schedule object specifying the availability of the DemandManager. A schedule value of 0 indicates that the unit is off for that time period. A schedule value greater than 0 indicates that the unit can operate during the time period. If this field is blank, the schedule has values of 1 for all time periods.

Field: Reset Control[LINK]

This field specifies the type of limiting control. The Fixed option resets the thermostats to a fixed temperature determined by the Maximum Heating Setpoint Reset and Maximum Cooling Setpoint Reset fields. The Off option disables the DemandManager in the simulation.

Field: Minimum Reset Duration[LINK]

The minimum amount of time [minutes] that the DemandManager will continue to demand limit after being activated. This prevents thermostats from resetting on and off every time step.

Field: Maximum Heating Setpoint Reset[LINK]

This field specifies the thermostat heating setpoint temperature [C] that represents the largest allowable temperature reset or setback. With Reset Control set to Fixed, the setpoint temperature is reset to the Maximum Heating Setpoint Reset whenever the manager is activated. For example, if the heating setpoint is normally 22 C and the Maximum Heating Setpoint Reset is 20 C, then the setpoint is reset to 20 C when limiting.

Field: Maximum Cooling Setpoint Reset[LINK]

This field specifies the thermostat cooling setpoint temperature [C] that represents the largest allowable temperature reset or setback. With Reset Control set to Fixed, the setpoint temperature is reset to the Maximum Cooling Setpoint Reset whenever the manager is activated. For example, if the cooling setpoint is normally 22 C and the Maximum Cooling Setpoint Reset is 24 C, then the setpoint is reset to 24 C when limiting.

Field: Reset Step Change[LINK]

NOT YET IMPLEMENTED.

Field: Selection Control[LINK]

This field specifies which loads are selected to be limited. The All option simultaneously limits all of the loads listed in this DemandManager. The RotateMany option limits all loads except for one which rotates sequentially through the loads listed. The RotateOne limits only one load which rotates sequentially through the loads listed. The time interval between rotations is set by the Rotation Duration field.

Field: Rotation Duration[LINK]

If the RotateOne or RotateMany option is used for Selection Control, this field sets the time interval [minutes] between rotations.

Field: Thermostat <#> Name[LINK]

The names of ZoneControl:Thermostat objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager. This field is extensible, so additional fields of this type can be added to the end of this object.

If a global thermostat statement is used (Ref: ZoneControl:Thermostat), then only that name need be entered and the demand limiting will be applied to all the zones for that thermostatic control. If only one of a set of zones from a global thermostat statement is desired, then the name to be entered is: <Zone Name> <Name of Thermostat Global Object>.

An example IDF showing how this object is used is provided below:

DemandManager:Thermostats,
  Thermostats Manager,         !- Name
  ,                                               !- Availability Schedule Name
  Fixed,                                     !- Reset Control
  60,                                           !- Minimum Reset Duration {minutes}
  19,                                           !- Maximum Heating Setpoint Reset {C}
  26,                                           !- Maximum Cooling Setpoint Reset {C}
  ,                                               !- Reset Step Change
  All,                                         !- Selection Control
  ,                                               !- Rotation Duration {minutes}
  SPACE1-1 Control,               !- Thermostat 1 Name
  SPACE2-1 Control,               !- Thermostat 2 Name
  SPACE3-1 Control,               !- Thermostat 3 Name
  SPACE4-1 Control,               !- Thermostat 4 Name
  SPACE5-1 Control;               !- Thermostat 5 Name

Outputs[LINK]

There are no output variables reported for the DemandManager:Thermostats object.

DemandManager:Ventilation[LINK]

The DemandManager:Ventilation object is used for limiting the ventilation rate calculated from the Controller:OutdoorAir object.

Field: Name[LINK]

The name of the DemandManager:Ventilation object.

Field: Availability Schedule Name[LINK]

The reference to the schedule object specifying the availability of this demand manager. A schedule value of zero indicates that this demand response (DR) is not applicable for that time period. A schedule greater than zero indicates that the demand response applies during the time period. If this field is blank, the schedule has values of one for all time period.

Field: Limit Control[LINK]

This field specifies the type of limiting control. There are three options. The FixedRate option reduces the ventilation to a specified air flow rate. The ReductionRatio specifies the multiplier of the ventilation rate. The Off option disables the demand manager in the simulation.

Field: Minimum Limit Duration[LINK]

The minimum amount of time [minutes] that the demand manager will continue to demand limit after being activated. This prevent loads from turning on and off every time step.

Field: Fixed Rate[LINK]

This field specifies the amount of fixed ventilation rate when the demand manager is active and FixedRate limit control is applied. The unit is m3/s.

Field: Reduction Ratio[LINK]

This field specifies the multiplier of the ventilation rate when the demand manager is active and ReductionRatio limit control is applied.

Field: Limit Step Change[LINK]

NOT YET IMPLEMENTED.

Field: Selection Control[LINK]

This field specifies which loads (ventilation rates) are selected to be limited. The All option simultaneously limits all of the loads listed in the demand manager. The RotateMany option limits all loads except for one which rotates sequentially through the loads listed. The RotateOne limits only one load which rotates sequentially through the loads listed. The time interval between rotations is set by the Rotation Duration field.

Field: Rotation Duration[LINK]

If the RotateOne of RotateMany option is used for Selection Control, this field sets the time interval [minues] between rotations.

Field: Controller Outdoor Air <#> Name[LINK]

The names of Controller:OutdoorAir objects defined elsewhere in the input file. These are the ventilation rates to be limited by this demand manager. Then objects are accommodated in the list by default. This field is extensible, so additional fields of this type can be added to the end of this object.

An example IDF showing how this object is used is provided below:

DemandManager:Ventilation,
  Ventilation Manager,         !- Name
  ,                            !- Availability Schedule Name
  ReductionRatio,              !- Reset Control
  60,                          !- Minimum Limit Duration {minutes}
  ,                            !- Fixed Rate {m3/s}
  0.5,                         !- Reduction Ratio
  ,                            !- Limit Step Change
  All,                         !- Selection Control
  ,                            !- Rotation Duration {minutes}
  OA Controller 1;             !- Controller:OutdoorAir Name

DemandManager:Ventilation Outputs[LINK]

There are no output variables reported for the DemandManager:Ventilation object.