pycontrails 0.54.12__tar.gz → 0.56.0__tar.gz

{pycontrails-0.54.12 → pycontrails-0.56.0}/.github/workflows/docs.yaml

@@ -41,14 +41,14 @@ 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
           cache-dependency-path: pyproject.toml
 
       - name: Authenticate to Google Cloud
-        uses: google-github-actions/auth@v2
+        uses: google-github-actions/auth@v3
         with:
           credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT }}
 

{pycontrails-0.54.12 → pycontrails-0.56.0}/.github/workflows/doctest.yaml

@@ -39,19 +39,19 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: pip
           cache-dependency-path: pyproject.toml
 
       - name: Authenticate to Google Cloud
-        uses: google-github-actions/auth@v2
+        uses: google-github-actions/auth@v3
         with:
           credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT }}
 
       - name: Set up Cloud SDK
-        uses: google-github-actions/setup-gcloud@v3.0.0
+        uses: google-github-actions/setup-gcloud@v3
 
       # put bada files in the default location
       - name: BADA files

{pycontrails-0.54.12 → 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
@@ -63,12 +63,12 @@ jobs:
             ${{ github.workspace }}/.pytest_cache
 
       - name: Authenticate to Google Cloud
-        uses: google-github-actions/auth@v2
+        uses: google-github-actions/auth@v3
         with:
           credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT }}
 
       - name: Set up Cloud SDK
-        uses: google-github-actions/setup-gcloud@v3.0.0
+        uses: google-github-actions/setup-gcloud@v3
 
       - name: Download BADA files
         timeout-minutes: 5  # `gcloud storage cp` occasionally hangs on windows

{pycontrails-0.54.12 → 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.54.12 → pycontrails-0.56.0}/CHANGELOG.md

@@ -1,5 +1,35 @@
 # 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
+
+- Add new `pycontrails.models.extended_k15` module for modeling volatile particulate matter (vPM) activation in aircraft plumes. This module implements the extended K15 model introduced by [Ponsonby et al.](https://doi.org/10.5194/egusphere-2025-1717).
+- Introduce basic support for vPM activation within the `Cocip` and `CocipGrid` models. This support is experimental and can be enabled via the `vpm_activation` parameter.
+
+### Internals
+
+- Refactor `contrail_properties.initial_ice_particle_number` to integrate more smoothly with the vPM activation model. The function's signature has been updated, but its underlying behavior is unchanged. In particular, this has no effect on the `Cocip` model when `vpm_activation` is disabled.
+
 ## 0.54.12
 
 ### Breaking changes

{pycontrails-0.54.12 → 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.54.12/pycontrails.egg-info → pycontrails-0.56.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycontrails
-Version: 0.54.12
+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