Définir les propriétés du raster (Gestion des données)

Synthèse

Définit le type de données, les statistiques et les valeurs NoData sur un jeu de données raster ou une mosaïque.

Utilisation

  • Vous pouvez définir les statistiques d’un jeu de données raster ou mosaïque à l’aide de cet outil. Vous l’utilisez habituellement lorsque vous ne souhaitez pas qu’elles soient calculées. Vous pouvez définir les valeurs minimale, maximale, d’écart type et de moyenne pour chaque canal. Vous pouvez lire ces statistiques dans un fichier .xml.

  • Les propriétés que vous pouvez définir avec cet outil définissent les paramètres de rendu par défaut dans ArcGIS Pro, ainsi que les statistiques utilisées par d’autres outils.

    Vous pouvez définir les propriétés suivantes :

    • Data Source Type (Type de source de données) : indique si les valeurs de cellule représentent des données d’élévation ou catégorielles ou si elles ont été traitées via d’autres méthodes et ne nécessitent aucun étirement lors de l’affichage des données.
    • Statistics Per Band (Statistiques par canal) : pour chaque canal, vous pouvez définir des valeurs minimale, maximale, de moyenne et d’écart type.
    • Bands for NoData Value (Canaux pour la valeur NoData) : pour chaque canal, vous pouvez définir une valeur NoData.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster ou mosaïque comportant les propriétés à définir.

Mosaic Layer ; Raster Layer
Type de source de données
(Facultatif)

Spécifie le type d'imagerie du jeu de données mosaïque.

  • GénériqueAucun type de données n'est spécifié pour la mosaïque.
  • ÉlévationLa mosaïque contient des données d'altitude.
  • ThématiqueLe jeu de données mosaïque comporte des données thématiques qui contiennent des valeurs discrètes, telles que l’occupation du sol.
  • ScientifiqueLes données contiennent des informations scientifiques et seront affichées par défaut avec un dégradé de couleurs allant du rouge au bleu.
  • Vecteur UVLes données sont un raster à deux canaux qui contient un composant U et un composant V des données du champ vectoriel.
  • Magnitude et directionLes données sont un raster à deux canaux qui contient la magnitude et la direction des données du champ vectoriel.
  • TraitéLes couleurs de la mosaïque ont été équilibrées.
String
Statistiques par canal
(Facultatif)

Spécifie les canaux ainsi que les valeurs minimale et maximale, la moyenne et l’écart type.

Value Table
Import Statistics From File (Importer les statistiques à partir du fichier)
(Facultatif)

Fichier .xml qui contient les statistiques.

File
Bands for NoData Value (Canaux pour la valeur NoData)
(Facultatif)

Valeur NoData de chaque canal. Il peut être définie une valeur NoData unique pour chaque canal ou bien la même valeur peut être spécifiée pour tous les canaux.

Cliquez sur la flèche de la liste déroulante NoData, sélectionnez un canal dans la liste et cliquez sur le bouton Add (Ajouter) pour ajouter le canal à la table. Saisissez ensuite une ou plusieurs valeurs. Si vous sélectionnez plusieurs valeurs NoData, séparez chaque valeur par un espace.

Value Table
Propriétés clés
(Facultatif)

Propriétés prises en charge de manière native. Il se peut que vos données contiennent des propriétés supplémentaires non répertoriées dans la liste suivante. Les propriétés ne respectent pas la casse.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Emprise
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
Multidimensional information (Informations multidimensionnelles)
(Facultatif)

Informations multidimensionnelles du jeu de données raster. Lorsque vous définissez des informations multidimensionnelles, le raster sans dimension est converti en raster multidimensionnel.

Si la dimension est temporelle, elle doit être nommée StdTime. Le format temporel est soit année-mois-jour (2021-10-01), soit année-mois-jourThh:mm:ss (2021-10-01T01:00:00).

Pour définir une variable avec une dimension temporelle et une altitude, ajoutez d’abord la variable avec la dimension temporelle, puis ajoutez la même variable avec la dimension z.

Value Table

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données raster mis à jour

Jeu de données raster en sortie.

Raster Dataset

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})
NomExplicationType de données
in_raster

Jeu de données raster ou mosaïque comportant les propriétés à définir.

Mosaic Layer ; Raster Layer
data_type
(Facultatif)

Spécifie le type d'imagerie du jeu de données mosaïque.

  • GENERICAucun type de données n'est spécifié pour la mosaïque.
  • ELEVATIONLa mosaïque contient des données d'altitude.
  • THEMATICLe jeu de données mosaïque comporte des données thématiques qui contiennent des valeurs discrètes, telles que l’occupation du sol.
  • PROCESSEDLes couleurs de la mosaïque ont été équilibrées.
  • SCIENTIFICLes données contiennent des informations scientifiques et seront affichées par défaut avec un dégradé de couleurs allant du rouge au bleu.
  • VECTOR_UVLes données sont un raster à deux canaux qui contient un composant U et un composant V des données du champ vectoriel.
  • VECTOR_MAGDIRLes données sont un raster à deux canaux qui contient la magnitude et la direction des données du champ vectoriel.
String
statistics
[[band_index, min, max, mean, std_dev],...]
(Facultatif)

Spécifie les canaux ainsi que les valeurs minimale et maximale, la moyenne et l’écart type.

Value Table
stats_file
(Facultatif)

Fichier .xml qui contient les statistiques.

File
nodata
[[band index, nodata_value],...]
(Facultatif)

Valeur NoData de chaque canal. Il peut être définie une valeur NoData unique pour chaque canal ou bien la même valeur peut être spécifiée pour tous les canaux. Pour définir plusieurs valeurs NoData pour chaque sélection de canaux, insérez un espace entre chaque valeur NoData dans le paramètre bands_for_nodata_value.

Value Table
key_properties
[key_properties,...]
(Facultatif)

Propriétés prises en charge de manière native. Il se peut que vos données contiennent des propriétés supplémentaires non répertoriées dans la liste suivante. Les propriétés ne respectent pas la casse.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Emprise
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
multidimensional_info
[multidimensional_info,...]
(Facultatif)

Informations multidimensionnelles du jeu de données raster. Lorsque vous définissez des informations multidimensionnelles, le raster sans dimension est converti en raster multidimensionnel.

Si la dimension est temporelle, elle doit être nommée StdTime. Le format temporel est soit année-mois-jour (2021-10-01), soit année-mois-jourThh:mm:ss (2021-10-01T01:00:00).

Pour définir une variable avec une dimension temporelle et une altitude, ajoutez d’abord la variable avec la dimension temporelle, puis ajoutez la même variable avec la dimension z.

Value Table

Sortie obtenue

NomExplicationType de données
out_raster

Jeu de données raster en sortie.

Raster Dataset

Exemple de code

Exemple 1 d'utilisation de l'outil Définir les propriétés du raster (fenêtre Python)

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

import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION", 
                                     "1 50 400 5 28" , "#" , "#")
Exemple 2 d'utilisation de l'outil Définir les propriétés du raster (script autonome)

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

#Set raster dataset type and statistics

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION", 
                                         "1 50 400 5 28", "#", "#")

Informations de licence

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