Détecter les incidents

Disponible dans les analyses en temps réel et les analyses de Big Data.

L’outil Détecter les incidents  évalue les entités à l’aide d’un ensemble de conditions d’ouverture et de conditions de fermeture facultatives, puis crée un incident unique pour chaque ensemble continu d’observations qui répondent aux conditions.

Diagramme de workflow

Exemples

Vous trouverez ci-dessous des exemples d’utilisation de l’outil Détecter les incidents :

• Chaque véhicule d’une flotte envoie sa localisation et sa vitesse à intervalles réguliers. Si la vitesse signalée par un véhicule dépasse la limitation de vitesse en vigueur à la localisation indiquée, l’outil Détecter les incidents ouvre un incident. Pour chaque observation signalée par la suite par le véhicule, si sa vitesse continue à être supérieure à la limitation de vitesse, l’incident est maintenu à l’état en cours. Lorsque le véhicule indique une vitesse inférieure à la limitation de vitesse en vigueur, l’incident est fermé.
• Un capteur de pression situé sur un pipeline qui mesure la pression actuelle au niveau d’une vanne indique une pression hors de la plage de fonctionnement normale. L’outil Détecter les incidents ouvre un incident qui est maintenu à l’état en cours tant que le capteur indique que la pression se situe en dehors de la plage normale. L’incident est fermé une fois que la pression revient à la normale.
• Un convoi de poids lourds approche d’un tunnel dans lequel les véhicules transportant des matières dangereuses sont interdits. Chaque véhicule signale sa localisation et ArcGIS Velocity met à jour les informations entrantes pour chaque véhicule en fonction de son manifeste de fret. Un des poids lourds transporte des oxydants, considérés comme dangereux. Un incident est ouvert en fonction de la proximité du poids lourd par rapport au tunnel et en fonction des attributs du fret. Lorsque le poids lourd s’éloigne du tunnel, l’incident est fermé.
• Un véhicule de livraison attribué à un itinéraire spécifique sort de la zone pendant une durée définie. Un incident est ouvert lorsque le véhicule quitte la zone attribuée et est fermé lorsque le véhicule rentre à nouveau dans la zone.

Remarques sur l’utilisation

Gardez les points suivants à l’esprit lorsque vous utilisez l’outil Détecter les incidents :

• Le paramètre Open Condition (Condition d’ouverture) est obligatoire. Le paramètre Close Condition (Condition de fermeture) est en revanche lui facultatif. Si la valeur du paramètre Close Condition (Condition de fermeture) n’est pas explicitement définie, l’opérateur logique NOT du paramètre Open Condition (Condition d’ouverture) est utilisé comme condition de fermeture.
  • Si l’option Spatial Relationship (Relation spatiale) est définie sur Intersects (Intersecte ), la valeur implicite du paramètre Close Condition (Condition de fermeture) est Disjoint.
  • Si l’option Spatial Relationship (Relation spatiale) est définie sur Enter (Entrée) ou Exit (Sortie), la valeur implicite de Close Condition (Condition de fermeture) est respectivement Exit (Sortie) ou Enter (Entrée).
