6 Funzioni matematiche

Tutte le funzioni elencate qui sono supportate in:

• Espressioni dei trigger
• Item calcolati
• Macro di espressione

Le funzioni matematiche sono supportate con i tipi di valore float e integer, salvo diversa indicazione.

Le funzioni sono elencate senza informazioni aggiuntive. Fare clic sulla funzione per visualizzare tutti i dettagli.

Dettagli della funzione

Alcune note generali sui parametri della funzione:

• I parametri della funzione sono separati da una virgola
• Le espressioni sono accettate come parametri
• I parametri opzionali della funzione (o parti di parametro) sono indicati da < >

abs(value)

Il valore assoluto (a partire da 0) di un valore.

Parametro:

• value - il valore da controllare

Ad esempio, il valore assoluto di '3' o '-3' sarà '3'.

Esempio:

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

acos(value)

L'arcocoseno di un valore come angolo, espresso in radianti.

Parametro:

• value - il valore da controllare

Il valore deve essere compreso tra -1 e 1. Ad esempio, l'arcocoseno del valore '0.5' sarà '2.0943951'.

Esempio:

acos(last(/host/key))

asin(value)

L'arcoseno di un valore come angolo, espresso in radianti.

Parametro:

• value - il valore da controllare

Il valore deve essere compreso tra -1 e 1. Ad esempio, l'arcoseno del valore '0.5' sarà '-0.523598776'.

Esempio:

asin(last(/host/key))

atan(value)

L'arcotangente di un valore come angolo, espressa in radianti.

Parametro:

• value - il valore da verificare

Ad esempio, l'arcotangente del valore '1' sarà '0.785398163'.

Esempio:

atan(last(/host/key))

atan2(value,abscissa)

L'arcotangente delle coordinate dell'ordinata (value) e dell'ascissa specificata come angolo, espressa in radianti.

Parametri:

• value - il valore da controllare;
• abscissa - il valore dell'ascissa.

Ad esempio, l'arcotangente delle coordinate dell'ordinata e dell'ascissa di un valore '1' sarà '2.21429744'.

Esempio:

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

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

Il valore medio dei valori degli item referenziati.

Parametro:

• valueX - il valore restituito da un'altra funzione che lavora con la cronologia degli item.

Esempio:

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

cbrt(value)

La radice cubica di un valore.

Parametro:

• value - il valore da controllare

Ad esempio, la radice cubica di '64' sarà '4', quella di '63' sarà '3.97905721'.

Esempio:

cbrt(last(/host/key))

ceil(value)

Arrotonda il valore per eccesso all'intero maggiore o uguale più vicino.

Parametro:

• value - il valore da verificare

Ad esempio, '2.4' verrà arrotondato per eccesso a '3'. Vedi anche floor().

Esempio:

ceil(last(/host/key))

cos(value)

Il coseno di un valore, dove il valore è un angolo espresso in radianti.

Parametro:

• value - il valore da controllare

Per esempio, il coseno del valore '1' sarà '0.54030230586'.

Esempio:

cos(last(/host/key))

cosh(value)

Il coseno iperbolico di un valore. Restituisce il valore come numero reale, non in notazione scientifica.

Parametro:

• value - il valore da controllare

Ad esempio, il coseno iperbolico del valore '1' sarà '1.54308063482'.

Esempio:

cosh(last(/host/key))

cot(value)

La cotangente di un valore, dove il valore è un angolo espresso in radianti.

Parametro:

• value - il valore da controllare

Per esempio, la cotangente del valore '1' sarà '0.54030230586'.

Esempio:

cot(last(/host/key))

degrees(value)

Converte un valore da radianti a gradi.

Parametro:

• value - il valore da controllare

Ad esempio, un valore '1' convertito in gradi sarà '57.2957795'.

Esempio:

degrees(last(/host/key))

e

Il numero di Eulero (2.718281828459045).

Esempio:

e()

exp(value)

Il numero di Eulero elevato alla potenza di un valore.

Parametro:

• value - il valore da controllare

Per esempio, il numero di Eulero elevato alla potenza del valore '2' sarà '7.38905609893065'.

Esempio:

exp(last(/host/key))

expm1(value)

Il numero di Eulero elevato alla potenza di un valore meno 1.

Parametro:

• value - il valore da controllare

