TimeAtLevelCount (FPScript)
Performs a time-at-level count (time-at-level procedure) in accordance with the DIN 45667 standard.
Syntax
TimeAtLevelCount(Signal, ClassLimits)
or
TimeAtLevelCount(Amplitude, Time, ClassLimits)
The syntax of the TimeAtLevelCount function consists of the following parts:
Part |
Description |
|---|---|
Signal |
The signal to be examined. Permitted data structures are signal, signal series und signal series with two-dimensional X-component. All real data types are permitted. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
Amplitude |
The Y component of the signal to be examined. If you specify a signal, then its Y component is used. Permitted data structures are data series, data matrix, signal, signal series und signal series with two-dimensional X-component. All real data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
Time |
The X component of the signal to be examined. If you specify a signal, then its Y component is used. Permitted data structures are data series, data matrix, signal und signal series with two-dimensional X-component. All real data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
ClassLimits |
Contains a data series, which contains the class limits for the signal. If ClassLimits contains n values, this leads to n-1 closed classes. The first or the last value in ClassLimits provides the lowest or highest limit of the class division. Values that lie outside the limits are not counted. Permitted data structures are data series. All real data types are permitted. The unit has to be compatible with that of parameter Amplitude. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
Remarks
Void values are not counted. The result is a signal or a signal series with the dwell times in the Y component. The X component then contains the mid-points of the class divisions specified as the ClassLimits argument.
Available in
Option Counting Procedures
Examples
TimeAtLevelCount(Signal({1, 9, 7, 5, 7, 6, 10, 2, 4, 2, 7}, 0.1), (11., 0.5, 1))
Results in Signal({0, 0.2, 0, 0.1, 0.1, 0.1, 0.3, 0, 0.1, 0.1}, (10., 1, 1)). Carries out a time-at-level count. Ten classes are defined with the class width of 1 starting at 0.5. The sampling rate of the signal is 0.1.