# 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

example

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

example

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

### Input Arguments

expand all

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.

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

## Properties

expand all

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

collapse all

```grs80 = referenceEllipsoid('GRS 80'); conv1 = map.geodesy.ConformalLatitudeConverter; conv1.Eccentricity = grs80.Eccentricity ```
```conv1 = ConformalLatitudeConverter with properties: Eccentricity: 0.0818```
```grs80 = referenceEllipsoid('GRS 80'); conv2 = map.geodesy.ConformalLatitudeConverter(grs80)```
```conv2 = ConformalLatitudeConverter with properties: Eccentricity: 0.0818```

## Version History

Introduced in R2013a