Skip to content

Albumentations 2.0.0 Release Notes
Compare
Choose a tag to compare
@ternaus ternaus released this 08 Jan 20:24
· 44 commits to main since this release
2.0.0
72d9726
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This is major release, meaning

  • only one new transform

  • a lot of changes.

    • all parameter renaming was moved through deprecations => you got deprecation warning for months
    • A few transform have change of default parameters. If you always specify parameters for each augmentations => it will not affect you.

If you have questions or proposals:

If you have complaints:

New transform

ConstrainedCoarseDropout

Screenshot 2025-01-03 at 5 58 27 PM

by @vedantdalimkar

Core

  • Deleted always_apply => use p=1 to always apply and p=0 for not applying.
  • Deleted update_params, get_params_dependent_on_targets => use get_params_dependent_on_data

Transforms

GaussNoise

  • Deleted: var_limit, mean
  • Use: std_range, mean_range

It is not just a renaming, var_limit and std_range sample from different distributions. Sampling from std_range matches with other libraries like torchvision.

AdvancedBlur

  • Deleted: sigmaX_limit, sigmaY_limit
  • Use: sigma_x_limit, sigma_y_limit

RandomCrop

  • Deleted pad_mode, pad_val_mask, pad_cvl
  • Use: border_mode, fill_mask, fill

CenterCrop

  • Deleted pad_mode, pad_val_mask, pad_cvl
  • Use: border_mode, fill_mask, fill

Crop

  • Deleted pad_mode, pad_val_mask, pad_cvl
  • Use: border_mode, fill_mask, fill

RandomResizedCrop

  • Deleted: height, width
  • Use: size

RandomSizedCrop

  • Deleted: height, width
  • Use: size

RandomCropNearBBox

  • Deleted: cropping_box_key
  • Use: cropping_bbox_key

CropAndPad

  • Deleted: pad_mode, pad_val_mask, pad_cvl
  • Use: border_mode, fill_mask, fill

TemplateTransform

  • Deleted: template_weight

ChannelDropout

  • Deleted: fill_value
  • Use: fill

CoarseDropout

  • Deleted: min_holes, max_holes, min_height, max_height, min_width, max_width, mask_fill_value, fill_value
  • Use: num_holes_range, hole_height_range, hole_width_range, fill, fill_mask

Also default parameters changed:
num_height_range = (8, 8) => num_height_range = (0.1, 0.2)
num_width_range = (8, 8) => num_width_range = (0.1, 0.2)

GridDropout

  • Deleted: unit_size_min, unit_size_max, holes_number_x, holes_number_y, shift_x, shift_y, fill_value, mask_fill_value
  • Use: unit_size_range, holes_number_xy, fill, fill_mask

MaskDropout

  • Deleted: image_fill_value, mask_fill_value
  • Use: fill, fill_mask

XYMasking

  • Deleted: mask_fill_value, fill_value
  • Use: fill, fill_mask

Rotate

  • Deleted: value, mask_value
  • Use: fill, fill_mask

Changed default value for border_mode from cv2.BORDER_REFLECT_101 to cv2.BORDER_CONSTANT

SafeRotate

  • Deleted: value, mask_value
  • Use: fill, fill_mask

Changed default value for border_mode from cv2.BORDER_REFLECT_101 to cv2.BORDER_CONSTANT

ElasticTransform

  • Deleted: border_mode, value, mask_value

Perspective

  • Deleted: pad_mode, pad_val, mask_pad_val

Affine

  • Deleted: cval, cval_mask, mode
  • Use: fill, fill_mask, border_mode

ShiftScaleRotate

  • Deleted: value, mask_value
  • Use: fill, fill_mask

Changed default border_mode from cv2.BORDER_REFLECT_101 to cv2.BORDER_CONSTANT

PiesewiseAffine

  • Deleted: cval, cval_mask, mode, keypoints_threshold

OpticalDistortion

  • Deleted: shift_limit, value, mask_value, border_mode

GridDistortion

  • Deleted: value, mask_value, border_mode

RandomRotate90

Changed default probability from p=0.5 to p=1

PadIfNeeded

  • Deleted: value, mask_value
  • Use: fill, fill_mask

Changed default value for border_mode from cv2.BORDER_REFLECT_101 to cv2.BORDER_CONSTANT

ImageCompression

  • Deleted: quality_lower, quality_upper
  • Use: quality_range

RandomSnow

  • Deleted: snow_point_lower, snow_point_upper
  • Use: snow_point_range

RandomRain

  • Deleted: slant_lower, slant_upper
  • Use: slant_range

RandomFog

  • Deleted: fog_coef_lower, fog_coef_upper
  • Use: fog_coef_range

RandomSunFlare

  • Deleted: angle_lower, angle_upper, num_flare_circles_lower, num_flare_circles_upper
  • Use: num_flare_circles_range, angle_range

RandomShadow

  • Deleted: num_shadows_lower, num_shadows_upper
  • Use: num_shadows_limit

Solarize

  • Deleted: threshold
  • Use: threshold_range

Downscale

  • Deleted interpolation, scale_min, scale_max
  • Use: interpolation_pair, scale_range

by @ternaus

Small improvements

  • Fixed links in readme by @guspan-tanadi
  • Better bounding box processing in Dropouts

Contributors

ternaus, guspan-tanadi, and vedantdalimkar
Assets 2
Loading