org.cts.op.projection

Class UniversalTransverseMercator

java.lang.Object

org.cts.IdentifiableComponent

org.cts.op.AbstractCoordinateOperation

org.cts.op.projection.Projection

org.cts.op.projection.UniversalTransverseMercator

All Implemented Interfaces:

Identifiable, CoordinateOperation

public class UniversalTransverseMercator
extends Projection

The Universal Transverse Mercator Projection (UTM).

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

Fields

Modifier and Type	Field and Description
protected double[]	dircoeff
protected double	FE
protected double[]	invcoeff
protected double	lon0
protected double	n
static String	NORTH
static String	SOUTH
static Identifier	UTM The Identifier used for all Universal Transverse Mercator projections.
protected double	xs
protected double	ys

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

Constructors

Constructor and Description
UniversalTransverseMercator(Ellipsoid ellipsoid, Map<String,Measure> parameters) Creates a new Universal Transverse Mercator Projection based on the given Ellipsoid and parameters (must contain Central Meridian and False Northing)

Method Summary

Modifier and Type	Method and Description
static UniversalTransverseMercator	createUTM(Ellipsoid ellipsoid, int zone, String hemisphere) Creates a new Universal Transverse Mercator Projection based on the given Ellipsoid, for the given zone and the given hemisphere.
static double[]	getDirectUTMCoeff(Ellipsoid ellps) Return the coefficients for the direct UTM projection associated with the ellipsoid in parameter.
static double[]	getInverseUTMCoeff(Ellipsoid ellps) Return the coefficients for the inverse UTM projection associated with the ellipsoid in parameter.
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.
Projection	inverse() Creates the inverse CoordinateOperation.
double[]	transform(double[] coord) Transform coord using the 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, isDirect, toWKT

Methods inherited from class org.cts.op.AbstractCoordinateOperation

getPrecision, isIdentity

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.

NORTH

public static final String NORTH

See Also:

Constant Field Values

SOUTH

public static final String SOUTH

See Also:

Constant Field Values

FE

protected final double FE

lon0

protected final double lon0

n

protected final double n

xs

protected final double xs

ys

protected final double ys

dircoeff

protected final double[] dircoeff

invcoeff

protected final double[] invcoeff

Constructor Detail

UniversalTransverseMercator

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

Creates a new Universal Transverse Mercator Projection based on the given Ellipsoid and parameters (must contain Central Meridian and False Northing)

Parameters:

ellipsoid - ellipsoid used to define the projection.

parameters - a map of parameters to define the projection. Must include Central Meridian and False Northing

Method Detail

createUTM

public static UniversalTransverseMercator createUTM(Ellipsoid ellipsoid,
                                                    int zone,
                                                    String hemisphere)

Creates a new Universal Transverse Mercator Projection based on the given Ellipsoid, for the given zone and the given hemisphere.

Parameters:

ellipsoid - ellipsoid used to define the projection.

zone - the UTM zone

getDirectUTMCoeff

public static double[] getDirectUTMCoeff(Ellipsoid ellps)

Return the coefficients for the direct UTM projection associated with the ellipsoid in parameter.

Parameters:

ellps - the projected ellipsoid

getInverseUTMCoeff

public static double[] getInverseUTMCoeff(Ellipsoid ellps)

Return the coefficients for the inverse UTM projection associated with the ellipsoid in parameter.

Parameters:

ellps - the projected ellipsoid

transform

public double[] transform(double[] coord)

Transform coord using the 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 Projection inverse()

Creates the inverse CoordinateOperation.

Specified by:

inverse in interface CoordinateOperation

Overrides:

inverse in class Projection

getSurface

public Projection.Surface getSurface()

Return the Surface type of this Projection.

Specified by:

getSurface in class Projection

Returns:

getProperty

public Projection.Property getProperty()

Return the Property of this Projection.

Specified by:

getProperty in class Projection

Returns:

getOrientation

public Projection.Orientation getOrientation()

Return the Orientation of this Projection.

Specified by:

getOrientation in class Projection

Returns: