Skip to content

Published catalogues

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.

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

  • 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 87 rows

    Diffusion coefficients of semicylinders, semiellipses, triangles and other surfaces, computed with a two-dimensional boundary element model.

  • 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 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 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 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 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 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 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.

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.

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:

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:

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.

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

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 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 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, so an editor completes a file of yours as you type it.