org.apache.sis.referencing.operation.projection

Class ZonedGridSystem

Object

FormattableObject

AbstractMathTransform

AbstractMathTransform2D

ZonedGridSystem

All Implemented Interfaces:

Serializable, Parameterized, LenientComparable, MathTransform, MathTransform2D

public class ZonedGridSystem
extends AbstractMathTransform2D
implements Serializable

Transverse Mercator Zoned Grid System projection (EPSG codes 9824). This projection is valid for all the world in a given hemisphere, except the poles. The Earth is divided into zones, usually 6° width. The zone number is determined automatically from the longitude and is prefixed to the Easting value.

This map projection is not suitable for geometric calculations like distances and angles, since there is discontinuities (gaps) between zones. Actually this operation is not handled as a map projection by Apache SIS, as can been seen from the different class hierarchy.

Note: current implementation can only be backed by the Transverse Mercator projection, but future versions could apply to some other projections if needed.

Examples of CRS using this projection are WGS 84 / UTM grid system EPSG:32600 (northern hemisphere) and EPSG:32700 (southern hemisphere).

Since:

0.8

See Also:

Serialized Form

Defined in the sis-referencing module

Constructor Summary

Constructors

Constructor and Description
ZonedGridSystem(OperationMethod method, Parameters parameters, MathTransformFactory factory) Creates a Zoned Grid System from the given parameters.

Method Summary

Methods

Modifier and Type	Method and Description
protected int	computeHashCode() Computes a hash code value for this Zoned­Grid­System.
boolean	equals(Object object, ComparisonMode mode) Compares the given object with this transform for equivalence.
ParameterValueGroup	getParameterValues() Returns the parameter values of this zoned grid system projection.
MathTransform2D	inverse() Returns the inverse of this map projection.
Matrix	transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate) Converts the specified (λ,φ) coordinate and stores the result in dst­Pts.

Methods inherited from class AbstractMathTransform2D

create­Transformed­Shape, derivative, get­Source­Dimensions, get­Target­Dimensions, transform

Methods inherited from class AbstractMathTransform

derivative, equals, format­To, get­Contextual­Parameters, get­Parameter­Descriptors, hash­Code, is­Identity, transform, transform, transform, transform, transform, try­Concatenate

Methods inherited from class FormattableObject

print, to­String, to­String, to­WKT

Methods inherited from class Object

clone, finalize, get­Class, notify, notify­All, wait, wait, wait

Methods inherited from interface MathTransform

derivative, is­Identity, to­WKT, transform, transform, transform, transform, transform

Constructor Detail

ZonedGridSystem

public ZonedGridSystem(OperationMethod method,
               Parameters parameters,
               MathTransformFactory factory)
                throws FactoryException

Creates a Zoned Grid System from the given parameters. The method argument can be the description of one of the following:

• "Transverse Mercator Zoned Grid System".

Contrarily to other map projections in this package, there is no create­Map­Projection(Math­Transform­Factory) method in this class. Instead, the factory must be specified at this Zoned­Grid­System construction time.

Parameters:

method - description of the projection parameters.

parameters - the parameter values of the projection to create.

factory - the factory to use for creating the transform.

Throws:

Factory­Exception - if an error occurred while creating a transform.

Method Detail

getParameterValues

public ParameterValueGroup getParameterValues()

Returns the parameter values of this zoned grid system projection.

Specified by:

get­Parameter­Values in interface Parameterized

Overrides:

get­Parameter­Values in class Abstract­Math­Transform

Returns:

the internal parameter values for this zoned grid system projection.

See Also:

Abstract­Math­Transform.get­Contextual­Parameters(), Abstract­Single­Operation.get­Parameter­Values()

transform

public Matrix transform(double[] srcPts,
               int srcOff,
               double[] dstPts,
               int dstOff,
               boolean derivate)
                 throws TransformException

Converts the specified (λ,φ) coordinate and stores the result in dst­Pts. In addition, opportunistically computes the projection derivative if derivate is true. Note that the derivative does not contain zone prefix.

Specified by:

transform in class Abstract­Math­Transform

Parameters:

src­Pts - the array containing the source coordinate (can not be null).

src­Off - the offset to the point to be transformed in the source array.

dst­Pts - the array into which the transformed coordinate is returned. May be the same than src­Pts. May be null if only the derivative matrix is desired.

dst­Off - the offset to the location of the transformed point that is stored in the destination array.

derivate - true for computing the derivative, or false if not needed.

Returns:

the matrix of the projection derivative at the given source position, or null if the derivate argument is false.

Throws:

Transform­Exception - if the coordinate can not be converted.

See Also:

Abstract­Math­Transform.derivative(Direct­Position), Abstract­Math­Transform.transform(Direct­Position, Direct­Position), Math­Transforms.derivative­And­Transform(Math­Transform, double[], int, double[], int)

inverse

public MathTransform2D inverse()

Returns the inverse of this map projection.

Specified by:

inverse in interface Math­Transform

Specified by:

inverse in interface Math­Transform2D

Overrides:

inverse in class Abstract­Math­Transform2D

Returns:

the inverse of this map projection.

computeHashCode

protected int computeHashCode()

Computes a hash code value for this Zoned­Grid­System.

Overrides:

compute­Hash­Code in class Abstract­Math­Transform

Returns:

the hash code value.

equals

public boolean equals(Object object,
             ComparisonMode mode)

Compares the given object with this transform for equivalence. If this method returns true, then for any given identical source position, the two compared map projections shall compute the same target position.

Specified by:

equals in interface Lenient­Comparable

Overrides:

equals in class Abstract­Math­Transform

Parameters:

object - the object to compare with this map projection for equivalence.

mode - the strictness level of the comparison. Default to Comparison­Mode.STRICT.

Returns:

true if the given object is equivalent to this map projection.