demand_noise_reg: Noise Regulation Demand Model

View source: R/demand_noise_reg.R

demand_noise_regR Documentation

Noise Regulation Demand Model

Description

Runs the noise regulation ecosystem service model, generating demand scores based on three indicators: distance to noise sources (airports, railways and major roads), population, and health. (Specific indicators can be omitted by setting the appropriate weight to 0.)

Usage

demand_noise_reg(
  x = parent.frame()$mm,
  studyArea = parent.frame()$studyArea,
  res = 5,
  distances = c(motorway = 800, dual = 600, primary = 550, railway = 650, airport = 1500),
  local = 300,
  indicators = TRUE,
  indic_weights = c(1, 0.5, 0.5),
  projectLog = parent.frame()$projectLog,
  runtitle = parent.frame()$runtitle,
  save = NULL
)

Arguments

x

A basemap, in a list of sf tiles or as one sf object. Must have attributes "HabCode_B", "housePop", "health".

studyArea

The boundaries of the site, as one sf object. The final raster will be masked to this shape. For best results this shape should be smaller than the basemap (which should be buffered by typically 300 m - 1km to avoid edge effects).

res

Desired resolution of the raster. Default is 5 m. Range recommended is 5-10m.

distances

Distance threshold (in meters) for noise attenuation for the noise sources: motorways, dual carriageways, primary roads, railways, and airports. Must be a named vector of numeric values in meters; defaults to c("motorway" = 800,"dual" = 600,"primary" = 550,"railway" = 650,"airport" = 1500). Defra's Strategic Noise Mapping (https://www.gov.uk/government/publications/strategic-noise-mapping-2019) may help set sensible defaults.

local

Radius (m) for focal statistics at local range. Default is 300 m.

indicators

Logical; should raw indicators (before transformation into z-scores and rescaling) be saved to the project folder? Default TRUE.

indic_weights

A numeric vector of length 3, with weights for distance to roads, population and health, respectively. Default to c(1, 0.5, 0.5) so that population and health combined has equal weight to noise sources.

projectLog

The RDS project log file generated by the wizard app and containing all file paths to data inputs and model parameters

runtitle

A customised title you can give a specific model run, which will be appended to your project title in the outputs. If comparing a basemap to an intervention map, we recommend using "pre" and "post", or a short description of the interventions, e.g. "baseline" vs "tree planting".

save

Path to folder where outputs will be saved. By default a folder will be created using your chosen run title, prefixed by "services_". Do not use this argument unless you need to save the outputs somewhere else.

Value

Two rasters with demand scores: one with raw scores (arbitrary units), and one rescaled 0-100 (where 100 is maximum demand for the area).


ecoservR/ecoserv_tool documentation built on April 5, 2025, 1:49 a.m.