ラスター属性テーブルをラスター データセットに追加するか、既存のテーブルを更新します。 これは、主に不連続データとともに使用します。
既存のテーブルを削除して新しいテーブルを作成するには、[上書き] パラメーターをオンにします。 新しいラスター属性テーブルが作成され、既存のテーブルは削除されます。
既存のテーブルが存在し、[上書き] パラメーターをオンにしなかった場合、テーブルは更新されます。 フィールドは削除されませんが、テーブルの値が更新されます。
32 ビット浮動小数点のピクセル タイプのラスター データセットにラスター属性テーブルを構築することはできません。
多次元データセットに属性テーブルを生成できます。 多次元モザイク データセットまたは多次元ラスターでこのツールを使用すると、出力テーブルには各スライス内にある各クラスのピクセル数が含まれます。 Count_S0 フィールドには、データセットの最初のスライス内にある各クラスのピクセル数が格納されます。 Count_S1 フィールドには、2 番目のスライス内にある各クラスのピクセル数が格納され、以降も同様です。 変数は、土地被覆などのカテゴリ データを含む必要があります。
| ラベル | 説明 | データ タイプ |
入力ラスター | テーブルを追加する対象となる入力ラスター データセット。 このツールは、ピクセル タイプが浮動小数点または倍精度である場合は、実行されません。 | Raster Layer |
上書き (オプション) | 既存のテーブルを上書きするかどうかを指定します。
| Boolean |
カラーマップの変換 (オプション) | カラーマップをラスター属性テーブルに変換するかどうかを指定します。 出力ラスター属性テーブルには、カラーマップの色の値を含む Red、Green、Blue の各フィールドがあります。 これらのフィールドは、対応するクラス値の表示色を定義します。 関連するカラーマップが [入力ラスター] パラメーター値に含まれている場合のみ、このパラメーターが適用されます。
| Boolean |
| ラベル | 説明 | データ タイプ |
| 更新された入力ラスター | 出力ラスター データセット。 | Raster Layer |
arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite}, {convert_colormap})| 名前 | 説明 | データ タイプ |
in_raster | テーブルを追加する対象となる入力ラスター データセット。 このツールは、ピクセル タイプが浮動小数点または倍精度である場合は、実行されません。 | Raster Layer |
overwrite (オプション) | 既存のテーブルを上書きするかどうかを指定します。
| Boolean |
convert_colormap (オプション) | カラーマップをラスター属性テーブルに変換するかどうかを指定します。 出力ラスター属性テーブルには、カラーマップの色の値を含む Red、Green、Blue の各フィールドがあります。 これらのフィールドは、対応するクラス値の表示色を定義します。 関連するカラーマップが [入力ラスター] パラメーター値に含まれている場合のみ、このパラメーターが適用されます。
| Boolean |
| 名前 | 説明 | データ タイプ |
| out_raster | 出力ラスター データセット。 | Raster Layer |
以下は、BuildRasterAttributeTable 関数を実行する Python サンプルです。
import arcpy
arcpy.BuildRasterAttributeTable_management("c:/data/image.tif", "Overwrite")以下は、BuildRasterAttributeTable 関数を実行する Python スクリプト サンプルです。
##====================================
##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")