トップへ戻る

エリア内での集計 (Summarize Within) (標準フィーチャ解析)

このトピックの内容

  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報

サマリー

別のレイヤーのポリゴンの境界線内にあるポイント、ライン、またはポリゴン フィーチャ (またはフィーチャの一部) を検索します。

このツールの使用シナリオには次のようなものがあります。

  • 集水域境界線のレイヤーと、土地利用タイプ別土地利用境界線のレイヤーを基にして、各集水域の土地利用タイプの総面積を計算する。
  • 郡の土地区画のレイヤーと市の境界線のレイヤーを基にして、それぞれの市の境界線内にある空き地の平均値を求める。
  • 郡のレイヤーと道路のレイヤーを基にして、各郡内の道路タイプ別に道路の距離を集計する。

図

エリア内での集計ツールの図

使用法

  • このツールは、2 つのレイヤーを受け取ってそれらを積み重ねる処理であると考えることができます。 たとえば、レイヤーの 1 つ、入力ポリゴン レイヤー内のフィーチャがすべて赤色であるとします。 別のレイヤー、入力集計フィーチャは、ポイント、ライン、またはポリゴンのいずれのフィーチャ タイプも指定できます。 これらのレイヤーを積み重ねてから、そのスタックを見下ろして、境界線が赤色のポリゴン (入力ポリゴン) 内にある入力サマリー フィーチャ レイヤー内のフィーチャ数をカウントします。 フィーチャの数をカウントできるだけでなく、入力集計フィーチャ レイヤー内のフィーチャの属性に関する合計、平均、最小、最大などの単純な統計情報を計算できます。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力ポリゴン

これらのポリゴンの境界線内にある、[入力サマリー フィーチャ] パラメーター値からの、フィーチャまたはフィーチャの一部が集計されます。

Feature Set
入力サマリー フィーチャ

入力ポリゴンごとに集計される、ポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。

Feature Set
出力名

ポータルに作成される出力レイヤーの名前。

String
シェープ属性のサマリー値を追加
(オプション)

各入力ポリゴン内の入力サマリー フィーチャのラインの長さやポリゴンの面積など、[入力サマリー フィーチャ] パラメーター値のシェープに基づいて統計情報を計算するかどうかを指定します。

  • オン - シェープ サマリー属性に基づいて統計が計算されます。 これがデフォルトです。
  • オフ - シェープ サマリー属性に基づいて統計が計算されません。

Boolean
シェープ単位
(オプション)

シェープ サマリーに使用される単位を指定します。

入力サマリー フィーチャがポリゴンの場合、有効なオプションはエーカー、ヘクタール、平方メートル、平方キロメートル、平方フィート、平方ヤード、および平方マイルです。

入力サマリー フィーチャがラインの場合、有効なオプションはマイル、フィート、キロメートル、メートル、およびヤードです。

  • マイル—単位はマイルです。
  • フィート—単位はフィートです。
  • キロメートル—単位はキロメートルです。
  • メートル—単位はメートルです。
  • ヤード—単位はヤードです。
  • エーカー—単位はエーカーです。
  • ヘクタール—単位はヘクタールです。
  • 平方メートル—単位は平方メートルです。
  • 平方キロメートル—単位は平方キロメートルです。
  • 平方フィート—単位は平方フィートです。
  • 平方ヤード—単位は平方ヤードです。
  • 平方マイル—単位は平方マイルです。
String
サマリー フィールド
(オプション)

各ポリゴン内のすべてのポイントについて計算されるフィールド名と統計サマリー タイプのリスト。 各ポリゴン内のポイント数が常に返されます。

サポートされている統計情報タイプとしては、次のものがあります。

  • [合計] - 合計値が計算されます。
  • [最小] - 最小値が特定されます。
  • [最大] - 最大値が特定されます。
  • [平均] - 平均値が計算されます。
  • [標準偏差] - 標準偏差が計算されます。

Value Table
フィールドでグループ化
(オプション)

一意の属性値ごとに統計を個別に計算するために使用される入力サマリー フィーチャのフィールド。 たとえば、[入力サマリー フィーチャ] パラメーター値には、危険物を保管している会社の位置ポイントが含まれ、HazardClass フィールドには、保管されている危険物のタイプを記述したコードが含まれているとします。 HazardClass フィールドの一意の値のそれぞれについてサマリーを計算するには、そのフィールドをグループ化フィールドとして使用します。

Field
最少頻値属性および最頻値属性の追加
(オプション)

最少頻値フィールドと最頻値フィールドを出力に追加するかどうかを指定します。

このパラメーターは、[フィールドでグループ化] パラメーターが使用されている場合にのみ適用されます。

  • オフ - 最少頻値フィールドと最頻値フィールドが出力に追加されません。 これがデフォルトです。
  • オン - 各境界内のグループ フィールドごとに最少頻値 (個数が最も少ない値) または最頻値 (個数が最も多い値) 属性の値が計算され、Minority_ と Majority_ の接頭辞を持つ 2 つの新しいフィールドが出力に追加されます。

