ncplot 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

ncplot/plot.py

@@ -28,7 +28,7 @@ import copy
 import numpy as np
 import os
 
-from ncplot.utils import get_dims, check_lon, check_lat
+from ncplot.utils import get_dims, check_lon, check_lat, normalise_lon
 
 hv.extension("bokeh")
 hv.Store.renderers
@@ -579,6 +579,10 @@ def view(x, vars=None, autoscale=True, out=None, **kwargs):
         if "lon" not in lon_name:
             coastline = False
 
+    # coastlines are drawn on a -180-180 map, so longitudes must follow that convention
+    if coastline:
+        ds = normalise_lon(ds, lon_name)
+
     ff_dims = list(ds.coords)
 
     possible_others = [x for x in ff_dims if x not in df_dims.columns]

ncplot/utils.py

@@ -1,5 +1,6 @@
 import subprocess
 
+import numpy as np
 import xarray as xr
 import pandas as pd
 import logging
@@ -9,6 +10,31 @@ metpy_log = logging.getLogger("metpy")
 metpy_log.setLevel(logging.CRITICAL)
 
 
+def normalise_lon(ds, lon_name):
+    """
+    Convert longitudes running 0-360 to -180-180 (sorted), as coastlines are drawn on a -180-180 map.
+    The dataset is returned unchanged if the longitudes cannot be converted to a contiguous axis,
+    e.g. a regional subset that straddles 180 degrees.
+    """
+    if lon_name is None or lon_name not in ds.dims:
+        return ds
+
+    lons = ds[lon_name].values
+    if lons.ndim != 1 or len(lons) < 2 or not lons.max() > 180:
+        return ds
+
+    attrs = ds[lon_name].attrs
+    new_ds = ds.assign_coords({lon_name: ((ds[lon_name] + 180) % 360) - 180})
+    new_ds = new_ds.sortby(lon_name)
+    new_ds[lon_name].attrs = attrs
+
+    steps = np.diff(new_ds[lon_name].values.astype("float64"))
+    if len(steps) > 0 and steps.max() > 1.5 * np.median(steps):
+        return ds
+
+    return new_ds
+
+
 def check_lon(x, ds):
     """
     A function to change the lon coord identified in case it cannot be represented by hvplot

{ncplot-0.4.0.dist-info → ncplot-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ncplot
-Version: 0.4.0
+Version: 0.4.2
 Summary: Interactive viewing of NetCDF data
 Home-page: https://github.com/pmlmodelling/ncplot
 Author: Robert Wilson
@@ -46,15 +46,21 @@ Dynamic: requires-python
 Dynamic: summary
 
 
+<p align="center">
+  <img src="docs-site/assets/img/ncplot_wordmark.svg" alt="NCPlot" width="380">
+</p>
 
-# ncplot - Easy interactive viewing of NetCDF files in Python 
-
-
+> [!TIP]
+> 📖 **New here?** The NCPlot website — installing, a quickstart, the API reference, and more — lives at **[plymouthmarinelaboratory.github.io/ncplot](https://plymouthmarinelaboratory.github.io/ncplot/)**.
 
 [![pypi](https://img.shields.io/pypi/v/ncplot.svg)](https://pypi.python.org/pypi/ncplot/)
 [![Documentation Status](https://readthedocs.org/projects/ncplot/badge/?version=latest)](https://ncplot.readthedocs.io/en/latest/?badge=latest)
 
 
+# NCPlot
+
+Easy interactive viewing of NetCDF files in Python.
+
 An easy to use Python (3.6 and above) package for quickly plotting the contents of NetCDF files or xarray datasets in Python or on the command line. 
 
 This package is designed to work with [CF](https://cfconventions.org/) compliant NetCDF data.
@@ -144,7 +150,7 @@ ncplot example.nc
 
 # Reference and tutorials
 
-A full API reference, and a how-to guide are available at [readthedocs](https://ncplot.readthedocs.io/en/latest/).
+A full API reference, and a how-to guide are available at the [NCPlot website](https://plymouthmarinelaboratory.github.io/ncplot/) and on [readthedocs](https://ncplot.readthedocs.io/en/latest/).
 
 
 

ncplot-0.4.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+ncplot/__init__.py,sha256=Y7JgOH_AwvTpuvmX3rnp0LBeIaEjEZkXxCEQjSpq2mc,29
+ncplot/command_line.py,sha256=L4JRPyYv9clgU35H9xSmyp3A4AAiC8Zm0W1ciTYv06A,835
+ncplot/deprecated.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ncplot/plot.py,sha256=NHQzJ-jKt5nF1JDeMfZ_Jz9rt5jbuqNnH8uGteMXQvU,40052
+ncplot/utils.py,sha256=pvFahoxeuc26DtdEIp28MkyvDik8NR0aSqdHbBupQr8,6005
+ncplot/xarray.py,sha256=F-kGEufuE8ZvIdWsNpuLGjhn4Tn6aM1UNUWvHIaiOvA,535
+ncplot-0.4.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ncplot-0.4.2.dist-info/METADATA,sha256=mjSRD4vxjKR6Ch9VBVAapHaBIaozSGX1KgjbA3Bk2mY,3603
+ncplot-0.4.2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+ncplot-0.4.2.dist-info/entry_points.txt,sha256=8CIFyTPZn49GsrojImqnJpkYIbxxZHAP_rHqA-256Eo,52
+ncplot-0.4.2.dist-info/top_level.txt,sha256=hCfsI7KZNMRpk8FI5lwz_PFTyzJl91Iy2TSPAGEu9WI,7
+ncplot-0.4.2.dist-info/RECORD,,

{ncplot-0.4.0.dist-info → ncplot-0.4.2.dist-info}/WHEEL

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

ncplot-0.4.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-ncplot/__init__.py,sha256=Y7JgOH_AwvTpuvmX3rnp0LBeIaEjEZkXxCEQjSpq2mc,29
-ncplot/command_line.py,sha256=L4JRPyYv9clgU35H9xSmyp3A4AAiC8Zm0W1ciTYv06A,835
-ncplot/deprecated.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ncplot/plot.py,sha256=YZDkANCJss7azv2wbx6RPpCtp9GgFTSCjf7B0w96FJ0,39889
-ncplot/utils.py,sha256=iR-4_KqovkqhSYRlGMUZBykwUG3W2cXxs5GTayghF3c,5149
-ncplot/xarray.py,sha256=F-kGEufuE8ZvIdWsNpuLGjhn4Tn6aM1UNUWvHIaiOvA,535
-ncplot-0.4.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ncplot-0.4.0.dist-info/METADATA,sha256=qaJ1oRSWhwkULxKELz8RD9333CN4wufEdmwvYJCjqZQ,3200
-ncplot-0.4.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-ncplot-0.4.0.dist-info/entry_points.txt,sha256=8CIFyTPZn49GsrojImqnJpkYIbxxZHAP_rHqA-256Eo,52
-ncplot-0.4.0.dist-info/top_level.txt,sha256=hCfsI7KZNMRpk8FI5lwz_PFTyzJl91Iy2TSPAGEu9WI,7
-ncplot-0.4.0.dist-info/RECORD,,