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 / datum / VerticalDatumType.java @ 794

History | View | Annotate | Download (5.17 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.datum;
60

    
61
/**
62
 * Type of a vertical datum.
63
 */
64
public enum VerticalDatumType {
65
    /**
66
     * In some cases, for example oil exploration and production, a geological feature, such as the top
67
     * or bottom of a geologically identifiable and meaningful subsurface layer, is used as a
68
     * vertical datum. Other variations to the above three vertical datum types may exist
69
     * and are all included in this type.
70
     */
71
    OTHER_SURFACE,
72

    
73
    /**
74
     * The zero value of the associated vertical coordinate system axis is defined to approximate
75
     * a constant potential surface, usually the geoid. Such a reference surface is usually
76
     * determined by a national or scientific authority, and is then a well-known, named datum.
77
     */
78
    GEOIDAL,
79

    
80
    /**
81
     * The zero point of the vertical axis is defined by a surface that has meaning for the
82
     * purpose which the associated vertical measurements are used for. For hydrographic charts,
83
     * this is often a predicted nominal sea surface (i.e., without waves or other wind and current
84
     * effects) that occurs at low tide. Depths are measured in the direction perpendicular
85
     * (approximately) to the actual equipotential surfaces of the earth's gravity field,
86
     * using such procedures as echo-sounding.
87
     */
88
    DEPTH,
89

    
90
    /**
91
     * Atmospheric pressure is the basis for the definition of the origin of the
92
     * associated vertical coordinate system axis. These are approximations of
93
     * orthometric heights obtained with the help of a barometer or a barometric
94
     * altimeter. These values are usually expressed in one of the following units:
95
     * meters, feet, millibars (used to measure pressure levels), or theta value
96
     * (units used to measure geopotential height).
97
     */
98
    BAROMETRIC,
99
        
100
    /**
101
     * The zero point of the associated vertical coordinate system axis is defined
102
     * by the ellipsoid of the associated horizontal CRS.
103
     * 
104
     * Note: ISO 19111 ommits the definition of an ELLIPSOIDAL vertical height on intend.
105
     * GeographicCRS with ellipsoidal height shall be backed by a three-dimensional
106
     * EllipsoidalCS; they should never be built as CompoundCRS. If nevertheless an
107
     * ellipsoidal height is needed (for example in order to process a CRS in the WKT
108
     * format), implementors can get a suitable vertical datum type using
109
     * VerticalDatumType.valueOf("ELLIPSOIDAL"). Implementors are encouraged to not
110
     * expose that datum type in public API however.
111
     */
112
        ELLIPSOIDAL;
113
}