Repository navigation
Summary
- Require OpenCV 5.1 or later; PyPI wheels must be version 5.1.0.95 or newer. #680
- Map eligible fisheye annotations in continuous coordinates and reduce CPU time for box and keypoint workloads. #682
- Keep instance-bound masks and keypoints aligned when bbox rows are removed. #685
- Preserve every nonzero numeric value in dropout inpainting masks. #683
Breaking changes
AlbumentationsX now requires OpenCV 5.1 or later. PyPI wheels must be version 5.1.0.95 or newer. Importing with an older installation raises an actionable ImportError. Upgrade the OpenCV variant you use or install it through the matching extra, for example pip install -U "albumentationsx[headless]". #680
New features
For full-resolution fisheye maps with constant borders and a coefficient in [-0.3, 0.3] whose radial mapping is monotone in the frame, OpticalDistortion now maps keypoints and sampled box edges in continuous coordinates. It fits boxes to the visible contour and applies BboxParams.min_visibility before output clipping. KeypointParams.remove_invisible controls removal of out-of-frame keypoints and labels. Other settings retain the raster-based path. #682
On one Apple M4 Max CPU thread, paired median timings against 2.6.6 showed a 6.9–11.1× baseline-to-candidate speedup at 224×224 and a 36–71× speedup at 1024×1024 for full Compose calls with 16 horizontal or oriented boxes plus 32 keypoints. Image-only and empty-annotation control times stayed within 3% of baseline. The measurements used Python 3.11.15, Albucore 0.3.10, OpenCV 5.1.0, NumPy 2.4.6, and PyTorch 2.15.0. Benchmark details
Bug fixes
Composealigns masks and grouped keypoints with surviving bbox IDs after preprocessing or nested transforms remove rows, including when per-transform filtering is deferred. #685- GridElasticDeform keeps collapsed cells at their source rectangles and skips source cells without area. Images, annotations, and replay use the same recovered grid. #682
- Dropout inpainting treats every nonzero numeric mask value as foreground, including values such as
256that previously became zero during conversion touint8. #683
Misc
- Pin Albucore 0.3.11 and update OpenCV variant extras to support OpenCV 5.1 boolean-mask operations. #680
Commits
| Commit | PR | Description |
|---|---|---|
8d254be |
#680 | Require OpenCV 5.1 and streamline dropout masks |
052ccdb |
#683 | Honor nonzero numeric inpainting masks |
23b54c0 |
#685 | Align bound instances after transforms drop boxes |
a7bfda0 |
#682 | Map fisheye annotations and recover degenerate elastic cells |
9fe84cd |
#687 | Prepare release 2.6.7 |