Points vers segments de traces (AllSource)

Synthèse

Convertit les 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 du paramètre Entités en entrée se situent dans un système de coordonnées projetées, la valeur du paramètre Classe d’entités en sortie utilise le même système de coordonnées. Si les valeurs du paramètre Entités en entrée figurent dans un système de coordonnées géographiques, la valeur du paramètre Classe d’entités en sortie utilise la projection azimutale équidistante.

  • Si les valeurs du paramètre Entités en entrée ont des points ayant les mêmes coordonnées, un décalage d’un centimètre est ajouté aux secondes coordonnées 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 des Entités en entrée se trouvent dans un système Web Mercator projeté, des différences peuvent apparaître entre les valeurs des champs Shape Length et distance_m, car les valeurs du champ distance_m sont calculées avec une longueur géodésique et considérées comme plus précises.

  • Les champs suivants sont ajoutés à la valeur du paramètre Classe d’entités en sortie :

    Nom du champAlias du champDescription
    d_startStart Date

    Date et heure de début

    d_start_sStart Date (string)

    Date et heure de début en tant que chaîne ou texte

    d_endEnd Date

    Date et heure de fin

    d_end_sEnd Date (string)

    Date et heure de fin en tant que chaîne ou texte

    distance_mDistance (meters)

    Distance en mètres

    dt_secTime Delta (seconds)

    Différence de temps en secondes

    dt_minTime Delta (minutes)

    Différence de temps en minutes

    speed_mpsSpeed (meters per second)

    Facultatif. Vitesse en mètres par seconde

    speed_mphSpeed (miles per hour)

    Facultatif. Vitesse en miles par heure

    speed_kphSpeed (kilometers per hour)

    Facultatif. Vitesse en kilomètres par heure

    speed_kntSpeed (knots)

    Facultatif. Vitesse en nœuds

    oid_startStart ObjectID

    ID d’objet du point de début issu de Entités en entrée

    oid_endEnd ObjectID

    ID d’objet du point de fin issu de Entités en entrée

    group_idGroup Identification

    Facultatif. Valeurs de Champ de regroupement provenant du paramètre 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 champAlias du champDescription
    sequenceSequence Number

    Numéro de séquence du point dans la trace

    dateDate

    Champ Date/heure issu du paramètre Entités en entrée

    date_strDate (string)

    Champ Date/heure sous forme de chaîne

    oid_origOriginal ObjectID

    ID d’objet de l’entité d’origine issu du paramètre Entités en entrée

    group_idGroup Identification

    Facultatif. Valeurs de Champ de regroupement provenant du paramètre Entités en entrée

    Un fichier .lyrx en sortie (paramètres de couche et de symbologie) est créé pour les paramètres Classe d’entités en sortie et Points de la séquence en sortie. Ces fichiers sont créés dans l’espace de travail de dossier le plus proche contenant 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 sur les horodatages dupliqués) ne l’est pas, tous les horodatages dupliqués que la vitesse de piste mesure seront inf (infini) quelle que soit la distance entre les points.

  • Les valeurs nulles du paramètre Group Field (Champ de regroupement) ne seront 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.

Paramètres

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

Entités ponctuelles en tant que positions des points le long des pistes à créer.

Feature Layer
Champ Date

Champ de date à utiliser pour classer les points 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)

Un champ provenant du paramètre Entités en entrée permet de regrouper les points en entrée. Chaque groupe unique crée une piste distincte.

Field
Include Velocity Fields (Inclure les champs de vitesse)
(Facultatif)

Indique si les champs de vitesse en sortie (speed_mps, speed_mph, speed_kph et speed_knt) doivent être inclus dans la valeur du paramètre 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ésactivé : les champs de vitesse en sortie ne sont pas inclus dans la sortie.
Boolean
Output Sequence Points (Points de la séquence en sortie)
(Facultatif)

Entités ponctuelles en sortie. La sortie inclut un champ SEQUENCE contenant l’ordre à utiliser pour le chemin créé dans le paramètre Classe d’entités en sortie.

Feature Class
Erreur lors d’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 entraînent l’échec de l’outil. Il s’agit de l’option par défaut.
  • Désactivé : 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)

Indique si les champs sont transférés depuis la valeur du paramètre Entités en entrée vers la valeur du paramètre Points de la séquence en sortie.

  • Activé : les champs sont transférés depuis la valeur du paramètre Entités en entrée vers la valeur du paramètre Points de la séquence en sortie.
  • Désactivé : les champs ne sont pas transférés depuis la valeur du paramètre Entités en entrée vers la valeur du paramètre 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})
NomExplicationType 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)

Un champ provenant du paramètre in_features permet de regrouper les points en entrée. Chaque groupe unique crée une piste distincte.

Field
include_velocity
(Facultatif)

Indique si les champs de vitesse en sortie (speed_mps, speed_mph, speed_kph et speed_knt) doivent être inclus dans la valeur du paramètre out_feature_class.

  • INCLUDE_VELOCITYLes champs de vitesse en sortie sont inclus dans la sortie. Il s’agit de l’option par défaut.
  • EXCLUDE_VELOCITYLes 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 contenant 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_TIMESTAMPSLes horodatages dupliqués entraînent l’échec de l’outil. Il s’agit de l’option par défaut.
  • ALLOW_DUPLICATE_TIMESTAMPSLes horodatages dupliqués sont acceptés. La séquence d’horodatages dupliqués repose sur la valeur ObjectID.
Boolean
keep_input_fields
(Facultatif)

Indique si les champs sont transférés depuis la valeur du paramètre in_features vers la valeur du paramètre out_point_feature_class.

  • KEEP_INPUT_FIELDSLes champs sont transférés depuis la valeur du paramètre in_features vers la valeur du paramètre out_point_feature_class.
  • DISCARD_INPUT_FIELDSLes 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 de la fenêtre Python ci-dessous 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-dessous 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.