org.gvsig.raster.netcdf.io

Class NetCDFProvider

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

org.gvsig.raster.impl.provider.AbstractRasterProvider

org.gvsig.raster.netcdf.io.NetCDFProvider

All Implemented Interfaces:

Histogramable, DataStoreProvider, CoverageStoreProvider, RasterProvider, Disposable, DynObject

public class NetCDFProvider
extends AbstractRasterProvider

Data provider for NetCDF files with raster data

Field Summary

Fields

Modifier and Type	Field and Description
static String	DESCRIPTION
protected static String[]	formatList
String	METADATA_DEFINITION_NAME
static String	NAME

Fields inherited from class org.gvsig.raster.impl.provider.AbstractRasterProvider

ALPHA_BAND, bandCount, BLUE_BAND, bytesReaded, colorTable, externalTransformation, fileSize, fileUtil, geoPointList, GREEN_BAND, histogram, lineCnt, noData, ownTransformation, param, proj, rasterUtil, RED_BAND, rmfBlocksManager, selectedSubdatasetID, serialInfo, stats, storeServices, transparency, uri

Fields inherited from class org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

metadata, parameters, store

Constructor Summary

Constructors

Constructor and Description
NetCDFProvider()
NetCDFProvider(NetCDFDataParameters params, DataStoreProviderServices storeServices)
NetCDFProvider(String params) Deprecated. use NetCDFProvider(URI), this constructor will be removed in gvSIG 2.5
NetCDFProvider(URI uri) Opens the dataset.

Method Summary

Methods

Modifier and Type	Method and Description
void	addFile(File file) Adds a new file.
void	close() Request to close de source
int	getBlockSize()
ColorInterpretation	getColorInterpretation() Gets the object with the color interpretation by band
Object	getData(int x, int y, int band) Obtiene el valor del raster en la coordenada que se le pasa.
String[]	getFormatList() Gets the list of supported formats
double	getHeight() Obtiene el ancho de la imagen
int	getOverviewCount(int band) Obtiene el número de overviews de una banda
int	getOverviewHeight(int band, int overview) Obtiene el alto de una overview de una banda
int	getOverviewWidth(int band, int overview) Obtiene el ancho de una overview de una banda
String	getProviderName() Return the name of the provider.
TileServer	getTileServer() Gets the tile cache data server
DataStoreTransparency	getTransparency() Obtiene el estado de transparencia a partir de los estados de transparencia de todos los ficheros que lo componen.
Extent	getView() Obtiene el extent asignado
double	getWidth() Obtiene el ancho de la imagen
void	init(NetCDFDataParameters params, DataStoreProviderServices storeServices) Build file references
boolean	isExtensionSupported(String ext) Returns true if the extension is supported and false if doesn't
boolean	isOpen() Returns true if this provider is open and false if don't
boolean	isOverviewsSupported() Informa de si el dataset soporta overviews o no.
boolean	isReproyectable() Devuelve si el Dataset es reproyectable
boolean	isSupersampling() Informa de si el driver ha supersampleado en el �ltimo dibujado.
boolean	isTimeSupported() Returns true if this provider supports time.
RasterProvider	load() Carga un fichero raster.
void	loadBuffer(SpiRasterQuery query) Load a buffer with the parameters.
Object	readBlock(int pos, int blockHeight, double scale) Reads a complete block of data and returns an tridimensional array of the right type.
static void	register()
void	removeFile(File file) Removes a file.
void	selectSubdataset() Selects the GridDataType using the selected variable in the parameters
void	setAffineTransform(AffineTransform t) Asigna una transformación al raster para que se tenga en cuenta en la asignación del setView.
void	setStatus(RasterProvider provider) Sets the status information using other provider of the same type.
void	setView(Extent e) Asigna el extent de la vista actual. existe un fichero .rmf debemos hacer una transformaci�n de la vista asignada ya que la petici�n viene en coordenadas del fichero .rmf y la vista (v) ha de estar en coordenadas del fichero.
URI	translateURI(URI uri) Traduce el nombre del fichero por un alias asignado por el propio driver.

Methods inherited from class org.gvsig.raster.impl.provider.AbstractRasterProvider

cloneProvider, deleteLayerFromCache, doDispose, finalize, getAffineTransform, getBandCount, getBandCountByProvider, getBandPositionByProvider, getCellSize, getChilds, getColorTable, getDataParameters, getDataSet, getDataType, getDefaultBandList, getExplorer, getExtent, getExtentWithoutRot, getFileSize, getFileSizeByProvider, getFileSuffix, getFullName, getGeoPointList, getHistogramComputer, getImageLegend, getInfoByPoint, getInfoByPoint, getInternalProvider, getInternalProviderCount, getInterval, getMetadata, getName, getNoDataValue, getOwnAffineTransform, getPixelSizeX, getPixelSizeY, getProjection, getResource, getRmfBlocksManager, getRMFFile, getRMFFileForRemoteServices, getSourceId, getSourceType, getStatistics, getSubdatasetCount, getTileSize, getTime, getTimes, getTimes, getTimeSerials, getURI, getURIByBand, getURIByProvider, getURIOfFirstProvider, getWktProjection, init, isARGB, isGeoreferenced, isInside, isMosaic, isMultiFile, isRasterEnclosed, isRGB, isRotated, isTiled, loadFromRmf, loadObjectFromRmf, loadObjectFromRmf, loadObjectFromRmfFile, needEnhanced, newProvider, open, rasterToWorld, reload, resetAffineTransform, saveObjectToRmf, saveObjectToRmf, selectSubdataset, setColorInterpretation, setColorTable, setDataType, setFileSize, setFName, setGeoPointList, setNoDataValue, setParam, setProjection, setStatistics, setTileServer, setTimeSerials, singleDatasetInstance, translateFileName, worldToRaster

Methods inherited from class org.gvsig.fmap.dal.raster.spi.AbstractCoverageStoreProvider

allowWrite, clear, createCoverageSelection, createResource, delegate, getClassName, getDataStoreParameters, getDynClass, getDynValue, getEnvelope, getStoreServices, hasDynValue, implement, init, invokeDynMethod, invokeDynMethod, refresh, setDynValue, setMetadata

Methods inherited from class org.gvsig.tools.dispose.impl.AbstractDisposable

dispose, dispose

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gvsig.fmap.dal.raster.spi.CoverageStoreProvider

allowWrite, getStoreServices

Methods inherited from interface org.gvsig.fmap.dal.spi.DataStoreProvider

refresh

Methods inherited from interface org.gvsig.tools.dynobject.DynObject

clear, delegate, getDynClass, getDynValue, hasDynValue, implement, invokeDynMethod, invokeDynMethod, setDynValue

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Field Detail

NAME

public static String NAME

DESCRIPTION

public static String DESCRIPTION

METADATA_DEFINITION_NAME

public final String METADATA_DEFINITION_NAME

formatList

protected static String[] formatList

Constructor Detail

NetCDFProvider

public NetCDFProvider()

NetCDFProvider

public NetCDFProvider(String params)
               throws NotSupportedExtensionException,
                      OpenException

Deprecated. use NetCDFProvider(URI), this constructor will be removed in gvSIG 2.5

Opens the dataset.

Parameters:

proj - Projection

fName - File name

Throws:

NotSupportedExtensionException

OpenException

NetCDFProvider

public NetCDFProvider(URI uri)
               throws NotSupportedExtensionException,
                      OpenException

Opens the dataset.

Parameters:

proj - Projection

fName - File name

Throws:

NotSupportedExtensionException

OpenException

NetCDFProvider

public NetCDFProvider(NetCDFDataParameters params,
              DataStoreProviderServices storeServices)
               throws NotSupportedExtensionException,
                      OpenException

Throws:

NotSupportedExtensionException

OpenException

Method Detail

register

public static void register()

getFormatList

public String[] getFormatList()

Description copied from interface: RasterProvider

Gets the list of supported formats

Specified by:

getFormatList in interface RasterProvider

Overrides:

getFormatList in class AbstractRasterProvider

Returns:

isExtensionSupported

public boolean isExtensionSupported(String ext)

Returns true if the extension is supported and false if doesn't

Parameters:

ext -

Returns:

init

public void init(NetCDFDataParameters params,
        DataStoreProviderServices storeServices)
          throws NotSupportedExtensionException,
                 OpenException

Build file references

Parameters:

proj - Projection

param - Load parameters

Throws:

NotSupportedExtensionException

OpenException

load

public RasterProvider load()

Description copied from class: AbstractRasterProvider

Carga un fichero raster. Puede usarse para calcular el extent e instanciar un objeto de este tipo.

Specified by:

load in class AbstractRasterProvider

Returns:

RasterProvider

isOpen

public boolean isOpen()

Description copied from interface: RasterProvider

Returns true if this provider is open and false if don't

Returns:

close

public void close()

Description copied from interface: DataStoreProvider

Request to close de source

Specified by:

close in interface RasterProvider

Overrides:

close in class AbstractRasterProvider

translateURI

public URI translateURI(URI uri)

Description copied from class: AbstractRasterProvider

Traduce el nombre del fichero por un alias asignado por el propio driver. Cuando es traducido por un alias el driver intentar� abrir el alias y no el fichero. Esto es util porque algunos formatos tienen la extensi�n en el fichero de cabecera pero lo que se abre realmente es el fichero de datos.

Overrides:

translateURI in class AbstractRasterProvider

Returns:

uri

setView

public void setView(Extent e)

Asigna el extent de la vista actual. existe un fichero .rmf debemos hacer una transformaci�n de la vista asignada ya que la petici�n viene en coordenadas del fichero .rmf y la vista (v) ha de estar en coordenadas del fichero.

Specified by:

setView in class AbstractRasterProvider

Parameters:

e - Extent

getView

public Extent getView()

Description copied from class: AbstractRasterProvider

Obtiene el extent asignado

Specified by:

getView in interface RasterProvider

Specified by:

getView in class AbstractRasterProvider

Returns:

Extent

getWidth

public double getWidth()

Description copied from class: AbstractRasterProvider

Obtiene el ancho de la imagen

Specified by:

getWidth in interface RasterProvider

Specified by:

getWidth in class AbstractRasterProvider

Returns:

Ancho de la imagen

getHeight

public double getHeight()

Description copied from class: AbstractRasterProvider

Obtiene el ancho de la imagen

Specified by:

getHeight in interface RasterProvider

Specified by:

getHeight in class AbstractRasterProvider

Returns:

Ancho de la imagen

readBlock

public Object readBlock(int pos,
               int blockHeight,
               double scale)
                 throws InvalidSetViewException,
                        FileNotOpenException,
                        RasterDriverException,
                        ProcessInterruptedException

Description copied from interface: RasterProvider

Reads a complete block of data and returns an tridimensional array of the right type. This function is useful to read a file very fast without setting a view.

Throws:

InvalidSetViewException

FileNotOpenException

RasterDriverException

ProcessInterruptedException

getData

public Object getData(int x,
             int y,
             int band)
               throws InvalidSetViewException,
                      FileNotOpenException,
                      RasterDriverException

Description copied from class: AbstractRasterProvider

Obtiene el valor del raster en la coordenada que se le pasa. El valor será Double, Int, Byte, etc. dependiendo del tipo de raster.

Specified by:

getData in interface RasterProvider

Specified by:

getData in class AbstractRasterProvider

Parameters:

x - coordenada X

y - coordenada Y

Returns:

data

Throws:

InvalidSetViewException

FileNotOpenException

RasterDriverException

loadBuffer

public void loadBuffer(SpiRasterQuery query)
                throws ProcessInterruptedException,
                       RasterDriverException

Description copied from class: AbstractRasterProvider

Load a buffer with the parameters. The buffer should already have been created inside the query structure SpiRasterQuery by the RasterDataStore. The other parameters have been calculated too, all of them adjusted to the raster limits. The provider only have to read the parameters and load the buffer.

Specified by:

loadBuffer in class AbstractRasterProvider

Throws:

ProcessInterruptedException

RasterDriverException

selectSubdataset

public void selectSubdataset()

Selects the GridDataType using the selected variable in the parameters

Specified by:

selectSubdataset in interface RasterProvider

Overrides:

selectSubdataset in class AbstractRasterProvider

getBlockSize

public int getBlockSize()

Specified by:

getBlockSize in class AbstractRasterProvider

getColorInterpretation

public ColorInterpretation getColorInterpretation()

Description copied from interface: RasterProvider

Gets the object with the color interpretation by band

Specified by:

