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.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.mass_spring_mass_resonance or phonometry.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: ArrayLike,
mass1: float,
mass2: float,
bending_stiffness1: float,
bending_stiffness2: float,
*,
ties_per_area: float,
tie: str | 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

NameDescription
frequencyFrequencies f, in hertz (array, > 0).
mass1Surface density rho_s1 of the excited leaf, in kg/m^2 (> 0).
mass2Surface density rho_s2 of the receiving leaf, in kg/m^2 (> 0).
bending_stiffness1Bending stiffness per unit width B' of leaf 1, in N.m (> 0); see phonometry.vibration.structural.point_mobility.plate_bending_stiffness.
bending_stiffness2Bending stiffness per unit width of leaf 2, in N.m.
ties_per_areaNumber of ties per unit area n, in 1/m^2 (> 0).
tieA name from WALL_TIE_STIFFNESS, an explicit dynamic stiffness k in N/m, or None for a rigid connection (, the screw/nail/bolt limit).

Returns: A WallTieCouplingResult.

Raises

ExceptionWhen
ValueErrorfor a non-positive input or an unknown tie name.

Constant (dict).

WALL_TIE_STIFFNESS = {'butterfly': (0.05, 1700000.0), 'double_triangle': (0.05, 16100000.0), 'vertical_twist': (0.05, 94000000.0), 'vertical_twist_100mm': (0.1, 43400000.0)}
wall_tie_stiffness(tie: str) -> tuple[float, float]

Look up a wall tie in Hopkins Table A4.

Parameters

NameDescription
tieOne of "butterfly", "double_triangle", "vertical_twist" (all at a 50 mm cavity) or "vertical_twist_100mm".

Returns: (cavity_width, stiffness): the cavity width in m at which the tie was measured, and its dynamic stiffness sX mm in N/m.

Raises

ExceptionWhen
ValueErrorfor an unknown tie name.
wall_tie_stiffness_per_area(ties_per_area: float, tie: str | 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.mass_spring_mass_resonance or phonometry.double_wall_transmission_loss as tie_stiffness_per_area.

Parameters

NameDescription
ties_per_areaNumber of ties per unit area , in 1/m^2 (> 0).
tieA name from WALL_TIE_STIFFNESS, or an explicit dynamic stiffness k of one tie, in N/m (> 0).

Returns: The stiffness per unit area , in N/m^3.

Raises

ExceptionWhen
ValueErrorfor a non-positive input or an unknown tie name.
WallTieCouplingResult(
frequencies: np.ndarray,
coupling_loss_factor: np.ndarray,
mobility1: float,
mobility2: float,
connector_mobility: np.ndarray,
ties_per_area: float,
tie_stiffness: float | None,
rigid_coupling_loss_factor: np.ndarray,
)

Structure-borne coupling of a wall-tie array (Hopkins Eqs. 4.87/4.88).

Attributes

NameDescription
frequenciesFrequencies, in hertz.
coupling_loss_factorCoupling loss factor eta_ij from leaf 1 to leaf 2 per frequency (dimensionless).
mobility1Driving-point mobility Yi of leaf 1, in m/(N.s).
mobility2Driving-point mobility Yj of leaf 2, in m/(N.s).
connector_mobilityMagnitude of the tie mobility per frequency, in m/(N.s); all zeros for a rigid connection.
ties_per_areaNumber of ties per unit area n, in 1/m^2.
tie_stiffnessDynamic stiffness k of one tie, in N/m, or None for a rigid connection.
rigid_coupling_loss_factorThe coupling loss factor per frequency, the ceiling a resilient tie is measured against.
WallTieCouplingResult.plot(
ax: Axes | None = None,
*,
language: str = 'en',
**kwargs: Any,
) -> Axes

Plot eta_ij(f) against the rigid-connection ceiling.

Requires matplotlib (pip install phonometry[plot]); returns the Axes.