PointCarrier

class PointCarrier(location: ndarray[3], attributes_set: Set[ElementAttributes] | None = None)

A PointCarrier is functionally the same as a Point and is purely to separate the concept of ShapeElement and Carrier for points.

Parameters:

location – Where the point is located.
attributes_set – The set of ElementAttributes present in elements on this carrier.

Attributes

location

Where the point is located.

Methods

`contains_point`	Return `True` if `point` is coincident to this carrier.
`equivalent_to`	Return `True` if this carrier is equivalent to another.
`find_intersections`	Find all intersection points between this carrier and another.
`group_elements_by_attribute`	Group elements by `ElementAttributes`.
`group_elements_by_coequality`	Group elements by coequality.
`maximize`	Maximize a group of elements.

contains_point(point: ndarray[3]) → bool: Return True if point is coincident to this carrier. Fuzzy with tolerance.

equivalent_to(other: PointCarrier) → bool: Return True if this carrier is equivalent to another. Fuzzy with tolerance.

find_intersections(other: Carrier) → ndarray: Find all intersection points between this carrier and another. The output should be a numpy array of shape (n, 3) where each row is an intersection point. If there are no intersections, return np.zeros((0, 3)).

classmethod group_elements_by_attribute(elements: Iterable[E_co]) → Dict[ElementAttributes, List[E_co]]

Group elements by ElementAttributes.

Parameters:: elements – Elements to group.
Returns:: A mapping of ElementAttributes to lists of ShapeElement instances that have the attributes used as the key in the map.

classmethod group_elements_by_coequality(elements: Iterable[E_co]) → List[List[E_co]]

Group elements by coequality. Two ShapeElement instances are considered coequal if they have spatially equivalent carriers ( checked with equivalent_to() with match_attributes=False).

Parameters:: elements – Elements to group.
Returns:: A list of elements grouped by coequality. Each entry in this list is a list of coequal elements.

classmethod maximize(elements: Sequence[Point]) → List[Point]

Maximize a group of elements. Elements are considered maximal if there are no two elements such that coincident_with() returns True.

Specifically, if two elements visually appear to be one, replace the two with the one element they appear to be.

Maximization also performs calibration, which involves finding the “average” carrier of each set of coequal elements and projecting the resulting maximal elements onto this average carrier. This helps account for floating point error in the long run.

location: Where the point is located.