feat: Add transform method to Layer class (AI GENERATED)

[Tobias314]

Attention: AI generated PR (should be handled as experimental and with care)

This commit introduces a new transform method to the Layer class, allowing for spatial transformations of layer data.

The method takes an output layer, an inverse transformation function, and optional parameters for magnification, number of threads, output bounding box, and chunk shape.

Key features:

• Supports arbitrary inverse transformations (e.g., affine, rotation, translation, scaling) via a callable.
• Processes data in chunks to handle large datasets efficiently.
• Utilizes multithreading for improved performance.
• Handles out-of-bounds coordinates by clamping and uses nearest-neighbor interpolation for non-integer coordinates.

Unit tests have been added to webknossos/tests/dataset/test_layer.py to verify the functionality, covering:

• Identity, translation, scaling, and affine transformations.
• Different output bounding box configurations.
• Various chunk shapes and numbers of threads.
• Edge cases such as transformations mapping outside input bounds and small input layers.

Description:

• abc

Issues:

• fixes #...

Todos:

Make sure to delete unnecessary points or to check all before merging:

• Updated Changelog
• Updated Documentation
• Added / Updated Tests
• Considered adding this to the Examples