getColorInterpretation in interface RasterProvider

Overrides:

getColorInterpretation in class AbstractRasterProvider

Returns:

ColorInterpretation

getTransparency

public DataStoreTransparency getTransparency()

Description copied from interface: RasterProvider

Obtiene el estado de transparencia a partir de los estados de transparencia de todos los ficheros que lo componen. Si varios de los ficheros que lo componen tienen banda de transparencia estas tendrán que ser mezcladas sobre una banda de transparencia única.

Specified by:

getTransparency in interface RasterProvider

Overrides:

getTransparency in class AbstractRasterProvider

Returns:

Objeto FileTransparency con el estado de transparencia

isSupersampling

public boolean isSupersampling()

Informa de si el driver ha supersampleado en el �ltimo dibujado. Es el driver el que colocar� el valor de esta variable cada vez que dibuja.

Returns:

true si se ha supersampleado y false si no se ha hecho.

setAffineTransform

public void setAffineTransform(AffineTransform t)

Description copied from interface: RasterProvider

Asigna una transformación al raster para que se tenga en cuenta en la asignación del setView. Esta asignación recalcula el extent, el requestExtent y asigna el AffineTransform que se usará para la transformación. Esta transformación será considerada como si la imagen tuviera asociado un rmf.

Specified by:

setAffineTransform in interface RasterProvider

Overrides:

setAffineTransform in class AbstractRasterProvider

Parameters:

t - Transformación afín a aplicar

getOverviewCount

public int getOverviewCount(int band)
                     throws BandAccessException,
                            RasterDriverException

Description copied from interface: RasterProvider

Obtiene el número de overviews de una banda

Returns:

Throws:

BandAccessException

RasterDriverException

getOverviewWidth

public int getOverviewWidth(int band,
                   int overview)
                     throws BandAccessException,
                            RasterDriverException

Description copied from interface: RasterProvider

Obtiene el ancho de una overview de una banda

Specified by:

getOverviewWidth in interface RasterProvider

Specified by:

getOverviewWidth in class AbstractRasterProvider

Returns:

Throws:

BandAccessException

RasterDriverException

getOverviewHeight

public int getOverviewHeight(int band,
                    int overview)
                      throws BandAccessException,
                             RasterDriverException

Description copied from interface: RasterProvider

Obtiene el alto de una overview de una banda

Specified by:

getOverviewHeight in interface RasterProvider

Specified by:

getOverviewHeight in class AbstractRasterProvider

Returns:

Throws:

BandAccessException

RasterDriverException

isOverviewsSupported

public boolean isOverviewsSupported()

Description copied from class: AbstractRasterProvider

Informa de si el dataset soporta overviews o no.

Specified by:

isOverviewsSupported in interface RasterProvider

Specified by:

isOverviewsSupported in class AbstractRasterProvider

Returns:

true si soporta overviews y false si no las soporta.

isReproyectable

public boolean isReproyectable()

Description copied from class: AbstractRasterProvider

Devuelve si el Dataset es reproyectable

Specified by:

isReproyectable in interface RasterProvider

Overrides:

isReproyectable in class AbstractRasterProvider

Returns:

true if Dataset is reproyectable

getProviderName

public String getProviderName()

Description copied from interface: DataStoreProvider

Return the name of the provider. Examples: dbf, shp, jdbc, postgresql, wfs, gml

Returns:

setStatus

public void setStatus(RasterProvider provider)

Description copied from interface: RasterProvider

Sets the status information using other provider of the same type. The first action of this method should be to check the type of the parameter.

isTimeSupported

public boolean isTimeSupported()

Description copied from interface: RasterProvider

Returns true if this provider supports time.

Specified by:

isTimeSupported in interface RasterProvider

Overrides:

isTimeSupported in class AbstractRasterProvider

Returns:

getTileServer

public TileServer getTileServer()

Description copied from interface: RasterProvider

Gets the tile cache data server

Returns:

addFile

public void addFile(File file)
             throws InvalidSourceException

Description copied from interface: RasterProvider

Adds a new file. The behavior of this function depends on the kind of provider and its implementation.

Throws:

InvalidSourceException

removeFile

public void removeFile(File file)

Description copied from interface: RasterProvider

Removes a file. The behavior of this function depends on the kind of provider and its implementation.