aircraft.anp_fleet

EASA ANP fleet database bridge for the ECAC Doc 29 airport-noise chain.

The ECAC Doc 29 method in phonometry.aircraft.airport_noise places an aircraft’s noise at a receiver from a Noise-Power-Distance (NPD) table and a flight profile. Both come, for real aircraft types, from the Aircraft Noise and Performance (ANP) database maintained by EUROCONTROL/EASA: per aircraft it tabulates NPD curves (LAmax and SEL versus slant distance for a set of engine power settings, per operation mode) and default trajectories.

This module reads the ANP database tables (the semicolon-delimited CSV exports) and exposes, for a given aircraft identifier and operation:

• AnpNpdCurves — the NPD curves (LAmax/SEL versus distance for each tabulated power), with a .plot();
• AnpProfile — the default fixed-point trajectory as a Doc 29 flight path (N, 5) with the takeoff/landing ground-roll masks, with a .plot();
• AnpAircraft — the aircraft metadata plus convenience wiring (AnpAircraft.event_level, AnpAircraft.noise_contour) that feeds the NPD curves and the profile straight into the existing Doc 29 functions.

load_anp_database returns an AnpDatabase. Called without a path it loads the full EASA ANP database (archive version 2.3) shipped with the package (see aircraft/data/anp/PROVENANCE.md); pointed at a directory it reads any other ANP CSV export the user provides.

Aircraft whose default trajectory is published as procedural steps rather than as fixed points are reached through phonometry.aircraft.flight_performance, the ECAC Doc 29 Vol. 2 Appendix B performance model: AnpDatabase.flight_profile flies the published procedure for an aerodrome and its weather, and AnpDatabase.procedural_profile returns the result as the same Doc 29 flight path the fixed-point bridge produces, so either kind of profile feeds the same chain. NPD curves are available for every aircraft regardless.

Source (clean-room, implemented from the published table format): EASA ANP database v2.3 (2020) and the ECAC Doc 29 4th ed. Vol 2 NPD/profile conventions.

Auto-generated from the source docstrings by scripts/generate_api_docs.py (make api-docs). Do not edit by hand.

AnpAircraft(
    aircraft_id: str,
    description: str,
    engine_type: str,
    num_engines: int,
    weight_class: str,
    mounting: str,
    npd_id: str,
    power_parameter: str,
    approach_spectral_class_id: str,
    departure_spectral_class_id: str,
    _database: AnpDatabase,
)

One ANP aircraft type: metadata plus NPD/profile access and Doc 29 wiring.

Attributes

AnpAircraft.event_level(
    observer: NDArray[np.float64] | list[float],
    operation: str,
    *,
    aerodrome: Aerodrome | None = None,
    stage_length: int | str = 1,
    metric: EventMetric = 'exposure',
    temperature_c: float | None = None,
    atmospheric_pressure_kpa: float | None = None,
    relative_humidity_percent: float | None = None,
    absorption: str = 'arp5534',
) -> FlyoverResult

Single-event level at a receiver (see AnpDatabase.event_level).

AnpAircraft.noise_contour(
    operation: str,
    *,
    x: NDArray[np.float64] | list[float],
    y: NDArray[np.float64] | list[float],
    aerodrome: Aerodrome | None = None,
    stage_length: int | str = 1,
    metric: EventMetric = 'exposure',
    temperature_c: float | None = None,
    atmospheric_pressure_kpa: float | None = None,
    relative_humidity_percent: float | None = None,
    absorption: str = 'arp5534',
) -> NoiseContourResult

Single-event ground contour (see AnpDatabase.noise_contour).

AnpAircraft.npd_curves(operation: str, metric: str = 'SEL') -> AnpNpdCurves

NPD curves for this aircraft (see AnpDatabase.npd_curves).

AnpAircraft.profile(
    operation: str,
    stage_length: int = 1,
    *,
    profile_id: str | None = None,
) -> AnpProfile

Fixed-point profile (see AnpDatabase.profile).

AnpAircraft.revised_npd_curves(
    operation: str,
    metric: str = 'SEL',
    *,
    temperature_c: float,
    relative_humidity_percent: float,
    atmospheric_pressure_kpa: float = 101.325,
    absorption: str = 'arp5534',
) -> RevisedNpdCurves

NPD curves for another atmosphere (see AnpDatabase.revised_npd_curves).

AnpAircraft.spectral_class(operation: str) -> SpectralClass

Spectral class of this aircraft’s NPD for an operation.

Parameters

Returns: The SpectralClass the ANP database assigns.

Raises

AnpDatabase(
    aircraft: Mapping[str, dict[str, str]],
    npd: Mapping[tuple[str, str, str], tuple[NDArray[np.float64], NDArray[np.float64]]],
    distances: NDArray[np.float64],
    profiles: Mapping[tuple[str, str, str, int], NDArray[np.float64]],
    performance: _PerformanceTables | None = None,
    spectral_classes: Mapping[str, SpectralClass] | None = None,
)

A parsed ANP database (aircraft metadata, NPD curves and default profiles).

Build one with load_anp_database. NPD curves are available for every aircraft; default profiles are available for aircraft that have a fixed-point trajectory in the database, and procedural-step profiles for those whose coefficient and step tables the export carries.

AnpDatabase.aircraft(aircraft_id: str) -> AnpAircraft

Return the AnpAircraft for an identifier.

Raises

property

Sorted list of aircraft identifiers in the database.

AnpDatabase.event_level(
    aircraft_id: str,
    observer: NDArray[np.float64] | list[float],
    operation: str,
    *,
    aerodrome: Aerodrome | None = None,
    stage_length: int | str = 1,
    metric: EventMetric = 'exposure',
    temperature_c: float | None = None,
    atmospheric_pressure_kpa: float | None = None,
    relative_humidity_percent: float | None = None,
    absorption: str = 'arp5534',
) -> FlyoverResult

Doc 29 single-event level of an ANP aircraft at a receiver.

Feeds the aircraft’s profile and NPD curves into phonometry.aircraft.airport_noise.event_level.

Parameters

Returns: A FlyoverResult.

AnpDatabase.flight_profile(
    aircraft_id: str,
    operation: str,
    *,
    aerodrome: Aerodrome,
    stage_length: int | str = 1,
    profile_id: str | None = None,
    weight_lb: float | None = None,
) -> FlightProfile

Fly an aircraft’s published procedure into a Doc 29 flight profile.

The ECAC Doc 29 Vol. 2 Appendix B model applied to this aircraft’s ANP procedural steps: the profile depends on the aerodrome and its weather, which is why one has to be given and why the answer is not a table entry.

Parameters

Returns: A FlightProfile.

Raises

AnpDatabase.noise_contour(
    aircraft_id: str,
    operation: str,
    *,
    x: NDArray[np.float64] | list[float],
    y: NDArray[np.float64] | list[float],
    aerodrome: Aerodrome | None = None,
    stage_length: int | str = 1,
    metric: EventMetric = 'exposure',
    temperature_c: float | None = None,
    atmospheric_pressure_kpa: float | None = None,
    relative_humidity_percent: float | None = None,
    absorption: str = 'arp5534',
) -> NoiseContourResult

Doc 29 single-event ground contour of an ANP aircraft.

Feeds the aircraft’s profile and NPD curves into phonometry.aircraft.airport_noise.noise_contour.

Parameters

Returns: A NoiseContourResult.

AnpDatabase.npd_curves(
    aircraft_id: str,
    operation: str,
    metric: str = 'SEL',
) -> AnpNpdCurves

NPD curves for an aircraft, operation and noise metric.

Parameters

Returns: An AnpNpdCurves.

Raises

AnpDatabase.performance_aircraft(aircraft_id: str) -> PerformanceAircraft

The aeroplane’s ECAC Doc 29 Vol. 2 Appendix B coefficient set.

Gathers the engine, aerodynamic and weight tables into the PerformanceAircraft the performance model takes. The engine count, the maximum sea-level static thrust and the maximum landing weight come from the aircraft table; the approach weight follows from the last of those as Doc 29 defines it.

Parameters

Returns: A PerformanceAircraft.

Raises

AnpDatabase.procedural_profile(
    aircraft_id: str,
    operation: str,
    *,
    aerodrome: Aerodrome,
    stage_length: int | str = 1,
    profile_id: str | None = None,
    weight_lb: float | None = None,
) -> AnpProfile

A flown procedure as the flight path the Doc 29 noise chain reads.

flight_profile converted into the same AnpProfile the fixed-point bridge returns, so an aircraft that publishes procedural steps and one that publishes fixed points feed event_level and noise_contour alike. The units change on the way (Appendix B works in feet, knots and pounds; the noise chain in metres and metres per second) and the power setting stays the corrected net thrust per engine the NPD tables are indexed on.

Takes the same arguments as flight_profile.

Returns: An AnpProfile.

AnpDatabase.procedural_steps(
    aircraft_id: str,
    operation: str,
    stage_length: int | str = 1,
    *,
    profile_id: str | None = None,
) -> tuple[DepartureStep, ...] | tuple[ApproachStep, ...]

The published procedure for an aircraft, as procedural steps.

The rows of the ANP departure or approach procedural-step table, in step order, as the types flight_performance flies. Approach procedures are not tabulated per stage length, so stage_length is read only for a departure.

Parameters

Returns: The steps, in order.

Raises

AnpDatabase.profile(
    aircraft_id: str,
    operation: str,
    stage_length: int | str = 1,
    *,
    profile_id: str | None = None,
) -> AnpProfile

Fixed-point trajectory for an aircraft, operation and stage length.

Aircraft may ship several fixed-point profiles for the same operation and stage length (e.g. weight variants). With profile_id=None the "DEFAULT" profile is selected when present; otherwise the single available profile is used, and an ambiguous request (several profiles, none named "DEFAULT") raises listing the identifiers.

Parameters

Returns: An AnpProfile (a Doc 29 flight path with ground-roll masks).

Raises

AnpDatabase.revised_npd_curves(
    aircraft_id: str,
    operation: str,
    metric: str = 'SEL',
    *,
    temperature_c: float,
    relative_humidity_percent: float,
    atmospheric_pressure_kpa: float = 101.325,
    absorption: str = 'arp5534',
) -> RevisedNpdCurves

NPD curves recalculated for another atmosphere (Doc 29 Vol. 2 Appendix D).

The curves of npd_curves revised by the increment of the aircraft’s own spectral class for the operation, as revise_npd_curves computes it.

Parameters

Returns: A RevisedNpdCurves.

Raises

AnpDatabase.spectral_class(class_id: int | str) -> SpectralClass

One spectral class of the database (ECAC Doc 29 Vol. 2 G4.3).

Parameters

Returns: A SpectralClass.

Raises

property

Sorted list of the spectral class identifiers in the database.

AnpNpdCurves(
    aircraft_id: str,
    npd_id: str,
    metric: str,
    operation: str,
    power_parameter: str,
    powers: NDArray[np.float64],
    distances: NDArray[np.float64],
    levels: NDArray[np.float64],
)

ANP Noise-Power-Distance curves for one aircraft, metric and operation.

Attributes

The powers, distances and levels arrays are read-only views shared with the parent database; copy them before mutating.

AnpNpdCurves.level(
    power: float,
    distance: NDArray[np.float64] | list[float] | float,
) -> NDArray[np.float64]

Interpolated NPD level L(P, d) (Doc 29 Eq. 4-3/4-4).

Parameters

Returns: The interpolated level per query distance, in dB.

AnpNpdCurves.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the NPD curve at each tabulated power versus slant distance.

AnpProfile(
    aircraft_id: str,
    operation: str,
    profile_id: str,
    stage_length: int | str,
    path: NDArray[np.float64],
    ground_roll: NDArray[np.bool_],
    landing_roll: NDArray[np.bool_],
)

Default fixed-point trajectory of an ANP aircraft as a Doc 29 flight path.

Attributes

path is a read-only view shared with the parent database; copy it before mutating.

AnpProfile.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the trajectory altitude versus along-track distance.

load_anp_database(path: Path | str | None = None) -> AnpDatabase

Load an EASA ANP database (aircraft, NPD curves and default profiles).

Parameters

Returns: An AnpDatabase.

Raises

SpectralClass(
    class_id: str,
    operation: str,
    description: str,
    frequencies_hz: NDArray[np.float64],
    levels_db: NDArray[np.float64],
)

One ANP spectral class: the reference spectrum of a group of aircraft.

ECAC Doc 29 Vol. 2 G4.3: the average unweighted spectrum at the time of the maximum level, at 1 000 ft, normalised to the same SAE AIR-1845 attenuation rates as the NPD data and, for historical reasons, to 70 dB in the 1 kHz band. Every aircraft is assigned one for approach and one for departure. Appendix D recalculates the aircraft’s NPD curves for another atmosphere from it (revise_npd_curves).

Attributes

SpectralClass.plot(
    ax: Axes | None = None,
    *,
    language: str = 'en',
    **kwargs: Any,
) -> Axes

Plot the band levels versus frequency.