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
| Control | Meaning / action | Unit | Range / choices | Example 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 90 | 20 |
| Also limit the minimum inlet temperature | The 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). | years | 1 to 100 | 25 |
| 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. | m | 5 to 2000 | 20 |
| Maximum length: | Longest borehole length considered by sizing. | m | 10 to 3000 | 300 |
| Tolerance: | Sizing tolerance on the borehole length. | m | 0.01 to 10 | 0.1 |
| Max. iterations: | Maximum number of iterations of the length search. | 5 to 1000 | 60 | |
| Check the limits in the last year only | Size 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 100 | 8 | |
| 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.5 | 0.02 | |
| Distance tolerance: | Relative tolerance for treating distances as identical (similarities method). | 0 to 0.5 | 0.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 50 | 10 | |
| Cylindrical short-time correction | Add 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. | m | 0.25 to 50 | 2 |
| 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. | kW | 0 to 100000 | 0 |
| Minimum run time: | On/off by load: once started, the pump runs at least this long. | min | 0 to 1440 | 0 |
| Temperature-dependent fluid properties | Re-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). | K | 0 to 20 | 1 |
| Minimum time between reversals: | Automatic direction: the minimum time between two flow reversals. | h | 0 to 720 | 1 |
| 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 200 | 10 | |
| 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. | h | 0 to 720 | 24 |
| Classic-method compatibility | Sets 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 defaults | Restores 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 104 | 26.6 |
| Maximum mean fluid temperature: | Maximum allowed mean fluid temperature (cooling / heat injection). Typical 15 … 35 °C. | °F | -4 to 194 | 68 |
| Minimum inlet temperature: | Lowest allowed inlet temperature of the field (with flow). Keep it above the freezing point of the fluid. | °F | -40 to 104 | 23 |
| Minimum length: | Shortest borehole length considered by sizing. | ft | 16 to 6562 | 66 |
| Maximum length: | Longest borehole length considered by sizing. | ft | 33 to 9843 | 984 |
| Tolerance: | Sizing tolerance on the borehole length. | ft | 0.03 to 32.81 | 0.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. | ft | 0.82 to 164.04 | 6.56 |
| Pump-off threshold: | On/off by load: the pump is off while the ground load |Q| is at or below this value. | MW | 0 to 100 | 0 |
| Reversal hysteresis: | Automatic direction with a given inlet temperature: the band ΔTh around the fluid temperatures that keeps the direction (avoids chatter). | °F | 0 to 36 | 1.8 |