gov.nasa.gsfc.spdf.cdfj

Class CDFReader

java.lang.Object

gov.nasa.gsfc.spdf.cdfj.MetaData

gov.nasa.gsfc.spdf.cdfj.GenericReader

gov.nasa.gsfc.spdf.cdfj.CDFReader

public class CDFReader
extends GenericReader

CDFReader extends GenericReader with access methods for time series variables. Time series methods of this class do not require a detailed knowledge of the internal structure of CDF.

Constructor Summary

Constructors

Constructor and Description
CDFReader()
CDFReader(java.lang.String cdfFile) Constructs a reader for the given CDF file.
CDFReader(java.net.URL url) Constructs a reader for the given URL for CDF file.

Method Summary

Modifier and Type	Method and Description
int[]	firstAvailableTime(java.lang.String varName) Returns first available time for a variable.
int[]	firstAvailableTime(java.lang.String varName, int[] start) Returns first available time which is not before the given time for a variable.
double[]	getAvailableTimeRange(java.lang.String varName) Returns available time range using default time instant model.
java.lang.String[]	getDependent(java.lang.String varName) Returns names of variables that the specified variable depends on.
java.lang.String	getIndexName(java.lang.String varName, int index) Returns the name of the specified index of a multi-dimensional variable
double[][]	getScalarTimeSeries(java.lang.String varName) Returns the time series of the specified scalar variable, ignoring points whose value equals fill value.
double[][]	getScalarTimeSeries(java.lang.String varName, boolean ignoreFill) Returns the time series of the specified scalar variable, optionally ignoring points whose value equals fill value.
double[][]	getScalarTimeSeries(java.lang.String varName, boolean ignoreFill, int[] startTime, int[] stopTime) Returns the time series of the specified scalar variable in the specified time range, optionally ignoring points whose value equals fill value.
TimeSeries	getScalarTimeSeries(java.lang.String varName, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) Returns the time series as a TimeSeries of the specified scalar variable in the specified time range using the given time instant model, optionally ignoring points whose value equals fill value.
double[][]	getScalarTimeSeries(java.lang.String varName, int[] startTime, int[] stopTime) Returns the time series of the specified scalar variable in the specified time range, ignoring points whose value equals fill value.
TimeSeries	getScalarTimeSeries(java.lang.String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec) Returns the time series as a TimeSeries, of the specified scalar variable in the specified time range, using the given time instant model, ignoring points whose value equals fill value.
TimeSeries	getTimeSeries(java.lang.String varName) Returns TimeSeries of the specified variable using the default time instant model.
TimeSeries	getTimeSeries(java.lang.String varName, int[] startTime, int[] stopTime) Returns TimeSeries of the specified variable in the specified time range using the default time instant model.
TimeSeries	getTimeSeries(java.lang.String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec) Returns TimeSeries of the specified variable in the specified time range using the given time instant model.
TimeSeries	getTimeSeries(java.lang.String varName, TimeInstantModel tspec) Returns TimeSeries of the specified variable using the specified time instant model.
TimeSeriesOneD	getTimeSeriesOneD(java.lang.String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec, boolean columnMajor) Returns time series of the specified variable in the specified time range using the given time instant model.
double[][]	getVectorTimeSeries(java.lang.String varName, int component) Returns the time series of the specified component of a 1 dimensional variable, ignoring points whose value equals fill value.
double[][]	getVectorTimeSeries(java.lang.String varName, int component, boolean ignoreFill) Returns the time series of the specified component of a 1 dimensional variable, optionally ignoring points whose value equals fill value.
double[][]	getVectorTimeSeries(java.lang.String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime) Returns the time series of the specified component of 1 dimensional variable in the specified time range, optionally ignoring points whose value equals fill value.
TimeSeries	getVectorTimeSeries(java.lang.String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) Returns the time series of the specified component of 1 dimensional variable in the specified time range using the given time instant model, optionally ignoring points whose value equals fill value.
double[][]	getVectorTimeSeries(java.lang.String varName, int component, int[] startTime, int[] stopTime) Returns the time series of the specified component of 1 dimensional variable in the specified time range, ignoring points whose value equals fill value.
TimeSeries	getVectorTimeSeries(java.lang.String varName, int component, int[] startTime, int[] stopTime, TimeInstantModel tspec) Returns the time series as a TimeSeries, of the specified component of a vector variable in the specified time range using the given time instant model, ignoring points whose value equals fill value.
int[]	lastAvailableTime(java.lang.String varName) Returns last available time for a variable.
int[]	lastAvailableTime(java.lang.String varName, int[] stop) Returns last available time which is not later than the given time for a variable.
static TimeInstantModel	timeModelInstance() Returns default time instant model.
static TimeInstantModel	timeModelInstance(java.lang.String offsetUnits) Returns time instant model that uses given units for the offset..
TimeInstantModel	timeModelInstance(java.lang.String varName, int[] baseTime) Returns time instant model with specified base time and default offset units (millisecond) for a variable.
TimeInstantModel	timeModelInstance(java.lang.String varName, int[] baseTime, TimePrecision offsetUnits) Returns time instant model with specified base time and specified offset units (millisecond) for a variable.

Methods inherited from class gov.nasa.gsfc.spdf.cdfj.GenericReader

asDouble0, asDouble1, asDouble2, asDouble3, get, getBuffer, getBuffer, getBuffer, getBuffer, getBufferCapacity, getLong, getOneD, getOneDArray, getOneDArray, getRange, getRangeForComponent, getRangeForComponents, getRangeOneD, getSampled, getSampled, getSource, getVectorComponent, getVectorComponents, isScalar, isVector, sourceIsFile, startContainerThread, threadFinished, userTimeVariableName

Methods inherited from class gov.nasa.gsfc.spdf.cdfj.MetaData

existsVariable, getAttribute, getAttribute, getAttributeEntries, getAttributeEntries, getBlockingFactor, getByteOrder, getDataItemSize, getDimensions, getEffectiveDimensions, getEffectiveRank, getElementCount, getGlobalAttribute, getLastLeapSecondId, getNumber, getNumberOfElements, getNumberOfValues, getPadValue, getPadValue, getRecordRange, getTimeVariableName, getType, getVariableNames, getVariableNames, getVarys, globalAttributeEntryCount, globalAttributeNames, isCompatible, isCompatible, isCompressed, isMissingRecords, isTimeType, isTypeR, missingRecordValueIsPad, missingRecordValueIsPrevious, recordVariance, rowMajority, variableAttributeNames

Methods inherited from class java.lang.Object

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

Constructor Detail

CDFReader

public CDFReader()

CDFReader

public CDFReader(java.lang.String cdfFile)
          throws CDFException.ReaderError

Constructs a reader for the given CDF file.

Parameters:

cdfFile - the cdf file name

Throws:

CDFException.ReaderError - If there was a problem

CDFReader

public CDFReader(java.net.URL url)
          throws CDFException.ReaderError

Constructs a reader for the given URL for CDF file.

Parameters:

url - the URL for CDF file

Throws:

CDFException.ReaderError - If there was a problem

Method Detail

getTimeSeries

public TimeSeries getTimeSeries(java.lang.String varName)
                         throws CDFException.ReaderError

Returns TimeSeries of the specified variable using the default time instant model.

Parameters:

varName - variable name

Returns:

A time series object

Throws:

CDFException.ReaderError - If there was a problem

getTimeSeries

public TimeSeries getTimeSeries(java.lang.String varName,
                                TimeInstantModel tspec)
                         throws CDFException.ReaderError

Returns TimeSeries of the specified variable using the specified time instant model.

Parameters:

varName - variable name

tspec - time instant model, May be null, in which case the default model is used.

Returns:

A time series object

Throws:

CDFException.ReaderError - If there was a problem

getTimeSeries

public TimeSeries getTimeSeries(java.lang.String varName,
                                int[] startTime,
                                int[] stopTime)
                         throws CDFException.ReaderError

Returns TimeSeries of the specified variable in the specified time range using the default time instant model.

Parameters:

varName - variable name

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

Returns:

A time series object

Throws:

CDFException.ReaderError - if not a valid variable name.

getTimeSeries

public TimeSeries getTimeSeries(java.lang.String varName,
                                int[] startTime,
                                int[] stopTime,
                                TimeInstantModel tspec)
                         throws CDFException.ReaderError

Returns TimeSeries of the specified variable in the specified time range using the given time instant model.

Parameters:

varName - variable name

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

Returns:

time series

Throws:

CDFException.ReaderError - if not a valid variable name.

getTimeSeriesOneD

public TimeSeriesOneD getTimeSeriesOneD(java.lang.String varName,
                                        int[] startTime,
                                        int[] stopTime,
                                        TimeInstantModel tspec,
                                        boolean columnMajor)
                                 throws CDFException.ReaderError

Returns time series of the specified variable in the specified time range using the given time instant model.

Parameters:

varName - variable name

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

columnMajor - specifies whether the first index of the variable dimension varies the fastest, i.e. IDL like.

Returns:

time series

Throws:

CDFException.ReaderError - if not a valid variable name.

getAvailableTimeRange

public double[] getAvailableTimeRange(java.lang.String varName)
                               throws CDFException.ReaderError

Returns available time range using default time instant model.

Parameters:

varName - variable name

Returns:

double[2] 0th element is the first available offset time; 1st element is the last available offset time;

Throws:

CDFException.ReaderError - if not a valid variable name.

firstAvailableTime

public int[] firstAvailableTime(java.lang.String varName)
                         throws CDFException.ReaderError

