Ir al contenido

building.prediction.installed_structure_borne

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.

Installed structure-borne sound from service equipment (EN 12354-5:2009).

EN 12354-5 predicts the sound pressure level in a receiving room caused by building service equipment that injects structure-borne sound into the building. The chain closes the structural-vibroacoustics series:

  1. The source strength is its characteristic structure-borne sound power level L_Ws,c. It is not the raw reception-plate power of EN 15657 Formula (14): that plate-injected level must first be converted to the plate-independent L_Ws,n (EN 15657 Formulae (15)/(17); see phonometry.building.measurement.structure_borne_power) and then referred to the actual receiver with the Annex I mobility correction (installed_power_from_reception_plate), with the reference plate mobility m/(N.s), or equivalently to the characteristic level with the source mobility (Annex I.3, Table I.8), from which D_C is subtracted.
  2. Only part of that power is actually injected into the supporting element; the loss is the coupling term D_C (clause 4.4.3), positive in the usual mobility-mismatched cases (see coupling_term for the exception), set by the source mobility Y_s and the receiver mobility Y_i (Formula 19b): , which reduces to for a force source (high source mobility, Formula 19c) and to for a velocity source (low source mobility, Formula 19d). An elastic support adds its transfer mobility Y_k inside the modulus (Formula 19e).
  3. The installed power level is then (Formula 18b).
  4. The normalised sound pressure level in the receiving room for one path (i->j) follows from the installed power, the structure-to-airborne adjustment term D_sa (clause 4.4.4), the flanking sound reduction index R_ij,ref and the element area (Formula 18a): with m²; the paths combine energetically (Formula 17).

The source and receiver mobilities/impedances are those of phonometry.vibration.structural.mechanical_mobility and phonometry.vibration.structural.transfer_stiffness.

The informative tables. Every term of that chain is a number the user would otherwise copy out of the standard, so the two tables of the informative annexes are here as named lookups:

Annex F also supplies the two terms step 4 takes: the adjustment term D_sa of Formula (F.3) (structure_to_airborne_adjustment) and the multi-junction adjustment dK of clause F.1 (multi_junction_adjustment), which the flanking reduction index R_ij,ref of a path more than one junction away is built with.

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

coupling_term(
source_mobility: complex | np.number[Any],
receiver_mobility: complex | np.number[Any],
*,
transfer_mobility: complex | np.number[Any] = ...,
) -> float
coupling_term(
source_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
receiver_mobility: NumericArrayLike,
*,
transfer_mobility: NumericArrayLike = ...,
) -> NDArray[np.float64]
coupling_term(
source_mobility: complex | np.number[Any],
receiver_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
*,
transfer_mobility: NumericArrayLike = ...,
) -> NDArray[np.float64]
coupling_term(
source_mobility: complex | np.number[Any],
receiver_mobility: complex | np.number[Any],
*,
transfer_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.float64]
coupling_term(
source_mobility: NumericArrayLike,
receiver_mobility: NumericArrayLike,
*,
transfer_mobility: NumericArrayLike = ...,
) -> float | NDArray[np.float64]

Coupling term D_C for a point excitation (EN 12354-5, Formula 19b/19e).

, the loss between the characteristic and the injected structure-borne power. Y_k is the transfer mobility of an elastic support (Formula 19e; 0 for a rigid connection, Formula 19b).

Parameters

Name Description
source_mobility Source point mobility Y_s (complex, non-zero), in m/(N.s).
receiver_mobility Receiver point mobility Y_i (complex, positive real part).
transfer_mobility Elastic-support transfer mobility Y_k (Default: 0.0).

Returns: The coupling term D_C, in dB. Positive whenever the source and receiver mobilities are well mismatched (the usual installed case), but not guaranteed non-negative: near a mounting resonance where Y_s and Y_i are of comparable magnitude and opposite phase the numerator A float when source_mobility, receiver_mobility and transfer_mobility are all numbers, an array when one of them is a sequence or an array, a zero-dimensional one included. collapses and D_C goes negative (the installed power then exceeds the characteristic level; e.g. , m/(N·s) gives dB).

Raises

