Générer une couche raster multidimensionnelle (Outils multidimensionnels)

Synthèse

Crée une couche raster à partir d’un jeu de données raster multidimensionnel ou d’une couche raster multidimensionnel en découpant les données selon des variables et 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.

  • Parmi les jeux de données raster multidimensionnel pris en charge se trouvent le format Cloud Raster Format (CRF), les mosaïques multidimensionnelles ou les couches raster multidimensionnelles générées par des fichiers au format 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.

  • Le paramètre Dimension Definition (Définition de la dimension) permet de réduire les 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 (Pas) 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

ÉtiquetteExplicationType 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.

  • TousLa plage complète de chaque dimension est utilisée. Il s’agit de l’option par défaut.
  • By Ranges (Par plages)La dimension est découpée en tranches selon une plage ou une liste de plages.
  • By Iteration (Par itération)La dimension est découpée en tranches selon une taille d’intervalle précisée.
  • By Values (Par valeurs)La dimension est découpée en tranches selon une liste de valeurs de dimension.
String
Plage
(Facultatif)

Plage ou liste de plages de la dimension indiquée.

Les données sont découpé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 utilisé 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 utilisé 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 à utiliser. 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.

  • HeuresL’unité de temps spécifiée correspond aux heures.
  • JoursL’unité de temps spécifiée correspond aux jours.
  • SemainesL’unité de temps spécifiée correspond aux semaines.
  • MoisL’unité de temps spécifiée correspond aux mois.
  • AnnéesL’unité de temps spécifiée correspond aux années.
String
Étendue
(Facultatif)

Étendue (emprise) de la couche. Sélectionnez l’option Extent (Étendue) appropriée pour la couche.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Dessiner l’étendue Draw Extent : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte.
    Remarque :

    Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil.

    Remarque :

    Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue.

  • Extent of a Layer (Étendue d’une couche) Couche : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.

    Chaque couche de carte comporte les options suivantes :

    • Toutes les entités Sélectionner tout : étendue de toutes les entités dans la couche.
    • Entités sélectionnéesArea from Selected Features : étendue de toutes les entités sélectionnées dans la couche.
    • Entités visibles Extent Indicator : étendue des entités visibles dans la couche.
      Remarque :

      Les étendues des options Entités sélectionnées Area from Selected Features et Entités visibles Extent Indicator sont disponibles uniquement pour les couches d’entités.

  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Presse-papiers Coller : l’étendue peut être copiée vers et collée depuis le Presse-papiers.
    • Copier l’étendue Copier : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers.
    • Coller l’étendue Coller : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte.
    Remarque :

    Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale.

  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active.
    Attention :

    La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. Utilisez le signe moins pour les coordonnées sud et ouest.

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.

  • Activé : la couche ne contient pas de valeurs de dimension.
  • Désactivé : la couche contient des valeurs de dimension. Il s’agit de l’option par défaut.

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

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})
NomExplicationType 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.

  • ALLLa plage complète de chaque dimension est utilisée. Il s’agit de l’option par défaut.
  • BY_RANGESLa dimension est découpée en tranches selon une plage ou une liste de plages.
  • BY_ITERATIONLa dimension est découpée en tranches selon une taille d’intervalle précisée.
  • BY_VALUELa dimension est découpée en tranches selon une liste de valeurs de dimension.
String
dimension_ranges
[dimension_ranges,...]
(Facultatif)

Plage ou liste de plages de la dimension indiquée.

Les données sont découpées en tranches en fonction du nom de la dimension et des valeurs minimale et maximale de la plage. Ce paramètre est obligatoire si 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 obligatoire si 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 utilisé pour l’itération au sein du jeu de données. Ce paramètre est obligatoire si le paramètre dimension_def est défini sur BY_ITERATION.

String
end_of_first_iteration
(Facultatif)

Fin du premier intervalle. Cet intervalle est utilisé pour l’itération au sein du jeu de données. Ce paramètre est obligatoire si 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 obligatoire si le paramètre dimension_def est défini sur BY_ITERATION.

Double
iteration_unit
(Facultatif)

Spécifie l’unité de l’itération à utiliser. 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.

  • HOURSL’unité de temps spécifiée correspond aux heures.
  • DAYSL’unité de temps spécifiée correspond aux jours.
  • WEEKSL’unité de temps spécifiée correspond aux semaines.
  • MONTHSL’unité de temps spécifiée correspond aux mois.
  • YEARSL’unité de temps spécifiée correspond aux années.
String
template
(Facultatif)

Étendue (emprise) de la couche. Sélectionnez l’option Extent (Étendue) appropriée pour la couche.

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale commune à toutes les entrées est utilisée.
  • DISPLAY : l’étendue est égale à l’affichage visible.
  • Nom de la couche : l’étendue de la couche spécifiée est utilisée.
  • Objet Extent : l’étendue de l’objet spécifié est utilisée.
  • Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.
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.

  • NO_DIMENSIONSLa couche ne contient pas de valeurs de dimension.
  • DIMENSIONSLa couche contient des valeurs de dimension. Il s’agit de l’option par défaut.
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

Exemple 1 de la fonction MakeMultidimensionalRasterLayer (fenêtre Python)

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
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")
Exemple 2 d’utilisation de la fonction MakeMultidimensionalRasterLayer (script autonome)

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)
Exemple 3 d’utilisation de la fonction MakeMultidimensionalRasterLayer (script autonome)

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)