# phonometry: medición acústica conforme a norma para Python

> Una página de la documentación de phonometry, en Markdown. Índice: https://docs.jmrp.io/phonometry/llms.txt

Canonical: https://docs.jmrp.io/phonometry/es/
Language: es
Alternate: https://docs.jmrp.io/phonometry/index.md
Version: phonometry 4.0.0
Install: pip install "phonometry[full]"
Unreleased: esta página cambió después de phonometry 4.0.0, la última versión publicada en PyPI, así que puede describir código que esa versión aún no tiene; lo nuevo desde entonces figura en Unreleased en 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: Biblioteca de medición acústica en Python: 1899 comprobaciones de conformidad frente a 230 designaciones normativas y 121 fuentes publicadas adicionales.

---

Medición, análisis y predicción acústica en Python. Cada métrica se implementa a partir del texto de su norma, y se comprueba en CI frente a las tablas de tolerancia y los ejemplos resueltos de esa misma norma en cada pull request.

- [Instalar y primer análisis](https://docs.jmrp.io/phonometry/es/start/getting-started/)
- [¿Qué necesitas medir?](https://docs.jmrp.io/phonometry/es/start/tasks/)
- [Informe de conformidad](https://docs.jmrp.io/phonometry/es/reference/conformance/)
- [Ver en GitHub](https://github.com/jmrplens/phonometry)

**La biblioteca en cuatro cifras**

- **1899** [comprobaciones de conformidad superadas](https://docs.jmrp.io/phonometry/es/reference/conformance/)
- **230** designaciones normativas y 121 fuentes publicadas adicionales, sobre 111 dominios
- **1992** [filas de catálogo publicadas, cada una con la fuente de la que sale](https://docs.jmrp.io/phonometry/es/reference/catalogues/)
- **77** [fichas PDF con el formato de informe que define su norma](https://docs.jmrp.io/phonometry/es/reference/reports/)

## Qué es

phonometry (publicada como PyOctaveBand hasta la 3.0.0) es una biblioteca de Python para medición, análisis y predicción acústica. Le das una señal, un espectro medido o un conjunto de datos geométricos y de materiales, y te devuelve la magnitud que define la norma, con los términos intermedios a la vista.

Cada resultado es un dataclass tipado y congelado (`frozen`). Conserva los datos de entrada con los que se calculó, dibuja su propia figura con un `.plot()` de una línea en inglés o en español y, cuando una norma define un formato de informe, genera una ficha PDF de una página con `.report()`.

La escribe y la mantiene una sola persona, se publica con licencia MIT en [PyPI](https://pypi.org/project/phonometry/), se archiva con [DOI en Zenodo](https://doi.org/10.5281/zenodo.21215280) y va por la versión 4.0.0. Necesita Python 3.12 o posterior con NumPy y SciPy. Los extras opcionales añaden el resto: `[plot]` para las figuras, `[perf]` para acelerar la ponderación temporal de impulso, `[report]` para las fichas PDF, `[audio]` para los formatos de audio más allá del WAV sin comprimir, `[full]` para los cuatro, y `[torch]`, fuera de `[full]`, para calcular las simulaciones FDTD con PyTorch.

### Para quién es

- Consultores y laboratorios de ensayo que necesitan el número que define la norma y los términos que hay detrás, en una forma que se pueda llevar a un informe.
- Investigadores que necesitan una implementación de referencia legible y citable en lugar de una caja negra, y ver de qué apartado sale cada fórmula.
- Ingenieros de audio, firmware y producto que necesitan filtros y ponderaciones de clase 1, distorsión, sonoridad y métricas de habla dentro de sus propios bancos de ensayo.
- Estudiantes y docentes, porque cada guía enuncia la norma, la fórmula y las hipótesis antes del código.

### Qué no es

- No es un instrumento certificado. El informe de conformidad consiste en que la biblioteca comprueba su propia salida frente a valores publicados en las normas; no es una calibración acreditada por un tercero. Una medición con validez legal sigue necesitando equipo con aprobación de modelo.
- No es un sistema de adquisición de datos. Procesa los arrays y los archivos que le pases; no habla con tarjetas de sonido, micrófonos ni analizadores.
- No implementa por completo todas las normas que cita. Cada guía indica qué apartados, métodos y anexos cubre y cuáles no.

## Cómo se ve en uso

Dos cosas que hace la biblioteca, difíciles de afirmar y fáciles de enseñar: el resultado de un análisis se dibuja solo y, cuando una norma prescribe un formato de informe, ese mismo resultado lo genera en PDF.

### Un análisis y la figura que dibuja

Niveles por bandas de tercio de octava de una señal de dos tonos, con los límites de banda de IEC 61260-1 y la densidad espectral de potencia bruta al fondo. La figura de abajo es la que está publicada en la documentación, no una maqueta.

```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
```

![Espectro en tercios de octava de una señal de dos tonos, con la densidad espectral de potencia bruta al fondo](https://docs.jmrp.io/phonometry/media/signal_response_fraction_3_es.svg)

De la guía Primeros pasos: 33 bandas de 12,6 Hz a 20 kHz, con máximos en 100 Hz y 1 kHz.

### Un índice global y la ficha que genera

El índice global de aislamiento a ruido aéreo de ISO 717-1 sobre las 16 bandas de tercio de octava que usa el índice, con el formato de un informe de laboratorio: cabecera de metadatos, tabla por bandas, la curva frente a la curva de referencia desplazada, el resultado de un solo número enmarcado y el veredicto frente al requisito. El código es la llamada que genera la ficha de al lado, con el bloque de metadatos reducido a los campos de los que se habla aquí.

```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)
```

**Informe:** [Informe de ejemplo ISO 717-1 a ruido aéreo (PDF)](https://docs.jmrp.io/phonometry/media/iso717_airborne_example.pdf): Ficha de aislamiento a ruido aéreo de una página para un vidrio flotado de 6 mm: cabecera de metadatos, tabla de R en tercios de octava junto al gráfico de esa curva frente a la de referencia desplazada, el resultado Rw (C; Ctr) = 31 (-1; -3) dB enmarcado y el veredicto (PASS, en inglés como el resto de la ficha) frente al requisito de 30 dB.

Ficha del índice global a ruido aéreo (SoundReductionResult.report), Rw (C; Ctr).

## Qué abarca

Trece áreas de documentación sobre veintiún espacios de nombres de importación; en total, 168 guías y 268 páginas de referencia de la API. Cada fila enlaza al índice del área; las designaciones son las normas realmente implementadas ahí, no una lista de lecturas.

| Área | Normas implementadas |
| --- | --- |
| [Análisis de señal](https://docs.jmrp.io/phonometry/es/signals/): Bancos de filtros, ponderaciones, niveles, espectros, calibración e incertidumbre. | IEC 61260-1, ANSI S1.11, IEC 61672-1, ISO 7196, IEC 61252, ISO 1996-1, IEC 60942, GUM |
| [Fluidos](https://docs.jmrp.io/phonometry/es/fluids/): El fluido por el que viaja el sonido, calculado a partir de las condiciones medidas: aire húmedo, agua de mar y gases ideales, cada uno con el modelo que lo produce. | IEC 61094-2 Anexo F |
| [Sólidos elásticos](https://docs.jmrp.io/phonometry/es/solids/): Las constantes elásticas de un sólido y las tres velocidades longitudinales que se siguen de ellas, con las conversiones entre las formas que imprime una tabla. | sin norma que la rija |
| [Archivos](https://docs.jmrp.io/phonometry/es/io/): Audio de medición de entrada y salida: lectura calibrada, procedencia, flujo por bloques, escritura BWF, conversión sin pérdidas; catálogos de materiales propios. | EBU Tech 3285, ITU-R BS.2088 |
| [Audición y percepción](https://docs.jmrp.io/phonometry/es/perception/): Sonoridad, calidad sonora, inteligibilidad del habla, audición y exposición. | 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 |
| [Salas y edificación](https://docs.jmrp.io/phonometry/es/buildings/): Parámetros de sala, ruido de fondo, aislamiento en campo y laboratorio, predicción. | 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 |
| [Materiales y superficies](https://docs.jmrp.io/phonometry/es/materials/): Absorción, resistencia al flujo de aire, tubo de impedancia, modelos porosos y de metamaterial, difusores, dispersión. | 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 |
| [Vibración y ruido estructural](https://docs.jmrp.io/phonometry/es/vibration/): Movilidad y FRF, aisladores, potencia radiada, uniones, vibración en humanos. | 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 |
| [Medio ambiente y transporte](https://docs.jmrp.io/phonometry/es/environment/): Propagación en exteriores, barreras, refracción, indicadores ambientales, tráfico y aerogeneradores. De CNOSSOS-EU, la parte de fuentes del anexo II: el método de propagación de su apartado 2.5 no está implementado, y la atenuación en exteriores pasa aquí por ISO 9613-2 en su lugar. | ISO 9613-1/-2, ISO 1996-1/-2, ISO/PAS 1996-3, NT ACOU 112, CNOSSOS-EU (Directiva 2002/49/CE, anexo II, 2.2 y 2.3), IEC 61400-11 |
| [Ruido de aeronaves](https://docs.jmrp.io/phonometry/es/aircraft/): Niveles de certificación, contornos de aeropuerto y el método de hemisferio para helicópteros. | Anexo 16 OACI, IEC 61265, SAE ARP 866A/5534, ECAC Doc 29, ECAC Doc 32 |
| [Acústica submarina](https://docs.jmrp.io/phonometry/es/underwater/): Niveles re 1 µPa, ruido radiado por buques, hincado de pilotes, ruido ambiente, pérdidas por transmisión. | ISO 18405, ISO 17208-1/-2, ISO 18406, JOMOPANS-ECHO |
| [Fuentes y dispositivos](https://docs.jmrp.io/phonometry/es/devices/): Potencia acústica, intensidad, declaraciones de emisión, electroacústica, sonoridad de programa. | 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 |
| [Simulación de ondas](https://docs.jmrp.io/phonometry/es/simulation/): Simulación FDTD 2D determinista, acústica y elástica P-SV, validada frente a oráculos analíticos y no frente a una norma. | sin norma que la rija |

## Empezar desde cero

Tres pasos, en orden. Los dos primeros son cuestión de minutos; al tercero vuelves una y otra vez.

1. **Instálala.** Python 3.12 o posterior. La instalación básica trae NumPy y SciPy; el extra [full] añade cuatro más, [plot] para las figuras, [perf] para la ponderación temporal de impulso acelerada, [report] para las fichas PDF y [audio] para los formatos de audio más allá del WAV sin comprimir. [torch], que [full] deja fuera, calcula las simulaciones FDTD con PyTorch. En Windows y Linux de 32 bits, donde [full] no tiene soporte, [plot,report,audio] instala los otros tres. Si ya tienes instalada phonometry 3.x, actualízala con pip install -U phonometry y los extras que uses: la 3.x organiza sus imports de otra manera, y en ella from phonometry import filters falla.

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

   [Opciones de instalación](https://docs.jmrp.io/phonometry/es/start/getting-started/)
2. **Haz un análisis de principio a fin.** La guía Primeros pasos recorre una vez toda la cadena de proceso, primero con una señal sintética y después con un archivo WAV: calibración, ponderación frecuencial, banco de filtros, ponderación temporal y los niveles que salen.

   [Primeros pasos](https://docs.jmrp.io/phonometry/es/start/getting-started/)
3. **Ve a tu dominio.** Cada guía empieza por la norma que implementa, las magnitudes que define y las hipótesis, y sigue con el código y la figura. Cuando necesites la firma exacta, la referencia de la API tiene una página por módulo.

   [Referencia de la API](https://docs.jmrp.io/phonometry/es/reference/api/)

Para modelos de lenguaje: [llms.txt](https://docs.jmrp.io/phonometry/llms.txt), el índice de todas las páginas de esta documentación en Markdown (en inglés).
