All Downloads are FREE. Search and download functionalities are using the official Maven repository.

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

/*
 *    Geotoolkit.org - An Open Source Java GIS Toolkit
 *    http://www.geotoolkit.org
 *
 *    (C) 1999-2012, Open Source Geospatial Foundation (OSGeo)
 *    (C) 2009-2012, 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.metadata.citation.Citation;
import org.opengis.parameter.ParameterValueGroup;
import org.opengis.parameter.ParameterDescriptor;
import org.opengis.parameter.ParameterDescriptorGroup;
import org.opengis.referencing.ReferenceIdentifier;
import org.opengis.referencing.operation.MathTransform2D;
import org.opengis.referencing.operation.CylindricalProjection;

import org.geotoolkit.resources.Vocabulary;
import org.geotoolkit.referencing.NamedIdentifier;
import org.geotoolkit.metadata.iso.citation.Citations;


/**
 * The provider for "Transverse Mercator" projection (EPSG:9807).
 * The math transform implementations instantiated by this provider may be any of the following classes:
 * 

*

    *
  • {@link org.geotoolkit.referencing.operation.projection.TransverseMercator}
  • *
* * *

The following table summarizes the parameters recognized by this provider. * For a more detailed parameter list, see the {@link #PARAMETERS} constant.

*

Operation name: {@code Transverse_Mercator} *
Area of use: (union of CRS domains of validity in EPSG database)

*
* * *
in latitudes:80°00.0′Sto84°00.0′N
in longitudes:180°00.0′Wto180°00.0′E
* * * * * * * * * * *
Parameter nameDefault value
{@code semi_major}
{@code semi_minor}
{@code roll_longitude}false
{@code central_meridian}
{@code latitude_of_origin}
{@code scale_factor}1
{@code false_easting}0 metres
{@code false_northing}0 metres
* * * @author Martin Desruisseaux (MPO, IRD, Geomatys) * @author Rueben Schulz (UBC) * @version 3.20 * * @see Transverse Mercator on RemoteSensing.org * @see Geotk coordinate operations matrix * * @since 2.1 * @module */ @Immutable public class TransverseMercator extends MapProjection { /** * For cross-version compatibility. */ private static final long serialVersionUID = -3386587506686432398L; /** * 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°. * * @deprecated Invoke {@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)} instead. */ @Deprecated public static final ParameterDescriptor CENTRAL_MERIDIAN = UniversalParameters.CENTRAL_MERIDIAN.select(null, "Longitude of natural origin", // EPSG "central_meridian", // OGC "Central_Meridian", // ESRI "longitude_of_central_meridian", // NetCDF "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 0°. * * @deprecated Invoke {@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)} instead. */ @Deprecated public static final ParameterDescriptor LATITUDE_OF_ORIGIN = Mercator2SP.LATITUDE_OF_ORIGIN; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#scaleFactor * scale factor} parameter value. * * This parameter is mandatory. * Valid values range is (0 … ∞) and default value is 1. * * @deprecated Invoke {@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)} instead. */ @Deprecated public static final ParameterDescriptor SCALE_FACTOR = UniversalParameters.SCALE_FACTOR.select(null, "Scale factor at natural origin", // EPSG "scale_factor_at_central_meridian", // NetCDF "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. * * @deprecated Invoke {@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)} instead. */ @Deprecated public static final ParameterDescriptor FALSE_EASTING = Mercator2SP.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. * * @deprecated Invoke {@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)} instead. */ @Deprecated public static final ParameterDescriptor FALSE_NORTHING = Mercator2SP.FALSE_NORTHING; /** * The group of all parameters expected by this coordinate operation. * The following table lists the operation names and the parameters recognized by Geotk: *

* *

* * * * * * * * * *
* * * * * * * * * * * * * * *
Name:OGC:Transverse_Mercator
Alias:EPSG:Transverse Mercator
EPSG:Gauss-Kruger
EPSG:Gauss-Boaga
EPSG:TM
ESRI:Transverse_Mercator
ESRI:Gauss_Kruger
NetCDF:TransverseMercator
GeoTIFF:CT_TransverseMercator
PROJ4:tmerc
Geotk:Transverse Mercator projection
Identifier:EPSG:9807
GeoTIFF:1
*
* * * * * * * *
Name:OGC:semi_major
Alias:EPSG:Semi-major axis
ESRI:Semi_Major
NetCDF:semi_major_axis
GeoTIFF:SemiMajor
PROJ4:a
*
* * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞) metres
*
* * * * * * * *
Name:OGC:semi_minor
Alias:EPSG:Semi-minor axis
ESRI:Semi_Minor
NetCDF:semi_minor_axis
GeoTIFF:SemiMinor
PROJ4:b
*
* * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞) metres
*
* * *
Name:Geotk:roll_longitude
*
* * * * *
Type:{@code Boolean}
Obligation:optional
Default value:false
*
* * * * * * * *
Name:OGC:central_meridian
Alias:EPSG:Longitude of natural origin
ESRI:Central_Meridian
NetCDF:longitude_of_central_meridian
GeoTIFF:NatOriginLong
PROJ4:lon_0
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[-180 … 180]°
Default value:
*
* * * * * * * *
Name:OGC:latitude_of_origin
Alias:EPSG:Latitude of natural origin
ESRI:Latitude_Of_Origin
NetCDF:latitude_of_projection_origin
GeoTIFF:NatOriginLat
PROJ4:lat_0
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[-90 … 90]°
Default value:
*
* * * * * * * *
Name:OGC:scale_factor
Alias:EPSG:Scale factor at natural origin
ESRI:Scale_Factor
NetCDF:scale_factor_at_central_meridian
GeoTIFF:ScaleAtNatOrigin
PROJ4:k
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞)
Default value:1
*
* * * * * * * *
Name:OGC:false_easting
Alias:EPSG:False easting
ESRI:False_Easting
NetCDF:false_easting
GeoTIFF:FalseEasting
PROJ4:x_0
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:(-∞ … ∞) metres
Default value:0 metres
*
* * * * * * * *
Name:OGC:false_northing
Alias:EPSG:False northing
ESRI:False_Northing
NetCDF:false_northing
GeoTIFF:FalseNorthing
PROJ4:y_0
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:(-∞ … ∞) metres
Default value:0 metres
*
*/ public static final ParameterDescriptorGroup PARAMETERS = UniversalParameters.createDescriptorGroup( new ReferenceIdentifier[] { new NamedIdentifier(Citations.OGC, "Transverse_Mercator"), new NamedIdentifier(Citations.EPSG, "Transverse Mercator"), new NamedIdentifier(Citations.EPSG, "Gauss-Kruger"), new NamedIdentifier(Citations.EPSG, "Gauss-Boaga"), new NamedIdentifier(Citations.EPSG, "TM"), new IdentifierCode (Citations.EPSG, 9807), new NamedIdentifier(Citations.ESRI, "Transverse_Mercator"), new NamedIdentifier(Citations.ESRI, "Gauss_Kruger"), new NamedIdentifier(Citations.NETCDF, "TransverseMercator"), new NamedIdentifier(Citations.GEOTIFF, "CT_TransverseMercator"), new IdentifierCode (Citations.GEOTIFF, 1), new NamedIdentifier(Citations.PROJ4, "tmerc"), new NamedIdentifier(Citations.GEOTOOLKIT, Vocabulary.formatInternational( Vocabulary.Keys.TRANSVERSE_MERCATOR_PROJECTION)), }, null, new ParameterDescriptor[] { SEMI_MAJOR, SEMI_MINOR, ROLL_LONGITUDE, CENTRAL_MERIDIAN, LATITUDE_OF_ORIGIN, SCALE_FACTOR, FALSE_EASTING, FALSE_NORTHING }, MapProjectionDescriptor.ADD_EARTH_RADIUS); /** * Constructs a new provider. */ public TransverseMercator() { super(PARAMETERS); } /** * Constructs a new provider with the specified parameters. */ TransverseMercator(final ParameterDescriptorGroup descriptor) { super(descriptor); } /** * Returns the operation type for this map projection. */ @Override public Class getOperationType() { return CylindricalProjection.class; } /** * {@inheritDoc} */ @Override protected MathTransform2D createMathTransform(ParameterValueGroup values) { return org.geotoolkit.referencing.operation.projection.TransverseMercator.create(getParameters(), values); } /** * The provider for Mercator Transverse (South Orientated) projection * (EPSG:9808). The coordinate axes are called Westings and Southings * and increment to the West and South from the origin respectively. *

* The terms false easting (FE) and false northing (FN) increase * the Westing and Southing value at the natural origin. In other words they are effectively * false westing (FW) and false southing (FS) respectively. * * *

The following table summarizes the parameters recognized by this provider. * For a more detailed parameter list, see the {@link #PARAMETERS} constant.

*

Operation name: {@code Transverse Mercator (South Orientated)} *
Area of use: (union of CRS domains of validity in EPSG database)

*
* * *
in latitudes:34°51.0′Sto16°59.4′S
in longitudes:11°36.0′Eto32°54.0′E
* * * * * * * * * * *
Parameter nameDefault value
{@code semi_major}
{@code semi_minor}
{@code roll_longitude}false
{@code central_meridian}
{@code latitude_of_origin}
{@code scale_factor}1
{@code false_easting}0 metres
{@code false_northing}0 metres
* * * @author Martin Desruisseaux (MPO, IRD, Geomatys) * @version 3.20 * * @see org.geotoolkit.referencing.operation.projection.TransverseMercator * @see Geotk coordinate operations matrix * * @since 2.2 * @module */ @Immutable public static class SouthOrientated extends TransverseMercator { /** * For cross-version compatibility. */ private static final long serialVersionUID = -5938929136350638347L; /** * The group of all parameters expected by this coordinate operation. * The following table lists the operation names and the parameters recognized by Geotk. * Note that the terms false easting (FE) and false northing (FN) * increase the Westing and Southing value at the natural origin. In other words they are * effectively false westing (FW) and false southing (FS) respectively. *

* *

* * * * * * * * * *
* * * * *
Name:EPSG:Transverse Mercator (South Orientated)
Alias:Geotk:Transverse Mercator projection
Identifier:EPSG:9808
*
* * * *
Name:OGC:semi_major
Alias:EPSG:Semi-major axis
*
* * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞) metres
*
* * * *
Name:OGC:semi_minor
Alias:EPSG:Semi-minor axis
*
* * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞) metres
*
* * *
Name:Geotk:roll_longitude
*
* * * * *
Type:{@code Boolean}
Obligation:optional
Default value:false
*
* * * *
Name:OGC:central_meridian
Alias:EPSG:Longitude of natural origin
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[-180 … 180]°
Default value:
*
* * * *
Name:OGC:latitude_of_origin
Alias:EPSG:Latitude of natural origin
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[-90 … 90]°
Default value:
*
* * * *
Name:OGC:scale_factor
Alias:EPSG:Scale factor at natural origin
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:[0…∞)
Default value:1
*
* * * *
Name:OGC:false_easting
Alias:EPSG:False easting
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:(-∞ … ∞) metres
Default value:0 metres
*
* * * *
Name:OGC:false_northing
Alias:EPSG:False northing
*
* * * * * *
Type:{@code Double}
Obligation:mandatory
Value range:(-∞ … ∞) metres
Default value:0 metres
*
*/ @SuppressWarnings("hiding") public static final ParameterDescriptorGroup PARAMETERS; static { final Citation[] excludes = { Citations.ESRI, Citations.NETCDF, Citations.GEOTIFF, Citations.PROJ4 }; PARAMETERS = UniversalParameters.createDescriptorGroup( new ReferenceIdentifier[] { new NamedIdentifier(Citations.EPSG, "Transverse Mercator (South Orientated)"), new IdentifierCode (Citations.EPSG, 9808), sameNameAs(Citations.GEOTOOLKIT, TransverseMercator.PARAMETERS) }, excludes, new ParameterDescriptor[] { sameParameterAs(PseudoMercator.PARAMETERS, "semi_major"), sameParameterAs(PseudoMercator.PARAMETERS, "semi_minor"), ROLL_LONGITUDE, sameParameterAs(PseudoMercator.PARAMETERS, "central_meridian"), sameParameterAs(PseudoMercator.PARAMETERS, "latitude_of_origin"), SCALE_FACTOR, sameParameterAs(PseudoMercator.PARAMETERS, "false_easting"), sameParameterAs(PseudoMercator.PARAMETERS, "false_northing") }, MapProjectionDescriptor.ADD_EARTH_RADIUS); } /** * Constructs a new provider. */ public SouthOrientated() { super(PARAMETERS); } } }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy