Entités vers points (Gestion des données)

Disponible avec une licence Advanced.

Résumé

Crée une classe d'entités contenant des points générée depuis les emplacements représentatifs des entités en entrée.

Illustration

Illustration de la fonction 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.

  • Si l’option Inside (Intérieur) de la boîte de dialogue est désactivée (le paramètre point_location est défini sur CENTROID), l’emplacement du point en sortie est déterminé comme suit :

    • Pour une entité multi-points en entrée : le point en sortie se trouvera à la moyenne des coordonnées x et y de tous les points de l'entité multi-points.
    • Pour une entité linéaire en entrée : le point en sortie se trouvera à la moyenne pondérée des coordonnées x et y des centres de tous les segments de ligne dans l'entité linéaire, la pondération d'un centre donné étant la longueur du segment de ligne de correspondant. Les courbes paramétriques (vraies) sont densifiées en premier.
    • Pour une entité surfacique en entrée : le point en sortie se trouvera au centre de gravité (centroïde) du polygone.

    Si l’option Inside (Intérieur) de la boîte de dialogue est activée (le paramètre point_location est défini sur INSIDE), l’emplacement du point représentatif d’une entité en entrée sera contenu par l’entité en entrée et déterminé comme suit :

    • Pour des multi-points en entrée : le point en sortie sera coïncident avec l'un des points du multi-points.
    • Pour une ligne en entrée : le point en sortie sera sur la ligne. Si la ligne est une courbe paramétrique (vraie), le point en sortie sera au centre de la ligne.
    • Pour un polygone en entrée : le point en sortie sera à l'intérieur du polygone.

Syntaxe

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

Entités en entrée qui peuvent être multi-points, linéaire, surfacique ou annotation.

Feature Layer
out_feature_class

Classe d'entités points en sortie.

Feature Class
point_location
(Facultatif)

Spécifie si des centres représentatifs d'entités en entrée ou des emplacements contenus par les entités en entrée doivent être utilisés comme emplacements de point en sortie.

  • CENTROIDUtilise le centre représentatif d'une entité en entrée comme son emplacement de point en sortie. Cet emplacement de point n'est pas toujours contenu par l'entité en entrée. Il s’agit de l’option par défaut.
  • INSIDEUtilise un emplacement contenu par une entité en entrée comme emplacement de point en sortie.
Boolean

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToPoint_management("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
Exemple 2 d’utilisation de l’outil FeatureToPoint (script autonome)

Le script autonome suivant dessous 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.FeatureToPoint_management(inFeatures, outFeatureClass, "INSIDE")

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes