Multidimensionalen Raster-Layer erstellen (Multidimensional)

Zusammenfassung

Erstellt einen Raster-Layer aus einem multidimensionalen Raster-Dataset oder einem multidimensionalen Raster-Layer, indem Daten entlang definierter Variablen und Dimensionen aufgeteilt werden.

Verwendung

  • Mit diesem Werkzeug wird ein multidimensionaler Raster-Layer aus einem multidimensionalen Raster- oder Mosaik-Dataset durch Extrahieren einer Teilmenge von Variablen erstellt. Beispiel: Sie verfügen über ein Mosaik-Dataset, das die monatlichen Niederschlagsdaten von 30 Jahren enthält, und Sie möchten Daten für den Januar der einzelnen Jahre extrahieren, um zu ermitteln, wie sich der Niederschlag in diesem Monat im Lauf der Jahre verändert hat.

  • Zu den unterstützten multidimensionalen Raster-Datasets gehören solche im Cloud-Raster-Format (CRF), multidimensionale Mosaik-Datasets oder multidimensionale Raster-Layer, die von netCDF-, GRIB- oder HDF-Dateien generiert werden.

  • Dieses Werkzeug erstellt einen temporären Layer, den Sie auf einem Datenträger speichern müssen, wenn Sie ihn beibehalten möchten.

  • Verwenden Sie den Parameter Dimensionsdefinition, um Dimensionen über ein Intervall, einen Wert oder einen Wertebereich aufzuteilen. Stehen Ihnen beispielsweise Daten über 10 Jahre zum Salzgehalt des Meerwassers zur Verfügung, die monatlich für alle 2 Meter bis zu einer Tiefe von 500 Metern erfasst wurden, können Sie die verschiedenen Optionen zur Dimensionsdefinition für die folgenden Szenarien verwenden:

    • Extrahieren der Daten zum Salzgehalt für den Monat Januar über den Zeitraum von 10 Jahren. Wählen Sie Durch Werte aus. Legen Sie für Dimension den Wert StdTime und für Werte die Option Januar fest.
    • Aufteilen der Daten zum Salzgehalt für den Tiefenbereich 0 bis 150 Meter. Wählen Sie Nach Bereichen aus. Legen Sie für Dimension den Wert StdZ, für Minimalwert den Wert -150 und für Maximalwert den Wert 0 fest.
    • Extrahieren der Daten zum Salzgehalt für die ersten 10 Tage des Monats Januar über einen Zeitraum von 10 Jahren. Wählen Sie Nach Iteration aus. Legen Sie für Dimension den Wert StdTime, für Beginn der ersten Iteration und Ende der ersten Iteration den entsprechenden Beginn und das Ende des Iterationszeitraums und für Schritt den Wert 1 fest, und geben Sie unter Einheit die Option Jahre an.

  • Um einen nicht-multidimensionalen Layer zu erstellen, der Daten aus einem einzelnen Ausschnitt des multidimensionalen Rasters enthält, wählen Sie für den Parameter Dimensionsdefinition die Einstellung Nach Werten, wählen Sie einen einzelnen Dimensionswert aus, und aktivieren Sie den Parameter Ohne Dimensionen.

Parameter

BeschriftungErläuterungDatentyp
Multidimensionales Eingabe-Raster

Das als Eingabe verwendete multidimensionale Raster-Dataset.

Als Eingaben werden netCDF-, GRIB-, HDF-, CRF- und Zarr-Dateien, ein multidimensionales Mosaik-Dataset, ein multidimensionaler Image-Service, eine OPeNDAP-URL oder ein multidimensionaler Raster-Layer unterstützt.

Hinweis:

Zarr-Dateien müssen die Erweiterung .zarr aufweisen und über eine .zgroup-Datei im Ordner verfügen.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Multidimensionaler Ausgabe-Raster-Layer

Der als Ausgabe verwendete multidimensionale Raster-Layer.

Raster Layer
Variablen
(optional)

Die Variablen, die in den multidimensionalen Ausgabe-Raster-Layer aufgenommen werden. Wenn keine Variable angegeben ist, wird die erste Variable verwendet.

String
Dimensionsdefinition
(optional)

Gibt die Methode an, die zum Aufteilen der Dimension verwendet wird.

  • AlleFür jede Dimension wird der volle Bereich verwendet. Dies ist die Standardeinstellung.
  • Nach BereichenDie Dimension wird anhand eines Bereichs oder einer Liste von Bereichen aufgeteilt.
  • Nach IterationDie Dimension wird über eine angegebene Intervallgröße aufgeteilt.
  • Durch WerteDie Dimension wird anhand einer Liste von Dimensionswerten aufgeteilt.
String
Bereich
(optional)

Der Bereich oder die Liste der Bereiche für die angegebene Dimension.

Die Daten werden basierend auf dem Dimensionsnamen und den minimalen und maximalen Werten für den Bereich aufgeteilt. Dieser Parameter ist erforderlich, wenn für den Parameter Dimensionsdefinition die Option Nach Bereichen festgelegt wurde.

Value Table
Werte
(optional)

