Comparer des zones (Renseignement)

Synthèse

Compare les traces ponctuelles de mouvement sur plusieurs zones d’intérêt connues.

Utilisation

  • Cet outil permet de rechercher le nombre d’identités de traces de points uniques dans des zones connues. Pour comparer des zones dans l’espace et dans le temps, vous devez activer le temps pour les valeurs (couches) des paramètres Input Point Features (Entités ponctuelles en entrée) et Input Area Features (Entités surfaciques en entrée).

    Plus d’informations sur la définition des propriétés temporelles des données

  • Si le paramètre Relationship (Relation) est défini sur Location and Time (Localisation et données temporelles), vous pouvez indiquer certaines relations temporelles dans le paramètre Time Relationship (Relation temporelle). Vous pouvez utiliser l’option Near (Proche), Near before (À proximité avant) ou Near after (À proximité après) pour filtrer les entités selon une valeur indiquée dans le paramètre Time Difference (Différence de temps).

  • Le paramètre Output Feature Class (Classe d’entités en sortie) renvoie une classe d’entités surfaciques avec les géométries en entrée et les identifiants uniques issus des paramètres Point Features Name Field (Champ Nom des entités ponctuelles) et Area Features Name Field (Champ Nom des entités surfaciques).

  • Si le paramètre Include Time Statistics (Inclure les statistiques temporelles) est activé, les champs suivants sont ajoutés au paramètre Output Feature Class (Classe d’entités en sortie) :

    • enter_time- La première instance temporelle observée de la trace spécifiée dans l’entité surfacique donnée
    • exit_time- La dernière instance temporelle observée de la trace spécifiée dans l’entité surfacique donnée
    • duration- La durée en secondes entre la première heure observée et la dernière heure observée de la trace spécifiée dans l’entité surfacique donnée

Paramètres

ÉtiquetteExplicationType de données
Entités ponctuelles en entrée

Entités ponctuelles représentant les points de trace de mouvement. Il est possible d’activer le temps sur la couche.

Feature Layer
Input Area Features (Entités surfaciques en entrée)

Entités surfaciques représentant les zones d’intérêt qui seront utilisées pour identifier les identifiants uniques des points de trace de mouvement. Il est possible d’activer le temps sur la couche.

Feature Layer
Classe d’entités en sortie

Classe d’entités de la zone en sortie. La sortie contient une copie de la géométrie Entités surfaciques en entrée et les identifiants uniques des paramètres Champ Nom des entités surfaciques et Champ Nom des entités ponctuelles.

Si le temps est activé pour les deux valeurs de paramètre Input Point Features (Entités ponctuelles en entrée) et Input Area Features (Entités surfaciques en entrée) et que Relationship (Relation) est défini sur Location and Time (Localisation et données temporelles), seules les entités correspondant à la géométrie et à la période sont renvoyées.

Feature Layer
Point Features Name Field (Champ Nom des entités ponctuelles)

Champ contenant les identifiants uniques des points de trace de mouvement. Le champ peut contenir un nombre ou une chaîne.

Field
Area Features Name Field (Champ Nom des entités surfaciques)

Champ contenant les identifiants uniques des zones d’intérêt. Le champ peut contenir un nombre ou une chaîne.

Field
Relation

Spécifie la relation entre les entrées.

  • Emplacement uniquementLes entités ponctuelles et surfaciques sont évaluées en fonction de la co-occurrence spatiale.
  • Location and Time (Localisation et données temporelles)Les entités ponctuelles et surfaciques sont évaluées en fonction de la co-occurrence spatiale et temporelle.
String
Time Difference (Différence de temps)
(Facultatif)

Durée autorisée entre les valeurs de paramètre Input Point Features (Entités ponctuelles en entrée) et Input Area Features (Entités surfaciques en entrée) avant qu’une relation spatiale soit considérée comme non valide. Ce paramètre est activé lorsque le paramètre Relationship (Relation) est défini sur Location and Time (Localisation et données temporelles) et que le temps est activé pour les deux entrées.

Time Unit
Time Relationship (Relation temporelle)
(Facultatif)

Spécifie la relation temporelle entre les valeurs des paramètres Input Point Features (Entités ponctuelles en entrée) et Input Area Features (Entités surfaciques en entrée).

Ce paramètre est activé lorsque le paramètre Relationship (Relation) est défini sur Location and Time (Localisation et données temporelles) et que le temps est activé pour les deux entrées. Si l’option Near before (À proximité avant) ou Near after (À proximité après) est indiquée, seules les entités du paramètre Input Point Features (Entités ponctuelles en entrée) comprise dans la fenêtre horaire spécifiée sont évaluées en vue de leur inclusion dans le paramètre Output Feature Class (Classe d’entités en sortie).

  • ProcheLorsque les données temporelles de l’entité ponctuelle se situent dans une plage temporelle spécifiée à partir des données temporelles de l’entité surfacique, les données temporelles de l’entité ponctuelle sont proches des données temporelles de l’entité surfacique.
  • À proximité avantLorsque des données temporelles de l’entité ponctuelle se situent avant les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle précèdent de peu les données temporelles de l’entité surfacique.
  • À proximité aprèsLorsque des données temporelles de l’entité ponctuelle se situent après les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle suivent de peu les données temporelles de l’entité surfacique.
  • ProcheLorsque les données temporelles de l’entité ponctuelle se situent dans une plage temporelle spécifiée à partir des données temporelles de l’entité surfacique, les données temporelles de l’entité ponctuelle sont proches des données temporelles de l’entité surfacique.
  • À proximité avantLorsque des données temporelles de l’entité ponctuelle se situent avant les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle précèdent de peu les données temporelles de l’entité surfacique.
  • À proximité aprèsLorsque des données temporelles de l’entité ponctuelle se situent après les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle suivent de peu les données temporelles de l’entité surfacique.
