Index   |   toolbox > geo > private > reckon.m <<  rec2geod rotatem  >>
reckon
PURPOSE
RECKON Computes points at a specified azimuth and range
SYNOPSIS
function [latout,lonout] = reckon(varargin)
DESCRIPTION
```RECKON  Computes points at a specified azimuth and range

[lat,lon] = RECKON(lat0,lon0,rng,az) computes the latitude and
longitude positions for selected ranges and azimuths from a
starting point along a great circle path on a globe.  The range
is input as degrees of arc length on a sphere.  The input
azimuth is measured clockwise from due north.

[lat,lon] = RECKON(lat0,lon0,rng,az,geoid) computes the new point
assuming that the great circle points lie on the ellipsoid defined by
the input geoid.  The geoid vector is of the form
[semimajor axes, eccentricity].

[lat,lon] = RECKON(lat0,lon0,rng,az,'units') uses the input string 'units'
to define the angle units of the input and output data.  In this
form, the input range is measured as an arc length in the units
specified by 'units'.  If 'units' is omitted, 'degrees' are assumed.

[lat,lon] = RECKON(lat0,lon0,rng,az,geoid,'units') is a valid calling
form.  In this case, the input range is in the same units as
the semimajor axes of the geoid vector.

[lat,lon] = RECKON('track',...) uses the input string 'track' to define
either a great circle or rhumb line reckon calculation.  If
'track' = 'gc', then the new point is computed to along a great
circle track.  If 'track' = 'rh', then the new point is computed
along a rhumb line track.  If omitted, 'gc' is assumed.