Feature-Class-Ausdehnung neu berechnen (Data Management)

Zusammenfassung

Berechnet die Eigenschaften für die XY-, Z- und M-Ausdehnung einer Feature-Class basierend auf den Features in der Feature-Class neu.

Eine Feature-Class verfügt über eine räumliche Ausdehnung, die auf allen Koordinaten in der Feature-Class basiert. Diese räumliche Ausdehnung wird verwendet, wenn Sie einer Karte eine Feature-Class hinzufügen, um alle Features neu zu zentrieren und anzuzeigen. Damit nicht alle Features in der Feature-Class jedes Mal überprüft werden, wenn die Feature-Class einer Karte hinzugefügt wird (ein u. U. langer Vorgang), umfasst die Feature-Class eine Ausdehnungseigenschaft, die die letzte bekannte räumliche Ausdehnung enthält. Diese Ausdehnungseigenschaft wird jedoch nicht immer aktualisiert, wenn Features in der Feature-Class bearbeitet werden. Dies bedeutet, dass die Werte in der Ausdehnungseigenschaft möglicherweise nicht die tatsächliche räumliche Ausdehnung der Features darstellen. Das Werkzeug Feature-Class-Ausdehnung neu berechnen liest alle Features und aktualisiert die Eigenschaft für die Ausdehnung.

Hinweis:

XY-, Z- und M-Ausdehnungen sind nicht mit Raumbezugsdomänen identisch. Die XY-, Z- und M-Domänen in einem Raumbezug definieren den gültigen Bereich von Koordinatenwerten, die in einer Feature-Class gespeichert werden können. Die Feature-Class-Ausdehnungen spiegeln den tatsächlichen Bereich von Koordinatenwerten wider, die in der Feature-Class enthalten sind. Diese Ausdehnungen dürfen nicht größer sein als die Domänen.

Verwendung

• Dieses Werkzeug aktualisiert Geodatabase-Feature-Classes oder Shapefiles (Punkt, Multipoint, Linie oder Polygon).

• In einer Enterprise-Geodatabase ist die Ausdehnung eine Eigenschaft des Feature-Class-Schemas, für deren Ausführung eine exklusive Schemasperre erforderlich ist.

• Wird dieses Werkzeug mit der Feature-Class einer Enterprise-Geodatabase als Eingabe verwendet, wird die Ausdehnung basierend auf den Features berechnet, die in dieser Feature-Class in allen Versionen vorhanden sind. Die Ausdehnung wird weder verkleinert noch erweitert, es sei denn, dieses Werkzeug wird ausgeführt, nachdem die Datenbank komprimiert wurde.

• Der Parameter Ausdehnung speichern wird für nicht registrierte räumliche Tabellen in einer Datenbank oder Enterprise-Geodatabase unterstützt. Wenn der Parameter aktiviert ist, wird die neue Ausdehnung in den Metadaten der Shape-Spalte der zugrunde liegenden Tabelle gespeichert. Wenn der Parameter nicht aktiviert ist, wird die Ausdehnung neu berechnet, der Wert aber nicht gespeichert, was nützlich sein kann, wenn die zugrunde liegenden Daten häufig aktualisiert werden.

• Dieses Werkzeug kann nicht ausgeführt werden, wenn Ihnen keine Berechtigungen zum Bearbeiten der Feature-Class zugewiesen sind.

• Die Neuberechnung der Feature-Class-Ausdehnung kann nicht rückgängig gemacht werden.

• Die Werte für die Ausdehnung werden über die Eigenschaft extent der Funktion arcpy.Describe zurückgegeben.

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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Feature-Class	Das Shapefile oder die Geodatabase-Feature-Class, die aktualisiert wird.	Feature Layer
Ausdehnung speichern (optional)	Gibt an, ob die Ausdehnung für nicht registrierte Feature-Classes gespeichert wird. Dieser Parameter ist nur aktiv, wenn die Eingabe-Feature-Class eine nicht registrierte räumliche Tabelle in einer Datenbank oder Enterprise-Geodatabase ist. Wenn die Eingabe-Feature-Class häufig aktualisiert wird, könnten Sie festlegen, dass der Wert der neu berechneten Ausdehnung nicht gespeichert wird. Wenn Sie auswählen, dass die Ausdehnung gespeichert wird, wird die Ausdehnung nicht jedes Mal neu berechnet, wenn die Feature-Class zu einer Karte hinzugefügt wird. Aktiviert: Die Ausdehnung wird für die Eingabe-Feature-Class gespeichert. Deaktiviert: Die Ausdehnung wird nicht für die Eingabe-Feature-Class gespeichert. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Feature-Class	Die aktualisierte Feature-Class.	Feature Class

Python

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})

Name	Erläuterung	Datentyp
in_features	Das Shapefile oder die Geodatabase-Feature-Class, die aktualisiert wird.	Feature Layer
store_extent (optional)	Gibt an, ob die Ausdehnung für nicht registrierte Feature-Classes gespeichert wird. Dieser Parameter wird nur unterstützt, wenn die Eingabe-Feature-Class eine nicht registrierte räumliche Tabelle in einer Datenbank oder Enterprise-Geodatabase ist. Wenn die Eingabe-Feature-Class häufig aktualisiert wird, könnten Sie festlegen, dass der Wert der neu berechneten Ausdehnung nicht gespeichert wird. Wenn Sie auswählen, dass die Ausdehnung gespeichert wird, wird die Ausdehnung nicht jedes Mal neu berechnet, wenn die Feature-Class zur Karte hinzugefügt wird. STORE_EXTENT—Die Ausdehnung wird für die Eingabe-Feature-Class gespeichert. DO_NOT_STORE_EXTENT—Die Ausdehnung wird nicht für die Eingabe-Feature-Class gespeichert. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_features	Die aktualisierte Feature-Class.	Feature Class

Codebeispiel

RecalculateFeatureClassExtent: Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion RecalculateFeatureClassExtent im unmittelbaren Modus verwendet wird. Es berechnet die XY-, M- oder Z-Ausdehnung einer Feature-Class neu.

import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.management.RecalculateFeatureClassExtent(feature_class)

Umgebungen

Aktueller Workspace, Scratch-Workspace