Résumé
Définit le type de données, les statistiques et les valeurs NoData sur un jeu de données raster ou une mosaïque.
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. Vous l'utilisez habituellement lorsque vous ne souhaitez pas qu'elles soient calculées automatiquement. 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.
- Développez 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.
Syntaxe
SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})
Paramètre | Explication | Type de données |
in_raster | Jeu de données raster ou mosaïque dont vous souhaitez définir les propriétés. | Mosaic Layer ; Raster Layer |
data_type (Facultatif) | Type d'imagerie dans la mosaïque.
| String |
statistics [[band_index, min, max, mean, std_dev],...] (Facultatif) | Spécifie les canaux et les valeurs minimale et maximale, la moyenne, ainsi que l'écart type. | Value Table |
stats_file (Facultatif) | Fichier .xml qui contient les statistiques. Pour créer ce fichier, exportez les statistiques d'un autre raster ou d'une autre mosaïque. | File |
nodata [[band index, nodata_value],...] (Facultatif) | Spécifiez la 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. 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 |
key_properties [key_properties,...] (Facultatif) | Les propriétés prises en charge de manière native sont les suivantes. Il se peut que vos données contiennent des propriétés supplémentaires non répertoriées dans cette liste. Les propriétés ne respectent pas la casse.
| Value Table |
Sortie dérivée
Nom | Explication | Type de données |
out_raster | Jeu de données raster en sortie. | Jeu de données raster |
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 de script Python pour 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)
Ceci est un exemple de script Python pour 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui