Skip to main content

Funzioni matematiche

Una funzione matematica esegue calcoli matematici. Utilizza le funzioni matematiche solo con tipi di dati numerici.

ABS

ABS(x): restituisce il valore assoluto di un numero (x). Si tratta della distanza tra 0 e un numero. Il valore è sempre positivo.

Esempio

  • ABS(32) restituisce 32.

  • ABS(–32) restituisce 32.

ACOS

ACOS(x): restituisce l'arcocoseno o il coseno inverso di un numero (x). L'arcocoseno è l'angolo il cui coseno è (x).

  • L'angolo viene restituito in radianti con un valore compreso nell'intervallo da 0 (zero) a pi.

  • Il numero (x) deve essere compreso tra -1 e 1.

Esempio

ACOS(0.5) restituisce 1.047198.

ASIN

ASIN(x): restituisce l'arcoseno o il seno inverso di un numeror (x). L'arcoseno è l'angolo il cui seno è (x).

  • L'angolo viene restituito in radianti con un valore compreso nell'intervallo da -pi/2 a pi/2.

  • Il numero (x) deve essere compreso tra -1 e 1.

Esempio

ASIN(0.5) restituisce 0.523599.

ATAN

ATAN(x): restituisce l'arcotangente o la tangente inversa di un numero (x). L'arcotangente è l'angolo la cui tangente è (x). L'angolo viene restituito in radianti con un valore compreso nell'intervallo da -pi/2 a pi/2.

Esempio

ATAN(0.8) restituisce 0.674741.

ATAN2

ATAN2(y, x): restituisce l'arcotangente o la tangente inversa di y e x (Arco - tangente di (y/x)).

Esempio

ATAN2(4, –3) restituisce 2,2143.

Average

Average(n1, ...): restituisce la media di un elenco di numeri. I valori NULL sono trattati come 0 e presi in considerazione nel calcolo del valore medio.

Esempio

Average(20,30,55) restituisce 35 poiché [(20+30+55)/3]= 35.

AverageNonNull

AverageNonNull(n1, ...): restituisce la media di un elenco di numeri. I valori null sono esclusi dal calcolo. Il calcolo funziona solo con i tipi di dati numerici.

Nota

La funzione AverageNonNull funziona in modo diverso rispetto alla funzione Average(n1, …) precedente.

  • AverageNonNull esclude i valori null dal calcolo della media. Il comportamento è lo stesso dell'azione Media disponibile tramite lo strumento Riepiloga.

  • Media considera i valori null come 0.

Per questo motivo, le 2 funzioni possono restituire risultati diversi a seconda dell'input.

Esempio

  • AVERAGENONNULL(Null, 1, 1) restituisce 1 (vs 0.666666666666667 della funzione Media, che include null come 0).

  • AVERAGENONNULL(Null, 1, 2, 3) restituisce 2 (vs 1.5 della funzione Media).

  • AVERAGENONNULL(Null, 1, 2, 2) restituisce 1.666666666666667 (vs 1.25 della funzione Media).

  • AVERAGENONNULL(Null, 1.2, 2.345, 3.456789) restituisce 2.33392966666667 (vs 1.75044725 della funzione Media).

  • AVERAGENONNULL(Null, 1.2, 2.345, 3.456789, Null) restituisce 2.33392966666667 (vs 1.4003578 della funzione Media).

  • AVERAGENONNULL(Null, Null, Null) Restituisce null. Quando tutti i valori sono null, i risultati sono null.

CEIL

CEIL(x, [mult]): restituisce un valore numerico (x) elevato al multiplo più piccolo di (mult), maggiore o uguale a x. Il parametro (mult) deve essere un numero maggiore di 0. Se il parametro (mult) non è specificato, la funzione restituisce il numero intero più piccolo maggiore o uguale a (x).

Nota

CEIL(x) cambia il valore Double in Int64 se il valore rientra nell'intervallo INT64, altrimenti restituisce Double.

Esempio

  • CEIL(9.567) restituisce 10 (se non viene fornito un parametro, la funzione restituisce per impostazione predefinita il numero intero più piccolo maggiore o uguale a x).

  • CEIL(123.456, 10) restituisce 130 (arrotonda al multiplo più vicino di 10).

  • CEIL(–110, 100) restituisce -100 (arrotonda al multiplo più vicino di 100).

  • CEIL(123, Null) restituisce null (se è presente un valore null in qualsiasi parametro, il risultato è null).

  • CEIL(9.123, 0.01) restituisce 9.13 (arrotonda al multiplo più vicino di .01).

  • CEIL(7, 5) restituisce 10 (arrotonda al multiplo più vicino di 5).

COS

COS(x): restituisce il coseno di un angolo (x). x deve essere in radianti.

Esempio

COS(1) restituisce 0.54030230586814.

COSH

COSH(x): restituisce il coseno iperbolico di un numero (x).

Esempio

COSH(1) restituisce 1,54308063481524.

DISTANCE

DISTANCE(from_Lat,from_Lon, to_Lat, to_Lon): restituisce la distanza da (lat1,lon1) a (lat2,lon2).

Esempio

DISTANCE(42, –90, 43, –80) restituisce un valore di 513.473706 miglia.

EXP

EXP(x): restituisce la costante e elevata alla potenza di un esponente (x) (e^x).

FACTORIAL

FACTORIAL(x): restituisce il fattoriale di un valore numerico (x) tramite il calcolo (n! = n x (n-1) x … x 1). Ad esempio, il fattoriale di 4 viene calcolato come: 4! = 4 x 3 x 2 x 1 = 24.

  • Questa funzione accetta solo numeri interi positivi.

  • Questa funzione non supporta i numeri decimali.

  • A causa delle limitazioni delle dimensioni dei tipi di dati numerici, il valore massimo consentito per (x) nella funzione fattoriale è 170.

