org.cts.op.projection

Class Projection

java.lang.Object

org.cts.IdentifiableComponent

org.cts.op.AbstractCoordinateOperation

org.cts.op.projection.Projection

All Implemented Interfaces:

Identifiable, CoordinateOperation

Direct Known Subclasses:

AlbersEqualArea, CassiniSoldner, CylindricalEqualArea, EquidistantCylindrical, GaussSchreiberTransverseMercator, Krovak, LambertAzimuthalEqualArea, LambertConicConformal1SP, LambertConicConformal2SP, Mercator1SP, MillerCylindrical, NewZealandMapGrid, ObliqueMercator, ObliqueStereographicAlternative, Polyconic, Stereographic, SwissObliqueMercator, TransverseMercator, UniversalTransverseMercator, UniversalTransverseMercatorAuto

public abstract class Projection
extends AbstractCoordinateOperation

A map projection is any method used in cartography (mapmaking) to represent the two-dimensional curved surface of the earth or other body on a plane. The term "projection" here refers to any function defined on the earth's surface and with values on the plane, and not necessarily a geometric projection.

Author:

Michaël Michaud, Erwan Bocher

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Projection.Orientation Projection orientation.
static class	Projection.Property Projection property.
static class	Projection.Surface Projection classification based on the surface type.

Field Summary

Fields

Modifier and Type	Field and Description
static Parameter[]	DEFAULT_PARAMETERS

Fields inherited from class org.cts.op.AbstractCoordinateOperation

precision

Fields inherited from interface org.cts.Identifiable

DEFAULT, LOCAL, UNKNOWN

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Projection(Identifier identifier, Ellipsoid ellipsoid, Map<String,Measure> parameters) Creates a new Projection

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o) Returns true if object is equals to this.
double	getAzimuth() Return the azimuth of the initial line of oblique projections.
double	getCentralMeridian() Return the central meridian used for this projection.
static ConcurrentHashMap<String,Measure>	getDefaultParameters()
double	getFalseEasting() Return the false easting of this projection.
double	getFalseNorthing() Return the false northing of this projection.
double	getLatitudeOfOrigin() Return the reference latitude used for this projection.
double	getLatitudeOfTrueScale() Return the latitude of true scale of secant projections.
abstract Projection.Orientation	getOrientation() Return the Orientation of this Projection.
abstract Projection.Property	getProperty() Return the Property of this Projection.
double	getRectifiedGridAngle() Return the angle from the rectified grid to the skew (oblique) grid of oblique projections.
double	getScaleFactor() Return the scale factor of this projection.
double	getSemiMajorAxis() Return the semi-major axis of the ellipsoid used for this projection (fr : demi grand axe).
double	getSemiMinorAxis() Return the semi-minor axis of the ellipsoid used for this projection (fr : demi petit axe).
double	getStandardParallel1() Return the the first standard parallel of secant conformal conic projections.
double	getStandardParallel2() Return the the second standard parallel of secant conformal conic projections.
abstract Projection.Surface	getSurface() Return the Surface type of this Projection.
int	hashCode() Returns the hash code for this Projection.
Projection	inverse() Creates the inverse CoordinateOperation.
boolean	isDirect() Return true for direct operation (projection) and false for the inverse operation.
String	toWKT(Unit unit) Returns a WKT representation of the projection.

Methods inherited from class org.cts.op.AbstractCoordinateOperation

getPrecision, isIdentity, transform

Methods inherited from class org.cts.IdentifiableComponent

addAlias, addRemark, getAliases, getAuthorityKey, getAuthorityName, getCode, getComponent, getIdentifier, getName, getRemarks, getShortName, setIdentifier, setRemarks, setShortName, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.cts.Identifiable

addAlias, addRemark, getAliases, getAuthorityKey, getAuthorityName, getCode, getName, getRemarks, getShortName, setRemarks, setShortName

Field Detail

DEFAULT_PARAMETERS

public static final Parameter[] DEFAULT_PARAMETERS

Constructor Detail

Projection

protected Projection(Identifier identifier,
                     Ellipsoid ellipsoid,
                     Map<String,Measure> parameters)

Creates a new Projection

Parameters:

identifier - identifier of the projection

ellipsoid - ellipsoid used for this projection

parameters - other projection parameters

Method Detail

getDefaultParameters

public static ConcurrentHashMap<String,Measure> getDefaultParameters()

getSemiMajorAxis

public double getSemiMajorAxis()

Return the semi-major axis of the ellipsoid used for this projection (fr : demi grand axe).

Returns:

getSemiMinorAxis

public double getSemiMinorAxis()

Return the semi-minor axis of the ellipsoid used for this projection (fr : demi petit axe).

Returns:

getCentralMeridian

public double getCentralMeridian()

Return the central meridian used for this projection.

Returns:

getLatitudeOfOrigin

public double getLatitudeOfOrigin()

Return the reference latitude used for this projection.

Returns:

getStandardParallel1

public double getStandardParallel1()

Return the the first standard parallel of secant conformal conic projections.

Returns:

getStandardParallel2

public double getStandardParallel2()

Return the the second standard parallel of secant conformal conic projections.

Returns:

getLatitudeOfTrueScale

public double getLatitudeOfTrueScale()

Return the latitude of true scale of secant projections.

Returns:

getAzimuth

public double getAzimuth()

Return the azimuth of the initial line of oblique projections.

Returns:

getRectifiedGridAngle

public double getRectifiedGridAngle()

Return the angle from the rectified grid to the skew (oblique) grid of oblique projections.

Returns:

getScaleFactor

public double getScaleFactor()

Return the scale factor of this projection.

Returns:

getFalseEasting

public double getFalseEasting()

Return the false easting of this projection.

Returns:

getFalseNorthing

public double getFalseNorthing()

Return the false northing of this projection.

Returns:

getSurface

public abstract Projection.Surface getSurface()

Return the Surface type of this Projection.

Returns:

getProperty

public abstract Projection.Property getProperty()

Return the Property of this Projection.

Returns:

getOrientation

public abstract Projection.Orientation getOrientation()

Return the Orientation of this Projection.

Returns:

inverse

public Projection inverse()
                   throws NonInvertibleOperationException

Description copied from class: AbstractCoordinateOperation

Creates the inverse CoordinateOperation. This method can be used to chain CoordinateOperations and/or inverse CoordinateOperation in a unique CoordinateOperationSequence. This method is not declared abstract, so that implementation classes have not to implement it if they represent non invertible operation.

Specified by:

inverse in interface CoordinateOperation

Overrides:

inverse in class AbstractCoordinateOperation

Throws:

NonInvertibleOperationException

isDirect

public boolean isDirect()

Return true for direct operation (projection) and false for the inverse operation.

Returns:

toWKT

public String toWKT(Unit unit)

Returns a WKT representation of the projection.

Returns:

equals

public boolean equals(Object o)

Returns true if object is equals to this. Tests equality between the references of both object, then tests if the string representation of these objects are equals.

Overrides:

equals in class IdentifiableComponent

Parameters:

o - The object to compare this ProjectedCRS against

Returns:

hashCode

public int hashCode()

Returns the hash code for this Projection.

Overrides:

hashCode in class IdentifiableComponent

Returns: