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

Synthèse

Créez ou mettez à jour une table à l'aide d'informations sur les classes dans vos jeux de données raster. 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, sélectionnez Overwrite (Remplacer) (overwrite = "OVERWRITE" dans Python). 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 l'option Ecraser, la table est mise à jour. Aucun champ n'est supprimé, mais les valeurs de la table sont actualisées.

  • 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 raster existante n’est pas remplacée et les mises à jour sont ajoutées à la table actuelle. 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

Sortie obtenue

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

Jeu de données raster en sortie.

Couche raster

arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite})
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 vous voulez remplacer la table existante.

  • NONELa table attributaire raster existante n’est pas remplacée et les mises à jour sont ajoutées à la table actuelle. 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

Sortie obtenue

NomExplicationType de données
out_raster

Jeu de données raster en sortie.

Couche raster

Exemple de code

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

Il s’agit d'un exemple Python d'utilisation de l'outil 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 l'outil 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