Créer la table attributaire d’un raster (Gestion des données)

Synthèse

Permet d’ajouter une table attributaire de raster à un jeu de données raster ou de mettre à jour une table existante. Cette méthode est principalement utilisée avec les données discrètes.

Utilisation

  • Pour supprimer une table existante et en recréer une nouvelle, cochez le paramètre Remplacer. Une nouvelle table attributaire de raster est créée et l’ancienne est supprimée.

  • Si une table existe déjà et que vous ne sélectionnez pas le paramètre Remplacer, la table est mise à jour. Aucun champ n’est supprimé, mais les valeurs de la table sont mises à jour.

  • Vous ne pouvez pas générer une table attributaire raster pour un jeu de données raster dont le type de pixel est une virgule flottante 32 bits.

  • Vous pouvez générer une table attributaire pour un jeu de données multidimensionnelles. Lorsque vous utilisez cet outil dans un jeu de données mosaïque multidimensionnelles ou un raster multidimensionnel, la table en sortie contient le nombre de pixels pour chaque classe dans chaque coupe. Le champ Count_S0 contient le nombre de pixels de chaque classe dans la première coupe du jeu de données. Le champ Count_S1 contient le nombre de pixels de chaque classe dans la deuxième coupe et ainsi de suite. Les variables doivent contenir des données catégorielles comme occupation du sol.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster en entrée auquel la table est ajoutée. Cet outil ne s'exécute pas si le pixel est de type virgule flottante ou double précision.

Raster Layer
Remplacer
(Facultatif)

Indique si la table existante est remplacée.

  • AucunLa table attributaire de raster existante n’est pas remplacée et les mises à jour y sont ajoutées. Il s’agit de l’option par défaut.
  • RemplacerLa table attributaire raster existante est remplacée et une nouvelle table attributaire raster est créée.
Boolean
Convertir la palette de couleurs
(Facultatif)

Indique si la palette de couleurs est convertie en table attributaire de raster. La table attributaire de raster en sortie inclut les champs Red, Green et Blue qui contiennent des valeurs de couleur issues de la palette de couleurs. Ces champs définissent les couleurs d’affichage des valeurs de classe correspondantes.

Ce paramètre s’applique uniquement lorsque la valeur du paramètre Raster en entrée inclut une palette de couleurs associée.

  • Convertir la palette de couleursLa palette de couleurs est convertie en une nouvelle table attributaire de raster.
  • AucunLa palette de couleurs n’est pas convertie en table attributaire de raster. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en entrée mis à jour

Jeu de données raster en sortie.

Raster Layer

arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite}, {convert_colormap})
NomExplicationType de données
in_raster

Jeu de données raster en entrée auquel la table est ajoutée. Cet outil ne s'exécute pas si le pixel est de type virgule flottante ou double précision.

Raster Layer
overwrite
(Facultatif)

Indique si la table existante est remplacée.

  • NONELa table attributaire de raster existante n’est pas remplacée et les mises à jour y sont ajoutées. Il s’agit de l’option par défaut.
  • OverwriteLa table attributaire raster existante est remplacée et une nouvelle table attributaire raster est créée.
Boolean
convert_colormap
(Facultatif)

Indique si la palette de couleurs est convertie en table attributaire de raster. La table attributaire de raster en sortie inclut les champs Red, Green et Blue qui contiennent des valeurs de couleur issues de la palette de couleurs. Ces champs définissent les couleurs d’affichage des valeurs de classe correspondantes.

Ce paramètre s’applique uniquement lorsque la valeur du paramètre Raster en entrée inclut une palette de couleurs associée.

  • Activé : la palette de couleurs est convertie en une nouvelle table attributaire de raster.
  • Désactivé : la palette de couleurs n’est pas convertie en table attributaire de raster. Il s’agit de l’option par défaut.
  • ConvertColormapLa palette de couleurs est convertie en une nouvelle table attributaire de raster.
  • NONELa palette de couleurs n’est pas convertie en table attributaire de raster. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_raster

Jeu de données raster en sortie.

Raster Layer

Exemple de code

Exemple d'utilisation de l'outil BuildRasterAttributeTable (fenêtre Python)

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

import arcpy
arcpy.BuildRasterAttributeTable_management("c:/data/image.tif", "Overwrite")
Exemple 2 d'utilisation de l'outil BuildRasterAttributeTable (script autonome)

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

##====================================
##Build Raster Attribute Table
##Usage: BuildRasterAttributeTable_management in_raster {NONE | Overwrite}
    
import arcpy
arcpy.env.workspace = "C:/Workspace"

##Build attribute table for single band raster dataset
##Overwrite the existing attribute table file
arcpy.BuildRasterAttributeTable_management("image.tif", "Overwrite")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

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

Rubriques connexes