org.deegree.cs.projections.cylindric
Class TransverseMercator

java.lang.Object
  org.deegree.cs.CRSIdentifiable
      org.deegree.cs.projections.Projection
          org.deegree.cs.projections.cylindric.CylindricalProjection
              org.deegree.cs.projections.cylindric.TransverseMercator

public class TransverseMercator
extends CylindricalProjection

The TransverseMercator projection has following properties:

• Cylindrical (transverse)
• Conformal
• The central meridian, each meridian 90° from central meridian and the equator are straight lines
• All other meridians and parallels are complex curves
• Scale is true along central meridian or along two straight lines equidistant from and parallel to central merdian. (These lines are only approximately straight for the ellipsoid)
• Scale becomes infinite on sphere 90° from central meridian
• Used extensively for quadrangle maps at scales from 1:24.000 to 1:250.000
• Often used to show regions with greater north-south extent
• presented by lambert in 1772

Version:

$Revision: 23245 $, $Date: 2010-03-25 10:45:24 +0100 (Do, 25. Mär 2010) $

Author:

Rutger Bezema, last edited by: $Author: rbezema $

Constructor Summary

TransverseMercator(boolean northernHemisphere, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale)
Sets the id to EPSG:9807

TransverseMercator(boolean northernHemisphere, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale, CRSIdentifiable id)

TransverseMercator(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units)
A northern hemisphere conformal transverse mercator projection with a scale of one.

TransverseMercator(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, CRSIdentifiable id)
A northern hemisphere conformal transverse mercator projection with a scale of one.

TransverseMercator(int zone, boolean northernHemisphere, GeographicCRS geographicCRS, Unit units)
Sets the false-easting to 50000, false-northing to 0 or 10000000 (depending on the hemisphere), the projection-longitude is calculated from the zone and the projection-latitude is set to 0.

TransverseMercator(int zone, boolean northernHemisphere, GeographicCRS geographicCRS, Unit units, CRSIdentifiable id)
Sets the false-easting to 50000, false-northing to 0 or 10000000 (depending on the hemisphere), the projection-longitude is calculated from the zone and the projection-latitude is set to 0.

Method Summary

Projection	clone(GeographicCRS newCRS) Creates a copy of this projection with the given GeographicCRS as the base.
javax.vecmath.Point2d	doInverseProjection(double x, double y) Do an inverse projection from projected (map) coordinates to geographic coordinates.
javax.vecmath.Point2d	doProjection(double lambda, double phi) The actual transform method doing a projection from geographic coordinates to map coordinates.
boolean	getHemisphere()
java.lang.String	getImplementationName()
int	getRowFromNearestParallel(double latitude)
int	getZoneFromNearestMeridian(double longitude) the utm zone from a given meridian

Methods inherited from class org.deegree.cs.projections.Projection

equals, getCosphi0, getDatum, getEccentricity, getEllipsoid, getFalseEasting, getFalseNorthing, getGeographicCRS, getNaturalOrigin, getPrimeMeridian, getProjectionLatitude, getProjectionLongitude, getScale, getScaleFactor, getSemiMajorAxis, getSemiMinorAxis, getSinphi0, getSquaredEccentricity, getUnits, hashCode, isConformal, isEqualArea, isSpherical, setFalseEasting, setScale, toString

Methods inherited from class org.deegree.cs.CRSIdentifiable

addAreaOfUse, addName, checkForNullObject, checkForNullObject, checkForNullObject, getAreaOfUse, getAreaOfUseBBox, getAreasOfUse, getCode, getCodeAndName, getCodes, getDescription, getDescriptions, getName, getNames, getOrignalCodeStrings, getVersion, getVersions, hasCode, hasId, hasIdOrName, setDefaultAreaOfUse, setDefaultDescription, setDefaultId, setDefaultName, setDefaultVersion

Methods inherited from class java.lang.Object

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

Constructor Detail

TransverseMercator

