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

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.

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.

  • 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.

    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.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster ou mosaïque dont vous souhaitez définir les propriétés.

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

Type d'imagerie dans la mosaïque.

  • Générique Aucun type de données n'est spécifié pour la mosaïque.
  • Altitude La mosaïque contient des données d'altitude.
  • ThématiqueLes données thématiques comportent 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 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 et les valeurs minimale et maximale, la moyenne, ainsi que l'écart type.

Value Table
Importer les statistiques à partir du fichier
(Facultatif)

Fichier .xml qui contient les statistiques.

File
Canaux pour la valeur NoData
(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.

Choisissez le canal dans la liste déroulante NoData et cliquez sur le bouton Ajouter pour l'ajouter à 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)

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.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Emprise
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • Tendance de réflectance
  • 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

Sortie dérivée

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

Jeu de données raster en sortie.

Jeu de données raster

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})
NomExplicationType 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.

  • GENERIC Aucun type de données n'est spécifié pour la mosaïque.
  • ELEVATION La mosaïque contient des données d'altitude.
  • THEMATICLes données thématiques comportent 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 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 et les valeurs minimale et maximale, la moyenne, ainsi que l'écart type.

Value Table
stats_file
(Facultatif)

Fichier .xml qui contient les statistiques.

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.

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Emprise
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • Tendance de réflectance
  • 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

Sortie dérivée

NomExplicationType 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", "#", "#")

Informations de licence

  • Basic: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O