Scripting > Math Functions


Time Derivative (Difference Per Unit Time)

timeDerivative()

 

Derive a new time series data set from the successive differences per unit time of the current regular or irregular interval time series data set.  For the time “t”,

 

TS2(t)  =  ( TS1(t) – TS1(t-1) ) / DT

 

where DT is the time difference between t and t-1.  For the current form of the function, the units of DT are minutes.

 

A value in the resultant time series is set to missing if either the current or previous value in the original time series is missing (need to have two consecutive valid values).  By default, the data type of the resultant time series data set is assigned as "PER-AVER.”

 

See also:  successiveDifferences()

Parameters:  Takes no parameters

Example: newTsData = tsData.timeDerivative()

Returns:  A new TimeSeriesMath object