org.opengis.referencing.crs.CompoundCRS Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gt-opengis Show documentation
Standard interfaces implemented throughout the library.
There is a newer version: 24.2-oss84-1
/*
 *    GeoTools - The Open Source Java GIS Toolkit
 *    http://geotools.org
 *
 *    (C) 2011, Open Source Geospatial Foundation (OSGeo)
 *    (C) 2003-2005, Open Geospatial Consortium Inc.
 *
 *    All Rights Reserved. http://www.opengis.org/legal/
 */
package org.opengis.referencing.crs;

import static org.opengis.annotation.Obligation.*;
import static org.opengis.annotation.Specification.*;

import java.util.List;
import org.opengis.annotation.UML;

/**
 * A coordinate reference system describing the position of points through two or more independent
 * coordinate reference systems. Thus it is associated with two or more {@linkplain
 * org.opengis.referencing.cs.CoordinateSystem Coordinate Systems} and {@linkplain
 * org.opengis.referencing.datum.Datum Datums} by defining the compound CRS as an ordered set of two
 * or more instances of {@link CoordinateReferenceSystem}.
 *
 * In general, a Compound CRS may contain any number of axes. The Compound CRS contains an
 * ordered set of coordinate reference systems and the tuple order of a compound coordinate set
 * shall follow that order, while the subsets of the tuple, described by each of the composing
 * coordinate reference systems, follow the tuple order valid for their respective coordinate
 * reference systems.
 *
 * 
For spatial coordinates, a number of constraints exist for the construction of Compound CRSs.
 * For example, the coordinate reference systems that are combined should not contain any duplicate
 * or redundant axes. Valid combinations include:
 *
 * 

 *
 * 

 *   Geographic 2D + Vertical
 *   
Geographic 2D + Engineering 1D (near vertical)
 *   
Projected + Vertical
 *   
Projected + Engineering 1D (near vertical)
 *   
Engineering (horizontal 2D or 1D linear) + Vertical
 * 
 *
 * Any coordinate reference system, or any of the above listed combinations of coordinate
 * reference systems, can have a Temporal CRS added. More than one Temporal CRS may be added if
 * these axes represent different time quantities. For example, the oil industry sometimes uses "4D
 * seismic", by which is meant seismic data with the vertical axis expressed in milliseconds (signal
 * travel time). A second time axis indicates how it changes with time (years), e.g. as a reservoir
 * is gradually exhausted of its recoverable oil or gas).
 *
 * @version Abstract
 *     specification 2.0
 * @author Martin Desruisseaux (IRD)
 * @since GeoAPI 1.0
 */
@UML(identifier = "SC_CompoundCRS", specification = ISO_19111)
public interface CompoundCRS extends CoordinateReferenceSystem {
    /**
     * The ordered list of coordinate reference systems.
     *
     * @return The ordered list of coordinate reference systems.
     */
    @UML(identifier = "includesCRS", obligation = MANDATORY, specification = ISO_19111)
    List getCoordinateReferenceSystems();
}