Application: gvSIG desktop » gvSIG projections

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program 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 General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

package org.gvsig.proj.catalogue.cs;

/**

 * A 2- or 3-dimensional coordinate system with orthogonal straight axes.

 * All axes shall have the same length unit of measure.

 *

 * <p>This type of CS can be used by coordinate reference systems of type

 * {@link org.opengis.referencing.crs.GeocentricCRS},

 * {@link org.opengis.referencing.crs.ProjectedCRS},

 * {@link org.opengis.referencing.crs.EngineeringCRS} or

 * {@link org.opengis.referencing.crs.ImageCRS}.

 * The following examples describe some possible set of axes for Cartesian CS used with the above-cited CRS:</p>

 *

 * <table class="ogc">

 *   <caption>Example 1: used with a Projected CRS</caption>

 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>

 *   <tr><td>Easting</td> <td>E</td> <td>{@link AxisDirection#EAST}</td>  <td>metre</td></tr>

 *   <tr><td>Northing</td><td>N</td> <td>{@link AxisDirection#NORTH}</td> <td>metre</td></tr>

 * </table>

 *

 * <table class="ogc">

 *   <caption>Example 2: used with a Geocentric CRS</caption>

 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>

 *   <tr><td>Geocentric X</td><td>X</td> <td>{@link AxisDirection#GEOCENTRIC_X}</td> <td>metre</td></tr>

 *   <tr><td>Geocentric Y</td><td>Y</td> <td>{@link AxisDirection#GEOCENTRIC_Y}</td> <td>metre</td></tr>

 *   <tr><td>Geocentric Z</td><td>Z</td> <td>{@link AxisDirection#GEOCENTRIC_Z}</td> <td>metre</td></tr>

 * </table>

 *

 * <table class="ogc">

 *   <caption>Example 3: used with an Engineering CRS for a station fixed to Earth</caption>

 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>

 *   <tr><td>Site north</td><td>x</td> <td>{@link AxisDirection#SOUTH_EAST}</td> <td>metre</td></tr>

 *   <tr><td>Site east</td> <td>y</td> <td>{@link AxisDirection#SOUTH_WEST}</td> <td>metre</td></tr>

 * </table>

 *

 * <table class="ogc">

 *   <caption>Example 4: used with an Engineering CRS for a moving platform</caption>

 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>

 *   <tr><td>Ahead</td><td>x</td> <td>{@code AxisDirection.valueOf("FORDWARD")}</td>  <td>metre</td></tr>

 *   <tr><td>Right</td><td>y</td> <td>{@code AxisDirection.valueOf("STARBOARD")}</td> <td>metre</td></tr>

 *   <tr><td>Down</td> <td>z</td> <td>{@link AxisDirection#DOWN}</td>                 <td>metre</td></tr>

 * </table>

 *

 * <div class="note"><b>Note:</b>

 * The above example uses two axis directions that are not defined in ISO 19111,

 * but found in ISO 19162 as "{@code forward}" and "{@code starboard}".</div>

 *

 * @departure constraint

 *   ISO 19111 defines <code>CartesianCS</code> as a direct sub-type of <code>CoordinateSystem</code>.

 *   ISO also defines <code>ImageCS</code> as the union of <code>AffineCS</code> and <code>CartesianCS</code>,

 *   for use by <code>ImageCRS</code>. Because the <code>union</code> construct found in some languages like

 *   C/C++ does not exist in Java, GeoAPI defines <code>CartesianCS</code> as a sub-type of <code>AffineCS</code>

 *   in order to achieve the same type safety.

 *   With this change, GeoAPI can use <code>AffineCS</code> directly without the need to define <code>ImageCS</code>.

 *   In this hierarchy, <code>CartesianCS</code> is considered a special case of <code>AffineCS</code> where all axes

 *   are perpendicular to each other.

 *

 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to

 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans

 * to evolve these interfaces to adapt them to future GeoAPI versions.

 * 

 * @author  gvSIG Team

 * @author  Martin Desruisseaux (IRD)

 * @version 3.1

 * @since   1.0

 *

 * @see CSAuthorityFactory#createCartesianCS(String)

 * @see CSFactory#createCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)

 * @see CSFactory#createCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)

 */

public interface CartesianCS extends AffineCS {

}