Eine Liste von Werten für die angegebene Dimension. Dieser Parameter ist erforderlich, wenn für den Parameter Dimensionsdefinition die Option Nach Werten festgelegt wurde.

Value Table
Dimension
(optional)

Die Dimension, an der entlang die Variablen aufgeteilt werden. Dieser Parameter ist erforderlich, wenn für den Parameter Dimensionsdefinition die Option Nach Iteration festgelegt wurde.

String
Beginn der ersten Iteration
(optional)

Der Beginn des ersten Intervalls. Die Iteration durch das Dataset erfolgt anhand dieses Intervalls. Dieser Parameter ist erforderlich, wenn für den Parameter Bemaßungsdefinition die Option Nach Iteration festgelegt wurde.

String
Ende der ersten Iteration
(optional)

Das Ende des ersten Intervalls. Die Iteration durch das Dataset erfolgt anhand dieses Intervalls. Dieser Parameter ist erforderlich, wenn für den Parameter Bemaßungsdefinition die Option Nach Iteration festgelegt wurde.

String
Schritt
(optional)

Die Häufigkeit, in der die Daten aufgeteilt werden. Dieser Parameter ist erforderlich, wenn für den Parameter Bemaßungsdefinition die Option Nach Iteration festgelegt wurde.

Double
Einheit
(optional)

Gibt die verwendete Iterationseinheit an. Dieser Parameter ist erforderlich, wenn für den Parameter Dimensionsdefinition die Option Nach Iteration und für den Parameter Dimension der Wert StdTime festgelegt wurde.

  • StundenDie angegebene Zeiteinheit lautet "Stunden".
  • TageDie angegebene Zeiteinheit lautet "Tage".
  • WochenDie angegebene Zeiteinheit lautet "Wochen".
  • MonateDie angegebene Zeiteinheit lautet "Monate".
  • JahreDie angegebene Zeiteinheit lautet "Jahre".
String
Ausdehnung
(optional)

Die Ausdehnung (umgebendes Feld) des Layers. Wählen Sie unter Ausdehnung die entsprechende Option für den Layer aus.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung darstellen Draw Extent: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein.
    Hinweis:

    Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar.

    Hinweis:

    Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen.

  • Ausdehnung eines Layers:Layer Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist.

    Jeder Karten-Layer bietet die folgenden Optionen:

    • Alle Features Alles auswählen: Die Ausdehnung aller Features im Layer.
    • Ausgewählte FeaturesArea from Selected Features: Die Ausdehnung der ausgewählten Features im Layer.
    • Sichtbare Features Extent Indicator: Die Ausdehnung der sichtbaren Features im Layer.
      Hinweis:

      Die Ausdehnungen der Optionen Ausgewählte Features Area from Selected Features und Sichtbare Features Extent Indicator sind nur für Feature-Layer verfügbar.

  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Zwischenablage Einfügen: Die Ausdehnung kann in die Zwischenablage kopiert und aus der Zwischenablage eingefügt werden.
    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
    • Ausdehnung einfügen Einfügen: Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.
    Hinweis:

    Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug.

  • Ausdehnung zurücksetzen: ZurücksetzenDie Ausdehnung wird auf den Standardwert zurückgesetzt.
  • Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.
    Vorsicht:

    Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Extent
Ohne Dimensionen
(optional)

Gibt an, ob der Layer Dimensionswerte enthält. Dieser Parameter ist nur aktiv, wenn ein einzelner Ausschnitt zur Erstellung eines Layers gewählt wird.

  • Aktiviert: Der Layer enthält keine Dimensionswerte.
  • Deaktiviert: Der Layer enthält Dimensionswerte. Dies ist die Standardeinstellung.

Boolean
Raumbezug
(optional)

Das Koordinatensystem für den Wert des Parameters Multidimensionaler Ausgabe-Raster-Layer. Dieser Parameter wird nur dann angewendet, wenn der Wert des Parameters Multidimensionales Eingabe-Raster im Zarr-Format vorliegt. Verwenden Sie diesen Parameter, um den Raumbezug zu definieren, falls er in den Daten nicht vorhanden ist.

Coordinate System

arcpy.management.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit}, {template}, {dimensionless}, {spatial_reference})
NameErläuterungDatentyp
in_multidimensional_raster

Das als Eingabe verwendete multidimensionale Raster-Dataset.

Als Eingaben werden netCDF-, GRIB-, HDF-, CRF- und Zarr-Dateien, ein multidimensionales Mosaik-Dataset, ein multidimensionaler Image-Service, eine OPeNDAP-URL oder ein multidimensionaler Raster-Layer unterstützt.

Hinweis:

Zarr-Dateien müssen die Erweiterung .zarr aufweisen und über eine .zgroup-Datei im Ordner verfügen.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
out_multidimensional_raster_layer

Der als Ausgabe verwendete multidimensionale Raster-Layer.

Raster Layer
variables
[variables,...]
(optional)

Die Variablen, die in den multidimensionalen Ausgabe-Raster-Layer aufgenommen werden. Wenn keine Variable angegeben ist, wird die erste Variable verwendet.

