Gérer un raster multidimensionnel (Outils multidimensionnels)

Synthèse

Met à jour un raster multidimensionnel en ajoutant ou supprimant des variables ou des dimensions.

Utilisation

  • Utilisez cet outil pour mettre à jour un raster multidimensionnel. Cet outil ne génère pas de nouveau jeu de données ; il modifie le raster multidimensionnel. Pour créer un jeu de données, utilisez l’outil Sous-ensemble du raster multidimensionnel ou Copier un raster avant d’effectuer une mise à jour avec cet outil.

  • Les rasters cible et en entrée doit être au format CRF (Cloud Raster Format). Cet outil ne prend actuellement en charge aucun autre format. Pour convertir un jeu de données mosaïque multidimensionnelles ou une couche raster multimensionnelle en fichier .crf, utilisez l’outil Copier un raster, sélectionnez le format en sortie CRF, puis choisissez de traiter le jeu de données comme un jeu de données multidimensionnelles.

  • Le paramètre Manage Mode (Mode de gestion) définit le type d’opération de mise à jour à effectuer. Le paramètre prend en charge les options suivantes :

    • Add Dimension (Ajouter une dimension) : ajoute une dimension au jeu de données. Vous devez fournir le nom, la description et l’unité de la dimension. Une fois la dimension ajoutée, des tranches d’un autre jeu de données multidimensionnelles avec la même dimension peuvent être ajoutées.

      Remarque :

      Si un jeu de données CRF en entrée n’est pas un raster multidimensionnel, vous ne pouvez pas utiliser l’outil Gérer un raster multidimensionnel pour créer un raster multidimensionnel. Utilisez l’outil Définir les propriétés de raster pour créer un raster multidimensionnel.

    • Remove Dimension (Supprimer une dimension) : supprime une dimension du jeu de données. Chaque dimension à supprimer ne peut contenir qu'une seule valeur.
    • Append Slices (Ajouter des tranches) : ajoute des tranches à partir d’un ou plusieurs rasters multidimensionnels en entrée à la fin d’une pile de tranches dans le raster multidimensionnel cible. Les noms de la variable et de la dimension dans les rasters multidimensionnels doivent être parfaitement identiques, et les valeurs de dimension ne doivent pas se chevaucher entre les rasters. Les valeurs de dimension des tranches ajoutées doivent venir après la fin des valeurs de dimension dans le raster multidimensionnel cible.
    • Replace Slices (Remplacer des tranches) : supprime des tranches du raster multidimensionnel cible et les remplace par des tranches d’un autre raster multidimensionnel. Les noms de la variable et de la dimension dans les rasters multidimensionnels doivent être parfaitement identiques, et seules les tranches superposées sont remplacées.
    • Append Variables (Ajouter des variables) : ajoute toutes les variables d’un ou plusieurs rasters multidimensionnels en entrée à la fin d’une liste de variables dans le raster multidimensionnel cible. Si le nom de la variable existe déjà dans le raster multidimensionnel cible, elle ne sera pas ajoutée. Si plusieurs rasters multidimensionnels en entrée contiennent une variable avec le même nom, la variable du raster en entrée figurant en premier dans la liste sera ajoutée au raster multidimensionnel cible.
    • Delete Variables (Supprimer des variables) : supprime une ou plusieurs variables, ainsi que les tranches correspondantes, du raster multidimensionnel cible. Il doit rester au moins une variable dans le raster multidimensionnel.

  • Les données en entrée doivent avoir exactement la même référence spatiale, la même étendue spatiale et la même taille de cellule pour utiliser les options Append Slices (Ajouter des tranches), Replace Slices (Remplacer des tranches) et Append Variables (Ajouter des variables) du paramètre Manage Mode (Mode de gestion).

Paramètres

ÉtiquetteExplicationType de données
Raster multidimensionnel cible

Raster multidimensionnel CRF à modifier.

Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
Mode de gestion
(Facultatif)

Spécifie le type de modification qui sera apportée au raster cible.

  • Add Dimension (Ajouter une dimension)Une dimension est ajoutée au raster multidimensionnel en entrée.
  • Append Slices (Ajouter des tranches)Les tranches issues des rasters multidimensionnels en entrée sont ajoutées à la fin des tranches d’une dimension. Il s’agit de l’option par défaut.
  • Append Variables (Ajouter des variables)Les variables issues des rasters multidimensionnels en entrée sont ajoutées.
  • Replace Slices (Remplacer des tranches)Les tranches existantes sont remplacées par des tranches d’un autre raster multidimensionnel, à des valeurs de dimension spécifiques.
  • Delete Variables (Supprimer des variables)Une ou plusieurs variables sont supprimées du raster multidimensionnel.
  • Remove Dimension (Supprimer une dimension)Les rasters multidimensionnels avec une seule tranche sont convertis en rasters sans dimension.
String
Variables
(Facultatif)

Variables qui sont modifiées dans le raster multidimensionnel cible. Ce paramètre est obligatoire si l’opération effectuée est une modification d’une variable existante.

Si aucune variable n’est spécifiée, la première variable du raster multidimensionnel cible est modifiée.

String
Rasters multidimensionnels en entrée
(Facultatif)

Jeux de données raster multidimensionnelles qui contiennent les tranches ou les variables à ajouter au raster multidimensionnel cible. Ce paramètre est requis lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Append Slices (Ajouter des tranches), Replace Slices (Remplacer des tranches) ou Append Variables (Ajouter des variables).

Raster Layer; Image Service
Nom de la dimension
(Facultatif)

Nom de la dimension à ajouter aux propriétés du raster ou à supprimer des propriétés du raster. Ce paramètre est requis lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Add Dimension (Ajouter une dimension). Si le paramètre Manage Mode (Mode de gestion) est défini sur Remove Dimension (Supprimer une dimension), la dimension spécifiée ne peut contenir qu'une seule valeur. Si le paramètre Dimension Name (Nom de la dimension) n'est pas spécifié et que l'entrée ne contient qu'une tranche, toutes les dimensions seront supprimées.

String
Valeur de dimension
(Facultatif)

Valeur de la dimension à ajouter. Il peut s’agir d’une valeur unique ou d’une plage de valeurs. Pour une plage de valeurs, indiquez les valeurs minimum et maximum en les séparant par une virgule. Par exemple, pour une nouvelle dimension de hauteur, saisissez 0,10 pour générer une dimension dans laquelle la première tranche contient des informations pour les 10 premiers mètres de hauteur.

Ce paramètre est requis lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Add Dimension (Ajouter une dimension).

String
Dimension Description (Description de la dimension)
(Facultatif)

Description de la nouvelle dimension à ajouter aux propriétés du raster pour les métadonnées. Ce paramètre est actif lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Add Dimension (Ajouter une dimension).

String
Dimension Unit (Unité de la dimension)
(Facultatif)

Unité de la nouvelle dimension à ajouter aux propriétés du raster pour les métadonnées. Ce paramètre est actif lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Add Dimension (Ajouter une dimension).

String
Update Statistics (Mettre à jour les statistiques)
(Facultatif)

Indique si les statistiques sont recalculées pour le jeu de données raster multidimensionnelles.

  • Activé : les statistiques sont recalculées. Il s’agit de l’option par défaut.
  • Désactivé : les statistiques ne sont pas recalculées.
Boolean
Update Transpose (Mettre à jour la transposition)
(Facultatif)

Indique si la transposition est régénérée pour le jeu de données raster multidimensionnelles.

  • Activé : la transposition est régénérée. S’il n’existe aucune transposition, une nouvelle transposition est créée. Il s’agit de l’option par défaut.
  • Désactivé : la transposition n’est pas régénérée.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Raster multidimensionnel cible

Raster multidimensionnel modifié.

Raster Layer

arcpy.management.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})
NomExplicationType de données
target_multidimensional_raster

Raster multidimensionnel CRF à modifier.

Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
manage_mode
(Facultatif)

Spécifie le type de modification qui sera apportée au raster cible.

  • ADD_DIMENSIONUne dimension est ajoutée au raster multidimensionnel en entrée.
  • APPEND_SLICESLes tranches issues des rasters multidimensionnels en entrée sont ajoutées à la fin des tranches d’une dimension. Il s’agit de l’option par défaut.
  • APPEND_VARIABLESLes variables issues des rasters multidimensionnels en entrée sont ajoutées.
  • REPLACE_SLICESLes tranches existantes sont remplacées par des tranches d’un autre raster multidimensionnel, à des valeurs de dimension spécifiques.
  • DELETE_VARIABLESUne ou plusieurs variables sont supprimées du raster multidimensionnel.
  • REMOVE_DIMENSIONLes rasters multidimensionnels avec une seule tranche sont convertis en rasters sans dimension.
String
variables
[variables,...]
(Facultatif)

Variables qui sont modifiées dans le raster multidimensionnel cible. Ce paramètre est obligatoire si l’opération effectuée est une modification d’une variable existante.

Si aucune variable n’est spécifiée, la première variable du raster multidimensionnel cible est modifiée.

String
in_multidimensional_rasters
[in_multidimensional_rasters,...]
(Facultatif)

Jeux de données raster multidimensionnelles qui contiennent les tranches ou les variables à ajouter au raster multidimensionnel cible. Ce paramètre est requis lorsque le paramètre manage_mode est défini sur APPEND_SLICES, REPLACE_SLICES ou sur APPEND_VARIABLES.

Raster Layer; Image Service
dimension_name
(Facultatif)

Nom de la dimension à ajouter aux propriétés du raster ou à supprimer des propriétés du raster. Ce paramètre est requis lorsque le manage_mode est défini sur ADD_DIMENSION. Si le paramètre manage_mode est défini sur REMOVE_DIMENSION, la dimension spécifiée ne peut contenir qu'une seule valeur. Si le paramètre dimension_name n'est pas spécifié et que l'entrée ne contient qu'une tranche, toutes les dimensions seront supprimées.

String
dimension_value
(Facultatif)

Valeur de la dimension à ajouter. Il peut s’agir d’une valeur unique ou d’une plage de valeurs. Pour une plage de valeurs, indiquez les valeurs minimum et maximum en les séparant par une virgule. Par exemple, pour une nouvelle dimension de hauteur, saisissez 0,10 pour générer une dimension dans laquelle la première tranche contient des informations pour les 10 premiers mètres de hauteur.

Ce paramètre est requis lorsque le paramètre manage_mode est défini sur ADD_DIMENSION.

String
dimension_description
(Facultatif)

Description de la nouvelle dimension à ajouter aux propriétés du raster pour les métadonnées. Ce paramètre est activé lorsque le paramètre manage_mode est défini sur ADD_DIMENSION.

String
dimension_unit
(Facultatif)

Unité de la nouvelle dimension à ajouter aux propriétés du raster pour les métadonnées. Ce paramètre est activé lorsque le paramètre manage_mode est défini sur ADD_DIMENSION.

String
update_statistics
(Facultatif)

Indique si les statistiques sont recalculées pour le jeu de données raster multidimensionnelles.

  • UPDATE_STATISTICSLes statistiques sont recalculées. Il s’agit de l’option par défaut.
  • NO_UPDATE_STATISTICSLes statistiques ne sont pas recalculées.
Boolean
update_transpose
(Facultatif)

Indique si la transposition est régénérée pour le jeu de données raster multidimensionnelles.

  • UPDATE_TRANSPOSELa transposition est régénérée. S’il n’existe aucune transposition, une nouvelle transposition est créée. Il s’agit de l’option par défaut.
  • NO_UPDATE_TRANSPOSELa transposition n’est pas régénérée.
Boolean

Sortie obtenue

NomExplicationType de données
updated_target_multidimensional_raster

Raster multidimensionnel modifié.

Raster Layer

Exemple de code

Exemple 1 d’utilisation de l’outil ManageMultidimensionalRaster (fenêtre Python)

Cet exemple ajoute des tranches à la fin d’un raster multidimensionnel et met à jour les statistiques.

# 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")
Exemple 2 d’utilisation de l’outil ManageMultidimensionalRaster (script autonome)

Cet exemple remplace les tranches, ajoute une variable et ajoute une dimension au raster multidimensionnel cible.

# 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"

# Replace existing slices with new slices
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_replace, 
	variables, replace_multidimensional_rasters)

# Append salinity variable
arcpy.md.ManageMultidimensionalRaster(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.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit)
Exemple 3 d’utilisation de l’outil ManageMultidimensionalRaster (script autonome)

Cet exemple supprime des dimensions d’un raster multidimensionnel à une seule tranche.

# 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)