org.geotoolkit.referencing.operation.provider.LambertAzimuthalEqualArea 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
Show all versions of geotk-referencing Show documentation
Implementations of Coordinate Reference Systems (CRS),
conversion and transformation services derived from ISO 19111.
/*
* Geotoolkit.org - An Open Source Java GIS Toolkit
* http://www.geotoolkit.org
*
* (C) 2006-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 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;
/**
* The provider for "Lambert Azimuthal Equal Area" projection (EPSG:9820, EPSG:1027).
*
* {@note EPSG defines two codes for this projection, 1027 being the spherical case and 9820 the
* ellipsoidal case. However the formulas are the same in both cases. Consequently they are
* implemented in Geotk by the same class.}
*
* The programmatic names and parameters are enumerated at
* Lambert
* Azimuthal Equal Area on RemoteSensing.org. The math transform implementations instantiated by
* this provider may be any of the following classes:
*
*
* - {@link org.geotoolkit.referencing.operation.projection.LambertAzimuthalEqualArea}
*
*
* @author Beate Stollberg
* @author Martin Desruisseaux (Geomatys)
* @version 3.16
*
* @since 2.4
* @module
*/
@Immutable
public class LambertAzimuthalEqualArea extends MapProjection {
/**
* For cross-version compatibility.
*/
private static final long serialVersionUID = 3877793025552244132L;
/**
* 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 0°.
*/
public static final ParameterDescriptor LONGITUDE_OF_CENTRE =
Identifiers.CENTRAL_MERIDIAN.select(
"longitude_of_center", // OGC
"Longitude of natural origin", // EPSG
"Central_Meridian", // ESRI
"ProjCenterLong"); // 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 0°.
*/
public static final ParameterDescriptor LATITUDE_OF_CENTRE =
Identifiers.LATITUDE_OF_ORIGIN.select(
"latitude_of_center", // OGC
"Latitude_Of_Origin", // ESRI
"Latitude of natural origin", // EPSG
"ProjCenterLat"); // GeoTIFF
/**
* The operation parameter descriptor for the {@linkplain
* org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseEasting
* false easting} parameter value.
*
* This parameter is mandatory.
* Valid values range is unrestricted and default value is 0 metre.
*/
public static final ParameterDescriptor FALSE_EASTING = Mercator1SP.FALSE_EASTING;
/**
* The operation parameter descriptor for the {@linkplain
* org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseNorthing
* false northing} parameter value.
*
* This parameter is mandatory.
* Valid values range is unrestricted and default value is 0 metre.
*/
public static final ParameterDescriptor FALSE_NORTHING = Mercator1SP.FALSE_NORTHING;
/**
* The parameters group.
*/
public static final ParameterDescriptorGroup PARAMETERS = Identifiers.createDescriptorGroup(
new ReferenceIdentifier[] {
new NamedIdentifier(Citations.OGC, "Lambert_Azimuthal_Equal_Area"),
new NamedIdentifier(Citations.EPSG, "Lambert Azimuthal Equal Area"),
new NamedIdentifier(Citations.EPSG, "Lambert Azimuthal Equal Area (Spherical)"),
new IdentifierCode (Citations.EPSG, 9820),
new IdentifierCode (Citations.EPSG, 1027),
new NamedIdentifier(Citations.GEOTIFF, "CT_LambertAzimEqualArea"),
new IdentifierCode (Citations.GEOTIFF, 10),
}, new ParameterDescriptor[] {
SEMI_MAJOR, SEMI_MINOR, ROLL_LONGITUDE,
LATITUDE_OF_CENTRE, LONGITUDE_OF_CENTRE,
FALSE_EASTING, FALSE_NORTHING
});
/**
* Constructs a new provider.
*/
public LambertAzimuthalEqualArea() {
super(PARAMETERS);
}
/**
* Constructs a new provider for the given parameters.
*/
LambertAzimuthalEqualArea(ParameterDescriptorGroup parameters) {
super(parameters);
}
/**
* {@inheritDoc}
*/
@Override
protected MathTransform2D createMathTransform(ParameterValueGroup values) {
return org.geotoolkit.referencing.operation.projection.LambertAzimuthalEqualArea.create(getParameters(), values);
}
/**
* The provider for "Lambert Azimuthal Equal Area (Spherical)" projection
* (EPSG:9821). This provider is declared explicitly only because EPSG uses a distinct
* code with different parameter names for this case.
*
* {@note This projection method is deprecated by EPSG. It has been replaced
* by EPSG:1027, which use the same parameter names than the ellipsoidal case.}
*
* @author Beate Stollberg
* @author Martin Desruisseaux (Geomatys)
* @version 3.16
*
* @since 3.00
* @module
*/
@Immutable
public static class Spherical extends LambertAzimuthalEqualArea {
/**
* For cross-version compatibility.
*/
private static final long serialVersionUID = -6583175996290305778L;
/**
* 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 0°.
*/
@SuppressWarnings("hiding")
public static final ParameterDescriptor LONGITUDE_OF_CENTRE =
Identifiers.CENTRAL_MERIDIAN.select(
"longitude_of_center", // OGC
"Spherical longitude of origin", // EPSG
"Central_Meridian", // ESRI
"ProjCenterLong"); // 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 0°.
*/
@SuppressWarnings("hiding")
public static final ParameterDescriptor LATITUDE_OF_CENTRE =
Identifiers.LATITUDE_OF_ORIGIN.select(
"latitude_of_center", // OGC
"Latitude_Of_Origin", // ESRI
"Spherical latitude of origin", // EPSG
"ProjCenterLat"); // GeoTIFF
/**
* The parameters group.
*/
public static final ParameterDescriptorGroup PARAMETERS = Identifiers.createDescriptorGroup(
new ReferenceIdentifier[] {
new DeprecatedName(Citations.EPSG, "Lambert Azimuthal Equal Area (Spherical)"),
new IdentifierCode(Citations.EPSG, 9821, 1027),
}, new ParameterDescriptor[] {
SEMI_MAJOR, SEMI_MINOR, ROLL_LONGITUDE,
LATITUDE_OF_CENTRE, LONGITUDE_OF_CENTRE,
FALSE_EASTING, FALSE_NORTHING
});
/**
* Constructs a new provider.
*/
public Spherical() {
super(PARAMETERS);
}
}
}