noise_control.enclosure_insulation
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.
What an enclosure is worth, measured rather than predicted (ISO 11546).
phonometry.noise_control.enclosures predicts what a box around a
machine will do from its walls and its lining. This module is the other half:
the measurement that says what the box built actually does, and the arithmetic
by which a manufacturer may declare it.
The quantity is a difference of two runs. Determine the machine’s sound power without the enclosure, determine it again with the enclosure in place, and subtract band by band:
That is Equation (1) of both parts, and Equations (2) to (5) are the same subtraction on the A-weighted total, on a sound pressure level at a stated position and, in part 1, on the pair of levels the reciprocity method reads. Nothing here is a transmission loss: an insertion loss carries the source, the room and the mounting with it, which is why the standard makes all three reportable.
Two parts, one procedure
Section titled “Two parts, one procedure”ISO 11546-1:1995 measures in a laboratory, for a declaration: the manufacturer’s figure, obtained under conditions the buyer can compare across suppliers. ISO 11546-2:1995 measures the same thing in situ, for an acceptance: the enclosure as installed, in the room it was installed in, with the machine it was built for. The two documents share their definitions, their equations, their reporting rules and their artificial source word for word; what changes is the environment, the base standard the levels come from and, in part 2, an annex that asks whether the room is good enough at all.
Where the machine cannot be run, both parts substitute a source for it, and
the substitution is what the choice in applicable_methods is about:
- an actual source, the machine itself, which is the normal case;
- the reciprocity method of part 1, 7.2, which puts the enclosure in a diffuse field and measures inside it, giving ;
- an artificial source, the tapping machine of Annex A on its undamped steel plate, used at several positions inside the enclosure.
Clause 1 draws the scope around the first of those: the part applies without
restriction to a free-standing enclosure smaller than
UNRESTRICTED_ENCLOSURE_VOLUME_M3, and a larger one may still be
measured with its actual source, provided the base standard’s own limit on
volume is met.
What this module computes, and what it refuses to
Section titled “What this module computes, and what it refuses to”Every equation of clauses 6 and 7 is here, with the weighted rating of
ISO 717-1 delegated to phonometry.building.weighted_rating rather than
re-derived, and the A-weighted estimate of the annexes written so that it
cannot disagree with its own inputs: estimated_a_weighted_enclosure_insulation
reduces algebraically to the difference of the two A-weighted totals computed
from the same assumed spectrum, which is the only exact oracle either part
offers.
Annex A is a hardware drawing and Annex B an illustration; their numbers are
constants here and nothing more. Clause 5 is instrumentation, clause 8 hands
its uncertainty to the base standard and to ISO 4871, and clauses 9 and 10 are
a report. The one piece of clause 9 that computes is the rounding of
9.4, which is EnclosureInsulationResult.rounded.
Neither part prints a worked example, so the tests are anchored where the
documents allow: the algebraic identities of the subtraction, the closed form
behind Figure C.1 of part 2, which is cross-checked against
phonometry.emission.environmental_correction, and the printed
thresholds and tables.
Auto-generated from the source docstrings by
scripts/generate_api_docs.py(make api-docs). Do not edit by hand.
applicable_methods
Section titled “applicable_methods”applicable_methods( *, condition: Literal['laboratory', 'in-situ'] = 'laboratory', source_kind: Literal['actual', 'reciprocity', 'artificial'] = 'actual',) -> tuple[MethodEntry, ...]The rows of Table 1 open to a given condition and source.
Reading the table is what stops a declaration claiming more than its method can give: a survey-grade determination hands back an A-weighted number and nothing per band, so cannot be declared from it, and the reciprocity method exists only in the laboratory.
Parameters
| Name | Description |
|---|---|
condition |
"laboratory" (default) or "in-situ". |
source_kind |
"actual" (default), "reciprocity" or "artificial". |
Returns: The rows, as MethodEntry values.
Raises
| Exception | When |
|---|---|
| ValueError | For an unknown condition or source kind, or a combination the standard does not have. |
| TypeError | if condition or source_kind is not a text. |
ARTIFICIAL_SOURCE_DROP_MM
Section titled “ARTIFICIAL_SOURCE_DROP_MM”Constant (float).
ARTIFICIAL_SOURCE_DROP_MM = 40.0ARTIFICIAL_SOURCE_EXAMPLE_LWA
Section titled “ARTIFICIAL_SOURCE_EXAMPLE_LWA”Constant (float).
ARTIFICIAL_SOURCE_EXAMPLE_LWA = 110.0ARTIFICIAL_SOURCE_LEAK_RATIO_ADVISORY
Section titled “ARTIFICIAL_SOURCE_LEAK_RATIO_ADVISORY”Constant (float).
ARTIFICIAL_SOURCE_LEAK_RATIO_ADVISORY = 0.02ARTIFICIAL_SOURCE_MAX_FILL_RATIO
Section titled “ARTIFICIAL_SOURCE_MAX_FILL_RATIO”Constant (float).
ARTIFICIAL_SOURCE_MAX_FILL_RATIO = 0.25ARTIFICIAL_SOURCE_PLATE_MM
Section titled “ARTIFICIAL_SOURCE_PLATE_MM”Constant (tuple).
ARTIFICIAL_SOURCE_PLATE_MM = (4.0, 800.0, 300.0)ARTIFICIAL_SOURCE_STANDOFF_MM
Section titled “ARTIFICIAL_SOURCE_STANDOFF_MM”Constant (float).
ARTIFICIAL_SOURCE_STANDOFF_MM = 60.0check_enclosure_test_environment
Section titled “check_enclosure_test_environment”check_enclosure_test_environment( *, base_standard: Literal['ISO 3743-1', 'ISO 3744', 'ISO 3746', 'ISO 3747', 'ISO 9614-1', 'ISO 9614-2', 'ISO 11201', 'ISO 11202', 'ISO 11204'], mean_absorption_coefficient: float, room_surface_area_m2: float, measurement_surface_area_m2: float,) -> EnclosureTestEnvironmentCheckIs this room good enough for that base standard? Annex C of part 2.
Annex C asks the question the other way round from the emission standards: not what the environmental correction of this room is, but how much room a method needs. With held at the limit Table C.1 sets, the ratio the room must reach is
which is Figure C.1 in closed form, the curve the annex asks the reader to
read off by eye. Take from
ROOM_ABSORPTION_ESTIMATES when nobody measured it.
A standard that works by comparison with a reference sound source, ISO
3743-1 and ISO 3747, states no requirement at all; for those
the answer carries the background margin and nothing else, and
passes is decided by the margin alone, which this function does
not see. It is reported as True there, with
required_area_ratio at None, so that the caller reads the table
rather than a number the annex does not give.
Parameters
| Name | Description |
|---|---|
base_standard |
One of the columns of Table C.1, as TEST_ENVIRONMENT_REQUIREMENTS keys them. One of "ISO 3743-1", "ISO 3744", "ISO 3746", "ISO 3747", "ISO 9614-1", "ISO 9614-2", "ISO 11201", "ISO 11202" or "ISO 11204". |
mean_absorption_coefficient |
of the room, dimensionless. |
room_surface_area_m2 |
, the total area of the room’s boundary surfaces, in square metres. |
measurement_surface_area_m2 |
, the area of the measurement surface around the source, in square metres. |
Returns: The verdict, as an EnclosureTestEnvironmentCheck.
Raises
| Exception | When |
|---|---|
| ValueError | For an unknown standard, a coefficient outside (0, 1] or a non-positive area. |
| TypeError | if mean_absorption_coefficient, measurement_surface_area_m2 or room_surface_area_m2 is not a single number, or base_standard is not a text. |
enclosure_artificial_source_insulation
Section titled “enclosure_artificial_source_insulation”enclosure_artificial_source_insulation( level_without_by_position: NumericArrayLike, level_with_by_position: NumericArrayLike, *, frequencies: NumericArrayLike | None = None, quantity: Literal['sound_power', 'sound_pressure'] = 'sound_power', condition: Literal['laboratory', 'in-situ'] = 'laboratory', fraction: Literal[1, 3] | np.integer[Any] = 3,) -> EnclosureInsulationResultInsertion loss with the tapping source of Annex A, 7.3 of part 1 and 7.2 of part 2.
The plate is dropped at each of several positions, the band difference is formed at each, and the positions are averaged arithmetically: “express the final result as the arithmetic mean value of the results for the different source positions” is the clause’s own sentence, and it is not the energy mean used almost everywhere else in this library, so it is written out here rather than borrowed.
The clause sends the levels to Equation (1) or to Equation (3) depending on
which determination was made, so the method yields or
and 9.4 e) reports whichever it was. That is quantity.
Parameters
| Name | Description |
|---|---|
level_without_by_position |
Levels without the enclosure, one row per source position, in decibels. |
level_with_by_position |
The same with the enclosure, row for row, in decibels. |
frequencies |
Nominal band centres, in hertz. |
quantity |
"sound_power" (default) for Equation (1), or "sound_pressure" for Equation (3). |
condition |
"laboratory" for part 1, "in-situ" for part 2. |
fraction |
The band set, 3 for one-third octaves (default) or 1 for octaves. One of 1 or 3. |
Returns: The averaged insertion loss, as an EnclosureInsulationResult.
Raises
| Exception | When |
|---|---|
| ValueError | For arrays that are not two-dimensional and matched, fewer than two source positions, or an unknown quantity. |
| TypeError | if fraction is not an integer (a word, a flag or a float), or frequencies, level_with_by_position or level_without_by_position holds a text or a value that is not a real number, or condition or quantity is not a text. |
enclosure_reciprocity_insulation
Section titled “enclosure_reciprocity_insulation”enclosure_reciprocity_insulation( external_levels: NumericArrayLike, internal_levels: NumericArrayLike, *, frequencies: NumericArrayLike | None = None, fraction: Literal[1, 3] | np.integer[Any] = 3,) -> EnclosureInsulationResultInsertion loss measured from the outside in, Equation (5) of part 1.
: the enclosure is put in a diffuse field, the field is measured around it and again inside it, and the difference is the insulation the enclosure would give a source within it. The method belongs to the laboratory, and it is the one case where the enclosure is measured without any source inside at all.
Parameters
| Name | Description |
|---|---|
external_levels |
The averaged level in the field outside, per band, in decibels. |
internal_levels |
The averaged level inside the enclosure standing in that field, per band, in decibels. |
frequencies |
Nominal band centres, in hertz. |
fraction |
The band set, 3 for one-third octaves (default) or 1 for octaves. One of 1 or 3. |
Returns: The insertion loss, as an EnclosureInsulationResult whose quantity is "reciprocity".
Raises
| Exception | When |
|---|---|
| ValueError | For spectra that do not match, non-finite values or an unknown band fraction. |
| TypeError | if fraction is not an integer (a word, a flag or a float), or external_levels, frequencies or internal_levels holds a text or a value that is not a real number. |
enclosure_sound_power_insulation
Section titled “enclosure_sound_power_insulation”enclosure_sound_power_insulation( level_without: NumericArrayLike, level_with: NumericArrayLike, *, frequencies: NumericArrayLike | None = None, a_weighted_without: float | None = None, a_weighted_with: float | None = None, base_standard: Literal['ISO 3741', 'ISO 3742', 'ISO 3743-2', 'ISO 3743-1', 'ISO 3744', 'ISO 3746', 'ISO 3747', 'ISO 9614-1', 'ISO 9614-2'] = 'ISO 3744', condition: Literal['laboratory', 'in-situ'] = 'laboratory', source_kind: Literal['actual', 'reciprocity', 'artificial'] = 'actual', fraction: Literal[1, 3] | np.integer[Any] = 3,) -> EnclosureInsulationResultInsertion loss from two sound power determinations, Equations (1) and (2).
band by band, and the same difference of the A-weighted totals. Where the A-weighted pair is not supplied it is computed from the band spectra with the ISO 3744 Annex E table, which is what the note to clause 6.2 prefers.
Parameters
| Name | Description |
|---|---|
level_without |
Sound power levels of the machine without the enclosure, in decibels. |
level_with |
The same with the enclosure in place, in decibels. |
frequencies |
Nominal band centres, in hertz. |
a_weighted_without |
without the enclosure, in decibels, when it was measured rather than computed. |
a_weighted_with |
The same with the enclosure, in decibels. |
base_standard |
The standard the sound power came from, one of those Table 1 of either part lists for a sound power (default "ISO 3744"). One of "ISO 3741", "ISO 3742", "ISO 3743-2", "ISO 3743-1", "ISO 3744", "ISO 3746", "ISO 3747", "ISO 9614-1" or "ISO 9614-2". |
condition |
"laboratory" for part 1, "in-situ" for part 2. |
source_kind |
"actual", "reciprocity" or "artificial". |
fraction |
The band set, 3 for one-third octaves (default) or 1 for octaves. One of 1 or 3. |
Returns: The insertion loss, as an EnclosureInsulationResult.
Raises
| Exception | When |
|---|---|
| ValueError | For spectra that do not match, non-finite values, half an A-weighted pair, an unknown base standard, condition, source kind or band fraction, or a combination of condition and source kind Table 1 does not have. |
| TypeError | if base_standard is not a text, fraction is not an integer (a word, a flag or a float), a_weighted_with or a_weighted_without is not a single number, or frequencies, level_with or level_without holds a text or a value that is not a real number, or condition or source_kind is not a text. |
enclosure_sound_pressure_insulation
Section titled “enclosure_sound_pressure_insulation”enclosure_sound_pressure_insulation( level_without: NumericArrayLike, level_with: NumericArrayLike, *, frequencies: NumericArrayLike | None = None, a_weighted_without: float | None = None, a_weighted_with: float | None = None, base_standard: Literal['ISO 11201', 'ISO 11202', 'ISO 11204'] = 'ISO 11201', condition: Literal['laboratory', 'in-situ'] = 'laboratory', source_kind: Literal['actual', 'reciprocity', 'artificial'] = 'actual', fraction: Literal[1, 3] | np.integer[Any] = 3,) -> EnclosureInsulationResultInsertion loss from two sound pressure levels, Equations (3) and (4).
at one stated position, with the same microphone positions in both runs, and the difference of the A-weighted values. The position is part of the answer: the standard requires it in the report, because an insertion loss at the operator’s ear and one a metre from the panel are different numbers about the same enclosure.
Parameters
| Name | Description |
|---|---|
level_without |
Sound pressure levels without the enclosure, in decibels. |
level_with |
The same with the enclosure, in decibels. |
frequencies |
Nominal band centres, in hertz. |
a_weighted_without |
without the enclosure, in decibels, when it was measured rather than computed. |
a_weighted_with |
The same with the enclosure, in decibels. |
base_standard |
The standard the pressure levels came from, one of those Table 1 of either part lists for a sound pressure level (default "ISO 11201"). One of "ISO 11201", "ISO 11202" or "ISO 11204". |
condition |
"laboratory" for part 1, "in-situ" for part 2. |
source_kind |
"actual", "reciprocity" or "artificial". |
fraction |
The band set, 3 for one-third octaves (default) or 1 for octaves. One of 1 or 3. |
Returns: The insertion loss, as an EnclosureInsulationResult.
Raises
| Exception | When |
|---|---|
| ValueError | For spectra that do not match, non-finite values, half an A-weighted pair, an unknown base standard, condition, source kind or band fraction, or a combination of condition and source kind Table 1 does not have. |
| TypeError | if base_standard is not a text, fraction is not an integer (a word, a flag or a float), a_weighted_with or a_weighted_without is not a single number, or frequencies, level_with or level_without holds a text or a value that is not a real number, or condition or source_kind is not a text. |
EnclosureInsulationResult
Section titled “EnclosureInsulationResult”EnclosureInsulationResult( frequencies: NDArray[np.float64] | None, level_without: NDArray[np.float64], level_with: NDArray[np.float64], insulation: NDArray[np.float64], quantity: Literal['sound_power', 'sound_pressure', 'reciprocity'], a_weighted_insulation: float | None, condition: Literal['laboratory', 'in-situ'], source_kind: Literal['actual', 'reciprocity', 'artificial'], base_standard: str, fraction: Literal[1, 3],)The measured insulation of an enclosure, band by band (ISO 11546).
Attributes
| Name | Description |
|---|---|
frequencies |
Nominal band centre frequencies, in hertz, or None when the levels were given without them. |
level_without |
The level measured without the enclosure, in decibels. |
level_with |
The level measured with it, in decibels. |
insulation |
, or per band, in decibels. |
quantity |
What was subtracted: "sound_power", "sound_pressure" or "reciprocity". |
a_weighted_insulation |
or of Equation (2) or (4), in decibels, or None when no band centres were given and no A-weighted pair was supplied. For the two standards of Table 1 that determine an A-weighted value alone, a single pair of levels is that value, and it is carried here. |
condition |
"laboratory" (part 1) or "in-situ" (part 2). |
source_kind |
"actual", "reciprocity" or "artificial". |
base_standard |
The standard the levels were determined by. |
fraction |
The band set, 3 for one-third octaves or 1 for octaves. One of 1 or 3. |
EnclosureInsulationResult.plot()
Section titled “EnclosureInsulationResult.plot()”EnclosureInsulationResult.plot( ax: Axes | None = None, *, language: Literal['en', 'es'] = 'en', **kwargs: Any,) -> AxesDraw the two runs and the difference between them.
Requires matplotlib (the [plot] extra).
Parameters
| Name | Description |
|---|---|
ax |
Existing axes, or None to create a figure. |
language |
Label language, "en" (default) or "es". |
kwargs |
Forwarded to phonometry._plot.noise_control.plot_enclosure_insulation. |
Returns: The Axes.
EnclosureInsulationResult.rounded
Section titled “EnclosureInsulationResult.rounded”property
The band values as clause 9.4 reports them, to the nearest decibel.
EnclosureInsulationWarning
Section titled “EnclosureInsulationWarning”The measurement is outside a condition ISO 11546 states.
EnclosureTestEnvironmentCheck
Section titled “EnclosureTestEnvironmentCheck”EnclosureTestEnvironmentCheck( base_standard: Literal['ISO 3743-1', 'ISO 3744', 'ISO 3746', 'ISO 3747', 'ISO 9614-1', 'ISO 9614-2', 'ISO 11201', 'ISO 11202', 'ISO 11204'], actual_area_ratio: float, mean_absorption_coefficient: float,)Whether a room is good enough for a base standard, Annex C of part 2.
Table C.1 is the annex’s, so its two columns, the area ratio they call for and the verdict are read from the standard asked about and the room, not stored beside them: an answer cannot be built against another limit.
Attributes
| Name | Description |
|---|---|
base_standard |
The standard asked about, one of the keys of TEST_ENVIRONMENT_REQUIREMENTS. One of "ISO 3743-1", "ISO 3744", "ISO 3746", "ISO 3747", "ISO 9614-1", "ISO 9614-2", "ISO 11201", "ISO 11202" or "ISO 11204". |
actual_area_ratio |
The of the room and the measurement surface given. |
mean_absorption_coefficient |
The the answer was read at. |
EnclosureTestEnvironmentCheck.background_margin_limit_db
Section titled “EnclosureTestEnvironmentCheck.background_margin_limit_db”property
The smallest margin over the background Table C.1 asks, in decibels.
Returns: The margin, or None where the table states none.
EnclosureTestEnvironmentCheck.environmental_correction_limit_db
Section titled “EnclosureTestEnvironmentCheck.environmental_correction_limit_db”property
The largest Table C.1 allows the standard, in decibels.
Returns: The limit, or None where the standard states none.
EnclosureTestEnvironmentCheck.passes
Section titled “EnclosureTestEnvironmentCheck.passes”property
The verdict: the room meets the limit of the standard.
True for a standard with no limit, whose answer turns
on the background margin alone, which this check does not see.
EnclosureTestEnvironmentCheck.required_area_ratio
Section titled “EnclosureTestEnvironmentCheck.required_area_ratio”property
The smallest that meets the limit.
at
mean_absorption_coefficient.
Returns: The ratio, or None where the standard states no limit.
estimated_a_weighted_enclosure_insulation
Section titled “estimated_a_weighted_enclosure_insulation”estimated_a_weighted_enclosure_insulation( spectrum_levels: NumericArrayLike, insulation: NumericArrayLike, *, frequencies: NumericArrayLike,) -> floatThe A-weighted insulation an enclosure would give a stated spectrum.
Annex C of part 1 and Annex D of part 2, the same formula:
where is the assumed source spectrum, the A-weighting of the band and the measured insulation. The sign of is the trap: the standard prints an attenuation, positive where the weighting takes level away, while this library’s band corrections are the correction itself, so . Both terms are formed here from the same table, so the total and the sum cannot disagree, and with the answer is exactly zero.
The same formula serves (giving ), and ; which one it is, is the caller’s.
Parameters
| Name | Description |
|---|---|
spectrum_levels |
The assumed source spectrum per band, in decibels. |
insulation |
The measured insulation per band, in decibels. |
frequencies |
Nominal band centres, in hertz. |
Returns: , in decibels.
Raises
| Exception | When |
|---|---|
| ValueError | For inputs that do not match band for band. |
| TypeError | if frequencies, insulation or spectrum_levels holds a text or a value that is not a real number. |
fill_ratio
Section titled “fill_ratio”fill_ratio(source_volume_m3: float, interior_volume_m3: float) -> floatHow much of the enclosure the source fills, 3.15 of part 1 and 3.13 of part 2.
. The artificial source of Annex A is
representative only up to
ARTIFICIAL_SOURCE_MAX_FILL_RATIO; past that it is changing the
interior field it is supposed to be measuring through.
Parameters
| Name | Description |
|---|---|
source_volume_m3 |
The volume of the source, in cubic metres. |
interior_volume_m3 |
The interior volume of the enclosure, in cubic metres. |
Returns: The ratio, dimensionless.
Raises
| Exception | When |
|---|---|
| ValueError | For a non-positive volume. |
| TypeError | if interior_volume_m3 or source_volume_m3 is not a single number. |
leak_ratio
Section titled “leak_ratio”leak_ratio(opening_area_m2: float, interior_surface_area_m2: float) -> floatHow open an enclosure or a cabin is.
, the area of the openings over the area of the interior surface: definition 3.16 of ISO 11546-1, 3.14 of ISO 11546-2 and 3.14 of ISO 11957, in the same words in all three. What they do with it differs: clause 4 of ISO 11546 only prefers a value under 2 %, while clause 1 of ISO 11957 makes the same 2 % a condition of applicability.
An opening fitted with an effective silencer does not count as one.
Parameters
| Name | Description |
|---|---|
opening_area_m2 |
The total area of the openings, in square metres. |
interior_surface_area_m2 |
The interior surface area, openings included, in square metres. |
Returns: The ratio, dimensionless.
Raises
| Exception | When |
|---|---|
| ValueError | For a non-positive area. |
| TypeError | if interior_surface_area_m2 or opening_area_m2 is not a single number. |
MANDATORY_BAND_RANGE_HZ
Section titled “MANDATORY_BAND_RANGE_HZ”Constant (mapping).
MANDATORY_BAND_RANGE_HZ = {3: (100.0, 5000.0), 1: (125.0, 4000.0)}MethodEntry
Section titled “MethodEntry”MethodEntry( base_standard: str, test_environment: str, quantities: tuple[str, ...], subclause: str, band_values: bool, survey_grade_excluded: bool = False,)One row of Table 1: a way of measuring and what it yields.
Attributes
| Name | Description |
|---|---|
base_standard |
The standard the levels come from. |
test_environment |
The environment the row names for it, as printed. |
quantities |
The symbols the row can give, such as ("D_W", "D_WA"). |
subclause |
The subclause of ISO 11546 that describes it. |
band_values |
Whether the row gives values per band, or only the A-weighted number. |
survey_grade_excluded |
Whether footnote 2 of Table 1 of part 1 marks the row, which excludes the survey-grade variant of that standard. Part 2 carries no such footnote. |
PREFERRED_BAND_RANGE_HZ
Section titled “PREFERRED_BAND_RANGE_HZ”Constant (mapping).
PREFERRED_BAND_RANGE_HZ = {3: (50.0, 10000.0), 1: (63.0, 8000.0)}ROOM_ABSORPTION_ESTIMATES
Section titled “ROOM_ABSORPTION_ESTIMATES”Constant (mapping).
ROOM_ABSORPTION_ESTIMATES = {0.05: 'Nearly empty room with smooth hard walls made of concrete, brick, plaster or tile', 0.1: 'Partly empty room; room with smooth walls', 0.15: 'Room with furniture; rectangular machinery room; rectangular industrial room', 0.2: 'Irregularly shaped room with furniture; irregularly shaped machinery room or industrial room', 0.25: 'Room with upholstered furniture; machinery or industrial room with a small amount of sound-absorbing material on ceiling or walls (e.g. partially absorptive ceiling)', 0.35: 'Room with sound-absorbing materials on both ceiling and walls', 0.5: 'Room with large amounts of sound-absorbing materials on ceiling and walls'}seal_ratio
Section titled “seal_ratio”seal_ratio(leak: float) -> floatThe reciprocal of the leak ratio.
, from NOTE 5 to definition 3.16 of ISO 11546-1 and NOTE 3 to definition 3.14 of ISO 11957. Both print the two because a catalogue quotes whichever reads better.
Parameters
| Name | Description |
|---|---|
leak |
The leak ratio , dimensionless and positive. |
Returns: , dimensionless.
Raises
| Exception | When |
|---|---|
| ValueError | For a non-positive ratio. |
| TypeError | if leak is not a single number. |
source_position_clearance_m
Section titled “source_position_clearance_m”source_position_clearance_m(shortest_inner_dimension_m: float) -> floatHow far the artificial source stands from a wall, 7.3 of part 1 and 7.2 of part 2.
with the shortest interior dimension of the enclosure, so that the plate is never against a panel it is meant to excite through the air. Both parts print the same sentence, and both add that the source is used in two orientations 90 degrees apart where the enclosure has room for them.
Parameters
| Name | Description |
|---|---|
shortest_inner_dimension_m |
, in metres. |
Returns: The least distance to any wall, in metres.
Raises
| Exception | When |
|---|---|
| ValueError | For a non-positive dimension. |
| TypeError | if shortest_inner_dimension_m is not a single number. |
SOURCE_WALL_CLEARANCE_FACTOR
Section titled “SOURCE_WALL_CLEARANCE_FACTOR”Constant (float).
SOURCE_WALL_CLEARANCE_FACTOR = 0.2TEST_ENVIRONMENT_REQUIREMENTS
Section titled “TEST_ENVIRONMENT_REQUIREMENTS”Constant (mapping).
TEST_ENVIRONMENT_REQUIREMENTS = {'ISO 3743-1': (None, 6.0), 'ISO 3744': (2.0, 6.0), 'ISO 3746': (7.0, 3.0), 'ISO 3747': (None, 3.0), 'ISO 9614-1': (None, None), 'ISO 9614-2': (None, None), 'ISO 11201': (2.0, 6.0), 'ISO 11202': (7.0, 3.0), 'ISO 11204': (7.0, 6.0)}UNRESTRICTED_ENCLOSURE_VOLUME_M3
Section titled “UNRESTRICTED_ENCLOSURE_VOLUME_M3”Constant (float).
UNRESTRICTED_ENCLOSURE_VOLUME_M3 = 2.0weighted_enclosure_insulation
Section titled “weighted_enclosure_insulation”weighted_enclosure_insulation( insulation: NumericArrayLike, *, quantity: Literal['sound_power', 'reciprocity'] = 'sound_power', fraction: Literal[1, 3] | np.integer[Any] = 3,) -> WeightedEnclosureInsulationThe single-number rating of an insertion loss, 7.4 of part 1 and 7.3 of part 2.
Both parts say the same thing: rate the spectrum by ISO 717-1, putting
or where that standard writes . The
reference curve, the shift and the adaptation terms come from
phonometry.building.weighted_rating, which has its own conformance
rows; what is done here is the trim to the rating bands.
Parameters
| Name | Description |
|---|---|
insulation |
The insertion loss per band, in decibels, over exactly the 16 one-third-octave rating bands of 100 Hz to 3.15 kHz or the 5 octave ones of 125 Hz to 2 kHz; a wider spectrum is refused rather than trimmed, because which bands it holds is the caller’s to say. |
quantity |
"sound_power" (default) or "reciprocity". |
fraction |
The band set, 3 for one-third octaves (default) or 1 for octaves. One of 1 or 3. |
Returns: The rating, as a WeightedEnclosureInsulation.
Raises
| Exception | When |
|---|---|
| ValueError | For a spectrum that does not carry the rating bands. |
| TypeError | if fraction is not an integer (a word, a flag or a float), or insulation holds a text or a value that is not a real number, or quantity is not a text. |
WeightedEnclosureInsulation
Section titled “WeightedEnclosureInsulation”WeightedEnclosureInsulation( rating: int, c: int, ctr: int, unfavorable_sum: float, frequencies: NDArray[np.float64], quantity: Literal['sound_power', 'reciprocity'],)The single-number rating of an insertion loss spectrum, ISO 717-1.
Attributes
| Name | Description |
|---|---|
rating |
or , in decibels. |
c |
The spectrum adaptation term , in decibels. |
ctr |
The spectrum adaptation term , in decibels. |
unfavorable_sum |
The sum of unfavourable deviations the shift left, in decibels. |
frequencies |
The bands the rating was read over, in hertz. |
quantity |
What was rated, "sound_power" or "reciprocity". |