modelBorefield

Base subsystem with geothermal borefield

Extends from Buildings.Obsolete.BaseClasses.ObsoleteModel (Icon for classes that are obsolete and will be removed in later versions), Buildings.Fluid.Interfaces.PartialTwoPortInterface (Partial model with two ports and declaration of quantities that are used by many models).

Information

This is a model for a borefield system with a variable speed pump and a mixing valve modulated to maintain a maximum inlet temperature.

The system is controlled based on the logic described in Buildings.Obsolete.DHC.ETS.Combined.Controls.Borefield. The pump flow rate is considered proportional to the pump speed under the assumption of a constant flow resistance in the borefield loop. This assumption is justified by the connection of the loop to the buffer tanks, and by the additional assumption that the bypass branch of the mixing valve is balanced with the direct branch.

(The parameter from_dp of the valve model is set to false to simplify the system of algebraic equations, which, in this specific case, alleviates non-convergence issues.)

Parameters

TypeNameDefaultDescription
Buildings.Fluid.Geothermal.Borefields.Data.Borefield.ExampledatBorFie
Modelica.Units.SI.PressuredpValBorFie_nominaldp_nominal/2Nominal pressure drop of control valve
Modelica.Units.SI.TemperatureTBorWatEntMaxMaximum value of borefield water entering temperature
RealspePumBorMin0.1Borefield pump minimum speed
Assumptions
BooleanallowFlowReversal (from PartialTwoPort)true= false to simplify equations, assuming, but not enforcing, no flow reversal
Nominal condition
Modelica.Units.SI.MassFlowRatem_flow_nominal (from PartialTwoPortInterface)Nominal mass flow rate
Modelica.Units.SI.Pressuredp_nominalPressure losses for the entire borefield (control valve excluded)
Advanced
Modelica.Units.SI.MassFlowRatem_flow_small (from PartialTwoPortInterface)1E-4*abs(m_flow_nominal)Small mass flow rate for regularization of zero flow
Advanced › Diagnostics
Booleanshow_T (from PartialTwoPortInterface)false= true, if actual temperature at port is computed

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Interfaces.FluidPort_aport_a (from PartialTwoPort)Fluid connector a (positive design flow direction is from port_a to port_b)
Modelica.Fluid.Interfaces.FluidPort_bport_b (from PartialTwoPort)Fluid connector b (positive design flow direction is from port_a to port_b)
Buildings.Controls.OBC.CDL.Interfaces.RealInput[2]yValIso_actualIsolation valves return position (fractional)
Buildings.Controls.OBC.CDL.Interfaces.RealInputuControl signal from supervisory
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPPumPump power

Components

TypeNameDefaultDescription
Modelica.Units.SI.MassFlowRatem_flow (from PartialTwoPortInterface)port_a.m_flowMass flow rate from port_a to port_b (m_flow > 0 is design flow direction)
Modelica.Units.SI.PressureDifferencedp (from PartialTwoPortInterface)port_a.p - port_b.pPressure difference between port_a and port_b
Medium.ThermodynamicStatesta_a (from PartialTwoPortInterface)if allowFlowReversal then Medium.setState_phX(port_a.p, noEvent(actualStream(port_a.h_outflow)), noEvent(actualStream(port_a.Xi_outflow))) else Medium.setState_phX(port_a.p, noEvent(inStream(port_a.h_outflow)), noEvent(inStream(port_a.Xi_outflow)))Medium properties in port_a
Medium.ThermodynamicStatesta_b (from PartialTwoPortInterface)if allowFlowReversal then Medium.setState_phX(port_b.p, noEvent(actualStream(port_b.h_outflow)), noEvent(actualStream(port_b.Xi_outflow))) else Medium.setState_phX(port_b.p, noEvent(port_b.h_outflow), noEvent(port_b.Xi_outflow))Medium properties in port_b
Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinearvalMixing valve controlling entering temperature
Buildings.DHC.ETS.BaseClasses.Pump_m_flowpumPump with prescribed mass flow rate
Buildings.Fluid.Sensors.TemperatureTwoPortsenTEntEntering temperature
BorefieldTypeborFieGeothermal borefield
Buildings.DHC.ETS.BaseClasses.JunctionsplFlow splitter
Buildings.Fluid.Sensors.TemperatureTwoPortsenTLvgLeaving temperature
Buildings.Obsolete.DHC.ETS.Combined.Controls.BorefieldconController
Buildings.Controls.OBC.CDL.Reals.MultiplyByParametergai1Scale to nominal mass flow rate

Contents

NameDescription
BorefieldType