emission.workstation

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 the ISO 11200 group shares: the emission sound pressure level at a work station, its two corrections and its uncertainty.

The sound power level says how much noise a machine makes. The emission sound pressure level says how much of it reaches the person working at it, and it is the number a machine is declared and bought by. ISO 4871 already has this library declaring $L_{p A}$ ; nothing computed it until now.

Five standards determine it, and they differ only in how they get rid of the room:

====================== ===================================================== ISO 11201:2010 Free field over a reflecting plane, so there is no room to get rid of and $K_{3} = 0$ . ISO 11202:2010 Two approximate routes to $K_{3}$ , one for a machine with a dominating source and one from the directivity the work station sees. ISO 11203:1995 No sound-pressure measurement at the work station: the level is derived from the sound power level, which was itself determined somehow. ISO 11204:2010 The same piecewise $K_{3}$ as ISO 11202 method A.2, reached accurately rather than approximately. ISO 11205:2003 By sound intensity, and not implemented here. ====================== =====================================================

Everything they share is in this module, transcribed once, and each part’s own method sits beside it in its own module.

The quantity. ISO 11201:2010 Equation (7), ISO 11202:2010 Equation (10) and ISO 11204:2010 Equation (9) print one law three times,

L_{p} = L_{p}^{'} - K_{1} - K_{3}

where $L_{p}^{'}$ is what the meter read, $K_{1}$ removes the background noise and $K_{3}$ removes the reflections the room sent back. ISO 11201 prints it without the $K_{3}$ term because its environment is qualified so that the term is negligible, which is the same equation with a zero in it.

Peak levels take no correction at all. ISO 11204:2010 clause 7 and ISO 11202:2010 clause 8 both say so: $L_{p C, peak}$ is reported as measured. A correction derived from mean-square pressures has no meaning for a single largest excursion. Nothing here can tell a peak level from any other, since both arrive as a number of decibels, so this is a rule for the caller and not a guard: do not put a peak level through emission_sound_pressure_level.

The background correction is the same expression the sound-power side already uses, ISO 3744:2010 Equation (16), but this group sets its own thresholds: 15 dB of margin makes it negligible, and 6 dB (grade 2) or 3 dB (grade 3) is as far down as a result may be claimed. Below that the correction is clamped and the level becomes an upper bound, which is why background_noise_correction_at_workstation returns the clamp rather than raising: the reading is still worth reporting, it just stops being a determination.

The local environmental correction is where the group divides. Both ISO 11202 Equation (A.5) and ISO 11204 Equations (A.2)/(A.5) print the same piecewise function of one dimensionless ratio $z$ ,

K_{3} = ⎩ ⎨ ⎧ 7 dB, - 10 l g z dB, 0 dB, z \leq 0, 2 0, 2 < z \leq 1 z > 1

and differ only in how $z$ is reached. The two branches meet: at $z = 0, 2$ the middle branch gives $- 10 l g 0, 2 = 6, 99$ dB, so the 7 dB cap is the curve’s own value rounded, not a discontinuity.

The uncertainty is one pair of equations in all three measuring parts (ISO 11201 Equations (10) and (11), ISO 11202 (13) and (14), ISO 11204 (12) and (13)):

σ_{tot} = σ_{R 0}^{2} + σ_{omc}^{2}, U = k σ_{tot}

with $σ_{R 0}$ the reproducibility of the method and $σ_{omc}$ the instability of the machine itself, estimated from repeated measurements by Equation (C.1).

Sources (clean-room, implemented from the standard texts): ISO 11201:2010, ISO 11202:2010 and its Amendment 1:2020, ISO 11203:1995 and its Amendment 1:2020, ISO 11204:2010, with the worked examples of ISO 11200:2014 Annex B.

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

background_noise_correction_at_workstation

background_noise_correction_at_workstation(
    measured_level_db: ArrayLike,
    background_level_db: ArrayLike,
    *,
    grade: Grade = 'engineering',
) -> tuple[float | NDArray[np.float64], bool]

Background-noise correction $K_{1}$ for the ISO 11200 group.

K_{1} = - 10 l g (1 - 1 0^{- 0, 1Δ L}) dB, Δ L = L_{p}^{'} - L_{p} (B)

ISO 11201:2010 Equation (5), ISO 11202:2010 Equation (8) and ISO 11204:2010 Equation (7), one expression printed three times. It is the same closed form as ISO 3744:2010 Equation (16) on the sound-power side, and this group puts its own thresholds around it: above NEGLIGIBLE_BACKGROUND_MARGIN_DB the correction is taken as zero, and below the grade’s entry in MINIMUM_BACKGROUND_MARGIN_DB it is held at the value it has there. A held correction does not fail the measurement; it makes the level an upper bound, which the second return value reports and the caller must carry into what it publishes.

Parameters

Name	Description
`measured_level_db`	The reading with the machine running, $L_{p}^{'}$ , in decibels; a scalar or one value per band.
`background_level_db`	The reading with it stopped, $L_{p} (B)$ , in decibels, of the same shape.
`grade`	`'engineering'` (grade 2, 6 dB) or `'survey'` (grade 3, 3 dB), which sets how far down a determination may be claimed.

Returns: The correction in decibels, and whether any value was clamped.

Raises

Exception	When
ValueError	If the two arguments do not have the same shape, or the grade is neither of the two.

DEFAULT_COVERAGE_FACTOR

Constant (float).

DEFAULT_COVERAGE_FACTOR = 1.6

emission_expanded_uncertainty

emission_expanded_uncertainty(
    total_standard_deviation_db: float,
    coverage_factor: float = 1.6,
) -> float

Expanded uncertainty $U = k σ_{tot}$ .

ISO 11201:2010 Equation (11), ISO 11202:2010 Equation (14) and ISO 11204:2010 Equation (13). The coverage factor is the caller’s to choose: $k = 2$ gives the two-sided 95 % interval of a normal distribution, while the worked examples of ISO 11200:2014 Annex B all print $k = 1, 6$ , which is the one-sided factor used when the result is compared with a limit value, and is this function’s default.

Parameters

Name	Description
`total_standard_deviation_db`	$σ_{tot}$ in decibels.
`coverage_factor`	$k$ (default `DEFAULT_COVERAGE_FACTOR`).

Returns: $U$ in decibels.

Raises

Exception	When
ValueError	If either argument is negative.

emission_sound_pressure_level

emission_sound_pressure_level(
    measured_level_db: ArrayLike,
    *,
    background_correction_db: ArrayLike = 0.0,
    local_correction_db: ArrayLike = 0.0,
) -> float | NDArray[np.float64]

The emission sound pressure level, reading less both corrections.

L_{p} = L_{p}^{'} - K_{1} - K_{3}

ISO 11201:2010 Equation (7) (which prints no $K_{3}$ because its environment makes the term negligible), ISO 11202:2010 Equation (10) and ISO 11204:2010 Equation (9).

Never call this for a peak level. ISO 11202:2010 clause 8 and ISO 11204:2010 clause 7 both forbid correcting $L_{p C, peak}$ , which is reported exactly as measured: neither correction has a meaning for a single largest excursion, both being derived from mean-square pressures. A peak level reaches this function as an ordinary number of decibels and cannot be recognised, so the rule is the caller’s to keep.

Parameters

Name	Description
`measured_level_db`	The uncorrected reading $L_{p}^{'}$ , in decibels.
`background_correction_db`	$K_{1}$ in decibels (default 0).
`local_correction_db`	$K_{3}$ in decibels (default 0).

Returns: $L_{p}$ in decibels, of the broadcast shape.

EmissionPressureResult

EmissionPressureResult(
    level_db: float | NDArray[np.float64],
    measured_level_db: float | NDArray[np.float64],
    background_correction_db: float | NDArray[np.float64],
    local_correction_db: float | NDArray[np.float64],
    grade: Grade,
    *,
    upper_bound: bool,
    standard: str,
)

An emission sound pressure level and the two corrections behind it.

Attributes

Name	Description
`level_db`	Emission sound pressure level $L_{p}$ , in decibels re 20 uPa: what the meter read, less both corrections.
`measured_level_db`	The uncorrected reading $L_{p}^{'}$ , in decibels.
`background_correction_db`	$K_{1}$ , in decibels.
`local_correction_db`	$K_{3}$ , in decibels.
`grade`	Accuracy grade the determination earns.
`upper_bound`	`True` when the background margin fell below the grade’s minimum, so the level is an upper bound rather than a determination.
`standard`	The part of the group the determination followed.

EmissionPressureResult.plot()

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

Plot the reading, the two corrections and what is left of them.

environmental_ratio_from_absorption

environmental_ratio_from_absorption(
    absorption_area_m2: ArrayLike,
    measurement_surface_m2: float,
    directivity_index_db: ArrayLike = 0.0,
) -> float | NDArray[np.float64]

The ratio $z$ from the equivalent sound absorption area.

z = 1 - \frac{1}{1 + A / ( 4 S _{M} )} 1 0^{- 0, 1 D_{I, op}^{*}}

ISO 11204:2010 Equation (A.6). It is the same quantity environmental_ratio_from_k2 returns, reached without going through $K_{2}$ : under the ISO 3744 definition $K_{2} = 10 l g (1 + 4 S_{M} / A)$ the two are identically equal, which is why ISO 11204 A.1.2 says the two routes rest on the same assumptions.

Parameters

Name	Description
`absorption_area_m2`	Equivalent sound absorption area $A$ of the test room, in square metres, strictly positive.
`measurement_surface_m2`	Area $S_{M}$ of the reference measurement surface, in square metres, strictly positive.
`directivity_index_db`	$D_{I, op}^{*}$ in decibels (default 0).

Returns: The ratio $z$ .

Raises

Exception	When
ValueError	If either area is not strictly positive.

environmental_ratio_from_k2

environmental_ratio_from_k2(
    environmental_correction_db: ArrayLike,
    directivity_index_db: ArrayLike = 0.0,
) -> float | NDArray[np.float64]

The ratio $z$ from the environmental correction of the test room.

z = 1 - (1 - 1 0^{- 0, 1 K_{2}}) 1 0^{- 0, 1 D_{I, op}^{*}}

ISO 11202:2010 Equation (A.4) and ISO 11204:2010 Equation (A.3). $K_{2}$ is the average environmental correction of the reference measurement surface, the quantity environmental_correction computes for the sound-power methods, and $D_{I, op}^{*}$ is the apparent directivity index the work station sees.

With no directivity to speak of the expression collapses to $z = 1 0^{- 0, 1 K_{2}}$ , so $K_{3} = K_{2}$ : a work station that sees the machine no more strongly than the measurement surface does needs the same correction the surface needed. That holds until the cap bites, at $K_{2} = 7$ dB; above it the local correction stays at MAX_K3_DB however large the environmental one grows, which is the piecewise function of local_environmental_correction and not a limitation here.

Parameters

Name	Description
`environmental_correction_db`	$K_{2}$ in decibels, non-negative.
`directivity_index_db`	$D_{I, op}^{*}$ in decibels (default 0, no directivity).

Returns: The ratio $z$ , of the broadcast shape.

GRADE_2_MAX_K3_DB

Constant (float).

GRADE_2_MAX_K3_DB = 4.0

grade_from_local_correction

grade_from_local_correction(local_correction_db: ArrayLike) -> Grade

The accuracy grade a local environmental correction earns.

ISO 11202:2010 A.1.3 puts the boundary at GRADE_2_MAX_K3_DB: a greatest possible $K_{3}$ of 4 dB or less is grade 2 (engineering), and more than that is grade 3 (survey). Method A.2 reaches the same boundary by a different road, Condition (A.6), which is algebraically the same 4 dB once (A.4) and (A.5) are substituted into it.

The worst band decides, since a determination is only as good as its weakest part.

Parameters

Name	Description
`local_correction_db`	$K_{3}$ in decibels; a scalar or one value per band.

Returns: 'engineering' or 'survey'.

local_environmental_correction

local_environmental_correction(
    ratio: ArrayLike,
) -> float | NDArray[np.float64]

Local environmental correction $K_{3}$ from the ratio $z$ .

K_{3} = ⎩ ⎨ ⎧ 7 dB, - 10 l g z dB, 0 dB, z \leq 0, 2 0, 2 < z \leq 1 z > 1

ISO 11202:2010 Equation (A.5) and ISO 11204:2010 Equations (A.2) and (A.5), the same three lines printed three times; only the route to $z$ differs between them, and that is environmental_ratio_from_k2 and environmental_ratio_from_absorption.

The cap is the curve’s own value, not a separate rule: $- 10 l g 0, 2 = 6, 99$ dB, so the function is continuous where the 7 dB takes over. The upper branch is a floor for the same reason a correction cannot be negative: the room can only add to the reading.

Parameters

Name	Description
`ratio`	The dimensionless $z$ , strictly positive; a scalar or one value per band.

Returns: $K_{3}$ in decibels, of the same shape.

Raises

Exception	When
ValueError	If any value is not strictly positive.

MAX_K3_DB

Constant (float).

MAX_K3_DB = 7.0

MINIMUM_BACKGROUND_MARGIN_DB

Constant (mapping).

MINIMUM_BACKGROUND_MARGIN_DB = {'engineering': 6.0, 'survey': 3.0}

NEGLIGIBLE_BACKGROUND_MARGIN_DB

Constant (float).

NEGLIGIBLE_BACKGROUND_MARGIN_DB = 15.0

operating_standard_deviation

operating_standard_deviation(levels_db: ArrayLike) -> float

Standard deviation of the operating and mounting conditions.

σ_{omc} = \frac{1}{N - 1} j = 1 \sum N (L_{p, j}^{'} - \overline{L_{p}^{'}})^{2}

Equation (C.1), identical in ISO 11201:2010, ISO 11202:2010 and ISO 11204:2010. It is the sample standard deviation of levels measured under the same nominal conditions, and it answers how repeatable the machine is rather than how good the method is: the measurements are made in situ, so the readings need no correction before going in.

The divisor is $N - 1$ , as printed. The two worked examples of ISO 11200:2014 Annex B disagree with each other about that, and docs/ERRATA.md records it; this library follows the equation.

Parameters

Name	Description
`levels_db`	Repeated readings under the same conditions, in decibels; at least two.

Returns: $σ_{omc}$ in decibels.

Raises

Exception	When
ValueError	If fewer than two readings are given.

subinterval_level

subinterval_level(levels_db: ArrayLike, durations_s: ArrayLike) -> float

One level for a cycle made of operating periods of different lengths.

L_{p} = 10 l g [\frac{1}{T} i = 1 \sum N T_{i} 1 0^{0, 1 L_{p, T_{i}}}] dB, T = i \sum T_{i}

ISO 11201:2010 Equation (8), ISO 11202:2010 Equation (11) and ISO 11204:2010 Equation (10). A machine that idles, cuts and returns spends a different length of time in each state, so the states are energy-averaged weighted by how long each lasts, not by how many there are.

Parameters

Name	Description
`levels_db`	The level of each sub-interval, in decibels.
`durations_s`	How long each lasted, in seconds, strictly positive and of the same length.

Returns: The level of the whole interval, in decibels.

Raises

Exception	When
ValueError	If the two are of different lengths, or a duration is not strictly positive.

total_standard_deviation

total_standard_deviation(
    reproducibility_db: float,
    operating_db: float = 0.0,
) -> float

Total standard deviation of the determination.

σ_{tot} = σ_{R 0}^{2} + σ_{omc}^{2}

ISO 11201:2010 Equation (10), ISO 11202:2010 Equation (13) and ISO 11204:2010 Equation (12). The two components are taken as statistically independent, which is what lets them add in quadrature: one is a property of the method and the other of the machine.

Parameters

Name	Description
`reproducibility_db`	$σ_{R 0}$ of the method, in decibels.
`operating_db`	$σ_{omc}$ of the machine, in decibels (default 0, a source whose emission does not wander).

Returns: $σ_{tot}$ in decibels.

Raises

Exception	When
ValueError	If either component is negative.

Creado y mantenido por José Manuel Requena Plens ORCID Todos los proyectos