ucar.nc2.dt.trajectory

Class UnidataTrajectoryObsDataset2

java.lang.Object

ucar.nc2.dt.TypedDatasetImpl

ucar.nc2.dt.trajectory.UnidataTrajectoryObsDataset2

All Implemented Interfaces:

java.io.Closeable, java.lang.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 https://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 Variable	elevVar Deprecated.
protected java.lang.String	elevVarName Deprecated.
protected boolean	isMultiTrajStructure Deprecated.
protected boolean	isTimeDimensionFirst Deprecated.
protected Variable	latVar Deprecated.
protected java.lang.String	latVarName Deprecated.
protected Variable	lonVar Deprecated.
protected java.lang.String	lonVarName Deprecated.
protected Structure	recordVar Deprecated.
protected Dimension	timeDim Deprecated.
protected java.lang.String	timeDimName Deprecated.
protected Variable	timeVar Deprecated.
protected java.lang.String	timeVarName Deprecated.
protected Dimension	trajDim Deprecated.
protected java.lang.String	trajDimName Deprecated.
protected Variable	trajVar Deprecated.
protected java.lang.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(NetcdfDataset ncd) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. Close all resources associated with this dataset.
Attribute	findGlobalAttributeIgnoreCase(java.lang.String name) Deprecated.
LatLonRect	getBoundingBox() Deprecated.
VariableSimpleIF	getDataVariable(java.lang.String shortName) Deprecated. Get the named data Variable.
java.util.List<VariableSimpleIF>	getDataVariables() Deprecated. The data Variables available in this dataset.
java.lang.String	getDescription() Deprecated.
java.lang.String	getDetailInfo() Deprecated.
java.util.Date	getEndDate() Deprecated.
java.util.List<Attribute>	getGlobalAttributes() Deprecated. List of global attributes.
java.lang.String	getLocation() Deprecated.
NetcdfFile	getNetcdfFile() Deprecated.
FeatureType	getScientificDataType() Deprecated. What kind of cientific data type will this return?
java.util.Date	getStartDate() Deprecated.
java.lang.String	getTitle() Deprecated.
java.util.List	getTrajectories() Deprecated. Get trajectories contained in this dataset.
TrajectoryObsDatatype	getTrajectory(java.lang.String trajectoryId) Deprecated. Get the named trajectory
java.util.List<java.lang.String>	getTrajectoryIds() Deprecated. Get a list of String IDs for the available trajectories.
boolean	isMine(NetcdfDataset ds) Deprecated. Determine if this dataset belongs to you
static boolean	isValidFile(NetcdfFile ds) Deprecated.
TypedDataset	open(NetcdfDataset ncd, CancelTask task, java.lang.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 Variable trajVar

Deprecated.

trajDim

protected Dimension trajDim

Deprecated.

timeVar

protected Variable timeVar

Deprecated.

timeDim

protected Dimension timeDim

Deprecated.

recordVar

protected Structure recordVar

Deprecated.

latVar

protected Variable latVar

Deprecated.

lonVar

protected Variable lonVar

Deprecated.

elevVar

protected Variable elevVar

Deprecated.

trajDimName

protected java.lang.String trajDimName

Deprecated.

trajVarName

protected java.lang.String trajVarName

Deprecated.

timeDimName

protected java.lang.String timeDimName

Deprecated.

timeVarName

protected java.lang.String timeVarName

Deprecated.

latVarName

protected java.lang.String latVarName

Deprecated.

lonVarName

protected java.lang.String lonVarName

Deprecated.

elevVarName

protected java.lang.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(NetcdfDataset ncd)
                             throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

Method Detail

isValidFile

public static boolean isValidFile(NetcdfFile ds)

Deprecated.

isMine

public boolean isMine(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(NetcdfDataset ncd,
                         CancelTask task,
                         java.lang.StringBuilder errlog)
                  throws java.io.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:

java.io.IOException - on error

getScientificDataType

public 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 java.lang.String getDetailInfo()

Deprecated.

Specified by:

getDetailInfo in interface TypedDataset

Overrides:

getDetailInfo in class TypedDatasetImpl

Returns:

debug / underlying implementation details

getTitle

public java.lang.String getTitle()

Deprecated.

Specified by:

getTitle in interface TypedDataset

Overrides:

getTitle in class TypedDatasetImpl

Returns:

Title of the dataset.

getDescription

public java.lang.String getDescription()

Deprecated.

Specified by:

getDescription in interface TypedDataset

Overrides:

getDescription in class TypedDatasetImpl

Returns:

Text information about this dataset.

getLocation

public java.lang.String getLocation()

Deprecated.

Overrides:

getLocation in class TypedDatasetImpl

setStartDate

protected void setStartDate()

Deprecated.

Specified by:

setStartDate in class TypedDatasetImpl

getStartDate

public java.util.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 java.util.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 LatLonRect getBoundingBox()

Deprecated.

Specified by:

getBoundingBox in interface TypedDataset

Overrides:

getBoundingBox in class TypedDatasetImpl

Returns:

the boundingBox for the entire dataset.

getGlobalAttributes

public java.util.List<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 Attribute findGlobalAttributeIgnoreCase(java.lang.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 java.util.List<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 VariableSimpleIF getDataVariable(java.lang.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 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 java.io.IOException

Deprecated.

Description copied from interface: TypedDataset

Close all resources associated with this dataset.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface TypedDataset

Overrides:

close in class TypedDatasetImpl

Throws:

java.io.IOException - on I/O error

getTrajectoryIds

public java.util.List<java.lang.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 java.util.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(java.lang.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.