# Catálogos publicados

> 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/catalogues/
Language: es
Alternate: https://docs.jmrp.io/phonometry/reference/catalogues/index.md
Version: phonometry 4.0.0
Install: pip install "phonometry[full]"
Author: José Manuel Requena Plens (https://orcid.org/0000-0003-1250-6212)
Published: 2026-10-28
Updated: 2026-11-16T21:36:14Z
License: MIT (https://github.com/jmrplens/phonometry/blob/main/LICENSE)
Summary: Todo material, gas y fluido que la biblioteca lee de una página impresa, de constantes elásticas a estados de fluido, con su tabla y lo que decía su celda.

---

Una biblioteca que calcula con una densidad tiene que sacarla de algún sitio.
Esta la saca de una página, y se queda con la página: cada fila de estos
catálogos nombra el libro, la tabla, la página del PDF y el folio impreso en
los que se leyó, y dice lo que decía su celda de verdad. Una densidad impresa
como intervalo aquí es un intervalo, un factor de pérdidas impreso como cota
superior es una cota, y una tortuosidad que una página imprime como la palabra
`model` es esa palabra, porque ahí la magnitud depende de la frecuencia y
ningún número suelto la representa.

De esa disciplina se siguen tres cosas, y las tres se ven en las tablas.

**Los libros discrepan, y la clave dice cuál habla.** Cuatro de ellos imprimen
un acero a 7 800 kg/m³ y no hay dos que coincidan en su módulo. Eso no es un
defecto que haya que promediar: es la dispersión de la literatura, y un
catálogo que eligiera uno la estaría escondiendo. Las filas llevan por clave la
tabla de la que salieron, y las búsquedas de la biblioteca devuelven la lectura
de cada libro en vez de elegir entre ellas.

**Un número que ha calculado esta biblioteca va marcado.** Una página que
imprime un módulo y una densidad ha impreso una velocidad de barra sin
escribirla, así que la fila la lleva; pero se muestra en cursiva, y de qué se
calculó está a un puntero de distancia. Ningún valor derivado se guarda como si
se hubiera leído. Otras dos clases de celda guardan el número de la propia
página y dicen cómo llegó ahí: un valor que la página da en una unidad que
esta biblioteca no guarda, grados Fahrenheit, psi o sabines, está convertido,
y la marca da la cifra de la página y su unidad; y una celda que la página deja
en blanco porque imprime el valor una sola vez para un bloque de filas está
arrastrada, y la marca nombra la fila que lo imprime. Un valor que la propia fuente llama estimación va
marcado como tal.

Un material marcado con un asterisco lleva una nota que hizo su página sobre
él, y la nota se lee sobre el nombre. Igual que el motivo de cualquier celda
que no sea un número a secas.

**Nada de esto es una especificación.** La densidad de un bloque varía con el
fabricante, la de una espuma con el lote, y los libros lo dicen imprimiendo
rangos donde un rango es lo que se sabe. Usa una fila para reproducir un
ejemplo resuelto, para contrastar una medida o para tener un orden de magnitud;
para lo que tenga que estar bien, mide la probeta.

## Los catálogos

Cada catálogo tiene su propia página, con el texto que explica qué son sus
filas y la tabla que las contiene.

- [Sólidos](https://docs.jmrp.io/phonometry/es/reference/catalogues/solids/) (260 filas): Constantes elásticas, velocidades de onda y factores de pérdidas de sólidos, leídos de nueve tablas de ocho libros, cada fila con su tabla y su página.
- [Materiales amortiguadores](https://docs.jmrp.io/phonometry/es/reference/catalogues/damping-materials/) (17 filas): Diecisiete materiales amortiguadores comerciales: el factor de pérdidas máximo, la temperatura del máximo a 10 Hz, 100 Hz y 1 kHz, y sus módulos.
- [Tratamientos amortiguadores](https://docs.jmrp.io/phonometry/es/reference/catalogues/damping-treatments/) (8 filas): Ocho fieltros asfálticos valorados por lo deprisa que amortiguan una placa normalizada de acero a 160 Hz, en decibelios por segundo, de 1 dB/s a 400.
- [Madera ortótropa](https://docs.jmrp.io/phonometry/es/reference/catalogues/orthotropic-wood/) (2 filas): Las cuatro constantes elásticas de una placa delgada ortótropa para las dos maderas de un instrumento de cuerda, con las estimaciones del autor marcadas.
- [Constantes del método de la meseta](https://docs.jmrp.io/phonometry/es/reference/catalogues/plateau-method-constants/) (8 filas): Los tres números con los que el método de la meseta esboza la pérdida por transmisión de un panel simple: masa por milímetro, altura y anchura de la meseta.
- [Materiales porosos](https://docs.jmrp.io/phonometry/es/reference/catalogues/porous-materials/) (194 filas): Porosidad, resistividad al flujo, tortuosidad y los demás datos de los modelos de fluido equivalente y poroelásticos, como probetas medidas y como rangos.
- [Velos resistivos](https://docs.jmrp.io/phonometry/es/reference/catalogues/resistive-facings/) (29 filas): Veintinueve mallas metálicas, tejidos de vidrio y láminas sinterizadas, cada una con la resistencia al flujo de la unidad de área, que no es una resistividad.
- [Capas elásticas](https://docs.jmrp.io/phonometry/es/reference/catalogues/resilient-layers/) (15 filas): Quince capas elásticas sobre las que flota un suelo, cada una con la rigidez dinámica por unidad de superficie medida sobre ella, su densidad y su espesor.
- [Módulo dinámico de materiales elásticos](https://docs.jmrp.io/phonometry/es/reference/catalogues/dynamic-modulus-of-resilient-materials/) (6 filas): El módulo dinámico de seis materiales elásticos sobre los que se apoya un suelo flotante, impreso como intervalo y medido con una carga estática de unos 2 kPa.
- [Coeficientes de absorción](https://docs.jmrp.io/phonometry/es/reference/catalogues/absorption-coefficients/) (459 filas): Lo que absorbió un acabado en una cámara reverberante, banda a banda, con el montaje y la fuente de cada fila, y el área de absorción del público y del aire.
- [Alfombras](https://docs.jmrp.io/phonometry/es/reference/catalogues/carpets/) (19 filas): Diecinueve alfombras valoradas por su coeficiente de reducción del ruido, sobre hormigón desnudo o sobre relleno de pelo, con el peso, la altura y la fibra.
- [Aislamiento acústico](https://docs.jmrp.io/phonometry/es/reference/catalogues/transmission-loss/) (255 filas): Lo que hizo una partición en un laboratorio, banda a banda, y la clase de transmisión del sonido de muros, puertas, ventanas y sistemas de suelo-techo.
- [Aislamiento al ruido de impacto](https://docs.jmrp.io/phonometry/es/reference/catalogues/impact-insulation/) (71 filas): La clase de aislamiento al impacto de conjuntos de suelo y techo, y la mejora que dan tratamientos y acabados sobre un forjado de hormigón desnudo.
- [Paredes de conducto](https://docs.jmrp.io/phonometry/es/reference/catalogues/duct-walls/) (46 filas): Cuarenta y seis medidas del sonido que sale de un conducto de chapa por su pared y del que entra por ella, según tamaño, forma, calibre y forro.
- [Coeficientes de dispersión](https://docs.jmrp.io/phonometry/es/reference/catalogues/scattering-coefficients/) (46 filas): Coeficientes de dispersión medidos de superficies, banda a banda, cada fila con el artículo del que sale: los valores de los que parte quien modela una sala.
- [Coeficientes de difusión](https://docs.jmrp.io/phonometry/es/reference/catalogues/diffusion-coefficients/) (87 filas): Coeficientes de difusión de semicilindros, semielipses, triángulos y otras superficies, calculados con un modelo de elementos de contorno en dos dimensiones.
- [Coeficientes de dispersión calculados](https://docs.jmrp.io/phonometry/es/reference/catalogues/predicted-scattering-coefficients/) (119 filas): Coeficientes de dispersión calculados con modelos de elementos de contorno en dos y tres dimensiones, aparte de los medidos; cada fila dice con cuál se calculó.
- [Superficies de suelo](https://docs.jmrp.io/phonometry/es/reference/catalogues/ground-surfaces/) (105 filas): La resistividad al flujo efectiva que los modelos de propagación exterior toman para un suelo, con el modelo con el que se ajustó, y las clases de suelo A a H.
- [Gases](https://docs.jmrp.io/phonometry/es/reference/catalogues/gases/) (43 filas): La masa molar y la relación de calores específicos de los gases, que cierran el estado de gas ideal a cualquier temperatura y presión, según dos libros.
- [Fluidos](https://docs.jmrp.io/phonometry/es/reference/catalogues/fluids/) (25 filas): Estados de fluido con nombre: líquidos y gases a la temperatura de su página, leídos de dos libros, y cuatro aires que fijan los modelos y normas que los usan.
- [Parámetro de no linealidad B/A](https://docs.jmrp.io/phonometry/es/reference/catalogues/nonlinearity-parameter-ba/) (164 filas): Ciento sesenta y cuatro valores del parámetro de no linealidad B/A del agua, de líquidos orgánicos, metales líquidos y gases licuados, cada uno con su artículo.
- [Parámetro de no linealidad de sólidos](https://docs.jmrp.io/phonometry/es/reference/catalogues/nonlinearity-parameter-of-solids/) (8 filas): El parámetro de no linealidad ultrasónico de ocho sólidos a temperatura ambiente, promediado en las tres direcciones longitudinales puras de un cristal cúbico.
- [Atenuación del aire](https://docs.jmrp.io/phonometry/es/reference/catalogues/air-attenuation/) (6 filas): El coeficiente de atenuación del aire, banda a banda, en las seis condiciones de temperatura y humedad que tabula el modelo de sala de una norma de edificación.

## Leer un catálogo desde el código

Cada catálogo es un diccionario de `'<tabla>/<fila>'` a una fila, y la fila
devuelve lo que su página imprimió. Una magnitud que la página dio es un
atributo; una que no dio responde `None`, y la fila dice por qué.

```python
from phonometry import materials

foam = materials.PUBLISHED_POROUS_MATERIALS["allard-2009-table-13-1/foam"]
print(foam.source)
print(foam.printed("flow_resistivity_pa_s_m2"), "Pa s/m2")

screen = materials.PUBLISHED_POROUS_MATERIALS["allard-2009-table-11-5/screen_2"]
print(screen.tortuosity)
print(screen.why_missing("tortuosity"))
```

`printed` es la lectura estricta: devuelve el número que imprimió la página o
se niega, nombrando la página y lo que había en la celda. Úsalo allí donde un
número equivocado sea peor que una excepción.

Preguntar por un nombre da todos los libros a la vez, que es la comparación que
ningún libro por separado puede hacer. El nombre que se pregunta es el que
imprime el libro, casi siempre en inglés: las tablas de los catálogos muestran
los nombres, las notas y las fuentes en español, pero su buscador encuentra
cada fila también por el nombre del libro, que es el que hay que escribir aquí.

```python
for row in materials.porous_materials_named("Mineral wool"):
    interval = row.ranges.get("porosity")
    print(row.table, row.porosity if interval is None else interval)
```

El catálogo de suelos funciona igual, y el `medium()` de una fila es el
semiespacio poroso que los modelos de exteriores toman como suelo, calculado a
partir de la resistividad que imprime la página:

```python
from phonometry import environment

pasture = environment.PUBLISHED_GROUND_SURFACES["bies-2017-table-5-2/normal_uncompacted_ground"]
print(pasture.harmonoise_class, pasture.printed("flow_resistivity_pa_s_m2"))

octaves = [125.0, 250.0, 500.0, 1000.0]
over_pasture = environment.ground_effect(
    octaves, 1.0, 1.5, 50.0, impedance=pasture.medium(octaves)
)
print(over_pasture.excess_attenuation.round(2), "dB")
```

Un estado de fluido es un `Fluid` como cualquier otro, así que entra en las
mismas llamadas; lo que lo distingue es que su `model` nombra una tabla y no
una forma cerrada.

```python
from phonometry import fluids

sea = fluids.PUBLISHED_FLUIDS["bies-2017-table-c1-fluids/sea_water"]
print(sea.model)
print(sea.validity)
```

## Tu propio catálogo

Tus hojas de características, declaraciones de prestaciones, informes de
ensayo y medidas van en un archivo de catálogo tuyo, un documento JSON o una
hoja de cálculo guardada como CSV. `io.read_catalogue` lo lee en las mismas
clases de fila que las tablas publicadas, y todas las búsquedas por nombre
buscan en él con `catalogue=`, solo o unido a un catálogo publicado. [Tus
propios catálogos](https://docs.jmrp.io/phonometry/es/io/material-catalogues/) explica cómo, desde
una tabla publicada escrita como plantilla hasta el rechazo que señala una
celda.

Los catálogos publicados recogen lo que la biblioteca ha leído de un libro o
de una norma, y nunca la tabla de un fabricante: una hoja de características se
revisa bajo el mismo título, sus condiciones de uso rara vez permiten
copiarla, y el valor que necesita un proyecto es el de la hoja con la que se
especificó. Una tabla de un fabricante pegada en una issue o en una pull
request nunca se incorpora, y nada de estos catálogos sale de una.

Los coeficientes de absorción prácticos de una hoja de características, los
coeficientes por tercios de octava de un informe de ensayo, el índice de
reducción acústica de un laboratorio y la mejora a impactos de un
revestimiento tienen clases de fila propias que ninguna tabla publicada usa, y
[Cómo leer la hoja de características de un
material](https://docs.jmrp.io/phonometry/es/materials/reading-a-datasheet/) dice qué número de una
hoja es cuál. El esquema JSON de un archivo de catálogo, para todas las clases
de fila que publica la biblioteca, se sirve en
[`schemas/phonometry-catalogue-1.json`](https://docs.jmrp.io/phonometry/schemas/phonometry-catalogue-1.json),
para que un editor complete un archivo tuyo mientras lo escribes.
