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

Boîte de dialogue

Étiquette	Explication	Type 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érique—Aucun type de données n'est spécifié pour la mosaïque. Élévation—La mosaïque contient des données d'altitude. Thématique—Le jeu de données mosaïque comporte des données thématiques qui contiennent des valeurs discrètes, telles que l’occupation du sol. Scientifique—Les 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 UV—Les données sont un raster à deux canaux qui contient un composant U et un composant V des données du champ vectoriel. Magnitude et direction—Les 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

Étiquette	Explication	Type de données
Jeu de données raster mis à jour	Jeu de données raster en sortie.	Raster Dataset

Python

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})

Nom	Explication	Type 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. GENERIC—Aucun type de données n'est spécifié pour la mosaïque. ELEVATION—La mosaïque contient des données d'altitude. THEMATIC—Le jeu de données mosaïque comporte des données thématiques qui contiennent des valeurs discrètes, telles que l’occupation du sol. PROCESSED—Les couleurs de la mosaïque ont été équilibrées. SCIENTIFIC—Les 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_UV—Les données sont un raster à deux canaux qui contient un composant U et un composant V des données du champ vectoriel. VECTOR_MAGDIR—Les 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

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

Environnements

Espace de travail courant, Espace de travail temporaire

Cas particuliers

Informations de licence

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