Package noaa.coastwatch.render.feature

Class OpendapGSHHSLineReader

java.lang.Object

noaa.coastwatch.render.feature.AbstractFeatureSource

noaa.coastwatch.render.feature.LineFeatureSource

noaa.coastwatch.render.feature.BinnedGSHHSLineReader

noaa.coastwatch.render.feature.OpendapGSHHSLineReader

All Implemented Interfaces:

Iterable<Feature>, FeatureSource

public class OpendapGSHHSLineReader
extends BinnedGSHHSLineReader

The OpendapGSHHSLineReader extends BinnedGSHHSLineReader to read data from an OPeNDAP-enabled binned data file. Some optimizations are made for network connections.

Since:

3.2.1

Author:

Peter Hollemans

Nested Class Summary

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

BinnedGSHHSLineReader.Bin

Field Summary

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

binSize, database, dxID, dyID, firstSegment, latBins, lonBins, multiplier, numSegments, sdID, segmentLevelID, segmentPointsID, segmentStart, totalBins, totalPoints, totalSegments

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

area, featureList

Constructor Summary

Constructors

Constructor	Description
OpendapGSHHSLineReader(String path, String name)	Creates a new reader from the database name.

Method Summary

Modifier and Type	Method	Description
protected void	getGlobalData()	Reads data about the entire file, including binSize, multiplier, lonBins, latBins, totalBins, firstSegment, numSegments, 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.
protected void	setBinHint(int index)	Sets a hint that subsequent bin data access is about to occur.
protected void	setBinListHint(List indexList)	Sets a hint that subsequent bin data access is about to occur for a list of bins.

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

getBinIndex, getBinIndices, getBins, getDatabase, init, iterator, select, setLevelRange

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

render

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

OpendapGSHHSLineReader

public OpendapGSHHSLineReader(String path,
 String name)
                       throws IOException

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

Parameters:

path - the OPeNDAP server path as http://server/path.

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

setBinHint

protected void setBinHint(int index)

Description copied from class: BinnedGSHHSLineReader

Sets a hint that subsequent bin data access is about to occur. This may be used by child classes to increase the speed of bin data access.

Overrides:

setBinHint in class BinnedGSHHSLineReader

Parameters:

index - the bin that data access will be performed for next.

readData

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

Description copied from class: BinnedGSHHSLineReader

Reads data for the specified variable ID.

Specified by:

readData in class BinnedGSHHSLineReader

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: BinnedGSHHSLineReader

Reads data for the specified variable name.

Specified by:

readData in class BinnedGSHHSLineReader

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.

setBinListHint

protected void setBinListHint(List indexList)

Description copied from class: BinnedGSHHSLineReader

Sets a hint that subsequent bin data access is about to occur for a list of bins. This may be used by child classes to increase the speed of bin data access.

Overrides:

setBinListHint in class BinnedGSHHSLineReader

Parameters:

indexList - the list of bin indices to be accessed sorted in increasing order.

selectData

protected int selectData(String var)
                  throws IOException

Description copied from class: BinnedGSHHSLineReader

Gets the variable ID for the specified variable.

Specified by:

selectData in class BinnedGSHHSLineReader

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: BinnedGSHHSLineReader

Opens the data file and returns the file ID.

Specified by:

openFile in class BinnedGSHHSLineReader

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: BinnedGSHHSLineReader

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

Specified by:

getGlobalData in class BinnedGSHHSLineReader

Throws:

IOException - if an error occurred reading the data.