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

Synthèse

Crée une classe d'entités contenant des polygones générée à partir de surfaces délimitées par des entités surfaciques or linéaires en entrée.

Illustration

Illustration de l'outil Entité vers polygone

Utilisation

  • Lorsqu’une ou plusieurs entités en entrée forment une zone fermée, une nouvelle entité surfacique est créée et saisie vers la classe d’entités en sortie. Les attributs en sortie varient en fonction des valeurs des paramètres Conserver les attributs et Étiqueter les entités.

  • Si plusieurs couches ou classes d'entités sont spécifiées dans la liste des entités en entrée, l'ordre des entrées dans la liste n'affecte pas le type d'entité en sortie, mais la référence spatiale de l'entrée supérieure de la boîte de dialogue de l'outil (première entrée dans Python) dans la liste est utilisée au cours du traitement et définie sur la sortie.

  • Les (vraies) courbes paramétriques des entités en entrée resteront de vraies courbes dans les polygones en sortie, même si elles sont fractionnées. Cela ne s'applique pas aux données des fichiers de formes.

  • Remarque :

    Il est recommandé de ne pas utiliser le paramètre Conserver les attributs, car il n’est plus pris en charge et ne fonctionne pas. Il est toutefois conservé pour la compatibilité descendante des scripts et des modèles. La structure attributaire en sortie et les valeurs de champ de certaines combinaisons en entrée peuvent être générées comme décrit ci-après, mais la plupart de manière involontaire.

    Si le paramètre Conserver les attributs est sélectionné, la structure attributaire en sortie et les valeurs de champ varient selon que les entités d’étiquette (points) sont fournies comme suit :

    • Si aucune valeur de paramètre Étiqueter les entités n'est fournie, la structure attributaire (noms de champ et propriétés, mais pas les valeurs de champ) de chaque entrée est conservée dans la sortie suivant l'ordre dans lequel elle apparaît dans la liste des entrées. Un nouveau champ, FID_xxx, dans lequel xxx représente le nom de classe d'entité source d'une entrée particulière, est ajouté à la sortie pour chaque entrée et défini sur la valeur -1. Tous les autres champs ont des valeurs égales à zéro ou Null.
    • Si une valeur de paramètre Étiqueter les entités est fournie, aucune structure attributaire en entrée n'est conservée dans la classe d'entités en sortie ; seuls les attributs des entités d'étiquette sont inclus dans la classe d'entités en sortie. Si un polygone en sortie contient une entité d'étiquette, il possède les valeurs de champ de cette entité d'étiquette. Si un polygone en sortie contient plusieurs entités d'étiquette, il possède les valeurs de champ de l'un d'eux ; sinon, il possède des valeurs de champ égales à zéro ou nulles.
  • Si l’option Conserver les attributs est décochée, les structures attributaires en entrée sont écrites en sortie, mais les valeurs attributaires restent vides. Si vous ne voulez pas d'attributs dans la classe d'entités surfaciques en sortie, fournissez une classe d'entités ponctuelles sans attribut pour le paramètre Étiqueter les entités.

  • Si les entités surfaciques en entrée sont réparties en plus petites entités surfaciques en sortie, vous pouvez utiliser l'outil Identité pour transférer les attributs des entités surfaciques en entrée aux entités surfaciques résultantes.

  • Afin d’améliorer les performances et l’évolutivité, cet outil utilise un processus de tuilage pour la gestion des jeux de données très volumineux. Pour plus de détails, reportez-vous à la rubrique Traitement tuilé de jeux de données volumineux.

Paramètres

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

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

Feature Layer
Classe d’entités en sortie

Classe d'entités surfaciques en sortie.

Feature Class
Tolérance XY
(Facultatif)

La distance minimale séparant toutes les coordonnées d'entité, ainsi que la distance de déplacement possible d'une coordonnée sur X ou Y (ou les deux) au cours du calcul spatial. La tolérance XY par défaut est de 0,001 mètre ou son équivalent dans les unités d'entité.

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
Conserver les attributs
(Facultatif)
Remarque :

Ce paramètre n’est plus pris en charge. Le paramètre est conservé pour la compatibilité descendante des scripts et des modèles. Pour en savoir plus, consultez la section Utilisation.

Boolean
Etiqueter les entités
(Facultatif)

Entités ponctuelles en entrée facultatives qui contiennent les attributs à transférer vers les entités surfaciques en sortie.

Feature Layer

arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})
NomExplicationType de données
in_features
[in_features,...]

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

Feature Layer
out_feature_class

Classe d'entités surfaciques en sortie.

Feature Class
cluster_tolerance
(Facultatif)

La distance minimale séparant toutes les coordonnées d'entité, ainsi que la distance de déplacement possible d'une coordonnée sur X ou Y (ou les deux) au cours du calcul spatial. La tolérance XY par défaut est de 0,001 mètre ou son équivalent dans les unités d'entité.

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
attributes
(Facultatif)
Remarque :

Ce paramètre n’est plus pris en charge. Le paramètre est conservé pour la compatibilité descendante des scripts et des modèles. Pour en savoir plus, consultez la section Utilisation.

Boolean
label_features
(Facultatif)

Entités ponctuelles en entrée facultatives qui contiennent les attributs à transférer vers les entités surfaciques en sortie.

Feature Layer

Exemple de code

Exemple 1 de FeatureToPolygon (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction FeatureToPolygon en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPolygon(["mainroads.shp","streets.shp"],
                                  "c:/output/output.gdb/streetblocks",
                                  "", "NO_ATTRIBUTES")
Exemple 2 de FeatureToPolygon (script autonome)

Le script autonome ci-après est un exemple d’application simple de la fonction FeatureToPolygon dans un environnement de scripts.

# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
#              from park boundaries and rivers.

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/parks_analysis.gdb"

# Set local parameters
inFeatures = ["park_boundaries", "rivers"]
outFeatureClass = "c:/output/output.gdb/habitat_areas"
clusTol = "0.05 Meters"

# Use the FeatureToPolygon function to form new areas
arcpy.management.FeatureToPolygon(inFeatures, outFeatureClass, clusTol,
                                  "NO_ATTRIBUTES")

Rubriques connexes