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

Abbildung des Werkzeugs "Feature in Polygon"
Beispiele für das Werkzeug "Feature in Polygon" werden zum Vergleich gezeigt.

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 (attributes in Python) und Beschriftungs-Features (label_features in Python).

  • 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 (attributes in Python) 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 (attributes = "ATTRIBUTES" in Python) 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 (attributes = "NO_ATTRIBUTES" in Python) 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.

  • 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.

Parameter

BeschriftungErläuterungDatentyp
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 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.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu 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)

Vorversion:

Dieser Parameter wird nicht mehr unterstützt.

Boolean
Beschriftungs-Features
(optional)

Die optionalen Eingabe-Punkt-Features, die die Attribute enthalten, die in die Ausgabe-Polygon-Features übertragen werden sollen.

Feature Layer

arcpy.management.FeatureToPolygon(in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})
NameErläuterungDatentyp
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.

Vorsicht:

Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu 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)

Vorversion:

Dieser Parameter wird nicht mehr unterstützt.

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")

Lizenzinformationen

  • Basic: Nein
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen