Points To Track Segments (Points en segments de piste) (Outils AllSource)

Résumé

Convertit des séquences temporelles de données ponctuelles en entrée, telles que des points GPS, en une série de chemins en sortie.

Utilisation

Si les valeurs de paramètre Input Features (Entités en entrée) se situent dans un système de coordonnées projetées, le paramètre Output Feature Class (Classe d’entités en sortie) utilise le même système de coordonnées. Si les valeurs de paramètre Input Features (Entités en entrée) se situent dans un système de coordonnées géographiques, la valeur de paramètre Output Feature Class (Classe d’entités en sortie) utilise World Azimuthal Equidistant.
Si les valeurs de paramètre Input Features (Entités en entrée) contiennent des points avec les mêmes coordonnées, un décalage d’un centimètre est ajouté à la seconde coordonnée y lors de la création de chaque ligne en sortie. En effet, le modèle géométrique ne permet pas de dupliquer les sommets dans une seule polyligne.
Si les points Input Features (Entités en entrée) sont projetés dans Web Mercator, il peut y avoir des écarts entre les valeurs des champs Shape Length et distance_m car les valeurs de champ distance_m sont calculées à l’aide d’une longueur géodésique et sont considérées comme plus précises.

Les champs suivants sont ajoutés à la valeur de paramètre Output Feature Class (Classe d’entités en sortie) :


Nom du champ	Alias du champ	Description
`d_start`	`Start Date`	Date et heure de début
`d_start_s`	`Start Date (string)`	Date et heure de début sous forme de chaîne ou de texte
`d_end`	`End Date`	Date et heure de fin
`d_end_s`	`End Date (string)`	Date et heure de fin sous forme de chaîne ou de texte
`distance_m`	`Distance (meters)`	Distance en mètres
`dt_sec`	`Time Delta (seconds)`	Différence de temps en secondes
`dt_min`	`Time Delta (minutes)`	Différence de temps en minutes
`speed_mps`	`Speed (meters per second)`	Facultatif. Vitesse en mètres par seconde
`speed_mph`	`Speed (miles per hour)`	Facultatif. Vitesse en miles par heure
`speed_kph`	`Speed (kilometers per hour)`	Facultatif. Vitesse en kilomètres par heure
`speed_knt`	`Speed (knots)`	Facultatif. Vitesse en nœuds
`oid_start`	`Start ObjectID`	ID d’objet du point de départ depuis Input Features (Entités en entrée)
`oid_end`	`End ObjectID`	ID d’objet du point de fin depuis Input Features (Entités en entrée)
`group_id`	`Group Identification`	Facultatif. Valeurs Group Field (Champ de regroupement) du paramètre Input Features (Entités en entrée)

Les champs suivants sont ajoutés à la valeur de paramètre Output Sequence Points (Points de séquence en sortie) :


Nom du champ	Alias du champ	Description
`sequence`	`Sequence Number`	Numéro de séquence de point dans la trace
`date`	`Date`	Champ de date/heure du paramètre Input Features (Entités en entrée)
`date_str`	`Date (string)`	Champ Datetime (Date/heure) sous forme de chaîne
`oid_orig`	`Original ObjectID`	ID d’objet de l’entité d’origine du paramètre Input Features (Entités en entrée)
`group_id`	`Group Identification`	Facultatif. Valeurs Group Field (Champ de regroupement) du paramètre Input Features (Entités en entrée)

Un fichier .lyrx en sortie (paramètres de la couche et de symbologie) est créé pour les paramètres Output Feature Class (Classe d’entités en sortie) et Output Sequence Points (Points de séquence en sortie). Ces fichiers sont créés dans l’espace de travail de dossier le plus proche qui contient les entités en sortie.

Si le paramètre Include Velocity (Inclure la vitesse) est coché et que le paramètre Error On Duplicate Timestamps (Erreur lors d’horodatages dupliqués) ne l’est pas, les horodatages dupliqués mesurés par la vitesse de piste ont la valeur inf (infini), quelle que soit la distance entre les points.
Les valeurs nulles du paramètre Group Field (Champ de regroupement) ne sont pas traitées. Les valeurs nulles ne peuvent pas être triées et groupées dans le cadre du traitement des points en entrée, ces lignes étant donc ignorées. Pour éviter ce problème, utilisez l’ingénierie des données ou l’outil Calculate Field (Calculer un champ) pour convertir les valeurs nulles en valeurs valides avant d’utiliser cet outil.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Entités ponctuelles en tant que positions des points le long des pistes à créer.	Feature Layer
Date Field	Champ de date à utiliser pour classer les points Input Features (Entités en entrée).	Field
Classe d’entités en sortie	Entités linéaires de piste en sortie.	Feature Class
Champ de regroupement (Facultatif)	Champ du paramètre Input Features (Entités en entrée) à utiliser pour regrouper les points en entrée. Chaque groupe unique crée une piste distincte.	Field
Champs Include Velocity (Inclure la vitesse) (Facultatif)	Indique si les champs de vitesse en sortie (speed_mps, `speed_mph`, `speed_kph` et `speed_knt`) sont inclus dans la valeur du paramètre Output Feature Class (Classe d’entités en sortie). Activé—Les champs de vitesse en sortie sont inclus dans la sortie. Il s’agit de l’option par défaut. Décoché—Les champs de vitesse en sortie ne sont pas inclus dans la sortie.	Boolean
Points de séquence en sortie (Facultatif)	Entités ponctuelles en sortie. La sortie inclut un champ `SEQUENCE`, qui contient l’ordre à utiliser pour le chemin créé dans le paramètre Output Feature Class (Classe d’entités en sortie).	Feature Class
Erreur sur les horodatages dupliqués (Facultatif)	Spécifie si les horodatages dupliqués dans la valeur de paramètre Date Field (Champ de date) ou dans chaque groupe de la valeur de paramètre Group Field (Champ de regroupement) sont acceptés ou sont à l’origine de la défaillance de l’outil. Activé—Les horodatages dupliqués sont à l’origine de la défaillance de l’outil. Il s’agit de l’option par défaut. Décoché—Les horodatages dupliqués sont acceptés. La séquence d’horodatages dupliqués repose sur la valeur `ObjectID`.	Boolean
Conserver les champs en entrée (Facultatif)	Spécifie si les champs sont transférés de la valeur de paramètre Input Features (Entités en entrée) à la valeur de paramètre Output Sequence Points (Points de séquence en sortie). Activé—Les champs sont transférés de la valeur de paramètre Input Features (Entités en entrée) à la valeur de paramètre Output Sequence Points (Points de la séquence en sortie). Décoché—Les champs ne sont pas transférés de la valeur de paramètre Input Features (Entités en entrée) à la valeur de paramètre Output Sequence Points (Points de la séquence en sortie). Il s’agit de l’option par défaut.	Boolean

arcpy.intelligence.PointsToTrackSegments(in_features, date_field, out_feature_class, {group_field}, {include_velocity}, {out_point_feature_class}, {error_on_duplicate_timestamps}, {keep_input_fields})

Nom	Explication	Type de données
in_features	Entités ponctuelles en tant que positions des points le long des pistes à créer.	Feature Layer
date_field	Champ de date à utiliser pour classer les points `in_features`.	Field
out_feature_class	Entités linéaires de piste en sortie.	Feature Class
group_field (Facultatif)	Champ du paramètre `in_features` à utiliser pour regrouper les points en entrée. Chaque groupe unique crée une piste distincte.	Field
include_velocity (Facultatif)	Spécifie si les champs de vitesse (speed_mps, `speed_mph`, `speed_kph` et `speed_knt`) sont inclus dans la valeur du paramètre `out_feature_class`. `INCLUDE_VELOCITY`—Les champs de vitesse en sortie sont inclus dans la sortie. Il s’agit de l’option par défaut. `EXCLUDE_VELOCITY`—Les champs de vitesse en sortie ne sont pas inclus dans la sortie.	Boolean
out_point_feature_class (Facultatif)	Entités ponctuelles en sortie. La sortie inclut un champ `SEQUENCE`, qui contient l’ordre à utiliser pour le chemin créé dans le paramètre `out_feature_class`.	Feature Class
error_on_duplicate_timestamps (Facultatif)	Spécifie si les horodatages dupliqués dans la valeur de paramètre `date_field` ou dans chaque groupe de la valeur de paramètre `group_field` sont acceptés ou sont à l’origine de la défaillance de l’outil. `ERROR_DUPLICATE_TIMESTAMPS`—Les horodatages dupliqués sont à l’origine de la défaillance de l’outil. Il s’agit de l’option par défaut. `ALLOW_DUPLICATE_TIMESTAMPS`—Les horodatages dupliqués sont acceptés. La séquence d’horodatages dupliqués repose sur la valeur `ObjectID`.	Boolean
keep_input_fields (Facultatif)	Spécifie si les champs sont transférés de la valeur de paramètre `in_features` à la valeur de paramètre `out_point_feature_class`. `KEEP_INPUT_FIELDS`—Les champs sont transférés de la valeur de paramètre `in_features` à la valeur de paramètre `out_point_feature_class`. `DISCARD_INPUT_FIELDS`—Les champs ne sont pas transférés de la valeur de paramètre `in_features` à la valeur de paramètre `out_point_feature_class`. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction PointsToTrackSegments (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction PointsToTrackSegments en mode immédiat :

import arcpy

arcpy.intelligence.PointsToTrackSegments("C:/data/mtracks.gdb/source_pts",
                                         "DateTime",
                                         "C:/data/mtracks.gdb/tracklines",
                                         "Name",
                                         "INCLUDE_VELOCITY",
                                         "C:/data/mtracks.gdb/seqpoints")

Exemple 2 d’utilisation de la fonction PointsToTrackSegments (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction PointsToTrackSegments dans un script autonome :

# Name: PointsToTrackSegments_Example2.py
# Description: Convert points to track segments.

# Import system modules
import arcpy

# Set local variables
in_features = "C:/data/mtracks.gdb/source_pts"
date_time = "DateTime"
out_feature_class = "C:/data/mtracks.gdb/tracklines"
group_field = "Name"
out_points = "C:/data/mtracks.gdb/seqpoints"

# Run PointsToTrackSegments
arcpy.intelligence.PointsToTrackSegments(in_features, date_time,
                                         out_feature_class, group_field,
                                         "INCLUDE_VELOCITY", out_points)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence