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 |
---|---|
Coil | Record for coil model |
Damper | Record for damper model |
Fan | Record for fan model |
HeatPump | Record for heat pump model |
PumpMultiple | Record for multiple-pump models |
PumpSingle | Record for single pump model |
Valve | Record for valve model |
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).
Parameters
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 | |
Boolean | have_sou | Set to true for fluid ports on the source side | |
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).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Configuration | |||
Damper | typ | Equipment type | |
Mechanical | |||
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).
Parameters
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 for the equation fit model
When using
typMod=Buildings.Templates.Components.Types.HeatPumpModel.EquationFit
,
the design values declared at the top-level
are propagated by default to the performance data record per
under the assumption that the reference conditions used for assessing the
performance data match the design conditions.
This avoids duplicate parameter assignments when manually entering
the performance curve coefficients.
Note that this propagation does not persist when redeclaring or reassigning the record. This is because the equation fit method uses reference values that must match the ones used to compute the performance curve coefficients.
Also note that placeholders values are assigned to the performance curves,
the reference source temperature and the input power in
cooling mode to avoid assigning these parameters in case of non-reversible
heat pumps.
These values are unrealistic and must be overwritten for reversible heat pumps, which
is always the case when redeclaring or
reassigning the performance record per
.
Models that use this record will issue a warning if these placeholders values
are not overwritten in case of reversible heat pumps.
Extends from Modelica.Icons.Record (Icon for records).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Generic | perFit | perFit(dpHeaLoa_nominal=dpHe... | Performance data - Equation fit model |
Configuration | |||
HeatPump | typ | Equipment type | |
Boolean | is_rev | Set to true for reversible heat pumps, false for heating only | |
HeatPumpModel | typMod | Type of heat pump model | |
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
per
or 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).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Generic | per[max(nPum, 1)] | per(pressure(V_flow=if typ <... | Performance data - Each pump |
Density | rho_default | Modelica.Media.Water.Constan... | 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).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Generic | per | per(pressure(V_flow={0,1,2}*... | Performance data |
Density | rho_default | Modelica.Media.Water.Constan... | 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).
Parameters
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] |