# Published catalogues

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

Canonical: https://docs.jmrp.io/phonometry/reference/catalogues/
Language: en
Alternate: https://docs.jmrp.io/phonometry/es/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: Every material, gas and fluid the library reads from a printed page, from elastic constants to fluid states, with its source table and what its cell said.

---

A library that computes with a density has to get it from somewhere. This one
gets it from a page, and keeps the page: every row of these catalogues names
the book, the table, the PDF page and the printed folio it was read on, and
says what its cell actually said. A density printed as an interval is an
interval here, a loss factor printed as an upper bound is a bound, and a
tortuosity a page prints as the word `model` is that word, because the quantity
is frequency dependent there and no single number stands for it.

Three things follow from that discipline and are visible in the tables.

**The books disagree, and the key says which one is speaking.** Four of them
print a steel at 7 800 kg/m³ and no two agree on its modulus. That is not a
defect to be averaged away: it is the spread of the literature, and a
catalogue that picked one would be hiding it. Rows are keyed by the table they
came off, and the library's lookups return every book's reading of a name
rather than choosing between them.

**A number this library worked out is marked as such.** A page that prints a
modulus and a density has printed a bar speed without writing it down, so the
row carries it; but it is shown in italics, and what it was computed from is
one hover away. No derived value is ever stored as if it had been read.
Two other kinds of cell hold the page's own number and say how it got there:
a value the page gives in a unit this library does not hold, degrees
Fahrenheit, psi or sabins, is converted, and the mark names the page's figure
and its unit; and a cell the page leaves blank because it prints the value
once for a block of rows is carried, and the mark names the row that prints
it. A value the source itself calls an estimate is marked as one.

A material marked with an asterisk carries a note its page made about it, and
the note reads on the name. So does the reason behind any cell that is not a
plain number.

**Nothing here is a specification.** Block densities vary by manufacturer,
foams vary by batch, and the books say so by printing ranges where a range is
what is known. Use a row to reproduce a worked example, to sanity-check a
measurement or to get an order of magnitude; measure the specimen for anything
that has to be right.

## The catalogues

Each catalogue has a page of its own, with the prose that says what its
rows are and the table that holds them.

- [Solids](https://docs.jmrp.io/phonometry/reference/catalogues/solids/) (260 rows): Elastic constants, wave speeds and loss factors of solids, read from nine tables in eight books, each row with the table and the page it came from.
- [Damping materials](https://docs.jmrp.io/phonometry/reference/catalogues/damping-materials/) (17 rows): Seventeen commercial damping materials: the peak loss factor, the temperature of the peak at 10 Hz, 100 Hz and 1 kHz, and the storage and loss moduli.
- [Damping treatments](https://docs.jmrp.io/phonometry/reference/catalogues/damping-treatments/) (8 rows): Eight asphalt felt treatments rated by how fast they damp a standard steel plate at 160 Hz, in decibels per second, from 1 dB/s to 400.
- [Orthotropic wood](https://docs.jmrp.io/phonometry/reference/catalogues/orthotropic-wood/) (2 rows): The four elastic constants of a thin orthotropic plate for the two woods a stringed instrument is made of, with the author's own guesses marked.
- [Plateau-method constants](https://docs.jmrp.io/phonometry/reference/catalogues/plateau-method-constants/) (8 rows): The three numbers the plateau method sketches a single panel's transmission loss with: mass per millimetre, plateau height and plateau width.
- [Porous materials](https://docs.jmrp.io/phonometry/reference/catalogues/porous-materials/) (194 rows): Porosity, flow resistivity, tortuosity and the other inputs of the equivalent-fluid and poroelastic models, as measured specimens and as compiled ranges.
- [Resistive facings](https://docs.jmrp.io/phonometry/reference/catalogues/resistive-facings/) (29 rows): Twenty-nine wire meshes, glass cloths and sintered metal sheets, each with the flow resistance of unit area of it, which is not a resistivity per metre.
- [Resilient layers](https://docs.jmrp.io/phonometry/reference/catalogues/resilient-layers/) (15 rows): Fifteen resilient layers a floating floor is laid on, each with the dynamic stiffness per unit area measured on it, its density and its thickness.
- [Dynamic modulus of resilient materials](https://docs.jmrp.io/phonometry/reference/catalogues/dynamic-modulus-of-resilient-materials/) (6 rows): The dynamic modulus of six resilient materials a floating floor is laid on, printed as ranges and measured under a static load of about 2 kPa.
- [Absorption coefficients](https://docs.jmrp.io/phonometry/reference/catalogues/absorption-coefficients/) (459 rows): What finishes absorbed in a reverberation room, band by band, with the mounting and the source of each row, and the absorption area of audiences and air.
- [Carpets](https://docs.jmrp.io/phonometry/reference/catalogues/carpets/) (19 rows): Nineteen carpets rated by their noise reduction coefficient, on bare concrete and on a hair pad, with the weight, height, surface and fibre of the pile.
- [Transmission loss](https://docs.jmrp.io/phonometry/reference/catalogues/transmission-loss/) (255 rows): What partitions did in a laboratory, band by band, and the sound transmission class of walls, doors, windows and floor-ceiling systems.
- [Impact insulation](https://docs.jmrp.io/phonometry/reference/catalogues/impact-insulation/) (71 rows): The impact insulation class of floor-ceiling constructions, and the improvement surface treatments and floor finishes give over a bare concrete floor.
- [Duct walls](https://docs.jmrp.io/phonometry/reference/catalogues/duct-walls/) (46 rows): Forty-six measurements of the sound that leaves a sheet metal duct through its wall and the sound that enters it, by size, shape, gauge and lining.
- [Scattering coefficients](https://docs.jmrp.io/phonometry/reference/catalogues/scattering-coefficients/) (46 rows): Measured scattering coefficients of surfaces, band by band, each row credited to the paper it came from: the values a room modeller starts from.
- [Diffusion coefficients](https://docs.jmrp.io/phonometry/reference/catalogues/diffusion-coefficients/) (87 rows): Diffusion coefficients of semicylinders, semiellipses, triangles and other surfaces, computed with a two-dimensional boundary element model.
- [Predicted scattering coefficients](https://docs.jmrp.io/phonometry/reference/catalogues/predicted-scattering-coefficients/) (119 rows): Scattering coefficients computed with two- and three-dimensional boundary element models, kept apart from the measured ones, with the solver of each row.
- [Ground surfaces](https://docs.jmrp.io/phonometry/reference/catalogues/ground-surfaces/) (105 rows): The effective flow resistivity the outdoor propagation models take for a ground, with the model each value was fitted with, and the ground classes A to H.
- [Gases](https://docs.jmrp.io/phonometry/reference/catalogues/gases/) (43 rows): The molar mass and the ratio of specific heats of gases, which close the ideal-gas state at any temperature and pressure, as two books print them.
- [Fluids](https://docs.jmrp.io/phonometry/reference/catalogues/fluids/) (25 rows): Named fluid states: liquids and gases at the temperature each page states, read from two books, and four airs fixed by the models and standards that use them.
- [Nonlinearity parameter B/A](https://docs.jmrp.io/phonometry/reference/catalogues/nonlinearity-parameter-ba/) (164 rows): A hundred and sixty-four values of the nonlinearity parameter B/A of water, organic liquids, liquid metals and liquefied gases, each with its paper.
- [Nonlinearity parameter of solids](https://docs.jmrp.io/phonometry/reference/catalogues/nonlinearity-parameter-of-solids/) (8 rows): The ultrasonic nonlinearity parameter of eight solids at room temperature, averaged over the three pure longitudinal directions of a cubic crystal.
- [Air attenuation](https://docs.jmrp.io/phonometry/reference/catalogues/air-attenuation/) (6 rows): The air attenuation coefficient, band by band, for the six temperature and humidity conditions a building standard's room model tabulates, in neper per metre.

## Reading a catalogue from code

Every catalogue is a mapping from `'<table>/<row>'` to a row, and a row hands
back what its page printed. A quantity the page gave is an attribute; a
quantity it did not answers `None`, and the row says why.

```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` is the strict reading: it returns the number the page printed or
refuses, naming the page and what the cell held instead. Use it wherever a
wrong number would be worse than an exception.

Asking for a name gives every book at once, which is the comparison no single
book can make:

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

The ground catalogue works the same way, and a row's `medium()` is the porous
half-space the outdoor models take as the ground, worked out from the
resistivity the page prints:

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

A fluid state is a `Fluid` like any other, so it drops into the same calls; what
tells it apart is that its `model` names a table rather than a closed form.

```python
from phonometry import fluids

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

## Your own catalogue

Your own data sheets, declarations of performance, test reports and
measurements go in a catalogue file of yours, a JSON document or a spreadsheet
saved as CSV. `io.read_catalogue` reads it into the same row classes as the
published tables, and every lookup by name searches it with `catalogue=`,
alone or joined with a published catalogue. [Your own
catalogues](https://docs.jmrp.io/phonometry/io/material-catalogues/) shows how, from a published
table written out as a template to the refusal that points at a cell.

The published catalogues hold what the library has read from a book or a
standard, and never a manufacturer's table: a data sheet is revised under the
same title, its terms rarely allow copying it, and the value a project needs
is the one on the sheet it was specified against. A manufacturer's table
pasted into an issue or a pull request is never merged, and nothing in these
catalogues comes from one.

A data sheet's practical absorption coefficients, a test report's
one-third-octave coefficients, a laboratory's sound reduction index and a
covering's impact improvement have row classes of their own that no published
table uses, and [Reading a material
datasheet](https://docs.jmrp.io/phonometry/materials/reading-a-datasheet/) says which number on a
sheet is which. The JSON Schema of a catalogue file, for every row class the
library publishes, is served at
[`schemas/phonometry-catalogue-1.json`](https://docs.jmrp.io/phonometry/schemas/phonometry-catalogue-1.json),
so an editor completes a file of yours as you type it.
