fimage-python 0.1.2__cp312-cp312-win_amd64.whl

fim/__init__.py

@@ -0,0 +1,72 @@
+"""
+FIM: Fast Image processing library with lazy evaluation.
+
+This module provides a PyVips-style lazy image processing pipeline built on
+top of a high-performance C++ backend using CRTP for zero-overhead abstraction.
+
+Example:
+    >>> import fim
+    >>>
+    >>> # Load and process an image lazily
+    >>> img = fim.Image.from_libtiff("input.tiff")
+    >>> result = img.crop((100, 100), (512, 512)).downsample(2)
+    >>>
+    >>> # Nothing has been computed yet - evaluation happens on write
+    >>> result.write_png("output.png")
+    >>>
+    >>> # Or convert to numpy
+    >>> array = result.to_numpy()  # shape: (height, width, channels)
+    >>>
+    >>> # High-quality resize with different kernels
+    >>> resized = img.resize(512, 512, kernel=fim.KernelType.LANCZOS3)
+    >>>
+    >>> # Resize with subpixel-accurate box parameter
+    >>> box = fim.Box(10.5, 20.5, 510.5, 520.5)
+    >>> cropped_resized = img.resize(256, 256, box=box)
+    >>>
+    >>> # Stack multiple images
+    >>> red = fim.Image.from_png("red.png")
+    >>> green = fim.Image.from_png("green.png")
+    >>> blue = fim.Image.from_png("blue.png")
+    >>> rgb = fim.Image.stack([red, green, blue], axis="bands")
+    >>> rgb.write_tiff("rgb.tiff")
+"""
+
+from ._fim import (
+    Image,
+    KernelType,
+    PixelType,
+    DataLayout,
+    CompressionType,
+    Box,
+    DeferredBlackCanvas,
+    FastSlideContext,
+    open_fastslide,
+    LibtiffContext,
+    open_libtiff,
+    __version__,
+)
+
+try:
+    from ._fim import OpenSlideContext, open_openslide  # type: ignore[attr-defined]
+except ImportError:
+    OpenSlideContext = None  # type: ignore[assignment]
+    open_openslide = None  # type: ignore[assignment]
+
+__all__ = [
+    "Image",
+    "KernelType",
+    "PixelType",
+    "DataLayout",
+    "CompressionType",
+    "Box",
+    "DeferredBlackCanvas",
+    "FastSlideContext",
+    "open_fastslide",
+    "LibtiffContext",
+    "open_libtiff",
+    "__version__",
+]
+
+if OpenSlideContext is not None and open_openslide is not None:
+    __all__.extend(["OpenSlideContext", "open_openslide"])

fim/_fim.pyi

@@ -0,0 +1,26 @@
+"""Typing stubs for the native `fim._fim` extension module.
+
+The runtime implementation is provided by a nanobind extension.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+class Image: ...
+class Box: ...
+class DeferredBlackCanvas: ...
+class FastSlideContext: ...
+class OpenSlideContext: ...
+class LibtiffContext: ...
+
+KernelType: Any
+PixelType: Any
+DataLayout: Any
+CompressionType: Any
+
+def open_fastslide(*args: Any, **kwargs: Any) -> Any: ...
+def open_openslide(*args: Any, **kwargs: Any) -> Any: ...
+def open_libtiff(*args: Any, **kwargs: Any) -> Any: ...
+
+__version__: str

fimage_python-0.1.2.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.1
+Name: fimage-python
+Version: 0.1.2
+Summary: Fast Image processing library with lazy evaluation
+Author-Email: AI for Oncology Research Group <j.teuwen@nki.nl>
+License: Apache-2.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Project-URL: Homepage, https://github.com/NKI-AI/fimage
+Project-URL: Repository, https://github.com/NKI-AI/fimage
+Project-URL: Issues, https://github.com/NKI-AI/fimage/issues
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.20
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Description-Content-Type: text/markdown
+
+# fim (FastImage)
+
+A high-performance C++20 library for tile-based image processing using CRTP
+(Curiously Recurring Template Pattern), with Python bindings that provide a
+PyVips-style lazy-evaluation pipeline.
+
+This repository is automatically synced from the AI for Oncology monorepo. It
+builds both with [Bazel](https://bazel.build/) (via bzlmod) and with
+[Meson](https://mesonbuild.com/) (used to produce the Python wheels).
+
+## Features
+
+- **Tile-based processing**: efficient processing of large images through tiling
+- **CRTP pipeline**: zero-overhead composition using compile-time polymorphism
+- **Lazy evaluation**: operations are deferred until a sink materializes the result
+- **Multiple sources**: TIFF (libtiff), PNG (lodepng/libspng), and FastSlide (whole slide images)
+- **Operators**: crop, paste, downsample, resize (Lanczos / Magic2021 kernels), and stack
+- **Flexible sinks**: tiled TIFF/PNG output or zero-copy NumPy arrays
+- **Python bindings**: full Python API via nanobind
+
+## Installation (Python)
+
+```bash
+pip install fimage-python
+```
+
+```python
+import fim
+
+img = fim.Image.from_libtiff("input.tiff")
+img.crop(100, 100, 512, 512).resize(256, 256).write_png("output.png")
+```
+
+## Building from source
+
+### Bazel
+
+```bash
+# Build the C++ library
+bazelisk build //:fimage
+
+# Build the Python extension
+bazelisk build //python:fim
+
+# Run the test suite
+bazelisk test //...
+```
+
+### Meson (wheels)
+
+```bash
+# Build a wheel + sdist for the current interpreter
+uv build
+```
+
+The Meson build fetches every dependency through `subprojects/*.wrap` and links
+them statically, producing a self-contained `_fim` extension.
+
+## License
+
+Apache 2.0 - see [LICENSE](LICENSE) for details.

fimage_python-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+fimage_python-0.1.2.dist-info/METADATA,sha256=XbJ4fHrBbxYeCLpsweql-6ODcahtMyfEIo7X0HvCc_0,2887
+fimage_python-0.1.2.dist-info/WHEEL,sha256=50PeAbplA6PkI0hYOYoeacB9US1R6EguyfOnsccH0WU,85
+fim/_fim.cp312-win_amd64.pyd,sha256=5L0mai2FehnS44nyIvJ_fnKL4gCxjDYnI2vSShFteRc,5140480
+fim/_fim.cp312-win_amd64.lib,sha256=wHFTlD4f2yGJtjYjAXXb9gNgdM5RLq3_28Sl908vLPs,9128
+fim/__init__.py,sha256=kGnk5sAc8S54Squ932Zetg0HeLSqrB-aaDwp55QVdMA,2116
+fim/_fim.pyi,sha256=utwHgZ-n8jKAet66JZCJhpljfTFoOc1I2LtCRelGyn4,621
+fimage_python-0.1.2.dist-info/RECORD,,

fimage_python-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: meson
+Root-Is-Purelib: false
+Tag: cp312-cp312-win_amd64