org.geotools.referencing.operation.projection
Class Robinson

java.lang.Object
  extended by org.geotools.referencing.wkt.Formattable
      extended by org.geotools.referencing.operation.transform.AbstractMathTransform
          extended by org.geotools.referencing.operation.projection.MapProjection
              extended by org.geotools.referencing.operation.projection.Robinson
All Implemented Interfaces:
java.io.Serializable, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.MathTransform2D

public class Robinson
extends MapProjection

Robinson projection

Since:
2.6.3
Author:
Andrea Aime
See Also:
Robinson projection on Wikipedia, "Robinson" on RemoteSensing.org, Serialized Form

Nested Class Summary
static class Robinson.Provider
          The math transform provider for the Robinson projection (not part of the EPSG database).
 
Nested classes/interfaces inherited from class org.geotools.referencing.operation.projection.MapProjection
MapProjection.AbstractProvider
 
Field Summary
 
Fields inherited from class org.geotools.referencing.operation.projection.MapProjection
centralMeridian, en0, en1, en2, en3, en4, excentricity, excentricitySquared, falseEasting, falseNorthing, globalScale, isSpherical, latitudeOfOrigin, LOGGER, scaleFactor, semiMajor, semiMinor
 
Fields inherited from class org.geotools.referencing.wkt.Formattable
SINGLE_LINE
 
Constructor Summary
protected Robinson(org.opengis.parameter.ParameterValueGroup parameters)
          Constructs a new map projection from the supplied parameters.
 
Method Summary
 boolean equals(java.lang.Object object)
          Compares the specified object with this map projection for equality.
 org.opengis.parameter.ParameterDescriptorGroup getParameterDescriptors()
          Returns the parameter descriptors for this map projection.
protected  double getToleranceForAssertions(double longitude, double latitude)
          Maximal error (in metres) tolerated for assertions, if enabled.
protected  java.awt.geom.Point2D inverseTransformNormalized(double x, double y, java.awt.geom.Point2D ptDst)
          Transforms the specified (x,y) coordinates and stores the result in ptDst.
static void main(java.lang.String[] args)
           
protected  java.awt.geom.Point2D transformNormalized(double lam, double phi, java.awt.geom.Point2D ptDst)
          Transforms the specified (λ,φ) coordinates (units in radians) and stores the result in ptDst (linear distance on a unit sphere).
 
Methods inherited from class org.geotools.referencing.operation.projection.MapProjection
getParameterValues, getSourceDimensions, getTargetDimensions, hashCode, inv_mlfn, inverse, mlfn, resetWarnings, transform, transform, transform
 
Methods inherited from class org.geotools.referencing.operation.transform.AbstractMathTransform
createTransformedShape, derivative, derivative, ensureNonNull, formatWKT, getName, isIdentity, needCopy, rollLongitude, transform, transform, transform
 
Methods inherited from class org.geotools.referencing.wkt.Formattable
cleanupThreadLocals, toString, toWKT, toWKT, toWKT
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.opengis.referencing.operation.MathTransform2D
createTransformedShape, derivative
 
Methods inherited from interface org.opengis.referencing.operation.MathTransform
derivative, isIdentity, toWKT, transform, transform, transform
 

Constructor Detail

Robinson

protected Robinson(org.opengis.parameter.ParameterValueGroup parameters)
            throws org.opengis.parameter.ParameterNotFoundException
Constructs a new map projection from the supplied parameters.

Parameters:
parameters - The parameter values in standard units.
Throws:
org.opengis.parameter.ParameterNotFoundException - if a mandatory parameter is missing.
Method Detail

getParameterDescriptors

public org.opengis.parameter.ParameterDescriptorGroup getParameterDescriptors()
Returns the parameter descriptors for this map projection. This is used for a providing a default implementation of MapProjection.getParameterValues(), as well as arguments checking.

Specified by:
getParameterDescriptors in class MapProjection
Returns:
The parameter descriptors for this math transform, or null.
See Also:
OperationMethod.getParameters()

transformNormalized

protected java.awt.geom.Point2D transformNormalized(double lam,
                                                    double phi,
                                                    java.awt.geom.Point2D ptDst)
                                             throws ProjectionException
Transforms the specified (λ,φ) coordinates (units in radians) and stores the result in ptDst (linear distance on a unit sphere).

Specified by:
transformNormalized in class MapProjection
Parameters:
lam - The longitude of the coordinate, in radians.
phi - The latitude of the coordinate, in radians.
ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in a dimensionless unit, as a linear distance on a unit sphere or ellipse.
Returns:
the coordinate point after transforming (lambda, phi) and storing the result in ptDst.
Throws:
ProjectionException - if the point can't be transformed.

inverseTransformNormalized

protected java.awt.geom.Point2D inverseTransformNormalized(double x,
                                                           double y,
                                                           java.awt.geom.Point2D ptDst)
                                                    throws ProjectionException
Transforms the specified (x,y) coordinates and stores the result in ptDst.

Specified by:
inverseTransformNormalized in class MapProjection
Parameters:
x - The easting of the coordinate, linear distance on a unit sphere or ellipse.
y - The northing of the coordinate, linear distance on a unit sphere or ellipse.
ptDst - the specified coordinate point that stores the result of transforming ptSrc, or null. Ordinates will be in radians.
Returns:
the coordinate point after transforming x, y and storing the result in ptDst.
Throws:
ProjectionException - if the point can't be transformed.

equals

public boolean equals(java.lang.Object object)
Compares the specified object with this map projection for equality.

Overrides:
equals in class MapProjection
Parameters:
object - The object to compare with this transform.
Returns:
true if the given object is a transform of the same class and if, given identical source position, the transformed position would be the equals.

getToleranceForAssertions

protected double getToleranceForAssertions(double longitude,
                                           double latitude)
Description copied from class: MapProjection
Maximal error (in metres) tolerated for assertions, if enabled. When assertions are enabled, every direct projection is followed by an inverse projection, and the result is compared to the original coordinate. If a distance greater than the tolerance level is found, then an ProjectionException will be thrown. Subclasses should override this method if they need to relax the tolerance level.

Overrides:
getToleranceForAssertions in class MapProjection
Parameters:
longitude - The longitude in decimal degrees.
latitude - The latitude in decimal degrees.
Returns:
The tolerance level for assertions, in meters.

main

public static void main(java.lang.String[] args)


Copyright © 1996-2010 Geotools. All Rights Reserved.