Mit der Advanced-Lizenz verfügbar.
Zusammenfassung
Erstellt eine Feature-Class mit Polygonen, die aus von Eingabe-Linien- oder -Polygon-Features umschlossenen Flächen generiert wurden.
Abbildung
Verwendung
Wenn ein oder mehrere Eingabe-Features eine geschlossene Fläche bilden, wird ein neues Polygon-Feature erstellt und in die Ausgabe-Feature-Class geschrieben. Die Ausgabeattribute unterscheiden sich abhängig von der Option Attribute beibehalten im Dialogfeld (dem Parameter attributes bei der Skripterstellung) und der Option Features beschriften im Dialogfeld (dem Parameter label_features bei der Skripterstellung).
Wenn mehrere Feature-Classes oder -Layer in der Liste der Eingabe-Features angegeben werden, wirkt sich die Reihenfolge der Einträge in der Liste nicht auf den Ausgabe-Feature-Typ aus, aber der Raumbezug des obersten Eintrags in der Liste im Werkzeugdialogfeld (der erste Eintrag bei der Skripterstellung) wird während der Verarbeitung verwendet und auf die Ausgabe festgelegt.
Parametrische (echte) Kurven in den Eingabe-Features bleiben in den Ausgabe-Polygonen echte Kurven, auch wenn sie geteilt werden. Dies gilt nicht für Shapefile-Daten.
Wenn die Option Attribute beibehalten im Dialogfeld aktiviert wird (bei der Skripterstellung wird der Parameter attributes auf ATTRIBUTES festgelegt), hängen das Ausgabe-Attributschema und die Feldwerte davon ab, ob die Label-Features (Punkte) folgendermaßen bereitgestellt werden:
- Wenn keine Label-Features bereitgestellt werden, werden die Attributschemas (Feldnamen und Eigenschaften, keine Feldwerte) aus allen Eingaben für die Ausgabe in der Reihenfolge beibehalten, in der sie in der Eingabeliste aufgeführt werden. Der Ausgabe für jeden Eingabeeintrag wird das neue Feld FID_xxx hinzugefügt und auf den Wert -1 festgelegt, wobei xxx der Name der Quell-Feature-Class eines bestimmten Eingabeeintrags ist. Alle anderen Felder weisen 0 oder NULL-Werte auf.
- Wenn Label-Features bereitgestellt werden, wird keines der Eingabe-Attributschemas in der Ausgabe-Feature-Class beibehalten. Nur die Attribute der Label-Features sind in der Ausgabe-Feature-Class enthalten. Wenn ein Ausgabe-Polygon ein Label-Feature enthält, weist es Feldwerte aus diesem Label-Feature auf. Wenn ein Ausgabe-Polygon mehr als ein Label-Feature enthält, weist es Feldwerte aus einem von ihnen auf. Andernfalls weist es Feldwerte von 0 oder NULL-Werte auf.
Wenn die Option Attribute beibehalten im Dialogfeld deaktiviert wird (bei der Skripterstellung wird der Parameter attributes auf NO_ATTRIBUTES festgelegt), werden Eingabe-Attributschemas in die Ausgabe geschrieben, die Attributwerte sind jedoch leer. Wenn in der Ausgabe-Polygon-Feature-Class keine Attribute enthalten sein sollen, geben Sie eine Point-Feature-Class an, in der für den Parameter Features beschriften keine Attribute definiert sind.
Wenn Eingabe-Polygon-Features in kleinere Ausgabe-Polygon-Features aufgegliedert werden, kann das Werkzeug Verschneiden (Identity) verwendet werden, um Attribute von den Eingabe-Polygon-Features auf die resultierenden Polygon-Features zu übertragen.
Dieses Werkzeug verwendet einen Kachelvorgang, um beim Verarbeiten sehr großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter Geoverarbeitung mit großen Datasets.
Syntax
arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})
Parameter | Erklärung | Datentyp |
in_features [in_features,...] | Die Eingabe-Features, die den Typ "Linie" oder "Polygon" oder beides haben können. | Feature Layer |
out_feature_class | Die Ausgabe-Polygon-Feature-Class. | Feature Class |
cluster_tolerance (optional) | Der Mindestabstand zwischen allen Feature-Koordinaten sowie die Entfernung, um die eine Koordinate während der räumlichen Berechnung in X- bzw. Y-Richtung (oder in beiden Richtungen) verschoben werden kann. Die Standard-XY-Toleranz ist auf 0,001 Meter bzw. das Äquivalent in Feature-Einheiten festgelegt. | Linear Unit |
attributes (optional) | Boolean | |
label_features (optional) | Die optionalen Eingabe-Punkt-Features, die die Attribute enthalten, die in die Ausgabe-Polygon-Features übertragen werden sollen. | Feature Layer |
Codebeispiel
FeatureToPolygon – Beispiel 1 (Python-Fenster)
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion FeatureToPolygon im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES")
FeatureToPolygon – Beispiel 2 (eigenständiges Skript)
Das folgende eigenständige Skript ist ein einfaches Beispiel für die Anwendung der Funktion FeatureToPolygon in einer Skriptumgebung.
# 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.FeatureToPolygon_management(inFeatures, outFeatureClass, clusTol,
"NO_ATTRIBUTES")
Umgebungen
- Aktueller Workspace
- Scratch-Workspace
- Standard-Ausgabe-Z-Wert
- M-Auflösung
- M-Toleranz
- Ausgabe-M-Domäne
- Ausgabe-Z-Domäne
- Ausgabe-Koordinatensystem
- Ausdehnung
- Ausgabe hat M-Werte
- Ausgabe hat Z-Werte
- Räumliches Gitter 1 der Ausgabe
- Räumliches Gitter 2 der Ausgabe
- Räumliches Gitter 3 der Ausgabe
- XY-Auflösung
- XY-Toleranz
- Z-Auflösung
- Z-Toleranz
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja