L’outil Calculer un champ permet d’utiliser des expressions Arcade pour déterminer les valeurs de champ. Vous pouvez effectuer des calculs simples ou complexes et les appliquer à tous les enregistrements. Ce calcul s'applique à chaque entité. Les sections suivantes proposent des exemples d’utilisation d’une expression de champ calculé. Les calculs ont lieu dès que l’analyse démarre sur le ArcGIS GeoAnalytics Server et ont pour effet de générer systématiquement une nouvelle couche.
Dans ArcGIS Enterprise 10.6 et ultérieur, les expressions sont mises en forme à l’aide d’Arcade. 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.
Pour en savoir plus sur les expressions Arcade
Les expressions Arcade sont utilisées par les outils suivants dans GeoAnalytics Server :
- Expressions de zone tampon dans Reconstruire les pistes
- Expressions de zone tampon dans Créer des zones tampon
- Expressions de jointure dans Joindre des entités
- Détecter les incidents à l’aide des expressions de début et de fin dans Détecter les 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érateur | Explication | Exemple | Ré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 Calculer un champ peuvent s’appliquer à 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 |
|---|---|---|---|
concatenate( <valeurs>, <séparateur>) | Concatène les valeurs et renvoie une chaîne.
| 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.
| 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.
| 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 Calculer un champ peuvent s’appliquer à des dates. Le tableau ci-dessous présente des exemples d’opérations disponibles. Dans Arcade, les valeurs relatives aux mois, aux jours et aux heures sont comprises respectivement entre 0 (Janvier) et 11 (Décembre), entre le 1er et le 31, et entre 0 (12:00 am) et 23 (11:00 pm) heures, 0 et 59 minutes, 0 et 59 secondes et 0 et 999 millisecondes. Les dates Arcade renvoient des valeurs de temps dans l’emplacement de votre GeoAnalytics Server.
En savoir plus sur les fonctions de date disponibles dans Arcade
| Opérateur | Explication | Exemple | Résultat |
|---|---|---|---|
date( <value>, <month>, <day>, <hour>, <minute>) | Décrit une valeur ou un ensemble de valeurs dans une chaîne de date.
| 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.
| 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.
| 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.
| Fonction | Explication | Exemple | Ré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 :
| 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.
| 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.
| 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érateur | Explication | Exemple | Ré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’expressions permettant de gérer les pistes
Certains Outils GeoAnalytics, tels que Détecter les incidents et Calculer un champ, peuvent utiliser des équations permettant de gérer les pistes 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, l’expression est dotée de propriétés de gestion de pistes et un ou plusieurs champs sont utilisés pour identifier les pistes.
Utilisez l’expression de suivi suivante dans ArcGIS Enterprise 10.6.
| Fonction | Explication | Exemple | Résultat | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
$track.field["nom de champ"].history(<value1>) | Renvoie un groupe de valeurs dans le champ donné pour l'index de temps spécifié.
| MyField comporte les valeurs classées séquentiellement suivantes : [10, 20, 30, 40, 50, 60, 70, 80]. La valeur 10 se trouve à l’index 0, et 80 à l’index 7. Les expressions sont évaluées à chaque index et les exemples soulignent l’index utilisés pour les exemples. n représente le nombre d’entités dans la séquence et k représente l’index évalué. Exemple 1 :$track.field["MyField"].history(3)) Exemple 2 :$track.field["MyField"].history(-3) Exemple 3 :mean($track.field["MyField"].history(-2)) Exemple 4 :$track.field["MyField"].history(-3)[0] | Lorsque l’exemple 1 est évalué à l’index k, il renvoie une matrice de valeurs à l’index 3 à k. Si vous effectuez l’évaluation à l’index 6 (70), une matrice des valeurs à l’index [3, 4, 5, 6] est renvoyée, de sorte que la matrice est de [40, 50, 60, 70]. L’exemple 2 renvoie une matrice de valeurs calculées comme suit : index k moins la valeur donnée moins 1 (k-2). Si cet exemple est évalué à l’index 6 (value = 70), les valeurs k-2, k-1 et k sont renvoyées [50, 60, 70]. L’exemple 3 renvoie la moyenne des valeurs à l’index k-1 et à l’index k. Si vous l’évaluez à l’index 4 (value = 50), vous trouvez la moyenne de value 40 (index 3) et value 50 (index 4), ce qui est égal à 45. Si vous évaluez cet exemple à l’index 7, le résultat est alors la moyenne de 70 et 80, ce qui est égal à 75. L’exemple 4 renvoie le premier élément (index 0) de la matrice créée à l’exemple 2, c’est-à-dire 50. | ||||||||||||
$track.field["nom de champ"].history(< value1>,<value2>) | Renvoie un groupe de valeurs en commençant par l’index1 (<value1>) jusqu’à l’index2 (<value2>). | MyField a des valeurs ordonnées séquentiellement de [10, 20, 30, 40, 50, 60, 70, 80]. 10 se trouve à l’index 0, et 80 à l’index 7. Pour cet exemple, les expressions sont évaluées à l’index 7 (80). Exemple 1 :$track.field["MyField"].history(-3,-2)) Exemple 2 :$track.field["MyField"].history(-5,-2)) | Exemple 1 : [60] Exemple 2 : [40, 50, 60] | ||||||||||||
$track.time.start | 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 $track.time.start | 1483315200000 | ||||||||||||
$track.time.duration | 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. $track.time.duration | 172800000 | ||||||||||||
$track.time.current | Calcule l’heure actuelle dans une piste. | Utilisation d’une entité survenant le 3 janvier 2017 à 9 h 00. $track.time.current | 1483434000000 | ||||||||||||
$track.index | Renvoie l’index temporel de l’entité en cours de calcul. | Calculant cette valeur sur la première entité dans une piste. $track.index | 0 | ||||||||||||
$track.T(<value>, "<units>") | Renvoie l’heure d’entité plus l’heure créée à l'aide de la <valeur> numérique et des <unités> données.
| Utilisation d’une entité en date du 2 janvier 2017 à 14 h. Exemple 1 : $track.T(1, "hours") Exemple 2 : $track.T(-2, "days") | Exemple 1 : renvoie le 2 janvier à 15 h: 1483369200000 Exemple 2 : renvoie le 31 décembre à 14 h: 1483192800000 | ||||||||||||
$track.field["nom de champ"].window(<value1>, <value2>) | 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.
La fonction de fenêtre est disponible dans ArcGIS Enterprise 10.6.1 ou version ultérieure. | 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 :$track.field["MonChamp"].window(-1,2) Exemple 2 :$track.field["MonChamp"].window(-2,0)[0] Exemple 3 :$track.field["MonChamp"].window(0,3)[2] | Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.
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. | ||||||||||||
$track.geometry.window(<value1>, <value2>) | 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.
La fonction de fenêtre est disponible dans ArcGIS Enterprise 10.6.1 ou version ultérieure. | 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 :$track.geometry.window(-1,2) Exemple 2 : $track.geometry.window(0,1)[0] sur un jeu de données polylignes Exemple 3 : $track.geometry.window(0,1)[0] sur un jeu de données surfaciques Exemple 4 : recherche de la valeur X du point précédent $track.geometry.window(-1,0)[0]["x"] | Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.
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 | ||||||||||||
$track.window(<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.
La fonction de fenêtre est disponible dans ArcGIS Enterprise 10.6.1 ou version ultérieure. | 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 : $track.window(-1,0)[0] Exemple 2 : geometry($track.window(-1,0)[0]["x"] | Exemple 1 : lorsque l’expression est évaluée à chaque entité, la table présente les résultats suivants.
Exemple 2 : l’expression est évaluée à l’index 2 (valeur de 30) : 2 |
Utilisez l’expression de suivi suivante dans ArcGIS Enterprise 10.6.1 ou version ultérieure.
| 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 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.
| 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.
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.
| 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 de polylignes Exemple 3 : TrackGeometryWindow(0,1)[0] sur un jeu de données de polygones Exemple 4 : recherchez 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.
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.
| 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.
Exemple 2 : l’expression est évaluée à l’index 2 (valeur de 30) : 2 |
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?