Returns first available time for a variable. Returned time has millisecond precision.

Parameters:

varName - the variable name

Returns:

int[7] containing year, month, day, hour, minute, second and millisecond, or null.

Throws:

CDFException.ReaderError - if not a valid variable name.

firstAvailableTime

public int[] firstAvailableTime(java.lang.String varName,
                                int[] start)
                         throws CDFException.ReaderError

Returns first available time which is not before the given time for a variable. Returned time has millisecond precision.

Parameters:

varName - the variable name

start - a 3 to 7 element int[], containing year, month (January is 1), day, hour, minute, second and millisecond.

Returns:

int[7] containing year, month, day, hour, minute, second and millisecond, or null.

Throws:

CDFException.ReaderError - if not a valid variable name.

lastAvailableTime

public int[] lastAvailableTime(java.lang.String varName)
                        throws CDFException.ReaderError

Returns last available time for a variable. Returned time has millisecond precision.

Parameters:

varName - the variable name

Returns:

int[7] containing year, month, day, hour, minute, second and millisecond, or null.

Throws:

CDFException.ReaderError - if not a valid variable name.

lastAvailableTime

public int[] lastAvailableTime(java.lang.String varName,
                               int[] stop)
                        throws CDFException.ReaderError

Returns last available time which is not later than the given time for a variable. Returned time has millisecond precision.

Parameters:

varName - the variable name

stop - a 3 to 7 element int[], containing year, month (January is 1), day, hour, minute, second and millisecond.

Returns:

int[7] containing year, month, day, hour, minute, second and millisecond, or null.

Throws:

CDFException.ReaderError - if not a valid variable name.

timeModelInstance

public TimeInstantModel timeModelInstance(java.lang.String varName,
                                          int[] baseTime)
                                   throws CDFException.ReaderError

Returns time instant model with specified base time and default offset units (millisecond) for a variable.

Parameters:

varName - variable name

baseTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond.

Returns:

A TimeInstantModel object

Throws:

CDFException.ReaderError - if not a valid variable name or incomplete base time.

timeModelInstance

public TimeInstantModel timeModelInstance(java.lang.String varName,
                                          int[] baseTime,
                                          TimePrecision offsetUnits)
                                   throws CDFException.ReaderError

Returns time instant model with specified base time and specified offset units (millisecond) for a variable.

Parameters:

varName - variable name

baseTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond.

offsetUnits - offset units in milliseconds

Returns:

A TimeInstantModel object

Throws:

CDFException.ReaderError - if not a valid variable name or incomplete base time.

timeModelInstance

public static TimeInstantModel timeModelInstance()

Returns default time instant model.

The base of default TimeInstantModel is January 1,1970 0:0:0

Returns:

A TimeInstantModel object

timeModelInstance

public static TimeInstantModel timeModelInstance(java.lang.String offsetUnits)

Returns time instant model that uses given units for the offset..

The base of default TimeInstantModel is January 1,1970 0:0:0

Parameters:

offsetUnits - offset units in milliseconds

Returns:

A TimeInstantModel object

getDependent

public java.lang.String[] getDependent(java.lang.String varName)

Returns names of variables that the specified variable depends on.

Parameters:

varName - the variable name

Returns:

a string array of variable names that the given variable depends on.

getIndexName

public java.lang.String getIndexName(java.lang.String varName,
                                     int index)
                              throws CDFException.ReaderError

Returns the name of the specified index of a multi-dimensional variable

Parameters:

varName - variable name

index - index to a multi-dimensional variable

Returns:

the name of the variable corresponding to the index that the given variable depends on

Throws:

CDFException.ReaderError - if there is an error

getScalarTimeSeries

public double[][] getScalarTimeSeries(java.lang.String varName)
                               throws CDFException.ReaderError

Returns the time series of the specified scalar variable, ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

Parameters:

varName - variable name

Returns:

2-D double with times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getScalarTimeSeries

public double[][] getScalarTimeSeries(java.lang.String varName,
                                      int[] startTime,
                                      int[] stopTime)
                               throws CDFException.ReaderError

Returns the time series of the specified scalar variable in the specified time range, ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

For numeric variables of dimension other than 0, and for character string variables an exception is thrown.

Parameters:

varName - variable name

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

Returns:

2-D double with times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getScalarTimeSeries

public TimeSeries getScalarTimeSeries(java.lang.String varName,
                                      int[] startTime,
                                      int[] stopTime,
                                      TimeInstantModel tspec)
                               throws CDFException.ReaderError

Returns the time series as a TimeSeries, of the specified scalar variable in the specified time range, using the given time instant model, ignoring points whose value equals fill value.

If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

Parameters:

varName - the variable name

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

Returns:

A TimeSeries object

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getScalarTimeSeries

public double[][] getScalarTimeSeries(java.lang.String varName,
                                      boolean ignoreFill)
                               throws CDFException.ReaderError

Returns the time series of the specified scalar variable, optionally ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - the variable name

ignoreFill - A flag indicating whether to ignore the FILLVAL value

Returns:

A 2-D double with times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getScalarTimeSeries

public double[][] getScalarTimeSeries(java.lang.String varName,
                                      boolean ignoreFill,
                                      int[] startTime,
                                      int[] stopTime)
                               throws CDFException.ReaderError

Returns the time series of the specified scalar variable in the specified time range, optionally ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then if ignoreFill has the value true, points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - the variable name

ignoreFill - A flag indicating whether to ignore the FILLVAL value

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

Returns:

A 2-D double with times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getScalarTimeSeries

public TimeSeries getScalarTimeSeries(java.lang.String varName,
                                      boolean ignoreFill,
                                      int[] startTime,
                                      int[] stopTime,
                                      TimeInstantModel tspec)
                               throws CDFException.ReaderError

Returns the time series as a TimeSeries of the specified scalar variable in the specified time range using the given time instant model, optionally ignoring points whose value equals fill value.

If a fill value has been specified for this variable via the FILLVAL attribute, then if ignoreFill has the value true, points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - the variable name

ignoreFill - A flag indicating whether to ignore the FILLVAL value

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

Returns:

A TimeSeries object

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a scalar.

getVectorTimeSeries

public double[][] getVectorTimeSeries(java.lang.String varName,
                                      int component)
                               throws CDFException.ReaderError

Returns the time series of the specified component of a 1 dimensional variable, ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

Parameters:

varName - the variable name

component - The component in 1-D array

Returns:

A 2-D double containing times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector.

getVectorTimeSeries

public double[][] getVectorTimeSeries(java.lang.String varName,
                                      int component,
                                      int[] startTime,
                                      int[] stopTime)
                               throws CDFException.ReaderError

Returns the time series of the specified component of 1 dimensional variable in the specified time range, ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

Parameters:

varName - the variable name

component - The component in 1-D array

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

Returns:

A 2-D double containing times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector.

getVectorTimeSeries

public TimeSeries getVectorTimeSeries(java.lang.String varName,
                                      int component,
                                      int[] startTime,
                                      int[] stopTime,
                                      TimeInstantModel tspec)
                               throws CDFException.ReaderError

Returns the time series as a TimeSeries, of the specified component of a vector variable in the specified time range using the given time instant model, ignoring points whose value equals fill value.

If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded.

Parameters:

varName - variable name

component - index of the vector component

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

Returns:

A TimeSeries object

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector.

getVectorTimeSeries

public double[][] getVectorTimeSeries(java.lang.String varName,
                                      int component,
                                      boolean ignoreFill)
                               throws CDFException.ReaderError

Returns the time series of the specified component of a 1 dimensional variable, optionally ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - variable name

component - index of the vector component

ignoreFill - A flag indicating whether to ingore the FILLVAL value

Returns:

A 2-D double containing times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector.

getVectorTimeSeries

public double[][] getVectorTimeSeries(java.lang.String varName,
                                      int component,
                                      boolean ignoreFill,
                                      int[] startTime,
                                      int[] stopTime)
                               throws CDFException.ReaderError

Returns the time series of the specified component of 1 dimensional variable in the specified time range, optionally ignoring points whose value equals fill value.

A double[2][] array is returned. The 0th element is the array containing times, and the 1st element is the array containing corresponding values. If a fill value has been specified for this variable via the FILLVAL attribute, then points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - variable name

component - index of the vector component

ignoreFill - A flag indicating whether to ingore the FILLVAL value

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

Returns:

A 2-D double containing times and values

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector.

getVectorTimeSeries

public TimeSeries getVectorTimeSeries(java.lang.String varName,
                                      int component,
                                      boolean ignoreFill,
                                      int[] startTime,
                                      int[] stopTime,
                                      TimeInstantModel tspec)
                               throws CDFException.ReaderError

Returns the time series of the specified component of 1 dimensional variable in the specified time range using the given time instant model, optionally ignoring points whose value equals fill value.

If a fill value has been specified for this variable via the FILLVAL attribute, then if ignoreFill has the value true, points where the value is equal to fill value are excluded if ignoreFill = true.

Parameters:

varName - variable name

component - index of the vector component

ignoreFill - A flag indicating whether to ingore the FILLVAL value

startTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the first available time is used.

stopTime - a 3 to 7 element int[], containing year, month (January is 1), day,hour, minute, second and millisecond. May be null, in which case the stop time is assumed to be later than the last available time.

tspec - time instant model, May be null, in which case the default model is used.

Returns:

A TimeSeries object

Throws:

CDFException.ReaderError - if variables is non-numeric, or is not a vector. Use getTimeSeries( String varName) for string type.