Disponible avec une licence Advanced.
Résumé
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
Utilisation
A l'endroit où une ou plusieurs entités en entrée forment une surface fermée, une nouvelle entité surfacique est construite et écrite dans la classe d'entités en sortie. Les attributs en sortie varient selon le paramétrage de l'option Conserver les attributs de la boîte de dialogue (paramètre attributs dans l'écriture de script) et de l'option Etiqueter les entités de la boîte de dialogue (paramètre label_features dans l'écriture de script).
Lorsque 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 l'écriture de script) dans la liste sera utilisée au cours du traitement et définie sur la sortie.
Les courbes paramétriques (vrai) des entités en entrée demeurent de véritables 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.
Si l'option Conserver les attributs de la boîte de dialogue est activée (le paramètre attributs est défini sur ATTRIBUTES dans l'écriture de script), la structure d'attributs en sortie et les valeurs de champ varient selon que les entités d'étiquette (points) sont indiquées des façons suivantes :
- Si aucune entité d'étiquette n'est indiquée, la structure attributaire (noms de champ et propriétés, pas valeurs de champ) de chaque entrée sera conservée dans la sortie dans l'ordre dans lequel elle apparaît dans la liste des entrées. Un nouveau champ, FID_xxx, où xxx est 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 les entités d'étiquette sont fournies, aucune des structures attributaires en entrée ne sera conservée dans la classe d'entités en sortie seuls les attributs des entités d'étiquette seront comprises dans la classe d'entités en sortie. Si un polygone en sortie contient une entité d'étiquette, il aura des valeurs de champ de cette entité d'étiquette ; Si un polygone en sortie contient plusieurs entités d'étiquette, il aura des valeurs de champ de l'un d'eux ; sinon, il aura des valeurs de champ égales à zéro ou nulles.
Si l'option Conserver les attributs de la boîte de dialogue est désactivée (le paramètre attributs est défini sur NO_ATTRIBUTES dans le script), les structures des attributs en entrée sont écrits dans la sortie, mais les valeurs attributaires sont vides. Si vous ne voulez pas d'attributs sur la classe d'entités surfaciques en sortie, fournissez une classe d'entités points qui n'a pas d'attributs pour le paramètre Etiqueter les entités.
Lorsque des entités surfaciques en entrée sont rompues en entités surfaciques en sortie plus petites, l'outil Identité peut permettre de transférer des attributs des entités surfaciques en entrée aux entités surfaciques résultantes.
Cet outil utilise un processus de tuilage pour la gestion des jeux de données très volumineux afin d'améliorer les performances et l'évolutivité. Pour plus de détails, reportez-vous à la rubrique Géotraitement sur jeux de données volumineux.
Syntaxe
FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})
Paramètre | Explication | Type 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é. | Linear unit |
attributes (Facultatif) | Indique s'il faut conserver la structure attributaire en entrée ou les attributs des entités d'étiquette dans la classe d'entités en sortie ou omettre les attributs en entrée dans la classe d'entités en sortie. Ce paramètre ne fonctionne pas. Il ne sera pas supprimé pour la compatibilité descendante des scripts ou modèles. La structure attributaire en sortie et les valeurs de champ de certaines combinaisons en entrée peuvent être produites comme décrit dans les notes d'utilisation, pour la plupart de façon involontaire.
| Boolean |
label_features (Facultatif) | Entités ponctuelles en entrée facultatives qui comprennent les attributs à transférer vers les entités surfaciques en sortie. | Feature Layer |
Exemple de code
Exemple 1 d'utilisation de l'outil FeatureToPolygon (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser la fonction FeatureToPolygon en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES", "")
Exemple 2 d'utilisation de l'outil FeatureToPolygon (script autonome)
Le script autonome suivant dessous 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.
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
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.FeatureToPolygon_management(inFeatures, outFeatureClass, clusTol,
"NO_ATTRIBUTES", "")
Environnements
- Espace de travail courant
- Espace de travail temporaire
- Valeur Z en sortie par défaut
- Résolution M
- Tolérance M
- Domaine M en sortie
- Domaine Z en sortie
- Système de coordonnées en sortie
- Etendue
- Valeurs M en sortie
- Valeurs Z en sortie
- Grille spatiale 1 en sortie
- Grille spatiale 2 en sortie
- Grille spatiale 3 en sortie
- Résolution XY
- Tolérance XY
- Résolution Z
- Tolérance Z
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui