Skip to content

planned_drillholes builtin

planned_drillholes(
    targets,
    spacing,
    *,
    rotation=0.0,
    azimuth=0.0,
    dip=90.0,
    topography=None,
    offset=Ellipsis,
)

Straight holes on a regular collar grid over targets, for drilling plans and spacing studies.

Grid nodes start at the footprint's lowest (along, across) corner, shifted by offset. A node becomes a collar when a target lies within half a cell of the hole collared there at the top of the targets; collars then slide along their hole to topography, so inclined holes keep their targets. Each hole runs down to the bottom of the targets.

Parameters:

Name Type Description Default
targets BlockModel, PointSet or array of shape (n, 3)

Ground to drill; a block model spans its blocks' full height.

required
spacing float or (float, float)

Collar spacing, or (along, across) spacing.

required
rotation float

Azimuth of the along axis, degrees clockwise from north.

0.0
azimuth float

Hole direction in degrees; dip is positive down, 90 vertical.

0.0
dip float

Hole direction in degrees; dip is positive down, 90 vertical.

0.0
topography Mesh

Surface the collars sit on; collars off it stay at the targets' top, with a UserWarning.

None
offset (float, float)

(along, across) shift of the grid, in meters.

Ellipsis

Returns:

Type Description
Drillholes

Holes P0001, P0002, ... with one interval each, FROM 0 to TO the hole length, so composite(length, []) cuts them into composites. Holes collared at or below the bottom are left out.

used in