ultraplot 2.3.0__tar.gz → 2.4.0__tar.gz

{ultraplot-2.3.0 → ultraplot-2.4.0}/.github/workflows/build-ultraplot.yml

@@ -49,7 +49,7 @@ jobs:
           nproc
           cat /proc/cpuinfo | grep "model name" | head -1
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -98,7 +98,7 @@ jobs:
           nproc
           cat /proc/cpuinfo | grep "model name" | head -1
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - uses: mamba-org/setup-micromamba@v3.0.0
         with:
@@ -131,7 +131,7 @@ jobs:
       # Cache Baseline Figures (Restore step)
       - name: Cache Baseline Figures
         id: cache-baseline
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         if: ${{ env.IS_PR }}
         with:
           path: ./ultraplot/tests/baseline # The directory to cache

{ultraplot-2.3.0 → ultraplot-2.4.0}/.github/workflows/main.yml

@@ -11,7 +11,7 @@ jobs:
     outputs:
       run: ${{ github.event_name == 'push' && 'true' || steps.filter.outputs.python }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: dorny/paths-filter@v4
         id: filter
         with:
@@ -32,7 +32,7 @@ jobs:
       mode: ${{ steps.select.outputs.mode }}
       tests: ${{ steps.select.outputs.tests }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -41,7 +41,7 @@ jobs:
 
       - name: Restore test map cache
         id: restore-map
-        uses: actions/cache/restore@v5
+        uses: actions/cache/restore@v6
         with:
           path: .ci/test-map.json
           key: test-map-${{ github.event.pull_request.base.sha }}
@@ -122,7 +122,7 @@ jobs:
       matplotlib-versions: ${{ steps.set-versions.outputs.matplotlib-versions }}
       test-matrix: ${{ steps.set-versions.outputs.test-matrix }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -153,7 +153,7 @@ jobs:
         with:
           swap-size-gb: 10
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -182,7 +182,7 @@ jobs:
             ultraplot/tests
 
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@v7
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml

{ultraplot-2.3.0 → ultraplot-2.4.0}/.github/workflows/publish-pypi.yml

@@ -14,7 +14,7 @@ jobs:
     name: Build packages
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -144,7 +144,7 @@ jobs:
   #   env:
   #     ZENODO_ACCESS_TOKEN: ${{ secrets.ZENODO_ACCESS_TOKEN }}
   #   steps:
-  #     - uses: actions/checkout@v6
+  #     - uses: actions/checkout@v7
   #       with:
   #         fetch-depth: 0
   #

{ultraplot-2.3.0 → ultraplot-2.4.0}/.github/workflows/test-map.yml

@@ -19,7 +19,7 @@ jobs:
         with:
           swap-size-gb: 10
 
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -48,14 +48,14 @@ jobs:
           python tools/ci/build_test_map.py --coverage-file .coverage --output .ci/test-map.json --root .
 
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v6
+        uses: codecov/codecov-action@v7
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml
           name: codecov-test-map
 
       - name: Cache test map
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         with:
           path: .ci/test-map.json
           key: test-map-${{ github.sha }}

{ultraplot-2.3.0 → ultraplot-2.4.0}/CITATION.cff

@@ -20,13 +20,13 @@ keywords:
   - wrapper
 references:
   - type: software
-    name: "ProPlot"
+    title: "ProPlot"
     authors:
       - family-names: "Davis"
         given-names: "Luke"
     url: "https://github.com/lukelbd/proplot"
   - type: software
-    name: "Matplotlib"
+    title: "Matplotlib"
     authors:
       - family-names: "Hunter"
         given-names: "John D."

{ultraplot-2.3.0/ultraplot.egg-info → ultraplot-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ultraplot
-Version: 2.3.0
+Version: 2.4.0
 Summary: A succinct matplotlib wrapper for making beautiful, publication-quality graphics.
 Author-email: Casper van Elteren <caspervanelteren@gmail.com>, Luke Davis <lukelbd@gmail.com>
 Maintainer-email: Casper van Elteren <caspervanelteren@gmail.com>, "Matthew R. Becker" <becker.mr@gmail.com>

ultraplot-2.4.0/docs/examples/plot_types/12_taylor_diagram.py

@@ -0,0 +1,72 @@
+"""
+Taylor Diagram
+==============
+
+Taylor diagrams compare model skill with correlation coefficient, standard
+deviation, and centered RMS difference in a single polar-style plot.
+
+Why UltraPlot here?
+-------------------
+UltraPlot exposes Taylor diagrams as a projection, so you can create them with
+``proj="taylor"`` and then use regular axes methods plus convenience methods
+for plotting points from correlation and standard-deviation coordinates.
+
+Key functions: :py:meth:`ultraplot.axes.TaylorAxes.plot_corr`,
+:py:meth:`ultraplot.axes.TaylorAxes.scatter_corr`.
+
+See also
+--------
+* :doc:`Geographic and polar axes </projections>`
+"""
+
+import numpy as np
+
+import ultraplot as uplt
+
+models = ("Control", "Physics A", "Physics B", "Ensemble")
+correlation = np.array([0.73, 0.84, 0.91, 0.96])
+stddev = np.array([0.82, 1.18, 1.05, 0.93])
+colors = ("blue7", "orange7", "green7", "violet7")
+
+fig, ax = uplt.subplots(proj="taylor", refwidth=4.2)
+ax.format(
+    title="Model skill summary",
+    xlabel="Standard deviation",
+    ylabel="",
+    corrlabel="Correlation",
+    rlim=(0, 1.5),
+    rlines=0.25,
+    corrlines=(1, 0.95, 0.9, 0.8, 0.6, 0.4, 0.2, 0),
+)
+
+# Centered RMS-difference contours around the reference point at (corr=1, std=1).
+theta = np.linspace(0, np.pi / 2, 160)
+radius = np.linspace(0, 1.5, 160)
+theta_grid, radius_grid = np.meshgrid(theta, radius)
+rms = np.sqrt(1 + radius_grid**2 - 2 * radius_grid * np.cos(theta_grid))
+contours = ax.contour(
+    theta_grid,
+    radius_grid,
+    rms,
+    levels=(0.25, 0.5, 0.75, 1.0, 1.25),
+    cmap="tokyo",
+    lw=0.9,
+    ls="--",
+)
+ax.clabel(contours, levels=(0.5, 1.0), inline=True, fontsize=8, fmt="%.1f")
+
+ax.plot_corr(1, 1, marker="*", markersize=12, color="red7", label="Reference")
+for name, corr, std, color in zip(models, correlation, stddev, colors):
+    ax.scatter_corr(
+        corr,
+        std,
+        s=75,
+        color=color,
+        edgecolor="white",
+        lw=0.8,
+        zorder=4,
+        label=name,
+    )
+
+ax.legend(loc="b", ncols=3, frame=False)
+fig.show()

{ultraplot-2.3.0 → ultraplot-2.4.0}/docs/projections.py

@@ -108,6 +108,71 @@ axs[2].format(
     rlocator=2,
 )
 
+# %% [raw] raw_mimetype="text/restructuredtext"
+# .. _ug_taylor:
+#
+# Taylor diagrams
+# ---------------
+#
+# To create Taylor diagrams, pass ``proj='taylor'`` to an axes-creation command.
+# Taylor axes are represented with the :class:`~ultraplot.axes.TaylorAxes`
+# subclass and are useful for comparing model output against a reference series:
+# angular gridlines represent correlation coefficients and radial gridlines
+# represent standard deviation. The :meth:`~ultraplot.axes.TaylorAxes.plot_corr`
+# and :meth:`~ultraplot.axes.TaylorAxes.scatter_corr` helpers accept correlation
+# and standard-deviation coordinates directly, while regular polar plotting
+# commands can still be used for annotations like centered RMS-difference
+# contours.
+
+# %%
+import numpy as np
+
+import ultraplot as uplt
+
+labels = ("Model A", "Model B", "Model C", "Model D")
+corr = np.array([0.72, 0.84, 0.91, 0.96])
+std = np.array([0.86, 1.16, 1.04, 0.94])
+colors = ("blue7", "orange7", "green7", "violet7")
+
+fig, ax = uplt.subplots(proj="taylor", refwidth=4.2)
+ax.format(
+    title="Taylor diagram",
+    xlabel="Standard deviation",
+    ylabel="",
+    rlim=(0, 1.5),
+    rlines=0.25,
+    corrlines=(1, 0.95, 0.9, 0.8, 0.6, 0.4, 0.2, 0),
+)
+
+theta = np.linspace(0, np.pi / 2, 121)
+radius = np.linspace(0, 1.5, 121)
+theta_grid, radius_grid = np.meshgrid(theta, radius)
+rms = np.sqrt(1 + radius_grid**2 - 2 * radius_grid * np.cos(theta_grid))
+contours = ax.contour(
+    theta_grid,
+    radius_grid,
+    rms,
+    levels=(0.25, 0.5, 0.75, 1.0, 1.25),
+    cmap="tokyo",
+    lw=0.9,
+    ls="--",
+)
+ax.clabel(contours, levels=(0.5, 1.0), inline=True, fontsize=8, fmt="%.1f")
+
+ax.plot_corr(1, 1, marker="*", markersize=11, color="red7", label="Reference")
+for label, c, s, color in zip(labels, corr, std, colors):
+    ax.scatter_corr(
+        c,
+        s,
+        s=70,
+        color=color,
+        edgecolor="white",
+        lw=0.8,
+        zorder=4,
+        label=label,
+    )
+ax.legend(loc="b", ncols=3, frame=False)
+
 # %% [raw] raw_mimetype="text/restructuredtext"
 # .. _ug_geo:
 #

{ultraplot-2.3.0 → ultraplot-2.4.0}/ultraplot/__init__.py

@@ -26,6 +26,7 @@ if TYPE_CHECKING:
     from .axes import GeoAxes as GeoAxes
     from .axes import PlotAxes as PlotAxes
     from .axes import PolarAxes as PolarAxes
+    from .axes import TaylorAxes as TaylorAxes
     from .axes import ThreeAxes as ThreeAxes
     from .colors import ColormapDatabase as ColormapDatabase
     from .colors import ColorDatabase as ColorDatabase

ultraplot-2.4.0/ultraplot/_version.py

@@ -0,0 +1 @@
+__version__ = '2.4.0'

{ultraplot-2.3.0 → ultraplot-2.4.0}/ultraplot/axes/__init__.py

@@ -17,6 +17,7 @@ from .geo import (
 from .plot import PlotAxes  # noqa: F401
 from .polar import PolarAxes
 from .shared import _SharedAxes  # noqa: F401
+from .taylor import TaylorAxes
 from .three import ThreeAxes  # noqa: F401
 
 # Prevent importing module names and set order of appearance for objects
@@ -25,6 +26,7 @@ __all__ = [
     "PlotAxes",
     "CartesianAxes",
     "PolarAxes",
+    "TaylorAxes",
     "GeoAxes",
     "ThreeAxes",
     "ExternalAxesContainer",
@@ -34,7 +36,14 @@ __all__ = [
 # NOTE: We integrate with cartopy and basemap rather than using matplotlib's
 # native projection system. Therefore axes names are not part of public API.
 _cls_dict = {}  # track valid names
-for _cls in (CartesianAxes, PolarAxes, _CartopyAxes, _BasemapAxes, ThreeAxes):
+for _cls in (
+    CartesianAxes,
+    PolarAxes,
+    TaylorAxes,
+    _CartopyAxes,
+    _BasemapAxes,
+    ThreeAxes,
+):
     for _name in (_cls._name, *_cls._name_aliases):
         with context._state_context(_cls, name="ultraplot_" + _name):
             mproj.register_projection(_cls)

{ultraplot-2.3.0 → ultraplot-2.4.0}/ultraplot/axes/_formatting.py

@@ -6,8 +6,24 @@ Shared metadata for axis formatting keyword routing and persistence.
 import inspect
 
 _AXIS_STYLE_FIELD_TEMPLATES = {
-    "color": ("{axis}color", "color", "{axis}ec", "ec", "{axis}edgecolor", "edgecolor"),
-    "linewidth": ("{axis}linewidth", "linewidth", "{axis}lw", "lw"),
+    "color": (
+        "{axis}color",
+        "color",
+        "{axis}ec",
+        "ec",
+        "{axis}edgecolor",
+        "edgecolor",
+        "axesec",
+        "axesedgecolor",
+    ),
+    "linewidth": (
+        "{axis}linewidth",
+        "linewidth",
+        "{axis}lw",
+        "lw",
+        "axeslw",
+        "axeslinewidth",
+    ),
     "rotation": ("{axis}rotation", "rotation"),
     "spineloc": ("{axis}spineloc", "{axis}loc"),
     "tickloc": ("{axis}tickloc",),