Class Polyconic
-
- All Implemented Interfaces:
Serializable
,Parameterized
,LenientComparable
,MathTransform
,MathTransform2D
public class Polyconic extends NormalizedProjection
American Polyconic projection (EPSG codes 9818). This projection has the following properties:- Neither conformal nor equal-area.
- Parallels of latitude (except for Equator) are arcs of circles, but are not concentrics.
- Central Meridian and Equator are straight lines; all other meridians are complex curves.
- Scale is true along each parallel and along the central meridian, but no parallel is "standard".
- Free of distortion only along the central meridian.
References:
- John P. Snyder (Map Projections - A Working Manual,
U.S. Geological Survey Professional Paper 1395, 1987) - "Coordinate Conversions and Transformations including Formulas",
EPSG Guidance Note Number 7.
- Since:
- 1.0
- See Also:
- Serialized Form
Defined in the
sis-referencing
module
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class NormalizedProjection
NormalizedProjection.ParameterRole
-
-
Field Summary
-
Fields inherited from class NormalizedProjection
eccentricity, eccentricitySquared
-
-
Constructor Summary
Constructors Constructor Description Polyconic(OperationMethod method, Parameters parameters)
Creates a Polyconic projection from the given parameters.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description MathTransform
createMapProjection(MathTransformFactory factory)
Returns the sequence of normalization →this
→ denormalization transforms as a whole.protected void
inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff)
Transforms the specified (x,y) coordinates and stores the result indstPts
(angles in radians).Matrix
transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate)
Converts the specified (λ,φ) coordinate (units in radians) and stores the result indstPts
(linear distance on a unit sphere).-
Methods inherited from class NormalizedProjection
computeHashCode, equals, getContextualParameters, getParameterDescriptors, getParameterValues, inverse, tryConcatenate
-
Methods inherited from class AbstractMathTransform2D
createTransformedShape, derivative, getSourceDimensions, getTargetDimensions, transform
-
Methods inherited from class AbstractMathTransform
derivative, equals, formatTo, hashCode, isIdentity, transform, transform, transform, transform, transform
-
Methods inherited from class FormattableObject
print, toString, toString, toWKT
-
Methods inherited from class Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface MathTransform
derivative, isIdentity, toWKT, transform, transform, transform, transform, transform
-
-
-
-
Constructor Detail
-
Polyconic
public Polyconic(OperationMethod method, Parameters parameters)
Creates a Polyconic projection from the given parameters. Themethod
argument can be the description of one of the following:- "American Polyconic".
- Parameters:
method
- description of the projection parameters.parameters
- the parameter values of the projection to create.
-
-
Method Detail
-
createMapProjection
public MathTransform createMapProjection(MathTransformFactory factory) throws FactoryException
Returns the sequence of normalization →this
→ denormalization transforms as a whole. The transform returned by this method expects (longitude, latitude) coordinates in degrees and returns (x,y) coordinates in metres.The non-linear part of the returned transform will be
this
transform, except if the ellipsoid is spherical. In the later case,this
transform will be replaced by a simplified implementation.- Overrides:
createMapProjection
in classNormalizedProjection
- Parameters:
factory
- the factory to use for creating the transform.- Returns:
- the map projection from (λ,φ) to (x,y) coordinates.
- Throws:
FactoryException
- if an error occurred while creating a transform.- See Also:
ContextualParameters.completeTransform(MathTransformFactory, MathTransform)
-
transform
public Matrix transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate) throws ProjectionException
Converts the specified (λ,φ) coordinate (units in radians) and stores the result indstPts
(linear distance on a unit sphere). In addition, opportunistically computes the projection derivative ifderivate
istrue
.- Specified by:
transform
in classNormalizedProjection
- Parameters:
srcPts
- the array containing the source point coordinate, as (longitude, latitude) angles in radians.srcOff
- the offset of the single coordinate to be converted in the source array.dstPts
- the array into which the converted coordinate is returned (may be the same thansrcPts
). Coordinates will be expressed in a dimensionless unit, as a linear distance on a unit sphere or ellipse.dstOff
- the offset of the location of the converted coordinate that is stored in the destination array.derivate
-true
for computing the derivative, orfalse
if not needed.- Returns:
- the matrix of the projection derivative at the given source position,
or
null
if thederivate
argument isfalse
. - Throws:
ProjectionException
- if the coordinates can not be converted.- See Also:
AbstractMathTransform.derivative(DirectPosition)
,AbstractMathTransform.transform(DirectPosition, DirectPosition)
,MathTransforms.derivativeAndTransform(MathTransform, double[], int, double[], int)
-
inverseTransform
protected void inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff) throws ProjectionException
Transforms the specified (x,y) coordinates and stores the result indstPts
(angles in radians).- Specified by:
inverseTransform
in classNormalizedProjection
- Parameters:
srcPts
- the array containing the source point coordinate, as linear distance on a unit sphere or ellipse.srcOff
- the offset of the point to be converted in the source array.dstPts
- the array into which the converted point coordinate is returned (may be the same thansrcPts
). Coordinates will be (longitude, latitude) angles in radians.dstOff
- the offset of the location of the converted point that is stored in the destination array.- Throws:
ProjectionException
- if the coordinates can not be converted.
-
-