org.gvsig.raster.multifile.io

Class MultiFileProvider

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.multifile.io.MultiFileProvider

All Implemented Interfaces:

Histogramable, DataFactoryUnit, DataStoreProvider, CoverageStoreProvider, RasterProvider, Disposable, DynObject, DynObject_v2

public class MultiFileProvider
extends AbstractRasterProvider

A data provider for a multiband image readed from different files

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
MultiFileProvider()
MultiFileProvider(MultiFileDataParametersImpl params, DataStoreProviderServices storeServices)
MultiFileProvider(String params) Deprecated. use MultiFileProvider(URI), this constructor will be removed in gvSIG 2.5
MultiFileProvider(URI uri) Opens the dataset.

Method Summary

Modifier and Type	Method and Description
void	addFile(File file) Adds a new file.
void	addFile(String file)
void	close() Request to close de source
AffineTransform	getAffineTransform() Obtiene la transformación afin aplicada en las peticiones con coordenadas reales.
int	getBandCount() Obtiene el número de bandas del fichero
int[]	getBandCountByProvider() Gets the number of bands by provider.
int	getBandPositionByProvider(int band) Selecting a number of band this function returns the number of band inside the file.
int	getBlockSize()
double	getCellSize() Gets the pixel size
ColorInterpretation	getColorInterpretation() Gets the object with the color interpretation by band
ColorTable	getColorTable() A multiband provider doesn't have a color table because this will have more than one band.
Object	getData(int x, int y, int band) Obtiene el valor del raster en la coordenada que se le pasa.
int[]	getDataType() Obtiene el tipo de dato por banda
Extent	getExtent() Calcula el extent en coordenadas del mundo real
long[]	getFileSizeByProvider() Gets a list of sizes.
double	getHeight() Obtiene el ancho de la imagen
HistogramComputer	getHistogramComputer() Gets the object which computes the histogram
RasterProvider	getInternalProvider(int i) Gets the internal provider of the i position
int	getInternalProviderCount() Returns the number of internal providers that it has
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
MultiFileDataParameters	getParameters()
String	getProviderName() Return the name of the provider.
Statistics	getStatistics() Gets statistics of this 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.
URI	getURIByBand(int band) Gets the URI of the source.
URI[]	getURIByProvider() Gets a list of file names or URI.
URI	getURIOfFirstProvider() Gets the URI of the first provider.
Extent	getView() Obtiene el extent asignado
double	getWidth() Obtiene el ancho de la imagen
void	init(MultiFileDataParameters params, DataStoreProviderServices storeServices) Build file references
boolean	isInside(Point2D p) Informa de si el punto en coordenadas del mundo real pasado por parámetro cae dentro del raster o fuera.
boolean	isMultiFile() Returns true if the provider has several files and all of them has the same extension
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 q) Load a buffer with the parameters.
Point2D	rasterToWorld(Point2D pt) Convierte un punto desde coordenadas pixel a coordenadas del mundo.
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	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.
Point2D	worldToRaster(Point2D pt) Convierte un punto desde del mundo a coordenadas pixel.

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

cloneProvider, deleteLayerFromCache, doDispose, finalize, getChilds, getDataParameters, getDataSet, getDefaultBandList, getExplorer, getExtentWithoutRot, getFileSize, getFileSuffix, getFormatList, getFullName, getGeoPointList, getImageLegend, getInfoByPoint, getInfoByPoint, getInterval, getMetadata, getName, getNoDataValue, getOwnAffineTransform, getPixelSizeX, getPixelSizeY, getProjection, getResource, getRmfBlocksManager, getRMFFile, getRMFFileForRemoteServices, getSourceId, getSourceType, getSubdatasetCount, getTileSize, getTime, getTimes, getTimes, getTimeSerials, getURI, getWktProjection, init, isARGB, isGeoreferenced, isMosaic, isRasterEnclosed, isRGB, isRotated, isTiled, loadFromRmf, loadObjectFromRmf, loadObjectFromRmf, loadObjectFromRmfFile, needEnhanced, newProvider, open, reload, resetAffineTransform, saveObjectToRmf, saveObjectToRmf, selectSubdataset, selectSubdataset, setColorInterpretation, setColorTable, setDataType, setFileSize, setFName, setGeoPointList, setNoDataValue, setParam, setProjection, setStatistics, setTileServer, setTimeSerials, singleDatasetInstance, translateFileName

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

