Entités vers points (Outils de gestion des données)
Résumé
Crée une classe d’entités contenant des points générés à partir des centroïdes des entités en entrée ou placés dans les entités en entrée.
Illustration
Utilisation
Les attributs des entités en entrée seront conservés dans la classe d’entités ponctuelles en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d’entités en sortie et défini sur les ID d’entité en entrée.
Entités en entrée, qui peuvent être de type multi-point, linéaire, surfacique ou annotation.
Feature Layer
Classe d’entités en sortie
Classe d’entités ponctuelles en sortie.
Feature Class
Intérieur
(Facultatif)
Indique si un point en sortie se trouve à l’intérieur de l’entité en entrée ou au centroïde de l’entité en entrée.
Si ce paramètre est désactivé, la localisation de chaque point en sortie est déterminée comme suit :
Multipoint features—Le point en sortie se trouve à la moyenne des coordonnées x et y de tous les points du multi-point.
Polyline features—Le point en sortie se trouve à la moyenne pondérée des coordonnées x et y des points médians de tous les segments de la ligne, la pondération d’un point médian donné étant la longueur du segment de ligne correspondant. Les (vraies) courbes paramétriques seront densifiées.
Polygon features—Le point en sortie se trouve au centre de gravité (centroïde) du polygone.
Si ce paramètre est activé, la localisation du point représentatif d’une entité en entrée est contenue dans l’entité en entrée et déterminée comme suit :
Multipoint features—Le point en sortie coïncide avec l’un des points du multi-point.
Polyline features—Le point en sortie se trouve sur la ligne. Si la ligne est une courbe paramétrique (vraie), le point en sortie sera au centre de la ligne.
Polygon features—Le point en sortie se trouve à l’intérieur du polygone.
Activé—Le point en sortie se trouve à l’intérieur de l’entité en entrée.
Décoché—Le point en sortie se trouve au centroïde de l’entité en entrée. Le point en sortie n’est pas toujours contenu dans l’entité en entrée. Il s’agit de l’option par défaut.
Entités en entrée, qui peuvent être de type multi-point, linéaire, surfacique ou annotation.
Feature Layer
out_feature_class
Classe d’entités ponctuelles en sortie.
Feature Class
point_location
(Facultatif)
Indique si un point en sortie se trouve à l’intérieur de l’entité en entrée ou au centroïde de l’entité en entrée.
Si ce paramètre est défini sur CENTROID, l’emplacement de chaque point en sortie est déterminé comme suit :
Multipoint features—Le point en sortie se trouve à la moyenne des coordonnées x et y de tous les points du multi-point.
Polyline features—Le point en sortie se trouve à la moyenne pondérée des coordonnées x et y des points médians de tous les segments de la ligne, la pondération d’un point médian donné étant la longueur du segment de ligne correspondant. Les (vraies) courbes paramétriques seront densifiées.
Polygon features—Le point en sortie se trouve au centre de gravité (centroïde) du polygone.
Si ce paramètre est défini sur INSIDE, l’emplacement du point représentatif d’une entité en entrée est contenu dans l’entité en entrée et déterminé comme suit :
Multipoint features—Le point en sortie coïncide avec l’un des points du multi-point.
Polyline features—Le point en sortie se trouve sur la ligne. Si la ligne est une courbe paramétrique (vraie), le point en sortie sera au centre de la ligne.
Polygon features—Le point en sortie se trouve à l’intérieur du polygone.
INSIDE—Le point en sortie se trouve à l’intérieur de l’entité en entrée.
CENTROID—Le point en sortie se trouve au centroïde de l’entité en entrée. Le point en sortie n’est pas toujours contenu dans l’entité en entrée. Il s’agit de l’option par défaut.
Boolean
Exemple de code
Exemple 1 d’utilisation de l’outil FeatureToPoint (fenêtre Python)
Le script de fenêtre Python ci-après illustre l’utilisation de la fonction FeatureToPoint en mode immédiat.
Exemple 2 d’utilisation de l’outil FeatureToPoint (script autonome)
Le script autonome ci-après est un exemple d’application simple de la fonction FeatureToPoint dans un environnement de scripts.
# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"
# Use FeatureToPoint function to find a point inside each park
arcpy.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")