org.geotoolkit.referencing.operation.provider.NewZealandMapGrid Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of geotk-referencing Show documentation
Implementations of Coordinate Reference Systems (CRS), conversion and transformation services derived from ISO 19111.
There is a newer version: 3.20-geoapi-3.0
/*
 *    Geotoolkit.org - An Open Source Java GIS Toolkit
 *    http://www.geotoolkit.org
 *
 *    (C) 2005-2011, Open Source Geospatial Foundation (OSGeo)
 *    (C) 2009-2011, Geomatys
 *
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License as published by the Free Software Foundation;
 *    version 2.1 of the License.
 *
 *    This library is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *    Lesser General Public License for more details.
 */
package org.geotoolkit.referencing.operation.provider;

import javax.measure.unit.SI;
import net.jcip.annotations.Immutable;

import org.opengis.parameter.ParameterValueGroup;
import org.opengis.parameter.ParameterDescriptor;
import org.opengis.parameter.ParameterDescriptorGroup;
import org.opengis.referencing.operation.MathTransform2D;
import org.opengis.referencing.ReferenceIdentifier;

import org.geotoolkit.referencing.NamedIdentifier;
import org.geotoolkit.internal.referencing.Identifiers;
import org.geotoolkit.metadata.iso.citation.Citations;
import static org.geotoolkit.internal.referencing.Identifiers.createDescriptor;


/**
 * The provider for "New Zealand Map Grid" (EPSG:9811).
 * The programmatic names and parameters are enumerated at
 * New Zealand
 * Map Grid on RemoteSensing.org. The math transform implementations instantiated by this
 * provider may be any of the following classes:
 * 
 * 

 *   {@link org.geotoolkit.referencing.operation.projection.NewZealandMapGrid}
 * 
 * 
 * This projection is used with the International 1924 ellipsoid.
 *
 * @author Justin Deoliveira (Refractions)
 * @author Martin Desruisseaux (IRD, Geomatys)
 * @version 3.00
 *
 * @since 2.2
 * @module
 */
@Immutable
public class NewZealandMapGrid extends MapProjection {
    /**
     * For compatibility with different versions during deserialization.
     */
    private static final long serialVersionUID = -7716733400419275656L;

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#semiMajor
     * semi major} parameter value.
     *
     * This parameter is mandatory.
     * Valid values range is (0 … ∞) and default value is 6378388 metres.
     */
    @SuppressWarnings("hiding")
    public static final ParameterDescriptor SEMI_MAJOR = createDescriptor(
            new NamedIdentifier[] {
                sameNameAs(Citations.OGC,  MapProjection.SEMI_MAJOR),
                sameNameAs(Citations.EPSG, MapProjection.SEMI_MAJOR)
            },
            6378388.0, 0.0, Double.POSITIVE_INFINITY, SI.METRE);

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#semiMinor
     * semi minor} parameter value.
     *
     * This parameter is mandatory.
     * Valid values range is (0 … ∞) and default value is approximatively
     * 6356911.95 metres.
     */
    @SuppressWarnings("hiding")
    public static final ParameterDescriptor SEMI_MINOR = createDescriptor(
            new NamedIdentifier[] {
                sameNameAs(Citations.OGC,  MapProjection.SEMI_MINOR),
                sameNameAs(Citations.EPSG, MapProjection.SEMI_MINOR)
            },
            6378388.0*(1-1/297.0), 0.0, Double.POSITIVE_INFINITY, SI.METRE);

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#centralMeridian
     * central meridian} parameter value.
     *
     * This parameter is mandatory.
     * Valid values range is [-180 … 180]° and default value is 173°.
     */
    public static final ParameterDescriptor CENTRAL_MERIDIAN =
            Identifiers.CENTRAL_MERIDIAN.select(true, 173,
                "central_meridian",             // OGC
                "Longitude_Of_Origin",          // ESRI
                "Longitude of natural origin",  // EPSG
                "NatOriginLong");               // GeoTIFF

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#latitudeOfOrigin
     * latitude of origin} parameter value.
     *
     * This parameter is mandatory.
     * Valid values range is [-90 … 90]° and default value is -41°.
     */
    public static final ParameterDescriptor LATITUDE_OF_ORIGIN =
            Identifiers.LATITUDE_OF_ORIGIN.select(true, -41,
                "latitude_of_origin",           // OGC
                "Latitude_Of_Origin",           // ESRI
                "Latitude of natural origin",   // EPSG
                "NatOriginLat");                // GeoTIFF

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseEasting
     * false easting} parameter value. Valid values range is unrestricted.
     *
     * This parameter is mandatory.
     * Valid values range is unrestricted and default value is 2510000 metre.
     */
    public static final ParameterDescriptor FALSE_EASTING =
            Identifiers.FALSE_EASTING.select(true, 2510000,
                "False easting",    // EPSG
                "FalseEasting");    // GeoTIFF

    /**
     * The operation parameter descriptor for the {@linkplain
     * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseNorthing
     * false northing} parameter value. Valid values range is unrestricted.
     *
     * This parameter is mandatory.
     * Valid values range is unrestricted and default value is 6023150 metre.
     */
    public static final ParameterDescriptor FALSE_NORTHING =
            Identifiers.FALSE_NORTHING.select(true, 6023150,
                "False northing",   // EPSG
                "FalseNorthing");   // GeoTIFF

    /**
     * The parameters group.
     */
    public static final ParameterDescriptorGroup PARAMETERS = Identifiers.createDescriptorGroup(
        new ReferenceIdentifier[] {
            new NamedIdentifier(Citations.OGC,     "New_Zealand_Map_Grid"),
            new NamedIdentifier(Citations.EPSG,    "New Zealand Map Grid"),
            new IdentifierCode (Citations.EPSG,     9811),
            new NamedIdentifier(Citations.GEOTIFF, "CT_NewZealandMapGrid"),
            new IdentifierCode (Citations.GEOTIFF,  26)
        }, new ParameterDescriptor[] {
            SEMI_MAJOR, SEMI_MINOR, ROLL_LONGITUDE,
            LATITUDE_OF_ORIGIN, CENTRAL_MERIDIAN,
            FALSE_EASTING, FALSE_NORTHING
        });

    /**
     * Constructs a new provider.
     */
    public NewZealandMapGrid() {
        super(PARAMETERS);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    protected MathTransform2D createMathTransform(ParameterValueGroup values) {
        return org.geotoolkit.referencing.operation.projection.NewZealandMapGrid.create(getParameters(), values);
    }
}