Feature in Polygon (Data Management)
Zusammenfassung
Erstellt eine Feature-Class mit Polygonen, die aus von Eingabe-Linien- oder -Polygon-Features umschlossenen Flächen generiert wurden.
Abbildung
 |
Feature in Polygon |
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.
-
Hinweis:Der Parameter Attribute beibehalten (der Parameter attributes bei der Skripterstellung) funktioniert nicht und sollte nicht verwendet werden. Er wird aber aus Gründen der Abwärtskompatibilität von Skripten oder Modellen nicht entfernt. Das Ausgabe-Attributschema und die Feldwerte für bestimmte Eingabekombinationen werden möglicherweise wie unten beschrieben erstellt. Die meisten von ihnen sind unbeabsichtigt.
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 ein neues 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
| Parameter | Erläuterung | 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) |
Gibt an, ob das Eingabeattributschema oder die Attribute aus Label-Features in der Ausgabe-Feature-Class beibehalten werden sollen oder ob alle Eingabeattribute in der Ausgabe-Feature-Class weggelassen werden sollen. Dieser Parameter funktioniert nicht. Er wird aber aus Gründen der Abwärtskompatibilität von Skripten oder Modellen nicht entfernt. Das Ausgabeattributschema und die Feldwerte für bestimmte Eingabekombinationen werden möglicherweise wie in den Verwendungshinweisen beschrieben erstellt. Die meisten von ihnen sind unbeabsichtigt.
| 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
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion "FeatureToPolygon" im unmittelbaren Modus verwendet wird.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES", "")
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.
# 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", "")