Comparer des zones (Outils AllSource)

Résumé

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).

En savoir plus 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

Etiqueter	Explication	Type de données
Entités points 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 Input Area Features (Entités surfaciques en entrée) et les identifiants uniques des paramètres Area Features Name Field (Champ Nom des entités surfaciques) et Point Features Name Field (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 uniquement—Les 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 spécifié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). Proche—Lorsque 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 before (À proximité avant)—Lorsque 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 after (À proximité après)—Lorsque 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. Activé—Des champs de statistiques temporelles sont ajoutés à la sortie. Décoché—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})

Nom	Explication	Type 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_ONLY`—Les entités ponctuelles et surfaciques sont évaluées en fonction de la co-occurrence spatiale. `LOCATION_TIME`—Les 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 les deux entrées sont de type temporel. Si l’option `NEAR_BEFORE` ou `NEAR_AFTER` est spécifié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`. `NEAR`—Lorsque 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_BEFORE`—Lorsque 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_AFTER`—Lorsque 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_STATISTICS`—Des champs de statistiques temporelles sont ajoutés à la sortie. `NO_TIME_STATISTICS`—Aucun champ de statistiques temporelles n’est ajouté à la sortie.	Boolean

Exemple de code

Exemple d’utilisation de la fonction 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)

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant, Facteur de traitement parallèle

Informations de licence