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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

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

Feature Layer
Geometrieattribute

Gibt die Felder an, in denen die ausgewählten Geometrieeigenschaften berechnet werden.

Sie können ein vorhandenes Feld auswählen oder einen neuen Feldnamen angeben. Wenn ein neuer Feldname angegeben wird, ist der Feldtyp vom Typ der Werte abhängig, die in das Feld geschrieben werden.

  • Anzahl-Attribute werden in Long-Integer-Felder geschrieben.
  • Attribute für Fläche, Länge und X-, Y-, Z- und M-Koordinaten werden in Double-Felder geschrieben.
  • Koordinatenangaben wie Grad, Minuten, Sekunden oder MGRS werden in Textfelder geschrieben.

  • 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
Längeneinheit
(optional)

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

  • Fuß (USA)Die Längeneinheit ist Fuß (USA).
  • MeterDie Längeneinheit ist Meter.
  • KilometerDie Längeneinheit ist Kilometer.
  • Meilen (USA)Die Längeneinheit ist Meilen (USA).
  • Seemeilen (USA)Die Längeneinheit ist Seemeilen (USA).
  • Yards (USA)Die Längeneinheit ist Yards (USA).
String
Flächeneinheiten
(optional)

Hierüber geben Sie die für die Berechnung der Fläche verwendeten Einheiten an.

  • AcresDie Flächeneinheiten sind Acres.
  • HektarDie Flächeneinheiten sind Hektar.
  • Quadratmeilen (USA)Die Flächeneinheiten sind Quadratmeilen (USA).
  • QuadratkilometerDie Flächeneinheiten sind Quadratkilometer.
  • QuadratmeterDie Flächeneinheiten sind Quadratmeter.
  • Quadratfuß (USA)Die Flächeneinheiten sind Quadratfuß (USA).
  • Quadratyards (USA)Die Flächeneinheiten sind Quadratyards (USA).
  • Quadratseemeilen (USA)Die Flächeneinheiten sind 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.

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

Coordinate System
Koordinatenformat
(optional)

Gibt das Koordinatenformat an, 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.

  • Gleich wie EingabeDie Raumbezugseinheiten der Eingabe-Features werden für die Koordinatenformatierung verwendet. Dies ist die Standardeinstellung.
  • DezimalgradDezimalgrad.
  • Grad Minuten Sekunden (DDD° MM' SSS.ss" <N|S|E|W>)"Grad Minuten Sekunden" mit Himmelsrichtungskomponente am Ende (DDD° MM' SSS.ss" <N|S|E|W>)
  • Grad Minuten Sekunden (<N|S|E|W> DDD° MM' SSS.ss")"Grad Minuten Sekunden" mit Himmelsrichtungskomponente am Anfang (<N|S|E|W> DDD° MM' SSS.ss")
  • Grad Minuten Sekunden (<+|-> DDD° MM' SSS.ss")"Grad Minuten Sekunden" mit positiver oder negativer Richtungskomponente am Anfang (<+|-> DDD° MM' SSS.ss")
  • Grad Minuten Sekunden (<+|-> DDD.MMSSSss)"Grad Minuten Sekunden", zusammengefasst in einem einzelnen Wert mit positiver oder negativer Richtungskomponente (<+|-> DDD.MMSSSss)
  • Grad Dezimalminuten (DDD° MM.mmm' <N|S|E|W>)"Grad Dezimalminuten" mit Himmelsrichtungskomponente am Ende (DDD° MM.mmm' <N|S|E|W>)
  • Grad Dezimalminuten (<N|S|E|W> DDD° MM.mmm')"Grad Dezimalminuten" mit Himmelsrichtungskomponente am Anfang (<N|S|E|W> DDD° MM.mmm')
  • Grad Dezimalminuten (<+|-> DDD° MM.mmm')"Grad Dezimalminuten" mit positiver oder negativer Richtungskomponente am Anfang (<+|-> DDD° MM.mmm')
  • GARS (Global Area Reference System)Das Global Area Reference System basiert auf Breiten- und Längengraden, die die Welt in Zellen unterteilen.
  • GEOREF (World Geographic Reference System)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)Military Grid Reference System.
  • USNG (United States National Grid)United States National Grid.
  • UTM (Universelle transversale Mercator-Projektion)Universal Transverse Mercator.
  • UTM ohne LeerzeichenUniverselle transversale Mercator-Projektion ohne Leerzeichen
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Features

Die aktualisierten Eingabe-Features.

Feature Layer

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

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

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

Gibt die Felder an, in denen die ausgewählten Geometrieeigenschaften berechnet werden.

Sie können ein vorhandenes Feld auswählen oder einen neuen Feldnamen angeben. Wenn ein neuer Feldname angegeben wird, ist der Feldtyp vom Typ der Werte abhängig, die in das Feld geschrieben werden.

  • Anzahl-Attribute werden in Long-Integer-Felder geschrieben.
  • Attribute für Fläche, Länge und X-, Y-, Z- und M-Koordinaten werden in Double-Felder geschrieben.
  • Koordinatenangaben wie Grad, Minuten, Sekunden oder MGRS werden in Textfelder geschrieben.

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

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

  • FEET_USDie Längeneinheit ist Fuß (USA).
  • METERSDie Längeneinheit ist Meter.
  • KILOMETERSDie Längeneinheit ist Kilometer.
  • MILES_USDie Längeneinheit ist Meilen (USA).
  • NAUTICAL_MILESDie Längeneinheit ist Seemeilen (USA).
  • YARDSDie Längeneinheit ist Yards (USA).
String
area_unit
(optional)

Hierüber geben Sie die für die Berechnung der Fläche verwendeten Einheiten an.

  • ACRESDie Flächeneinheiten sind Acres.
  • HECTARESDie Flächeneinheiten sind Hektar.
  • SQUARE_MILES_USDie Flächeneinheiten sind Quadratmeilen (USA).
  • SQUARE_KILOMETERSDie Flächeneinheiten sind Quadratkilometer.
  • SQUARE_METERSDie Flächeneinheiten sind Quadratmeter.
  • SQUARE_FEET_USDie Flächeneinheiten sind Quadratfuß (USA).
  • SQUARE_YARDSDie Flächeneinheiten sind Quadratyards (USA).
  • SQUARE_NAUTICAL_MILESDie Flächeneinheiten sind 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 WGS84 verwendet.

Coordinate System
coordinate_format
(optional)

Gibt das Koordinatenformat an, 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

NameErläuterungDatentyp
updated_features

Die aktualisierten Eingabe-Features.

Feature Layer

Codebeispiel

CalculateGeometryAttributes – Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion CalculateGeometryAttributes verwenden.

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: Erfordert J
  • Standard: Erfordert J
  • Advanced: Erfordert J

Verwandte Themen