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 - Equation fit model
WaterToWater	Water-to-water heat pump - Equation fit model
Validation	Package with validation models

Buildings.Templates.Components.HeatPumps.AirToWater

Air-to-water heat pump - Equation fit model

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 based on the equation fit method. The model can be configured to represent either a non-reversible heat pump (is_rev=false) or a reversible heat pump (is_rev=true). This model uses Buildings.Fluid.HeatPumps.EquationFitReversible, which the user may refer to for the modeling assumptions.

Control points

Refer to the documentation of the interface class Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit for a description of the available control input and output variables.

Extends from Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit (Interface for heat pump using equation fit model).

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_preDroChiHeaWat	true	Set to true for CHW/HW pressure drop computed by this model, false for external computation
Boolean	have_preDroSou	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 - Equation fit model" extends Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit( redeclare final package MediumSou=MediumAir, final typ=Buildings.Templates.Components.Types.HeatPump.AirToWater, final allowFlowReversalSou=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(bus.y1, y1Rea.u); end AirToWater;

Buildings.Templates.Components.HeatPumps.WaterToWater

Water-to-water heat pump - Equation fit model

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 based on the equation fit method. The model can be configured with the parameter is_rev to represent either a non-reversible heat pump (heating only) or a reversible heat pump. This model uses Buildings.Fluid.HeatPumps.EquationFitReversible, which the user may refer to for the modeling assumptions.

Control points

Refer to the documentation of the interface class Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit for a description of the available control input and output variables.

Extends from Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit (Interface for heat pump using equation fit model).

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_preDroChiHeaWat	true	Set to true for CHW/HW pressure drop computed by this model, false for external computation
Boolean	have_preDroSou	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 - Equation fit model" extends Buildings.Templates.Components.Interfaces.PartialHeatPumpEquationFit( final typ=Buildings.Templates.Components.Types.HeatPump.WaterToWater); equation connect(port_aSou, TSouEnt.port_a); end WaterToWater;