シグネチャの作成（Create Signatures） (Spatial Analyst)
サマリ
入力サンプル データと一連のラスタ バンドによって定義されたクラスの ASCII シグネチャ ファイルを作成します。
使用法
-
出力シグネチャ ファイルの拡張子は、「.gsg」にする必要があります。
-
入力ラスタ バンドとフィーチャ サンプル データの入力ラスタは、範囲が重なる必要があります。統計情報は、この共通エリアのみが計算されます。
-
サンプル データ内にあるクラス サンプルの最少の有効数は 2 です。クラスの最大数はありません。
-
シグネチャ ファイルが、[最尤法分類（Maximum Likelihood Classification）] や [クラス確率（Class Probability）] など、共分散行列を使用する多変量解析ツールで使用される場合、共分散行列が存在する必要があります。この情報は、ダイアログ ボックスの [共分散行列を計算] オプションが有効か、スクリプトの [COVARIANCE] オプションが指定されている場合に生成されます。これがデフォルトの設定ですので注意してください。共分散行列が作成される場合と平均値のみが生成される場合のシグネチャ ファイルの比較については、「[シグネチャの作成（Create Signatures）] ツールの仕組みの詳細」をご参照ください。
-
シグネチャ ファイルは、クラスの名前を入力する以外は何も変更しないでください。ファイル内の統計情報を作成および変更するのは、[多変量解析] ツールのみです。
-
出力シグネチャ ファイルのクラスの名前はオプションです。これは、参照目的でのみ使用されます。クラス名は、[サンプル フィールド] を通して入力するか、テキスト エディタで結果のシグネチャ ファイルを開いて入力することができます。それぞれのクラス名は、英数字で最大 31 文字です。
-
入力が、4 バンド以上のマルチバンド ラスタから作成したレイヤである場合、この操作では、レイヤによって読み込まれた（シンボル表示された）3 つのバンドだけでなく、ソース データセットに関連付けられたバンドがすべて考慮されます。
マルチバンド ラスタからバンドのサブセットを指定し、ツールの入力として使用するには、いくつかの方法があります。
- ツールのダイアログ ボックスを使用する場合は、[入力ラスタ バンド] の横にある参照
ボタンを使用してマルチバンド ラスタを参照し、ラスタを開いて、使用するバンドを選択します。 - マルチバンド ラスタがコンテンツ ウィンドウのレイヤである場合は、[ラスタ レイヤの作成（Make Raster Layer）] ツールを使用して、目的のバンドだけを含む新しいマルチバンド レイヤを作成できます。
- [コンポジット バンド（Composite Bands）] を使用して、目的のバンドだけを含む新しいデータセットを作成し、結果のデータセットをツールの入力として使用することもできます。
- Python では、使用するバンドをツール パラメータでリストとして直接指定できます。
- ツールのダイアログ ボックスを使用する場合は、[入力ラスタ バンド] の横にある参照
構文
| パラメータ | 説明 | データ タイプ |
in_raster_bands [in_raster_band,...] |
シグネチャを作成する入力ラスタ バンド。 | Raster Layer |
in_sample_data |
一連のクラス サンプルを表す入力。 入力には、整数ラスタまたはフィーチャ データセットを使用できます。 | Raster Layer | Feature Layer |
out_signature_file |
出力シグネチャ ファイル。 拡張子「.gsg」を指定する必要があります。 | File |
compute_covariance (オプション) |
平均値の他に、共分散行列を計算するかどうかを指定します。
| Boolean |
sample_field (オプション) |
サンプリングした位置（クラス）に値を割り当てる入力ラスタまたはフィーチャ サンプル データのフィールド。 有効なフィールドは、整数または文字列のフィールドだけです。指定した数字または文字列は、出力シグネチャ ファイルでクラス名として使用されます。 | Field |
コードのサンプル
次の例では、サンプリングされたトレーニング エリアと一連の入力ラスタ バンドによって定義されたクラスのシグネチャ ファイルを作成しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CreateSignatures("sb", "sbtrain", "c:/sapyexamples/output/rbsig.gsg",
"COVARIANCE", "")
次の例では、サンプリングされたトレーニング エリアと一連の入力ラスタ バンドによって定義されたクラスのシグネチャ ファイルを作成しています。
# Name: CreateSignatures_Ex_02.py
# Description: Creates an ASCII signature file of classes defined by input
# sample data and a set of raster bands.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "sb"
inSamples = "sbtrain"
outSig = "c:/sapyexamples/output/rbsig02.gsg"
sampField = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)