Gérer un raster multidimensionnel (Outils multidimensionnels)

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 de 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 multimensionnelle 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. 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 Set Raster Properties (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 de 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 de 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.
- Truncate Dimension Values (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.
- Remove Slices (Supprimer des tranches) : supprime une tranche ou une plage de tranches d’un raster multidimensionnel.
Le paramètre Truncation Unit (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 Dimension Name (Nom de la dimension) a pour valeur StdTime.
Le paramètre Truncation Unit (Unité de troncature) dispose des options suivantes pour tronquer les valeurs de date : Year (Année), Month (Mois), Day (Jour), Hour (Heure), Minute et Second (Seconde). Si, par exemple, la valeur de la dimension temporelle est 2013-03-19T12:30:00, l’option Hour (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 Month (Mois) produit la valeur de dimension 2013-03-01T00:00:00 Ce paramètre ne s’applique que si la valeur du paramètre Dimension Name (Nom de la dimension) repose sur le temps.
Toutes les données en entrée doivent avoir exactement les mêmes référence spatiale, étendue spatiale et 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).
La suppression de tranches d’un raster CRF implique l’exécution d’opérations de fichier onéreuses. Les performances de suppression de tranches d’un raster CRF stocké dans le cloud peuvent être affectées.

Etiqueter	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. Supprimer des tranches—Une tranche, ou une plage de tranches, seront supprimées du raster multidimensionnel en entrée.	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 Manage Mode (Mode de gestion) est défini sur Add Dimension (Ajouter une dimension), Truncate Dimension Values (Tronquer les valeurs de dimension) ou Remove Slices (Supprimer des tranches). 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 aucune valeur n’est indiquée pour ce paramètre 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 ou supprimer. 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) et défini sur Add Dimension (Ajouter une dimension) ou Remove Slices (Supprimer des tranches) lorsque le paramètre Dimension Definition (Définition de la dimension) a la valeur By Values (Par valeurs). Si le paramètre Manage Mode (Mode de gestion) est défini sur Remove Slices (Supprimer des tranches), la valeur doit être une valeur unique.	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écoché—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écoché—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 Manage Mode (Mode de gestion) est défini sur Truncate Dimension Values (Tronquer les valeurs de dimension) et que le paramètre Dimension Name (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)	Spécifie la façon dont la valeur de dimension sera tronquée. Ce paramètre est actif lorsque le paramètre Manage Mode (Mode de gestion) est défini sur Truncate Dimension Values (Tronquer les valeurs de dimension). Départ—La valeur de dimension sera tronquée sur la valeur de début. Fin—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
Dimension Definition (Définition de la dimension) (Facultatif)	Spécifie la façon dont la dimension sera découpée en tranches. By Values (Par valeurs)—La dimension est découpée en tranches selon une liste de valeurs de dimension. Il s’agit de l’option par défaut. By Ranges (Par plages)—La dimension est découpée en tranches selon une plage.	String
Valeur minimale (Facultatif)	Valeur minimale de la plage de tranches à supprimer. Ce paramètre est actif lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Ranges (Par plages).	String
Valeur maximale (Facultatif)	Valeur maximale de la plage de tranches à supprimer. Ce paramètre est actif lorsque le paramètre Dimension Definition (Définition de la dimension) est défini sur By Ranges (Par plages).	String

Sortie dérivée

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

arcpy.md.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}, {dimension_def}, {min_value}, {max_value})

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. `REMOVE_SLICES`—Une tranche, ou une plage de tranches, seront supprimées du raster multidimensionnel en entrée.	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 obligatoire si le paramètre `manage_mode` est défini sur `APPEND_SLICES`, `REPLACE_SLICES` ou `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 obligatoire si le paramètre `manage_mode` est défini sur `ADD_DIMENSION`, `TRUNCATE_DIMENSION_VALUES` ou `REMOVE_SLICES`. 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 aucune valeur n’est indiquée pour ce paramètre 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 ou supprimer. 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` ou `REMOVE_SLICES` lorsque le paramètre `dimension_def` est défini sur `BY_VALUES`. Si le paramètre `manage_mode` est défini sur `REMOVE_SLICES`, la valeur doit être une valeur unique.	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 lorsque le paramètre `manage_mode` est défini sur `TRUNCATE_DIMENSION_VALUES` et que le paramètre `dimension_name` est défini sur `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 façon dont la valeur de dimension sera tronquée. Ce paramètre est actif lorsque 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
dimension_def (Facultatif)	Spécifie la façon dont la dimension sera découpée en tranches. `BY_VALUES`—La dimension est découpée en tranches selon une liste de valeurs de dimension. Il s’agit de l’option par défaut. `BY_RANGES`—La dimension est découpée en tranches selon une plage.	String
min_value (Facultatif)	Valeur minimale de la plage de tranches à supprimer. Ce paramètre est actif lorsque le paramètre `dimension_def` est défini sur `BY_RANGES`.	String
max_value (Facultatif)	Valeur maximale de la plage de tranches à supprimer. Ce paramètre est actif lorsque le paramètre `dimension_def` est défini sur `BY_RANGES`.	String

Sortie dérivée

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"
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.md.ManageMultidimensionalRaster(target_multidimensional_raster,
    manage_mode)

Environnements

Facteur de traitement parallèle

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Gérer un raster multidimensionnel (Outils multidimensionnels)

Résumé

Utilisation

Remarque :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes