ucar.nc2.dt.trajectory

Class UnidataTrajectoryObsDataset2

java.lang.Object

ucar.nc2.dt.TypedDatasetImpl

ucar.nc2.dt.trajectory.UnidataTrajectoryObsDataset2

All Implemented Interfaces:

Closeable, AutoCloseable, TrajectoryObsDataset, TypedDataset, TypedDatasetFactoryIF

Deprecated.

use ucar.nc2.ft.point

public class UnidataTrajectoryObsDataset2
extends TypedDatasetImpl
implements TrajectoryObsDataset, TypedDatasetFactoryIF

Handle trajectory data files that follow the Unidata Observation Dataset convention version 1.0. Documentation on this convention is available at http://www.unidata.ucar.edu/software/netcdf-java/formats/UnidataObsConvention.html

Since:

2006-11-17T17:26:14-0700

Field Summary

Fields

Modifier and Type	Field and Description
protected TrajectoryObsDataset	backingTraj Deprecated.
protected ucar.nc2.Variable	elevVar Deprecated.
protected String	elevVarName Deprecated.
protected boolean	isMultiTrajStructure Deprecated.
protected boolean	isTimeDimensionFirst Deprecated.
protected ucar.nc2.Variable	latVar Deprecated.
protected String	latVarName Deprecated.
protected ucar.nc2.Variable	lonVar Deprecated.
protected String	lonVarName Deprecated.
protected ucar.nc2.Structure	recordVar Deprecated.
protected ucar.nc2.Dimension	timeDim Deprecated.
protected String	timeDimName Deprecated.
protected ucar.nc2.Variable	timeVar Deprecated.
protected String	timeVarName Deprecated.
protected ucar.nc2.Dimension	trajDim Deprecated.
protected String	trajDimName Deprecated.
protected ucar.nc2.Variable	trajVar Deprecated.
protected String	trajVarName Deprecated.

Fields inherited from class ucar.nc2.dt.TypedDatasetImpl

boundingBox, dataVariables, desc, endDate, location, netcdfDataset, parseInfo, startDate, title

Constructor Summary

Constructors

Constructor and Description
UnidataTrajectoryObsDataset2() Deprecated.
UnidataTrajectoryObsDataset2(ucar.nc2.dataset.NetcdfDataset ncd) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. Close all resources associated with this dataset.
ucar.nc2.Attribute	findGlobalAttributeIgnoreCase(String name) Deprecated.
ucar.unidata.geoloc.LatLonRect	getBoundingBox() Deprecated.
ucar.nc2.VariableSimpleIF	getDataVariable(String shortName) Deprecated. Get the named data Variable.
List<ucar.nc2.VariableSimpleIF>	getDataVariables() Deprecated. The data Variables available in this dataset.
String	getDescription() Deprecated.
String	getDetailInfo() Deprecated.
Date	getEndDate() Deprecated.
List<ucar.nc2.Attribute>	getGlobalAttributes() Deprecated. List of global attributes.
String	getLocation() Deprecated.
ucar.nc2.NetcdfFile	getNetcdfFile() Deprecated.
ucar.nc2.constants.FeatureType	getScientificDataType() Deprecated. What kind of cientific data type will this return?
Date	getStartDate() Deprecated.
String	getTitle() Deprecated.
List	getTrajectories() Deprecated. Get trajectories contained in this dataset.
TrajectoryObsDatatype	getTrajectory(String trajectoryId) Deprecated. Get the named trajectory
List<String>	getTrajectoryIds() Deprecated. Get a list of String IDs for the available trajectories.
boolean	isMine(ucar.nc2.dataset.NetcdfDataset ds) Deprecated. Determine if this dataset belongs to you
static boolean	isValidFile(ucar.nc2.NetcdfFile ds) Deprecated.
TypedDataset	open(ucar.nc2.dataset.NetcdfDataset ncd, ucar.nc2.util.CancelTask task, StringBuilder errlog) Deprecated. Open a NetcdfDataset as a TypedDataset.
protected void	setBoundingBox() Deprecated.
protected void	setEndDate() Deprecated.
protected void	setStartDate() Deprecated.
boolean	syncExtend() Deprecated. Syncronize with the underlying dataset if it has been extended in a way that is compatible with the existing structural metadata (for instance, if the unlimited dimension has grown).