Boolean
グループの割合を追加
(オプション)

グループの割合フィールドを出力に追加するかどうかを指定します。

このパラメーターは、[フィールドでグループ化] パラメーターが使用されている場合にのみ適用されます。

  • オフ - 割合フィールドは出力に追加されません。 これがデフォルトです。
  • オン - 各入力ポリゴンについて、一意の各グループ値の割合が計算され、割合フィールドが出力に追加されます。

Boolean

派生した出力

ラベル説明データ タイプ
出力フィーチャ サービス

出力サマリー済みレイヤー。

Feature Set
出力グループ テーブル

フィールドでグループ化が指定されると、ツールは、一意のグループごとに計算された統計を含むテーブルを出力します。

Record Set

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
名前説明データ タイプ
sumWithinLayer

これらのポリゴンの境界線内にある、summaryLayer パラメーター値からの、フィーチャまたはフィーチャの一部が集計されます。

Feature Set
summaryLayer

入力ポリゴンごとに集計される、ポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。

Feature Set
outputName

ポータルに作成される出力レイヤーの名前。

String
sumShape
(オプション)

各入力ポリゴン内の入力サマリー フィーチャのラインの長さやポリゴンの面積など、summaryLayer パラメーター値のシェープに基づいて統計を計算するかどうかを指定します。

  • ADD_SHAPE_SUM—シェープ サマリー属性に基づいて統計が計算されます。 これがデフォルトです。
  • NO_SHAPE_SUM—シェープ サマリー属性に基づいて統計が計算されません。
Boolean
shapeUnits
(オプション)

シェープ サマリーに使用される単位を指定します。

入力サマリー フィーチャがポリゴンの場合、有効なオプションはエーカー、ヘクタール、平方メートル、平方キロメートル、平方フィート、平方ヤード、および平方マイルです。

入力サマリー フィーチャがラインの場合、有効なオプションはマイル、フィート、キロメートル、メートル、およびヤードです。

  • MILES—単位はマイルです。
  • FEET—単位はフィートです。
  • KILOMETERS—単位はキロメートルです。
  • METERS—単位はメートルです。
  • YARDS—単位はヤードです。
  • ACRES—単位はエーカーです。
  • HECTARES—単位はヘクタールです。
  • SQUAREMETERS—単位は平方メートルです。
  • SQUAREKILOMETERS—単位は平方キロメートルです。
  • SQUAREFEET—単位は平方フィートです。
  • SQUAREYARDS—単位は平方ヤードです。
  • SQUAREMILES—単位は平方マイルです。
String
summaryFields
[[Field, Statistic],...]
(オプション)

各ポリゴン内のすべてのポイントについて計算されるフィールド名と統計サマリー タイプのリスト。 各ポリゴン内のポイント数が常に返されます。

サポートされている統計タイプとしては、次のものがあります。

  • SUM - 合計値が計算されます。
  • MIN - 最小値が特定されます。
  • MAX - 最大値が特定されます。
  • MEAN - 平均値が計算されます。
  • STD - 標準偏差が計算されます。

Value Table
groupByField
(オプション)

一意の属性値ごとに統計を個別に計算するために使用される入力サマリー フィーチャのフィールド。 たとえば、summaryLayer パラメーター値には、危険物を保管している会社の位置ポイントが含まれ、HazardClass フィールドには、保管されている危険物のタイプを記述したコードが含まれているとします。 HazardClass フィールドの一意の値のそれぞれについてサマリーを計算するには、そのフィールドをグループ化フィールドとして使用します。

Field
minorityMajority
(オプション)

最少頻値フィールドと最頻値フィールドを出力に追加するかどうかを指定します。

このパラメーターは、groupByField パラメーターが使用されている場合にのみ適用されます。

  • NO_MIN_MAJ—最少頻値フィールドと最頻値フィールドが出力に追加されません。 これがデフォルトです。
  • ADD_MIN_MAJ—各境界内のグループ フィールドごとに最少頻値 (個数が最も少ない値) または最頻値 (個数が最も多い値) 属性の値が計算され、Minority_ と Majority_ の接頭辞を持つ 2 つの新しいフィールドが出力に追加されます。
Boolean
percentShape
(オプション)

グループの割合フィールドを出力に追加するかどうかを指定します。

このパラメーターは、groupByField パラメーターが使用されている場合にのみ適用されます。

  • NO_PERCENT—割合フィールドは出力に追加されません。 これがデフォルトです。
  • ADD_PERCENT—各入力ポリゴンについて、一意の各グループ値の割合が計算され、割合フィールドが出力に追加されます。
Boolean

派生した出力

名前説明データ タイプ
outputLayer

出力サマリー済みレイヤー。

Feature Set
groupBySummaryLayer

フィールドでグループ化が指定されると、ツールは、一意のグループごとに計算された統計を含むテーブルを出力します。

Record Set

環境

範囲

ライセンス情報

  • Basic: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定
  • Standard: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定
  • Advanced: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定

関連トピック

  • データの集約ツールセットの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報