Résumé
Extrait les identifiants uniques qui se déplacent dans l’espace et dans le temps à des intervalles définis par l’utilisateur dans un jeu de données de traces de points.
Utilisation
L’outil identifie les identifiants uniques issus des entités en entrée qui se déplacent dans un intervalle de distance et de temps spécifié. Les entités en entrée doivent être temporelles.
Pour savoir comment activer le temps sur un jeu de données, reportez-vous à la rubrique Définir les propriétés de temps des données.
Lorsque vous sélectionnez un champ à utiliser comme identifiant unique, choisissez un champ contenant des nombres entiers ou du texte. Cela permettra un regroupement plus efficace des entités et renverra une sortie optimale.
Des intervalles de distance et de temps plus courts sont plus rapides à traiter. Par exemple, une différence de temps de 10 minutes et une séparation spatiale de 100 mètres seront traitées beaucoup plus rapidement qu’une différence de temps d’une heure et une séparation spatiale d’un kilomètre.
Les entités en sortie représentent les emplacements des entités covoyageuses. Deux champs seront ajoutés aux entités en sortie pour indiquer la séparation temporelle et spatiale entre le voyageur et le covoyageur potentiel, en plus des autres champs descriptifs.
Les entités en sortie incluent les champs suivants :
- traveler_id : identifiant unique de l’entité voyageuse. Il s’agit de l’identifiant avec lequel l’entité covoyageuse se déplaçait. Il peut être considéré comme l’entité source.
- cotraveler_id : identifiant unique de l’entité covoyageuse. Il s’agit de l’identifiant qui voyageait avec l’entité voyageuse. Il peut être considéré comme l’entité cible.
- X : coordonnée x de l’entité voyageuse. La coordonnée sera exprimée dans les unités de projection des entités en entrée.
- Y : coordonnée y de l’entité voyageuse. La coordonnée sera exprimée dans les unités de projection des entités en entrée.
- X_cotraveler : coordonnée x de l’entité covoyageuse. La coordonnée sera exprimée dans les unités de projection des entités en entrée.
- Y_cotraveler : coordonnée y de l’entité covoyageuse. La coordonnée sera exprimée dans les unités de projection des entités en entrée.
- traveler_time : date et heure de l’entité voyageuse.
- cotraveler_time : date et heure de l’entité covoyageuse.
- distance_difference : distance séparant l’entité identifiée dans les entités en entrée et le covoyageur évalué. La distance sera exprimée dans les unités linéaires des entités en entrée.
- time_difference : séparation temporelle entre l’entité identifiée dans les entités en entrée et le covoyageur évalué. La différence de temps est exprimée en secondes. Elle peut être positive ou négative. Les nombres positifs indiquent que les entités sont identifiées après le voyageur. Les nombres négatifs indiquent que les entités sont identifiées avant le voyageur.
- cotraveling_pair_id : un identifiant unique généré pour chaque paire unique d’entités covoyageuses. Deux entités covoyageuses (A, B) partageront le même cotraveling_pair_id à la fois pour (A, B) et (B, A).
Une table de synthèse facultative peut être créée à partir des entités en sortie. La table de synthèse comprendra les champs suivants :
- unique_pair_id : un identifiant unique généré pour chaque paire unique d’entités covoyageuses. Deux entités covoyageuses (A, B) partageront le même unique_pair_id à la fois pour (A, B) et (B, A).
- traveler_id : identifiant unique de l’entité voyageuse. Il s’agit de l’identifiant avec lequel l’entité covoyageuse se déplaçait. Il peut être considéré comme l’entité source.
- cotraveler_id : identifiant unique de l’entité covoyageuse. Il s’agit de l’identifiant qui voyageait avec l’entité voyageuse. Il peut être considéré comme l’entité cible.
- time_diff_max : la séparation temporelle maximum entre le voyageur et le covoyageur.
- time_diff_min : la séparation temporelle minimum entre le voyageur et le covoyageur.
- time_diff_mean : la séparation temporelle moyenne entre le voyageur et le covoyageur.
- time_diff_std : l’écart type de séparation temporelle entre le voyageur et le covoyageur.
- dist_diff_max : la distance de séparation maximum entre le voyageur et le covoyageur.
- dist_diff_min : la distance de séparation minimum entre le voyageur et le covoyageur.
- dist_diff_mean : la distance de séparation moyenne entre le voyageur et le covoyageur.
- dist_diff_std : l’écart type de la distance de séparation entre le voyageur et le covoyageur.
- unique_pair_id_count : le nombre total d’entités identifiées comme covoyageuses pour le unique_pair_id.
Syntaxe
arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table})| Paramètre | Explication | Type de données |
input_features | Entités avec le temps activé représentant l’identifiant connu qui sera utilisé pour rechercher des covoyageurs. Les identifiants uniques, les horodatages et les emplacements seront transférés vers la couche en sortie pour aider au calcul de la séparation temporelle et spatiale. | Feature Layer |
out_featureclass | Classe d’entités en sortie qui contient les segments de tracés de points identifiés comme covoyageurs des couches source en entrée. Cette classe d’entités inclut la source à laquelle le segment de tracé de point est associé. La séparation temporelle et spatiale est calculée pour chaque entité de tracé de point. | Feature Class |
id_field | Champ des entités en entrée utilisé pour obtenir les identifiants uniques par tracé de points. Ce champ sera copié dans la classe d’entités en sortie. | Field |
search_distance (Facultatif) | Distance maximale qui peut séparer les entités avant qu’elles ne soient plus considérées comme covoyageuses. La valeur par défaut est 100 pieds (30,5 mètres). | Linear Unit |
time_difference (Facultatif) | Différence de temps maximale qui peut séparer les entités avant qu’elles ne soient plus considérées comme covoyageuses. La valeur par défaut est 10 secondes. | Time Unit |
input_type (Facultatif) | Spécifie si les covoyageurs seront identifiés dans une classe d'entités ou entre deux.
| String |
secondary_features (Facultatif) | Classe d’entités secondaires pour identifier les covoyageurs. Les covoyageurs potentiels seront évalués à l’aide des éléments suivants :
| Feature Layer |
secondary_id_field (Facultatif) | Champ des Secondary Features (Entités secondaires) utilisé pour obtenir les identifiants uniques par tracé de points. Ce champ sera copié dans la classe d’entités en sortie. | Field |
create_summary_table (Facultatif) | Indique s'il convient de créer une table de synthèse en sortie.
| Boolean |
out_summary_table (Facultatif) | Table en sortie dans laquelle sont stockées les informations de synthèse. Cette option n’est activée que si la valeur du paramètre Create Summary Table (Créer une table de synthèse) est définie sur True (Vrai). | Table |
Exemple de code
Le script Python ci-dessous illustre l'utilisation de la fonction FindCotravelers dans un script autonome sans la table de synthèse en sortie et une classe d'entités en entrée.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field)Le script Python ci-dessous illustre l'utilisation de la fonction FindCotravelers dans un script autonome avec la table de synthèse en sortie et deux classes d'entités en entrée.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field_name,
search_distance,
time_difference,
"TWO_FEATURECLASSES",
unknown_features,
unknown_id_field,
summary_table,
summary_table_name)Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?