13  🪬 prop

The prop module provides access to aircraft and engine property data.

from openap import prop
from pprint import pprint

13.0.1 available_aircraft(use_synonym=False)

Get a list of available aircraft types in OpenAP.

Parameter Type Description
use_synonym bool Include synonyms in the list. Default: False

Returns: List[str] — List of ICAO aircraft type codes

# Get first 10 available aircraft types
prop.available_aircraft()[:10]
['a19n',
 'a20n',
 'a21n',
 'a318',
 'a319',
 'a320',
 'a321',
 'a332',
 'a333',
 'a343']

13.0.2 aircraft(ac, use_synonym=False)

Get detailed performance parameters for a specific aircraft type.

Parameter Type Description
ac str ICAO aircraft type code (e.g., “A320”)
use_synonym bool Use synonym if aircraft not found. Default: False

Returns: Dict[str, Any] — Dictionary containing performance parameters including maximum takeoff weight (mtow), maximum landing weight (mlw), operating empty weight (oew), dimensions, engine information, and other aircraft specifications.

# Get aircraft details for A320
aircraft_data = prop.aircraft("A320")
pprint(aircraft_data)
{'aircraft': 'Airbus A320',
 'ceiling': 12500,
 'cruise': {'height': 11000, 'mach': 0.78, 'range': 5000},
 'drag': {'cd0': 0.018, 'e': 0.799, 'gears': 0.017, 'k': 0.039},
 'engine': {'default': 'CFM56-5B4',
            'mount': 'wing',
            'number': 2,
            'options': {'A320-111': 'CFM56-5-A1',
                        'A320-211': 'CFM56-5-A1',
                        'A320-212': 'CFM56-5A3',
                        'A320-214': 'CFM56-5B4',
                        'A320-215': 'CFM56-5B5',
                        'A320-216': 'CFM56-5B6',
                        'A320-231': 'V2500-A1',
                        'A320-232': 'V2527-A5',
                        'A320-233': 'V2527E-A5'},
            'type': 'turbofan'},
 'flaps': {'Sf/S': 0.17,
           'area': 21.1,
           'bf/b': 0.78,
           'cf/c': 0.176,
           'lambda_f': 0.9,
           'type': 'single-slotted'},
 'fuel': {'engine': 'CFM56-5B4/P', 'fuel_coef': 2.65942225},
 'fuselage': {'height': 4.14, 'length': 37.57, 'width': 3.95},
 'limits': {'MFC': 24210,
            'MLW': 66000,
            'MMO': 0.82,
            'MTOW': 78000,
            'OEW': 42600,
            'VMO': 350,
            'ceiling': 12500},
 'mfc': 24210,
 'mlw': 66000,
 'mmo': 0.82,
 'mtow': 78000,
 'oew': 42600,
 'pax': {'high': 170, 'low': 140, 'max': 180},
 'vmo': 350,
 'wing': {'area': 124, 'mac': 4.1935, 'span': 35.8, 'sweep': 25, 't/c': None}}

13.0.3 aircraft_engine_options(ac)

Get the list of engine options available for a specific aircraft type.

Parameter Type Description
ac str ICAO aircraft type code (e.g., “A320”)

Returns: List[str] — List of engine type strings

# Get engine options for A320
prop.aircraft_engine_options("A320")
['CFM56-5-A1',
 'CFM56-5-A1',
 'CFM56-5A3',
 'CFM56-5B4',
 'CFM56-5B5',
 'CFM56-5B6',
 'V2500-A1',
 'V2527-A5',
 'V2527E-A5']

13.0.4 search_engine(eng)

Search for engines that match the given prefix string.

Parameter Type Description
eng str Engine type prefix (e.g., “CFM56”)

Returns: List[str] or None — List of matching engine types, or None if no matches found

# Search for CFM56 engines
prop.search_engine("CFM56")
['CFM56-2A',
 'CFM56-2B-1',
 'CFM56-2-C5',
 'CFM56-3-B1',
 'CFM56-3B-2',
 'CFM56-3C-1',
 'CFM56-5-A1',
 'CFM56-5A3',
 'CFM56-5A4',
 'CFM56-5A5',
 'CFM56-5B1',
 'CFM56-5B1/2',
 'CFM56-5B1/2P',
 'CFM56-5B1/3',
 'CFM56-5B1/P',
 'CFM56-5B2',
 'CFM56-5B2/2',
 'CFM56-5B2/2P',
 'CFM56-5B2/3',
 'CFM56-5B2/P',
 'CFM56-5B3/2P',
 'CFM56-5B3/3',
 'CFM56-5B3/P',
 'CFM56-5B4',
 'CFM56-5B4/2',
 'CFM56-5B4/2P',
 'CFM56-5B4/3',
 'CFM56-5B4/P',
 'CFM56-5B5/3',
 'CFM56-5B5/P',
 'CFM56-5B6/2',
 'CFM56-5B6/2P',
 'CFM56-5B6/3',
 'CFM56-5B6/P',
 'CFM56-5B7/3',
 'CFM56-5B7/P',
 'CFM56-5B8/3',
 'CFM56-5B8/P',
 'CFM56-5B9/2P',
 'CFM56-5B9/3',
 'CFM56-5B9/P',
 'CFM56-5C2',
 'CFM56-5C2/P',
 'CFM56-5C3',
 'CFM56-5C3/P',
 'CFM56-5C4',
 'CFM56-5C4/P',
 'CFM56-7B18',
 'CFM56-7B18/3',
 'CFM56-7B20',
 'CFM56-7B20/2',
 'CFM56-7B20/3',
 'CFM56-7B20E',
 'CFM56-7B22',
 'CFM56-7B22/2',
 'CFM56-7B22/3',
 'CFM56-7B22E',
 'CFM56-7B22E/B1',
 'CFM56-7B24',
 'CFM56-7B24/2',
 'CFM56-7B24/3',
 'CFM56-7B24E',
 'CFM56-7B24E/B1',
 'CFM56-7B26',
 'CFM56-7B26/2',
 'CFM56-7B26/3',
 'CFM56-7B26E',
 'CFM56-7B26E/B1',
 'CFM56-7B26E/B2',
 'CFM56-7B26E/B2F',
 'CFM56-7B26E/F',
 'CFM56-7B27',
 'CFM56-7B27/2',
 'CFM56-7B27/3',
 'CFM56-7B27AE',
 'CFM56-7B27E',
 'CFM56-7B27E/B1',
 'CFM56-7B27E/B1F',
 'CFM56-7B27E/B3',
 'CFM56-7B27E/F']

13.0.5 engine(eng)

Get detailed parameters for a specific engine type.

Parameter Type Description
eng str Engine type (e.g., “CFM56-5B6”)

Returns: Dict[str, Any] — Dictionary containing engine specifications including thrust, fuel flow, specific fuel consumption, and other performance parameters.

# Get engine details for CFM56-5B4
engine_data = prop.engine("CFM56-5B4")
pprint(engine_data)
{'bpr': 5.9,
 'cruise_alt': 35000.0,
 'cruise_mach': 0.8,
 'cruise_sfc': 0.0154,
 'cruise_thrust': 22241.0,
 'ei_co_app': 2.33,
 'ei_co_co': 0.5,
 'ei_co_idl': 31.9,
 'ei_co_to': 0.5,
 'ei_hc_app': 0.13,
 'ei_hc_co': 0.1,
 'ei_hc_idl': 3.87,
 'ei_hc_to': 0.1,
 'ei_nox_app': 10.0,
 'ei_nox_co': 23.3,
 'ei_nox_idl': 4.3,
 'ei_nox_to': 28.7,
 'ff_app': 0.326,
 'ff_co': 0.961,
 'ff_idl': 0.107,
 'ff_to': 1.166,
 'fuel_ch': np.float64(5.2e-07),
 'fuel_lto': 421.0,
 'manufacturer': 'CFM International',
 'max_thrust': 117900.0,
 'name': 'CFM56-5B4',
 'pr': 27.1,
 'type': 'TF',
 'uid': '2CM014'}