Welcome to Albumentations Documentation! 🔗

🚀 Important: AlbumentationsX - The Next Generation

AlbumentationsX is now available as the actively maintained successor to Albumentations:

• ✅ 100% drop-in replacement - no code changes required
• ⚡ Better performance with bug fixes and new features
• 🔧 Active maintenance and professional support
• 📄 Dual licensed (AGPL/Commercial) - see our License Guide

pip uninstall albumentations  # If you have it installed
pip install albumentationsx   # Install the new version

Your existing code continues to work exactly as before! Learn more in our Installation Guide.

Albumentations is a fast and flexible library for image augmentation. Whether you're working on classification, segmentation, object detection, or other computer vision tasks, Albumentations provides a comprehensive set of transforms and a powerful pipeline framework.

This documentation will guide you through installing the library, understanding its core concepts, applying it to various tasks, and exploring advanced features.

Getting Started 🔗

• Introduction: Learn what data augmentation is and why it's important.
• Installation: Set up Albumentations in your environment.

Learning the Basics 🔗

• Core Concepts: Understand the fundamental building blocks: Transforms, Pipelines (Compose), Targets (image, mask, bboxes, keypoints), and Probabilities.
• Basic Usage Guides: Find practical examples for common computer vision tasks:
  • Image Classification
  • Semantic Segmentation
  • Object Detection (Bounding Boxes)
  • Keypoint Augmentation
  • Video Augmentation
  • Volumetric (3D) Augmentation
• Choosing Augmentations: A detailed guide on selecting effective augmentation strategies for model generalization.
• Performance Tuning: Tips for optimizing your augmentation pipeline speed.

Advanced Topics 🔗

• Advanced Guides: Explore more complex features:
  • Using Additional Targets
  • Creating Custom Transforms
  • Serialization

Other Resources 🔗

• Comparing with Torchvision/Kornia: See how Albumentations compares to other libraries.
• Frequently Asked Questions (FAQ): Find answers to common questions.
• Benchmarks: Performance comparison results.
• Supported Targets by Transform: Check which transforms work with images, masks, bounding boxes, keypoints, etc.
• API Reference
• GitHub Repositories:
  • AlbumentationsX - Active development (dual licensed)
  • Original Albumentations - MIT licensed (maintenance mode)
• Examples Repository: Many practical examples.

We hope this documentation helps you leverage the full power of Albumentations!