Skip to contents

Removes or flags non-numeric and not available coordinates as well as lat >90, lat <-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.

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”.

Details

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

Note

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

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_urb(), cc_zero()

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)
#> Testing coordinate validity
#> Removed 4 records.
#>     species decimalLongitude decimalLatitude
#> 1         a       139.960163        2.714213
#> 2         b       123.721268      -22.657575
#> 3         c        16.829869       -9.106877
#> 4         d       -87.475574       68.669291
#> 5         e       -18.748979       -6.057378
#> 6         f      -154.092145       50.331887
#> 7         g       155.728509       67.072977
#> 8         h       105.130340       59.511856
#> 9         i       -20.857225       68.541891
#> 10        j       -74.829953       57.797704
#> 11        a       -47.936709       82.706399
#> 12        b       -82.537084       -9.734454
#> 13        c        -7.653825      -49.793956
#> 14        d      -124.640072       68.301082
#> 15        e        61.848143       40.702252
#> 16        f        23.056200      -22.624410
#> 17        g       149.891799       84.566549
#> 18        h        62.696210       33.149898
#> 19        i       120.825445       63.018706
#> 20        j       121.142716       17.834615
#> 21        a        56.506590       26.338155
#> 22        b      -108.771322      -51.526303
#> 23        c       -29.049704      -29.828181
#> 24        d       -60.401778       36.859343
#> 25        e       117.801525       59.473390
#> 26        f        20.044293       77.175325
#> 27        g       136.674276       64.713726
#> 28        h       179.176341      -50.240781
#> 29        i       -35.994489       17.985525
#> 30        j       -97.214597       42.312640
#> 31        a      -116.838666      -82.908861
#> 32        b       128.712597      -64.427014
#> 33        c       162.883340       72.825828
#> 34        d      -165.059167       -9.214445
#> 35        e         7.709092      -75.013983
#> 36        f        -1.200577       62.734172
#> 37        g        73.169808       54.933630
#> 38        h      -125.320122      -72.062897
#> 39        i        39.738800      -78.048400
#> 40        j       178.337769      -65.169110
#> 41        a       158.782118      -11.986470
#> 42        b         3.839336        6.405068
#> 43        c       118.302086       -7.276883
#> 44        d       -61.284064       28.683086
#> 45        e       -11.977279       85.594805
#> 46        f       -52.520214      -33.359126
#> 47        g       147.390954       15.159658
#> 48        h       103.459324      -35.247816
#> 49        i       -64.658217       72.944551
#> 50        j         5.929590      -14.971455
#> 51        a       -71.932542       57.624294
#> 52        b       -75.327645       -8.083552
#> 53        c       124.070054      -80.050430
#> 54        d        17.060956       23.947601
#> 55        e        59.412852       82.763940
#> 56        f      -153.876832      -43.766867
#> 57        g       103.970113       19.368338
#> 58        h       162.481070        7.088885
#> 59        i        31.700338      -77.571612
#> 60        j       127.563809       10.747840
#> 61        a        64.821221       -3.879421
#> 62        b        76.095520      -21.274453
#> 63        c       -66.846793      -72.293926
#> 64        d       -67.731123      -37.112276
#> 65        e       106.171120      -80.897574
#> 66        f        55.687000       -4.027367
#> 67        g        63.495481       20.490572
#> 68        h         2.623203      -79.648524
#> 69        i        46.413555       71.841252
#> 70        j        81.716962      -57.435524
#> 71        a      -176.642746      -85.072467
#> 72        b        54.325299       28.994266
#> 73        c      -139.610323        2.767326
#> 74        d       -28.331888      -73.318219
#> 75        e       -61.649311        3.142834
#> 76        f       161.673949      -27.877770
#> 77        g        10.513194      -84.518275
#> 78        h       118.734243      -30.055970
#> 79        i       128.440286       43.341888
#> 80        j        15.167338       57.273254
#> 81        a       -76.190825       72.715443
#> 82        b      -105.974456       -6.039954
#> 83        c        44.466590       85.481695
#> 84        d        65.104917       26.707479
#> 85        e      -120.698272      -42.239505
#> 86        f         2.892955      -14.145330
#> 87        g       -97.690531       79.584344
#> 88        h      -166.841348      -45.985198
#> 89        i       -30.712231      -58.274138
#> 90        j        26.051348      -63.679962
#> 91        a        56.629976       53.972749
#> 92        b      -115.990012       80.519645
#> 93        c      -151.914732       -3.842598
#> 94        d       156.380726       77.239124
#> 95        e       106.635341        1.608100
#> 96        f        13.440817       30.093730
#> 97        g         2.485761      -21.605509
#> 98        h      -166.836198      -13.663325
#> 99        i       -74.610386      -85.049406
#> 100       j         7.912243      -64.640550
#> 101       a      -161.248144       63.579433
#> 102       b        26.988219      -23.467413
#> 103       c      -127.501401       50.024589
#> 104       d      -153.599722      -56.244761
#> 105       e        71.311984      -43.373158
#> 106       f       124.463493       17.619960
cc_val(x, value = "flagged")
#> Testing coordinate validity
#> Flagged 4 records.
#>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [13]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [25]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [37]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [49]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [61]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [73]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [85]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE
#>  [97]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE FALSE FALSE
#> [109] FALSE FALSE