aircraft.certification
Aircraft noise certification: Effective Perceived Noise Level (ICAO Annex 16).
The EPNL is the noise-certification metric for transport-category aircraft. It is built from a half-second spectral time history (24 one-third-octave bands, 50 Hz-10 kHz) in five steps, implementing ICAO Annex 16 Vol. I, Appendix 2 (the analytic formulation):
perceived_noisiness: per-band perceived noisinessn(noys), the analytic piecewise noy law with the Table A2-3 constants.perceived_noise_level: from the total noisiness .tone_correction: the tone-correction factorC(the slope / “encircling” method) that penalises spectral irregularities.effective_perceived_noise_level: the end-to-end metric, from the per-record , the maximumPNLTM, the 10 dB-down integration limits and the duration correction, giving .
Auto-generated from the source docstrings by
scripts/generate_api_docs.py(make api-docs). Do not edit by hand.
effective_perceived_noise_level
Section titled “effective_perceived_noise_level”effective_perceived_noise_level( spectra: NumericArrayLike, dt: NumericArrayLike = 0.5, *, reference_time: float = 10.0, procedure: Literal['airplane', 'helicopter'] = 'airplane',) -> EPNLResultEffective Perceived Noise Level from a spectral time history (ICAO Annex 16).
Each record (row) is a 24-band one-third-octave spectrum sampled every
dt seconds. The per-record PNL and tone correction C give
; the maximum PNLTM and the
duration correction over
the 10 dB-down window give .
Parameters
| Name | Description |
|---|---|
spectra |
Spectral time history, shape (K, 24), in dB. |
dt |
Per-record duration, in s (scalar or per record, default 0.5). |
reference_time |
Normalising time T0, in s (default 10). |
procedure |
Tone-correction procedure of App. 2 §4.3.1 Step 1: "airplane" (default) starts the slope analysis at the 80 Hz band (band 3), "helicopter" (helicopters and tilt-rotors) at the 50 Hz band (band 1), so rotor tones in the 50-80 Hz bands are not missed. |
Returns: An EPNLResult.
Raises
| Exception | When |
|---|---|
| ValueError | If the input is not a (K, 24) finite array, or procedure is not "airplane" or "helicopter". |
| TypeError | if procedure is not a text, or dt or spectra holds a text or a value that is not a real number. |
epnl_from_pnlt
Section titled “epnl_from_pnlt”epnl_from_pnlt( pnlt: NumericArrayLike, dt: NumericArrayLike = 0.5, *, reference_time: float = 10.0, tone_corrections: NumericArrayLike | None = None,) -> EPNLIntegrationEPNL from a tone-corrected perceived-noise-level time history (App. 2 §4.5-4.6).
with the
10 dB-down integration limits about the maximum PNLTM. The exact
form is used rather than the Annex’s rounded
constant 13 for
uniform 0.5 s records (difference 0.0103 dB); the ETM Table 4-4 integrated
reference reproduces the exact form to five decimals.
When tone_corrections is given, the bandsharing adjustment ΔB
(App. 2 §4.4.2/4.4.3, ETM GM/AMC A2 4.4.2) is applied: if the tone
correction at the PNLTM record is below the average of the records within
one second of it (five records for the uniform 0.5 s cadence), ΔB is
that shortfall, added to PNLTM before the 10 dB-down window is found and
included in the reported EPNL.
Parameters
| Name | Description |
|---|---|
pnlt |
The tone-corrected perceived noise levels PNLT(k), in TPNdB. |
dt |
Per-record duration, in s (scalar broadcast or per record). |
reference_time |
Normalising time T0, in s (default 10). |
tone_corrections |
Optional tone corrections C(k), in dB, one per pnlt record; enables the bandsharing adjustment ΔB described above. Default None (no adjustment). |
Returns: An EPNLIntegration: .epnl in EPNdB, the peak .pnltm, the .bandsharing_adjustment and the 0-based 10 dB-down record indices .band_limits (inclusive), with the duration correction as .duration_correction.
Raises
| Exception | When |
|---|---|
| ValueError | If the inputs are invalid. |
| TypeError | if reference_time is not a single number, or dt, pnlt or tone_corrections holds a text or a value that is not a real number. |
EPNLIntegration
Section titled “EPNLIntegration”EPNLIntegration( epnl: float, pnltm: float, bandsharing_adjustment: float, band_limits: tuple[int, int],)The integration of a PNLT history into EPNL (ICAO Annex 16 App. 2 §4.5-4.6).
What epnl_from_pnlt returns: the integral and the window it was
taken over, named, where a (epnl, pnltm, kF, kL) tuple used to be
unpacked by position. EPNLResult carries the same four numbers
beside the record histories they were integrated from.
Attributes
| Name | Description |
|---|---|
epnl |
Effective perceived noise level, in EPNdB, including the bandsharing adjustment. |
pnltm |
Maximum tone-corrected perceived noise level, in TPNdB, including the bandsharing adjustment ΔB (App. 2 §4.4.2), the adjusted value §4.4.3 requires for EPNL. |
bandsharing_adjustment |
The bandsharing adjustment ΔB, in TPNdB, the unit the Nomenclature prints for it (I-7), since it is added to the maximum PNLT (App. 2 §4.4.2; zero unless the tone correction at PNLTM is suppressed). |
band_limits |
The 0-based 10 dB-down record indices (kF, kL), both inclusive. |
EPNLIntegration.duration_correction
Section titled “EPNLIntegration.duration_correction”property
Duration correction , in dB.
EPNLResult
Section titled “EPNLResult”EPNLResult( frequencies: NDArray[np.float64], times: NDArray[np.float64], pnl: NDArray[np.float64], tone_correction: NDArray[np.float64], pnlt: NDArray[np.float64], pnltm: float, bandsharing_adjustment: float, duration_correction: float, epnl: float, band_limits: tuple[int, int],)Effective Perceived Noise Level of an aircraft flyover (ICAO Annex 16).
Attributes
| Name | Description |
|---|---|
frequencies |
The 24 one-third-octave band centre frequencies, in Hz. |
times |
Record times, in s. |
pnl |
Perceived noise level per record, in PNdB. |
tone_correction |
Tone-correction factor per record, in dB. |
pnlt |
Tone-corrected perceived noise level per record, in TPNdB. |
pnltm |
Maximum tone-corrected perceived noise level, in TPNdB, including the bandsharing adjustment ΔB (App. 2 §4.4.2), the adjusted value §4.4.3 requires for EPNL. |
bandsharing_adjustment |
The bandsharing adjustment ΔB, in TPNdB, the unit the Nomenclature prints for it (I-7), since it is added to the maximum PNLT (App. 2 §4.4.2; zero unless the tone correction at PNLTM is suppressed). |
duration_correction |
Duration correction , in dB. |
epnl |
Effective perceived noise level, in EPNdB. |
band_limits |
The 0-based 10 dB-down record indices (kF, kL). |
EPNLResult.plot()
Section titled “EPNLResult.plot()”EPNLResult.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot the PNL and PNLT time histories with PNLTM and the 10 dB-down band.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |
EPNLResult.report()
Section titled “EPNLResult.report()”EPNLResult.report( path: str | os.PathLike[str], *, metadata: ReportMetadata | None = None, engine: Literal['reportlab'] = 'reportlab', verbose: bool = False, language: Literal['en', 'es'] = 'en',) -> strRender an ICAO Annex 16 EPNL certification fiche to a PDF.
Writes a one-page aircraft-noise-certification data sheet: the
standard-basis line (ICAO Annex 16 Vol. I Appendix 2), an optional
TCDSN-style metadata header (aircraft, manufacturer / type-certificate
holder, applicant, measurement point), a metrics table of the
informational intermediate quantities (PNLTM, the duration correction
D, the 10 dB-down record window and, when non-zero, the bandsharing
adjustment), the result’s own landscape PNLT-versus-time plot,
the boxed EPNL = X EPNdB result, a Level | Limit | Margin verdict
row when a certification limit is supplied, a static reference-conditions
strip and a footer with the fixed disclaimer.
Parameters
| Name | Description |
|---|---|
path |
Destination path of the PDF file. |
metadata |
Optional ReportMetadata; None produces a prediction fiche (metrics, plot and result only, no verdict). A supplied requirement is read as the certification EPNL limit in EPNdB (the EPNL passes at or below it). |
engine |
Rendering back end; only "reportlab" is supported. |
verbose |
Accepted for a uniform signature; it has no effect on the single-layout EPNL fiche. |
language |
Fiche language: "en" (default, English) or "es" (Spanish, with a comma decimal separator). |
Returns: The written path as a str.
Raises
| Exception | When |
|---|---|
| ValueError | If engine is not "reportlab". |
| ImportError | If reportlab is not installed (the [report] extra), or matplotlib is missing for the embedded figure (the [plot] extra). |
NOY_BANDS_HZ
Section titled “NOY_BANDS_HZ”Constant (numpy.ndarray, shape (24,)).
perceived_noise_level
Section titled “perceived_noise_level”perceived_noise_level(spl: NumericArrayLike) -> floatPerceived noise level PNL (ICAO Annex 16 App. 2 §4.2), in PNdB.
and . If the total noisiness is not positive the PNL is defined as 0.
Parameters
| Name | Description |
|---|---|
spl |
The 24 one-third-octave-band sound pressure levels, in dB. |
Returns: The perceived noise level, in PNdB.
Raises
| Exception | When |
|---|---|
| ValueError | If the spectrum is not 24 finite levels. |
perceived_noisiness
Section titled “perceived_noisiness”perceived_noisiness(spl: NumericArrayLike) -> NDArray[np.float64]Per-band perceived noisiness n in noys (ICAO Annex 16 App. 2 §4.7).
The analytic piecewise noy law, using the Table A2-3 constants:
- :
- :
- :
- :
- : (below the noy floor)
Parameters
| Name | Description |
|---|---|
spl |
The 24 one-third-octave-band sound pressure levels, in dB. |
Returns: The per-band perceived noisiness, in noys.
Raises
| Exception | When |
|---|---|
| ValueError | If the spectrum is not 24 finite levels. |
| TypeError | if spl holds a text or a value that is not a real number. |
tone_correction
Section titled “tone_correction”tone_correction( spl: NumericArrayLike, *, start_band: int | np.integer[Any] = 2,) -> floatTone-correction factor C for a spectrum (ICAO Annex 16 App. 2 §4.3).
The maximum over bands of the tone-correction factor derived from the tone
excess F above the smoothed background, with the 1.5 dB threshold, the
500 Hz / 5000 Hz frequency split and the 6⅔ dB cap of Table A2-2.
Parameters
| Name | Description |
|---|---|
spl |
The 24 one-third-octave-band sound pressure levels, in dB. |
start_band |
First band index of the slope analysis (App. 2 §4.3.1 Step 1). The default 2 (80 Hz) is the aeroplane procedure; helicopters and tilt-rotors use 0 (50 Hz). |
Returns: The tone-correction factor C, in dB (0 if no tones qualify).
Raises
| Exception | When |
|---|---|
| TypeError | If start_band is not a number, or spl holds a text or a value that is not a real number. |
| ValueError | If the spectrum is not 24 finite levels, or start_band is not an integer between 0 and 3. |