org.opengis.gc
Interface GC_GridCoverageExchange

All Superinterfaces:

Remote

public interface GC_GridCoverageExchange
extends Remote

Support for creation of grid coverages from persistent formats as well as exporting a grid coverage to a persistent formats. For example, it allows for creation of grid coverages from the GeoTIFF Well-known binary format and exporting to the GeoTIFF file format. Basic implementations only require creation of grid coverages from a file format or resource.

Since:

1.00

Version:

1.00

Method Summary

GC_GridCoverage	createFromName(String name) Create a new GC_GridCoverage from a grid coverage file.
GC_GridCoverage	createFromSubName(String name, String subName) Create a new GC_GridCoverage from a file where the file contains many grid coverages.
void	exportTo(GC_GridCoverage gridCoverage, String fileFormat, String fileName, GC_Parameter[] creationOptions) Export a grid coverage to a persistent file format.
GC_Format	getFormat(int index) Retrieve information on file formats or resources available with the GC_GridCoverageExchange implementation.
String[]	getMetadataNames() List of metadata keywords for the interface.
String	getMetadataValue(String name) Retrieve the metadata value for a given metadata name.
int	getNumFormats() The number of formats supported by the GC_GridCoverageExchange.
String[]	listSubNames(String name) Retrieve the list of grid coverages contained within the given file or resource.
GC_GridCoverage	move(GC_GridCoverage gridCoverage, CS_CoordinateSystem coordsys, CT_MathTransform gridToCoordinateSystem) Create a new coverage with a different coordinate reference system.

Method Detail

getNumFormats

int getNumFormats()
                  throws RemoteException

The number of formats supported by the GC_GridCoverageExchange.

Returns:

the number of formats supported by the GC_GridCoverageExchange.

Throws:

RemoteException - if a remote method call failed.

getMetadataNames

String[] getMetadataNames()
                          throws RemoteException

List of metadata keywords for the interface. If no metadata is available, the sequnce will be empty.

Returns:

the list of metadata keywords for the interface.

Throws:

RemoteException - if a remote method call failed.

getFormat

GC_Format getFormat(int index)
                    throws RemoteException

Retrieve information on file formats or resources available with the GC_GridCoverageExchange implementation. Indices start at zero.

Parameters:

index - Index for which to retrieve the format information.

Returns:

information on file formats or resources available with the GC_GridCoverageExchange implementation.

Throws:

RemoteException - if a remote method call failed.

getMetadataValue

String getMetadataValue(String name)
                        throws RemoteException

Retrieve the metadata value for a given metadata name.

Parameters:

name - Metadata keyword for which to retrieve metadata.

Returns:

the metadata value for the given metadata name.

Throws:

RemoteException - if a remote method call failed.

createFromName

GC_GridCoverage createFromName(String name)
                               throws RemoteException

Create a new GC_GridCoverage from a grid coverage file. This method is meant to allow implementations to create a GC_GridCoverage. from any file format. An implementation can support any number of formats which is determined from the GC_Format interface.

Parameters:

name - File name (including path) from which to create a grid coverage interface. This file name can be any valid file name within the underlying operating system of the server or a valid string, such as a URL which specifics a grid coverage. Each implementation must determine if file name is valid for it's own use.

Returns:

a new GC_GridCoverage.

Throws:

RemoteException - if a remote method call failed.

listSubNames

String[] listSubNames(String name)
                      throws RemoteException

Retrieve the list of grid coverages contained within the given file or resource. Each grid can have a different coordinate system, number of dimensions and grid geometry. For example, a HDF-EOS file (GRID.HDF) contains 6 grid coverages each having a different projection. An empty sequence will be returned if no sub names exist.

Parameters:

name - File name (including path) from which to retrieve the grid coverage names. This file name can be any valid file name within the underlying operating system of the server or a valid string, such as a URL which specifics a grid coverage. Each implementation must determine if file name is valid for it s own use. Implementations can support many different of file formats.

Returns:

The list of grid coverages contained within the given file or resource.

Throws:

RemoteException - if a remote method call failed.

createFromSubName

GC_GridCoverage createFromSubName(String name,
                                  String subName)
                                  throws RemoteException

Create a new GC_GridCoverage from a file where the file contains many grid coverages. This method is meant to allow implementations to create a GC_GridCoverage from any file format which contains many grid coverages. An example of such a format is HDF-EOS format.

Parameters:

name - File name (including path) from which to create a grid coverage interface. This file name can be any valid file name within the underlying operating system of the server or a valid string, such as a URL which specifics a grid coverage. Each implementation must determine if name is valid for it's own use.

subName - Name of grid coverage contained in file name or resource.

Returns:

a new GC_GridCoverage from a file where the file contains many grid coverages.

Throws:

RemoteException - if a remote method call failed.

exportTo

void exportTo(GC_GridCoverage gridCoverage,
              String fileFormat,
              String fileName,
              GC_Parameter[] creationOptions)
              throws RemoteException

Export a grid coverage to a persistent file format. The file format types are implementation specific. The file format name is determined from the GC_Format interface. Sample file formats include:

   "GeoTIFF"   - GeoTIFF
   "PIX"       - PCI Geomatics PIX
   "HDF-EOS"   - NASA HDF-EOS
   "NITF"      - National Image Transfer Format
   "STDS-DEM"  - Standard Transfer Data Standard
 

Other file format names are implementation dependent.

Parameters:

gridCoverage - Source grid coverage.

fileFormat - String which indicates exported file format.

fileName - File name to store grid coverage. This file name can be any valid file name within the underlying operating system of the server.

creationOptions - Options to use for creating the file. These options are implementation specific are the valid options is determined from the GC_Format interface.

Throws:

RemoteException - if a remote method call failed.

move

GC_GridCoverage move(GC_GridCoverage gridCoverage,
                     CS_CoordinateSystem coordsys,
                     CT_MathTransform gridToCoordinateSystem)
                     throws RemoteException

Create a new coverage with a different coordinate reference system.

Parameters:

gridCoverage - Source grid coverage.

coordsys - Coordinate system of the new grid coverage.

gridToCoordinateSystem - Math transform to assign to grid coverage.

Returns:

a new coverage with a different coordinate reference system.

Throws:

RemoteException - if a remote method call failed.