public TransverseMercator(boolean northernHemisphere,
                          GeographicCRS geographicCRS,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          Unit units,
                          double scale,
                          CRSIdentifiable id)

Parameters:

northernHemisphere - true if on the northern hemisphere false otherwise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

id - an identifiable instance containing information about this projection

TransverseMercator

public TransverseMercator(boolean northernHemisphere,
                          GeographicCRS geographicCRS,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          Unit units,
                          double scale)

Sets the id to EPSG:9807

Parameters:

northernHemisphere - true if on the northern hemisphere false otherwise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

TransverseMercator

public TransverseMercator(int zone,
                          boolean northernHemisphere,
                          GeographicCRS geographicCRS,
                          Unit units,
                          CRSIdentifiable id)

Sets the false-easting to 50000, false-northing to 0 or 10000000 (depending on the hemisphere), the projection-longitude is calculated from the zone and the projection-latitude is set to 0. The scale will be 0.9996.

Parameters:

zone - to add

northernHemisphere - true if the projection is on the northern hemisphere

geographicCRS -

units -

id - an identifiable instance containing information about this projection

TransverseMercator

public TransverseMercator(int zone,
                          boolean northernHemisphere,
                          GeographicCRS geographicCRS,
                          Unit units)

Sets the false-easting to 50000, false-northing to 0 or 10000000 (depending on the hemisphere), the projection-longitude is calculated from the zone and the projection-latitude is set to 0. The scale will be 0.9996.

Parameters:

zone - to add

northernHemisphere - true if the projection is on the northern hemisphere

geographicCRS -

units -

TransverseMercator

public TransverseMercator(GeographicCRS geographicCRS,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          Unit units)

A northern hemisphere conformal transverse mercator projection with a scale of one. Using the given datum.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

TransverseMercator

public TransverseMercator(GeographicCRS geographicCRS,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          Unit units,
                          CRSIdentifiable id)

A northern hemisphere conformal transverse mercator projection with a scale of one. Using the given datum.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

id - an identifiable instance containing information about this projection

Method Detail

doInverseProjection

public javax.vecmath.Point2d doInverseProjection(double x,
                                                 double y)
                                          throws ProjectionException

Description copied from class: Projection

Do an inverse projection from projected (map) coordinates to geographic coordinates.

Specified by:

doInverseProjection in class Projection

Parameters:

x - coordinate on the map

y - coordinate on the map

Returns:

the projected Point with x = lambda and y = phi;

Throws:

ProjectionException - if the given x and y coordinates could not be inverted to lambda and phi.

doProjection

public javax.vecmath.Point2d doProjection(double lambda,
                                          double phi)
                                   throws ProjectionException

Description copied from class: Projection

The actual transform method doing a projection from geographic coordinates to map coordinates.

Specified by:

doProjection in class Projection

Parameters:

lambda - the longitude

phi - the latitude

Returns:

the projected Point or Point(Double.NAN, Double.NAN) if an error occurred.

Throws:

ProjectionException - if the given lamba and phi coordinates could not be projected to x and y.

getRowFromNearestParallel

public int getRowFromNearestParallel(double latitude)

Parameters:

latitude - to get the nearest paralles to.

Returns:

the nearest parallel in radians of given latitude

getZoneFromNearestMeridian

public int getZoneFromNearestMeridian(double longitude)

the utm zone from a given meridian

Parameters:

longitude - in radians

Returns:

the utm zone.

getImplementationName

public java.lang.String getImplementationName()

Specified by:

getImplementationName in class Projection

Returns:

A deegree specific name which will be used for the export of a projection.

getHemisphere

public final boolean getHemisphere()

Returns:

the true if defined on the northern hemisphere.

clone

public Projection clone(GeographicCRS newCRS)

Description copied from class: Projection

Creates a copy of this projection with the given GeographicCRS as the base.

Specified by:

clone in class Projection

Parameters:

newCRS - the new GeographicCRS

Returns:

a copy of this projection based upon the given crs.