Geometrieattribute hinzufügen (Data Management)

Zusammenfassung

Fügt neue Attributfelder zu den Eingabe-Features hinzu, die den räumlichen oder geometrischen Eigenschaften und der Position jedes Features entsprechen, darunter Länge, Fläche oder die X-, Y-, Z- und M-Koordinaten.

Verwendung

Vorsicht:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

• Abhängig von den im Parameter Geometrieeigenschaften angegebenen Optionen werden den Eingabe-Features ein oder mehrere Attributfelder hinzugefügt. Wenn die Felder in den Eingabe-Features bereits vorhanden sind, werden die Werte in diesen Feldern überschrieben. Anhand der folgenden Tabelle können Sie bestimmen, welche Felder für die einzelnen Geometrieeigenschaften hinzugefügt werden:

  Geometrieeigenschaft	Hinzugefügtes Feld
  AREA	POLY_AREA: Die Fläche des Polygons.
  AREA_GEODESIC	AREA_GEO: Die formgetreue geodätische Fläche des Polygons.
  CENTROID	CENTROID_X: Die X-Koordinate des Schwerpunktes. CENTROID_Y: Die Y-Koordinate des Schwerpunktes. CENTROID_Z: Die Z-Koordinate des Schwerpunktes. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. CENTROID_M: Die M-Koordinate des Schwerpunktes. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind.
  CENTROID_INSIDE	INSIDE_X: Die X-Koordinate eines zentralen Punktes im oder auf dem Eingabe-Feature. INSIDE_Y: Die Y-Koordinate eines zentralen Punktes im oder auf dem Eingabe-Feature. INSIDE_Z: Die Z-Koordinate eines zentralen Punktes im oder auf dem Eingabe-Feature. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. INSIDE_M: Die M-Koordinate eines zentralen Punktes im oder auf dem Eingabe-Feature. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind.
  EXTENT	EXT_MIN_X: Die kleinste X-Koordinate des Features. EXT_MIN_Y: Die kleinste Y-Koordinate des Features. EXT_MAX_X: Die größte X-Koordinate des Features. EXT_MAX_Y: Die größte Y-Koordinate des Features.
  LENGTH	LENGTH: Die Länge der Linie.
  LENGTH_GEODESIC	LENGTH_GEO: Die formgetreue geodätische Länge der Linie.
  LENGTH_3D	LENGTH_3D: Die 3D-Länge der Linie.
  LINE_BEARING	BEARING: Die Peilung der Linie vom Anfang bis zum Ende. Die Werte liegen zwischen 0 und 360, wobei 0 Norden, 90 Osten, 180 Süden und 270 Westen angibt.
  LINE_START_MID_END	START_X: Die X-Koordinate des ersten Punktes der Linie oder Polygongrenze. START_Y: Die Y-Koordinate des ersten Punktes der Linie oder Polygongrenze. START_Z: Die Z-Koordinate des ersten Punktes der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. START_M: Die M-Koordinate des ersten Punktes der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind. MID_X: Die X-Koordinate des Punktes auf der halben Länge der Linie oder Polygongrenze. MID_Y: Die Y-Koordinate des Punktes auf der halben Länge der Linie oder Polygongrenze. MID_Z: Die Z-Koordinate des Punktes auf der halben Länge der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. MID_M: Die M-Koordinate des Punktes auf der halben Länge der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind. END_X: Die X-Koordinate des letzten Punktes der Linie oder Polygongrenze. END_Y: Die Y-Koordinate des letzten Punktes der Linie oder Polygongrenze. END_Z: Die Z-Koordinate des letzten Punktes der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. END_M: Die M-Koordinate des letzten Punktes der Linie oder Polygongrenze. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind.
  PART_COUNT	PART_COUNT: Die Anzahl der Teile, aus denen das Feature besteht.
  PERIMETER_LENGTH	PERIMETER: Die Länge des Polygonumfangs oder der Polygongrenze.
  PERIMETER_LENGTH_GEODESIC	PERIM_GEO: Die formgetreue geodätische Länge des Polygonumfangs oder der Polygongrenze.
  POINT_COUNT	PNT_COUNT: Die Anzahl der Punkte, aus denen das Feature besteht.
  POINT_X_Y_Z_M	POINT_X: Die X-Koordinate des Punktes. POINT_Y: Die Y-Koordinate des Punktes. POINT_Z: Die Z-Koordinate des Punktes. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features Z-aktiviert sind. POINT_M: Die M-Koordinate des Punktes. Dieses Feld wird nur hinzugefügt, wenn die Eingabe-Features M-aktiviert sind.

• Wenn ein Koordinatensystem angegeben wird, werden die Längen- und Flächenberechnungen in den Einheiten dieses Koordinatensystems durchgeführt, sofern in den Parametern Längeneinheit und Flächeneinheiten keine anderen Einheiten ausgewählt sind.

• Die von diesem Werkzeug hinzugefügten Attributfelder unterscheiden sich nicht von anderen Feldern, die Sie einem Feature-Layer hinzufügen können. Sie können die Feldwerte überschreiben oder die Felder löschen oder umbenennen. Die Werte in diesen Feldern werden nach Änderungen nicht automatisch neu berechnet. Wenn Sie die Features bearbeiten, müssen Sie dieses Werkzeug erneut ausführen, um die Feldwerte zu aktualisieren.

• Wenn in den Eingabe-Features eine Auswahl getroffen wurde, werden nur für die ausgewählten Felder Werte in den hinzugefügten Feldern berechnet. Alle anderen Features enthalten Null-Werte.

• Dieses Werkzeug kann für Point-, Multipoint-, Polyline-, Polygon- und Annotation-Feature-Classes verwendet werden. Eine Annotation wird als Polygon-Feature-Class behandelt.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Features, denen neue Attributfelder hinzugefügt werden, um Eigenschaften wie Länge, Fläche oder X-, Y-, Z- und M-Koordinaten zu speichern.	Feature Layer
Geometrieeigenschaften	Gibt die Geometrie- oder Shape-Eigenschaften an, die für die neuen Attributfelder berechnet werden. Fläche—Es wird ein Attribut hinzugefügt, um die Fläche der einzelnen Polygon-Features zu speichern. Geodätischer Bereich—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Fläche der einzelnen Polygon-Features zu speichern. Schwerpunktkoordinaten—Es werden Attribute hinzugefügt, um die Schwerpunktkoordinaten der einzelnen Features zu speichern. Allgemeine Punktkoordinaten—Es werden Attribute hinzugefügt, um die Koordinaten eines zentralen Punktes in oder auf den einzelnen Features zu speichern. Ausdehnungskoordinaten—Es werden Attribute hinzugefügt, um die Ausdehnungskoordinaten der einzelnen Features zu speichern. Länge—Es wird ein Attribut hinzugefügt, um die Länge der einzelnen Linien-Features zu speichern. Geodätische Länge—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge der einzelnen Linien-Features zu speichern. 3D-Länge—Es wird ein Attribut hinzugefügt, um die 3D-Länge der einzelnen Linien-Features zu speichern. Linienpeilung—Es wird ein Attribut hinzugefügt, um die Peilung der einzelnen Linien-Features von Anfang bis Ende zu speichern. Die Werte liegen zwischen 0 und 360, wobei 0 Norden, 90 Osten, 180 Süden und 270 Westen angibt. Anfang, Mittelpunkt und Endkoordinaten einer Linie—Es werden Attribute hinzugefügt, um die Koordinaten der Start-, Mittel- und Endpunkte der einzelnen Features zu speichern. Anzahl der Teile—Es wird ein Attribut hinzugefügt, um die Anzahl der Teile, aus denen die einzelnen Features bestehen, zu speichern. Länge des Umfangs—Es wird ein Attribut hinzugefügt, um die Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern. Geodätische Länge des Umfangs—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern. Anzahl der Stützpunkte—Es wird ein Attribut hinzugefügt, um die Anzahl der Punkte oder Stützpunkte, aus denen die einzelnen Features bestehen, zu speichern. X-, Y- Z- oder M-Koordinaten des Punktes—Es werden Attribute hinzugefügt, um die X-, Y-, Z- und M-Koordinaten der einzelnen Punkt-Features zu speichern.	String
Längeneinheit (optional)	Gibt die Einheit an, in der die Länge berechnet werden soll. Fuß (USA)—Länge in Fuß (USA) Meter—Länge in Metern Kilometer—Länge in Kilometern Meilen (USA)—Länge in Meilen (USA) Seemeilen (USA)—Länge in Seemeilen (USA) Yards (USA)—Länge in Yards (USA)	String
Flächeneinheiten (optional)	Gibt die Einheit an, in der die Fläche berechnet werden soll. Acres—Fläche in Acres Hektar—Fläche in Hektar Quadratmeilen (USA)—Fläche in Quadratmeilen (USA) Quadratkilometer—Fläche in Quadratkilometern Quadratmeter—Fläche in Quadratmetern Quadratfuß (USA)—Fläche in Quadratfuß (USA) Quadratyards (USA)—Fläche in Quadratyards (USA) Quadratseemeilen (USA)—Fläche in Quadratseemeilen (USA)	String
Koordinatensystem (optional)	Das Koordinatensystem, in dem die Koordinaten, Länge und Fläche berechnet werden. Standardmäßig wird das Koordinatensystem der Eingabe-Features verwendet.	Coordinate System

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Geänderte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

Python

arcpy.management.AddGeometryAttributes(Input_Features, Geometry_Properties, {Length_Unit}, {Area_Unit}, {Coordinate_System})

Name	Erläuterung	Datentyp
Input_Features	Die Eingabe-Features, denen neue Attributfelder hinzugefügt werden, um Eigenschaften wie Länge, Fläche oder X-, Y-, Z- und M-Koordinaten zu speichern.	Feature Layer
Geometry_Properties [Geometry_Properties,...]	Gibt die Geometrie- oder Shape-Eigenschaften an, die für die neuen Attributfelder berechnet werden. AREA—Es wird ein Attribut hinzugefügt, um die Fläche der einzelnen Polygon-Features zu speichern. AREA_GEODESIC—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Fläche der einzelnen Polygon-Features zu speichern. CENTROID—Es werden Attribute hinzugefügt, um die Schwerpunktkoordinaten der einzelnen Features zu speichern. CENTROID_INSIDE—Es werden Attribute hinzugefügt, um die Koordinaten eines zentralen Punktes in oder auf den einzelnen Features zu speichern. EXTENT—Es werden Attribute hinzugefügt, um die Ausdehnungskoordinaten der einzelnen Features zu speichern. LENGTH—Es wird ein Attribut hinzugefügt, um die Länge der einzelnen Linien-Features zu speichern. LENGTH_GEODESIC—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge der einzelnen Linien-Features zu speichern. LENGTH_3D—Es wird ein Attribut hinzugefügt, um die 3D-Länge der einzelnen Linien-Features zu speichern. LINE_BEARING—Es wird ein Attribut hinzugefügt, um die Peilung der einzelnen Linien-Features von Anfang bis Ende zu speichern. Die Werte liegen zwischen 0 und 360, wobei 0 Norden, 90 Osten, 180 Süden und 270 Westen angibt. LINE_START_MID_END—Es werden Attribute hinzugefügt, um die Koordinaten der Start-, Mittel- und Endpunkte der einzelnen Features zu speichern. PART_COUNT—Es wird ein Attribut hinzugefügt, um die Anzahl der Teile, aus denen die einzelnen Features bestehen, zu speichern. PERIMETER_LENGTH—Es wird ein Attribut hinzugefügt, um die Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern. PERIMETER_LENGTH_GEODESIC—Es wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern. POINT_COUNT—Es wird ein Attribut hinzugefügt, um die Anzahl der Punkte oder Stützpunkte, aus denen die einzelnen Features bestehen, zu speichern. POINT_X_Y_Z_M—Es werden Attribute hinzugefügt, um die X-, Y-, Z- und M-Koordinaten der einzelnen Punkt-Features zu speichern.	String
Length_Unit (optional)	Gibt die Einheit an, in der die Länge berechnet werden soll. FEET_US—Länge in Fuß (USA) METERS—Länge in Metern KILOMETERS—Länge in Kilometern MILES_US—Länge in Meilen (USA) NAUTICAL_MILES—Länge in Seemeilen (USA) YARDS—Länge in Yards (USA)	String
Area_Unit (optional)	Gibt die Einheit an, in der die Fläche berechnet werden soll. ACRES—Fläche in Acres HECTARES—Fläche in Hektar SQUARE_MILES_US—Fläche in Quadratmeilen (USA) SQUARE_KILOMETERS—Fläche in Quadratkilometern SQUARE_METERS—Fläche in Quadratmetern SQUARE_FEET_US—Fläche in Quadratfuß (USA) SQUARE_YARDS—Fläche in Quadratyards (USA) SQUARE_NAUTICAL_MILES—Fläche in Quadratseemeilen (USA)	String
Coordinate_System (optional)	Das Koordinatensystem, in dem die Koordinaten, Länge und Fläche berechnet werden. Standardmäßig wird das Koordinatensystem der Eingabe-Features verwendet.	Coordinate System

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
Modified_Input_Features	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

AddGeometryAttributes – Beispiel (Python-Fenster)

Das folgende Skript veranschaulicht die Verwendung des Werkzeugs AddGeometryAttributes im Python-Fenster.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.AddGeometryAttributes_management("roads", "LENGTH;LINE_START_MID_END")

AddGeometryAttributes – Beispiel (eigenständiges Skript)

Das Ausdehnungsrechteck der einzelnen Linien-Features wird abgerufen, und es wird ein Raster von 10 x 10 innerhalb dieser Ausdehnung erstellt.

# Name: GridCreation.py

# import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.env.outputCoordinateSystem = arcpy.Describe("roads").spatialReference

# Set local variables
in_features = "roads"
properties = "EXTENT"
length_unit = ""
area_unit = ""
coordinate_system = ""

# Generate the extent coordinates using Add Geometry Properties tool
arcpy.AddGeometryAttributes_management(in_features, properties, length_unit,
                                       area_unit, coordinate_system)

# Use Search Cursor to walk through each feature and generate grids
with arcpy.da.SearchCursor(in_features, ["OID@", "EXT_MIN_X", "EXT_MIN_Y",
                                         "EXT_MAX_X", "EXT_MAX_Y"]) as sCur:
    for row in sCur:
        minX, minY, maxX, maxY = row[1], row[2], row[3], row[4]
        arcpy.CreateFishnet_management("fishnet_{0}".format(row[0]),
                    number_rows = 10,
                    number_columns = 10,
                    template = "{} {} {} {}".format(minX, maxX, minY, maxY),
                    origin_coord = "{} {}".format(minX, minY),
                    y_axis_coord = "{} {}".format(minX, maxY),
                    corner_coord = "{} {}".format(maxX, maxY),
                    geometry_type = "POLYGON",
                    labels = "NO_LABELS")

Umgebungen

Ausgabe-Koordinatensystem, Aktueller Workspace

Sonderfälle

Lizenzinformationen

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