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:

  • AREADie Fläche der einzelnen Polygon-Features.
  • AREA_GEODESICDie formgetreue geodätische Fläche der einzelnen Polygon-Features.
  • CENTROID_XDie X-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_YDie Y-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_ZDie Z-Koordinate des Schwerpunkts für die einzelnen Features.
  • CENTROID_MDie M-Koordinate des Schwerpunkts für die einzelnen Features.
  • INSIDE_XDie 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_YDie 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_ZDie 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_MDie 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_COUNTDie Anzahl der Kurven in den einzelnen Features. Kurven sind beispielsweise Ellipsenbögen, Kreisbögen und Bézierkurven.
  • HOLE_COUNTDie Anzahl der Löcher im Innenbereich der einzelnen Polygon-Features.
  • EXTENT_MIN_XDie minimale X-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MIN_YDie minimale Y-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MIN_ZDie minimale Z-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_XDie maximale X-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_YDie maximale Y-Koordinate der Ausdehnung für die einzelnen Features.
  • EXTENT_MAX_ZDie maximale Z-Koordinate der Ausdehnung für die einzelnen Features.
  • LENGTHDie Länge der einzelnen Linien-Features.
  • LENGTH_GEODESICDie formgetreue geodätische Länge der einzelnen Linien-Features.
  • LENGTH_3DDie 3D-Länge der einzelnen Linien-Features.
  • LINE_BEARINGDie 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_XDie X-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_YDie Y-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_ZDie Z-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_START_MDie M-Koordinate des Startpunktes für die einzelnen Linien-Features.
  • LINE_END_XDie X-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_YDie Y-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_ZDie Z-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • LINE_END_MDie M-Koordinate des Endpunktes für die einzelnen Linien-Features.
  • PART_COUNTDie Anzahl der Teile, aus denen die einzelnen Features bestehen.
  • PERIMETER_LENGTHDie Länge des Umfangs oder der Grenze der einzelnen Polygon-Features.
  • PERIMETER_LENGTH_GEODESICDie formgetreue geodätischen Länge des Umfangs oder der Grenze der einzelnen Polygon-Features.
  • POINT_COUNTDie Anzahl der Punkte oder Stützpunkte, aus denen die einzelnen Features bestehen.
  • POINT_XDie X-Koordinate der einzelnen Punkt-Features.
  • POINT_YDie Y-Koordinate der einzelnen Punkt-Features.
  • POINT_ZDie Z-Koordinate der einzelnen Punkt-Features.
  • POINT_MDie M-Koordinate der einzelnen Punkt-Features.
  • POINT_COORD_NOTATIONDie 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_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)

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

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

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_INPUTDie Raumbezugseinheiten der Eingabe-Features werden für die Koordinatenformatierung verwendet. Dies ist die Standardeinstellung.
  • DDDezimalgrad.
  • 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')
  • GARSDas Global Area Reference System basiert auf Breiten- und Längengraden, die die Welt in Zellen unterteilen.
  • GEOREFDas World Geographic Reference System basiert auf dem geographischen System von Breitengrad und Längengrad, verwendet jedoch eine einfachere und flexiblere Schreibweise.
  • MGRSMilitary Grid Reference System.
  • USNGUnited States National Grid.
  • UTMUniversal Transverse Mercator.
  • UTMNSUniverselle 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