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

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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. 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
Längeneinheit (optional)	Gibt die Einheit an, die zum Berechnen der Länge verwendet wird. Fuß (USA)—Die Längeneinheit ist Fuß (USA). Meter—Die Längeneinheit ist Meter. Kilometer—Die 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. Acres—Die Flächeneinheiten sind Acres. Hektar—Die Flächeneinheiten sind Hektar. Quadratmeilen (USA)—Die Flächeneinheiten sind Quadratmeilen (USA). Quadratkilometer—Die Flächeneinheiten sind Quadratkilometer. Quadratmeter—Die 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 Eingabe—Die Raumbezugseinheiten der Eingabe-Features werden für die Koordinatenformatierung verwendet. Dies ist die Standardeinstellung. Dezimalgrad—Dezimalgrad. 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 Leerzeichen—Universelle transversale Mercator-Projektion ohne Leerzeichen	String

Abgeleitete Ausgabe

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

Python

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

Name	Erläuterung	Datentyp
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. 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)	Gibt die Einheit an, die zum Berechnen der Länge verwendet wird. FEET_US—Die Längeneinheit ist Fuß (USA). METERS—Die Längeneinheit ist Meter. KILOMETERS—Die Längeneinheit ist Kilometer. MILES_US—Die Längeneinheit ist Meilen (USA). NAUTICAL_MILES—Die Längeneinheit ist Seemeilen (USA). YARDS—Die Längeneinheit ist Yards (USA).	String
area_unit (optional)	Hierüber geben Sie die für die Berechnung der Fläche verwendeten Einheiten an. ACRES—Die Flächeneinheiten sind Acres. HECTARES—Die Flächeneinheiten sind Hektar. SQUARE_MILES_US—Die Flächeneinheiten sind Quadratmeilen (USA). SQUARE_KILOMETERS—Die Flächeneinheiten sind Quadratkilometer. SQUARE_METERS—Die Flächeneinheiten sind Quadratmeter. SQUARE_FEET_US—Die Flächeneinheiten sind Quadratfuß (USA). SQUARE_YARDS—Die Flächeneinheiten sind Quadratyards (USA). SQUARE_NAUTICAL_MILES—Die 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_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

Name	Erläuterung	Datentyp
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"]])

Umgebungen

Ausgabe-Koordinatensystem, Aktueller Workspace

Sonderfälle

Lizenzinformationen

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