CoordinateCleaner: cc_val – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

cc_val

Identify Invalid lat/lon Coordinates

Description

Removes or flags non-numeric and not available coordinates as well as lat >90, la <-90, lon > 180 and lon < -180 are flagged.

Usage

cc_val(
  x,
  lon = "decimallongitude",
  lat = "decimallatitude",
  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”.
`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.

Details

This test is obligatory before running any further tests of CoordinateCleaner, as additional tests only run with valid coordinates.

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.

Examples

x <- data.frame(species = letters[1:10], 
                decimallongitude = c(runif(106, -180, 180), NA, "13W33'", "67,09", 305), 
                decimallatitude = runif(110, -90,90))
                
cc_val(x)
cc_val(x, value = "flagged")

CoordinateCleaner

Automated Cleaning of Occurrence Records from Biological Collections

v2.0-18

GPL-3

Authors

Alexander Zizka [aut, cre], Daniele Silvestro [ctb], Tobias Andermann [ctb], Josue Azevedo [ctb], Camila Duarte Ritter [ctb], Daniel Edler [ctb], Harith Farooq [ctb], Andrei Herdean [ctb], Maria Ariza [ctb], Ruud Scharn [ctb], Sten Svanteson [ctb], Niklas Wengstrom [ctb], Vera Zizka [ctb], Alexandre Antonelli [ctb], Irene Steves [rev] (Irene reviewed the package for ropensci, see <https://github.com/ropensci/onboarding/issues/210>), Francisco Rodriguez-Sanchez [rev] (Francisco reviewed the package for ropensci, see <https://github.com/ropensci/onboarding/issues/210>)

Initial release