Spatial Analyst のライセンスで利用可能。
サマリー
入力サンプル データと一連のラスター バンドによって定義されたクラスの ASCII シグネチャ ファイルを作成します。
使用法
出力シグネチャ ファイルの拡張子は、「.gsg」にする必要があります。
入力ラスター バンドとフィーチャ サンプル データの入力ラスターは、範囲が重なる必要があります。統計情報は、この共通エリアのみが計算されます。
サンプル データ内にあるクラス サンプルの最少の有効数は 2 です。クラスの最大数はありません。
シグネチャ ファイルが、[最尤法分類 (Maximum Likelihood Classification)] や [クラス確率 (Class Probability)] など、共分散行列を使用する多変量解析ツールで使用される場合、共分散行列が存在する必要があります。この情報は、ダイアログ ボックスの [共分散行列を計算] オプションが有効か、スクリプトの COVARIANCE オプションが指定されている場合に生成されます。これがデフォルトの設定ですので注意してください。共分散行列が作成される場合と平均値のみが生成される場合のシグネチャ ファイルの比較については、「シグネチャの作成 (Create Signatures) の仕組み」をご参照ください。
シグネチャ ファイルは、クラスの名前を入力する以外は何も変更しないでください。ファイル内の統計情報を作成および変更するのは、[多変量解析] ツールのみです。
出力シグネチャ ファイルのクラスの名前はオプションです。これは、参照目的でのみ使用されます。クラス名は、[サンプル フィールド] を通して入力するか、テキスト エディターで結果のシグネチャ ファイルを開いて入力することができます。それぞれのクラス名は、英数字で最大 31 文字です。
-
入力が、4 バンド以上のマルチバンド ラスターから作成したレイヤーである場合、この操作では、レイヤーによって読み込まれた (シンボル表示された) 3 つのバンドだけでなく、ソース データセットに関連付けられたバンドがすべて考慮されます。
マルチバンド ラスターからバンドのサブセットを指定し、ツールの入力として使用するには、いくつかの方法があります。
- ツールのダイアログ ボックスを使用する場合は、[入力ラスター バンド] の横にある参照
ボタンを使用してマルチバンド ラスターを参照し、ラスターを開いて、使用するバンドを選択します。 - マルチバンド ラスターが [コンテンツ] ウィンドウ内のレイヤーである場合、[ラスター レイヤーの作成 (Make Raster Layer)] ツールを使用して、目的のバンドのみが含まれる新しいマルチバンド レイヤーを作成できます。
- [コンポジット バンド (Composite Bands)] を使用して、目的のバンドだけを含む新しいデータセットを作成し、結果のデータセットをツールの入力として使用することもできます。
- Python では、使用するバンドをツール パラメーターでリストとして直接指定できます。
- ツールのダイアログ ボックスを使用する場合は、[入力ラスター バンド] の横にある参照
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
CreateSignatures (in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})| パラメーター | 説明 | データ タイプ |
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 |
コードのサンプル
CreateSignatures (シグネチャの作成) の例 1 (Python ウィンドウ)
次の例では、サンプリングされたトレーニング エリアと一連の入力ラスター バンドによって定義されたクラスのシグネチャ ファイルを作成しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CreateSignatures("sb", "sbtrain", "c:/sapyexamples/output/rbsig.gsg",
"COVARIANCE", "")
CreateSignatures (シグネチャの作成) の例 2 (スタンドアロン スクリプト)
次の例では、サンプリングされたトレーニング エリアと一連の入力ラスター バンドによって定義されたクラスのシグネチャ ファイルを作成しています。
# 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)
環境
ライセンス情報
- ArcGIS Desktop Basic: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Standard: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Advanced: 次のものが必要 Spatial Analyst