calc_exposed_population_acled {mapme.biodiversity}R Documentation

Calculate population exposed to violent conflict from ACLED

Description

The indicator calculates the population exposed to conflict events within a specified buffer distance around events in ACLED. Per default, the first available WorldPop layer is used to estimate exposed populations for years before the respective year, while the most recent layer is used for years after.

Usage

calc_exposed_population_acled(
  distance = 5000,
  filter_category = c("event_type", "sub_event_type", "disorder_type"),
  filter_types = NULL,
  years = c(1997:2024),
  precision_location = 1,
  precision_time = 1
)

Arguments

distance

A numeric vector indicating the buffer radius in meters. If length is 1, the same buffer size around included conflict events is drawn. Otherwise, it must be equal to the length of included categories selected with filter_types.

filter_category

A character indicating the categories to be used to calculate the exposed population by. Defaults to event_type meaning one estimation per event type will be returned.

filter_types

A character vector of event types of the respective category specified in filter_category to retain. Defaults to NULL, meaning that no filter is applied and all types are retained.

years

A numeric vector indicating for which years to calculate the exposed population. Restricted to available years for ACLED. For years not intersecting with available WorldPop layers, the first layer is used for earlier years and the last layer to more recent years.

precision_location

A numeric indicating precision value for the geolocation up to which events are included. Defaults to 1.

precision_time

A numeric indicating the precision value of the temporal coding up to which events are included. Defaults to 1.

Details

The indicator is inspired by the Conflict Exposure tool from ACLED (see citation below), but differs in the regard that we simply flatten our buffered event layer instead of applying voronoi tessellation.

The required resources for this indicator are:

Events in ACLED are classified according to the schema described extensively in their codebook. You may filter for certain types of events. The categories for which a filter can be applied are either "event_type", "event_sub_type", or "disorder_type". These are translated into the following categories:

You may supply buffer distances for each of the event categories. Custom buffers will then be drawn per category. Supply a single value if you do not wish do differentiate between categories. Otherwise, supply a vector of distances equal to the length of included categories.

You may apply quality filters based on the precision of the geolocation of events and the temporal precision. By default, these are set to only include events with the highest precision scores.

For geo-precision there are levels 1 to 3 with decreasing accuracy:

For temporal precision there are levels 1 to 3 with decreasing precision:

Value

A function that returns an indicator tibble with conflict exposure as variable and percentage of the population as its value.

References

Raleigh, C; C Dowd; A Tatem; A Linke; N Tejedor-Garavito; M Bondarenko and K Kishi. 2023. Assessing and Mapping Global and Local Conflict Exposure. Working Paper.

Examples


## Not run: 
if (FALSE) {
  library(sf)
  library(mapme.biodiversity)

  outdir <- file.path(tempdir(), "mapme-data")
  dir.create(outdir, showWarnings = FALSE)

  mapme_options(
    outdir = outdir,
    verbose = FALSE,
    chunk_size = 1e8
  )

  aoi <- system.file("extdata", "burundi.gpkg",
    package = "mapme.biodiversity"
  ) %>%
    read_sf() %>%
    get_resources(
      get_acled(year = 2000),
      get_worldpop(years = 2000)
    ) %>%
    calc_indicators(
      conflict_exposure_acled(
        distance = 5000,
        years = 2000,
        precision_location = 1,
        precision_time = 1
      )
    ) %>%
    portfolio_long()

  aoi
}

## End(Not run)

[Package mapme.biodiversity version 0.9.4 Index]