forward

Convert geodetic latitude to authalic, conformal, isometric, or rectifying latitude

Description

example

lat = forward(converter,phi) returns the authalic, conformal, isometric, or rectifying latitude coordinates corresponding to geodetic latitude coordinates phi.

example

lat = forward(converter,phi,angleUnit) specifies the units of input phi.

Examples

collapse all

 phi = [-90 -67.5 -45 -22.5 0 22.5 45 67.5 90];
 conv = map.geodesy.AuthalicLatitudeConverter(wgs84Ellipsoid);
 beta = forward(conv,phi)
beta =

 -90.0000 -67.4092 -44.8717  -22.4094  0  22.4094  44.8717  67.4092  90.0000
phi = [-90 -67.5 -45 -22.5 0 22.5 45 67.5 90];
conv = map.geodesy.IsometricLatitudeConverter(wgs84Ellipsoid);
psi = forward(conv,phi)
psi =

     -Inf  -1.6087  -0.8766   -0.4006  0  0.4006  0.8766  1.6087  Inf
phi = [-90 -67.5 -45 -22.5 0 22.5 45 67.5 90];
phirad = deg2rad(phi);
conv = map.geodesy.RectifyingLatitudeConverter(wgs84Ellipsoid);
mu = forward(conv,phirad,'radians')
mu =

  -90.0000 -67.3978 -44.8557  -22.3981  0  22.3981  44.8557  67.3978  90.0000

Input Arguments

collapse all

Geodetic latitude coordinates, specified as a numeric scalar value, vector, matrix, or N-D array. If angleUnit is not supplied, phi is in degrees. Otherwise, values of phi must be consistent with the units of angleUnit.

Data Types: single | double

Units of geodetic latitude coordinates, specified as 'degrees' or 'radians'.

Output Arguments

collapse all

Converted latitude coordinates, returned as a numeric scalar, vector, matrix, or N-D array. lat is the same size as phi.

The interpretation of lat depends on the latitude converter. If the conversion is:

  • authalic, lat represents the variable β (beta), and has the same units as phi.

  • conformal, lat represents χ (chi), and has the same units as phi.

  • isometric, lat represents ψ (psi). lat is a dimensionless number and does not have an angle unit.

  • rectifying, lat represents μ (mu), and has the same units as phi.

See Also

Introduced in R2013a