Package noaa.coastwatch.render.feature

Class IQuamNCReader

java.lang.Object

noaa.coastwatch.render.feature.AbstractFeatureSource

noaa.coastwatch.render.feature.PointFeatureSource

noaa.coastwatch.render.feature.IQuamNCReader

All Implemented Interfaces:

Iterable<Feature>, FeatureSource

public class IQuamNCReader
extends PointFeatureSource

The iQuam data reader reads NOAA iQuam (in-situ SST quality monitoring) system data files and presents the data as point features. Data files are obtained from:

http://www.star.nesdis.noaa.gov/sod/sst/iquam/v2/index.html

Since:

3.3.2

Author:

Peter Hollemans

Field Summary

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

area, featureList

Constructor Summary

Constructors

Constructor	Description
IQuamNCReader(String filename)	Creates a new reader for an iQuam point data file.

Method Summary

Modifier and Type	Method	Description
List<EarthDataOverlay>	getStandardOverlays(Date date, EarthTransform trans, List<Grid> gridList)	Gets the standard set of iQuam point data overlays for this data source.
static void	main(String[] argv)	Tests this class.
void	precache()	Performs a precaching read of all the point data in the file.
protected void	select()	Selects a set of features from the data source based on the current area.

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

render, 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, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

IQuamNCReader

public IQuamNCReader(String filename)
              throws IOException

Creates a new reader for an iQuam point data file.

Parameters:

filename - the name of the file.

Throws:

IOException

Method Details

precache

public void precache()
              throws IOException

Performs a precaching read of all the point data in the file. This will have the effect of speeding up subsequent select operations significantly, as the point data will be returned from memory and not read on-demand. This operation may take some time to complete.

Throws:

IOException

select

protected void select()
               throws IOException

Description copied from class: AbstractFeatureSource

Selects a set of features from the data source based on the current area.

Specified by:

select in class AbstractFeatureSource

Throws:

IOException - if an error occurred accessing the data source.

getStandardOverlays

public List<EarthDataOverlay> getStandardOverlays(Date date,
 EarthTransform trans,
 List<Grid> gridList)
                                           throws IOException

Gets the standard set of iQuam point data overlays for this data source.

Parameters:

date - the date to use for the set of overlays. Point data in the overlays will be filtered to fall within a certain time window centered on the date.

trans - the earth transform for the grid data.

gridList - the list of grids to append data values to the point feature attributes.

Returns:

a set of overlays that can be used to display iQuam data points.

Throws:

IOException - if an error occurred accessing the data file.

main

public static void main(String[] argv)
                 throws Exception

Tests this class.

Parameters:

argv - the array of command line parameters.

Throws:

Exception