# box_geometry

Python API: `depthai_nodes.node.box_dimensioner.box_geometry`

Box dimensions from the points of one box above a support plane.

## Classes

### BoxGeometry

Measure box dimensions from a millimeter point cloud of one box.

#### Methods

##### measure

```python
def measure(points: np.ndarray, plane_eq: np.ndarray) -> BoxDimensions | None:
```

Measure the box whose points lie above a support plane.

Parameters

 * `points` (`np.ndarray`): `(N, 3)` box points in millimeters.
 * `plane_eq` (`np.ndarray`): Support plane `(a, b, c, d)` with `ax + by + cz + d = 0`, in millimeters. The normal need not be
   unit length or point up.

Returns

 * `BoxDimensions | None`: The box dimensions, or `None` when there are too few points or no dominant top surface.

Raises

 * `ValueError`: If the plane normal is zero.

#### Attributes

##### HEIGHT_PERCENTILE

##### MAD_K

##### MAX_HEIGHT_MARGIN_MM

##### MIN_FOOTPRINT_POINTS

##### MIN_POINTS

##### MIN_TOP_PLANE_POINTS

##### TOP_BAND_FRACTION

##### TOP_PLANE_BAND_FRACTION

##### TOP_PLANE_ITERATIONS

##### TOP_PLANE_RANSAC_THRESH_MM

##### VOXEL_SIZE

## Attributes

### logger
