Utilizzare espressioni Arcade con Rileva Eventi

Nella casella degli strumenti di GeoAnalytics Tools sono disponibili vari strumenti che consentono di applicare un'espressione.

• Espressioni buffer in Crea Buffer

  Ulteriori informazioni sulle espressioni buffer

• Espressioni buffer in Ricostruisci tracce

  Ulteriori informazioni sulle espressioni buffer

• Condizioni di join in Join delle feature

  Ulteriori informazioni sulle espressioni in Join delle feature

• Condizioni di evento in Rileva eventi

  Ulteriori informazioni sulle espressioni in Rileva Eventi

• Calcolo dei valori di campo in Calcola Campo

  Ulteriori informazioni sulle espressioni in Calcola Campo

I GeoAnalytics Toolsche utilizzano espressioni hanno scopi diversi, nonché limitazioni su quali espressioni possono essere applicate Nella versione 11.0, tutte le espressioni utilizzate inArcGIS GeoAnalytics Server supportanoArcade.

Ulteriori informazioni sulle funzioni Arcade

Espressioni in Rileva Eventi

Le espressioni vengono utilizzate nello strumento Rileva eventi per specificare le condizioni iniziali e finali per eventi. Una condizione Rileva eventi deve restituire sempretrue o false. Utilizzare una condizione per verificare se una feature deve essere inclusa in un evento. Le condizioni vengono testate rispetto a ogni feature per determinare le feature che sono eventi. I calcoli sono eseguiti quando l'analisi viene eseguita su ArcGIS GeoAnalytics Server. Nelle sezioni riportate di seguito sono inclusi esempi di espressioni utilizzabili.

Esempi di operatori matematici e funzioni

Le espressioni possono processare matematicamente i numeri. La seguente tabella mostra un esempio delle operazioni disponibili.

Ulteriori informazioni sulle operazioni matematiche e le funzioni disponibili in Arcade

Operatore	Spiegazione	Esempio	Risultato
a + b	a più b.	fieldname contiene un valore di 1.5. $feature["fieldname"] + 2.5	4.0
a - b	a meno b.	fieldname contiene un valore di 3.3. $feature["fieldname"]- 2.2	1,1
a * b	a per b.	fieldname contiene un valore di 2.0. $feature["fieldname"] * 2.2	4,4
a / b	a diviso b.	fieldname contiene un valore di 4.0. $feature["fieldname"] / 1.25	3,2
abs( a )	Restituisce il valore assoluto (positivo) di a.	fieldname contiene un valore di -1.5. abs($feature["fieldname"])	1,5
log( a )	Restituisce il logaritmo naturale (base E) di a.	fieldname contiene un valore di 1. log($feature["fieldname"])	0
sin( a )	Restituisce il seno trigonometrico di a. Si presuppone che l'input sia un angolo espresso in radianti.	fieldname contiene un valore di 1.5707. sin($feature["fieldname"])	1
cos( a )	Restituisce il coseno trigonometrico di a. Si presuppone che l'input sia un angolo espresso in radianti.	fieldname contiene un valore di 0. cos($feature["fieldname"])	1
tan( a )	Restituisce la tangente di a. Si presuppone che l'input sia un angolo espresso in radianti.	fieldname contiene un valore di 0. tan($feature["fieldname"])	0
rq( a )	Restituisce la radice quadrata di a.	fieldname contiene un valore di 9. rq($feature["fieldname"])	3
min( a, b )	Restituisce il valore più basso compreso tra a e b.	fieldname contiene un valore di 1.5 e un valore di -3. min($feature["fieldname"], -3)	-3
max( a, b )	Restituisce il valore più alto tra a e b.	fieldname1 contiene un valore di 1.5 e fieldname2 contiene un valore di -3. max($feature["fieldname1"], $feature["fieldname2"])	1,5
constrain(<value>,<low>,<high>)	Restituisce il valore di input se rientra nei limiti vincolanti. Se il valore di input è inferiore al valore basso, restituisce il valore basso. Se il valore di input è superiore al valore alto, restituisce il valore alto.	limite($feature["distanza"], 0, 10) limite($feature['Store dist'], 6, distanza)	Restituisce 0 se distance è minore di 0, 10 se distance è maggiore di 10, altrimenti distance. Restituisce 6 se Store dist è minore di 6, distance se Store dist è maggiore di distance, altrimenti Store dist.

Esempio di moltiplicazione per una condizione che rileva un evento.

$feature["Distance"] * 2 > 50

Esempi della funzione di testo

Le espressioni Rileva eventi possono processare testo. La seguente tabella mostra un esempio delle operazioni disponibili.

Ulteriori informazioni sulle funzioni di testo disponibili in Arcade

Operatore	Spiegazione	Esempio	Risultato
concatenare( <valori>, <separatore>)	Concatena i valori e restituisce una stringa. values: un array di valori stringa da concatenare. separator (opzionale): un separatore da utilizzare per la concatenazione se il parametro values è un array, oppure una stringa da concatenare se viene specificato un valore singolo per il primo parametro. Se non specificato, sarà vuoto.	fieldname contiene un valore di GeoAnalytics. Concatenare ([$features["fieldname"], "is", "great!"], ' ')	GeoAnalytics è fantastico!
cercare(<searchText>, <text>, <startPos>)	Cerca una stringa in una stringa. I caratteri jolly non sono supportati. searchText: la sottostringa da cercare. text: il testo da cercare. startPos (opzionale): l'indice basato su zero della posizione nella stringa da cui cercare.	fieldname1 contiene un valore di 14NorthStreet e fieldname2 contiene un valore di North. find($feature["fieldname2"], $feature["fieldname1"])	2
inferiore(<valore>)	Compilare una stringa in minuscolo. value: la stringa da trasformare in caratteri minuscoli.	fieldname contiene un valore di GEOANALYTICS. inferiore($feature["fieldname"])	geoanalytics

Esempio di testo usando find e lower.

find(("north"), lower("146NorthStreet")) == 2

Esempi della funzione di dati

È possibile utilizzare Rileva Eventi da espressioni che usano date. La seguente tabella mostra un esempio delle operazioni disponibili.

Ulteriori informazioni sulle funzioni di dati disponibili in Arcade

In Arcade, i valori del mese variano dallo 0 (gennaio) all'11 (dicembre), i giorni dall'1 al 31, le ore dallo 0 (12:00 am) al 23 (11:00 pm), i minuti ed i secondi dallo 0 al 59, ed i millisecondi dallo 0 al 999. Le date Arcade restituiscono i valori temporali nella posizione del proprio GeoAnalytics Server.

Operatore	Spiegazione	Esempio	Risultato
data( <valore>, <mese>, <giorno>, <ora>, <minuto>)	Analizza il valore o un insieme di valori in una stringa di data. value (opzionale): o il numero di millisecondi a partire dell'1 gennaio, 1970 UTC o il numero che rappresenta l'anno. Se viene specificato l'anno, è necessario specificare anche il giorno e il mese nei parametri successivi. Questo valore potrebbe anche essere una stringa di data o una stringa ISO 8601 da convertire in una data. month (opzionale): il mese (0-11), in cui lo 0 rappresenta gennaio e l'11 rappresenta dicembre. day (opzionale): il giorno del mese (1-31). hour (opzionale): l'ora del giorno (0-23). minute (opzionale): il minuto dell'ora (0-59). second (opzionale): il secondo del minuto (0-59). millisecond (opzionale): il millisecondo del secondo (0-999).	fieldname contiene un valore di 1476987783555. Esempio 1: Data($features["fieldname"]) Esempio 2: Data(2017,0,14,0) Esempio 3: Data()	Esempio 1: 20 Ott 2016 11:23:03 am Esempio 2: 14 Gen 2017 12:00:00 am Esempio 3: Restituisce il periodo temporale attuale
DiffData(<data1>, <data2>, <unità>)	Sottrae due date e restituisce la differenza nelle unità specificate. date1: il valore data da cui sottrarre una seconda data. date2: il valore data da sottrarre dalla prima data specificata. startpos (opzionale): le unità nelle quali restituire la differenza di due date specifiche. I tipi di unità supportate includono milliseconds, seconds, minutes, hours, days, months e years. Il valore predefinito è millisecondi.	Esempio 1: DiffData(Data(2017,1,14,0), Data()) Esempio 2: DiffData(Data(2017,1,14,0), Data(), "Anni")	Il risultato cambierà a seconda del momento di avvio di questo comando. Esempio 1: -20532129137 Esempio 2: -0.6546783768647119
Anno(<Valoredata>)	Restituisce l'anno della data specificata. value: un valore data da cui ottenere l'anno.	Esempio 1: fieldname è un campo di un tipo Date con un valore di valore di 09 Oct 2017 04:30:43 pm. Anno($feature["fieldname"]) Esempio 2: fieldname è un campo stringa con il formato di una stringa ISO 8601 con un valore di 2012-09-27.	Esempio 1: 2017 Esempio 2: 2012

Operatori condizionali

Le istruzioni condizionali possono utilizzare i seguenti operatori:

Operatore	Spiegazione	Esempio	Risultati
a > b a < b	a è maggiore di b a è minore di b	10 > 2	False
a >= b a <= b	a è maggiore o uguale a b a è minore o uguale a b	abs(-10) >= 10	True
a != b	a non è uguale a b	abs(-3) != -3	True
a == b	a è uguale a b	abs(-5) == 5	True
<condition1> || <condition2>	Condition 1 o condition 2 viene soddisfatta.	(abs(-5) == 5) || (10 < 2)	True
<condition1> && <condition2>	Condition 1 e condition 2 vengono soddisfatte.	(abs(-5) == 5) && (10 < 2)	False

Esempi di operatore logico

Oltre ad operatori condizionali, è possibile utilizzare operatori logici più avanzati con Rileva eventi.

Ulteriori informazioni sulle funzioni logiche disponibili in Arcade

Funzione	Spiegazione	Esempio	Risultato
iif(<condition>,<true value>,<false value>)	Restituisce un valore se una condizione è true e un altro valore se tale condizione è false. <true value> e <false value> possono essere i seguenti: Un campo numerico. Utilizzare le parentesi quadre se c'è uno spazio nel nome del campo. Un numero. Una funzione.	iif($feature["field1"] > $feature["field2"], $feature["field1"], 0) iif($feature["field1"] > $feature["field2"], iif($feature["field2"] = 0, $feature["field3"], $feature["field4"]), 0)	Restituisce field1 se field1 è maggiore di field2, altrimenti 0. Restituisce il risultato della seconda funzione iif se field1 è maggiore di field2, altrimenti 0.
when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>)	Valuta una serie di espressioni, una alla volta, fino a quando una non risulta essere true. expression: un'espressione. result: può essere un numero o un campo. default: un valore facoltativo se nessuna delle espressioni corrisponde.	quando($feature["field1"] + 10) > 1, 1,($feature["field2"] + 10) > 2 , 2, $feature["field3"])	Se field1 + 10 è maggiore di 1, restituisce 1. In caso contrario, verifica se field2 + 10 è maggiore di 2. Se lo è, restituisce 2. In caso contrario, restituisce field3.
decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> )	La funzione decode valuta un'espressione e ne confronta il valore con i parametri successivi. Se l'espressione corrisponde, restituisce il successivo valore di parametro. In assenza di corrispondenze, è disponibile l'opzione per cui l'ultimo parametro è un valore restituito predefinito. :conditional val può essere un campo o un'espressione. case: un valore da confrontare con conditional val. result: il risultato se il caso corrispondente corrisponde a conditional val. defaultValue: un valore facoltativo se nessun altro valore è true.	decodifica($feature["field1"] + 3 , $feature["field1"], 1, $feature["field2"], 2, 0)	Confronta l'uguaglianza tra il conditional val field1 + 3 e il caso 1 field1. Se true, restituisce 1. Se false, confronta l'uguaglianza tra field1 + 3 e field2. Se true, restituisce 2; altrimenti, restituisce 0.

Esempi di considerazione tracce

Inoltre, alcuni GeoAnalytics Tools, come Rileva eventi e Calcola Campo, possono utilizzare equazioni che prendono in considerazione le tracce in Arcade.

Funzione	Spiegazione	Esempio	Risultato
TrackStartTime()	Calcola il periodo temporale di inizio di un rilevamento in millisecondi da epoca.	Se si usa un rilevamento che inizia il 2 gennaio 2017. TrackStartTime()	1483315200000
TrackDuration()	Calcola la durata di una traccia in millisecondi dall’inizio fino al passaggio temporale attuale.	Se si usa un rilevamento che inizia il 2 gennaio 2017 e il periodo temporale corrente è il 4 gennaio 2017. TrackDuration()	172800000
TrackCurrentTime()	Calcola l’ora attuale in una traccia.	Se si usa una feature del 3 gennaio 2017 alle 9:00 TrackCurrentTime()	1483434000000
TrackIndex	Restituisce l’indice temporale della feature calcolata.	Calcolo di questo valore sulla prima feature di una traccia. TrackIndex	0
TrackFieldWindow(<fieldName>, <startIndex>, <endIndex>)	Restituisce un array di valori nel campo specificato per l’indice temporale specificato. La funzione finestra consente di andare avanti e indietro nel tempo. L'espressione viene valutata su ciascuna feature nella traccia. La feature attuale è sull'indice 0. I valori positivi rappresentano feature che si verificano in futuro, dopo il valore corrente. Ad esempio, la posizione 1 è il valore successivo nell'array. I numeri negativi rappresentano feature accadute nel passato, prima della feature precedente. Ad esempio, -1 è il valore precedente nell'array.	MyField ha ordinato i valori di [10, 20, 30, 40, 50] in maniera sequenziale. L'espressione viene valutata su ciascuna feature nella traccia. I risultati restituiti includono la feature iniziale ma non la feature finale. Esempio 1:TrackFieldWindow("MyField,-1,2) Esempio 2: TrackFieldWindow("MyField,-2,0)[0] Esempio 3: TrackFieldWindow("MyField,0,3)[2]	Esempio 1: se si esegue la valutazione su ciascuna feature, la tabella mostra i risultati seguenti. Feature valutata Risultato 10 [10, 20] 20 [10, 20, 30] 30 [20,30,40] 40 [30, 40, 50] 50 [40, 50] Esempio 2: se si esegue la valutazione sull'indice 2 (il valore è 30), restituisce: 10. Esempio 3: se si esegue la valutazione sull'indice 2 (il valore è 30), restituisce: 50.
TrackGeometryWindow(<startIndex>, <endIndex>)	Restituisce un array di valori rappresentante la geometria per l'indice temporale specificato. La funzione finestra consente di andare avanti e indietro nel tempo. L'espressione viene valutata su ciascuna feature nella traccia. La feature attuale è sull'indice 0. I valori positivi rappresentano feature che si verificano in futuro, dopo il valore corrente. Ad esempio, la posizione 1 è il valore successivo nell'array. I numeri negativi rappresentano feature accadute nel passato, prima della feature precedente. Ad esempio, -1 è il valore precedente nell'array.	MyField ha ordinato i valori di [10, 20, 30, 40, 50] in maniera sequenziale. La geometria delle feature [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]. L'espressione viene valutata su ciascuna feature nella traccia. I risultati restituiti includono la feature iniziale ma non la feature finale. Esempio 1: TrackGeometryWindow(-1,2) Esempio 2: TrackGeometryWindow(0,1)[0] su un dataset polilinea Esempio 3: TrackGeometryWindow(0,1)[0] su un dataset polilinea Esempio 4: trova il valore X del punto precedente TrackGeometryWindow(-1,0)[0]["x"]	Esempio 1: se si esegue la valutazione su ciascuna feature, la tabella mostra i risultati seguenti. Feature valutata Risultato 10 [{x: 1, y: 1},{x: 2, y: 2}] 20 [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null}] 30 [{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}] 40 [{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}] 50 [{x: 4, y: 4}, {x: 5, y: 5}] Esempio 2: le polilinee vengono restituite nel seguente formato: [{"paths":[[[-180,-22.88],[-177.6,-23.6]],[[180,-18.099999999999994],[179.7,-18.4],[179.4,-18.7],[178.9,-18.9],[178.5,-19.3],[178.2,-19.7],[178.4,-20],[178.8,-20.2],[178.9,-21.8],[179,-22.2],[179.4,-22.7],[180,-22.88]],[[-178,-17],[-178.8,-17.3],[-179.2,-17.5],[-179.6,-17.8],[-179.9,-18],[-180,-18.099999999999994]]]}] Esempio 3: i poligoni vengono restituiti nel seguente formato: [{"rings":[[[-7882559.1197999995,6376090.883500002],[-7893142.474300001,6042715.216800004],[-8544018.775999999,6045361.0554000065],[-8544018.775999999,6376090.883500002],[-7882559.1197999995,6376090.883500002]]]}] Esempio 4: valutato sull'indice 2 (il valore è 30): 2.
TrackWindow(<value1>, <value2>)	Restituisce un array di valori rappresentante la geometria e tutti gli attributi per l'indice temporale specificato. La funzione finestra consente di andare avanti e indietro nel tempo. La feature attuale è sull'indice 0. I valori positivi rappresentano feature che si verificano in futuro, dopo il valore corrente. Ad esempio, la posizione 1 è il valore successivo nell'array. I numeri negativi rappresentano feature accadute nel passato, prima della feature precedente. Ad esempio, -1 è il valore precedente nell'array.	MyField ha ordinato in maniera sequenziale i valori di [10, 20, 30, 40, 50], oltre ai campi objectID, globalID e instant_datetime. La geometria delle feature [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]. L'espressione viene valutata su ciascuna feature nella traccia. I risultati restituiti includono la feature iniziale ma non la feature finale. Esempio 1: TrackWindow(-1,0)[0] Esempio 2: geometry(TrackWindow(-1,0)[0]["x"]	Esempio 1: se si esegue la valutazione su ciascuna feature, la tabella mostra i risultati seguenti. Feature valutata Risultato 10 20 [{"geometry": {x: 1, y: 1}},{"attributes": {"MyField" : 10, "trackName":"ExampleTrack1"}}] 30 [{"geometry": {x: 2, y: 2}},{"attributes": {"MyField" : 20, "trackName":"ExampleTrack1"}}] 40 [{"geometry": {x: null, y: null}},{"attributes": {"MyField" : 30, "trackName":"ExampleTrack1"}}] 50 [{"geometry": {x: 4, y: 4}},{"attributes": {"MyField" : 40, "trackName":"ExampleTrack1"}}] Esempio 2: valutato sull'indice 2 (il valore è 30): 2.

