Geometrieattribute berechnen (Data Management)

Zusammenfassung

Fügt Informationen zu den Attributfeldern eines Features hinzu, die den räumlichen oder geometrischen Eigenschaften und der Position des Features entsprechen, darunter Länge, Fläche oder die X-, Y-, Z- und M-Koordinaten.

Ein ähnliches Werkzeug, mit dem neuen Attributfeldern mehrere Geometrieattribute hinzugefügt werden, ist das Werkzeug Geometrieattribute hinzufügen.

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.

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

  • 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 behalten ihre vorhandenen Werte bei.

  • Dieses Werkzeug kann für Point-, Multipoint-, Polyline- und Polygon-Feature-Classes verwendet werden.

Syntax

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})
ParameterErklärungDatentyp
in_features

Der Feature-Layer mit einem Feld, das mit Geometrieberechnungen aktualisiert wird.

Feature Layer
geometry_property
[[Target Field, Property],...]

Gibt die Felder, in denen Geometrieeigenschaften berechnet werden, sowie die zu berechnenden Geometrieeigenschaften an. Folgende Geometrieeigenschaften werden unterstützt:

  • AREA —Die Fläche der einzelnen Polygon-Features.
  • AREA_GEODESIC —Die formgetreue geodätische Fläche der einzelnen Polygon-Features.
  • CENTROID_X —Die X-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_Y —Die Y-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_Z —Die Z-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_M —Die M-Koordinate des Schwerpunkts für die einzelnen Features.
  • INSIDE_X —Die X-Koordinate eines Zentralpunktes im oder auf den einzelnen Features. Dieser Punkt ist mit dem Schwerpunkt identisch, wenn sich der Schwerpunkt innerhalb des Features befindet. Andernfalls ist dieser Punkt ein interner Label-Punkt.
  • INSIDE_Y —Die Y-Koordinate eines Zentralpunktes im oder auf den einzelnen Features. Dieser Punkt ist mit dem Schwerpunkt identisch, wenn sich der Schwerpunkt innerhalb des Features befindet. Andernfalls ist dieser Punkt ein interner Label-Punkt.
  • INSIDE_Z —Die Z-Koordinate eines Zentralpunktes im oder auf den einzelnen Features. Dieser Punkt ist mit dem Schwerpunkt identisch, wenn sich der Schwerpunkt innerhalb des Features befindet. Andernfalls ist dieser Punkt ein interner Label-Punkt.
  • INSIDE_M —Die M-Koordinate eines Zentralpunktes im oder auf den einzelnen Features. Dieser Punkt ist mit dem Schwerpunkt identisch, wenn sich der Schwerpunkt innerhalb des Features befindet. Andernfalls ist dieser Punkt ein interner Label-Punkt.
  • CURVE_COUNT —Die Anzahl der Kurven in den einzelnen Features. Kurven sind beispielsweise Ellipsenbögen, Kreisbögen und Bézierkurven.
  • HOLE_COUNT —Die Anzahl der Löcher im Innenbereich der einzelnen Polygon-Features.
  • EXTENT_MIN_X —Die minimale X-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MIN_Y —Die minimale Y-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MIN_Z —Die minimale Z-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_X —Die maximale X-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_Y —Die maximale Y-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_Z —Die maximale Z-Koordinate der Ausdehnung für die einzelnen Features.
  • LENGTH —Die Länge der einzelnen Linien-Features.
  • LENGTH_GEODESIC —Die formgetreue geodätische Länge der einzelnen Linien-Features.
  • LENGTH_3D —Die 3D-Länge der einzelnen Linien-Features.
  • LINE_BEARING —Die Peilung der Linie vom Anfang bis zum Ende für die einzelnen Linien-Features. Die Werte liegen zwischen 0 und 360, wobei 0 Norden, 90 Osten, 180 Süden und 270 Westen angibt usw.
  • LINE_START_X —Die X-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_Y —Die Y-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_Z —Die Z-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_M —Die M-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_END_X —Die X-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_Y —Die Y-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_Z —Die Z-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_M —Die M-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • PART_COUNT —Die Anzahl der Teile, aus denen die einzelnen Features bestehen.
  • PERIMETER_LENGTH —Die Länge des Umfangs oder der Grenze der einzelnen Polygon-Features.
  • PERIMETER_LENGTH_GEODESIC —Die formgetreue geodätischen Länge des Umfangs oder der Grenze der einzelnen Polygon-Features.
  • POINT_COUNT —Die Anzahl der Punkte oder Stützpunkte, aus denen die einzelnen Features bestehen.
  • POINT_X —Die X-Koordinate der einzelnen Punkt-Features.
  • POINT_Y —Die Y-Koordinate der einzelnen Punkt-Features.
  • POINT_Z —Die Z-Koordinate der einzelnen Punkt-Features.
  • POINT_M —Die M-Koordinate der einzelnen Punkt-Features.
  • POINT_COORD_NOTATION —Die X- und Y-Koordinate der einzelnen Punkt-Features, formatiert als bestimmte Koordinatenschreibweise.
Value Table
length_unit
(optional)

Die Einheit, die zum Berechnen der Länge verwendet wird.

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

Die Einheit, die zum Berechnen der Fläche verwendet wird.

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

Bei koordinatenbasierten Geometrieeigenschaften wird das Koordinatensystem nur angewendet, wenn das Koordinatenformat mit der Eingabe übereinstimmt; andernfalls wird das geographische Koordinatensystem WGS_1984 verwendet.

Coordinate System
coordinate_format
(optional)

Das Koordinatenformat, in dem die X- und Y-Koordinaten berechnet werden. Standardmäßig wird das Koordinatenformat verwendet, das den Raumbezugseinheiten der Eingabe-Features entspricht.

Mehrere Koordinatenformate, darunter "Grad Minuten Sekunden" und "Grad Dezimalminuten", erfordern, dass die Berechnung in einem Textfeld durchgeführt wird.

  • SAME_AS_INPUT —Die Raumbezugseinheiten der Eingabe-Features werden für die Koordinatenformatierung verwendet. Dies ist die Standardeinstellung.
  • DD —Dezimalgrad.
  • DMS_DIR_LAST —"Grad Minuten Sekunden" mit Himmelsrichtungskomponente am Ende (DDD° MM' SSS.ss" <N|S|E|W>)
  • DMS_DIR_FIRST —"Grad Minuten Sekunden" mit Himmelsrichtungskomponente am Anfang (<N|S|E|W> DDD° MM' SSS.ss")
  • DMS_POS_NEG —"Grad Minuten Sekunden" mit positiver oder negativer Richtungskomponente am Anfang (<+|-> DDD° MM' SSS.ss")
  • DMS_PACKED —"Grad Minuten Sekunden", zusammengefasst in einem einzelnen Wert mit positiver oder negativer Richtungskomponente (<+|-> DDD.MMSSSss)
  • DDM_DIR_LAST —"Grad Dezimalminuten" mit Himmelsrichtungskomponente am Ende (DDD° MM.mmm' <N|S|E|W>)
  • DDM_DIR_FIRST —"Grad Dezimalminuten" mit Himmelsrichtungskomponente am Anfang (<N|S|E|W> DDD° MM.mmm')
  • DDM_POS_NEG —"Grad Dezimalminuten" mit positiver oder negativer Richtungskomponente am Anfang (<+|-> DDD° MM.mmm')
  • GARS —Das Global Area Reference System basiert auf Breiten- und Längengraden, die die Welt in Zellen unterteilen.
  • GEOREF —Das World Geographic Reference System basiert auf dem geographischen System von Breitengrad und Längengrad, verwendet jedoch eine einfachere und flexiblere Schreibweise.
  • MGRS —Military Grid Reference System.
  • USNG —United States National Grid.
  • UTM —Universal Transverse Mercator.
  • UTMNS —Universelle transversale Mercator-Projektion ohne Leerzeichen
String

Abgeleitete Ausgabe

NameErklärungDatentyp
updated_features

Die aktualisierten Eingabe-Features.

Feature-Layer

Codebeispiel

CalculateGeometryAttributes – Beispiel (Python-Fenster)

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

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.CalculateGeometryAttributes_management("roads", [["Length_mi", "LENGTH"], ["Stops", "POINT_COUNT"]], "MILES_US")
CalculateGeometryAttributes – Beispiel (eigenständiges Skript)

Rufen Sie das Ausdehnungsrechteck der einzelnen Features ab.

# Name: ExtentCreation.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"
# Generate the extent coordinates using CalculateGeometry
arcpy.CalculateGeometryAttributes_management(in_features, [["Left", "EXTENT_MIN_X"],
                                                           ["Bottom", "EXTENT_MIN_Y"],
                                                           ["Right", "EXTENT_MAX_X"],
                                                           ["Top", "EXTENT_MAX_Y"]])

Lizenzinformationen

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

Verwandte Themen