• Dans une analyse temps réel, cet outil fonctionne avec état lorsque la valeur Enter (Entrée) ou Exit (Sortie) est utilisée pour l’option Spatial Relationship (Relation spatiale) dans Open Condition (Condition d’ouverture) ou Close Condition (Condition de fermeture). Lorsqu’il fonctionne avec état, l’outil peut comparer les observations séquentielles pour détecter un changement d’état entre les observations. Cet outil s’exécute sans état lorsque vous utilisez d’autres options de relation spatiale car il n’a alors pas besoin de comparer les observations actuelles aux observations précédentes. L’exécution sans état nécessite moins de ressources.
• Lorsqu’il fonctionne avec état, l’outil Détecter les incidents conserve un magasin d’état de l’observation actuelle pour chaque ID de suivi. Lorsqu’une nouvelle observation est reçue, elle est comparée à l’observation actuelle du même ID de suivi, si cette dernière existe. Si l’horodatage de la nouvelle observation est plus récent que celui de l’observation actuelle dans le magasin d’état, l’observation actuelle est remplacée. Si l’horodatage est identique à celui de l’observation actuelle pour le même ID de suivi, l’outil ne peut pas faire la distinction entre les deux observations. Ceci signifie que l’outil ne remplace pas l’observation actuelle par la nouvelle observation dans le magasin d’état, la nouvelle observation n’est pas ajoutée au magasin d’état et les observations futures de cet ID de suivi sont comparées à l’observation actuelle, laquelle est conservée dans le magasin d’état jusqu’à l’arrivée d’une nouvelle observation possédant un horodatage ultérieur. L’outil enregistre un avertissement lorsque cela se produit.
• L’outil dispose de deux entrées. Néanmoins, le paramètre Join data (Données de jointure) est disponible uniquement si vous sélectionnez Spatial Relationship (Relation spatiale) pour le paramètre Open Condition (Condition d’ouverture) ou Close Condition (Condition de fermeture).
• Il est possible de configurer une expression Arcade pour les paramètres Open Condition (Condition d’ouverture) et Close Condition (Condition de fermeture).
• Dans une analyse en temps réel, si le paramètre Close on Expiration (Fermer à l’expiration) est défini sur Yes (Oui), tout incident d’ouverture est fermé à l’expiration du délai fixé pour Target Time Window (Fenêtre horaire cible). Si ce paramètre est défini sur No (Non), tout incident ouvert reste ouvert. Si la fenêtre horaire définie dans Target Time Window (Fenêtre horaire cible) expire, un nouvel incident est créé si la relation spatiale ou l’expression attributaire indiquée dans le paramètre Open Condition (Condition d’ouverture) est satisfaite.
• Pour le paramètre Open Condition (Condition d’ouverture), si vous sélectionnez Spatial Relationship (Relation spatiale) et que vous utilisez l’opérateur spatial Enter (Entrée) ou Exit (Sortie), le fait de cocher la case First observation can trigger enter (La première observation peut déclencher l’entrée) ou First observation can trigger exit (La première observation peut déclencher la sortie) indique que la première entité cible reçue ou traitée pour chaque ID de suivi peut déclencher l’ouverture d’un incident si elle se trouve dans une entité de jointure si la relation spatiale est de type Enter (Entrée), ou en dehors de toutes les entités de jointure si la relation spatiale est de type Exit (Sortie), malgré l’absence d’entité cible précédente avec laquelle comparer la localisation de l’entité cible actuelle. Cette option est désactivée par défaut.
• Dans une analyse temps réel, le paramètre Target Time Window (Fenêtre horaire cible) doit être défini sur la durée la plus longue pendant laquelle un incident doit rester ouvert ou sur une durée plus longue. Les observations plus anciennes sont supprimées de la mémoire dans le cadre de la gestion des ressources. Il est recommandé de définir une valeur supérieure à la durée la plus longue attendue pour l’incident. Par exemple, si la durée la plus longue attendue pendant laquelle un incident doit rester ouvert est de 20 heures, il est possible de définir cette valeur sur 24 heures pour vous assurer qu’aucun incident ne sera fermé prématurément.
• La valeur IncidentDuration est calculée pour les incidents en sortie en millisecondes.
• Si un flux est connecté au port de jointure, la détection d’incidents s’effectue en fonction de l’évolution des entités dans les flux cible et de jointure.
• Lorsque vous effectuez un geofencing dynamique, le paramètre Join Time Window (Fenêtre horaire de jointure) doit être défini. Si, dans le flux de jointure, aucun champ de clé n’est spécifié pour l’option End time (Date/heure de fin) et que la dernière observation connue pour une entité de jointure est antérieure à cette fenêtre, elle est supprimée de la mémoire de l’outil et exclue de l’analyse. Si, dans le flux de jointure, un champ de clé est spécifié pour l’option End time (Date/heure de fin), l’entité expire du magasin de geofences en fonction de la valeur figurant dans le champ, à savoir la date/heure de fin, ou à la fermeture de la fenêtre horaire de jointure, selon l’événement qui se produit en premier.
• Lorsque le geofencing dynamique est effectué, les expressions Arcade ne sont valides que pour l’entité cible.
• Le tableau suivant indique les méthodes disponibles pour la relation spatiale en fonction des types de géométrie en entrée et de jointure :

Types de géométrie en entrée et de jointure	Contient	Croise	Disjoint	Entrée	Est égal à	Quitter	Intersecte	Géodésique proche	Planaire proche	Superpose	Touche	Dans
Point et point
Point et polyligne
Point et polygone
Polyligne et point
Polyligne et polyligne
Polyligne et polygone
Polygone et point
Polygone et polyligne
Polygone et polygone

Paramètres

Les paramètres de l’outil Détecter les incidents sont les suivants :

