Application: gvSIG desktop » gvSIG projections

import org.gvsig.proj.catalogue.CRSCatalogueManager;

    protected CRSCatalogueManager manager;

    protected abstract CRSCatalogueManager createProjectionManager();

import org.gvsig.proj.catalogue.CRSCatalogueManager;

import org.gvsig.proj.catalogue.CoordinateOperationDefinition;

        CRSCatalogueManager manager =

    CRSCatalogueManager {

		public CoordinateOperationDefinition getCSDefinition(String code) {

		public List<CoordinateOperationDefinition> getCoordinateOperations(CRSDefinition source, CRSDefinition target) {

		public List<CoordinateOperationDefinition> getCoordinateOperations(String source, String target) {

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2012 gvSIG Association.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj.catalogue;

import org.gvsig.tools.exception.BaseException;

/**

 * Generic exception thrown in the CoordinateReferenceSystem API when the

 * exception or error

 * may be dealt by the program or the user of the program which is a client of

 * the CoordinateReferenceSystem API.

 * 

 * @see {@link CoordinateReferenceSystemManager}

 * @author gvSIG team.

 * @version $Id$

 */

public class CRSCatalogException extends BaseException {

    private static final long serialVersionUID = 6756475060924237176L;

    private static final String MESSAGE =

        "An error has been produced in the CRSCatalog library";

    private static final String KEY = "_CRSCatalogException";

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <strong>Don't use this constructor in child classes.</strong>

     */

    public CRSCatalogException() {

        super(MESSAGE, KEY, serialVersionUID);

    }

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <p>

     * <strong>Don't use this constructor in child classes.</strong>

     * </p>

     * 

     * @param cause

     *            the original cause of the exception

     */

    public CRSCatalogException(Exception cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

    }

    /**

     * @see BaseException#BaseException(String, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected CRSCatalogException(String message, String key,

        long code) {

        super(message, key, code);

    }

    /**

     * @see BaseException#BaseException(String, Throwable, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param cause

     *            the original cause of the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected CRSCatalogException(String message,

        Throwable cause, String key, long code) {

        super(message, cause, key, code);

    }

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

package org.gvsig.proj.catalogue;

import org.gvsig.proj.catalogue.ref.Extent;

/**

 * A mathematical operation on coordinates that transforms or converts coordinates to

 * another coordinate reference system.

 *

 * <h3>Inverse operation</h3>

 * Many but not all coordinate operations (from

 * {@linkplain CoordinateReferenceSystem coordinate reference system} <var>A</var> to

 * {@linkplain CoordinateReferenceSystem coordinate reference system} <var>B</var>)

 * also uniquely define the inverse operation (from

 * {@linkplain CoordinateReferenceSystem coordinate reference system} <var>B</var> to

 * {@linkplain CoordinateReferenceSystem coordinate reference system} <var>A</var>).

 * In some cases, the operation method algorithm for the inverse operation is the same

 * as for the forward algorithm, but the signs of some operation parameter values must

 * be reversed. In other cases, different algorithms are required for the forward and

 * inverse operations, but the same operation parameter values are used. If (some)

 * entirely different parameter values are needed, a different coordinate operation

 * shall be defined.

 *

 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to

 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans

 * to evolve these interfaces to adapt them to future GeoAPI versions.

 * 

 * @author  gvSIG Team

 * @author  Martin Desruisseaux (IRD)

 * @version 3.1

 * @since   1.0

 *

 * @see CoordinateOperationAuthorityFactory#createCoordinateOperation(String)

 * @see CoordinateOperationAuthorityFactory#createFromCoordinateReferenceSystemCodes(String, String)

 * @see CoordinateOperationFactory#createOperation(CoordinateReferenceSystem, CoordinateReferenceSystem)

 */

public interface CoordinateOperationDefinition  extends IdentifiedObject {

    /**

     * Returns the source CRS. The source CRS is mandatory for {@linkplain Transformation transformations} only.

     * {@linkplain Conversion Conversions} may have a source CRS that is not specified here, but through

     * {@link org.opengis.referencing.crs.GeneralDerivedCRS#getBaseCRS()} instead.

     *

     * @return the source CRS, or {@code null} if not available.

     *

     * @see Conversion#getSourceCRS()

     * @see Transformation#getSourceCRS()

     */

    CRSDefinition getSourceCRS();

    /**

     * Returns the target CRS. The target CRS is mandatory for {@linkplain Transformation transformations} only.

     * {@linkplain Conversion Conversions} may have a target CRS that is not specified here, but through

     * {@link org.opengis.referencing.crs.GeneralDerivedCRS} instead.

     *

     * @return the target CRS, or {@code null} if not available.

     *

     * @see Conversion#getTargetCRS()

     * @see Transformation#getTargetCRS()

     */

    CRSDefinition getTargetCRS();

    /**

     * Version of the coordinate transformation (i.e., instantiation due to the stochastic

     * nature of the parameters). Mandatory when describing a transformation, and should not

     * be supplied for a conversion.

     *

     * @return the coordinate operation version, or {@code null} in none.

     */

    String getOperationVersion();

    /**

     * Area or region or timeframe in which this coordinate operation is valid.

     *

     * @return the coordinate operation valid domain, or {@code null} if not available.

     *

     * @since 2.1

     */

    Extent getDomainOfValidity();

    /**

     * Description of domain of usage, or limitations of usage, for which this operation is valid.

     *

     * @return a description of domain of usage, or {@code null} if none.

     *

     * @departure historic

     *   This method has been kept conformant with the specification published in 2003.

     *   The revision published in 2007 replaced the singleton by a collection and changed the

     *   obligation from "optional" to "mandatory", requiring a return value of

     *   <cite>"not known"</cite> if the scope is unknown. This change is still under review.

     */

    String getScope();

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2012 gvSIG Association.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj.catalogue;

/**

 * Exception thrown when there is a {@link CoordinateReferenceSystem} is not

 * found.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class CoordinateOperationNotFoundException extends

    CRSCatalogException {

	private static final long serialVersionUID = -5936207106375683418L;

	private static final String MESSAGE =

        "The coordinate operation with Authority: %(authority) "

            + "and Code: %(code) is not available";

    private static final String KEY = "_CoordinateOperationNotFoundException";

    /**

     * Creates a new {@link CoordinateOperationNotFoundException}.

     * 

     * @param cause

     *            the original cause

     */

    public CoordinateOperationNotFoundException(String authority,

        String code) {

        super(MESSAGE, KEY, serialVersionUID);

        setValue("authority", authority);

        setValue("code", code);

    }

    /**

     * Creates a new {@link CoordinateOperationNotFoundException}.

     * 

     * @param cause

     *            the original cause

     */

    public CoordinateOperationNotFoundException(String authority,

        String code, Throwable cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

        setValue("authority", authority);

        setValue("code", code);

    }

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2012 gvSIG Association.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj.catalogue;

import java.io.File;

import java.util.List;

import org.gvsig.tools.dynobject.DynObject;

/**

 * This class is responsible of the management of the CoordinateReferenceSystem

 * library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link CoordinateReferenceSystem}s.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface CRSCatalogueManager {

	/**

	 * Returns a List of String values with the available authority names.

	 * 

	 * @return the available authority names

	 */

	List<String> getAuthorityNames();

	/**

	 * Returns a List of String values with the codes available for all the

	 * available authorities

	 *

	 * @return the list of available codes, using the AUTHORITY:CODE format

	 */

	List<String> getCodes();

	/**

	 * Returns a List of String values with the codes available for a given

	 * Authority,

	 * 

	 * @param authorityName

	 *            name of the authority to get the codes of

	 * @return the list of available codes, using the AUTHORITY:CODE format

	 */

	List<String> getCodes(String authorityName);

	/**

	 * Returns a list of codes that match the provided search string.

	 * Examples of valid searchString: "4326", "EPSG:4326", "ESRI:4326", etc.

	 * Depending on the implementation of the catalogue, it may search only

	 * codes or it may search on several CRS fields (name, description,

	 * area description, etc)

	 * 

	 * @param searchString

	 * @return

	 */

	List<String> search(String searchString);

	/**

	 * Returns a list of codes that match the provided search string.

	 * Examples of valid searchString: "4326", "EPSG:4326", "ESRI:4326", etc.

	 * Depending on the implementation of the catalog, it may only search for

	 * codes or it may search on several CRS fields (name, description,

	 * area description, etc)

	 * 

	 * @param searchString

	 * @return

	 */

	List<String> search(String authority, String searchString);

	/**

	 * Gets the CRSDefinition for the provided code

	 * @param code The CRS code (e.g. "EPSG:4326", "ESRI:4326")

	 * 

	 * @return

	 */

	CRSDefinition getCRSDefinition(String code);

	/**

	 * Parses the provided WKT CRS definition to create a

	 * CRSDefinition object 

	 * @param wkt The WKT CRS definition

	 * 

	 * @return

	 */

	CRSDefinition getCRSDefinitionFromWKT(String wkt);

	/**

	 * Gets the CoordinateOperationDefinition for the provided code

	 * @param code The operation code (e.g. "EPSG:1633", "EPSG:1632")

	 * 

	 * @return

	 */

	CoordinateOperationDefinition getCSDefinition(String code);

	/**

	 * Register a user-defined CRS.

	 * 

	 * @param crs an instance of the CRS to register

	 * @param description A human-readable description of the CRS

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 */

/*	String registerCoordinateReferenceSystem(CoordinateReferenceSystem crs, String description);

*/

	/**

	 * Register a user-defined CRS from an WKT definition

	 * 

	 * @param wktDefinition The WKT definition of the CRS to register

	 * @param description A human-readable description of the CRS

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 */

	String registerCoordinateReferenceSystem(String wktDefinition, String description);

	/**

	 * Register a user-defined coordinate operation

	 * 

	 * @param wktDefinition The WKT definition of the operation to register

	 * @param description A human-readable description of the CRS

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 */

	String registerCoordinateOperation(String wktDefinition, String description);

	/**

	 * Register a user-defined coordinate transformation using the Position

	 * Vector Transformation method

	 * 

	 * @param definition The WKT definition of the operation to register

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 * @see #registerCoordinateTransformationCFR(String, String, String, float, float, float, float, float, float, float)

	 */

	String registerCoordinateTransformationPVT(String sourceCRS, String targetCRS,

			String description,

			float xTraslation, float yTraslation, float zTraslation,

			float xRotation, float yRotation, float zRotation,

			float scaleDifference);

	/**

	 * Register a user-defined coordinate transformation using the Coordinate

	 * Frame Rotation method

	 * 

	 * @param definition The WKT definition of the operation to register

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 * @see #registerCoordinateTransformationPVT(String, String, String, float, float, float, float, float, float, float)

	 */

	String registerCoordinateTransformationCFR(String sourceCRS, String targetCRS,

			String description,

			float xTraslation, float yTraslation, float zTraslation,

			float xRotation, float yRotation, float zRotation,

			float scaleDifference);

	/**

	 * Register a user-defined coordinate transformation using a

	 * transformation grid in NTv2 format

	 * 

	 * @param definition The WKT definition of the operation to register

	 * @return The code assigned to the registered CRS on the USER

	 * namespace

	 */

	String registerCoordinateTransformation(String sourceCRS, String targetCRS,

			String description, File ntv2Grid);

	/**

	 * Gets the list of available CoordinatesOperations to transform or

	 * convert coordinates from the source CoordinateReferenceSystem to

	 * the target one. 

	 * @param source

	 * @param target

	 * @return

	 */

	List<CoordinateOperationDefinition> getCoordinateOperations(CRSDefinition source, CRSDefinition target);

	/**

	 * Gets the list of available CoordinatesOperations to transform or

	 * convert coordinates from the source CoordinateReferenceSystem to

	 * the target one.

	 * 

	 * @param source The code of the source CRS (e.g. "ESPG:25830")

	 * @param target The code of the target CRS (e.g. "ESPG:4230")

	 * @return

	 */

	List<CoordinateOperationDefinition> getCoordinateOperations(String source, String target);

	/**

	 * Creates the parameters needed to initialize the manager.

	 * 

	 * @return the initialization parameters

	 */

	DynObject createParameters();

	/**

	 * Initializes the manager with the given parameters.

	 * 

	 * @param parameters

	 *            to initialize the manager

	 */

	void initialize(DynObject parameters);

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2012 gvSIG Association.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj.catalogue;

/**

 * Exception thrown when there is a {@link CoordinateReferenceSystem} is not

 * found.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class CoordinateReferenceSystemNotFoundException extends

    CRSCatalogException {

    private static final long serialVersionUID = -4051458353306878010L;

    private static final String MESSAGE =

        "The projection with Authority: %(authority) "

            + "and Code: %(code) is not available";

    private static final String KEY = "_ProjectionNotFoundException";

    /**

     * Creates a new {@link CoordinateReferenceSystemNotFoundException}.

     * 

     * @param cause

     *            the original cause

     */

    public CoordinateReferenceSystemNotFoundException(String authority,

        String code) {

        super(MESSAGE, KEY, serialVersionUID);

        setValue("authority", authority);

        setValue("code", code);

    }

    /**

     * Creates a new {@link CoordinateReferenceSystemNotFoundException}.

     * 

     * @param cause

     *            the original cause

     */

    public CoordinateReferenceSystemNotFoundException(String authority,

        String code, Throwable cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

        setValue("authority", authority);

        setValue("code", code);

    }

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

package org.gvsig.proj.catalogue;

import java.util.Set;

public interface IdentifiedObject {

    /**

     * An identifier which references elsewhere the object's defining information.

     * Alternatively an identifier by which this object can be referenced.

     *

     * @return this object identifiers, or an empty collection if there is none.

     */

    Set<String> getIdentifiers();

    /**

     * Gets the identifier which was used to instantiate the object, or the

     * identifier that more closely matches the information used to instantiate

     * the object (e.g. in case of dialect differences)

     */

    String getIdentifier();

    /**

     * Comments on or information about this object, including data source information.

     *

     * @return the remarks, or {@code null} if none.

     */

    String getRemarks();

    /**

     * Returns a <cite>Well-Known Text</cite> (WKT) for this object.

     * Well-Known Texts (WKT) may come in two formats:

     *

     * <ul>

     *   <li>The current standard, WKT 2, is defined by ISO 19162.</li>

     *   <li>The legacy format, WKT 1, was defined by {@linkplain org.opengis.annotation.Specification#OGC_01009 OGC 01-009}

     *       and is shown using Extended Backus Naur Form (EBNF) <a href="doc-files/WKT.html">here</a>.</li>

     * </ul>

     *

     * Implementations are encouraged to format according the most recent standard.

     * This operation may fail if unsupported or if this instance contains elements that do not have

     * WKT representation.

     *

     * @return the Well-Known Text (WKT) for this object.

     * @throws UnsupportedOperationException if this object can not be formatted as WKT.

     *

     * @departure extension

     *   This method is not part of the OGC specification. It has been added in order to provide

     *   the converse of the <code>CRSFactory.createFromWKT(String)</code> method, which is

     *   defined in OGC 01-009.

     *

     * @see org.opengis.referencing.crs.CRSFactory#createFromWKT(String)

     */

	String toWKT() throws UnsupportedOperationException;

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

 package org.gvsig.proj.catalogue.datum;

/**

 * A textual description and/or a set of parameters identifying a particular reference level

 * surface used as a zero-height surface. The description includes its position with respect

 * to the Earth for any of the height types recognized by this standard.

 *

 * <p>There are several types of Vertical Datums, and each may place constraints on the

 * {@linkplain org.opengis.referencing.cs.CoordinateSystemAxis Coordinate Axis} with which

 * it is combined to create a {@linkplain org.opengis.referencing.crs.VerticalCRS Vertical CRS}.</p>

 *

 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to

 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans

 * to evolve these interfaces to adapt them to future GeoAPI versions.

 * 

 * @author  gvSIG Team

 * @author  Martin Desruisseaux (IRD)

 * @version 3.0

 * @since   1.0

 *

 * @see DatumAuthorityFactory#createVerticalDatum(String)

 * @see DatumFactory#createVerticalDatum(Map, VerticalDatumType)

 */

public interface VerticalDatum extends Datum {

    /**

     * The type of this vertical datum.

     *

     * @departure historic

     *   This attribute is kept conformant with the specification published in 2003.

     *   The 2007 revision of ISO 19111 removed this attribute, since this information

     *   can be encoded in the <cite>anchor definition</cite>. However GeoAPI keep this attribute

     *   for historical reasons, and because it provides some of the anchor definition information

     *   in a programmatic way more suitable to coordinate transformation engines.

     *

     * @return the type of this vertical datum.

     *

     * @see #getAnchorPoint()

     */

	VerticalDatumType getVerticalDatumType();

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

package org.gvsig.proj.catalogue.datum;

/**

 * Defines the origin of an engineering coordinate reference system. An engineering datum is used

 * in a region around that origin. This origin can be fixed with respect to the earth (such as a

 * defined point at a construction site), or be a defined point on a moving vehicle (such as on a

 * ship or satellite).

 *

 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to

 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans

 * to evolve these interfaces to adapt them to future GeoAPI versions.

 * 

 * @author  gvSIG Team

 * @author  Martin Desruisseaux (IRD)

 * @version 3.0

 * @since   1.0

 *

 * @see DatumAuthorityFactory#createEngineeringDatum(String)

 * @see DatumFactory#createEngineeringDatum(Map)

 */

public interface EngineeringDatum extends Datum {

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2018 gvSIG Association.

 * 

 * This file has been adapted from GeoAPI, see 

 * the original copyright headers bellow.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 * 

 * ----------

 * 

 *    GeoAPI - Java interfaces for OGC/ISO standards

 *    http://www.geoapi.org

 *

 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.

 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal

 *

 *    Permission to use, copy, and modify this software and its documentation, with

 *    or without modification, for any purpose and without fee or royalty is hereby

 *    granted, provided that you include the following on ALL copies of the software

 *    and documentation or portions thereof, including modifications, that you make:

 *

 *    1. The full text of this NOTICE in a location viewable to users of the

 *       redistributed or derivative work.

 *    2. Notice of any changes or modifications to the OGC files, including the

 *       date changes were made.

 *

 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE

 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED

 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT

 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY

 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

 *

 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR

 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.

 *

 *    The name and trademarks of copyright holders may NOT be used in advertising or

 *    publicity pertaining to the software without specific, written prior permission.

 *    Title to copyright in this software and any associated documentation will at all

 *    times remain with copyright holders.

 */

package org.gvsig.proj.catalogue.datum;

/**

 * Defines the location and precise orientation in 3-dimensional space of a defined ellipsoid

 * (or sphere) that approximates the shape of the earth. Used also for Cartesian coordinate

 * system centered in this ellipsoid (or sphere).

 * 

 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to

 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans

 * to evolve these interfaces to adapt them to future GeoAPI versions.

 * 

 * @author  gvSIG Team

 * @author  Martin Desruisseaux (IRD)

 * @version 3.0

 * @since   1.0

 *

 * @see Ellipsoid

 * @see PrimeMeridian

 *

 * @see DatumAuthorityFactory#createGeodeticDatum(String)

 * @see DatumFactory#createGeodeticDatum(Map, Ellipsoid, PrimeMeridian)

 */

public interface GeodeticDatum extends Datum {

    /**

     * Returns the ellipsoid.

     *

     * @return the ellipsoid.

     */

    Ellipsoid getEllipsoid();

    /**

     * Returns the prime meridian.

     *

     * @return the prime meridian.

     */

PrimeMeridian getPrimeMeridian();

}

 * by the concept of "{@linkplain GeodeticDatum geodetic datum}". A change of size, shape, position

 *   

 * @departure constraint

 *   ISO 19111 defines the union named <code>secondDefiningParameter</code>

 *   as being either <code>semiMinorAxis</code> or <code>inverseFlattening</code>.

 *   The <code>union</code> construct (defined in some languages like C/C++) does not exist in Java.

 *   GeoAPI changed the interface to require both ellipsoidal parameters (in addition to the <code>semiMajorAxis</code>

 *   parameter which is mandatory in any case), as was done in <a href="http://www.opengeospatial.org/standards/ct">OGC 01-009</a>.

 *   However, implementors could readily permit users to only provide one of the two parameters

 *   by creating a class which calculates the second parameter from the first.

 *   For precision, GeoAPI imports the <code>isIvfDefinitive</code> attribute from OGC 01-009

 *   to enable the user to establish which of the two parameters was used to define the instance.

 * @version 3.0.1

 * @since   1.0

 *

 * @see DatumAuthorityFactory#createEllipsoid(String)

 * @see DatumFactory#createEllipsoid(Map, double, double, Unit)

 * @see DatumFactory#createFlattenedSphere(Map, double, double, Unit)

 *

 * <p>Constraints:</p>

 * <ul>

 *   <li>If the prime meridian {@linkplain #getName() name} is "Greenwich" then the value of

 *       {@linkplain #getGreenwichLongitude() Greenwich longitude} shall be 0 degrees.</li>

 *   <li>Conversely if the Greenwich longitude value is zero, then the prime meridian name

 *       shall be "Greenwich".</li>

 * </ul>

 * @version 3.0.1

 * @since   1.0

 *

 * @see DatumAuthorityFactory#createPrimeMeridian(String)

 * @see DatumFactory#createPrimeMeridian(Map, double, Unit)

     *

     * @departure historic

     *   This attribute is inherited from an older OGC specification.

     *   In ISO 19111, <code>greenwichLongitude</code> is a property of type <code>Angle</code>

     *   rather than <code>double</code>, and the unit of measure is part of the <code>Angle</code> value.

     *

import org.gvsig.proj.catalogue.IdentifiedObject;

import org.gvsig.proj.catalogue.ref.Extent;

 * Specifies the relationship of a {@linkplain org.opengis.referencing.cs.CoordinateSystem coordinate system}

 * to the earth, thus creating a {@linkplain org.opengis.referencing.crs.CoordinateReferenceSystem coordinate

 * reference system}. For {@linkplain org.opengis.referencing.crs.GeocentricCRS geodetic} and

 * {@linkplain org.opengis.referencing.crs.VerticalCRS vertical} coordinate reference systems,

 * the datum relates the coordinate system to the Earth. With other types of coordinate reference systems,

 * coordinate reference system. Each datum subtype can be associated with only specific types of

 * {@linkplain org.opengis.referencing.cs.CoordinateSystem coordinate systems}, documented in their

 * javadoc.</p>

 * @version 3.1

 * @since   1.0

public interface Datum  extends IdentifiedObject {

     *   <li>For a {@link GeodeticDatum}, this anchor may be a point known as the fundamental point,

     *   <li>For an {@link EngineeringDatum}, the anchor may be an identified physical point with the

     *   <li>For an {@link ImageDatum}, the anchor point is usually either the centre of the image or the

     *   <li>For a {@link TemporalDatum}, this attribute is not defined. Instead of the anchor point,

     * @departure historic

     *   This method has been kept conformant with the specification published in 2003 for compatibility reasons.

     *   The revision published in 2007 renamed this property as <code>anchorDefinition</code>.

     *

     *

     * @see VerticalDatum#getVerticalDatumType()

     * <div class="warning"><b>Upcoming API change - temporal schema</b><br>

     * The return type of this method may change in GeoAPI 4.0 release. It may be replaced by a

     * type matching more closely either ISO 19108 (<cite>Temporal Schema</cite>) or ISO 19103.

     * </div>

     *

     * Area or region or timeframe in which this datum is valid.

     * @return the datum valid domain, or {@code null} if not available.

     *

     * @since 2.1

    Extent getDomainOfValidity();

     * Description of domain of usage, or limitations of usage, for which this datum object is valid.

     * @return a description of domain of usage, or {@code null} if none.

     * @departure historic

     *   This method has been kept conformant with the specification published in 2003. The revision

     *   published in 2007 replaced the singleton by a collection and changed the obligation

     *   from "optional" to "mandatory", requiring a return value of <cite>"not known"</cite>

     *   if the scope is unknown.

    String getScope();

 * @version 3.1

 * @since   1.0

     *

     * @condition Mandatory if {@linkplain #getGeographicElements() geographic element},

     *            {@linkplain #getVerticalElements() vertical element} and

     *            {@linkplain #getTemporalElements() temporal element} are not provided.