gr.cite.geoanalytics.geospatial.retrieval

Class GeoTiffReader

java.lang.Object

org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

gr.cite.geoanalytics.geospatial.retrieval.GeoTiffReader

All Implemented Interfaces:

org.geotools.coverage.grid.io.GridCoverage2DReader, org.opengis.coverage.grid.GridCoverageReader

public class GeoTiffReader
extends org.geotools.coverage.grid.io.AbstractGridCoverage2DReader
implements org.geotools.coverage.grid.io.GridCoverage2DReader

this class is responsible for exposing the data and the Georeferencing metadata available to the Geotools library. This reader is heavily based on the capabilities provided by the ImageIO tools and JAI libraries.

Since:

2.1

Author:

Bryce Nordgren, USDA Forest Service, Simone Giannecchini

Field Summary

Fields

Modifier and Type	Field and Description
static String	OVERRIDE_CRS_SWITCH With this java switch I can control whether or not an external PRJ files takes precedence over the internal CRS definition

Fields inherited from class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

closeMe, coverageFactory, coverageName, crs, dtLayout, EPS, gzipped, highestRes, hints, inStream, inStreamSPI, numOverviews, originalEnvelope, originalGridRange, overViewResolutions, raster2Model, source

Fields inherited from interface org.geotools.coverage.grid.io.GridCoverage2DReader

ELEVATION_DOMAIN, ELEVATION_DOMAIN_MAXIMUM, ELEVATION_DOMAIN_MINIMUM, ELEVATION_DOMAIN_RESOLUTION, FILE_SOURCE_PROPERTY, HAS_ELEVATION_DOMAIN, HAS_TIME_DOMAIN, REPROJECTING_READER, TIME_DOMAIN, TIME_DOMAIN_MAXIMUM, TIME_DOMAIN_MINIMUM, TIME_DOMAIN_RESOLUTION

Constructor Summary

Constructors

Constructor and Description
GeoTiffReader(Object input) Creates a new instance of GeoTiffReader
GeoTiffReader(Object input, org.geotools.factory.Hints uHints) Creates a new instance of GeoTiffReader

Method Summary

Modifier and Type	Method and Description
protected org.geotools.coverage.grid.GridCoverage2D	createCoverage(javax.media.jai.PlanarImage image, org.opengis.referencing.operation.MathTransform raster2Model, javax.media.jai.ROI roi) Creates a GridCoverage for the provided PlanarImage using the AbstractGridCoverage2DReader.raster2Model that was provided for this coverage.
protected List<org.geotools.data.FileGroupProvider.FileGroup>	getFiles()
org.opengis.coverage.grid.Format	getFormat()
int	getGridCoverageCount() Number of coverages for this reader is 1
org.geotools.coverage.grid.io.GroundControlPoints	getGroundControlPoints()
org.geotools.coverage.grid.io.imageio.geotiff.GeoTiffIIOMetadataDecoder	getMetadata() Returns the geotiff metadata for this geotiff file.
org.geotools.coverage.grid.GridCoverage2D	read(org.opengis.parameter.GeneralParameterValue[] params) This method reads in the TIFF image, constructs an appropriate CRS, determines the math transform from raster to the CRS model, and constructs a GridCoverage.

Methods inherited from class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

addAllSiblings, addSiblings, checkName, createImageCoverage, createImageCoverage, createImageCoverage, createImageCoverage, decimationOnReadingControl, decimationOnReadingControl, dispose, finalize, getCoordinateReferenceSystem, getCoordinateReferenceSystem, getCrs, getCurrentSubname, getDatasetLayout, getDatasetLayout, getDynamicParameters, getDynamicParameters, getGridCoverageNames, getGroundControlPoints, getHighestRes, getImageLayout, getImageLayout, getInfo, getInfo, getMetadataNames, getMetadataNames, getMetadataValue, getMetadataValue, getMultiLevelROIProvider, getNumOverviews, getNumOverviews, getOriginalEnvelope, getOriginalEnvelope, getOriginalGridRange, getOriginalGridRange, getOriginalGridToWorld, getOriginalGridToWorld, getOverviewGridEnvelope, getOverviewGridEnvelope, getReadingResolutions, getReadingResolutions, getRescaledRasterToModel, getResolution, getResolutionLevels, getResolutionLevels, getSibling, getSource, getSourceAsFile, hasMoreGridCoverages, listSubNames, read, setlayout, setLayout, setReadParams, setReadParams, skip

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.geotools.coverage.grid.io.GridCoverage2DReader

