Skip to main content

パスの距離 (Spatial Analyst ツール)

サマリー

水平コスト係数と鉛直コスト係数とともにサーフェス距離を考慮に入れて、最小コスト ソースとの最小累積コスト距離をセルごとに計算します。

レガシー:

このツールは非推奨となり、将来のリリースで削除される予定です。

距離累積 ツールにより、機能またはパフォーマンスが向上します。

パスの距離ツールの詳細

使用法

  • パスの距離ツールは、ラスターの各セル位置とソースとの最小累積移動コストを求めるという点ではコスト距離ツールと同等です。 ただし、パスの距離ツールでは、他の水平方向ファクターと鉛直方向ファクターに加えて実際のサーフェス距離を考慮できるため、解析がさらに複雑になります。

  • 入力ソース データは、フィーチャクラスまたはラスターです。 フィーチャクラスは、ポイント、ライン、またはポリゴンです。

  • 入力ソース データがラスターの場合、一連のソース セルは、ソース ラスター内にある有効な値を持つすべてのセルから構成されます。 値が NoData のセルは、ソース セットには含まれません。 ゼロは有効値です。 ソース ラスターは、抽出ツールを使用して作成できます。

  • 入力ソース データがフィーチャクラスの場合、解析を実行する前に内部でソースの位置がラスターに変換されます。 ラスターの解像度はセル サイズ環境で制御できます。 他のラスターがツールで指定されていない場合、デフォルトの解像度は、入力空間参照において、入力フィーチャの範囲の幅または高さ (どちらか短い方) を 250 で割った値になります。

  • 入力のソース データにフィーチャ データを使用する場合は、出力セル サイズが入力の詳細よりも粗いときの処理方法に注意する必要があります。 内部的なラスター化処理では、フィーチャ → ラスター ツールと同じデフォルトの 集約タイプ 値 (セルの中心メソッド) が使用されます。 つまり、セルの中心に配置されていないデータはラスター化されたソースの中間出力に含まれず、距離の計算では表されません。 たとえば、ソースが出力のセル サイズに比べて小さい一連のポリゴン (建物のフットプリントなど) である場合は、一部のポリゴンだけが出力ラスター セルの中心に分類され、ほとんどのポリゴンが解析で失われたように見える可能性があります。

    この状況を回避するには、中間的な手順として、フィーチャ → ラスター ツールを使用して入力フィーチャを直接ラスター化し、 フィールド パラメーターを設定します。 次に、結果の出力を距離ツールの入力として使用します。 または、入力フィーチャから適切な量の情報を捕捉できる、小さいセル サイズを選択することもできます。

  • NoData 値のセルは、パスの距離ツールではバリアとして働きます。 NoData 値の背後にあるセルのコスト距離は、NoData バリアを回避するのに必要な累積コストによって計算されます。 いずれかの入力ラスターで NoData が割り当てられたセル位置は、すべての出力ラスターで NoData になります。

  • 入力ソース データとコスト ラスターの範囲が異なる場合、デフォルトの出力範囲は両者の交差部分です。 範囲全体のコスト距離サーフェスを取得するには、出力の範囲環境設定で 入力データのすべての領域 オプションを選択します。

  • 傾斜方向 ツールの出力は、 入力水平方向ラスター パラメーターの入力として使用できます。

  • 最大距離 パラメーターの値は、コスト ラスターと同じコストの単位で指定します。

  • 出力距離ラスターの場合、セルと一部ソース位置との最小コスト距離 (または最小累積コスト距離) は、セルから全ソース位置までの最小コスト距離の下限です。

  • 水平方向ファクターの修飾子のデフォルト値は次のとおりです:

    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   ~

  • 垂直方向ファクターの修飾子のデフォルト値は次のとおりです:

    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
