Release 2.5.0

Summary

• Adds four medical imaging transforms: BiasField, GhostingArtifact, GibbsRinging, and MotionArtifact.
• Raises the minimum supported Python version to 3.11.
• Fixes RandomGamma so gamma 1 preserves every uint8 value.
• Cuts FFT work and temporary memory for selected large MRI volume cases.

Breaking changes

• Python 3.10 is no longer supported. Install and run AlbumentationsX with Python 3.11 or newer.
• Medical transform implementations and functional helpers now live in albumentations.augmentations.medical.transforms and albumentations.augmentations.medical.functional. Code importing implementation modules should update its import path. For example:

# Before
from albumentations.augmentations.pixel.color_advanced import HEStain

# After
from albumentations.augmentations.medical.transforms import HEStain

Top-level exports such as A.HEStain retain their constructor parameters and serialization identifiers.

New features

• BiasField simulates smooth multiplicative intensity variation in images and 3D volumes, with shared or per-channel fields.
• GhostingArtifact simulates periodic MRI ghost replicas in real 3D magnitude volumes.
• GibbsRinging applies rectangular k-space truncation to 2D images and 3D volumes.
• MotionArtifact simulates motion between MRI acquisition segments in 3D volumes.
• The new medical package groups these transforms with Anisotropy3D, HEStain, KSpaceSpikeNoise, and RicianNoise. Their top-level exports, target behavior, and serialization remain intact.

Bug fixes

• RandomGamma now builds its uint8 lookup table from exact integer pixel values. With gamma 1, all 256 uint8 values remain unchanged across images and volumes.
• Corrects the documented gamma equation and brightening/darkening directions, and adds a runnable numeric example.

Misc

• For large 3D volumes, KSpaceSpikeNoise, GibbsRinging, and BiasField reduce FFT computation or temporary memory in selected parameter, shape, and dtype ranges. Other inputs keep the existing execution paths.
• Updates the supported Python and operating-system matrix, contributor guidance, release metadata, and development dependencies.
• Keeps release-core ASV discovery compatible with 2.4.13 and corrects pinned artifact action version comments in CI workflows (#571, #573).

Commits