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 SpatialPolygonsDataFrame. Providing the geographic gazetteer with the urban areas. See details. By default rnaturalearth::ne_download(scale = 'medium', type = 'urban_areas'). Can be any SpatialPolygonsDataframe, 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.

Value

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.

See also

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

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")
# }