API Reference

The complete public API, one page per module. Import the domain subpackage and call through it:

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

from phonometry import metrology, underwater

spl, freq = metrology.octave_filter(x, fs)
snr = underwater.passive_sonar_equation(185.0, 60.0, 50.0)

Every documented name can also be imported directly from the top-level package (from phonometry import leq).

Filters and frequencies

Module	Summary
`phonometry`	Package-level names defined in `phonometry/__init__.py` itself.
`metrology.core`	Core processing logic and FilterBank class for phonometry.
`metrology.parametric_filters`	Weighting filters (A, B, C, D, G, AU, Z) and time weighting utilities.
`metrology.equalizer`	Parametric equalizer biquads per the RBJ Audio EQ Cookbook.
`metrology.frequencies`	Frequency calculation logic according to ANSI/IEC standards.
`metrology.compliance`	IEC 61260-1:2014 filter and IEC 61672-1:2013 weighting class verification.

Levels and calibration

Module	Summary
`metrology.levels`	Integrated and statistical sound levels (Leq, LAeq, LN percentiles).
`metrology.calibration`	Calibration utilities for mapping digital signals to physical SPL levels.

Psychoacoustics

Module	Summary
`psychoacoustics.loudness_zwicker`	Zwicker loudness for stationary and time-varying sounds per ISO 532-1:2017.
`psychoacoustics.loudness_moore_glasberg`	Stationary loudness per ISO 532-2:2017 (Moore-Glasberg method).
`psychoacoustics.loudness_moore_glasberg_time`	Time-varying loudness per ISO 532-3:2023 (Moore-Glasberg-Schlittenlacher).
`psychoacoustics.loudness_ecma`	Psychoacoustic loudness per ECMA-418-2:2025 (4th ed., Sottek Hearing Model).
`psychoacoustics.loudness_contours`	Normal equal-loudness-level contours per ISO 226:2023.
`psychoacoustics.sharpness`	Sharpness per DIN 45692:2009-08.
`psychoacoustics.roughness_ecma`	Psychoacoustic roughness per ECMA-418-2:2025 (4th ed., Sottek Hearing Model).
`psychoacoustics.tonality`	Prominent discrete tone assessment per ECMA-418-1:2024 (3rd edition).
`psychoacoustics.tonality_ecma`	Psychoacoustic tonality per ECMA-418-2:2025 (4th ed., Sottek Hearing Model).
`psychoacoustics.tone_audibility`	Objective audibility of tones in noise — engineering method (ISO/PAS 20065:2016).
`psychoacoustics.fluctuation_strength`	Fluctuation strength after Fastl & Zwicker / Osses et al.
`psychoacoustics.fluctuation_strength_ecma`	Psychoacoustic fluctuation strength per ECMA-418-2:2025 (4th ed., Clause 9).
`psychoacoustics.psychoacoustic_annoyance`	Psychoacoustic annoyance (PA) after Fastl & Zwicker.

Speech

Module	Summary
`hearing.sti`	Speech Transmission Index (STI) per IEC 60268-16:2020 (Edition 5).
`hearing.sii`	Speech Intelligibility Index (SII) per ANSI S3.5-1997 (R2017).
`hearing.objective_intelligibility`	Short-Time Objective Intelligibility (STOI and ESTOI).

Hearing and exposure

Module	Summary
`hearing.threshold`	Age-related hearing threshold (ISO 7029:2017) and audiometric reference zero (ISO 389-7:2005).
`hearing.noise_induced_hearing_loss`	Estimation of noise-induced hearing loss (ISO 1999:2013).
`hearing.occupational_exposure`	Occupational noise exposure: measurement strategies and uncertainty (ISO 9612:2009).

Room acoustics

Module	Summary
`room.room_acoustics`	Room acoustic parameters from impulse responses per ISO 3382-1:2009 (performance spaces) and ISO 3382-2:2008 (ordinary rooms).
`room.room_ir`	Impulse-response acquisition per BS EN ISO 18233:2006.
`room.room_noise`	Room-noise rating curves per ANSI/ASA S12.2-2019.
`room.open_plan`	Open-plan-office spatial metrics per ISO 3382-3:2012.
`room.reverberation_prediction`	Reverberation-time prediction from room geometry and absorption.
`room.enclosed_space_absorption`	Sound absorption in enclosed spaces (EN 12354-6:2003).
`room.image_source`	Synthetic room impulse response by the image-source method (rectangular room).
`room.steady_field`	Steady-state sound field in a room: room constant, critical distance, level.

Building acoustics

