Manage Multidimensional Raster (Gérer un raster multidimensionnel) (Multidimension)

Résumé

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 un nouveau jeu de données ; il modifie le raster multidimensionnel. Pour créer un jeu de données, utilisez l’outil Subset Multidimensional Raster (Sous-ensemble du raster multidimensionnel) ou Copy Raster (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 multidimensionnelle en fichier .crf, utilisez l’outil Copy Raster (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. Six options sont disponibles :

  • 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.

    Si le raster cible est un fichier raster .crf standard, l’ajout d’une dimension transforme la cible en raster multidimensionnel et ajoute le paramètre Multidimensional Info (Informations multidimensionnelles) aux propriétés du raster.

  • Remove Dimension (Supprimer une dimension) : supprime une dimension du jeu de données. S’il n’y a qu’une dimension, il ne peut y avoir qu’une seule tranche dans le jeu de données.
  • 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) : ajoutez 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, la variable ne sera pas ajoutée. Si plusieurs rasters multidimensionnels en entrée contiennent une variable portant 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) ou Append Variables (Ajouter des variables).

Syntaxe

arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})

Paramètre	Explication	Type de données
target_multidimensional_raster	Le raster multidimensionnel au format Cloud Raster (.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_DIMENSION —Une dimension est ajoutée au raster multidimensionnel en entrée. APPEND_SLICES —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 —Les variables issues des rasters multidimensionnels en entrée sont ajoutées. REPLACE_SLICES —Les tranches existantes sont remplacées par des tranches d’un autre raster multidimensionnel, à des valeurs de dimension spécifiques. DELETE_VARIABLES —Une ou plusieurs variables sont supprimées du raster multidimensionnel. REMOVE_DIMENSION —Les 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 obligatoire lorsque le paramètre manage_mode est défini sur APPEND_SLICES, REPLACE_SLICES ou APPEND_VARIABLES.	Raster Layer; Image Service
dimension_name (Facultatif)	Nom de la nouvelle dimension à ajouter aux propriétés du raster. Ce paramètre est obligatoire lorsque le paramètre manage_mode est défini sur ADD_DIMENSION.	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 obligatoire 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é si 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é si 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_STATISTICS —Les statistiques sont recalculées. Il s’agit de l’option par défaut. NO_UPDATE_STATISTICS —Les 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_TRANSPOSE —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. NO_UPDATE_TRANSPOSE —La transposition n’est pas régénérée.	Boolean

Sortie dérivée

Nom	Explication	Type de données
updated_target_multidimensional_raster	Raster multidimensionnel modifié.	Couche raster

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"
update_stats = "UPDATE_STATISTICS"
update_transpose = "UPDATE_TRANSPOSE"


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

# Append salinity variable
arcpy.md.ManageMutidimensionalRaster(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.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit,
	update_stats, update_transpose)

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.ManageMultidimensionalRaster_md(target_multidimensional_raster,
	manage_mode)

Environnements

Facteur de traitement parallèle

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui