aircraft.anp_fleet
La referencia de la API se publica en inglés en los dos idiomas: se genera a partir de los docstrings del código, que son su texto original.
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/SELversus 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
Section titled “ANPAircraft”ANPAircraft( aircraft_id: str, description: str, engine_type: str, n_engines: int, weight_class: str, mounting: Literal['wing', 'fuselage', 'propeller'], 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier (e.g. "747100"). |
description |
Human-readable aircraft/engine description. |
engine_type |
"Jet", "Turboprop" or "Piston". |
n_engines |
Number of engines. |
weight_class |
ICAO wake weight class. |
mounting |
Doc 29 engine mounting ("wing"/"fuselage"/"propeller"). |
npd_id |
ANP noise identifier. |
power_parameter |
Name/unit of the NPD power parameter. |
approach_spectral_class_id |
Spectral class of the approach NPD. |
departure_spectral_class_id |
Spectral class of the departure NPD. |
database |
The ANPDatabase the aircraft was read from, which its NPD, spectral-class, profile and Doc 29 methods consult. |
ANPAircraft.event_level()
Section titled “ANPAircraft.event_level()”ANPAircraft.event_level( observer: NumericArrayLike, operation: Literal['departure', 'D', 'arrival', 'A'], *, aerodrome: Aerodrome | None = None, stage_length: int | str = 1, metric: Literal['exposure', 'maximum'] = 'exposure', temperature_c: float | None = None, static_pressure_kpa: float | None = None, relative_humidity_percent: float | None = None, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> FlyoverResultSingle-event level at a receiver (see ANPDatabase.event_level).
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
metric |
One of "exposure" or "maximum". |
absorption |
One of "arp5534" or "arp866a". |
Raises
| Exception | When |
|---|---|
| ValueError | for an operation, metric or absorption other than those listed (the spelling as written). |
| TypeError | if operation, metric or absorption is not a text. |
ANPAircraft.noise_contour()
Section titled “ANPAircraft.noise_contour()”ANPAircraft.noise_contour( operation: Literal['departure', 'D', 'arrival', 'A'], *, x: NumericArrayLike, y: NumericArrayLike, aerodrome: Aerodrome | None = None, stage_length: int | str = 1, metric: Literal['exposure', 'maximum'] = 'exposure', temperature_c: float | None = None, static_pressure_kpa: float | None = None, relative_humidity_percent: float | None = None, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> NoiseContourResultSingle-event ground contour (see ANPDatabase.noise_contour).
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
metric |
One of "exposure" or "maximum". |
absorption |
One of "arp5534" or "arp866a". |
Raises
| Exception | When |
|---|---|
| ValueError | for an operation, metric or absorption other than those listed (the spelling as written). |
| TypeError | if operation, metric or absorption is not a text. |
ANPAircraft.npd_curves()
Section titled “ANPAircraft.npd_curves()”ANPAircraft.npd_curves( operation: Literal['departure', 'D', 'arrival', 'A'], metric: Literal['SEL', 'LAmax'] = 'SEL',) -> ANPNPDCurvesNPD curves for this aircraft (see ANPDatabase.npd_curves).
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
metric |
One of "SEL" or "LAmax". |
Raises
| Exception | When |
|---|---|
| ValueError | for an operation or metric other than those listed (the spelling as written, "departure" and not "Departure"). |
| TypeError | if operation or metric is not a text. |
ANPAircraft.profile()
Section titled “ANPAircraft.profile()”ANPAircraft.profile( operation: Literal['departure', 'D', 'arrival', 'A'], stage_length: int = 1, *, profile_id: str | None = None,) -> ANPProfileFixed-point profile (see ANPDatabase.profile).
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
Raises
| Exception | When |
|---|---|
| ValueError | for an operation other than the four listed (the spelling as written, "arrival" and not "ARRIVAL"). |
| TypeError | if operation is not a text. |
ANPAircraft.revised_npd_curves()
Section titled “ANPAircraft.revised_npd_curves()”ANPAircraft.revised_npd_curves( operation: Literal['departure', 'D', 'arrival', 'A'], metric: Literal['SEL', 'LAmax'] = 'SEL', *, temperature_c: float, relative_humidity_percent: float, static_pressure_kpa: float = 101.325, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> RevisedNPDCurvesNPD curves for another atmosphere (see ANPDatabase.revised_npd_curves).
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
metric |
One of "SEL" or "LAmax". |
absorption |
One of "arp5534" or "arp866a". |
Raises
| Exception | When |
|---|---|
| ValueError | for an operation, metric or absorption other than those listed (the spelling as written). |
| TypeError | if operation, absorption or metric is not a text. |
ANPAircraft.spectral_class()
Section titled “ANPAircraft.spectral_class()”ANPAircraft.spectral_class( operation: Literal['departure', 'D', 'arrival', 'A'],) -> SpectralClassSpectral class of this aircraft’s NPD for an operation.
Parameters
| Name | Description |
|---|---|
operation |
"departure"/"D" or "arrival"/"A". |
Returns: The SpectralClass the ANP database assigns.
Raises
| Exception | When |
|---|---|
| KeyError | if the database carries no such class. |
| TypeError | if operation is not a text. |
ANPDatabase
Section titled “ANPDatabase”ANPDatabase( aircraft: Mapping[str, Mapping[str, str]], npd: Mapping[tuple[str, str, str], tuple[NDArray[np.float64], NDArray[np.float64]]], distances_m: NumericArrayLike, profiles: Mapping[tuple[str, str, str, int], NDArray[np.float64]], 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()
Section titled “ANPDatabase.aircraft()”ANPDatabase.aircraft(aircraft_id: str) -> ANPAircraftThe ANPAircraft for an identifier.
Raises
| Exception | When |
|---|---|
| KeyError | If the identifier is not in the database. |
ANPDatabase.aircraft_ids
Section titled “ANPDatabase.aircraft_ids”property
Sorted list of aircraft identifiers in the database.
ANPDatabase.event_level()
Section titled “ANPDatabase.event_level()”ANPDatabase.event_level( aircraft_id: str, observer: NumericArrayLike, operation: Literal['departure', 'D', 'arrival', 'A'], *, aerodrome: Aerodrome | None = None, stage_length: int | str = 1, metric: Literal['exposure', 'maximum'] = 'exposure', temperature_c: float | None = None, static_pressure_kpa: float | None = None, relative_humidity_percent: float | None = None, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> FlyoverResultDoc 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
observer |
Receiver position (x, y, z), in metres. |
operation |
"departure"/"D" or "arrival"/"A". |
aerodrome |
Fly the published procedural steps at this field through the Appendix B performance model instead of reading the tabulated fixed-point trajectory. Most ANP types publish only steps, so for them this is not an alternative but the only way in. |
stage_length |
ANP stage length (default 1). |
metric |
"exposure" (SEL) or "maximum" (LAmax). |
temperature_c |
Air temperature at the field, in °C, for the atmospheric impedance adjustment. Left unset it follows aerodrome, or the standard atmosphere when there is none. |
static_pressure_kpa |
Air pressure at the field, in kPa, likewise. |
relative_humidity_percent |
Relative humidity at the field, in percent. Given, the SEL and LAmax NPD curves are recalculated for that humidity and the temperature and pressure above by ECAC Doc 29 Vol. 2 Appendix D, with the aircraft’s spectral class for the operation; left unset they stay in the SAE AIR-1845 atmosphere the database is normalised to. |
absorption |
The Appendix D absorption route, "arp5534" (default) or "arp866a"; read only with a humidity. |
Returns: A FlyoverResult.
Raises
| Exception | When |
|---|---|
| ValueError | for an operation, metric or absorption other than those listed (the spelling as written, "departure" and not "DEPARTURE" or "takeoff"). |
| TypeError | if operation, metric or absorption is not a text. relative_humidity_percent is refused the same way when it is not one real number. |
ANPDatabase.flight_profile()
Section titled “ANPDatabase.flight_profile()”ANPDatabase.flight_profile( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], *, aerodrome: Aerodrome, stage_length: int | str = 1, profile_id: str | None = None, weight_lb: float | None = None,) -> FlightProfileFly 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
aerodrome |
The Aerodrome to fly from, carrying its elevation, temperature, pressure and headwind. |
stage_length |
ANP stage length (default 1), which selects the take-off weight of a departure. |
profile_id |
Optional ANP profile identifier. |
weight_lb |
Weight to fly at, lb. None (default) takes the ANP default weight for the stage length on a departure, and 90 % of the maximum landing weight on an arrival, as Doc 29 defines it. |
Returns: A FlightProfile.
Raises
| Exception | When |
|---|---|
| KeyError | If the aircraft has no procedural-step profile or no default weight for the request. |
| TypeError | if operation is not a text. |
ANPDatabase.noise_contour()
Section titled “ANPDatabase.noise_contour()”ANPDatabase.noise_contour( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], *, x: NumericArrayLike, y: NumericArrayLike, aerodrome: Aerodrome | None = None, stage_length: int | str = 1, metric: Literal['exposure', 'maximum'] = 'exposure', temperature_c: float | None = None, static_pressure_kpa: float | None = None, relative_humidity_percent: float | None = None, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> NoiseContourResultDoc 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
x |
Grid x coordinates (along-track), in metres. |
y |
Grid y coordinates (lateral), in metres. |
aerodrome |
Fly the published procedural steps at this field through the Appendix B performance model instead of reading the tabulated fixed-point trajectory. Most ANP types publish only steps, so for them this is not an alternative but the only way in. |
stage_length |
ANP stage length (default 1). |
metric |
"exposure" (SEL) or "maximum" (LAmax). |
temperature_c |
Air temperature at the field, in °C, for the atmospheric impedance adjustment. Left unset it follows aerodrome, or the standard atmosphere when there is none. |
static_pressure_kpa |
Air pressure at the field, in kPa, likewise. |
relative_humidity_percent |
Relative humidity at the field, in percent. Given, the SEL and LAmax NPD curves are recalculated for that humidity and the temperature and pressure above by ECAC Doc 29 Vol. 2 Appendix D, with the aircraft’s spectral class for the operation; left unset they stay in the SAE AIR-1845 atmosphere the database is normalised to. |
absorption |
The Appendix D absorption route, "arp5534" (default) or "arp866a"; read only with a humidity. |
Returns: A NoiseContourResult.
Raises
| Exception | When |
|---|---|
| ValueError | for an operation, metric or absorption other than those listed (the spelling as written, "departure" and not "DEPARTURE" or "takeoff"). |
| TypeError | if operation, metric or absorption is not a text. relative_humidity_percent is refused the same way when it is not one real number. |
ANPDatabase.npd_curves()
Section titled “ANPDatabase.npd_curves()”ANPDatabase.npd_curves( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], metric: Literal['SEL', 'LAmax'] = 'SEL',) -> ANPNPDCurvesNPD curves for an aircraft, operation and noise metric.
Parameters
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
metric |
"SEL" (default) or "LAmax". |
Returns: An ANPNPDCurves.
Raises
| Exception | When |
|---|---|
| KeyError | If the aircraft has no NPD data for the request. |
| ValueError | If the metric or operation is unknown. |
| TypeError | if operation or metric is not a text. |
ANPDatabase.performance_aircraft()
Section titled “ANPDatabase.performance_aircraft()”ANPDatabase.performance_aircraft(aircraft_id: str) -> PerformanceAircraftThe 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
Returns: A PerformanceAircraft.
Raises
| Exception | When |
|---|---|
| KeyError | If the aircraft is not in the database. |
| ValueError | If the export carries no performance tables at all, which is the case for an NPD-only export. |
ANPDatabase.procedural_profile()
Section titled “ANPDatabase.procedural_profile()”ANPDatabase.procedural_profile( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], *, aerodrome: Aerodrome, stage_length: int | str = 1, profile_id: str | None = None, weight_lb: float | None = None,) -> ANPProfileA 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.
Parameters
| Name | Description |
|---|---|
operation |
One of "departure", "D", "arrival" or "A". |
Returns: An ANPProfile.
Raises
| Exception | When |
|---|---|
| ValueError | for an operation other than the four listed (the spelling as written), and as flight_profile does. |
| TypeError | if operation is not a text. |
ANPDatabase.procedural_steps()
Section titled “ANPDatabase.procedural_steps()”ANPDatabase.procedural_steps( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
stage_length |
ANP stage length (default 1), departures only. |
profile_id |
Optional ANP profile identifier; None (default) selects "DEFAULT" when present, or the single available one. |
Returns: The steps, in order.
Raises
| Exception | When |
|---|---|
| KeyError | If the aircraft has no procedural-step profile for the request, or profile_id is not among the available ones. |
| ValueError | If profile_id is None and several profiles exist with none of them named "DEFAULT", or for an operation other than the four listed. |
| TypeError | if operation is not a text. |
ANPDatabase.profile()
Section titled “ANPDatabase.profile()”ANPDatabase.profile( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], stage_length: int | str = 1, *, profile_id: str | None = None,) -> ANPProfileFixed-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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
stage_length |
ANP stage length (default 1). |
profile_id |
Optional ANP profile identifier (e.g. "DEFAULT", "3000LB"); None (default) selects as described above. |
Returns: An ANPProfile (a Doc 29 flight path with ground-roll masks).
Raises
| Exception | When |
|---|---|
| KeyError | If the aircraft is unknown, has no fixed-point profile for the request, or profile_id is not among the available ones. |
| ValueError | If profile_id is None and several profiles exist with none of them named "DEFAULT". |
| TypeError | if operation is not a text. |
ANPDatabase.revised_npd_curves()
Section titled “ANPDatabase.revised_npd_curves()”ANPDatabase.revised_npd_curves( aircraft_id: str, operation: Literal['departure', 'D', 'arrival', 'A'], metric: Literal['SEL', 'LAmax'] = 'SEL', *, temperature_c: float, relative_humidity_percent: float, static_pressure_kpa: float = 101.325, absorption: Literal['arp5534', 'arp866a'] = 'arp5534',) -> RevisedNPDCurvesNPD 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"departure"/"D" or "arrival"/"A". |
metric |
"SEL" (default) or "LAmax". |
temperature_c |
Air temperature, in degrees Celsius. |
relative_humidity_percent |
Relative humidity, in percent. |
static_pressure_kpa |
Air pressure, in kPa (default 101.325). |
absorption |
"arp5534" (default) or "arp866a". |
Returns: A RevisedNPDCurves.
Raises
| Exception | When |
|---|---|
| KeyError | if the aircraft, its NPD data or its spectral class is missing. |
| ValueError | for an unknown metric, operation or absorption route. |
| TypeError | if operation, absorption or metric is not a text. |
ANPDatabase.spectral_class()
Section titled “ANPDatabase.spectral_class()”ANPDatabase.spectral_class(class_id: int | str) -> SpectralClassOne spectral class of the database (ECAC Doc 29 Vol. 2 G4.3).
Parameters
| Name | Description |
|---|---|
class_id |
Spectral class identifier, as a number or as the table writes it (103 or "103"). |
Returns: A SpectralClass.
Raises
| Exception | When |
|---|---|
| KeyError | if the export carries no such class, or no spectral-class table at all. |
ANPDatabase.spectral_class_ids
Section titled “ANPDatabase.spectral_class_ids”property
Sorted list of the spectral class identifiers in the database.
ANPNPDCurves
Section titled “ANPNPDCurves”ANPNPDCurves( *, aircraft_id: str, npd_id: str, metric: Literal['SEL', 'LAmax'], operation: Literal['A', 'D'], power_parameter: str, powers: NumericArrayLike, distances_m: NumericArrayLike, levels: NumericArrayLike,)ANP Noise-Power-Distance curves for one aircraft, metric and operation.
Attributes
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
npd_id |
ANP noise identifier (shared by aircraft with the same NPD set). |
metric |
"SEL" or "LAmax". |
operation |
"A" (arrival) or "D" (departure). |
power_parameter |
Name/unit of the power setting (e.g. corrected net thrust). |
powers |
Tabulated engine power settings (1-D, strictly increasing). |
distances_m |
Tabulated slant distances, in metres (1-D, strictly increasing). |
levels |
Tabulated event levels, shape (len(powers), len(distances)), in dB. |
The powers, distances_m and levels arrays are read-only views shared
with the parent database; copy them before mutating.
ANPNPDCurves.level()
Section titled “ANPNPDCurves.level()”ANPNPDCurves.level( power: float, distance_m: float | np.floating[Any] | np.integer[Any],) -> float
ANPNPDCurves.level( power: float, distance_m: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],) -> NDArray[np.float64]
ANPNPDCurves.level( power: float, distance_m: NumericArrayLike,) -> float | NDArray[np.float64]Interpolated NPD level L(P, d) (Doc 29 Eq. 4-3/4-4).
Parameters
| Name | Description |
|---|---|
power |
Query engine power setting. |
distance_m |
Query slant distance(s), in metres. |
Returns: The interpolated level per query distance, in dB. A float for a number, an array for a sequence or an array, a zero-dimensional one included.
ANPNPDCurves.plot()
Section titled “ANPNPDCurves.plot()”ANPNPDCurves.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot the NPD curve at each tabulated power versus slant distance.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |
ANPProfile
Section titled “ANPProfile”ANPProfile( aircraft_id: str, operation: Literal['A', 'D'], 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
| Name | Description |
|---|---|
aircraft_id |
ANP aircraft identifier. |
operation |
"A" (arrival) or "D" (departure). |
profile_id |
ANP profile label (usually "DEFAULT"). |
stage_length |
ANP stage length (trip-distance/weight bin). Usually one of the numbered bins, but the database’s own column also carries "M" for a maximum-weight procedure, so the label is kept as it is read. |
path |
Flight-path points, shape (N, 5): x, y, z (m, along-track, lateral, altitude), engine power setting and true airspeed (m/s). |
ground_roll |
Boolean mask (length N-1) of takeoff ground-roll segments. |
landing_roll |
Boolean mask (length N-1) of landing rollout segments. |
path is a read-only view shared with the parent database; copy it before
mutating.
ANPProfile.plot()
Section titled “ANPProfile.plot()”ANPProfile.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot the trajectory altitude versus along-track distance.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |
load_anp_database
Section titled “load_anp_database”load_anp_database(path: str | os.PathLike[str] | None = None) -> ANPDatabaseLoad an EASA ANP database (aircraft, NPD curves and default profiles).
Parameters
| Name | Description |
|---|---|
path |
Directory of an ANP CSV export (the *Aircraft.csv, *NPD_data.csv, *fixed_point_profiles.csv tables, plus the optional performance tables the procedural-step model reads: *engine_coefficients.csv, *Aerodynamic_coefficients.csv, *weights.csv and the two *procedural_steps.csv, and the *Spectral_classes.csv table ECAC Doc 29 Vol. 2 Appendix D reads to recalculate the NPD curves for another atmosphere). If None (default), loads the full EASA ANP database v2.3 shipped with the package (see aircraft/data/anp/PROVENANCE.md). Every table is read from a regular file of at most 32 MiB (the copy shipped with a package run from inside a zip archive is read as the archive holds it), and every number in it is a finite one. |
Returns: An ANPDatabase.
Raises
| Exception | When |
|---|---|
| FileNotFoundError | If a required table is missing, or the file of a table the export carries is gone when it is read (a link to nothing). |
| NotADirectoryError | If path is not a directory. |
| ValueError | If two files match one table, a table is a named pipe, a device, a socket or a directory rather than a regular file (refused before it is opened), holds more than 32 MiB or is not UTF-8 text, a cell that holds a number is not a finite one (nan, inf, 1e999) or no number at all, or a count (a stage length, a point or step number, a number of engines) is not a whole one, naming the table, the line and the column. |
SpectralClass
Section titled “SpectralClass”SpectralClass( *, class_id: str, operation: Literal['A', 'D'], description: str, frequencies: NDArray[np.float64], levels: 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
| Name | Description |
|---|---|
class_id |
Spectral class identifier ("103", "205"…). |
operation |
"A" (approach) or "D" (departure). |
description |
The aircraft family the class describes. |
frequencies |
Nominal one-third-octave-band centre frequencies, in Hz, from 50 Hz to 10 kHz. |
levels |
Band levels at 1 000 ft, in dB. |
SpectralClass.plot()
Section titled “SpectralClass.plot()”SpectralClass.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot the band levels versus frequency.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |