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:
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 1[LINK]
The key word defining the type of DemandManager.
Field: Demand Manager
Name 1[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.
Ten managers are accomodated in the list by default. The IDD
specification, however, is extensible and additional pairs may
be added by directly editing the IDD.
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
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.
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 1-10 Name[LINK]
The names of Exterior:Lights
objects defined elsewhere in the input file. These are the
loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD
specification, however, is extensible and additional fields
may be added by directly editing the IDD.
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
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.
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 1-10 Name[LINK]
The names of Lights
objects defined elsewhere in the input file. These are the
loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD
specification, however, is extensible and additional fields
may be added by directly editing the IDD.
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
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.
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 1-10 Name[LINK]
The names of ElectricEquipment
objects defined elsewhere in the input file. These are the
loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD
specification, however, is extensible and additional fields
may be added by directly editing the IDD.
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
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.
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 1-10
Name[LINK]
The names of ZoneControl:Thermostat
objects defined elsewhere in the input file. These are the
loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD
specification, however, is extensible and additional fields
may be added by directly editing the IDD.
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
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.
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 1-10 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. The IDD
specification, however, is extensible and additional fields
may be added by directly editing the IDD.
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.
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 1[LINK]
The key word defining the type of DemandManager.
Field: Demand Manager Name 1[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. Ten managers are accomodated in the list by default. The IDD specification, however, is extensible and additional pairs may be added by directly editing the IDD.
An example IDF showing how this object is used is provided below:
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 1-10 Name[LINK]
The names of Exterior:Lights objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD specification, however, is extensible and additional fields may be added by directly editing the IDD.
An example IDF showing how this object is used is provided below:
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 1-10 Name[LINK]
The names of Lights objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD specification, however, is extensible and additional fields may be added by directly editing the IDD.
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:
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 1-10 Name[LINK]
The names of ElectricEquipment objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD specification, however, is extensible and additional fields may be added by directly editing the IDD.
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:
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 1-10 Name[LINK]
The names of ZoneControl:Thermostat objects defined elsewhere in the input file. These are the loads to be limited by this DemandManager.
Ten objects are accomodated in the list by default. The IDD specification, however, is extensible and additional fields may be added by directly editing the IDD.
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:
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 1-10 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. The IDD specification, however, is extensible and additional fields may be added by directly editing the IDD.
An example IDF showing how this object is used is provided below:
DemandManager:Ventilation Outputs[LINK]
There are no output variables reported for the DemandManager:Ventilation object.
Documentation content copyright © 1996-2026 The Board of Trustees of the University of Illinois and the Regents of the University of California through the Ernest Orlando Lawrence Berkeley National Laboratory. All rights reserved. EnergyPlus is a trademark of the US Department of Energy.
This documentation is made available under the EnergyPlus Open Source License v1.0.