plopp 25.11.0__tar.gz → 26.2.0__tar.gz

{plopp-25.11.0 → plopp-26.2.0}/.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
-_commit: c3214e6
+_commit: b87e087
 _src_path: https://github.com/scipp/copier_template.git
 description: Visualization library for Scipp
 max_python: '3.13'

{plopp-25.11.0 → plopp-26.2.0}/.github/workflows/docs.yml

@@ -71,7 +71,7 @@ jobs:
           path: html/
       - run: echo "::notice::https://remote-unzip.deno.dev/${{ github.repository }}/artifacts/${{ steps.artifact-upload-step.outputs.artifact-id }}"
 
-      - uses: JamesIves/github-pages-deploy-action@v4.7.3
+      - uses: JamesIves/github-pages-deploy-action@v4.8.0
         if: ${{ inputs.publish }}
         with:
           branch: gh-pages

{plopp-25.11.0 → plopp-26.2.0}/.github/workflows/nightly_at_main_lower_bound.yml

@@ -31,7 +31,7 @@ jobs:
         ESS_PROTECTED_FILESTORE_PASSWORD: ${{ secrets.ESS_PROTECTED_FILESTORE_PASSWORD }}
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python.version }}
       - run: uv run --extra=test --resolution=lowest-direct pytest

{plopp-25.11.0 → plopp-26.2.0}/.gitignore

@@ -51,3 +51,4 @@ docs/generated/
 *.zip
 *.sqw
 *.nxspe
+*.mtz

{plopp-25.11.0 → plopp-26.2.0}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -15,14 +15,14 @@ repos:
         args: [ --markdown-linebreak-ext=md ]
         exclude: '\.svg'
   - repo: https://github.com/kynan/nbstripout
-    rev: 0.7.1
+    rev: 0.8.2
     hooks:
       - id: nbstripout
         types: [ "jupyter" ]
         args: [ "--drop-empty-cells",
                 "--extra-keys 'metadata.language_info.version cell.metadata.jp-MarkdownHeadingCollapsed cell.metadata.pycharm'" ]
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.0
+    rev: v0.14.6
     hooks:
       - id: ruff
         args: [ --fix ]
@@ -30,7 +30,7 @@ repos:
       - id: ruff-format
         types_or: [ python, pyi ]
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         additional_dependencies:
@@ -48,7 +48,7 @@ repos:
       - id: rst-inline-touching-normal
       - id: text-unicode-replacement-char
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.3
+    rev: v1.7.9
     hooks:
       - id: actionlint
         # Disable because of false-positive SC2046

{plopp-25.11.0/src/plopp.egg-info → plopp-26.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plopp
-Version: 25.11.0
+Version: 26.2.0
 Summary: Visualization library for Scipp
 Author: Scipp contributors
 License-Expression: BSD-3-Clause
@@ -36,13 +36,13 @@ Requires-Dist: graphviz>=0.20.3; extra == "test"
 Requires-Dist: h5py>=3.12; extra == "test"
 Requires-Dist: ipympl>=0.8.4; extra == "test"
 Requires-Dist: ipywidgets>=8.1.0; extra == "test"
-Requires-Dist: ipykernel<7; extra == "test"
+Requires-Dist: ipykernel<7,>=6.26; extra == "test"
 Requires-Dist: mpltoolbox>=24.6.0; extra == "test"
 Requires-Dist: pandas>=2.2.2; extra == "test"
 Requires-Dist: plotly>=5.15.0; extra == "test"
 Requires-Dist: pooch>=1.5; extra == "test"
 Requires-Dist: pyarrow>=13.0.0; extra == "test"
-Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest>=8.0; extra == "test"
 Requires-Dist: pythreejs>=2.4.1; extra == "test"
 Requires-Dist: scipp>=25.5.0; extra == "test"
 Requires-Dist: scipy>=1.10.0; extra == "test"

{plopp-25.11.0 → plopp-26.2.0}/docs/api-reference/index.md

@@ -79,7 +79,8 @@
    widgets.drawing.PointsTool
 
    widgets.clip3d.Clip3dTool
-   widgets.clip3d.ClippingPlanes
+   widgets.clip3d.ClipValueTool
+   widgets.clip3d.ClippingManager
 ```
 
 ## Backends

{plopp-25.11.0 → plopp-26.2.0}/docs/conf.py

@@ -251,7 +251,8 @@ linkcheck_ignore = [
     r'https?://github\.com/.*?/blob/[a-f0-9]+/.+?#',
     # Linkcheck seems to be denied access by some DOI resolvers.
     # Since DOIs are supposed to be permanent, we don't need to check them.'
-    r'https://doi\.org/',
+    r'https?://doi\.org/',
+    r'https?://dx\.doi\.org/',
 ]
 
 # -- Options for nbsphinx gallery------------------------------------------

{plopp-25.11.0 → plopp-26.2.0}/docs/getting-started/numpy-pandas-xarray.ipynb

@@ -223,8 +223,7 @@
    "id": "16",
    "metadata": {},
    "source": [
-    "Or the `inspector` plot that allows you to pick points on the 2d map and display a time cut in a second plot below using the the inspector tool\n",
-    "<img src='https://upload.wikimedia.org/wikipedia/commons/thumb/1/15/Font_Awesome_5_solid_crosshairs.svg/32px-Font_Awesome_5_solid_crosshairs.svg.png' width=\"20\"/>:"
+    "Or the `inspector` plot that allows you to pick points on the 2d map and display a time cut in a second plot below using the the inspector tool <img src='../_static/crosshairs.png' width=\"20\"/>:"
    ]
   },
   {

{plopp-25.11.0 → plopp-26.2.0}/docs/plotting/inspector-plot.ipynb

@@ -10,9 +10,7 @@
     "The `inspector` plot takes in a three-dimensional input and applies a reduction operation (`sum` by default) along one of the dimensions specified by `dim`.\n",
     "It displays the result as a two-dimensional image.\n",
     "\n",
-    "In addition, the inspector tool\n",
-    "<img src='https://upload.wikimedia.org/wikipedia/commons/thumb/1/15/Font_Awesome_5_solid_crosshairs.svg/32px-Font_Awesome_5_solid_crosshairs.svg.png' width=\"20\"/>\n",
-    "in the toolbar allows to add markers on the image,\n",
+    "In addition, the inspector tool <img src='../_static/crosshairs.png' width=\"20\"/> in the toolbar allows to add markers on the image,\n",
     "which generate one-dimensional slices (retaining only `dim`) that are displayed in a second figure.\n",
     "\n",
     "The points can be dragged/moved, as well as deleted (via a middle click).\n",

{plopp-25.11.0 → plopp-26.2.0}/pyproject.toml

@@ -44,13 +44,13 @@ test = [
     "h5py>=3.12",
     "ipympl>=0.8.4",
     "ipywidgets>=8.1.0",
-    "ipykernel<7",  # Concurrency bug, see https://github.com/scipp/plopp/issues/499.
+    "ipykernel>=6.26,<7",  # Concurrency bug, see https://github.com/scipp/plopp/issues/499.
     "mpltoolbox>=24.6.0",
     "pandas>=2.2.2",
     "plotly>=5.15.0",
     "pooch>=1.5",
     "pyarrow>=13.0.0",
-    "pytest>=7.0",
+    "pytest>=8.0",
     "pythreejs>=2.4.1",
     "scipp>=25.5.0",
     "scipy>=1.10.0",
@@ -86,6 +86,11 @@ filterwarnings = [
   'ignore:Parsing dates involving a day of month without a year:DeprecationWarning',
   # Should be removed once we lower pin a matplotlib version that respects the deprecation
   'ignore:.*parameter is deprecated and will be removed in Pillow 13.*:DeprecationWarning',
+  # Warnings related to pyparsing deprecations: this is fixed in mpl==3.10.8 onwards
+  "ignore:'parseString' deprecated:DeprecationWarning",
+  "ignore:'resetCache' deprecated:DeprecationWarning",
+  "ignore:'enablePackrat' deprecated:DeprecationWarning",
+  "ignore:'parseAll' argument is deprecated:DeprecationWarning",
 ]
 
 [tool.ruff]

{plopp-25.11.0 → plopp-26.2.0}/requirements/base.txt

@@ -32,7 +32,7 @@ pyparsing==3.2.5
     # via matplotlib
 python-dateutil==2.9.0.post0
     # via matplotlib
-scipp==25.11.0
+scipp==26.1.1
     # via -r base.in
 six==1.17.0
     # via python-dateutil

{plopp-25.11.0 → plopp-26.2.0}/requirements/basetest.txt

@@ -161,7 +161,7 @@ pyzmq==27.1.0
     #   jupyter-client
 requests==2.32.5
     # via pooch
-scipp==25.11.0
+scipp==26.1.1
     # via -r basetest.in
 scipy==1.16.3
     # via -r basetest.in

{plopp-25.11.0 → plopp-26.2.0}/requirements/nightly.txt

@@ -168,7 +168,7 @@ pyzmq==27.1.0
     #   jupyter-client
 requests==2.32.5
     # via pooch
-scipp==100.0.0.dev0
+scipp==26.1.1
     # via -r nightly.in
 scipy==1.16.3
     # via -r nightly.in

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/__init__.py

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: BSD-3-Clause
 # Copyright (c) 2025 Scipp contributors (https://github.com/scipp)
-# ruff: noqa: E402, F401, I
+# ruff: noqa: RUF100, E402, F401, I
 
 import importlib.metadata
 

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/backends/matplotlib/canvas.py

@@ -112,7 +112,7 @@ class Canvas:
         grid: bool = False,
         user_vmin: sc.Variable | float | None = None,
         user_vmax: sc.Variable | float | None = None,
-        aspect: Literal['auto', 'equal', None] = None,
+        aspect: Literal['auto', 'equal'] | None = None,
         cbar: bool = False,
         legend: bool | tuple[float, float] = True,
         xmin: sc.Variable | float | None = None,
@@ -123,7 +123,7 @@ class Canvas:
         logy: bool = False,
         xlabel: str | None = None,
         ylabel: str | None = None,
-        norm: Literal['linear', 'log', None] = None,
+        norm: Literal['linear', 'log'] | None = None,
         **ignored,
     ):
         # Note on the `**ignored`` keyword arguments: the figure which owns the canvas
@@ -515,7 +515,7 @@ class Canvas:
         """
         self.fig.canvas.toolbar.pan()
 
-    def panzoom(self, value: Literal['pan', 'zoom', None]):
+    def panzoom(self, value: Literal['pan', 'zoom'] | None):
         """
         Activate or deactivate the pan or zoom tool, depending on the input value.
         """

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/backends/plotly/canvas.py

@@ -46,7 +46,7 @@ class Canvas:
         logy: bool | None = None,
         xlabel: str | None = None,
         ylabel: str | None = None,
-        norm: Literal['linear', 'log', None] = None,
+        norm: Literal['linear', 'log'] | None = None,
         **ignored,
     ):
         # Note on the `**ignored`` keyword arguments: the figure which owns the canvas
@@ -326,7 +326,7 @@ class Canvas:
         """
         self.fig.update_layout(dragmode='pan')
 
-    def panzoom(self, value: Literal['pan', 'zoom', None]):
+    def panzoom(self, value: Literal['pan', 'zoom'] | None):
         """
         Activate or deactivate the pan or zoom tool, depending on the input value.
         """

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/graphics/colormapper.py

@@ -55,7 +55,12 @@ def _get_cmap(colormap: str | Colormap, nan_color: str | None = None) -> Colorma
         else:
             cmap = mpl.cm.get_cmap(colormap)
     except (KeyError, ValueError):
+        # Case where we have just a single color
         cmap = LinearSegmentedColormap.from_list('tmp', [colormap, colormap])
+        cmap.set_over(colormap)
+        cmap.set_under(colormap)
+        cmap.set_bad(colormap)
+        return cmap
 
     # Add under and over values to the cmap
     delta = 0.15
@@ -141,7 +146,7 @@ class ColorMapper:
         clabel: str | None = None,
         nan_color: str | None = None,
         figsize: tuple[float, float] | None = None,
-        norm: Literal['linear', 'log', None] = None,
+        norm: Literal['linear', 'log'] | None = None,
         vmin: sc.Variable | float | None = None,
         vmax: sc.Variable | float | None = None,
     ):
@@ -152,9 +157,14 @@ class ColorMapper:
         self._canvas = canvas
         self.cax = self._canvas.cax if hasattr(self._canvas, 'cax') else None
         self.cmap = _get_cmap(cmap, nan_color=nan_color)
-        self.mask_cmap = _get_cmap(
-            mask_cmap if mask_color is None else mask_color, nan_color=nan_color
-        )
+        self.mask_cmap = _get_cmap(mask_cmap if mask_color is None else mask_color)
+        if mask_color is None:
+            # If no single color was used for masks, it means a colormap was used
+            # instead. However, `nan_color` was not passed to get_cmap for the masks
+            # (it only applied to non-masked data), so we still need to set the 'bad'
+            # color here. We choose to set it to the 'over' color for a lack of a
+            # better idea.
+            self.mask_cmap.set_bad(self.mask_cmap.get_over())
 
         # Inside the autoscale, we need to distinguish between a min value that was set
         # by the user and one that was found by looping over all the data.

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/graphics/graphicalview.py

@@ -51,11 +51,11 @@ class GraphicalView(View):
         mask_cmap: str = 'gray',
         mask_color: str | None = None,
         cbar: bool = False,
-        norm: Literal['linear', 'log', None] = None,
+        norm: Literal['linear', 'log'] | None = None,
         vmin: sc.Variable | float | None = None,
         vmax: sc.Variable | float | None = None,
         scale: dict[str, str] | None = None,
-        aspect: Literal['auto', 'equal', None] = None,
+        aspect: Literal['auto', 'equal'] | None = None,
         grid: bool = False,
         title: str | None = None,
         figsize: tuple[float, float] | None = None,
@@ -312,5 +312,6 @@ class GraphicalView(View):
         self.artists[key].remove()
         del self.artists[key]
         self.canvas.update_legend()
-        self.fit_to_data()
-        self.canvas.draw()
+        if self._autoscale:
+            self.fit_to_data()
+            self.canvas.draw()

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/plotting/common.py

@@ -319,7 +319,7 @@ def input_to_nodes(obj: PlottableMulti, processor: Callable) -> list[Node]:
         to_nodes = obj.items()
     else:
         to_nodes = [(getattr(obj, "name", None), obj)]
-    nodes = [Node(processor, inp, name=name) for name, inp in to_nodes]
+    nodes = [Node(processor, inp, name=str(name)) for name, inp in to_nodes]
     for node in nodes:
         if hasattr(processor, 'func'):
             node.pretty_name = processor.func.__name__
@@ -347,7 +347,7 @@ def raise_multiple_inputs_for_2d_plot_error(origin):
 
 
 def categorize_args(
-    aspect: Literal['auto', 'equal', None] = None,
+    aspect: Literal['auto', 'equal'] | None = None,
     autoscale: bool = True,
     cbar: bool = True,
     clabel: str | None = None,
@@ -364,7 +364,7 @@ def categorize_args(
     mask_cmap: str = 'gray',
     mask_color: str = 'black',
     nan_color: str | None = None,
-    norm: Literal['linear', 'log', None] = None,
+    norm: Literal['linear', 'log'] | None = None,
     scale: dict[str, str] | None = None,
     title: str | None = None,
     vmax: sc.Variable | float | None = None,

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/plotting/inspector.py

@@ -3,6 +3,7 @@
 
 from typing import Literal
 
+import numpy as np
 import scipp as sc
 
 from ..core import Node
@@ -34,11 +35,40 @@ def _slice_xy(da: sc.DataArray, xy: dict[str, dict[str, int]]) -> sc.DataArray:
     return da[y['dim'], y['value']][x['dim'], x['value']]
 
 
+def _coord_to_centers(da: sc.DataArray, dim: str) -> sc.Variable:
+    coord = da.coords[dim]
+    if da.coords.is_edges(dim, dim=dim):
+        return sc.midpoints(coord, dim=dim)
+    return coord
+
+
+def _mask_outside_polygon(
+    da: sc.DataArray, poly: dict[str, dict[str, sc.Variable]]
+) -> sc.DataArray:
+    from matplotlib.path import Path
+
+    xdim = poly['x']['dim']
+    ydim = poly['y']['dim']
+    x = _coord_to_centers(da, xdim)
+    y = _coord_to_centers(da, ydim)
+    vx = poly['x']['value'].to(unit=x.unit).values
+    vy = poly['y']['value'].to(unit=y.unit).values
+    verts = np.column_stack([vx, vy])
+    path = Path(verts)
+    xx = sc.broadcast(x, sizes={**x.sizes, **y.sizes})
+    yy = sc.broadcast(y, sizes={**x.sizes, **y.sizes})
+    points = np.column_stack([xx.values.ravel(), yy.values.ravel()])
+    inside = sc.array(
+        dims=yy.dims, values=path.contains_points(points).reshape(yy.shape)
+    )
+    return da.assign_masks(__inside_polygon=~inside).sum({*x.dims, *y.dims})
+
+
 def inspector(
     obj: Plottable,
     dim: str | None = None,
     *,
-    aspect: Literal['auto', 'equal', None] = None,
+    aspect: Literal['auto', 'equal'] | None = None,
     autoscale: bool = True,
     cbar: bool = True,
     clabel: str | None = None,
@@ -49,17 +79,19 @@ def inspector(
     grid: bool = False,
     legend: bool | tuple[float, float] = True,
     logc: bool | None = None,
-    logy: bool | None = None,
     mask_cmap: str = 'gray',
     mask_color: str = 'black',
+    mode: Literal['point', 'polygon'] = 'point',
     nan_color: str | None = None,
-    norm: Literal['linear', 'log', None] = None,
+    norm: Literal['linear', 'log'] | None = None,
     operation: Literal['sum', 'mean', 'min', 'max'] = 'sum',
     orientation: Literal['horizontal', 'vertical'] = 'horizontal',
     title: str | None = None,
     vmax: sc.Variable | float | None = None,
     vmin: sc.Variable | float | None = None,
     xlabel: str | None = None,
+    xmax: sc.Variable | float | None = None,
+    xmin: sc.Variable | float | None = None,
     ylabel: str | None = None,
     ymax: sc.Variable | float | None = None,
     ymin: sc.Variable | float | None = None,
@@ -69,16 +101,29 @@ def inspector(
     Inspector takes in a three-dimensional input and applies a reduction operation
     (``'sum'`` by default) along one of the dimensions specified by ``dim``.
     It displays the result as a two-dimensional image.
-    In addition, an 'inspection' tool is available in the toolbar which allows to place
-    markers on the image which perform slicing at that position to retain only the third
-    dimension and displays the resulting one-dimensional slice on the right hand side
-    figure.
-
-    Controls:
-    - Click to make new point
-    - Drag existing point to move it
+    In addition, an 'inspection' tool is available in the toolbar. In ``mode='point'``
+    it allows placing point markers on the image to slice at that position, retaining
+    only the third dimension and displaying the resulting one-dimensional slice in the
+    right-hand side figure. In ``mode='polygon'`` it allows drawing a polygon to compute
+    the total intensity inside the polygon as a function of the third dimension.
+
+    Controls (point mode):
+    - Left-click to make new points
+    - Left-click and hold on point to move point
     - Middle-click to delete point
 
+    Controls (polygon mode):
+    - Left-click to make new polygons
+    - Left-click and hold on polygon vertex to move vertex
+    - Right-click and hold to drag/move the entire polygon
+    - Middle-click to delete polygon
+
+    Notes
+    -----
+
+    Almost all the arguments for plot customization apply to the two-dimensional image
+    (unless specified).
+
     Parameters
     ----------
     obj:
@@ -93,13 +138,13 @@ def inspector(
     autoscale:
         Automatically scale the axes/colormap on updates if ``True``.
     cbar:
-        Show colorbar if ``True`` (2d figure).
+        Show colorbar if ``True``.
     clabel:
-        Label for colorscale (2d figure).
+        Label for colorscale.
     cmax:
-        Upper limit for colorscale (2d figure).
+        Upper limit for colorscale.
     cmin:
-        Lower limit for colorscale (2d figure).
+        Lower limit for colorscale.
     errorbars:
         Show errorbars if ``True`` (1d figure).
     figsize:
@@ -111,18 +156,18 @@ def inspector(
         ``(x, y)`` coordinates of the legend's anchor point in axes coordinates
         (1d figure).
     logc:
-        If ``True``, use logarithmic scale for colorscale (2d figure).
-    logy:
-        If ``True``, use logarithmic scale for y-axis (1d figure).
+        If ``True``, use logarithmic scale for colorscale.
     mask_cmap:
-        Colormap to use for masks in 2d figure.
+        Colormap to use for masks.
     mask_color:
         Color of masks (overrides ``mask_cmap``).
+    mode:
+        Select ``'point'`` for point inspection or ``'polygon'`` for polygon selection
+        with total intensity inside the polygon plotted as a function of ``dim``.
     nan_color:
-        Color to use for NaN values in 2d figure.
+        Color to use for NaN values.
     norm:
-        Set to ``'log'`` for a logarithmic y-axis (1d figure) or logarithmic colorscale
-        (2d figure). Legacy, prefer ``logy`` and ``logc`` instead.
+        Set to ``'log'`` for a logarithmic colorscale. Legacy, prefer ``logc`` instead.
     operation:
         The operation to apply along the third (undisplayed) dimension specified by
         ``dim``.
@@ -132,15 +177,19 @@ def inspector(
     title:
         The figure title.
     vmax:
-        Upper limit for data to be displayed (y-axis for 1d figure, colorscale for
-        2d figure). Legacy, prefer ``ymax`` and ``cmax`` instead.
+        Upper limit for data colorscale to be displayed.
+        Legacy, prefer ``cmax`` instead.
     vmin:
-        Lower limit for data to be displayed (y-axis for 1d figure, colorscale for
-        2d figure). Legacy, prefer ``ymin`` and ``cmin`` instead.
+        Lower limit for data colorscale to be displayed.
+        Legacy, prefer ``cmin`` instead.
     xlabel:
-        Label for x-axis (2d figure).
+        Label for x-axis.
+    xmax:
+        Upper limit for x-axis (1d figure)
+    xmin:
+        Lower limit for x-axis (1d figure)
     ylabel:
-        Label for y-axis (2d figure).
+        Label for y-axis.
     ymax:
         Upper limit for y-axis (1d figure).
     ymin:
@@ -159,11 +208,9 @@ def inspector(
         errorbars=errorbars,
         grid=grid,
         legend=legend,
-        logy=logy,
         mask_color=mask_color,
-        norm=norm,
-        vmax=vmax,
-        vmin=vmin,
+        xmax=xmax,
+        xmin=xmin,
         ymax=ymax,
         ymin=ymin,
     )
@@ -190,6 +237,7 @@ def inspector(
         figsize=figsize,
         grid=grid,
         logc=logc,
+        mask_cmap=mask_cmap,
         mask_color=mask_color,
         nan_color=nan_color,
         norm=norm,
@@ -198,21 +246,30 @@ def inspector(
         vmin=vmin,
         xlabel=xlabel,
         ylabel=ylabel,
-        ymax=ymax,
-        ymin=ymin,
         **kwargs,
     )
+    from ..widgets import Box, PointsTool, PolygonTool
 
-    from ..widgets import Box, PointsTool
+    if mode == 'point':
+        tool = PointsTool(
+            figure=f2d,
+            input_node=bin_edges_node,
+            func=_slice_xy,
+            destination=f1d,
+            tooltip="Activate inspector tool",
+        )
+    elif mode == 'polygon':
+        tool = PolygonTool(
+            figure=f2d,
+            input_node=bin_edges_node,
+            func=_mask_outside_polygon,
+            destination=f1d,
+            tooltip="Activate polygon inspector tool",
+        )
+    else:
+        raise ValueError(f'Mode "{mode}" is unknown.')
 
-    pts = PointsTool(
-        figure=f2d,
-        input_node=bin_edges_node,
-        func=_slice_xy,
-        destination=f1d,
-        tooltip="Activate inspector tool",
-    )
-    f2d.toolbar['inspect'] = pts
+    f2d.toolbar['inspect'] = tool
     out = [f2d, f1d]
     if orientation == 'horizontal':
         out = [out]

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/plotting/mesh3d.py

@@ -53,7 +53,7 @@ def mesh3d(
     figsize: tuple[int, int] = (600, 400),
     logc: bool | None = None,
     nan_color: str | None = None,
-    norm: Literal['linear', 'log', None] = None,
+    norm: Literal['linear', 'log'] | None = None,
     title: str | None = None,
     vmax: sc.Variable | float = None,
     vmin: sc.Variable | float = None,

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/plotting/plot.py

@@ -19,7 +19,7 @@ from .common import (
 def plot(
     obj: PlottableMulti,
     *,
-    aspect: Literal['auto', 'equal', None] = None,
+    aspect: Literal['auto', 'equal'] | None = None,
     autoscale: bool = True,
     cbar: bool = True,
     clabel: str | None = None,
@@ -38,7 +38,7 @@ def plot(
     mask_cmap: str = 'gray',
     mask_color: str | None = None,
     nan_color: str | None = None,
-    norm: Literal['linear', 'log', None] = None,
+    norm: Literal['linear', 'log'] | None = None,
     scale: dict[str, str] | None = None,
     title: str | None = None,
     vmax: sc.Variable | float | None = None,

{plopp-25.11.0 → plopp-26.2.0}/src/plopp/plotting/scatter.py

@@ -46,9 +46,9 @@ def scatter(
     x: str = 'x',
     y: str = 'y',
     pos: str | None = None,
-    aspect: Literal['auto', 'equal', None] = None,
+    aspect: Literal['auto', 'equal'] | None = None,
     autoscale: bool = True,
-    cbar: bool = True,
+    cbar: bool = False,
     clabel: str | None = None,
     cmap: str = 'viridis',
     cmax: sc.Variable | float | None = None,
@@ -62,7 +62,7 @@ def scatter(
     logy: bool | None = None,
     mask_color: str = 'black',
     nan_color: str | None = None,
-    norm: Literal['linear', 'log', None] = None,
+    norm: Literal['linear', 'log'] | None = None,
     scale: dict[str, str] | None = None,
     size: str | float | None = None,
     title: str | None = None,