EMS Calling Points[LINK]
This section provides an overview of EnergyPlus’s program flow and describes the various places where you can use the EMS to initiate calls for custom controlling. The input object EnergyManagementSystem:ProgramCallingManager requires the user describe the timing for when the Erl programs are run. These EMS Calling Points correspond to places inside the EnergyPlus program where and when the EMS can be called to do something. The EMS offers a wide range of calling points. This section attempts to explain what you need to know about the EnergyPlus program flow so you can better understand which calling point to use for a particular application. Because the EMS needs to interact with the rest of the EnergyPlus computer program, you need a fairly high level of understanding of the inner workings of EnergyPlus. Finding the right point to insert your Erl override is a challenge. This is a complicated computer program. Using an interpreted language to override its calculations is no simple thing and should not be taken lightly.
The best calling point will depend on the type of actuator being controlled and the intent of the override activity. Unfortunately, there is no easy way to explain the inner workings of a model as large as EnergyPlus, so this section includes only a brief overview. We attempt to provide useful recommendations for the types of control that are best suited for particular calling points. But for the full details you will need to refer to the EnergyPlus source code, which you can obtain with a developer license.
This section starts with a series of three figures and then discusses them and the 14 calling points. Figure 1.1 shows the overall flow of an EnergyPlus model with some EMS calling points. Figure 1.2 shows the sequence for a single timestep with the remaining EMS calling points. Figure 1.3 is similar but shows the calling points for shortened system timesteps. These diagram the flow of procedures during a run from top to bottom.
When EnergyPlus runs a model, it first does various sizing and setup activities and then models the environment periods you ask for; e.g., design days and run periods. The built-in variable called CurrentEnvironment indentifies which of these is being simulated and any given time. Figure 1.1 diagrams the overall program flow starting at the top and listing certain key steps in outline form. EnergyPlus models contain a lot of input, and the internal processes to acquire and process that input take some time to complete. Before the model starts doing final calculations, it may have to do various sizing calculations and automatically design the size of components. It will also go through special setup periods that model a truncated set of timesteps for each environment period. In the diagram, this initial phase is not finished until just before the design periods begin. Two EMS calling points that occur only once in a given run, EndOfZoneSizing and EndOfSystemSizing, can be triggered during this initial setup phase. During the phase called “Setup Simulation,” the various timestep-based calling points diagrammed in Figure 1.2 will also be called.
Another thing that happens during the setup phase described above is that individual HVAC component models access their input data and do various setup calculations in preparation for the rest of the simulation. An EMS calling point (added for Version 7) called “AfterComponentInputReadIn” is available for selected HVAC components that allows triggering Erl programs at a point just after the component’s input data have been read in but before the component’s sizing routines have executed. This calling point is intended to be used with various actuators that are setup to override the autosize values that result from sizing.
To model environment periods, EnergyPlus runs through a serious of timesteps. Figure 1.2 diagrams the program flow for a single timestep where the timestep for the system modeling is equal to that for the zone load modeling. The system timestep can be shorter than the zone timestep. The usual process of modeling a timestep is to first calculate the zone loads during the “Predictor,” then model the response of the HVAC systems, and then calculate the resulting zone conditions during the “Corrector.” Within the HVAC system modeling, some system iterations are used to iteratively solve a system of systems. Figure 1.3 is a slightly modified version Figure 1.2 that diagrams the situation when the timestep of the system calculations has been reduced to half the length of the zone timestep.
EMS Calling Points[LINK]
This section provides an overview of EnergyPlus’s program flow and describes the various places where you can use the EMS to initiate calls for custom controlling. The input object EnergyManagementSystem:ProgramCallingManager requires the user describe the timing for when the Erl programs are run. These EMS Calling Points correspond to places inside the EnergyPlus program where and when the EMS can be called to do something. The EMS offers a wide range of calling points. This section attempts to explain what you need to know about the EnergyPlus program flow so you can better understand which calling point to use for a particular application. Because the EMS needs to interact with the rest of the EnergyPlus computer program, you need a fairly high level of understanding of the inner workings of EnergyPlus. Finding the right point to insert your Erl override is a challenge. This is a complicated computer program. Using an interpreted language to override its calculations is no simple thing and should not be taken lightly.
The best calling point will depend on the type of actuator being controlled and the intent of the override activity. Unfortunately, there is no easy way to explain the inner workings of a model as large as EnergyPlus, so this section includes only a brief overview. We attempt to provide useful recommendations for the types of control that are best suited for particular calling points. But for the full details you will need to refer to the EnergyPlus source code, which you can obtain with a developer license.
This section starts with a series of three figures and then discusses them and the 14 calling points. Figure 1.1 shows the overall flow of an EnergyPlus model with some EMS calling points. Figure 1.2 shows the sequence for a single timestep with the remaining EMS calling points. Figure 1.3 is similar but shows the calling points for shortened system timesteps. These diagram the flow of procedures during a run from top to bottom.
Overall Program Flow and EMS Calling Points [fig:overall-program-flow-and-ems-calling-points]
Timestep Sequence with EMS Calling Points [fig:timestep-sequence-with-ems-calling-points]
System Timestep Sequence with EMS Calling Points [fig:system-timestep-sequence-with-ems-calling]
When EnergyPlus runs a model, it first does various sizing and setup activities and then models the environment periods you ask for; e.g., design days and run periods. The built-in variable called CurrentEnvironment indentifies which of these is being simulated and any given time. Figure 1.1 diagrams the overall program flow starting at the top and listing certain key steps in outline form. EnergyPlus models contain a lot of input, and the internal processes to acquire and process that input take some time to complete. Before the model starts doing final calculations, it may have to do various sizing calculations and automatically design the size of components. It will also go through special setup periods that model a truncated set of timesteps for each environment period. In the diagram, this initial phase is not finished until just before the design periods begin. Two EMS calling points that occur only once in a given run, EndOfZoneSizing and EndOfSystemSizing, can be triggered during this initial setup phase. During the phase called “Setup Simulation,” the various timestep-based calling points diagrammed in Figure 1.2 will also be called.
Another thing that happens during the setup phase described above is that individual HVAC component models access their input data and do various setup calculations in preparation for the rest of the simulation. An EMS calling point (added for Version 7) called “AfterComponentInputReadIn” is available for selected HVAC components that allows triggering Erl programs at a point just after the component’s input data have been read in but before the component’s sizing routines have executed. This calling point is intended to be used with various actuators that are setup to override the autosize values that result from sizing.
To model environment periods, EnergyPlus runs through a serious of timesteps. Figure 1.2 diagrams the program flow for a single timestep where the timestep for the system modeling is equal to that for the zone load modeling. The system timestep can be shorter than the zone timestep. The usual process of modeling a timestep is to first calculate the zone loads during the “Predictor,” then model the response of the HVAC systems, and then calculate the resulting zone conditions during the “Corrector.” Within the HVAC system modeling, some system iterations are used to iteratively solve a system of systems. Figure 1.3 is a slightly modified version Figure 1.2 that diagrams the situation when the timestep of the system calculations has been reduced to half the length of the zone timestep.
Documentation content copyright © 1996-2023 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.