pycontrails 0.56.0__tar.gz → 0.58.0__tar.gz

{pycontrails-0.56.0 → pycontrails-0.58.0}/.github/workflows/release.yaml

@@ -40,13 +40,13 @@ jobs:
 
       # https://cibuildwheel.readthedocs.io/en/stable/options/#testing
       - name: Build wheels
-        uses: pypa/cibuildwheel@v3.1
+        uses: pypa/cibuildwheel@v3.2
         env:
-          CIBW_BUILD: cp310-* cp311-* cp312-* cp313-*
+          CIBW_BUILD: cp311-* cp312-* cp313-* cp314-*
           CIBW_SKIP: '*-win32 *-manylinux_i686 *-musllinux*'
           CIBW_BUILD_VERBOSITY: 3
           CIBW_ARCHS_MACOS: x86_64 arm64
-          CIBW_TEST_SKIP: '*-macosx_arm64'
+          CIBW_TEST_SKIP: '*-macosx_arm64 cp314-*'
           # Completely isolate tests to prevent cibuildwheel from importing the
           # source instead of the wheel. This happens when tests/__init__.py is read.
           CIBW_TEST_EXTRAS: "complete,dev"

{pycontrails-0.56.0 → pycontrails-0.58.0}/.github/workflows/test.yaml

@@ -38,7 +38,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
-        pyversion: ['3.10', '3.11', '3.12', '3.13']
+        pyversion: ['3.11', '3.12', '3.13']
     runs-on: ${{ matrix.os }}
 
     steps:

