# Informe de conformidad

> 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/reference/conformance/
Language: es
Alternate: https://docs.jmrp.io/phonometry/reference/conformance/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-08-29
Updated: 2026-11-18T01:01:07Z
License: MIT (https://github.com/jmrplens/phonometry/blob/main/LICENSE)
Summary: Informe numérico de conformidad, regenerado y exigido en CI: cada comprobación fija el valor esperado de un apartado frente al que calcula la biblioteca.

---

El activo diferencial de phonometry no es la lista de funcionalidades sino la
prueba que hay detrás: cada métrica se implementa a partir del texto de la
norma que la rige, y un **informe numérico de conformidad** fija cada
comprobación a una norma, un apartado o tabla, el valor esperado normativo y
el valor que la biblioteca calcula realmente, con la desviación y un veredicto
de cumple/no cumple.

El informe es un documento autogenerado que la CI regenera en **cada pull
request** (la compilación falla si se desincroniza del código), de modo que
siempre está en sincronía con el código que documenta este sitio. Cada fila de
aquí abajo se compone en tiempo de compilación a partir de
[`docs/conformance.json`](https://github.com/jmrplens/phonometry/blob/main/docs/conformance.json),
el documento que escriben las propias comprobaciones; las mismas filas en forma
de tabla plana están en
[`docs/CONFORMANCE.md`](https://github.com/jmrplens/phonometry/blob/main/docs/CONFORMANCE.md).

**Nota**

Los encabezados de columna, los veredictos y los controles de filtrado están
traducidos. Las designaciones de norma, los apartados, las magnitudes y las
unidades no: son identificadores, salen del registro de comprobaciones tal cual
se ejecuta y traducirlos rompería la correspondencia con el documento citado.
Por eso la copia en texto plano de las filas, la que sirve para leerlas de una
sola vez, es la de la [página en inglés](https://docs.jmrp.io/phonometry/reference/conformance/).

## Cómo leerlo

- **Clases de filtro**: el veredicto de clase IEC 61260-1:2014 por
  arquitectura de filtro, con la atenuación relativa medida en la banda
  *determinante*, el límite de clase 1 que debe superar y el margen en dB.
- **Ponderaciones frecuenciales**: desviaciones de A/C (IEC 61672-1 Tabla 3)
  y G (ISO 7196 A.3) respecto a las curvas nominales, juzgadas en la
  frecuencia determinante con la banda de tolerancia aplicable y el margen.
- **Las más cerca de su límite publicado**: cada comprobación conoce el límite
  frente al que se la juzga, así que las diez que consumen la mayor fracción
  del suyo aparecen primero. Una fracción alta no es un fallo: es el margen con
  el que la comprobación cumple, y es lo que una tabla de tolerancias pregunta
  en realidad.
- **Una tabla de conformidad por dominio** (niveles, psicoacústica, acústica
  de salas y de la edificación, potencia acústica, materiales, vibración,
  incertidumbre, ...): la norma y el apartado, la magnitud, el valor normativo,
  el valor que calcula la biblioteca, el límite publicado, la desviación y qué
  parte del límite consume. Los valores esperados provienen de los ejemplos
  resueltos de las propias normas o de expresiones en forma cerrada sintetizadas
  a un resultado conocido.

Cada sección de dominio es plegable y permanece plegada mientras todas sus
filas pasan; una sección con alguna fila fallida se abre sola. Cada guía cuyas
normas comprueba un dominio enlaza la sección de ese dominio desde la línea que
lleva bajo el título, con cuántas comprobaciones la verifican, y el enlace abre
la sección. En pantallas estrechas las tablas anchas se desplazan lateralmente
dentro de su propia caja.

## Cómo se genera

El registro de comprobaciones vive en
[`scripts/conformance_report.py`](https://github.com/jmrplens/phonometry/blob/main/scripts/conformance_report.py)
y se ejecuta en local con `make conformance`, que escribe
`docs/conformance.json` y compone `docs/CONFORMANCE.md` a partir de él. Los
valores esperados se toman de las mismas tablas de referencia que exige la
batería de tests, de modo que el informe y los tests no pueden discrepar en
silencio. Esta página lee el documento ya versionado y nunca lo genera, y la CI
falla si ese documento se desincroniza de una ejecución nueva de las
comprobaciones.

Para la filosofía de diseño detrás de este enfoque, junto con un caso de estudio
sobre la ponderación temporal de IEC 61672-1, consulta
[Por qué phonometry](https://docs.jmrp.io/phonometry/es/start/why-phonometry/).

Volver a deducir las normas con este detalle también saca a la luz defectos de
los propios documentos publicados: ejemplos resueltos que contradicen su
articulado, constantes mal impresas, referencias cruzadas rotas. Cada caso
confirmado, con su evidencia y lo que hace la biblioteca al respecto, está en el
[registro de erratas](https://docs.jmrp.io/phonometry/es/reference/errata/).

**Datos de campo.** Las filas de abajo comprueban la biblioteca frente a los
valores que publica la propia norma. Tres guías van un paso más allá, a datos
medidos que sus autores publicaron junto con los resultados que calculó su
propio software:
[la respuesta al impulso de una capilla](https://docs.jmrp.io/phonometry/es/buildings/rooms/room-acoustics/#una-capilla-medida-frente-a-sus-parametros-publicados)
frente a los parámetros de sala de ISO 3382-1 que publicaron sus autores,
[un año de dos monitores de ruido de Dublín](https://docs.jmrp.io/phonometry/es/environment/assessment/environmental-levels/#un-ano-de-ruido-urbano-frente-a-sus-niveles-por-periodo-publicados)
frente a los niveles anuales por periodo y el Lden del informe del ayuntamiento, y
[cinco pasos de vehículos grabados por un sonómetro de clase 1](https://docs.jmrp.io/phonometry/es/perception/psychoacoustics/loudness/#pasos-de-vehiculos-grabados-por-un-sonometro-de-clase-1)
frente a los niveles y la sonoridad que da su depósito. No son filas de este
informe, porque aquello con lo que se comparan es la salida de otro programa
y no el texto de una norma, pero cada uno corre dos veces en la CI: como test
de oráculo y como fragmento de la guía cuyos valores impresos sujeta la
comprobación de la documentación. Cada guía dice dónde se separan los dos
programas y da la atribución y la licencia de los datos.

Las filas del informe, con sus designaciones de norma, apartados, magnitudes y unidades tal como las ejecuta el registro de comprobaciones, están en texto plano en la copia en Markdown de la página en inglés: https://docs.jmrp.io/phonometry/reference/conformance/index.md.