getCoordinateReferenceSystem, getCoordinateReferenceSystem, getDatasetLayout, getDatasetLayout, getDynamicParameters, getDynamicParameters, getImageLayout, getImageLayout, getInfo, getInfo, getNumOverviews, getNumOverviews, getOriginalEnvelope, getOriginalEnvelope, getOriginalGridRange, getOriginalGridRange, getOriginalGridToWorld, getOriginalGridToWorld, getReadingResolutions, getReadingResolutions, getResolutionLevels, getResolutionLevels, read

Methods inherited from interface org.opengis.coverage.grid.GridCoverageReader

dispose, getCurrentSubname, getGridCoverageNames, getMetadataNames, getMetadataNames, getMetadataValue, getMetadataValue, getSource, hasMoreGridCoverages, listSubNames, skip

Field Detail

OVERRIDE_CRS_SWITCH

public static final String OVERRIDE_CRS_SWITCH

With this java switch I can control whether or not an external PRJ files takes precedence over the internal CRS definition

See Also:

Constant Field Values

Constructor Detail

GeoTiffReader

public GeoTiffReader(Object input)
              throws org.geotools.data.DataSourceException

Creates a new instance of GeoTiffReader

Parameters:

input - the GeoTiff file

Throws:

org.geotools.data.DataSourceException

GeoTiffReader

public GeoTiffReader(Object input,
                     org.geotools.factory.Hints uHints)
              throws org.geotools.data.DataSourceException

Creates a new instance of GeoTiffReader

Parameters:

input - the GeoTiff file

uHints - user-supplied hints TODO currently are unused

Throws:

org.geotools.data.DataSourceException

Method Detail

getFormat

public org.opengis.coverage.grid.Format getFormat()

Specified by:

getFormat in interface org.opengis.coverage.grid.GridCoverageReader

See Also:

GridCoverageReader.getFormat()

read

public org.geotools.coverage.grid.GridCoverage2D read(org.opengis.parameter.GeneralParameterValue[] params)
                                               throws IOException

This method reads in the TIFF image, constructs an appropriate CRS, determines the math transform from raster to the CRS model, and constructs a GridCoverage.

Specified by:

read in interface org.geotools.coverage.grid.io.GridCoverage2DReader

Specified by:

read in interface org.opengis.coverage.grid.GridCoverageReader

Overrides:

read in class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

Parameters:

params - currently ignored, potentially may be used for hints.

Returns:

grid coverage represented by the image

Throws:

IOException - on any IO related troubles

getMetadata

public org.geotools.coverage.grid.io.imageio.geotiff.GeoTiffIIOMetadataDecoder getMetadata()

Returns the geotiff metadata for this geotiff file.

Returns:

the metadata

createCoverage

protected final org.geotools.coverage.grid.GridCoverage2D createCoverage(javax.media.jai.PlanarImage image,
                                                                         org.opengis.referencing.operation.MathTransform raster2Model,
                                                                         javax.media.jai.ROI roi)
                                                                  throws IOException

Creates a GridCoverage for the provided PlanarImage using the AbstractGridCoverage2DReader.raster2Model that was provided for this coverage.

This method is vital when working with coverages that have a raster to model transformation that is not a simple scale and translate.

Parameters:

image - contains the data for the coverage to create.

raster2Model - is the MathTransform that maps from the raster space to the model space.

roi - Optional ROI used as Mask

Returns:

a GridCoverage

Throws:

IOException

getGridCoverageCount

public int getGridCoverageCount()

Number of coverages for this reader is 1

Specified by:

getGridCoverageCount in interface org.opengis.coverage.grid.GridCoverageReader

Overrides:

getGridCoverageCount in class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

Returns:

the number of coverages for this reader.

getGroundControlPoints

public org.geotools.coverage.grid.io.GroundControlPoints getGroundControlPoints()

Overrides:

getGroundControlPoints in class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader

getFiles

protected List<org.geotools.data.FileGroupProvider.FileGroup> getFiles()

Overrides:

getFiles in class org.geotools.coverage.grid.io.AbstractGridCoverage2DReader