Feature in Polygon (Data Management Tools)

Zusammenfassung

Erstellt eine Feature-Class mit Polygonen, die aus von Eingabe-Linien- oder -Polygon-Features umschlossenen Flächen oder aus einzelnen abgeschlossenen Linien generiert wurden.

Abbildung

Abbildung: Werkzeug "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 den Parameterwerten Attribute beibehalten und Beschriftungs-Features.
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 in Python) 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:

Von der Verwendung des Parameters Attribute beibehalten wird abgeraten, da er nicht mehr unterstützt wird und nicht funktionsfähig ist. Er wird aber aus Gründen der Abwärtskompatibilität von Skripten oder Modellen nicht entfernt. Wenn auch das Ausgabe-Attributschema und die Feldwerte für bestimmte Eingabekombinationen möglicherweise wie unten beschrieben erstellt werden, sind die meisten von ihnen unbeabsichtigt.

Wenn der Parameter Attribute beibehalten aktiviert ist, hängen das Ausgabe-Attributschema und die Feldwerte davon ab, ob die Beschriftungs-Features (Punkte) folgendermaßen bereitgestellt werden:
- Wenn für Beschriftungs-Features keine Parameterwerte 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 für Beschriftungs-Features ein Parameterwert bereitgestellt wird, wird keines der Eingabe-Attributschemas in der Ausgabe-Feature-Class beibehalten. Nur die Attribute der Beschriftungs-Features sind in der Ausgabe-Feature-Class enthalten. Wenn ein Ausgabe-Polygon ein Beschriftungs-Feature enthält, weist es Feldwerte aus diesem Beschriftungs-Feature auf. Wenn ein Ausgabe-Polygon mehr als ein Beschriftungs-Feature enthält, weist es Feldwerte aus einem von ihnen auf. Andernfalls weist es Feldwerte von 0 oder NULL-Werte auf.
Wenn der Parameter Attribute beibehalten deaktiviert ist, 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 Beschriftungs-Features keine Attribute definiert sind.
Der Parameter Polygon-Konstruktionsquelle unterstützt die folgenden Optionen, die festlegen, wie ein Polygon konstruiert wird:
- Pro umschlossenem Bereich: Ein Polygon wird an der Stelle erstellt, an der ein oder mehrere Features eine umschlossene Fläche bilden. Dies ist die Standardeinstellung und wird von der Standard-Lizenz und höheren Lizenzen unterstützt.
- Pro abgeschlossener Linie: Ein Polygon wird aus einer abgeschlossenen Linie konstruiert (als Eingabe werden ausschließlich Linien-Features akzeptiert). Wenn eine Linie keine geschlossene Form bildet, d. h. ihr Start- und Endpunkt liegen mehr als die XY-Toleranz des Features auseinander, wird diese Linie übersprungen. Werden mehr als 10 Features übersprungen, wird eine Textdatei erstellt, in der alle übersprungenen Datensätze zur Überprüfung gespeichert werden. Alle Eingabeattribute werden in die Ausgabe übernommen. Diese Option wird von der Basic-Lizenz und höheren Lizenzen unterstützt und bietet keine Unterstützung für Beschriftungs-Features.
Wenn Eingabe-Polygon-Features in kleinere Ausgabe-Polygon-Features aufgegliedert werden, können Sie mit dem Werkzeug Verschneiden (Identity) Attribute von den Eingabe-Polygon-Features auf die resultierenden Polygon-Features übertragen.
Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter "Gekachelte Verarbeitung großer Datasets".

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Features, die den Typ "Linie" oder "Polygon" oder beides haben können.	Feature Layer
Ausgabe-Feature-Class	Die Ausgabe-Polygon-Feature-Class.	Feature Class
XY-Toleranz (Optional)	Der Mindestabstand zwischen allen Feature-Koordinaten sowie die Strecke, um die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) während einer räumlichen Berechnung bewegt werden kann. Der Standardwert beträgt 0,001 Meter oder dessen Äquivalent in Feature-Einheiten. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit
Attribute beibehalten (Optional)	Hinweis: Dieser Parameter wird nicht mehr unterstützt. Der Parameter wird aus Gründen der Abwärtskompatibilität von Skripten und Modellen nicht entfernt. Weitere Informationen finden Sie im Abschnitt Verwendung.	Boolean
Features beschriften (Optional)	Die optionalen Eingabe-Punkt-Features, die die Attribute enthalten, die in die Ausgabe-Polygon-Features übertragen werden sollen.	Feature Layer
Polygon-Konstruktionsquelle (Optional)	Gibt die Quellkriterien für ein zu erstellendes Polygon an. Pro umschlossenem Bereich—Ein Polygon wird an der Stelle erstellt, an der eine umschlossene Fläche gefunden wird. Dies ist die Standardeinstellung. Diese Option erfordert die Standard-Lizenz oder eine höhere Lizenz. Pro abgeschlossener Linie—Ein Polygon wird an der Stelle erstellt, an der eine abgeschlossene Linie gefunden wird. Diese Option erfordert die Basic-Lizenz oder eine höhere Lizenz.	String

arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features}, {polygon_construction_source})

Name	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 Strecke, um die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) während einer räumlichen Berechnung bewegt werden kann. Der Standardwert beträgt 0,001 Meter oder dessen Äquivalent in Feature-Einheiten. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit
attributes (Optional)	Hinweis: Dieser Parameter wird nicht mehr unterstützt. Der Parameter wird aus Gründen der Abwärtskompatibilität von Skripten und Modellen nicht entfernt. Weitere Informationen finden Sie im Abschnitt Verwendung.	Boolean
label_features (Optional)	Die optionalen Eingabe-Punkt-Features, die die Attribute enthalten, die in die Ausgabe-Polygon-Features übertragen werden sollen.	Feature Layer
polygon_construction_source (Optional)	Gibt die Quellkriterien für ein zu erstellendes Polygon an. `PER_ENCLOSED_AREA`—Ein Polygon wird an der Stelle erstellt, an der eine umschlossene Fläche gefunden wird. Dies ist die Standardeinstellung. Diese Option erfordert die Standard-Lizenz oder eine höhere Lizenz. `PER_ENCLOSED_LINE`—Ein Polygon wird an der Stelle erstellt, an der eine abgeschlossene Linie gefunden wird. Diese Option erfordert die Basic-Lizenz oder eine höhere Lizenz.	String

Codebeispiel

FeatureToPolygon: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion FeatureToPolygon im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPolygon(["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.management.FeatureToPolygon(inFeatures, outFeatureClass, clusTol,
                                  "NO_ATTRIBUTES")

Umgebungen

Aktueller Workspace, Scratch-Workspace, Standard-Ausgabe-Z-Werte, M-Auflösung, M-Toleranz, Ausgabe-M-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Lizenzierungsinformationen

Basic: Eingeschränkt
Standard: Ja
Advanced: Ja