Buildings.Fluid.Geothermal.ZonedBorefields

Package with borefield models for thermal energy storage with multiple parallel loops

Information

Package with models for zoned borehole thermal energy storage systems.

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

Package Content

Name Description
Buildings.Fluid.Geothermal.ZonedBorefields.UsersGuide UsersGuide User's Guide
Buildings.Fluid.Geothermal.ZonedBorefields.OneUTube OneUTube Borefield model containing single U-tube boreholes
Buildings.Fluid.Geothermal.ZonedBorefields.TwoUTubes TwoUTubes Borefield model containing double U-tube boreholes
Buildings.Fluid.Geothermal.ZonedBorefields.Data Data Collection of data records for ground heat exchanger models
Buildings.Fluid.Geothermal.ZonedBorefields.Examples Examples Example models for zoned borefields
Buildings.Fluid.Geothermal.ZonedBorefields.Validation Validation Validation models for zoned geothermal energy storage
Buildings.Fluid.Geothermal.ZonedBorefields.Interfaces Interfaces Package with interface for bore field models
Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses BaseClasses Base classes used in Buildings.Fluid.Geothermal.ZonedBorefields

Buildings.Fluid.Geothermal.ZonedBorefields.OneUTube Buildings.Fluid.Geothermal.ZonedBorefields.OneUTube

Borefield model containing single U-tube boreholes

Buildings.Fluid.Geothermal.ZonedBorefields.OneUTube

Information

This model simulates a borehole thermal energy storage system with multiple zones of single U-tube boreholes. Boreholes within the same zone are connected in parallel. The borefield configuration and thermal parameters are defined in the borFieDat record.

Heat transfer to the soil is modeled using only one borehole heat exchanger per zone. The fluid mass flow rate into each borehole is divided to reflect the per-borehole fluid mass flow rate. The borehole model calculates the dynamics within the borehole itself using an axial discretization and a resistance-capacitance network for the internal thermal resistances between the individual pipes and between each pipe and the borehole wall.

The ground thermal response at each borehole segment is evaluated using analytical thermal response factors. Spatial and temporal superposition are used to evaluate the total temperature change at each of the borehole segments.

Extends from Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses.PartialStorage (Partial model for borehole thermal energy storage with independent borefield zones).

Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumMedium in the component
TimetLoaAgg3600.0Time resolution of load aggregation [s]
IntegernCel5Number of cells per aggregation level
IntegernSeg10Number of segments to use in vertical discretization of the boreholes
TemplateborFieDat Borefield data record
Assumptions
BooleanallowFlowReversaltrue= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRatem_flow_small[nPorts]1E-4*abs(m_flow_nominal)Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Booleanshow_Tfalse= true, if actual temperature at port is computed
Flow resistance
Booleanfrom_dp[nPorts]fill(false, nPorts)= true, use m_flow = f(dp) else dp = f(m_flow)
BooleanlinearizeFlowResistance[nPorts]fill(false, nPorts)= true, use linear relation between m_flow and dp for any flow rate
RealdeltaM[nPorts]fill(0.1, nPorts)Fraction of nominal flow rate where flow transitions to laminar
Dynamics
Conservation equations
DynamicsenergyDynamicsModelica.Fluid.Types.Dynamic...Type of energy balance: dynamic (3 initialization options) or steady state
Initialization
AbsolutePressurep_startMedium.p_defaultStart value of pressure [Pa]
TemperatureTFlu_start[nSeg]TGro_startStart value of fluid temperature [K]
Soil
TemperatureTExt0_start283.15Initial far field temperature [K]
TemperatureTExt_start[nSeg]{if z[i] >= z0 then TExt0_st...Temperature of the undisturbed ground [K]
Filling material
TemperatureTGro_start[nSeg]TExt_startStart value of grout temperature [K]
Temperature profile
Heightz010Depth below which the temperature gradient starts [m]
RealdT_dz0.01Vertical temperature gradient of the undisturbed soil for h below z0 [K/m]

Connectors

TypeNameDescription
FluidPort_aport_a[nPorts]Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_bport_b[nPorts]Fluid connector b (positive design flow direction is from port_a to port_b)
output RealOutputTBorAve[nZon]Average borehole wall temperature in the borefield [K]
output RealOutputQBorAve[nZon]Average (per borehole) heat transfer rate in each zone [W]

Modelica definition

model OneUTube "Borefield model containing single U-tube boreholes" extends Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses.PartialStorage( redeclare Buildings.Fluid.Geothermal.Borefields.BaseClasses.Boreholes.OneUTube borHol[nZon]); end OneUTube;

Buildings.Fluid.Geothermal.ZonedBorefields.TwoUTubes Buildings.Fluid.Geothermal.ZonedBorefields.TwoUTubes

Borefield model containing double U-tube boreholes

Buildings.Fluid.Geothermal.ZonedBorefields.TwoUTubes

Information

This model simulates a borehole thermal energy storage system with multiple zones of double U-tube boreholes. Boreholes within the same zone are connected in parallel. The borefield configuration and thermal parameters are defined in the borFieDat record.

Heat transfer to the soil is modeled using only one borehole heat exchanger per zone. The fluid mass flow rate into each borehole is divided to reflect the per-borehole fluid mass flow rate. The borehole model calculates the dynamics within the borehole itself using an axial discretization and a resistance-capacitance network for the internal thermal resistances between the individual pipes and between each pipe and the borehole wall.

The ground thermal response at each borehole segment is evaluated using analytical thermal response factors. Spatial and temporal superposition are used to evaluate the total temperature change at each of the borehole segments.

Extends from Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses.PartialStorage (Partial model for borehole thermal energy storage with independent borefield zones).

Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumMedium in the component
TimetLoaAgg3600.0Time resolution of load aggregation [s]
IntegernCel5Number of cells per aggregation level
IntegernSeg10Number of segments to use in vertical discretization of the boreholes
TemplateborFieDat Borefield data record
Assumptions
BooleanallowFlowReversaltrue= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRatem_flow_small[nPorts]1E-4*abs(m_flow_nominal)Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Booleanshow_Tfalse= true, if actual temperature at port is computed
Flow resistance
Booleanfrom_dp[nPorts]fill(false, nPorts)= true, use m_flow = f(dp) else dp = f(m_flow)
BooleanlinearizeFlowResistance[nPorts]fill(false, nPorts)= true, use linear relation between m_flow and dp for any flow rate
RealdeltaM[nPorts]fill(0.1, nPorts)Fraction of nominal flow rate where flow transitions to laminar
Dynamics
Conservation equations
DynamicsenergyDynamicsModelica.Fluid.Types.Dynamic...Type of energy balance: dynamic (3 initialization options) or steady state
Initialization
AbsolutePressurep_startMedium.p_defaultStart value of pressure [Pa]
TemperatureTFlu_start[nSeg]TGro_startStart value of fluid temperature [K]
Soil
TemperatureTExt0_start283.15Initial far field temperature [K]
TemperatureTExt_start[nSeg]{if z[i] >= z0 then TExt0_st...Temperature of the undisturbed ground [K]
Filling material
TemperatureTGro_start[nSeg]TExt_startStart value of grout temperature [K]
Temperature profile
Heightz010Depth below which the temperature gradient starts [m]
RealdT_dz0.01Vertical temperature gradient of the undisturbed soil for h below z0 [K/m]

Connectors

TypeNameDescription
FluidPort_aport_a[nPorts]Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_bport_b[nPorts]Fluid connector b (positive design flow direction is from port_a to port_b)
output RealOutputTBorAve[nZon]Average borehole wall temperature in the borefield [K]
output RealOutputQBorAve[nZon]Average (per borehole) heat transfer rate in each zone [W]

Modelica definition

model TwoUTubes "Borefield model containing double U-tube boreholes" extends Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses.PartialStorage( redeclare Buildings.Fluid.Geothermal.Borefields.BaseClasses.Boreholes.TwoUTube borHol[nZon]); end TwoUTubes;