GXDMPPLY class

class GXDMPPLY(handle=0)[source]

GXDMPPLY class.

Datamine Multiple polygon object

__init__(handle=0)[source]
clear()[source]

Clear/remove all polygons from the GXDMPPLY.

New in version 6.0.

License: Geosoft End-User License

copy(source)[source]

Copy

Parameters:

source (GXDMPPLY) – Source

New in version 6.0.

License: Geosoft End-User License

classmethod create()[source]

Creates a GXDMPPLY object.

Returns:

DMPLY Object

Return type:

GXDMPPLY

New in version 6.0.

License: Geosoft End-User License

get_azimuth(p, az)[source]

Get the azimuth of a given polygon.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • az (float_ref) – Azimuth (degrees) (o)

New in version 6.0.

License: Geosoft End-User License

Note: The azimuth is the equivalent section azimuth, equal to the azimuth of the normal vector plus 90 degrees.

get_extents(p, x, y, z, w, h)[source]

Get the center, width and height of a given polygon.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • x (float_ref) – Center point X (o)

  • y (float_ref) – Center point Y (o)

  • z (float_ref) – Center point Z (o)

  • w (float_ref) – Width of polygon (in its plane) (o)

  • h (float_ref) – Height of polygon (Z extent) (o)

New in version 6.0.

License: Geosoft End-User License

get_joins(p, vv)[source]

Get join lines for each vertex in a specific polygon.

Parameters:

  • p (int) – Polygon number (1 to N)

  • vv (GXVV) – INT GXVV of join indices (1 to NJoins).

New in version 6.0.

License: Geosoft End-User License

Note: If a specific vertex is not joined, the returned value is 0. If the vertex is joined, then the index of the join line (1 to NJoins) is returned.

get_normal_vectors(p, x1, y1, z1, x2, y2, z2, x3, y3, z3)[source]

Get the normal vectors of a given polygon.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • x1 (float_ref) – X component (o) (Horizontal azimuth vector)

  • y1 (float_ref) – Y component (o)

  • z1 (float_ref) – Z component (o)

  • x2 (float_ref) – X component (o) (Down-dip, in the vertical plane)

  • y2 (float_ref) – Y component (o)

  • z2 (float_ref) – Z component (o)

  • x3 (float_ref) – X component (o) (Normal vector)

  • y3 (float_ref) – Y component (o)

  • z3 (float_ref) – Z component (o)

New in version 6.0.

License: Geosoft End-User License

Note: Three normalized vectors are returned. The first is horizontal, in the plane of the polygon. The second is in the vertical plane, corresponding to the “down-dip” direction. The third is the normal vector to the polygon plane.

get_poly(p, vv_x, vv_y, vv_z)[source]

Get a specific polygon from a GXDMPPLY object.

Parameters:

  • p (int) – Polygon number (1 to NP) (i)

  • vv_x (GXVV) – X Locations (o)

  • vv_y (GXVV) – Y Locations (o)

  • vv_z (GXVV) – Z Locations (o)

New in version 6.0.

License: Geosoft End-User License

Note: Get the number of points from the GXVV length.

get_swing(p, az)[source]

Get the swing of a given polygon.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • az (float_ref) – Swing (degrees) (o)

New in version 6.0.

License: Geosoft End-User License

Note: The swing is the equivalent section swing, equal to zero for vertical plates, and increasing as the normal vector goes from horizontal upward.

get_vertex(p, v, x, y, z)[source]

Get a vertex location from a GXDMPPLY object.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • v (int) – Vertex number (1 to NV)

  • x (float_ref) – X Location (o)

  • y (float_ref) – Y Location (o)

  • z (float_ref) – Z Location (o)

New in version 6.0.

License: Geosoft End-User License

is_null()[source]

Check if this is a null (undefined) instance

Returns:

True if this is a null (undefined) instance, False otherwise.

Return type:

bool

load(file)[source]

Loads a Datamine polygon file.

