Feature in Punkt (Data Management)

Zusammenfassung

Erstellt eine Feature-Class mit Punkten, die aus den Schwerpunkten der Eingabe-Features generiert oder innerhalb der Eingabe-Features platziert wurden.

Abbildung

Abbildung des Werkzeugs "Feature in Punkt"

Verwendung

  • Die Attribute der Eingabe-Features werden in der Ausgabe-Feature-Class beibehalten. Ein neues Feld, ORIG_FID, wird der Ausgabe-Feature-Class hinzugefügt und auf die IDs des Eingabe-Features gesetzt.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Eingabe-Features, die vom Typ Multipoint, Linie, Polygon oder Annotation sein können.

Feature Layer
Ausgabe-Feature-Class

Die Ausgabe-Point-Feature-Class.

Feature Class
Innerhalb
(optional)

Gibt an, ob sich ein Ausgabepunkt innerhalb des Eingabe-Features oder am Schwerpunkt des Eingabefeatures befindet.

  • Deaktiviert: Der Ausgabepunkt befindet sich am Schwerpunkt des Eingabe-Features. Der Ausgabepunkt ist möglicherweise nicht im Eingabe-Feature enthalten. Dies ist die Standardeinstellung.
  • Aktiviert: Der Ausgabepunkt befindet sich innerhalb des Eingabe-Features.

Wenn der Parameter Innerhalb nicht aktiviert ist, wird die Position der einzelnen Ausgabepunkte wie folgt bestimmt:

  • Multipoint-Features: Der Ausgabepunkt befindet sich an den durchschnittlichen X- und Y-Koordinaten aller Punkte im Multipoint-Feature.
  • Polylinien-Features: Der Ausgabepunkt befindet sich an den gewichteten durchschnittlichen X- und Y-Koordinaten der Mittelpunkte aller Liniensegmente in der Linie. Dabei entspricht die Gewichtung eines bestimmten Mittelpunktes der Länge des entsprechenden Liniensegments. Parametrische (echte) Kurven werden verdichtet.
  • Polygon-Features: Der Ausgabepunkt befindet sich auf dem Schwerpunkt des Polygons.

Wenn der Parameter Innerhalb aktiviert ist, ist die Position des repräsentativen Punktes eines Eingabe-Features in dem Eingabe-Feature enthalten und wird folgendermaßen bestimmt:

  • Multipoint-Features: Der Ausgabepunkt ist mit einem der Punkte im Multipoint lagegleich.
  • Polylinien-Features: Der Ausgabepunkt befindet sich auf der Linie. Wenn die Linie eine parametrische (echte) Kurve ist, befindet sich der Ausgabepunkt auf dem Mittelpunkt der Linie.
  • Polygon-Features: Der Ausgabepunkt befindet sich innerhalb des Polygons.

Boolean

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
NameErläuterungDatentyp
in_features

Die Eingabe-Features, die vom Typ Multipoint, Linie, Polygon oder Annotation sein können.

Feature Layer
out_feature_class

Die Ausgabe-Point-Feature-Class.

Feature Class
point_location
(optional)

Gibt an, ob sich ein Ausgabepunkt innerhalb des Eingabe-Features oder am Schwerpunkt des Eingabefeatures befindet.

  • CENTROIDDer Ausgabepunkt befindet sich am Schwerpunkt des Eingabe-Features. Der Ausgabepunkt ist möglicherweise nicht im Eingabe-Feature enthalten. Dies ist die Standardeinstellung.
  • INSIDEDer Ausgabepunkt befindet sich innerhalb des Eingabe-Features.

Wenn der Parameter point_location auf CENTROID festgelegt ist, wird die Position der einzelnen Ausgabepunkte wie folgt bestimmt:

  • Multipoint-Features: Der Ausgabepunkt befindet sich an den durchschnittlichen X- und Y-Koordinaten aller Punkte im Multipoint-Feature.
  • Polylinien-Features: Der Ausgabepunkt befindet sich an den gewichteten durchschnittlichen X- und Y-Koordinaten der Mittelpunkte aller Liniensegmente in der Linie. Dabei entspricht die Gewichtung eines bestimmten Mittelpunktes der Länge des entsprechenden Liniensegments. Parametrische (echte) Kurven werden verdichtet.
  • Polygon-Features: Der Ausgabepunkt befindet sich auf dem Schwerpunkt des Polygons.

Wenn der Parameter point_location auf INSIDE festgelegt ist, ist die Position des repräsentativen Punktes eines Eingabe-Features in dem Eingabe-Feature enthalten und wird folgendermaßen bestimmt:

  • Multipoint-Features: Der Ausgabepunkt ist mit einem der Punkte im Multipoint lagegleich.
  • Polylinien-Features: Der Ausgabepunkt befindet sich auf der Linie. Wenn die Linie eine parametrische (echte) Kurve ist, befindet sich der Ausgabepunkt auf dem Mittelpunkt der Linie.
  • Polygon-Features: Der Ausgabepunkt befindet sich innerhalb des Polygons.

Boolean

Codebeispiel

FeatureToPoint: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
FeatureToPoint: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein einfaches Beispiel für die Anwendung der Funktion FeatureToPoint in einer Skriptumgebung.

# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

#  Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"

# Use FeatureToPoint function to find a point inside each park
arcpy.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")

Verwandte Themen