/* * Geotoolkit.org - An Open Source Java GIS Toolkit * http://www.geotoolkit.org * * (C) 2002-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 org.apache.sis.internal.referencing.provider.Equirectangular; 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.operation.ConicProjection; import org.opengis.referencing.operation.MathTransform2D; import org.opengis.referencing.operation.MathTransformFactory; import org.opengis.metadata.Identifier; import org.apache.sis.referencing.NamedIdentifier; import org.geotoolkit.internal.referencing.DeprecatedName; import org.geotoolkit.metadata.Citations; /** * The provider for "<cite>Krovak Oblique Conic Conformal</cite>" projection (EPSG:9819). * The math transform implementations instantiated by this provider may be any of the following classes: * <p> * <ul> * <li>{@link org.geotoolkit.referencing.operation.projection.Krovak}</li> * </ul> * * <!-- PARAMETERS Krovak --> * <p>The following table summarizes the parameters recognized by this provider. * For a more detailed parameter list, see the {@link #PARAMETERS} constant.</p> * <blockquote><p><b>Operation name:</b> {@code Krovak} * <br><b>Area of use:</b> <font size="-1">(union of CRS domains of validity in EPSG database)</font></p> * <blockquote><table class="compact"> * <tr><td><b>in latitudes:</b></td><td class="onright">47°44.4′N</td><td>to</td><td class="onright">51°03.0′N</td></tr> * <tr><td><b>in longitudes:</b></td><td class="onright">12°05.4′E</td><td>to</td><td class="onright">22°33.6′E</td></tr> * </table></blockquote> * <table class="geotk"> * <tr><th>Parameter name</th><th>Default value</th></tr> * <tr><td>{@code semi_major}</td><td></td></tr> * <tr><td>{@code semi_minor}</td><td></td></tr> * <tr><td>{@code latitude_of_center}</td><td>49.5°</td></tr> * <tr><td>{@code longitude_of_center}</td><td>24.83333333333333°</td></tr> * <tr><td>{@code azimuth}</td><td>30.28813972222222°</td></tr> * <tr><td>{@code pseudo_standard_parallel_1}</td><td>78.5°</td></tr> * <tr><td>{@code scale_factor}</td><td>0.9999</td></tr> * <tr><td>{@code false_easting}</td><td>0 metres</td></tr> * <tr><td>{@code false_northing}</td><td>0 metres</td></tr> * <tr><td>{@code X_Scale}</td><td>1</td></tr> * <tr><td>{@code Y_Scale}</td><td>1</td></tr> * <tr><td>{@code XY_Plane_Rotation}</td><td>0°</td></tr> * </table></blockquote> * <!-- END OF PARAMETERS --> * * @author Jan Jezek (HSRS) * @author Martin Desruisseaux (IRD, Geomatys) * @version 3.20 * * @see <A HREF="http://www.remotesensing.org/geotiff/proj_list/krovak.html">Krovak on RemoteSensing.org</A> * @see <a href="{@docRoot}/../modules/referencing/operation-parameters.html">Geotk coordinate operations matrix</a> * * @since 2.4 * @module */ public class Krovak extends MapProjection { /** * For cross-version compatibility. */ private static final long serialVersionUID = -278392856661204734L; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#centralMeridian * central meridian} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is [-180 … 180]° and default value is * 24°50' (which is 42°30' from Ferro prime meridian). * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> LONGITUDE_OF_CENTRE; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#latitudeOfOrigin * latitude of origin} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is [-90 … 90]° and default value is 49.5°. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> LATITUDE_OF_CENTRE; /** * The operation parameter descriptor for the {@code azimuth} parameter value. This has * been renamed "<cite>Co-latitude of cone axis</cite>" in latest EPSG database versions. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is [-90 … 90]° and default value is 30.28813972222°. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> AZIMUTH; /** * The operation parameter descriptor for the first {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#standardParallels * standard parallel} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is [-90 … 90]° and default value is 78.5°. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> PSEUDO_STANDARD_PARALLEL; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#scaleFactor * scale factor} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is (0 … ∞) and default value is 0.9999. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> SCALE_FACTOR; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseEasting * false easting} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is unrestricted and default value is 0 metre. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> FALSE_EASTING; /** * The operation parameter descriptor for the {@linkplain * org.geotoolkit.referencing.operation.projection.UnitaryProjection.Parameters#falseNorthing * false northing} parameter value. * * This parameter is <a href="package-summary.html#Obligation">mandatory</a>. * Valid values range is unrestricted and default value is 0 metre. * * @deprecated Invoke <code>{@linkplain #PARAMETERS}.{@linkplain ParameterDescriptorGroup#descriptor(String) * descriptor(String)}</code> instead. */ @Deprecated public static final ParameterDescriptor<Double> FALSE_NORTHING; /** * Parameters creation, which must be done before to initialize the {@link #PARAMETERS} field. */ static { final Citation[] excludes = new Citation[] {Citations.NETCDF}; LONGITUDE_OF_CENTRE = UniversalParameters.CENTRAL_MERIDIAN.select(true, 42.5 - 17.66666666666667, excludes, null, "Longitude of origin", // EPSG "longitude_of_center", // OGC "Longitude_Of_Center", // ESRI "CenterLong"); // GeoTIFF LATITUDE_OF_CENTRE = UniversalParameters.LATITUDE_OF_ORIGIN.select(true, 49.5, excludes, null, "Latitude of projection centre", // EPSG "latitude_of_center", // OGC "Latitude_Of_Center", // ESRI "CenterLat"); // GeoTIFF AZIMUTH = UniversalParameters.AZIMUTH.select(true, 30.28813972222222, excludes, null, "Co-latitude of cone axis", // EPSG "azimuth", // OGC "AzimuthAngle"); // GeoTIFF PSEUDO_STANDARD_PARALLEL = UniversalParameters.STANDARD_PARALLEL_1.select(true, 78.5, excludes, null, "Latitude of pseudo standard parallel", // EPSG "pseudo_standard_parallel_1", // OGC "Pseudo_Standard_Parallel_1"); // ESRI SCALE_FACTOR = UniversalParameters.SCALE_FACTOR.select(true, 0.9999, excludes, null, "Scale factor on pseudo standard parallel", // EPSG "ScaleAtCenter"); // GeoTIFF // Following are the same than Mercator1SP except for the exclusion list. FALSE_EASTING = Equirectangular.FALSE_EASTING; FALSE_NORTHING = Equirectangular.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: * <p> * <!-- GENERATED PARAMETERS - inserted by ProjectionParametersJavadoc --> * <table class="geotk" border="1"> * <tr><th colspan="2"> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>Krovak</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Krovak</code></td></tr> * <tr><td></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code><del>Krovak Oblique Conic Conformal</del></code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Krovak</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>Krovak</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>krovak</code></td></tr> * <tr><td></td><td class="onright"><code>Geotk</code>:</td><td class="onleft"><code>Krovak Oblique Conformal Conic</code></td></tr> * <tr><td><b>Identifier:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>9819</code></td></tr> * </table> * </th></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>semi_major</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Semi-major axis</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Semi_Major</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>SemiMajor</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>a</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[0…∞) metres</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>semi_minor</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Semi-minor axis</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Semi_Minor</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>SemiMinor</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>b</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[0…∞) metres</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Boolean}</td></tr> * <tr><td><b>Obligation:</b></td><td>optional</td></tr> * <tr><td><b>Default value:</b></td><td>false</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>latitude_of_center</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Latitude of projection centre</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Latitude_Of_Center</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>CenterLat</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>lat_0</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[-90 … 90]°</td></tr> * <tr><td><b>Default value:</b></td><td>49.5°</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>longitude_of_center</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Longitude of origin</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Longitude_Of_Center</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>CenterLong</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>lon_0</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[-180 … 180]°</td></tr> * <tr><td><b>Default value:</b></td><td>24.83333333333333°</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>azimuth</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Co-latitude of cone axis</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Azimuth</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>AzimuthAngle</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[-360 … 360]°</td></tr> * <tr><td><b>Default value:</b></td><td>30.28813972222222°</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>pseudo_standard_parallel_1</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Latitude of pseudo standard parallel</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Pseudo_Standard_Parallel_1</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>StdParallel1</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>lat_1</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[-90 … 90]°</td></tr> * <tr><td><b>Default value:</b></td><td>78.5°</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>scale_factor</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>Scale factor on pseudo standard parallel</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Scale_Factor</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>ScaleAtCenter</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>k</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>[0…∞)</td></tr> * <tr><td><b>Default value:</b></td><td>0.9999</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>false_easting</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>False easting</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>False_Easting</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>FalseEasting</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>x_0</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>(-∞ … ∞) metres</td></tr> * <tr><td><b>Default value:</b></td><td>0 metres</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>OGC</code>:</td><td class="onleft"><code>false_northing</code></td></tr> * <tr><td><b>Alias:</b></td><td class="onright"><code>EPSG</code>:</td><td class="onleft"><code>False northing</code></td></tr> * <tr><td></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>False_Northing</code></td></tr> * <tr><td></td><td class="onright"><code>GeoTIFF</code>:</td><td class="onleft"><code>FalseNorthing</code></td></tr> * <tr><td></td><td class="onright"><code>PROJ4</code>:</td><td class="onleft"><code>y_0</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>mandatory</td></tr> * <tr><td><b>Value range:</b></td><td>(-∞ … ∞) metres</td></tr> * <tr><td><b>Default value:</b></td><td>0 metres</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>X_Scale</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>optional</td></tr> * <tr><td><b>Value range:</b></td><td>(-∞ … ∞)</td></tr> * <tr><td><b>Default value:</b></td><td>1</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>Y_Scale</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>optional</td></tr> * <tr><td><b>Value range:</b></td><td>(-∞ … ∞)</td></tr> * <tr><td><b>Default value:</b></td><td>1</td></tr> * </table> * </td></tr> * <tr><td> * <table class="compact"> * <tr><td><b>Name:</b></td><td class="onright"><code>ESRI</code>:</td><td class="onleft"><code>XY_Plane_Rotation</code></td></tr> * </table> * </td><td> * <table class="compact"> * <tr><td><b>Type:</b></td><td>{@code Double}</td></tr> * <tr><td><b>Obligation:</b></td><td>optional</td></tr> * <tr><td><b>Value range:</b></td><td>[-360 … 360]°</td></tr> * <tr><td><b>Default value:</b></td><td>0°</td></tr> * </table> * </td></tr> * </table> */ public static final ParameterDescriptorGroup PARAMETERS = UniversalParameters.createDescriptorGroup( new Identifier[] { new NamedIdentifier(Citations.OGC, "Krovak"), new NamedIdentifier(Citations.EPSG, "Krovak"), // Starting from EPSG version 7.6 new DeprecatedName (Citations.EPSG, "Krovak Oblique Conic Conformal"), // Legacy new IdentifierCode (Citations.EPSG, 9819), new NamedIdentifier(Citations.ESRI, "Krovak"), new NamedIdentifier(Citations.GEOTIFF, "Krovak"), new NamedIdentifier(Citations.PROJ4, "krovak"), new NamedIdentifier(Citations.GEOTOOLKIT, "Krovak Oblique Conformal Conic"), }, null, new ParameterDescriptor<?>[] { SEMI_MAJOR, SEMI_MINOR, LATITUDE_OF_CENTRE, LONGITUDE_OF_CENTRE, AZIMUTH, PSEUDO_STANDARD_PARALLEL, SCALE_FACTOR, FALSE_EASTING, FALSE_NORTHING, X_SCALE, Y_SCALE, XY_PLANE_ROTATION }, MapProjectionDescriptor.ADD_EARTH_RADIUS); /** * Constructs a new provider. */ public Krovak() { super(PARAMETERS); } /** * Returns the operation type for this map projection. */ @Override public Class<ConicProjection> getOperationType() { return ConicProjection.class; } /** * {@inheritDoc} */ @Override public MathTransform2D createMathTransform(MathTransformFactory factory, ParameterValueGroup values) { return org.geotoolkit.referencing.operation.projection.Krovak.create(this, values); } }