Release 2.0.15
🧭 Oriented Bounding Boxes (OBB)
What’s new in 2.0.15
AlbumentationsX now supports oriented (rotated) bounding boxes as a first-class feature.
You can enable this by setting bbox_type="obb" in BboxParams.
When using OBBs, each bounding box is represented by 5 values instead of 4:
[x1, y1, x2, y2, angle]
The first four values follow the same format semantics as before. The fifth value is the rotation angle.
No new formats were introduced — OBB is a strict extension of existing ones.
Supported formats
All existing bounding box formats are supported with OBB:
-
coco[x_min, y_min, width, height, angle] -
pascal_voc[x_min, y_min, x_max, y_max, angle] -
albumentationsPascal VOC format, normalized to[0, 1], plusangle -
yolo[x_center, y_center, width, height, angle], normalized to[0, 1]
How to enable OBB
from albumentations import BboxParams
bbox_params = BboxParams(
format="pascal_voc",
bbox_type="obb",
label_fields=["class_labels"]
)
If bbox_type="obb" is set, AlbumentationsX expects exactly 5 values per box.
The default remains unchanged:
bbox_type="hbb"→ axis-aligned boxes (4 values)- Backward compatibility is fully preserved
Processing behavior
The bounding box pipeline remains conceptually the same:
- Convert to internal Albumentations format
- Optional clipping (
clip=True) - Optional invalid box filtering
- Apply transformations (rotation-aware)
- Apply area / visibility / size filtering
- Convert back to the original format
All existing filters (min_area, min_visibility, min_width, max_accept_ratio, etc.) continue to work.
Why this matters
Native OBB support is critical for:
- aerial and satellite imagery
- OCR and document analysis
- industrial inspection
- rotated object detection models (YOLO-OBB, MMRotate, etc.)
This release removes the need for custom hacks and keeps rotated boxes fully integrated into the AlbumentationsX augmentation pipeline.
Licensing
AlbumentationsX offers two licensing options:
- Commercial license: agree on rights for proprietary applications and services, with coverage for your teams, products, and customer deployments. Request a quote or email [email protected].
- AGPL: available at no charge, including for commercial use, subject to the license included with this release.
Supporting the project
Sponsorship supports maintenance, reviews, and new features. It is voluntary and does not include a commercial license or support agreement.
Support the project on GitHub Sponsors.
Commercial license purchases also help support continued development.
Thank you to everyone who uses, reports issues, sponsors, or supports AlbumentationsX in any form. This release exists because of that support.