Class AuthalicMercator

All Implemented Interfaces:
Serializable, Parameterized, LenientComparable, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.MathTransform2D

final class AuthalicMercator extends AuthalicConversion
Spherical Mercator projection after conversion of geodetic latitudes to authalic latitudes. This is used for implementation of ESRI "Mercator Auxiliary Sphere type 3" projection.
Since:
1.2
Version:
1.3
  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      For cross-version compatibility.
      See Also:
    • TYPE

      static final int TYPE
      The type value for this map projection in ESRI Auxiliary sphere type parameter.
      See Also:
  • Constructor Details

    • AuthalicMercator

      AuthalicMercator(Mercator other)
      Creates a new normalized projection from the parameters computed by the given initializer.
      Parameters:
      other - the other projection from which to compute parameters.
  • Method Details

    • getDomain

      public Optional<org.opengis.geometry.Envelope> getDomain(DomainDefinition criteria)
      Returns the domain of input coordinates. This method is defined for consistency with Mercator.getDomain(DomainDefinition).
      Overrides:
      getDomain in 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:
    • transform

      public org.opengis.referencing.operation.Matrix transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, boolean derivate)
      Projects the specified (λ,φ) coordinates (units in radians) and stores the result in dstPts. In addition, opportunistically computes the projection derivative if derivate is true. The results must be multiplied by the denormalization matrix before to get linear distances.
      Specified by:
      transform in class NormalizedProjection
      Parameters:
      srcPts - the array containing the source point coordinates, as (longitude, latitude) angles in radians.
      srcOff - the offset of the single coordinate tuple to be converted in the source array.
      dstPts - the array into which the converted coordinates is returned (may be the same than srcPts). 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 coordinates 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.
      See Also:
    • transform

      public void transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws org.opengis.referencing.operation.TransformException
      Converts a list of coordinate tuples. This method performs the same calculation than above transform(double[], int, double[], int, boolean) method, but is overridden for efficiency.
      Specified by:
      transform in interface org.opengis.referencing.operation.MathTransform
      Overrides:
      transform in class AbstractMathTransform
      Parameters:
      srcPts - the array containing the source point coordinates.
      srcOff - the offset to the first point to be transformed in the source array.
      dstPts - the array into which the transformed point coordinates are returned. May be the same than srcPts.
      dstOff - the offset to the location of the first transformed point that is stored in the destination array.
      numPts - the number of point objects to be transformed.
      Throws:
      org.opengis.referencing.operation.TransformException - if a point cannot be converted.
    • inverseTransform

      protected void inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff) throws ProjectionException
      Converts the specified (x,y) coordinates and stores the result in dstPts (angles in radians).
      Specified by:
      inverseTransform in class NormalizedProjection
      Parameters:
      srcPts - the array containing the source point coordinates, 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 coordinates is returned (may be the same than srcPts). 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 point cannot be converted.