Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page

# Revision history [back]

You want to replace __Slat Angle Control__ with __Window Shading Control__ in your second actuator (see below).

EnergyManagementSystem:Actuator,
Window1_slat_angle,  !- Name
Sub Surface 1,           !- Actuated Component Unique Name
Window Shading Control,  !- Actuated Component Type
Slat Angle;          !- Actuated Component Control Type


You can think of "Window Shading Control" as one category of actuators. Within that category, there are two control types -- Control Status or __Slat Angle__. You're right that the documentation isn't great at explaining that, so what you can do is generate the EMS Data Dictionary (EDD) output file with detailed actuators options for your input file. This is done by adding an Output:EnergyManagementSystem object to your input file and setting the first input field for _Actuator Availability Dictionary Reporting_ to "Verbose". Save your input file, run a simulation, and EnergyPlus will generate the EDD output file for you to review actuator options.

You want to replace __Slat Angle Control__ with __Window Shading Control__ in your second actuator (see below).

EnergyManagementSystem:Actuator,
Window1_slat_angle,  !- Name
Sub Surface 1,           !- Actuated Component Unique Name
Window Shading Control,  !- Actuated Component Type
Slat Angle;          !- Actuated Component Control Type


You can think of "Window Shading Control" as one category of actuators. Within that category, there are two control types -- Control Status or __Slat Angle__. You're right that the documentation isn't great at explaining that, so what you can do is generate the EMS Data Dictionary (EDD) output file with detailed actuators options for your input file. This is done by adding an Output:EnergyManagementSystem object to your input file and setting the first input field for _Actuator Availability Dictionary Reporting_ to "Verbose". Save your input file, run a simulation, and EnergyPlus will generate the EDD output file for you to review actuator options.

The Output:EnergyManagementSystem object has three input fields that each tell EnergyPlus how much information to generate in the EDD output file. The first input field is about EMS Actuators, but the two other input fields also relate to EMS Internal Variables and EMS Programs. From these three input fields, the EDD output file will have three sections (one related to each input field). The section related to EMS actuators begins with the following comment line:

! <EnergyManagementSystem:Actuator Available>, Component Unique Name, Component Type,  Control Type, Units


Everything between this line (line #30 in the EDD file you shared) and the next similar comment line for internal variables is a potential actuator you can use. Searching for "slat" doesn't appear anywhere in this EDD file, which means that the __Slat Angle__ actuator isn't available. This is weird, since it appears that you have set up everything correctly for the blind and window shading control. After some testing, I discovered that changing your window shading control's _Type of Slat Angle Control_ input field from __FixedSlatAngle__ to __ScheduledSlatAngle__ (and then setting a schedule in the following input field) fixed the problem (updated input fields start with "*" below).

WindowShadingControl,
Thermal Zone 1,          !- Zone Name
1,                       !- Shading Control Sequence Number
,                        !- Construction with Shading Name
Office Activity,         !- Schedule Name
350,                     !- Setpoint {W/m2, W or deg C}
Yes,                     !- Shading Control Is Scheduled
No,                      !- Glare Control Is Active
Window Material Blind 1, !- Shading Device Material Name
*      ScheduledSlatAngle,          !- Type of Slat Angle Control for Blinds
*      Always Off Discrete,                        !- Slat Angle Schedule Name
,                        !- Setpoint 2 {W/m2 or deg C}
,                        !- Daylighting Control Object Name
Group,                   !- Multiple Surface Control Type
Sub Surface 1,           !- Fenestration Surface 1 Name
Sub Surface 2;           !- Fenestration Surface 2 Name


This is likely an issue with the EMS Application documentation (it should say "this slat angle EMS actuator only works for ScheduleSlatAngle control of blinds), but it could be a bug in EnergyPlus if the developers expected the actuator to work with blinds for all situations.

There are a few other fixes to make in your EMS program, so I'll email you my updated input file with more details.

You want to replace __Slat Slat Angle Control__ Control with __Window Window Shading Control__ Control in your second actuator (see below).

EnergyManagementSystem:Actuator,
Window1_slat_angle,  !- Name
Sub Surface 1,           !- Actuated Component Unique Name
Window Shading Control,  !- Actuated Component Type
Slat Angle;          !- Actuated Component Control Type


You can think of "Window Shading Control" as one category of actuators. Within that category, there are two control types -- Control Status or __Slat Angle__. Slat Angle. You're right that the documentation isn't great at explaining that, so what you can do is generate the EMS Data Dictionary (EDD) output file with detailed actuators options for your input file. This is done by adding an Output:EnergyManagementSystem object to your input file and setting the first input field for _Actuator Actuator Availability Dictionary Reporting_ Reporting to "Verbose". Save your input file, run a simulation, and EnergyPlus will generate the EDD output file for you to review actuator options.

The Output:EnergyManagementSystem object has three input fields that each tell EnergyPlus how much information to generate in the EDD output file. The first input field is about EMS Actuators, but the two other input fields also relate to EMS Internal Variables and EMS Programs. From these three input fields, the EDD output file will have three sections (one related to each input field). The section related to EMS actuators begins with the following comment line:

! <EnergyManagementSystem:Actuator Available>, Component Unique Name, Component Type,  Control Type, Units


Everything between this line (line #30 in the EDD file you shared) and the next similar comment line for internal variables is a potential actuator you can use. Searching for "slat" doesn't appear anywhere in this EDD file, which means that the __Slat Angle__ Slat Angle actuator isn't available. This is weird, since it appears that you have set up everything correctly for the blind and window shading control. After some testing, I discovered that changing your window shading control's _Type Type of Slat Angle Control_ Control input field from __FixedSlatAngle__ to __ScheduledSlatAngle__ FixedSlatAngle to ScheduledSlatAngle (and then setting a schedule in the following input field) fixed the problem (updated input fields start with "*" below).

WindowShadingControl,
Thermal Zone 1,          !- Zone Name
1,                       !- Shading Control Sequence Number
,                        !- Construction with Shading Name
Office Activity,         !- Schedule Name
350,                     !- Setpoint {W/m2, W or deg C}
Yes,                     !- Shading Control Is Scheduled
No,                      !- Glare Control Is Active
Window Material Blind 1, !- Shading Device Material Name
*      ScheduledSlatAngle,          !- Type of Slat Angle Control for Blinds
*      Always Off Discrete,                        !- Slat Angle Schedule Name
,                        !- Setpoint 2 {W/m2 or deg C}
,                        !- Daylighting Control Object Name
Group,                   !- Multiple Surface Control Type
Sub Surface 1,           !- Fenestration Surface 1 Name
Sub Surface 2;           !- Fenestration Surface 2 Name


This is likely an issue with the EMS Application documentation (it should say "this slat angle EMS actuator only works for ScheduleSlatAngle control of blinds), but it could be a bug in EnergyPlus if the developers expected the actuator to work with blinds for all situations.

There are a few other fixes to make in your EMS program, so I'll email you my updated input file with more details.