Hiking time               ~       -70    70     ~      ~      ~      ~
Bidirectional hiking time ~       -70    70     ~      ~      ~      ~

  • ソースの特性、またはソースに対する移動者は、特定のパラメーターで制御できます。 ソースのコスト乗数 パラメーターは、移動のモードまたはソースの強度を指定します。 ソースの開始コスト は、移動開始前の開始コストを設定します。 ソースの耐性率 は、ハイカーの疲労度のシミュレーションなど、累積コストの影響を考慮した動的な調整を表します。 ソースの容量 は、制限に達するまでソースが許容できるコストの量を設定します。 移動方向 は、移動者がソースを起点としてソース以外の場所に移動するか、ソース以外の場所を起点としてソースへ戻るかを識別します。

  • フィールドを使用してソース特性パラメーターを指定した場合、そのソース特性は、指定されたソース データのフィールド内の情報に従い、ソースごとに適用されます。 キーワードまたは定数値が指定された場合は、すべてのソースに適用されます。

  • ソースの開始コスト パラメーター値が指定され、 移動方向 が ソースから移動 に設定されている場合、出力コスト距離サーフェス上のソース位置が ソースの開始コスト の値に設定されます。そうでない場合は、出力コスト距離サーフェス上のソース位置はゼロに設定されます。

  • このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサーや、複数のコアを持つプロセッサーが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。 この機能と設定方法の詳細については、「Spatial Analyst による並列処理」ヘルプ トピックをご参照ください。

    並列処理を使用する場合、処理中のデータ チャンクを処理するために一時データが書き込まれます。 デフォルトの一時フォルダーの場所は、ローカルの C: ドライブにあります。 このフォルダーの場所は、TempFolders という名前のシステム環境変数を設定し、使用するフォルダーへのパスを指定することで変更できます (例: E:\RasterCache)。 コンピューター上で管理者権限を持っている場合は、レジストリー キー (例: HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster) を使用することもできます。

    デフォルトでは、このツールは使用可能なコアの 50% を使うようになっています。 入力データのサイズが 5,000 セル x 5,000 セルよりも小さい場合、使用されるコア数はそれよりも少なくなります。 並列処理ファクター 環境で、ツールが使用するコアの数を制御できます。

  • 出力ラスターの形式が .crf の場合、このツールはピラミッド ラスター格納環境をサポートします。 デフォルトでは、ピラミッドは出力で作成されます。 その他の出力形式ではこの環境はサポートされず、ピラミッドは作成されません。

  • このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

パラメーター

ラベル 説明 データ タイプ

入力ラスターまたはフィーチャ ソース データ

入力ソース位置。

これは、各出力セル位置の最小累積コスト距離の計算に使用されるセルまたは位置を特定するラスターまたはフィーチャ (ポイント、ライン、またはポリゴン) です。

ラスターの場合、入力タイプは整数または浮動小数点数です。

Raster Layer; Feature Layer

入力コスト ラスター

(オプション)

各セル内を平面的に通過するときにかかるインピーダンスまたはコストを定義するラスター。

各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。 セル内を通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動についても補正します。

コスト ラスターとして、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません (負またはゼロのコストは指定できません)。

Raster Layer

入力サーフェス ラスター

(オプション)

各セル位置の標高値を定義するラスター。

この値は、セル間を通過するときにたどる実際のサーフェス距離を計算するときに使用されます。

Raster Layer

入力水平方向ラスター

(オプション)

各セルの水平方向を定義するラスター。

ラスター上の値は 0 〜 360 の範囲の整数でなくてはいけません。0 度は北または画面の上方向を示し、値は時計回りに増加します。 平らなエリアには -1 という値を指定します。 各位置の値は 水平方向ファクター パラメーターと組み合わせて、あるセルから隣接セルに移動するときに発生する水平コストを決定するときに使用されます。

Raster Layer

水平方向ファクター

(オプション)

水平コスト ファクターと水平相対移動角度 (HRMA) の間の関係を指定します。

定義された水平方向ファクター グラフを特定する修飾子付きのファクターが複数存在します。 さらに、テーブルを使用してカスタム グラフを作成することもできます。 グラフは、隣接セルに移動する総コストを計算するときに使用する水平方向ファクターを特定するために使用されます。

以下の説明では、2 つ略語を使用しています。HF は水平方向ファクターを表し、あるセルから次のセルに移動するときに生じる水平移動の難易度を定義します。HRMA は水平相対移動角度を表し、セルからの水平方向と移動方向がなす角度を示します。

次のようなオプションがあります:

  • バイナリー - HRMA がカット アングルより小さい場合、HF はゼロ ファクターに関連付けられた値に設定され、そうでない場合、HF は無限大に設定されます。

  • 前方 - 前進運動だけが許されます。 HRMA は 0 度以上 90 度未満 (0 <= HRMA < 90) である必要があります。 HRMA が 0 度より大きく 45 度未満である場合、セルの HF はゼロ ファクターに関連付けられている値に設定されます。 HRMA が 45 度以上である場合、サイド値修飾子の値が使用されます。 HRMA が 90 度以上であると、その HF は無限大に設定されます。

  • リニア - HF は HRMA の一次関数です。

  • 逆リニア - HF は HRMA の一次逆関数です。

  • テーブル - テーブル ファイルを使用して、HF の決定に使用される水平方向ファクター グラフを定義します。

水平方向ファクターの修飾子は次のとおりです:

  • ゼロ ファクター - HRMA がゼロのときに使用する水平方向ファクター。 このファクターは、任意の水平方向ファクター関数の Y 軸切片の位置を決めます。

  • カット アングル - HRMA 角度がこの角度を超えると HF は無限大に設定されます。

  • 傾斜角 - リニア および 逆リニア 水平方向ファクター キーワードで使用される直線の傾斜角。 傾斜角は、水平方向の長さを分母、鉛直方向の長さを分子として指定されます (たとえば、45% の傾斜角は 1/45 であり、0.02222 として入力されます)。

  • サイド値 - 前方 水平方向ファクター キーワードが指定され、HRMA が 45 度以上、90 度未満のときの HF 値を指定します。

  • テーブル名 - HF を定義するテーブルの名前。

Horizontal Factor

入力鉛直方向ラスター

(オプション)

各セル位置の Z 値を定義するラスター。

この値は、あるセルから別のセルに移動するときに生じる鉛直方向ファクターを特定する傾斜角を計算するために使用されます。

Raster Layer

鉛直方向ファクター

(オプション)

鉛直コスト ファクターと鉛直相対移動角度 (VRMA) の間の関係を指定します。

定義された鉛直方向ファクター グラフを特定する修飾子付きのファクターが複数存在します。 さらに、テーブルを使用してカスタム グラフを作成することもできます。 グラフは、隣接セルに移動する総コストを計算するときに使用する鉛直方向ファクターを特定するために使用されます。

以下の説明では、2 つ略語を使用しています。VF は鉛直方向ファクターを表し、あるセルから次のセルに移動するときに生じる鉛直移動の困難度を定義します。VRMA は鉛直相対移動角度を表し、FROM セル (処理中のセル) と TO セルの間の傾斜角度を示します。

次のようなオプションがあります:

  • バイナリー - VRMA が最小カット アングルより大きく最大カット アングルより小さい場合、VF はゼロ ファクターに関連付けられた値に設定され、そうでない場合、VF は無限大に設定されます。

  • リニア - VF は VRMA の一次関数です。

  • 相対リニア - VF はそれぞれ VRMA の負の側と正の側で VRMA の一次関数で、この 2 つの一次関数は VF (Y) 軸に対して対称的です。

  • 逆リニア - VF は VRMA の一次逆関数です。

  • 相対逆リニア - VF はそれぞれ VRMA の負の側と正の側で VRMA の一次逆関数であり、この 2 つの一次逆関数は VF (Y) 軸に対して対称的です。

  • Cos - VF は VRMA のコサインベースの関数です。

  • Sec - VF は VRMA のセカントベースの関数です。

  • Cos-Sec - VRMA が負の場合、VF は VRMA のコサインベースの関数で、VRMA が負でない場合、VF は VRMA のセカントベースの関数です。

  • Sec-Cos - VRMA が負の場合、VF は VRMA のセカントベースの関数で、VRMA が負でない場合、VF は VRMA のコサインベースの関数です。

  • ハイキング時間 - VF は VRMA のハイキング時間関数です。

  • 双方向ハイキング時間 - VF は VRMA の双方向の修正済みハイキング時間関数です。

  • テーブル - テーブル ファイルを使用して、VF の決定に使用される鉛直方向ファクター グラフを定義します。

鉛直方向のキーワードの修飾子は次のとおりです:

  • ゼロ ファクター - VRMA がゼロのときに使用する鉛直方向ファクター。 このファクターは、指定された関数の Y 軸切片の位置を決めます。 定義上、ゼロ ファクターは鉛直三角関数 (COS、SEC、COS-SEC、SEC-COS) には適用されません。 Y 軸切片はこれらの関数によって定義されます。

  • 最小カット アングル - VRMA 角度がこの角度を下回ると VF は無限大に設定されます。

  • 最大カット アングル - VRMA 角度がこの角度を上回ると VF は無限大に設定されます。

  • 傾斜角 - リニア および 逆リニア 鉛直方向ファクター キーワードで使用される直線の傾斜角。 傾斜角は、水平方向の長さを分母、鉛直方向の長さを分子として指定されます (たとえば、45% の傾斜角は 1/45 であり、0.02222 として入力されます)。

  • テーブル名 - VF を定義するテーブルの名前。

Vertical Factor

最大距離

(オプション)

累積コスト値が超えることのできない閾値。

累積コスト距離がこの値を超える場合、セル位置の出力値は NoData になります。 最大距離は、累積コスト距離を計算する範囲です。

デフォルトは出力ラスターのエッジまでです。

Double

出力バックリンク ラスター

(オプション)

出力コスト バックリンク ラスター。

バックリンク ラスターは 0 ～ 8 の値を含みます。この値は方向を定義します。つまり、サーフェス距離、水平サーフェス係数、鉛直サーフェス係数を考慮に入れて、セルから最小コスト ソースまでの最小累積コスト パスに沿った次の隣接セルを特定します。

パスが右の隣接セルに進む場合、その隣接セルには値 1 が、右下のセルには値 2 が割り当てられ、これが時計回りに続きます。 値 0 はソース セル用とされています。

Backlink positions

Raster Dataset

コストに適用する乗数

(オプション)

コスト値に適用する乗数です。

これを使用すると、移動のモードまたはソースの強度を制御できます。 乗数が大きいほど、各セルの移動コストが大きくなります。

0 より大きい値を指定する必要があります。 デフォルトは 1 です。

Double; Field

開始コスト

(オプション)

コスト計算を開始する際に使用される開始コストです。

ソースに関連付けられた固定コストを指定できます。 コスト アルゴリズムは、コスト 0 から開始する代わりに、この値から開始します。

値は 0 以上である必要があります。 デフォルトは 0 です。

Double; Field

累積コスト耐性率

(オプション)

このパラメーターは、累積コストの増加に伴う、コストに対処する労力の増加をシミュレートします。 これは、移動者の疲労をモデル化するのに使用されます。 セルに到達するまでに増加した累積コストが耐性率で乗算され、次のセルに移動するコストに追加されます。

これは、複利率の計算式の変更バージョンで、セルの移動による見かけコストの計算に使用されます。 耐性率の値が増えると、後に移動するセルのコストが増加します。 耐性率が大きいほど、次のセルに到達するための追加コストが大きくなります。これは、移動するごとに大きくなります。 耐性率は複利と似ており、累積コストの値は一般に非常に大きいため、耐性率は累積コストの値に応じて 0.02 や 0.005、またはこれより小さいレートをおすすめします。

値は 0 以上である必要があります。 デフォルトは 0 です。

Double; Field

容量

(オプション)

ソースに対する移動者のコスト キャパシティー。

指定した許容値に達するまで、各ソースのコスト計算が続行されます。

0 より大きい値を指定する必要があります。 デフォルトの許容値は出力ラスターのエッジまでです。

Double; Field

移動方向

(オプション)

水平方向ファクター、鉛直方向ファクター、およびソース耐性率を適用する際の、移動者の方向を指定します。

String オプションを選択した場合、始点または終点オプションを選択できます。これは、すべてのソースに適用されます。

フィールド オプションを選択した場合、ソース データから、各ソースに使用する方向を決定するフィールドを選択できます。 フィールドには、テキスト文字列 FROM_SOURCE または TO_SOURCE が含まれている必要があります。

  • ソースから移動—水平方向ファクター、鉛直方向ファクター、およびソース耐性率は、入力ソースを起点としてソース以外のセルに移動する場合に適用されます。 これがデフォルトです。

  • ソースへ移動—水平方向ファクター、鉛直方向ファクター、およびソース耐性率は、ソース以外の各セルを起点として入力ソースへ戻る場合に適用されます。

String; Field

戻り値

ラベル 説明 データ タイプ

出力距離ラスター

出力パス距離ラスター。

出力パス距離ラスターは、サーフェス距離、水平サーフェス係数、鉛直サーフェス係数を考慮に入れて、コスト サーフェス上の特定されたソース位置までの最小累積コスト距離をセルごとに特定します。

ソースは、セル、セル セット、または 1 つ以上のフィーチャ位置です。

出力ラスターのタイプは浮動小数点数です。

Raster

環境

自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, 並行処理ファクター, ピラミッド, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ

ライセンス情報

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