Module	Summary
`building.insulation`	Field airborne sound insulation (ISO 16283-1:2014) and impact sound insulation (ISO 16283-2), with single-number weighted ratings and spectrum adaptation terms (ISO 717-1 airborne, ISO 717-2 impact).
`building.panel_transmission`	Predicted airborne sound reduction index of panels (Bies, Hansen & Howard 2017, Engineering Noise Control 5e, Section 7.2; Sharp 1973).
`building.aperture_transmission`	Sound transmission through slits, holes and apertures (Hopkins 2007, Sound Insulation, Section 4.3.10; Gomperts 1964; Wilson & Soroka 1965).
`building.lab_insulation`	Laboratory sound insulation of building elements (ISO 10140).
`building.survey_insulation`	Field survey method for sound insulation and service-equipment noise (ISO 10052:2021).
`building.intensity_insulation`	Sound insulation measured with sound intensity (ISO 15186).
`building.flanking_transmission`	Laboratory measurement of flanking sound transmission (ISO 10848:2006/2010).
`building.facade_prediction`	Façade sound insulation and outdoor radiation prediction (EN 12354-3/-4:2000).
`building.building_prediction`	Building acoustic performance prediction (EN 12354-1/-2:2000).
`building.building_uncertainty`	Measurement uncertainty in building acoustics (ISO 12999-1:2020).
`building.floor_covering_improvement`	Impact-sound improvement of floor coverings on a small mock-up (ISO 16251-1:2014).
`building.structure_borne_power`	Structure-borne sound power of building equipment (EN 15657:2018; ISO 9611).
`building.installed_structure_borne`	Installed structure-borne sound from service equipment (EN 12354-5:2009).

Materials and surfaces

Module	Summary
`materials.sound_absorption`	Sound absorption in a reverberation room: BS EN ISO 354:2003.
`materials.absorption_rating`	Single-number rating of sound absorption (ISO 11654:1997).
`materials.absorption_uncertainty`	Measurement uncertainty for sound absorption (ISO 12999-2:2020).
`materials.airflow_resistance`	Airflow resistance of porous materials: ISO 9053-1 and ISO 9053-2.
`materials.dynamic_stiffness`	Dynamic stiffness of resilient materials under floating floors (EN 29052-1:1992).
`materials.impedance_tube`	Impedance-tube material characterisation.
`materials.porous_absorber`	Porous-material models and multilayer absorber prediction.
`materials.slow_sound_absorber`	Slow-sound slit panels loaded with Helmholtz resonators (perfect absorbers).
`materials.scattering_diffusion`	Random-incidence scattering and directional diffusion coefficients.
`materials.diffuser_design`	Far-field polar response and diffusion coefficient predicted from a diffuser design.
`materials.road_absorption`	In-situ sound absorption of road surfaces (ISO 13472-1 / ISO 13472-2).

Vibration and structure-borne

Module	Summary
`vibration.mechanical_mobility`	Mechanical mobility and the frequency-response-function family (ISO 7626-1:2011).
`vibration.point_mobility`	Point mobilities and impedances of infinite structures (Cremer, Heckl & Petersson 2005, Chapter 5, Table 5.1).
`vibration.radiation_efficiency`	Radiation efficiency of a plate in bending (Hopkins 2007, Sound Insulation, Section 2.9; Leppington et al.
`vibration.junction_transmission`	Bending-wave transmission coefficients for rigid plate junctions (Hopkins 2007, Sound Insulation, Section 5.2.1.3; Cremer et al.
`vibration.transfer_stiffness`	Dynamic transfer stiffness of resilient elements (ISO 10846-1/-2/-3).
`vibration.human_vibration`	Human exposure to whole-body and hand-transmitted vibration.
`vibration.multiple_shock_vibration`	Whole-body vibration containing multiple shocks (ISO 2631-5:2018).

Environmental acoustics

Module	Summary
`environmental.outdoor_propagation`	Outdoor sound propagation: ISO 9613-2:1996 general method of calculation.
`environmental.ground_barriers`	Spherical-wave ground effect and advanced barrier diffraction.
`environmental.atmospheric_refraction`	Atmospheric refraction: ray tracing and the parabolic equation (PE).
`environmental.air_absorption`	Atmospheric absorption of sound: ISO 9613-1:1993.
`environmental.impulse_prominence`	Prominence of impulsive sounds and the LAeq adjustment (NT ACOU 112:2002).
`environmental.impulsive_sound`	Objective prominence of impulsive sounds and the `LAeq` adjustment (ISO/PAS 1996-3:2022).
`environmental.rating`	Environmental noise descriptors per ISO 1996-1:2016.
`environmental.measurement`	Determination of environmental-noise sound pressure levels (ISO 1996-2:2017).

Aircraft and wind energy

Module	Summary
`aircraft.aircraft_noise`	Aircraft noise certification: Effective Perceived Noise Level (ICAO Annex 16).
`aircraft.atmospheric_absorption`	One-third-octave-band atmospheric absorption for aircraft noise (SAE ARP 5534).
`aircraft.airport_noise`	Noise-Power-Distance (NPD) event-level interpolation (ECAC Doc 29).
`aircraft.anp_fleet`	EASA ANP fleet database bridge for the ECAC Doc 29 airport-noise chain.
`aircraft.rotorcraft_noise`	Rotorcraft noise by the hemisphere method (ECAC Doc 32 / NORAH2).
`environmental.wind_turbine_noise`	Wind-turbine acoustic noise (IEC 61400-11:2012+A1:2018).

Underwater acoustics

Module	Summary
`underwater.acoustics`	Underwater-acoustics reference levels (ISO 18405:2017).
`underwater.propagation`	Underwater sound propagation: transmission loss (closed-form).
`underwater.sound_speed`	Speed of sound in sea water (empirical equations).
`underwater.sonar_equation`	The sonar equation (passive and active), in decibels.
`underwater.ocean_ambient_noise`	Ocean ambient-noise spectrum levels (Wenz framework).
`underwater.seabed_reflection`	Plane-wave reflection at the seabed (fluid-fluid Rayleigh model).
`underwater.ship_radiated_noise`	Ship radiated noise and equivalent monopole source level (ISO 17208-1/-2).
`underwater.ship_traffic_noise`	Predicted source-level spectrum of shipping traffic (semi-empirical models).
`underwater.pile_driving_noise`	Radiated underwater sound from percussive pile driving (ISO 18406:2017).
`underwater.numerical_propagation`	Numerical models of underwater sound propagation (range-independent ocean).

Sound power and intensity

Module	Summary
`emission.sound_power`	Sound power level of a noise source from sound pressure measurements over an enveloping measurement surface: ISO 3744:2010 (engineering, accuracy grade 2) and ISO 3746:2010 (survey, accuracy grade 3).
`emission.sound_power_intensity`	Sound power level of a noise source by sound-intensity scanning: ISO 9614-2:1996 (engineering, grade 2; survey/control, grade 3).
`emission.sound_power_reverberation`	Sound power level of a noise source measured in a reverberation test room: ISO 3741:2010 (precision method, accuracy grade 1).
`emission.intensity`	Two-microphone (p-p) sound intensity per IEC 61043:1994 and the ISO 9614-1:1993 field indicators.
`emission.vibration_sound_power`	Airborne sound power from surface vibration (ISO/TS 7849-1/-2:2009).
`emission.declaration`	ISO 4871:1996 declaration of noise emission values of machinery and equipment.

Electroacoustics

Module	Summary
`electroacoustics.distortion`	Distortion metrics for electroacoustic equipment (IEC 60268-3 / AES17).
`electroacoustics.frequency_response`	Frequency-response and coherence estimators (Bendat & Piersol).
`electroacoustics.swept_sine`	Harmonic-distortion separation with exponential sweeps (Farina / Novak).
`electroacoustics.piston`	Radiation of a rigid circular piston set in an infinite baffle.
`electroacoustics.loudspeaker`	Rated loudspeaker characteristics (IEC 60268-5).
`electroacoustics.microphone`	Rated microphone characteristics (IEC 60268-4).

Industrial noise control

Module	Summary
`noise_control.silencers`	Reactive silencers by the four-pole (transmission-matrix) method.
`noise_control.hvac`	HVAC duct acoustics: end reflection, bends, plenums and flow-generated noise.
`noise_control.enclosures`	Insertion loss of a close or free-standing machine enclosure.

Program loudness

Module	Summary
`broadcast.program_loudness`	Programme loudness and true-peak level (ITU-R BS.1770-5, EBU R 128).

Uncertainty and data quality

Module	Summary
`metrology.uncertainty`	Measurement uncertainty by the GUM and its Monte Carlo supplement.
`metrology.random_data`	Random-data qualification: stationarity tests and Rice crossing statistics.

Spectral analysis

Module	Summary
`metrology.spectra`	Calibrated spectral-density estimation with statistical error analysis.
`metrology.miso`	Multiple and partial coherence of a multiple-input/single-output system.
`metrology.time_frequency`	Calibrated time-frequency analysis: STFT spectrogram and zoom FFT.
`metrology.signals`	Test signals and sample-rate utilities.
`metrology.phase`	Phase utilities: minimum phase, group delay and excess phase.
`metrology.cepstrum`	Cepstral analysis: real/power/complex cepstrum, liftering and echo detection.
`metrology.synchronous_average`	Time synchronous averaging (TSA) of a periodic waveform in noise.
`metrology.inversion`	Regularized spectral inversion with frequency-dependent regularization.

Wave simulation

Module	Summary
`simulation.fdtd`	2D acoustic finite-difference time-domain (FDTD) simulation.

Correlation & envelope

Module	Summary
`metrology.correlation`	Correlation analysis and time-delay estimation.
`metrology.envelope`	Envelope and instantaneous phase via the Hilbert transform.

Created and maintained byJosé Manuel Requena Plens· GitHub· PyPI· All projects