Takes WGS84 longitude and latitude coordinates and finds the closest matching c-squares for a given resolution.
as_csquares(x, resolution, csquares, ...)
# Default S3 method
as_csquares(x, resolution, csquares, ...)
# S3 method for class 'character'
as_csquares(x, resolution, csquares, validate = TRUE, ...)
# S3 method for class 'numeric'
as_csquares(x, resolution = 1, csquares, ...)
# S3 method for class 'data.frame'
as_csquares(x, resolution = 1, csquares, ...)
# S3 method for class 'sf'
as_csquares(x, resolution = 1, csquares, ..., use_centroids = TRUE)
# S3 method for class 'sfc'
as_csquares(x, resolution = 1, csquares, ..., use_centroids = TRUE)
# S3 method for class 'stars'
as_csquares(x, resolution = 1, csquares, ...)An object to be coerced to a csquares object. x can be a vector of character strings
representing c-squares code. It can also be a numeric matrix with two columns
containing the x and y coordinates. x can also be a simple features object
(sf) or a spatial arrays object (stars).
Resolution (in WGS84 degrees) to be used for creating c-squares codes. As per c-square specifications, the resolution should be 10 or less, yet greater than 0. It should be a tenfold of 1 or 5. Valid resolutions are therefore: 10, 5, 1, 0.5, 0.1, etc.
If x is not a vector of character strings (but for instance a data.frame),
the csquares argument should specify the name of the element of x containing the c-square
codes as character strings.
Currently ignored
A logical value indicating whether the created object needs to be validated.
Defaults to TRUE. Validation can be time-consuming so set to FALSE to save computing time.
In case x is a simple features object and use_centroids is TRUE,
the centroid of each geometry is used for deriving c-squares. If it is FALSE all coordinates
in the geometry are used.
Returns a csquares object that contains c-squares codes.
as_csquares(cbind(x = 5.2399066, y = 52.7155812), resolution = 1)
#> x y csquares
#> x 5.239907 52.71558 N50 E 0 (1°)
orca_csq <- as_csquares(orca, csquares = "csquares")