The one idea: the drawing is a picture, the polygons are the rules
A DXF drawing (the exchange format of CAD programs) or a picture of the site is a background. BoreTherm does not calculate with it. What counts are the polygons made from it: drilling areas (where boreholes may go), no-go zones (buildings, trees) and corridors (pipes and cables in the ground), each with a setback (a margin no borehole may enter), in metres in the site frame. The boreholes are an ordinary custom field in the same frame.
x = s · X − x0w = a · z̄ + bc(p) ≥ 0L = MST(heads, connection)s is metres per drawing unit and x0 the origin; a and b (complex numbers: scale, rotation, shift) come from two points of a picture; c(p) is the free distance beyond the nearest setback; MST is the minimum spanning tree (the shortest set of straight trench runs that connects every head and the connection point at the building). The site frame has x to the east and y to the north and is the frame of the borehole heads. The thermal model does not know about the site: it sees only where the heads are.
The workflow
- Layers to kinds. Use layer as turns every polyline of a layer into a polygon of the chosen kind; CAD polyline takes one polyline that you click. Closed polylines (also circles, closed splines and hatch loops) can be drilling areas or no-go zones; open ones only corridors or references. New polygons get default setbacks: drilling area 1 m, no-go zone 2 m, corridor 1.5 m. Change them in the Areas tab.
- Fill area places heads in the drilling areas: grid, staggered (every other row shifted by half a spacing), row-wise (each row starts at the edge) or perimeter (along the edge only). With a count, the most spread-out heads are kept. Apply to the field replaces the field; the layout becomes Custom and the heads copy H, D, rb and tilt of the layout’s borehole.
- Check lists every head outside an area, inside a no-go zone, within a setback, or closer to another head than the minimum distance. Calculate and Size borehole length still run; the results carry a site-plan warning.
What is stored and what stays linked
- Stored in the project: the field, every polygon with its points in metres and its setback, the origin, the connection point, the minimum distance, and the background settings (type, path, units, hidden layers, opacity, calibration). With Store the plan, also a copy of the plan file; plans over 20 MB make the project large.
- Linked: the plan file itself when no copy is stored. Save as rewrites the relative path for the new folder; File › Pack project puts the project and the linked plan into one zip. Send a pack, not a lone project file.
- The polygons are copies, not live links. Changing the DXF later does not move them: use the layer again, or edit the polygons.
How it works
- Reading. ASCII DXF, group code by group code: the header ($INSUNITS, extents), the layer table, blocks and entities. Lines, polylines with bulges, circles, arcs, ellipses, splines, hatch loops, points, texts and block references (with scale, rotation and arrays) are read; paper space and unknown entities are skipped with a note; binary DXF is refused.
- Units and origin. s comes from $INSUNITS (mm 0.001, cm 0.01, m 1, ft 0.3048, in 0.0254, …) unless a unit is chosen; a drawing without a unit is read in metres. Survey (UTM) coordinates in the millions would lose precision, so on loading BoreTherm shifts them by a round origin near the lower-left corner when it lies more than 10 km from 0.
- Region test. A point is inside a polygon by the winding number (any orientation, concave outlines). c(p) takes the best drilling area, then every no-go zone and corridor; 10⁻⁶ m tolerance, so a head exactly on a setback line is allowed.
- Fill. Rows run along the longest edge of the largest drilling area unless an angle is given. The lattice offset is searched on a 4 × 4 grid within one cell and the offset with the most positions wins.
The theory: frames, the region test, and spacing
The site plan has no thermal model of its own. It acts on the borefield only through the distances between the heads it allows: boreholes closer together take heat from each other, and the field gets colder over the years. The measure is Tf,min, the lowest mean fluid temperature (the mean of the inlet and outlet temperatures of the borehole fluid) over the simulated years; the design limit of the example is −3 °C.
How each result is derived
| Quantity | How BoreTherm derives it | Example |
|---|---|---|
| Drawing unit | $INSUNITS of the DXF header, or the unit chosen under Drawing units; a drawing without a unit is read in metres | $INSUNITS = 4 → mm, s = 0.001 m per unit |
| Site coordinates | x = s · X − x0, y = s · Y − y0; no rotation (the drawing’s +Y is north) | plot corner (45000, 20000) → (45.0, 20.0) m |
| Origin | set on loading when the lower-left corner lies more than 10 km from 0 (rounded down to 1 m) | (0, 0): the drawing is near 0 |
| Circle → polygon | tessellated in steps of at most 5° | tree r = 2.0 m → 72 points |
| Drilling area | area of the drilling areas minus the no-go zones (setbacks not deducted) | 1260 m² → 1168.2 m² |
| Clearance of a head | c(p) = the smallest free distance beyond a setback (T-P14-1) | borehole 1 at (3.0, 1.5): 0.50 m (drilling area) |
| Fill capacity | grid at B = 6 m along the longest edge, lattice offset searched (4 × 4) | 28 positions, offset (3.0, 1.5) |
| Spread-first selection | farthest-point order from the centroid; the first N | N = 16: nearest neighbour 6.0 m min, 7.15 m mean |
| Trench | minimum spanning tree of the heads and the connection point (Prim) | 110.5 m |
The example in numbers
| 16 heads from the 6 m fill | Neighbour min / mean [m] | Tf,min | Tf,max | Sized H | Drilling | Trench |
|---|---|---|---|---|---|---|
| Spread-first (example) | 6.0 / 7.15 | −1.13 °C | 16.42 °C | 130.0 m | 2080 m | 110.5 m |
| Compact, nearest the connection point | 6.0 / 6.00 | −2.17 °C | 16.08 °C | 141.2 m | 2258 m | 92.3 m |
Tf at the example length of 150 m; sized H by Size borehole length; drilling = 16 × sized H. The spread field needs 179 m less drilling; the compact one 18 m less trench. Which one is cheaper depends on the prices: the optimizer (Optimization with region Site, or boretherm-cli optimize --site) ranks both kinds of selection by its cost function. Site check of the example: 0 of 16 heads with a problem; Calculate with the example loads: −1.13 °C to 16.42 °C.
Limits to keep in mind
- The drawing is only as good as its source. Check the unit, the scale (measure a known distance with Measure), north and the setbacks against the survey and the local rules. The example drawing is illustrative.
- A DXF cannot be rotated in BoreTherm: the site frame takes the drawing’s axes. If the drawing is not north-up, directions in the project (the azimuth of inclined boreholes, the groundwater flow direction) refer to the drawing’s +X, not to east.
- The check tests the heads only. Inclined boreholes can reach under a building or a neighbour’s plot below ground; look at the 3D view with the site plan shown.
- A violation does not stop Calculate or Size borehole length. Read the warning and the Check tab before you report a design.
- Setbacks are measured in the plan to the polygon outline. Two touching drilling areas keep their setbacks along the common edge: draw one polygon where drilling may cross.
- Binary DXF, paper space and 3D solids are not read; export the plan view as ASCII DXF, or use a picture with a two-point scale.
Numbers calculated with BoreTherm. The fill, the site check, the sizing, the compact selection and the spacing study are made with boretherm-cli fill, site-check, size, simulate and study.