What the example does
BoreTherm runs without the window as well: a command-line program calculates, sizes and prices projects, alone or many at once, and writes results as JSON. The desktop program shows the same results in metric or imperial units and in several languages.
Inputs
| Input | Value |
|---|---|
| Field | 16 boreholes, 4 × 4 rectangle, spacing 6.0 × 6.0 m |
| Boreholes | length 150.0 m, top 4.0 m below the surface, diameter 140 mm |
| Construction | single U, PE pipe 32 × 2.9 mm, shank spacing 70 mm, grout 1.60 W/(m·K) |
| Ground | thermal conductivity 2.60 W/(m·K), heat capacity 2.20 MJ/(m³·K), surface temperature 9.0 °C, geothermal heat flux 0.060 W/m² |
| Fluid and flow | 25 % monopropylene glycol, 0.50 l/s per borehole |
| Loads | monthly: heating 200 MWh, hot water 8 MWh and cooling 45 MWh per year; peaks 100 kW heating and 45 kW cooling for 6 h |
| Heat pump | seasonal performance factors 3.8 heating, 2.8 hot water, 5.0 cooling |
| Design limits | mean fluid temperature between −3.0 °C and 20.0 °C |
| Period | 25 years |
| Batch | three jobs: simulate, size, cost |
| Display | SI and imperial units; English and German |
Run the example in BoreTherm
- On the command line:
boretherm-cli simulate,sizeorcostwith the project and--json;boretherm-cli runruns a list of jobs in parallel. --setchanges an input for one run without editing the project.- In the program, Project → Units switches the display units and View → Language the language.
One engine, two interfaces
- ProjectBoth read and write the same project files.
- OverridesInputs can be changed per run; unknown names and values out of range are refused.
- EngineThe results are identical to the program's.
- JSONEvery number in the JSON output is in SI units with temperatures in °C; the exit code tells success, limits exceeded or input errors.
- DisplayImperial units and another language change what is shown, not the calculation.
The example in BoreTherm
Calculated results
Calculated with BoreTherm for every variant of the example. Displayed values are rounded.
| Batch job | Command | Exit code | Design limits |
|---|---|---|---|
| temperature | simulate | 0 | within limits |
| required_length | size | 0 | within limits |
| cost | cost | 0 | within limits |
Temperatures by variant
| Variant | Boreholes | Length H [m] | Tf min [°C] | Tf max [°C] | Rb* [m K/W] | Pump [W] | Design limits |
|---|---|---|---|---|---|---|---|
| office, SI units | 16 | 150.000 | -2.413 | 16.026 | 0.1194 | 3,033.2 | within limits |
| office, imperial units | 16 | 150.000 | -2.413 | 16.026 | 0.1194 | 3,033.2 | within limits |
What the example shows
The same project gives the same numbers in the program, on the command line and in another language or unit system. The command line suits batch work, parameter variations and the integration of BoreTherm into other tools; its JSON output always stays in SI units.