Skip to main content

距離アロケーション (Spatial Analyst ツール)

サマリー

直線距離、コスト距離、実際のサーフェス距離、鉛直および水平方向のコスト係数に基づいて、各セルから指定したソースまでの距離アロケーションを計算します。

距離累積ツールの詳細

使用法

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

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

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

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

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

  • バリア は回避する必要のある障害物です。 バリアは、次の 2 通りの方法で定義できます。

    入力ラスターまたはフィーチャ バリア パラメーターの場合は、有効な値を含むセルでバリアを表すか、ラスターに変換されたフィーチャ データでバリアを表すことができます。 バリアが対角線セルでのみ接続されている位置では、これらのバリアが厚化されて不透過になります。

    また、バリアは、 入力コスト ラスター、 入力サーフェス ラスター、 入力鉛直方向ラスター、および 入力水平方向ラスター 内で NoData セルが存在する位置でも定義されます。 NoData が対角線セルでのみ接続されている位置では、他の NoData セルと組み合わされて厚化されるため、不透過なバリアになります。

  • 入力サーフェス ラスター の値に VCS (鉛直座標系) がある場合、そのサーフェス ラスターの値は VCS の単位になっていると見なされます。 入力サーフェス ラスター の値に VCS がなく、データが投影されている場合、そのサーフェスの値は空間参照の距離単位になっていると見なされます。 入力サーフェス ラスター の値に VCS がなく、データが投影されていない場合、そのサーフェスの値はメートル単位になっていると見なされます。 距離累積の最終結果は、距離単位ごとのコストで表されるか、コストが導入されていない場合は距離単位で表されます。

  • 負またはゼロのコスト ラスターの値は無効ですが、小さな正の値として扱われます。 累積コスト アルゴリズムは乗法的プロセスであり、コストの値が負またはゼロの場合、累積コストを正しく計算できません。

    コスト ラスターにこのような値が含まれており、それらの位置が解析から除外すべきエリアを表している場合、それらのセルを NoData に変換してからこのツールを実行してください。 これは Set Null ツールを使用して実行できます。

    この解析で NoData 値はバリアとして扱われるため、入力内で NoData である位置は結果でも NoData になります。

  • ソースが対応する入力ラスターで NoData にあたる場合、解析では無視されるため、そのソースからの距離は計算されません。

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

    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     ~      ~      ~      ~

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

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

    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 つのセルの幅で拡張された入力データのすべての領域が処理範囲として使用されます。 出力ラスターが 2 行および 2 列で拡張される理由は、出力を 最適パス (ライン) ツールと 最適パス (ラスター) ツールで使用するためです。生成されたパスはバリアを回避できます。 範囲を暗黙的なバリアとして使用するには、環境設定で範囲の値を明示的に設定する必要があります。

    入力サーフェス ラスター、 入力コスト ラスター、 入力鉛直方向ラスター、または 入力水平方向ラスター パラメーター値が指定されている場合、処理範囲はこれらのラスターの交差部分になります。

  • マスク解析環境は、フィーチャクラスまたはラスター データセットに設定することができます。 マスクがフィーチャの場合は、ラスターに変換されます。 値を含むセルは、マスク エリア内にある位置を定義します。 NoData セルは、マスク エリア外にある位置を定義し、バリアと見なされます。

  • セル サイズまたはスナップ対象ラスター環境設定が指定されていない場合で、入力として指定されたラスターが複数存在する場合、次の優先順位に基づいて、セルサイズおよびスナップ対象ラスターの環境が設定されます: 入力コスト ラスター、 入力サーフェス ラスター、 入力鉛直方向ラスター、 入力水平方向ラスター、 入力ラスターまたはフィーチャ ソース、 入力ラスターまたはフィーチャ バリア。

  • このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサーや、複数のコアを持つプロセッサーが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。 この機能と設定方法の詳細については、「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

入力ラスターまたはフィーチャ バリア

(オプション)

バリアを定義するデータセット。

バリアは、整数または浮動小数点ラスター、またはポイント、ライン、ポリゴン フィーチャのいずれかによって定義できます。

ラスター バリアの場合、バリアは有効な値 (ゼロを含む) を持つ必要があり、バリア以外のエリアは NoData である必要があります。

Raster Layer; Feature Layer

入力サーフェス ラスター

(オプション)

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

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

Raster Layer

入力コスト ラスター

(オプション)

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

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

コスト ラスターとして、整数値または浮動小数点値を使用できます。 負またはゼロのコスト ラスターの値は無効ですが、小さな正のコスト値として扱われます。

Raster Layer

入力鉛直方向ラスター

(オプション)

各セル位置の 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

入力水平方向ラスター

(オプション)

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

ラスター上の値は 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

出力距離累積ラスター

(オプション)

出力距離ラスター。

距離累積ラスターには、各セルと最小コスト ソースの累積距離が含まれています。

Raster Dataset

出力バック方向ラスター

(オプション)

バック方向ラスターは、角度で計算した方向を含みます。 バリアを避けながら、最寄りのソースに戻る最短パスに沿った隣接セルへの方向を度単位で特定します。

値の範囲は 0 度から 360 度で、0 はソース セル用に予約されています。 真東は 90 で、値は時計回りに増加します (180 が北、270 が西、360 が北)。

出力ラスターのタイプは float です。

Raster Dataset

出力ソース方向ラスター

(オプション)

ソース方向ラスターは、最小累積コスト ソース セルの方向を水平角 (度単位) で識別します。

値の範囲は 0 度から 360 度で、0 はソース セル用に予約されています。 真東は 90 で、値は時計回りに増加します (180 が北、270 が西、360 が北)。

出力ラスターのタイプは float です。

Raster Dataset

出力ソース位置ラスター

(オプション)

ソース位置ラスターは、マルチバンド出力です。 最初のバンドには行インデックス、2 つ目のバンドには列インデックスが含まれています。 これらのインデックスは、最小累積コスト距離にあるソース セルの位置を識別します。

Raster Dataset

ソース フィールド

(オプション)

ソース位置に値を割り当てるために使用するフィールド。 整数タイプでなければなりません。

Field

初期累積

(オプション)

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

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

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

Double; Field

最大累積

(オプション)

ソースに対する移動者の最大累積。

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

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

Double; Field

コストに適用する乗数

(オプション)

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

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

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

Double; Field

移動方向

(オプション)

水平方向ファクターと鉛直方向ファクターを適用する際の、移動者の方向を指定します。

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

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

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

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

String; Field

距離計算の方法

(オプション)

距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。

  • 平面—距離計算は、2 次元直交座標系を使用して投影された平面で実行されます。 これがデフォルトです。

  • 測地線—距離は楕円形に基づいて計算されます。 入力または出力投影法に関係なく、結果は変わりません。

String

戻り値

ラベル 説明 データ タイプ

出力距離アロケーション ラスター

出力距離アロケーション ラスター。

Raster

環境

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

ライセンス情報

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