Skip to content

environment.assessment.rating

Environmental noise descriptors per ISO 1996-1:2016.

Day-evening-night (Lden, 3.6.4) and day-night (Ldn, 3.6.5) sound levels, and composite whole-day rating levels (6.5, Formulae 5-6).

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

composite_rating_level(
periods: Iterable[tuple[float, float, float]] | NumericArrayLike,
) -> float

Composite whole-day rating level (ISO 1996-1:2016, 6.5).

Generalizes Formulae (5) and (6): each period contributes its rating level plus adjustment, weighted by its share of the 24 h day:

Parameters

Name Description
periods Iterable of (level, hours, adjustment) tuples, or an array of one such row per period. level is the period’s (rating) equivalent continuous level, hours its duration and adjustment the time-of-day or source adjustment K (e.g. ISO 1996-1 Table A.1: evening 5 dB, night 10 dB). Hours must be positive and sum to 24.

Returns: Composite rating level in dB.

Raises

Exception When
ValueError for no period, a period that is not three numbers, a duration that is not positive and finite, or durations that do not sum to 24 h.
TypeError if periods holds a text or a value that is not a real number.
lden(
lday: float,
levening: float,
lnight: float,
*,
period_hours: tuple[float, float, float] = (12.0, 4.0, 8.0),
) -> float

Day-evening-night sound level Lden (ISO 1996-1:2016, 3.6.4).

Parameters

Name Description
lday LAeq over the day period, in dB.
levening LAeq over the evening period, in dB (+5 dB weighting).
lnight LAeq over the night period, in dB (+10 dB weighting).
period_hours (t_day, t_evening, t_night), the duration of each period in hours, summing to 24. Default (12, 4, 8); countries may define the periods differently (3.6.4 Note 1).

Returns: Lden in dB.

Raises

Exception When
TypeError if lday, levening or lnight is not a single number.
ldn(
lday: float,
lnight: float,
*,
period_hours: tuple[float, float] = (15.0, 9.0),
) -> float

Day-night sound level Ldn (ISO 1996-1:2016, 3.6.5).

Parameters

Name Description
lday LAeq over the day period, in dB.
lnight LAeq over the night period, in dB (+10 dB weighting).
period_hours (t_day, t_night), the duration of each period in hours, summing to 24. Default (15, 9).

Returns: Ldn in dB.

Raises

Exception When
TypeError if lday or lnight is not a single number.