Utilizzare le seguenti espressioni di tracce per calcolare la distanza, la velocità e l'accelerazione sulle tracce.

Tutte le distanze vengono calcolate in metri, la velocità in metri al secondo e l'accelerazione in metri al secondo quadrato. Le distanze vengono calcolate con distanze geodetiche.

Funzione	Spiegazione
TracciamentoDistanzaCorrente()	La somma delle distanze percorse tra le osservazioni dalla prima all'attuale osservazione.
TracciamentoDistanzaCorrente(valore)	La somma delle distanze percorse tra le osservazioni dalla prima all'osservazione attuale più il valore specificato.
TracciaFinestraDistanza(valore1, valore2)	Le distanze tra il primo (incluso) e l'ultimo valore (esclusivo) in una finestra sull'osservazione corrente (0).
TracciamentoVelocitàCorrente()	La velocità tra l'osservazione precedente e quella attuale.
TracciamentoVelocitàA(valore1)	La velocità all'osservazione rispetto all'osservazione corrente. Per esempio, al valore2, è la velocità dell'osservazione due osservazioni dopo l'osservazione attuale.
TracciamentoFinestraVelocità(valore1, valore2)	I valori di velocità tra il primo (incluso) e l'ultimo valore (esclusivo) in una finestra intorno all'osservazione corrente (0).
TracciamentoAccelerazioneCorrente()	L'accelerazione tra l'osservazione precedente e quella attuale.
TracciamentoAccelerazioneCorrente(valore1)	L'accelerazione all'osservazione rispetto all'osservazione corrente.
TracciamentoFinestraAccelerazione(valore1, valore2)	I valori di accelerazione tra il primo (incluso) e l'ultimo valore (esclusivo) in una finestra intorno all'osservazione corrente (0).

I calcoli di esempio per la distanza, la velocità e l'accelerazione useranno gli esempi della seguente immagine:

Funzione	Risultato esempio
TracciamentoDistanzaCorrente()	ID punto Risultato (metri) P1 0 P2 60 P3 80 + 60 = 140 P4 30 + 80 + 60 = 170 P5 35 + 30 + 80 + 60 = 205 P6 25 + 35 + 30 + 80 + 60 = 230
TracciamentoDistanzaA(2)	ID punto Risultato (metri) P1 0 + 80 + 60 = 140 P2 30 + 80 + 60 = 170 P3 35 + 30 + 80 + 60 = 205 P4 25 + 35 + 30 + 80 + 60 = 230 P5 null P6 null
TracciamentoFinestraDistanza(-1, 2)	ID punto Risultato (metri) P1 [0, 60] P2 [0, 60, 140] P3 [60, 140, 170] P4 [140, 170, 205] P5 [170, 205, 230] P6 [205, 230]
TracciamentoVelocitàCorrente()	ID punto Risultato (metri/secondo) P1 0 P2 60/60 1 P3 80/60 1,33 P4 30/60 ,5 P5 35/60 0,5833 P6 25/60 0,4167
TracciamentoVelocitàA(2)	ID punto Risultato (metri/secondo) P1 80/60 1,33 P2 30/60 ,5 P3 35/60 0,5833 P4 25/60 0,4167 P5 null P6 null
TracciamentoFinestraVelocità(-1, 2)	ID punto Risultato (metri/secondo) P1 [0, 1] P2 [0, 1, 1,3] P3 [1, 1,3, 0,5] P4 [1,3, 0,5, 0,583] P5 [0,5, 0,583, -0,4167] P6 [0,583, -0,4167]
TracciamentoAccelerazioneCorrente()	ID punto Risultato (metri/secondo²) P1 0 P2 0,0167 P3 0,0056 P4 -0,0014 P5 0,0014 P6 -0,0028
TracciamentoAccelerazioneA(2)	ID punto Risultato (metri/secondo²) P1 0,0056 P2 -0,0014 P3 0,0014 P4 -0,0028 P5 null P6 null
TracciamentoFinestraAccelerazione(-1, 2)	ID punto Risultato (metri/secondo²) P1 [0, 0,0167] P2 [0, 0.0167, 0.0056 ] P3 [0.0167, 0.0056 , -0.0014] P4 [ 0.0056 , -0.0014, 0.0014] P5 [-0,0014, 0,0014, -0,0028] P6 [0,0014, -0,0028]