org.deegree.cs.projections.cylindric
Class Mercator

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

public class Mercator
extends CylindricalProjection

The Mercator projection has following properties:

• Cylindircal
• Conformal
• Meridians are equally spaced straight lines
• Parallels are unequally spaced straight lines closest near the equator, cutting meridians at right angles.
• Scale is true along the Equator, or along two parallels equidistant from the Equator
• Loxodromes (rhumb lines) are straight lines
• Not perspective
• Poles are at infinity; great distortion or area in polar regions
• Used for navigation
• Presented by Mercator in 1569

Version:

$Revision: $, $Date: $

Author:

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

Constructor Summary

Mercator(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale)
Sets the id to EPSG:9804

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

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.
java.lang.String	getImplementationName()

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

Mercator

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

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

id - an identifiable instance containing information about this projection

Mercator

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

Sets the id to EPSG:9804

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

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.

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.

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.