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
Section titled “coincidence_frequency”coincidence_frequency( mass_per_area: float, bending_stiffness: float, *, speed_of_sound: float = 343.0,) -> floatCoincidence (critical) frequency fc of a thin plate (Hopkins 2.201).
(identical to Bies Eq. 7.3).
Parameters
| Name | Description |
|---|---|
mass_per_area | Mass per unit area m'', in kg/m^2. |
bending_stiffness | Bending stiffness per unit width B', in N.m (see phonometry.vibration.structural.point_mobility.plate_bending_stiffness). |
speed_of_sound | Speed of sound in air c0 (Default: 343 m/s). |
Returns: The coincidence frequency fc, in hertz.
Raises
| Exception | When |
|---|---|
| ValueError | for a non-positive input. |
plot_plate_geometry
Section titled “plot_plate_geometry”plot_plate_geometry( length_x: float, length_y: float, ax: Axes | None = None, *, boundary: str = 'simply_supported', language: str = 'en', **kwargs: Any,) -> AxesDraw the baffled rectangular plate of the radiation model, to scale.
Plate a x b inside its baffle frame, boundary condition in the title.
Parameters
| Name | Description |
|---|---|
length_x | Plate length a, in metres. |
length_y | Plate width b, in metres. |
ax | Existing axes, or None to create a figure. |
boundary | Boundary-condition label of the model. |
language | Label language, "en" (default) or "es". |
kwargs | Forwarded to the plate rectangle. |
Returns: The axes.
radiation_efficiency
Section titled “radiation_efficiency”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,) -> RadiationEfficiencyResultFrequency-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
| Name | Description |
|---|---|
frequency | Band centre frequencies f, in hertz (array, > 0). |
length_x | Plate dimension Lx, in m (> 0). |
length_y | Plate dimension Ly, in m (> 0). |
critical_frequency | Coincidence 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_sound | Speed of sound in air c0 (Default: 343 m/s). |
Returns: A RadiationEfficiencyResult.
Raises
| Exception | When |
|---|---|
| ValueError | for a non-positive input or unknown boundary/baffle. |
RadiationEfficiencyResult
Section titled “RadiationEfficiencyResult”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
| Name | Description |
|---|---|
frequencies | Band centre frequencies, in hertz. |
radiation_efficiency | Radiation efficiency sigma per band. |
critical_frequency | Coincidence frequency fc, in hertz. |
length_x | Plate dimension Lx, in m. |
length_y | Plate dimension Ly, in m. |
boundary | Boundary condition ("simply_supported" / "clamped"). |
baffle | Baffle orientation ("infinite" / "perpendicular"). |
RadiationEfficiencyResult.plot()
Section titled “RadiationEfficiencyResult.plot()”RadiationEfficiencyResult.plot( ax: Axes | None = None, *, language: str = 'en', **kwargs: Any,) -> AxesPlot the radiation efficiency sigma(f) on log-log axes.
Requires matplotlib (pip install phonometry[plot]); returns the
Axes.
RadiationEfficiencyResult.plot_geometry()
Section titled “RadiationEfficiencyResult.plot_geometry()”RadiationEfficiencyResult.plot_geometry( ax: Axes | None = None, *, language: str = 'en', **kwargs: Any,) -> AxesDraw the baffled plate to scale.
Requires matplotlib (pip install phonometry[plot]); returns the
Axes.
RadiationEfficiencyResult.radiation_index
Section titled “RadiationEfficiencyResult.radiation_index”property
Radiation index per band, in dB.