Points To Track Segments (Points en segments de piste) (Renseignement)

Synthèse

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 Azimutale équidistante mondiale.

  • Si les valeurs de paramètre Input Features (Entités en entrée) ont des points avec les mêmes coordonnées, un décalage de 1 centimètre est ajoutée à la seconde coordonnée y lors de la création de la ligne en entrée. 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 dans les 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 étant 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 champAlias du champDescription
    d_startStart Date

    Date et heure de début

    d_start_sStart Date (string)

    Date et heure de début sous forme de chaîne ou de texte

    d_endEnd Date

    Date et heure de fin

    d_end_sEnd Date (string)

    Date et heure de fin sous forme de chaîne ou de 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épart depuis Input Features (Entités en entrée)

    oid_endEnd ObjectID

    ID d’objet du point de fin depuis Input Features (Entités en entrée)

    group_idGroup Identification

    Facultatif. Valeurs Group Field (Champ Groupe) 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 champAlias du champDescription
    sequenceSequence Number

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

    dateDate

    Champ de date/heure du paramètre Input Features (Entités en entrée)

    date_strDate (string)

    Champ Datetime (Date/heure) sous forme de chaîne

    oid_origOriginal ObjectID

    ID d’objet de l’entité d’origine du paramètre Input Features (Entités en entrée)

    group_idGroup 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 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
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) utilisé pour regrouper les points en entrée. Chaque groupe unique crée une piste distincte.

Field
Champs Include Velocity (Inclure la vitesse)
(Facultatif)

Spécifie si les champs de vitesse (speed_mps, speed_mph, speed_kph et speed_knt) sont inclus dans la valeur de paramètre Output Feature Class (Classe d’entités en entrée).

  • 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
Points de séquence en sortie
(Facultatif)

Entités ponctuelles en sortie. La sortie inclut un champ SEQUENCE qui contient l’ordre dans lequel le chemin créé dans le paramètre Output Feature Class (Classe d’entités en sortie) sera utilisé.

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

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 séquence en sortie).
  • Désactivé : 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 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

Le champ de date est utilisé 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 utilisé 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 de 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 qui contient l’ordre dans lequel le chemin créé dans le paramètre out_feature_class sera utilisé.

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 sont à l’origine de la défaillance 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)

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_FIELDSLes champs sont transférés de la valeur de paramètre in_features à la valeur de 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 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 PointsToTrackSegmentsdans 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.