Add random gaussian blur

[ternaus]

Addresses: #2092

Summary by Sourcery

Add RandomGaussianBlur transform as an alias for GaussianBlur to ensure compatibility with Kornia API, refactor MotionBlur class, update documentation, and add a test case for the new transform.

New Features:

• Introduce RandomGaussianBlur transform as an alias for GaussianBlur, providing compatibility with Kornia API.

Enhancements:

• Refactor MotionBlur class to use BlurInitSchema and remove redundant blur limit validation.

Documentation:

• Add documentation entry for RandomGaussianBlur in README.md.

Tests:

• Add test case for RandomGaussianBlur in aug_definitions.py.

[sourcery-ai]

Reviewer's Guide by Sourcery

This PR adds a new RandomGaussianBlur transform class that serves as an alias for the existing GaussianBlur transform, providing compatibility with Kornia's API while maintaining the same functionality. The implementation includes parameter mapping between the two naming conventions and adds appropriate documentation and tests.

Class diagram for the new RandomGaussianBlur transform

classDiagram
    class RandomGaussianBlur {
        - ScaleIntType kernel_size
        - ScaleFloatType sigma
        - bool|None always_apply
        - float p
        + RandomGaussianBlur(ScaleIntType kernel_size, ScaleFloatType sigma, bool|None always_apply, float p)
        + get_transform_init_args_names() tuple[str, ...]
    }
    class GaussianBlur {
        <<abstract>>
    }
    RandomGaussianBlur --|> GaussianBlur : Inherits
    note for RandomGaussianBlur "This class is an alias for GaussianBlur with parameter naming for Kornia compatibility."

Loading

File-Level Changes

Change	Details	Files
Added new RandomGaussianBlur transform class as an alias for GaussianBlur	Created new class inheriting from GaussianBlur Mapped 'kernel_size' parameter to 'blur_limit' Mapped 'sigma' parameter to 'sigma_limit' Added deprecation warning encouraging use of GaussianBlur directly Implemented transform initialization schema	albumentations/augmentations/tk/transform.py
Updated documentation and test coverage	Added RandomGaussianBlur to the pixel-level transforms list Added RandomGaussianBlur to the test definitions	README.md tests/aug_definitions.py
Refactored blur transform validation logic	Changed MotionBlur to use BlurInitSchema Fixed return type annotation for get_transform_init_args_names	albumentations/augmentations/blur/transforms.py

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time. You can also use
  this command to specify where the summary should be inserted.

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey @ternaus - I've reviewed your changes and they look great!

Here's what I looked at during the review

• 🟢 General issues: all looks good
• 🟢 Security: all looks good
• 🟡 Testing: 1 issue found
• 🟡 Complexity: 1 issue found
• 🟢 Documentation: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.37%. Comparing base (b1a79c2) to head (e570678).
Report is 276 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##           main    #2144       +/-   ##
=========================================
+ Coverage      0   90.37%   +90.37%     
=========================================
  Files         0       48       +48     
  Lines         0     8045     +8045     
=========================================
+ Hits          0     7271     +7271     
- Misses        0      774      +774     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.