HomeFeaturesExamplesTutorialsHelpTheoryVerificationPricingContact
BoreTherm Online help

3D analysis

Run 3D analysis computes a separate FEM ground response (Simple FEM) and compares it with the analytic design. Choose mesh and domain controls, time points, slices, probes and evaluation objects. Coarse mesh is a preview; repeat with refinement for engineering accuracy. The saved .boretherm.fem sidecar can be reused after load changes if its fingerprint matches. Changing geometry, ground, flow, mesh or horizon invalidates that response. Temperature fields use superposition. With 3D analysis: Full FEM on the Project page the mesh, domain and solver set here also apply to the full 3D simulation (Full FEM › Physics & run), whose temperature field, plume maps, head and Darcy velocity are shown here.

Step-by-step workflows · Menus and keyboard

3D analysis 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
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.
Open the Thermal plume page2D and 3D overlaid, the table of extents and clearances, image and CSV export.
CancelClose without accepting unapplied edits.
Reset viewShow the whole mesh from the south-west (3D) or fit the slice (2D)
Save image…Save the view with its legend as a PNG or JPEG picture
Colour byColour the elements by their ground layer, their size, their shape quality or, after a run that provides it, the temperatureGround layer / Cell size / Element quality / Temperature
Element edgesEnables or disables this option.
Boreholes and sectionsEnables or disables this option.
Boreholes through the surfaceDraw the boreholes on top, also where the mesh hides them
Outer surfaceEnables or disables this option.
Depth scaleVertical exaggeration of the 3D view (1 = true scale)×0.1 to 201
PerspectiveEnables or disables this option.
FromSelect one of the listed alternatives.
ToSelect one of the listed alternatives.
One frame backOne frame back
Mesh playPlay / pause the animation over the chosen time range
One frame forwardOne frame forward
Playback speed (also of the exported animation)Playback speed (also of the exported animation)1 frames/s / 2 frames/s / 4 frames/s / 8 frames/s / 12 frames/s / 24 frames/s
LoopEnables or disables this option.
Colour scaleFixed: the same colours mean the same temperature in every frame of the rangeFixed over the time range / Per frame
Save animation…Save the frames of the time range as an animated GIF or as PNG pictures
PlaneSelect one of the listed alternatives.x–z (vertical, west–east) / y–z (vertical, south–north) / Horizontal
Keep the other sideEnables or disables this option.
x–z planeEnables or disables this option.
y–z planeEnables or disables this option.
PlaneSelect one of the listed alternatives.x–z (vertical, west–east) / y–z (vertical, south–north)
Run 3D analysisRun the 3D analysis of the current design (Shift+F5): the FEM g-function, the fluid temperatures with it, the comparison with the 2D model and the ground temperature field. Saved or cached results of the same inputs are reused.
Mesh:Auto chooses the cell sizes from the project (earliest time of interest, borehole length, simulation period). Coarse is quick, Fine and Very fine are for convergence checks. Custom makes every value editable.Auto / Coarse / Medium / Fine / Very fine / Custom
Elements:Auto: hexahedra (fastest) for vertical fields, tetrahedra as soon as a borehole is inclined. Tetrahedra can also be chosen for vertical fields.Auto / Hexahedra / Tetrahedra
Cell size at the boreholes:Horizontal cell size at the borehole axes. The line-source model needs cells about ten times the borehole radius; a smaller value is raised (with a note).m0.01 to 200.5
Cell size along the boreholes:Largest vertical cell size along the boreholes (hexahedra). For tetrahedra it sets only the cell size at the layer interfaces (half of it).m0.1 to 1005
Largest cell size:Largest cell size far from the boreholes.m1 to 50025
Growth ratio:Size ratio of neighbouring cells away from the boreholes (smaller: more cells, more accurate far field).1.05 to 21.3
Cells around each axis:Uniform cells of the borehole cell size on each side of every axis (1 to 4: the calibrated range of the well index).1 to 42
Refinement radius:Radius around each axis kept at the borehole cell size before the cells grow (Automatic: the cells around the axis).m0 to 500
Minimum cells per layer:At least this many vertical cells in every ground layer and every borehole section.1 to 503
Time steps per level:Backward Euler time steps per time level (each level doubles the step). More steps: smaller time error, longer run.1 to 2006
Solver:Auto: the direct solver (PARDISO) up to the node limit, the iterative solver (conjugate gradients) above. The direct solver needs much more memory on large meshes.Auto / Direct / Iterative
Domain:Size of the ground block around the field. Auto: the larger of 3 × the field's width (2 × the deepest borehole's depth) and the distance the heat travels in the simulation period, 4 √(α t). Custom: your factors.Auto / Custom
Width factor:Width of the block in x and y as a multiple of the field's plan extent (3: one field width on each side).1 to 203
Depth factor:Depth of the block as a multiple of the deepest borehole's depth below the surface.1 to 102
Heat-travel margin:The block reaches at least this many √(α t) beyond the field (heat-travel margin; recommended 4, where the temperature change is below 0.5 %).1 to 104
Time budget:Run time the suggested mesh may take on this computer (estimate).s10 to 7200180
SuggestSuggest a mesh for this project: as accurate as the time budget allows.
Use this meshTake the suggested cell sizes (mesh mode Custom).
Check meshRuns this mesh and one 1.5 times coarser on a horizon of at most 5 years and estimates the discretisation error of g (about 1.3 runs).
Show:What the 3D view and the maps show; the isotherms are always changes against the undisturbed ground.Ground temperature / Temperature change against the undisturbed ground
Plan map depth:Depth of the plan map; "Averaged" takes the mean over the boreholes' active length.m-1 to 5000-1
Thresholds:Temperature changes to watch, separated by ";": positive = warming, negative = cooling. Isotherms, first exceedance and extents use them. BoreTherm has no built-in legal limits.
Report years:Years whose maps the report shows besides the end of the period (at most two, separated by ";").
Field memory limit:Memory for the temperature field of the next FEM run; above it fewer time steps are kept (values between them are interpolated).MB50 to 640001000
The site plan's boundaries (property lines)Enables or disables this option.
Add lineAdd an evaluation line; configure its coordinates and sample spacing.
Add pointAdd an evaluation point; configure its position and inspect the calculated value.
RemoveRemove the selected evaluation item or interval from this table.
Export CSV…Write the displayed numerical table to a CSV file using the selected CSV format.
Export VTU (ParaView)…Export the mesh and field values for inspection in ParaView.
Minimum vertical cells in this ground layer; Automatic uses the minimum cells per layer.Minimum vertical cells in this ground layer; Automatic uses the minimum cells per layer.0 to 500
Cell size at the boreholes:Horizontal cell size at the borehole axes. The line-source model needs cells about ten times the borehole radius; a smaller value is raised (with a note).ft0.03 to 65.621.64
Cell size along the boreholes:Largest vertical cell size along the boreholes (hexahedra). For tetrahedra it sets only the cell size at the layer interfaces (half of it).ft0.3 to 328.116.4
Largest cell size:Largest cell size far from the boreholes.ft3.3 to 1640.482
Refinement radius:Radius around each axis kept at the borehole cell size before the cells grow (Automatic: the cells around the axis).ft0 to 1640
Plan map depth:Depth of the plan map; "Averaged" takes the mean over the boreholes' active length.ft-3.3 to 16404.2-3.3