Multidimensionales Raster verwalten (Multidimension)—ArcGIS Pro

Zusammenfassung

Bearbeitet ein multidimensionales Raster durch Hinzufügen oder Löschen von Variablen oder Dimensionen.

Verwendung

Verwenden Sie dieses Werkzeug zum Bearbeiten eines multidimensionalen Rasters. Mit diesem Werkzeug wird kein neues Dataset generiert. Das multidimensionale Raster wird geändert. Verwenden Sie zum Erstellen eines Datasets das Werkzeug Teilmenge eines multidimensionalen Rasters oder das Werkzeug Raster kopieren, bevor Sie mit diesem Werkzeug weitere Änderungen vornehmen.
Die Ziel- und Eingabe-Raster müssen das Cloud-Raster-Format (CRF) aufweisen. Gegenwärtig wird in diesem Werkzeug kein anderes Format unterstützt. Verwenden Sie zum Konvertieren eines multidimensionalen Mosaik-Datasets oder eines multidimensionalen Raster-Layers in eine .crf-Datei das Werkzeug Raster kopieren, wählen Sie CRF als Ausgabeformat aus, und legen Sie fest, dass das Dataset multidimensional verarbeitet werden soll.
Mit dem Parameter Verwaltungsmodus wird der Typ der durchzuführenden Bearbeitungsoperation bestimmt. Es sind sechs Optionen verfügbar:
- Dimension hinzufügen: Fügen Sie eine Dimension zum Dataset hinzu. Name, Beschreibung und Einheit der Dimension müssen angegeben werden. Nach dem Hinzufügen der Dimension können Ausschnitte eines anderen multidimensionalen Datasets mit der gleichen Dimension angefügt werden.
  Wenn das Ziel-Raster eine Standard-.crf-Raster-Datei ist, wird das Ziel durch Hinzufügen einer Dimension zu einem multidimensionalen Raster, und in den Raster-Eigenschaften werden Multidimensionale Informationen hinzugefügt.
- Dimension entfernen: Entfernen Sie eine Dimension aus dem Dataset. Ist nur eine Dimension vorhanden, kann es im Dataset nur einen Ausschnitt geben.
- Ausschnitte anhängen: Fügen Sie Ausschnitte von einem oder mehreren multidimensionalen Eingabe-Rastern an das Ende des Stapels von Ausschnitten im multidimensionalen Ziel-Raster hinzu. Die Variablen- und Dimensionsnamen in den multidimensionalen Rastern müssen genau übereinstimmen. Zudem darf es zwischen den Rastern keine überlappenden Dimensionswerte geben. Die angefügten Ausschnitte müssen Dimensionswerte aufweisen, die hinter dem Ende der Dimensionswerte im multidimensionalen Ziel-Raster liegen.
- Ausschnitte ersetzen: Löschen Sie Ausschnitte aus dem multidimensionalen Ziel-Raster, und ersetzen Sie sie durch Ausschnitte aus einem anderen multidimensionalen Raster. Die Variablen- und Dimensionsnamen in den multidimensionalen Rastern müssen genau übereinstimmen. Zudem werden nur die überlappenden Ausschnitte ersetzt.
- Variablen anhängen: Fügen Sie alle Variablen von einem oder mehreren multidimensionalen Eingabe-Rastern an das Ende der Liste von Variablen im multidimensionalen Ziel-Raster hinzu. Wenn der Variablenname im multidimensionalen Ziel-Raster bereits vorhanden ist, wird er nicht hinzugefügt. Wenn mehrere multidimensionale Eingabe-Raster eine Variable mit dem gleichen Namen enthalten, wird die Variable aus dem zuerst aufgeführten Eingabe-Raster zum multidimensionalen Ziel-Raster hinzugefügt.
- Variablen löschen: Löschen Sie eine oder mehrere Variablen und die zugehörigen Ausschnitte aus dem multidimensionalen Ziel-Raster. Im multidimensionalen Raster muss mindestens eine Variable vorhanden sein.
Eingabedaten müssen genau den gleichen Raumbezug, die gleiche räumliche Ausdehnung und Zellengröße aufweisen, damit die Option Ausschnitte anhängen, Ausschnitte ersetzen oder Variablen anhängen verwendet werden kann.

Syntax

arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})

