Filter by Geometry (Filtrer par géométrie)

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

L’outil Filtrer par géométrie filtre les entités selon une relation spatiale avec les autres entités du même flux ou avec celles d’un autre flux ou jeu de données. Les entités que la relation spatiale évalue comme vraies sont conservées.

Exemples

Vous trouverez ci-dessous des exemples d’utilisation de l’outil Filtrer par géométrie :

• Une analyse en temps réel utilise l’outil Filtrer par géométrie pour conserver uniquement les enregistrements entrants d’un flux dans lequel la géométrie des entités intersecte un jeu de données surfacique des zones portuaires.
• Une analyse de Big Data ou en temps réel utilise l’outil Filtrer par géométrie pour conserver uniquement les entités dans lesquelles la géométrie des entités entre dans un jeu de données surfacique représentant des zones de service.
• Déterminez lorsque les navires d’un flux se trouvent dans une cellule d’intempéries en mouvement en provenance d’un autre flux.

Remarques sur l’utilisation

Lorsque vous utilisez l’outil Filtrer par géométrie, gardez à l’esprit les points suivants :

• L’outil permet de comparer la relation spatiale des entités avec les entités ponctuelles, linéaires ou surfaciques.
• L’outil évalue une relation spatiale définie entre les entités cibles et un jeu de données de jointure spécifié.
• Si une valeur de Spatial Relationship (Relation spatiale) est définie sur 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 répond à la condition de filtrage si elle se trouve à l’intérieur d’une entité de jointure (si la valeur Enter [Entrée] est sélectionnée) ou à l’extérieur de toutes les entités de jointure (si la valeur Exit [Sortie] est sélectionnée), malgré l’absence d’une entité cible antérieure à comparer à l’emplacement de l’entité cible active. Cette option est désactivée par défaut.
• Si la valeur du paramètre Spatial relationship (Relation spatiale) est définie sur Enter (Entrée) ou Exit (Sortie) dans une analyse en temps réel, l’outil fonctionne avec état. Cela lui permet de comparer les observations séquentielles. Par exemple, un changement d’état est détecté comme étant une condition actuelle différente de celle de l’observation précédente. Avec d’autres relations spatiales dans l’analyse en temps réel, l’outil n’a pas besoin de comparer les observations avec de précédentes observations ; il peut donc s’exécuter sans état, ce qui nécessite moins de ressources.
• Lorsque l’outil fonctionne avec état (valeur Enter [Entrée] ou Exit [Sortie] attribuée à Spatial Relationship [Relation spatiale]), le paramètre Target time window (Fenêtre horaire cible) est obligatoire. Ce paramètre doit être défini au minimum sur l’intervalle le plus long prévu entre des observations pour une trace donnée. 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 élevée, car une valeur trop basse entraînerait la suppression d’enregistrements du stockage d’entités avant l’arrivée de nouvelles observations. Cela signifie que les informations historiques seraient supprimées du stockage et que l’entité suivante serait traitée comme s’il s’agissait de l’observation initiale. En d’autres termes, les observations n’entreraient ni ne sortiraient jamais de l’outil Filtrer par géométrie, car l’analyse n’aurait pas connaissance de la précédente observation.
• Lorsqu’il fonctionne avec état, l’outil Filtrer par géométrie garde en mémoire l’état de l’observation active pour chaque ID de suivi. Lorsqu’une nouvelle observation est reçue, elle est comparée à l’observation active du même ID de suivi, si celle-ci existe. Si l’horodatage de la nouvelle observation est plus récent que celui de l’observation active dans le magasin d’état, l’observation active 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. Cela signifie que l’outil ne remplace pas l’observation active 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 pour cet ID de suivi sont comparées à l’observation active, laquelle est conservée dans le magasin d’état jusqu’à l’arrivée d’une nouvelle observation possédant un horodatage postérieur. L’outil enregistre un avertissement lorsque ceci se produit.
• Dans le geofencing dynamique, le paramètre Join Time Window (Fenêtre horaire de jointure) doit être défini. Si le flux de jointure ne comporte pas de champ balisé END_TIME et que la dernière observation connue pour une entité de jointure est postérieure à cette fenêtre, elle est supprimée de la mémoire de l’outil et n’est pas incluse dans l’analyse. Si le flux de jointure comporte un champ balisé END_TIME, l’entité obsolète est exclue du magasin de geofences en fonction de la valeur figurant dans le champ balisé END_TIME ou à la fermeture de la fenêtre horaire de jointure, selon l’événement qui se produit en premier. La relance d’une analyse en temps réel n’entraîne pas l’expiration des entités dans le magasin de geofences.

Paramètres

Les paramètres de l’outil Filtrer par géométrie sont les suivants :

Paramètre	Description	Type de données
Couche en entrée	Indique la couche qui est filtrée.	Entités
Couche de jointure	Indique la couche utilisée pour le traitement d’une relation spatiale.	Entités
Relation spatiale	Définit les critères utilisés pour filtrer spatialement les entités cibles. Les relations spatiales sont les suivantes : Disjoint : une géométrie n’en intersecte pas une autre. Enter (Entrée) : une géométrie franchit la limite d’une autre géométrie. Equals (Égal à) : deux géométries sont identiques du point de vue de la forme, de la taille et de la position. Exit (Sortie) : une géométrie sort de la limite d’une autre géométrie. Intersects (Intersecte) : une géométrie a une surface commune avec une autre géométrie. Near Geodesic (Géodésique proche) : une géométrie se trouve à une distance géodésique d’une autre géométrie sur la surface de la Terre. Near planar (Planaire proche) : distance entre deux géométries dans un plan cartésien bidimensionnel. Touches (Touche) : une géométrie touche l’autre géométrie. Within (Dans) : une géométrie est entièrement contenue dans l’autre géométrie. Remarque : Une entité cible doit satisfaire sa relation spatiale avec toutes les entités de jointure lorsque la valeur Disjoint ou Exit (Sortie) a été spécifiée et qu’il existe plusieurs entités de jointure. Pour toute autre relation spatiale, s'il existe plusieurs entités de jointure, une entité cible peut satisfaire sa relation spatiale avec toute entité de jointure individuelle.	Chaîne
Fenêtre horaire cible	Dans le cadre d’un fonctionnement avec état, ce paramètre doit être défini au minimum sur l’intervalle attendu le plus long entre les observations pour une trace donnée. Les observations plus anciennes sont supprimées de la mémoire dans le cadre de la gestion des ressources.	Chaîne
Fenêtre horaire de jointure	Fenêtre horaire pour le flux de jointure (geofencing dynamique). 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 marqué comme END_TIME, ce paramètre est facultatif.	Chaîne

Couche en sortie

L’outil Filtrer par géométrie ne modifie pas les entités entrantes. La couche en sortie contient les mêmes champs et les mêmes valeurs attributaires que les entités entrantes.