Étiquette | Explication | Type 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.
| Boolean |
Méthode de construction de ligne (Facultatif) | Spécifie la méthode utilisée pour construire les entités linéaires.
| String |
Source d’attribut (Facultatif) | Indique comment les attributs spécifiés 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 |
Synthèse
Crée des entités linéaires à partir de points.
Illustration
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
arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
Nom | Explication | Type 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.
| Boolean |
Line_Construction_Method (Facultatif) | Spécifie la méthode utilisée pour construire les entités linéaires.
| String |
Attribute_Source (Facultatif) | Indique comment les attributs spécifiés 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
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")
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)
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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?