demand_access_nature: Access to Nature Demand Model

View source: R/demand_access_nature.R

demand_access_natureR Documentation

Access to Nature Demand Model

Description

Runs the access to nature ecosystem service model, generating demand scores based on three indicators: proportion of households meeting the criteria of having accessible greenspaces >2ha within a 300m radius (or specified by user with the "local" argument), population, and health. (Specific indicators can be omitted by setting the appropriate weight to 0.)

Usage

demand_access_nature(
  x = parent.frame()$mm,
  studyArea = parent.frame()$studyArea,
  res = 5,
  local = 300,
  pop_threshold = 5,
  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", "GI", and "GIpublic".

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.

local

Radius (m) for focal statistics at local range, and threshold for distance to greenspace. Default is 300 m.

pop_threshold

Population density (people per hectare) below which to consider there is no demand. Default is 5.

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 greenspaces, population and health, respectively. Default to c(1, 0.5, 0.5) (so that population and health combined contribute the same amount as the ANGSt indicator).

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.