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.

Vorversion:

Dies ist ein veraltetes Werkzeug. Diese Funktionalität wurde durch das Werkzeug Geometrieattribute berechnen ersetzt.

Verwendung

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

    GeometrieeigenschaftHinzugefü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

BeschriftungErläuterungDatentyp
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ächeEs wird ein Attribut hinzugefügt, um die Fläche der einzelnen Polygon-Features zu speichern.
  • Geodätischer BereichEs wird ein Attribut hinzugefügt, um die formgetreue geodätische Fläche der einzelnen Polygon-Features zu speichern.
  • SchwerpunktkoordinatenEs werden Attribute hinzugefügt, um die Schwerpunktkoordinaten der einzelnen Features zu speichern.
  • Allgemeine PunktkoordinatenEs werden Attribute hinzugefügt, um die Koordinaten eines zentralen Punktes in oder auf den einzelnen Features zu speichern.
  • AusdehnungskoordinatenEs werden Attribute hinzugefügt, um die Ausdehnungskoordinaten der einzelnen Features zu speichern.
  • LängeEs wird ein Attribut hinzugefügt, um die Länge der einzelnen Linien-Features zu speichern.
  • Geodätische LängeEs wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge der einzelnen Linien-Features zu speichern.
  • 3D-LängeEs wird ein Attribut hinzugefügt, um die 3D-Länge der einzelnen Linien-Features zu speichern.
  • LinienpeilungEs 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 LinieEs werden Attribute hinzugefügt, um die Koordinaten der Start-, Mittel- und Endpunkte der einzelnen Features zu speichern.
  • Anzahl der TeileEs wird ein Attribut hinzugefügt, um die Anzahl der Teile, aus denen die einzelnen Features bestehen, zu speichern.
  • Länge des UmfangsEs 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 UmfangsEs 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ützpunkteEs 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 PunktesEs 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)
  • MeterLänge in Metern
  • KilometerLä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.

  • AcresFläche in Acres
  • HektarFläche in Hektar
  • Quadratmeilen (USA)Fläche in Quadratmeilen (USA)
  • QuadratkilometerFläche in Quadratkilometern
  • QuadratmeterFlä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

BeschriftungErläuterungDatentyp
Geänderte Eingabe-Features

Die aktualisierten Eingabe-Features.

Feature Layer

arcpy.management.AddGeometryAttributes(Input_Features, Geometry_Properties, {Length_Unit}, {Area_Unit}, {Coordinate_System})
NameErläuterungDatentyp
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.

  • AREAEs wird ein Attribut hinzugefügt, um die Fläche der einzelnen Polygon-Features zu speichern.
  • AREA_GEODESICEs wird ein Attribut hinzugefügt, um die formgetreue geodätische Fläche der einzelnen Polygon-Features zu speichern.
  • CENTROIDEs werden Attribute hinzugefügt, um die Schwerpunktkoordinaten der einzelnen Features zu speichern.
  • CENTROID_INSIDEEs werden Attribute hinzugefügt, um die Koordinaten eines zentralen Punktes in oder auf den einzelnen Features zu speichern.
  • EXTENTEs werden Attribute hinzugefügt, um die Ausdehnungskoordinaten der einzelnen Features zu speichern.
  • LENGTHEs wird ein Attribut hinzugefügt, um die Länge der einzelnen Linien-Features zu speichern.
  • LENGTH_GEODESICEs wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge der einzelnen Linien-Features zu speichern.
  • LENGTH_3DEs wird ein Attribut hinzugefügt, um die 3D-Länge der einzelnen Linien-Features zu speichern.
  • LINE_BEARINGEs 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_ENDEs werden Attribute hinzugefügt, um die Koordinaten der Start-, Mittel- und Endpunkte der einzelnen Features zu speichern.
  • PART_COUNTEs wird ein Attribut hinzugefügt, um die Anzahl der Teile, aus denen die einzelnen Features bestehen, zu speichern.
  • PERIMETER_LENGTHEs wird ein Attribut hinzugefügt, um die Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern.
  • PERIMETER_LENGTH_GEODESICEs wird ein Attribut hinzugefügt, um die formgetreue geodätische Länge des Umfangs oder der Grenze der einzelnen Polygon-Features zu speichern.
  • POINT_COUNTEs 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_MEs 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_USLänge in Fuß (USA)
  • METERSLänge in Metern
  • KILOMETERSLänge in Kilometern
  • MILES_USLänge in Meilen (USA)
  • NAUTICAL_MILESLänge in Seemeilen (USA)
  • YARDSLänge in Yards (USA)
String
Area_Unit
(optional)

Gibt die Einheit an, in der die Fläche berechnet werden soll.

  • ACRESFläche in Acres
  • HECTARESFläche in Hektar
  • SQUARE_MILES_USFläche in Quadratmeilen (USA)
  • SQUARE_KILOMETERSFläche in Quadratkilometern
  • SQUARE_METERSFläche in Quadratmetern
  • SQUARE_FEET_USFläche in Quadratfuß (USA)
  • SQUARE_YARDSFläche in Quadratyards (USA)
  • SQUARE_NAUTICAL_MILESFlä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

NameErläuterungDatentyp
Modified_Input_Features

Die aktualisierten Eingabe-Features.

Feature Layer

Codebeispiel

AddGeometryAttributes – Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion AddGeometryAttributes verwenden.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.AddGeometryAttributes("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.management.AddGeometryAttributes(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.management.CreateFishnet("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")