API Reference#

Data#

Meteorology#

MetDataset(data[, cachestore, ...])

Meteorological dataset with multiple variables.

MetDataArray(data[, cachestore, ...])

Meteorological DataArray of single variable.

Vector Data#

VectorDataset([data, attrs, copy])

Base class to hold 1D arrays of consistent size.

GeoVectorDataset([data, longitude, ...])

Base class to hold 1D geospatial arrays of consistent size.

Flight & Aircraft#

Flight([data, longitude, latitude, ...])

A single flight trajectory.

Fleet([data, longitude, latitude, altitude, ...])

Data structure for holding a sequence of Flight instances.

FlightPhase(value[, names, module, ...])

Flight phase enumeration.

Fuel(fuel_name, q_fuel, hydrogen_content, ...)

Base class for the physical parameters of the fuel.

JetA([fuel_name, q_fuel, hydrogen_content, ...])

Jet A-1 Fuel.

SAFBlend(pct_blend)

Jet A-1 / Sustainable Aviation Fuel Blend.

HydrogenFuel([fuel_name, q_fuel, ...])

Hydrogen Fuel.

Datalib#

ECMWF#

datalib.ecmwf.ERA5(time, variables[, ...])

Class to support ERA5 data access, download, and organization.

datalib.ecmwf.HRES(time, variables[, ...])

Class to support HRES data access, download, and organization.

datalib.ecmwf.hres.get_forecast_filename(...)

Create forecast filename from ECMWF dissemination products.

datalib.ecmwf.IFS(time, variables[, ...])

ECMWF Integrated Forecasting System (IFS) data source.

datalib.ecmwf.variables

ECMWF Parameter Support.

GFS#

datalib.gfs.GFSForecast(time, variables[, ...])

GFS Forecast data access.

datalib.gfs.variables

GFS Parameter Support.

GOES#

datalib.goes

Support for GOES access and analysis.

Models#

Base Classes#

Model([met, params])

Base class for physical models.

ModelParams([copy_source, ...])

Class for constructing model parameters.

SAC, ISSR & PCC#

models.issr

Ice super-saturated regions (ISSR).

models.sac

Schmidt-Appleman criteria (SAC).

models.pcr

Persistent contrail regions (PCR = SAC & ISSR).

models.pcc

Probability of persistent contrail coverage (PCC).

CoCiP#

models.cocip.Cocip(met, rad[, params])

Contrail Cirrus Prediction Model (CoCiP).

models.cocip.CocipParams([copy_source, ...])

Model parameters required by the CoCiP models.

models.cocip.contrail_properties

Contrail Property Calculations.

models.cocip.radiative_forcing

Module for calculating radiative forcing of contrail cirrus.

models.cocip.wake_vortex

Wave-vortex downwash functions.

models.cocip.wind_shear

Wind shear functions.

ACCF#

This model is a this interface over the DLR / UMadrid climaccf package. See ACCF for more information.

models.accf.ACCF(met[, surface, params])

Compute Algorithmic Climate Change Functions (ACCF).

models.accf.ACCFParams([copy_source, ...])

Default ACCF model parameters.

Aircraft Performance#

In development

core.aircraft_performance

Abstract interfaces for aircraft performance models.

models.ps_model.PSFlightParams([...])

Default parameters for PSFlight.

models.ps_model.PSFlight([met, params])

Simulate aircraft performance using Poll-Schumann (PS) model.

models.ps_model.PSGrid([met, params])

Compute nominal Poll-Schumann aircraft performance over a grid.

models.ps_model.PSAircraftEngineParams(...)

Store extracted aircraft and engine parameters for each aircraft type.

models.ps_model.ps_nominal_grid(aircraft_type, *)

Calculate the nominal performance grid for a given aircraft type.

Emissions#

models.emissions.Emissions([met, params])

Emissions handling using ICAO Emissions Databank (EDB) and black carbon correlations.

models.emissions.black_carbon

Non-volatile particulate matter (nvPM) calculations.

models.emissions.ffm2

Calculate nitrogen oxide (NOx), carbon monoxide (CO) and hydrocarbon (HC) emissions.

Cirrus Optical Depth (\(\tau_{cirrus}\))#

models.tau_cirrus

Calculate tau cirrus on Met data.

Humidity Scaling#

models.humidity_scaling

Humidity scaling methodologies.

Physics#

physics.constants

Meteorological, thermophysical, and aircraft constants.

physics.thermo

Thermodynamic relationships.

physics.jet

Jet aircraft trajectory and performance parameters.

physics.geo

Tools for spherical geometry, solar radiation, and wind advection.

physics.units

Unit conversion support.

Cache#

DiskCacheStore([cache_dir, allow_clear])

Cache that uses a folder on the local filesystem.

GCPCacheStore([cache_dir, project, bucket, ...])

Google Cloud Platform (Storage) Cache.

Core#

core.airports

Airport data support.

core.cache

Pycontrails Caching Support.

core.coordinates

Coordinates utilities.

core.datalib

Datalib utilities.

core.fleet

A single data structure encompassing a sequence of Flight instances.

core.flight

Flight Data Handling.

core.fuel

Fuel data support.

core.interpolation

Interpolation utilities.

core.met

Meteorology data models.

core.met_var

Module containing core met variables.

core.models

Physical model data structures.

core.polygon

Algorithm support for grid to polygon conversion.

core.vector

Lightweight data structures for vector paths.

Utilities#

utils.types

Convienence types.

utils.iteration

Utilites for iterating of sequences.

utils.temp

Temp utilities.

utils.json

JSON utilities.

Extensions#

BADA#

Requires pycontrails-bada extension and data files obtained through BADA license. See BADA Extension for more information.

ext.bada.bada_model

BADA models along flight and on a regular grid.

ext.bada.BADAFlight([met, params])

Compute aircraft properties and fuel consumption.

ext.bada.BADAFlightParams([copy_source, ...])

BADAFlight model parameters.

ext.bada.BADAGrid([met, params])

Compute nominal BADA values for a large grid of independent points.

ext.bada.BADAGridParams([copy_source, ...])

BADAGrid model parameters.

ext.bada.BADA3([bada_path])

BADA 3.15 Support.

ext.bada.BADA4([bada_path])

BADA 4.2 Support.