py3dtiles.bounding_volume_box module

class py3dtiles.bounding_volume_box.BoundingVolumeBox

Bases: BoundingVolume

A box bounding volume as defined in the 3DTiles specifications i.e. an array of 12 numbers that define an oriented bounding box: - The first three elements define the x, y, and z values for the

center of the box.

• The next three elements (with indices 3, 4, and 5) define the x axis direction and half-length.

• The next three elements (with indices 6, 7, and 8) define the y axis direction and half-length.

• The last three elements (indices 9, 10, and 11) define the z axis direction and half-length.”

Note that, by default, a box bounding volume doesn’t need to be aligned with the coordinate axis. Still in general, computing the box bounding volume of two box bounding volumes won’t necessarily yield a box that is aligned with the coordinate axis (although this computation might require some fitting algorithm e.g. the principal component analysis method. Yet in sake of simplification (and numerical efficiency), when asked to “add” (i.e. to find the enclosing box of) two (or more) box bounding volumes this class resolves to compute the “canonical” fitting/enclosing box i.e. a box that is parallel to the coordinate axis.

add(other: BoundingVolumeBox) → None

Compute the ‘canonical’ bounding volume fitting this bounding volume together with the added bounding volume. Again (refer above to the class definition) the computed fitting bounding volume is generically not the smallest one (due to its alignment with the coordinate axis). :param other: another box bounding volume to be added with this one

static get_box_array_from_mins_maxs(mins_maxs: list | ndarray) → ndarray

Parameters:

mins_maxs – the list [x_min, y_min, z_min, x_max, y_max, z_max] that is the boundaries of the box along each coordinate axis

Returns:

the smallest box (as an array, as opposed to a BoundingVolumeBox instance) that encloses the given list of (3D) points and that is parallel to the coordinate axis.

static get_box_array_from_point(points: list[list[float]]) → ndarray

Parameters:

points – a list of 3D points

Returns:

the smallest box (as an array, as opposed to a BoundingVolumeBox instance) that encloses the given list of (3D) points and that is parallel to the coordinate axis.

get_canonical_as_array() → ndarray

Returns:

the smallest enclosing box (as an array) that is parallel to the coordinate axis

get_center() → ndarray

get_corners() → list

Returns:

the corners (3D points) of the box as a list

is_box() → bool

static is_valid(box) → tuple[bool, str]

set_from_array(box_array: ndarray) → None

set_from_list(box_list: list) → None

set_from_mins_maxs(mins_maxs: list | ndarray) → None

Parameters:

mins_maxs – the list [x_min, y_min, z_min, x_max, y_max, z_max] that is the boundaries of the box along each coordinate axis

set_from_points(points: list) → None

sync_with_children(owner: Tile) → None

to_dict() → dict

transform(transform: list[float] | ndarray) → None

Apply the provided transformation matrix (4x4) to the box :param transform: transformation matrix (4x4) to be applied

translate(offset: list | ndarray) → None

Translate the box center with the given offset “vector” :param offset: the 3D vector by which the box should be translated