Methods inherited from class ucar.nc2.dt.TypedDatasetImpl

getLocationURI, removeDataVariable, setDescription, setLocationURI, setTitle

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.dt.TypedDataset

getLocationURI

Field Detail

trajVar

protected ucar.nc2.Variable trajVar

Deprecated.

trajDim

protected ucar.nc2.Dimension trajDim

Deprecated.

timeVar

protected ucar.nc2.Variable timeVar

Deprecated.

timeDim

protected ucar.nc2.Dimension timeDim

Deprecated.

recordVar

protected ucar.nc2.Structure recordVar

Deprecated.

latVar

protected ucar.nc2.Variable latVar

Deprecated.

lonVar

protected ucar.nc2.Variable lonVar

Deprecated.

elevVar

protected ucar.nc2.Variable elevVar

Deprecated.

trajDimName

protected String trajDimName

Deprecated.

trajVarName

protected String trajVarName

Deprecated.

timeDimName

protected String timeDimName

Deprecated.

timeVarName

protected String timeVarName

Deprecated.

latVarName

protected String latVarName

Deprecated.

lonVarName

protected String lonVarName

Deprecated.

elevVarName

protected String elevVarName

Deprecated.

isMultiTrajStructure

protected boolean isMultiTrajStructure

Deprecated.

isTimeDimensionFirst

protected boolean isTimeDimensionFirst

Deprecated.

backingTraj

protected TrajectoryObsDataset backingTraj

Deprecated.

Constructor Detail

UnidataTrajectoryObsDataset2

public UnidataTrajectoryObsDataset2()

Deprecated.

UnidataTrajectoryObsDataset2

public UnidataTrajectoryObsDataset2(ucar.nc2.dataset.NetcdfDataset ncd)
                             throws IOException

Deprecated.

Throws:

IOException

Method Detail

isValidFile

public static boolean isValidFile(ucar.nc2.NetcdfFile ds)

Deprecated.

isMine

public boolean isMine(ucar.nc2.dataset.NetcdfDataset ds)

Deprecated.

Description copied from interface: TypedDatasetFactoryIF

Determine if this dataset belongs to you

Specified by:

isMine in interface TypedDatasetFactoryIF

Parameters:

ds - examine this NetcdfDataset to see if it belongs to this class.

Returns:

true if this class knows how to create a TypedDataset out of this NetcdfDataset.

open

public TypedDataset open(ucar.nc2.dataset.NetcdfDataset ncd,
                         ucar.nc2.util.CancelTask task,
                         StringBuilder errlog)
                  throws IOException

Deprecated.

Description copied from interface: TypedDatasetFactoryIF

Open a NetcdfDataset as a TypedDataset.

Specified by:

open in interface TypedDatasetFactoryIF

Parameters:

ncd - already opened NetcdfDataset.

task - use may cancel

errlog - place errors here

Returns:

a subclass of TypedDataset

Throws:

IOException - on error

getScientificDataType

public ucar.nc2.constants.FeatureType getScientificDataType()

Deprecated.

Description copied from interface: TypedDatasetFactoryIF

What kind of cientific data type will this return?

Specified by:

getScientificDataType in interface TypedDatasetFactoryIF

Returns:

scientific data type

getDetailInfo

public String getDetailInfo()

Deprecated.

Specified by:

getDetailInfo in interface TypedDataset

Overrides:

getDetailInfo in class TypedDatasetImpl

Returns:

debug / underlying implementation details

getTitle

public String getTitle()

Deprecated.

Specified by:

getTitle in interface TypedDataset

Overrides:

getTitle in class TypedDatasetImpl

Returns:

Title of the dataset.

getDescription

public String getDescription()

Deprecated.

Specified by:

getDescription in interface TypedDataset

Overrides:

getDescription in class TypedDatasetImpl

Returns:

Text information about this dataset.

getLocation

public String getLocation()

Deprecated.

Overrides:

getLocation in class TypedDatasetImpl

setStartDate

protected void setStartDate()

Deprecated.

Specified by:

setStartDate in class TypedDatasetImpl

getStartDate

public Date getStartDate()

Deprecated.

Specified by:

getStartDate in interface TypedDataset

Overrides:

getStartDate in class TypedDatasetImpl

Returns:

Start date for the entire dataset.

setEndDate

protected void setEndDate()

Deprecated.

Specified by:

