plopp 25.7.1__tar.gz → 25.9.0__tar.gz

{plopp-25.7.1 → plopp-25.9.0}/.copier-answers.yml

@@ -1,9 +1,9 @@
 # Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
-_commit: 3561fcd
+_commit: c3214e6
 _src_path: https://github.com/scipp/copier_template.git
 description: Visualization library for Scipp
 max_python: '3.13'
-min_python: '3.10'
+min_python: '3.11'
 namespace_package: ''
 nightly_deps: scipp
 orgname: scipp

plopp-25.9.0/.github/workflows/python-version-ci

@@ -0,0 +1 @@
+3.11

{plopp-25.7.1 → plopp-25.9.0}/.github/workflows/release.yml

@@ -33,7 +33,7 @@ jobs:
 
   upload_pypi:
     name: Deploy PyPI
-    needs: build_wheels
+    needs: [build_wheels]
     runs-on: 'ubuntu-24.04'
     environment: release
     permissions:
@@ -44,7 +44,7 @@ jobs:
       - uses: pypa/gh-action-pypi-publish@v1.12.4
 
   docs:
-    needs: upload_pypi
+    needs: [upload_pypi]
     uses: ./.github/workflows/docs.yml
     with:
       publish: ${{ github.event_name == 'release' && github.event.action == 'published' }}

{plopp-25.7.1 → plopp-25.9.0}/.pre-commit-config.yaml

@@ -10,7 +10,6 @@ repos:
       - id: check-merge-conflict
       - id: check-toml
       - id: check-yaml
-        exclude: conda/meta.yaml
       - id: detect-private-key
       - id: trailing-whitespace
         args: [ --markdown-linebreak-ext=md ]

plopp-25.9.0/.python-version

@@ -0,0 +1 @@
+3.11

{plopp-25.7.1 → plopp-25.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plopp
-Version: 25.7.1
+Version: 25.9.0
 Summary: Visualization library for Scipp
 Author: Scipp contributors
 License-Expression: BSD-3-Clause
@@ -12,13 +12,12 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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: Topic :: Scientific/Engineering
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lazy-loader>=0.4
@@ -41,7 +40,7 @@ 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>=10.0.0; extra == "test"
+Requires-Dist: pyarrow>=13.0.0; extra == "test"
 Requires-Dist: pytest>=7.0; extra == "test"
 Requires-Dist: pythreejs>=2.4.1; extra == "test"
 Requires-Dist: scipp>=25.5.0; extra == "test"

plopp-25.9.0/docs/customization/animations.ipynb

@@ -0,0 +1,241 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "0",
+   "metadata": {},
+   "source": [
+    "# Animations\n",
+    "\n",
+    "To create animations with Plopp, we make use of the [node mechanism](custom-interfaces.ipynb)\n",
+    "and leverage [Matplotlib's support for animations](https://matplotlib.org/stable/users/explain/animations/animations.html).\n",
+    "\n",
+    "## 1D animations"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import plopp as pp\n",
+    "from plopp.data.examples import three_bands\n",
+    "import matplotlib.animation as animation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2",
+   "metadata": {},
+   "source": [
+    "We load the data and display it in a figure:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "da = three_bands()\n",
+    "da.plot(norm=\"log\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4",
+   "metadata": {},
+   "source": [
+    "We now create an animation where we are scanning the vertical `y` direction of the data,\n",
+    "making a plot of each slice in each step of the animation.\n",
+    "\n",
+    "On every call to the `update` function passed to Matplotlib's `FuncAnimation`,\n",
+    "we update the index node and notify the children nodes of the change.\n",
+    "This updates the figure at every step.\n",
+    "\n",
+    "Finally, we save the animation to a `.gif` file.\n",
+    "See [here](https://matplotlib.org/stable/users/explain/animations/animations.html#saving-animations)\n",
+    "for the possible formats animations can be saved in."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "data_node = pp.Node(da)\n",
+    "index_node = pp.Node(0)\n",
+    "# Here, 'y' is the dimension you want to slice\n",
+    "slice_node = pp.Node(lambda da, ind: da[\"y\", ind], da=data_node, ind=index_node)\n",
+    "\n",
+    "f = pp.linefigure(slice_node, vmin=-1, vmax=200)\n",
+    "\n",
+    "\n",
+    "def update(frame):\n",
+    "    index_node.func = lambda: frame\n",
+    "    index_node.notify_children(\"\")\n",
+    "\n",
+    "\n",
+    "ani = animation.FuncAnimation(fig=f.fig, func=update, frames=200, interval=100)\n",
+    "ani.save(filename=\"animation_1d.gif\", writer=\"pillow\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6",
+   "metadata": {},
+   "source": [
+    "### Displaying the animation in the notebook\n",
+    "\n",
+    "There are (at least) three different ways to display the animation directly in the notebook.\n",
+    "\n",
+    "#### Markdown\n",
+    "\n",
+    "The first is to create a markdown cell and just display the image (note that refreshing browser window may be required in some cases):\n",
+    "\n",
+    "```\n",
+    "![ani](animation_1d.gif)\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7",
+   "metadata": {},
+   "source": [
+    "![ani](animation_1d.gif)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8",
+   "metadata": {},
+   "source": [
+    "#### Display the interactive figure\n",
+    "\n",
+    "The second method is to simply display the figure `f` define above,\n",
+    "but **this only works if `%matplotlib widget` is enabled** (and does not work in the rendered docs, hence not shown here).\n",
+    "The advantage of this method is that it does not require first saving the animation to disk.\n",
+    "\n",
+    "#### Ipywidgets\n",
+    "\n",
+    "The third method is to use `ipywidgets` to display the image in the file:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import ipywidgets as ipw\n",
+    "\n",
+    "ipw.Image(value=open(\"animation_1d.gif\", \"rb\").read(), format=\"gif\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "10",
+   "metadata": {},
+   "source": [
+    "## 2D animations\n",
+    "\n",
+    "We can create a similar animation on 2d images,\n",
+    "where instead of slicing the vertical dimension,\n",
+    "we collect more and more signal as time progresses.\n",
+    "\n",
+    "Every time the `update` function is called,\n",
+    "new data is created and added to the current data."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "11",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "da = three_bands(npeaks=20, per_peak=500, spread=30.0)\n",
+    "data_node = pp.Node(da)\n",
+    "\n",
+    "f = pp.imagefigure(data_node, cbar=True, vmin=30, vmax=400, norm=\"log\")\n",
+    "\n",
+    "\n",
+    "def update(frame):\n",
+    "    # Make new data and add it to the current data.\n",
+    "    # The current data is obtained by calling the `data_node()`\n",
+    "    new = three_bands(npeaks=20, per_peak=500, spread=30.0) + data_node()\n",
+    "    data_node.func = lambda: new\n",
+    "    data_node.notify_children(\"\")\n",
+    "\n",
+    "\n",
+    "ani = animation.FuncAnimation(fig=f.fig, func=update, frames=80, interval=100)\n",
+    "ani.save(filename=\"animation_2d.gif\", writer=\"pillow\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "12",
+   "metadata": {},
+   "source": [
+    "We now display the resulting animation (using markdown):\n",
+    "\n",
+    "![ani2](animation_2d.gif)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "13",
+   "metadata": {},
+   "source": [
+    "## 3D animations\n",
+    "\n",
+    "Animations on 3D plots are currently not supported.\n",
+    "\n",
+    "The best way to achieve this would be to record a screencast while interacting with a 3D scene."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "14",
+   "metadata": {
+    "nbsphinx": "hidden"
+   },
+   "outputs": [],
+   "source": [
+    "# This cell is used to generate the thumbnail for the docs.\n",
+    "# It is hidden from the online documentation.\n",
+    "import shutil\n",
+    "\n",
+    "shutil.copyfile(\"animation_2d.gif\", \"../_static/customization/animation_2d.gif\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

{plopp-25.7.1 → plopp-25.9.0}/docs/customization/index.md

@@ -30,6 +30,12 @@
 
 :::
 
+::::{grid-item-card} Animations
+:link: animations.ipynb
+:img-bottom: ../_static/customization/animation_2d.gif
+
+:::
+
 ::::
 
 ```{toctree}
@@ -41,4 +47,5 @@ subplots
 tweaking-figures
 custom-interfaces
 graph-node-tips
+animations
 ```

{plopp-25.7.1 → plopp-25.9.0}/docs/developer/getting-started.md

@@ -40,7 +40,7 @@ Alternatively, if you want a different workflow, take a look at ``tox.ini`` or `
 Run the tests using
 
 ```sh
-tox -e py310
+tox -e py311
 ```
 
 (or just `tox` if you want to run all environments).

{plopp-25.7.1 → plopp-25.9.0}/docs/index.md

@@ -154,6 +154,10 @@
 
 :::
 
+:::{grid-item-card} Animations
+:link: customization/animations.ipynb
+:img-bottom: _static/customization/animation_2d.gif
+
 ::::
 
 ```{toctree}

{plopp-25.7.1 → plopp-25.9.0}/pyproject.toml

@@ -18,14 +18,13 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering",
     "Typing :: Typed",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 
 # IMPORTANT:
 # Run 'tox -e deps' after making changes here. This will update requirement files.
@@ -49,7 +48,7 @@ test = [
     "pandas>=2.2.2",
     "plotly>=5.15.0",
     "pooch>=1.5",
-    "pyarrow>=10.0.0",
+    "pyarrow>=13.0.0",
     "pytest>=7.0",
     "pythreejs>=2.4.1",
     "scipp>=25.5.0",

{plopp-25.7.1 → plopp-25.9.0}/requirements/base.txt

@@ -5,19 +5,19 @@
 #
 #    requirements upgrade
 #
-contourpy==1.3.2
+contourpy==1.3.3
     # via matplotlib
 cycler==0.12.1
     # via matplotlib
-fonttools==4.58.5
+fonttools==4.59.0
     # via matplotlib
 kiwisolver==1.4.8
     # via matplotlib
 lazy-loader==0.4
     # via -r base.in
-matplotlib==3.10.3
+matplotlib==3.10.5
     # via -r base.in
-numpy==2.2.6
+numpy==2.3.2
     # via
     #   contourpy
     #   matplotlib
@@ -32,7 +32,7 @@ pyparsing==3.2.3
     # via matplotlib
 python-dateutil==2.9.0.post0
     # via matplotlib
-scipp==25.5.1
+scipp==25.8.0
     # via -r base.in
 six==1.17.0
     # via python-dateutil

{plopp-25.7.1 → plopp-25.9.0}/requirements/basetest.in

@@ -15,7 +15,7 @@ mpltoolbox>=24.6.0
 pandas>=2.2.2
 plotly>=5.15.0
 pooch>=1.5
-pyarrow>=10.0.0
+pyarrow>=13.0.0
 pytest>=7.0
 pythreejs>=2.4.1
 scipp>=25.5.0

{plopp-25.7.1 → plopp-25.9.0}/requirements/basetest.txt

@@ -1,4 +1,4 @@
-# SHA1:dd4af2e04ad5b26b2644cddc71f19afa74319a65
+# SHA1:9304fdc650b0b353b34a5f31e5b8071be9d3f4e8
 #
 # This file was generated by pip-compile-multi.
 # To update, run:
@@ -9,25 +9,21 @@ anywidget==0.9.18
     # via -r basetest.in
 asttokens==3.0.0
     # via stack-data
-certifi==2025.7.14
+certifi==2025.8.3
     # via requests
 charset-normalizer==3.4.2
     # via requests
-comm==0.2.2
+comm==0.2.3
     # via ipywidgets
-contourpy==1.3.2
+contourpy==1.3.3
     # via matplotlib
 cycler==0.12.1
     # via matplotlib
 decorator==5.2.1
     # via ipython
-exceptiongroup==1.3.0
-    # via
-    #   ipython
-    #   pytest
 executing==2.2.0
     # via stack-data
-fonttools==4.58.5
+fonttools==4.59.0
     # via matplotlib
 graphviz==0.21
     # via -r basetest.in
@@ -41,10 +37,12 @@ ipydatawidgets==4.3.5
     # via pythreejs
 ipympl==0.9.7
     # via -r basetest.in
-ipython==8.37.0
+ipython==9.4.0
     # via
     #   ipympl
     #   ipywidgets
+ipython-pygments-lexers==1.1.1
+    # via ipython
 ipywidgets==8.1.7
     # via
     #   -r basetest.in
@@ -58,7 +56,7 @@ jupyterlab-widgets==3.0.15
     # via ipywidgets
 kiwisolver==1.4.8
     # via matplotlib
-matplotlib==3.10.3
+matplotlib==3.10.5
     # via
     #   ipympl
     #   mpltoolbox
@@ -66,9 +64,9 @@ matplotlib-inline==0.1.7
     # via ipython
 mpltoolbox==25.5.0
     # via -r basetest.in
-narwhals==1.47.0
+narwhals==2.0.1
     # via plotly
-numpy==2.2.6
+numpy==2.3.2
     # via
     #   contourpy
     #   h5py
@@ -115,11 +113,12 @@ ptyprocess==0.7.0
     # via pexpect
 pure-eval==0.2.3
     # via stack-data
-pyarrow==20.0.0
+pyarrow==21.0.0
     # via -r basetest.in
 pygments==2.19.2
     # via
     #   ipython
+    #   ipython-pygments-lexers
     #   pytest
 pyparsing==3.2.3
     # via matplotlib
@@ -135,19 +134,16 @@ pytz==2025.2
     # via pandas
 requests==2.32.4
     # via pooch
-scipp==25.5.1
+scipp==25.8.0
     # via -r basetest.in
-scipy==1.15.3
+scipy==1.16.1
     # via -r basetest.in
 six==1.17.0
     # via python-dateutil
 stack-data==0.6.3
     # via ipython
-tomli==2.2.1
-    # via pytest
 traitlets==5.14.3
     # via
-    #   comm
     #   ipympl
     #   ipython
     #   ipywidgets
@@ -159,7 +155,6 @@ traittypes==0.2.1
 typing-extensions==4.14.1
     # via
     #   anywidget
-    #   exceptiongroup
     #   ipython
 tzdata==2025.2
     # via pandas
@@ -169,5 +164,5 @@ wcwidth==0.2.13
     # via prompt-toolkit
 widgetsnbextension==4.0.14
     # via ipywidgets
-xarray==2025.6.1
+xarray==2025.7.1
     # via -r basetest.in

{plopp-25.7.1 → plopp-25.9.0}/requirements/ci.txt

@@ -7,7 +7,7 @@
 #
 cachetools==6.1.0
     # via tox
-certifi==2025.7.14
+certifi==2025.8.3
     # via requests
 chardet==5.2.0
     # via tox
@@ -15,7 +15,7 @@ charset-normalizer==3.4.2
     # via requests
 colorama==0.4.6
     # via tox
-distlib==0.3.9
+distlib==0.4.0
     # via virtualenv
 filelock==3.18.0
     # via
@@ -23,7 +23,7 @@ filelock==3.18.0
     #   virtualenv
 gitdb==4.0.12
     # via gitpython
-gitpython==3.1.44
+gitpython==3.1.45
     # via -r ci.in
 idna==3.10
     # via requests
@@ -44,15 +44,9 @@ requests==2.32.4
     # via -r ci.in
 smmap==5.0.2
     # via gitdb
-tomli==2.2.1
-    # via
-    #   pyproject-api
-    #   tox
-tox==4.27.0
+tox==4.28.4
     # via -r ci.in
-typing-extensions==4.14.1
-    # via tox
 urllib3==2.5.0
     # via requests
-virtualenv==20.31.2
+virtualenv==20.33.1
     # via tox

{plopp-25.7.1 → plopp-25.9.0}/requirements/dev.txt

@@ -12,13 +12,13 @@
 -r static.txt
 -r test.txt
 -r wheels.txt
-anyio==4.9.0
+anyio==4.10.0
     # via
     #   httpx
     #   jupyter-server
 argon2-cffi==25.1.0
     # via jupyter-server
-argon2-cffi-bindings==21.2.0
+argon2-cffi-bindings==25.1.0
     # via argon2-cffi
 arrow==1.3.0
     # via isoduration
@@ -30,7 +30,7 @@ click==8.2.1
     # via
     #   pip-compile-multi
     #   pip-tools
-copier==9.8.0
+copier==9.9.0
     # via -r dev.in
 dunamai==1.25.0
     # via copier
@@ -52,14 +52,14 @@ json5==0.12.0
     # via jupyterlab-server
 jsonpointer==3.0.0
     # via jsonschema
-jsonschema[format-nongpl]==4.24.0
+jsonschema[format-nongpl]==4.25.0
     # via
     #   jupyter-events
     #   jupyterlab-server
     #   nbformat
 jupyter-events==0.12.0
     # via jupyter-server
-jupyter-lsp==2.2.5
+jupyter-lsp==2.2.6
     # via jupyterlab
 jupyter-server==2.16.0
     # via
@@ -69,17 +69,19 @@ jupyter-server==2.16.0
     #   notebook-shim
 jupyter-server-terminals==0.5.3
     # via jupyter-server
-jupyterlab==4.4.4
+jupyterlab==4.4.5
     # via -r dev.in
 jupyterlab-server==2.27.3
     # via jupyterlab
+lark==1.2.2
+    # via rfc3987-syntax
 notebook-shim==0.2.4
     # via jupyterlab
 overrides==7.7.0
     # via jupyter-server
 pip-compile-multi==3.2.1
     # via -r dev.in
-pip-tools==7.4.1
+pip-tools==7.5.0
     # via pip-compile-multi
 plumbum==1.9.0
     # via copier
@@ -99,6 +101,8 @@ rfc3986-validator==0.1.1
     # via
     #   jsonschema
     #   jupyter-events
+rfc3987-syntax==1.1.0
+    # via jsonschema
 send2trash==1.8.3
     # via jupyter-server
 sniffio==1.3.1

{plopp-25.7.1 → plopp-25.9.0}/requirements/docs.in

@@ -1,5 +1,6 @@
 -r base.in
 -r basetest.in
+autodoc-pydantic
 gitpython
 autodoc-pydantic
 ipykernel