String
dimension_def
(optional)

Gibt die Methode an, die zum Aufteilen der Dimension verwendet wird.

  • ALLFür jede Dimension wird der volle Bereich verwendet. Dies ist die Standardeinstellung.
  • BY_RANGESDie Dimension wird anhand eines Bereichs oder einer Liste von Bereichen aufgeteilt.
  • BY_ITERATIONDie Dimension wird über eine angegebene Intervallgröße aufgeteilt.
  • BY_VALUEDie Dimension wird anhand einer Liste von Dimensionswerten aufgeteilt.
String
dimension_ranges
[dimension_ranges,...]
(optional)

Der Bereich oder die Liste der Bereiche für die angegebene Dimension.

Die Daten werden basierend auf dem Dimensionsnamen und den minimalen und maximalen Werten für den Bereich aufgeteilt. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_RANGES festgelegt wurde.

Value Table
dimension_values
[dimension_values,...]
(optional)

Eine Liste von Werten für die angegebene Dimension. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_VALUE festgelegt wurde.

Value Table
dimension
(optional)

Die Dimension, an der entlang die Variablen aufgeteilt werden. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_ITERATION festgelegt ist.

String
start_of_first_iteration
(optional)

Der Beginn des ersten Intervalls. Die Iteration durch das Dataset erfolgt anhand dieses Intervalls. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_ITERATION festgelegt wurde.

String
end_of_first_iteration
(optional)

Das Ende des ersten Intervalls. Die Iteration durch das Dataset erfolgt anhand dieses Intervalls. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_ITERATION festgelegt wurde.

String
iteration_step
(optional)

Die Häufigkeit, in der die Daten aufgeteilt werden. Dieser Parameter ist erforderlich, wenn der Parameter dimension_def auf BY_ITERATION festgelegt wurde.

Double
iteration_unit
(optional)

Gibt die verwendete Iterationseinheit an. Dieser Parameter ist erforderlich, wenn für den Parameter dimension_def der Wert BY_ITERATION und für den Parameter dimension die Option StdTime festgelegt wurde.

  • HOURSDie angegebene Zeiteinheit lautet "Stunden".
  • DAYSDie angegebene Zeiteinheit lautet "Tage".
  • WEEKSDie angegebene Zeiteinheit lautet "Wochen".
  • MONTHSDie angegebene Zeiteinheit lautet "Monate".
  • YEARSDie angegebene Zeiteinheit lautet "Jahre".
String
template
(optional)

Die Ausdehnung (umgebendes Feld) des Layers. Wählen Sie unter Ausdehnung die entsprechende Option für den Layer aus.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.
Extent
dimensionless
(optional)

Gibt an, ob der Layer Dimensionswerte enthält. Dieser Parameter ist nur aktiviert, wenn ein einzelner Ausschnitt zur Erstellung eines Layers gewählt wird.

  • NO_DIMENSIONSDer Layer enthält keine Dimensionswerte.
  • DIMENSIONSDer Layer enthält Dimensionswerte. Dies ist die Standardeinstellung.
Boolean
spatial_reference
(optional)

Das Koordinatensystem für den Wert des Parameters out_multidimensional_raster_layer. Dieser Parameter wird nur dann angewendet, wenn der Wert des Parameters in_multidimensional_raster im Zarr-Format vorliegt. Verwenden Sie diesen Parameter, um den Raumbezug zu definieren, falls er in den Daten nicht vorhanden ist.

Coordinate System

Codebeispiel

MakeMultidimensionalRasterLayer – Beispiel 1 (Python-Fenster)

Extrahieren Sie eine Teilmenge von Variablen aus einem multidimensionalen Raster mithilfe der BY_RANGES-Methode.

# Import system modules
import arcpy

# Execute
MakeMultidim = MakeMultidimensionalRasterLayer("C:\data\Ocean_Data.crf", "salinity", "BY_RANGES", "StdZ -500 -100", "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414")


# Save Output
MakeMultidim.save("C:\data\Salinity_MultidimLayer.crf")
MakeMultidimensionalRasterLayer – Beispiel 2 (eigenständiges Skript)

Extrahieren Sie die Variable für die Wassertemperatur aus einem multidimensionalen Raster für bestimmte Tiefewerte mithilfe der BY_VALUE-Methode.

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"

#Execute

arcpy.md.MakeMultidimensionalRasterLayer(
	in_multidimensional_raster, out_multidimensional_raster_layer, variables, 
	dimension_def, dimension_values, template)
MakeMultidimensionalRasterLayer – Beispiel 3 (eigenständiges Skript)

Extrahieren Sie die Variable für Salzgehalt aus einem multidimensionalen Raster mithilfe der BY_ITERATION-Methode.

# Import system modules
import arcpy
 
# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer =  r"C:\data\salinity_slice.crf"
variables = "salinity"
dimension_def = "BY_ITERATION"
dimension = "StdTime"
start_of_first_iteration = "2009-01-01"
end_of_first_iteration = "2009-01-10"
iteration_step = "1"
iteration_unit = "YEARS"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"
 
#Execute
 
arcpy.md.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit, template)