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

Field Summary

Fields

Modifier and Type	Field and Description
protected double	altScaleFactor
protected ucar.unidata.geoloc.LatLonRect	boundingBox
protected java.util.Formatter	errs
protected java.lang.String	latVName
protected java.lang.String	lonVName
protected double	maxDate
protected double	minDate
protected ucar.nc2.dataset.NetcdfDataset	ncfile
protected java.lang.String	nomTimeVName
protected ucar.nc2.Dimension	obsDim
protected java.lang.String	obsTimeVName
protected ucar.nc2.dataset.StructureDS	recordVar
protected ucar.nc2.ft.point.StationHelper	stationHelper
protected ucar.ma2.DataType	stationIdType
protected java.lang.String	stnDescVName
protected java.lang.String	stnIdVName
protected java.lang.String	stnIndexVName
protected ucar.nc2.time.CalendarDateUnit	timeUnit
protected java.lang.String	zcoordUnits
protected java.lang.String	zcoordVName

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
ucar.nc2.ft.PointFeature	factory(ucar.unidata.geoloc.StationImpl s, ucar.ma2.StructureData sdata, int recno)
double	getLatitude(ucar.ma2.StructureData sdata)
ucar.unidata.geoloc.LatLonPoint	getLocation(ucar.ma2.StructureData sdata)
double	getLongitude(ucar.ma2.StructureData sdata)
protected static double	getMetersConversionFactor(java.lang.String unitsString)
double	getObservationTime(ucar.ma2.StructureData sdata)
ucar.nc2.time.CalendarDate	getObservationTimeAsDate(ucar.ma2.StructureData sdata)
int	getRecordCount()
ucar.nc2.Structure	getRecordVar()
ucar.nc2.time.CalendarDateUnit	getTimeUnit()
double	getZcoordinate(ucar.ma2.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, ucar.nc2.ft.point.StationHelper stationHelper) Set extra information used by station obs datasets.
void	setTimeUnit(ucar.nc2.time.CalendarDateUnit timeUnit)

Methods inherited from class java.lang.Object

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

Field Detail

ncfile

protected ucar.nc2.dataset.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 ucar.nc2.ft.point.StationHelper stationHelper

stationIdType

protected ucar.ma2.DataType stationIdType

recordVar

protected ucar.nc2.dataset.StructureDS recordVar

obsDim

protected ucar.nc2.Dimension obsDim

boundingBox

protected ucar.unidata.geoloc.LatLonRect boundingBox

minDate

protected double minDate

maxDate

protected double maxDate

timeUnit

protected ucar.nc2.time.CalendarDateUnit timeUnit

altScaleFactor

protected double altScaleFactor

errs

protected java.util.Formatter errs

Constructor Detail

RecordDatasetHelper

public RecordDatasetHelper(ucar.nc2.dataset.NetcdfDataset ncfile,
                           java.lang.String obsTimeVName,
                           java.lang.String nomTimeVName,
                           java.util.List<ucar.nc2.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,
                           ucar.nc2.ft.point.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 ucar.nc2.Structure getRecordVar()

getRecordCount

public int getRecordCount()

setTimeUnit

public void setTimeUnit(ucar.nc2.time.CalendarDateUnit timeUnit)

getTimeUnit

public ucar.nc2.time.CalendarDateUnit getTimeUnit()

getLocation

public ucar.unidata.geoloc.LatLonPoint getLocation(ucar.ma2.StructureData sdata)

getLatitude

public double getLatitude(ucar.ma2.StructureData sdata)

getLongitude

public double getLongitude(ucar.ma2.StructureData sdata)

getZcoordinate

public double getZcoordinate(ucar.ma2.StructureData sdata)

getZcoordUnits

public java.lang.String getZcoordUnits()

getObservationTimeAsDate

public ucar.nc2.time.CalendarDate getObservationTimeAsDate(ucar.ma2.StructureData sdata)

getObservationTime

public double getObservationTime(ucar.ma2.StructureData sdata)

factory

public ucar.nc2.ft.PointFeature factory(ucar.unidata.geoloc.StationImpl s,
                                        ucar.ma2.StructureData sdata,
                                        int recno)