Buildings.Templates.Components.HeatPumps

Heat pump models

Information

This package contains models for heat pumps.

Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).

Package Content

Name	Description
AirToWater	Air-to-water heat pump
WaterToWater	Water-to-water heat pump

Buildings.Templates.Components.HeatPumps.AirToWater

Air-to-water heat pump

Buildings.Templates.Components.HeatPumps.AirToWater

Information

This is a model for an air-to-water heat pump where the capacity and input power are computed by interpolating manufacturer data along the condenser entering or leaving temperature, the evaporator entering or leaving temperature and the part load ratio. The model can be configured to represent either a non-reversible (heating-only) heat pump (is_rev=false) or a reversible heat pump (is_rev=true).

This model is a wrapper for Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDep, which the user may refer to for the modeling assumptions. Note that, by default, internal safeties in this model are disabled.

Control points

Refer to the documentation of the base class Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep for a description of the available control input and output variables.

Extends from Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep (Interface for heat pump using load-dependent 2D table data).

Parameters

Type	Name	Default	Description
replaceable package MediumHeaWat		Water	HW medium
replaceable package MediumSou		Water	Source-side medium
replaceable package MediumAir		Air	Air medium
HeatPump	dat		Design and operating parameters
Configuration
HeatPump	typ	Buildings.Templates.Componen...	Equipment type
Boolean	is_rev		Set to true for reversible heat pumps, false for heating only
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Boolean	allowFlowReversalSou	false	Source side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal
Boolean	have_dpChiHeaWat	true	Set to true for CHW/HW pressure drop computed by this model, false for external computation
Boolean	have_dpSou	true	Set to true for source fluid pressure drop computed by this model, false for external computation
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Conservation equations
Dynamics	energyDynamics	Modelica.Fluid.Types.Dynamic...	Type of energy balance: dynamic (3 initialization options) or steady state

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
replaceable package MediumSou		Source-side medium
FluidPort_a	port_aSou	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_bSou	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus
Bus	busWea	Weather bus

Modelica definition

model AirToWater "Air-to-water heat pump" extends Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep ( redeclare final package MediumSou=MediumAir, final typ=Buildings.Templates.Components.Types.HeatPump.AirToWater, final allowFlowReversalSou=false, hp(use_intSafCtr=false)); Buildings.Controls.OBC.CDL.Reals.MultiplyByParameter mAir_flow( final k=mSouHea_flow_nominal) "Air mass flow rate"; Buildings.Controls.OBC.CDL.Conversions.BooleanToReal y1Rea "Convert on/off command into real"; Fluid.Movers.BaseClasses.IdealSource floSou( redeclare final package Medium=MediumAir, final m_flow_small=1E-4 * mSouHea_flow_nominal, final allowFlowReversal=allowFlowReversalSou, final control_m_flow=true, final control_dp=false) "Air flow source"; equation connect(y1Rea.y, mAir_flow.u); connect(floSou.port_b, TSouEnt.port_a); connect(port_aSou, floSou.port_a); connect(mAir_flow.y, floSou.m_flow_in); connect(hp.on, y1Rea.u); end AirToWater;

Buildings.Templates.Components.HeatPumps.WaterToWater

Water-to-water heat pump

Buildings.Templates.Components.HeatPumps.WaterToWater

Information

This is a model for a water-to-water heat pump where the capacity and input power are computed by interpolating manufacturer data along the condenser entering or leaving temperature, the evaporator entering or leaving temperature and the part load ratio. The model can be configured to represent either a non-reversible (heating-only) heat pump (is_rev=false) or a reversible heat pump (is_rev=true).

Control points

Refer to the documentation of the base class Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep for a description of the available control input and output variables.

Extends from Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep (Interface for heat pump using load-dependent 2D table data).

Parameters

Type	Name	Default	Description
replaceable package MediumHeaWat		Water	HW medium
replaceable package MediumSou		Water	Source-side medium
replaceable package MediumAir		Air	Air medium
HeatPump	dat		Design and operating parameters
Configuration
HeatPump	typ	Buildings.Templates.Componen...	Equipment type
Boolean	is_rev		Set to true for reversible heat pumps, false for heating only
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Boolean	allowFlowReversalSou	true	Source side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal
Boolean	have_dpChiHeaWat	true	Set to true for CHW/HW pressure drop computed by this model, false for external computation
Boolean	have_dpSou	true	Set to true for source fluid pressure drop computed by this model, false for external computation
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Conservation equations
Dynamics	energyDynamics	Modelica.Fluid.Types.Dynamic...	Type of energy balance: dynamic (3 initialization options) or steady state

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
FluidPort_a	port_aSou	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_bSou	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus
Bus	busWea	Weather bus

Modelica definition

model WaterToWater "Water-to-water heat pump" extends Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep ( final typ=Buildings.Templates.Components.Types.HeatPump.WaterToWater, hp( use_intSafCtr=false)); equation connect(port_aSou, TSouEnt.port_a); end WaterToWater;