Statistics
| Revision:

root / org.gvsig.proj / branches / refactor2018 / org.gvsig.proj / org.gvsig.proj.catalog / org.gvsig.proj.catalog.api / src / main / java / org / gvsig / proj / catalogue / cs / EllipsoidalCS.java @ 793

History | View | Annotate | Download (4.67 KB)

1
/**
2
 * gvSIG. Desktop Geographic Information System.
3
 *
4
 * Copyright (C) 2018 gvSIG Association.
5
 * 
6
 * This file has been adapted from GeoAPI, see 
7
 * the original copyright headers bellow.
8
 *
9
 * This program is free software; you can redistribute it and/or
10
 * modify it under the terms of the GNU General Public License
11
 * as published by the Free Software Foundation; either version 2
12
 * of the License, or (at your option) any later version.
13
 *
14
 * This program is distributed in the hope that it will be useful,
15
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17
 * GNU General Public License for more details.
18
 *
19
 * You should have received a copy of the GNU General Public License
20
 * along with this program; if not, write to the Free Software
21
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
22
 * MA  02110-1301, USA.
23
 *
24
 * For any additional information, do not hesitate to contact us
25
 * at info AT gvsig.com, or visit our website www.gvsig.com.
26
 * 
27
 * ----------
28
 * 
29
 *    GeoAPI - Java interfaces for OGC/ISO standards
30
 *    http://www.geoapi.org
31
 *
32
 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.
33
 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal
34
 *
35
 *    Permission to use, copy, and modify this software and its documentation, with
36
 *    or without modification, for any purpose and without fee or royalty is hereby
37
 *    granted, provided that you include the following on ALL copies of the software
38
 *    and documentation or portions thereof, including modifications, that you make:
39
 *
40
 *    1. The full text of this NOTICE in a location viewable to users of the
41
 *       redistributed or derivative work.
42
 *    2. Notice of any changes or modifications to the OGC files, including the
43
 *       date changes were made.
44
 *
45
 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
46
 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
47
 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
48
 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
49
 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
50
 *
51
 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
52
 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
53
 *
54
 *    The name and trademarks of copyright holders may NOT be used in advertising or
55
 *    publicity pertaining to the software without specific, written prior permission.
56
 *    Title to copyright in this software and any associated documentation will at all
57
 *    times remain with copyright holders.
58
 */
59
package org.gvsig.proj.catalogue.cs;
60

    
61
/**
62
 * A 2- or 3-dimensional coordinate system in which position is specified by
63
 * geodetic latitude, geodetic longitude, and (in the 3D case) ellipsoidal height.
64
 *
65
 * <p>This type of CS can be used by coordinate reference systems of type
66
 * {@link org.opengis.referencing.crs.GeographicCRS}.
67
 * The following examples describe some possible set of axes for ellipsoidal CS used with the above-cited CRS:</p>
68
 *
69
 * <table class="ogc">
70
 *   <caption>Example 1: used with a two-dimensional Geographic CRS</caption>
71
 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>
72
 *   <tr><td>Geodetic latitude</td> <td>phi</td> <td>{@link AxisDirection#NORTH}</td><td>degree</td></tr>
73
 *   <tr><td>Geodetic longitude</td><td>lambda</td> <td>{@link AxisDirection#EAST}</td> <td>degree</td></tr>
74
 * </table>
75
 *
76
 * <table class="ogc">
77
 *   <caption>Example 2: used with a three-dimensional Geographic CRS</caption>
78
 *   <tr><th>Axis name</th> <th>Abbr.</th> <th>Direction</th> <th>Unit</th></tr>
79
 *   <tr><td>Geodetic latitude</td> <td>phi</td> <td>{@link AxisDirection#NORTH}</td><td>degree</td></tr>
80
 *   <tr><td>Geodetic longitude</td><td>lambda</td> <td>{@link AxisDirection#EAST}</td> <td>degree</td></tr>
81
 *   <tr><td>Ellipsoidal height</td><td>h</td> <td>{@link AxisDirection#UP}</td>   <td>metre</td></tr>
82
 * </table>
83
 *
84
 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to
85
 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans
86
 * to evolve these interfaces to adapt them to future GeoAPI versions.
87
 * 
88
 * @author  gvSIG Team
89
 * @author  Martin Desruisseaux (IRD)
90
 * @version 3.1
91
 * @since   1.0
92
 *
93
 * @see CSAuthorityFactory#createEllipsoidalCS(String)
94
 * @see CSFactory#createEllipsoidalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
95
 * @see CSFactory#createEllipsoidalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
96
 */
97
public interface EllipsoidalCS extends CoordinateSystem {
98

    
99
}