cf-xarray 0.9.0__tar.gz → 0.9.1__tar.gz

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/.github/workflows/ci.yaml

@@ -50,7 +50,7 @@ jobs:
         run: |
           pytest -n auto --cov=./ --cov-report=xml
       - name: Upload code coverage to Codecov
-        uses: codecov/codecov-action@v4.0.0
+        uses: codecov/codecov-action@v4.3.0
         with:
           file: ./coverage.xml
           flags: unittests
@@ -114,7 +114,7 @@ jobs:
         run: |
           python -m mypy --install-types --non-interactive --cobertura-xml-report mypy_report cf_xarray/
       - name: Upload mypy coverage to Codecov
-        uses: codecov/codecov-action@v4.0.0
+        uses: codecov/codecov-action@v4.3.0
         with:
           file: mypy_report/cobertura.xml
           flags: mypy

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/.github/workflows/pypi.yaml

@@ -72,7 +72,7 @@ jobs:
 
       - name: Publish package to TestPyPI
         if: github.event_name == 'push'
-        uses: pypa/gh-action-pypi-publish@v1.8.11
+        uses: pypa/gh-action-pypi-publish@v1.8.12
         with:
           password: ${{ secrets.TESTPYPI_TOKEN }}
           repository_url: https://test.pypi.org/legacy/
@@ -96,6 +96,6 @@ jobs:
           name: releases
           path: dist
       - name: Publish package to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.8.11
+        uses: pypa/gh-action-pypi-publish@v1.8.12
         with:
           verbose: true

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/.github/workflows/upstream-dev-ci.yaml

@@ -22,7 +22,7 @@ jobs:
   upstream-dev:
     name: upstream-dev
     runs-on: ubuntu-latest
-    if: ${{ (contains( github.event.pull_request.labels.*.name, 'test-upstream') && github.event_name == 'pull_request') || github.event_name == 'workflow_dispatch' }}
+    if: ${{ (contains( github.event.pull_request.labels.*.name, 'test-upstream') && github.event_name == 'pull_request') || github.event_name == 'workflow_dispatch' || github.event_name == 'schedule' }}
     defaults:
       run:
         shell: bash -l {0}

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cf_xarray
-Version: 0.9.0
+Version: 0.9.1
 Summary: A convenience wrapper for using CF attributes on xarray objects
 License:                                  Apache License
                                    Version 2.0, January 2004

cf_xarray-0.9.1/cf_xarray/_version.py

@@ -0,0 +1 @@
+__version__ = "0.9.1"

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/cf_xarray/geometry.py

@@ -94,9 +94,10 @@ def shapely_to_cf(geometries: xr.DataArray | Sequence, grid_mapping: str | None
         A dataset with shapely geometry objects translated into CF-compliant variables :
          - 'x', 'y' : the node coordinates
          - 'crd_x', 'crd_y' : the feature coordinates (might have different names if `grid_mapping` is available).
-         - 'node_count' : The number of nodes per feature. Absent if all instances are Points.
+         - 'node_count' : The number of nodes per feature. Always present for Lines and Polygons. For Points: only present if there are multipart geometries.
+         - 'part_node_count' : The number of nodes per individual geometry. Only for Lines with multipart geometries and for Polygons with multipart geometries or holes.
+         - 'interior_ring' : Integer boolean indicating whether rings are interior or exterior. Only for Polygons with holes.
          - 'geometry_container' : Empty variable with attributes describing the geometry type.
-         - Other variables are not implemented as only Points are currently understood.
 
     References
     ----------

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/cf_xarray/helpers.py

@@ -48,7 +48,7 @@ def _guess_bounds_2d(da, dims):
     # At this point, we might have different corners for adjacent cells, we average them together to have a nice grid
     # To make this vectorized and keep the edges, we'll pad with NaNs and ignore them in the averages
     daXYp = (
-        daXY.pad({d: (1, 1) for d in dims}, mode="constant", constant_values=np.NaN)
+        daXY.pad({d: (1, 1) for d in dims}, mode="constant", constant_values=np.nan)
         .transpose(*dims, "Xbnds", "Ybnds")
         .values
     )  # Tranpose for an easier notation

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/cf_xarray.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cf_xarray
-Version: 0.9.0
+Version: 0.9.1
 Summary: A convenience wrapper for using CF attributes on xarray objects
 License:                                  Apache License
                                    Version 2.0, January 2004

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/ci/doc.yml

@@ -19,6 +19,7 @@ dependencies:
   - pooch
   - pint
   - regex
+  - shapely
   - furo
   - myst-nb
   - pip:

cf_xarray-0.9.1/doc/geometry.md

@@ -0,0 +1,99 @@
+---
+jupytext:
+  text_representation:
+    format_name: myst
+kernelspec:
+  display_name: Python 3
+  name: python3
+---
+
+```{eval-rst}
+.. currentmodule:: xarray
+```
+
+# Geometries
+
+```{seealso}
+1. [The CF conventions on Geometries](http://cfconventions.org/Data/cf-conventions/cf-conventions-1.11/cf-conventions.html#geometries)
+1. {py:func}`cf_xarray.shapely_to_cf`
+1. {py:func}`cf_xarray.cf_to_shapely`
+```
+
+`cf_xarray` can convert between vector geometries represented as shapely objects
+and CF-compliant array representations of those geometries.
+
+Let's start by creating an xarray object containing some shapely geometries. This example uses
+a `xr.DataArray` but these functions also work with a `xr.Dataset` where one of the data variables
+contains an array of shapes.
+
+```{code-cell}
+import cf_xarray as cfxr
+import xarray as xr
+
+from shapely.geometry import MultiPoint, Point
+
+da = xr.DataArray(
+    [
+        MultiPoint([(1.0, 2.0), (2.0, 3.0)]),
+        Point(3.0, 4.0),
+        Point(4.0, 5.0),
+        Point(3.0, 4.0),
+    ],
+    dims=("index",),
+    name="geometry"
+)
+```
+
+```{warning}
+`cf_xarray` does not support handle multiple types of shapes (Point, Line, Polygon) in one
+`xr.DataArray`, but multipart geometries are supported and can be mixed with single-part
+geometries of the same type.
+```
+
+Now we can take that `xr.DataArray` containing shapely geometries and convert it to cf:
+
+```{code-cell}
+ds_cf = cfxr.shapely_to_cf(da)
+ds_cf
+```
+
+This function returns a `xr.Dataset` containing the CF fields needed to reconstruct the
+geometries. In particular there are:
+
+- `'x'`, `'y'` : the node coordinates
+- `'crd_x'`, `'crd_y'` : the feature coordinates (might have different names if `grid_mapping` is available).
+- `'node_count'` : The number of nodes per feature. Always present for Lines and Polygons. For
+  Points: only present if there are multipart geometries.
+- `'part_node_count'` : The number of nodes per individual geometry. Only for Lines with multipart
+  geometries and for Polygons with multipart geometries or holes.
+- `'interior_ring'` : Integer boolean indicating whether ring is interior or exterior. Only for
+  Polygons with holes.
+- `'geometry_container`' : Empty variable with attributes describing the geometry type.
+
+Here are the attributes on `geometry_container`. This pattern mimics the convention of
+specifying spatial reference information in the attrs of the empty array `spatial_ref`.
+
+```{code-cell}
+ds_cf.geometry_container.attrs
+```
+
+```{note}
+Z axis is not yet supported for any shapes.
+```
+
+This `xr.Dataset` can be converted back into a `xr.DataArray` of shapely geometries:
+
+```{code-cell}
+cfxr.cf_to_shapely(ds_cf)
+```
+
+This conversion adds coordinates that aren't in the `xr.DataArray` that we started with.
+By default these are called `crd_x` and `crd_y` unless `grid_mapping` is specified.
+
+## Gotchas
+
+For MultiPolygons with holes the CF notation is slightly ambiguous on which hole is associated
+with which polygon. This is problematic because shapely stores holes within the polygon
+object that they are associated with. `cf_xarray` assumes that the the shapes are interleaved
+such that the holes (interior rings) are associated with the exteriors (exterior rings) that
+immediately precede them.

{cf_xarray-0.9.0 → cf_xarray-0.9.1}/pyproject.toml

@@ -64,6 +64,8 @@ exclude = [
     ".eggs",
     "doc",
 ]
+
+[tool.ruff.lint]
 # E402: module level import not at top of file
 # E501: line too long - let ruff worry about that
 ignore = [
@@ -72,7 +74,6 @@ ignore = [
     "B018",
     "B015",
 ]
-[tool.ruff.lint]
 select = [
     # Pyflakes
     "F",

cf_xarray-0.9.0/cf_xarray/_version.py

@@ -1 +0,0 @@
-__version__ = "0.9.0"

cf_xarray-0.9.0/doc/geometry.md

@@ -1,7 +0,0 @@
-```{eval-rst}
-.. currentmodule:: xarray
-```
-
-# Geometries
-
-See {py:func}`cf_xarray.shapely_to_cf`,  {py:func}`cf_xarray.cf_to_shapely`