building.prediction.masonry_cavity_wall
Wall ties in masonry cavity walls: the structural bridge across the cavity (Hopkins 2007, Sections 3.11.3.2 and 4.3.5.4.1).
A masonry cavity wall is a double leaf, and the textbook double-leaf prediction
(phonometry.building.double_wall_transmission_loss) treats the cavity
as pure air. Real cavity walls are stitched together by wall ties every few
courses. Those ties do two things the air-only model cannot see: they add a
mechanical spring in parallel with the air spring, which pushes the
mass-spring-mass resonance up, and they open a structure-borne path from one
leaf to the other, which caps the insulation the pair can reach.
Dynamic stiffness of a tie (Section 3.11.3.2). A tie is characterised by a
single number sX mm, its dynamic stiffness at a cavity width X,
measured on two nominally identical 100 mm concrete cubes from the
mass-spring-mass resonance of the pair,
(Eq. 3.202).
WALL_TIE_STIFFNESS carries Hopkins’ Table A4, whose 50 mm
rows come from Hopkins, Wilson & Craik (1999) and whose 100 mm row comes from
Hall & Hopkins (2001).
The tie array as a spring in parallel with the air (Eq. 4.89). N ties
over a plate of area S add to the cavity air stiffness
s_a:
Below fmsm the two leaves move as one plate of the combined mass. Stiff ties
are therefore doubly bad: they raise the resonance into the rating range and
bridge the cavity. Use wall_tie_stiffness_per_area and pass the result
as tie_stiffness_per_area to
phonometry.building.mass_spring_mass_resonance or
phonometry.building.double_wall_transmission_loss.
The structure-borne path (Eqs. 4.84 to 4.88). Each tie is a point
connection between two plates. With the driving-point mobilities Yi,
Yj of the two leaves (infinite thin plates,
, Eq. 2.190) and the connector mobility of a
linear spring (Eq. 4.88), N identical
uncorrelated connections give the coupling loss factor
The plate area cancels ( with n ties per m2),
so wall_tie_coupling_loss_factor needs only the tie density. A rigid
connection (screw, nail, bolt, or a tie so stiff it never yields) is the
limit , where the only frequency dependence left is the
and falls as . Once
overtakes the plate mobilities a resilient tie adds
two more powers, so falls as and the ratio
to the rigid ceiling as . That is exactly why a butterfly tie at
1.7 MN/m and a vertical-twist tie at 94 MN/m behave so differently: the soft
one enters that regime inside the building acoustics range, the stiff one
stays on the rigid ceiling for another two octaves.
Auto-generated from the source docstrings by
scripts/generate_api_docs.py(make api-docs). Do not edit by hand.
wall_tie_coupling_loss_factor
Section titled “wall_tie_coupling_loss_factor”wall_tie_coupling_loss_factor( frequency: NumericArrayLike, mass1: float, mass2: float, bending_stiffness1: float, bending_stiffness2: float, *, ties_per_area: float, tie: Literal['butterfly', 'double_triangle', 'vertical_twist', 'vertical_twist_100mm'] | float | None = None,) -> WallTieCouplingResultCoupling loss factor of a wall-tie array (Hopkins Eqs. 4.87 and 4.88).
for N identical, uncorrelated point connections, with the leaves
modelled as infinite thin plates (,
Eq. 2.190) and each tie as a linear spring (,
Eq. 4.88). Since and , the plate
area cancels and only the tie density n enters.
Parameters
| Name | Description |
|---|---|
frequency |
Frequency f, in hertz (scalar or array, > 0). |
mass1 |
Surface density rho_s1 of the excited leaf, in kg/m^2 (> 0). |
mass2 |
Surface density rho_s2 of the receiving leaf, in kg/m^2 (> 0). |
bending_stiffness1 |
Bending stiffness per unit width B' of leaf 1, in N.m (> 0); see phonometry.vibration.structural.point_mobility.plate_bending_stiffness. |
bending_stiffness2 |
Bending stiffness per unit width of leaf 2, in N.m. |
ties_per_area |
Number of ties per unit area n, in 1/m^2 (> 0). |
tie |
A name from WALL_TIE_STIFFNESS, an explicit dynamic stiffness k in N/m, or None for a rigid connection (, the screw/nail/bolt limit). One of "butterfly", "double_triangle", "vertical_twist" or "vertical_twist_100mm". |
Returns: A WallTieCouplingResult.
Raises
| Exception | When |
|---|---|
| ValueError | for a non-positive input or an unknown tie name. |
| TypeError | if mass1, mass2, tie or ties_per_area is not a single number, or frequency holds a text or a value that is not a real number, or bending_stiffness1 or bending_stiffness2 is not a single number. |
WALL_TIE_STIFFNESS
Section titled “WALL_TIE_STIFFNESS”Constant (mapping).
WALL_TIE_STIFFNESS = {'butterfly': WallTieStiffness(cavity_width_m=0.05, stiffness=1700000.0), 'double_triangle': WallTieStiffness(cavity_width_m=0.05, stiffness=16100000.0), 'vertical_twist': WallTieStiffness(cavity_width_m=0.05, stiffness=94000000.0), 'vertical_twist_100mm': WallTieStiffness(cavity_width_m=0.1, stiffness=43400000.0)}wall_tie_stiffness
Section titled “wall_tie_stiffness”wall_tie_stiffness( tie: Literal['butterfly', 'double_triangle', 'vertical_twist', 'vertical_twist_100mm'],) -> WallTieStiffnessLook up a wall tie in Hopkins Table A4.
Parameters
| Name | Description |
|---|---|
tie |
One of "butterfly", "double_triangle", "vertical_twist" (all at a 50 mm cavity) or "vertical_twist_100mm". |
Returns: The row, as a WallTieStiffness: the cavity width in m at which the tie was measured (cavity_width_m) and its dynamic stiffness sX mm in N/m (stiffness).
Raises
| Exception | When |
|---|---|
| ValueError | for an unknown tie name. |
| TypeError | if tie is not a text. |
wall_tie_stiffness_per_area
Section titled “wall_tie_stiffness_per_area”wall_tie_stiffness_per_area( ties_per_area: float, tie: Literal['butterfly', 'double_triangle', 'vertical_twist', 'vertical_twist_100mm'] | float,) -> floatStiffness per unit area of a tie array, (Hopkins Eq. 4.89).
The term that acts in parallel with the cavity air stiffness s_a in the
mass-spring-mass resonance. Feed it to
phonometry.building.mass_spring_mass_resonance or
phonometry.building.double_wall_transmission_loss as
tie_stiffness_per_area.
Parameters
| Name | Description |
|---|---|
ties_per_area |
Number of ties per unit area , in 1/m^2 (> 0). |
tie |
A name from WALL_TIE_STIFFNESS, or an explicit dynamic stiffness k of one tie, in N/m (> 0). One of "butterfly", "double_triangle", "vertical_twist" or "vertical_twist_100mm". |
Returns: The stiffness per unit area , in N/m^3.
Raises
| Exception | When |
|---|---|
| ValueError | for a non-positive input or an unknown tie name. |
| TypeError | if tie or ties_per_area is not a single number. |
WallTieCouplingResult
Section titled “WallTieCouplingResult”WallTieCouplingResult( frequencies: NDArray[np.float64], coupling_loss_factor: NDArray[np.float64], mobility1: float, mobility2: float, connector_mobility: NDArray[np.float64], ties_per_area: float, tie_stiffness: float | None, rigid_coupling_loss_factor: NDArray[np.float64],)Structure-borne coupling of a wall-tie array (Hopkins Eqs. 4.87/4.88).
Attributes
| Name | Description |
|---|---|
frequencies |
Frequencies, in hertz. |
coupling_loss_factor |
Coupling loss factor eta_ij from leaf 1 to leaf 2 per frequency (dimensionless). |
mobility1 |
Driving-point mobility Yi of leaf 1, in m/(N.s). |
mobility2 |
Driving-point mobility Yj of leaf 2, in m/(N.s). |
connector_mobility |
Magnitude of the tie mobility per frequency, in m/(N.s); all zeros for a rigid connection. |
ties_per_area |
Number of ties per unit area n, in 1/m^2. |
tie_stiffness |
Dynamic stiffness k of one tie, in N/m, or None for a rigid connection. |
rigid_coupling_loss_factor |
The coupling loss factor per frequency, the ceiling a resilient tie is measured against. |
WallTieCouplingResult.plot()
Section titled “WallTieCouplingResult.plot()”WallTieCouplingResult.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesPlot eta_ij(f) against the rigid-connection ceiling.
Requires matplotlib (the [plot] extra); returns the
Axes.
Parameters
| Name | Description |
|---|---|
language |
The language of the labels: "en" or "es". |
WallTieStiffness
Section titled “WallTieStiffness”WallTieStiffness(cavity_width_m: float, stiffness: float)The dynamic stiffness of a wall tie and the cavity it was measured at.
A row of WALL_TIE_STIFFNESS (Hopkins Table A4), and what
wall_tie_stiffness returns, named, where a (cavity width, stiffness) tuple used to be unpacked by position.
Attributes
| Name | Description |
|---|---|
cavity_width_m |
The cavity width the tie was measured at, in m. |
stiffness |
Its dynamic stiffness sX mm, in N/m. |