Nota

Mentre la rappresentazione matematica del fattoriale è comunemente indicata come x!, la funzione Alteryx riconosce il fattoriale solo tramite Fattoriale(x).

Esempio

  • FACTORIAL(0) restituisce 1.

  • FACTORIAL(1) restituisce 1.

  • FACTORIAL(Null) restituisce null.

  • FACTORIAL(5) restituisce 120 (5 * 4 * 3 * 2 * 1).

  • FACTORIAL(8) restituisce 40320 (8 * 7 * 6 * 5 * 4 * 3 * 2 * 1).

FLOOR

FLOOR(x, [mult]): restituisce un valore numerico (x) ridotto al multiplo più grande di (mult), minore o uguale a x. Il parametro (mult) deve essere un numero maggiore di 0. Se il parametro (mult) non è specificato, la funzione restituisce il numero intero più grande minore o uguale a (x), come mostrato nel primo esempio di seguito.

Nota

FLOOR(x) cambia il valore Double in Int64 se il valore rientra nell'intervallo INT64, altrimenti restituisce Double.

Esempio

  • FLOOR(4.567) restituisce 4 (se non fornisci un parametro, la funzione restituisce per impostazione predefinita il numero intero più grande, minore o uguale a x).

  • FLOOR(4.567, 0.01) restituisce 4.56 (arrotonda al centesimo più vicino).

  • FLOOR(–15.75, 0.1) restituisce -15,8 (arrotonda al decimo più vicino).

  • FLOOR(Null, 10) restituisce null (se è presente un valore null in qualsiasi parametro, il risultato è null).

  • FLOOR(13, 5) restituisce 10 (arrotondamento per difetto a 10, ossia il multiplo più vicino di 5, minore o uguale a 13).

LOG

LOG(x): restituisce il logaritmo naturale di un numero (x). x deve essere un numero positivo.

Esempio

  • LOG(1) restituisce 0.

  • LOG(14) restituisce 2.639057.

LOG10

LOG10(x): restituisce il logaritmo in base 10 di un numero (x). x deve essere un numero positivo.

Esempio

  • LOG10(1) restituisce 0.

  • LOG10(14) restituisce 1.146128.

Median

Median(...): calcola il valore mediano di uno o più valori (verosimilmente non ordinati).

Esempio

Median (5, 4, 3, 7, 6) restituisce 5.

Mod

Mod(n,d): modulo di un numero (n) diviso per un numero (d) (operazione con numeri interi).

L'operazione Modulo trova il residuo di un numero intero (n) diviso per un divisore intero (d).

  • Se (n) è positivo, il risultato è positivo.

  • Se (n) è negativo, il risultato è negativo.

Se si utilizzano valori decimali, il decimale viene troncato. Questo può causare un errore "diviso per 0" se il divisore è un decimale inferiore a 1.

Esempio

  • MOD(6,4) restituisce 2.

  • MOD(6,–4) restituisce 2.

  • MOD(–6,4) restituisce 2.

  • MOD(–6,–4) restituisce 2.

  • MOD(6,.4) Restituisce [Null].

PI

PI(): restituisce il valore della costante PI in 15 cifre di precisione.

Esempio

PI() restituisce 3.141593.

POW

POW(x, e): restituisce (x) elevato alla potenza di (e).

Esempio

POW(2, 3) equivale a 23 e restituisce 8.

RAND

RAND(): restituisce un numero casuale maggiore o uguale a 0 e minore di 1.

Esempio

RAND() restituisce un numero casuale come 0.256.

RandInt

RandInt(n): restituisce un numero intero casuale compreso tra 0 e il parametro specificato (n).

Esempio

  • RandInt(10) restituisce 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 o 10.

  • RandInt(5000) restituisce un numero intero casuale compreso tra 0 e 5000, come 741.

Round

Round(x, mult): restituisce un numero (x) arrotondato al multiplo più vicino di (mult).

Nota

L'arrotondamento viene eseguito dopo aver diviso il numero (x) per un valore mult. Se il risultato è negativo (e corrisponde esattamente a un numero intero più metà), la funzione esegue l'arrotondamento verso l'alto anziché lontano dallo zero. Dopo l'arrotondamento a un numero intero, il risultato viene moltiplicato di nuovo per il valore mult.

Esempio

  • Round(55.34, 2) restituisce un valore di 56.

  • Round(39.88, 10) restituisce un valore di 40.

  • Round(41.1, 10) restituisce un valore di 40.

  • Round(1.25, 0,1) restituisce un valore di 1.3.

  • Round(1.227, 0,01) restituisce un valore di 1.23.

  • Round(-25, -10) restituisce -30.

  • Round(-25, 10) restituisce -20.

  • Round(-1,5, 1) restituisce -1.

  • Round(15, 10) restituisce 20.

  • Round(-15, 10) restituisce -10.

  • Round(15, -10) restituisce 10.

  • Round(-15, -10) restituisce -20.

SIN

SIN(x): restituisce il seno di un angolo (x). x deve essere in radianti.

Esempio

SIN(90) restituisce 0.893996663600558.

SINH

SINH(x): restituisce il seno iperbolico di un numero (x).

SmartRound

SmartRound(x): restituisce un numero (x) arrotondato al multiplo più vicino di un valore determinato dinamicamente in base alla dimensione di (x).

SQRT

SQRT(x): restituisce la radice quadrata di un numero (x).

Esempio

SQRT(100) restituisce il valore 10.

TAN

TAN(x): restituisce la tangente di un angolo (x). x deve essere in radianti.

Esempio

TAN(1) restituisce 1.5574077246549.

TANH

TANH(x): restituisce la tangente iperbolica di un numero (x).

Esempio

TANH(90) restituisce 1.