roifile 2024.5.24__tar.gz → 2025.2.20__tar.gz

{roifile-2024.5.24 → roifile-2025.2.20}/CHANGES.rst

@@ -1,9 +1,18 @@
 Revisions
 ---------
 
+2025.2.20
+
+- Drop support for Python 3.9.
+
+2024.9.15
+
+- Improve typing.
+- Deprecate Python 3.9, support Python 3.13.
+
 2024.5.24
 
-- Fix GitHub not correctly rendering docstring examples.
+- Fix docstring examples not correctly rendered on GitHub.
 
 2024.3.20
 

{roifile-2024.5.24 → roifile-2025.2.20}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2020-2024, Christoph Gohlke
+Copyright (c) 2020-2025, Christoph Gohlke
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

{roifile-2024.5.24/roifile.egg-info → roifile-2025.2.20}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: roifile
-Version: 2024.5.24
+Version: 2025.2.20
 Summary: Read and write ImageJ ROI format
 Home-page: https://www.cgohlke.com
 Author: Christoph Gohlke
@@ -15,17 +15,30 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: numpy
 Provides-Extra: all
 Requires-Dist: matplotlib; extra == "all"
 Requires-Dist: tifffile; extra == "all"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: platform
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 Read and write ImageJ ROI format
 ================================
@@ -38,7 +51,7 @@ interest, geometric shapes, paths, text, and whatnot for image overlays.
 
 :Author: `Christoph Gohlke <https://www.cgohlke.com>`_
 :License: BSD 3-Clause
-:Version: 2024.5.24
+:Version: 2025.2.20
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -64,17 +77,26 @@ Requirements
 This revision was tested with the following requirements and dependencies
 (other versions may work):
 
-- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
-- `Numpy <https://pypi.org/project/numpy/>`_ 1.26.4
-- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.5.22 (optional)
-- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.8.4 (optional)
+- `CPython <https://www.python.org>`_ 3.10.11, 3.11.9, 3.12.9, 3.13.2 64-bit
+- `NumPy <https://pypi.org/project/numpy/>`_ 2.2.3
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2025.2.18 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.10.0 (optional)
 
 Revisions
 ---------
 
+2025.2.20
+
+- Drop support for Python 3.9.
+
+2024.9.15
+
+- Improve typing.
+- Deprecate Python 3.9, support Python 3.13.
+
 2024.5.24
 
-- Fix GitHub not correctly rendering docstring examples.
+- Fix docstring examples not correctly rendered on GitHub.
 
 2024.3.20
 
@@ -160,11 +182,38 @@ array([[1.1, 2.2],
        [5.5, 6.6]], dtype=float32)
 >>> roi.left, roi.top, roi.right, roi.bottom
 (1, 2, 7, 8)
+>>> roi2.name = 'test'
 
 Plot the ROI using matplotlib:
 
 >>> roi.plot()
 
+Write the ROIs to a ZIP file:
+
+>>> roiwrite('_test.zip', [roi, roi2], mode='w')
+
+Read the ROIs from the ZIP file:
+
+>>> rois = roiread('_test.zip')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
+Write the ROIs to an ImageJ formatted TIFF file:
+
+>>> import tifffile
+>>> tifffile.imwrite(
+...     '_test.tif',
+...     numpy.zeros((9, 9), 'u1'),
+...     imagej=True,
+...     metadata={'Overlays': [roi.tobytes(), roi2.tobytes()]},
+... )
+
+Read the ROIs embedded in an ImageJ formatted TIFF file:
+
+>>> rois = roiread('_test.tif')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
 View the overlays stored in a ROI, ZIP, or TIFF file from a command line::
 
     python -m roifile _test.roi
+
+For an advanced example, see `roifile_demo.py` in the source distribution.

{roifile-2024.5.24 → roifile-2025.2.20}/README.rst