Parameters:

file (str) – Name of the file to load

New in version 6.0.

License: Geosoft End-User License

move_vertex(p, v, x, y, z)[source]

Moves a vertex and any associated lines.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • v (int) – Vertex number (1 to NV)

  • x (float) – New location X

  • y (float) – New location Y

  • z (float) – New location Z

New in version 6.0.

License: Geosoft End-User License

classmethod null()[source]

A null (undefined) instance of GXDMPPLY

Returns:

A null GXDMPPLY

Return type:

GXDMPPLY

num_joins()[source]

Get the number of joining lines in a GXDMPPLY object.

Returns:

Number of joining lines

Return type:

int

New in version 6.0.

License: Geosoft End-User License

num_polys()[source]

Get the number of polygons in a GXDMPPLY object.

Returns:

Number of polygons

Return type:

int

New in version 6.0.

License: Geosoft End-User License

Note: The value returned is the “NP” used in function descriptions below.

num_vertices(p)[source]

Get the number of vertices in a polygon.

Parameters:

p (int) – Polygon number (1 to NP)

Returns:

Number of vertices in a polygon

Return type:

int

New in version 6.0.

License: Geosoft End-User License

Note: The value returned is the “NV” used in function descriptions below.

project_poly(p, xp, yp, zp, az, swing, vv_x, vv_y, vv_z)[source]

Project a polygon onto a vertical plane.

Parameters:

  • p (int) – Polygon number (1 to NP)

  • xp (float) – X location of plane origin in 3D

  • yp (float) – Y location of plane origin in 3D

  • zp (float) – Z location of plane origin in 3D

  • az (float) – Azimuth of the plane in degrees

  • swing (float) – Swing of the plane in degrees

  • vv_x (GXVV) – X (horizontal along-section locations on vertical plane (o)

  • vv_y (GXVV) – Y (vertical locations on vertical plane (o)

  • vv_z (GXVV) – Z (horizontal distances perpendicular to the plane (o)

New in version 6.0.

License: Geosoft End-User License

Note: Gives the location in plane coordinates of a selected polygon, after it has been projected perpendicularly onto the plane.

Plane coodinates: X - horizontal in plane

Y - “vertical” in plane (can be a swing) Z - horizontal, “perpendicular” to plane (RH)

re_project_poly(p, xp, yp, zp, az, vv_x, vv_y, vv_x3, vv_y3, vv_z3)[source]

Recover polygon locations from 2D locations on vertical plane.

Parameters:

  • p (int) – Polygon number (1 to lNP) (i)

  • xp (float) – X location of plane origin in 3D (i)

  • yp (float) – Y location of plane origin in 3D (i)

  • zp (float) – Z location of plane origin in 3D (i)

  • az (float) – Azimuth of the plane in degrees (i)

  • vv_x (GXVV) – X locations on vertical plane (i)

  • vv_y (GXVV) – Y (actually Z) locations on vertical plane (i)

  • vv_x3 (GXVV) – X Locations of polygon (o)

  • vv_y3 (GXVV) – Y Locations of polygon (o)

  • vv_z3 (GXVV) – Z Locations of polygon (o)

New in version 6.0.

License: Geosoft End-User License

Note: This is the inverse operation of project_poly.

Input the 2D locations on the projected vertical plane. These locations are projected back onto the original polygon plane.

save(file)[source]

Save to a Datamine polygon file

Parameters:

file (str) – Name of the file to save to

New in version 6.0.

License: Geosoft End-User License

set_poly(p, vv_x, vv_y, vv_z)[source]

Set a specific polygon into a GXDMPPLY object.

Parameters:

  • p (int) – Polygon number (1 to NP) (i)

  • vv_x (GXVV) – X Locations (i)

  • vv_y (GXVV) – Y Locations (i)

  • vv_z (GXVV) – Z Locations (i)

New in version 6.0.

License: Geosoft End-User License

Note: Get the number of points from the GXVV length.