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 cet outil 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.
  • Tronquer les valeurs de dimension : modifie les valeurs de dimension en tronquant les valeurs de date ou en sélectionnant les valeurs de début et de fin si les valeurs de dimension sont des plages.

• Le paramètre Unité de troncature indique l’unité de troncature de date et temporelle à utiliser. Ce paramètre est requis lorsque le paramètre manage_mode est défini sur TRUNCATE_DIMENSION_VALUES et que le paramètre Nom de la dimension a pour valeur StdTime.

• Le paramètre Unité de troncature dispose des options suivantes pour tronquer les valeurs de date : Année, Mois, Jour, Heure, Minute et Seconde. Si, par exemple, la valeur de la dimension temporelle est 2013-03-19T12:30:00, l’option Heure tronque les valeurs après les heures, ce qui aboutit à la valeur de dimension 2013-03-19T12:00:00. L’utilisation de l’option Mois produit la valeur de dimension 2013-03-01T00:00:00. Ce paramètre ne s’applique que si la valeur du paramètre Nom de la dimension repose sur le temps.

• Toutes 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 Ajouter des tranches, Remplacer des tranches et Ajouter des variables du paramètre Mode de gestion.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster multidimensionnel cible	Raster multidimensionnel au format 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. Tronquer les valeurs de dimension—Les valeurs de dimension seront modifiées en tronquant les valeurs de date ou en sélectionnant les valeurs de début et de fin si les valeurs de dimension sont des plages.	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 qui seront ajoutées 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 Dataset; Raster Layer; Image Service
Nom de la dimension (Facultatif)	Nom de la dimension qui sera ajoutée aux propriétés du raster ou supprimée des propriétés du raster. Ce paramètre est requis lorsque le paramètre Mode de gestion est défini sur Ajouter une dimension ou Tronquer les valeurs de 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 la valeur du paramètre Nom de la dimension n’est pas spécifiée 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 qui sera ajoutée. 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 qui sera ajoutée 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 qui sera ajoutée 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
Unité de troncature (Facultatif)	Indique l’unité de troncature de date et temporelle à utiliser. Ce paramètre est requis lorsque le paramètre Mode de gestion est défini sur Tronquer les valeurs de dimension et que le paramètre Nom de la dimension a pour valeur StdTime. Seconde—L’unité de troncature temporelle spécifiée sera la seconde. Minute—L’unité de troncature temporelle spécifiée sera la minute. Heure—L’unité de troncature temporelle spécifiée sera l’heure. Jour—L’unité de troncature temporelle spécifiée sera le jour. Mois—L’unité de troncature temporelle spécifiée sera le mois. Année—L’unité de troncature temporelle spécifiée sera l’année.	String
Mot-clé de début/fin (Facultatif)	Indique comment la valeur de dimension est tronquée si le paramètre Mode de gestion est défini sur Tronquer les valeurs de dimension. Début—La valeur de dimension sera tronquée sur la valeur de début. Extrémité—La valeur de dimension sera tronquée sur la valeur de fin. Les deux—La valeur de dimension sera tronquée sur les valeurs de début et de fin.	String

Sortie obtenue

Étiquette	Explication	Type de données
Raster multidimensionnel cible	Raster multidimensionnel modifié.	Raster Layer

Python

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

Nom	Explication	Type de données
target_multidimensional_raster	Raster multidimensionnel au format 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. TRUNCATE_DIMENSION_VALUES—Les valeurs de dimension seront modifiées en tronquant les valeurs de date ou en sélectionnant les valeurs de début et de fin si les valeurs de dimension sont des plages.	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 qui seront ajoutées 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 Dataset; Raster Layer; Image Service
dimension_name (Facultatif)	Nom de la dimension qui sera ajoutée aux propriétés du raster ou supprimée des propriétés du raster. Ce paramètre est requis lorsque le paramètre 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 la valeur du paramètre dimension_name n’est pas spécifiée et que l’entrée ne contient qu’une tranche, toutes les dimensions seront supprimées.	String
dimension_value (Facultatif)	Valeur de la dimension qui sera ajoutée. 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 qui sera ajoutée 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 qui sera ajoutée 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_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
truncation_unit (Facultatif)	Indique l’unité de troncature de date et temporelle à utiliser. Ce paramètre est requis si le paramètre manage_mode est défini sur TRUNCATE_DIMENSION_VALUES et que le paramètre dimension_name a pour valeur STDTIME. SECOND—L’unité de troncature temporelle spécifiée sera la seconde. MINUTE—L’unité de troncature temporelle spécifiée sera la minute. HOUR—L’unité de troncature temporelle spécifiée sera l’heure. DAY—L’unité de troncature temporelle spécifiée sera le jour. MONTH—L’unité de troncature temporelle spécifiée sera le mois. YEAR—L’unité de troncature temporelle spécifiée sera l’année.	String
startEnd_keyword (Facultatif)	Spécifie la manière de tronquer la valeur de dimension si le paramètre manage_mode est défini sur TRUNCATE_DIMENSION_VALUES. START—La valeur de dimension sera tronquée sur la valeur de début. END—La valeur de dimension sera tronquée sur la valeur de fin. BOTH—La valeur de dimension sera tronquée sur les valeurs de début et de fin.	String

Sortie obtenue

Nom	Explication	Type 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)

Environnements

Facteur de traitement parallèle