How contrailcirrus/pycontrails works
pycontrails is a Python library for modeling aircraft contrails and other aviation climate impacts. The main workflow represents aircraft trajectories and meteorology as shared data structures, obtains weather from data-source adapters, then evaluates models such as CoCiP to estimate contrail properties and radiative forcing. Aircraft-performance, emissions, and related models are additional branches built on the same common interfaces. The map uses the README and SOURCE INDEX references; unsampled modules are included where they represent major capabilities, but their internal call paths are not inferred.
Main entry points: met.py Meteorology data · flight.py Flight data · apcemm.py APCEMM model · cocip.py CoCiP contrails
Components 24
Shared data
- Flight data
pycontrails/core/flight.py - Vector datasets
pycontrails/core/vector.py - Aircraft fleets
pycontrails/core/fleet.py - Meteorology data
pycontrails/core/met.py - Meteorology variables
pycontrails/core/met_var.py
Data sources
- Weather source interface
pycontrails/datalib/_met_utils/metsource.py - ECMWF weather
pycontrails/datalib/ecmwf - GFS weather
pycontrails/datalib/gfs - DWD ICON weather
pycontrails/datalib/dwd
Climate models
- Model interfaces
pycontrails/core/models.py - CoCiP contrails
pycontrails/models/cocip/cocip.py - Contrail properties
pycontrails/models/cocip/contrail_properties.py - CoCiP grid model
pycontrails/models/cocipgrid/cocip_grid.py - APCEMM model
pycontrails/models/apcemm/apcemm.py - Emissions models
pycontrails/models/emissions - Humidity scaling
pycontrails/models/humidity_scaling/humidity_scaling.py
Aircraft and physics
- Aircraft performance
pycontrails/core/aircraft_performance.py - Thermodynamics
pycontrails/physics/thermo.py - Unit conversions
pycontrails/physics/units.py
Satellite data
- Satellite search
pycontrails/datalib/leo_utils/search.py - GOES imagery
pycontrails/datalib/goes.py - Landsat imagery
pycontrails/datalib/landsat.py - Sentinel imagery
pycontrails/datalib/sentinel.py
Other components
- Library user
Connections 27
- Library user → Flight data: provides trajectory
- Library user → Meteorology data: provides meteorology
- Library user → Model interfaces: runs models
- Flight data → Vector datasets: extends
pycontrails/core/flight.py - Aircraft fleets → Flight data: uses
pycontrails/core/fleet.py - Weather source interface → Meteorology data: provides weather
pycontrails/datalib/_met_utils/metsource.py - ECMWF weather → Meteorology data: provides weather
pycontrails/datalib/ecmwf/hres.py - GFS weather → Meteorology data: provides weather
pycontrails/core/models.py - DWD ICON weather → Meteorology data: provides weather
pycontrails/datalib/dwd/icon.py - Model interfaces → Meteorology data: selects variables
pycontrails/core/models.py - Model interfaces → Flight data: processes trajectories
pycontrails/core/models.py - CoCiP contrails → Model interfaces: uses interface
pycontrails/models/cocip/cocip.py - CoCiP contrails → Flight data: uses trajectory
pycontrails/models/cocip/cocip.py - CoCiP contrails → Meteorology data: uses weather
pycontrails/models/cocip/cocip.py - CoCiP contrails → Contrail properties: uses properties
pycontrails/models/cocip/cocip.py - Contrail properties → Thermodynamics: uses thermodynamics
pycontrails/models/cocip/contrail_properties.py - Contrail properties → Unit conversions: uses conversions
pycontrails/models/cocip/contrail_properties.py - CoCiP grid model → CoCiP contrails: uses model
pycontrails/models/cocipgrid/cocip_grid.py - CoCiP grid model → Contrail properties: uses properties
pycontrails/models/cocipgrid/cocip_grid.py - APCEMM model → Model interfaces: uses interface
pycontrails/models/apcemm/apcemm.py - APCEMM model → Flight data: uses trajectory
pycontrails/models/apcemm/apcemm.py - APCEMM model → Meteorology data: uses weather
pycontrails/models/apcemm/apcemm.py - APCEMM model → Emissions models: uses emissions
pycontrails/models/apcemm/apcemm.py - APCEMM model → Humidity scaling: uses scaling
pycontrails/models/apcemm/apcemm.py - Aircraft performance → Flight data: uses trajectory
pycontrails/core/aircraft_performance.py - Satellite search → GOES imagery: searches imagery
- Library user → Satellite search: queries imagery