Ad esempio, il numero di Eulero elevato alla potenza del valore '2' meno 1 sarà '6.38905609893065'.

Esempio:

expm1(last(/host/key))

floor(value)

Arrotonda il valore per difetto all'intero più piccolo o uguale più vicino.

Parametro:

• value - il valore da controllare

Ad esempio, '2.6' verrà arrotondato per difetto a '2'. Vedi anche ceil().

Esempio:

floor(last(/host/key))

log(value)

Il logaritmo naturale.

Parametro:

• value - il valore da controllare

Ad esempio, il logaritmo naturale di un valore '2' sarà '0.69314718055994529'.

Esempio:

log(last(/host/key))

log10(value)

Il logaritmo decimale.

Parametro:

• value - il valore da controllare

Per esempio, il logaritmo decimale del valore '5' sarà '0.69897000433'.

Esempio:

log10(last(/host/key))

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

Il valore più alto tra i valori dell'item referenziato.

Parametro:

• valueX - il valore restituito da un'altra funzione che lavora con la cronologia dell'item.

Esempio:

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

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

Il valore più basso tra i valori degli item di riferimento.

Parametro:

• valueX - il valore restituito da un'altra funzione che lavora con la cronologia degli item.

Esempio:

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

mod(value,denominator)

Il resto della divisione.

Parametri:

• value - il valore da controllare;
• denominator - il denominatore della divisione.

Ad esempio, il resto della divisione del valore '5' con denominatore della divisione '2' sarà '1'.

Esempio:

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

pi

La costante Pi (3.14159265358979).

Esempio:

pi()

power(valore,valore della potenza)

La potenza di un valore.

Parametri:

• valore - il valore da controllare;
• valore della potenza - la potenza N-esima da utilizzare.

Ad esempio, la terza potenza di un valore '2' sarà '8'.

Esempio:

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

radians(value)

Converte un valore da gradi a radianti.

Parametro:

• value - il valore da controllare

Ad esempio, un valore '1' convertito in radianti sarà '0.0174532925'.

Esempio:

radians(last(/host/key))

rand

Restituisce un valore intero casuale. Un numero pseudo-casuale generato usando il tempo come seed (sufficiente per scopi matematici, ma non per la crittografia).

Esempio:

rand()

round(valore, posizioni decimali)

Arrotonda il valore al numero di posizioni decimali specificato.

Parametri:

• valore - il valore da controllare;
• posizioni decimali - specifica il numero di posizioni decimali per l'arrotondamento (è possibile anche 0).

Ad esempio, un valore '2.5482' arrotondato a 2 posizioni decimali diventerà '2.55'.

Esempio:

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

signum(value)

Restituisce '-1' se un valore è negativo, '0' se un valore è zero, '1' se un valore è positivo.

Parametro:

• value - il valore da controllare.

Esempio:

signum(last(/host/key))

sin(value)

Il seno di un valore, dove il valore è un angolo espresso in radianti.

Parametro:

• value - il valore da controllare

Ad esempio, il seno del valore '1' sarà '0.8414709848'.

Esempio:

sin(last(/host/key))

sinh(value)

Il seno iperbolico di un valore.

Parametro:

• value - il valore da controllare

Ad esempio, il seno iperbolico del valore '1' sarà '1.17520119364'.

Esempio:

sinh(last(/host/key))

sqrt(value)

La radice quadrata di un valore.
Questa funzione non riuscirà con un valore negativo.

Parametro:

• value - il valore da controllare

Ad esempio, la radice quadrata di un valore '3.5' sarà '1.87082869339'.

Esempio:

sqrt(last(/host/key))

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

La somma dei valori degli item referenziati.

Parametro:

• valueX - il valore restituito da un'altra funzione che lavora con la cronologia degli item.

Esempio:

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

tan(value)

La tangente di un valore.

Parametro:

• value - il valore da controllare

Ad esempio, la tangente del valore '1' sarà '1.55740772465'.

Esempio:

tan(last(/host/key))

truncate(valore, posizioni decimali)

Tronca il valore al numero di posizioni decimali specificato.

Parametri:

• valore - il valore da controllare;
• posizioni decimali - specifica il numero di posizioni decimali per il troncamento (è possibile anche 0).

Ad esempio, un valore '2.5482' troncato a 2 posizioni decimali diventerà '2.54'.

Esempio:

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

Vedere tutte le funzioni supportate.