Skip to content

building.prediction.panel_transmission

Predicted airborne sound reduction index of panels (Bies, Hansen & Howard 2017, Engineering Noise Control 5e, Section 7.2; Sharp 1973).

Where EN 12354-1 (phonometry.building.prediction.simplified_model) takes the element sound reduction index R as a measured input, this module predicts R(f) from the physical properties of the construction: the mass per unit area, bending stiffness (through the coincidence frequency) and loss factor. The prediction feeds the same ISO 717-1 weighting (phonometry.building.weighted_rating) as the measured quantities, closing the chain from panel physics to the single-number Rw.

Mass law (Bies Eq. 7.40/7.42). A non-stiff panel transmits by forced motion; the transmission coefficient of an infinite limp panel gives the normal- and field-incidence transmission loss:

with m'' the mass per unit area, the characteristic impedance of air and the field-incidence correction dB for one-third-octave or 4.0 dB for octave bands (Eq. 7.42). The mass law rises 6 dB per octave and 6 dB per doubling of mass.

Single panel, Sharp’s method (Bies 7.2.4.1). Below the coincidence region the field-incidence mass law holds; from the coincidence frequency fc upwards the loss factor eta controls the transmission (Eq. 7.44):

and between and the curve is a straight line on versus . The coincidence dip at sits below the extrapolated mass law (Bies design-chart point B, ).

Double wall (Bies 7.2.6, Eq. 7.62-7.64). Two leaves m1, m2 separated by a gap d behave as a mass-spring-mass system. Below the resonance the pair follows the mass law of the combined mass ; above it the two mass laws add, boosted by the cavity (Eq. 7.64):

The cavity stiffness s'' is for an empty (adiabatic) air gap; a porous fill (a PorousMediumResult from phonometry.materials.absorbers.porous) lowers the resonance through its softer, near-isothermal effective bulk modulus and damps the cavity so the mid-band slope is realised without standing-wave dips.

Orthotropic panels (Bies 7.2.4.5; Vigran, Building Acoustics, 3.7.3 and 6.5.3). Ribbed and corrugated cladding is stiff along the corrugations and limp across them, so a single coincidence frequency no longer exists: the panel has a range bounded by the stiffest and the least stiff direction (Vigran Eq. 6.107). The bending-wave impedance then depends on the azimuth theta as well as the incidence angle phi (Heckl 1960; Hansen 1993; Vigran Eq. 6.108 = Bies Eq. 7.30), and the diffuse-field average is a double integral (Vigran Eq. 6.111 = Bies Eq. 7.38). The consequence is the whole point of the model: over one to two decades the resonant transmission dominates and R flattens far below the mass law of a flat plate of the same mass. See orthotropic_transmission_loss, orthotropic_critical_frequencies, corrugated_plate_stiffness and orthotropic_plate_resonance.

Auto-generated from the source docstrings by scripts/generate_api_docs.py (make api-docs). Do not edit by hand.

corrugated_plate_mass_factor(
corrugation_amplitude: float,
corrugation_wavelength: float,
) -> float

Surface-density increase of a sine-corrugated plate.

Corrugating a sheet does not change its thickness, so its mass per unit area grows in proportion to the developed length of the profile. For a sinusoid of amplitude H and wavelength L the developed length per period, divided by the period, is the closed form

with E the complete elliptic integral of the second kind. Vigran, in the worked example following his Eq. (3.115) (printed p. 96), warns that “we have to take into account the fact that the mass per unit area will increase when making the corrugations”, and it is exactly this factor that reproduces his published eigenfrequencies.

Parameters

Name Description
corrugation_amplitude Corrugation amplitude H, in m (> 0); the total peak-to-trough depth of the profile is .
corrugation_wavelength Corrugation wavelength L, in m (> 0).

Returns: The factor (>= 1) multiplying the flat-sheet surface density.

Raises

Exception When
ValueError for a non-positive input.
TypeError if corrugation_amplitude or corrugation_wavelength is not a single number.
corrugated_plate_stiffness(
thickness_m: float,
corrugation_amplitude: float,
corrugation_wavelength: float,
*,
youngs_modulus: float,
poisson_ratio: float = 0.3,
) -> CorrugatedPlateStiffness

Equivalent orthotropic stiffnesses of a “wavy” corrugated plate.

Timoshenko & Woinowsky-Krieger’s (1959) equivalent bending stiffnesses of a plate of thickness h whose profile is a sinusoid of amplitude H and wavelength L, as transcribed by Vigran Eq. (3.115) (printed p. 96):

Bx is the stiffness across the corrugations (slightly below the flat-plate value), Bz the stiffness along them (larger by orders of magnitude: that is what corrugating buys) and Bxz the twisting term Eq. (3.113) needs. Vigran’s footnote records that the same equations appear in Blevins (1979) “unfortunately, with a misprint in the expression for Bz”.

Feed (Bx, Bz) to orthotropic_critical_frequencies for the coincidence range and all three to orthotropic_plate_resonance for the eigenfrequencies. Remember to scale the surface density by corrugated_plate_mass_factor.

Parameters

Name Description
thickness_m Sheet thickness h, in m (> 0).
corrugation_amplitude Corrugation amplitude H, in m (> 0).
corrugation_wavelength Corrugation wavelength L, in m (> 0).
youngs_modulus Young’s modulus E, in Pa (> 0).
poisson_ratio Poisson’s ratio nu (Default: 0.3).

Returns: The three stiffnesses, in N.m, as a CorrugatedPlateStiffness (b_x_n_m, b_z_n_m, b_xz_n_m).

Raises

Exception When
ValueError for a non-positive input or .
TypeError if corrugation_amplitude, corrugation_wavelength, poisson_ratio, thickness_m or youngs_modulus is not a single number.
CorrugatedPlateStiffness(b_x_n_m: float, b_z_n_m: float, b_xz_n_m: float)

The equivalent orthotropic stiffnesses of a corrugated plate (Vigran Eq. 3.115).

What corrugated_plate_stiffness returns: the three stiffnesses, named, where a (Bx, Bz, Bxz) tuple used to be unpacked by position.

Attributes

Name Description
b_x_n_m , the bending stiffness across the corrugations, in N·m.
b_z_n_m , the bending stiffness along the corrugations, in N·m.
b_xz_n_m , the twisting stiffness Eq. (3.113) needs, in N·m.
double_wall_transmission_loss(
frequency: NumericArrayLike,
mass1: float,
mass2: float,
gap_m: float,
*,
loss_factor: float = 0.1,
cavity_medium: PorousMediumResult | None = None,
tie_stiffness_per_area: float = 0.0,
fraction: Literal[1, 3] | np.integer[Any] = 3,
fluid: Fluid = ...,
) -> SoundReductionResult

Sound reduction index of a double wall (Bies 7.2.6, Eq. 7.64).

Piecewise Sharp model: below the mass-spring-mass resonance f0 the pair behaves as the mass law of the combined mass; between f0 and the limiting frequency the two mass laws add plus ; above f_l they add plus 6 dB. The curve is continuous at f_l ( there).

Ties or mounts bridging the cavity stiffen it (Hopkins Eq. 4.89), pushing f0 up and extending the combined-mass branch; pass their stiffness per unit area as tie_stiffness_per_area (see phonometry.building.wall_tie_stiffness_per_area).

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
mass1 Surface density of leaf 1 m1, in kg/m^2 (> 0).
mass2 Surface density of leaf 2 m2, in kg/m^2 (> 0).
gap_m Cavity depth d, in m (> 0).
loss_factor Leaf loss factor eta (> 0, Default: 0.1); reserved for the coincidence extension and reported for reference.
cavity_medium Optional porous fill; see mass_spring_mass_resonance.
tie_stiffness_per_area Stiffness per unit area of a connection array bridging the cavity, in N/m^3 (>= 0, Default: 0).
fraction The band set of the field correction, 3 for one-third octaves or 1 for octaves. One of 1 or 3.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: A SoundReductionResult (model "double-wall").

Raises

Exception When
ValueError for a non-positive input.
TypeError if gap_m, loss_factor, mass1 or mass2 is not a single number, or fraction is not an integer (a word, a flag or a float), or frequency holds a text or a value that is not a real number.
field_incidence_correction(
fraction: Literal[1, 3] | np.integer[Any] = 3,
) -> float

Field-incidence mass-law correction dB (Bies Eq. 7.42).

Parameters

Name Description
fraction The band set, 3 for one-third octaves (5.5 dB) or 1 for octaves (4.0 dB). One of 1 or 3.

Returns: The correction subtracted from the normal-incidence mass law, dB.

Raises

Exception When
ValueError for a band set other than 1 or 3.
TypeError if fraction is not an integer (a word, a flag or a float).
mass_law_transmission_loss(
frequency: float | np.floating[Any] | np.integer[Any],
mass_per_area: float,
*,
incidence: Literal['normal', 'field'] = ...,
fraction: Literal[1, 3] | np.integer[Any] = ...,
field_correction: float | None = ...,
fluid: Fluid = ...,
) -> float
mass_law_transmission_loss(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
mass_per_area: float,
*,
incidence: Literal['normal', 'field'] = ...,
fraction: Literal[1, 3] | np.integer[Any] = ...,
field_correction: float | None = ...,
fluid: Fluid = ...,
) -> NDArray[np.float64]
mass_law_transmission_loss(
frequency: NumericArrayLike,
mass_per_area: float,
*,
incidence: Literal['normal', 'field'] = ...,
fraction: Literal[1, 3] | np.integer[Any] = ...,
field_correction: float | None = ...,
fluid: Fluid = ...,
) -> float | NDArray[np.float64]

Mass-law transmission loss of a limp panel (Bies Eq. 7.40/7.42).

; the field-incidence value subtracts the band correction of field_incidence_correction, or the explicit field_correction when one is given (Norton & Karczub Eq. 3.106 uses a flat 5 dB, the line plateau_transmission_loss builds its estimate on).

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array, > 0).
mass_per_area Mass per unit area m'', in kg/m^2 (> 0).
incidence "normal" or "field" (Default: "field").
fraction The band set of the field correction, 3 for one-third octaves or 1 for octaves. One of 1 or 3.
field_correction Explicit field-incidence correction, in dB (>= 0), overriding the band table (Default: None).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: The transmission loss TL, in dB. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive input, an unknown incidence or a band set other than 1 or 3.
TypeError if incidence is not a text, or field_correction or mass_per_area is not a single number, or fraction is not an integer (a word, a flag or a float), or frequency holds a text or a value that is not a real number.
mass_spring_mass_resonance(
mass1: float,
mass2: float,
gap_m: float,
*,
cavity_medium: PorousMediumResult | None = None,
tie_stiffness_per_area: float = 0.0,
fluid: Fluid = ...,
) -> float

Mass-spring-mass resonance f0 of a double wall (Bies Eq. 7.62).

with the cavity stiffness per unit area s''. For an empty air gap (adiabatic, Hopkins Eq. 4.72); with a porous cavity_medium the fill’s effective (near-isothermal) bulk modulus at the lowest supplied frequency sets a softer , lowering f0.

An array of mechanical connections across the cavity (wall ties in a masonry cavity wall, resilient mounts under a floating floor) acts as a spring in parallel with the cavity, adding to s'' (Hopkins Eq. 4.89). Pass that term as tie_stiffness_per_area; the helper phonometry.building.wall_tie_stiffness_per_area builds it from a tie density and Hopkins’ Table A4.

Parameters

Name Description
mass1 Surface density of leaf 1 m1, in kg/m^2 (> 0).
mass2 Surface density of leaf 2 m2, in kg/m^2 (> 0).
gap_m Cavity depth d, in m (> 0).
cavity_medium Optional porous fill (a PorousMediumResult) whose effective bulk modulus sets the cavity stiffness.
tie_stiffness_per_area Stiffness per unit area of a connection array bridging the cavity, in N/m^3 (>= 0, Default: 0).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: The mass-spring-mass resonance f0, in hertz.

Raises

Exception When
ValueError for a non-positive input.
TypeError if gap_m, mass1, mass2 or tie_stiffness_per_area is not a single number.
orthotropic_critical_frequencies(
mass_per_area: float,
bending_stiffness_1: float,
bending_stiffness_2: float,
*,
speed_of_sound: float = 343.0,
) -> tuple[float, float]

Coincidence range (fc1, fc2) of orthotropic panels (Vigran 6.107).

evaluated for both principal bending stiffnesses (Vigran Eq. (6.107), printed p. 252; the same closed form as the isotropic coincidence_frequency). The stiffest direction gives the lowest coincidence frequency, so the returned pair is sorted: fc1 from the larger stiffness, fc2 from the smaller. For a corrugated sheet fc1 can sit at a few hundred hertz while fc2 reaches 15 kHz to 30 kHz, and the resonant transmission then dominates over most of the useful frequency range.

Parameters

Name Description
mass_per_area Mass per unit area m'', in kg/m^2 (> 0), including the developed-length increase of a corrugated sheet (see corrugated_plate_mass_factor).
bending_stiffness_1 One principal bending stiffness, in N.m (> 0).
bending_stiffness_2 The other principal bending stiffness, in N.m (> 0). The argument order does not matter.
speed_of_sound Speed of sound in air c0 (Default: 343 m/s).

Returns: The pair (fc1, fc2) in hertz, with .

Raises

Exception When
ValueError for a non-positive input.
TypeError if bending_stiffness_1, bending_stiffness_2, mass_per_area or speed_of_sound is not a single number.
orthotropic_plate_resonance(
mode_x: int | np.integer[Any],
mode_z: int | np.integer[Any],
*,
length_x: float,
length_z: float,
mass_per_area: float,
bending_stiffness_x: float,
bending_stiffness_z: float,
bending_stiffness_xz: float,
) -> float

Eigenfrequency of a simply supported orthotropic plate (Vigran 3.113).

(Vigran Eq. (3.113), printed p. 95; identical to Bies Eq. (7.27) after Hearmon 1959). It collapses to the isotropic Eq. (3.109) when and .

The lowest eigenfrequency matters to the transmission-loss prediction because the infinite-panel models of orthotropic_transmission_loss and single_panel_transmission_loss are only valid above about (Bies, Sect. 7.2.4).

Parameters

Name Description
mode_x Mode order i along a (integer >= 1).
mode_z Mode order n along b (integer >= 1).
length_x Plate dimension a, in m (> 0), along the axis whose bending stiffness is bending_stiffness_x.
length_z Plate dimension b, in m (> 0).
mass_per_area Mass per unit area m'', in kg/m^2 (> 0).
bending_stiffness_x Bx, in N.m (> 0).
bending_stiffness_z Bz, in N.m (> 0).
bending_stiffness_xz Bxz, in N.m (> 0).

Returns: The eigenfrequency, in hertz.

Raises

Exception When
ValueError for a non-positive input or a mode order below 1.
TypeError if bending_stiffness_x, bending_stiffness_xz, bending_stiffness_z, length_x, length_z or mass_per_area is not a single number, or mode_x or mode_z is a flag, a text or an array where a count goes.
orthotropic_transmission_loss(
frequency: NumericArrayLike,
mass_per_area: float,
*,
critical_frequency_lower: float,
critical_frequency_upper: float,
loss_factor: float = 0.01,
method: Literal['integral', 'heckl'] = 'integral',
area: float | None = None,
limiting_angle_deg: float = 78.0,
fraction: Literal[1, 3] | np.integer[Any] = 3,
fluid: Fluid = ...,
) -> SoundReductionResult

Orthotropic-panel sound reduction index (Vigran 6.5.3, Bies 7.2.4.5).

A ribbed or corrugated sheet is stiff along the corrugations and limp across them, so instead of one coincidence dip it has a whole coincidence range fc1 to fc2 (see orthotropic_critical_frequencies). Over that range the resonant transmission dominates and R flattens well below the mass law of a flat plate of the same surface density, which is the price paid for the strength-to-weight ratio.

Two prediction routes, both from the same wall impedance (Heckl 1960; Hansen 1993; Vigran Eq. (6.108) = Bies Eq. (7.30))

  • method="integral" (Default) averages the angular transmission coefficient (Vigran Eq. (6.109) = Bies Eq. (7.31)) over azimuth and incidence angle, (Vigran Eq. (6.111) = Bies Eq. (7.38)), numerically. The near-grazing angles are excluded by the limiting angle: pass area for the size-dependent limit of Bies Eq. (7.36) (the correction Vigran writes as Eq. (6.113)) or leave it out for the fixed limiting_angle. This is the only route that responds to the loss factor.
  • method="heckl" is Heckl’s closed-form approximation for , the design chart of Bies Figure 7.9(b): field-incidence mass law below , Eq. (7.59) (the first of Vigran Eq. (6.112)) from fc1 to , Eq. (7.60) (the second) above , and straight lines in across the two gaps. It is cheap and it needs no loss factor, but it cannot show the depth of the coincidence region and it requires for its four construction points to stay ordered.

The two routes are not interchangeable. Above they converge as the loss factor falls: with the integral lands within about 0.3 dB of Eq. (7.60), which is a useful independent check on both transcriptions. Across the coincidence range Eq. (7.59) is a much rougher approximation and stays a few decibels above the integral even at , as Vigran’s Figure 6.27 shows for its own worked case.

Both models are infinite-panel models, valid above roughly (orthotropic_plate_resonance). Bies also notes two systematic departures of the Heckl branch from measurement: below about it underestimates R on small panels, and real corrugated panels show a dip of up to 5 dB between 2 kHz and 4 kHz caused by resonances of the panel sections between the ribs, which no smooth model predicts.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
mass_per_area Mass per unit area m'', in kg/m^2 (> 0).
critical_frequency_lower Lower coincidence frequency fc1, in hertz (> 0), from the stiffest direction.
critical_frequency_upper Upper coincidence frequency fc2, in hertz (> fc1).
loss_factor Total loss factor eta (> 0, Default: 0.01); used only by method="integral", but validated on both routes.
method "integral" (Default) or "heckl".
area Panel area S, in m^2 (> 0), selecting the size-dependent limiting angle of Bies Eq. (7.36) (Default: None); used only by method="integral", but validated on both routes.
limiting_angle_deg Fixed limiting angle theta_L, in degrees (, Default: 78.0), used when area is None and only by method="integral", but validated on both routes.
fraction The band set of the field correction of the Heckl mass-law branch, 3 for one-third octaves or 1 for octaves. One of 1 or 3.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: A SoundReductionResult (model "orthotropic-integral" or "orthotropic-heckl") carrying fc1 in critical_frequency and fc2 in critical_frequency_upper.

Raises

Exception When
ValueError for a non-positive input, an unknown method, a coincidence range that is not increasing, or a Heckl construction whose points would be out of order.
TypeError if method is not a text, or area, critical_frequency_lower, critical_frequency_upper, limiting_angle_deg, loss_factor or mass_per_area is not a single number, or fraction is not an integer (a word, a flag or a float), or frequency holds a text or a value that is not a real number.

Constant (mapping).

PLATEAU_MATERIALS = {'aluminium': (2.66, 29.0, 11.0), 'brick': (2.1, 37.0, 4.5), 'concrete': (2.28, 38.0, 4.5), 'glass': (2.47, 27.0, 10.0), 'lead': (11.2, 56.0, 4.0), 'plaster': (1.71, 30.0, 8.0), 'plywood': (0.57, 19.0, 6.5), 'steel': (7.6, 40.0, 11.0)}
plateau_transmission_loss(
frequency: NumericArrayLike,
*,
material: Literal['aluminium', 'brick', 'concrete', 'glass', 'lead', 'plaster', 'plywood', 'steel'] | PlateauMaterial,
thickness_mm: float,
plateau_height_db: float | None = ...,
frequency_ratio: float | None = ...,
field_correction: float = ...,
fluid: Fluid = ...,
) -> SoundReductionResult
plateau_transmission_loss(
frequency: NumericArrayLike,
*,
material: Literal['aluminium', 'brick', 'concrete', 'glass', 'lead', 'plaster', 'plywood', 'steel'] | PlateauMaterial,
mass_per_area: float,
thickness_mm: float | None = ...,
plateau_height_db: float | None = ...,
frequency_ratio: float | None = ...,
field_correction: float = ...,
fluid: Fluid = ...,
) -> SoundReductionResult
plateau_transmission_loss(
frequency: NumericArrayLike,
*,
mass_per_area: float,
plateau_height_db: float,
frequency_ratio: float,
field_correction: float = ...,
fluid: Fluid = ...,
) -> SoundReductionResult

Plateau-method estimate of a single panel’s TL (Norton 3.9.1).

The plateau (Watters) construction is the empirical shortcut practitioners draw by hand, and it approximates the whole curve from three numbers per material (Norton & Karczub Table 3.1, tabulated in PLATEAU_MATERIALS):

  1. the field-incidence mass law (Eqs. 3.104/3.106), rising 6 dB per octave;
  2. a horizontal coincidence plateau at the material’s plateau height; point A is where the mass-law line reaches it;
  3. point B at frequency_ratio x fA, above which the estimate recovers at 10 dB per octave.

Unlike the physical model of single_panel_transmission_loss it needs neither the bending stiffness nor the loss factor: the material’s tabulated plateau absorbs both. The price is that it is only an estimate, and it assumes a diffuse field on both sides of a panel whose length and width are at least twenty times its thickness.

Give a material with its thickness_mm (the surface density then follows from the material’s), or give mass_per_area together with plateau_height and frequency_ratio. The material is a name the table tabulates, or a PlateauMaterial row: one of PUBLISHED_PLATEAU_DATA, or one of your own that phonometry.io.read_catalogue read from a file. A row gives its three numbers through printed, so a cell it holds as a range, a bound or a word is refused with what it holds, never read as a number. An explicit mass_per_area, plateau_height or frequency_ratio always overrides the material’s, and the material’s own is then not read at all.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
material A key into PLATEAU_MATERIALS, or a PlateauMaterial row (Default: None). One of "aluminium", "brick", "concrete", "glass", "lead", "plaster", "plywood" or "steel".
thickness_mm Panel thickness, in millimetres (> 0), used with material to get the surface density.
mass_per_area Mass per unit area m'', in kg/m^2 (> 0).
plateau_height_db Coincidence plateau height, in dB (> 0).
frequency_ratio Ratio locating the 10 dB/octave recovery (> 1).
field_correction Field-incidence correction of the mass-law line, in dB (Default: 5.0, Norton Eq. 3.106).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: A SoundReductionResult (model "plateau") carrying plateau_height_db, plateau_start (point A) and plateau_end (point B).

Raises

Exception When
ValueError for a non-positive input, an unknown material name, a row that does not print a number the construction reads, or an under-specified panel.
TypeError for a material that is neither a name nor a PlateauMaterial, or a thickness_mm, mass_per_area, plateau_height_db, frequency_ratio or field_correction that is not one number, or frequency holds a text or a value that is not a real number.
plot_double_wall_geometry(
mass1: float,
mass2: float,
gap_m: float,
*,
ax: Axes | None = None,
resonance_frequency: float | None = None,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the mass-spring-mass double wall to scale.

Two leaves separated by the gap_m; leaf thicknesses are drawn from the surface densities at a nominal board density, and the mass-spring-mass resonance is annotated when given.

Parameters

Name Description
mass1 Surface density of the first leaf, in kg/m2.
mass2 Surface density of the second leaf, in kg/m2.
gap_m Cavity depth, in metres.
ax Existing axes, or None to create a figure.
resonance_frequency Optional f0 to annotate, in Hz.
language Label language, "en" (default) or "es".
kwargs Forwarded to the leaf rectangles.

Returns: The axes.

Raises

Exception When
ValueError naming the first of the three that is not finite and positive, or resonance_frequency when one is passed that is not.
TypeError if gap_m, mass1, mass2 or resonance_frequency is not a single number.
single_panel_transmission_loss(
frequency: NumericArrayLike,
mass_per_area: float,
*,
critical_frequency: float | None = None,
bending_stiffness: float | None = None,
loss_factor: float = 0.01,
fraction: Literal[1, 3] | np.integer[Any] = 3,
coincidence_model: Literal['sharp', 'cremer'] = 'sharp',
field_correction: float | None = None,
fluid: Fluid = ...,
) -> SoundReductionResult

Sound reduction index of a single panel, Sharp’s method (Bies 7.2.4.1).

Field-incidence mass law up to , Eq. 7.44 from fc upwards, and a straight line in across the coincidence region between them.

With coincidence_model="cremer" the region above fc follows Cremer’s empirical relationship instead (Norton & Karczub Eq. 3.110),

which also rises at 10 dB per octave far above coincidence but starts from the singularity at fc itself rather than from a finite value. Norton pairs it with the field-incidence mass law below fc and treats the two as the whole model, so there is no interpolated bridge: the mass law runs all the way to fc.

The empirical line is floored at dB, which is where it lands at : Norton’s Eq. (3.109) has degrees there and the panel “offers no resistance to incident sound waves”, . It is also the hard bound of a passive panel, so without the floor a band centre landing on fc would report an arbitrarily large negative TL and a transmission coefficient above one.

Provide the coincidence frequency directly through critical_frequency, or let it be computed from bending_stiffness and mass_per_area through coincidence_frequency.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
mass_per_area Mass per unit area m'', in kg/m^2 (> 0).
critical_frequency Coincidence frequency fc, in hertz (> 0).
bending_stiffness Bending stiffness per unit width B', in N.m, used to compute fc when critical_frequency is not given.
loss_factor Total loss factor eta (> 0, Default: 0.01).
fraction The band set of the field correction, 3 for one-third octaves or 1 for octaves. One of 1 or 3.
coincidence_model "sharp" (Default, Bies Eq. 7.44 above fc with the interpolated bridge from ) or "cremer" (Norton Eq. 3.110, mass law right up to fc).
field_correction Explicit field-incidence correction of the mass-law region, in dB (>= 0), overriding the band table (Default: None; Norton’s Eq. 3.106 uses a flat 5 dB).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values).

Returns: A SoundReductionResult (model "sharp-single" or "cremer-single").

Raises

Exception When
ValueError for a non-positive input, an unknown coincidence model, or if neither critical_frequency nor bending_stiffness is given.
TypeError if coincidence_model is not a text, or critical_frequency, field_correction, loss_factor or mass_per_area is not a single number, or fraction is not an integer (a word, a flag or a float), or frequency holds a text or a value that is not a real number.
SoundReductionResult(
*,
frequencies: NDArray[np.float64],
transmission_loss: NDArray[np.float64],
model: Literal['sharp-single', 'cremer-single', 'plateau', 'orthotropic-integral', 'orthotropic-heckl', 'double-wall'],
critical_frequency: float | None = None,
resonance_frequency: float | None = None,
mass1: float | None = None,
mass2: float | None = None,
gap_m: float | None = None,
plateau_height_db: float | None = None,
plateau_start: float | None = None,
plateau_end: float | None = None,
critical_frequency_upper: float | None = None,
)

Predicted airborne sound reduction index R(f) of a construction.

Attributes

Name Description
frequencies Band centre frequencies, in hertz.
transmission_loss Sound reduction index R per band, in dB.
model Prediction model (e.g. "sharp-single", "double-wall").
critical_frequency Coincidence frequency fc, in hertz, or None (double wall reports the mass-spring-mass resonance instead).
resonance_frequency Mass-spring-mass resonance f0, in hertz, or None (single panel).
mass1 First-leaf surface density, in kg/m2, retained (with mass2 and gap_m) by the double-wall constructor so plot_geometry can draw the section; None otherwise.
mass2 Second-leaf surface density, in kg/m2, or None.
gap_m Cavity depth, in metres, or None.
plateau_height_db Height of the coincidence plateau, in dB, or None (only the plateau model sets these three).
plateau_start Frequency of point A, where the mass-law line meets the plateau, in hertz, or None.
plateau_end Frequency of point B, where the 10 dB/octave recovery starts, in hertz, or None.
critical_frequency_upper Upper coincidence frequency fc2 of an orthotropic panel, in hertz, or None; critical_frequency then carries the lower bound fc1 and the pair spans the flattened coincidence range.
SoundReductionResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the predicted sound reduction index R(f).

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".
SoundReductionResult.plot_geometry(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the mass-spring-mass cross-section to scale.

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".

Raises

Exception When
ValueError If the result does not retain its geometry.
SoundReductionResult.rating(
fraction: Literal[1, 3] | np.integer[Any] | None = None,
) -> WeightedRatingResult

Single-number weighted rating Rw of the predicted R(f).

Delegates to phonometry.building.weighted_rating (ISO 717-1); requires the spectrum to be on the 16 one-third-octave bands (100 Hz to 3150 Hz) or the 5 octave bands (125 Hz to 2000 Hz).

Parameters

Name Description
fraction Band set forwarded to phonometry.building.weighted_rating, 3 for one-third octaves or 1 for octaves (Default: None, read from the number of values). One of 1 or 3.

Returns: The WeightedRatingResult.

Raises

Exception When
TypeError if fraction is not an integer (a word, a flag or a float).
SoundReductionResult.report(
path: str | os.PathLike[str],
*,
metadata: ReportMetadata | None = None,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> str

Render the ISO 717-1 Annex C rating fiche of R(f) to a PDF.

Convenience wrapper delegating to report on rating; requires the predicted spectrum to be on the 16 one-third-octave bands (100 Hz to 3150 Hz) or the 5 octave bands (125 Hz to 2000 Hz).

Parameters

Name Description
path Destination path of the PDF file.
metadata The laboratory, client and specimen block, a ReportMetadata; None leaves it blank.
language "en" (default) or "es" for the fiche.
kwargs Forwarded to report (e.g. engine).

Returns: The written path as a str.

SoundReductionResult.transmission_coefficient

Section titled “SoundReductionResult.transmission_coefficient”

property

Transmission coefficient per band.