Skip to content

AlbumentationsX 2.6.7

Latest

Choose a tag to compare

@ternaus ternaus released this 20 Nov 07:34
9fe84cd

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

  • Compose aligns 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 256 that previously became zero during conversion to uint8. #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

Full changelog from 2.6.6 to 2.6.7