Optimisation Design Variables
Accessed from Parametric, Optimisation and UA/SA Analysis Settings dialog
Tip: The Edit Variables dialog should be used with caution because there is no Cancel button, so once the dialog is opened, any changes made cannot be undone and upon closing of the dialog, the variable will be saved, replacing the previous one, with the settings currently being shown on the screen. In the case where you have mistakenly added a variable (or made incorrect changes while editing an existing one) you can close the dialog and then delete the incorrect variable on the design variables tab on the main Edit Parametric, Optimisation and UA/SA Analysis Settings dialog. Alternatively if you haven't made any other changes since opening the main dialog , simply press Cancel on that dialog to lose all changes.
Design Variable
Variable type
Select the variable type from the browse list.
View the full list of variable types.
Natural ventilation/infiltration
- Natural ventilation rate - Used only when the Natural ventilation model option is set to Scheduled.
- Nat vent set-point temp - Requires a Natural ventilation system to have been included in the base model.
- Nat vent max temp difference - Requires a Natural ventilation system to have been included in the base model.
- Infiltration - Scheduled natural ventilation only. When this variable is applied infiltration is automatically activated in the optimisation simulations even if the Model infiltration model option is switched off in the base model.
- Airtightness - Value range between 0 and 4 to cover the 5 Airtightness slider settings when using Calculated natural ventilation. When this variable is applied infiltration is automatically activated in the optimisation simulations even if the Model infiltration model option is switched off in the base model.
- Crack template - Used only when the Natural ventilation model option is set to Calculated. When this variable is applied infiltration is automatically activated in the optimisation simulations even if the Model infiltration model option is switched off in the base model.
- % External window opens - Used only when the Natural ventilation model option is set to Calculated.
- % Roof window opens - Used only when the Natural ventilation model option is set to Calculated.
- Vent area - the area of the auto-generated external vents (does not affect custom drawn vents) - Used only when the Natural ventilation model option is set to Calculated.
- Internal vent area - the area of the auto-generated internal vents (does not affect custom drawn vents) - Used only when the Natural ventilation model option is set to Calculated.
- Roof vent area - the area of the auto-generated roof vents (does not affect custom drawn vents) - Used only when the Natural ventilation model option is set to Calculated.
- Mixed mode switch off when raining - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode max wind speed - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode min temperature - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode max temperature - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode min enthalpy - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode max enthalpy - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode min dew point temperature - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Mixed mode max dew point temperature - When this variable is applied the Mixed mode natural ventilation option is automatically activated in the optimisation simulations even if the Mixed Mode Zone Equipment > Mixed mode on model option is switched off in the base model. Note however that the Natural Ventilation > On model option must still be manually set in the base model for mixed mode setting to be applied in the simulation.
- Nat vent indoor min temp schedule -
- External window operation schedule - Used only when the Natural ventilation model option is set to Calculated.
- Internal window operation schedule - Used only when the Natural ventilation model option is set to Calculated.
- Roof window operation schedule - Used only when the Natural ventilation model option is set to Calculated.
- Earth tube ventilation rate - When this variable is applied the earthtube option is automatically activated in the optimisation simulations even if the Earth Tube > Include earthtube option is switched off in the base model.
- Limit value of opening nat vent modulation factor -
- Nat vent modulation lower value of Tin-Tout -
- Nat vent modulation upper value of Tin-Tout -
Glazing/shading
- Glazing template -
- Glazing type -
- Facade type -
- Window to wall % -
- Window frame type -
- Window blind type - When this variable is applied window blinds on external walls are automatically activated in the optimisation simulations even if the Window shading model option is switched off in the base model.
- Window shading control schedule - When this variable is applied window blinds on external walls are automatically activated in the optimisation simulations even if the Window shading model option is switched off in the base model.
- Local shading type - When this variable is applied local shading on external walls are automatically activated in the optimisation simulations even if the Local shading model option is switched off in the base model.
- Internal glazing type -
- Internal facade type -
- % Internal glazing -
- Internal window frame type -
- % Internal window opens -
- Roof glazing type -
- Roof facade type -
- Roof window frame type -
- Roof shading coefficient -
- Roof window blind type - When this variable is applied window blinds on roof surfaces are automatically activated in the optimisation simulations even if the Roof Window shading model option is switched off in the base model.
- Roof window shading control schedule - When this variable is applied window blinds on roof surfaces are automatically activated in the optimisation simulations even if the Roof Window shading model option is switched off in the base model.
Activity/occupancy/comfort setpoints
- Activity template -
- Occupancy density -
- Occupancy (Days/week) -
- Heating set-point temperature -
- Heating set-back temperature - Note that heating setback temperatures only apply when the Heating operation schedule includes values of 0.5 to indicate times of setback operation.
- Cooling set-point temperature
- Cooling set-back temperature - Note that heating setback temperatures only apply when the Cooling operation schedule includes values of 0.5 to indicate times of setback operation.
- Heating set-point PMV - Only applies when using the 4-Fanger comfort option for the Temperature control option for a Detailed HVAC simulation.
- Heating set-back PMV - Only applies when using the 4-Fanger comfort option for the Temperature control option for a Detailed HVAC simulation.
- Cooling set-point PMV - Only applies when using the 4-Fanger comfort option for the Temperature control option for a Detailed HVAC simulation.
- Cooling set-back PMV - Only applies when using the 4-Fanger comfort option for the Temperature control option for a Detailed HVAC simulation.
- Mech vent set-point temp -
- Mech vent max temp difference -
- Mech vent rate per person -
- Mech vent rate per area -
Constructions
- Construction template -
- Insulation - Pre-design construction and glazing data only. 0=Uninsulated, 1=Typical ref, 2=Energy code, 3=Best practice.
- Thermal mass - Pre-design construction and glazing data only. 0=Light, 1=Medium, 2=Heavy.
- External wall construction -
- Flat roof construction -
- Pitched roof construction (occ) -
- Pitched roof construction (unocc) -
- Semi-exposed ceiling construction -
- Semi-exposed floor construction -
- Ground floor construction -
- External floor construction -
- Internal floor construction -
- Wall sub-surface construction -
- Partition sub-surface construction -
- Roof sub-surface construction -
- External door construction -
- Internal door construction -
- Internal thermal mass construction - Construction used for hanging partitions and when a non-zero value has been entered for the zone internal thermal mass exposed
area on the Constructions tab under the Internal Thermal Mass header.
- Component block material -
- Wall below grade construction -
- Partition construction -
- Basement ground floor construction -
Internal gains/lighting
- Computer power density - Used only when the Equipment gain units model option is set to 1-Power density. When this variable is applied computer gains are automatically activated in the optimisation simulations even if the Computer > On model option is switched off in the base model.
- Equipment power density - Used only when the Equipment gain units model option is set to 1-Power density. When this variable is applied Office equipment gains are automatically activated in the optimisation simulations even if the Office Equipment > On model option is switched off in the base model.
- Miscellaneous power density - Used only when the Equipment gain units model option is set to 1-Power density. When this variable is applied Miscellaneous gains are automatically activated in the optimisation simulations even if the Miscellaneous > On model option is switched off in the base model.
- Catering power density - Used only when the Equipment gain units model option is set to 1-Power density. When this variable is applied Catering gains are automatically activated in the optimisation simulations even if the Catering > On model option is switched off in the base model.
- Process power density - Used only when the Equipment gain units model option is set to 1-Power density. When this variable is applied Process gains are automatically activated in the optimisation simulations even if the Process > On model option is switched off in the base model.
- Lighting template -
- General lighting power density - Used only when the Lighting gain units model option is set to 1-Power density. When this variable is applied general lighting gains are automatically activated in the optimisation simulations even if the General Lighting > On model option is switched off in the base model.
- General lighting normalised power density - Used only when the Lighting gain units model option is set to 2-Normalised Power density. When this variable is applied general lighting gains are automatically activated in the optimisation simulations even if the General Lighting > On model option is switched off in the base model.
- Task lighting power density - When this variable is applied task lighting gains are automatically activated in the optimisation simulations even if the Task and Display Lighting > On model option is switched off in the base model.
- External lighting -
- All gains - Used only when the Gains data model option is set to Lumped.
HVAC systems
- Simple HVAC template (Simple HVAC) - Simple HVAC only.
- HVAC template (Detailed HVAC) - Detailed HVAC only. Note that Detailed HVAC templates only support templates with a single HVAC zone group. The way that zones are allocated to the zone group is as follows. If the building is the target then all zones that don't use the <None> Simple HVAC template are included in the HVAC zone. Otherwise if individual zones are set as targets then only those zones are loaded to the HVAC zone group. In this case zones that are not included as targets will not be assigned an HVAC system and so will be unconditioned.
- Mechanical ventilation rate -
- Auxiliary energy - Simple HVAC only
- Pump etc energy - Simple HVAC only
- Boiler CoP - Simple HVAC only
- Heating system seasonal CoP - Simple HVAC only
- Cooling system CoP - Simple HVAC only
- Cooling system seasonal CoP - Simple HVAC only
- Heating operation schedule -
- Cooling operation schedule -
Location/weather/orientation
- Location template -
- Hourly weather data -
- Site orientation - adjusts the orientation of all objects on the site. See also Building rotation in the Other category.
Renewables
- Load centre 1 - the load centre variables can be useful for varying the number of PV panels in a study. Set up and select a number of load centres each one having a different number of PV panels.
- Load centre 2 - see Load centre 1
- Load centre 3 - see Load centre 1
- Load centre 4 - see Load centre 1
- Load centre 5 - see Load centre 1
Other
- Building rotation - adjusts the orientation of the building relative to the site. Building objects are rotated about the geometric centre point of all building objects. Care should be taken to ensure that building objects would not intersect with any site objects for all possible building rotations. Note that component blocks that are part of the wider site are not rotated with the building, but component blocks that are part of the building are. See under the help for Level setting under Component block settings. See also Site orientation in the Location/weather/orientation category.
- Zone capacitance multiplier -
Custom EMS
- Custom EMS - a special variable type which acts on IDF variables within EMS scripts. For example a line of EMS script such as
SET HeatingSetpoint = <Var,SPTemp,20>,
could be written and if a custom IDF variable with Variable key of SPTemp was included in the optimisation, then for each iteration of the simulation, the code in angle brackets would be automatically replaced, behind the scenes, with the currently tested setpoint temperature , e.g.
SET HeatingSetpoint = 20.7,
Custom IDF
- Custom IDF - a special variable type which adds a parametric variation to IDF files through an Output:PreprocessorMessage statement. This statement can be processed using CS-Script code together with the EpNet library for example.
Extra IDF is added to main IDF in the form:
Output:PreprocessorMessage,
EpNet Script,
Information,
Variable key,
CurrentValue;
Where Variable key is the setting made on the dialog, matching up with corresponding code in the scripts and CurrentValue would be automatically replaced with the value of the variable for the current iteration.
Important Note: You must write extra script to pre-process the IDF Output:PreprocessorMessage statement to ensure that variables of type Custom IDF have an effect on the simulations.
Custom Script
- Custom Script - a hook function is called in all active CS-Scripts and plugins to allow your to define your own custom variants of the model based on current variable values.
Note: All variable options are listed for selection regardless of the state of the model so care must be taken to select variables that are appropriate. For example, if the Scheduled natural ventilation model option is used then changes in the % External window opens variable (which only applies to Calculated natural ventilation) won't affect results.
Min value
The lowest value that this numeric design variable can take on. This option is only visible when a numeric variable type has been selected (above).
Max value
The highest value that this numeric design variable can take on. This option is only visible when a numeric variable type has been selected (above).
Step
Not used yet. This option is only visible when a numeric variable type has been selected (above).
Options list
Click on the browse button to open a list of components or templates for selection. Items can be selected by checking the appropriate checkboxes. Each item selected will be an option that can be applied during the optimisation process.
When a template is selected as the variable type, one of the selected templates from the list are loaded in each iteration of the optimisation analysis.
This option is only visible when a list variable type has been selected (above).
After the list option selection process has been completed the Variable Option Order dialog is displayed. See below.
List Variable Option Ordering
After clicking on the Options list browse button to select a list of discreet variable options selecting the options to use and closing the Select design options dialog, you will be presented with a further Variable Option Order dialog where you can define the order in which the variables are listed. Depending on the case it may or may not be important to list the options in the right order. Generally if the list of components or templates represents some sort of numerical sequence then it is important to set the order up correctly, otherwise it generally is not.
An example where the options should be listed in the right order is the case where a variable consists of a list of glazing components of incrementally varying U-value. For example the list might consist of 4 glazing systems having U-values 1.0, 1.5, 2.0 and 2.5 W/m2-K respectively. In this case it will help the optimiser to efficiently identify solutions best meeting objectives if you order the list in sequence of the U-values (ascending or descending order).
An example of a case where it is less important to list variable options in a particular order is a set of 4 completely different HVAC system templates such as Fan coil units, Hot water radiators with nat vent, VAV and reversible chilled/heated floor. In this case there is no clear sequence and ordering the list is not so important for efficient optimisation analysis.
Target
Target objects
This option allows you to select one or more object(s) to which the variations are to be applied.
The object(s) you select here are the places in the model where the variations will actually be applied. Normal model data inheritance rules apply so if you set the building as the target then the change will set for the building but will also inherit down to block, zone, surface and opening levels where appropriate. In this case any hard set data at block or lower levels will prevent inheritance in the normal way.
Key
Variable key
This data is available for variables of the Custom IDF and Custom Script categories. Enter the name of the variable to be used in one or more corresponding DB Erl / EMS <Var, VarName, DefaultValue> statements. The variable key entered here corresponds with the VarName value in the DB Erl script.