upxo.geoEntities.surface module

3D surface geometric entity for UPXO.

Usage

from upxo.geoEntities.surface import Surface

Classes

Surface : 3D surface representation with meshing and smoothing operations.

Limitations

• All methods are stubs awaiting implementation.

class upxo.geoEntities.surface.Surface

Bases: object

Represents a 3D surface in UPXO.

x

X-coordinates of surface points.

Type:

array-like

y

Y-coordinates of surface points.

Type:

array-like

z

Z-coordinates of surface points.

Type:

array-like

Limitations

-----------

- All methods are stubs awaiting implementation.

classmethod from_points()

Construct a surface from a collection of 3D points.

Raises:

NotImplementedError – Always raised because point-based construction is not implemented.

classmethod from_vertices()

Construct a surface from a vertex array.

Raises:

NotImplementedError – Always raised because vertex-based construction is not implemented.

compute_normals()

Compute surface normals at each vertex.

Raises:

NotImplementedError – Always raised because normal computation is not implemented.

shortest_path(point)

Find the shortest geodesic path from a reference point on the surface.

Parameters:

point (array-like) – Query point coordinates.

Raises:

NotImplementedError – Always raised because geodesic path finding is not implemented.

triangulate(point)

Triangulate the surface from the given reference point.

Parameters:

point (array-like) – Reference point for triangulation.

Raises:

NotImplementedError – Always raised because triangulation is not implemented.

distribute_points(n, min_distance=-1)

Distribute n points on the surface with optional minimum separation.

Parameters:

• n (int) – Number of points to distribute.

• min_distance (float, optional) – Minimum distance between points. Default is -1 (no constraint).

Raises:

NotImplementedError – Always raised because point distribution is not implemented.

pyvista_mesh()

Return a PyVista mesh representation of this surface.

Raises:

NotImplementedError – Always raised because PyVista mesh construction is not implemented.

smooth_laplace(niterations)

Apply Laplacian smoothing to the surface.

Parameters:

niterations (int) – Number of smoothing iterations.

Raises:

NotImplementedError – Always raised because Laplacian smoothing is not implemented.

smooth_taubin(niterations)

Apply Taubin smoothing to the surface.

Parameters:

niterations (int) – Number of smoothing iterations.

Raises:

NotImplementedError – Always raised because Taubin smoothing is not implemented.

x

y

z