6 Mathematische Funktionen

Alle hier aufgeführten Funktionen werden unterstützt in:

• Auslöser-Ausdrücken
• Berechneten Datenpunkten
• Ausdrucks-Makros

Mathematische Funktionen werden mit den Werttypen Gleitkommazahl und Ganzzahl unterstützt, sofern nicht anders angegeben.

Die Funktionen sind ohne zusätzliche Informationen aufgeführt. Klicken Sie auf die Funktion, um die vollständigen Details anzuzeigen.

Funktionsdetails

Einige allgemeine Hinweise zu Funktionsparametern:

• Funktionsparameter werden durch ein Komma getrennt
• Ausdrücke werden als Parameter akzeptiert
• Optionale Funktionsparameter (oder Parameterteile) werden durch < > gekennzeichnet

abs(value)

Der Absolutwert (ab 0) eines Wertes.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Absolutwert von sowohl „3“ als auch „-3“ gleich „3“.

Beispiel:

abs(last(/host/key))>10

acos(value)

Der Arkuskosinus eines Werts als Winkel, ausgedrückt in Radiant.

Parameter:

• value - der zu prüfende Wert

Der Wert muss zwischen -1 und 1 liegen. Zum Beispiel ist der Arkuskosinus des Werts „0.5“ „2.0943951“.

Beispiel:

acos(last(/host/key))

asin(value)

Der Arkussinus eines Werts als Winkel, ausgedrückt in Radiant.

Parameter:

• value - der zu prüfende Wert

Der Wert muss zwischen -1 und 1 liegen. Zum Beispiel ist der Arkussinus des Werts „0.5“ „-0.523598776“.

Beispiel:

asin(last(/host/key))

atan(value)

Der Arkustangens eines Werts als Winkel, ausgedrückt in Radiant.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Arkustangens des Werts „1“ gleich „0.785398163“.

Beispiel:

atan(last(/host/key))

atan2(value,abscissa)

Der Arkustangens der Ordinaten- (value) und Abszissenkoordinaten, angegeben als Winkel und ausgedrückt in Radiant.

Parameter:

• value - der zu prüfende Wert;
• abscissa - der Abszissenwert.

Zum Beispiel ist der Arkustangens der Ordinaten- und Abszissenkoordinaten eines Werts '1' gleich '2.21429744'.

Beispiel:

atan2(last(/host/key),2)

avg(<value1>,<value2>,...)

Der Durchschnittswert der referenzierten Datenpunktwerte.

Parameter:

• valueX - der von einer anderen Funktion zurückgegebene Wert, die mit der Datenpunkthistorie arbeitet.

Beispiel:

avg(avg(/host/key,1h),avg(/host2/key2,1h))

cbrt(value)

Die Kubikwurzel eines Wertes.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist die Kubikwurzel von „64“ „4“, von „63“ „3,97905721“.

Beispiel:

cbrt(last(/host/key))

ceil(value)

Rundet den Wert auf die nächstgrößere oder gleiche ganze Zahl auf.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel wird „2.4“ auf „3“ aufgerundet. Siehe auch floor().

Beispiel:

ceil(last(/host/key))

cos(value)

Der Kosinus eines Werts, wobei der Wert ein Winkel ist, der in Radiant ausgedrückt wird.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Kosinus des Werts „1“ gleich „0.54030230586“.

Beispiel:

cos(last(/host/key))

cosh(value)

Der hyperbolische Kosinus eines Werts. Gibt den Wert als reelle Zahl und nicht in wissenschaftlicher Notation zurück.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der hyperbolische Kosinus des Werts „1“ gleich „1.54308063482“.

Beispiel:

cosh(last(/host/key))

cot(value)

Der Kotangens eines Werts, wobei der Wert ein in Radiant ausgedrückter Winkel ist.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Kotangens eines Werts '1' gleich '0.54030230586'.

Beispiel:

cot(last(/host/key))

degrees(value)

Konvertiert einen Wert von Radiant in Grad.

Parameter:

• value - der zu prüfende Wert

Beispielsweise wird ein Wert '1' bei der Umrechnung in Grad zu '57.2957795'.

Beispiel:

degrees(last(/host/key))

e

Die Eulersche Zahl (2.718281828459045).

Beispiel:

e()

exp(value)

Die Eulersche Zahl hoch dem Wert eines Wertes.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ergibt die Eulersche Zahl hoch dem Wert „2“ den Wert „7.38905609893065“.

Beispiel:

exp(last(/host/key))

expm1(value)

Die Eulersche Zahl hoch dem Wert minus 1.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ergibt die Eulersche Zahl hoch dem Wert „2“ minus 1 den Wert „6.38905609893065“.

Beispiel:

expm1(last(/host/key))

floor(value)

Rundet den Wert auf die nächstkleinere oder gleiche Ganzzahl ab.

Parameter:

• value – der zu prüfende Wert

Zum Beispiel wird „2.6“ auf „2“ abgerundet. Siehe auch ceil().

Beispiel:

floor(last(/host/key))

log(value)

Der natürliche Logarithmus.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der natürliche Logarithmus des Werts „2“ gleich „0.69314718055994529“.

Beispiel:

log(last(/host/key))

log10(value)

Der dekadische Logarithmus.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der dekadische Logarithmus des Werts „5“ gleich „0.69897000433“.

Beispiel:

log10(last(/host/key))

max(<value1>,<value2>,...)

Der höchste Wert der referenzierten Datenpunkt-Werte.

Parameter:

• valueX - der von einer anderen Funktion zurückgegebene Wert, die mit der Datenpunkt-Historie arbeitet.

Beispiel:

max(avg(/host/key,1h),avg(/host2/key2,1h))

min(<value1>,<value2>,...)

Der niedrigste Wert der referenzierten Datenpunkt-Werte.

Parameter:

• valueX - der von einer anderen Funktion zurückgegebene Wert, die mit der Datenpunkt-Historie arbeitet.

Beispiel:

min(avg(/host/key,1h),avg(/host2/key2,1h))

mod(value,denominator)

Der Divisionsrest.

Parameter:

• value - der zu prüfende Wert;
• denominator - der Divisor.

Zum Beispiel ist der Divisionsrest eines Werts „5“ bei einem Divisor „2“ gleich „1“.

Beispiel:

mod(last(/host/key),2)

pi

Die Pi-Konstante (3.14159265358979).

Beispiel:

pi()

power(Wert, Potenzwert)

Die Potenz eines Werts.

Parameter:

• Wert – der zu prüfende Wert;
• Potenzwert – die zu verwendende n-te Potenz.

Zum Beispiel ergibt die 3. Potenz des Werts „2“ den Wert „8“.

Beispiel:

power(last(/host/key),3)

radians(value)

Konvertiert einen Wert von Grad in Bogenmaß.

Parameter:

• value - der zu prüfende Wert

Beispielsweise wird ein Wert '1' in Bogenmaß zu '0.0174532925' konvertiert.

Beispiel:

radians(last(/host/key))

rand

Gibt einen zufälligen Ganzzahlwert zurück. Eine pseudozufällig erzeugte Zahl, die die Zeit als Seed verwendet (ausreichend für mathematische Zwecke, aber nicht für Kryptografie).

Beispiel:

rand()

round(value,decimal places)

Rundet den Wert auf Dezimalstellen.

Parameter:

• value - der zu prüfende Wert;
• decimal places - gibt die Dezimalstellen für die Rundung an (0 ist ebenfalls möglich).

Beispielsweise wird ein Wert „2.5482“, auf 2 Dezimalstellen gerundet, zu „2.55“.

Beispiel:

round(last(/host/key),2)

signum(value)

Gibt '-1' zurück, wenn ein Wert negativ ist, '0', wenn ein Wert null ist, und '1', wenn ein Wert positiv ist.

Parameter:

• value - der zu prüfende Wert.

Beispiel:

signum(last(/host/key))

sin(value)

Der Sinus eines Werts, wobei der Wert ein in Radiant ausgedrückter Winkel ist.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Sinus des Werts „1“ gleich „0.8414709848“.

Beispiel:

sin(last(/host/key))

sinh(value)

Der hyperbolische Sinus eines Wertes.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der hyperbolische Sinus des Wertes „1“ gleich „1.17520119364“.

Beispiel:

sinh(last(/host/key))

sqrt(value)

Die Quadratwurzel eines Wertes.
Diese Funktion schlägt bei einem negativen Wert fehl.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist die Quadratwurzel des Wertes „3.5“ gleich „1.87082869339“.

Beispiel:

sqrt(last(/host/key))

sum(<value1>,<value2>,...)

Die Summe der referenzierten Datenpunkt-Werte.

Parameter:

• valueX – der von einer anderen Funktion zurückgegebene Wert, die mit der Datenpunkt-Historie arbeitet.

Beispiel:

sum(avg(/host/key,1h),avg(/host2/key2,1h))

tan(value)

Der Tangens eines Werts.

Parameter:

• value - der zu prüfende Wert

Zum Beispiel ist der Tangens des Werts „1“ gleich „1.55740772465“.

Beispiel:

tan(last(/host/key))

truncate(value,decimal places)

Den Wert auf Dezimalstellen kürzen.

Parameter:

• value - der zu prüfende Wert;
• decimal places - Dezimalstellen für das Kürzen angeben (0 ist ebenfalls möglich).

Zum Beispiel wird ein Wert '2.5482', der auf 2 Dezimalstellen gekürzt wird, zu '2.54'.

Beispiel:

truncate(last(/host/key),2)

Siehe alle unterstützten Funktionen.