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. 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. Der Parameter unterstützt die folgenden Optionen:

    • Dimension hinzufügen: Fügt 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.

      Hinweis:

      Wenn ein Eingabe-CRF-Dataset kein multidimensionales Raster ist, kann das Werkzeug the Multidimensionales Raster verwalten nicht zum Erstellen eines multidimensionalen Rasters verwendet werden. Verwenden Sie stattdessen das Werkzeug Raster-Eigenschaften festlegen, um ein multidimensionales Raster zu erstellen.

    • Dimension entfernen: Entfernt eine Dimension aus dem Dataset. Jede zu entfernende Dimension kann nur einen einzigen Wert enthalten.
    • Ausschnitte anhängen: Fügt 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öscht Ausschnitte aus dem multidimensionalen Ziel-Raster und ersetzt 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ügt 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öscht 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 die gleiche Zellengröße aufweisen, damit die Optionen Ausschnitte anhängen, Ausschnitte ersetzen und Variablen anhängen des Parameters Verwaltungsmodus verwendet werden können.

Parameter

BeschriftungErläuterungDatentyp
Multidimensionales Ziel-Raster

Das zu ändernde multidimensionale Raster in CRF.

Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
Verwaltungsmodus
(optional)

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

  • Dimension hinzufügenEine Dimension wird dem multidimensionalen Eingabe-Raster hinzugefügt.
  • Ausschnitte anhängenAusschnitte aus den multidimensionalen Eingabe-Rastern werden am Ende der Ausschnitte für eine Dimension hinzugefügt. Dies ist die Standardeinstellung.
  • Variablen anhängenDie Variablen der multidimensionalen Eingabe-Raster werden hinzugefügt.
  • Ausschnitte ersetzenVorhandene Ausschnitte werden bei bestimmten Dimensionswerten durch Ausschnitte eines anderen multidimensionalen Rasters ersetzt.
  • Variablen löschenEine oder mehrere Variablen werden aus dem multidimensionalen Raster gelöscht.
  • Dimension entfernenEin multidimensionales Raster mit einem Ausschnitt wird in ein Raster ohne Dimension konvertiert.
String
Variablen
(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
Multidimensionale Eingabe-Raster
(optional)

Die multidimensionalen Raster-Datasets, die Ausschnitte oder Variablen enthalten, die dem multidimensionalen Ziel-Raster hinzugefügt werden sollen. Dieser Parameter ist erforderlich, wenn der Parameter Verwaltungsmodus auf Ausschnitte anhängen, Ausschnitte ersetzen oder Variablen anhängen festgelegt ist.

Raster Layer; Image Service
Dimensionsname
(optional)

Der Name der Dimension, die den Raster-Eigenschaften hinzugefügt oder aus ihnen entfernt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter Verwaltungsmodus auf Dimension hinzufügen festgelegt ist. Wenn der Parameter Verwaltungsmodus auf Dimension entfernen festgelegt ist, kann die angegebene Dimension nur einen einzigen Wert enthalten. Wenn der Parameter Dimensionsname nicht angegeben ist und die Eingabe nur einen einzigen Ausschnitt enthält, werden alle Dimensionen entfernt.

String
Dimensionswert
(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 der Parameter Verwaltungsmodus auf Dimension hinzufügen festgelegt ist.

String
Dimensionsbeschreibung
(optional)

Die Beschreibung der neuen Dimension, die den Raster-Eigenschaften als Metadaten hinzugefügt wird. Dieser Parameter ist aktiv, wenn der Parameter Verwaltungsmodus auf Dimension hinzufügen festgelegt ist.

String
Dimensionseinheit
(optional)

Die Einheit der neuen Dimension, die den Raster-Eigenschaften als Metadaten hinzugefügt wird. Dieser Parameter ist aktiv, wenn der Parameter Verwaltungsmodus auf Dimension hinzufügen festgelegt ist.

String
Statistik aktualisieren
(optional)

Gibt an, ob die Statistik für das multidimensionale Raster-Dataset neu berechnet wird.

  • Aktiviert: Die Statistik wird neu berechnet. Dies ist die Standardeinstellung.
  • Deaktiviert: Die Statistik wird nicht neu berechnet.
Boolean
Umgruppierung aktualisieren
(optional)

Gibt an, ob die Umgruppierung für das multidimensionale Raster-Dataset neu erstellt wird.

  • Aktiviert: Die Umgruppierung wird neu erstellt. Wenn keine Umgruppierung vorhanden ist, wird eine neue Umgruppierung erstellt. Dies ist die Standardeinstellung.
  • Deaktiviert: Die Umgruppierung wird nicht neu erstellt.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Multidimensionales Ziel-Raster

Das geänderte multidimensionale Raster.

Raster Layer

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

Das zu ändernde multidimensionale Raster in CRF.

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_DIMENSIONEine Dimension wird dem multidimensionalen Eingabe-Raster hinzugefügt.
  • APPEND_SLICESAusschnitte aus den multidimensionalen Eingabe-Rastern 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 der Parameter manage_mode auf APPEND_SLICES, REPLACE_SLICES oder APPEND_VARIABLES festgelegt ist.

Raster Layer; Image Service
dimension_name
(optional)

Der Name der Dimension, die den Raster-Eigenschaften hinzugefügt oder aus ihnen entfernt werden soll. Dieser Parameter ist erforderlich, wenn manage_mode auf ADD_DIMENSION festgelegt ist. Wenn der Parameter manage_mode auf REMOVE_DIMENSION festgelegt ist, kann die angegebene Dimension nur einen einzigen Wert enthalten. Wenn der Parameter dimension_name nicht angegeben ist und die Eingabe nur einen einzigen Ausschnitt enthält, werden alle Dimensionen entfernt.

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 der Parameter 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 wird aktiviert, wenn der Parameter manage_mode auf ADD_DIMENSION gesetzt ist.

String
dimension_unit
(optional)

Die Einheit der neuen Dimension, die den Raster-Eigenschaften als Metadaten hinzugefügt wird. Dieser Parameter wird aktiviert, wenn der Parameter 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_STATISTICSDie Statistik wird neu berechnet. Dies ist die Standardeinstellung.
  • NO_UPDATE_STATISTICSDie Statistik wird nicht neu berechnet.
Boolean
update_transpose
(optional)

Gibt an, ob die Umgruppierung für das multidimensionale Raster-Dataset neu erstellt wird.

  • UPDATE_TRANSPOSEDie Umgruppierung wird neu erstellt. Wenn keine Umgruppierung vorhanden ist, wird eine neue Umgruppierung erstellt. Dies ist die Standardeinstellung.
  • NO_UPDATE_TRANSPOSEDie Umgruppierung wird nicht neu erstellt.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
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.md.ManageMultidimensionalRaster(target_multidimensional_raster,
	manage_mode)

Lizenzinformationen

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

Verwandte Themen