org.deegree.crs.projections.cylindric
Class TransverseMercator

java.lang.Object
  org.deegree.crs.Identifiable
      org.deegree.crs.projections.Projection
          org.deegree.crs.projections.cylindric.CylindricalProjection
              org.deegree.crs.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:$, $Date:$

Author:

Rutger Bezema, last edited by: $Author:$

Constructor Summary

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

TransverseMercator(boolean northernHemisphere, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale, String[] identifiers)

TransverseMercator(boolean northernHemisphere, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale, String[] identifiers, String[] names, String[] versions, String[] descriptions, String[] areasOfUse)

TransverseMercator(boolean northernHemisphere, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale, String identifier, String name, String version, String description, String areaOfUse)

TransverseMercator(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, String identifier)
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, String[] identifiers)
A northern hemisphere conformal transverse mercator projection with a scale of one.

Method Summary

javax.vecmath.Point2d	doInverseProjection(double x, double y) Do an inverse projection from projected (map) coordinates to geogpraphic coordinates.
javax.vecmath.Point2d	doProjection(double lambda, double phi) The actual transform method doing a projection from geographic coordinates to map coordinates.
String	getDeegreeSpecificName()
boolean	getHemisphere()
int	getRowFromNearestParallel(double latitude)
int	getZoneFromNearestMeridian(double longitude) the utm zone from a given meridian
void	setUTMZone(int zone) Set the zone for this transverse mercator, not yet used.

Methods inherited from class org.deegree.crs.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, setProjectionLatitude, setProjectionLongitude, setScale, toString

Methods inherited from class org.deegree.crs.Identifiable

checkForNullObject, checkForNullObject, getAreaOfUse, getAreasOfUse, getDescription, getDescriptions, getIdAndName, getIdentifier, getIdentifiers, getName, getNames, getVersion, getVersions

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,
                          String[] identifiers,
                          String[] names,
                          String[] versions,
                          String[] descriptions,
                          String[] areasOfUse)

Parameters:

northernHemisphere - true if on the northernhemisphere false otherwhise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifiers -

names -

versions -

descriptions -

areasOfUse -

TransverseMercator

public TransverseMercator(boolean northernHemisphere,
                          GeographicCRS geographicCRS,
                          double falseNorthing,
                          double falseEasting,
                          javax.vecmath.Point2d naturalOrigin,
                          Unit units,
                          double scale,
                          String identifier,
                          String name,
                          String version,
                          String description,
                          String areaOfUse)

Parameters:

northernHemisphere - true if on the northernhemisphere false otherwhise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifier -

name -

version -

description -

areaOfUse -

TransverseMercator

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

Parameters:

northernHemisphere - true if on the northernhemisphere false otherwhise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifiers -

TransverseMercator

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

Parameters:

northernHemisphere - true if on the northernhemisphere false otherwhise.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifier -

TransverseMercator

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

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

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

identifiers -

name -

TransverseMercator

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

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

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

identifier -

name -

Method Detail

doInverseProjection

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

Description copied from class: Projection

Do an inverse projection from projected (map) coordinates to geogpraphic 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, or Point(Double.NAN, Double.NAN) if an error occurred.

Throws:

CRSException

doProjection

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

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:

CRSException

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.

setUTMZone

public void setUTMZone(int zone)

Set the zone for this transverse mercator, not yet used.

Parameters:

zone - the new utm zone.

getDeegreeSpecificName

public String getDeegreeSpecificName()

Specified by:

getDeegreeSpecificName in class Projection

Returns:

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

getHemisphere

public final boolean getHemisphere()

Returns:

the true if defined on the northern hemisphere.