Exception When
ValueError if Y_s is zero/non-finite or Re{Y_i} is not positive and finite.
TypeError if receiver_mobility, source_mobility or transfer_mobility holds a text or a value that is not a number.
coupling_term_force_source(
source_mobility: complex | np.number[Any],
receiver_mobility: complex | np.number[Any],
) -> float
coupling_term_force_source(
source_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
receiver_mobility: NumericArrayLike,
) -> NDArray[np.float64]
coupling_term_force_source(
source_mobility: complex | np.number[Any],
receiver_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.float64]
coupling_term_force_source(
source_mobility: NumericArrayLike,
receiver_mobility: NumericArrayLike,
) -> float | NDArray[np.float64]

Coupling term for a force source, high source mobility (Formula 19c).

Parameters

Name Description
source_mobility Source point mobility Y_s (complex, non-zero).
receiver_mobility Receiver point mobility Y_i (complex, positive real part).

Returns: The coupling term D_C, in dB. A float when source_mobility and receiver_mobility are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError if Y_s is zero/non-finite or Re{Y_i} is not positive and finite.
TypeError if receiver_mobility or source_mobility holds a text or a value that is not a number.
coupling_term_velocity_source(
source_mobility: complex | np.number[Any],
receiver_impedance: complex | np.number[Any],
) -> float
coupling_term_velocity_source(
source_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
receiver_impedance: NumericArrayLike,
) -> NDArray[np.float64]
coupling_term_velocity_source(
source_mobility: complex | np.number[Any],
receiver_impedance: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.float64]
coupling_term_velocity_source(
source_mobility: NumericArrayLike,
receiver_impedance: NumericArrayLike,
) -> float | NDArray[np.float64]

Coupling term for a velocity source, low source mobility (Formula 19d).

Parameters

Name Description
source_mobility Source point mobility Y_s (complex, non-zero).
receiver_impedance Receiver point impedance Z_i (complex, positive real part).

Returns: The coupling term D_C, in dB. A float when source_mobility and receiver_impedance are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError if Y_s is zero/non-finite or Re{Z_i} is not positive and finite.
TypeError if receiver_impedance holds a text or a value that is not a real number, or source_mobility holds a text or a value that is not a number.
installed_power_from_reception_plate(
reception_plate_level: float | np.floating[Any] | np.integer[Any],
receiver_mobility: complex | np.number[Any],
*,
plate_mobility: float = ...,
) -> float
installed_power_from_reception_plate(
reception_plate_level: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
receiver_mobility: NumericArrayLike,
*,
plate_mobility: float = ...,
) -> NDArray[np.float64]
installed_power_from_reception_plate(
reception_plate_level: float | np.floating[Any] | np.integer[Any],
receiver_mobility: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
*,
plate_mobility: float = ...,
) -> NDArray[np.float64]
installed_power_from_reception_plate(
reception_plate_level: NumericArrayLike,
receiver_mobility: NumericArrayLike,
*,
plate_mobility: float = ...,
) -> float | NDArray[np.float64]

Mobility correction of the reception-plate power (EN 12354-5, Annex I).

, which refers the characteristic reception-plate power level L_Ws,n (EN 15657 Formula (17), re the 10 cm concrete plate m/(N.s)) to the characteristic mobility Y_inf,i of the actual receiving element (floor, wall), yielding the installed power of that element as in the Annex I.2 whirlpool example. The same correction with the source mobility instead of Y_inf,i yields the characteristic level L_Ws,c (Annex I.3, Table I.8), from which installed_structure_borne_power_level subtracts D_C.

Parameters

Name Description
reception_plate_level Power level to re-refer (per band), in dB re 1 pW: either the characteristic level L_Ws,n (EN 15657 Formula 17, referred to the default 5e-6 m/(N.s) plate) or a raw Formula (14) plate power together with the mobility of the plate it was measured on, passed as plate_mobility.
receiver_mobility Characteristic mobility Y_inf,i of the receiving element (per band; complex values use their magnitude), in m/(N.s).
plate_mobility Mobility the input level is referred to (Default: the EN 15657 reference plate, m/(N.s); pass the measured plate mobility when the input is a raw Formula (14) level).

