org.geotoolkit.referencing.operation.provider.Orthographic 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) 2003-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.operation.PlanarProjection;
import org.opengis.referencing.ReferenceIdentifier;
import org.geotoolkit.resources.Vocabulary;
import org.geotoolkit.referencing.NamedIdentifier;
import org.geotoolkit.internal.referencing.Identifiers;
import org.geotoolkit.metadata.iso.citation.Citations;
/**
* The provider for "Orthographic" projection.
* The programmatic names and parameters are enumerated at
* Orthographic on
* RemoteSensing.org. The math transform implementations instantiated by this provider may
* be any of the following classes:
*
*
* - {@link org.geotoolkit.referencing.operation.projection.Orthographic}
*
*
* @author Rueben Schulz (UBC)
* @author Martin Desruisseaux (Geomatys)
* @version 3.00
*
* @since 2.1
* @module
*/
@Immutable
public class Orthographic extends MapProjection {
/**
* For compatibility with different versions during deserialization.
*/
private static final long serialVersionUID = 3180410512573499562L;
/**
* 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(
"central_meridian", // OGC
"Longitude_Of_Center", // ESRI
"Longitude of natural origin", // EPSG
"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_origin", // OGC
"Latitude_Of_Center", // ESRI
"Latitude of natural origin", // EPSG
"ProjCenterLat"); // GeoTIFF
/**
* The operation parameter descriptor for the {@linkplain
* org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#scaleFactor
* scale factor} parameter value.
*
* This parameter is optional because
* remotesensing.org does not list it. Valid values range is (0 …
* ∞) and default value is 1.
*/
public static final ParameterDescriptor SCALE_FACTOR =
Identifiers.SCALE_FACTOR.select(false,
"Scale factor at natural origin", // EPSG
"ScaleAtNatOrigin"); // 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, "Orthographic"),
new NamedIdentifier(Citations.ESRI, "Orthographic"),
new NamedIdentifier(Citations.EPSG, "Orthographic"),
new IdentifierCode (Citations.EPSG, 9840),
new NamedIdentifier(Citations.GEOTIFF, "CT_Orthographic"),
new IdentifierCode (Citations.GEOTIFF, 21),
new NamedIdentifier(Citations.GEOTOOLKIT, Vocabulary.formatInternational(
Vocabulary.Keys.ORTHOGRAPHIC_PROJECTION))
}, new ParameterDescriptor[] {
SEMI_MAJOR, SEMI_MINOR, ROLL_LONGITUDE,
LONGITUDE_OF_CENTRE, LATITUDE_OF_CENTRE,
SCALE_FACTOR, FALSE_EASTING, FALSE_NORTHING
});
/**
* Constructs a new provider.
*/
public Orthographic() {
super(PARAMETERS);
}
/**
* Returns the operation type for this map projection.
*/
@Override
public Class getOperationType() {
return PlanarProjection.class;
}
/**
* {@inheritDoc}
*/
@Override
protected MathTransform2D createMathTransform(ParameterValueGroup values) {
return org.geotoolkit.referencing.operation.projection.Orthographic.create(getParameters(), values);
}
}