Package hec.data.tx

Class DSSTimeSeries

java.lang.Object

hec.heclib.dss.HecDSSFileAccess

hec.heclib.dss.HecDssCatalog

hec.heclib.dss.HecDSSDataAttributes

hec.heclib.dss.HecDataManager

hec.heclib.dss.HecTimeSeriesBase

hec.heclib.dss.HecTimeSeries

hec.data.tx.DSSTimeSeriesTranslator

hec.data.tx.DSSTimeSeries

All Implemented Interfaces:

HecDssListener, Serializable, Cloneable, EventListener

@Deprecated
public class DSSTimeSeries
extends DSSTimeSeriesTranslator

Deprecated.

use DSSTimeSeriesTranslator and DSSTimeSeriesUtil instead

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class hec.heclib.dss.HecDssCatalog

HecDssCatalog.WriteCatalogFileRunnable

Field Summary

Fields inherited from class hec.heclib.dss.HecTimeSeries

_timeZone

Fields inherited from class hec.heclib.dss.HecTimeSeriesBase

_defaultInterval, _interval, _retrieveAllTimes

Fields inherited from class hec.heclib.dss.HecDataManager

_recordData, logFileName, messageUnit

Fields inherited from class hec.heclib.dss.HecDSSDataAttributes

_arrayEndTime, _arraySize, _arrayStartTime, _checkedNumber, _dataLengthInts, _dataType, _defaultEndTime, _defaultStartTime, _desiredArraySize, _dirty, _dssPathname, _endTime, _localUnitSystem, _recordExists, _recordType, _slashPosition, _startTime, _timeSeries, _timeWindowSet, _typeX, _unitsX, ALBERS, ALBERS_GRID, ALBERS_GRID_WITH_TIME, DOUBLE_ARRAY, ENGLISH_UNITS, ERROR, FILE, FLOAT_ARRAY, HRAP, HRAP_GRID, HRAP_GRID_WITH_TIME, IMAGE, INT_ARRAY, IRREGULAR_TIME_PATTERN, IRREGULAR_TIME_SERIES, IRREGULAR_TIME_SERIES_DOUBLES, LOCATION_LEVEL, PAIRED, PAIRED_DOUBLES, REGULAR_TIME_PATTERN, REGULAR_TIME_SERIES, REGULAR_TIME_SERIES_DOUBLES, SI_UNITS, SINGLE_VALUE, SPECIFIED_GRID, SPECIFIED_GRID_TYPE, SPECIFIED_GRID_WITH_TIME, TEXT, UNDEFINED_GRID, UNDEFINED_GRID_TYPE, UNDEFINED_GRID_WITH_TIME, UNDEFINED_UNITS, UNKNOWN

Fields inherited from class hec.heclib.dss.HecDssCatalog

_catalogName, _forceNewCatalog, _listenerList, _observerThreads, _useCollectionGroups, crcValues, dataTypeEnd, dataTypeStart, endDates, lastWriteTimeFile, lastWriteTimeRecord, listIsCollection, listIsComplete, listIsSorted, maxNumberToRetrieve, pathnameAddresses, pathnameHash, pathnameList, pathnameWithWild, startDates, statusRead, statusWanted

Fields inherited from class hec.heclib.dss.HecDSSFileAccess

_defaultDirectory, _defaultDSSFileName, _fileData, _maxNumberReopensForError, _numberReopensForError, _severeErrorIndex, _severeErrorMessages, _severeErrorRaised, ABBREVIATED_CATALOG, CONDENSED_CATALOG, FULL_CATALOG, MESS_LEVEL_CRITICAL, MESS_LEVEL_GENERAL, MESS_LEVEL_INTERNAL_DIAG_1, MESS_LEVEL_INTERNAL_DIAG_2, MESS_LEVEL_NONE, MESS_LEVEL_TERSE, MESS_LEVEL_USER_DIAG, MESS_METHOD_ALIAS, MESS_METHOD_CATALOG, MESS_METHOD_CHECK, MESS_METHOD_COPY, MESS_METHOD_FILE_CHECK, MESS_METHOD_GENERAL, MESS_METHOD_GET, MESS_METHOD_GLOBAL, MESS_METHOD_JNI, MESS_METHOD_LOCKING, MESS_METHOD_OPEN, MESS_METHOD_PERM, MESS_METHOD_PUT, MESS_METHOD_READ, MESS_METHOD_TS_READ, MESS_METHOD_TS_WRITE, MESS_METHOD_UTILITY, MESS_METHOD_WRITE

Constructor Summary

Constructors

Constructor	Description
DSSTimeSeries()	Deprecated.

Method Summary

Modifier and Type	Method	Description
static DescriptionTx	getDefaultDescription(String dssPath, String dssType, DescriptionTx similarDesc)	Deprecated. use DSSTimeSeriesUtil::getDefaultDescription
static String	getDefaultPathname(DataSetTxTemplate dataSetTxTemplate)	Deprecated. use DSSTimeSeriesUtil::getDefaultPathname
static String	getDefaultPathname(DescriptionTx description)	Deprecated. use DSSTimeSeriesUtil::getDefaultPathname
DescriptionTx	getDescription()	Deprecated.
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, DescriptionTx desc2)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, DescriptionTx desc2, String desc2DssType)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, DescriptionTx desc2, String pathname2, String desc2DssType)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, String desc1DssType, DescriptionTx desc2)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, String pathname1, String desc1DssType, DescriptionTx desc2)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static StringBuffer	getDescriptionDifferences(DescriptionTx desc1, String pathname1, String dssType1, DescriptionTx desc2, String pathname2, String dssType2)	Deprecated. use DSSTimeSeriesUtil::getDescriptionDifferences
static String	getDSSType(Parameter parameter, ParameterType parameterType)	Deprecated. use DSSTimeSeriesUtil::getDSSType
static String	getDSSType(DescriptionTx description)	Deprecated. use DSSTimeSeriesUtil::getDSSType
static Interval	getIntervalFromDssInterval(String dssIntervalStr)	Deprecated. use DSSTimeSeriesUtil::getIntervalFromDssInterval
static ParameterType	getParameterType(String dssType)	Deprecated. use DSSTimeSeriesUtil::getDSSType
DataSetTx	read(String pathname, long startTime, long endTime, TimeZone timeZone)	Deprecated.
DataSetTx	read(String pathname, long startTime, long endTime, TimeZone timeZone, TimeZone timeZoneOverride)	Deprecated.
DataSetTx	read(String pathname, DescriptionTx description, long startTime, long endTime, TimeZone timeZone)	Deprecated.
DataSetTx	read(String pathname, DescriptionTx description, long startTime, long endTime, TimeZone timeZone, TimeZone timeZoneOverride)	Deprecated.
DataSetTx	readAndChangeUnits(DataSetTxTemplate template, TimeZone timeZone)	Deprecated. Public read functions
DataSetTx	readAndChangeUnits(DataSetTxTemplate template, TimeZone timeZone, String pathname)	Deprecated.
DataSetTx	readAndChangeUnits(DataSetTxTemplate template, TimeZone timeZone, TimeZone timeZoneOverride)	Deprecated.
DataSetTx	readAndChangeUnits(DataSetTxTemplate template, TimeZone timeZone, TimeZone timeZoneOverride, String pathname)	Deprecated.
void	setDescription(DescriptionTx description)	Deprecated.
int	write(DataSetTx dataSet, TimeZone timeZone)	Deprecated.
int	write(DataSetTx dataSet, TimeZone timeZone, DSSPathname writePathname)	Deprecated.
int	write(DataSetTx dataSet, TimeZone timeZone, String pathname)	Deprecated. Public write functions
int	write(DataSetTx dataSet, TimeZone timeZone, String pathname, String dssType)	Deprecated.

Methods inherited from class hec.data.tx.DSSTimeSeriesTranslator

getTimeSeriesIdentifier, readAndChangeUnits, readAndChangeUnits, readAndChangeUnits, readAndChangeUnits, readTimeSeries, readTimeSeries, readTimeSeries, readTimeSeries, setDescription, write, write, write, write

Methods inherited from class hec.heclib.dss.HecTimeSeries

arraySizeOk, checkTimeWindow, clear, computeTimes, contractProfileContainer, DSSFileName, expandProfileContainer, flushToDisk, getBlockStartDate, getCoincidentTimes, getCollectionList, getData, getData, getDesiredArraySize, getFlags, getInterval, getSeriesPathnameRange, getSeriesTimeRange, getStandardPathDate, getStatistics, getStoreDoubles, getSupplementalInfo, getTimes, getTimes, getTimeZone, hasTimeZone, incrementalValue, intIndex, prepareForWrite, read, read, read, read, read, read, read, read, read, read, read, read, read, removeLeadingTrailingMissing, removeTimeZone, reset, resetArrayTime, retrieveData, saveDataToDisk, setData, setData, setData, setFlags, setFlags, setIrregularIntervalInFlag, setReadPreviousSubsquent, setRegularIntervalStorePlan, setRetrieveAllTimes, setStoreDoubles, setTimes, setTimes, setTimes, setTimeZone, status, timeWindowNumber, updateArrayTime, value, write, write, write, write, write, write, write, write, ztsRetrieve, ztsStore, ztsStore

Methods inherited from class hec.heclib.dss.HecTimeSeriesBase

getAppropriateEPart, getAppropriateIrregularBlock, getAppropriateRegularEPart, getDefaultUnitsType, getDpartFromTime, getEPartFromInterval, getIntervalFromEPart, getListOfEParts, getMostCommonInterval, getNumberValuesForArraySize, getTimeWindowFromPath, interval, isRegular, numberValues, precision, setDefaultEPart, setDefaultInterval, setDefaultPathnameParts, setEPart, setInterval, setPathname, setPathnameParts, setPrecision, setStartTime, setType, setUnits, type, units, zgintlFromEPart

Methods inherited from class hec.heclib.dss.HecDataManager

addAlias, addAlias, addAlias, addAliasList, aliasGetPrimary, aliasGetPrimary, aliasList, aliasList, aliasRemove, aliasRemove, aliasRemoveList, closeLogFile, closeMessageFile, convertUnitSystem, copyContainerToRecordData, copyRecordDataToContainer, displayLogFile, done, flushMessageFile, generateLogFileName, getLogFileName, getRecordInfo, getRecordInfo, getRecordInfo, getTSRecordInfo, numberArray, release, release, setLogFile, setMessageFile, setProgramName, windMessageFile, Xarray, Yarray, Yarray, zlocationRetrieve, zlocationStore

Methods inherited from class hec.heclib.dss.HecDSSDataAttributes

aPart, arrayEndTime, arrayStartTime, bPart, clearDefaultParts, convertDoubleUnits, convertUnits, cPart, createArrayObject, createObject, createPairedDataObject, createTextObject, createTimeSeriesObject, defaultAPart, defaultBPart, defaultCPart, defaultDPart, defaultEPart, defaultFPart, dirty, dPart, endTime, ePart, fPart, getLastWriteTime, getLastWriteTime, getLastWriteTimeMillis, getLastWriteTimeMillis, getRecordBasics, isGridRecord, isTimeWindowSet, localUnitSystem, pathname, pathnameDataType, readRawBytes, readRawBytes, readRawRecord, readRawShorts, readRawShorts, recordExists, recordsUpdated, recordType, recordType, recordTypes, setAPart, setBPart, setCPart, setDefaultAPart, setDefaultBPart, setDefaultCPart, setDefaultDPart, setDefaultFPart, setDefaultTimeWindow, setDefaultTimeWindow, setDPart, setDSSFileName, setEndTime, setFPart, setLocalUnitSystem, setTimeWindow, setTimeWindow, startTime, writeRawRecord

Methods inherited from class hec.heclib.dss.HecDssCatalog

addHecDssListener, addHecDssListener, addHecDssListener, addHecDssListener, addHecDssListener, addHecDssListener, addHecDssListener, buildCondensedList, buildSortedCatalog, callCatalog, callCatalog, callCatalog, callCatalogOriginal, catalogFile, cleanCatalogPart, clearList, clone, compareCondensedPaths, createNewCatalog, expandPathname, fireHecDssEvent, getCatalog, getCatalog, getCatalog, getCatalogName, getCatalogSortAddresses, getCondensedCatalog, getCondensedCatalog, getEndDates, getEPartLoc, getMaximumPartLengths, getMaximumPartLengths, getPathnameList, getPathnameList, getPathnameList6, getPathnameList7, getPathnameListAndDates, getPathnameListType, getPathnames, getSortedPathnameList, getStartDates, getStatusRead, getUseCollectionGroups, hecDssEventPerformed, isCatalogValid, isPathnamePartsString, numberCatalogedRecords, pathNamePartsToRegex, processSearchParts, readCatalog, removeHecDssListener, searchDSSCatalog, searchDSSCatalog, searchDSSPaths, searchDSSPaths, setCatalogSortAddresses, setForceNewCatalog, setMaxNumberToRetrieve, setPathnameList, setPathnameList, setPathWithWildChars, setStatusWanted, setTypeWanted, setUseCollectionGroups, sort, sortCatalog, startObserverThread, whatChanged, whatChanged, whatChangedCompare, whatChangedSetStart, whatChangedSetStart, whatChangedSetStart, wildCharsToRegex, writeCatalog

Methods inherited from class hec.heclib.dss.HecDSSFileAccess

allSevereErrorMessages, appendNameToDirectory, catchSevereErrors, checkAccessReset, checkAllPathnames, checkForError, checkForSevereError, checkForSevereError, checkForSevereFileError, checkLinks, checkPathnameBins, checkSystemError, cleanDSSFileName, clearError, clearSevereError, clearSevereError, clearStatus, close, close, closeAll, closeAllFiles, closeAndClear, closeDSSFile, debugLook, debugLook7, debugModify, defaultDirectory, defaultDSSFileName, doesDSSFileExist, DSSFileName, fileAccessible, fileOpened, fileStatus, flushMessages, forceMultiUserAccess, getCollectionSequenceList, getCollectionSize, getDssFileVersion, getDssFileVersion, getFileInfo, getFileLastWriteTime, getFileLastWriteTimeMillis, getIrregBeginningDate, getLastError, getMessageLevel, getNumberRecords, getProcessStatus, getTimeSeriesExtents, getTSRecordInfo, isFileRemote, lastSevereErrorMessage, nextTimeSeriesPathname, numberRecords, open, open, processStatus, requestSecondAccess, setDefaultDirectory, setDefaultDSSFileName, setDss, setDSSFileName, setDSSFileName, setDSSFileName, setInterrupt, setMessageLevel, setSpaceReclaimation, setSpaceReclaimationPerm, setUnit, writeAccess, zgetMessageLevel, zinqir, zinqir, zinquire, zmessage, zquery, zquery, zset, zsetFile, zsetMessageLevel

Methods inherited from class java.lang.Object

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

Constructor Details

DSSTimeSeries

public DSSTimeSeries()

Deprecated.

Method Details

readAndChangeUnits

public DataSetTx readAndChangeUnits(DataSetTxTemplate template,
 TimeZone timeZone)
                             throws DataSetException

Deprecated.

Public read functions

Throws:

DataSetException

readAndChangeUnits

public DataSetTx readAndChangeUnits(DataSetTxTemplate template,
 TimeZone timeZone,
 TimeZone timeZoneOverride)
                             throws DataSetException

Deprecated.

Throws:

DataSetException

readAndChangeUnits

public DataSetTx readAndChangeUnits(DataSetTxTemplate template,
 TimeZone timeZone,
 String pathname)
                             throws DataSetException

Deprecated.

Throws:

DataSetException

readAndChangeUnits

public DataSetTx readAndChangeUnits(DataSetTxTemplate template,
 TimeZone timeZone,
 TimeZone timeZoneOverride,
 String pathname)
                             throws DataSetException

Deprecated.

Throws:

DataSetException

read

public DataSetTx read(String pathname,
 long startTime,
 long endTime,
 TimeZone timeZone)
               throws DataSetException

Deprecated.

Throws:

DataSetException

read

public DataSetTx read(String pathname,
 long startTime,
 long endTime,
 TimeZone timeZone,
 TimeZone timeZoneOverride)
               throws DataSetException

Deprecated.

Throws:

DataSetException

read

public DataSetTx read(String pathname,
 DescriptionTx description,
 long startTime,
 long endTime,
 TimeZone timeZone)
               throws DataSetException

Deprecated.

Throws:

DataSetException

read

public DataSetTx read(String pathname,
 DescriptionTx description,
 long startTime,
 long endTime,
 TimeZone timeZone,
 TimeZone timeZoneOverride)
               throws DataSetException

Deprecated.

Throws:

DataSetException

write

public int write(DataSetTx dataSet,
 TimeZone timeZone,
 String pathname)
          throws DataSetIllegalArgumentException,
DataSetTxException,
DSSTimeSeriesWriteException

Deprecated.

Public write functions

Throws:

DataSetIllegalArgumentException

DataSetTxException

DSSTimeSeriesWriteException

write

public int write(DataSetTx dataSet,
 TimeZone timeZone,
 String pathname,
 String dssType)
          throws DataSetIllegalArgumentException,
DataSetTxException,
DSSTimeSeriesWriteException

Deprecated.

Throws:

DataSetIllegalArgumentException

DataSetTxException

DSSTimeSeriesWriteException

write

public int write(DataSetTx dataSet,
 TimeZone timeZone,
 DSSPathname writePathname)
          throws DataSetIllegalArgumentException,
DataSetTxException,
DSSTimeSeriesWriteException

Deprecated.

Throws:

DataSetIllegalArgumentException

DataSetTxException

DSSTimeSeriesWriteException

write

public int write(DataSetTx dataSet,
 TimeZone timeZone)
          throws DataSetTxEmptyException,
DSSTimeSeriesWriteException

Deprecated.

Throws:

DataSetTxEmptyException

DSSTimeSeriesWriteException

setDescription

public void setDescription(DescriptionTx description)

Deprecated.

getDescription

public DescriptionTx getDescription()
                             throws DataSetIllegalArgumentException

Deprecated.

Throws:

DataSetIllegalArgumentException

getDefaultPathname

@Deprecated
public static String getDefaultPathname(DataSetTxTemplate dataSetTxTemplate)

Deprecated.

use DSSTimeSeriesUtil::getDefaultPathname

getDefaultPathname

@Deprecated
public static String getDefaultPathname(DescriptionTx description)

Deprecated.

use DSSTimeSeriesUtil::getDefaultPathname

getParameterType

@Deprecated
public static ParameterType getParameterType(String dssType)
                                      throws DataSetIllegalArgumentException

Deprecated.

use DSSTimeSeriesUtil::getDSSType

getParameterType returns a CWMS ParameterType object derived from a DSS Type. If the DSS Type is not known to CWMS, the parameter type this returned as a null.

Throws:

DataSetIllegalArgumentException

getIntervalFromDssInterval

@Deprecated
public static Interval getIntervalFromDssInterval(String dssIntervalStr)
                                           throws DataSetIllegalArgumentException

Deprecated.

use DSSTimeSeriesUtil::getIntervalFromDssInterval

getIntervalFromDssInterval returns a CWMS Interval object derived from a DSS Interval String. If the DSS Interval is not known to CWMS, the Interval this returned as a null.

Throws:

DataSetIllegalArgumentException

getDSSType

@Deprecated
public static String getDSSType(DescriptionTx description)

Deprecated.

use DSSTimeSeriesUtil::getDSSType

getDSSType

@Deprecated
public static String getDSSType(Parameter parameter,
 ParameterType parameterType)

Deprecated.

use DSSTimeSeriesUtil::getDSSType

getDSSType returns a string of DSS type derived from the CWMS parameter and parameter type.

getDefaultDescription

@Deprecated
public static DescriptionTx getDefaultDescription(String dssPath,
 String dssType,
 DescriptionTx similarDesc)
                                           throws DataSetIllegalArgumentException

Deprecated.

use DSSTimeSeriesUtil::getDefaultDescription

getDefaultDescription returns a DescriptionTx object derived from the DSS Pathname string, a DSS Type string, and a CWMS Description object.

The description method argument is may be null, in which case appropriate exceptions are thrown for unrecognized DSS pathname C-PART and DSS data types.

If the DSS Pathname C-PART string contains the parameterType and duration in the form "parameter--parameterType-duration", these are overridden by the specified argument string "dssType".

If the "dssType" is specified as "null", the parameterType will be taken from the pathname C-Part first, or if the C-Part contains no parameterType, from the description argument object.

Duration will come from the description argument object when it is not null and its duration is compatible with parameterType determined as above. When the description argument is null or its duration is incompatible, duration will come first from the C-Part when it is specified, or it will be set to the value of interval.

If the DSS Pathname C-PART contains a CWMS recognized parameter, it will be used in the resulting description. Otherwise the parameter from the method argument DescriptionTx object "similarDesc" will be used.

If the DSS Pathame E-PART is a recognized DSS interval, it will be used in the resulting description.

Throws:

DataSetIllegalArgumentException

DataSetIllegalArgumentException

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 DescriptionTx desc2)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences

getDescriptionDifferences returns list of differences between two descriptions, excluding location or labeling, or null if no differences. Optional String arguments identify the DSS-Pathname or DSS-type equivalent to each description, which are used to construct additional labels in the first or second description's interval or parameterType difference messages.

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 String desc1DssType,
 DescriptionTx desc2)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 DescriptionTx desc2,
 String desc2DssType)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 String pathname1,
 String desc1DssType,
 DescriptionTx desc2)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 DescriptionTx desc2,
 String pathname2,
 String desc2DssType)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences

getDescriptionDifferences

@Deprecated
public static StringBuffer getDescriptionDifferences(DescriptionTx desc1,
 String pathname1,
 String dssType1,
 DescriptionTx desc2,
 String pathname2,
 String dssType2)

Deprecated.

use DSSTimeSeriesUtil::getDescriptionDifferences