resqpy.olio.simple_lines.drape_lines

resqpy.olio.simple_lines.drape_lines(line_list, pillar_list_list, grid, ref_k=0, ref_kp=0, offset=-1.0, snap=False)[source]

Roughly drapes lines over grid horizon; draped lines are suitable for 3D visualisation.

Parameters
  • line_list (list of numpy arrays of floats) – the undraped poly-lines

  • pillar_list_list – (list of lists of pairs of integers): as returned by nearest_pillars()

  • grid – (grid.Grid object): the grid to which the poly-lines are to be draped

  • ref_k (integer, default 0) – the reference layer in the grid to which the lines will be draped; zero based

  • ref_kp (integer, default 0) – 0 to indicate the top corners of the reference layer, 1 for the base

  • offset (float, default -1.0) – the vertical offset to add to the z value of pillar points; positive drapes lines deeper, negative shallower (assumes grid’s crs has z increasing downwards)

  • snap (boolean, default False) – if True, the x & y values of each vertex in the lines are moved to match the pillar point; if False, only the z values are adjusted

Returns

list of numpy arrays of floats, being the draped equivalents of the line_list

Notes

the units of the line list must implicitly be those of the crs for the grid; for grids with split coordinate lines (faults), only the primary pillars are currently used; the results of this function are intended for 3D visualisation of an indicative nature; resulting draped lines may penetrate the grid layer faces depending on the 3D geometry and the spacing of the vertices compared to cell sizes