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

All Implemented Interfaces:

Object, TypedObjectNode, CRSResource, ITransverseMercator, IProjection

public class TransverseMercator
extends CylindricalProjection
implements ITransverseMercator

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: 29642 $, $Date: 2011-02-11 13:59:33 +0100 (Fri, 11 Feb 2011) $

Author:

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

Constructor Summary

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

TransverseMercator(boolean northernHemisphere, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, IUnit units, double scale, CRSResource id)

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

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

TransverseMercator(int zone, boolean northernHemisphere, IUnit 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, IUnit units, CRSResource 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

javax.vecmath.Point2d	doInverseProjection(IGeographicCRS geographicCRS, double x, double y) Do an inverse projection from projected (map) coordinates to geographic coordinates.
javax.vecmath.Point2d	doProjection(IGeographicCRS geographicCRS, double lambda, double phi) The actual transform method doing a projection from geographic coordinates to map coordinates.
boolean	getHemisphere()
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, getEccentricity, getEllipsoid, getFalseEasting, getFalseNorthing, 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, getId, 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

Methods inherited from interface org.deegree.cs.projections.IProjection

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

Methods inherited from interface org.deegree.cs.CRSResource

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

Methods inherited from interface org.deegree.commons.tom.Object

getId

Constructor Detail

TransverseMercator

public TransverseMercator(boolean northernHemisphere,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          IUnit units,
                          double scale,
                          CRSResource 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,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          IUnit 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,
                          IUnit units,
                          CRSResource 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,
                          IUnit 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(double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          IUnit 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(double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          IUnit units,
                          CRSResource 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(IGeographicCRS geographicCRS,
                                                 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 interface IProjection

Specified by:

doInverseProjection in class Projection

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(IGeographicCRS geographicCRS,
                                          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 interface IProjection

Specified by:

doProjection in class Projection

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)

Specified by:

getRowFromNearestParallel in interface ITransverseMercator

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

Specified by:

getZoneFromNearestMeridian in interface ITransverseMercator

Parameters:

longitude - in radians

Returns:

the utm zone.

getImplementationName

public String getImplementationName()

Specified by:

getImplementationName in interface IProjection

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()

Specified by:

getHemisphere in interface ITransverseMercator

Returns:

the true if defined on the northern hemisphere.