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
Section titled “composite_rating_level”composite_rating_level( periods: Iterable[tuple[float, float, float]] | NumericArrayLike,) -> floatComposite 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),) -> floatDay-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),) -> floatDay-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. |
Created and maintained by José Manuel Requena PlensORCIDAbout the maintainerRelease notesChangelogAll projects