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

| Control | Meaning / action | Unit | Range / choices | Example value |
|---|---|---|---|---|
| Reset view | Show all data (also: double-click the plot). | |||
| Chart style button | Chart 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 page | 2D and 3D overlaid, the table of extents and clearances, image and CSV export. | |||
| Cancel | Close without accepting unapplied edits. | |||
| Reset view | Show 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 by | Colour the elements by their ground layer, their size, their shape quality or, after a run that provides it, the temperature | Ground layer / Cell size / Element quality / Temperature | ||
| Element edges | Enables or disables this option. | |||
| Boreholes and sections | Enables or disables this option. | |||
| Boreholes through the surface | Draw the boreholes on top, also where the mesh hides them | |||
| Outer surface | Enables or disables this option. | |||
| Depth scale | Vertical exaggeration of the 3D view (1 = true scale) | × | 0.1 to 20 | 1 |
| Perspective | Enables or disables this option. | |||
| From | Select one of the listed alternatives. | |||
| To | Select one of the listed alternatives. | |||
| One frame back | One frame back | |||
| Mesh play | Play / pause the animation over the chosen time range | |||
| One frame forward | One 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 | ||
| Loop | Enables or disables this option. | |||
| Colour scale | Fixed: the same colours mean the same temperature in every frame of the range | Fixed over the time range / Per frame | ||
| Save animation… | Save the frames of the time range as an animated GIF or as PNG pictures | |||
| Plane | Select one of the listed alternatives. | x–z (vertical, west–east) / y–z (vertical, south–north) / Horizontal | ||
| Keep the other side | Enables or disables this option. | |||
| x–z plane | Enables or disables this option. | |||
| y–z plane | Enables or disables this option. | |||
| Plane | Select one of the listed alternatives. | x–z (vertical, west–east) / y–z (vertical, south–north) | ||
| Run 3D analysis | Run 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). | m | 0.01 to 20 | 0.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). | m | 0.1 to 100 | 5 |
| Largest cell size: | Largest cell size far from the boreholes. | m | 1 to 500 | 25 |
| Growth ratio: | Size ratio of neighbouring cells away from the boreholes (smaller: more cells, more accurate far field). | 1.05 to 2 | 1.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 4 | 2 | |
| Refinement radius: | Radius around each axis kept at the borehole cell size before the cells grow (Automatic: the cells around the axis). | m | 0 to 50 | 0 |
| Minimum cells per layer: | At least this many vertical cells in every ground layer and every borehole section. | 1 to 50 | 3 | |
| 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 200 | 6 | |
| 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 20 | 3 | |
| Depth factor: | Depth of the block as a multiple of the deepest borehole's depth below the surface. | 1 to 10 | 2 | |
| 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 10 | 4 | |
| Time budget: | Run time the suggested mesh may take on this computer (estimate). | s | 10 to 7200 | 180 |
| Suggest | Suggest a mesh for this project: as accurate as the time budget allows. | |||
| Use this mesh | Take the suggested cell sizes (mesh mode Custom). | |||
| Check mesh | Runs 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). | MB | 50 to 64000 | 1000 |
| The site plan's boundaries (property lines) | Enables or disables this option. | |||
| Add line | Add an evaluation line; configure its coordinates and sample spacing. | |||
| Add point | Add an evaluation point; configure its position and inspect the calculated value. | |||
| Remove | Remove 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 50 | 0 | |
| 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). | ft | 0.03 to 65.62 | 1.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). | ft | 0.3 to 328.1 | 16.4 |
| Largest cell size: | Largest cell size far from the boreholes. | ft | 3.3 to 1640.4 | 82 |
| Refinement radius: | Radius around each axis kept at the borehole cell size before the cells grow (Automatic: the cells around the axis). | ft | 0 to 164 | 0 |
| 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 |