Buildings.Templates.Components.Data
Records for design and operating parameters
Information
This package provides records for design and operating parameters.
Extends from Modelica.Icons.MaterialPropertiesPackage (Icon for package containing property classes).
Package Content
| Name | Description |
|---|---|
| Record for chiller model | |
| Record for coil model | |
| Record for damper model | |
| Record for fan model | |
| Record for heat pump model | |
| Record for multiple-pump models | |
| Record for single pump model | |
| Record for valve model |
Buildings.Templates.Components.Data.Chiller
Record for chiller model
Information
This record provides the set of sizing and operating parameters for
the classes within
Buildings.Templates.Components.Chillers.
It is composed of a set of parameters corresponding to the design
(selection) conditions and a sub-record per providing
the chiller performance data.
The design capacity is used to parameterize the chiller model.
The capacity (and power) computed from the external performance data file
is automatically scaled by the chiller model to match the value provided
at design conditions.
Note that the design value for condenser cooling fluid (e.g., condenser water) mass flow rate is only required for water-cooled chillers. Air-cooled chillers use a default outdoor air flow assignment since the chiller model doesn't explicitly calculate fan power based on outdoor air flow and condenser pressure drop. Instead, fan power is integrated into the chiller power computed from the performance data. This is because both US (AHRI Standard 550/590) and European (EN14511) chiller performance rating standards incorporate fan power into the rated total input power.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Generic | per | per(mCon_flow_nominal=mCon_f... | Cooling performance data |
| Power | P_min | 0 | Minimum power when system is enabled with compressor cycled off [W] |
| Configuration | |||
| Chiller | typ | Type of chiller | |
| Nominal condition | |||
| MassFlowRate | mChiWat_flow_nominal | CHW mass flow rate [kg/s] | |
| MassFlowRate | mCon_flow_nominal | Condenser cooling fluid (e.g. CW) mass flow rate [kg/s] | |
| HeatFlowRate | cap_nominal | Cooling capacity [W] | |
| PressureDifference | dpChiWat_nominal | CHW pressure drop [Pa] | |
| PressureDifference | dpCon_nominal | Condenser cooling fluid pressure drop [Pa] | |
| Temperature | TChiWatSup_nominal | CHW supply temperature [K] | |
| Temperature | TCon_nominal | Condenser entering or leaving fluid temperature (depending on per.use_TConOutForTab) [K] | |
Modelica definition
Buildings.Templates.Components.Data.Coil
Record for coil model
Information
This record provides the set of sizing parameters for the classes within Buildings.Templates.Components.Coils.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Carrier_Centurion_50PG06 | datCoi | redeclare parameter Building... | Performance data record of evaporator coil |
| Configuration | |||
| Coil | typ | Equipment type | |
| Valve | typVal | Type of valve | |
| Nominal condition | |||
| MassFlowRate | mAir_flow_nominal | Air mass flow rate [kg/s] | |
| PressureDifference | dpAir_nominal | Air pressure drop [Pa] | |
| MassFlowRate | mWat_flow_nominal | Liquid mass flow rate [kg/s] | |
| PressureDifference | dpWat_nominal | Liquid pressure drop across coil [Pa] | |
| PressureDifference | dpValve_nominal | Liquid pressure drop across fully open valve [Pa] | |
| HeatFlowRate | cap_nominal | Coil capacity [W] | |
| Temperature | TWatEnt_nominal | Nominal entering liquid temperature [K] | |
| Temperature | TAirEnt_nominal | Nominal entering air temperature [K] | |
| MassFraction | wAirEnt_nominal | Nominal entering air humidity ratio [1] | |
Modelica definition
Buildings.Templates.Components.Data.Damper
Record for damper model
Information
This record provides the set of sizing parameters for the class Buildings.Templates.Components.Actuators.Damper.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Configuration | |||
| Damper | typ | Equipment type | |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Air mass flow rate [kg/s] | |
| PressureDifference | dp_nominal | Air pressure drop [Pa] | |
| PressureDifference | dpFixed_nominal | 0 | Air pressure drop of fixed elements in series with damper [Pa] |
Modelica definition
Buildings.Templates.Components.Data.Fan
Record for fan model
Information
This record provides the set of sizing parameters for the classes within Buildings.Templates.Components.Fans.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Generic | per | per(pressure(V_flow={0,1,2}*... | Performance data |
| Configuration | |||
| Fan | typ | Equipment type | |
| Integer | nFan | Number of fans | |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Total air mass flow rate [kg/s] | |
| PressureDifference | dp_nominal | Total pressure rise [Pa] | |
Modelica definition
Buildings.Templates.Components.Data.HeatPump
Record for heat pump model
Information
This record provides the set of sizing and operating parameters for heat pump models that can be found within Buildings.Templates.Components.HeatPumps.
Performance data
The design capacity is used to parameterize the heat pump model. The capacity (and power) computed from the external performance data file will be scaled to match the value provided at design conditions.
Also note that placeholders values are assigned to some parameters
of the subrecord perCoo which is used to specify
the performance data in cooling mode.
These values should be overwritten for reversible heat pumps.
This overwriting happens automatically when redeclaring or reassigning
the performance record perCoo.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| GenericHeatPump | perHea | perHea(mCon_flow_nominal=mHe... | Performance data in heating mode |
| Generic | perCoo | perCoo(mCon_flow_nominal=mSo... | Performance data in cooling mode |
| Power | P_min | 0 | Minimum power when system is enabled with compressor cycled off [W] |
| Configuration | |||
| HeatPump | typ | Equipment type | |
| Boolean | is_rev | Set to true for reversible heat pumps, false for heating only | |
| SpecificHeatCapacity | cpHeaWat_default | Buildings.Utilities.Psychrom... | HW default specific heat capacity [J/(kg.K)] |
| SpecificHeatCapacity | cpSou_default | if typ == Buildings.Template... | Source fluid default specific heat capacity [J/(kg.K)] |
| Nominal condition | |||
| MassFlowRate | mHeaWat_flow_nominal | HW mass flow rate [kg/s] | |
| PressureDifference | dpHeaWat_nominal | Pressure drop at design HW mass flow rate [Pa] | |
| HeatFlowRate | capHea_nominal | Heating capacity [W] | |
| Temperature | THeaWatSup_nominal | (Highest) HW supply temperature [K] | |
| MassFlowRate | mChiWat_flow_nominal | CHW mass flow rate [kg/s] | |
| HeatFlowRate | capCoo_nominal | Cooling capacity [W] | |
| Temperature | TChiWatSup_nominal | (Lowest) CHW supply temperature [K] | |
| Temperature | TSouHea_nominal | OAT or source fluid supply temperature (evaporator entering) in heating mode [K] | |
| MassFlowRate | mSouWwHea_flow_nominal | Source fluid mass flow rate in heating mode [kg/s] | |
| PressureDifference | dpSouWwHea_nominal | Source fluid pressure drop in heating mode [Pa] | |
| Temperature | TSouCoo_nominal | OAT or source fluid supply temperature (condenser entering) in cooling mode [K] | |
| MassFlowRate | mSouWwCoo_flow_nominal | Source fluid mass flow rate in cooling mode [kg/s] | |
Modelica definition
Buildings.Templates.Components.Data.PumpMultiple
Record for multiple-pump models
Information
This record provides the set of sizing and operating parameters for the multiple-pump model Buildings.Templates.Components.Pumps.Multiple.
A default flow characteristic is provided, which goes through the design operating point and spans over 0 and twice the design flow rate at maximum speed. This default characteristic is based on a least squares polynomial fit of the characteristics from Buildings.Fluid.Movers.Data.Pumps.Wilo. The user may refer to the documentation of Buildings.Fluid.HydronicConfigurations.UsersGuide.ModelParameters for further details. Note that a default medium density is used to parameterize the pump characteristic. So models that use this record should overwrite this default value with the density of the medium in use, especially in the case of a water/glycol mix.
In order to modify the default characteristic, one may use either of the following methods.
- Assign the whole subrecord
peror only its componentper.pressure. In this case the elementsper[i]may differ one from another. This is the recommended approach for unequally sized units such as dedicated pumps. - Redeclare the component
per. In this case the elementsper[i]are all equal to the redeclared record instance. This is the recommended approach for equally sized units such as headered pumps.
Those various use cases are illustrated in Buildings.Templates.Components.Validation.PumpMultipleRecord.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Generic | per[max(nPum, 1)] | per(pressure(V_flow=if typ <... | Performance data - Each pump |
| Density | rho_default | Buildings.Media.Water.d_const | Default medium density [kg/m3] |
| Configuration | |||
| Pump | typ | Equipment type | |
| Integer | nPum | Number of pumps | |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal[nPum] | Mass flow rate - Each pump [kg/s] | |
| PressureDifference | dp_nominal[nPum] | Total pressure rise - Each pump [Pa] | |
Modelica definition
Buildings.Templates.Components.Data.PumpSingle
Record for single pump model
Information
This record provides the set of sizing and operating parameters for the single pump model Buildings.Templates.Components.Pumps.Single.
A default flow characteristic is provided and can be overwritten as described in the documentation of Buildings.Templates.Components.Data.PumpMultiple in the more generic case of multiple units.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Generic | per | per(pressure(V_flow=if typ <... | Performance data |
| Density | rho_default | Buildings.Media.Water.d_const | Default medium density [kg/m3] |
| Configuration | |||
| Pump | typ | Equipment type | |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Mass flow rate [kg/s] | |
| PressureDifference | dp_nominal | Total pressure rise [Pa] | |
Modelica definition
Buildings.Templates.Components.Data.Valve
Record for valve model
Information
This record provides the set of sizing parameters for the class Buildings.Templates.Components.Actuators.Valve.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| Configuration | |||
| Valve | typ | Equipment type | |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Nominal mass flow rate of fully open valve [kg/s] | |
| PressureDifference | dpValve_nominal | Nominal pressure drop of fully open valve [Pa] | |
| PressureDifference | dpFixed_nominal | 0 | Nominal pressure drop of pipes and other equipment in flow leg [Pa] |
| PressureDifference | dpFixedByp_nominal | dpFixed_nominal | Nominal pressure drop in the bypass line [Pa] |