allowWrite, clear, createCoverageSelection, createResource, delegate, getClassName, getDataStoreParameters, getDynClass, getDynValue, getEnvelope, getStoreServices, hasDynMethod, 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_v2

hasDynMethod

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

MultiFileProvider

public MultiFileProvider()

MultiFileProvider

public MultiFileProvider(String params)
                  throws NotSupportedExtensionException,
                         OpenException

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

Opens the dataset.

Parameters:

params -

proj - Projection

fName - File name

Throws:

NotSupportedExtensionException

OpenException

MultiFileProvider

public MultiFileProvider(URI uri)
                  throws NotSupportedExtensionException,
                         OpenException

Opens the dataset.

Parameters:

uri -

proj - Projection

fName - File name

Throws:

NotSupportedExtensionException

OpenException

MultiFileProvider

public MultiFileProvider(MultiFileDataParametersImpl params,
                         DataStoreProviderServices storeServices)
                  throws NotSupportedExtensionException,
                         OpenException

Parameters:

params -

storeServices -

Throws:

NotSupportedExtensionException

OpenException

Method Detail

register

public static void register()

init

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

Build file references

Parameters:

params -

storeServices -

proj - Projection

param - Load parameters

Throws:

NotSupportedExtensionException

OpenException

getParameters

public MultiFileDataParameters getParameters()

Returns:

MultiFileDataParameters

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

getBandCount

public int getBandCount()

Description copied from class: AbstractRasterProvider

Obtiene el número de bandas del fichero

Specified by:

getBandCount in interface RasterProvider

Overrides:

getBandCount in class AbstractRasterProvider

Returns:

Entero que representa el número de bandas

getDataType

public int[] getDataType()

Description copied from interface: RasterProvider

Obtiene el tipo de dato por banda

Specified by:

getDataType in interface RasterProvider

Overrides:

getDataType in class AbstractRasterProvider

Returns:

Returns the dataType.

getURIByProvider

public URI[] getURIByProvider()

Description copied from interface: RasterProvider

Gets a list of file names or URI. Each element of this array is the name of a provider

Specified by:

getURIByProvider in interface RasterProvider

Overrides:

getURIByProvider in class AbstractRasterProvider

Returns:

getBandPositionByProvider

public int getBandPositionByProvider(int band)

Description copied from interface: RasterProvider

Selecting a number of band this function returns the number of band inside the file. If this provider has only one file the result will be band parameter.

Specified by:

getBandPositionByProvider in interface RasterProvider

Overrides:

getBandPositionByProvider in class AbstractRasterProvider

Returns:

getURIOfFirstProvider

public URI getURIOfFirstProvider()

Description copied from interface: RasterProvider

Gets the URI of the first provider.

Specified by:

getURIOfFirstProvider in interface RasterProvider

Overrides:

getURIOfFirstProvider in class AbstractRasterProvider

Returns:

String File name or URI

getExtent

public Extent getExtent()

Description copied from class: AbstractRasterProvider

Calcula el extent en coordenadas del mundo real

Specified by:

getExtent in interface RasterProvider

Overrides:

getExtent in class AbstractRasterProvider

Returns:

Extent

getAffineTransform

public AffineTransform getAffineTransform()

Description copied from interface: RasterProvider

Obtiene la transformación afin aplicada en las peticiones con coordenadas reales. Esta corresponde al producto matricial entre la transformación de la propia georreferenciación del raster (ownTransformation) y la transformación que se le aplique de forma externa. Si esta última no existe será la matriz identidad.

Specified by:

getAffineTransform in interface RasterProvider

Overrides:

getAffineTransform in class AbstractRasterProvider

Returns:

Matriz de la transformación afín.

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

getInternalProviderCount

public int getInternalProviderCount()

Description copied from interface: RasterProvider

Returns the number of internal providers that it has

Specified by:

getInternalProviderCount in interface RasterProvider

Overrides:

getInternalProviderCount in class AbstractRasterProvider

Returns:

getInternalProvider

public RasterProvider getInternalProvider(int i)

Description copied from interface: RasterProvider

Gets the internal provider of the i position

Specified by:

getInternalProvider in interface RasterProvider

Overrides:

getInternalProvider in class AbstractRasterProvider

Returns:

getBandCountByProvider

public int[] getBandCountByProvider()

Description copied from interface: RasterProvider

Gets the number of bands by provider.

Specified by:

getBandCountByProvider in interface RasterProvider

Overrides:

getBandCountByProvider in class AbstractRasterProvider

Returns:

getFileSizeByProvider

public long[] getFileSizeByProvider()

Description copied from interface: RasterProvider

Gets a list of sizes. If the provider doesn't have files it will return null. If the provider has one file it will return an array of one element with the size of this file. If the provider contains others with one file each one.

Specified by:

getFileSizeByProvider in interface RasterProvider

Overrides:

getFileSizeByProvider in class AbstractRasterProvider

Returns:

rasterToWorld

public Point2D rasterToWorld(Point2D pt)

Description copied from class: AbstractRasterProvider

Convierte un punto desde coordenadas pixel a coordenadas del mundo.

Specified by:

rasterToWorld in interface RasterProvider

Overrides:

rasterToWorld in class AbstractRasterProvider

Parameters:

pt - Punto a transformar

Returns:

punto transformado en coordenadas del mundo

worldToRaster

public Point2D worldToRaster(Point2D pt)

Description copied from class: AbstractRasterProvider

Convierte un punto desde del mundo a coordenadas pixel.

Specified by:

worldToRaster in interface RasterProvider

Overrides:

worldToRaster in class AbstractRasterProvider

Parameters:

pt - Punto a transformar

Returns:

punto transformado en coordenadas pixel

isInside

public boolean isInside(Point2D p)

Description copied from interface: RasterProvider

Informa de si el punto en coordenadas del mundo real pasado por parámetro cae dentro del raster o fuera. Para este calculo cogeremos el punto a averiguar si está dentro del raster y le aplicaremos la transformación inversa de la transformación afín aplicada. Una vez hecho esto ya se puede comprobar si está dentro de los límites del extent del raster.

Specified by:

isInside in interface RasterProvider

Overrides:

isInside in class AbstractRasterProvider

Parameters:

p - Punto a comprobar en coordenadas reales

Returns:

true si el punto está dentro y false si está fuera.

getCellSize

public double getCellSize()

Description copied from interface: RasterProvider

Gets the pixel size

Specified by:

getCellSize in interface RasterProvider

Overrides:

getCellSize in class AbstractRasterProvider

Returns:

getStatistics

public Statistics getStatistics()

Description copied from interface: RasterProvider

Gets statistics of this provider

Specified by:

getStatistics in interface RasterProvider

Overrides:

getStatistics in class AbstractRasterProvider

Returns:

MultiFileStatistics

getHistogramComputer

public HistogramComputer getHistogramComputer()

Description copied from interface: Histogramable

Gets the object which computes the histogram

Specified by:

getHistogramComputer in interface Histogramable

Overrides:

getHistogramComputer in class AbstractRasterProvider

Returns:

Histograma

getColorTable

public ColorTable getColorTable()

A multiband provider doesn't have a color table because this will have more than one band.

Specified by:

getColorTable in interface RasterProvider

Overrides:

getColorTable in class AbstractRasterProvider

Returns:

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

loadBuffer

public void loadBuffer(SpiRasterQuery q)
                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

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

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.

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

isMultiFile

public boolean isMultiFile()

Description copied from interface: RasterProvider

Returns true if the provider has several files and all of them has the same extension

Specified by:

isMultiFile in interface RasterProvider

Overrides:

isMultiFile in class AbstractRasterProvider

Returns:

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:

getURIByBand

public URI getURIByBand(int band)

Description copied from interface: RasterProvider

Gets the URI of the source. If the provider has only one band the result will be the URI. If it is multifile will have to choose among several sources.

Specified by:

getURIByBand in interface RasterProvider

Overrides:

getURIByBand in class AbstractRasterProvider

Returns:

addFile

public void addFile(String file)
             throws InvalidSourceException

Parameters:

file -

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.

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