Class ZonedGridSystem
Object
FormattableObject
AbstractMathTransform
AbstractMathTransform2D
ZonedGridSystem
- All Implemented Interfaces:
- Serializable,- Parameterized,- LenientComparable,- MathTransform,- MathTransform2D
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 be 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:
Defined in the sis-referencing module
- 
Field SummaryFields inherited from class AbstractMathTransform2DDIMENSION
- 
Constructor SummaryConstructorsConstructorDescriptionZonedGridSystem(OperationMethod method, Parameters parameters, MathTransformFactory factory) Creates a Zoned Grid System from the given parameters.
- 
Method SummaryModifier and TypeMethodDescriptionprotected intComputes a hash code value for thisZonedGridSystem.booleanequals(Object object, ComparisonMode mode) Compares the given object with this transform for equivalence.getDomain(DomainDefinition criteria) Returns the domain of input coordinates.Returns the parameter values of this zoned grid system projection.inverse()Returns the inverse of this map projection.transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate) Projects the specified (λ,φ) coordinates and stores the result indstPts.Methods inherited from class AbstractMathTransform2DcreateTransformedShape, derivative, getSourceDimensions, getTargetDimensions, transformMethods inherited from class AbstractMathTransformderivative, equals, formatTo, getContextualParameters, getParameterDescriptors, hashCode, isIdentity, transform, transform, transform, transform, transform, tryConcatenateMethods inherited from class FormattableObjectprint, toString, toString, toWKTMethods inherited from class Objectclone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface MathTransformderivative, isIdentity, toWKT, transform, transform, transform, transform, transform
- 
Constructor Details- 
ZonedGridSystempublic ZonedGridSystem(OperationMethod method, Parameters parameters, MathTransformFactory factory) throws FactoryException Creates a Zoned Grid System from the given parameters. Themethodargument can be the description of one of the following:- "Transverse Mercator Zoned Grid System".
 createMapProjection(MathTransformFactory)method in this class. Instead, the factory must be specified at thisZonedGridSystemconstruction 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:
- FactoryException- if an error occurred while creating a transform.
 
 
- 
- 
Method Details- 
getParameterValuesReturns the parameter values of this zoned grid system projection.- Specified by:
- getParameterValuesin interface- Parameterized
- Overrides:
- getParameterValuesin class- AbstractMathTransform
- Returns:
- the internal parameter values for this zoned grid system projection.
- See Also:
 
- 
getDomainReturns the domain of input coordinates. The limits defined by this method are arbitrary and may change in any future implementation. Current implementation sets a longitude range of ±180° (i.e. the world) and a latitude range from 84°S to 84°N.- Overrides:
- getDomainin class- AbstractMathTransform
- Parameters:
- criteria- controls the definition of transform domain.
- Returns:
- estimation of a domain where this transform is considered numerically applicable.
- Since:
- 1.3
- See Also:
 
- 
transformpublic Matrix transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate) throws TransformException Projects the specified (λ,φ) coordinates and stores the result indstPts. In addition, opportunistically computes the projection derivative ifderivateistrue. Note that the derivative does not contain zone prefix.- Specified by:
- transformin class- AbstractMathTransform
- Parameters:
- srcPts- the array containing the source coordinates (cannot be- null).
- srcOff- the offset to the point to be transformed in the source array.
- dstPts- the array into which the transformed coordinates is returned. May be the same than- srcPts. May be- nullif only the derivative matrix is desired.
- dstOff- the offset to the location of the transformed point that is stored in the destination array.
- derivate-- truefor computing the derivative, or- falseif not needed.
- Returns:
- the matrix of the projection derivative at the given source position,
         or nullif thederivateargument isfalse.
- Throws:
- TransformException- if the coordinates cannot be converted.
- See Also:
 
- 
inverseReturns the inverse of this map projection.- Specified by:
- inversein interface- MathTransform
- Specified by:
- inversein interface- MathTransform2D
- Overrides:
- inversein class- AbstractMathTransform2D
- Returns:
- the inverse of this map projection.
 
- 
computeHashCodeprotected int computeHashCode()Computes a hash code value for thisZonedGridSystem.- Overrides:
- computeHashCodein class- AbstractMathTransform
- Returns:
- the hash code value.
 
- 
equalsCompares the given object with this transform for equivalence. If this method returnstrue, then for any given identical source position, the two compared map projections shall compute the same target position.- Specified by:
- equalsin interface- LenientComparable
- Overrides:
- equalsin class- AbstractMathTransform
- Parameters:
- object- the object to compare with this map projection for equivalence.
- mode- the strictness level of the comparison. Default to- ComparisonMode.STRICT.
- Returns:
- trueif the given object is equivalent to this map projection.
- See Also:
 
 
-