# environment.assessment.rating

> One page of the phonometry documentation, as Markdown. Index: https://docs.jmrp.io/phonometry/llms.txt

Canonical: https://docs.jmrp.io/phonometry/reference/api/environment/rating/
Language: en
Version: phonometry 4.0.0
Install: pip install "phonometry[full]"
Author: José Manuel Requena Plens (https://orcid.org/0000-0003-1250-6212)
Published: 2026-07-15
Updated: 2026-11-11T17:49:24Z
License: MIT (https://github.com/jmrplens/phonometry/blob/main/LICENSE)
Summary: Environmental noise descriptors per ISO 1996-1:2016.

---

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

```python
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:

$$
10 \log_{10}\left[ \sum_i \frac{h_i}{24} \cdot 10^{0.1 (L_i + K_i)} \right]
$$

**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

```python
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).

$$
L_\mathrm{den} = 10 \log_{10}\left\{ (1/24) \left[ t_\mathrm{d} \cdot 10^{0.1 L_\mathrm{day}} + t_\mathrm{e} \cdot 10^{0.1 (L_\mathrm{evening}+5)} + t_\mathrm{n} \cdot 10^{0.1 (L_\mathrm{night}+10)} \right] \right\}
$$

**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

```python
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).

$$
L_\mathrm{dn} = 10 \log_{10}\left\{ (1/24) \left[ t_\mathrm{d} \cdot 10^{0.1 L_\mathrm{day}} + t_\mathrm{n} \cdot 10^{0.1 (L_\mathrm{night}+10)} \right] \right\}
$$

**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. |
