# phonometry: standards-conformant acoustic measurement for Python

> One page of the phonometry documentation, as Markdown. Index: https://docs.jmrp.io/phonometry/llms.txt

Canonical: https://docs.jmrp.io/phonometry/
Language: en
Alternate: https://docs.jmrp.io/phonometry/es/index.md
Version: phonometry 4.0.0
Install: pip install "phonometry[full]"
Unreleased: this page changed after phonometry 4.0.0, the latest release on PyPI, so it may describe code that release does not have yet; what is new since then is listed under Unreleased in https://github.com/jmrplens/phonometry/blob/main/CHANGELOG.md#unreleased
Author: José Manuel Requena Plens (https://orcid.org/0000-0003-1250-6212)
Published: 2026-07-05
Updated: 2026-11-18T11:51:28Z
License: MIT (https://github.com/jmrplens/phonometry/blob/main/LICENSE)
Summary: Acoustic measurement toolkit for Python: 1899 conformance checks against 230 normative designations and 121 further published sources.

---

Acoustic measurement, analysis and prediction in Python. Every metric is implemented from the text of its standard, and CI checks it against that standard's own tolerance tables and worked examples on every pull request.

- [Install and first analysis](https://docs.jmrp.io/phonometry/start/getting-started/)
- [What do you need to measure?](https://docs.jmrp.io/phonometry/start/tasks/)
- [Conformance report](https://docs.jmrp.io/phonometry/reference/conformance/)
- [View on GitHub](https://github.com/jmrplens/phonometry)

**The library in four numbers**

- **1899** [conformance checks passing](https://docs.jmrp.io/phonometry/reference/conformance/)
- **230** [normative designations and 121 further published sources, across 111 test domains](https://docs.jmrp.io/phonometry/reference/conformance/)
- **1992** [published catalogue rows, each naming the source it came from](https://docs.jmrp.io/phonometry/reference/catalogues/)
- **77** [PDF fiches in the reporting format their standard defines](https://docs.jmrp.io/phonometry/reference/reports/)

## What this is

phonometry (published as PyOctaveBand until 3.0.0) is a Python library for acoustic measurement, analysis and prediction. You give it a signal, a measured spectrum or a set of geometrical and material inputs; it gives you the quantity the standard defines, with the intermediate terms still visible.

Every result is a typed, frozen dataclass. It carries the inputs it was computed from, it draws its own figure with a one-line `.plot()` in English or Spanish, and where a standard defines a reporting format it renders a one-page PDF fiche with `.report()`.

It is written and maintained by one person, published under the MIT licence on [PyPI](https://pypi.org/project/phonometry/), archived with a [DOI on Zenodo](https://doi.org/10.5281/zenodo.21215280), and currently at version 4.0.0. It needs Python 3.12 or newer with NumPy and SciPy. Optional extras add the rest: `[plot]` for the figures, `[perf]` for the faster impulse ballistics, `[report]` for the PDF fiches, `[audio]` for the audio formats beyond uncompressed WAV, `[full]` for all four, and `[torch]`, outside `[full]`, for running the FDTD simulations on PyTorch.

### Who it is for

- Consultants and test laboratories who need the number a standard defines and the terms behind it, in a form that can go into a report.
- Researchers who need a readable, citable reference implementation rather than a black box, and who need to see which clause each formula came from.
- Audio, firmware and product engineers who need class 1 weighting and filters, distortion, loudness and speech metrics inside their own test rigs.
- Students and teachers, since every guide states the standard, the formula and the assumptions before the code.

### What it is not

- Not a certified instrument. The conformance report is the library checking its own output against values published in the standards, not an accredited third-party calibration. Legal measurements still need type-approved hardware.
- Not a data-acquisition system. It processes arrays and files you supply; it does not talk to sound cards, microphones or analysers.
- Not a complete implementation of every standard it cites. Each guide states which clauses, methods and annexes are covered, and which are not.

## What it looks like in use

Three things the library does that are hard to claim and easy to show: it computes wave fields and renders them, the result of an analysis draws itself, and where a standard prescribes a reporting layout, the same result renders that layout as a PDF.

**Video:** [A wavefront through a hall of columns (2D FDTD)](https://docs.jmrp.io/phonometry/media/anim_fdtd_pillar_hall.webm): An 800 Hz plane wavefront sweeps a 4 m rigid-walled hall filled with a staggered colonnade of rigid columns 10 to 17 cm across, simulated at 2.5 mm; every column diffracts the front and sheds a scattered wavelet, and the wavelets interfere until the whole hall is filled with structured energy that then drains through the absorbing ends.

An 800 Hz front through a hall of rigid columns, 2D FDTD at 2.5 mm: every column diffracts the front until the scattered wavelets fill the hall.

### An analysis, and the figure it draws

One-third-octave band levels per the IEC 61260-1 band edges, and the power spectral density of the same record, which is a result object, so one call draws it. The figure below is committed to the documentation, not a mock-up; it is drawn from a six-tone signal rather than the two-tone one in the snippet, so that the band structure is worth looking at.

```python
import numpy as np
from phonometry import filters, signals

fs = 48_000
t = np.linspace(0, 1, fs, endpoint=False)
signal = np.sin(2 * np.pi * 100 * t) + np.sin(2 * np.pi * 1000 * t)

bands = filters.octave_filter(signal, fs=fs, fraction=3)

psd = signals.power_spectral_density(signal, fs=fs)
ax = psd.plot()          # the result draws itself
```

![One-third-octave spectrum of a six-tone signal, with the raw power spectral density in the background](https://docs.jmrp.io/phonometry/media/signal_response_fraction_3.svg)

From the Getting Started guide: 33 bands from 12.6 Hz to 20 kHz, with tones at 20, 100, 500, 2000, 4000 and 15 000 Hz standing out of the spectrum behind them.

### A rating, and the fiche it renders

The weighted airborne rating of ISO 717-1 over the 16 one-third-octave bands the rating uses, rendered in a laboratory report layout: metadata header, band table, the curve against the shifted reference, the boxed single-number result and the verdict against the requirement. The code is the call that renders the fiche beside it, with the metadata block cut to the fields discussed here. Reading the result: Rw is the value of the standard reference curve, at 500 Hz, after it has been shifted as far towards the measured curve as the unfavourable-deviation rule allows (their sum may reach 32.0 dB and here stops at 23.7 dB), so one number stands in for sixteen. The terms in brackets are the spectrum adaptation terms C and Ctr, which are added to Rw rather than replacing it and say how the same element performs against a pink-noise-like source and against urban road traffic: 30 and 28 dB for this pane. The verdict is a pass because the requirement was written against Rw alone; written against Rw + Ctr, as national codes for facades often are, the same pane would fail it.

```python
import numpy as np
from phonometry import building, ReportMetadata

freqs = np.array([100, 125, 160, 200, 250, 315,
                  400, 500, 630, 800, 1000, 1250,
                  1600, 2000, 2500, 3150])

R = building.single_panel_transmission_loss(
    freqs, mass_per_area=15.0,
    critical_frequency=2000.0, loss_factor=0.02,
)

meta = ReportMetadata(
    specimen="6 mm float glass pane",
    laboratory="Phonometry reference example",
    report_id="EXAMPLE-717-1",
    requirement=30.0,  # adds the verdict row
)

R.report("Rw_fiche.pdf", metadata=meta)
```

**Report:** [Airborne ISO 717-1 example report (PDF)](https://docs.jmrp.io/phonometry/media/iso717_airborne_example.pdf): One-page airborne sound insulation fiche for a 6 mm float glass pane: a metadata header, the one-third-octave R table beside the plot of that curve against the shifted reference, the boxed result Rw (C; Ctr) = 31 (-1; -3) dB and a PASS verdict against the 30 dB requirement.

Airborne rating fiche (SoundReductionResult.report), Rw (C; Ctr).

## What it covers

Thirteen documentation areas over twenty-one import namespaces; in all, 168 guides and 268 API reference pages. Each row links to the area overview; the designations are the standards actually implemented there, not a reading list.

| Area | Standards implemented |
| --- | --- |
| [Signal analysis](https://docs.jmrp.io/phonometry/signals/): Filter banks, weighting, levels, spectra, calibration and uncertainty. | IEC 61260-1, ANSI S1.11, IEC 61672-1, ISO 7196, IEC 61252, ISO 1996-1, IEC 60942, GUM |
| [Fluids](https://docs.jmrp.io/phonometry/fluids/): The fluid a sound travels through, computed from the measured conditions: humid air, sea water and ideal gases, each with the model behind it. | IEC 61094-2 Annex F |
| [Elastic solids](https://docs.jmrp.io/phonometry/solids/): The elastic constants of a solid and the three longitudinal wave speeds that follow from them, with the conversions between the forms a table prints. | no governing standard |
| [Files](https://docs.jmrp.io/phonometry/io/): Measurement audio in and out: calibrated reading, provenance, streaming, BWF writing, lossless conversion; catalogues of materials of your own. | EBU Tech 3285, ITU-R BS.2088 |
| [Hearing and perception](https://docs.jmrp.io/phonometry/perception/): Loudness, sound quality, speech intelligibility, hearing and exposure. | ISO 532-1/-2/-3, ECMA-418-1/-2, ISO 226, DIN 45692, IEC 60268-16, ANSI S3.5, DIN 45681, ISO/PAS 20065, ISO 7029, ISO 389-7, ISO 8253-1/-2, ISO 1999, ISO 9612, ISO 4869-1/-2/-3/-6 |
| [Rooms and buildings](https://docs.jmrp.io/phonometry/buildings/): Room parameters, background noise, field and laboratory insulation, prediction. | ISO 3382-1/-2/-3, ISO 16283-1/-2/-3, ISO 10140, ISO 10848, ISO 15186-1/-2, ISO 16251-1, ISO 717-1/-2, EN 12354-1…-6, ISO 18233, ISO 12999-1, ISO 10052, ISO 16032, ANSI/ASA S12.2, ASTM E413 |
| [Materials and surfaces](https://docs.jmrp.io/phonometry/materials/): Absorption, airflow resistance, impedance tube, porous and metamaterial models, diffusers, scattering. | ISO 354, ISO 11654, ISO 10534-1/-2, ISO 9053-1/-2, ISO 17497-1/-2, ISO 13472-1/-2, EN 29052-1, ISO 12999-2 |
| [Vibration and structure-borne sound](https://docs.jmrp.io/phonometry/vibration/): Mobility and FRFs, isolators, radiated power, junctions, human vibration. | ISO 7626-1/-2/-5, ISO 10846-1/-2/-3/-4/-5, ISO 9611, ISO/TS 7849-1/-2, EN 15657, EN 12354-5, ISO 2631-1/-2/-4/-5, ISO 5349-1/-2, ISO 8041-1/-2 |
| [Environment and transport](https://docs.jmrp.io/phonometry/environment/): Outdoor propagation, barriers, refraction, environmental indicators, traffic and wind-turbine sources. Of CNOSSOS-EU, the source side of Annex II: the propagation method of its section 2.5 is not implemented, and outdoor attenuation here goes through ISO 9613-2 instead. | ISO 9613-1/-2, ISO 1996-1/-2, ISO/PAS 1996-3, NT ACOU 112, CNOSSOS-EU (2002/49/EC Annex II, 2.2 and 2.3), IEC 61400-11 |
| [Aircraft noise](https://docs.jmrp.io/phonometry/aircraft/): Certification levels, airport contours and the rotorcraft hemisphere method. | ICAO Annex 16, IEC 61265, SAE ARP 866A/5534, ECAC Doc 29, ECAC Doc 32 |
| [Underwater acoustics](https://docs.jmrp.io/phonometry/underwater/): Levels re 1 µPa, ship radiated noise, pile driving, ambient noise, propagation loss. | ISO 18405, ISO 17208-1/-2, ISO 18406, JOMOPANS-ECHO |
| [Sources and devices](https://docs.jmrp.io/phonometry/devices/): Sound power, intensity, emission declarations, electroacoustics, programme loudness. | ISO 3741, ISO 3744/3746, ISO 3745, ISO 9614-1/-2/-3, IEC 61043, ISO 4871, IEC 60268-3/-4/-5, ITU-R BS.1770-5, EBU R 128 |
| [Wave simulation](https://docs.jmrp.io/phonometry/simulation/): Deterministic 2D FDTD solvers, acoustic and elastic P-SV, validated against analytic oracles rather than a standard. | no governing standard |

## Starting from zero

Three steps, in order. The first two take a few minutes; the third is the part you keep coming back to.

1. **Install it.** Python 3.12 or newer. The base install pulls in NumPy and SciPy; the [full] extra adds four more, [plot] for the figures, [perf] for the faster impulse ballistics, [report] for the PDF fiches and [audio] for the audio formats beyond uncompressed WAV. [torch], which [full] leaves out, runs the FDTD simulations on PyTorch. On 32-bit Windows and 32-bit Linux, which [full] does not support, [plot,report,audio] installs the other three. If phonometry 3.x is already installed, upgrade it with pip install -U phonometry and the extras you use: 3.x has a different import layout, and from phonometry import filters fails on it.

   ```bash
   pip install "phonometry[full]"
   ```

   [Installation options](https://docs.jmrp.io/phonometry/start/getting-started/)
2. **Run one analysis end to end.** Getting Started splits a signal into one-third-octave bands, then anchors those bands to a calibrator tone so the levels are decibels re 20 µPa rather than decibels re nothing, and reduces them to one A-weighted level. Build a sound level meter carries the same chain to the end: the Fast ballistics, LAeq, SEL, LCpeak, the percentile levels and the class check of every stage.

   [Getting Started](https://docs.jmrp.io/phonometry/start/getting-started/) · [Build a sound level meter](https://docs.jmrp.io/phonometry/signals/sound-level-meter/)
3. **Go to the page for your job.** What do you need to measure? is the same library indexed by the task instead of the subject: a job on the left, the guide that answers it and the standard it implements on the right. All guides is the full inventory, 168 of them grouped by topic. Each one opens with the standard it implements, the quantities that standard defines and the assumptions the implementation makes, then the runnable code and the figure it draws, and closes with a Covered / Not covered statement, so you know before you start what the page will and will not answer. When you need an exact signature rather than a method, the API reference has one page per module.

   [What do you need to measure?](https://docs.jmrp.io/phonometry/start/tasks/) · [All guides](https://docs.jmrp.io/phonometry/start/guides/)

For language models: [llms.txt](https://docs.jmrp.io/phonometry/llms.txt), the index of every page of this documentation as Markdown.
