org.deegree.crs.projections.azimuthal
Class StereographicAzimuthal

java.lang.Object
  org.deegree.crs.CRSIdentifiable
      org.deegree.crs.projections.Projection
          org.deegree.crs.projections.azimuthal.AzimuthalProjection
              org.deegree.crs.projections.azimuthal.StereographicAzimuthal

public class StereographicAzimuthal
extends AzimuthalProjection

The StereographicAzimuthal class allows for Stereographic Projections of the Poles, equator as well as oblique. This projection has following properties (Snyder p. 154):

• Azimuthal
• Conformal
• The central meridian an a particular parallel (if shown) are straight lines.
• All meridians on the polar aspects and the equator on the equatorial aspect are straight lines.
• All other meidians and parallels are shown as arcs of circles
• A perspective projections for the sphere
• Directions from the center of the projection are true (except on ellipsoidal oblique and equatorial aspects)
• Scale increases away from the center of the projection
• Point opposite the center of the projection cannot be plotted
• Used for polar maps and miscellaneous special maps

Like Orthographic, the stereographic projection is a true perspective in its isSpherical() form. It is the only known true perspective projection of any kind that is also conformal. Its point of projection is on the the surface of the sphere at a point jus opposite the oint of tangency of the plane or the center point of the projection. Thus, if the north pole is the center of the map, the projection is from the south-pole.

It is known to be used by following epsg transformations:

• EPSG:28992

Version:

$Revision: 22637 $, $Date: 2010-02-19 11:34:11 +0100 (Fr, 19 Feb 2010) $

Author:

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

Field Summary

Fields inherited from class org.deegree.crs.projections.azimuthal.AzimuthalProjection

EQUATOR, NORTH_POLE, OBLIQUE, SOUTH_POLE

Constructor Summary

StereographicAzimuthal(double trueScaleLatitude, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units)
Create a StereographicAzimuthal which has a scale of 1 and a true scale latitude.

StereographicAzimuthal(double trueScaleLatitude, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, CRSIdentifiable id)
Create a StereographicAzimuthal which has a scale of 1 and a true scale latitude,

StereographicAzimuthal(double trueScaleLatitude, GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale)
Sets the id to "Snyder-StereoGraphic"

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

StereographicAzimuthal(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units)
Create a StereographicAzimuthal which is conformal, has a scale of 1 and a truescale latitude at pi*0.5.

StereographicAzimuthal(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, CRSIdentifiable id)
Create a StereographicAzimuthal which is conformal, has a scale of 1 and a truescale latitude at pi*0.5.

StereographicAzimuthal(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale)
Create a StereographicAzimuthal which has a true scale latitude at MapUtils.HALFPI.

StereographicAzimuthal(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, double scale, CRSIdentifiable id)
Create a StereographicAzimuthal which has a true scale latitude at MapUtils.HALFPI.

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.
String	getImplementationName()
double	getTrueScaleLatitude()

Methods inherited from class org.deegree.crs.projections.azimuthal.AzimuthalProjection

getMode, hashCode

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, isConformal, isEqualArea, isSpherical, setFalseEasting, setScale, toString

Methods inherited from class org.deegree.crs.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

StereographicAzimuthal

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

Parameters:

trueScaleLatitude - the latitude (in radians) of a circle around the projection point, which contains the true scale.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

id - an identifiable instance containing information about this projection

StereographicAzimuthal

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

Sets the id to "Snyder-StereoGraphic"

Parameters:

trueScaleLatitude - the latitude (in radians) of a circle around the projection point, which contains the true scale.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a true scale latitude at MapUtils.HALFPI.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

id - an identifiable instance containing information about this projection

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a true scale latitude at MapUtils.HALFPI. Sets the id to "Snyder-StereoGraphic"

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a scale of 1 and a true scale latitude,

Parameters:

trueScaleLatitude - the latitude (in radians) of a circle around the projection point, which contains the true scale.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

id - an identifiable instance containing information about this projection

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a scale of 1 and a true scale latitude. Sets the id to "Snyder-StereoGraphic".

Parameters:

trueScaleLatitude - the latitude (in radians) of a circle around the projection point, which contains the true scale.

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

StereographicAzimuthal

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

Create a StereographicAzimuthal which is conformal, has a scale of 1 and a truescale latitude at pi*0.5.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

id - an identifiable instance containing information about this projection

StereographicAzimuthal

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

Create a StereographicAzimuthal which is conformal, has a scale of 1 and a truescale latitude at pi*0.5. Sets the id to "Snyder-StereoGraphic".

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

Method Detail

doInverseProjection

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

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;

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

Specified by:

getImplementationName in class Projection

Returns:

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

getTrueScaleLatitude

public final double getTrueScaleLatitude()

Returns:

the trueScaleLatitude.

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.