Identify records lacking or with invalid coordinates but containing locality information

This function Identifies records whose coordinates can potentially be extracted from locality information.

bdc_coordinates_from_locality(
  data,
  lat = "decimalLatitude",
  lon = "decimalLongitude",
  locality = "locality",
  save_outputs = FALSE
)

Arguments

data

data.frame. Containing geographical coordinates and the column "locality'.

lat

character string. The column name with latitude in decimal degrees and WGS84. Default = "decimalLatitude".

lon

character string. The column with longitude in decimal degrees and WGS84. Default = "decimalLongitude".

locality

character string. The column name with locality information. Default = "locality".

save_outputs

logical. Should a table containing transposed coordinates saved for further inspection? Default = FALSE.

Value

A data.frame containing records missing or with invalid coordinates but with potentially useful locality information. When save_outputs = FALSE the data.frame is saved in Output/Check/01_coordinates_from_locality.csv

Details

According to DarwinCore terminology, locality refers to "the specific description of the place" where an organism was recorded.

See also

Other prefilter: bdc_basisOfRecords_notStandard(), bdc_coordinates_country_inconsistent(), bdc_coordinates_empty(), bdc_coordinates_outOfRange(), bdc_coordinates_transposed(), bdc_country_standardized(), bdc_scientificName_empty()

Examples

x <- data.frame(
  lat = c(NA, NA, ""),
  lon = c("", NA, NA),
  locality = c(
    "PARAGUAY: ALTO PARAGUAY: CO.; 64KM W PUERTO SASTRE",
    "Parque Estadual da Serra de Caldas Novas, Goias, Brazil",
    "Parque Nacional Iguazu"
  )
)

bdc_coordinates_from_locality(
  data = x,
  lat = "lat",
  lon = "lon",
  locality = "locality",
  save_outputs = FALSE
)
#> 
#> bdc_coordinates_from_locality 
#> Found 3 records missing or with invalid coordinates but with potentially useful information on locality.
#>    lat  lon                                                locality
#> 1 <NA>           PARAGUAY: ALTO PARAGUAY: CO.; 64KM W PUERTO SASTRE
#> 2 <NA> <NA> Parque Estadual da Serra de Caldas Novas, Goias, Brazil
#> 3      <NA>                                  Parque Nacional Iguazu
#>   .coordinates_empty .coordinates_outOfRange
#> 1              FALSE                    TRUE
#> 2              FALSE                    TRUE
#> 3              FALSE                    TRUE