Ir al contenido

building.prediction.masonry_cavity_wall

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.

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(
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,
) -> WallTieCouplingResult

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

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(
tie: Literal['butterfly', 'double_triangle', 'vertical_twist', 'vertical_twist_100mm'],
) -> WallTieStiffness

Look 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(
ties_per_area: float,
tie: Literal['butterfly', 'double_triangle', 'vertical_twist', 'vertical_twist_100mm'] | float,
) -> float

Stiffness 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(
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(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot 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(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.