Package noaa.coastwatch.render.feature

Class HDFGSHHSReader

java.lang.Object

noaa.coastwatch.render.feature.AbstractFeatureSource

noaa.coastwatch.render.feature.LineFeatureSource

noaa.coastwatch.render.feature.PolygonFeatureSource

noaa.coastwatch.render.feature.BinnedGSHHSReader

noaa.coastwatch.render.feature.HDFGSHHSReader

All Implemented Interfaces:

Iterable<Feature>, FeatureSource

public class HDFGSHHSReader
extends BinnedGSHHSReader

The HDFGSHHSReader extends BinnedGSHHSReader to read data from an HDF binned data file.

Since:

3.2.1

Author:

Peter Hollemans

Nested Class Summary

Nested classes/interfaces inherited from class noaa.coastwatch.render.feature.BinnedGSHHSReader

BinnedGSHHSReader.Bin

Field Summary

Fields inherited from class noaa.coastwatch.render.feature.BinnedGSHHSReader

binInfo, binSize, database, dxID, dyID, firstSegment, latBins, lonBins, multiplier, numSegments, sdID, segmentAreaID, segmentInfoID, segmentStart, totalBins, totalPoints, totalSegments

Fields inherited from class noaa.coastwatch.render.feature.PolygonFeatureSource

polygonList

Fields inherited from class noaa.coastwatch.render.feature.AbstractFeatureSource

area, featureList

Constructor Summary

Constructors

Constructor	Description
HDFGSHHSReader(String name)	Creates a new binned GSHHS reader from the database file name.

Method Summary

Modifier and Type	Method	Description
protected void	finalize()
protected void	getGlobalData()	Reads data about the entire file, including binSize, multiplier, lonBins, latBins, totalBins, firstSegment, numSegments, binInfo, and segmentStart.
protected int	openFile(String name)	Opens the data file and returns the file ID.
protected void	readData(int sdsid, int[] start, int[] count, Object data)	Reads data for the specified variable ID.
protected void	readData(String var, int[] start, int[] count, Object data)	Reads data for the specified variable name.
protected int	selectData(String var)	Gets the variable ID for the specified variable.

Methods inherited from class noaa.coastwatch.render.feature.BinnedGSHHSReader

getBinIndex, getBinIndices, getBins, getDatabase, getMinArea, getPolygonRendering, init, select, setBinHint, setBinListHint, setMinArea, setPolygonRendering

Methods inherited from class noaa.coastwatch.render.feature.PolygonFeatureSource

renderOutlines, renderPolygons

Methods inherited from class noaa.coastwatch.render.feature.LineFeatureSource

render

Methods inherited from class noaa.coastwatch.render.feature.AbstractFeatureSource

getArea, getAttributeCount, getAttributeNameMap, getAttributes, getFilter, iterator, select, setAttributes, setFilter

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

HDFGSHHSReader

public HDFGSHHSReader(String name)
               throws IOException

Creates a new binned GSHHS reader from the database file name. By default, there is no minimum area for polygon selection and no polygons are selected.

Parameters:

name - the database name. Several predefined database names are available from BinnedGSHHSReaderFactory.getDatabaseName(int, int).

Throws:

IOException - if an error occurred reading the file.

Method Details

readData

protected void readData(int sdsid,
 int[] start,
 int[] count,
 Object data)
                 throws IOException

Description copied from class: BinnedGSHHSReader

Reads data for the specified variable ID.

Specified by:

readData in class BinnedGSHHSReader

Parameters:

sdsid - the identifier for the variable.

start - the starting data index for reading.

count - the number of data values to read.

data - the data array to fill with values.

Throws:

IOException - if an error occurred reading the data.

readData

protected void readData(String var,
 int[] start,
 int[] count,
 Object data)
                 throws IOException

Description copied from class: BinnedGSHHSReader

Reads data for the specified variable name.

Specified by:

readData in class BinnedGSHHSReader

Parameters:

var - the name of the variable.

start - the starting data index for reading.

count - the number of data values to read.

data - the data array to fill with values.

Throws:

IOException - if an error occurred reading the data.

selectData

protected int selectData(String var)
                  throws IOException

Description copied from class: BinnedGSHHSReader

Gets the variable ID for the specified variable.

Specified by:

selectData in class BinnedGSHHSReader

Parameters:

var - the variable name to retrieve an ID.

Returns:

the variable ID.

Throws:

IOException - if an error occurred retrieving the ID.

openFile

protected int openFile(String name)
                throws IOException

Description copied from class: BinnedGSHHSReader

Opens the data file and returns the file ID.

Specified by:

openFile in class BinnedGSHHSReader

Parameters:

name - the data file name.

Throws:

IOException - if an error occurred opening the file.

getGlobalData

protected void getGlobalData()
                      throws IOException

Description copied from class: BinnedGSHHSReader

Reads data about the entire file, including binSize, multiplier, lonBins, latBins, totalBins, firstSegment, numSegments, binInfo, and segmentStart.

Specified by:

getGlobalData in class BinnedGSHHSReader

Throws:

IOException - if an error occurred reading the data.

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable