マルチスケール サーフェス パーセンタイル (Spatial Analyst ツール)
サマリー
空間縮尺の範囲における、最も極端なパーセンタイルを計算します。
使用法
入力サーフェス ラスター (Python では
in_raster) パラメーターの値には、いずれかのタイプのサーフェス ラスターを指定できます。 標高サーフェス以外のサーフェス ラスターを使用する場合、このツールはラスターのセル値のパーセンタイルを計算します。標高サーフェスを入力として使用する場合、標高パーセンタイル (EP) が計算されるパーセンタイルです。 EP は、局所的な地形位置 (LTP) の尺度です。 これは、セルの垂直位置を、フィルター ウィンドウまたは近傍内の標高分布のパーセンタイルとして表現します。 マルチスケール EP は、小スケールでは大きく変化しますが、大スケールではより緩やかに変化します。 また、不規則な標高分布や外れ値の影響も比較的受けにくいため、LTP の堅牢な尺度です。
入力として標高サーフェスと別のタイプのサーフェスのどちらを使用する場合でも、パーセンタイルは複数のスケールで計算されます。 これらのスケールは、計算に使用される近傍距離値です。 これらは、ターゲット セルの中心からの距離で、ターゲット セルの周囲にセルの正方形を作成します。 たとえば、4 つのセルのスケールは、9 x 9 セルの近傍です。
出力パーセンタイル ラスター (Python では
out_percentile_raster) パラメーターはプライマリー出力です。 空間スケールの範囲全体における各セルの最も極端なパーセンタイルを含むラスターです。 値の範囲は 0 ～ 100 です。 最も極端な値は、50 から最も遠いパーセンタイル (0 または 100 に近いパーセンタイルなど) です。出力スケール ラスター (Python では
out_scale_raster) パラメーターは、プライマリー出力に関するさらに詳細な情報を提供します。 これには、各セルで最も極端なパーセンタイルが見つかったスケールが含まれます。 このスケールは近傍距離の値です (ターゲット セルの中心からの距離、ターゲット セルを囲むセルから成る四角形を作成)。距離単位 パラメーター (Python では
distance_units) のヤード・ポンド単位のオプションは国際版の単位です。 米国測量のヤード・ポンド単位は現在のところサポートされていません。 入力サーフェス ラスター の値の空間参照のマップ単位が米国測量の場合、このパラメーターではデフォルト値として セル が使用されます。最小近傍距離 (Python では
min_scale) および 最大近傍距離 (Python ではmax_scale) パラメーターは、パーセンタイルが計算される最小および最大の近傍サイズ、つまりスケールを定義します。 これらの値は、ターゲット セルからの最小距離と最大距離を表します。 たとえば、値 1 では 3 x 3 のセル近傍が作成され、値 2 では 5 x 5 のセル近傍が作成されます。これらの値は、入力ラスターのセル サイズまたは 1 セルよりも小さくすることはできません。
最小近傍距離 パラメーター値は、最大近傍距離 パラメーター値以下でなくてはなりません。
基本距離の増分 (Python では
base_increment) パラメーターは、スケール間の近傍距離の初期増分です。 この増分は、非線形ファクター (Python ではnonlinearity) パラメーターに 1 より大きい値を使用すると変更されます。このパラメーター値を入力ラスターのセル サイズ (1 セル) よりも小さくすることはできません。 デフォルト値は入力ラスターのセル サイズです。
非線形ファクター パラメーターは、近傍距離の増分、つまり縮尺を制御します。 値が 1.0 の場合、スケールの線形増分が作成され、スケール間の増分が同じになります (基本距離増分 パラメーターの値)。 この値を大きくすると、スケールが速く増加し、指定された最小スケールと最大スケールのスケール数が減ります。
小スケールを高いスケール サンプリング密度、大スケールを低いスケール サンプリング密度にする場合、このパラメーターに 1.0 より大きい値を使用します。
このパラメーターは 1.0 以上の値を受け入れます。 一般に、近傍距離で非線形増分を使用する場合、このパラメーターには 1.0 ～ 2.0 の値が最もよく使用されます。
入力サーフェス ラスター 値の NoData セルは無視され、それらのセルには 出力パーセンタイル ラスター と 出力スケール ラスター パラメーター値に NoData が割り当てられます。
このツールは GPU により処理を加速化できます。つまり、システムで互換性のある GPU (グラフィックス処理装置) を使用可能な場合は、その GPU を使用してツールのパフォーマンスを強化できます。 このツールの実行に GPU と CPU のどちらを使用するかを制御するには、解析のターゲット デバイス パラメーター (Python では
analysis_target_device) を使用します。互換性のある GPU、GPU デバイスの構成と操作、トラブルシューティングのヒントの詳細については、Spatial Analyst での GPU 処理をご参照ください。
このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサや、複数のコアを持つプロセッサが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。 Spatial Analyst による並列処理ヘルプ トピックには、この機能と設定方法の詳細が記載されています。
デフォルトでは、このツールは使用可能なコアの 50% を使うようになっています。 並列処理ファクター環境で、ツールが使用するコアの数を制御できます。
出力ラスターの形式が
.crfの場合、このツールはピラミッドラスター格納環境をサポートします。 デフォルトでは、ピラミッドは出力で作成されます。 その他の出力形式ではこの環境はサポートされず、ピラミッドは作成されません。このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力サーフェス ラスター |
入力サーフェス ラスター。 |
Raster Layer |
|
出力スケール ラスター (オプション) |
各セルで最も極端なパーセンタイルが見つかったスケールを含む出力ラスター。 スケールはその近傍距離の値として表されます。 浮動小数点タイプになります。 |
Raster Dataset |
|
距離単位 (オプション) |
最小近傍距離、最大近傍距離、基本距離の増分 の各パラメーターに使用される距離単位を指定します。 距離は、セル数または指定した単位で計測されます。 デフォルトは、入力サーフェス ラスター 値の空間参照のマップ単位です。
|
String |
|
最小近傍距離 (オプション) |
標高パーセンタイルが計算される最小の近傍スケールを定義する距離。 これはターゲット セルの中心からの距離であり、ターゲット セルを囲むセルから成る四角形を作成します。 この値は 最大近傍距離 パラメーター値以下、入力ラスター セル サイズまたは 1 セル以上である必要があります。 デフォルト値は 入力サーフェス ラスター パラメーター値のセル サイズの 4 倍で、9 x 9 セル近傍になります。 |
Double |
|
最大近傍距離 (オプション) |
標高パーセンタイルが計算される最大の近傍スケールを定義する距離。 これはターゲット セルの中心からの距離であり、ターゲット セルを囲むセルから成る四角形を作成します。 この値は 最小近傍距離 パラメーター値と、入力ラスター セル サイズまたは 1 セル以上である必要があります。 デフォルト値は 入力サーフェス ラスター パラメーター値のセル サイズの 13 倍で、27 x 27 セル近傍になります。 |
Double |
|
基本距離の増分 (オプション) |
縮尺間の近傍距離の初期増分。 このパラメーター値を 入力サーフェス ラスター のセル サイズ (1 セル) よりも小さくすることはできません。 デフォルト値は、入力サーフェス ラスター パラメーター値のセル サイズです。 |
Double |
|
非線形ファクター (オプション) |
スケールの拡大において非線形な増分を実現するファクター。 これにより、スケール間の増分が一定でなくなります。 通常、1.0 ～ 2.0 の間の値が使用されます。 このパラメーターは 1 以上でなくてはなりません。 デフォルト値は 1 で、近傍距離が線形に増加します (スケール間の増分が一定です)。 |
Double |
|
解析のターゲット デバイス (オプション) |
計算の実行に使用するデバイスを指定します。
|
String |
戻り値
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
出力パーセンタイル ラスター |
各セルの最も極端なパーセンタイル値を含む出力ラスター。 最も極端な値は、50 から最も遠いパーセンタイル (0 または 100 に近いパーセンタイルなど) です。 浮動小数点タイプになります。 |
Raster |
環境
自動コミット, セル サイズ, セル サイズ投影法, 現在のワークスペース, 範囲, 地理座標系変換, GPU ID, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, 並列処理ファクター, プロセッサー タイプ, ピラミッド, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ
ライセンス情報
- Basic: Spatial Analyst が必要
- Standard: Spatial Analyst が必要
- Advanced: Spatial Analyst が必要