modelPumpsPrimaryDedicated
Dedicated primary pumps
Information
This model represents dedicated primary HW pumps and, optionally, separate
dedicated primary CHW pumps if the parameter
have_pumChiWatDedHp is set to true. The pump components are
connected to the heat pump outlet, in a "pump away" configuration. Variable
speed or constant speed pumps can be modeled by setting the parameters
have_pumHeaWatPriVar and have_pumChiWatPriVar. If
headered pumps are modeled
(typArrPumPri=Buildings.Templates.Components.Types.PumpArrangement.Headered),
this component resolves to a direct fluid pass-through.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | nPumHeaWat | Number of primary HW pumps | |
| Integer | nPumChiWat | Number of primary CHW pumps | |
| Integer | idxConPumChiWat | if have_pumChiWatDedHp then nHp + 1 else 1 | Lowest index to connect polyvalent HP ports to primary CHW pump ports |
| Boolean | have_pumChiWatDedHp | have_hp and nPumChiWat > 0 and typArrPumPri == Buildings.Templates.Components.Types.PumpArrangement.Dedicated and not have_pumPriComHp | Set to true for HP with separate dedicated primary CHW pumps |
| Boolean | is_heaOnlHp | have_hp and nPumHeaWat > 0 and nPumChiWat == 0 and typArrPumPri == Buildings.Templates.Components.Types.PumpArrangement.Dedicated and not have_pumPriComHp | Set to true for heating-only (non-reversible) HP with dedicated primary HW pumps |
| Buildings.Templates.Components.Data.PumpMultiple | datPumHeaWat | HW pump parameters | |
| Buildings.Templates.Components.Data.PumpMultiple | datPumChiWat | CHW pump parameters | |
| Configuration | |||
| Boolean | have_hp | true | Set to true for plants with non-reversible or reversible heat pumps |
| Boolean | have_php | false | Set to true for plants with polyvalent heat pumps |
| Integer | nHp | Number of heat pumps (excluding polyvalent HPs) | |
| Integer | nPhp | 0 | Number of polyvalent heat pumps |
| Buildings.Templates.Components.Types.PumpArrangement | typArrPumPri | Type of primary pump arrangement | |
| Boolean | have_pumPriComHp | Set to true for HP with single dedicated primary pump serving both CHW and HW circuits | |
| Boolean | have_pumHeaWatPriVar | Set to true for variable speed primary HW pumps | |
| Boolean | have_pumChiWatPriVar | Set to true for variable speed primary CHW pumps | |
| Nominal condition | |||
| Modelica.Units.SI.PressureDifference[nPumHeaWat] | dpValCheHeaWat_nominal | fill(if typArrPumPri == Buildings.Templates.Components.Types.PumpArrangement.Dedicated then Buildings.Templates.Data.Defaults.dpValChe else 0, nPumHeaWat) | HW pump check valve pressure drop at design pump flow rate (selection conditions) |
| Modelica.Units.SI.PressureDifference[nPumChiWat] | dpValCheChiWat_nominal | fill(if typArrPumPri == Buildings.Templates.Components.Types.PumpArrangement.Dedicated and (have_pumChiWatDedHp or have_php) then Buildings.Templates.Data.Defaults.dpValChe else 0, nPumChiWat) | CHW pump check valve pressure drop at design pump flow rate (selection conditions) |
| Dynamics › Conservation equations | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamics.DynamicFreeInitial | Type of energy balance: dynamic (3 initialization options) or steady state |
| Dynamics › Nominal condition | |||
| Modelica.Units.SI.Time | tau | 1 | Time constant at nominal flow |
| Assumptions | |||
| Boolean | allowFlowReversal | true | Set to false to simplify equations, assuming, but not enforcing, no flow reversal |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bChiHeaWat | CHW/HW supply (to primary loop) | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nHp] | ports_aChiHeaWat | CHW/HW return (from primary loop) | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bChiHeaWatHp | CHW/HW return – HP entering | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bHeaWat | HW supply (to primary loop) – HP with dedicated pumps and (heating-only or separate CHW and HW pumps) | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bChiWat | CHW supply (to primary loop) | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nHp] | ports_aChiHeaWatHp | CHW/HW supply (HP leaving) | |
| Buildings.Templates.Plants.HeatPumps.Interfaces.Bus | bus | Plant control bus | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nPhp] | ports_aHeaWat | HW return (from primary loop) to polyvalent HP | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nPhp] | ports_aChiWat | CHW return (from primary loop) to polyvalent HP | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nPhp] | ports_bHeaWatRetShc | HW return – Polyvalent heat pump entering | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nPhp] | ports_bChiWatRetShc | CHW return – Polyvalent heat pump entering | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nPhp] | ports_aHeaWatPhp | HW supply – Polyvalent heat pump leaving | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nPhp] | ports_aChiWatPhp | CHW supply – Polyvalent heat pump leaving | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nPhp] | ports_bChiWatSupShc | CHW supply – Polyvalent heat pump leaving | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nPhp] | ports_bHeaWatSupShc | HW supply – Polyvalent heat pump leaving |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Templates.Components.Pumps.Multiple | pumHeaWat | Dedicated primary (HW) Pumps | |
| Buildings.Templates.Components.Pumps.Multiple | pumChiWat | Dedicated primary CHW pumps - Optional | |
| Buildings.Templates.Components.Routing.PassThroughFluid[nHp] | pasHdr | Direct fluid pass-through for headered primary pumps | |
| Fluid.FixedResistances.Junction[nHp] | junDedSep | Fluid junction for separate dedicated primary pumps | |
| Buildings.Templates.Components.Routing.PassThroughFluid[nHp] | pasDedCom | Direct fluid pass-through for dedicated pumps and (heating-only HP or common CHW/HW pump) | |
| Buildings.Templates.Components.Routing.PassThroughFluid[nPhp] | pasHdrHeaWatShc | Direct fluid pass-through for headered primary pumps | |
| Buildings.Templates.Components.Routing.PassThroughFluid[nPhp] | pasHdrChiWatShc | Direct fluid pass-through for headered primary pumps |
Contents
| Name | Description |
|---|---|
 Medium |
Revisions
-
July 10, 2026, by Antoine Gautier:
Refactored for plants with polyvalent heat pumps.
This is for #4512. -
March 29, 2024, by Antoine Gautier:
First implementation.