simgeometry.objects.aperture3d

Three-dimensional aperture helpers for geometric object definitions.

Classes

Name	Description
Aperture3D	Represent a three-dimensional aperture embedded in a simulation domain.

Aperture3Dclass#

View source

class Aperture3D(axis: str, center_coords: tuple, vertices: tuple[tuple[float, float], ...], lower_bound: tuple, upper_bound: tuple, bc: ConfigValue = None, inverted: bool = True)

Bases: Shape3D

Represent a three-dimensional aperture embedded in a simulation domain.

axisattributeinstance attribute#

View source

axis = axis

axis_indexattributeinstance attribute#

View source

axis_index = {'x': 0, 'y': 1, 'z': 2}[axis]

center_coordsattributeinstance attribute#

View source

center_coords = xp.array(center_coords, dtype=float)

solid_within_bounding_boxattributeclass attributeinstance attribute#

View source

solid_within_bounding_box = True

verticesattributeinstance attribute#

View source

vertices = xp.array(vertices)

max_radiusproperty#

View source

max_radius: float

Return the largest aperture radius.

min_radiusproperty#

View source

min_radius: float

Return the smallest aperture radius.

containsmethod#

View source

def contains(coords: Array) -> bool

Check if the given coordinates are inside the aperture.

Parameters: coords (list or tuple): 3D coordinates.

Returns: bool: True if the coordinates are inside the aperture, False otherwise.

contains_pointsmethod#

View source

def contains_points(points: Array) -> Array

Vectorized :meth:contains: a mask of the (3, n) points inside.

copymethod#

View source

def copy() -> Aperture3D

Create a copy of the aperture.

Returns

Aperture3DAperture3D

A new instance of Aperture3D with the same properties.

get_verticesmethod#

View source

def get_vertices(slice_axis: int, slice_position: float) -> ConfigValue

Get the vertices of a slice of the aperture along a given axis.

Parameters: slice_axis (int): Axis along which to slice (0 for x, 1 for y, 2 for z). slice_position (float): Position along the slice_axis where the slice is taken.

vertices (ndarray): Array of vertices defining the slice shape. If the slice does not intersect the aperture, returns an empty array.

mirrormethod#

View source

def mirror(axis: int, position: float) -> None

Mirror the aperture across a specified axis at a given position.

Parameters

Name	Type	Description
axis	int	Axis index (0 for x-axis, 1 for y-axis, 2 for z-axis).
position	float	Position along the axis to mirror.

surface_areamethod#

View source

def surface_area() -> None

Declare the aperture surface-area interface.

translatemethod#

View source

def translate(offset: tuple[float, float, float]) -> None

Translate the aperture by the given offset.

Parameters

Name	Type	Description
offset	tuple	(dx, dy, dz) translation vector.

volumemethod#

View source

def volume() -> None

Declare the aperture volume interface.

Inherited from simgeometry.shapes.Shape

ndimattributeinstance attribute#

Inherited from simgeometry.shapes.ShapeView source

ndim = ndim

bounding_boxproperty#

Inherited from simgeometry.shapes.ShapeView source

bounding_box: BoundingBox

Return the bounding box.

invertedproperty#

Inherited from simgeometry.shapes.ShapeView source

inverted: bool

Return whether this object represents an inverted region.

lower_boundproperty#

Inherited from simgeometry.shapes.ShapeView source

lower_bound: tuple[float, ...]

Return the lower coordinate bounds.

upper_boundproperty#

Inherited from simgeometry.shapes.ShapeView source

upper_bound: tuple[float, ...]

Return the upper coordinate bounds.

get_bound_verticesmethod#

Inherited from simgeometry.shapes.ShapeView source

def get_bound_vertices(slice_axis: int) -> xp.ndarray

Return vertices that bound the shape.

get_indices_in_objectmethod#

Inherited from simgeometry.shapes.ShapeView source

def get_indices_in_object(grid: Grid) -> list[int] | list[tuple[int, ...]]

Get the indices of grid points that are inside the shape.

Parameters: grid (object): Grid object containing indices and cell sizes.

Returns: list: The :attr:Grid.indices of the nodes inside, in their order.

node_maskmethod#

Inherited from simgeometry.shapes.ShapeView source

def node_mask(grid: Grid) -> np.ndarray

Return a host boolean array of the grid’s shape, set at the nodes inside.

One vectorised :meth:contains_points over :meth:Grid.node_points, so the cost is that of a few array passes over the grid.

set_bounding_boxmethod#

Inherited from simgeometry.shapes.ShapeView source

def set_bounding_box(lower_bound: tuple[float, ...], upper_bound: tuple[float, ...]) -> None

Set the bounding box for the shape.

Inherited from simgeometry.api.GeometryAPI

cell_fractionsmethod#

Inherited from simgeometry.api.GeometryAPIView source

def cell_fractions(grid, *, samples_per_axis=4)

Estimate solid cell-volume and face-area fractions by subcell sampling.

Increase samples_per_axis to check convergence; unresolved thin features can be missed. This is not an exact finite-volume interface reconstruction.

closest_pointmethod#

Inherited from simgeometry.api.GeometryAPIView source

def closest_point(points, *, resolution=64, bounds=None)

Closest surface coordinates; primitives are exact, others use a mesh.

Mesh fallback requires mesh extras. Its accuracy is controlled by resolution and may miss unresolved components. Points are (ndim, n), or one (ndim,) point; the returned array has the same layout.

cut_edgesmethod#

Inherited from simgeometry.api.GeometryAPIView source

def cut_edges(grid, **kwargs)

Locate all detected grid-edge surface hits, without solver clamping.

diagnosemethod#

Inherited from simgeometry.api.GeometryAPIView source

def diagnose(grid, **kwargs)

Report sampled overlaps, unresolved components, and short cut distances.

differencemethod#

Inherited from simgeometry.api.GeometryAPIView source

def difference(other)

evaluatemethod#

Inherited from simgeometry.api.GeometryAPIView source

def evaluate(x=None, y=None, z=None, *, grid=None, bounds=None, resolution=128, quantity='occupancy')

Sample geometry as an xarray.DataArray (requires the evaluate extra).

Scalars fix axes, sequences form a tensor product, and DataArrays with shared dimension names describe scattered points. Unspecified axes use grid nodes, or resolution samples across bounds/the shape bounds. quantity is occupancy, labels (collections), or signed_distance. This is a local host operation, with no implicit MPI collectives.

exportmethod#

Inherited from simgeometry.api.GeometryAPIView source

def export(path, **kwargs)

Export a sampled mesh as NPZ, OBJ, or STL (3D only).

intersect_segmentmethod#

Inherited from simgeometry.api.GeometryAPIView source

def intersect_segment(start, end, *, samples=256, tolerance=1e-10)

Return ordered surface hits, including multiple crossings and tangencies.

Primitive intersections are analytic. Generic membership functions use samples intervals and may miss features smaller than that sampling. Result.exact distinguishes these cases. Coincident surface segments do not have a discrete set of hits; their end contacts may be returned.

intersectionmethod#

Inherited from simgeometry.api.GeometryAPIView source

def intersection(other)

plotmethod#

Inherited from simgeometry.api.GeometryAPIView source

def plot(ax=None, **kwargs)

Draw without displaying and return axes for composition.

rotatedmethod#

Inherited from simgeometry.api.GeometryAPIView source

def rotated(angle, *, axis=(0, 0, 1), origin=None)

Return a rotated snapshot; angle is in degrees, about origin (default 0).

sample_interiormethod#

Inherited from simgeometry.api.GeometryAPIView source

def sample_interior(count, *, rng=None, bounds=None, max_draws=1000000)

Uniform rejection samples, returned as (ndim, count).

Supply bounds for inverted/unbounded shapes. Raises if max_draws is exhausted; it never silently returns too few samples.

sample_surfacemethod#

Inherited from simgeometry.api.GeometryAPIView source

def sample_surface(count, *, rng=None, resolution=64, bounds=None)

Uniform-by-length/area samples from the faceted boundary mesh.

scaledmethod#

Inherited from simgeometry.api.GeometryAPIView source

def scaled(factors, *, origin=None)

Return a snapshot scaled by a nonzero scalar or per-axis factors.

showmethod#

Inherited from simgeometry.api.GeometryAPIView source

def show(**kwargs)

Display geometry, dispatching to 3D unless a slice is requested.

Returns Matplotlib axes, or a PyVista plotter for backend='pyvista'. Set display=False for scripts. save=path saves the figure.

show_3dmethod#

Inherited from simgeometry.api.GeometryAPIView source

def show_3d(**kwargs)

Display a surface with optional wireframe, normals and clipping.

backend='pyvista' enables an interactive clipping-plane widget via clip=True (requires the interactive extra). Matplotlib supports a static clip=(origin, normal) plane. Meshes are resolution-dependent.

signed_distancemethod#

Inherited from simgeometry.api.GeometryAPIView source

def signed_distance(points, *, resolution=64, bounds=None)

Distance to the boundary, negative inside, positive outside.

Exact for balls, boxes and simple polygons; otherwise distance to the sampled surface mesh. A membership function is not itself a distance.

slicemethod#

Inherited from simgeometry.api.GeometryAPIView source

def slice(x=None, y=None, z=None, origin=None, normal=None)

Return a queryable section with local-to-world coordinate mappings.

Fix exactly one coordinate, or give a 3D plane’s origin and normal. Axis-aligned sections retain the remaining coordinate names; oblique sections use x/y as their local plane coordinates.

surface_normalmethod#

Inherited from simgeometry.api.GeometryAPIView source

def surface_normal(points, *, scale=None)

Outward unit normals at boundary points; NaN where undefined.

Primitive faces use analytic normals. Other geometries estimate the normal from nearby membership samples. At corners normals are not unique.

to_meshmethod#

Inherited from simgeometry.api.GeometryAPIView source

def to_mesh(resolution=64, bounds=None)

Return sampled contours (2D) or triangles (3D), with spacing metadata.

Requires the mesh extra. Open contours/surfaces at the sampling bounds remain open; no artificial caps are added. Refine to resolve thin features.

transformedmethod#

Inherited from simgeometry.api.GeometryAPIView source

def transformed(matrix, offset=None)

Return an affine-transformed snapshot; the source is unchanged.

translatedmethod#

Inherited from simgeometry.api.GeometryAPIView source

def translated(offset)

Return a translated snapshot (unlike legacy in-place translate).

unionmethod#

Inherited from simgeometry.api.GeometryAPIView source

def union(other)