Application: gvSIG desktop » gvSIG projections

/**

 * 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.catalog;

import java.io.File;

import java.util.List;

import org.gvsig.proj.catalog.exception.CRSCatalogException;

import org.gvsig.proj.catalog.exception.CoordinateReferenceSystemNotFoundException;

import org.gvsig.proj.catalog.exception.IncompatibleDefinitionException;

/**

 * This class is responsible of the management of the CRSCatalog

 * library's business logic.

 * 

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

 * {@link CRSDefinition}s and {@link TransformationDefinition}s.

 * 

 * @author gvSIG team

 * @author Cesar Martinez Izquierdo

 */

public interface CRSCatalogManager {

        /**

         * 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

         * @throws CoordinateReferenceSystemNotFoundException 

         */

        CRSDefinition getCRSDefinition(String code) throws CoordinateReferenceSystemNotFoundException;

        /**

         * Parses the provided WKT CRS definition to create a

         * CRSDefinition object 

         * @param wkt The WKT CRS definition

         * 

         * @return

         * @throws CoordinateReferenceSystemNotFoundException 

         */

        CRSDefinition getCRSDefinitionFromWKT(String wkt) throws CoordinateReferenceSystemNotFoundException; // anyadir formato

        /**

         * Creates a compound CRS by combining the provided individual

         * CRSDefinitions. 

         * 

         * @param crsList The list of CRSDefinitions to compound

         * @return The definition of the compound CRS

         * @throws CRSCatalogException 

         * 

         * @see CRSType#CompoundCRSType

         * @see CRSDefinition#getComponents()

         * @see CRSDefinition#getType()

         */

        CRSDefinition getCompoundCRS(CRSDefinition... crsList) throws CRSCatalogException;

        /**

         * Gets the TransformationDefinition for the provided code

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

         * 

         * @return

         */

        TransformationDefinition getTransformationDefinition(String code);

        /**

         * Parses the provided WKT transformation definition to create a

         * TransformationDefinition object

         * @param wkt The WKT coordinate operation definition

         * 

         * @return

         */

        TransformationDefinition getTransformationDefinitionFromWKT(String wkt);

        /**

         * 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 registerTransformation(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 TransformationDefinition to transform or

         * convert coordinates from the source CoordinateReferenceSystem to

         * the target one. 

         * @param source

         * @param target

         * @return

         * @throws CRSCatalogException 

         */

        List<TransformationDefinition> getCoordinateTransformations(CRSDefinition source, CRSDefinition target) throws CRSCatalogException;

        /**

         * Gets the list of available TransformationDefinition 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<TransformationDefinition> getCoordinateTransformations(String source, String target) throws CRSCatalogException;

}