org.deegree.crs.projections.azimuthal
Class StereographicAzimuthal

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

Author:

Rutger Bezema, last edited by: $Author:$

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, double scale, String identifier)

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

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

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

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

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

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

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

StereographicAzimuthal(GeographicCRS geographicCRS, double falseNorthing, double falseEasting, javax.vecmath.Point2d naturalOrigin, Unit units, String identifier)
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, String[] identifiers)
Create a StereographicAzimuthal which is conformal, has a scale of 1 and a truescale latitude at pi*0.5.

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

StereographicAzimuthal

public StereographicAzimuthal(double trueScaleLatitude,
                              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:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifiers -

names -

versions -

descriptions -

areasOfUse -

StereographicAzimuthal

public StereographicAzimuthal(double trueScaleLatitude,
                              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:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifier -

name -

version -

description -

areaOfUse -

StereographicAzimuthal

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

Parameters:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifiers -

StereographicAzimuthal

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

Parameters:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifier -

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a truescale latitude at MapUtils.HALFPI.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifiers -

StereographicAzimuthal

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

Create a StereographicAzimuthal which has a truescale latitude at MapUtils.HALFPI.

Parameters:

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

scale -

identifier -

StereographicAzimuthal

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

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

Parameters:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

identifiers -

StereographicAzimuthal

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

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

Parameters:

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

geographicCRS -

falseNorthing -

falseEasting -

naturalOrigin -

units -

identifier -

StereographicAzimuthal

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

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 -

identifiers -

StereographicAzimuthal

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

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 -

identifier -

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 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.

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

getDeegreeSpecificName

public String getDeegreeSpecificName()

Specified by:

getDeegreeSpecificName in class Projection

Returns:

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

getTrueScaleLatitude

public final double getTrueScaleLatitude()

Returns:

the trueScaleLatitude.