pycontrails 0.55.0__tar.gz → 0.57.0__tar.gz

{pycontrails-0.55.0 → pycontrails-0.57.0}/.github/workflows/docs.yaml

@@ -41,7 +41,7 @@ jobs:
         id: get_version
         run: echo "version=$(git describe --tags --abbrev=0)" >> $GITHUB_OUTPUT
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: pip

{pycontrails-0.55.0 → pycontrails-0.57.0}/.github/workflows/doctest.yaml

@@ -39,7 +39,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: pip

{pycontrails-0.55.0 → pycontrails-0.57.0}/.github/workflows/release.yaml

@@ -40,7 +40,7 @@ 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_SKIP: '*-win32 *-manylinux_i686 *-musllinux*'

{pycontrails-0.55.0 → pycontrails-0.57.0}/.github/workflows/test.yaml

@@ -46,7 +46,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.pyversion }}
           cache: pip

{pycontrails-0.55.0 → pycontrails-0.57.0}/.zenodo.json

@@ -1,4 +1,7 @@
 {
+  "license": "Apache-2.0",
+  "title": "pycontrails: Python library for modeling aviation climate impacts",
+  "description": "<p><strong>pycontrails</strong> is an open source project and Python package for modeling aircraft contrails and other<br>\naviation related climate impacts.</p>\n\n<p><code>pycontrails</code> defines common data structures and interfaces to efficiently build and run models of aircraft performance, emissions, and radiative forcing.</p>\n\n<p>See the <a href=\"https://github.com/contrailcirrus/pycontrails\">Github repository</a> and <a href=\"https://py.contrails.org\">documentation</a> for more information.</p>",
   "creators": [
     {
       "name": "Marc Shapiro",
@@ -26,9 +29,6 @@
       "affiliation": "Breakthrough Energy"
     }
   ],
-  "license": "Apache-2.0",
-  "title": "pycontrails: Python library for modeling aviation climate impacts",
-  "description": "<p><strong>pycontrails</strong> is an open source project and Python package for modeling aircraft contrails and other<br>\naviation related climate impacts.</p>\n\n<p><code>pycontrails</code> defines common data structures and interfaces to efficiently build and run models of aircraft performance, emissions, and radiative forcing.</p>\n\n<p>See the <a href=\"https://github.com/contrailcirrus/pycontrails\">Github repository</a> and <a href=\"https://py.contrails.org\">documentation</a> for more information.</p>",
   "contributors": [
     {
       "affiliation": "DLR",
@@ -49,6 +49,11 @@
       "name": "Jakob Smretschnig",
       "affiliation": "TU Delft",
       "type": "Researcher"
+    },
+    {
+      "name": "Thymen Woldhuis",
+      "affiliation": "TU Delft",
+      "type": "Researcher"
     }
   ]
 }

{pycontrails-0.55.0 → pycontrails-0.57.0}/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 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
+
+- Improve the accuracy of overlaying flight tracks and contrails on Landsat and Sentinel imagery. This includes:
+  - A new `correction` module to align vectorized aircraft data with satellite imagery using sensing-angle (parallax error) and scan-time corrections. *Naively overlaying ADS-B data results in errors of several kilometers; with this correction, typical errors are reduced to a few hundred meters.*
+  - An updated `Sentinel` interface for parsing metadata required for overlay correction (see the new `sentinel_metadata` module for low-level details). This includes a new `colocate_flight` method to overlay flight tracks on Sentinel-2 imagery.
+  - A new `landsat_metadata` module for parsing Landsat metadata required for overlay correction (not exposed within the `Landsat` datalib).
+  - A new `open_landsat_metadata` function for accessing the [USGS Bulk Metadata service](https://www.usgs.gov/landsat-missions/bulk-metadata-service).
+- Update the [Sentinel notebook](https://py.contrails.org/notebooks/Sentinel.html) to demonstrate the new overlay correction functionality available in the `Sentinel` datalib.
+
+### Fixes
+
+- Fix the `Flight.to_geojson_multilinestring` method to handle flights without an "altitude" field.
+
+### Internals
+
+- Update the `Landsat` datalib documentation to describe current limitations. The `Landsat` datalib should be considered legacy and may be replaced in future releases.
+
 ## 0.55.0
 
 ### Features

{pycontrails-0.55.0 → pycontrails-0.57.0}/Makefile

@@ -204,6 +204,7 @@ nb-test: ensure-era5-cached nb-clean-check nb-format-check nb-check-links
 		--ignore=docs/notebooks/run-cocip-on-flight.ipynb \
 		--ignore=docs/notebooks/model-levels.ipynb \
 		--ignore=docs/notebooks/ARCO-ERA5.ipynb \
+		--ignore=docs/notebooks/Sentinel.ipynb \
 		docs/notebooks docs/integrations
 
 # Check for broken links in notebooks

{pycontrails-0.55.0/pycontrails.egg-info → pycontrails-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycontrails
-Version: 0.55.0
+Version: 0.57.0
 Summary: Python library for modeling aviation climate impacts
 Author-email: "Contrails.org" <py@contrails.org>
 License-Expression: Apache-2.0
@@ -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"
@@ -88,12 +87,15 @@ 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: geopandas>=1.1.1; extra == "sat"
 Requires-Dist: google-cloud-bigquery>=3.23; extra == "sat"
 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
 Requires-Dist: open3d>=0.14; extra == "open3d"
 Provides-Extra: pyproj

{pycontrails-0.55.0 → pycontrails-0.57.0}/docs/api.rst

@@ -100,6 +100,9 @@ Low Earth Orbit Satellites
 
     datalib.landsat
     datalib.sentinel
+    datalib.leo_utils
+    datalib.leo_utils.landsat_metadata
+    datalib.leo_utils.sentinel_metadata
 
 
 Models