roifile 2024.5.24__py3-none-any.whl → 2024.9.15__py3-none-any.whl

roifile/roifile.py

@@ -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: 2024.9.15
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -65,17 +65,22 @@ 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.5, 3.13.0rc2
+- `Numpy <https://pypi.org/project/numpy/>`_ 2.2.1
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.8.30 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.9.2 (optional)
 
 Revisions
 ---------
 
+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,20 +166,47 @@ 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__ = '2024.9.15'
 
 __all__ = [
     'roiread',
@@ -201,8 +233,9 @@ import numpy
 
 if TYPE_CHECKING:
     from collections.abc import Iterable
-    from typing import Any, Literal
+    from typing import Any, Iterator, Literal
 
+    from matplotlib.axes import Axes
     from numpy.typing import ArrayLike, NDArray
 
 
@@ -892,15 +925,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 +976,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 +1006,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,
@@ -1180,17 +1213,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 +1253,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 +1268,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 +1309,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 +1325,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.dist-info → roifile-2024.9.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: roifile
-Version: 2024.5.24
+Version: 2024.9.15
 Summary: Read and write ImageJ ROI format
 Home-page: https://www.cgohlke.com
 Author: Christoph Gohlke
@@ -15,17 +15,17 @@ 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
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
 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'
+Requires-Dist: matplotlib; extra == "all"
+Requires-Dist: tifffile; extra == "all"
 
 Read and write ImageJ ROI format
 ================================
@@ -38,7 +38,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: 2024.9.15
 :DOI: `10.5281/zenodo.6941603 <https://doi.org/10.5281/zenodo.6941603>`_
 
 Quickstart
@@ -64,17 +64,22 @@ 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.5, 3.13.0rc2
+- `Numpy <https://pypi.org/project/numpy/>`_ 2.2.1
+- `Tifffile <https://pypi.org/project/tifffile/>`_ 2024.8.30 (optional)
+- `Matplotlib <https://pypi.org/project/matplotlib/>`_ 3.9.2 (optional)
 
 Revisions
 ---------
 
+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 +165,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.9.15.dist-info/RECORD

@@ -0,0 +1,10 @@
+roifile/__init__.py,sha256=leII9J_JWVpi0O9sAnG8s4SpcdwdqEeisFEFsnmN56c,101
+roifile/__main__.py,sha256=Mfn3wm-4cRRChIRonbEcZZT7eRX6RFlS31S8wS1JAVM,132
+roifile/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+roifile/roifile.py,sha256=4DEDDd_hzjhPdrByjDRBYOEzkcjVvg9X3urOOmvStYI,48478
+roifile-2024.9.15.dist-info/LICENSE,sha256=4bDcZTEFGF584Dw8M-07T5qfat7bsrfr8uuffsbFJYU,1559
+roifile-2024.9.15.dist-info/METADATA,sha256=_jKO-ffueSPxsvfJ-b2oTOAA99QgkgI8sTdGe_IMi88,5471
+roifile-2024.9.15.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
+roifile-2024.9.15.dist-info/entry_points.txt,sha256=xP8cwEUbAUeROLXNRanJnAIl13tagbjSSDGfVWf2vh0,49
+roifile-2024.9.15.dist-info/top_level.txt,sha256=QlfLomxPxuYNU0TTR7MXoVBAEAXCj2WJyKvoCJxNwek,8
+roifile-2024.9.15.dist-info/RECORD,,

{roifile-2024.5.24.dist-info → roifile-2024.9.15.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (74.1.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

roifile-2024.5.24.dist-info/RECORD

@@ -1,10 +0,0 @@
-roifile/__init__.py,sha256=leII9J_JWVpi0O9sAnG8s4SpcdwdqEeisFEFsnmN56c,101
-roifile/__main__.py,sha256=Mfn3wm-4cRRChIRonbEcZZT7eRX6RFlS31S8wS1JAVM,132
-roifile/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-roifile/roifile.py,sha256=2SiA7oALORVX0mJC6FfyiHnUxivoU06ptIAp9hmuqrk,47109
-roifile-2024.5.24.dist-info/LICENSE,sha256=4bDcZTEFGF584Dw8M-07T5qfat7bsrfr8uuffsbFJYU,1559
-roifile-2024.5.24.dist-info/METADATA,sha256=GP9Nj1hx9z3W733mHG8GCBIR257HGOunuhOkqGVkmTo,4639
-roifile-2024.5.24.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-roifile-2024.5.24.dist-info/entry_points.txt,sha256=xP8cwEUbAUeROLXNRanJnAIl13tagbjSSDGfVWf2vh0,49
-roifile-2024.5.24.dist-info/top_level.txt,sha256=QlfLomxPxuYNU0TTR7MXoVBAEAXCj2WJyKvoCJxNwek,8
-roifile-2024.5.24.dist-info/RECORD,,