Learn R Programming

spatialEco (version 1.3-0)

spheroid.distance: Vincenty Direct Calculation of Distance and Direction

Description

Estimates the distance on a sphere using lat and long coordinates

Usage

spheroid.distance(lat1, lon1 = NULL, lat2 = NULL, lon2 = NULL, bearing = FALSE)

Arguments

lat1

a single value or vector of values representing latitude in decimal degrees from -90 to 90 degrees. Alternatively, a data.frame or matrix can be used here with each column representing lat1, lon1, lat2, lon2 (in that order).

lon1

a single value or vector of values representing longitude in decimal degrees from -180 to 180 degrees. If NULL, lat1 is assumed to be a matrix or data.frame.

lat2

a single value or vector of values representing latitude in decimal degrees from -90 to 90 degrees. If NULL, lat1 is assumed to be a matrix or data.frame.

lon2

a single value or vector of values representing longitude in decimal degrees from -180 to 180 degrees. If NULL, lat1 is assumed to be a matrix or data.frame.

bearing

boolean value as to calculate the direction as well as the distance.

Value

Returns a data.frame with:

  • lon1 - the original longitude

  • lat1 - the original latitude

  • lon2 - the destination longitude

  • lat2 - the destination latitude

  • distance - the distance used

  • bearing - if requested, the bearing between the two points

References

Vincenty, T. (1975). Direct and Inverse Solutions of Geodesics on the Ellipsoid with application of Nested Equations. Survey Review, vol XXII no 176.