Parameter	Erklärung	Datentyp
target_multidimensional_raster	Das multidimensionale Raster im Cloud-Raster-Format (.crf), das geändert werden soll.	Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
manage_mode (optional)	Gibt den Typ der Änderung an, die am Ziel-Raster vorgenommen wird. ADD_DIMENSION —Eine Dimension wird dem multidimensionalen Eingabe-Raster hinzugefügt. APPEND_SLICES —Ausschnitte aus den multidimensionalen Eingabe-Rastern werden am Ende der Ausschnitte für eine Dimension hinzugefügt. Dies ist die Standardeinstellung. APPEND_VARIABLES —Die Variablen der multidimensionalen Eingabe-Raster werden hinzugefügt. REPLACE_SLICES —Vorhandene Ausschnitte werden bei bestimmten Dimensionswerten durch Ausschnitte eines anderen multidimensionalen Rasters ersetzt. DELETE_VARIABLES —Eine oder mehrere Variablen werden aus dem multidimensionalen Raster gelöscht. REMOVE_DIMENSION —Ein multidimensionales Raster mit einem Ausschnitt wird in ein Raster ohne Dimension konvertiert.	String
variables [variables,...] (optional)	Die Variablen, die im multidimensionalen Ziel-Raster geändert werden. Dieser Parameter ist erforderlich, wenn die durchgeführte Operation die Änderung einer vorhandenen Variablen ist. Wenn keine Variable angegeben ist, wird die erste Variable im multidimensionalen Ziel-Raster analysiert.	String
in_multidimensional_rasters [in_multidimensional_rasters,...] (optional)	Die multidimensionalen Raster-Datasets, die Ausschnitte oder Variablen enthalten, die dem multidimensionalen Ziel-Raster hinzugefügt werden sollen. Dieser Parameter ist erforderlich, wenn manage_mode auf APPEND_SLICES, REPLACE_SLICES oder APPEND_VARIABLES festgelegt ist.	Raster Layer; Image Service
dimension_name (optional)	Der Name der neuen Dimension, die den Raster-Eigenschaften hinzugefügt wird. Dieser Parameter ist erforderlich, wenn manage_mode auf ADD_DIMENSION festgelegt ist.	String
dimension_value (optional)	Der Wert der Dimension, die hinzugefügt werden soll. Bei dem Wert kann es sich um einen einzelnen Wert oder einen Wertebereich handeln. Geben Sie für einen Wertebereich die Minimal- und Maximalwerte getrennt durch ein Komma an. Geben Sie beispielsweise für eine neue Höhendimension 0,10 ein, um eine Dimension zu generieren, bei der der erste Ausschnitt Informationen für die ersten 10 Meter Höhe enthält. Dieser Parameter ist erforderlich, wenn manage_mode auf ADD_DIMENSION festgelegt ist.	String
dimension_description (optional)	Die Beschreibung der neuen Dimension, die den Raster-Eigenschaften als Metadaten hinzugefügt wird. Dieser Parameter ist aktiviert, wenn manage_mode auf ADD_DIMENSION festgelegt ist.	String
dimension_unit (optional)	Die Einheit der neuen Dimension, die den Raster-Eigenschaften als Metadaten hinzugefügt wird. Dieser Parameter ist aktiviert, wenn manage_mode auf ADD_DIMENSION festgelegt ist.	String
update_statistics (optional)	Gibt an, ob die Statistik für das multidimensionale Raster-Dataset neu berechnet wird. UPDATE_STATISTICS —Die Statistik wird neu berechnet. Dies ist die Standardeinstellung. NO_UPDATE_STATISTICS —Die Statistik wird nicht neu berechnet.	Boolean
update_transpose (optional)	Gibt an, ob die Umgruppierung für das multidimensionale Raster-Dataset neu erstellt wird. UPDATE_TRANSPOSE —Die Umgruppierung wird neu erstellt. Wenn keine Umgruppierung vorhanden ist, wird eine neue Umgruppierung erstellt. Dies ist die Standardeinstellung. NO_UPDATE_TRANSPOSE —Die Umgruppierung wird nicht neu erstellt.	Boolean

Abgeleitete Ausgabe

Name	Erklärung	Datentyp
updated_target_multidimensional_raster	Das geänderte multidimensionale Raster.	Raster-Layer

Codebeispiel

ManageMultidimensionalRaster – Beispiel 1 (Python-Fenster)

Mit diesem Beispiel werden Ausschnitte an das Ende eines multidimensionalen Rasters angefügt, und die Statistik wird aktualisiert.

# Import system modules
import arcpy

# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
	"C:/data/temp1980_1990.crf", "APPEND_SLICES", "Temp", 
	["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"],None,
	None,None, None, "UPDATE_STATISTICS")

ManageMultidimensionalRaster – Beispiel 2 (eigenständiges Skript)

Mit diesem Beispiel werden Ausschnitte ersetzt, eine Variable hinzugefügt und eine Dimension zum multidimensionalen Ziel-Raster hinzugefügt.

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/hycom.crf"
manage_mode_replace = "REPLACE_SLICES"
manage_mode_append = "APPEND_VARIABLES"
manage_mode_newDimension = "ADD_DIMENSION"
variables = "water_temp"
replace_multidimensional_rasters = "C:/new_data/new_hycom1985.crf"
salinity_multidimensional_raster = "C:/data/salinity.crf"
dimension_name = "Depth"
dimension_value = "0,5"
dimension_description = "Depth at 5m increments"
dimension_unit = "meter"
update_stats = "UPDATE_STATISTICS"
update_transpose = "UPDATE_TRANSPOSE"


# Replace existing slices with new slices
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster,manage_mode_replace, 
	variables, replace_multidimensional_rasters)

# Append salinity variable
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_append,
	'', salinity_multidimensional_raster)
	
# Add a new dimension, depth, for the water temperature variable
# Depth will be measured in 5 meter increments
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit,
	update_stats, update_transpose)

ManageMultidimensionalRaster – Beispiel 3 (eigenständiges Skript)

Mit diesem Beispiel werden Dimensionen aus einem multidimensionalen Raster mit einem Ausschnitt entfernt.

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/precip.crf"
manage_mode = "REMOVE_DIMENSION"

# Remove dimension to make input data dimensionless
arcpy.ManageMultidimensionalRaster_md(target_multidimensional_raster,
	manage_mode)

Umgebungen

Faktor für parallele Verarbeitung

Lizenzinformationen

Basic: Ja
Standard: Ja
Advanced: Ja