距離累積

距離累積ツールは各セルから入力ソースまでの累積距離を計算します。

注意:

このツールを実行するには、ラスター解析用にポータルを構成する必要があります。

このツールが Map Viewer に表示されない場合は、ポータル管理者に問い合わせてください。 お使いのポータルがラスター解析用に構成されていないか、ユーザーに、このツールを実行するのに必要な権限がないことが考えられます。

ワークフロー図

例

適用例として、次のような質問に答えることが挙げられます。

• 最も近い都市までの距離。
• 最も近い道路までのコスト距離。
• 最も近い水源までのバリア周辺の距離。

使用上の注意

入力ソース データがラスターの場合、一連のソース セルは、ソース ラスター内にある有効な値を持つすべてのセルから構成されます。 値が NoData のセルは、ソース セットには含まれません。 値 0 (ゼロ) は、正当なソースと見なされます。

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

この状況を回避するには、中間的な手順として、[フィーチャをラスターに変換 (Convert Feature To Raster)] ツールを使用して入力フィーチャを直接ラスター化し、[フィールド] パラメーターを設定します。 次に、結果の出力を [距離] ツールの入力として使用します。

コスト ラスター、サーフェス ラスター、垂直方向ラスター、または水平方向ラスターの入力のいずれかに NoData がある場合、入力全体でそれらの位置にあるセルは計算で無視されます。 これらのラスターの NoData は、計算の間保持されるため、出力全体で NoData になります。

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

このアルゴリズムは乗算処理なので、コスト ラスターに値ゼロを含めることができません。 コスト ラスターに値ゼロが含まれており、それらの値が最小コストを表している場合は、まずそれらのセルを小さい正の値 (0.01 など) に変更します。その後でこのツールを実行してください。

[範囲] の環境設定が指定されていない場合、処理範囲は次の方法で決定されます。

ソースとバリア データだけが指定されている場合、各側で 2 つのセルの幅で拡張された入力データのすべての領域が処理範囲として使用されます。 出力ラスターが 2 行および 2 列で拡張される理由は、出力を [最適パス (ラスター) (Optimal Path As Raster)] と [最適パス (ライン) (Optimal Path As Line)] で使用するためです。生成されたパスはバリアを回避できます。 範囲を暗黙のバリアとして使用するには、環境設定で [範囲] を明示的に設定する必要があります。

サーフェス ラスター、コスト ラスター、垂直方向ラスター、または水平方向ラスターのラスター データセットのいずれかが指定されていない場合、処理範囲はこれらのラスターの交差部分になります。

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

[傾斜方向の取得] ツールの出力は、[入力水平方向ラスター] 設定の入力として使用できます。

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

ソースの特性、またはソースに対する移動者は、特定のパラメーターで制御できます。

• [初期累積] は、移動開始前の初期コストを設定します。
• [最大累積] は、ソースが上限に達する前に累積できるコストの量を指定します。
• [コストに適用する乗数] は、移動のモードまたはソースの強度を指定します。
• [移動方向] は、移動者がソースを起点としてソース以外の場所に移動するか、ソース以外の場所を起点としてソースへ戻るかを識別します。

[初期累積] が指定された場合、出力コスト距離サーフェス上のソース位置が [初期累積] の値に設定されます。そうでない場合は、出力コスト距離サーフェス上のソース位置はゼロに設定されます。

次の表に、このツールのパラメーターを示します。

パラメーター	説明
ソース ラスターまたはフィーチャの選択	距離を計算するソースを特定するラスターまたはフィーチャ レイヤー。 入力がラスターである場合、ラスターはソースに有効値 (0 は有効値) が含まれているセルで構成される必要があります。また、残りのセルには NoData が割り当てられていなければなりません。 入力がフィーチャ レイヤーである場合は、ポイント、ライン、ポリゴンを使用できます。
バリア ラスターまたはバリア フィーチャの選択 (オプション)	バリアを定義するデータセット。 ラスターの場合、入力タイプは整数か浮動小数です。 値 (0 を含む) を持つセルであれば、バリアとして処理されます。 NoData のセルはバリアとして処理されません。 フィーチャの場合、入力はポイント、ライン、ポリゴンです。
サーフェス ラスターの選択 (オプション)	距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。 この値は、セル間を通過するときにたどる実際のサーフェス距離を計算するときに使用されます。
コスト ラスターの選択 (オプション)	各セル内を平面的に通過するときにかかるインピーダンスまたはコストを定義するラスター。 各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。 セル内を通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動についても補正します。 コスト ラスターとして、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません (負またはゼロのコストは指定できません)。
垂直方向ラスターの選択 (オプション)	各セル位置の Z 値を定義するラスター。 この値は、あるセルから別のセルに移動するときに生じる垂直方向ファクターを特定する傾斜角を計算するために使用されます。
垂直方向ファクター (オプション)	[垂直方向ファクター] は、垂直コスト ファクター (VF) と垂直相対移動角度 (VRMA) の間の関係を定義します。 [垂直方向ラスターの選択 (オプション)] を指定している場合のみこのオプションを利用できます。 定義された垂直方向ファクター グラフを特定する修飾子付きのファクターがいくつかあって選択できます。 グラフは、隣接セルに移動する総コストを計算するときに使用する垂直方向ファクターを特定するために使用されます。 以下の説明では、VF はあるセルから次のセルに移動するときに生じる垂直移動の困難度を定義します。VRMA 修飾子は [ソースから] セルと [ソースへ] セルの間の傾斜角度を示します。 [バイナリ] - VRMA が最小カット アングルより大きく最大カット アングルより小さい場合、VF はゼロ ファクターに関連付けられた値に設定され、そうでない場合、VF は無限大に設定されます。 [リニア] - VF は VRMA の一次関数です。 [逆リニア] - VF は VRMA の一次逆関数です。 [相対リニア] - VF が VRMA の負の側または正の側で VRMA の一次関数であり、この 2 つの一次関数が VF (Y) 軸に対して対称的です。 [相対逆リニア] - 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 のコサインベースの関数です。 垂直方向ファクター パラメーターの修飾子は次のとおりです。 [ゼロ ファクター] - VRMA がゼロのときに使用する垂直方向ファクター。 このファクターは、指定された関数の Y 軸切片の位置を決めます。 定義上、ゼロ ファクターは垂直三角関数 (Cos、Sec、Cos-Sec、Sec-Cos) には適用されません。 Y 軸切片はこれらの関数によって定義されます。 [最小カット アングル] - VRMA 角度がこの角度を下回ると VF は無限大に設定されます。 [最大カット アングル] - VRMA 角度がこの角度を上回ると VF は無限大に設定されます。 [傾斜角] - [リニア] および [逆リニア] パラメーターで使用される直線の傾斜角。 傾斜角は、水平方向の長さを分母、垂直方向の長さを分子として指定されます (たとえば、45% の傾斜角は 1/45 であり、0.02222 として入力されます)。
水平方向ラスターの選択 (オプション)	各セルの水平方向を定義するラスター。 ラスター上の値は 0 〜 360 の範囲の整数でなくてはいけません。0 度は北または画面の上方向を示し、値は時計回りに増加します。 平らなエリアには -1 という値を指定します。 各位置の値は [水平方向ファクター] と組み合わせて、あるセルから隣接セルに移動するときに発生する水平コストを決定するときに使用されます。
水平方向ファクター (オプション)	[水平方向ファクター] は、水平コスト ファクターと水平相対移動角度の間の関係を定義します。 [水平方向ラスターの選択 (オプション)] を指定している場合のみこのオプションを利用できます。 定義された水平方向ファクター グラフを特定する修飾子付きのファクターがいくつかあって選択できます。 グラフは、隣接セルに移動する総コストを計算するときに使用する水平方向ファクターを特定するために使用されます。 以下の説明では、水平方向ファクター (HF) はあるセルから次のセルに移動するときに生じる水平移動の難易度を定義し、水平相対移動角度 (HRMA) はセルからの水平方向と移動方向がなす角度を示します。 これらの HF の定義とパラメーターは次のとおりです。 [バイナリ] - HRMA がカット アングルより小さい場合、HF はゼロ ファクターに関連付けられた値に設定され、そうでない場合、HF は無限大に設定されます。 [前方] - 前進運動だけが許されます。 HRMA は 0 以上 90 未満 (0 <= HRMA < 90) である必要があります。 HRMA が 0 度より大きく 45 度未満である場合、セルの HF はゼロ ファクターに関連付けられている値に設定されます。 HRMA が 45 度以上である場合、サイド値修飾子の値が使用されます。 HRMA が 90 度以上であると、その HF は無限大に設定されます。 [リニア] - HF は HRMA の一次関数です。 [逆リニア] - HF は HRMA の一次逆関数です。 水平方向ファクター キーワードの修飾子は次のとおりです。 [ゼロ ファクター] - HRMA が 0 のときに使用する水平方向ファクター。 このファクターは、任意の水平方向ファクター関数の Y 軸切片の位置を決めます。 [カット アングル] - HRMA 角度がこの角度を超えると HF は無限大に設定されます。 [傾斜角] - [リニア] および [逆リニア] 水平方向ファクター キーワードで使用される直線の傾斜角。 傾斜角は、水平方向の長さを分母、垂直方向の長さを分子として指定されます (たとえば、45% の傾斜角は 1/45 であり、0.02222 として入力されます)。 [サイド値] - [前方] 水平方向ファクター キーワードが指定され、HRMA が 45 度以上、90 度未満のときの HF 値を指定します。
初期累積 (オプション)	コスト計算を開始する際の初期累積コストです。 ソースに関連付けられた固定コストを指定できます。 コスト アルゴリズムは、コスト 0 から開始する代わりに、[初期累積] で設定された値から開始します。 値は 0 以上である必要があります。 デフォルトは 0 です。
最大累積 (オプション)	ソースに対する移動者の最大累積。 指定した累積に達するまで、各ソースのコスト計算が続行されます。 0 より大きい値を指定する必要があります。 デフォルトの累積は出力ラスターのエッジまでです。
コストの乗数 (オプション)	コスト値に適用する乗数です。 これを使用すると、移動のモードまたはソースの強度を制御できます。 乗数が大きいほど、各セルの移動コストが大きくなります。 0 より大きい値を指定する必要があります。 デフォルトは 1 です。
移動方向 (オプション)	水平方向ファクターと垂直方向ファクターを適用する際の、移動者の方向を指定します。 [ソースから] - 水平方向ファクターと垂直方向ファクターは、入力ソースを起点としてソース以外のセルに移動する場合に適用されます。 これがデフォルトです。 [ソースへ] - 水平方向ファクターと垂直方向ファクターは、ソース以外の各セルを起点として入力ソースへ戻る場合に適用されます。 [ソースから] または [ソースへ] キーワードを選択します。これは、すべてのソースに適用されます。または、ソース データで、各ソースの移動方向を識別するキーワードを含むフィールドを指定します。 このフィールドには、「FROM_SOURCE」または「TO_SOURCE」という文字列を含める必要があります。
距離の方法 (オプション)	距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。 [平面] - 距離計算は、2 次元直交座標系を使用して投影された平面で実行されます。 これはデフォルトの方法です。 [測地線] - 距離は楕円形に基づいて計算されます。 したがって、入力または出力投影に関係なく、結果は変わりません。
結果の距離累積ラスターの名前	距離累積ラスターには、各セルと最小コスト ソースの累積距離が含まれています。 出力ラスターのタイプは float です。 [マイ コンテンツ] に作成され、マップに追加されるレイヤーの名前。 デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。 レイヤーがすでに存在する場合は、別の名前を指定するよう求められます。 [出力の保存場所] ドロップダウン ボックスを使用して、結果を保存する [マイ コンテンツ] 内のフォルダーの名前を指定できます。
結果のバック方向ラスターの名前 (オプション)	逆方向ラスターは、角度で計算した方向を含みます。 バリアを避けながら、最寄りのソースに戻る最短パスに沿った隣接セルへの方向を度単位で特定します。 値の範囲は 0 度から 360 度で、0 はソース セル用に予約されています。 真東 (右) は 90 で、値は時計回りに増加します (180 が北、270 が西、360 が北)。 出力ラスターのタイプは float です。 [マイ コンテンツ] に作成され、マップに追加されるレイヤーの名前。 デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。 レイヤーがすでに存在する場合は、別の名前を指定するよう求められます。 [出力の保存場所] ドロップダウン ボックスを使用して、結果を保存する [マイ コンテンツ] 内のフォルダーの名前を指定できます。
結果のソース方向ラスターの名前 (オプション)	ソース方向ラスターは、最小累積コスト ソース セルの方向を水平角 (度単位) で識別します。 値の範囲は 0 度から 360 度で、0 はソース セル用に予約されています。 真東 (右) は 90 で、値は時計回りに増加します (180 が北、270 が西、360 が北)。 出力ラスターのタイプは float です。 [マイ コンテンツ] に作成され、マップに追加されるレイヤーの名前。 デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。 レイヤーがすでに存在する場合は、別の名前を指定するよう求められます。 [出力の保存場所] ドロップダウン ボックスを使用して、結果を保存する [マイ コンテンツ] 内のフォルダーの名前を指定できます。
結果のソース位置ラスターの名前 (オプション)	ソース位置ラスターは、マルチバンド出力です。 最初のバンドには行インデックス、2 つ目のバンドには列インデックスが含まれています。 これらのインデックスは、最小累積コスト距離にあるソース セルの位置を識別します。 [マイ コンテンツ] に作成され、マップに追加されるレイヤーの名前。 デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。 レイヤーがすでに存在する場合は、別の名前を指定するよう求められます。 [出力の保存場所] ドロップダウン ボックスを使用して、結果を保存する [マイ コンテンツ] 内のフォルダーの名前を指定できます。

環境

解析環境設定は、ツールの結果に影響する追加パラメーターです。 このツールの解析環境設定にアクセスするには、ツール パネルの上部にある歯車 アイコンをクリックします。

このツールでは次の [解析環境] が適用されます。

• 出力座標系 - 出力レイヤーの座標系を指定します。
• 範囲 - 解析に使用するエリアを指定します。
• スナップ対象ラスター - 指定したスナップ対象ラスター レイヤーのセルの配置に一致するように、出力の範囲を調整します。
• セル サイズ - 出力レイヤーで使用するセル サイズ。
• マスク - マスク レイヤーを指定します。このレイヤーでは、マスク エリアの範囲内にあるセルのみが解析に使用されます。

類似のツールとラスター関数

距離累積ツールは各セルから入力ソースまでの累積距離を計算します。 その他のツールは、類似した問題を解決するのに効果的です。

Map Viewer 解析ツールとラスター関数

距離アロケーション イメージ サービス出力が必要な場合は、距離アロケーション ツールか距離アロケーション ラスター関数を使用します。

距離累積はラスター関数として使用することもできます。

ArcGIS Pro 解析ツールとラスター関数

[距離累積 (Distance Accumulation)] と [距離アロケーション (Distance Allocation)] の各ジオプロセシング ツールは Spatial Analyst ツールボックスで利用できます。

[距離累積 (Distance Accumulation)] と [距離アロケーション (Distance Allocation)] の各ジオプロセシング ツールは Raster Analysis ツールボックスで利用できます。

距離累積と距離アロケーション はラスター関数として使用することもできます。

ArcGIS Enterprise 開発者向けリソース

ArcGIS REST API で作業を行っている場合は、Distance Accumulation タスクと Distance Allocation タスクを使用します。

ArcGIS API for Python で作業を行っている場合は、arcgis.raster.functions.gbl モジュールの Distance Accumulation と Distance Allocation を使用します。