Expressions ArcGIS Arcade dans la boîte à outils GeoAnalytics Desktop
Certains outils GeoAnalytics Desktop utilisent des expressions ArcGIS Arcade dans 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 GeoAnalytics Desktop utilisent le format $feature["field name"], à l’exception de l’outil Joindre les entités. Pour Joindre les entités, utilisez $target["field name"] et $join["field name"] afin de spécifier le jeu de données à utiliser.
Consultez le profil GeoAnalytics for Arcade pour en savoir plus sur l’utilisation, les variables de profil, les types de retour et bien plus encore.
Les expressions Arcade sont utilisées par les outils suivants de la boîte à outils GeoAnalytics Desktop :
Reconstruire les pistes et Créer des zones tampon : utilisez des expressions de zone tampon pour effectuer un calcul mathématique afin de 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é.
Reconstruire les pistes : utilise des expressions afin de spécifier une condition pour fractionner des pistes. Lorsque les points répondent aux critères, les pistes sont fractionnées et résumées dans différentes pistes. Vous pouvez appliquer des conditions simples et des conditions basées sur les pistes. Par exemple, vous pouvez fractionner des pistes lorsque la vitesse du point actuel est inférieure à deux mètres par seconde (
TrackCurrentSpeed() < 2).Joindre les entités : utilisez des expressions de jointure afin de spécifier une condition pour sélectionner les entités devant être incluses 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é.Calculer un champ : effectuez des calculs simples ou complexes et appliquez-les à tous les enregistrements. Ce calcul s’applique à chaque entité.
Détecter les incidents : déterminez des conditions de début et de fin pour les incidents. Utilisez des expressions de début et de fin pour détecter les incidents. Le résultat d’une condition de l’outil Détecter les incidents doit toujours être
trueoufalse. Utilisez une condition pour déterminer 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.
En savoir plus sur les expressions Arcade
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 et les fonctions mathématiques disponibles dans Arcade
|
Opérateur |
Explication |
Exemple |
|---|---|---|
|
|
Renvoie la somme de a plus b. |
4.0 |
|
|
Renvoie la différence de a moins b. |
1.1 |
|
|
Renvoie le produit de a multiplié par b. |
4.4 |
|
|
Renvoie le quotient de a divisé par b. |
3.2 |
|
|
Renvoie la valeur absolue (positive) de a. |
1,5 |
|
|
Renvoie le logarithme naturel (base E) de a. |
0 |
|
|
Renvoie le sinus trigonométrique de a. On suppose que l'entrée est un angle en radians. |
1 |
|
|
Renvoie le cosinus trigonométrique de a. On suppose que l'entrée est un angle en radians. |
1 |
|
|
Renvoie la tangente de a. On suppose que l'entrée est un angle en radians. |
0 |
|
|
Renvoie la racine carrée de a. |
3 |
|
|
Renvoie la valeur a ou b la plus faible. |
-3 |
|
|
Renvoie la valeur la plus élevée entre a et b. |
1,5 |
|
|
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. |
Exemple 1 : Renvoie 0 si Exemple 2 : Renvoie 6 si |
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érateur |
Explication |
Exemple |
Résultat |
|---|---|---|---|
|
|
Concatène les valeurs et renvoie une chaîne.
|
|
GeoAnalytics est super ! |
|
|
Trouve une chaîne à l’intérieur d’une chaîne. Les caractères génériques ne sont pas pris en charge.
|
|
2 |
|
|
Convertit une chaîne en minuscule.
|
|
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érateur |
Explication |
Exemple |
Résultat |
|---|---|---|---|
|
|
Analyse une valeur ou un ensemble de valeurs dans une chaîne de date.
|
Exemple 1 : Exemple 2 : Exemple 3 : |
Exemple 1 : 20 Oct 2016 11:23:03 Exemple 2 : 14 Jan 2017 00:00:00 Exemple 3 : renvoie l'heure actuelle |
|
|
Opère une soustraction entre deux dates et renvoie la différence dans les unités spécifiées.
|
Exemple 1 : Exemple 2 : |
Le résultat dépend du moment où est exécutée cette commande. Exemple 1 : -20532129137 Exemple 2 : -0.6546783768647119 |
|
|
Renvoie l'année de la date donnée.
|
Exemple 1 :
Exemple 2 : |
Exemple 1 : 2017 Exemple 2 : 2012 |
Exemples de fonction logique
Outre les expressions mathématiques simples, vous pouvez utiliser les fonctions avancées affichées dans la table ci-dessous pour appliquer des expressions de zone tampon.
|
Fonction |
Explication |
Exemple |
Résultat |
|---|---|---|---|
|
|
Renvoie une valeur si une condition est
|
|
Renvoie Renvoie le résultat de la deuxième fonction |
|
|
Évalue une série d’expressions jusqu’à ce que l’une soit
|
|
Si |
|
|
É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.
|
|
Compare l’égalité entre la valeur conditionnelle |
Opérateurs conditionnels
Les instructions conditionnelles peuvent utiliser les opérateurs affichés dans la table suivante :
|
Opérateur |
Explication |
Exemple |
Résultats |
|---|---|---|---|
|
|
a est supérieur à b a est inférieur à b |
|
False |
|
|
a est supérieur ou égal à b a est inférieur ou égal à b |
|
True |
|
|
a est différent de b |
|
True |
|
|
a est égal à b |
|
True |
|
|
La condition 1 ou la condition 2 est satisfaite. |
|
True |
|
|
La condition 1 et la condition 2 sont satisfaites. |
|
False |
Exemples d’équations gérant les pistes
Les outils Détecter les incidents, Calculer un champ et Reconstruire les traces peuvent utiliser des équations de gestion des traces 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 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. Les fonctions de gestion des traces sont répertoriées dans la table suivante :
|
Fonction |
Explication |
Exemple |
Ré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
|
|
||||||||||||
|
TrackDuration() |
Calcule la durée d’une piste en millisecondes depuis le début jusqu’à l‘intervalle de temps actuel. |
Utilisation d’une piste commençant le 2 janvier 2017, la date actuelle étant le 4 janvier 2017.
|
|
||||||||||||
|
TrackCurrentTime() |
Calcule l’heure actuelle dans une piste. |
Utilisation d’une entité survenant le 3 janvier 2017 à 9 h 00.
|
|
||||||||||||
|
TrackIndex |
Renvoie l’index de temps de l’entité qui est calculée. |
Calcul de cette valeur sur la première entité dans une piste.
|
|
||||||||||||
|
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.
|
Exemple 1 : Exemple 2 : Exemple 3 : |
Exemple 1 : si elle est évaluée à chaque entité, la table contient les résultats suivants :
Exemple 2 : si l’expression est évaluée à l’index 2 (valeur de 30), elle renvoie Exemple 3 : si l’expression est évaluée à l’index 2 (valeur de 30), elle renvoie |
||||||||||||
|
TrackGeometryWindow(<startIndex>, <endIndex>) |
Renvoie une matrice de valeurs représentant la géométrie de 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.
|
Exemple 1 : Exemple 2 : Exemple 3 : Exemple 4 : recherche de la valeur X du point précédent |
Exemple 1 : si elle est évaluée à chaque entité, la table contient les résultats suivants :
Exemple 2 : les polylignes sont renvoyées au format suivant : Exemple 3 : les polygones sont renvoyés au format suivant : Exemple 4 : l’expression est évaluée à l’index 2 (valeur de 30) : |
||||||||||||
|
TrackWindow(<value1>, <value2>) |
Renvoie une matrice de valeurs représentant la géométrie et tous les attributs de l’index de temps spécifié. La fonction de fenêtre vous permet d’avancer et de reculer dans le temps.
|
Exemple 1 : Exemple 2 : |
Exemple 1 : si elle est évaluée à chaque entité, la table contient les résultats suivants :
Exemple 2 : l’expression est évaluée à l’index 2 (valeur de 30) : |
Utilisez les expressions de piste de la table ci-dessous pour calculer la distance, la vitesse et l’accélération sur les pistes. Cette opération est similaire aux calculs utilisés dans l’outil Calculer les statistiques de déplacement.
Tous les calculs de distance sont exprimés en mètres, la vitesse est exprimée en mètres par seconde et l’accélération, en mètres par seconde carré. Les distances sont mesurées à l’aide des distances géodésiques.
|
Fonction |
Explication |
|---|---|
|
|
Somme des distances parcourues entre les observations de la première observation à l’observation actuelle. |
|
|
Somme des distances parcourues entre les observations de la première observation à l’observation le service actuelle, plus la valeur donnée. |
|
|
Distances entre la première valeur (incluse) et la dernière valeur (exclue) dans une fenêtre sur l’observation actuelle (0). |
|
|
Vitesse entre l’observation précédente et l’observation actuelle. |
|
|
Vitesse au niveau de l’observation par rapport à l’observation actuelle. Par exemple, à la valeur 2, il s’agit de la vitesse au niveau de l’observation, deux observations après l’observation actuelle. |
|
|
Valeurs de vitesse entre la première valeur (incluse) et la dernière valeur (exclue) dans une fenêtre autour de l’observation actuelle (0). |
|
|
Accélération entre l’observation précédente et l’observation actuelle. |
|
|
Accélération au niveau de l’observation par rapport à l’observation actuelle. |
|
|
Valeurs d’accélération entre la première valeur (incluse) et la dernière valeur (exclue) dans une fenêtre autour de l’observation actuelle (0). |
Les exemples de calcul de distance, de vitesse et d’accélération utilisent les exemples de l’image ci-après.

|
Fonction |
Exemple de résultat |
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|
||||||||||||||
|
|
|