{pycontrails-0.56.0 → pycontrails-0.58.0}/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.58.0
+
+### Features
+
+- Build wheels for python 3.14. These are not yet tested in the CI (not all dependencies support python 3.14 yet).
+
+### Breaking changes
+
+- Drop support for python 3.10 per [NEP 29](https://numpy.org/neps/nep-0029-deprecation_policy.html).
+- Require scipy >= 1.12 to better support the `PycontrailsRegularGridInterpolator` interface.
+
+### Fixes
+
+- When instantiated with `copy=True`, `MetDataset` and `MetDataArray` now remove duplicate dimension values, preserving only the first occurrence of each. Previously, duplicates were silently retained (such duplicates are not expected with typical gridded weather data). With `copy=False`, a `ValueError` is raised if duplicate dimension values are present.
+- Update `PycontrailsRegularGridInterpolator` for improved compatibility with `scipy.interpolate.RegularGridInterpolator`. All methods now delegate to SciPy’s implementation, except for `method="linear"`, which retains a fast-path optimized in `PycontrailsRegularGridInterpolator`.
+
+## 0.57.0
+
+### Features
+
+- Add new `Himawari` interface for downloading, processing, and visualizing [Himawari-8 and Himawari-9](https://www.jma.go.jp/jma/jma-eng/satellite/introduction.html) imagery. See the [Himawari notebook](https://py.contrails.org/notebooks/Himawari.html) for usage examples.
+
+### Breaking changes
+
+- Deprecate the `channels` parameter in `GOES.__init__` in favor of `bands`, aligning with the new `Himawari` interface. The `channels` parameter is still available as an alias for `bands`, but will be removed in a future release.
+- Deprecate the `goes_bucket` parameter in `GOES.__init__` in favor of `bucket`, aligning with the new `Himawari` interface. The `goes_bucket` parameter is still available as an alias for `bucket`, but will be removed in a future release.
+
+### Internals
+
+- Add a new `pycontrails.datalib.geo_utils` module with tools for working with geostationary satellite imagery. This module currently includes functions previously defined in the `goes` module, but are also applicable to Himawari imagery.
+- Rename `goes.extract_goes_visualization` -> `goes.extract_visualization` for consistency with the new `himawari` module. The old name is still available as an alias.
+- Localize the `cartopy` import to the `extract_visualization` function within the `goes` module. This allows the user to download `GOES` imagery without having `cartopy` installed.
+- Tweak some of the internal logic in `GOES.get` to slightly improve performance and readability, and to avoid loading unnecessary cached data into memory.
+- Replace `boto3` with `s3fs` in the `gfs` module.
+
 ## 0.56.0
 
 ### Features

{pycontrails-0.56.0/pycontrails.egg-info → pycontrails-0.58.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycontrails
-Version: 0.56.0
+Version: 0.58.0
 Summary: Python library for modeling aviation climate impacts
 Author-email: "Contrails.org" <py@contrails.org>
 License-Expression: Apache-2.0
@@ -13,23 +13,23 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-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: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
 Classifier: Topic :: Scientific/Engineering :: GIS
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 Requires-Dist: dask>=2022.3
 Requires-Dist: numpy>=1.22
 Requires-Dist: pandas>=2.0
-Requires-Dist: scipy>=1.10
+Requires-Dist: scipy>=1.12
 Requires-Dist: typing-extensions>=4.5; python_version < "3.12"
 Requires-Dist: xarray>=2022.3
 Provides-Extra: complete
@@ -74,7 +74,6 @@ Requires-Dist: google-cloud-storage>=2.1; extra == "gcp"
 Requires-Dist: platformdirs>=3.0; extra == "gcp"
 Requires-Dist: tqdm>=4.61; extra == "gcp"
 Provides-Extra: gfs
-Requires-Dist: boto3>=1.20; extra == "gfs"
 Requires-Dist: cfgrib>=0.9; extra == "gfs"
 Requires-Dist: eccodes>=2.38; extra == "gfs"
 Requires-Dist: netcdf4>=1.6.1; extra == "gfs"
@@ -94,6 +93,7 @@ Requires-Dist: google-cloud-bigquery-storage>=2.25; extra == "sat"
 Requires-Dist: pillow>=10.3; extra == "sat"
 Requires-Dist: pyproj>=3.5; extra == "sat"
 Requires-Dist: rasterio>=1.3; extra == "sat"
+Requires-Dist: s3fs>=2022.3; extra == "sat"
 Requires-Dist: scikit-image>=0.18; extra == "sat"
 Requires-Dist: shapely>=2.0; extra == "sat"
 Provides-Extra: open3d
@@ -140,7 +140,7 @@ Documentation and examples available at [py.contrails.org](https://py.contrails.
 
 ### Install with pip
 
-You can install pycontrails from PyPI with `pip` (Python 3.10 or later required):
+You can install pycontrails from PyPI with `pip` (Python 3.11 or later required):
 
 ```bash
 $ pip install pycontrails

{pycontrails-0.56.0 → pycontrails-0.58.0}/README.md

@@ -25,7 +25,7 @@ Documentation and examples available at [py.contrails.org](https://py.contrails.
 
 ### Install with pip
 
-You can install pycontrails from PyPI with `pip` (Python 3.10 or later required):
+You can install pycontrails from PyPI with `pip` (Python 3.11 or later required):
 
 ```bash
 $ pip install pycontrails

{pycontrails-0.56.0 → pycontrails-0.58.0}/docs/api.rst

@@ -83,13 +83,15 @@ ARCO ERA5
     datalib.ecmwf.arco_era5
 
 
-GOES
-""""
+Geostationary Satellites
+""""""""""""""""""""""""
 
 .. autosummary::
     :toctree: api/
 
     datalib.goes
+    datalib.himawari
+    datalib.geo_utils
 
 
 Low Earth Orbit Satellites

{pycontrails-0.56.0 → pycontrails-0.58.0}/docs/install.rst

@@ -17,7 +17,7 @@ The conda-forge package includes all optional runtime dependencies.
 pip install
 -----------
 
-With Python 3.10 or later, install the latest release from PyPI using ``pip``:
+With Python 3.11 or later, install the latest release from PyPI using ``pip``:
 
 .. code-block:: bash
 
@@ -27,7 +27,8 @@ With Python 3.10 or later, install the latest release from PyPI using ``pip``:
     # install with all optional dependencies
     $ pip install "pycontrails[complete]"
 
-Wheels are currently built and tested for python 3.10 - 3.13 on Linux, macOS, and Windows.
+Wheels are currently built for python 3.11 - 3.14 and tested for
+python 3.11 - 3.13 on Linux, macOS, and Windows.
 
 Install the latest development version directly from GitHub: