pycontrails 0.55.0__tar.gz → 0.56.0__tar.gz

{pycontrails-0.55.0 → pycontrails-0.56.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.56.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.56.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.56.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.56.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 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.56.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.56.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycontrails
-Version: 0.55.0
+Version: 0.56.0
 Summary: Python library for modeling aviation climate impacts
 Author-email: "Contrails.org" <py@contrails.org>
 License-Expression: Apache-2.0
@@ -88,12 +88,14 @@ 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: 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.56.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