Feature in Polygon (Data Management)

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

Feature in Polygon
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 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})
ParameterErklärungDatentyp
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)

Ältere Versionen:

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