HomeFeaturesExamplesTutorialsHelpTheoryVerificationPricingContact
BoreTherm / Example libraryExample 20 / 23
Worked feature example

Co-simulation

Couple the office borefield to the bundled heat-pump FMU, inspect its identity and connections, run coupled sizing, and export a field FMU and Modelica data record.

16Boreholes
-2.41 °CMinimum mean fluid temperature
16.03 °CMaximum mean fluid temperature
2Variants compared
01 / Project

What the example does

The office borefield is coupled to a heat pump model: the heat pump's efficiency follows the fluid temperature that comes out of the field, and its ground heat drives the field. The system runs for 25 years in one-hour steps, and the field is sized with the heat pump in the loop.

Inputs

InputValue
Field16 boreholes, 4 × 4 rectangle, spacing 6.0 × 6.0 m
Boreholeslength 150.0 m, top 4.0 m below the surface, diameter 140 mm
Constructionsingle U, PE pipe 32 × 2.9 mm, shank spacing 70 mm, grout 1.60 W/(m·K)
Groundthermal conductivity 2.60 W/(m·K), heat capacity 2.20 MJ/(m³·K), surface temperature 9.0 °C, geothermal heat flux 0.060 W/m²
Fluid and flow25 % monopropylene glycol, 0.50 l/s per borehole
Loadsmonthly: heating 200 MWh, hot water 8 MWh and cooling 45 MWh per year; peaks 100 kW heating and 45 kW cooling for 6 h
Heat pumpseasonal performance factors 3.8 heating, 2.8 hot water, 5.0 cooling
Design limitsmean fluid temperature between −3.0 °C and 20.0 °C
Period25 years
Systemborefield + heat pump model (FMI 2.0 co-simulation unit): COP = 0.5 T_sink / (T_sink − T_source), sink 35 °C; building heating 184 MWh/a
Run25 years, hybrid long-term mode, communication step 1 h

Run the example in BoreTherm

  1. Open Advanced analysis → Co-simulation → System: the blocks and their connections.
  2. Confirm that you trust the heat pump model when BoreTherm asks.
  3. On Co-simulation → Settings, choose the period and the long-term mode, and run the co-simulation.
  4. Co-simulation → Results: every signal of the run; Size with the co-simulation finds the length.
02 / How BoreTherm calculates it

How the coupled run works

1 Building loadmonthly heating demand→ heat pump input2 Heat pump modelCOP from the sourcetemperature → ground heat3 Borefieldground heat → outlet T(field g-function)4 Feedbackoutlet T and flow back tothe heat pump, every hour5 Long termhourly detail in chosenyears, hybrid in between6 Sizingrepeat at other lengths untilthe limits are just metTfMin −2.00 °C at 150 m; sized length 138.3 m
The loop between the heat pump model and the borefield.
  1. Building loadThe building's heating demand drives the heat pump.
  2. Heat pump modelThe COP depends on the source temperature: a colder field means more electricity and less heat from the ground.
  3. BorefieldBoreTherm calculates the field outlet temperature from the ground heat.
  4. FeedbackThe loop is closed explicitly once per communication step (1 h).
  5. Long termDetailed years alternate with a faster approximation in between.
  6. SizingThe coupled system is rerun at other lengths.
03 / In BoreTherm

The example in BoreTherm

Co-simulation → System: building load, heat pump and borefield.
Co-simulation → System: building load, heat pump and borefield.
Co-simulation → Settings: period, step and long-term mode.
Co-simulation → Settings: period, step and long-term mode.
Co-simulation → Results: field temperatures of the coupled run.
Co-simulation → Results: field temperatures of the coupled run.
04 / Results

Calculated results

Calculated with BoreTherm for every variant of the example. Displayed values are rounded.

Coupled metricValue
Modehybrid
Communication step [s]3,600.000
Tf min [°C]-1.997
Tf max [°C]9.165
Limits metYes
Required H [m]138.299
Required total length [m]2,212.785
FMU bytes42541291
Co-simulation results plotted from BoreTherm output
Chart of the BoreTherm results in the tables of this section.

Temperatures by variant

VariantBoreholesLength H [m]Tf min [°C]Tf max [°C]Rb* [m K/W]Pump [W]Design limits
office, fixed SPF16150.000-2.41316.0260.11943,033.2within limits
co-simulation, 150 m——-1.9979.165——within limits
co-simulation, sized——-2.9988.909——within limits
05 / Discussion

What the example shows

With the heat pump in the loop the minimum is −2.00 °C at 150 m, and coupled sizing finds 138.3 m: the heat pump draws less from a colder field than a fixed seasonal factor assumes. The years between the detailed ones follow the hybrid approximation.

The heat pump model is a small demonstration model. Co-simulation with other tools' models follows the FMI standard; check every model before relying on it.