setEndDate in class TypedDatasetImpl

getEndDate

public Date getEndDate()

Deprecated.

Specified by:

getEndDate in interface TypedDataset

Overrides:

getEndDate in class TypedDatasetImpl

Returns:

End date for the entire dataset.

setBoundingBox

protected void setBoundingBox()

Deprecated.

Specified by:

setBoundingBox in class TypedDatasetImpl

getBoundingBox

public ucar.unidata.geoloc.LatLonRect getBoundingBox()

Deprecated.

Specified by:

getBoundingBox in interface TypedDataset

Overrides:

getBoundingBox in class TypedDatasetImpl

Returns:

the boundingBox for the entire dataset.

getGlobalAttributes

public List<ucar.nc2.Attribute> getGlobalAttributes()

Deprecated.

Description copied from interface: TypedDataset

List of global attributes.

Specified by:

getGlobalAttributes in interface TypedDataset

Overrides:

getGlobalAttributes in class TypedDatasetImpl

Returns:

List of type ucar.nc2.Attribute

findGlobalAttributeIgnoreCase

public ucar.nc2.Attribute findGlobalAttributeIgnoreCase(String name)

Deprecated.

Specified by:

findGlobalAttributeIgnoreCase in interface TypedDataset

Overrides:

findGlobalAttributeIgnoreCase in class TypedDatasetImpl

Parameters:

name - attribute name

Returns:

the global attribute with the given name, ingnoring case.

getDataVariables

public List<ucar.nc2.VariableSimpleIF> getDataVariables()

Deprecated.

Description copied from interface: TypedDataset

The data Variables available in this dataset. Should just be data variable others might be searching for, not metadata or coordinate system variables, etc. The shape of this VariableSimpleIF does not necessarily match the

Specified by:

getDataVariables in interface TypedDataset

Overrides:

getDataVariables in class TypedDatasetImpl

Returns:

List of type VariableSimpleIF

getDataVariable

public ucar.nc2.VariableSimpleIF getDataVariable(String shortName)

Deprecated.

Description copied from interface: TypedDataset

Get the named data Variable.

Specified by:

getDataVariable in interface TypedDataset

Overrides:

getDataVariable in class TypedDatasetImpl

Parameters:

shortName - of data Variable.

Returns:

VariableSimpleIF or null.

getNetcdfFile

public ucar.nc2.NetcdfFile getNetcdfFile()

Deprecated.

Specified by:

getNetcdfFile in interface TypedDataset

Overrides:

getNetcdfFile in class TypedDatasetImpl

Returns:

underlying NetcdfFile, or null if none.

close

public void close()
           throws IOException

Deprecated.

Description copied from interface: TypedDataset

Close all resources associated with this dataset.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface TypedDataset

Overrides:

close in class TypedDatasetImpl

Throws:

IOException - on I/O error

getTrajectoryIds

public List<String> getTrajectoryIds()

Deprecated.

Description copied from interface: TrajectoryObsDataset

Get a list of String IDs for the available trajectories.

Specified by:

getTrajectoryIds in interface TrajectoryObsDataset

Returns:

list of ids for this dataset

getTrajectories

public List getTrajectories()

Deprecated.

Description copied from interface: TrajectoryObsDataset

Get trajectories contained in this dataset.

Specified by:

getTrajectories in interface TrajectoryObsDataset

Returns:

List of type TrajectoryObsDatatype.

getTrajectory

public TrajectoryObsDatatype getTrajectory(String trajectoryId)

Deprecated.

Description copied from interface: TrajectoryObsDataset

Get the named trajectory

Specified by:

getTrajectory in interface TrajectoryObsDataset

Parameters:

trajectoryId - id of trajectory

Returns:

the named trajectory

syncExtend

public boolean syncExtend()

Deprecated.

Description copied from interface: TrajectoryObsDataset

Syncronize with the underlying dataset if it has been extended in a way that is compatible with the existing structural metadata (for instance, if the unlimited dimension has grown). Return true if syncronization was needed and sucessful. Otherwise, return false. NOTE: For now, assuming growth of the unlimited dimension only allowed change. To get range for new extent only, use getRange( oldNumPoints + 1, newNumPoints, 1)

Specified by:

syncExtend in interface TrajectoryObsDataset

Returns:

true if syncronization was needed and sucessful, otherwise false.