Définir les propriétés de raster (Gestion des données)
Récapitulatif
Définit des propriétés sur un jeu de données raster ou une mosaïque, telles qu'un type de données, des statistiques ou des valeurs NoData.
En savoir plus sur les propriétés et les statistiques raster
Utilisation
Cet outil vous permet de définir les statistiques d'un jeu de données raster ou d'une mosaïque. Habituellement, vous utilisez cet outil si vous ne souhaitez pas qu'ArcGIS les calcule pour vous. Les statistiques que vous définissez sont des valeurs minimales, maximales, d'écart type et moyennes pour chaque canal. Vous pouvez lire ces statistiques dans un fichier XML. Vous pouvez créer ce fichier XML en exportant les statistiques à partir d'un autre jeu de données raster ou d'une mosaïque, comme suit :
- Dans la fenêtre Catalogue, cliquez avec le bouton droit sur le raster ou la mosaïque qui contient les statistiques à exporter, puis sélectionnez Propriétés.
- En faisant défiler la liste, accédez à la ligne qui contient la propriété Statistiques.
- Ouvrez le menu déroulant Options de la colonne Valeur.
- Cliquez sur Exporter les statistiques en XML.
Les propriétés que vous pouvez définir avec cet outil définissent les paramètres de rendu par défaut dans ArcMap, ainsi que les statistiques utilisées par d'autres outils.
Parmi les propriétés que vous pouvez inclure, on compte les suivantes :
- Type de source de données : elle détermine si les valeurs des cellules représentent des données d'altitude 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.
- Statistiques par canal : pour chaque canal, vous pouvez définir des données minimales, maximales, moyennes et d'écart type.
- Canaux pour la valeur NoData : pour chaque canal, vous pouvez définir une valeur NoData.
-
Vous pouvez également définir ces propriétés dans la fenêtre Propriétés en cliquant avec le bouton droit sur un raster dans la fenêtre Catalogue et en sélectionnant Propriétés ou en cliquant avec le bouton droit sur une couche raster dans ArcMap et en sélectionnant Propriétés. L'outil Définir les propriétés du raster vous permet de définir ces propriétés dans un modèle de géotraitement ou dans Python.
Syntaxe
| Paramètre | Explication | Type de données |
in_raster |
Jeu de données raster ou mosaïque en entrée. | Mosaic Layer ; Raster Layer |
data_type (Facultatif) |
Type de données contenu dans ce jeu de données. Ces paramètres contrôlent la symbologie appliquée lorsque ces jeux de données sont affichés.
| String |
statistics [[band_index, min, max, mean, std_dev],...] (Facultatif) | Saisissez le numéro de canal, la valeur statistique minimale, la valeur statistique maximale, la valeur statistique moyenne et la valeur d'écart type. | Value Table |
stats_file (Facultatif) |
Fichier XML qui contient les statistiques. Ce fichier peut être créé en exportant les statistiques d'un autre raster ou mosaïque. | File |
nodata [[band index, nodata_value],...] (Facultatif) | Définissez des valeurs pour chaque canal ou pour tous les canaux. 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. Si vous souhaitez 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 |
Exemple de code
Voici un exemple Python d'utilisation de l'outil Définir les propriétés du raster.
import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION",
"1 50 400 5 28" , "#" , "#")
Voici un exemple de script Python d'utilisation de l'outil Définir les propriétés du raster.
#Set raster dataset type and statistics
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION",
"1 50 400 5 28", "#", "#")