PlotPy 2.8.4__tar.gz → 2.10.0__tar.gz

{plotpy-2.8.4 → plotpy-2.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PlotPy
-Version: 2.8.4
+Version: 2.10.0
 Summary: Curve and image plotting tools for Python/Qt applications
 Author-email: Codra <p.raybaut@codra.fr>
 License: BSD 3-Clause License
@@ -63,7 +63,7 @@ Requires-Python: <4,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: guidata>=3.14.1
-Requires-Dist: PythonQwt>=0.15
+Requires-Dist: PythonQwt>=0.16
 Requires-Dist: numpy>=1.22
 Requires-Dist: SciPy>=1.7.3
 Requires-Dist: scikit-image>=0.19
@@ -114,6 +114,8 @@ It is part of the [PlotPyStack](https://github.com/PlotPyStack) project, aiming
 * [guidata](https://pypi.python.org/pypi/guidata) automatic GUI generation library
 * [PythonQwt](https://pypi.python.org/pypi/PythonQwt) plotting widgets library
 * [NumPy](https://pypi.python.org/pypi/NumPy) and [SciPy](https://pypi.python.org/pypi/SciPy) scientific computing libraries
+* [scikit-image](https://pypi.python.org/pypi/scikit-image) image processing library
+* [Pillow](https://pypi.python.org/pypi/Pillow) imaging library and [tifffile](https://pypi.python.org/pypi/tifffile) TIFF I/O library
 
 <img src="https://raw.githubusercontent.com/PlotPyStack/plotpy/master/doc/images/panorama.png">
 
@@ -121,7 +123,7 @@ See [documentation](https://plotpy.readthedocs.io/en/latest/) for more details o
 
 Copyrights and licensing:
 
-* Copyright © 2023 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
+* Copyright © 2023-2026 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
 * Licensed under the terms of the BSD 3-Clause (see [LICENSE](https://github.com/PlotPyStack/PlotPy/blob/master/LICENSE)).
 
 ## Features
@@ -132,7 +134,7 @@ General plotting features:
 
 * Ready-to-use [plot widgets and dialog boxes](https://plotpy.readthedocs.io/en/latest/features/plot/index.html)
 * [pyplot](https://plotpy.readthedocs.io/en/latest/features/pyplot.html): interactive plotting widgets, equivalent to `matplotlib.pyplot`, at least for the implemented functions
-* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, labels, shapes, annotations, ...
+* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, vector fields (quiver plots), labels, shapes, annotations, ...
 
 Interactive features (i.e. not only programmatic plotting but also with mouse/keyboard):
 
@@ -141,7 +143,7 @@ Interactive features (i.e. not only programmatic plotting but also with mouse/ke
 * Customizable aspect ratio for images
 * Tons of ready-to-use tools: plot canvas export to image file, image snapshot, interval selection, image rectangular filter, etc.
 * Curve fitting tool with automatic fit, manual fit with sliders, ...
-* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, ...
+* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, invert colormaps, ...
 * X-axis and Y-axis cross-sections: support for multiple images, average cross-section tool on a rectangular area, ...
 * Apply any affine transform to displayed images in real-time (rotation, magnification, translation, horizontal/vertical flip, ...)
 

{plotpy-2.8.4 → plotpy-2.10.0}/PlotPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PlotPy
-Version: 2.8.4
+Version: 2.10.0
 Summary: Curve and image plotting tools for Python/Qt applications
 Author-email: Codra <p.raybaut@codra.fr>
 License: BSD 3-Clause License
@@ -63,7 +63,7 @@ Requires-Python: <4,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: guidata>=3.14.1
-Requires-Dist: PythonQwt>=0.15
+Requires-Dist: PythonQwt>=0.16
 Requires-Dist: numpy>=1.22
 Requires-Dist: SciPy>=1.7.3
 Requires-Dist: scikit-image>=0.19
@@ -114,6 +114,8 @@ It is part of the [PlotPyStack](https://github.com/PlotPyStack) project, aiming
 * [guidata](https://pypi.python.org/pypi/guidata) automatic GUI generation library
 * [PythonQwt](https://pypi.python.org/pypi/PythonQwt) plotting widgets library
 * [NumPy](https://pypi.python.org/pypi/NumPy) and [SciPy](https://pypi.python.org/pypi/SciPy) scientific computing libraries
+* [scikit-image](https://pypi.python.org/pypi/scikit-image) image processing library
+* [Pillow](https://pypi.python.org/pypi/Pillow) imaging library and [tifffile](https://pypi.python.org/pypi/tifffile) TIFF I/O library
 
 <img src="https://raw.githubusercontent.com/PlotPyStack/plotpy/master/doc/images/panorama.png">
 
@@ -121,7 +123,7 @@ See [documentation](https://plotpy.readthedocs.io/en/latest/) for more details o
 
 Copyrights and licensing:
 
-* Copyright © 2023 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
+* Copyright © 2023-2026 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
 * Licensed under the terms of the BSD 3-Clause (see [LICENSE](https://github.com/PlotPyStack/PlotPy/blob/master/LICENSE)).
 
 ## Features
@@ -132,7 +134,7 @@ General plotting features:
 
 * Ready-to-use [plot widgets and dialog boxes](https://plotpy.readthedocs.io/en/latest/features/plot/index.html)
 * [pyplot](https://plotpy.readthedocs.io/en/latest/features/pyplot.html): interactive plotting widgets, equivalent to `matplotlib.pyplot`, at least for the implemented functions
-* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, labels, shapes, annotations, ...
+* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, vector fields (quiver plots), labels, shapes, annotations, ...
 
 Interactive features (i.e. not only programmatic plotting but also with mouse/keyboard):
 
@@ -141,7 +143,7 @@ Interactive features (i.e. not only programmatic plotting but also with mouse/ke
 * Customizable aspect ratio for images
 * Tons of ready-to-use tools: plot canvas export to image file, image snapshot, interval selection, image rectangular filter, etc.
 * Curve fitting tool with automatic fit, manual fit with sliders, ...
-* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, ...
+* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, invert colormaps, ...
 * X-axis and Y-axis cross-sections: support for multiple images, average cross-section tool on a rectangular area, ...
 * Apply any affine transform to displayed images in real-time (rotation, magnification, translation, horizontal/vertical flip, ...)
 

{plotpy-2.8.4 → plotpy-2.10.0}/PlotPy.egg-info/SOURCES.txt

@@ -116,6 +116,8 @@ doc/release_notes/release_2.05.md
 doc/release_notes/release_2.06.md
 doc/release_notes/release_2.07.md
 doc/release_notes/release_2.08.md
+doc/release_notes/release_2.09.md
+doc/release_notes/release_2.10.md
 plotpy/__init__.py
 plotpy/config.py
 plotpy/constants.py
@@ -249,6 +251,7 @@ plotpy/data/icons/items/image.png
 plotpy/data/icons/items/label.png
 plotpy/data/icons/items/legend.png
 plotpy/data/icons/items/polygonmap.png
+plotpy/data/icons/items/quiver.png
 plotpy/data/icons/markers/cross.png
 plotpy/data/icons/markers/diamond.png
 plotpy/data/icons/markers/ellipse.png
@@ -325,6 +328,7 @@ plotpy/items/grid.py
 plotpy/items/histogram.py
 plotpy/items/label.py
 plotpy/items/polygonmap.py
+plotpy/items/quiver.py
 plotpy/items/curve/__init__.py
 plotpy/items/curve/base.py
 plotpy/items/curve/errorbar.py
@@ -418,6 +422,7 @@ plotpy/tests/features/test_plot_time.py
 plotpy/tests/features/test_plot_types.py
 plotpy/tests/features/test_plot_yreverse.py
 plotpy/tests/features/test_pyplot.py
+plotpy/tests/features/test_quiver.py
 plotpy/tests/features/test_resize.py
 plotpy/tests/items/__init__.py
 plotpy/tests/items/test_annotated_range.py
@@ -458,7 +463,9 @@ plotpy/tests/tools/test_stats_tools.py
 plotpy/tests/tools/test_zaxislog.py
 plotpy/tests/unit/__init__.py
 plotpy/tests/unit/test_annotation_tools.py
+plotpy/tests/unit/test_arrayfuncs.py
 plotpy/tests/unit/test_aspect_ratio_tool.py
+plotpy/tests/unit/test_autoscale_strategy.py
 plotpy/tests/unit/test_baseplot.py
 plotpy/tests/unit/test_builder_annotation.py
 plotpy/tests/unit/test_builder_curve.py
@@ -472,6 +479,7 @@ plotpy/tests/unit/test_display_coords_tool.py
 plotpy/tests/unit/test_events.py
 plotpy/tests/unit/test_fontparam.py
 plotpy/tests/unit/test_geometry.py
+plotpy/tests/unit/test_image_log_set_data.py
 plotpy/tests/unit/test_io.py
 plotpy/tests/unit/test_line.py
 plotpy/tests/unit/test_line_cross_section_tool.py
@@ -484,6 +492,7 @@ plotpy/tests/unit/test_plot_curve.py
 plotpy/tests/unit/test_plot_image.py
 plotpy/tests/unit/test_rect_zoom.py
 plotpy/tests/unit/test_seg_dist.py
+plotpy/tests/unit/test_snapshot_original_size.py
 plotpy/tests/unit/test_styles.py
 plotpy/tests/unit/test_tools_export.py
 plotpy/tests/unit/utils.py

{plotpy-2.8.4 → plotpy-2.10.0}/PlotPy.egg-info/requires.txt

@@ -1,5 +1,5 @@
 guidata>=3.14.1
-PythonQwt>=0.15
+PythonQwt>=0.16
 numpy>=1.22
 SciPy>=1.7.3
 scikit-image>=0.19

{plotpy-2.8.4 → plotpy-2.10.0}/README.md

@@ -20,6 +20,8 @@ It is part of the [PlotPyStack](https://github.com/PlotPyStack) project, aiming
 * [guidata](https://pypi.python.org/pypi/guidata) automatic GUI generation library
 * [PythonQwt](https://pypi.python.org/pypi/PythonQwt) plotting widgets library
 * [NumPy](https://pypi.python.org/pypi/NumPy) and [SciPy](https://pypi.python.org/pypi/SciPy) scientific computing libraries
+* [scikit-image](https://pypi.python.org/pypi/scikit-image) image processing library
+* [Pillow](https://pypi.python.org/pypi/Pillow) imaging library and [tifffile](https://pypi.python.org/pypi/tifffile) TIFF I/O library
 
 <img src="https://raw.githubusercontent.com/PlotPyStack/plotpy/master/doc/images/panorama.png">
 
@@ -27,7 +29,7 @@ See [documentation](https://plotpy.readthedocs.io/en/latest/) for more details o
 
 Copyrights and licensing:
 
-* Copyright © 2023 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
+* Copyright © 2023-2026 [CEA](https://www.cea.fr), [Codra](https://codra.net/), [Pierre Raybaut](https://github.com/PierreRaybaut).
 * Licensed under the terms of the BSD 3-Clause (see [LICENSE](https://github.com/PlotPyStack/PlotPy/blob/master/LICENSE)).
 
 ## Features
@@ -38,7 +40,7 @@ General plotting features:
 
 * Ready-to-use [plot widgets and dialog boxes](https://plotpy.readthedocs.io/en/latest/features/plot/index.html)
 * [pyplot](https://plotpy.readthedocs.io/en/latest/features/pyplot.html): interactive plotting widgets, equivalent to `matplotlib.pyplot`, at least for the implemented functions
-* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, labels, shapes, annotations, ...
+* Supported [plot items](https://plotpy.readthedocs.io/en/latest/features/items/index.html): curves, images, contours, histograms, vector fields (quiver plots), labels, shapes, annotations, ...
 
 Interactive features (i.e. not only programmatic plotting but also with mouse/keyboard):
 
@@ -47,7 +49,7 @@ Interactive features (i.e. not only programmatic plotting but also with mouse/ke
 * Customizable aspect ratio for images
 * Tons of ready-to-use tools: plot canvas export to image file, image snapshot, interval selection, image rectangular filter, etc.
 * Curve fitting tool with automatic fit, manual fit with sliders, ...
-* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, ...
+* Contrast adjustment panel for images: select the LUT by moving a range selection object on the image levels histogram, eliminate outliers, invert colormaps, ...
 * X-axis and Y-axis cross-sections: support for multiple images, average cross-section tool on a rectangular area, ...
 * Apply any affine transform to displayed images in real-time (rotation, magnification, translation, horizontal/vertical flip, ...)
 

{plotpy-2.8.4 → plotpy-2.10.0}/doc/features/items/overview.rst

@@ -41,6 +41,13 @@ The following image items are available:
 * :py:func:`.get_plot_qrect`
 * :py:func:`.get_image_from_plot`
 
+Flow fields
+^^^^^^^^^^^
+
+The following flow field items are available:
+
+* :py:class:`.QuiverItem`: a flow field item with arrows
+
 Grid
 ^^^^
 

{plotpy-2.8.4 → plotpy-2.10.0}/doc/features/items/reference.rst

@@ -71,6 +71,12 @@ Histograms
 .. autoclass:: plotpy.items.Histogram2DItem
     :members:
 
+Flow fields
+^^^^^^^^^^^
+
+.. autoclass:: plotpy.items.QuiverItem
+   :members:
+
 Grid
 ^^^^
 

{plotpy-2.8.4 → plotpy-2.10.0}/doc/release_notes/release_2.07.md

@@ -14,6 +14,9 @@ Other changes:
 
 * Updated `guidata` dependency to V3.10.0
 * Using new `guidata` translation utility based on `babel`
+* Development environment:
+  * Historically, the default Python interpreter for development was handled by the `PPSTACK_PYTHONEXE` environment variable, for example to run VS Code tasks with the correct Python interpreter.
+  * This approach has been replaced by relying on the virtual environment management as provided by VS Code itself, which is more standard and compatible with various tools.
 
 ## PlotPy Version 2.7.4 (2025-04-26) ##
 

plotpy-2.10.0/doc/release_notes/release_2.09.md

@@ -0,0 +1,58 @@
+# Version 2.9 #
+
+## PlotPy Version 2.9.0 ##
+
+💥 New features:
+
+* Added `QuiverItem` for displaying 2D vector fields (quiver plots), similar to
+  Matplotlib's `quiver`. This closes
+  [Issue #54](https://github.com/PlotPyStack/PlotPy/issues/54):
+  * New `QuiverItem` plot item class supporting X, Y, U, V arrays (1D or 2D)
+  * Auto-meshgrid expansion when X, Y are 1D and U, V are 2D
+  * Configurable arrow scale, head size, and color
+  * New `make.quiver()` builder method for easy item creation
+  * New `quiver()` function in the interactive plotting interface (`plotpy.pyplot`)
+  * Integrated with plot autoscale (initial zoom and middle-click reset)
+  * Item icon displayed in the item list widget
+* Added "Invert colormap" checkbox directly in the Colormap Manager dialog. This
+  closes [Issue #53](https://github.com/PlotPyStack/PlotPy/issues/53):
+  * Reflects the current inversion state when the dialog is opened
+  * Allows toggling inversion from the colormap selection widget
+  * Updates the colormap preview in real-time when toggled
+  * Inversion is treated as a display parameter, independent of the colormap
+    definition (toggling does not mark the colormap as having unsaved changes)
+
+🛠️ Bug fixes:
+
+* Fixed marker style parameters being overwritten when updating selected markers:
+  * `MarkerParam.update_param` now correctly reads back the selected or unselected
+    visual state into the matching parameter set, instead of overwriting the base
+    (normal) style with the selected style
+  * This preserves distinct normal and selected appearance for markers
+* Fixed error-bar curve cursor snapping: clicking near an error-bar bound on an
+  `ErrorBarCurveItem` now correctly returns the closest bar end coordinate.
+  Previously a typo (`abs(y - y)` / `abs(x - x)` instead of `abs(y - yi)` /
+  `abs(x - xi)`) made the snap-to-bound branches dead code, so the closest
+  coordinate was always the central curve point regardless of cursor position
+* Fixed image export via `Figure.print_` (`plotpy.pyplot`) leaking the underlying
+  `QPainter`: the painter is now always released, even when an axis fails to
+  render. This avoids "QPainter::begin: A paint device can only be painted by
+  one painter at a time" warnings, GDI/GL resource leaks, and truncated output
+  files on subsequent paints
+* Fixed `vector_projection` raising a division-by-zero warning and returning NaN
+  coordinates when the two reference points A and B coincided. The function now
+  detects the degenerate zero-length AB vector and returns point B
+* Fixed `scale_data_to_dtype` (`plotpy.io`) producing NaN values when the input
+  array was constant (`dmax == dmin`). The function now returns a finite
+  constant array set to the target dtype's minimum value instead of dividing by
+  zero
+* Fixed `get_nan_min` / `get_nan_max` (`plotpy.mathutils.arrayfuncs`) raising
+  `ValueError` on empty arrays and emitting `RuntimeWarning` on all-NaN inputs.
+  Both helpers now return NaN for empty or fully-NaN arrays without warnings
+
+🔧 Other changes:
+
+* CI: gate PyPI deployment on test suite passing
+* Development environment: improved `scripts/run_with_env.py` to support multiple
+  Python environment contexts (WinPython, venv, etc.) with legacy support for the
+  `WINPYDIRBASE` environment variable

plotpy-2.10.0/doc/release_notes/release_2.10.md

@@ -0,0 +1,34 @@
+# Version 2.10 #
+
+## PlotPy Version 2.10.0 ##
+
+✨ New features:
+
+* **Per-axis autoscale strategy**: Added configurable autoscale behavior for each axis via the axis parameters dialog. Three strategies are available: *Auto* (default — compute bounds from items), *Fixed range* (apply user-defined Min/Max values) and *Disabled* (leave the axis untouched on autoscale). New API: `BasePlot.set_axis_autoscale_strategy()` / `BasePlot.get_axis_autoscale_strategy()` (closes [Issue #63](https://github.com/PlotPyStack/PlotPy/issues/63), partial)
+* **Symbol border width**: Added an `edgewidth` parameter to `SymbolParam` for customizable marker border thickness — previously the border was always 1 pixel wide
+
+🛠️ Bug fixes:
+
+* **Rectangular snapshot tool** — Fixed the "Original size" computation (closes [Issue #57](https://github.com/PlotPyStack/PlotPy/issues/57)):
+  * The preview no longer displays negative dimensions when the X or Y axis is
+    reversed
+  * The "Original size" is now computed from pixel coordinates instead of axis
+    units, so it is correct for `XYImageItem` (and any item with non-uniform
+    axis scaling) regardless of axis orientation
+  * The `ValueError` raised by the resize dialog when the selection produced
+    negative dimensions on a reversed axis is gone
+  * Selecting a region larger than the plotted image now reports the same
+    native pixel resolution for both `ImageItem` and `XYImageItem`
+    (previously `XYImageItem` reported ``shape - 1`` while `ImageItem`
+    reported the full oversized resolution): exporting at "Original size"
+    now consistently preserves the source pixel density and avoids
+    upsampling, regardless of the item type
+* **Snapshot tool cursor** — Fixed the mouse cursor remaining stuck as a cross (`+`) outside the plot canvas (axes, toolbar) after using the snapshot tool. The modal dialogs are now opened after Qt has released the implicit pointer grab, so the cursor is correctly restored (closes [Issue #58](https://github.com/PlotPyStack/PlotPy/issues/58))
+* **Z-axis log tool** — Fixed the `ZAxisLogTool` being always disabled for non-`ImageItem` image types (`XYImageItem`, `MaskedImageItem`, `MaskedXYImageItem`, `TrImageItem`, `RGBImageItem`). The Z-axis log API (`get_zaxis_log_state` / `set_zaxis_log_state`) was moved from `ImageItem` up to `BaseImageItem` so all image item types support it. This notably fixes the tool being permanently greyed out in DataLab's image panel (closes [Issue #59](https://github.com/PlotPyStack/PlotPy/issues/59))
+* **Z-axis log data update** — Fixed image data not being recomputed when calling `set_data()` while Z-axis log scale is active — the log-transformed data is now refreshed and the LUT range preserved in log mode
+* **`YRangeCursorTool`** — Fixed incorrect inequality display and negative ∆y when the Y-range cursors are inverted (dragging the top cursor below the bottom one). Values are now sorted and ∆y is always positive (closes [Issue #55](https://github.com/PlotPyStack/PlotPy/issues/55))
+* **`CurveStatsTool`** — Replaced `min`/`max`/`mean`/`std`/`sum` with their NaN-safe equivalents (`nanmin`, `nanmax`, `nanmean`, `nanstd`, `nansum`) so that signal statistics are computed correctly when the data contains NaN values
+
+⚙️ Dependencies:
+
+* Bumped minimum PythonQwt version from 0.15 to **0.16** to benefit from the Qt6 performance optimizations (closes [Issue #22](https://github.com/PlotPyStack/PlotPy/issues/22) — see [PythonQwt#93](https://github.com/PlotPyStack/PythonQwt/issues/93) for the full optimization log)

{plotpy-2.8.4 → plotpy-2.10.0}/doc/requirements.rst

@@ -11,10 +11,10 @@ The `PlotPy` package requires the following Python modules:
       - >=3.9, <4
       - Python programming language
     * - guidata
-      - >= 3.13
+      - >= 3.14.1
       - Automatic GUI generation for easy dataset editing and display
     * - PythonQwt
-      - >= 0.15
+      - >= 0.16
       - Qt plotting widgets for Python
     * - numpy
       - >= 1.22
@@ -75,6 +75,12 @@ Optional modules for development:
     * - pre-commit
       - 
       - A framework for managing and maintaining multi-language pre-commit hooks.
+    * - setuptools
+      - 
+      - Most extensible Python build backend with support for C/C++ extension modules
+    * - wheel
+      - 
+      - Command line tool for manipulating wheel files
 
 Optional modules for building the documentation:
 

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/__init__.py

@@ -20,7 +20,7 @@ External resources:
 .. _GitHub: https://github.com/PierreRaybaut/plotpy
 """
 
-__version__ = "2.8.4"
+__version__ = "2.10.0"
 __VERSION__ = tuple([int(number) for number in __version__.split(".")])
 
 # --- Important note: DATAPATH and LOCALEPATH are used by guidata.configtools

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/builder/curvemarker.py

@@ -6,11 +6,11 @@
 # pylint: disable=C0103
 
 """
-Curve/cursor/marker Item builder
---------------------------------
+Curve/cursor/marker/... Item builder
+------------------------------------
 
 This module provides a set of factory functions to simplify the creation of
-curve, cursor and marker items.
+curve, cursor, marker, histogram and flow field items.
 """
 
 # Note: when adding method to builder classes, please do not forget to update the
@@ -32,6 +32,7 @@ from plotpy.items import (
     ErrorBarCurveItem,
     HistogramItem,
     Marker,
+    QuiverItem,
     XRangeSelection,
     YRangeSelection,
 )
@@ -1023,3 +1024,70 @@ class CurveMarkerCursorBuilder:
             marker.set_movable(False)
             marker.set_resizable(False)
         return marker
+
+    def quiver(
+        self,
+        x: numpy.ndarray,
+        y: numpy.ndarray,
+        u: numpy.ndarray,
+        v: numpy.ndarray,
+        title: str = "",
+        color: str | None = None,
+        arrow_scale: float = 30.0,
+        arrow_head_size: float = 6.0,
+        headwidth: float = 0.7,
+        xaxis: str = "bottom",
+        yaxis: str = "left",
+    ) -> QuiverItem:
+        """Make a quiver (vector field) `plot item`
+
+        Displays arrows at grid positions (x, y) with direction and magnitude
+        defined by (u, v) components, similar to Matplotlib's ``quiver``.
+
+        Args:
+            x: 1D or 2D array of arrow X positions
+            y: 1D or 2D array of arrow Y positions
+            u: 1D or 2D array of arrow X components
+            v: 1D or 2D array of arrow Y components
+            title: plot item title. Default is ''
+            color: arrow color name. Default is None (black)
+            arrow_scale: scale factor for arrow length in pixels.
+             Default is 30.0. Larger values produce longer arrows.
+            arrow_head_size: size of arrow heads in pixels.
+             Default is 6.0
+            headwidth: arrow head width as multiple of head size.
+             Default is 0.7
+            xaxis: x axis name. Default is 'bottom'
+            yaxis: y axis name. Default is 'left'
+
+        Returns:
+            :py:class:`.QuiverItem` object
+
+        Example::
+
+            import numpy as np
+            x = np.linspace(-2, 2, 10)
+            y = np.linspace(-2, 2, 10)
+            X, Y = np.meshgrid(x, y)
+            U, V = -Y, X  # Rotational field
+            quiver(X, Y, U, V, title="Rotation", color="blue")
+        """
+        if color is None:
+            color = "black"
+        item = QuiverItem(
+            x,
+            y,
+            u,
+            v,
+            color=color,
+            arrow_scale=arrow_scale,
+            arrow_head_size=arrow_head_size,
+            headwidth=headwidth,
+        )
+        if title:
+            item.setTitle(title)
+        else:
+            item.setTitle(_("Vector field"))
+        item.setXAxis(BasePlot.AXIS_NAMES[xaxis])
+        item.setYAxis(BasePlot.AXIS_NAMES[yaxis])
+        return item

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/io.py

@@ -64,6 +64,12 @@ def scale_data_to_dtype(data: np.ndarray, dtype: np.dtype) -> np.ndarray:
     info = np.iinfo(dtype)
     dmin = data.min()
     dmax = data.max()
+    if dmax == dmin:
+        # Constant data: avoid 0/0 division (which would yield NaN). Map every
+        # sample to the dtype range minimum so downstream image rendering keeps
+        # working instead of seeing NaNs.
+        data = np.full_like(data, float(info.min))
+        return np.array(data, dtype)
     data -= dmin
     data = data * float(info.max - info.min) / (dmax - dmin)
     data = data + float(info.min)
@@ -594,6 +600,7 @@ register_serializable_items(
     "plotpy.items",
     [
         "CurveItem",
+        "QuiverItem",
         "PolygonMapItem",
         "ErrorBarCurveItem",
         "RawImageItem",

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/items/__init__.py

@@ -33,6 +33,7 @@ from .image import (
     XYImageFilterItem,
     XYImageItem,
     assemble_imageitems,
+    compute_image_items_original_size,
     compute_trimageitems_original_size,
     get_image_from_plot,
     get_image_from_qrect,
@@ -55,6 +56,7 @@ from .label import (
     SelectedLegendBoxItem,
 )
 from .polygonmap import PolygonMapItem
+from .quiver import QuiverItem
 from .shape import (
     AbstractShape,
     Axes,

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/items/curve/errorbar.py

@@ -221,13 +221,13 @@ class ErrorBarCurveItem(CurveItem):
         xi = self.dsamp(self._x)[i]
         yi = self.dsamp(self._y)[i]
         xmin, xmax, ymin, ymax = self.get_minmax_arrays()
-        if abs(y - y) > abs(y - ymin[i]):
+        if abs(y - yi) > abs(y - ymin[i]):
             yi = ymin[i]
-        elif abs(y - y) > abs(y - ymax[i]):
+        elif abs(y - yi) > abs(y - ymax[i]):
             yi = ymax[i]
-        if abs(x - x) > abs(x - xmin[i]):
+        if abs(x - xi) > abs(x - xmin[i]):
             xi = xmin[i]
-        elif abs(x - x) > abs(x - xmax[i]):
+        elif abs(x - xi) > abs(x - xmax[i]):
             xi = xmax[i]
         return xi, yi
 

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/items/image/__init__.py

@@ -11,6 +11,7 @@ from .misc import (
     Histogram2DItem,
     QuadGridItem,
     assemble_imageitems,
+    compute_image_items_original_size,
     compute_trimageitems_original_size,
     get_image_from_plot,
     get_image_from_qrect,

{plotpy-2.8.4 → plotpy-2.10.0}/plotpy/items/image/base.py

@@ -132,6 +132,12 @@ class BaseImageItem(QwtPlotItem):
         self._filename = None  # The file this image comes from
 
         self.histogram_cache = None
+
+        # Z-axis logarithmic scale support
+        self._log_data: np.ndarray | None = None
+        self._lin_lut_range: tuple[float, float] | None = None
+        self._is_zaxis_log = False
+
         if data is not None:
             self.set_data(data)
         self.param.update_item(self)
@@ -334,6 +340,15 @@ class BaseImageItem(QwtPlotItem):
         """
         return self.get_x_values(i0, i1)
 
+    def _recompute_log_data(self) -> None:
+        """Refresh the cached log10 data from the current ``self.data``.
+
+        Used both when toggling the Z-axis log scale on and when the underlying
+        data is replaced (e.g. via :meth:`set_data`) while the log scale is
+        already active.
+        """
+        self._log_data = np.array(np.log10(self.data.clip(1)), dtype=np.float64)
+
     def set_data(
         self, data: np.ndarray, lut_range: tuple[float, float] | None = None
     ) -> None:
@@ -347,9 +362,15 @@ class BaseImageItem(QwtPlotItem):
         self.histogram_cache = None
         self.update_bounds()
         self.update_border()
+        # Refresh the cached log10 data when log scale is active, otherwise the
+        # display would keep using the previous (now stale) log data.
+        if self.get_zaxis_log_state():
+            self._recompute_log_data()
         if not self.param.keep_lut_range:
             if lut_range is not None:
                 _min, _max = lut_range
+            elif self.get_zaxis_log_state():
+                _min, _max = get_nan_range(self._log_data)
             else:
                 _min, _max = get_nan_range(data)
             self.set_lut_range((_min, _max))
@@ -552,6 +573,34 @@ class BaseImageItem(QwtPlotItem):
         """
         return get_nan_range(self.data)
 
+    # ---- Z-axis logarithmic scale --------------------------------------------
+    def get_zaxis_log_state(self) -> bool:
+        """Return True if Z-axis is in logarithmic scale"""
+        return self._is_zaxis_log
+
+    def set_zaxis_log_state(self, state: bool) -> None:
+        """Set Z-axis logarithmic scale state
+
+        Args:
+            state: True to enable logarithmic scale, False otherwise
+        """
+        self._is_zaxis_log = state
+        plot = self.plot()
+        if state:
+            self._lin_lut_range = self.get_lut_range()
+            if self._log_data is None:
+                self._recompute_log_data()
+            self.set_lut_range(get_nan_range(self._log_data))
+            dtype = self._log_data.dtype
+        else:
+            self._log_data = None
+            self.set_lut_range(self._lin_lut_range)
+            dtype = self.data.dtype
+        if self.interpolate[0] == INTERP_AA:
+            self.interpolate = (INTERP_AA, self.interpolate[1].astype(dtype))
+        if plot is not None:
+            plot.update_colormap_axis(self)
+
     def get_lut_range_max(self) -> tuple[float, float]:
         """Get maximum range for this dataset