map.geodesy.ConformalLatitudeConverter

Convert between geodetic and conformal latitudes

Description

A ConformalLatitudeConverter object provides conversion methods between geodetic and conformal latitudes for an ellipsoid with a given eccentricity.

The conformal latitude maps an ellipsoid (oblate spheroid) to a sphere while preserving shapes and angles locally. (Curves that meet at a given angle on the ellipsoid meet at the same angle on the sphere.) Use conformal latitudes when implementing conformal map projections on the ellipsoid.

Creation

Syntax

converter = map.geodesy.ConformalLatitudeConverter

converter = map.geodesy.ConformalLatitudeConverter(spheroid)

Description

converter = map.geodesy.ConformalLatitudeConverter creates a ConformalLatitudeConverter object for a sphere and sets the Eccentricity property to 0.

converter = map.geodesy.ConformalLatitudeConverter(spheroid) creates a conformal latitude converter object and sets the Eccentricity property to match the specified spheroid object.

Input Arguments

spheroid — Reference spheroid

referenceEllipsoid object | oblateSpheroid object | referenceSphere object

Reference spheroid, specified as a referenceEllipsoid object, oblateSpheroid object, or referenceSphere object. The term reference spheroid is used synonymously with reference ellipsoid. To create a reference spheroid, use the creation function for the object. To specify the reference ellipsoid for WGS84, use the wgs84Ellipsoid function.

For more information about reference spheroids, see Comparison of Reference Spheroids.

Example: spheroid = referenceEllipsoid('GRS 80');

Properties

Eccentricity — Ellipsoid eccentricity

0 | numeric scalar

Ellipsoid eccentricity, specified as a numeric scalar. Eccentricity is in the interval [0, 0.5]. Eccentricities larger than 0.5 are possible in theory, but do not occur in practice and are not supported.

Data Types: double

Object Functions

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

Examples

Create a Conformal Latitude Converter Object and Set Property

grs80 = referenceEllipsoid('GRS 80');

conv1 = map.geodesy.ConformalLatitudeConverter;
conv1.Eccentricity = grs80.Eccentricity

conv1 = 

  ConformalLatitudeConverter with properties:

    Eccentricity: 0.0818

Create a Conformal Latitude Converter Object Specifying a Spheroid

grs80 = referenceEllipsoid('GRS 80');

conv2 = map.geodesy.ConformalLatitudeConverter(grs80)

conv2 = 

  ConformalLatitudeConverter with properties:

    Eccentricity: 0.0818

Version History

Introduced in R2013a