02NoiseLab carries an Environmental Noise Directive (END, 2002/49/EC) road-noise study inside QGIS, from a road layer with traffic fields to strategic noise maps, exposure tables and health outcomes. The calculation follows CNOSSOS-EU, Annex II of the END as set out by Commission Directive (EU) 2015/996 and amended by Commission Delegated Directive (EU) 2021/1226; the health part follows Annex III as set out by Commission Directive (EU) 2020/367.
The chain is: traffic flows per vehicle category and period; octave-band sound power per metre of road; point sources along the roads; propagation from every source to every receiver within the search radius (divergence, atmospheric absorption, ground effect, diffraction over buildings and barriers, homogeneous and favourable conditions); \(L_\mathrm{d}\), \(L_\mathrm{e}\), \(L_\mathrm{n}\), \(L_\mathrm{den}\) and \(L_\mathrm{night}\) at grid and facade receivers; residents assigned to facade receivers; END tables, WHO guideline exceedance and Directive 2020/367 outcomes; mitigation scenarios; an HTML report.
The same chain is available in two ways: the lab dock (page by page, with charts, KPI cards and a styled map) and the Processing provider (one algorithm per step plus a whole-chain lab and a scenario algorithm, usable in models and batch runs). Only qgis.core, NumPy, GDAL and PyQt are required; SciPy is used for a faster neighbour search when present, with identical results without it. The plugin makes no network calls.
02NoiseLab is an open, auditable model for planners and researchers. Every equation is in this manual and in the report, the coefficient tables carry their Official Journal page references, and the scope limits are listed in section 13. It does not claim certification against ISO/TR 17534-4.
All acoustics run in a projected CRS in metres. If the road layer is geographic, its map units are not metres, or it is Web Mercator, every input is reprojected to the UTM zone of the road layer's extent centre (EPSG:326xx north, 327xx south); otherwise the road layer's CRS is kept. Outputs (vector and raster) are written in that working CRS, and the Data page badge, the run log and the report say which CRS was used and why.
Levels are dB re \(20\,\mu\mathrm{Pa}\), A-weighted unless a field name ends in _hz<band> (octave bands \(63\) to \(8000\,\mathrm{Hz}\), unweighted). Sound powers are dB re \(1\,\mathrm{pW}\) (per metre for line sources). Speeds are km/h, flows vehicles per hour per period, heights metres above ground (with a DEM: above the terrain).
| Layer | Geometry | Fields | Notes |
|---|---|---|---|
| Roads (required) | Lines | AADT (veh/day) and heavy-vehicle percent (categories 2 and 3, percent of AADT), speed (km/h); or period flow fields (veh/h per period and category); or a road class field (OSM highway). Optional surface name (Table F-4) and one-way flag. | One feature per segment. 02TODLab output (aadt, trk_pct) is read directly. NULL flows give zero flow: the road emits nothing. |
| Buildings | Polygons | Height (m) or levels (\(\text{storeys} \times \text{storey height}\), default \(3\,\mathrm{m}\)); residents; dwellings; an id field. | Screens for diffraction, facade receivers, population. Without height or levels the default height (10 m) is used and logged. 02Dasymetric <count>_est fields can be used as residents. |
| Population polygons | Polygons | Residents per polygon | Used when no residents field is set: shared over the buildings whose centroid lies in the polygon by floor area (\(\text{footprint} \times \text{storeys}\)). |
| Barriers | Lines | Height (m) | Thin screens; 3 m when the height is missing (logged). |
| Ground | Polygons | \(G\) (\(0\) hard, \(1\) soft) | Elsewhere the default \(G\) applies (\(G = 0\) for urban areas; use \(G = 1\) for open land). |
| DEM | Raster | Elevation (m) | Sets source, receiver and obstacle elevations; terrain screening is not modelled. |
The dock sits on the right of the QGIS window with an icon rail. Every parameter has a tooltip with its unit and the equation or rule it feeds. Computations run as QGIS background tasks with a progress bar and a Cancel button; the dock never freezes, and a cancelled run leaves earlier results unchanged. Results go to a 02NoiseLab layer group, styled with one fixed 5 dB band palette that the map, the legends, the charts and the report share:
\(< 35\,\mathrm{dB}\) 35–39 dB 40–44 dB 45–49 dB 50–54 dB 55–59 dB 60–64 dB 65–69 dB 70–74 dB 75–79 dB \(\ge 80\,\mathrm{dB}\)
Pick the road layer (required), buildings, population polygons, barriers, ground polygons and DEM, and the height, levels, storey height, residents, dwellings, barrier height and \(G\) fields. The CRS badge shows the working CRS and why it was chosen. Load demo district adds the synthetic district of section 12 and fills every field. KPI cards: road length (km), buildings, residents, extent (\(\mathrm{km^2}\)). Run all steps runs emission, grid, facades, exposure and health with the settings of every page.
Traffic mode chips: AADT (AADT, heavy percent and speed fields), Period flows (a field per period and category, veh/h), Road class (OSM highway defaults; a warning badge says they are assumed values to be replaced with counts). Period share sliders (day, evening, night) always add up to \(100\,\%\); the heavy split divides the heavy percent between categories 2 and 3 (default \(1:2\)); motorcycles (4b) as a percent of AADT. Period scheme: start hours of day, evening and night (END default 07/19/23; for example 06/18/22) and the evening and night penalties (5 and 10 dB). Road surface from Table F-4. Compute emission fills a table of A-weighted \(L_{W'}\) (dB(A)/m) for day, evening and night with the hourly day flow, draws the octave spectrum of the selected road with rolling and propulsion noise stacked, styles the roads by day \(L_{W'}\), and shows KPI cards (roads, mean and maximum day \(L_{W'}\), vehicle-km per day).
Grid cell \(\Delta x\) (m, default \(10\); run time grows with \(1/\Delta x^2\)), receiver height (END: 4 m), search radius (default 300 m), source step (5 m), maximum diffraction edges (4), default \(G\), air temperature (also used for the rolling-noise temperature correction), relative humidity, air pressure and the favourable occurrence \(p\) for day, evening and night (default \(p = 0.5\)). Estimate run time counts receivers, sources and paths and times a sample of receivers spread over the set. Compute noise map writes \(L_\mathrm{den}\), \(L_\mathrm{night}\), \(L_\mathrm{d}\) and \(L_\mathrm{e}\) GeoTIFFs and \(L_\mathrm{den}\) isophone polygons; KPI cards: maximum \(L_\mathrm{den}\), area at or above 55 and 65 dB \(L_\mathrm{den}\) (\(\mathrm{km^2}\)), run time; a chart of the area per 5 dB band.
Receiver spacing along walls (3 m), offset in front of the facade (0.1 m), and the allocation of residents: equal share per facade receiver of the building (CNOSSOS-EU 2.8, default) or most exposed (all residents at the facade with the highest \(L_\mathrm{den}\), a sensitivity option). Compute facade levels adds the facade receivers (\(L_\mathrm{den}\), \(L_\mathrm{night}\), \(L_\mathrm{d}\), \(L_\mathrm{e}\), residents) and the buildings with their highest and lowest facade \(L_\mathrm{den}\) and \(L_\mathrm{night}\) and the quiet-facade flag. KPI cards: residents at \(L_\mathrm{den} \ge 55\,\mathrm{dB}\), at \(L_\mathrm{night} \ge 50\,\mathrm{dB}\), quiet-facade buildings, facade receivers; a chart of buildings per band of their most exposed facade.
Band preset chips: END (\(L_\mathrm{den}\) 55-59, 60-64, 65-69, 70-74, \(\ge 75\); \(L_\mathrm{night}\) 50-54 ... \(\ge 70\)), Turkey 2022 (50-54 ... \(\ge 75\) for every indicator), custom (comma-separated lower bounds). The END tables for \(L_\mathrm{den}\) and \(L_\mathrm{night}\) show people, people rounded to the nearest hundred and dwellings per band (the exported CSV and the report add the residents of buildings with a quiet facade, END Annex VI 1.5), the area table shows \(\mathrm{km^2}\), people and dwellings at or above 55, 65 and 75 dB \(L_\mathrm{den}\); each table can be copied as CSV. A stacked bar shows people per band, two gauges show the share of residents at or above the WHO 2018 road guideline values (53 dB \(L_\mathrm{den}\), 45 dB \(L_\mathrm{night}\)), and four cards show highly annoyed people, highly sleep-disturbed people, the IHD attributable fraction and, when an incidence per \(100\,000\) is entered, the attributable IHD cases per year. Changing the preset or the incidence recomputes the tables from the finished run (no new propagation).
A mitigation form: name, speed change \(\Delta v\) (km/h, \(v' = \max(v + \Delta v, 20\,\mathrm{km/h})\)), flow factor \(f_Q\), heavy-vehicle factor \(f_H\), night heavy-vehicle factor \(f_{H,n}\), road surface, added barrier lines with their height field, and a QGIS expression selecting the affected roads (blank: all). Run scenario reruns the base run (grid and facades) on the same receivers and source positions and adds the \(\Delta L_\mathrm{den} = L_\mathrm{den}^\mathrm{scenario} - L_\mathrm{den}^\mathrm{base}\) raster (blue is quieter), the exposure change table and a card with the residents moved out of \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) and \(L_\mathrm{night} \ge 50\,\mathrm{dB}\). Up to three named scenarios are shown side by side.
Export report writes the self-contained HTML report (KPIs, END tables, health outcomes, method with equations, scope limits, run parameters, log and references; inline CSS and SVG, no scripts, no external resources). END tables CSV, GeoTIFF grids (\(L_\mathrm{den}\), \(L_\mathrm{night}\), \(L_\mathrm{d}\), \(L_\mathrm{e}\) and the scenario deltas) and GeoPackage (roads, facade receivers, buildings, isophones) write the other outputs to a folder; an open-in-browser link follows each export.
A short guide, what the model includes and leaves out, the method references, and links to this manual, the repository and the issue tracker.
Provider 02NoiseLab. Every algorithm reprojects its inputs to the working CRS (section 3), reports progress and honours Cancel; a bad input stops with a readable message. Outputs are not styled by the algorithms. Field defaults match the demo layers (aadt, trk_pct, speed, highway, height, pop, dwellings, bid, g); a default field name that your layer does not have counts as not set. Advanced parameters are marked advanced.
The step algorithms chain to the same numbers as the whole-chain lab: Facade receivers → Noise levels at receiver points → Assign residents to facade receivers → END exposure table and Health outcomes.
Hourly flows per CNOSSOS-EU vehicle category (1 light, 2 medium heavy, 3 heavy, 4a mopeds, 4b motorcycles) and period, read from AADT and heavy-vehicle percent, from period flow fields, or from road class defaults (core traffic.specs_from_layer). Output fields q_<d|e|n>_<category> in vehicles per hour, the light-vehicle speed per period (km/h), the road surface and the one-way flag.
\(Q_{p,m} = \mathrm{AADT}\; s_p\, \phi_m / h_p\) with the period share \(s_p\), the period length \(h_p\) in hours and the category share \(\phi_m\); the heavy percent is split \(1:2\) into categories 2 and 3; speeds are evaluated at \(v = \max(v, 20\,\mathrm{km/h})\) (Annex II 2.2.1; equation (1) of section 7). Roads with a NULL flow get zero flow and emit nothing.
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
OUTPUT | Traffic flows | vector output |
Numbers returned: DAILY_VEHICLES (Sum of daily vehicles over the roads).
Directional sound power per metre of road for day, evening and night (core emission.segment_emissions): lw_day, lw_eve, lw_night are A-weighted overall levels in dB(A) re \(1\,\mathrm{pW/m}\); lw_<period>_hz<band> are the unweighted octave-band levels \(63\)–\(8000\,\mathrm{Hz}\); the flows used (q_*) and the day speed are kept. Output in the working CRS.
Rolling \(L_{WR} = A_R + B_R \lg(v/70) + \Delta L_{WR}\); propulsion \(L_{WP} = A_P + B_P\,(v - 70)/70 + \Delta L_{WP}\); vehicle \(L_W = 10 \lg\left(10^{L_{WR}/10} + 10^{L_{WP}/10}\right)\); line source per metre \(L_{W'} = 10 \lg \sum_m 10^{\left(L_{W,m} + 10 \lg\frac{Q_m}{1000\, v_m}\right)/10}\), with \(Q_m\) in \(\mathrm{veh/h}\) and \(v_m\) in \(\mathrm{km/h}\) (Annex II 2.2.1-2.2.20, Table F-1 and F-4 of Delegated Directive (EU) 2021/1226; equations (2)-(10) of section 7). Air temperature correction \(K_m\,(20 - \tau)\) on rolling noise; a two-way road with a gradient \(s\) is split into \(Q_m/2\) at \(+s\) and \(Q_m/2\) at \(-s\).
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
TEMP_C | Air temperature (\(^\circ\mathrm{C}\)) | number | 15.0 |
OUTPUT | Road emission | vector output |
Numbers returned: MEAN_LW_DAY (Mean day \(L_{W'}\) (dB(A)/m)), MAX_LW_DAY (Maximum day \(L_{W'}\) (dB(A)/m)).
Cuts every road into pieces of at most the source step and places one point source at the centre of each piece, \(0.05\,\mathrm{m}\) above the road (core sources.discretise). Fields: road_fid (feature id of the road copy, 1-based in input order), length (m), lw_day, lw_eve, lw_night (A-weighted \(L_{W,0}\) in dB(A) re \(1\,\mathrm{pW}\)).
\(L_{W,0} = L_{W'} + 10 \lg l_k\) for a piece of length \(l_k\) in \(\mathrm{m}\) (Annex II 2.2.1; equation (11)); near junctions with a crossing or roundabout type the acceleration corrections \(C_{R}\max(1 - |x|/100, 0)\) and \(C_{P}\max(1 - |x|/100, 0)\) are applied per point source at its distance \(x\) from the junction. In the full lab the step is also refined to at most half the distance to the nearest receiver.
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
TEMP_C | Air temperature (\(^\circ\mathrm{C}\)) | number | 15.0 |
SOURCE_STEP | Maximum point-source spacing (m) | number | 5.0 |
OUTPUT | Point sources | vector output |
Numbers returned: SOURCES (Point sources).
Receivers at the centres of a regular grid over an extent, at the receiver height; cells whose centre lies inside a building are left out (core receivers.grid). Fields: row, col (0-based, row 0 at the top), height (m). The grid is snapped to multiples of the cell size in the working CRS.
END strategic maps use receivers 4 m above ground on a regular grid (Annex IV); levels inside buildings are not defined.
| Name | Description | Type | Default |
|---|---|---|---|
EXTENT | Extent | extent | |
GRID_CELL | Cell size (m) | number | 10.0 |
RECEIVER_HEIGHT | Receiver height (m) | number | 4.0 |
BUILDINGS | Buildings (polygons) optional | vector layer | |
OUTPUT | Grid receivers | vector output |
Numbers returned: RECEIVERS (Receivers), INSIDE (Cells inside buildings).
Receivers in front of every exterior wall of every building, spaced along the wall and offset outwards (core receivers.facades). Fields: bld_id (the building id field, or the building's 1-based position in the input), nx, ny (outward wall normal), height (m). Receivers that would fall inside a neighbouring building are dropped.
bld_id (used to join residents).CNOSSOS-EU 2.8: receivers 0.1 m in front of the facade, about every 3 m, at 4 m height; levels are incident levels without the reflection on the facade itself.
| Name | Description | Type | Default |
|---|---|---|---|
BUILDINGS | Buildings (polygons) | vector layer | |
ID_FIELD | Building id field optional | field | bid |
FACADE_SPACING | Spacing along walls (m) | number | 3.0 |
FACADE_OFFSET | Offset in front of the facade (m) | number | 0.1 |
RECEIVER_HEIGHT | Receiver height (m) | number | 4.0 |
OUTPUT | Facade receivers | vector output |
Numbers returned: RECEIVERS (Receivers).
The building heights the propagation uses (core geometry.build_obstacles): the height field, else \(\text{levels} \times \text{storey height}\), else the default height. Fields h_used (m), footprint (\(\mathrm{m^2}\)), top (m, terrain + height) and h_default (1 when the default height was used). Barrier lines without a height get 3 m in every run.
Buildings and barriers are screens with a flat top at their height; diffraction uses the vertical cut through source and receiver over these tops (Annex II 2.5.7).
| Name | Description | Type | Default |
|---|---|---|---|
BUILDINGS | Buildings (polygons) | vector layer | |
HEIGHT_FIELD | Building height field (m) optional | field | height |
LEVELS_FIELD | Building levels field (storeys) optional | field | |
STOREY_HEIGHT | Storey height (m) | number | 3.0 |
DEFAULT_HEIGHT | Default height (m) | number | 10.0 |
DEM | Terrain (DEM, optional) advanced optional | raster layer | |
OUTPUT | Buildings with heights | vector output |
Numbers returned: DEFAULTED (Buildings at the default height), MEAN_HEIGHT (Mean height (m)).
CNOSSOS-EU road noise at any receiver points (grid or facade receivers from this provider, or your own points): traffic, emission, point sources refined near the receivers, then the propagation engine (core engine.compute) and \(L_\mathrm{den}\) (core indicators.lden). Fields ld, le, ln, lden, lnight in dB(A). A receiver inside a building, or with no road within the search radius, gets NULL (never 0 dB).
Per source-receiver path and octave band \(i\): \(A_\mathrm{div} = 20 \lg d + 11\); \(A_{\mathrm{atm},i} = \alpha_i\, d / 1000\) with \(\alpha_i\) from ISO 9613-1; ground attenuation \(A_{\mathrm{ground},H}\) and \(A_{\mathrm{ground},F}\) with \(G'_\mathrm{path}\) (2.5.14-2.5.20); diffraction over the convex hull of buildings and barriers in the vertical plane, \(\Delta_{\mathrm{dif},i} = 10 \lg\left(3 + \frac{40}{\lambda_i} C'' \delta\right)\) with \(\Delta_\mathrm{dif}(S,R) \le 25\,\mathrm{dB}\), curved favourable rays of radius \(\Gamma = \max(1000, 8d)\); long-term level \(L_{LT} = 10 \lg\left(p\, 10^{L_F/10} + (1 - p)\, 10^{L_H/10}\right)\); A-weighted and summed over sources (equations (12)-(26) of section 8). No reflections, no lateral diffraction. \(L_\mathrm{den} = 10 \lg \frac{h_d\, 10^{L_\mathrm{d}/10} + h_e\, 10^{(L_\mathrm{e} + P_e)/10} + h_n\, 10^{(L_\mathrm{n} + P_n)/10}}{24}\) with the hours \(h_d, h_e, h_n\) of the period scheme (END: \(12, 4, 8\)) and the penalties \(P_e = 5\,\mathrm{dB}\), \(P_n = 10\,\mathrm{dB}\); \(L_\mathrm{night} = L_\mathrm{n}\) (equation (27)).
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
RECEIVERS | Receivers (points) | vector layer | |
RECEIVER_HEIGHT_FIELD | Receiver height field (m) optional | field | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
BUILDINGS | Buildings (polygons) optional | vector layer | |
HEIGHT_FIELD | Building height field (m) optional | field | height |
LEVELS_FIELD | Building levels field (storeys, used when no height) optional | field | |
STOREY_HEIGHT | Storey height (m) advanced | number | 3.0 |
DEFAULT_HEIGHT | Height of buildings without height or levels (m) advanced | number | 10.0 |
BARRIERS | Noise barriers (lines) optional | vector layer | |
BARRIER_HEIGHT_FIELD | Barrier height field (m; \(3\,\mathrm{m}\) when missing) optional | field | height |
GROUND | Ground factor polygons (\(G = 0\) hard to \(G = 1\) soft) optional | vector layer | |
G_FIELD | Ground factor field (\(0 \le G \le 1\)) optional | field | g |
DEM | Terrain (DEM, optional) advanced optional | raster layer | |
RECEIVER_HEIGHT | Receiver height above ground (m) | number | 4.0 |
MAX_DISTANCE | Source search radius (m) | number | 300.0 |
DEFAULT_G | Ground factor \(G\) where no ground polygon (\(0\) hard, \(1\) soft) | number | 0.0 |
TEMP_C | Air temperature (\(^\circ\mathrm{C}\)); also the rolling-noise temperature | number | 15.0 |
HUMIDITY | Relative humidity (%) advanced | number | 70.0 |
PRESSURE | Air pressure (kPa) advanced | number | 101.325 |
P_DAY | Favourable occurrence \(p\), day (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_EVENING | Favourable occurrence \(p\), evening (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_NIGHT | Favourable occurrence \(p\), night (\(0 \le p \le 1\)) advanced | number | 0.5 |
SOURCE_STEP | Maximum point-source spacing on roads (m) advanced | number | 5.0 |
MAX_DIFFRACTIONS | Maximum diffraction edges per path advanced | number | 4 |
OUTPUT | Receiver levels | vector output |
Numbers returned: MAX_LDEN (Maximum \(L_\mathrm{den}\) (dB)), NULL_RECEIVERS (Receivers with NULL level).
Adds lden and lnight to a layer that carries \(L_\mathrm{d}\), \(L_\mathrm{e}\) and \(L_\mathrm{n}\) (dB) fields (core indicators.lden). NULL in any period gives NULL.
\(L_\mathrm{den} = 10 \lg \frac{h_d\, 10^{L_\mathrm{d}/10} + h_e\, 10^{(L_\mathrm{e} + P_e)/10} + h_n\, 10^{(L_\mathrm{n} + P_n)/10}}{24}\) with the hours \(h_d, h_e, h_n\) of the period scheme (END: \(12, 4, 8\)) and the penalties \(P_e = 5\,\mathrm{dB}\), \(P_n = 10\,\mathrm{dB}\); \(L_\mathrm{night} = L_\mathrm{n}\) (equation (27)).
| Name | Description | Type | Default |
|---|---|---|---|
INPUT | Layer with period levels | vector layer | |
LD_FIELD | \(L_\mathrm{d}\) field (dB) | field | ld |
LE_FIELD | \(L_\mathrm{e}\) field (dB) | field | le |
LN_FIELD | \(L_\mathrm{n}\) field (dB) | field | ln |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
OUTPUT | With \(L_\mathrm{den}\) | vector output |
Numbers returned: MAX_LDEN (Maximum \(L_\mathrm{den}\) (dB)).
Band polygons of a level raster (core raster.isophones, GDAL ContourGenerateEx with polygon output): fields lo, hi (dB; hi NULL for the top band) and band ('55-59'). Areas below the first bound are left out.
Contour polygons at fixed levels; a cell value \(v\) belongs to the band \(L_\mathrm{lo} \le v < L_\mathrm{hi}\).
| Name | Description | Type | Default |
|---|---|---|---|
INPUT | Level raster (dB) | raster layer | |
BANDS | Band bounds (dB, comma separated) | text | 35, 40, 45, 50, 55, 60, 65, 70, 75, 80 |
OUTPUT | Isophones | vector output |
Numbers returned: POLYGONS (Polygons).
Residents per facade receiver (core exposure.assign_population): each building's residents shared equally over its facade receivers (CNOSSOS-EU 2.8), or all at the facade with the highest level. Residents come from a building field, or from population polygons shared by floor area (\(\text{footprint} \times \text{storeys}\)) over the buildings whose centroid they contain. Adds field pop.
bld_id) and, for the most-exposed method, a level.Equal share: \(p_r = P_b / n_b\) for the \(n_b\) receivers of building \(b\) with \(P_b\) residents; most exposed: \(P_b\) at the receiver \(\arg\max_{r \in b} L_{\mathrm{den},r}\) (equation (28)).
| Name | Description | Type | Default |
|---|---|---|---|
FACADES | Facade receivers (points) | vector layer | |
BLD_FIELD | Building key field of the receivers | field | bld_id |
LEVEL_FIELD | Level field (for the most-exposed method) optional | field | lden |
BUILDINGS | Buildings (polygons) | vector layer | |
ID_FIELD | Building id field optional | field | bid |
POP_FIELD | Residents field (per building) optional | field | pop |
POPULATION | Population polygons optional | vector layer | |
POP_LAYER_FIELD | Residents field of the polygons optional | field | |
LEVELS_FIELD | Building levels field (storeys) advanced optional | field | |
HEIGHT_FIELD | Building height field (m) advanced optional | field | height |
STOREY_HEIGHT | Storey height (m) advanced | number | 3.0 |
ALLOCATION | Allocation | choice | Equal share per facade receiver (CNOSSOS-EU 2.8) |
OUTPUT | Facade receivers with residents | vector output |
Numbers returned: RESIDENTS (Residents assigned), UNASSIGNED (Residents of buildings without a receiver).
People (and dwellings) per noise band from receiver levels and the people at each receiver (core exposure.table): END Annex VI bands (\(L_\mathrm{den}\) 55-59 ... \(\ge 75\), \(L_\mathrm{night}\) 50-54 ... \(\ge 70\)), the Turkish 2022 bands or custom lower bounds. Columns band, lo, hi, people, people_rounded (nearest hundred, halves up), dwellings, dwellings_rounded; a last row below holds people below the lowest band or with a NULL level.
Bands are half open, \(L_\mathrm{lo} \le L < L_\mathrm{hi}\); people are counted at the band of their receiver level; rounding to the nearest hundred, \(100\,\lfloor x/100 + 0.5 \rfloor\), applies to the reporting column only.
| Name | Description | Type | Default |
|---|---|---|---|
INPUT | Receivers with levels and people | vector layer | |
LEVEL_FIELD | Level field (dB) | field | lden |
PEOPLE_FIELD | People field | field | pop |
DWELLINGS_FIELD | Dwellings field optional | field | |
INDICATOR | Indicator | choice | \(L_\mathrm{den}\) |
PRESET | Band preset | choice | END Annex VI (\(L_\mathrm{den}\) 55-75, \(L_\mathrm{night}\) 50-70) |
CUSTOM_BANDS | Custom lower bounds (dB, comma separated) optional | text | |
OUTPUT | Exposure table | vector output |
Numbers returned: PEOPLE_TOTAL (People in total), PEOPLE_IN_BANDS (People in the bands), PEOPLE_BELOW (People below the lowest band or NULL).
Area in \(\mathrm{km^2}\) of a level raster at or above each threshold (core exposure.area_table): END Annex VI asks for \(L_\mathrm{den}\) above 55, 65 and 75 dB. NULL cells are not counted.
\(A(t) = N(L \ge t)\; \Delta x\, \Delta y / 10^6\) in \(\mathrm{km^2}\), with \(N(L \ge t)\) the number of cells at or above threshold \(t\) and \(\Delta x\), \(\Delta y\) the cell width and height in \(\mathrm{m}\).
| Name | Description | Type | Default |
|---|---|---|---|
INPUT | \(L_\mathrm{den}\) raster (dB) | raster layer | |
THRESHOLDS | Thresholds (dB, comma separated) | text | 55, 65, 75 |
OUTPUT | Area table | vector output |
Numbers returned: AREA_FIRST (Area above the first threshold (\(\mathrm{km^2}\))).
Highly annoyed and highly sleep-disturbed people and the ischaemic heart disease (IHD) burden from receiver levels and people (core health.assess). Table rows per \(1\,\mathrm{dB}\) band: indicator, band, people, ar (absolute risk), rr (IHD relative risk), attributable (HA or HSD people). With an IHD incidence the attributable cases per year are given; without it only the population attributable fraction.
\(AR_\mathrm{HA} = (78.9270 - 3.1162\, L_\mathrm{den} + 0.0342\, L_\mathrm{den}^2)/100\); \(AR_\mathrm{HSD} = (19.4312 - 0.9336\, L_\mathrm{night} + 0.0126\, L_\mathrm{night}^2)/100\); \(RR_\mathrm{IHD} = \exp\left(\frac{\ln 1.08}{10}\,(L_\mathrm{den} - 53)\right)\) for \(L_\mathrm{den} > 53\,\mathrm{dB}\), else \(1\); \(\mathrm{PAF} = \sum_j p_j (RR_j - 1) \big/ \left(\sum_j p_j (RR_j - 1) + 1\right)\); \(N_\mathrm{IHD} = \mathrm{PAF} \cdot I \cdot P\); \(N_\mathrm{HA} = \sum_j n_j\, AR_{\mathrm{HA},j}\) and \(N_\mathrm{HSD}\) likewise. \(1\,\mathrm{dB}\) bands \([L_j, L_j + 1)\) evaluated at the band centre \(L_j + 0.5\) (Annex III formulas 3, 4, 7, 10-12; equations (30)-(34)).
| Name | Description | Type | Default |
|---|---|---|---|
INPUT | Receivers with levels and people | vector layer | |
LDEN_FIELD | \(L_\mathrm{den}\) field (dB) | field | lden |
LNIGHT_FIELD | \(L_\mathrm{night}\) field (dB) | field | lnight |
PEOPLE_FIELD | People field | field | pop |
INCIDENCE | IHD incidence (cases per \(100\,000\) persons per year; \(0\) = not given) | number | 0.0 |
HA_MIN | Lowest \(L_\mathrm{den}\) evaluated for high annoyance (dB) advanced | number | 55.0 |
HSD_MIN | Lowest \(L_\mathrm{night}\) evaluated for high sleep disturbance (dB) advanced | number | 50.0 |
OUTPUT | Health table | vector output |
Numbers returned: HA (Highly annoyed people), HSD (Highly sleep-disturbed people), IHD_PAF (IHD population attributable fraction), IHD_CASES (IHD cases per year (NULL without incidence)).
The whole END road chain in one run (core pipeline.run_lab): traffic, CNOSSOS-EU emission, point sources, grid and facade receivers, propagation over buildings and barriers with ground effect and favourable conditions, \(L_\mathrm{d}\), \(L_\mathrm{e}\), \(L_\mathrm{n}\), \(L_\mathrm{den}\), \(L_\mathrm{night}\) GeoTIFFs, \(L_\mathrm{den}\) isophones, facade levels with residents, buildings with most-exposed and quiet-facade flags, END Annex VI tables, Directive 2020/367 health outcomes and an HTML report. Every layer is in the working CRS. The END table output has one row per band: table = lden / lnight (people, rounded, dwellings; below row), and area_km2 rows (value = area in \(\mathrm{km^2}\), people at or above).
Rolling \(L_{WR} = A_R + B_R \lg(v/70) + \Delta L_{WR}\); propulsion \(L_{WP} = A_P + B_P\,(v - 70)/70 + \Delta L_{WP}\); vehicle \(L_W = 10 \lg\left(10^{L_{WR}/10} + 10^{L_{WP}/10}\right)\); line source per metre \(L_{W'} = 10 \lg \sum_m 10^{\left(L_{W,m} + 10 \lg\frac{Q_m}{1000\, v_m}\right)/10}\), with \(Q_m\) in \(\mathrm{veh/h}\) and \(v_m\) in \(\mathrm{km/h}\) (Annex II 2.2.1-2.2.20, Table F-1 and F-4 of Delegated Directive (EU) 2021/1226; equations (2)-(10) of section 7). Air temperature correction \(K_m\,(20 - \tau)\) on rolling noise; a two-way road with a gradient \(s\) is split into \(Q_m/2\) at \(+s\) and \(Q_m/2\) at \(-s\). Per source-receiver path and octave band \(i\): \(A_\mathrm{div} = 20 \lg d + 11\); \(A_{\mathrm{atm},i} = \alpha_i\, d / 1000\) with \(\alpha_i\) from ISO 9613-1; ground attenuation \(A_{\mathrm{ground},H}\) and \(A_{\mathrm{ground},F}\) with \(G'_\mathrm{path}\) (2.5.14-2.5.20); diffraction over the convex hull of buildings and barriers in the vertical plane, \(\Delta_{\mathrm{dif},i} = 10 \lg\left(3 + \frac{40}{\lambda_i} C'' \delta\right)\) with \(\Delta_\mathrm{dif}(S,R) \le 25\,\mathrm{dB}\), curved favourable rays of radius \(\Gamma = \max(1000, 8d)\); long-term level \(L_{LT} = 10 \lg\left(p\, 10^{L_F/10} + (1 - p)\, 10^{L_H/10}\right)\); A-weighted and summed over sources (equations (12)-(26) of section 8). No reflections, no lateral diffraction. \(L_\mathrm{den} = 10 \lg \frac{h_d\, 10^{L_\mathrm{d}/10} + h_e\, 10^{(L_\mathrm{e} + P_e)/10} + h_n\, 10^{(L_\mathrm{n} + P_n)/10}}{24}\) with the hours \(h_d, h_e, h_n\) of the period scheme (END: \(12, 4, 8\)) and the penalties \(P_e = 5\,\mathrm{dB}\), \(P_n = 10\,\mathrm{dB}\); \(L_\mathrm{night} = L_\mathrm{n}\) (equation (27)). Exposure: residents shared over facade receivers, \(p_r = P_b/n_b\); quiet facade when \(L_{\mathrm{den},\min} < L_{\mathrm{den},\max} - 20\,\mathrm{dB}\). Health: Annex III (Directive (EU) 2020/367), equations (30)-(34).
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
BUILDINGS | Buildings (polygons) optional | vector layer | |
HEIGHT_FIELD | Building height field (m) optional | field | height |
LEVELS_FIELD | Building levels field (storeys, used when no height) optional | field | |
STOREY_HEIGHT | Storey height (m) advanced | number | 3.0 |
DEFAULT_HEIGHT | Height of buildings without height or levels (m) advanced | number | 10.0 |
BARRIERS | Noise barriers (lines) optional | vector layer | |
BARRIER_HEIGHT_FIELD | Barrier height field (m; \(3\,\mathrm{m}\) when missing) optional | field | height |
GROUND | Ground factor polygons (\(G = 0\) hard to \(G = 1\) soft) optional | vector layer | |
G_FIELD | Ground factor field (\(0 \le G \le 1\)) optional | field | g |
DEM | Terrain (DEM, optional) advanced optional | raster layer | |
POP_FIELD | Residents field (per building) optional | field | pop |
DWELLINGS_FIELD | Dwellings field (per building) optional | field | dwellings |
ID_FIELD | Building id field (copied to bld_id) optional | field | bid |
POPULATION | Population polygons (used when no residents field) optional | vector layer | |
POP_LAYER_FIELD | Residents field of the polygons optional | field | |
RECEIVER_HEIGHT | Receiver height above ground (m) | number | 4.0 |
MAX_DISTANCE | Source search radius (m) | number | 300.0 |
DEFAULT_G | Ground factor \(G\) where no ground polygon (\(0\) hard, \(1\) soft) | number | 0.0 |
TEMP_C | Air temperature (\(^\circ\mathrm{C}\)); also the rolling-noise temperature | number | 15.0 |
HUMIDITY | Relative humidity (%) advanced | number | 70.0 |
PRESSURE | Air pressure (kPa) advanced | number | 101.325 |
P_DAY | Favourable occurrence \(p\), day (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_EVENING | Favourable occurrence \(p\), evening (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_NIGHT | Favourable occurrence \(p\), night (\(0 \le p \le 1\)) advanced | number | 0.5 |
SOURCE_STEP | Maximum point-source spacing on roads (m) advanced | number | 5.0 |
MAX_DIFFRACTIONS | Maximum diffraction edges per path advanced | number | 4 |
GRID_CELL | Grid cell (m) | number | 10.0 |
COMPUTE_GRID | Compute the grid (noise map) | yes/no | True |
COMPUTE_FACADES | Compute facade receivers and exposure | yes/no | True |
FACADE_SPACING | Facade receiver spacing (m) advanced | number | 3.0 |
FACADE_OFFSET | Facade receiver offset (m) advanced | number | 0.1 |
ALLOCATION | Residents allocation advanced | choice | Equal share per facade receiver (CNOSSOS-EU 2.8) |
PRESET | Exposure band preset advanced | choice | END Annex VI (\(L_\mathrm{den}\) 55-75, \(L_\mathrm{night}\) 50-70) |
CUSTOM_BANDS | Custom lower bounds (dB, comma separated) advanced optional | text | |
INCIDENCE | IHD incidence (cases per \(100\,000\) persons per year; \(0\) = not given) advanced | number | 0.0 |
LDEN | \(L_\mathrm{den}\) raster (dB) optional | raster output | |
LNIGHT | \(L_\mathrm{night}\) raster (dB) optional | raster output | |
LDAY | \(L_\mathrm{d}\) raster (dB) optional | raster output | |
LEVENING | \(L_\mathrm{e}\) raster (dB) optional | raster output | |
ISOPHONES | \(L_\mathrm{den}\) isophones optional | vector output | |
ROADS_OUT | Roads with emission optional | vector output | |
FACADES | Facade receivers optional | vector output | |
BUILDINGS_OUT | Buildings with exposure optional | vector output | |
END_TABLES | END tables optional | vector output | |
REPORT | HTML report optional | file output |
Numbers returned: RESIDENTS (Residents), POP_LDEN55 (Residents at \(L_\mathrm{den} \ge 55\,\mathrm{dB}\)), POP_LNIGHT50 (Residents at \(L_\mathrm{night} \ge 50\,\mathrm{dB}\)), HA (Highly annoyed people), HSD (Highly sleep-disturbed people), IHD_PAF (IHD attributable fraction), MAX_LDEN (Maximum grid \(L_\mathrm{den}\) (dB)), AREA_LDEN55 (Area \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) (\(\mathrm{km^2}\))), QUIET_FACADE_BUILDINGS (Buildings with a quiet facade), WORKING_CRS (Working CRS).
Runs the lab for the base case and again with a mitigation on the same receivers and source positions (core pipeline.run_scenario and scenario.compare): speed change, flow and heavy-vehicle factors, night heavy factor, another road surface, added barrier lines, optionally only on roads matching an expression. Outputs the change of \(L_\mathrm{den}\) and \(L_\mathrm{night}\) as rasters (\(\Delta L = L^\mathrm{scenario} - L^\mathrm{base}\), negative = quieter), facade receivers with d_lden / d_lnight, and the exposure change per band.
Same method as the lab; the delta \(\Delta L = L^\mathrm{scenario} - L^\mathrm{base}\) is computed per receiver, so it is free of grid placement effects. People moved out of \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) and \(L_\mathrm{night} \ge 50\,\mathrm{dB}\) are the headline numbers.
| Name | Description | Type | Default |
|---|---|---|---|
ROADS | Roads (lines) | vector layer | |
TRAFFIC_MODE | Traffic mode | choice | AADT and heavy-vehicle percent |
AADT_FIELD | AADT field (vehicles per day) optional | field | aadt |
HEAVY_FIELD | Heavy-vehicle percent field (categories 2 and 3, percent of AADT) optional | field | trk_pct |
SPEED_FIELD | Speed field (km/h) optional | field | speed |
CLASS_FIELD | Road class field (e.g. OSM highway) optional | field | highway |
SURFACE_FIELD | Road surface field (Table F-4 name) advanced optional | field | |
ONE_WAY_FIELD | One-way field (yes/true/1) advanced optional | field | |
PERIOD_FLOWS | Period flow fields: period.category=field, comma separated (e.g. day.1=q_d_lv, day.3=q_d_hv, night.1=q_n_lv) advanced optional | text | |
DEFAULT_SPEED | Speed when no speed or class value (km/h) advanced | number | 50.0 |
SHARE_DAY | AADT share in the day period (%) advanced | number | 75.0 |
SHARE_EVENING | AADT share in the evening period (%) advanced | number | 15.0 |
SHARE_NIGHT | AADT share in the night period (%) advanced | number | 10.0 |
TWO_WHEELER_PCT | Motorcycles (category 4b), percent of AADT advanced | number | 0.0 |
DAY_START | Day starts at (hour) advanced | number | 7 |
EVENING_START | Evening starts at (hour) advanced | number | 19 |
NIGHT_START | Night starts at (hour) advanced | number | 23 |
EVENING_PENALTY | Evening penalty in \(L_\mathrm{den}\) (dB) advanced | number | 5.0 |
NIGHT_PENALTY | Night penalty in \(L_\mathrm{den}\) (dB) advanced | number | 10.0 |
BUILDINGS | Buildings (polygons) optional | vector layer | |
HEIGHT_FIELD | Building height field (m) optional | field | height |
LEVELS_FIELD | Building levels field (storeys, used when no height) optional | field | |
STOREY_HEIGHT | Storey height (m) advanced | number | 3.0 |
DEFAULT_HEIGHT | Height of buildings without height or levels (m) advanced | number | 10.0 |
BARRIERS | Noise barriers (lines) optional | vector layer | |
BARRIER_HEIGHT_FIELD | Barrier height field (m; \(3\,\mathrm{m}\) when missing) optional | field | height |
GROUND | Ground factor polygons (\(G = 0\) hard to \(G = 1\) soft) optional | vector layer | |
G_FIELD | Ground factor field (\(0 \le G \le 1\)) optional | field | g |
DEM | Terrain (DEM, optional) advanced optional | raster layer | |
POP_FIELD | Residents field (per building) optional | field | pop |
DWELLINGS_FIELD | Dwellings field (per building) optional | field | dwellings |
ID_FIELD | Building id field (copied to bld_id) optional | field | bid |
POPULATION | Population polygons (used when no residents field) optional | vector layer | |
POP_LAYER_FIELD | Residents field of the polygons optional | field | |
RECEIVER_HEIGHT | Receiver height above ground (m) | number | 4.0 |
MAX_DISTANCE | Source search radius (m) | number | 300.0 |
DEFAULT_G | Ground factor \(G\) where no ground polygon (\(0\) hard, \(1\) soft) | number | 0.0 |
TEMP_C | Air temperature (\(^\circ\mathrm{C}\)); also the rolling-noise temperature | number | 15.0 |
HUMIDITY | Relative humidity (%) advanced | number | 70.0 |
PRESSURE | Air pressure (kPa) advanced | number | 101.325 |
P_DAY | Favourable occurrence \(p\), day (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_EVENING | Favourable occurrence \(p\), evening (\(0 \le p \le 1\)) advanced | number | 0.5 |
P_NIGHT | Favourable occurrence \(p\), night (\(0 \le p \le 1\)) advanced | number | 0.5 |
SOURCE_STEP | Maximum point-source spacing on roads (m) advanced | number | 5.0 |
MAX_DIFFRACTIONS | Maximum diffraction edges per path advanced | number | 4 |
GRID_CELL | Grid cell (m) | number | 10.0 |
COMPUTE_GRID | Compute the grid (noise map) | yes/no | True |
COMPUTE_FACADES | Compute facade receivers and exposure | yes/no | True |
FACADE_SPACING | Facade receiver spacing (m) advanced | number | 3.0 |
FACADE_OFFSET | Facade receiver offset (m) advanced | number | 0.1 |
ALLOCATION | Residents allocation advanced | choice | Equal share per facade receiver (CNOSSOS-EU 2.8) |
PRESET | Exposure band preset advanced | choice | END Annex VI (\(L_\mathrm{den}\) 55-75, \(L_\mathrm{night}\) 50-70) |
CUSTOM_BANDS | Custom lower bounds (dB, comma separated) advanced optional | text | |
INCIDENCE | IHD incidence (cases per \(100\,000\) persons per year; \(0\) = not given) advanced | number | 0.0 |
SCENARIO_NAME | Scenario name | text | Scenario |
SPEED_DELTA | Speed change (km/h) | number | 0.0 |
FLOW_FACTOR | Flow factor (all categories) | number | 1.0 |
HEAVY_FACTOR | Heavy-vehicle factor (categories 2 and 3) | number | 1.0 |
NIGHT_HEAVY_FACTOR | Night heavy-vehicle factor | number | 1.0 |
SURFACE | Road surface of the affected roads | choice | Keep the current surface |
ROAD_FILTER | Affected roads (expression, blank = all) optional | expression | |
NEW_BARRIERS | Added barriers (lines) optional | vector layer | |
D_LDEN | Change of \(L_\mathrm{den}\) (dB) | raster output | |
D_LNIGHT | Change of \(L_\mathrm{night}\) (dB) optional | raster output | |
FACADE_DELTAS | Facade receivers with level changes optional | vector output | |
DELTA_TABLE | Exposure change per band optional | vector output | |
REPORT | HTML report of the scenario optional | file output |
Numbers returned: MOVED_OUT_55_LDEN (Residents moved out of \(L_\mathrm{den} \ge 55\,\mathrm{dB}\)), MOVED_OUT_50_LNIGHT (Residents moved out of \(L_\mathrm{night} \ge 50\,\mathrm{dB}\)), MEAN_D_LDEN (Mean facade change of \(L_\mathrm{den}\) (dB)).
Numbers such as (2.2.1) refer to Annex II of Directive 2002/49/EC as set out by Directive (EU) 2015/996 and amended by Delegated Directive (EU) 2021/1226; the tags (1), (2), ... at the right are the equation numbers of this manual. Index \(i\) runs over the eight octave bands \(63\)–\(8000\,\mathrm{Hz}\), index \(m\) over the vehicle categories \(1, 2, 3, 4a, 4b\).
From an AADT, the hourly flow of category \(m\) in period \(p \in \{d, e, n\}\) is
\[ Q_{p,m} = \frac{\mathrm{AADT}\; s_p}{h_p}\,\phi_m \tag{1} \]where \(s_p\) is the share of the AADT in period \(p\) (defaults \(s_d = 0.75\), \(s_e = 0.15\), \(s_n = 0.10\), with \(\sum_p s_p = 1\)), \(h_p\) the period length in hours (END scheme \(h_d = 12\), \(h_e = 4\), \(h_n = 8\)) and \(\phi_m\) the category share: \(\phi_1 = 1 - \eta - \mu\), \(\phi_2 = \eta/3\), \(\phi_3 = 2\eta/3\) (default heavy split \(1:2\)), \(\phi_{4a} = 0\), \(\phi_{4b} = \mu\), with \(\eta\) the heavy-vehicle share (categories 2 and 3) and \(\mu\) the motorcycle share, both as fractions of the AADT and \(\eta + \mu \le 1\). Speeds are evaluated at \(v_m = \max(v, 20\,\mathrm{km/h})\). With road-class defaults (motorway \(60\,000\,\mathrm{veh/day}\), \(15\,\%\) heavy, \(110\,\mathrm{km/h}\); primary \(25\,000\), \(8\,\%\), \(70\,\mathrm{km/h}\); residential \(1\,500\), \(2\,\%\), \(30\,\mathrm{km/h}\); and others) the flows are planning placeholders and the dock says so.
where \(L_{WR,i,m}\) is the rolling noise and \(L_{WP,i,m}\) the propulsion noise of one vehicle in \(\mathrm{dB}\) re \(1\,\mathrm{pW}\), \(A_{R,i,m}\), \(B_{R,i,m}\), \(A_{P,i,m}\), \(B_{P,i,m}\) the coefficients of Table F-1, \(v_m\) the speed in \(\mathrm{km/h}\), \(v_\mathrm{ref} = 70\,\mathrm{km/h}\), and \(\Delta L_{WR,i,m}\), \(\Delta L_{WP,i,m}\) the sums of the corrections below. Categories 4a and 4b have no rolling term: \(L_{W,i,m} = L_{WP,i,m}\).
Road surface (2.2.19-2.2.20, Table F-4, 14 surfaces plus the reference surface, each with its validity speeds; a warning is logged outside them):
\[ \Delta L_{WR,\mathrm{road},i,m} = \alpha_{i,m} + \beta_m\,\lg\!\left(\frac{v_m}{v_\mathrm{ref}}\right), \qquad \Delta L_{WP,\mathrm{road},i,m} = \min(\alpha_{i,m},\, 0) \tag{5} \]Air temperature, on rolling noise (2.2.10):
\[ \Delta L_{WR,\mathrm{temp},m} = K_m\,(20 - \tau) \tag{6} \]with \(\tau\) the yearly mean air temperature in \(^\circ\mathrm{C}\), \(K_1 = 0.08\), \(K_2 = K_3 = 0.04\) and \(K_{4a} = K_{4b} = 0\).
Studded tyres, category 1 only (2.2.6-2.2.9, Table F-2):
\[ \Delta L_{\mathrm{stud},i} = 10\,\lg\!\left[(1 - p_s) + p_s\,10^{\Delta_{\mathrm{stud},i}/10}\right], \qquad p_s = Q_\mathrm{stud,ratio}\,\frac{T_s}{12}, \qquad \Delta_{\mathrm{stud},i} = a_i + b_i\,\lg\!\left(\frac{v}{70}\right) \tag{7} \]where \(Q_\mathrm{stud,ratio}\) is the share of light vehicles with studded tyres, \(T_s\) the number of months per year they are used, \(a_i\), \(b_i\) the coefficients of Table F-2, and \(v\) is clipped to \(50 \le v \le 90\,\mathrm{km/h}\).
Road gradient \(s\) (percent, positive uphill) on the propulsion noise of categories 1-3 (2.2.13-2.2.16); a two-way road is split into \(Q_m/2\) uphill (\(+s\)) and \(Q_m/2\) downhill (\(-s\)).
Acceleration and deceleration within \(100\,\mathrm{m}\) of a crossing with traffic lights (\(k = 1\)) or a roundabout (\(k = 2\)) (2.2.17-2.2.18, Table F-3):
\[ \Delta L_{WR,\mathrm{acc},m,k} = C_{R,m,k}\,\max\!\left(1 - \frac{|x|}{100},\, 0\right), \qquad \Delta L_{WP,\mathrm{acc},m,k} = C_{P,m,k}\,\max\!\left(1 - \frac{|x|}{100},\, 0\right) \tag{8} \]with \(x\) the distance from the point source to the junction in \(\mathrm{m}\).
where \(Q_m\) is the hourly flow of category \(m\) in \(\mathrm{veh/h}\) and \(v_m\) its speed in \(\mathrm{km/h}\); the result is the directional sound power per metre in \(\mathrm{dB}\) re \(1\,\mathrm{pW/m}\). The A-weighted value shown in the dock and written to the road layer is
\[ L_{W'} = 10\,\lg \sum_{i=1}^{8} 10^{\left(L_{W',\mathrm{eq,line},i} + A_i\right)/10} \tag{10} \]with the A-weighting corrections \(A_i = -26.2, -16.1, -8.6, -3.2, 0, 1.2, 1.0, -1.1\,\mathrm{dB}\) for \(63\) to \(8000\,\mathrm{Hz}\).
Table F-1 coefficients come from the vendored roadnoise 0.1.1 tables, which were compared row by row with the Official Journal text of Delegated Directive (EU) 2021/1226 (20 rows of Table F-1, 14 surfaces of Table F-4) and with the opeNoise cross-check copy.
Each road is cut into pieces of at most the source step \(\Delta s\) and, near receivers, at most half the 3D distance from the piece centre to the nearest receiver; a point source sits at the centre of each piece, \(0.05\,\mathrm{m}\) above the road, with
\[ L_{W,0,i} = L_{W',\mathrm{eq,line},i} + 10\,\lg l_k \tag{11} \]where \(l_k\) is the length of piece \(k\) in \(\mathrm{m}\). Near a crossing or roundabout the acceleration correction (8) is evaluated per point source with its own distance \(x\).
For every source-receiver path within the search radius and every octave band \(i\), homogeneous (\(H\)) and favourable (\(F\)) conditions:
\[ L_{H,i} = L_{W,0,i} - A_{H,i}, \qquad A_{H,i} = A_\mathrm{div} + A_{\mathrm{atm},i} + A_{\mathrm{boundary},H,i} \tag{12} \]and \(L_{F,i}\) likewise with \(A_{\mathrm{boundary},F,i}\) (2.5.5-2.5.6). \(A_\mathrm{boundary}\) is \(A_\mathrm{ground}\) when the path is not diffracted and \(A_\mathrm{dif}\) when it is.
\[ A_\mathrm{div} = 20\,\lg d + 11 \tag{13} \] \[ A_{\mathrm{atm},i} = \frac{\alpha_\mathrm{atm}(f_i)\; d}{1000} \tag{14} \]where \(d\) is the 3D source-receiver distance in \(\mathrm{m}\) and \(\alpha_\mathrm{atm}(f_i)\) the absorption coefficient in \(\mathrm{dB/km}\) from the ISO 9613-1 formula with air temperature, relative humidity and pressure, at the exact mid-band frequencies \(f_i = 1000 \cdot 10^{3k/10}\,\mathrm{Hz}\), \(k = -4, \dots, 3\) (2.5.12-2.5.13).
where \(d_p\) is the horizontal source-receiver distance in \(\mathrm{m}\), \(z_s\) and \(z_r\) the source and receiver heights above the mean ground plane, \(f_m\) the nominal octave mid-band frequency, \(c = 340\,\mathrm{m/s}\), \(G_\mathrm{path}\) the mean ground factor of the ground polygons sampled at ten equally spaced points along the horizontal path (\(G = 0\) hard, \(G = 1\) soft), and \(G_s = 0\) the ground factor of the road platform. Homogeneous conditions use \(G_w = G_m = G'_\mathrm{path}\); favourable conditions use \(G_w = G_\mathrm{path}\) and \(G_m = G'_\mathrm{path}\). On hard ground (\(G_\mathrm{path} = 0\)) \(A_{\mathrm{ground},H} = -3\,\mathrm{dB}\) and \(A_{\mathrm{ground},F} = A_{\mathrm{ground},F,\min}\).
Favourable conditions evaluate (15)-(16) with raised heights and a different lower bound:
\[ z_{s,F} = z_s + \delta z_s + \delta z_T, \qquad \delta z_s = a_0 \left(\frac{z_s}{z_s + z_r}\right)^{2} \frac{d_p^2}{2}, \qquad \delta z_T = 6 \cdot 10^{-3}\,\frac{d_p}{z_s + z_r} \tag{18} \] \[ A_{\mathrm{ground},F,\min} = \begin{cases} -3\,(1 - G_m) & \text{if } d_p \le 30\,(z_s + z_r) \\[1ex] -3\,(1 - G_m)\left(1 + 2\left(1 - \dfrac{30\,(z_s + z_r)}{d_p}\right)\right) & \text{otherwise} \end{cases} \tag{19} \]where \(\delta z_s\) is the curvature term (\(z_{r,F}\) likewise with \(\delta z_r = a_0\,(z_r/(z_s + z_r))^2\,d_p^2/2\)), \(\delta z_T\) the turbulence term and \(a_0 = 2 \cdot 10^{-4}\,\mathrm{m^{-1}}\); then \(A_{\mathrm{ground},F,i} = \max(-10\,\lg[\dots],\, A_{\mathrm{ground},F,\min})\) with \(z_{s,F}\), \(z_{r,F}\) in (15).
Diffraction over buildings and barriers is computed in the vertical plane through source and receiver: the path follows the convex hull (rubber band) over the obstacle tops, with at most max diffractions edges (after that the path goes straight to the receiver, so screening is under-estimated, never over-estimated).
\[ \Delta_{\mathrm{dif},i} = \begin{cases} 10\,C_h\,\lg\!\left(3 + \dfrac{40}{\lambda_i}\,C''\,\delta\right) & \text{if } \dfrac{40}{\lambda_i}\,C''\,\delta \ge -2 \\[1ex] 0 & \text{otherwise} \end{cases} \qquad C_h = 1 \tag{20} \] \[ C'' = \begin{cases} 1 & \text{one edge, or } e \le 0.3\,\mathrm{m} \\[1ex] \dfrac{1 + (5\lambda_i/e)^2}{1/3 + (5\lambda_i/e)^2} & \text{several edges and } e > 0.3\,\mathrm{m} \end{cases} \tag{21} \] \[ A_{\mathrm{dif},i} = \min\!\left(\Delta_{\mathrm{dif},i}(S,R),\, 25\right) + \Delta_{\mathrm{ground},i}(S,O) + \Delta_{\mathrm{ground},i}(O,R) \tag{22} \] \[ \Delta_{\mathrm{ground},i}(S,O) = -20\,\lg\!\left[1 + \left(10^{-A_{\mathrm{ground},i}(S,O)/20} - 1\right) 10^{-\left(\Delta_{\mathrm{dif},i}(S',R) - \Delta_{\mathrm{dif},i}(S,R)\right)/20}\right] \tag{23} \]where \(\lambda_i = c/f_i\) is the wavelength at the nominal mid-band frequency, \(\delta\) the path difference (length of the hull path minus the direct distance), \(e\) the path length between the first and the last diffraction edge, \(S'\) the image of the source in the mean ground plane, and \(\Delta_{\mathrm{ground},i}(O,R)\) the same expression with the image receiver \(R'\) and \(A_{\mathrm{ground},i}(O,R)\). The ground terms use \(G_w = G_m = G'_\mathrm{path}\) (homogeneous) or \(G_w = G_\mathrm{path}\), \(G_m = G'_\mathrm{path}\) (favourable) on the source side \((S,O)\), and \(G_w = G_m = G_\mathrm{path}\) on the receiver side \((O,R)\), as the 2021 text sets out.
For an unblocked path, the profile point \(D\) with the largest path difference is tested per band: it diffracts only when \(\delta > -\lambda_i/20\) and the Rayleigh criterion \(\delta > \lambda_i/4 - \delta^*\) holds, with \(\delta^* = \overline{S'D} + \overline{DR'} - \overline{S'R}\) (2021/1226 point (9)(c)). Favourable path differences are taken along arcs over the straight-ray hull vertices \(O_1, \dots, O_n\) (2.5.24, 2.5.28):
\[ \Gamma = \max(1000,\, 8d), \qquad \widehat{XY} = 2\,\Gamma\,\arcsin\frac{\overline{XY}}{2\,\Gamma}, \qquad \delta_F = \widehat{SO_1} + \sum_{j=1}^{n-1} \widehat{O_j O_{j+1}} + \widehat{O_n R} - \widehat{SR} \tag{24} \]where \(\Gamma\) is the radius of the curved ray in \(\mathrm{m}\), \(\overline{XY}\) a chord and \(\widehat{XY}\) its arc length.
where \(p\) is the occurrence of favourable conditions in the period (default \(p = 0.5\); \(p = 0\) gives \(L_H\), \(p = 1\) gives \(L_F\)) and \(A_i\) the A-weighting of (10). A receiver inside a building, or with no source within the search radius, gets NULL, never \(0\,\mathrm{dB}\). Reflections and lateral diffraction are not modelled, so facade receivers give the incident level the END asks for (the reflection on the receiver's own facade is excluded).
Engine. The computation is vectorised over paths and the 8 bands in chunks of \(15\,000\) paths. Sources within the search radius come from a k-d tree (SciPy) or a numpy bucket index; both give identical levels. Obstacle edges crossing each path are found with a bearing-sorted crossing test per receiver. On the \(1\,\mathrm{km^2}\) demo district at a \(20\,\mathrm{m}\) cell (\(2\,188\) grid and \(3\,520\) facade receivers, \(500\) point sources, \(820\,820\) paths) the grid and facade stages take about 6-10 s.
where \(L_\mathrm{d}\), \(L_\mathrm{e}\), \(L_\mathrm{n}\) are the long-term A-weighted levels (26) of the day, evening and night periods, \(h_d\), \(h_e\), \(h_n\) the period lengths in hours (END: \(12\), \(4\), \(8\); \(h_d + h_e + h_n = 24\)) and \(P_e\), \(P_n\) the evening and night penalties (END: \(5\) and \(10\,\mathrm{dB}\)). The scheme and the penalties are editable; NULL in any period gives NULL.
Residents of a building are shared equally over its facade receivers, or all placed at the most exposed facade:
\[ p_r = \frac{P_b}{n_b} \quad \text{(equal share)}, \qquad p_{r^*} = P_b,\;\; r^* = \arg\max_{r \in b} L_{\mathrm{den},r} \quad \text{(most exposed)} \tag{28} \]where \(P_b\) is the number of residents of building \(b\), \(n_b\) its number of facade receivers and \(p_r\) the people at receiver \(r\). People (and dwellings) are counted per half-open band \(L_\mathrm{lo} \le L < L_\mathrm{hi}\) of their receiver level; the reporting column rounds to the nearest hundred, halves up, \(100\,\lfloor x/100 + 0.5 \rfloor\) (\(5\,150 \to 5\,200\), \(5\,249.9 \to 5\,200\), \(49 \to 0\)), and the raw values are kept; people below the lowest band or with a NULL level are reported as below. The area table gives
\[ A(t) = \frac{N(L_\mathrm{den} \ge t)\;\Delta x^2}{10^6} \tag{29} \]in \(\mathrm{km^2}\), with \(N(L_\mathrm{den} \ge t)\) the number of grid cells at or above threshold \(t\) (\(55\), \(65\) and \(75\,\mathrm{dB}\)) and \(\Delta x\) the cell size in \(\mathrm{m}\), together with the people and dwellings at or above those levels. A building has a quiet facade when \(L_{\mathrm{den},\min} < L_{\mathrm{den},\max} - 20\,\mathrm{dB}\) over its facade receivers (a difference of exactly \(20\,\mathrm{dB}\) is not quiet). WHO Environmental Noise Guidelines 2018 road values are reported as shares of residents at or above them, \(\sum_{r:\,L_{\mathrm{den},r} \ge 53} p_r \big/ \sum_r p_r\) and likewise for \(L_\mathrm{night} \ge 45\,\mathrm{dB}\).
where (30) is the absolute risk of high annoyance and (31) of high sleep disturbance (road), \(RR_\mathrm{IHD}\) the relative risk of ischaemic heart disease, \(j\) runs over \(1\,\mathrm{dB}\) bands \([L_j, L_j + 1)\) of the receiver levels evaluated at the band centre \(L_j + 0.5\), \(n_j\) the people in band \(j\), \(p_j = n_j/P\) their share of the whole assessed population \(P\) (people below \(53\,\mathrm{dB}\) and with a NULL level included in \(P\)), \(I\) the IHD incidence per person per year (entered per \(100\,000\)) and \(N_\mathrm{IHD}\) the attributable cases per year (Annex III formulas 3, 4, 7, 10-12). The Directive sets no lower bound of the evaluation; 02NoiseLab uses the END reporting thresholds \(L_{\mathrm{HA},\min} = 55\,\mathrm{dB}\) (\(L_\mathrm{den}\)) and \(L_{\mathrm{HSD},\min} = 50\,\mathrm{dB}\) (\(L_\mathrm{night}\)) as defaults and shows them in the report; the PAF uses all bands.
A mitigation changes the traffic of the selected roads and can add barrier lines:
\[ v'_{p,m} = \max\!\left(v_{p,m} + \Delta v,\; 20\,\mathrm{km/h}\right), \qquad Q'_{p,m} = Q_{p,m}\, f_Q \cdot \begin{cases} f_H\, f_{H,n} & m \in \{2, 3\},\ p = n \\ f_H & m \in \{2, 3\},\ p \in \{d, e\} \\ 1 & \text{otherwise} \end{cases} \tag{35} \]where \(\Delta v\) is the speed change, \(f_Q\) the flow factor, \(f_H\) the heavy-vehicle factor and \(f_{H,n}\) the night heavy-vehicle factor; a new surface replaces the old one in (5). The run is repeated on the same grid and facade receivers and the same point-source positions (added barriers rebuild the obstacle index), and
\[ \Delta L_\mathrm{den} = L_\mathrm{den}^\mathrm{scenario} - L_\mathrm{den}^\mathrm{base}, \qquad \Delta L_\mathrm{night} = L_\mathrm{night}^\mathrm{scenario} - L_\mathrm{night}^\mathrm{base} \tag{36} \]per receiver and per grid cell (negative is quieter), so the change is free of grid placement effects. The exposure change per band and the residents moved out of \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) and \(L_\mathrm{night} \ge 50\,\mathrm{dB}\) are the headline numbers.
| Output | Fields |
|---|---|
| Roads (emission) | source fields; lw_day, lw_eve, lw_night (A-weighted \(L_{W'}\), dB(A) re \(1\,\mathrm{pW/m}\)); q_d_lv, q_d_hv, q_d_2w (and _e_, _n_: light, heavy, two-wheeler veh/h); v_day; surface. The Processing emission algorithm adds lw_<period>_hz<band> octave levels. |
| \(L_\mathrm{den}\), \(L_\mathrm{night}\), \(L_\mathrm{d}\), \(L_\mathrm{e}\) GeoTIFF | Float32, NULL cells are NaN no-data (inside buildings, or no road within the search radius). |
| Isophones | lo, hi (dB, NULL for the top band), band label. |
| Facade receivers | lden, lnight, ld, le (dB), bld_id (building id), pop (residents at this receiver). |
| Buildings (exposure) | source fields; lden_max, lden_min, lnight_max, lnight_min, quiet_fac (1 when \(L_{\mathrm{den},\min} < L_{\mathrm{den},\max} - 20\,\mathrm{dB}\)), pop, dwellings. |
| END tables (Processing) | table (lden, lnight, area_km2), band, lo, hi, people, people_rounded, dwellings, value (\(\mathrm{km^2}\) for the area rows). |
| Scenario | d_lden.tif, d_lnight.tif (\(\Delta L = L^\mathrm{scenario} - L^\mathrm{base}\), dB); facade receivers with d_lden, d_lnight, bld_id; change table indicator, band, base, scenario, diff. |
Load demo district (or core.demo.make_demo_district()) builds a deterministic \(1 \times 1\,\mathrm{km}\) district in EPSG:32635 at easting \(500\,000\), northing \(4\,250\,000\):
highway=primary), a collector along \(x = 300\,\mathrm{m}\) (\(8\,000\), \(4\,\%\), \(50\,\mathrm{km/h}\)) and a local street along \(y = 800\,\mathrm{m}\) (\(1\,500\), \(2\,\%\), \(30\,\mathrm{km/h}\));The demo carries planted truths that do not use the propagation engine: three probe buildings (A in the front row on the arterial, B beside the collector, C in the screened interior) must rank \(A > B > C\), and the residents at \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) must lie between a lower bound from unscreened front-row walls (299) and an upper bound from an unscreened line-source estimate (5 205).
With the default \(\tau = 15\,{}^\circ\mathrm{C}\) and the END scheme, the arterial carries 1 725 light, 50 medium and 100 heavy vehicles per hour by day and emits \(L_{W'} = 88.6\) dB(A)/m by day and 81.6 dB(A)/m at night; the collector 79.6 and the local street 68.6 dB(A)/m by day.
1 000 point sources, 8 384 grid receivers outside buildings and 3 520 facade receivers; about half a minute on a desktop computer. Results:
| \(L_\mathrm{den}\) band (dB) | People | Rounded | \(L_\mathrm{night}\) band (dB) | People | Rounded | |
|---|---|---|---|---|---|---|
| 55-59 | 960.2 | 1 000 | 50-54 | 929.5 | 900 | |
| 60-64 | 832.0 | 800 | 55-59 | 385.1 | 400 | |
| 65-69 | 290.7 | 300 | 60-64 | 382.5 | 400 | |
| 70-74 | 276.4 | 300 | 65-69 | 174.5 | 200 | |
| \(\ge 75\) | 146.0 | 100 | \(\ge 70\) | 0 | 0 | |
| below 55 | 3 338.6 | below 50 | 3 972.4 |
Residents at \(L_\mathrm{den} \ge 55\,\mathrm{dB}\): 2 505 (inside the planted interval \(299 \le N \le 5\,205\)); at \(L_\mathrm{night} \ge 50\,\mathrm{dB}\): 1 872. Area at or above \(L_\mathrm{den} = 55\), \(65\) and \(75\,\mathrm{dB}\): \(0.418\), \(0.133\) and \(0.032\,\mathrm{km^2}\). Highest grid \(L_\mathrm{den}\) 79.6 dB, highest facade \(L_\mathrm{den}\) 75.2 dB. \(52.6\,\%\) of the residents live at or above the WHO value \(L_\mathrm{den} = 53\,\mathrm{dB}\) and \(48.0\,\%\) at or above \(L_\mathrm{night} = 45\,\mathrm{dB}\). Health: 490 highly annoyed, 135 highly sleep-disturbed, IHD attributable fraction \(\mathrm{PAF} = 3.44\,\%\). 58 buildings have a quiet facade.
On the Scenarios page set the speed change to \(\Delta v = -20\,\mathrm{km/h}\) and the road filter to "name" = 'Arterial'. Every facade within \(40\,\mathrm{m}\) of the arterial gets quieter (mean \(\Delta L_\mathrm{den} = -2.3\,\mathrm{dB}\) there); about 330 residents move out of \(L_\mathrm{den} \ge 55\,\mathrm{dB}\) and 470 out of \(L_\mathrm{night} \ge 50\,\mathrm{dB}\); highly annoyed people fall from 490 to about 391.
processing.run("zero2noiselab:noise_lab", {
"ROADS": roads, "AADT_FIELD": "aadt", "HEAVY_FIELD": "trk_pct", "SPEED_FIELD": "speed",
"BUILDINGS": buildings, "HEIGHT_FIELD": "height", "POP_FIELD": "pop", "DWELLINGS_FIELD": "dwellings",
"ID_FIELD": "bid", "BARRIERS": barriers, "BARRIER_HEIGHT_FIELD": "height", "GROUND": park, "G_FIELD": "g",
"GRID_CELL": 10, "LDEN": "TEMPORARY_OUTPUT", "FACADES": "TEMPORARY_OUTPUT",
"BUILDINGS_OUT": "TEMPORARY_OUTPUT", "END_TABLES": "TEMPORARY_OUTPUT", "REPORT": "C:/temp/noise.html"})
returns the same numbers (POP_LDEN55, HA, IHD_PAF, ...) and layers. The step chain Facade receivers → Noise levels at receiver points → Assign residents → END exposure table reproduces the lab's facade levels and END table.
core.coefficients.load_surface_csv); no national surface sets in the dock.Eminoğlu, Y. (2026). 02NoiseLab - Environmental Noise Lab (version 0.1.2) [QGIS plugin]. https://gitlab.com/geophilo1/zero2noiselab. https://doi.org/10.5281/zenodo.24263648. The DOI 10.5281/zenodo.24263648 always resolves to the latest version; version 0.1.2 has DOI https://doi.org/10.5281/zenodo.24263649.
Licence GPL-2.0-or-later, copyright (C) 2026 Yusuf Eminoğlu (Geophilo). The vendored core/vendor/roadnoise modules are MIT-licensed.
Repository: gitlab.com/geophilo1/zero2noiselab · Issues: work items · Homepage: geophilo.com/zero2noiselab