Créer des informations multidimensionnelles (Outils multidimensionnels)

Synthèse

Génère des métadonnées multidimensionnelles dans le jeu de données mosaïque en incluant les informations relatives aux variables et aux dimensions.

Utilisation

  • Lorsque vous créez un jeu de données mosaïque à partir de fichiers netCDF, GRIB ou HDF, les informations multidimensionnelles sont intégrées au jeu de données mosaïque et vous pouvez les consulter dans les propriétés du jeu de données. L’outil Build Multidimensional Info (Créer des informations dimensionnelles) génère des informations multidimensionnelles pour un jeu de données mosaïque qui contient des images recueillies à plusieurs reprises, profondeurs ou hauteurs, mais qui n’a pas été créé à partir de fichiers NetCDF.

  • Cet outil crée les deux champs textuels suivants dans le jeu de données mosaïque :

    • Variable : stocke les noms des variables. Par exemple, ce champ stocke la chaîne Temperature pour toutes les images avec les données relatives à la température et la chaîne Salinity pour toutes les images contenant des données relatives à la salinité.
    • Dimensions : stocke les noms des dimensions. Par exemple, si vos données de température ont un champ de dimension Date correspondant représentant le jour de sa saisie, et si vos données relatives à la salinité ont un champ de dimension Depth représentant la profondeur à laquelle elles ont été mesurées, le champ Dimensions de cette variable serait Date, Depth. Les deux champs, Date et Depth, doivent exister et être complétés dans le jeu de données mosaïque.

  • L’outil Créer des informations multidimensionnelles crée des champs Variable, Dimensions et StdTime (ou StdZ). Cocher le paramètre Supprimer les informations multidimensionnelles a pour effet d’éliminer les informations multidimensionnelles existantes de la fenêtre Propriétés. Cela ne supprimer pas les champs multidimensionnels des tables attributaires ou de métadonnées.

    Remarque :

    Si les champs multidimensionnels sont superflus, vous pouvez les supprimer manuellement de la table attributaire du jeu de données mosaïque.

Paramètres

ÉtiquetteExplicationType de données
Mosaïque

Jeu de données mosaïque multidimensionnelles en entrée.

Mosaic Layer
Champ de variable
(Facultatif)

Le champ du jeu de données mosaïque qui stocke les noms de variable et est utilisé pour compléter un nouveau champ intitulé Variable. Si tous les rasters du jeu de données mosaïque représentent la même variable, saisissez le nom de la variable, par exemple, Temperature (Température).

Si le champ Variable n’existe pas déjà, un champ existant ou une valeur de chaîne doit être spécifié. Si le champ Variable existe, l’outil met à jour uniquement les informations multidimensionnelles.

String
Champs dimensionnels
(Facultatif)

Les champs du jeu de données mosaïque qui stocke les informations de dimension et est utilisé pour compléter un nouveau champ intitulé Dimensions.

Si le champ Dimensions existe, l’outil met à jour uniquement les informations multidimensionnelles.

Value Table
Variable Info (Infos sur la variable)
(Facultatif)

Indique des informations supplémentaires sur le champ Variable.

Value Table
Supprimer les informations multidimensionnelles
(Facultatif)

Indique si les informations multidimensionnelles sont supprimées.

  • Désactivé : si des informations multidimensionnelles existent dans le jeu de données mosaïque, elles ne sont pas supprimées. Il s’agit de l’option par défaut.
  • Activé : si des informations multidimensionnelles existent dans le jeu de données mosaïque, elles sont supprimées.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Mosaïque

Jeu de données mosaïque mis à jour.

Mosaic Layer

arcpy.management.BuildMultidimensionalInfo(in_mosaic_dataset, {variable_field}, {dimension_fields}, {variable_desc_units}, {delete_multidimensional_info})
NomExplicationType de données
in_mosaic_dataset

Jeu de données mosaïque multidimensionnelles en entrée.

Mosaic Layer
variable_field
(Facultatif)

Le champ du jeu de données mosaïque qui stocke les noms de variable et est utilisé pour compléter un nouveau champ intitulé Variable. Si tous les rasters du jeu de données mosaïque représentent la même variable, saisissez le nom de la variable, par exemple, Temperature (Température).

Si le champ Variable n’existe pas déjà, un champ existant ou une valeur de chaîne doit être spécifié. Si le champ Variable existe, l’outil met à jour uniquement les informations multidimensionnelles.

String
dimension_fields
[[dimension field, description, units],...]
(Facultatif)

Les champs du jeu de données mosaïque qui stocke les informations de dimension et est utilisé pour compléter un nouveau champ intitulé Dimensions.

Si le champ Dimensions existe, l’outil met à jour uniquement les informations multidimensionnelles.

Value Table
variable_desc_units
[[variable name, description, units],...]
(Facultatif)

Indique des informations supplémentaires sur le champ Variable.

Value Table
delete_multidimensional_info
(Facultatif)

Indique si les informations multidimensionnelles sont supprimées.

  • DELETE_MULTIDIMENSIONAL_INFOSi des informations multidimensionnelles existent dans le jeu de données mosaïque, elles sont supprimées.
  • NO_DELETE_MULTIDIMENSIONAL_INFOSi des informations multidimensionnelles existent dans le jeu de données mosaïque, elles ne sont pas supprimées. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_mosaic_dataset

Jeu de données mosaïque mis à jour.

Mosaic Layer

Exemple de code

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

Il s’agit d’un exemple Python d’utilisation de la fonction BuildMultidimensionalInfo.

## Build multidimensional information for a time series mosaic dataset 
## with Landsat 7 imagery.

import arcpy
arcpy.md.BuildMultidimensionalInfo(
	"C:/data/input.gdb/L7TimeSeriesMosaic", "Landsat7", 'AcquisitionDate')
Exemple 2 d’utilisation de l’outil BuildMultidimensionalInfo (script autonome)

Il s’agit d’un exemple de script Python d’utilisation de la fonction BuildMultidimensionalInfo.

## Build multidimensional information for a mosaic dataset 
## containing sea ice extent imagery over time and water depth.

import arcpy
arcpy.env.workspace = "C:/data"

## Define the input parameters
inputmosaicdataset = "input.gdb/seaice_1982_2019"
variable_field = "measurement"
dimension_fields= "AcquisitionDate;Depth"

arcpy.md.BuildMultidimensionalInfo(
	inputmosaicdataset, variable_field, 
	dimension_fields)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.