Paramètre	Description	Type de données
Target Data (Données cibles)	Données pour lesquelles des incidents sont détectés à l’aide des paramètres Open Condition (Condition d’ouverture) et Close Condition (Condition de fermeture).	Entités
Join Data (Données de jointure) (facultatif)	Données à utiliser avec une relation spatiale dans les paramètres Open Condition (Condition d’ouverture) et Close Condition (Condition de fermeture).	Entités
Open Condition (Condition d’ouverture)	Ensemble de conditions définissant le début d’un incident. Cet ensemble peut inclure une condition spatiale, une période et un ensemble d’expressions attributaires. Time Range (Période) (analyses de Big Data uniquement) – Indique la période de détection des incidents. Spatial Relationship (Relation spatiale) – Spécifie les critères utilisés pour la détection spatiale des incidents. Cette option apparaît uniquement si un jeu de données a été connecté au port join. Les opérateurs spatiaux disponibles sont les suivants : Disjoint : si une géométrie n’intersecte pas une autre géométrie. Enter (Entrée) : si une géométrie entre dans l’espace d’une autre géométrie. Equals (Est égal à) : si les géométries de base et de comparaison ont le même type de forme. Exit (Sortie) : si une géométrie quitte l’espace occupé par une autre géométrie. Near Geodesic (Géodésique proche) : si une géométrie est proche d’un sommet ou d’un tronçon à une distance géodésique donnée d’une autre géométrie. Near Planar (Planaire proche) : si une géométrie est proche d’un sommet ou d’un tronçon à une distance planaire donnée d’une autre géométrie. Touches (Touche) : si une géométrie touche une autre géométrie si elles s’intersectent en un sommet sans se superposer. Contains (Contient) : si une géométrie en contient une autre. Crosses (Croise) : si les deux géométries s’intersectent dans une géométrie dont le type de forme est inférieur. Intersects (Intersecte) : si une géométrie en intersecte une autre. Overlaps (Superpose) : si une géométrie se superpose à une autre géométrie. None (Aucune) : s’il n’existe aucune relation spatiale entre deux géométries. Within (Dans) : si une géométrie est entièrement comprise dans une autre géométrie. First observation can trigger enter/exit (La première observation peut déclencher l’entrée/la sortie) – Cette option est disponible si l’opérateur Enter (Entrée) ou Exit (Sortie) est sélectionné pour une relation spatiale. Elle indique que la première entité cible reçue peut ouvrir un incident, malgré l’absence d’entité cible précédente avec laquelle comparer la localisation de l’entité cible actuelle. Si vous sélectionnez Enter (Entrée), l’incident s’ouvre si l’entité cible se trouve dans une entité de jointure. Si vous sélectionnez Exit (Sortie), l’incident s’ouvre si l’entité cible se trouve en dehors d’une entité de jointure. Ces deux opérateurs sont décochés par défaut. Join Fields (Champs de jointure) (facultatif) (analyses temps réel uniquement) – Spécifie les champs des entités de jointure à ajouter aux entités cibles. Les champs sélectionnés en tant que champs de jointure sont présents dans la structure en sortie. Si la relation spatiale disjointe est utilisée, les valeurs de champ sont définies sur des valeurs nulles. Arcade Expression (Expression Arcade) – Expression attributaire qui définit les critères des incidents. Match all open conditions (Remplir toutes les conditions d’ouverture) – Si cette option est définie sur Yes (Oui), les conditions spatiales, temporelles et attributaires doivent toutes être remplies pour qu’un incident soit ouvert. Si cette option est définie sur No (Non), n’importe laquelle des conditions est suffisante pour qu’un incident soit ouvert. Remarque : Si la relation spatiale Disjoint ou Exit (Sortie) est utilisée pour le paramètre Open Condition (Condition d’ouverture), les entités cibles doivent être entièrement disjointes de toute autre entité de la source du paramètre Join Data (Données de jointure) pour qu’un incident soit ouvert. Pour toutes les autres options de relation spatiale, l’entité cible doit uniquement satisfaire la relation spatiale avec n’importe quelle autre entité de la source du paramètre Join Data (Données de jointure) pour qu’un incident soit ouvert.	Paramètres
Close Condition (Condition de fermeture) (facultatif)	Ensemble de conditions définissant la fin d’un incident. Comme pour le paramètre Open Condition (Condition d’ouverture), cet ensemble peut inclure une condition spatiale, une période et un ensemble d’expressions attributaires. Time Range (Période) (analyses de Big Data uniquement) – Indique la période de détection des incidents. Spatial Relationship (Relation spatiale) : définit les critères utilisés pour filtrer les entités cibles de manière spatiale. Ce paramètre apparaît uniquement si un jeu de données a été connecté au port join. Les opérateurs spatiaux disponibles sont les suivants : Disjoint : si une géométrie n’intersecte pas une autre géométrie. Enter (Entrée) : si une géométrie entre dans l’espace d’une autre géométrie. Equals (Est égal à) : si les géométries de base et de comparaison ont le même type de forme. Exit (Sortie) : si une géométrie quitte l’espace occupé par une autre géométrie. Near Geodesic (Géodésique proche) : si une géométrie est proche d’un sommet ou d’un tronçon à une distance géodésique donnée d’une autre géométrie. Near Planar (Planaire proche) : si une géométrie est proche d’un sommet ou d’un tronçon à une distance planaire donnée d’une autre géométrie. Touches (Touche) : si une géométrie touche une autre géométrie si elles s’intersectent en un sommet sans se superposer. Contains (Contient) : si une géométrie en contient une autre. Crosses (Croise) : si les deux géométries s’intersectent dans une géométrie dont le type de forme est inférieur. Intersects (Intersecte) : si une géométrie en intersecte une autre. Overlaps (Superpose) : si une géométrie se superpose à une autre géométrie. None (Aucune) : s’il n’existe aucune relation spatiale entre deux géométries. Within (Dans) : si une géométrie est entièrement comprise dans une autre géométrie. Arcade Expression (Expression Arcade) – Expression attributaire qui doit être évaluée pour détecter des incidents. Match all close conditions (Remplir toutes les conditions de fermeture) – Si cette option est définie sur Yes (Oui), les conditions spatiales, temporelles et attributaires doivent toutes être remplies pour qu’un incident soit fermé. Si cette option est définie sur No (Non), n’importe laquelle des conditions est suffisante pour qu’un incident soit fermé. Remarque : Si la relation spatiale Disjoint ou Exit (Sortie) est utilisée pour le paramètre Close Condition (Condition de fermeture), les entités cibles doivent être entièrement disjointes de toute autre entité de la source du paramètre Join Data (Données de jointure) pour qu’un incident soit ouvert. Pour toutes les autres options de relation spatiale, l’entité cible doit uniquement satisfaire la relation spatiale avec n’importe quelle autre entité de la source du paramètre Join Data (Données de jointure) pour qu’un incident soit ouvert.	Paramètres
Return Incidents Only (Renvoyer uniquement les incidents)	Si défini sur Yes (Oui) – Renvoie les observations qui sont uniquement associées à un incident. Si défini sur No (Non) – Renvoie toutes les observations.	Booléen
Suivi de la localisation	Champs utilisés pour identifier de manière unique les entités à traiter. Si la couche d’entités cible comporte un champ d’ID de suivi spécifié, la valeur Track ID (ID de suivi) est automatiquement définie.	Champs
Target Time Window (Fenêtre horaire cible) (analyses temps réel uniquement)	Les observations plus anciennes sont supprimées de la mémoire dans le cadre de la gestion des ressources. Cette valeur doit être définie sur la durée la plus longue pendant laquelle un incident doit rester ouvert ou sur une durée plus longue. Il est recommandé de définir une valeur supérieure à la durée la plus longue attendue pour l’incident.	Chaîne
Join Time Window (Fenêtre horaire de jointure) (analyses temps réel uniquement)	Il s’agit de la fenêtre horaire pour le flux de jointure (geofences dynamiques). Si la dernière observation connue pour une entité de jointure est antérieure à la fenêtre horaire spécifiée, elle est supprimée et n’est pas incluse dans l’analyse. Si le flux de jointure comporte un champ de clé spécifié pour l’option End Time (Date/heure de fin), ce paramètre est facultatif. Remarque : Ce paramètre est disponible uniquement si les couches cible et de jointure sont toutes les deux des flux.	Chaîne
Close on Expiration (Fermer à expiration) (analyses temps réel uniquement)	Si défini sur Yes (Oui) – tout incident ouvert est fermé à l’expiration de la fenêtre horaire spécifiée par la valeur de Target Time Window (Fenêtre horaire cible). Si définie sur No (Non) – tout incident ouvert reste ouvert même après expiration de la fenêtre horaire spécifiée dans Target Time Window (Fenêtre horaire cible). À l’expiration de la fenêtre horaire spécifiée dans Target Time Window (Fenêtre horaire cible), un nouvel incident est créé si la relation spatiale ou l’expression attributaire est satisfaite.	Booléen

Couche en sortie

La couche en sortie comporte la structure des entités entrantes ainsi que les champs ci-dessous :

Nom du champ	Description	Type de champ
IncidentID	Identifiant unique de l’incident.	Chaîne
IncidentStatus	Statut actuel de l’incident. Le statut peut avoir pour valeur Started (Démarré), Ongoing (En cours) ou Ended (Terminé).	Chaîne
IncidentDuration	Durée en millisecondes pendant laquelle l’incident est ouvert.	Entier