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 des centroïdes des entités en entrée ou placés dans les entités en entrée.

Illustration

Illustration de l’outil Entité vers point

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.

Paramètres

ÉtiquetteExplicationType de données
Entités 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.

  • 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.
  • Coché : le point en sortie se trouve à l’intérieur de l’entité en entrée.

Si le paramètre Intérieur n’est pas coché, l’emplacement de chaque point en sortie est déterminé comme suit :

  • Entité multi-point : le point en sortie se trouve à la moyenne des coordonnées x et y de tous les points du multi-point.
  • Entités polylignes : 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.
  • Entités surfaciques : le point en sortie se trouve au centre de gravité (centroïde) du polygone.

Si le paramètre Intérieur est coché, l’emplacement du point représentatif d’une entité en entrée sera contenu dans l’entité en entrée et déterminé comme suit :

  • Entités multi-points : le point en sortie coïncide avec l’un des points du multi-point.
  • Entités polylignes : 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.
  • Entités surfaciques : le point en sortie se trouve à l’intérieur du polygone.

Boolean

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

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.

  • CENTROIDLe 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.
  • INSIDELe point en sortie se trouve à l’intérieur de l’entité en entrée.

Si le paramètre point_location est défini sur CENTROID, l’emplacement de chaque point en sortie est déterminé comme suit :

  • Entité multi-point : le point en sortie se trouve à la moyenne des coordonnées x et y de tous les points du multi-point.
  • Entités polylignes : 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.
  • Entités surfaciques : le point en sortie se trouve au centre de gravité (centroïde) du polygone.

Si le paramètre point_location est défini sur INSIDE, l’emplacement du point représentatif d’une entité en entrée sera contenu dans l’entité en entrée et déterminé comme suit :

  • Entités multi-points : le point en sortie coïncide avec l’un des points du multi-point.
  • Entités polylignes : 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.
  • Entités surfaciques : le point en sortie se trouve à l’intérieur du polygone.

Boolean

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
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")