Beschriftung | Erläuterung | Datentyp |
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.
| 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.
| String |
Ausdehnung (optional) | Die Ausdehnung (umgebendes Feld) des Layers. Wählen Sie unter Ausdehnung die entsprechende Option für den Layer aus.
| 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.
| 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 |
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
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})
Name | Erläuterung | Datentyp |
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.
| 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.
| String |
template (optional) | Die Ausdehnung (umgebendes Feld) des Layers. Wählen Sie unter Ausdehnung die entsprechende Option für den Layer aus.
| 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.
| 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
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")
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)
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)