@@ -12,7 +12,7 @@ interest, geometric shapes, paths, text, and whatnot for image overlays.
 
 :Author: `Christoph Gohlke <https://www.cgohlke.com>`_
 :License: BSD 3-Clause
-:Version: 2024.5.24
+:Version: 2025.2.20
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -38,17 +38,26 @@ Requirements
 This revision was tested with the following requirements and dependencies
 (other versions may work):
 
-- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
-- `Numpy <https://pypi.org/project/numpy/>`_ 1.26.4
-- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.5.22 (optional)
-- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.8.4 (optional)
+- `CPython <https://www.python.org>`_ 3.10.11, 3.11.9, 3.12.9, 3.13.2 64-bit
+- `NumPy <https://pypi.org/project/numpy/>`_ 2.2.3
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2025.2.18 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.10.0 (optional)
 
 Revisions
 ---------
 
+2025.2.20
+
+- Drop support for Python 3.9.
+
+2024.9.15
+
+- Improve typing.
+- Deprecate Python 3.9, support Python 3.13.
+
 2024.5.24
 
-- Fix GitHub not correctly rendering docstring examples.
+- Fix docstring examples not correctly rendered on GitHub.
 
 2024.3.20
 
@@ -140,6 +149,7 @@ Read the ImageJ ROI from the file and verify the content:
            [5.5, 6.6]], dtype=float32)
     >>> roi.left, roi.top, roi.right, roi.bottom
     (1, 2, 7, 8)
+    >>> roi2.name = 'test'
 
 Plot the ROI using matplotlib:
 
@@ -147,6 +157,40 @@ Plot the ROI using matplotlib:
 
     >>> roi.plot()
 
+Write the ROIs to a ZIP file:
+
+.. code-block:: python
+
+    >>> roiwrite('_test.zip', [roi, roi2], mode='w')
+
+Read the ROIs from the ZIP file:
+
+.. code-block:: python
+
+    >>> rois = roiread('_test.zip')
+    >>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
+Write the ROIs to an ImageJ formatted TIFF file:
+
+.. code-block:: python
+
+    >>> import tifffile
+    >>> tifffile.imwrite(
+    ...     '_test.tif',
+    ...     numpy.zeros((9, 9), 'u1'),
+    ...     imagej=True,
+    ...     metadata={'Overlays': [roi.tobytes(), roi2.tobytes()]},
+    ... )
+
+Read the ROIs embedded in an ImageJ formatted TIFF file:
+
+.. code-block:: python
+
+    >>> rois = roiread('_test.tif')
+    >>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
 View the overlays stored in a ROI, ZIP, or TIFF file from a command line::
 
-    python -m roifile _test.roi
+    python -m roifile _test.roi
+
+For an advanced example, see `roifile_demo.py` in the source distribution.

{roifile-2024.5.24 → roifile-2025.2.20}/roifile/roifile.py

@@ -1,6 +1,6 @@
 # roifile.py
 
-# Copyright (c) 2020-2024, Christoph Gohlke
+# Copyright (c) 2020-2025, Christoph Gohlke
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -39,7 +39,7 @@ interest, geometric shapes, paths, text, and whatnot for image overlays.
 
 :Author: `Christoph Gohlke <https://www.cgohlke.com>`_
 :License: BSD 3-Clause
-:Version: 2024.5.24
+:Version: 2025.2.20
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -65,17 +65,26 @@ Requirements
 This revision was tested with the following requirements and dependencies
 (other versions may work):
 
-- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
-- `Numpy <https://pypi.org/project/numpy/>`_ 1.26.4
-- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.5.22 (optional)
-- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.8.4 (optional)
+- `CPython <https://www.python.org>`_ 3.10.11, 3.11.9, 3.12.9, 3.13.2 64-bit
+- `NumPy <https://pypi.org/project/numpy/>`_ 2.2.3
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2025.2.18 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.10.0 (optional)
 
 Revisions
 ---------
 
+2025.2.20
+
+- Drop support for Python 3.9.
+
+2024.9.15
+
+- Improve typing.
+- Deprecate Python 3.9, support Python 3.13.
+
 2024.5.24
 
-- Fix GitHub not correctly rendering docstring examples.
+- Fix docstring examples not correctly rendered on GitHub.
 
 2024.3.20
 
@@ -161,22 +170,50 @@ array([[1.1, 2.2],
        [5.5, 6.6]], dtype=float32)
 >>> roi.left, roi.top, roi.right, roi.bottom
 (1, 2, 7, 8)
+>>> roi2.name = 'test'
 
 Plot the ROI using matplotlib:
 
 >>> roi.plot()
 
+Write the ROIs to a ZIP file:
+
+>>> roiwrite('_test.zip', [roi, roi2], mode='w')
+
+Read the ROIs from the ZIP file:
+
+>>> rois = roiread('_test.zip')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
+Write the ROIs to an ImageJ formatted TIFF file:
+
+>>> import tifffile
+>>> tifffile.imwrite(
+...     '_test.tif',
+...     numpy.zeros((9, 9), 'u1'),
+...     imagej=True,
+...     metadata={'Overlays': [roi.tobytes(), roi2.tobytes()]},
+... )
+
+Read the ROIs embedded in an ImageJ formatted TIFF file:
+
+>>> rois = roiread('_test.tif')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
 View the overlays stored in a ROI, ZIP, or TIFF file from a command line::
 
     python -m roifile _test.roi
 
+For an advanced example, see `roifile_demo.py` in the source distribution.
+
 """
 
 from __future__ import annotations
 
-__version__ = '2024.5.24'
+__version__ = '2025.2.20'
 
 __all__ = [
+    '__version__',
     'roiread',
     'roiwrite',
     'ImagejRoi',
@@ -200,9 +237,10 @@ from typing import TYPE_CHECKING
 import numpy
 
 if TYPE_CHECKING:
-    from collections.abc import Iterable
+    from collections.abc import Iterable, Iterator
     from typing import Any, Literal
 
+    from matplotlib.axes import Axes
     from numpy.typing import ArrayLike, NDArray
 
 
@@ -253,6 +291,7 @@ def roiwrite(
 
     import zipfile
 
+    assert mode is not None
     with zipfile.ZipFile(filename, mode) as zf:
         for r in roi:
             if name is None:
@@ -717,6 +756,7 @@ class ImagejRoi:
                 mode = 'a' if os.path.exists(filename) else 'w'
             import zipfile
 
+            assert mode is not None
             with zipfile.ZipFile(filename, mode) as zf:
                 with zf.open(name, 'w') as fh:
                     fh.write(self.tobytes())
@@ -892,15 +932,16 @@ class ImagejRoi:
 
     def plot(
         self,
-        ax: Any | None = None,
+        ax: Axes | None = None,
         *,
         rois: Iterable[ImagejRoi] | None = None,
         title: str | None = None,
         bounds: bool = False,
         invert_yaxis: bool | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> None:
         """Plot a draft of coordinates using matplotlib."""
+        fig: Any
         roitype = self.roitype
         subtype = self.subtype
 
@@ -942,8 +983,6 @@ class ImagejRoi:
             pyplot.show()
             return
 
-        if kwargs is None:
-            kwargs = {}
         if 'color' not in kwargs and 'c' not in kwargs:
             kwargs['color'] = self.hexcolor(self.stroke_color)
         if 'linewidth' not in kwargs and 'lw' not in kwargs:
@@ -974,7 +1013,8 @@ class ImagejRoi:
             if 'fontsize' not in kwargs and self.text_size > 0:
                 kwargs['fontsize'] = self.text_size
             text = ax.text(
-                *coords[1],
+                coords[1][0],
+                coords[1][1],
                 self.text,
                 va='center_baseline',
                 rotation=self.text_angle,
@@ -1063,9 +1103,11 @@ class ImagejRoi:
         multi_coordinates: NDArray[numpy.float32], /
     ) -> list[NDArray[numpy.float32]]:
         """Return list of coordinate arrays from 2D geometric path."""
-        coordinates = []
+        coordinates: list[NDArray[numpy.float32]] = []
         points: list[list[float]] = []
-        path: list[float] = multi_coordinates.tolist()
+        path: list[float] = []
+
+        path = multi_coordinates.tolist()  # type: ignore[assignment]
         n = 0
         m = 0
         while n < len(path):
@@ -1180,17 +1222,37 @@ class ImagejRoi:
         return indent(*info, end='\n)')
 
 
-def scale_text(text: Any, width: float) -> None:
+def scale_text(
+    text: Any,
+    width: float,
+    *,
+    offset: tuple[float, float] | None = None,
+) -> None:
     """Scale matplotlib text to width in data coordinates."""
     from matplotlib.patheffects import AbstractPathEffect
     from matplotlib.transforms import Bbox
 
     class TextScaler(AbstractPathEffect):
-        def __init__(self, text, width):
+        def __init__(
+            self,
+            text: Any,
+            width: float,
+            offset: tuple[float, float] | None = None,
+        ) -> None:
+            if offset is None:
+                offset = (0.0, 0.0)
+            super().__init__(offset)
             self._text = text
             self._width = width
 
-        def draw_path(self, renderer, gc, tpath, affine, rgbFace=None):
+        def draw_path(
+            self,
+            renderer: Any,
+            gc: Any,
+            tpath: Any,
+            affine: Any,
+            rgbFace: Any = None,
+        ) -> None:
             ax = self._text.axes
             renderer = ax.get_figure().canvas.get_renderer()
             bbox = text.get_window_extent(renderer=renderer)
@@ -1200,7 +1262,7 @@ def scale_text(text: Any, width: float) -> None:
                 affine = affine.from_values(scale, 0, 0, scale, 0, 0) + affine
             renderer.draw_path(gc, tpath, affine, rgbFace)
 
-    text.set_path_effects([TextScaler(text, width)])
+    text.set_path_effects([TextScaler(text, width, offset)])
 
 
 def oval(rect: ArrayLike, /, points: int = 33) -> NDArray[numpy.float32]:
@@ -1215,9 +1277,9 @@ def oval(rect: ArrayLike, /, points: int = 33) -> NDArray[numpy.float32]:
     return c
 
 
-def indent(*args: Any, sep='', end='') -> str:
+def indent(*args: Any, sep: str = '', end: str = '') -> str:
     """Return joined string representations of objects with indented lines."""
-    text = (sep + '\n').join(
+    text: str = (sep + '\n').join(
         arg if isinstance(arg, str) else repr(arg) for arg in args
     )
     return (
@@ -1256,7 +1318,7 @@ def logger() -> logging.Logger:
 def test(verbose: bool = False) -> None:
     """Test roifile.ImagejRoi class."""
     # test ROIs from a ZIP file
-    rois = ImagejRoi.fromfile('tests/ijzip.zip')
+    rois: Any = ImagejRoi.fromfile('tests/ijzip.zip')
     assert isinstance(rois, list)
     assert len(rois) == 7
     for roi in rois:
@@ -1272,7 +1334,7 @@ def test(verbose: bool = False) -> None:
     except OSError:
         pass
 
-    def roi_iter():
+    def roi_iter() -> Iterator[ImagejRoi]:
         # issue #9
         yield from rois
 

{roifile-2024.5.24 → roifile-2025.2.20/roifile.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: roifile
-Version: 2024.5.24
+Version: 2025.2.20
 Summary: Read and write ImageJ ROI format
 Home-page: https://www.cgohlke.com
 Author: Christoph Gohlke
@@ -15,17 +15,30 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: numpy
 Provides-Extra: all
 Requires-Dist: matplotlib; extra == "all"
 Requires-Dist: tifffile; extra == "all"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: platform
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 Read and write ImageJ ROI format
 ================================
@@ -38,7 +51,7 @@ interest, geometric shapes, paths, text, and whatnot for image overlays.
 
 :Author: `Christoph Gohlke <https://www.cgohlke.com>`_
 :License: BSD 3-Clause
-:Version: 2024.5.24
+:Version: 2025.2.20
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -64,17 +77,26 @@ Requirements
 This revision was tested with the following requirements and dependencies
 (other versions may work):
 
-- `CPython <https://www.python.org>`_ 3.9.13, 3.10.11, 3.11.9, 3.12.3
-- `Numpy <https://pypi.org/project/numpy/>`_ 1.26.4
-- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.5.22 (optional)
-- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.8.4 (optional)
+- `CPython <https://www.python.org>`_ 3.10.11, 3.11.9, 3.12.9, 3.13.2 64-bit
+- `NumPy <https://pypi.org/project/numpy/>`_ 2.2.3
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2025.2.18 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.10.0 (optional)
 
 Revisions
 ---------
 
+2025.2.20
+
+- Drop support for Python 3.9.
+
+2024.9.15
+
+- Improve typing.
+- Deprecate Python 3.9, support Python 3.13.
+
 2024.5.24
 
-- Fix GitHub not correctly rendering docstring examples.
+- Fix docstring examples not correctly rendered on GitHub.
 
 2024.3.20
 
@@ -160,11 +182,38 @@ array([[1.1, 2.2],
        [5.5, 6.6]], dtype=float32)
 >>> roi.left, roi.top, roi.right, roi.bottom
 (1, 2, 7, 8)
+>>> roi2.name = 'test'
 
 Plot the ROI using matplotlib:
 
 >>> roi.plot()
 
+Write the ROIs to a ZIP file:
+
+>>> roiwrite('_test.zip', [roi, roi2], mode='w')
+
+Read the ROIs from the ZIP file:
+
+>>> rois = roiread('_test.zip')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
+Write the ROIs to an ImageJ formatted TIFF file:
+
+>>> import tifffile
+>>> tifffile.imwrite(
+...     '_test.tif',
+...     numpy.zeros((9, 9), 'u1'),
+...     imagej=True,
+...     metadata={'Overlays': [roi.tobytes(), roi2.tobytes()]},
+... )
+
+Read the ROIs embedded in an ImageJ formatted TIFF file:
+
+>>> rois = roiread('_test.tif')
+>>> assert len(rois) == 2 and rois[0] == roi and rois[1].name == 'test'
+
 View the overlays stored in a ROI, ZIP, or TIFF file from a command line::
 
     python -m roifile _test.roi
+
+For an advanced example, see `roifile_demo.py` in the source distribution.

{roifile-2024.5.24 → roifile-2025.2.20}/setup.py

@@ -8,7 +8,7 @@ import sys
 from setuptools import setup
 
 
-def search(pattern, string, flags=0):
+def search(pattern: str, string: str, flags: int = 0) -> str:
     """Return first match of pattern in string."""
     match = re.search(pattern, string, flags)
     if match is None:
@@ -16,7 +16,7 @@ def search(pattern, string, flags=0):
     return match.groups()[0]
 
 
-def fix_docstring_examples(docstring):
+def fix_docstring_examples(docstring: str) -> str:
     """Return docstring with examples fixed for GitHub."""
     start = True
     indent = False
@@ -99,7 +99,7 @@ setup(
     packages=['roifile'],
     package_data={'roifile': ['py.typed']},
     entry_points={'console_scripts': ['roifile = roifile.roifile:main']},
-    python_requires='>=3.9',
+    python_requires='>=3.10',
     install_requires=['numpy'],
     extras_require={'all': ['matplotlib', 'tifffile']},
     platforms=['any'],
@@ -110,9 +110,9 @@ setup(
         'Intended Audience :: Developers',
         'Operating System :: OS Independent',
         'Programming Language :: Python :: 3 :: Only',
-        'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
         'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
     ],
 )