Expressions Arcade dans la boîte d’outils GeoAnalytics Desktop

Certains outils GeoAnalytics Desktop utilisent des expressions Arcade pour les analyses. Les outils et la fonction des expressions sont présentés ci-après.

Avec Arcade, les noms de champ sont présentés sous la forme $feature["field name"] ou $feature.fieldname. La première option, $feature["field name"], est requise lorsqu’un nom de champ contient un espace. Tous les exemples proposés ci-après utilisent cette option. Tous les outils utilisent le format $feature["field name"], à l’exception de l’outil Entités jointes. Avec l’outil Entités jointes, vous devez utiliser $target["field name"] et $join["field name"] pour définir le jeu de données à utiliser.

Pour en savoir plus sur les expressions Arcade

Des expressions Arcade sont utilisées par les outils suivants de la boîte d’outils GeoAnalytics Desktop :

  • Expressions de zone tampon dans Reconstruire les pistes et Créer des zones tampon - Réalisez un calcul mathématique pour définir la taille de la zone tampon. Vous pouvez effectuer des calculs simples ou complexes et les appliquer à tous les enregistrements. Ce calcul s’applique à chaque entité.
  • Expressions de jointure dans Entités jointes - Définissez une condition pour sélectionner les entités à inclure dans la jointure. Vous pouvez appliquer des conditions de jointure simples (telles que field a > field c), mais également des conditions avancées. Les conditions sont testées par rapport à chaque entité pour identifier le contenu analysé.
  • Valeurs des champs de calcul dans Calculer un champ - Réalisez des calculs simples ou complexes à appliquer à tous les enregistrements. Ce calcul s’applique à chaque entité.
  • Détecter les incidents à l’aide des expressions de début et de fin dans Détecter les incidents - Déterminez les conditions de début et de fin des incidents. Le résultat d’une condition de l’outil Détecter les incidents doit toujours être true ou false. Utilisez une condition pour vérifier si une entité doit être incluse dans un incident. Les conditions sont testées par rapport à chaque entité pour identifier les entités qui sont des incidents.

Exemples d’opérations et de fonctions mathématiques

Les expressions peuvent traiter les nombres mathématiquement. Le tableau ci-dessous présente des exemples d’opérations disponibles.

En savoir plus sur les opérations mathématiques et les fonctions disponibles dans Arcade

OpérateurExplicationExempleRésultat

a + b

Renvoie la somme de a plus b.

fieldname contient la valeur 1.5

$feature["nom du champ"] + 2.5

4.0

a - b

Renvoie la différence de a moins b.

fieldname contient la valeur 3.3

$feature["fieldname"] - 2.2

1.1

a * b

Renvoie le produit de a multiplié par b.

fieldname contient la valeur 2.0

$feature["nom du champ"] * 2.2

4.4

a / b

Renvoie le quotient de a divisé par b.

fieldname contient la valeur 4.0

$feature["nom du champ"] / 1.25

3.2

abs( a )

Renvoie la valeur absolue (positive) de a.

fieldname contient la valeur -1.5

abs($feature["nom du champ"])

1.5

log ( a )

Renvoie le logarithme naturel (base E) de a.

fieldname contient la valeur 1

log($feature["nom du champ"])

0

sin ( a )

Renvoie le sinus trigonométrique de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 1.5707

sin($feature["nom du champ"])

1

cos( a )

Renvoie le cosinus trigonométrique de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 0

cos($feature["nom du champ"])

1

tan( a )

Renvoie la tangente de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 0

tan($feature["nom du champ"])

0

sqrt( a )

Renvoie la racine carrée de a.

fieldname contient la valeur 9

sqrt($feature["nom du champ"])

3

min( a, b )

Renvoie la valeur a ou b la plus faible.

fieldname contient les valeurs 1.5 et -3

min($feature["nom du champ"], -3)

-3

max( a, b )

Renvoie la valeur a ou b la plus élevée.

fieldname1 contient la valeur 1.5 et fieldname2 contient la valeur -3

max($feature["nom du champ1"], $feature["nom du champ2"])

1.5

constrain(<value>,<low>,<high>)

Renvoie la valeur en entrée si elle est comprise dans les limites de contrainte. Si la valeur est inférieure à la valeur basse, elle renvoie la valeur basse. Si la valeur est supérieure à la valeur élevée, elle renvoie la valeur élevée.

constrain( $feature["distance"], 0, 10)

constrain($feature[’Store dist’], 6, distance)

Renvoie 0 si distance est inférieure à 0, 10 si distance est supérieure à 10 et distance dans les autres cas.

Renvoie 6 si Store dist est inférieure à 6, distance si Store dist est supérieure à distance et Store dist dans les autres cas.

Exemples de fonctions de texte

Les expressions Arcade peuvent traiter du texte. Le tableau ci-dessous présente des exemples d’opérations disponibles.

En savoir plus sur les fonctions de texte disponibles dans Arcade

OpérateurExplicationExempleRésultat

concatenate( <valeurs>, <séparateur>)

Concatène les valeurs et renvoie une chaîne.

  • values : un groupe de valeurs de chaîne à concaténer.
  • separator (facultatif) : un séparateur à utiliser pour la concaténation si le paramètre values est une matrice, ou une chaîne à concaténer si une valeur unique est fournie pour le premier paramètre. Si elle n’est pas renseignée, elle restera vide.

fieldname contient la valeur GeoAnalytics

Concaténer ([$features["fieldname"], "is", "great!"], ' ')

GeoAnalytics est formidable !

find(<searchText>, <text>, <startPos>)

Trouve une chaîne dans une chaîne. Les caractères génériques ne sont pas pris en charge.

  • searchText : la sous-chaîne à rechercher.
  • text : le texte à rechercher.
  • startPos (en option) : l'index basé sur zéro de l’emplacement dans la chaîne dans laquelle effectuer une recherche.

fieldname1 contient la valeur 14NorthStreet et fieldname2 contient la valeur North

find($feature["nom du champ2"], $feature["nom du champ1"])

2

lower(<value>)

Passe un segment en minuscules.

  • value : le segment passe en minuscules.

fieldname contient la valeur GEOANALYTICS

lower($feature["nom du champ"])

GeoAnalytics

Exemple de texte utilisant find et lower.

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

Exemples de fonctions de date

Les expressions Arcade peuvent traiter des dates. Le tableau ci-dessous présente des exemples d’opérations disponibles. Dans Arcade, les valeurs de mois, de jour et d’heure sont comprises respectivement entre 0 (janvier) et 11 (décembre), entre le 1er et le 31, et entre 0 (12:00 a.m.) et 23 (11:00 p.m.) heures, 0 et 59 minutes, 0 et 59 secondes et 0 et 999 millisecondes.

En savoir plus sur les fonctions de date disponibles dans Arcade

OpérateurExplicationExempleRésultat

date( <value>, <month>, <day>, <hour>, <minute>)

Décrit une valeur ou un ensemble de valeurs dans une chaîne de date.

  • value(En option) : le nombre de millisecondes depuis le 1er janvier 1970 UTC ou un nombre représentant une année. Si une année est spécifiée, le mois et le jour doivent être également renseignés dans les paramètres suivants. Cette valeur peut également être une chaîne de date ou une chaîne ISO 8601 à convertir en date.
  • month (facultatif) : le mois (de 0 à 11), où 0 correspond à janvier et 11 à décembre.
  • day (facultatif) : le jour du mois (1 à 31).
  • hour (facultatif) : l’heure de la journée (0 à 23).
  • minute (facultatif) : la minute de l’heure (0 à 59).
  • second (facultatif) : la seconde de la minute (0 à 59).
  • millisecond (facultatif) : la milliseconde de la seconde (0 à 999).

fieldname contient la valeur 1476987783555

Exemple 1 : Date($features["fieldname"])

Exemple 2 : Date(2017,0, 14,0)

Exemple 3 : Date()

Exemple 1 : 20 oct 2016 11:23:03 am

Exemple 2 : 14 jan 2017 00:00:00 am

Exemple 3 : renvoie l'heure actuelle

DateDiff(<date1>, <date2>, <unités>)

Opère une soustraction entre deux dates et renvoie la différence dans les unités spécifiées.

  • date1 : la valeur de date à laquelle soustraire une seconde date.
  • date2 : la valeur de date à soustraire depuis la première date donnée.
  • startpos (facultatif) : les unités utilisées pour renvoyer la différence entre les deux dates données. Les unités prises en charge sont les milliseconds, seconds, minutes, hours, days, months, years. La valeur par défaut est milliseconds.

Exemple 1 : DateDiff(Date(2017,1,14,0), Date())

Example 2: DateDiff(Date(2017,1,14,0), Date(), "Années")

Le résultat variera en fonction du moment où vous exécutez cette commande.

Exemple 1 : -20532129137

Exemple 2 : -0,6546783768647119

Year(<dateValue>)

Renvoie l'année de la date donnée.

  • value : valeur de date identifiant l’année.

Exemple 1 : fieldname est un champ de type Date dont la valeur est 09 Oct 2017 04:30:43 pm

Year($feature["nom du champ"])

Exemple 2 : fieldname est un champ de type chaîne au format chaîne ISO 8601 dont la valeur est 2012-09-27

Exemple 1 : 2017

Exemple 2 : 2012

Exemples de fonctions logiques

Outre les expressions mathématiques simples, vous pouvez utiliser d'autres fonctions avancées pour appliquer des expressions de zone tampon.

FonctionExplicationExempleRésultat

iif(<condition>,<true value>,<false value>)

Renvoie une valeur si une condition est true et renvoie une autre valeur si la condition est false.

<true value> et <false value> peuvent être :

  • Un champ numérique. Si le nom du champ renferme un espace, utilisez des crochets.
  • Un nombre.
  • Une fonction.

iif($feature["field1"] > $feature["field2"], $feature["field1"], 0)

iif($feature["field1"] > $feature["field2"], iif($feature["field2"] = 0, $feature["field3"], $feature["field4"]), 0)

Renvoie field1 si field1 est supérieur à field2 et 0 dans les autres cas.

Renvoie le résultat de la deuxième fonction iif si field1 est supérieur à field2 et 0 dans les autres cas.

when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>)

Évalue une série d’expressions jusqu’à ce que l’une soit true.

  • expression : une expression.
  • result : résultat de l’expression. Il peut s’agir d’un nombre ou d’un champ.
  • default : une valeur facultative si les expressions ne font l’objet d’aucune correspondance.

when(($feature["champ1"] + 10) > 1, 1,($feature["champ2"] + 10) > 2, 2, $feature["champ3"])

Si field1 + 10 est supérieur à 1, renvoie 1. Sinon, vérifie si field2 + 10 est supérieur à 2. Renvoie 2 si c'est le cas. Si ce n'est pas le cas, renvoie field3.

decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> )

Évalue une expression et compare sa valeur aux paramètres suivants. Si l’expression correspond, elle renvoie la valeur du paramètre suivant. Si aucune correspondance n’est trouvée, le dernier paramètre peut être une valeur de renvoi par défaut.

  • conditional val : valeur conditionnelle. Il peut s’agir d’un champ ou d’une expression.
  • case : une valeur à comparer à la conditional val.
  • result : le résultat si le cas correspond à la conditional val.
  • defaultValue : une valeur facultative si aucune autre valeur n'est true.

decode($feature["champ1"] + 3 , $feature["champ1"], 1, $feature["champ2"], 2, 0)

Compare l'égalité entre la valeur conditionnelle field1 + 3 et cas1 field1. Si la condition est true, renvoie 1. Si la condition est false, compare l'égalité entre field1 + 3 et field2. Si la condition est true, renvoie 2 ; sinon, renvoie 0.

Opérateurs conditionnels

Les instructions conditionnelles peuvent utiliser les opérateurs suivants :

OpérateurExplicationExempleRésultats

a > b

a < b

a est supérieur à b

a est inférieur à b

10 > 2

False

a >= b

a <= b

a est supérieur ou égal à b

a est inférieur ou égal à b

abs(-10) >= 10

True

a != b

a est différent de b

abs(-3) != -3

True

a == b

a est égal à b

abs(-5) == 5

True

<condition1> || <condition2>

La condition 1 ou la condition 2 est satisfaite.

(abs(-5) == 5) || (10 < 2)

True

<condition1> && <condition2>

La condition 1 et la condition 2 sont satisfaites.

(abs(-5) == 5) && (10 < 2)

False

Exemples d’équations gérant les pistes

Les outils Détecter les incidents, Calculer un champ et Reconstruire les pistes peuvent utiliser des équations de gestion du suivi dans Arcade. Dans l’outil Calculer un champ, les équations de gestion des pistes peuvent être utilisées lorsque la couche en entrée est temporelle, lorsque The expression is track aware (L’expression est dotée de propriétés de gestion de pistes) et qu’un ou plusieurs champs sont spécifiés pour identifier les pistes.

FonctionExplicationExempleRésultat

TrackStartTime()

Calcule l’heure de début d’une piste en millisecondes depuis la dernière époque.

Utilisation d’une piste commençant le 2 janvier 2017

TrackStartTime()

1483315200000

TrackDuration()

Calcule la durée d'une piste en millisecondes depuis le début jusqu’à l’intervalle temporel actuel.

Utilisation d’une piste commençant le 2 janvier 2017, la date actuelle étant le 4 janvier 2017.

TrackDuration()

172800000

TrackCurrentTime()

Calcule l’heure actuelle dans une piste.

Utilisation d’une entité survenant le 3 janvier 2017 à 9 h 00.

TrackCurrentTime()

1483434000000

TrackIndex

Renvoie l’index temporel de l’entité en cours de calcul.

Calculant cette valeur sur la première entité dans une piste.

TrackIndex

0

TrackFieldWindow(<fieldName>, <startIndex>, <endIndex>)

Renvoie une matrice de valeurs dans le champ donné pour l’index de temps spécifié. La fonction de fenêtre vous permet d’avancer et de reculer dans le temps. L’expression est évaluée à chaque entité de la piste.

  • L’entité actuelle se trouve à l’index 0.
  • Les valeurs positives représentent des entités qui ont lieu dans le futur, après la valeur actuelle. Par exemple, la position 1 est la prochaine valeur dans la matrice.
  • Les nombres négatifs représentent des entités qui ont eu lieu dans le passé, avant l’entité précédente. Par exemple, -1 est la valeur précédente dans la matrice.

MyField comporte les valeurs classées séquentiellement suivantes : [10, 20, 30, 40, 50]. L’expression est évaluée au niveau de chaque entité de la piste. Les résultats sont renvoyés en intégrant l’entité de départ et en excluant l’entité de fin.

Exemple 1 :TrackFieldWindow("MyField,-1,2)

Exemple 2 :TrackFieldWindow("MyField,-2,0)[0]

Exemple 3 :TrackFieldWindow("MyField,0,3)[2]

Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.

Entité évaluée

Résultat

10

[10,20]

20

[10, 20, 30]

30

[20,30,40]

40

[30,40,50]

50

[40, 50]

Exemple 2 : lorsque l’expression est évaluée à l’index 2 (valeur de 30), elle renvoie : 10.

Exemple 3 : lorsque l’expression est évaluée à l’index 2 (valeur de 30), elle renvoie : 50.

TrackGeometryWindow(<startIndex>, <endIndex>)

Renvoie une matrice de valeurs représentant la géométrie pour l’index de temps spécifié. La fonction window permet d’avancer et de remonter dans le temps. L’expression est évaluée à chaque entité de la piste.

  • L’entité actuelle se trouve à l’index 0.
  • Les valeurs positives représentent des entités qui ont lieu dans le futur, après la valeur actuelle. Par exemple, la position 1 est la prochaine valeur dans la matrice.
  • Les nombres négatifs représentent des entités qui ont eu lieu dans le passé, avant l’entité précédente. Par exemple, -1 est la valeur précédente dans la matrice.

MyField comporte les valeurs classées séquentiellement suivantes : [10, 20, 30, 40, 50]. La géométrie des entités est [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}] L’expression est évaluée à chaque entité de la piste. Les résultats sont renvoyés en intégrant l’entité de départ et en excluant l’entité de fin.

Exemple 1 :TrackGeometryWindow(-1,2)

Exemple 2 : TrackGeometryWindow(0,1)[0] sur un jeu de données polylignes

Exemple 3 : TrackGeometryWindow(0,1)[0] sur un jeu de données surfaciques

Exemple 4 : recherche de la valeur X du point précédent TrackGeometryWindow(-1,0)[0]["x"]

Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.

Entité évaluée

Résultat

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}]

Exemple 2 : les polylignes sont renvoyées au format suivant : [{"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]]]}]

Exemple 3 : les polygones sont renvoyés au format suivant : [{"rings":[[[-7882559.1197999995,6376090.883500002],[-7893142.474300001,6042715.216800004],[-8544018.775999999,6045361.0554000065],[-8544018.775999999,6376090.883500002],[-7882559.1197999995,6376090.883500002]]]}]

Exemple 4 : l’expression est évaluée à l’index 2 (valeur de 30) : 2

TrackWindow(<value1>, <value2>)

Renvoie une matrice de valeurs représentant la géométrie et tous les attributs pour l’index de temps spécifié. La fonction de fenêtre vous permet d’avancer et de reculer dans le temps.

  • L’entité actuelle se trouve à l’index 0.
  • Les valeurs positives représentent des entités qui ont lieu dans le futur, après la valeur actuelle. Par exemple, la position 1 est la prochaine valeur dans la matrice.
  • Les nombres négatifs représentent des entités qui ont eu lieu dans le passé, avant l’entité précédente. Par exemple, -1 est la valeur précédente dans la matrice.

MyField comporte les valeurs classées séquentiellement suivantes : [10, 20, 30, 40, 50], en plus des champs objectID, globalID et instant_datetime. La géométrie des entités est [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}] L’expression est évaluée à chaque entité de la piste. Les résultats sont renvoyés en intégrant l’entité de départ et en excluant l’entité de fin.

Exemple 1 : TrackWindow(-1,0)[0]

Exemple 2 :geometry(TrackWindow(-1,0)[0]["x"]

Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.

Entité évaluée

Résultat

10

20

[{"geometry": {x: 1, y: 1}},{"attributs": {"MonChamp" : 10, "NomPiste": "PisteExemple1"}}]

30

[{"geometry": {x: 2, y: 2}},{"attributs": {"MonChamp" : 20, "NomPiste":"PisteExemple1"}}]

40

[{"geometry": {x: null, y: null}},{"attributs": {"MonChamp" : 30, "NomPiste":"PisteExemple1"}}]

50

[{"geometry": {x: 4, y: 4}},{"attributs": {"MonChamp" : 40, "NomPiste":"PisteExemple1"}}]

Exemple 2 : l’expression est évaluée à l’index 2 (valeur de 30) : 2