pycontrails 0.51.1__tar.gz → 0.52.0__tar.gz

{pycontrails-0.51.1 → pycontrails-0.52.0}/.github/workflows/release.yaml

@@ -40,7 +40,7 @@ jobs:
 
       # https://cibuildwheel.readthedocs.io/en/stable/options/#testing
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.17
+        uses: pypa/cibuildwheel@v2.19
         env:
           CIBW_BUILD: cp39-* cp310-* cp311-* cp312-*
           CIBW_SKIP: '*-win32 *-manylinux_i686 *-musllinux*'
@@ -50,6 +50,10 @@ jobs:
           # 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"
+          # Make sure GITHUB_ACTIONS
+          # (used to selectively skip expensive unit test)
+          # is passed through when testing linux wheels
+          CIBW_ENVIRONMENT_PASS_LINUX: GITHUB_ACTIONS
           CIBW_TEST_COMMAND: >
             mv {project}/pycontrails {project}/pycontrails-bak &&
             python -m pytest {project}/tests -vv &&

{pycontrails-0.51.1 → pycontrails-0.52.0}/.github/workflows/scorecard.yaml

@@ -30,7 +30,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Run OpenSSF Security Scorecard
-        uses: ossf/scorecard-action@v2.3.1
+        uses: ossf/scorecard-action@v2.3.3
         with:
           results_file: results.sarif
           results_format: sarif

{pycontrails-0.51.1 → pycontrails-0.52.0}/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## v0.52.0
+
+### Breaking changes
+
+- The `_antimeridian_index` helper method in the `flight` module now returns a list of integers rather than an integer. This allows `Flight.to_geojson_multilinestring` to support multiple antimeridian crossings (see below).
+
+### Features
+
+- Add tools for running [APCEMM](https://github.com/MIT-LAE/APCEMM) from within pycontrails. This includes:
+    - utilities for generating APCEMM input files and running APCEMM (`pycontrails.models.apcemm.utils`)
+    - an interface (`pycontrails.models.apcemm.apcemm`) that allows users to run APCEMM as a pycontrails `Model`.
+- Add [APCEMM tutorial notebook](https://py.contrails.org/integrations/APCEMM.html).
+- Add prescribed sedimentation rate to `DryAdvection` model.
+- Add `Landsat` and `Sentinel` datalibs for searching, retrieving, and visualizing Landsat 8-9 and Sentinel-2 imagery. The datalibs include:
+    - Tools for querying Landsat and Sentinel-2 imagery for intersections with user-defined regions (`landsat.query`, `sentinel.query`) or flights (`landsat.intersect`, `sentinel.intersect`). These tools use BigQuery tables and require a Google Cloud Platform account with access to the BigQuery API.
+    - Tools for downloading and visualizing imagery from Landsat (`Landsat`) and Sentinel-2 (`Sentinel`). These tools retrieve data anonymously from Google Cloud Platform storage buckets and can be used without a Google Cloud Platform account.
+- Add tutorial notebooks demonstrating how to use `Landsat` and `Sentinel` datalibs to find flights in high-resolution satellite imagery.
+- Modify `Flight.to_geojson_multilinestring` to make grouping key optional and to support multiple antimeridian crossings.
+- Update the `pycontrails` build system to require `numpy 2.0` per the [official numpy guidelines](https://numpy.org/devdocs/dev/depending_on_numpy.html#numpy-2-0-specific-advice). Note that the runtime requirement for `pycontrails` remains `numpy>=1.22`.
+- Update `pycontrails` for breaking changes introduced in `numpy 2.0` (e.g., [NEP 50](https://numpy.org/neps/nep-0050-scalar-promotion.html)). All changes are backward compatible with `numpy>=1.22`.
+
+### Fixes
+
+- Ensure width and depth are never attached to `DryAdvection` source when running pointwise-only model.
+- Ensure that azimuth is not dropped when present in `DryAdvection` input source.
+- Exclude netCDF version 1.7.0, which causes non-deterministic failures in unit tests primarily due to segmentation faults.
+- Pin numpy to 1.x in runtime dependencies until a working numpy 2.x-compatible netCDF4 release is available.
+
+### Internals
+
+- Create unit tests for the `APCEMM` interface that run if an `APCEMM` executable is found on the `PATH` inside a clean APCEMM git repository with a pinned git hash. These tests will be skipped unless users carefully configure their local test environment and will not run in CI.
+- Exclude APCEMM tutorial notebook from notebook tests.
+- Add unit tests for Landsat and Sentinel search tools and datalibs, but disable any tests that retrieve imagery data when running tests in GitHub Actions to limit resource consumption in GitHub runners. Users can disable these units tests locally by setting the environment variable `GITHUB_ACTIONS=true`.
+- Ensure `GITHUB_ACTIONS` environment variable is available when building and testing wheels on linux.
+- Skip cells that retrieve imagery data when running tests on Landsat and Sentinel tutorial notebooks.
+- Add tests for `Flight.to_geojson_multilinestring` with grouping key omitted and update tests with multiple antimeridian crossings.
+- Minimum pandas version is bumped to 2.2 to ensure the the `include_groups` keyword argument used in `Flight.to_geojson_multilinestring` is available.
+- Upgrade minimum `mypy` dependencies
+
+## v0.51.2
+
+### Features
+
+- Add functionality to automatically compare  simulated contrails from `cocip.Cocip` with GOES satellite imagery (`compare_cocip_with_goes`).
+
+### Internals
+
+- Fix documentation build in CI.
+
 ## v0.51.1
 
 ### Breaking changes
@@ -8,9 +57,9 @@
 
 ### Features
 
-- PS model: Support four aircraft types, including `E75L`, `E75S`, `E290`, and `E295`
-- PS model: Integrate `ps_synonym_list` to increase PS model aircraft type coverage to 102
-- PS model: Account for increase in fuel consumption due to engine deterioration between maintenance cycle
+- PS model: Support four aircraft types, including `E75L`, `E75S`, `E290`, and `E295`.
+- PS model: Integrate `ps_synonym_list` to increase PS model aircraft type coverage to 102.
+- PS model: Account for increase in fuel consumption due to engine deterioration between maintenance cycle.
 
 ### Internals
 

{pycontrails-0.51.1 → pycontrails-0.52.0}/Makefile

@@ -202,6 +202,7 @@ nb-clean-check:
 nb-test: ensure-era5-cached nb-clean-check nb-black-check nb-check-links
 	python -m pytest --nbval-lax \
 		--ignore=docs/integrations/ACCF.ipynb \
+		--ignore=docs/integrations/APCEMM.ipynb \
 		--ignore=docs/notebooks/specific-humidity-interpolation.ipynb \
 		--ignore=docs/notebooks/GFS.ipynb \
 		--ignore=docs/notebooks/run-cocip-on-flight.ipynb \

{pycontrails-0.51.1 → pycontrails-0.52.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pycontrails
-Version: 0.51.1
+Version: 0.52.0
 Summary: Python library for modeling aviation climate impacts
 Author-email: Breakthrough Energy <py@contrails.org>
 License: Apache-2.0
@@ -28,21 +28,21 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 Requires-Dist: dask>=2022.3
-Requires-Dist: numpy>=1.22
+Requires-Dist: numpy<2.0.0,>=1.22
 Requires-Dist: overrides>=6.1
-Requires-Dist: pandas>=1.4
+Requires-Dist: pandas>=2.2
 Requires-Dist: scipy>=1.10
 Requires-Dist: xarray>=2022.3
 Provides-Extra: complete
-Requires-Dist: pycontrails[ecmwf,gcp,gfs,goes,jupyter,pyproj,vis,zarr]; extra == "complete"
+Requires-Dist: pycontrails[ecmwf,gcp,gfs,jupyter,pyproj,sat,vis,zarr]; extra == "complete"
 Provides-Extra: dev
 Requires-Dist: black[jupyter]==24.4.1; extra == "dev"
 Requires-Dist: dep_license; extra == "dev"
 Requires-Dist: fastparquet>=0.8; extra == "dev"
 Requires-Dist: ipdb>=0.13; extra == "dev"
 Requires-Dist: memory_profiler; extra == "dev"
-Requires-Dist: mypy>=0.99; extra == "dev"
-Requires-Dist: mypy-extensions>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: mypy-extensions>=1.0; extra == "dev"
 Requires-Dist: platformdirs>=3.0; extra == "dev"
 Requires-Dist: pre-commit>=2.10; extra == "dev"
 Requires-Dist: psutil; extra == "dev"
@@ -51,6 +51,7 @@ Requires-Dist: pytest>=8.2; extra == "dev"
 Requires-Dist: pytest-cov>=2.11; extra == "dev"
 Requires-Dist: requests>=2.25; extra == "dev"
 Requires-Dist: ruff==0.4.1; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: doc8>=1.1; extra == "docs"
 Requires-Dist: furo>=2023.3; extra == "docs"
@@ -69,7 +70,7 @@ Requires-Dist: cdsapi>=0.4; extra == "ecmwf"
 Requires-Dist: cfgrib>=0.9; extra == "ecmwf"
 Requires-Dist: eccodes>=1.4; extra == "ecmwf"
 Requires-Dist: ecmwf-api-client>=1.6; extra == "ecmwf"
-Requires-Dist: netcdf4>=1.6.1; extra == "ecmwf"
+Requires-Dist: netcdf4<1.7.0,>=1.6.1; extra == "ecmwf"
 Requires-Dist: platformdirs>=3.0; extra == "ecmwf"
 Requires-Dist: requests>=2.25; extra == "ecmwf"
 Requires-Dist: lxml>=5.1.0; extra == "ecmwf"
@@ -83,13 +84,21 @@ Requires-Dist: cfgrib>=0.9; extra == "gfs"
 Requires-Dist: eccodes>=1.4; extra == "gfs"
 Requires-Dist: platformdirs>=3.0; extra == "gfs"
 Requires-Dist: tqdm>=4.61; extra == "gfs"
-Provides-Extra: goes
-Requires-Dist: cartopy>=0.22; extra == "goes"
-Requires-Dist: gcsfs>=2022.3; extra == "goes"
-Requires-Dist: h5netcdf>=1.2; extra == "goes"
 Provides-Extra: jupyter
 Requires-Dist: ipywidgets>=7.6; extra == "jupyter"
 Requires-Dist: jupyterlab>=2.2; extra == "jupyter"
+Provides-Extra: sat
+Requires-Dist: cartopy>=0.22; extra == "sat"
+Requires-Dist: db-dtypes>=1.2; extra == "sat"
+Requires-Dist: gcsfs>=2022.3; extra == "sat"
+Requires-Dist: geojson>=3.1; extra == "sat"
+Requires-Dist: google-cloud-bigquery>=3.23; extra == "sat"
+Requires-Dist: google-cloud-bigquery-storage>=2.25; extra == "sat"
+Requires-Dist: h5netcdf>=1.2; 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: scikit-image>=0.18; extra == "sat"
 Provides-Extra: open3d
 Requires-Dist: open3d>=0.14; extra == "open3d"
 Provides-Extra: pyproj