🚀 Major Feature: Oriented Bounding Boxes (OBB) Support
This release introduces native Oriented Bounding Box (OBB) support across a wide range of transforms.
AlbumentationsX now supports both:
- HBB — Horizontal (axis-aligned) bounding boxes
- OBB — Oriented (rotated) bounding boxes
This makes augmentation pipelines consistent for rotated object detection use cases such as aerial imagery, scene text detection, industrial inspection, and autonomous driving.
✔️ Transforms with OBB Support
All links point to the interactive transform explorer:
/explore/transform/<TransformName>
- Affine
- AtLeastOneBBoxRandomCrop
- BBoxSafeRandomCrop
- CenterCrop
- Crop
- CropAndPad
- CropNonEmptyMaskIfExists
- D4
- ElasticTransform
- GridDistortion
- HorizontalFlip
- Lambda
- LongestMaxSize
- Mosaic
- NoOp
- OpticalDistortion
- Pad
- PadIfNeeded
- Perspective
- PiecewiseAffine
- PixelDropout
- RandomCrop
- RandomCropFromBorders
- RandomCropNearBBox
- RandomResizedCrop
- RandomRotate90
- RandomScale
- RandomSizedBBoxSafeCrop
- RandomSizedCrop
- Resize
- Rotate
- SafeRotate
- ShiftScaleRotate
- SmallestMaxSize
- SquareSymmetry
- ThinPlateSpline
- TimeReverse
- Transpose
- VerticalFlip
🧭 New Bounding Box Format
cxcywh (unnormalized)
Added support for: cxcywh
This format:
- Matches YOLO layout
- Uses pixel coordinates
- Is not normalized
Useful for center-based detection workflows.
⚠️ Breaking Changes
In BboxParams:
| Old name | New name |
|---|---|
format | coord_format |
clip | clip_bboxes_on_input |
Please update your pipelines accordingly.
⚡ Performance Improvements (Video)
Speedups when applying transforms to video:
MedianBlurZoomBlurSharpenSolarizeUnsharpMask
These optimizations improve throughput for multi-frame augmentation.
🙌 Contributors
- OBB support &
cxcywh— @ternaus - Video performance — @Dipet
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. This release exists because of that support.