シグネチャーの編集 (Spatial Analyst ツール)

サマリー

クラスシグネチャーをマージ、番号の再割り当て、および削除することでシグネチャーファイルを編集および更新します。

使用法

シグネチャーの編集 ツールを使用すると、次の一部または全部の操作によって、既存のシグネチャーファイルを変更できます。
- 一連のクラスからなるシグネチャーのマージ
- シグネチャークラス ID の再割り当て
- 不要なシグネチャーの削除
入力ラスターバンド (Python では in_raster_bands) の 1 つとしてマルチバンドラスターが指定された場合、すべてのバンドが使用されます。

マルチバンドラスターから選択したバンドを処理するには、まず、コンポジットバンドツールを使用して、それら特定のバンドから構成される新しいラスターデータセットを作成し、その結果を 入力ラスターバンド (Python では in_raster_bands) のリストで使用できます。
The input signature file must be an ASCII signature file. The file can be the output of any Multivariate tool that produces the file containing the required statistical information—たとえば、ISO クラスター や シグネチャーの作成 などです。ファイルには、最低 2 つのクラスが必要です。このようなファイルは、拡張子が .gsg であることでわかります。
入力シグネチャー再分類ファイルは、コロンで区切られた、1 行あたり 2 つの列からなる ASCII ファイルです。最初の列は、元のクラス ID の値です。 2 番目の列には、シグネチャーファイル内で更新するための新しいクラス ID が含まれます。ファイルのエントリはすべて、最初の列を基準にして、昇順で並べ替える必要があります。

状況によっては、必要なクラスのいくつかが統計的に極めて近いため、一意のクラスに対するセル割り当ての信頼性が低くなることがあります。たとえば、湿地クラスと、森林湿地用の別のクラスを必要としたとします。しかし、これら 2 つのクラスは簡単に区別できません。この場合、森林湿地クラスを、より一般的な湿地クラスにマージできます。また、これらのクラスの間に統計的な差異がない場合は、基本的に両方が同じクラスを表すため、いずれか 1 つのクラスを完全に削除できます。

一連のクラスをマージするには、そのセットの各クラス ID の 2 番目の値に同じ新しいクラス ID を設定します。シグネチャー再分類ファイルには、編集する必要のあるクラスのみを置かなければなりません。再分類ファイルにないクラスは変更されません。クラスシグネチャーを削除するには、そのクラスの 2 番目の列に、-9999 という値を入力します。また、クラス ID を入力シグネチャーファイルに存在しない値に再番号付けすることもできます。

入力シグネチャー再分類ファイルの例を以下に示します。

``<!--

この例では、クラス 2 と 9 を 3 にマージし、クラス 4 を 11 にマージして、クラス 5 を削除します。
入力シグネチャーファイルがクラスシグネチャーの名前を持ち、入力シグネチャー再分類ファイル内のシグネチャーをマージする場合、マージする値に関連付けられた名前は、出力シグネチャーファイルに転送されます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
入力ラスターバンド	シグネチャーを編集する入力ラスターバンド。整数タイプまたは浮動小数点タイプにすることができます。	Raster Layer
入力シグネチャーファイル	編集するクラスシグネチャを持つ入力シグネチャーファイル。拡張子 `-->.gsg<!--` が必要です。	File
入力シグネチャー再分類ファイル	マージ、再番号付け、または削除するクラス ID が含まれた、入力 ASCII 再分類テーブル。拡張子には、`-->.rmp`, `.asc` or `.txt`. The default is `.rmp<!--` を使用できます。	File
出力シグネチャーファイル	出力シグネチャーファイル。拡張子 `-->.gsg<!--` を指定する必要があります。	File
サンプル間隔 (オプション)	サンプリングに使用する間隔。デフォルトは 10 です。	Long

EditSignatures(in_raster_bands, in_signature_file, in_signature_remap_file, out_signature_file, {sample_interval})

名前	説明	データタイプ
in_raster_bands [in_raster_band,...]	シグネチャーを編集する入力ラスターバンド。整数タイプまたは浮動小数点タイプにすることができます。	Raster Layer
in_signature_file	編集するクラスシグネチャを持つ入力シグネチャーファイル。拡張子 `-->.gsg<!--` が必要です。	File
in_signature_remap_file	マージ、再番号付け、または削除するクラス ID が含まれた、入力 ASCII 再分類テーブル。拡張子には、`-->.rmp`, `.asc` or `.txt`. The default is `.rmp<!--` を使用できます。	File
out_signature_file	出力シグネチャーファイル。拡張子 `-->.gsg<!--` を指定する必要があります。	File
sample_interval (オプション)	サンプリングに使用する間隔。デフォルトは 10 です。	Long

コードのサンプル

-->EditSignatures<!-- の例 1 (Python ウィンドウ)

この例では、入力再分類ファイルに基づいてシグネチャーファイルを編集します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
EditSignatures("redl123", "c:/sapyexamples/data/zsamp12.gsg",
               "c:/sapyexamples/data/zsamp7.rmp",
               "c:/sapyexamples/output/redlremap.gsg", "")

-->EditSignatures の例 2 (スタンドアロンスクリプト)

この例では、入力再分類ファイルに基づいてシグネチャーファイルを編集します。

# Name: EditSignatures_Ex_02.py
# Description: Edits and updates a signature file by merging, renumbering,
#    and deleting class signatures.
# 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 = "redl123"
oldSig = "c:/sapyexamples/data/zsamp12.gsg"
sigRemap = "c:/sapyexamples/data/zsamp7.rmp"
outNewSig = "c:/sapyexamples/output/redlsig.gsg"
interval = ""

# Run EditSignatures
EditSignatures(inRaster, oldSig, sigRemap, outNewSig, interval)

環境

セルサイズ, セルサイズ投影法, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力座標系, スクラッチワークスペース, スナップ対象ラスター

ライセンス情報

Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要

シグネチャーの編集 (Spatial Analyst ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック