Ir al contenido

materials.absorbers.porous

La referencia de la API se publica en inglés en los dos idiomas: se genera a partir de los docstrings del código, que son su texto original.

Porous-material models and resonant sheet impedances.

Two complementary building blocks, all in the time convention with the forward wave carried by (so a passive medium has ):

  • Equivalent-fluid models for the characteristic impedance Zc and the complex wavenumber k of a rigid-frame porous material:

    • the one-parameter Delany-Bazley power law in the absorber variable (Mechel, Formulas of Acoustics 2e, Sect. G.11 Eqs. (1)-(2); Bies, Hansen & Howard, Engineering Noise Control 5e, Appendix D Eqs. (D.22)-(D.23) and Table D.1; Hopkins, Sound Insulation, Eqs. (1.171)-(1.174)), stated valid for and porosity close to one. Table D.1 also provides coefficient sets fitted to polyester (Garai & Pompoli 2005) and to foams (Dunn & Davern 1986, Wu 1988), exposed here as presets.
    • the Miki modification, regressed on the same Delany-Bazley data under a positive-real (passivity) constraint so the model stays well behaved below the fit range (Miki 1990, J. Acoust. Soc. Jpn (E) 11(1), Eqs. (30)-(34), in the variable ).
    • the five-parameter Johnson-Champoux-Allard (JCA) semi-phenomenological model with flow resistivity, porosity, tortuosity and the viscous/thermal characteristic lengths (Cox & D’Antonio, Acoustic Absorbers and Diffusers 3e, Eqs. (6.19)-(6.25); Attenborough & Van Renterghem, Predicting Outdoor Sound 2e, Eqs. (5.13)-(5.14)). The returned equivalent-fluid density and bulk modulus are the surface-normalised quantities (they absorb the porosity), so and hold for every model.
    • the limp-frame correction of any of the three rigid-frame models (Allard & Atalla, Propagation of Sound in Porous Media 2e, Sect. 11.3.4, Eqs. (11.53)-(11.55), printed pp. 251-253): a light frame is dragged along by the pore fluid, so its inertia has to be carried by the equivalent fluid. Only the effective density changes; the bulk modulus is the rigid-frame one. See limp_frame and decoupling_frequency.
  • Resonant sheets: the perforated-plate impedance uses the end-corrected air-plug mass and the visco-thermal surface resistance (Cox & D’Antonio Eqs. (7.6)/(7.12)/(7.21), end-correction variants of Table 7.1); the microperforated plate follows Maa’s exact short-tube impedance (Maa 1998, J. Acoust. Soc. Am. 104(5), Eq. (2), with the Eq. (5) end corrections; reproduced as Cox & D’Antonio Eqs. (7.33)-(7.35) and built on the same Bessel kernel as Mechel Sect. G.3); the membrane is the limp surface mass (Cox & D’Antonio Eq. (7.14); Bies Eq. (D.96)). Each sheet is closed by the shallow-cavity resonance it is designed around, helmholtz_resonance_frequency for a perforate and membrane_resonance_frequency for a membrane.

The air all of them propagate through is described by Fluid, which carries the six quantities a visco-thermal model can need (speed of sound, density, viscosity, Prandtl number, ratio of specific heats and static pressure), by default the fixed 20 degC values of ABSORBER_AIR. The narrow-channel models of slow_sound and metadiffuser take it as a single argument.

These are the elements a multilayer absorber is assembled from; declaring a stack of them and solving it with the transfer matrix is the subject of layered.

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

Constant (phonometry.fluids.Fluid).

airflow_resistivity_from_bulk_density(
bulk_density_kg_m3: float,
*,
fit: FiberResistivityFit,
) -> float

Airflow resistivity of a mineral wool from its bulk density (Eq. 1.165).

, the empirical relation Hopkins gives after Bies (1988) and Nichols (1947), with the fibre diameter in micrometres.

The relation is a straight line through measured points on a log-log plot, not a law, so it belongs to the material the points came from. Passing a bulk density outside the range the fit was made over emits a PorousAbsorberWarning naming both.

Parameters

Name Description
bulk_density_kg_m3 Bulk density of the wool, in kg/m3 (> 0).
fit The published k1, k2 pair to use, such as ROCK_WOOL_LONGITUDINAL_FIT.

Returns: The airflow resistivity r, in Pa s/m2.

Raises

Exception When
ValueError for a non-positive density.
TypeError if bulk_density_kg_m3 is not a single number.
check_limp_frame(
frame_bulk_modulus: float,
*,
criterion: Literal['beranek', 'doutres'] = 'doutres',
fluid_bulk_modulus: float = 101325.0,
) -> LimpFrameCheck

May the limp-frame model be used for this frame? (A&A 2e pp. 253-254).

With K_f taken as the isothermal bulk modulus of the fluid, kPa, the relaxed criterion of Doutres et al. is the book’s statement that “the limp model is applicable for materials having a bulk modulus lower than 20 kPa”. Neither criterion accounts for boundary or mounting conditions, and the book notes that a thin light foam decoupled from a vibrating structure by an air gap behaves limply well above the limit.

Parameters

Name Description
frame_bulk_modulus Bulk modulus of the frame in vacuum K_c, in Pa (>= 0; pass abs(K_c) for a complex modulus).
criterion Key into LIMP_FRAME_CRITERIA, "doutres" (Default, 0.2) or "beranek" (0.05).
fluid_bulk_modulus Bulk modulus of the pore fluid K_f, in Pa (Default: 101 325, the isothermal value for fluid).

Returns: The verdict, as a LimpFrameCheck; it passes when is below the threshold (the book prints both criteria as strict inequalities).

Raises

Exception When
ValueError for a negative modulus or an unknown criterion.
TypeError if criterion is not a text, or fluid_bulk_modulus or frame_bulk_modulus is not a single number.
decoupling_frequency(
flow_resistivity_pa_s_m2: float,
*,
porosity: float,
frame_density: float,
) -> float

Zwikker-Kosten decoupling frequency Fd of a porous frame.

(Allard & Atalla 2e, Sect. 11.3.4, printed p. 251; the same closed form as their Eq. (6.90), printed p. 126). Above Fd the visco-inertial coupling between the pore fluid and the frame is too weak for the acoustic wave to shake the frame, so the rigid-frame equivalent fluid of johnson_champoux_allard applies; below it the frame moves and the limp correction of limp_frame matters.

Parameters

Name Description
flow_resistivity_pa_s_m2 Airflow resistivity sigma, in Pa s/m2 (> 0).
porosity Open porosity phi (0 < phi <= 1).
frame_density Bulk density of the frame rho1, in kg/m3 (> 0): the mass of solid per unit volume of material, i.e. the density of the sample as weighed, not the density of the material the fibres are made of.

Returns: The decoupling frequency Fd, in hertz.

Raises

Exception When
ValueError for a non-positive input or a porosity above 1.
TypeError if flow_resistivity_pa_s_m2, frame_density or porosity is not a single number.
delany_bazley(
frequency: NumericArrayLike,
flow_resistivity_pa_s_m2: float,
*,
coefficients: Literal['delany_bazley', 'garai_pompoli', 'dunn_davern', 'wu'] | NumericArrayLike = 'delany_bazley',
fluid: Fluid = ...,
) -> PorousMediumResult

Delany-Bazley one-parameter porous model (power laws in X).

and with (Mechel 2e Sect. G.11 Eqs. (1)-(2); Bies 5e Eqs. (D.22)-(D.23) with the Table D.1 coefficients; Hopkins Eqs. (1.171)-(1.173)). A PorousAbsorberWarning is raised when any X leaves the stated validity range (Hopkins Eq. (1.174)); the values are still returned.

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
flow_resistivity_pa_s_m2 Airflow resistivity sigma, in Pa s/m2.
coefficients Preset name from DELANY_BAZLEY_COEFFICIENTS ("delany_bazley" rockwool/fibreglass default, "garai_pompoli" polyester, "dunn_davern" / "wu" foams) or the eight coefficients (C1..C8) as a sequence or an array of numbers.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: A PorousMediumResult.

Raises

Exception When
TypeError if flow_resistivity_pa_s_m2 is not a single number, frequency holds a text or a value that is not a real number, or coefficients is neither a preset name nor a sequence of numbers (a bytes, None, a text among the numbers).

Constant (mapping).

DELANY_BAZLEY_COEFFICIENTS = {'delany_bazley': (0.0571, 0.754, 0.087, 0.732, 0.0978, 0.7, 0.189, 0.595), 'garai_pompoli': (0.078, 0.623, 0.074, 0.66, 0.159, 0.571, 0.121, 0.53), 'dunn_davern': (0.114, 0.369, 0.0985, 0.758, 0.168, 0.715, 0.136, 0.491), 'wu': (0.212, 0.455, 0.105, 0.607, 0.163, 0.592, 0.188, 0.544)}

Constant (tuple).

DELANY_BAZLEY_VALIDITY = (0.01, 1.0)
fiber_characteristic_lengths(
fiber_radius_m: float,
*,
bulk_density_kg_m3: float,
fiber_density_kg_m3: float,
) -> FiberCharacteristicLengths

Both characteristic lengths of a fibrous layer, from its geometry.

Allard & Atalla Eqs. (5.29) and (5.30), PDF page 91 (printed p. 81), model the fibres as infinitely long cylinders of radius R and give, for a porosity close to 1,

where L is the total length of fibre per unit volume. Nobody measures L, so it is eliminated here through its own definition, which for cylinders is , leaving from three numbers a table does print. That substitution is arithmetic on the definition and not a second model.

This is a different model from viscous_characteristic_length, not a second opinion on the same one, and on Hopkins’ own rock wool the two drift apart with density: the cylinder model is the lower estimate throughout, by a factor of 1.4 at 38 kg/m3 and 1.9 at 155 kg/m3. Which to prefer is a question about the material, and neither is a substitute for measuring it.

Parameters

Name Description
fiber_radius_m Fibre radius R, in metres (> 0). A table that prints a diameter in micrometres wants half of it, divided by a million.
bulk_density_kg_m3 Bulk density of the layer, in kg/m3 (> 0), below the fibre density: the ratio of the two is the fibre volume fraction, and Eqs. (5.29) and (5.30) are stated for a porosity close to 1.
fiber_density_kg_m3 Density of the fibre itself, in kg/m3 (> 0).

Returns: The viscous and thermal lengths, in metres, as a FiberCharacteristicLengths.

Raises

Exception When
ValueError for a non-positive input, or a bulk density at or above the fibre density, which leaves no pore for a length to describe.
TypeError if bulk_density_kg_m3, fiber_density_kg_m3 or fiber_radius_m is not a single number.
FiberCharacteristicLengths(viscous_length_m: float, thermal_length_m: float)

The two characteristic lengths of a fibrous layer, in metres.

What fiber_characteristic_lengths returns: the viscous length and the thermal length , named, where a named tuple used to unpack them by position.

Attributes

Name Description
viscous_length_m The viscous characteristic length, in m.
thermal_length_m The thermal characteristic length, in m.
FiberResistivityFit(
*,
k1: float,
k2: float,
fiber_diameter_um: float,
bulk_density_range_kg_m3: NumericArrayLike,
direction: Literal['lateral', 'longitudinal'],
source: str,
)

A published k1, k2 pair of Hopkins Eq. (1.165), and its range.

The pair is not a property of mineral wool in general: k1 belongs to a material manufactured in a particular way and k2 to how its fibres are oriented, so the fit carries the fibre diameter it was made at and the bulk-density range it was fitted over, and using it outside that range is announced rather than silent.

Attributes

Name Description
k1 The constant of the manufacture.
k2 The exponent of the fibre orientation.
fiber_diameter_um Average fibre diameter of the fitted material, in micrometres, which is the unit Eq. (1.165) is written in.
bulk_density_range_kg_m3 The (low, high) the fit was made over.
direction "lateral" in the plane of the sheet or "longitudinal" through it. Mineral wool is anisotropic and the lateral resistivity is the lower of the two.
source Document, table or equation, PDF page and printed folio.
helmholtz_resonance_frequency(
*,
cavity_depth: float,
plate_thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float | None = None,
speed_of_sound: float = 343.0,
) -> float

Resonance of a perforated sheet over a shallow cavity (closed form).

with the end-corrected plug length (Cox & D’Antonio 3e, Eqs. (7.4)/(7.6), valid for ).

Parameters

Name Description
cavity_depth Cavity depth d, in metres.
plate_thickness_m Plate thickness t, in metres.
hole_radius Hole radius a, in metres.
open_area Fractional open area eps (0..1).
end_correction End-correction factor delta per end; default perforation_end_correction of eps.
speed_of_sound Speed of sound c in fluid, in m/s.

Returns: Resonance frequency f0, in hertz.

Raises

Exception When
TypeError if cavity_depth, end_correction, hole_radius, open_area, plate_thickness_m or speed_of_sound is not a single number.
johnson_champoux_allard(
frequency: NumericArrayLike,
flow_resistivity_pa_s_m2: float,
*,
porosity: float,
tortuosity: float,
viscous_length_m: float,
thermal_length_m: float,
fluid: Fluid = ...,
) -> PorousMediumResult

Johnson-Champoux-Allard five-parameter rigid-frame model.

Effective density (Cox & D’Antonio 3e, Eq. (6.19)):

and effective bulk modulus (Eq. (6.20)):

with tortuosity T, porosity phi, viscous/thermal characteristic lengths L / L'; then and (Eqs. (6.24)-(6.25)). Both quantities are surface-normalised (the factors are included). The model has the exact limits as and as (Johnson et al. 1987), pinned in the tests.

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
flow_resistivity_pa_s_m2 Airflow resistivity sigma, in Pa s/m2.
porosity Open porosity phi (0 < phi <= 1).
tortuosity High-frequency tortuosity (>= 1).
viscous_length_m Viscous characteristic length L, in metres.
thermal_length_m Thermal characteristic length L', in metres (physically ).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: A PorousMediumResult.

Raises

Exception When
TypeError if flow_resistivity_pa_s_m2, porosity, thermal_length_m, tortuosity or viscous_length_m is not a single number, or frequency holds a text or a value that is not a real number.
limp_frame(
medium: PorousMediumResult,
frame_density: float,
*,
porosity: float = 1.0,
) -> PorousMediumResult

Limp-frame correction of a rigid-frame equivalent fluid (A&A 11.3.4).

A light frame (aeronautic-grade fibreglass, felts, screens) is dragged along by the pore fluid instead of standing still, and the rigid-frame models of delany_bazley, miki and johnson_champoux_allard have no way to carry that inertia. Neglecting the stiffness of the frame altogether in the Biot mixed pressure-displacement formulation leaves an equivalent fluid with the same bulk modulus and a corrected effective density (Allard & Atalla 2e, Eqs. (11.53)-(11.55), printed pp. 252-253, after Panneton 2007):

with rho_eq the rigid-frame effective density of medium, rho0 the density of the pore fluid and the apparent total density of the material. What anchors this expression is the printed equation itself, transcribed term by term; Allard & Atalla tabulate no computed limp density anywhere, so there are no published digits to check against. The book also states two exact limits in prose, and both are verified, but they are weaker than they look: neither pins the and terms, since a sign-flipped variant of Eq. (11.55) satisfies both of them (and even the decay of the heavy-frame residual). They corroborate the transcription rather than determine it:

  • heavy frame: as the correction vanishes and the rigid-frame result is recovered (the book’s own reading of Eq. (11.55));
  • low frequency: since as (Eq. (5.37)), , a finite real density, where the rigid-frame model diverges. The rigid frame forbids rigid-body motion of the sample; the limp one allows it, which is why the two differ mainly at low frequency and why the limp model is the right one for an unconstrained sample in an impedance tube.

The corrected medium is a drop-in PorousMediumResult, so it can be handed to PorousLayer inside layered_absorber exactly like the rigid-frame one.

Use decoupling_frequency to see where the frame stops following the fluid and check_limp_frame for the published bulk-modulus rule of thumb on when the frame may be treated as limp at all.

Parameters

Name Description
medium A rigid-frame PorousMediumResult (its effective_density is rho_eq and its bulk_modulus is kept).
frame_density Bulk density of the frame rho1, in kg/m3 (> 0).
porosity Open porosity phi (0 < phi <= 1, Default: 1.0, the high-porosity assumption of the one-parameter models).

Returns: A PorousMediumResult with model "limp_frame(<base model>)".

Raises

Exception When
ValueError for a non-positive input or a porosity above 1.
TypeError if frame_density or porosity is not a single number.

Constant (mapping).

LIMP_FRAME_CRITERIA = {'beranek': 0.05, 'doutres': 0.2}
LimpFrameCheck(
frame_bulk_modulus: float,
*,
criterion: Literal['beranek', 'doutres'] = 'doutres',
fluid_bulk_modulus: float = 101325.0,
)

Whether the limp-frame model may be used, by a published rule of thumb.

Both published criteria compare the bulk modulus of the frame in vacuum K_c with that of the fluid in the pores K_f (Allard & Atalla 2e, printed pp. 253-254): Beranek (1947) requires , and the frame structural interaction study of Doutres et al. (2007) relaxes it to . The threshold, the ratio and the verdict are read from the criterion and the two moduli, so they are not fields: a check cannot be built against another threshold.

Attributes

Name Description
frame_bulk_modulus Bulk modulus of the frame in vacuum K_c, in Pa (>= 0; abs(K_c) for a complex modulus).
criterion Key into LIMP_FRAME_CRITERIA, "doutres" (Default, 0.2) or "beranek" (0.05).
fluid_bulk_modulus Bulk modulus of the pore fluid K_f, in Pa.

property

The verdict: the ratio is below the threshold, strictly, as printed.

Judged settled to nine decimals, so moduli whose ratio is the printed threshold in decimal are on it, and a ratio on the threshold does not pass.

property

, the ratio judged.

property

The bound must stay below.

membrane_impedance(
frequency: float | np.floating[Any] | np.integer[Any],
*,
surface_density: float,
resistance: float = ...,
) -> complex
membrane_impedance(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
surface_density: float,
resistance: float = ...,
) -> NDArray[np.complex128]
membrane_impedance(
frequency: NumericArrayLike,
*,
surface_density: float,
resistance: float = ...,
) -> complex | NDArray[np.complex128]

Transfer impedance of a limp impervious membrane.

: the surface-mass reactance (Cox & D’Antonio 3e, Eq. (7.14); Bies 5e Eq. (D.96)) plus an optional empirical resistance for the internal/fixing losses.

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
surface_density Mass per unit area m, in kg/m2.
resistance Series flow resistance r, in Pa s/m (default 0).

Returns: Complex transfer impedance z, in Pa s/m. A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if resistance or surface_density is not a single number, or frequency holds a text or a value that is not a real number.
membrane_resonance_frequency(
*,
surface_density: float,
cavity_depth: float,
isothermal: bool = False,
fluid: Fluid = ...,
) -> float

Mass-spring resonance of a membrane over a shallow cavity.

for an adiabatic air spring, numerically the classical (Cox & D’Antonio 3e, Eq. (7.9)). With isothermal=True the spring stiffness drops by gamma, giving (Eq. (7.10)), the porous-filled cavity case below about 500 Hz.

Parameters

Name Description
surface_density Membrane mass per unit area m, in kg/m2.
cavity_depth Cavity depth d, in metres.
isothermal Use the isothermal air-spring stiffness.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: Resonance frequency f0, in hertz.

Raises

Exception When
TypeError if cavity_depth or surface_density is not a single number.
microperforated_plate_impedance(
frequency: float | np.floating[Any] | np.integer[Any],
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float = ...,
fluid: Fluid = ...,
) -> complex
microperforated_plate_impedance(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float = ...,
fluid: Fluid = ...,
) -> NDArray[np.complex128]
microperforated_plate_impedance(
frequency: NumericArrayLike,
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float = ...,
fluid: Fluid = ...,
) -> complex | NDArray[np.complex128]

Transfer impedance of a microperforated plate (Maa’s exact model).

The specific impedance of one submillimetre hole is the exact short-tube result (Maa 1998, Eq. (2); reproduced as Cox & D’Antonio 3e Eq. (7.33) and the same Bessel kernel as Mechel 2e Sect. G.3):

with the perforate constant . Dividing by the open area and adding Maa’s Eq. (5) end corrections, the Rayleigh/Ingard surface resistance and the piston end-correction reactance ( total for the default per end), gives the sheet transfer impedance (Cox & D’Antonio Eq. (7.35)).

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
thickness_m Plate thickness t, in metres.
hole_radius Hole radius a, in metres (submillimetre for a genuine microperforated design).
open_area Fractional open area eps (0..1).
end_correction End-correction factor delta per end (default 0.85, the isolated-orifice value used by Maa).
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: Complex transfer impedance z, in Pa s/m. A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if end_correction, hole_radius, open_area or thickness_m is not a single number, or frequency holds a text or a value that is not a real number.
miki(
frequency: NumericArrayLike,
flow_resistivity_pa_s_m2: float,
*,
fluid: Fluid = ...,
) -> PorousMediumResult

Miki (1990) positive-real modification of the Delany-Bazley model.

In the variable (Miki 1990, Eqs. (30)-(34)): and, from the propagation constant via , . The regression was constrained to be positive real, so the surface impedance of a hard-backed layer keeps a non-negative real part even below the Delany-Bazley range; a PorousAbsorberWarning still flags Y outside the fit range (paper Sect. 4.1).

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
flow_resistivity_pa_s_m2 Airflow resistivity sigma, in Pa s/m2.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: A PorousMediumResult.

Raises

Exception When
TypeError if flow_resistivity_pa_s_m2 is not a single number, or frequency holds a text or a value that is not a real number.

Constant (tuple).

MIKI_VALIDITY = (0.01, 1.0)
perforated_plate_impedance(
frequency: float | np.floating[Any] | np.integer[Any],
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float | None = ...,
fluid: Fluid = ...,
) -> complex
perforated_plate_impedance(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float | None = ...,
fluid: Fluid = ...,
) -> NDArray[np.complex128]
perforated_plate_impedance(
frequency: NumericArrayLike,
*,
thickness_m: float,
hole_radius: float,
open_area: float,
end_correction: float | None = ...,
fluid: Fluid = ...,
) -> complex | NDArray[np.complex128]

Transfer impedance of a rigid perforated plate with circular holes.

Acoustic mass with both end corrections and the boundary-layer term (Cox & D’Antonio 3e, Eq. (7.6)):

and visco-thermal surface resistance (Eq. (7.12)):

giving (the series impedance added on top of the backing, Eq. (7.21)). Assumes hole radii well above the boundary-layer thickness; use microperforated_plate_impedance for submillimetre holes.

Parameters

Name Description
frequency Frequency f, in hertz (scalar or array).
thickness_m Plate thickness t, in metres.
hole_radius Hole radius a, in metres.
open_area Fractional open area eps (0..1).
end_correction End-correction factor delta per end; default perforation_end_correction of eps.
fluid The medium, a Fluid (Default: ABSORBER_AIR, dry air at 20 degC at textbook values). Pass a computed one, such as fluids.air(temperature_c=30.0, relative_humidity_percent=70.0), to work in the air of the room.

Returns: Complex transfer impedance z, in Pa s/m. A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if end_correction, hole_radius, open_area or thickness_m is not a single number, or frequency holds a text or a value that is not a real number.
perforation_end_correction(open_area: float) -> float

End-correction factor delta of a circular perforation.

The Fok-function interaction correction for circular holes (Cox & D’Antonio 3e, Table 7.1, Nesterov row; no open-area limit):

Each orifice end adds of air-plug length, and for an isolated hole.

Parameters

Name Description
open_area Fractional open area eps of the sheet (0..1).

Returns: End-correction factor delta (dimensionless, per end).

Raises

Exception When
TypeError if open_area is not a single number.
plot_absorber_stack(
layers: Sequence[AirLayer | PorousLayer | PerforatedPlateLayer | MicroperforatedPlateLayer | MembraneLayer | PoroelasticLayer] | AirLayer | PorousLayer | PerforatedPlateLayer | MicroperforatedPlateLayer | MembraneLayer | PoroelasticLayer,
*,
ax: Axes | None = None,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw a layered-absorber cross-section to scale, rigid backing at right.

Sound arrives from the left; each layer is drawn with its material fill and its thickness dimensioned below the stack. A membrane (no physical depth) is drawn as a thin sheet.

Parameters

Name Description
layers The layer sequence of layered_absorber, front layer first, or a single layer.
ax Existing axes, or None to create a figure.
language Label language, "en" (default) or "es".
kwargs Forwarded to the front-layer rectangle.

Returns: The axes.

porosity_from_bulk_density(
bulk_density_kg_m3: float,
*,
fiber_density_kg_m3: float,
) -> float

Porosity of a fibrous material from its two densities (Eq. 1.160).

, which holds when the fibres are solid and whatever binds them together has negligible mass. Hopkins states both conditions.

It closes on its own data: at the 2 600 kg/m3 fibre density and the 31 to 155 kg/m3 bulk-density range Hopkins prints for his rock wool, this returns 0.99 and 0.94, which is the porosity range he prints beside them.

Parameters

Name Description
bulk_density_kg_m3 Bulk density of the material, in kg/m3 (> 0).
fiber_density_kg_m3 Density of the fibre itself, in kg/m3, larger than the bulk density.

Returns: The open porosity phi, between 0 and 1.

Raises

Exception When
ValueError for a non-positive density, or a bulk density at or above the fibre density, which is not a porous material.
TypeError if bulk_density_kg_m3 or fiber_density_kg_m3 is not a single number.

Advisory for porous-model use outside the published fit range.

PorousMediumResult(
*,
frequencies: NDArray[np.float64],
characteristic_impedance: NDArray[np.complex128],
wavenumber: NDArray[np.complex128],
effective_density: NDArray[np.complex128],
bulk_modulus: NDArray[np.complex128],
model: str,
flow_resistivity_pa_s_m2: float,
speed_of_sound: float,
air_density: float,
)

Equivalent-fluid characterisation of a porous material.

All arrays share the shape of frequencies. characteristic_impedance is the complex characteristic impedance Zc in Pa s/m as seen from the material surface, wavenumber the complex wavenumber k in rad/m ( for the convention), effective_density and bulk_modulus the surface-normalised equivalent-fluid density and bulk modulus, so that and for every model.

property

Characteristic impedance normalised by of fluid.

property

Wavenumber normalised by the free-air wavenumber .

PorousMediumResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the normalised Zc and k components against frequency.

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

Parameters

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

Constant (float).

ROCK_WOOL_FIBER_DENSITY_KG_M3 = 2600.0

Constant (phonometry.materials.absorbers.porous.FiberResistivityFit).

Constant (phonometry.materials.absorbers.porous.FiberResistivityFit).

viscous_characteristic_length(
flow_resistivity_pa_s_m2: float,
*,
porosity: float,
tortuosity: float,
fluid: Fluid = ...,
shape_factor: float = 1.0,
) -> float

The viscous characteristic length from the three measured parameters.

, Allard & Atalla Eq. (5.25), PDF page 90 (printed p. 80), after Johnson et al. (1986), with c close to 1.

How close is the question the shape factor exists for, and it is worth saying what “close” buys. Against the twenty-three specimens Allard & Atalla print with all four columns, c = 1 puts within a factor of two of the printed length for eighteen of them, with the middle of the set near 1.2. The five it misses are the two carpets, the woven screen and two rows whose lengths the book itself took from a different model, and there the same arithmetic wants a c between 2 and 9.5.

So estimating this length rather than measuring it is worth a factor of two on a bulk fibrous or open-cell absorber, and nothing at all on a floor covering or a screen.

Parameters

Name Description
flow_resistivity_pa_s_m2 Airflow resistivity sigma, in Pa s/m2 (> 0).
porosity Open porosity phi, between 0 and 1.
tortuosity Tortuosity alpha_infinity (>= 1).
fluid The saturating fluid, for its dynamic viscosity eta.
shape_factor The c of Eq. (5.25) (> 0). One, unless the micro-geometry is known well enough to say otherwise.

Returns: The viscous characteristic length Lambda, in metres.

Raises

Exception When
ValueError for a non-positive input or a porosity out of range.
TypeError if flow_resistivity_pa_s_m2, porosity, shape_factor or tortuosity is not a single number.