Multidimensionales Raster verwalten (Multidimension)

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. Dadurch wird kein neues Dataset erstellt. 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 ein .crf-Standard-Raster ist, wird das Ziel zu einem multidimensionalen Raster, und in den Raster-Eigenschaften wird 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 Ausschnitte anhängen , Ausschnitte ersetzen oder Variablen anhängen verwendet werden kann.

Syntax

ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit})
ParameterErklärungDatentyp
target_multidimensional_raster

Das zu ändernde multidimensionale Raster.

Raster Dataset; Raster Layer
manage_mode
(optional)

Gibt den Typ der Änderung an, die am Ziel-Raster vorgenommen wird.

  • ADD_DIMENSIONEine Dimension wird dem multidimensionalen Eingabe-Raster hinzugefügt.
  • APPEND_SLICESAusschnitte des multidimensionalen Eingabe-Rasters werden am Ende der Ausschnitte für eine Dimension hinzugefügt. Dies ist die Standardeinstellung.
  • APPEND_VARIABLESDie Variablen der multidimensionalen Eingabe-Raster werden hinzugefügt.
  • REPLACE_SLICESVorhandene Ausschnitte werden bei bestimmten Dimensionswerten durch Ausschnitte eines anderen multidimensionalen Rasters ersetzt.
  • DELETE_VARIABLESEine oder mehrere Variablen werden aus dem multidimensionalen Raster gelöscht.
  • REMOVE_DIMENSIONEin 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
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

Abgeleitete Ausgabe

NameErklärungDatentyp
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.

# Import system modules
import arcpy

# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
	target = "C:/data/temp1980_1990.crf", manage_mode = "APPEND_SLICES",
	variables = "Temp", in_multidimensional_rasters = 
	["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"])
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"


# 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)
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.ManageMutidimensionalRaster_md(target_multidimensional_raster,
	manage_mode)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen