001/* 002 * GeoAPI - Java interfaces for OGC/ISO standards 003 * http://www.geoapi.org 004 * 005 * Copyright (C) 2011-2019 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 */ 032package org.opengis.test.referencing.gigs; 033 034 035/** 036 * Interpretation of the evaluation results of geospatial aspects of the software. 037 * Different software packages may have implemented functionality and reference data 038 * relating to geospatial integrity in different ways. In order to make a meaningful 039 * comparison possible, this package distinguishes four levels of compliance. 040 * 041 * <blockquote><b>Source:</b> Documentation in this class is derived from the 042 * <a href="http://www.iogp.org/pubs/430-1.pdf">GIGS 430-1</a> document, focusing 043 * on the requirements that can be verified programmatically by this test suite. 044 * See the original GIGS document for the full list of requirements.</blockquote> 045 * 046 * The {@linkplain #BRONZE bronze}, {@linkplain #SILVER silver} and {@linkplain #GOLD gold} 047 * compliance levels are progressively inclusive, in the sense that the silver level implies 048 * compliance to the bronze level and gold implies that the silver level is also achieved. 049 * 050 * @author Martin Desruisseaux (Geomatys) 051 * @version 3.1 052 * @since 3.1 053 */ 054public enum Classification { 055 /** 056 * Intended for software without the capability of performing coordinate operations. 057 * The software does handle spatial data but has no "geodetic engine" that performs 058 * coordinate conversions and transformations. 059 * 060 * <ul> 061 * <li><b>Completeness:</b><ul> 062 * <li>Coordinates are complete, unambiguously defined and are appended with a CRS 063 * identification, specified as a unique reference of the CRS in an (external) 064 * geodetic library or dataset.</li> 065 * </ul></li> 066 * <li><b>Correctness:</b><ul> 067 * <li>Merging and co-visualisation of spatial datasets referenced to different CRSs 068 * in the software’s workspace with imported data are blocked.</li> 069 * <li>The CRS identification is appended to any exported data.</li> 070 * </ul></li> 071 * <li><b>Verifiability:</b><ul> 072 * <li>CRS reference of a geoscience dataset can be inspected at any time during usage 073 * of the software.</li> 074 * </ul></li> 075 * </ul> 076 */ 077 ELEMENTARY, 078 079 /** 080 * Intended for software with a limited capability to perform coordinate operations. 081 * Geospatial integrity is only maintained within the bounds of the software. 082 * Integration or interaction with other geosciances software is likely to lead to 083 * loss of geospatial integrity. 084 * 085 * <ul> 086 * <li><b>Completeness:</b><ul> 087 * <li>Coordinates have a complete and correct CRS identification, updated when 088 * transformed/converted within the software.</li> 089 * <li>The software has an internal geodetic library with correct geodetic parameters 090 * within the confines of the software.</li> 091 * </ul></li> 092 * <li><b>Correctness:</b><ul> 093 * <li>Some methods of the test dataset are covered, transformation and conversion 094 * results are correct as per test dataset criteria.</li> 095 * </ul></li> 096 * <li><b>Verifiability:</b><ul> 097 * <li>CRS reference of spatial datasets and the contents of the geodetic library 098 * can be inspected at any time.</li> 099 * <li>The coordinate transformation applied to any data is identifiable and can be 100 * inspected by the user.</li> 101 * </ul></li> 102 * </ul> 103 */ 104 BRONZE, 105 106 /** 107 * Intended for software with a full capability to perform coordinate operations. 108 * This level indicates that the software establishes and maintains geospatial 109 * integrity to a fully satisfactory degree, based on industry best practices. 110 * The software is suitable for global deployment in the E&P industry. 111 * 112 * <ul> 113 * <li><b>Completeness:</b><ul> 114 * <li>Geodetic library consists of (a complete and consistent subset of) the EPSG dataset. 115 * Support of other industry standards and best practices may be software scope-dependent.</li> 116 * <li>All methods from test dataset are supported.</li> 117 * <li>EPSG data model has been partly implemented; some variations are acceptable, e.g. 118 * "early binding" model.</li> 119 * <li>Concept of "deprecation" is supported.</li> 120 * </ul></li> 121 * <li><b>Correctness:</b><ul> 122 * <li>User can define new geodetic entities.</li> 123 * <li>Geodetic entities are protected by a system of user privileges.</li> 124 * </ul></li> 125 * <li><b>Verifiability:</b><ul> 126 * <li>Audit trail is available to user enabling verification of Original CRS of data and 127 * coordinate transformation applied to Project CRS.</li> 128 * </ul></li> 129 * </ul> 130 */ 131 SILVER, 132 133 /** 134 * Intended for software with an extensive capability to perform coordinate operations. 135 * This level indicates software performance that exceeds the geospatial integrity capabilities 136 * of the silver level by incorporating additional software features that expand the range 137 * of applicability and/or reduce the probability of geospatial integrity violations. 138 * 139 * <ul> 140 * <li><b>Completeness:</b><ul> 141 * <li>Geodetic library consists of (a complete and consistent subset of) the EPSG dataset.</li> 142 * <li>Availability of metadata fields from EPSG dataset other than "deprecation".</li> 143 * <li>More operation methods are supported than are provided in the test dataset.</li> 144 * <li>Late-binding mechanism for coordinate transformations, supported by assistance to 145 * end user to reduce transformation multiplicity, or supported by a software tool 146 * facilitating selection of correct transformation.</li> 147 * </ul></li> 148 * <li><b>Correctness:</b><ul> 149 * <li>EPSG data model has been implemented.</li> 150 * <li>Functionality for following deprecation trail is present.</li> 151 * <li>(Semi-) automatic synchronisation with new releases of EPSG dataset.</li> 152 * </ul></li> 153 * <li><b>Verifiability:</b><ul> 154 * <li>Extensive audit trail available to user enabling verification of Original CRS of 155 * data and coordinate transformation applied to Project CRS.</li> 156 * </ul></li> 157 * </ul> 158 */ 159 GOLD 160}