Published catalogues
Each catalogue has a page of its own: choose one, and Open takes you to its table.
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
Section titled “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 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.
Reading a catalogue from code
Section titled “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.
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 catalogue
Section titled “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 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.