ensure3d: Checking and converting coordinates

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/ajbplot.R

Description

This is used as a checking mechanism for other functions to ensure data is given in the appropriate format, and if it is not, converting to the appropriate format where possible.

Usage

1
2

Arguments

x

A vector, matrix or dataframe to be checked

single

Logical indicating whether a single point is expected.

Details

ensure3d checks to ensure that the given data are one or more sets of 3D Cartesian coordinates, and converts them to numeric vectors if they are not already. If longitudes and latitudes are given as input into ensure3d, they will be converted to 3D Cartesian coordinates, on the unit sphere. ensurelonlat checks to ensure that the given data are one or more pairs of longitude and latitude and converts the data to a pair of lists if they are not already. Vectors and single rows/columns of matrices can be used as input for both functions; multiple rows/colums of matrices and pairs of lists can also be used as input for ensurelonlat.

Value

ensure3d A numeric vector or matrix ensurelonlat

$lon

List of Longitudes

$lat

List of Latitudes

Author(s)

Adrian Baddeley, Ege Rubak and Tom Lawrence

See Also

spatialpos

Examples

1
2
3
4
5
ensure3d(c(1,4,2))
ensure3d(matrix(1:3, ncol = 3))
ensure3d(data.frame(x = 1:2, y = 3:4, z = 5:6), single = FALSE)
ensure3d(data.frame(lon = c(0,180), lat = c(-45,45)), single = FALSE)
ensurelonlat(c(145, -90))

Example output

[1] 1 4 2
[1] 1 2 3
     x y z
[1,] 1 3 5
[2,] 2 4 6
           [,1]         [,2]       [,3]
[1,]  0.7071068 0.000000e+00 -0.7071068
[2,] -0.7071068 8.659561e-17  0.7071068
$lon
[1] 145

$lat
[1] -90

globe documentation built on May 30, 2017, 1:52 a.m.