String
Include Time Statistics (Inclure les statistiques temporelles)
(Facultatif)

Indique si des champs de statistiques temporelles sont ajoutés.

  • Include time statistics (Inclure les statistiques temporelles)Des champs de statistiques temporelles sont ajoutés à la sortie.
  • Exclude time statistics (Exclure les statistiques temporelles)Aucun champ de statistiques temporelles n’est ajouté à la sortie.
Boolean

arcpy.intelligence.CompareAreas(in_point_features, in_area_features, out_featureclass, point_id_field, area_id_field, relationship, {time_difference}, {time_relationship}, {include_time_statistics})
NomExplicationType de données
in_point_features

Entités ponctuelles représentant les points de trace de mouvement. Il est possible d’activer le temps sur la couche.

Feature Layer
in_area_features

Entités surfaciques représentant les zones d’intérêt qui seront utilisées pour identifier les identifiants uniques des points de trace de mouvement. Il est possible d’activer le temps sur la couche.

Feature Layer
out_featureclass

Classe d’entités de la zone en sortie. La sortie contient une copie de la géométrie in_area_features et les identifiants uniques issus des paramètres area_id_field et point_id_field.

Si le temps est activé pour les valeurs des deux paramètres in_point_features et in_area_features, et que relationship est défini sur LOCATION_TIME, seules les entités correspondant à la géométrie et à la période sont renvoyées.

Feature Layer
point_id_field

Champ contenant les identifiants uniques des points de trace de mouvement. Le champ peut contenir un nombre ou une chaîne.

Field
area_id_field

Champ contenant les identifiants uniques des zones d’intérêt. Le champ peut contenir un nombre ou une chaîne.

Field
relationship

Spécifie la relation entre les entrées.

  • LOCATION_ONLYLes entités ponctuelles et surfaciques sont évaluées en fonction de la co-occurrence spatiale.
  • LOCATION_TIMELes entités ponctuelles et surfaciques sont évaluées en fonction de la co-occurrence spatiale et temporelle.
String
time_difference
(Facultatif)

Durée autorisée entre les valeurs de paramètre in_point_features et in_area_features avant qu’une relation spatiale soit considérée comme non valide. Ce paramètre est activé lorsque le paramètre relationship est défini sur LOCATION_TIME et que le temps est activé pour les deux entrées.

Time Unit
time_relationship
(Facultatif)

Spécifie la relation temporelle entre les valeurs des paramètres in_point_features et in_area_features.

Ce paramètre est activé lorsque le paramètre relationship est défini sur LOCATION_TIME et que le temps est activé pour les deux entrées. Si l’option NEAR_BEFORE ou NEAR_AFTER est indiquée, seules les entités du paramètre in_point_features comprise dans la fenêtre horaire spécifiée sont évaluées en vue de leur inclusion dans le paramètre out_featureclass.

  • NEARLorsque les données temporelles de l’entité ponctuelle se situent dans une plage temporelle spécifiée à partir des données temporelles de l’entité surfacique, les données temporelles de l’entité ponctuelle sont proches des données temporelles de l’entité surfacique.
  • NEAR_BEFORELorsque des données temporelles de l’entité ponctuelle se situent avant les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle précèdent de peu les données temporelles de l’entité surfacique.
  • NEAR_AFTERLorsque des données temporelles de l’entité ponctuelle se situent après les données temporelles de l’entité surfacique mais sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles de l’entité ponctuelle suivent de peu les données temporelles de l’entité surfacique.
String
include_time_statistics
(Facultatif)

Indique si des champs de statistiques temporelles sont ajoutés.

  • TIME_STATISTICSDes champs de statistiques temporelles sont ajoutés à la sortie.
  • NO_TIME_STATISTICSAucun champ de statistiques temporelles n’est ajouté à la sortie.
Boolean

Exemple de code

Exemple d’utilisation de l’outil CompareAreas (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CompareAreas dans un script autonome.


# Name: CompareAreas.py
# Description: Identify unique movement point track identifiers in known areas of interest. 

# Import system modules 
import arcpy 

arcpy.env.workspace = "C:/data/Tracks.gdb"

# Set local variables 
point_features = "Movement_Points"
area_features = "Areas_Of_Interest"
out_features = "Compare_Areas"
point_id_field = "Created_By"
area_id_field = "Name"
relationship = "LOCATION_TIME"
time_difference = "2 Hours"

# Run tool
arcpy.intelligence.CompareAreas(point_features,
                                area_features,
                                out_features,
                                point_id_field,
                                area_id_field,
                                relationship,
                                time_difference)