001/*
002 *    GeoAPI - Java interfaces for OGC/ISO standards
003 *    Copyright © 2003-2023 Open Geospatial Consortium, Inc.
004 *    http://www.geoapi.org
005 *
006 *    Licensed under the Apache License, Version 2.0 (the "License");
007 *    you may not use this file except in compliance with the License.
008 *    You may obtain a copy of the License at
009 *
010 *        http://www.apache.org/licenses/LICENSE-2.0
011 *
012 *    Unless required by applicable law or agreed to in writing, software
013 *    distributed under the License is distributed on an "AS IS" BASIS,
014 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 *    See the License for the specific language governing permissions and
016 *    limitations under the License.
017 */
018package org.opengis.referencing.datum;
019
020import java.util.Map;
021import org.opengis.annotation.UML;
022import static org.opengis.annotation.Specification.*;
023
024
025/**
026 * Identification of the origin of an engineering (or local) coordinate reference system.
027 * An engineering datum is used in a region around that origin.
028 * This origin can be fixed with respect to the planet (such as a defined point at a construction site),
029 * a defined point on a moving object (such as on a road vehicle, vessel, aircraft or spacecraft),
030 * or a point used to describe spatial location internally on an image.
031 *
032 * <p>When used for a region on a planet, engineering <abbr>CRS</abbr>s use a flat-Earth approximation:
033 * corrections for planet-curvature are not applied.
034 * Typical applications are for civil engineering construction and building information management.
035 * Note that these applications are not restricted to using engineering <abbr>CRS</abbr>s:
036 * they often utilize projected and sometimes geodetic <abbr>CRS</abbr>s.</p>
037 *
038 * <p>When used for an image internal coordinates, the <abbr>CRS</abbr> is not georeferenced.
039 * The image can be georeferenced by relating the engineering <abbr>CRS</abbr> to a geodetic
040 * or projected <abbr>CRS</abbr> through a coordinate transformation.</p>
041 *
042 * @author  OGC Topic 2 (for abstract model and documentation)
043 * @author  Martin Desruisseaux (IRD, Geomatys)
044 * @version 3.1
045 * @since   1.0
046 *
047 * @see DatumAuthorityFactory#createEngineeringDatum(String)
048 * @see DatumFactory#createEngineeringDatum(Map)
049 */
050@UML(identifier="EngineeringDatum", specification=ISO_19111)
051public interface EngineeringDatum extends Datum {
052}