Étiquette | Explication | Type de données |
Raster multidimensionnel en entrée | Jeu de données raster multidimensionnelles en entrée. Les entrées prises en charge sont les fichiers netCDF, GRIB, HDF, CRF et Zarr, un jeu de données mosaïque multidimensionnelles, un service d’imagerie multidimensionnelle, une URL OPeNDAP ou une couche raster multidimensionnelle. Remarque :Un fichier Zarr doit avoir une extension .zarr, avec un fichier .zgroup dans le dossier. | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
Output Multidimensional Raster Layer (Couche raster multidimensionnelle en sortie) | Couche raster multidimensionnelle en sortie. | Raster Layer |
Variables (Facultatif) | Variables incluses dans la couche raster multidimensionnelle en sortie. Si aucune variable n’est spécifiée, la première variable est utilisée. | String |
Dimension Definition (Définition de la dimension) (Facultatif) | Précise la méthode utilisée pour découper la dimension en tranches.
| String |
Plage (Facultatif) | Plage ou liste de plages de la dimension indiquée. Permet de découper les données en tranches en fonction du nom de la dimension et des valeurs minimale et maximale de la plage. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Ranges (Par plages). | Value Table |
Valeurs (Facultatif) | Liste de valeurs pour la dimension indiquée. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Values (Par valeurs). | Value Table |
Dimension (Facultatif) | Dimension sur laquelle les variables sont découpées en tranches. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Iteration (Par itération). | String |
Start of first iteration (Début de la première itération) (Facultatif) | Début du premier intervalle. Cet intervalle est employé pour l’itération au sein du jeu de données. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Iteration (Par itération). | String |
End of first iteration (Fin de la première itération) (Facultatif) | Fin du premier intervalle. Cet intervalle est employé pour l’itération au sein du jeu de données. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Iteration (Par itération). | String |
Intervalle (Facultatif) | Fréquence à laquelle les données sont découpées en tranches. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Iteration (Par itération). | Double |
Unité (Facultatif) | Spécifie l’unité de l’itération. Ce paramètre est requis lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Iteration (Par itération) et que le paramètre Dimension a pour valeur StdTime.
| String |
Étendue (Facultatif) | Étendue (emprise) de la couche. Sélectionnez l’option Extent (Étendue) appropriée pour la couche.
| Extent |
Dimensionless (Sans dimension) (Facultatif) | Spécifie si la couche possède des valeurs de dimension. Ce paramètre est activé uniquement si une seule tranche est sélectionnée pour la création d’une couche.
| Boolean |
Référence spatiale (Facultatif) | Système de coordonnées de la valeur du paramètre Output Multidimensional Raster Layer (Couche raster multidimensionnelle en sortie). Ce paramètre s’applique uniquement lorsque la valeur du paramètre Input Multidimensional Raster (Raster multidimensionnel en entrée) est au format Zarr. Utilisez ce paramètre pour définir la référence spatiale si elle est absente des données. | Coordinate System |
Synthèse
Crée une couche raster à partir d’un jeu de données raster multidimensionnelles ou d’une couche raster multidimensionnelle en découpant des tranches de données le long de variables et de dimensions définies.
Utilisation
Cet outil crée une couche raster multidimensionnelle à partir d’un raster multidimensionnel ou d’un jeu de données mosaïque en procédant à l’extraction d’un sous-ensemble de variables. Vous pouvez ainsi disposer d’un jeu de données mosaïque contenant 30 années de données de précipitations mensuelles et souhaiter extraire uniquement les données de chaque mois de janvier afin d’observer l’évolution des précipitations pour ce mois.
Les jeux de données raster multidimensionnelles pris en charge incluent des fichiers CRF (Cloud Raster Format), des jeux de données mosaïque multidimensionnelles, ou des couches raster multidimensionnelles générées par des fichiers netCDF, GRIB ou HDF.
Cet outil génère une couche temporaire qui n’est conservée que si vous l’enregistrez sur le disque.
Utilisez le paramètre Dimension Definition (Définition de la dimension) pour découper des tranches de dimensions à l’aide d’un intervalle, d’une valeur ou d’une plage de valeurs. Par exemple, si vous avez 10 ans de données relatives à la salinité des océans, recueillies mensuellement et tous les 2 mètres de profondeur jusqu’à 500 mètres, vous pouvez utiliser les différentes options de définition de la dimension pour les scénarios suivants :
- Extraire les données de salinité pour le mois de janvier sur la période de 10 ans. Sélectionnez By Values (Par valeurs), définissez Dimension sur StdTime et Values (Valeurs) sur January (Janvier).
- Découper des tranches de données de salinité sur une plage de profondeur allant de 0 à 150 mètres. Sélectionnez By Ranges (Par plages), définissez Dimension sur StdZ, Minimum Value (Valeur minimale) sur -150 et Maximum Value (Valeur maximale) sur 0.
- Extraire les données de salinité pour les 10 premiers jours du mois de janvier sur la période de 10 ans. Sélectionnez By Iteration (Par itération), définissez Dimension sur StdTime, définissez Start of first iteration (Début de la première itération) et End of first iteration (Fin de la première itération) sur le début et la fin correspondants de la période d’itération, définissez Step (Étape) sur 1, puis définissez Unit (Unité) sur Years (Années).
Pour créer une couche non multidimensionnelle qui contient des données provenant d’une seule tranche du raster multidimensionnel, sélectionnez By Values (Par valeurs) pour le paramètre Dimension Definition (Définition de la dimension), sélectionnez une seule valeur de dimension et cochez le paramètre Dimensionless (Sans dimension).
Paramètres
arcpy.md.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})
Nom | Explication | Type de données |
in_multidimensional_raster | Jeu de données raster multidimensionnelles en entrée. Les entrées prises en charge sont les fichiers netCDF, GRIB, HDF, CRF et Zarr, un jeu de données mosaïque multidimensionnelles, un service d’imagerie multidimensionnelle, une URL OPeNDAP ou une couche raster multidimensionnelle. Remarque :Un fichier Zarr doit avoir une extension .zarr, avec un fichier .zgroup dans le dossier. | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
out_multidimensional_raster_layer | Couche raster multidimensionnelle en sortie. | Raster Layer |
variables [variables,...] (Facultatif) | Variables incluses dans la couche raster multidimensionnelle en sortie. Si aucune variable n’est spécifiée, la première variable est utilisée. | String |
dimension_def (Facultatif) | Précise la méthode utilisée pour découper la dimension en tranches.
| String |
dimension_ranges [dimension_ranges,...] (Facultatif) | Plage ou liste de plages de la dimension indiquée. Permet de découper les données en tranches en fonction du nom de la dimension et des valeurs minimale et maximale de la plage. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_RANGES. | Value Table |
dimension_values [dimension_values,...] (Facultatif) | Liste de valeurs pour la dimension indiquée. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_VALUE. | Value Table |
dimension (Facultatif) | Dimension sur laquelle les variables sont découpées en tranches. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_ITERATION. | String |
start_of_first_iteration (Facultatif) | Début du premier intervalle. Cet intervalle est employé pour l’itération au sein du jeu de données. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_ITERATION. | String |
end_of_first_iteration (Facultatif) | Fin du premier intervalle. Cet intervalle est employé pour l’itération au sein du jeu de données. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_ITERATION. | String |
iteration_step (Facultatif) | Fréquence à laquelle les données sont découpées en tranches. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_ITERATION. | Double |
iteration_unit (Facultatif) | Spécifie l’unité de l’itération. Ce paramètre est requis lorsque le paramètre dimension_def est défini sur BY_ITERATION et que le paramètre dimension a pour valeur StdTime.
| String |
template (Facultatif) | Étendue (emprise) de la couche. Sélectionnez l’option Extent (Étendue) appropriée pour la couche.
| Extent |
dimensionless (Facultatif) | Spécifie si la couche possède des valeurs de dimension. Ce paramètre est activé uniquement si une seule tranche est sélectionnée pour la création d’une couche.
| Boolean |
spatial_reference (Facultatif) | Système de coordonnées de la valeur du paramètre out_multidimensional_raster_layer. Ce paramètre s’applique uniquement lorsque la valeur du paramètre in_multidimensional_raster est au format Zarr. Utilisez ce paramètre pour définir la référence spatiale si elle est absente des données. | Coordinate System |
Exemple de code
Procédez à l’extraction d’un sous-ensemble de variables à partir d’un raster multidimensionnel à l’aide de la méthode BY_RANGES.
# Import system modules
import arcpy
# Execute
arcpy.md.MakeMultidimensionalRasterLayer(
"C:\data\Ocean_Data.crf", "C:\data\Salinity_MultidimLayer.crf",
"salinity", "BY_RANGES", "StdZ -500 -100",
"120.084279939743 0.914964278021376 139.524470909773 21.1231086159414")
Procédez à l’extraction de la variable relative à la température de l’eau, pour des valeurs de profondeur spécifiques, à partir d’un raster multidimensionnel à l’aide de la méthode BY_VALUE.
# 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)
Procédez à l’extraction de la variable relative à la salinité à partir d’un raster multidimensionnel à l’aide de la méthode BY_ITERATION.
# 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)
Environnements
Cas particuliers
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?