Clip (FPScript)

21.09.2021

Clips the amplitude of a data set.

Syntax

Clip(DataSet, [ LowerLimit ] [ , UpperLimit ])

 

The syntax of the Clip function consists of the following parts:

Part

Description

DataSet

The data set for which the amplitude is to be clipped.

All data structures are allowed, except scalar value und list. All numeric 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.

LowerLimit

The lower limit for the amplitude. If there is to be no limit at the bottom, you can omit the argument or specify ? or Empty.

Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet.

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.

UpperLimit

The upper limit for the amplitude. If there is to be no limit at the top, you can omit the argument or specify ? or Empty.

Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet.

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

The result has the same structure and unit as the argument DataSet.

If DataSet is of the calendar time or time span data type, then this also applies for the result. For all other DataSet data types, the data type of the result is a 64-bit floating point value.

All values above the upper or below the lower limit are set to the relevant limiting value.

Available in

FlexPro Basic, Professional, Developer Suite

Examples

Clip(Signal, -0.8, 0.8)

Limits the amplitude of a signal to the interval [-0.8, 0.8].

Clip(Signal, , 0.8))

Limits the amplitude of a signal only at the top to the value 0.8.

See Also

Clip2D Function

ValuesInInterval Function

Share article or send as email:

You might be interested in these articles