cc_urb function

Identify Records Inside Urban Areas

Identify Records Inside Urban Areas

Removes or flags records from inside urban areas, based on a geographic gazetteer. Often records from large databases span substantial time periods (centuries) and old records might represent habitats which today are replaced by city area.

cc_urb( x, lon = "decimalLongitude", lat = "decimalLatitude", ref = NULL, value = "clean", verbose = TRUE )

Arguments

  • x: data.frame. Containing geographical coordinates and species names.
  • lon: character string. The column with the longitude coordinates. Default = decimalLongitude .
  • lat: character string. The column with the latitude coordinates. Default = decimalLatitude .
  • ref: a SpatVector. Providing the geographic gazetteer with the urban areas. See details. By default rnaturalearth::ne_download(scale = 'medium', type = 'urban_areas', returnclass = "sf"). Can be any SpatVector, but the structure must be identical to rnaturalearth::ne_download().
  • value: character string. Defining the output value. See value.
  • verbose: logical. If TRUE reports the name of the test and the number of records flagged.

Returns

Depending on the value argument, either a data.frame

containing the records considered correct by the test (clean ) or a logical vector (flagged ), with TRUE = test passed and FALSE = test failed/potentially problematic . Default = clean .

Note

See https://ropensci.github.io/CoordinateCleaner/ for more details and tutorials.

Examples

## Not run: x <- data.frame(species = letters[1:10], decimalLongitude = runif(100, -180, 180), decimalLatitude = runif(100, -90,90)) cc_urb(x) cc_urb(x, value = "flagged") ## End(Not run)

See Also

Other Coordinates: cc_aohi(), cc_cap(), cc_cen(), cc_coun(), cc_dupl(), cc_equ(), cc_gbif(), cc_inst(), cc_iucn(), cc_outl(), cc_sea(), cc_val(), cc_zero()