Points vers lignes (Gestion des données)

Synthèse

Crée des entités linéaires à partir de points.

Illustration

Illustration de l’outil Points vers lignes

Utilisation

  • Les entités linéaires ne sont écrites en sortie que si la ligne contient deux ou plusieurs sommets.

  • Si un champ est spécifié comme valeur du paramètre Champ de ligne, les entités linéaires ne sont construites qu’avec des points de la valeur unique du champ. Le champ est inclus dans la classe d’entités en sortie.

  • Si un champ est spécifié comme valeur du paramètre Champ de tri, les points sont triés dans l’ordre croissant du champ.

  • Vous pouvez créer des polygones à partir de points en entrée en cochant d’abord le paramètre Fermer la ligne pour créer des entités linéaires fermées. Utilisez ensuite la classe d’entités linéaires en sortie comme entrée de l’outil Entité vers polygone pour créer des entités surfaciques.

  • Le paramètre Méthode de construction de ligne indique comment les entités linéaires seront construites. Vous pouvez créer des entités linéaires en connectant des points de manière continue ou en connectant deux points consécutifs en cours de tri. Par exemple, si l’entrée possède trois points ayant une valeur Champ de ligne égale à A et que quatre points possèdent une valeur Champ de ligne égale à B, les options génèrent les comportements suivants :

    • Construire une ligne continue : deux lignes en sortie, une présentant deux segments et l’autre trois segments, sont créées. Si le paramètre Fermer la ligne est coché, un segment supplémentaire connectant le dernier point au point de départ de chaque entité linéaire est ajouté pour former une ligne fermée.
    • Construire une ligne à deux points : cinq lignes en sortie, chacune entre des points consécutifs possédant la même valeur Champ de ligne, sont créées. Si le paramètre Fermer la ligne est coché, des entités linéaires supplémentaires connectant le dernier point au point de départ de chaque ensemble de points en entrée ayant la même valeur Champ de ligne sont ajoutées pour former une forme fermée.

  • Le paramètre Source d’attribut vous permet d’indiquer si oui ou non ou comment les attributs des points en entrée spécifiés par le paramètre Transférer des champs sont transférés vers les lignes en sortie. Le paramètre Source d’attribut prend en charge les options suivantes :

    • Aucun : Aucun attribut n’est transféré.
    • À partir des points de départ et d’arrivée : Les attributs sont transférés à partir des points de départ et d’arrivée de chaque ligne. Les noms de champ en sortie et leurs alias sont précédés du préfixe START_ et END_, par exemple, START_FIELD1 (START_ALIAS1),END_FIELD1 (END_ALIAS1), etc.
    • À partir du point de départ : Les attributs sont transférés à partir du point de départ de chaque ligne.
    • À partir du point d’arrivée : Les attributs sont transférés à partir du point d’arrivée de chaque ligne.

  • Utilisez le paramètre Transférer des champs pour identifier les champs allant être transférés à partir de l’entrée. Les valeurs des champs seront transférées en fonction de la valeur du paramètre Source d’attribut. Si la valeur Aucun est spécifiée pour ce paramètre, aucun attribut n’est transféré.

Paramètres

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

Les entités ponctuelles utilisées pour construire les lignes.

Feature Layer
Classe d’entités en sortie

La classe d’entité linéaire qui sera créée à partir des points en entrée.

Feature Class
Champ de ligne
(Facultatif)

Le champ utilisé pour identifier les valeurs attributaires uniques afin que les entités linéaires puissent être construites avec des points ayant la même valeur.

Si aucun champ n’est spécifié, les lignes sont construites sans utiliser de valeurs attributaires uniques. Il s’agit de l’option par défaut.

Field
Champ de tri
(Facultatif)

Champ qui sera utilisé pour trier l’ordre des points.

Si aucun champ n’est spécifié, les points utilisés pour créer des entités linéaires en sortie sont triés dans l’ordre dans lequel ils sont trouvés. Il s’agit de l’option par défaut.

Field
Fermer la ligne
(Facultatif)

Spécifie si les entités linéaires en sortie sont fermées.

  • Sélectionné : Pour une ligne continue, un segment supplémentaire connectant le dernier point au premier point est inclus afin de former une ligne fermée. Pour les lignes à deux points, une entité linéaire supplémentaire connectant le dernier point au premier point est incluse afin de former une forme fermée.
  • Non sélectionné : Aucun segment ou aucune ligne supplémentaire ne sont créés pour former une ligne ou une forme fermée. Il s’agit de l’option par défaut.
Boolean
Méthode de construction de ligne
(Facultatif)

Spécifie la méthode utilisée pour construire les entités linéaires.

  • Construire une ligne continueLes entités linéaires sont créées en connectant des points de manière continue. Il s’agit de l’option par défaut.
  • Construire une ligne à deux pointsLes entités linéaires sont créées en connectant deux points consécutifs.
String
Source d’attribut
(Facultatif)

Indique comment les attributs spécifiés sont transférés.

  • AucunAucun attribut n’est transféré. Il s’agit de l’option par défaut.
  • Les points de départ et d’arrivéeLes attributs des points de départ et d’arrivée de la ligne sont transférés.
  • Point de départLes attributs du point de départ de la ligne sont transférés.
  • Point d’arrivéeLes attributs du point d’arrivée de la ligne sont transférés.
String
Transférer des champs
(Facultatif)

Les champs contenant les valeurs allant être transférées des points source vers les lignes en sortie. Si aucun champ n’est sélectionné, aucun attribut n’est transféré.

Si la valeur du paramètre Source d’attribut est définie sur Aucun, ce paramètre est inactif.

Field

arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
NomExplicationType de données
Input_Features

Les entités ponctuelles utilisées pour construire les lignes.

Feature Layer
Output_Feature_Class

La classe d’entité linéaire qui sera créée à partir des points en entrée.

Feature Class
Line_Field
(Facultatif)

Le champ utilisé pour identifier les valeurs attributaires uniques afin que les entités linéaires puissent être construites avec des points ayant la même valeur.

Si aucun champ n’est spécifié, les lignes sont construites sans utiliser de valeurs attributaires uniques. Il s’agit de l’option par défaut.

Field
Sort_Field
(Facultatif)

Champ qui sera utilisé pour trier l’ordre des points.

Si aucun champ n’est spécifié, les points utilisés pour créer des entités linéaires en sortie sont triés dans l’ordre dans lequel ils sont trouvés. Il s’agit de l’option par défaut.

Field
Close_Line
(Facultatif)

Spécifie si les entités linéaires en sortie sont fermées.

  • CLOSEPour une ligne continue, un segment supplémentaire connectant le dernier point au premier point est inclus afin de former une ligne fermée. Pour les lignes à deux points, une entité linéaire supplémentaire connectant le dernier point au premier point est incluse afin de former une forme fermée.
  • NO_CLOSEAucun segment ou aucune ligne supplémentaire ne sont créés pour former une ligne ou une forme fermée. Il s’agit de l’option par défaut.
Boolean
Line_Construction_Method
(Facultatif)

Spécifie la méthode utilisée pour construire les entités linéaires.

  • CONTINUOUSLes entités linéaires sont créées en connectant des points de manière continue. Il s’agit de l’option par défaut.
  • TWO_POINTLes entités linéaires sont créées en connectant deux points consécutifs.
String
Attribute_Source
(Facultatif)

Indique comment les attributs spécifiés sont transférés.

  • NONEAucun attribut n’est transféré. Il s’agit de l’option par défaut.
  • BOTH_ENDSLes attributs des points de départ et d’arrivée de la ligne sont transférés.
  • STARTLes attributs du point de départ de la ligne sont transférés.
  • ENDLes attributs du point d’arrivée de la ligne sont transférés.
String
Transfer_Fields
[Transfer_Fields,...]
(Facultatif)

Les champs contenant les valeurs allant être transférées des points source vers les lignes en sortie. Si aucun champ n’est sélectionné, aucun attribut n’est transféré.

Si la valeur du paramètre Attribute_Source est définie sur NONE, ce paramètre est désactivé.

Field

Exemple de code

Exemple d’utilisation de l’outil PointsToLine (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l'utilisation de la fonction PointsToLine en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
                              "C:/output/output.gdb/out_lines",
                              "ROUTE1", "MEASURE")
Exemple 2 d’utilisation de l’outil PointsToLine (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction PointsToLine.

# Description: Convert point features into line features

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inFeatures = "calibration_points.shp"
outFeatures = "C:/output/output.gdb/out_lines"
lineField = "ROUTE1"
sortField = "MEASURE"

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField)
Exemple 3 d’utilisation de l’outil PointsToLine (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction PointsToLine.

# Description: Convert point features into line features

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/points.gdb"

# Set local variables
inFeatures = "in_points"
outFeatures = "out_lines"
lineField = "lineID"
sortField = "stopID"
transFields = ["OBJECTID", "stopID"]

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField,
                              "NO_CLOSE", "TWO_POINT", "BOTH_ENDS", transFields)

Rubriques connexes