Sommets d’entités vers points (Gestion des données)

Synthèse

Crée une classe d’entités contenant des points générés à partir d’emplacements ou de sommets spécifiés des entités en entrée.

Illustration

Sommets d’entités vers points
Sommets d’entités vers points

Utilisation

  • Les attributs des entités en entrée seront conservés dans la classe d'entités points en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d'entités en sortie et défini sur les identifiants d'entité en entrée.

  • Pour les polygones ou les lignes multi-parties, chaque partie est traitée comme une ligne. Par conséquent, chaque partie possède ses propres points de début, de fin et de centre ainsi qu’un ou plusieurs éventuels points d’arc pendant.

  • Une courbe paramétrique (vraie) comporte uniquement des points de début et de fin et n’est pas densifiée.

  • Pour l’option du paramètre Type de point de la boîte de dialogue (paramètre point_location dans Python), un champ supplémentaire, DANGLE_LEN, qui comporte les valeurs de longueur d’arc pendant dans l’unité de l’entité, est ajouté à la classe des entités en sortie. Pour une ligne isolée, les deux points de fin sont des points d’arc pendant ; par conséquent, la longueur d’arc pendant correspond à la longueur de la ligne elle-même. Pour une ligne d’arc pendant qui intersecte une autre ligne à l’un de ses points de fin, la longueur d’arc pendant est mesurée entre le point de fin de l’arc pendant et l’intersection.

Paramètres

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

Entités en entrée qui peuvent être des lignes ou des polygones.

Feature Layer
Classe d’entités en sortie

Classe d’entités ponctuelles en sortie.

Feature Class
Type de point
(Facultatif)

Indique l’emplacement où un point en sortie est créé.

  • ALLUn point est créé à chaque sommet d’entité en entrée. Il s’agit de l’option par défaut.
  • MIDUn point est créé au centre, pas nécessairement un sommet, de chaque ligne en entrée ou limite de polygone.
  • STARTUn point est créé au point de début (premier sommet) de chaque entité en entrée.
  • ENDUn point est créé au point de fin (dernier sommet) de chaque entité en entrée.
  • BOTH_ENDSDeux points seront créés : un au point de début et un autre au point de fin de chaque entité en entrée.
  • DANGLEUn point d’arc pendant est créé pour tout point de début ou de fin d’une ligne en entrée, si ce point n’est pas connecté à une autre ligne à tout emplacement le long de cette ligne. Cette option ne s’applique pas à l’entrée de polygone.
String

arcpy.management.FeatureVerticesToPoints(in_features, out_feature_class, {point_location})
NomExplicationType de données
in_features

Entités en entrée qui peuvent être des lignes ou des polygones.

Feature Layer
out_feature_class

Classe d’entités ponctuelles en sortie.

Feature Class
point_location
(Facultatif)

Indique l’emplacement où un point en sortie est créé.

  • ALLUn point est créé à chaque sommet d’entité en entrée. Il s’agit de l’option par défaut.
  • MIDUn point est créé au centre, pas nécessairement un sommet, de chaque ligne en entrée ou limite de polygone.
  • STARTUn point est créé au point de début (premier sommet) de chaque entité en entrée.
  • ENDUn point est créé au point de fin (dernier sommet) de chaque entité en entrée.
  • BOTH_ENDSDeux points seront créés : un au point de début et un autre au point de fin de chaque entité en entrée.
  • DANGLEUn point d’arc pendant est créé pour tout point de début ou de fin d’une ligne en entrée, si ce point n’est pas connecté à une autre ligne à tout emplacement le long de cette ligne. Cette option ne s’applique pas à l’entrée de polygone.
String

Exemple de code

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

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

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureVerticesToPoints_management("parcels.shp",
                                         "c:/output/output.gdb/parcels_corner", 
                                         "ALL")
Exemple 2 d’utilisation de l’outil FeatureVerticesToPoints (script autonome)

Le script autonome suivant dessous est un exemple d’application simple de la fonction FeatureVerticesToPoints dans un environnement de scripts.

# Name: FeatureVerticesToPoints_Example2.py
# Description: Use FeatureVerticesToPoints function to get the mid-points
#              of input line features

 
# import system modules 
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
 
# Set local variables
inFeatures = "majorrds.shp"
outFeatureClass = "c:/output/output.gdb/majorrds_midpt"

# Execute FeatureVerticesToPoints
arcpy.FeatureVerticesToPoints_management(inFeatures, outFeatureClass, "MID")

Rubriques connexes