HomeFeaturesExamplesTutorialsHelpTheoryVerificationPricingContact
BoreTherm Online help

Design limits & simulation

Set the design period and minimum/maximum mean fluid temperatures. Optional inlet limits constrain inlet temperature separately. Select monthly or hourly treatment, response boundary condition and short-time model. Dynamic boreholes resolve axial fluid transport in selected windows; steady results cover the remaining period. The direct 3D simulation (Full FEM, with transient boreholes and optional coupled groundwater flow) is chosen on the Project page and set up under Advanced analysis › 3D / Full FEM. Calculation › Calculate (F5) checks the design at its length; Calculation › Size borehole length (F6) finds the length within the bounds.

Step-by-step workflows · Menus and keyboard

Controls captured from the BoreTherm GUI. Ranges are interface bounds; example values depend on the open project.
ControlMeaning / actionUnitRange / choicesExample value
Minimum mean fluid temperature:Minimum allowed mean fluid temperature (heating). Must stay a few kelvin above the freezing point of the fluid. Typical −5 … 0 °C (glycol), > 2 °C (water).°C-40 to 40-3
Maximum mean fluid temperature:Maximum allowed mean fluid temperature (cooling / heat injection). Typical 15 … 35 °C.°C-20 to 9020
Also limit the minimum inlet temperatureThe design limits apply to the mean fluid temperature (classic monthly method). The fluid entering the field in heating is colder than the mean by half the temperature drop Q / (ṁ cp), and it may freeze although Tf,min holds.Checked: the lowest inlet temperature with flow is a design limit as well; the limits check and the sizing use it like Tf,min. The results always show the inlet and outlet minimum and the margin to the freezing point.
Minimum inlet temperature:Lowest allowed inlet temperature of the field (with flow). Keep it above the freezing point of the fluid.°C-40 to 40-5
Period:Simulation period (1 – 100 years).years1 to 10025
Start month:Month in which operation starts.January / February / March / April / May / June / July / August / September / October / November / December
Hourly method:Temporal superposition method for hourly loads: FFT convolution (Marcotte Pasquier 2008, no aggregation error) or Claesson Javed (2012) load aggregation.FFT convolution (exact) / Load aggregation (Claesson–Javed)
Rb* method:How the effective resistance Rb* accounts for heat exchange between the legs:uniform heat flux: Rb* = Rb + H² / (3 Ra (ṁcp)²)uniform temperature: Rb* = Rb η coth(η), η = H / (ṁcp √(Ra Rb))Uniform heat flux (Hellström) / Uniform temperature (Hellström)
Peak response:Thermal response to the monthly peak-load pulses of duration tp:field g-function: g of the whole field at tp (default);single-borehole asymptote: Eskilson's short-time asymptote g = ln(H / 2rb) + ½ ln(tp / ts).The two usually differ by less than 0.1 K. Hourly simulations are not affected.Field g-function (BoreTherm) / Single-borehole asymptote (Eskilson)
Minimum length:Shortest borehole length considered by sizing.m5 to 200020
Maximum length:Longest borehole length considered by sizing.m10 to 3000300
Tolerance:Sizing tolerance on the borehole length.m0.01 to 100.1
Max. iterations:Maximum number of iterations of the length search.5 to 100060
Check the limits in the last year onlySize the borehole length on the last simulated year only, assuming it is the worst one. By default every year is checked. When the ground warms up or cools down over the years (e.g. cooling-dominated loads), an earlier year can be colder than the last one, and the last-year-only length then violates the limit in that year.
Boundary condition:Boundary condition at the borehole wall.UBWT matches Eskilson's g-functions. UHTR is faster but gives higher long-term temperatures. UFT gives every segment the same mean fluid temperature, with its local borehole resistance, so segments with a higher resistance (insulated sections, low-λ grout) exchange less heat. Use it with borehole sections.MIFT follows the fluid along every borehole and through the borehole connections: all strings get the same inlet temperature, boreholes in series get the outlet of the one before, and the heat exchange along the depth follows the fluid temperature (Cimmino 2015). The most detailed choice for series strings, low flows and insulated sections. Rb* is then the effective resistance of the whole network, R*net.Energy piles, and short, wide boreholes (length below 200 diameters), with the head within two radii of the ground surface: use UHTR. UBWT then depends on the segmentation and is not conservative in heating (the results warn); a design made an energy pile is set to UHTR.Uniform borehole wall temperature (UBWT) / Uniform heat transfer rate (UHTR) / Uniform fluid temperature (UFT) / Mixed inlet fluid temperature (MIFT)
Method:Detailed: every segment pair. Similarities: identical pairs evaluated once. Equivalent: clusters similar boreholes (Prieto Cimmino 2021), for fields of hundreds of boreholes.Similarities (recommended) / Detailed (all segment pairs) / Equivalent boreholes (large fields)
Segments per borehole:Segments per borehole for UBWT (8 – 12 recommended).1 to 1008
End segment ratio:Length of the end segments relative to H (segments refined toward both ends). Strictly between 0 and 0.5; 1/n gives equal segments (0.125 for 8 segments); not used with 1 or 2 segments. The end segments are at least two borehole radii long (this matters for energy piles only).0 to 0.50.02
Distance tolerance:Relative tolerance for treating distances as identical (similarities method).0 to 0.50.01
Approximate FLS (Cimmino 2021 closed form)Use the closed-form approximation of the finite line source instead of numerical integration. Faster, slightly less accurate.
FLS terms:Number of terms of the approximate FLS expansion (about 10).1 to 5010
Cylindrical short-time correctionAdd the cylindrical heat source correction (CHS − ILS) to the self response. Improves short peak loads of a few hours.
Ground surface:Thermal condition of the ground surface in the g-function.Isothermal (default, classic monthly method): the surface stays at the surface temperature.Adiabatic: no heat flow through the surface, e.g. energy piles under a heated building with an insulated floor slab. The two are the bounds of a real building. Vertical boreholes and the analytic engine only.Isothermal (open ground) / Adiabatic (insulated slab)
Model:How the inside of the borehole is modelled.Steady resistance: the fluid and the grout store no heat; the mean fluid temperature is Tf = Tb + q Rb* at every month or hour. The default.Short-time capacity: the steady model plus the heat capacity of the fluid and the grout in the first hours of every load change (equivalent-pipe radial model). Less extreme hourly temperatures and peaks; costs almost nothing.Dynamic: the fluid flows through the borehole and the grout stores heat, step by step (resistance–capacity network along the depth). Gives the transit delay, the temperature profile along the depth, pump on/off and inlet temperatures at minute resolution. Needs hourly or time-series loads; a 25-year run takes about a minute.Steady resistance (Rb*) / Short-time capacity / Dynamic (transient fluid)
Time step:Control step: the load, the flow and the inlet temperature are constant within a step, and the borehole wall is coupled to the ground once per step. Inside a step the fluid moves in sub-steps of a fraction of its transit time, so a shorter control step costs little more. The step of time-series loads must be a multiple of it.1 min / 2 min / 5 min / 10 min / 15 min / 20 min / 30 min / 1 h / 2 h / 3 h / 6 h
Depth step Δz:Height of the depth levels of the borehole (rounded so that the levels fill the length exactly). 2 m is accurate for most boreholes; coarser levels run faster.m0.25 to 502
Inlet:Ground load given: the loads set the heat taken from or given to the ground; the inlet temperature follows from the outlet and the load (heat-pump side).Inlet temperature given: the inlet temperature column of the time-series loads drives the borehole (thermal response test, measured data, a heat-pump model); the load follows.Ground load given (inlet follows) / Inlet temperature given (time series)
Pump:Constant: the project flow, the pump always runs.On/off by load: the pump stops when the load is at or below the threshold and runs at least the minimum run time once started. With the pump off the fluid stands still and exchanges heat with the grout only.From the time series: the flow column of the time-series loads (total field flow; 0 = pump off).Constant (always on) / On/off by load / From the time series
Pump-off threshold:On/off by load: the pump is off while the ground load |Q| is at or below this value.kW0 to 1000000
Minimum run time:On/off by load: once started, the pump runs at least this long.min0 to 14400
Temperature-dependent fluid propertiesRe-evaluate the fluid properties (and with them the Reynolds number, the convection and the pipe resistances) when the mean fluid temperature moves by more than 0.5 K. Captures laminar flow in cold periods. Otherwise the properties of the Fluid flow page are used throughout.
Ground coupling:How the boreholes are coupled to the ground.Uniform: one wall temperature for the whole field (the default).Per ring: the boreholes of each ring (the convex-hull layers of the field, as the BTES network patterns use them) share a wall temperature. Resolves the hot centre and the cooler edge of a thermal energy store at little extra cost.Per borehole: every borehole has its own wall temperature; for unsymmetric networks. Slow for large fields.Uniform (whole field) / Per ring / Per borehole
Flow direction:Flow direction through the network. Normal is the network as drawn on the Field layout page (the charging direction); reversed runs every string backwards and enters every borehole by its other leg.Fixed: always normal.From the time series: the direction column (+1 normal, −1 reversed, 0 keeps the direction).Automatic: with a given inlet temperature, normal when it is above the fluid at the normal inlet by the hysteresis, reversed when it is below the fluid at the normal outlet by the hysteresis; with a given load, normal while injecting and reversed while extracting.Time series, else automatic: the column where it is not 0, the rule elsewhere.Fixed (as drawn) / From the time series / Automatic / Time series, else automatic
Reversal hysteresis:Automatic direction with a given inlet temperature: the band ΔTh around the fluid temperatures that keeps the direction (avoids chatter).K0 to 201
Minimum time between reversals:Automatic direction: the minimum time between two flow reversals.h0 to 7201
Dynamic periods:Periods run with the dynamic model; the steady model runs hourly in between, with one continuous ground history. The first and the last year usually hold the extreme temperatures at a fraction of the run time. Steady model only: no dynamic period; the steady model (per ring or per borehole with that coupling) runs the whole period at the time step, a fast hourly run of a thermal energy store.Whole period / First and last year / Custom periods / Steady model only
Custom periods [d]:Custom periods in days from the start of operation, as start–end, separated by semicolons.
Output interval:Resolution of the stored time series (mean values over each interval), a multiple of the time step. The full-resolution periods keep every time step.5 min / 10 min / 15 min / 30 min / 1 h / 2 h / 3 h / 6 h / 1 day(s)
Full resolution [d]:Periods stored at full resolution (one value per time step), in days from the start of operation as start–end, separated by semicolons.
Depth profiles at [d]:Times in days from the start of operation at which the temperatures along the depth are stored, separated by semicolons. They must lie in the dynamic periods.
Sub-steps per transit:Fluid sub-steps per transit time through the borehole. 10 is accurate to about 2 mK for single and double U-pipes; use 20 to 40 for coaxial pipes or for 1 mK (at twice the run time).2 to 20010
Warm-up:A dynamic period that starts after the start of operation begins this much earlier, so that the borehole interior (started from the steady model) has settled.h0 to 72024
Classic-method compatibilitySets the three classic-method compatibility options:Convection (Borehole cross-section page) = Colburn: Nu = 4.0 laminar, Nu = 0.023 Re0.8 Pr1/3 turbulent, no transition blend (instead of Gnielinski).Peak response = single-borehole asymptote g = ln(H / 2rb) + ½ ln(tp / ts) for the monthly peak pulses (instead of the field g-function).Sizing checks the limits in the last simulated year only (instead of every year).The Rb* method (uniform heat flux) and the g-function (UBWT) already match the classic monthly method; a fixed Rb* can be set on the Borehole cross-section page.
BoreTherm defaultsRestores BoreTherm's defaults for the three options: Gnielinski convection, field g-function for the peaks, sizing on every year.
Minimum mean fluid temperature:Minimum allowed mean fluid temperature (heating). Must stay a few kelvin above the freezing point of the fluid. Typical −5 … 0 °C (glycol), > 2 °C (water).°F-40 to 10426.6
Maximum mean fluid temperature:Maximum allowed mean fluid temperature (cooling / heat injection). Typical 15 … 35 °C.°F-4 to 19468
Minimum inlet temperature:Lowest allowed inlet temperature of the field (with flow). Keep it above the freezing point of the fluid.°F-40 to 10423
Minimum length:Shortest borehole length considered by sizing.ft16 to 656266
Maximum length:Longest borehole length considered by sizing.ft33 to 9843984
Tolerance:Sizing tolerance on the borehole length.ft0.03 to 32.810.33
Depth step Δz:Height of the depth levels of the borehole (rounded so that the levels fill the length exactly). 2 m is accurate for most boreholes; coarser levels run faster.ft0.82 to 164.046.56
Pump-off threshold:On/off by load: the pump is off while the ground load |Q| is at or below this value.MW0 to 1000
Reversal hysteresis:Automatic direction with a given inlet temperature: the band ΔTh around the fluid temperatures that keeps the direction (avoids chatter).°F0 to 361.8