Description

A standard interface to the CDT (Correcting Delaunay Triangulation) standalone engine executable.

Standard Definitions

point_list:

A list of points, defined as: [[x0, y0, z0], ..., [xN, yN, zN]].

coded_point_list:

A tuple containing two items: the first item is a code (string), the second is the corresponding point_list. This data type is intended to mimic the srv file format. The code should match with an accompanying parameter file (survey code file). For example, ['BENCH', [[x0, y0, z0], ..., [xN, yN, zN]]]

face_list:

All face lists are described such that the first index indicates how many faces are in the face. For example,

[3, 1, 2, 3, 3, 4, 5, 6]

States that there are 3 vertexes in the first face, and those vertexes are 1, 2, 3. Then the next face contains 3 vertexes, which are 4, 5, 6. This may seem a bit confusing, but using this structure buys us some definite efficiencies. Note that all faces in MineSight® products have 3 vertexes.

Functions

cdt(pointList, faceList, prm, contourPointLists, dir, width, contour, boundary, grid, debug)

Correcting Delaunay Triangulation corrects triangulated contour strings. The function returns the corrected solid/surface.

Arguments:

pointList : point_list (see Standard Definitions).

Points of the triangulated surface.

faceList : face_list (see Standard Definitions).

Faces of the triangulated surface.

prm : string

Parameter file path (for contour data).

contourPointLists : a list of coded_point_lists (see Standard Definitions).

Point lists for contour strings.

dir : string

Define a directory with input files.

width : integer

Maximal vertical width of a contour string.

contour : integer

Correct triangulated contour strings. Set value to 1 to turn on this option.

boundary : integer

Correct triangulated 2D boundary strings. Set value to 1 to turn on this option.

grid : integer

Correct triangulated grid. Set value to 1 to turn on this option.

debug : integer

Debug option will output the command string used to call the engine executable and will relay any output messages from the engine. Set value to 1 to turn on this option.

Returns:

A tuple containing: point_list, face_list (see Standard Definitions).

Example:

from grail.engines import cdt

pts = [[2.0, 0.0, 3895.0],[4.0, 0.0, 3895.0],[4.0, 2.0, 3895.0],[2.0, 2.0, 3895.0],[2.0, 0.0, 3895.0]]
fcs = [3, 3, 2, 1, 3, 3, 1, 0]

#use keyword arguments in function call
points, faces = cdt.cdt(pointList=pts, faceList=fcs, grid=1)