HomeFeaturesExamplesTutorialsHelpTheoryVerificationPricingContact
BoreTherm Online help

TRT evaluation wizard

Follow import, test description, screening/evaluation, comparison, report and apply steps. Next and Back navigate without accepting a fit into the design. Apply is explicit; retain the original test data and report for traceability.

Step-by-step workflows · Menus and keyboard

TRT evaluation wizard in BoreTherm
English GUI; click to enlarge.
Controls captured from the BoreTherm GUI. Ranges are interface bounds; example values depend on the open project.
ControlMeaning / actionUnitRange / choicesExample value
Ground thermal conductivity λEnables or disables this option.
Layer:λTRT is the effective value over the test borehole's active length. In layered ground it can go to every layer, or to one layer whose value is then chosen so that the effective conductivity over the test length equals λTRT.Homogeneous ground
Match the effective value over the test lengthEnables or disables this option.
Volumetric heat capacity C (only when estimated)Enables or disables this option.
Mean ground surface temperature, back-computed from T0The surface temperature is shifted so that the project's undisturbed temperature over the test length equals T0 of the test (with the project's geothermal heat flux)
Borehole resistance:Grout calibration: the grout conductivity is set so that the multipole Rb* of the test borehole at the test flow equals Rb* of the test; Rb* then still follows the design flow and length. Fixed: Rb* is used as it is for every flow and length.Calibrate the grout conductivity (recommended) / Fixed Rb* / Do not change
Darcy velocity (M3; stored only)Enables or disables this option.
Apply to projectWrites the changes above and the test (data and setup) into the project in one step
Undo applyUndo the last TRT-to-design Apply operation.
Use the values of:The recommended applicable fit is selected automatically. You can choose another applicable fit; unavailable methods are greyed out and explain why in their tooltips.Automatic recommendation (M2 CHS) / M1 line-source slope — not applicable / M2 superposition (infinite line source) — Review required / M2 superposition (cylinder source) — Review required (recommended) / M2 superposition (finite line source) — Review required / M3 moving line source (groundwater) — not applicable / M5 recovery (CHS) — Review required
Back to the automatic choiceDiscard your choice: the automatic rule selects the fit again
Samples:Realisations of the input errors (0 = off; 200 to 1,000 give stable P5/P95)0 to 100000200
Seed:Seed of the random numbers: the same seed gives the same result
Power:Heating power meter (measured power)%0 to 502
Flow:Flow meter (power from flow and ΔT)%0 to 501
Temperature sensors:Offset of each temperature sensorK0 to 50.05
Length H:Active borehole lengthm0 to 500.5
Borehole radius:Borehole radiusmm0 to 502
Heat capacity C:Volumetric heat capacity of the ground%0 to 10010
T0:Undisturbed ground temperatureK0 to 100.2
Run Monte CarloValidate the uncertainty setup and start the configured samples.
Histograms of:Select one of the listed alternatives.
Reset viewShow all data (also: double-click the plot).
Chart style buttonChart style: title, axis titles, legend, colours, line widths and markers, fonts, grid and background (also in the chart's context menu).
PNG…Export the plot as a PNG image.
SVG…Export the plot as a vector SVG image (for Word, Inkscape, …).
PDF…Export the plot as a vector PDF.
CSV…Export the plotted data as CSV.
Methods and evaluation windowRuns the named tool action.
M1M1 line-source slope (Mogensen 1983): straight line through Tf against ln t in the evaluation window, Tf = knbsp;lnnbsp;t + m.λ = Q̄ / (4π H k), Rb* = (m − T0)/q̄ − [ln(4α/rb²) − γ] / (4πλ).Needs a constant heating power: drifts and interruptions bias it.The data are unsuitable for this method; this result cannot be selected.Quality checks contain warnings or failed criteria; review the quality table.M1 assumes constant heating power: fluctuations or interruptions make this slope unsuitable; use superposition (M2)M1 conductivity changes by 49.5 % across later fitting starts (screening limit 10.0 %)
M2 ILSM2 parameter estimation with temporal superposition of the measured power, forward model: infinite line source (ILS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M2 CHS – recommendedM2 parameter estimation with temporal superposition of the measured power, forward model: infinite cylinder source (CHS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M2 FLSM2 parameter estimation with temporal superposition of the measured power, forward model: finite line source (FLS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M5 CHSM5 recovery: the temperature decline after the heating stops, fitted with the whole heating history superposed (kernel of the M2 model); classic form Tf − T0 = Q̄/(4πλH) ln(t/(t − th)).An independent check of λ and T0.
M1 line-source slopeM1 line-source slope (Mogensen 1983): straight line through Tf against ln t in the evaluation window, Tf = knbsp;lnnbsp;t + m.λ = Q̄ / (4π H k), Rb* = (m − T0)/q̄ − [ln(4α/rb²) − γ] / (4πλ).Needs a constant heating power: drifts and interruptions bias it.The data are unsuitable for this method; this result cannot be selected.Quality checks contain warnings or failed criteria; review the quality table.M1 assumes constant heating power: fluctuations or interruptions make this slope unsuitable; use superposition (M2)M1 conductivity changes by 49.5 % across later fitting starts (screening limit 10.0 %)
M2 superposition (infinite line source)M2 parameter estimation with temporal superposition of the measured power, forward model: infinite line source (ILS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M2 superposition (cylinder source)M2 parameter estimation with temporal superposition of the measured power, forward model: infinite cylinder source (CHS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M2 superposition (finite line source)M2 parameter estimation with temporal superposition of the measured power, forward model: finite line source (FLS).Tf(t) = T0 + Rb*nbsp;q̃(t) + 1/(2πλ) Σ Δqk G(t − tk), fitted by Levenberg–Marquardt.Robust to power fluctuations and interruptions; 95 % confidence intervals from the parameter covariance.
M3 moving line source (groundwater)M3 moving line source (groundwater): estimates λ, Rb* and the Darcy velocity u.Identifiable only when vT² t / (4α) ≳ 0.05; the flow direction cannot be found from one borehole. A bounded test domain (sandbox) or a drifting power also look like advection.
M5 recoveryM5 recovery: the temperature decline after the heating stops, fitted with the whole heating history superposed (kernel of the M2 model); classic form Tf − T0 = Q̄/(4πλH) ln(t/(t − th)).An independent check of λ and T0.
Estimate the heat capacity C (M2, M3)C is usually poorly determined by a TRT (strongly correlated with λ)
Estimate T0 (M2, M3)Enables or disables this option.
Fit the recovery too (M2, M3)The recovery samples after the heating stop are fitted with the same model
Window start:Start of the evaluation window since the heating start (automatic: max(10 h, 5 rb²/α))h-0.1 to 10000-0.1
Window end:End of the evaluation window since the heating starth-0.1 to 10000-0.1
Rb* time constant:Time constant of the borehole's own response: the Rb* term of M2/M3 follows the power with this lag (heat capacity of fluid and grout; 0 = steady state)h0 to 241
Automatic windowChoose an automatic fitting window from the screening criteria; inspect it before fitting.
Drag to exclude an intervalOn: a drag across a plot excludes that interval. Off: a drag moves the view.
Automatically exclude suspect readingsExclude detected temperature outliers and flow/power disturbances from fitting. Raw readings and measured heat history are preserved.
Interval time unitUnit used for the start and end of excluded observation intervals.Hours since heating start / Seconds in the data
FromEnter a numerical value in the shown units.-1e+12 to 1e+120
ToEnter a numerical value in the shown units.-1e+12 to 1e+120
Add intervalAdd an observation-exclusion interval with start/end times.
RemoveRemove the selected evaluation item or interval from this table.
Clear allRemove the manually selected exclusion intervals.
Copy borehole, pipes, fluid and ground from the projectCopy the design construction and material settings into this TRT setup; confirm they describe the measured test.
Length H:Active length of the test boreholem1 to 3000150
Buried depth D:Depth of the top of the active lengthm0 to 5002
Borehole diameter:Borehole diameter (2 rb)mm50 to 600152
Time since grouting:Days between grouting and the start of the test (quality check)days-1 to 36507
Pipe type:Select one of the listed alternatives.Single-U / Double-U / Triple-U / Coaxial / Multi-U (4–8) / Helix (spiral coil)
Pipe outer diameter:Outer diameter of the pipes (coaxial: outer pipe)mm10 to 20040
Pipe wall thickness:Wall thickness of the pipesmm0.5 to 203.7
Shank spacing:Centre-to-centre distance of opposite legsmm0 to 30085
Grout conductivity:Thermal conductivity of the groutW/(m·K)0.1 to 102
Pipe conductivity:Thermal conductivity of the pipe wallW/(m·K)0.05 to 600.42
Fluid:Select one of the listed alternatives.Water / / Glycols / Monoethylene glycol (MEG) / Monopropylene glycol (MPG) / / Alcohols / Ethanol / Methanol / / Salt solutions / Potassium formate / Potassium acetate / Potassium carbonate / Calcium chloride / Sodium chloride / / Glycerol / / Custom (constant properties) / Table (temperature-dependent)
Mass fraction:Mass fraction of the antifreeze%0 to 600
Heat capacity C:Volumetric heat capacity of the ground: fixed in the evaluation unless it is estimatedMJ/(m³·K)0.5 to 52.2
Surface temperature:Mean ground surface temperature (T0 plausibility check)°C-20.1 to 409.5
Geothermal heat flux:Geothermal heat flux (T0 plausibility check)W/m²-0.005 to 0.30.065
Method:Select one of the listed alternatives.Initial circulation (before the heating) / Manual value / Depth profile (mean over the active length)
Averaging window:Averaging window before the heating startmin1 to 144060
T0 (manual):Undisturbed ground temperature°C-10.1 to 100-10.1
Add depthAdd a depth-resolved TRT input row.
Remove depthRemove the selected depth-resolved input row.
Power:Q = ρ cp V̇ (Tin − Tout) with the fluid properties at the mean fluid temperature, or the heater / heat meter columnMeasured (power column) / From flow and ΔT (inlet − outlet)
Heating start:Start of the heating in the time of the datah-1000 to 100001
Heating end:End of the heating since its start; the recovery follows (automatic: the last sample with heating power)h-0.1 to 10000-0.1
Selected test fileThe local test data file selected for import.
Open file…Rig data (CSV, TXT, DAT), a BoreTherm test file (.trt.json) or a project with a stored test
Use the test stored in the projectLoad the TRT data already embedded in the open project.
Time columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Time unitSelect the source unit before import.elapsed seconds / elapsed minutes / elapsed hours / elapsed days / date and time (detected) / dd.mm.yyyy HH:MM / dd.mm.yyyy HH:MM:SS / mm/dd/yyyy HH:MM:SS
Inlet temperature columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Inlet temperature unitSelect the source unit before import.°C / K / °F
Outlet temperature columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Outlet temperature unitSelect the source unit before import.°C / K / °F
Flow columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Flow unitSelect the source unit before import.l/min / l/s / l/h / m³/h / m³/s / kg/s
Heat input columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Heat input unitSelect the source unit before import.W / kW / MW
Mean temperature columnMap the source column for this quantity. Leave not mapped only when the required quantity can be supplied by another supported input.
Mean temperature unitSelect the source unit before import.°C / K / °F
Trt constant flowConstant flow of the test when the file has no flow column (0 = none)l/min0 to 100000
Delimiter:Select one of the listed alternatives.detect / semicolon ; / comma , / tab / spaces
Decimal separator:Select one of the listed alternatives.detect / point 1.5 / comma 1,5
Repeated time stamps:Samples with the same time stamp, e.g. 30 s data with minute stampsaverage / spread to the next stamp / keep
Resample:Averages the samples on a uniform time step (0 = keep every sample)s0 to 36000
Fibre position of the ground surface: depth = position - offsetFibre position of the ground surface: depth = position - offsetm-10000 to 100000
Top of the depth range of the meanTop of the depth range of the meanm-10000 to 100000
Bottom of the depth range of the mean (e.g. the borehole length)Bottom of the depth range of the mean (e.g. the borehole length)m-10000 to 10000100
Added to the DTS times after the calendar times are matched (e.g. -1 h for a DTS in UTC and a logger in CET)Added to the DTS times after the calendar times are matched (e.g. -1 h for a DTS in UTC and a logger in CET)h-48 to 480
Depth mean as the mean fluid temperatureThe mean over the depth range of every DTS profile becomes the mean fluid temperature of the records (one-minute values).
Add DTS file…Links a DTS file (fibre position in the first column, one column per time stamp) to the test
Read the full dataReads the full data of the compact copy again from the linked files
Store the test in the projectOn closing, the records and the evaluation setup are kept in the project file (the report uses them); the design values change only with Apply.
Save test…Save the records and the setup as a BoreTherm test file (.trt.json), e.g. for boretherm-cli trt
TRT report…Write the TRT evaluation report (VDI 4640 Part 5 contents) as PDF or HTML
< BackReturn to the previous wizard step.
Next >Continue to the next wizard step.
CloseClose this view.
Histograms of:Select one of the listed alternatives.M1 line-source slope / M2 superposition (cylinder source)