Increment (FPScript)
Ermittelt das Inkrement eines Datensatzes bzw. von dessen X-Komponente mit linear ansteigenden oder abfallenden Werten.
Syntax
Increment(DataSet)
Die Syntax der Increment-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
DataSet |
Der Datensatz, dessen Inkrement ermittelt wird. Es sind alle Datenstrukturen erlaubt außer Einzelwert und Liste. Nicht unterstützte Datentypen sind Zeichenkette. |
Anmerkungen
Als Ergebnis liefert die Funktion einen Einzelwert vom Datentyp 64-Bit Fließkomma.
Das Ergebnis hat die gleiche Einheit wie das Argument DataSet.
Bei Signalen, Signalreihen und Raumkurven wird nur die X-Komponente analysiert. Das Inkrement entspricht der Differenz aufeinander folgender Werte im Datensatz. Die Inkremente zwischen benachbarten Werten müssen jedoch nicht exakt gleich sein, sondern dürfen um maximal 1 % abweichen. Wenn dieses Toleranzband überschritten wird, der Datensatz nicht mindestens zwei Werte enthält oder dieser ungültige Werte enthält, dann wird ein ungültiger Fließkommawert übergeben. Ansonsten wird das Inkrement zwischen erstem und zweitem Wert übergeben.
Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.
Bei komplexen Datentypen erfolgt eine Betragsbildung.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
Increment({1, 3, 5}) |
Ergibt 2. |
Increment({1, 2.001, 3}) |
Ergibt 1.001. |
Increment({1, 2, 3.001}) |
Ergibt 1. |
Increment({1, 2.1, 3}) |
Ergibt ?. |
Increment({1, 2, ?, 4}) |
Ergibt ?. |
Increment((10, 0 Hz, 0.5 Hz)) |
Ergibt 0.5 Hz. |
Increment(Signal({1 V, 1.5 V }, 0.5 ms)) |
Ergibt 0.5 ms. |