Class Point

phi/geom/_geom.py:658–745

Points have zero volume and are determined by a single location. An instance of `Point` represents a single n-dimensional point or a batch of points.

@sliceable(keepdims='vector')
@dataclass(frozen=True, eq=False)
class Point(Geometry):
    """
    Points have zero volume and are determined by a single location.
    An instance of `Point` represents a single n-dimensional point or a batch of points.
    """

    location: Tensor

    variable_attrs = ('location',)
    value_attrs = ('location',)

    def __post_init__(self):
        assert 'vector' in self.location.shape, "location must have a vector dimension"
        assert self.location.shape.get_item_names('vector') is not None, "Vector dimension needs to list spatial dimension as item names."

    @property
    def center(self) -> Tensor:
        return self.location

    @property
    def shape(self) -> Shape:
        return self.location.shape

    @property
    def faces(self) -> 'Geometry':
        return self

    def unstack(self, dimension: str) -> tuple:
        return tuple(Point(loc) for loc in math.unstack(self.location, dimension))

    def lies_inside(self, location: Tensor) -> Tensor:
        return expand(math.wrap(False), shape(location).without('vector'))

    def approximate_signed_distance(self, location: Union[Tensor, tuple]) -> Tensor:
        return math.norm(location - self.location)

    def bounding_radius(self) -> Tensor:
        return math.zeros()

    def bounding_half_extent(self) -> Tensor:
        return wrap(0)

    def at(self, center: Tensor) -> 'Geometry':
        return Point(center)

    def rotated(self, angle) -> 'Geometry':
        return self

    @property
    def volume(self) -> Tensor:
        return math.wrap(0)

    def sample_uniform(self, *shape: math.Shape) -> Tensor:
        raise NotImplementedError

    def scaled(self, factor: Union[float, Tensor]) -> 'Geometry':
        return self