ucar.nc2.ft.point
Class RecordDatasetHelper

java.lang.Object
  ucar.nc2.ft.point.RecordDatasetHelper

public class RecordDatasetHelper
extends java.lang.Object

Helper class for using the netcdf-3 record dimension.

Since:

Feb 29, 2008

Author:

caron

Field Summary

protected double	altScaleFactor
protected LatLonRect	boundingBox
protected java.util.Formatter	errs
protected java.lang.String	latVName
protected java.lang.String	lonVName
protected double	maxDate
protected double	minDate
protected NetcdfDataset	ncfile
protected java.lang.String	nomTimeVName
protected Dimension	obsDim
protected java.lang.String	obsTimeVName
protected StructureDS	recordVar
protected boolean	showErrors
protected StationHelper	stationHelper
protected DataType	stationIdType
protected java.lang.String	stnDescVName
protected java.lang.String	stnIdVName
protected java.lang.String	stnIndexVName
protected DateUnit	timeUnit
protected java.lang.String	zcoordUnits
protected java.lang.String	zcoordVName

Constructor Summary

RecordDatasetHelper(NetcdfDataset ncfile, java.lang.String obsTimeVName, java.lang.String nomTimeVName, java.util.List<VariableSimpleIF> typedDataVariables, java.lang.String recDimName, java.util.Formatter errBuffer)
Constructor.

Method Summary

PointFeature	factory(StationImpl s, StructureData sdata, int recno)
double	getLatitude(StructureData sdata)
LatLonPoint	getLocation(StructureData sdata)
double	getLongitude(StructureData sdata)
protected static double	getMetersConversionFactor(java.lang.String unitsString)
double	getObservationTime(StructureData sdata)
java.util.Date	getObservationTimeAsDate(StructureData sdata)
int	getRecordCount()
Structure	getRecordVar()
DateUnit	getTimeUnit()
double	getZcoordinate(StructureData sdata)
java.lang.String	getZcoordUnits()
void	setLocationInfo(java.lang.String latVName, java.lang.String lonVName, java.lang.String zcoordVName)
void	setShortNames(java.lang.String latVName, java.lang.String lonVName, java.lang.String altVName, java.lang.String obsTimeVName, java.lang.String nomTimeVName)
void	setStationInfo(java.lang.String stnIdVName, java.lang.String stnDescVName, java.lang.String stnIndexVName, StationHelper stationHelper) Set extra information used by station obs datasets.
void	setTimeUnit(DateUnit timeUnit)

Methods inherited from class java.lang.Object

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

Field Detail

ncfile

protected NetcdfDataset ncfile

obsTimeVName

protected java.lang.String obsTimeVName

nomTimeVName

protected java.lang.String nomTimeVName

latVName

protected java.lang.String latVName

lonVName

protected java.lang.String lonVName

zcoordVName

protected java.lang.String zcoordVName

zcoordUnits

protected java.lang.String zcoordUnits

stnIdVName

protected java.lang.String stnIdVName

stnIndexVName

protected java.lang.String stnIndexVName

stnDescVName

protected java.lang.String stnDescVName

stationHelper

protected StationHelper stationHelper

stationIdType

protected DataType stationIdType

recordVar

protected StructureDS recordVar

obsDim

protected Dimension obsDim

boundingBox

protected LatLonRect boundingBox

minDate

protected double minDate

maxDate

protected double maxDate

timeUnit

protected DateUnit timeUnit

altScaleFactor

protected double altScaleFactor

errs

protected java.util.Formatter errs

showErrors

protected boolean showErrors

Constructor Detail

RecordDatasetHelper

public RecordDatasetHelper(NetcdfDataset ncfile,
                           java.lang.String obsTimeVName,
                           java.lang.String nomTimeVName,
                           java.util.List<VariableSimpleIF> typedDataVariables,
                           java.lang.String recDimName,
                           java.util.Formatter errBuffer)

Constructor.

Parameters:

ncfile - the netccdf file

typedDataVariables - list of data variables; all record variables will be added to this list, except . You can remove extra

obsTimeVName - observation time variable name (required)

nomTimeVName - nominal time variable name (may be null)

Throws:

java.lang.IllegalArgumentException - if ncfile has no unlimited dimension and recDimName is null.

Method Detail

setStationInfo

public void setStationInfo(java.lang.String stnIdVName,
                           java.lang.String stnDescVName,
                           java.lang.String stnIndexVName,
                           StationHelper stationHelper)

Set extra information used by station obs datasets. Use stnIdVName or stnIndexVName.

Parameters:

stnIdVName - the obs variable that is used to find the station in the stnHash; may be type int or a String (char).

stnDescVName - optional station var containing station description

setLocationInfo

public void setLocationInfo(java.lang.String latVName,
                            java.lang.String lonVName,
                            java.lang.String zcoordVName)

setShortNames

public void setShortNames(java.lang.String latVName,
                          java.lang.String lonVName,
                          java.lang.String altVName,
                          java.lang.String obsTimeVName,
                          java.lang.String nomTimeVName)

getMetersConversionFactor

protected static double getMetersConversionFactor(java.lang.String unitsString)
                                           throws java.lang.Exception

Throws:

java.lang.Exception

getRecordVar

public Structure getRecordVar()

getRecordCount

public int getRecordCount()

setTimeUnit

public void setTimeUnit(DateUnit timeUnit)

getTimeUnit

public DateUnit getTimeUnit()

getLocation

public LatLonPoint getLocation(StructureData sdata)

getLatitude

public double getLatitude(StructureData sdata)

getLongitude

public double getLongitude(StructureData sdata)

getZcoordinate

public double getZcoordinate(StructureData sdata)

getZcoordUnits

public java.lang.String getZcoordUnits()

getObservationTimeAsDate

public java.util.Date getObservationTimeAsDate(StructureData sdata)

getObservationTime

public double getObservationTime(StructureData sdata)

factory

public PointFeature factory(StationImpl s,
                            StructureData sdata,
                            int recno)