Utilities to easily convert between different bounding box formats (YOLO, XYWH, XYXY, etc.).

You can find documentation for the project at here.

2D Bounding Box Conversions

• List of points [top left, top right, bottom right, bottom left]
• XYWH: top left, width, height
• XYXY: top left, bottom right
• YOLO

3D Bounding Box Conversions

You can create a 3D bounding box with either:

• A center point, width, height, depth, and rotation
• The back-bottom-left point, width, height, depth, and rotation

You can convert between the two forms and also get a triangular polygon to use for plotting triangular meshes.

The majority of the 3D Bounding Box implementation comes from the bbox PyPI package.

Visualizations You can use bbox-utils to visualize annotations within point clouds or images.

To use point clouds, you will need to install open3d and plotly with either:

pip3 install open3d plotly==4.14.3
pip install
# or
conda install -c open3d-admin open3d
conda install -c plotly plotly=4.14.3

At the time of writing this, open3d requires Python < 3.9

To use images, you will need to install OpenCV:

pip3 install opencv-python
# or
conda install opencv -c conda-forge

This project uses pre-commit, please make sure to install it before making any changes:

pip install pre-commit
cd bbox-utils
pre-commit install

It is a good idea to update the hooks to the latest version:

pre-commit autoupdate

This project has been set up using PyScaffold 4.0rc1. For details and usage information on PyScaffold see https://pyscaffold.org/.