Ir al contenido

vibration.structural.radiation_efficiency

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.

Radiation efficiency of a plate in bending (Hopkins 2007, Sound Insulation, Section 2.9; Leppington et al. 1982; Maidanik 1962).

The radiation efficiency sigma of a vibrating plate relates the airborne sound power it radiates, in watts, to its mean-square surface velocity:

so sigma is exactly the radiation factor epsilon that phonometry.sound_power_from_vibration (ISO/TS 7849) otherwise takes as a measured input: this module predicts it from the plate geometry and its coincidence (critical) frequency, closing the ISO 7849 chain without a power measurement, and it supplies the resonant transmission path of the single- and double-leaf sound-reduction-index predictions in phonometry.building.prediction.panel_transmission.

Coincidence (critical) frequency (Hopkins Eq. 2.201). Below it the free bending wavelength is shorter than the acoustic wavelength, so the plate radiates weakly; above it the bending wave is supersonic and radiates efficiently:

with m'' the mass per unit area (kg/m^2) and B' the bending stiffness per unit width (N.m). This is the closed form in terms of the plate longitudinal wave speed cL and thickness h.

Frequency-averaged efficiency (Hopkins 2.9.4, “method no. 1”). With (Eq. 2.228), the perimeter U, area S, the boundary constant (1 simply supported, 2 clamped) and the baffle-orientation constant (1 plate flush in an infinite baffle, 2 baffles perpendicular to the edges), the efficiency below fc is

with the acoustic wavenumber. Above fc, (Eq. 2.229), so well above coincidence. In the band that contains fc,

with L1 the smaller and L2 the larger plate dimension.

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

coincidence_frequency(
mass_per_area: float,
bending_stiffness: float,
*,
speed_of_sound: float = 343.0,
) -> float

Coincidence (critical) frequency fc of a thin plate (Hopkins 2.201).

(identical to Bies Eq. 7.3).

Parameters

NameDescription
mass_per_areaMass per unit area m'', in kg/m^2.
bending_stiffnessBending stiffness per unit width B', in N.m (see phonometry.vibration.structural.point_mobility.plate_bending_stiffness).
speed_of_soundSpeed of sound in air c0 (Default: 343 m/s).

Returns: The coincidence frequency fc, in hertz.

Raises

ExceptionWhen
ValueErrorfor a non-positive input.
plot_plate_geometry(
length_x: float,
length_y: float,
ax: Axes | None = None,
*,
boundary: str = 'simply_supported',
language: str = 'en',
**kwargs: Any,
) -> Axes

Draw the baffled rectangular plate of the radiation model, to scale.

Plate a x b inside its baffle frame, boundary condition in the title.

Parameters

NameDescription
length_xPlate length a, in metres.
length_yPlate width b, in metres.
axExisting axes, or None to create a figure.
boundaryBoundary-condition label of the model.
languageLabel language, "en" (default) or "es".
kwargsForwarded to the plate rectangle.

Returns: The axes.

radiation_efficiency(
frequency: ArrayLike,
length_x: float,
length_y: float,
critical_frequency: float,
*,
boundary: str = 'simply_supported',
baffle: str = 'infinite',
speed_of_sound: float = 343.0,
) -> RadiationEfficiencyResult

Frequency-averaged radiation efficiency of a plate (Hopkins 2.9.4).

Implements Hopkins “method no. 1” (Eqs 2.227, 2.229, 2.230): the below-, above- and at-coincidence expressions of Leppington/Maidanik. The band whose centre lies closest (on a log scale) to critical_frequency uses the at-coincidence expression (Eq. 2.230); all others use the below/above expressions.

Parameters

NameDescription
frequencyBand centre frequencies f, in hertz (array, > 0).
length_xPlate dimension Lx, in m (> 0).
length_yPlate dimension Ly, in m (> 0).
critical_frequencyCoincidence frequency fc, in hertz (> 0); see coincidence_frequency.
boundary"simply_supported" () or "clamped" ().
baffle"infinite" (, plate flush in a rigid baffle) or "perpendicular" (, baffles perpendicular to the edges).
speed_of_soundSpeed of sound in air c0 (Default: 343 m/s).

Returns: A RadiationEfficiencyResult.

Raises

ExceptionWhen
ValueErrorfor a non-positive input or unknown boundary/baffle.
RadiationEfficiencyResult(
frequencies: np.ndarray,
radiation_efficiency: np.ndarray,
critical_frequency: float,
length_x: float,
length_y: float,
boundary: str,
baffle: str,
)

Frequency-averaged plate radiation efficiency (Hopkins 2.9.4).

Attributes

NameDescription
frequenciesBand centre frequencies, in hertz.
radiation_efficiencyRadiation efficiency sigma per band.
critical_frequencyCoincidence frequency fc, in hertz.
length_xPlate dimension Lx, in m.
length_yPlate dimension Ly, in m.
boundaryBoundary condition ("simply_supported" / "clamped").
baffleBaffle orientation ("infinite" / "perpendicular").
RadiationEfficiencyResult.plot(
ax: Axes | None = None,
*,
language: str = 'en',
**kwargs: Any,
) -> Axes

Plot the radiation efficiency sigma(f) on log-log axes.

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

RadiationEfficiencyResult.plot_geometry(
ax: Axes | None = None,
*,
language: str = 'en',
**kwargs: Any,
) -> Axes

Draw the baffled plate to scale.

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

property

Radiation index per band, in dB.