Spatial Analyst のライセンスで利用可能。
概要
直線距離、コスト距離、実際のサーフェス距離、垂直および水平方向のコスト係数を考慮して、各セルからソースまでの累積距離を計算します。
グローバル ラスター関数です。
備考
ソース フィーチャがある場合は、最初に、フィーチャのラスター化関数を使用してそれらのフィーチャをラスター データセットに変換できます。整合性のある入力を、この関数の [ラスター] 入力として使用します。これにより、フィーチャが確実に、同じセル サイズ、範囲、および空間参照を使用して正しく変換されるようになります。
[ソース ラスター] 内に存在する NoData 値は、関数の有効な値として含まれません。値 0 (ゼロ) は、ソース ラスター内の正当な値と見なされます。[ソース ラスター] を作成するには、抽出ツールまたはクリップ関数を使用します。
[範囲] 環境設定が指定されていない場合、処理範囲は次の方法で決定されます。
[入力ラスター、またはフィーチャ ソース データ] および [入力バリア ラスターまたはフィーチャ データ] のみが指定されている場合、両側の 2 つのセル幅で拡張された入力のユニオンが処理範囲として使用されます。出力ラスターが 2 行および 2 列で拡張される理由は、出力を [最適パス (ライン) (Optimal Path As Line)] と [最適パス (ラスター) (Optimal Path As Raster)] で使用するためです。生成されたパスはバリアを回避できます。範囲を暗黙的なバリアとして使用するには、環境設定で [範囲] を明示的に設定する必要があります。
[入力サーフェス ラスター]、[入力コスト ラスター]、[入力垂直方向ラスター]、または [入力水平方向ラスター] のいずれかのラスター データセットが指定されている場合、処理範囲はこれらのラスターの交差部分になります。
[セル サイズ] または [スナップ対象ラスター] 環境設定が指定されておらず、入力として複数のラスターが指定されている場合、[セル サイズ] および [スナップ対象ラスター] は以下の優先順位に基づいて設定されます: [入力コスト ラスター]、[入力サーフェス ラスター]、[入力垂直方向ラスター]、[入力水平方向ラスター]、[入力ラスター、またはフィーチャ ソース データ]、および [入力バリア ラスターまたはフィーチャ データ]。
出力ラスターの場合、セルから一部のソース位置までの最小コスト距離 (または最小累積コスト距離) は、セルから全ソース位置までの最小コスト距離の下限です。
垂直方向ファクターの修飾子のデフォルト値は次のとおりです。
Keyword Zero Low High Slope Power Cos Sec
factor cut cut power power
angle angle
------------------------ ------ ----- ----- ----- ----- ----- -----
Binary 1.0 -30 30 ~ ~ ~ ~
Linear 1.0 -90 90 1/90 ~ ~ ~
Symmetric linear 1.0 -90 90 1/90 ~ ~ ~
Inverse linear 1.0 -45 45 -1/45 ~ ~ ~
Symmetric inverse linear 1.0 -45 45 -1/45 ~ ~ ~
Cos ~ -90 90 ~ 1.0 ~ ~
Sec ~ -90 90 ~ 1.0 ~ ~
Cos_sec ~ -90 90 ~ ~ 1.0 1.0
Sec_cos ~ -90 90 ~ ~ 1.0 1.0[傾斜方向] 関数の出力は、[入力水平方向ラスター] への入力に使用できます。
水平方向ファクターの修飾子のデフォルト値は次のとおりです。
Keywords Zero factor Cut angle Slope Side value -------------- ----------- ----------- ----- --------- Binary 1.0 45 ~ ~ Forward 0.5 45 (fixed) ~ 1.0 Linear 0.5 181 1/90 ~ Inverse linear 2.0 180 -1/90 ~
[ブール型] オプション [出力に追加のバンドとしてバック方向バンドを生成] をオンにすると、マルチバンド レイヤーが作成されます。最初のバンドは距離累積ラスターで、2 番目のバンドはバック方向ラスターです。これらのラスターは両方とも、ソースから特定の目的地への最適なパスを作成するために必要です。パスを作成するには、まず、[バンド抽出] 関数を使用して、距離累積ラスターおよびバック方向ラスターを抽出します。これらのレイヤーは [コスト パス] 関数への入力として使用されます。距離累積ラスターは [コスト距離ラスター] として使用され、バック方向ラスターは [コスト バックリンク ラスター] として使用されます。
値を使用してソースの特性パラメーターを指定した場合、すべてのソースにその値が適用されます。[ソース ラスター] に関連付けられたフィールドを使用してパラメーターを指定した場合、テーブル内の値が対応するソースだけに適用されます。
- [初期累積] は、移動が開始される前の開始コストを設定します。
- [最大累積] は、ソースが上限に達する前に累積できるコストの量を指定します。
- [コストに適用する乗数] は、移動のモードを指定します。
- [移動方向] は、移動者がソースを起点としてソース以外の場所に移動するか、ソース以外の場所を起点としてソースへ戻るかを識別します。
この関数は、並列処理をサポートしています。お使いのコンピューターに、複数のプロセッサや、複数のコアを持つプロセッサが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。この機能とこの機能の構成方法の詳細については、「Spatial Analyst による並列処理」をご参照ください。
並列処理を使用する場合、処理中のデータ チャンクを処理するために一時データが書き込まれます。デフォルトの一時フォルダーの場所は、ローカルの C ドライブ上です。このフォルダーの場所は、TempFolders という名前のシステム環境変数を設定し、使用するフォルダーへのパスを指定することで変更できます (例: E:\RasterCache)。コンピューター上で管理権限を持っている場合は、レジストリ キー (例: [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]) を使用することもできます。
デフォルトでは、この関数は使用可能なコアのうちの 50% を使用します。入力データのサイズが 5,000 セル x 5,000 セルよりも小さい場合、使用されるコア数はそれよりも少なくなります。並列処理ファクター環境で、ツールが使用するコアの数を制御できます。
パラメーター
| パラメーター名 | 説明 |
|---|---|
ソース ラスター (必須) | 入力ソース位置。 これは、あらゆる出力セル位置について最小累積コスト距離が計算されるセルまたは位置を特定するラスター データセットです。 整数タイプまたは浮動小数点タイプのいずれかになります。 |
ラスター バリア | バリアを定義するラスター。 バリアが存在しない場合、データセットには NoData を含める必要があります。バリアはゼロを含む有効な値で表されます。 バリアは、整数または浮動小数点のいずれかになります。 |
サーフェス ラスター | 各セル位置の標高値を定義するラスター。 この値は、セル間を通過するときにたどる実際のサーフェス距離を計算するときに使用されます。 |
コスト ラスター | 各セルを平面的に通過する際にかかるコストまたはインピーダンスを定義するラスター。各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。セルを通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動の補正も行います。 [コスト ラスター] として、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません。 |
垂直方向ラスター | 垂直コスト ファクターと垂直相対移動角度 (VRMA) の間の関係を定義します。 この値は、あるセルから別のセルに移動するときに生じる垂直方向ファクターを特定する傾斜角を計算するために使用されます。 |
垂直方向ファクター | 垂直コスト ファクターと垂直相対移動角度 (VRMA) の間の関係を定義します。 定義された垂直方向ファクター グラフを特定する修飾子付きの複数のファクターの中から選択できます。さらに、テーブルを使用してカスタム グラフを作成することもできます。グラフは、隣接セルに移動する総コストを計算するときに使用する垂直方向ファクターを特定するために使用されます。 以下の説明では、VF および VRMA という 2 つ略語を使用しています。VF は Vertical Factor (垂直方向ファクター) を表し、1 つのセルから次のセルに移動する際に生じる垂直方向の問題を意味します。VRMA は Vertical Relative Moving Angle (垂直相対移動角度) を表し、開始セル (つまり、処理セル) と終了セルとの間の傾斜角を意味します。 [垂直方向ファクター] タイプは以下のとおりです。
垂直方向ファクター キーワードの修飾子は次のとおりです。
|
水平方向ラスター | 各セルの水平方向を定義するラスター。 ラスター上の値は 0 〜 360 の範囲の整数でなくてはいけません。0 度は北または画面の上方向を示し、値は時計回りに増加します。平らなエリアには -1 という値を指定します。各位置の値は [水平方向ファクター] と組み合わせて、あるセルから隣接セルに移動するときに発生する水平コストを決定するときに使用されます。 |
水平方向ファクター | 水平コスト ファクターと水平相対移動角度 (HRMA) の間の関係を定義します。 定義された垂直方向ファクター グラフを特定する修飾子付きの複数のファクターの中から選択できます。さらに、テーブルを使用してカスタム グラフを作成することもできます。グラフは、隣接セルに移動する総コストを計算するときに使用する垂直方向ファクターを特定するために使用されます。 以下の説明では、HF および HRMA という 2 つ略語を使用しています。HF は Horizontal Factor (水平方向ファクター) を表し、1 つのセルから次のセルに移動する際に生じる水平方向の問題を意味します。HRMA は Horizontal Relative Moving Angle (水平相対移動角度) を表し、1 つのセルからの水平方向と移動方向との間の角度を意味します。 [水平方向ファクター] タイプは以下のとおりです。
水平方向ファクターの修飾子は次のとおりです。
|
出力に追加のバンドとしてバック方向バンドを生成 | 距離累積ラスターが作成されるか、距離累積ラスターとバック方向ラスカーの両方からなるマルチバンド ラスターが作成されるかを決定します。
バック方向ラスターは、バリアを避けながら、最寄りのソースに戻る最短パスに沿った隣接セルへの方向 (度) をセルごとに計算します。 |
距離計算の方法 | 距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。
|
初期累積 | コスト計算を開始する際の初期累積コストです。このパラメーターを使用すると、ソースに関連付けられた固定コストを指定できます。コスト アルゴリズムは、コスト 0 から開始する代わりに、設定された値から開始します。 このパラメーターには数値 (double) または [ソース ラスター] のフィールドを使用できます。 値は 0 以上である必要があります。デフォルトは 0 です。 |
最大累積 | ソースに対する移動者の最大累積コストを定義します。指定した許容値に達するまで、各ソースのコスト計算が続行されます。 このパラメーターには数値 (double) または [ソース ラスター] のフィールドを使用できます。 0 より大きい値を指定する必要があります。デフォルトの許容値は出力ラスターのエッジまでです。 |
コストに適用する乗数 | コスト値に適用する乗数です。 このパラメーターを使用すると、移動のモードまたはソースの強度を制御できます。乗数が大きいほど、各セルの移動コストが大きくなります。 このパラメーターには数値 (double) または [ソース ラスター] のフィールドを使用できます。 0 より大きい値を指定する必要があります。デフォルトは [1] です。 |
移動方向 | 垂直方向の係数、水平方向の係数、およびソースの耐性率を適用する際の、移動者の方向を定義します。
[ソースから] または [ソースへ] キーワードを選択します。これは、すべてのソースに適用されます。または、[ソース ラスター] から、各ソースの移動方向を識別するキーワードを含むフィールドを指定します。このフィールドには、文字列 FROM_SOURCE または TO_SOURCE が含まれている必要があります。 |
環境設定
グローバル関数のジオプロセシング環境設定は、アプリケーション レベルで制御されます。ArcGIS Pro での処理環境の設定は、[解析] タブの [環境] ボタンをクリックして行うことができます。環境設定の詳細については、「解析環境と Spatial Analyst」をご参照ください。
このグローバル関数では、次の環境がサポートされています。