cc_urb function

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()