org.cts.op.projection
Class UniversalTransverseMercatorAuto

java.lang.Object
  org.cts.IdentifiableComponent
      org.cts.op.AbstractCoordinateOperation
          org.cts.op.projection.Projection
              org.cts.op.projection.UniversalTransverseMercatorAuto

All Implemented Interfaces:

Identifiable, CoordinateOperation

public class UniversalTransverseMercatorAuto
extends Projection

A map projection is any method used in cartography (mapmaking) to represent the two-dimensional curved surface of the earth or other body on a plane. The term "projection" here refers to any function defined on the earth's surface and with values on the plane, and not necessarily a geometric projection.

Author:

Michaël Michaud

Nested Class Summary

Nested classes/interfaces inherited from class org.cts.op.projection.Projection

Projection.Orientation, Projection.Property, Projection.Surface

Field Summary

protected double[]	dircoeff
protected double[]	invcoeff
protected double	lat0
protected double	n
static Identifier	UTM The Identifier used for all Universal Transverse Mercator projections.
protected double	xs

Fields inherited from class org.cts.op.projection.Projection

DEFAULT_PARAMETERS

Fields inherited from class org.cts.op.AbstractCoordinateOperation

precision

Fields inherited from interface org.cts.Identifiable

DEFAULT, LOCAL, UNKNOWN

Constructor Summary

UniversalTransverseMercatorAuto(Ellipsoid ellipsoid, Map<String,Measure> parameters)
Create a new Universal Transverse Mercator Projection corresponding to the Ellipsoid given in argument and a default set of parameters and initialize common parameters lat0 and other parameters useful for the projection.

Method Summary

Projection.Orientation	getOrientation() Return the Orientation of this Projection.
Projection.Property	getProperty() Return the Property of this Projection.
Projection.Surface	getSurface() Return the Surface type of this Projection.
int	getZone(double[] coord)
CoordinateOperation	inverse() Creates the inverse CoordinateOperation.
double[]	transform(double[] coord) Transform coord using a Universal Transverse Mercator projection.

Methods inherited from class org.cts.op.projection.Projection

equals, getAzimuth, getCentralMeridian, getDefaultParameters, getFalseEasting, getFalseNorthing, getLatitudeOfOrigin, getLatitudeOfTrueScale, getRectifiedGridAngle, getScaleFactor, getSemiMajorAxis, getSemiMinorAxis, getStandardParallel1, getStandardParallel2, hashCode, toWKT

Methods inherited from class org.cts.op.AbstractCoordinateOperation

getPrecision

Methods inherited from class org.cts.IdentifiableComponent

addAlias, addRemark, getAliases, getAuthorityKey, getAuthorityName, getCode, getComponent, getIdentifier, getName, getRemarks, getShortName, setIdentifier, setRemarks, setShortName, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.cts.Identifiable

addAlias, addRemark, getAliases, getAuthorityKey, getAuthorityName, getCode, getName, getRemarks, getShortName, setRemarks, setShortName

Field Detail

UTM

public static final Identifier UTM

The Identifier used for all Universal Transverse Mercator projections.

lat0

protected final double lat0

n

protected final double n

xs

protected final double xs

dircoeff

protected final double[] dircoeff

invcoeff

protected final double[] invcoeff

Constructor Detail

UniversalTransverseMercatorAuto

public UniversalTransverseMercatorAuto(Ellipsoid ellipsoid,
                                       Map<String,Measure> parameters)

Create a new Universal Transverse Mercator Projection corresponding to the Ellipsoid given in argument and a default set of parameters and initialize common parameters lat0 and other parameters useful for the projection.

Parameters:

ellipsoid - ellipsoid used to define the projection.

parameters - a map of useful parameters to define the projection.

Method Detail

getZone

public int getZone(double[] coord)

transform

public double[] transform(double[] coord)
                   throws CoordinateDimensionException

Transform coord using a Universal Transverse Mercator projection. Input coord is supposed to be a geographic latitude / longitude coordinate in radians.

Specified by:

transform in interface CoordinateOperation

Specified by:

transform in class AbstractCoordinateOperation

Parameters:

coord - coordinate to transform

Returns:

a double array containing the output coordinate

Throws:

CoordinateDimensionException - if coord length is not compatible with this CoordinateOperation.

inverse

public CoordinateOperation inverse()
                            throws NonInvertibleOperationException

Creates the inverse CoordinateOperation.

Specified by:

inverse in interface CoordinateOperation

Overrides:

inverse in class AbstractCoordinateOperation

Throws:

NonInvertibleOperationException

getSurface

public Projection.Surface getSurface()

Return the Surface type of this Projection.

Specified by:

getSurface in class Projection

getProperty

public Projection.Property getProperty()

Return the Property of this Projection.

Specified by:

getProperty in class Projection

getOrientation

public Projection.Orientation getOrientation()

Return the Orientation of this Projection.

Specified by:

getOrientation in class Projection