001 /*
002 * GeoAPI - Java interfaces for OGC/ISO standards
003 * http://www.geoapi.org
004 *
005 * Copyright (C) 2005-2013 Open Geospatial Consortium, Inc.
006 * All Rights Reserved. http://www.opengeospatial.org/ogc/legal
007 *
008 * Permission to use, copy, and modify this software and its documentation, with
009 * or without modification, for any purpose and without fee or royalty is hereby
010 * granted, provided that you include the following on ALL copies of the software
011 * and documentation or portions thereof, including modifications, that you make:
012 *
013 * 1. The full text of this NOTICE in a location viewable to users of the
014 * redistributed or derivative work.
015 * 2. Notice of any changes or modifications to the OGC files, including the
016 * date changes were made.
017 *
018 * THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
019 * NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
020 * TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
021 * THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
022 * PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
023 *
024 * COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
025 * CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
026 *
027 * The name and trademarks of copyright holders may NOT be used in advertising or
028 * publicity pertaining to the software without specific, written prior permission.
029 * Title to copyright in this software and any associated documentation will at all
030 * times remain with copyright holders.
031 */
032 package org.opengis.annotation;
033
034
035 /**
036 * ISO/OGC specifications from which an interface, method or code list was derived.
037 * Some specifications are available both at OGC and ISO.
038 *
039 * @author Martin Desruisseaux (IRD)
040 * @author Cédric Briançon (Geomatys)
041 * @version 3.0
042 * @since 2.0
043 */
044 public enum Specification {
045 /**
046 * ISO 19103:2005, Geographic information - Conceptual schema language.
047 * This is the specification for some interfaces in package {@link org.opengis.util}.
048 *
049 * <p><b>ISO abstract:</b></p>
050 * <blockquote><font size="-1">
051 * <p>Provides rules and guidelines for the use of a conceptual schema language
052 * within the ISO geographic information standards. The chosen conceptual schema language is the
053 * Unified Modeling Language (UML).</p>
054 *
055 * <p>ISO TS 19103:2005 provides a profile of UML for use with geographic
056 * information. In addition, it provides guidelines on how UML should be used to create
057 * standardized geographic information and service models.</p>
058 * </font></blockquote>
059 *
060 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=37800">Buy from ISO</a>
061 */
062 ISO_19103,
063
064 /**
065 * ISO 19107:2003, Feature Geometry
066 * (<a href="http://www.opengeospatial.org/standards/as">OGC Topic 1</a>).
067 * This is the specification for package {@link org.opengis.geometry} and sub-packages.
068 *
069 * <p><b>ISO abstract:</b></p>
070 * <blockquote><font size="-1">
071 * <p>Specifies conceptual schemas for describing the spatial characteristics of
072 * geographic features, and a set of spatial operations consistent with these schemas. It treats
073 * vector geometry and topology up to three dimensions. It defines standard spatial operations
074 * for use in access, query, management, processing, and data exchange of geographic information
075 * for spatial (geometric and topological) objects of up to three topological dimensions embedded
076 * in coordinate spaces of up to three axes.</p>
077 * </font></blockquote>
078 *
079 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">Buy from ISO</a>
080 */
081 ISO_19107,
082
083 /**
084 * ISO 19108:2002, Temporal Schema.
085 * This is the specification for package {@link org.opengis.temporal} and sub-packages.
086 *
087 * <p><b>ISO abstract:</b></p>
088 * <blockquote><font size="-1">
089 * <p>Defines concepts for describing temporal characteristics of geographic
090 * information. It depends upon existing information technology standards for the interchange
091 * of temporal information. It provides a basis for defining temporal feature attributes,
092 * feature operations, and feature associations, and for defining the temporal aspects of
093 * metadata about geographic information. Since this International Standard is concerned with
094 * the temporal characteristics of geographic information as they are abstracted from the real
095 * world, it emphasizes valid time rather than transaction time.</p>
096 * </font></blockquote>
097 *
098 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26013">Buy from ISO</a>
099 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=44883">Corrigendum</a>
100 */
101 ISO_19108,
102
103 /**
104 * ISO 19111:2007, Spatial Referencing by Coordinates
105 * (<a href="http://www.opengeospatial.org/standards/as">OGC Topic 2</a>).
106 * This is the specification for package {@link org.opengis.referencing} and sub-packages.
107 *
108 * <p><b>ISO abstract:</b></p>
109 * <blockquote><font size="-1">
110 * <p>Defines the conceptual schema for the description of spatial referencing by
111 * coordinates, optionally extended to spatio-temporal referencing. It describes the minimum
112 * data required to define one-, two- and three-dimensional spatial coordinate reference systems
113 * with an extension to merged spatial-temporal reference systems. It allows additional descriptive
114 * information to be provided. It also describes the information required to change coordinates
115 * from one coordinate reference system to another.</p>
116 *
117 * <p>In ISO 19111:2007, a coordinate reference system does not change with time.
118 * For coordinate reference systems defined on moving platforms such as cars, ships, aircraft and
119 * spacecraft, the transformation to an Earth-fixed coordinate reference system can include a time
120 * element.</p>
121 *
122 * <p>ISO 19111:2007 is applicable to producers and users of geographic information.
123 * Although it is applicable to digital geographic data, its principles can be extended to many
124 * other forms of geographic data such as maps, charts and text documents.</p>
125 *
126 * <p>The schema described can be applied to the combination of horizontal
127 * position with a third non-spatial parameter which varies monotonically with height or depth.
128 * This extension to non-spatial data is beyond the scope of ISO 19111:2007 but can be implemented
129 * through profiles.</p>
130 * </font></blockquote>
131 *
132 * @see #OGC_01009
133 * @see <a href="http://portal.opengeospatial.org/files/?artifact_id=39049">Download from OGC</a>
134 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=41126">Buy from ISO</a>
135 */
136 ISO_19111,
137
138 /**
139 * ISO 19115:2003, Metadata
140 * (<a href="http://www.opengeospatial.org/standards/as">OGC Topic 11</a>).
141 * This is the specification for package {@link org.opengis.metadata} and sub-packages.
142 *
143 * <p><b>ISO abstract:</b></p>
144 * <blockquote><font size="-1">
145 * <p>Defines the schema required for describing geographic information and services.
146 * It provides information about the identification, the extent, the quality, the spatial and
147 * temporal schema, spatial reference, and distribution of digital geographic data.</p>
148 *
149 * <p>ISO 19115:2003 is applicable to:</p>
150 * <ul>
151 * <li>the cataloguing of datasets, clearinghouse activities, and the full description of datasets;</li>
152 * <li>geographic datasets, dataset series, and individual geographic features and feature properties.</li>
153 * </ul>
154 *
155 * <p>ISO 19115:2003 defines:</p>
156 * <ul>
157 * <li>mandatory and conditional metadata sections, metadata entities, and metadata elements;</li>
158 * <li>the minimum set of metadata required to serve the full range of metadata applications
159 * (data discovery, determining data fitness for use, data access, data transfer, and use
160 * of digital data);</li>
161 * <li>optional metadata elements - to allow for a more extensive standard description of
162 * geographic data, if required;</li>
163 * <li>a method for extending metadata to fit specialized needs.</li>
164 * </ul>
165 *
166 * <p>Though ISO 19115:2003 is applicable to digital data, its principles
167 * can be extended to many other forms of geographic data such as maps, charts, and textual
168 * documents as well as non-geographic data.</p>
169 *
170 * <p><b>NOTE:</b> Certain mandatory metadata elements may not apply to these
171 * other forms of data.</p>
172 * </font></blockquote>
173 *
174 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26020">Buy from ISO</a>
175 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=44361">Corrigendum</a>
176 */
177 ISO_19115,
178
179 /**
180 * ISO 19115-2:2009, Metadata part 2: extensions for imagery and gridded data.
181 * This is the specification for package {@link org.opengis.metadata} and sub-packages.
182 *
183 * <p><b>ISO abstract:</b></p>
184 * <blockquote><font size="-1">
185 * <p>Extends the existing geographic metadata standard by defining the schema
186 * required for describing imagery and gridded data. It provides information about the properties
187 * of the measuring equipment used to acquire the data, the geometry of the measuring process
188 * employed by the equipment, and the production process used to digitize the raw data. This
189 * extension deals with metadata needed to describe the derivation of geographic information
190 * from raw data, including the properties of the measuring system, and the numerical methods
191 * and computational procedures used in the derivation. The metadata required to address coverage
192 * data in general is addressed sufficiently in the general part of ISO 19115.</p>
193 * </font></blockquote>
194 *
195 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=39229">Buy from ISO</a>
196 *
197 * @since 2.3
198 */
199 ISO_19115_2,
200
201 /**
202 * ISO 19117:2005, Portrayal.
203 * This is an abstract specification for portraying features.
204 *
205 * <p><b>ISO abstract:</b></p>
206 * <blockquote><font size="-1">
207 * <p>Defines a schema describing the portrayal of geographic information in a
208 * form understandable by humans. It includes the methodology for describing symbols and mapping
209 * of the schema to an application schema. It does not include standardization of cartographic
210 * symbols, and their geometric and functional description.</p>
211 * </font></blockquote>
212 *
213 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=40395">Buy from ISO</a>
214 */
215 ISO_19117,
216
217 /**
218 * ISO 19123:2005, Schema for coverage geometry and functions
219 * (<a href="http://www.opengeospatial.org/standards/as">OGC Topic 6</a>).
220 * This is the specification for package {@link org.opengis.coverage} and sub-packages.
221 *
222 * <p><b>ISO abstract:</b></p>
223 * <blockquote><font size="-1">
224 * <p>Defines a conceptual schema for the spatial characteristics of coverages.
225 * Coverages support mapping from a spatial, temporal or spatiotemporal domain to feature attribute
226 * values where feature attribute types are common to all geographic positions within the domain.
227 * A coverage domain consists of a collection of direct positions in a coordinate space that may
228 * be defined in terms of up to three spatial dimensions as well as a temporal dimension.
229 * Examples of coverages include rasters, triangulated irregular networks, point coverages and
230 * polygon coverages. Coverages are the prevailing data structures in a number of application
231 * areas, such as remote sensing, meteorology and mapping of bathymetry, elevation, soil and
232 * vegetation.</p>
233 *
234 * <p>ISO 19123:2005 defines the relationship between the domain of a coverage
235 * and an associated attribute range. The characteristics of the spatial domain are defined
236 * whereas the characteristics of the attribute range are not part of ISO 19123:2005.</p>
237 * </font></blockquote>
238 *
239 * @see #OGC_01004
240 * @see <a href="http://portal.opengeospatial.org/files/?artifact_id=19820">Download from OGC</a>
241 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=40121">Buy from ISO</a>
242 */
243 ISO_19123,
244
245 /**
246 * ISO 19128:2005, Web map server interface.
247 * This is the specification for package {@link org.opengis.layer} and sub-packages.
248 *
249 * <p><b>ISO abstract:</b></p>
250 * <blockquote><font size="-1">
251 * <p>Specifies the behaviour of a service that produces spatially referenced
252 * maps dynamically from geographic information. It specifies operations to retrieve a description
253 * of the maps offered by a server, to retrieve a map, and to query a server about features
254 * displayed on a map. ISO 19128:2005 is applicable to pictorial renderings of maps in a
255 * graphical format; it is not applicable to retrieval of actual feature data or coverage data
256 * values.</p>
257 * </font></blockquote>
258 *
259 * @see <a href="http://portal.opengeospatial.org/files/?artifact_id=5316">Download from OGC</a>
260 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=32546">Buy from ISO</a>
261 */
262 ISO_19128,
263
264 /**
265 * ISO 19139:2007, Metadata. XML schema implementation.
266 * This is the specification for package {@link org.opengis.metadata} and sub-packages.
267 *
268 * <p><b>ISO abstract:</b></p>
269 * <blockquote><font size="-1">
270 * <p>Defines Geographic MetaData XML ({@code gmd}) encoding, an XML Schema
271 * implementation derived from ISO 19115.</p>
272 * </font></blockquote>
273 *
274 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=32557">Buy from ISO</a>
275 *
276 * @since 2.3
277 */
278 ISO_19139,
279
280 /**
281 * GO-1 Application Objects.
282 * This is the specification for package {@link org.opengis.go} and sub-packages.
283 *
284 * @see <a href="http://www.opengeospatial.org/standards/go">Download from OGC</a>
285 */
286 OGC_03064,
287
288 /**
289 * Coordinate Transformation Services implementation specification.
290 * This is the specification used as a complement of {@linkplain #ISO_19111 ISO 19111}
291 * when an aspect was not defined in the ISO specification.
292 *
293 * @see #ISO_19111
294 * @see <a href="http://www.opengeospatial.org/standards/ct">Download from OGC</a>
295 */
296 OGC_01009,
297
298 /**
299 * Grid Coverages implementation specification.
300 * This is the specification used as a complement of {@linkplain #ISO_19123 ISO 19123}
301 * when an aspect was not defined in the ISO specification.
302 *
303 * @see #ISO_19123
304 * @see <a href="http://www.opengeospatial.org/standards/gc">Download from OGC</a>
305 */
306 OGC_01004,
307
308 /**
309 * Filter encoding implementation specification.
310 * This is the specification for package {@link org.opengis.filter} and sub-packages.
311 *
312 * @see <a href="http://www.opengeospatial.org/standards/filter">Download from OGC</a>
313 *
314 * @deprecated To be replaced by {@code OGC 09-026}.
315 */
316 @Deprecated
317 OGC_02059,
318
319 /**
320 * Styled Layer Descriptor (SLD) implementation specification.
321 * This is the specification for package {@link org.opengis.sld} and sub-packages.
322 *
323 * @see <a href="http://www.opengeospatial.org/standards/sld">Download from OGC</a>
324 *
325 * @deprecated To be replaced by {@code OGC 05-078}.
326 */
327 @Deprecated
328 OGC_02070,
329
330 /**
331 * Web Feature Service implementation specification.
332 * This is the specification for package {@link org.opengis.feature} and sub-packages.
333 *
334 * @see <a href="http://www.opengeospatial.org/standards/wfs">Download from OGC</a>
335 *
336 * @deprecated To be replaced by {@code OGC 09-025}.
337 */
338 @Deprecated
339 OGC_04094,
340
341 /**
342 * Observations and Measurements, part 1.
343 * This is the specification for package {@link org.opengis.observation}.
344 *
345 * @deprecated To be replaced by Topic 20: Observations and Measurements
346 */
347 @Deprecated
348 OGC_07022,
349
350 /**
351 * Observations and Measurements, part 2: Sampling Features.
352 * This is the specification for package {@link org.opengis.observation.sampling}.
353 *
354 * @deprecated To be replaced by Topic 20: Observations and Measurements
355 */
356 @Deprecated
357 OGC_07002,
358
359 /**
360 * Specification not yet determined. This is a temporary enumeration
361 * for the processing of API submitted by some contributors.
362 */
363 UNSPECIFIED
364 }