Returns: The mobility-corrected power level, in dB re 1 pW. A float when reception_plate_level and receiver_mobility are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive receiver or plate mobility.
TypeError if plate_mobility is not a single number, or reception_plate_level holds a text or a value that is not a real number, or receiver_mobility holds a text or a value that is not a number.
installed_source_prediction(
characteristic_power_level: NumericArrayLike,
coupling_term: NumericArrayLike,
paths: Sequence[Mapping[str, Any]],
*,
frequencies: NumericArrayLike | None = None,
) -> InstalledSourceResult

Predict the installed structure-borne SPL over several paths (EN 12354-5).

The band count is set by the widest per-band input (the characteristic power level, the coupling_term or any path’s adjustment_term / flanking_reduction_index); every per-band input must carry one value or that count, and single values broadcast across the bands (a single-number source level with per-band path data is valid, and the result’s installed_power_level is broadcast to the band count).

Parameters

Name Description
characteristic_power_level Characteristic level L_Ws,c (per band or a single value), in dB.
coupling_term Coupling term D_C (per band or a single value), in dB.
paths One dict per transmission path with keys adjustment_term (D_sa), flanking_reduction_index (R_ij,ref) and element_area (S_i), each per band where applicable.
frequencies Band centre frequencies, in hertz, or None.

Returns: The InstalledSourceResult.

Raises

Exception When
ValueError if paths is empty, a path is missing a required key, or a per-band input matches neither one value nor the band count.
TypeError if frequencies holds a text or a value that is not a real number.
installed_structure_borne_power_level(
characteristic_power_level: float | np.floating[Any] | np.integer[Any],
coupling_term: float | np.floating[Any] | np.integer[Any],
) -> float
installed_structure_borne_power_level(
characteristic_power_level: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
coupling_term: NumericArrayLike,
) -> NDArray[np.float64]
installed_structure_borne_power_level(
characteristic_power_level: float | np.floating[Any] | np.integer[Any],
coupling_term: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
installed_structure_borne_power_level(
characteristic_power_level: NumericArrayLike,
coupling_term: NumericArrayLike,
) -> float | NDArray[np.float64]

Installed structure-borne power level (EN 12354-5, Formula 18b).

Parameters

Name Description
characteristic_power_level Characteristic level L_Ws,c (per band), in dB: the EN 15657 reception-plate level converted with Formulae (15)/(17) and the source-mobility correction (see the module docstring), not the raw plate-injected Formula (14) level.
coupling_term Coupling term D_C,i (per band), in dB.

Returns: The installed structure-borne power level L_Ws,inst, in dB. A float when characteristic_power_level and coupling_term are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if characteristic_power_level or coupling_term holds a text or a value that is not a real number.
InstalledSourceResult(
path_levels: NDArray[np.float64],
total_level: NDArray[np.float64],
installed_power_level: NDArray[np.float64],
frequencies: NDArray[np.float64] | None = None,
)

Installed structure-borne sound prediction (EN 12354-5).

Attributes

Name Description
frequencies Band centre frequencies, in hertz, or None.
path_levels Per-path normalised SPL L_n,s,ij (paths x bands), dB.
total_level Combined normalised SPL L_n,s per band, in dB.
installed_power_level Installed power level L_Ws,inst per band, dB.

property

Band-summed total level , in dB.

InstalledSourceResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the per-path and total normalised sound pressure levels.

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".
InstalledSourceResult.report(
path: str | os.PathLike[str],
*,
metadata: ReportMetadata | None = None,
engine: Literal['reportlab'] = 'reportlab',
verbose: bool = False,
language: Literal['en', 'es'] = 'en',
) -> str

Render an EN 12354-5 installed structure-borne prediction fiche.

Writes a one-page prediction sheet (an estimate, not a measurement): a prediction-basis line naming EN 12354-5:2009, an optional metadata header (client, source equipment, receiving room, instrumentation, climate, date), a per-band table (nominal octave/one-third-octave frequency, the installed structure-borne power level L_Ws,inst, each transmission path’s normalised SPL L_n,s,ij and the combined total L_n,s), the per-path and total L_n,s(f) spectra, the boxed band-summed total L_n,s (dB) with the installed power total and the path count, an optional verdict row against a declared limit, and a basis strip stating Formulae 18a/17 and the prediction disclaimer.

Parameters

Name Description
path Destination path of the PDF file.
metadata Optional ReportMetadata supplying the header (client, specimen the source equipment, test_room the receiving room, instrumentation, temperature_c, relative_humidity_percent, pressure, test_date), the footer identity (laboratory, operator, report_id, notes) and, via requirement, a declared upper limit on the overall L_n,s (lower is better).
engine Rendering back end; only "reportlab" is supported.
verbose When True the per-band table adds one column per transmission path (up to five); otherwise only the installed power and the combined total are shown.
language Fiche language: "en" (default) or "es".

Returns: The written path as a str.

Raises

Exception When
ValueError If engine is not "reportlab" or language is unknown.
ImportError If reportlab (or, for the figure, matplotlib) is not installed (the [report] extra).

Constant (float).

MIN_MULTI_JUNCTION_KIJ = -5.0
multi_junction_adjustment(n_junctions: int | np.integer[Any]) -> float

Vibration reduction index adjustment dK (EN 12354-5, clause F.1).

When the receiving room is more than one junction away from the equipment, Formula (F.1) sums the junction Kij along the path and subtracts an adjustment dK that covers the transmission by wave types other than bending waves. Clause F.1 estimates it from published data as 4 dB for two junctions and 6 dB for three or more, with the resulting Kij floored at MIN_MULTI_JUNCTION_KIJ.

Parameters

Name Description
n_junctions Number of junctions the transmission path crosses (>= 1).

Returns: The adjustment dK, in dB (0.0 for a single junction).

Raises

Exception When
ValueError for a number of junctions that is not a whole number from 1.
TypeError if n_junctions is a flag, a text or an array where a count goes.

Constant (float).

REFERENCE_AREA_M2 = 10.0
structure_borne_pressure_level_path(
installed_power_level: float | np.floating[Any] | np.integer[Any],
adjustment_term: float | np.floating[Any] | np.integer[Any],
flanking_reduction_index: float | np.floating[Any] | np.integer[Any],
element_area: float,
*,
reference_area: float = ...,
) -> float
structure_borne_pressure_level_path(
installed_power_level: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
adjustment_term: NumericArrayLike,
flanking_reduction_index: NumericArrayLike,
element_area: float,
*,
reference_area: float = ...,
) -> NDArray[np.float64]
structure_borne_pressure_level_path(
installed_power_level: float | np.floating[Any] | np.integer[Any],
adjustment_term: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
flanking_reduction_index: NumericArrayLike,
element_area: float,
*,
reference_area: float = ...,
) -> NDArray[np.float64]
structure_borne_pressure_level_path(
installed_power_level: float | np.floating[Any] | np.integer[Any],
adjustment_term: float | np.floating[Any] | np.integer[Any],
flanking_reduction_index: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
element_area: float,
*,
reference_area: float = ...,
) -> NDArray[np.float64]
structure_borne_pressure_level_path(
installed_power_level: NumericArrayLike,
adjustment_term: NumericArrayLike,
flanking_reduction_index: NumericArrayLike,
element_area: float,
*,
reference_area: float = ...,
) -> float | NDArray[np.float64]

Normalised structure-borne SPL for one path i->j (Formula 18a).

Parameters

Name Description
installed_power_level Installed power level L_Ws,inst,i, in dB.
adjustment_term Structure-to-airborne adjustment D_sa,i (clause 4.4.4 / Annex F), in dB.
flanking_reduction_index Flanking sound reduction index R_ij,ref re S0 (EN 12354-1), in dB.
element_area Supporting-element area S_i, in m^2 (> 0).
reference_area Reference area (Default: 10 m^2).

Returns: The normalised path sound pressure level L_n,s,ij, in dB. A float when installed_power_level, adjustment_term and flanking_reduction_index are all numbers, an array when one of them is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive area.
TypeError if element_area or reference_area is not a single number, or adjustment_term, flanking_reduction_index or installed_power_level holds a text or a value that is not a real number.
structure_to_airborne_adjustment(
frequency: float | np.floating[Any] | np.integer[Any],
critical_frequency: float,
mass_per_area: float,
*,
radiation_factor: float | np.floating[Any] | np.integer[Any] = ...,
) -> float
structure_to_airborne_adjustment(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
critical_frequency: float,
mass_per_area: float,
*,
radiation_factor: NumericArrayLike = ...,
) -> NDArray[np.float64]
structure_to_airborne_adjustment(
frequency: float | np.floating[Any] | np.integer[Any],
critical_frequency: float,
mass_per_area: float,
*,
radiation_factor: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
structure_to_airborne_adjustment(
frequency: NumericArrayLike,
critical_frequency: float,
mass_per_area: float,
*,
radiation_factor: NumericArrayLike = ...,
) -> float | NDArray[np.float64]

Adjustment term D_sa of a supporting element (Formula F.3).

the ratio of injected structure-borne power to incident airborne power that leaves the same free-vibration energy in the element. Clause F.2 gives it for a force excitation perpendicular to a homogeneous supporting element, exact above the critical frequency (where the radiation factor saturates at

  1. and a good approximation over the whole range.

D_sa is normally negative, and Formula (18a) subtracts it, so it raises the predicted level: this is the value structure_borne_pressure_level_path takes as adjustment_term, sign included.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
critical_frequency Critical frequency fc,i of the element, in hertz (> 0).
mass_per_area Mass per unit area mi of the element, in kg/m^2 (> 0).
radiation_factor Radiation factor sigma_i of the element (Default: 1.0, its value above fc; EN 12354-1:2000 Annex B estimates it below).

Returns: The adjustment term D_sa,i, in dB. A float when frequency and radiation_factor are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive frequency, critical frequency, mass or radiation factor.
TypeError if critical_frequency or mass_per_area is not a single number, or frequency or radiation_factor holds a text or a value that is not a real number.

Constant (mapping).

TABLE_D1_QUANTITIES = {'mass': ('mass',), 'bar_end': ('density', 'longitudinal_velocity', 'area'), 'beam': ('density', 'longitudinal_velocity', 'thickness_m', 'width_m'), 'plate': ('density', 'longitudinal_velocity', 'thickness_m'), 'pipe': ('density', 'longitudinal_velocity', 'thickness_m', 'radius'), 'mass_spring': ('mass', 'stiffness', 'loss_factor')}

Constant (tuple).

TABLE_F1_FORCE_LEVEL = (139.0, 142.0, 145.0, 148.0, 151.0, 154.0, 156.0, 156.0)

Constant (tuple).

TABLE_F1_OCTAVE_BANDS_HZ = (31.5, 63.0, 125.0, 250.0, 500.0, 1000.0, 2000.0, 4000.0)

tapping_machine_characteristic_power_level

Section titled “tapping_machine_characteristic_power_level”
tapping_machine_characteristic_power_level(
force_level: float | np.floating[Any] | np.integer[Any],
*,
frequency: float | np.floating[Any] | np.integer[Any],
) -> float
tapping_machine_characteristic_power_level(
force_level: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
frequency: NumericArrayLike,
) -> NDArray[np.float64]
tapping_machine_characteristic_power_level(
force_level: float | np.floating[Any] | np.integer[Any],
*,
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
tapping_machine_characteristic_power_level(
force_level: NumericArrayLike,
*,
frequency: NumericArrayLike,
) -> float | NDArray[np.float64]

Characteristic power level of the tapping machine (Formula D.9a).

The standard notes the result is about 115 dB re 1 pW per one-third octave for the ISO tapping machine, treated in clause D.1.3 as a force source with the mass-like source mobility of its 0.5 kg hammers. Pair it with tapping_machine_coupling_term and hand both to installed_source_prediction.

The formula only balances with the reference force F_0 = 1e-6 N, since it carries no term for ; that is what pins the reading of Table F.1 against its own printed “re 1 pN” caption.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
force_level Force level L_F, in dB re 1e-6 N (Table F.1 or tapping_machine_force_level_estimate).

Returns: The characteristic power level L_Ws,c, in dB re 1 pW. A float when force_level and frequency are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive frequency.
TypeError if force_level or frequency holds a text or a value that is not a real number.
tapping_machine_coupling_term(
receiver_mobility: float | np.floating[Any] | np.integer[Any],
*,
frequency: float | np.floating[Any] | np.integer[Any],
hammer_mass: float = ...,
) -> float
tapping_machine_coupling_term(
receiver_mobility: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
frequency: NumericArrayLike,
hammer_mass: float = ...,
) -> NDArray[np.float64]
tapping_machine_coupling_term(
receiver_mobility: float | np.floating[Any] | np.integer[Any],
*,
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
hammer_mass: float = ...,
) -> NDArray[np.float64]
tapping_machine_coupling_term(
receiver_mobility: NumericArrayLike,
*,
frequency: NumericArrayLike,
hammer_mass: float = ...,
) -> float | NDArray[np.float64]

Coupling term of the tapping machine (EN 12354-5, Formula D.9b).

with and M the hammer mass of clause D.1.3, which the standard takes as 0.5 kg. It is the mass-like-source form of Formula (19b), for a machine standing on a plate-like element of real mobility Y_i; Annex F Formulae (F.4) to (F.6b) estimate that Y_i.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
receiver_mobility Real mobility Y_i of the supporting element, in m/(N.s) (> 0).
hammer_mass Source mass M, in kilograms (Default: TAPPING_HAMMER_MASS_KG, the 0.5 kg of clause D.1.3 and ISO 10140-5).

Returns: The coupling term D_C,i, in dB. A float when receiver_mobility and frequency are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive frequency, mobility or mass.
TypeError if hammer_mass is not a single number, or frequency or receiver_mobility holds a text or a value that is not a real number.
tapping_machine_force_level() -> NDArray[np.float64]

Tabulated ISO tapping machine force level (EN 12354-5, Table F.1).

The eight octave-band values of Table F.1, in the order of TABLE_F1_OCTAVE_BANDS_HZ (31.5 Hz to 4 kHz). Clause F.4.2 offers them for the tapping machine used in place of an electrodynamic shaker when measuring D_Fp,n (Formula F.9), and clause D.1.2.3 restricts the source to low-mobility receiving structures.

Feed them to tapping_machine_characteristic_power_level for the L_Ws,c that installed_source_prediction takes.

Returns: The force level L_F per octave band, in dB re 1e-6 N (the table caption prints “re 1 pN”; see docs/ERRATA.md).

tapping_machine_force_level_estimate(
frequency: float | np.floating[Any] | np.integer[Any],
*,
fraction: Literal[1, 3] | np.integer[Any] = ...,
) -> float
tapping_machine_force_level_estimate(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
fraction: Literal[1, 3] | np.integer[Any] = ...,
) -> NDArray[np.float64]
tapping_machine_force_level_estimate(
frequency: NumericArrayLike,
*,
fraction: Literal[1, 3] | np.integer[Any] = ...,
) -> float | NDArray[np.float64]

Closed form printed under Table F.1 for the tapping machine force level.

The standard qualifies this with “up till about 1000 Hz”: it reproduces the first six tabulated values to the printed decibel, and above that it departs from the table, which flattens at 156 dB (the closed form gives 157 dB at 2 kHz and 160 dB at 4 kHz). Use tapping_machine_force_level for the octave bands the table covers and this only where it does not, chiefly the one-third-octave bands the standard does not tabulate.

Parameters

Name Description
frequency Band centre frequency f, in hertz (scalar or array, > 0).
fraction The band set, 1 for octaves (default, coefficient 2.5) or 3 for one-third octaves (coefficient 0.8). One of 1 or 3.

Returns: The force level L_F, in dB re 1e-6 N (the standard prints “re 1 pN”; see docs/ERRATA.md). A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for a non-positive frequency or a band set other than 1 or 3.
TypeError if fraction is not an integer (a word, a flag or a float), or frequency holds a text or a value that is not a real number.
total_structure_borne_pressure_level(
path_levels: NumericArrayLike,
) -> float | NDArray[np.float64]

Combine path sound pressure levels energetically (Formula 17).

Parameters

Name Description
path_levels Path levels L_n,s,ij; sum is over the first axis (paths), broadcasting any trailing band axis.

Returns: The total normalised sound pressure level L_n,s, in dB: a float for 1-D path levels, one value per band for 2-D ones.

Raises

Exception When
TypeError if path_levels holds a text or a value that is not a real number.
typical_element_mobility(
structure: Literal['mass', 'bar_end', 'beam', 'plate', 'pipe', 'mass_spring'],
*,
frequency: float | np.floating[Any] | np.integer[Any] | None = None,
mass: float | None = ...,
density: float | None = ...,
longitudinal_velocity: float | None = ...,
thickness_m: float | None = ...,
width_m: float | None = ...,
area: float | None = ...,
radius: float | None = ...,
stiffness: float | None = ...,
loss_factor: float | None = ...,
) -> float
typical_element_mobility(
structure: Literal['mass', 'bar_end', 'beam', 'plate', 'pipe', 'mass_spring'],
*,
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
mass: float | None = ...,
density: float | None = ...,
longitudinal_velocity: float | None = ...,
thickness_m: float | None = ...,
width_m: float | None = ...,
area: float | None = ...,
radius: float | None = ...,
stiffness: float | None = ...,
loss_factor: float | None = ...,
) -> NDArray[np.float64]
typical_element_mobility(
structure: Literal['mass', 'bar_end', 'beam', 'plate', 'pipe', 'mass_spring'],
*,
frequency: NumericArrayLike | None = None,
mass: float | None = ...,
density: float | None = ...,
longitudinal_velocity: float | None = ...,
thickness_m: float | None = ...,
width_m: float | None = ...,
area: float | None = ...,
radius: float | None = ...,
stiffness: float | None = ...,
loss_factor: float | None = ...,
) -> float | NDArray[np.float64]

Named lookup of EN 12354-5, Table D.1 (mobility of typical elements).

Returns the mobility magnitude |Y| the third column of Table D.1 prints, in m/(N.s), for the row named by structure:

  • "mass", described by mass [kg]: .
  • "bar_end", described by density [kg/m3], longitudinal_velocity [m/s] and area [m2]: .
  • "beam", described by , , thickness_m [m] and width_m [m]: .
  • "plate", described by , and : .
  • "pipe", described by , , and radius [m]: .
  • "mass_spring", described by , stiffness [N/m] and loss_factor [-]: .

TABLE_D1_QUANTITIES carries the “Describing quantities” column as the keyword names of this function, and only the quantities a row describes may be supplied. Frequency is not among them, because it is the band frequency of the prediction and not a property of the element, but it appears in four of the six expressions: "mass", "beam", "pipe" and "mass_spring" require frequency and the other two reject it.

Clause D.1.3 offers the table for building up a source mobility Y_s from the machine’s own parts, which is what coupling_term needs and what a measurement of the equipment does not give. Annex F Formulae (F.4) to (F.6b) cover the receiver mobility Y_i of the supporting element; the "plate" row is the same quantity as Formula (F.4) and as phonometry.vibration.structural.point_mobility.infinite_plate_mobility, written in , and instead of mass and bending stiffness.

The "mass_spring" row is the machine on non-rigid feet: its second bracket holds the two reactances, which cancel at the mass-spring resonance and leave the mobility at its damping-limited minimum, the frequency at which the mount injects the most power. loss_factor=0 returns exactly zero there, which coupling_term then rejects.

Parameters

Name Description
structure Table D.1 row name. One of "mass", "bar_end", "beam", "plate", "pipe" or "mass_spring".
frequency Frequency f, in hertz (scalar or array), for the frequency-dependent rows only.
mass Mass M, in kilograms (rows "mass", "mass_spring").
density Density rho, in kg/m^3.
longitudinal_velocity Quasi-longitudinal wave speed cL, in m/s.
thickness_m Thickness t, in metres.
width_m Beam width w, in metres (row "beam").
area Cross-sectional area S, in m^2 (row "bar_end").
radius Pipe radius r, in metres (row "pipe").
stiffness Support stiffness s, in N/m (row "mass_spring").
loss_factor Support loss factor eta (row "mass_spring").

Returns: The mobility magnitude |Y|, in m/(N.s). A float for a number frequency or a row that reads none, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError for an unknown row, a missing or surplus describing quantity, a frequency that the row does not take (or lacks), or a non-positive value.
TypeError if structure is not a text, or frequency holds a text or a value that is not a real number.