Expand (FPScript)
Erhöht die Werteanzahl eines Datensatzes.
Syntax
Expand(DataSet, ExpansionFactor)
Die Syntax der Expand-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
DataSet |
Der Datensatz, dessen Werteanzahl vergrößert werden soll. Es sind alle Datenstrukturen erlaubt außer Einzelwert und Liste. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
ExpansionFactor |
Ein Faktor, der angibt, um wie viel die Werteanzahl vergrößert werden soll. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Der Wert muss größer gleich 1 sein. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Das Ergebnis hat die gleiche Einheit wie das Argument DataSet.
Die Expansion erfolgt durch lineare Interpolation, d. h. dass benachbarte Werte im DataSet durch eine Gerade verbunden werden, die an der entsprechenden Anzahl von Punkten ausgewertet wird.
Bei zusammengesetzten Datenstrukturen werden deren Komponenten separat expandiert. Die Werte in den einzelnen Komponenten von DataSet müssen nicht aufsteigend oder abfallend sein.
Bei einem Datensatz mit Werteanzahl n ergibt sich als Werteanzahl für das Ergebnis:
(n - 1) * ExpansionFactor + 1
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Expand({1., 3., 5., 7.}, 2) |
Ergibt {1., 2., 3., 4., 5., 6., 7.}. Vergrößert die Datenreihe um den Faktor 2. |
Expand({1., 2., 5., 7.}, 2) |
Ergibt {1., 1.5, 2., 3.5, 5., 6., 7.}. |