トップ ハット変換 (Spatial Analyst ツール)
サマリー
使用法
出力ラスターは、各セル位置で検出された空間構造の高さまたは深さを表します。
解析タイプ パラメーター値は検出する空間構造の種類を指定します。 2 つのオプションは リッジ または バレー です。 リッジ 解析タイプは、周囲よりも高い空間構造を検出します。 谷 解析タイプは、周囲よりも低い空間構造を検出します。
近傍 パラメーター値は解析に使用されるウィンドウの形状と大きさを決定します。 この近傍よりもサイズまたは幅が小さい空間構造が一般的に検出されます。
使用できる近傍形状は、円、四角形、不規則です。 不規則近傍オプションは、カーネル ファイルを使って定義されたカスタム近傍です。
カーネル ファイルは、近傍の値と形状を指定する ASCII テキスト ファイルです。 ファイルは任意のプレーン テキスト エディターで作成できます。 ファイルには .txt 拡張子を付ける必要があり、ファイル名にスペースを含めることはできません。
出力ラスターの形式が .crf の場合、このツールはピラミッド ラスター格納環境をサポートします。 デフォルトでは、ピラミッドは出力で作成されます。 その他の出力形式ではこの環境はサポートされず、ピラミッドは作成されません。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
ラベル
説明
データ タイプ
入力サーフェス ラスター
入力サーフェス ラスター。
Raster Layer
近傍
(オプション)
トップ ハット変換の計算に使用される処理セルを囲むセルです。 さまざまな定義済みの近傍タイプから選択できます。または、カスタム カーネルを定義できます。
近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、半径 3 セルの円です。
使用可能な近傍タイプの形式を次に示します。
円形 、半径 、単位の種類
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
長方形 、高さ 、幅 、単位の種類
幅と高さで定義される長方形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。
不規則 、カーネル ファイル
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
円形および長方形の近傍タイプの場合、パラメーターの距離単位は、セル 単位または マップ 単位で指定できます。 セル単位がデフォルトです。
近傍タイプが不規則の場合、カーネル ファイルの最初の行は、セル数の近傍の幅と高さを定義します。 次の行は、カーネル内でその位置に対応する入力値の処理方法を示しています。 カーネル ファイルでの 0 という値は、対応する場所が計算に含まれないことを示します。 値 1 は、対応する入力セルが含まれることを示します。
Neighborhood
解析タイプ
(オプション)
検出されるオブジェクトのタイプを指定します。
String
戻り値
ラベル
説明
データ タイプ
出力ラスター
出力ラスター。
出力ラスターのセル値は、各セル位置で検出されたオブジェクトの高さまたは深さ (解析タイプによる) を表します。 解析タイプ に 尾根 オプションが指定されている場合、出力値は各セル位置で検出されたオブジェクトの高さを表します。 解析タイプ に 谷 オプションが指定されている場合、出力値は各セル位置で検出されたオブジェクトの深さを表します。
Raster
TopHatTransform(in_raster, {neighborhood}, {analysis_type})
名前
説明
データ タイプ
in_raster
入力サーフェス ラスター。
Raster Layer
neighborhood
(オプション)
トップ ハット変換の計算に使用される処理セルを囲むセルです。 さまざまな定義済みの近傍タイプから選択できます。または、カスタム カーネルを定義できます。
近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、半径 3 セルの円です。
近傍の形状は、NeighborhoodNbrCircleNbrRectangleNbrIrregular
使用可能な近傍タイプの形式を次に示します。
NbrCircle({radius}, {units}
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
NbrRectangle({width}, {height}, {units})
幅と高さで定義される長方形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。
NbrIrregular(inKernelFile)
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
近傍タイプが不規則の場合、カーネル ファイルの最初の行は、セル数の近傍の幅と高さを定義します。 次の行は、カーネル内でその位置に対応する入力値の処理方法を示しています。 カーネル ファイルでの 0 という値は、対応する場所が計算に含まれないことを示します。 値 1 は、対応する入力セルが含まれることを示します。
Neighborhood
analysis_type
(オプション)
検出されるオブジェクトのタイプを指定します。
String
戻り値
名前
説明
データ タイプ
out_raster
出力ラスター。
出力ラスターのセル値は、各セル位置で検出されたオブジェクトの高さまたは深さ (解析タイプによる) を表します。 analysis_type パラメーターに RIDGE オプションが指定されている場合、出力値は各セル位置で検出されたオブジェクトの高さを表します。 analysis_type パラメーターに VALLEY オプションが指定されている場合、出力値は各セル位置で検出されたオブジェクトの深さを表します。
Raster
コードのサンプル
TopHatTransform 例 1 (Python ウィンドウ)
この例では、谷解析タイプを使用して入力ラスターのトップ ハット変換を計算します。
from arcpy.sa import *
outRas = TopHatTransform('elevation.tif', "Circle 3 CELL", 'VALLEY')
outRas.save("C:/sapyexamples/output/thtout01.tif")
TopHatTransform 例 2 (スタンドアロン スクリプト)
この例では、尾根解析タイプを使用して入力ラスターのトップ ハット変換を計算します。
# Name: TopHatTransform_standalone.py
# Description: Calculates the top hat transform.
# Requirements: Spatial Analyst extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"
inAnalysisType = "RIDGE"
# Run the tool
outRas = TopHatTransform(inRaster, inNeighborhood, inAnalysisType)
# Save the output
outRas.save("C:/sapyexamples/output/thtout02.tif")
環境
自動コミット , セル サイズ , セル サイズ投影法 , 圧縮 , 現在のワークスペース , 範囲 , 地理座標系変換 , マスク , 出力データのコンフィグレーション キーワード , 出力座標系 , スクラッチ ワークスペース , スナップ対象ラスター , タイル サイズ
ライセンス情報
Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要