ラベル | 説明 | データ タイプ |
集計レイヤー |
ポリゴンまたはビンごとに集計するポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。 | Feature Layer |
出力フィーチャクラス | 交差するジオメトリおよび属性を含む出力フィーチャクラスの名前。 | Feature Class |
ポリゴンまたはビン | [集計レイヤー] 値をポリゴン別またはビン別のいずれで集計するかを指定します。
| String |
ビン タイプ | フィーチャを集約するために生成するビンの形状を指定します。
| String |
ビン サイズ (オプション) | 入力フィーチャを集約するビンのサイズと単位を表す距離間隔。 | Linear Unit |
サマリー ポリゴン (オプション) | 入力集計レイヤー内のフィーチャの集計に使用するポリゴン。 | Feature Layer |
シェープ属性の集計値を追加 | サマリー レイヤー (ポリゴンまたはビン) 内にあるラインの長さ、またはポリゴンの面積を計算するかどうかを指定します。 サマリー シェープと交差するポイント、ライン、およびポリゴンの数は常に含まれます。
| Boolean |
形状の単位 (オプション) | シェープ属性のサマリーで使用する計測単位を指定します。 入力サマリー フィーチャがポイントである場合、各入力ポリゴン内のポイント数が加算されるだけなので、形状の単位は不要です。 入力サマリー フィーチャがラインである場合は、距離単位を指定します。 入力サマリー フィーチャがポリゴンである場合は、面積単位を指定します。
| String |
標準サマリー フィールド (オプション) | 指定されたフィールドに関して計算される統計情報。 フィールドが個数を表すか、レートを表すかを指定します。
| Value Table |
加重サマリー フィールド (オプション) | 指定されたフィールドに関して計算される加重統計を指定します。 フィールドが個数を表すか、レートを表すかを指定します。
| Value Table |
フィールドでグループ化 (オプション) | 一意の属性値ごとに統計を個別に計算するために使用する入力サマリー フィーチャのフィールド。 たとえば、入力サマリー フィーチャに危険物を保管している会社の位置ポイントを含み、フィールドの 1 つが、保管されている危険物のタイプを記述したコードを含む HazardClass であるとします。 HazardClass の一意の値のそれぞれについて集計を計算するには、そのフィールドをグループ化フィールドとして使用します。 | Field |
最少頻値および最頻値属性の追加 (オプション) | 各境界内のグループ フィールドごとに最少頻値 (最も支配的でない) 属性値または最頻値 (最も支配的) 属性値が追加されるかどうかを指定します。 このパラメーターがオンの場合は、Majority_ と Minority_ の接頭辞を持つ 2 つの新しいフィールドが出力レイヤーに追加されます。 このパラメーターは、[フィールドでグループ化] パラメーターに値が指定された場合のみ適用されます。
| Boolean |
グループの割合の追加 (オプション) | 割合フィールドを追加するかどうかを指定します。 このパラメーターをオンにすると、各入力ポリゴンについて、一意の各グループ値のパーセンテージが計算されます。 このパラメーターは、[フィールドでグループ化] パラメーターに値が入力され、[最少頻値属性および最頻値属性の追加] パラメーターに値が指定されている場合のみ適用されます。
| Boolean |
サマリー テーブルでグループ化 (オプション) | 集計別にグループを格納する出力テーブル。 | Table |
サマリー
ポリゴン レイヤーを別のレイヤーに重ねて、各ポリゴン内のポイント数、ラインの長さ、またはポリゴンの面積を集計し、各ポリゴン内のフィーチャの属性フィールドの統計を計算します。
次に、[エリア内での集計 (Summarize Within)] を使用するシナリオの例を示します。
- 集水域境界線と、土地利用タイプ別土地利用境界線を基にして、各集水域の土地利用タイプの総面積を計算する。
- 郡の土地区画と市の境界線を基にして、それぞれの市の境界線内にある空き地の平均値を求める。
- 郡と道路を基にして、各郡内の道路タイプ別に道路の距離を集計する。
図
使用法
基本的には、[エリア内での集計 (Summarize Within)] ツールの処理は、2 つのレイヤー、入力ポリゴン、および入力サマリー フィーチャを受け取って、それらを積み重ねることです。 そのスタックを見下ろして、入力ポリゴン内にある入力サマリー フィーチャの数をカウントすることができます。 合計、平均、最小、最大など、入力サマリー フィーチャの属性についてのシンプルな統計を計算することもできます。
[エリア内での集計 (Summarize Within)] を使用して、標準の統計と地理空間的に加重した統計を計算できます。 標準の統計は、加重なしで統計値を集計したものです。 加重統計では、ポリゴン内のラインの属性、またはポリゴン内のポリゴンの属性を地理空間的に加重した値を使用して、値を計算します。 加重統計は、ポリゴン内のポイントには適用されません。
個数またはレートのいずれかを表す属性に対して、標準の統計と地理空間的に加重した統計を計算できます。 これは次のように定義されます。
- 個数 - ポイント位置、ライン沿い、またはポリゴン内にあるエンティティの合計または数量を表す属性。 個数タイプの属性には、国の人口、国勢調査区内のタクシー乗車数、河川沿いのダムの数などがあります。 ライン フィーチャとポリゴン フィーチャに対して、標準の統計または加重統計を計算する前に、個数が配分されます。
- レート - ポイント位置、ライン沿い、またはポリゴン内にある比率または指数を表す属性。 レート タイプの属性には、国の人口密度、道路の速度制限、国勢調査区内のタクシー乗車数、近傍の歩行適正スコアなどがあります。 レートは配分されません。
個数タイプの属性の場合、統計を計算する前に、ポリゴン内にあるラインの数量、または別のポリゴン内にあるポリゴンの数量に応じて、値が配分されます。 サマリー フィーチャがポイントのとき、個数タイプの属性とレート タイプの属性に対して、統計が同じ方法で計算されます。
以下の表にあるオプションを使用して、各ポリゴン内の集計対象レイヤーの長さと面積を計算できます。 オプションは、集計対象レイヤーのジオメトリに基づきます。
入力フィーチャ 説明 オプション ポイント
各ポリゴン内の集計ポイントの数
なし
ライン
各ポリゴン内の集計ラインの長さ
- 法定マイル
- 国際ヤード
- 国際フィート
- 米国測量マイル
- 米国測量ヤード
- 米国測量フィート
- キロメートル
- メートル
エリア
各ポリゴン内の集計ポリゴンの面積
- 平方法定マイル
- 平方国際ヤード
- 平方国際フィート
- 平方キロメートル
- 平方メートル
- ヘクタール
- 国際エーカー
- 平方 US Survey マイル
- 平方 US Survey ヤード
- 平方 US Survey フィート
- US Survey エーカー
ラインとエリアでは、すべての加重統計が算出されます。 標準サマリー フィールド統計情報と加重サマリー フィールド統計はどちらも、[サマリー ポリゴン] レイヤーと交差している [サマリー レイヤー] パラメーター値内のフィーチャのデータに適用されます。 加重サマリー フィールド統計に、[サマリー ポリゴン] パラメーター値のフィーチャが [サマリー対象レイヤー] パラメーター値内の各フィーチャと交差している割合に基づく重みが乗算されます。
標準統計には、8 つのオプションがあります (個数、合計、平均、最小、最大、範囲、標準偏差、および分散)。 文字列統計には、2 つのオプションがあります (個数および任意)。 加重統計には、集計対象レイヤー内の数値フィールドに対して算出される 3 つのオプションがあります (平均、標準偏差、および分散)。
文字列データの場合は、加重統計が算出されません。 [フィールド] 値および [統計] 値が指定されるたびに、行がこのツールのウィンドウに追加されるため、複数の統計を計算することができます。 集計結果を結果レイヤーのテーブルまたはポップアップに表示できます。 デフォルトでは、[サマリー ポリゴン] 値と交差しているフィーチャの個数が常に算出されます。
ビニングによる解析では、入力が投影されているか、出力座標系が投影座標系に設定されている必要があります。 データが投影座標系内になく、投影座標系を設定していない場合、解析するデータの範囲に基づいて投影法が使用されます。
[フィールドでグループ化] 値を入力して、一意の属性値ごとに統計が別々に計算されるようにできます。 [フィールドでグループ化] 値を指定すると、各フィーチャと統計を [フィールドでグループ化] 値に基づいて表示するサマリー テーブルが作成されます。
[フィールドでグループ化] 値が指定されると、[最少頻値属性および最頻値属性の追加] パラメーターと [グループの割合の追加] パラメーターを使用できます。 最少頻値と最頻値は、[フィールドでグループ化] パラメーターに含まれる最も優位性の低い値と最も優位性の高い値であり、優位性はそれぞれの値のポイント数、全長、または合計面積で決定されます。
[最少頻値属性および最頻値属性の追加] パラメーターをオンにすると、2 つのフィールドが結果レイヤーに追加されます。 これらのフィールドには、各結果フィーチャの最少頻値と最頻値である [フィールドでグループ化] パラメーターの値が表示されます。
[グループの割合の追加] パラメーターは、[最少頻値属性および最頻値属性の追加] がオンになったときのみ使用可能になります。 [グループの割合の追加] パラメーターをオンにすると、2 つのフィールドが結果レイヤーに追加され、各フィーチャの最少頻値と最頻値に属しているポイント数、全長、または合計面積のパーセンテージが表示されます。 パーセンテージのフィールドは結果テーブルにも追加され、各フィーチャの [フィールドでグループ化] パラメーターのすべての値に属しているポイント数、全長、または合計面積のパーセンテージが表示されます。
出力フィーチャ レイヤーは、常にポリゴン レイヤーです。 集計対象レイヤーと交差するポリゴンのみが返されます。 その他のポリゴンは、結果レイヤーから完全に削除されます。
出力ポリゴン フィーチャには、次のフィールドが含まれています。
フィールド名 説明 count 各ポリゴン レイヤーと交差する集計されたフィーチャの個数。
sum_length_<linearunit>、または sum_area_<areaunit>
ポリゴン内のラインの全長、または各ポリゴン内の集計ポリゴンの合計面積。 これらの値は、[シェープ属性のサマリー値を追加] をオンにしたときに、指定した単位で返されます。
statistic_<fieldname>
指定した統計ごとに、<statistic>_<fieldname> という形式の名前の属性フィールドが作成されます。 たとえば、フィールド id の最大と標準偏差は、MAX_id および SD_id です。
pstatistic_<fieldname>
指定した加重統計ごとに、p<statistic>_<fieldname> という形式の名前の属性フィールドが作成されます。 たとえば、フィールド id の加重最大値は pMAX_id です。
minority_<fieldname>
この値は、グループ化テーブルを作成し、[最少頻値属性および最頻値属性の追加] をオンにしたときに返されます。 これは、各ポリゴン内の指定したフィールドの最少頻値を表します。 たとえば、ポリゴン内に 5 つのポイントがあり、color というフィールドの値が赤、青、青、緑、緑であるとします。 color フィールドでグループを作成した場合、minority_color フィールドの値は赤になります。
majority_<fieldname>
この値は、グループ化テーブルを作成し、[最少頻値属性および最頻値属性の追加] をオンにしたときに返されます。 これは、各ポリゴン内の指定したフィールドの最頻値を表します。 たとえば、ポリゴン内に 5 つのポイントがあり、color というフィールドの値が赤、青、青、緑、緑であるとします。 color フィールドでグループを作成した場合、majority_color フィールドの値は青と緑になります。
minority_<fieldname>_percent
この値は、グループ化テーブルを作成し、[グループの割合の追加] をオンにしたときに返されます。 これは、各ポリゴン内の指定したフィールドにおける個数の割合の最少頻値を表します。 たとえば、ポリゴン内に 5 つのポイントがあり、color というフィールドの値が赤、青、青、緑、緑であるとします。 color フィールドでグループを作成した場合、minority_color_percent フィールドの値は 20 になります (1/5 として計算)。
majority_<fieldname>_percent
この値は、グループ化テーブルを作成し、[グループの割合の追加] をオンにしたときに返されます。 これは、各ポリゴン内の指定したフィールドにおける個数の割合の最頻値を表します。 たとえば、ポリゴン内に 5 つのポイントがあり、color というフィールドの値が赤、青、青、緑、緑であるとします。 color フィールドでグループを作成した場合、majority_color_percent フィールドの値は 40 になります (2/5 として計算)。
join_id
この値は、グループ化テーブルを作成したときに返されます。 これは、フィーチャをグループ化テーブルにリンクする ID です。 すべての join_id は、グループ化テーブルの 1 つまたは複数の行に対応しています。
出力グループ化テーブルには、次のフィールドが含まれています。
フィールド名 説明 join_id
これは、フィーチャをポリゴン レイヤーにリンクする ID です。 各ポリゴンには、すべてのグループ化の値を表す 1 つ以上のフィーチャがあり、それらは同じ ID を持ちます。 たとえば、ポリゴン内に 5 つのポイントがあり、color というフィールドの値が赤、青、青、緑、緑であるとします。 グループ化テーブルには、そのポリゴン (同じ結合 ID) を表す 3 つの行があり、それぞれが赤、青、緑の色に対応します。
count
結合したポリゴン内の指定したグループの数。 たとえば、選択したポリゴンで赤は 1 です。
<statistic>_<fieldname>
各グループに対して計算される指定した統計量。
p<statistic>_<fieldname>
各グループに対して計算される指定した加重統計量。
percentcount
各グループがポリゴン内の合計数に寄与するパーセンテージ。 上記の例を使用すると、赤は 1/5 = 20、青は 2/5 = 40、緑は 2/5 = 20 になります。
次の操作を 1 つ以上使用することで、[エリア内での集計 (Summarize Within)] ツールのパフォーマンスを向上させることができます。
- 対象データのみが解析されるように、範囲環境を設定します。
- 大きいビンは、小さいビンよりパフォーマンスが高くなります。 ビンを使用しており、使用すべきサイズがわからない場合は、大きいビンのプロトタイプから開始します。
- 解析が実行されているロケーションに対してローカルなデータを使用します。
ジオプロセシング ツールは、Spark を活用しています。 解析は、デスクトップ コンピューターで複数のコアを並列に使用して行われます。 解析の実行の詳細については、「GeoAnalytics Desktop ツールの考慮事項」をご参照ください。
GeoAnalytics Desktop ツールを実行する際、解析はデスクトップ コンピューターで行われます。 最適なパフォーマンスを得るために、データがデスクトップで利用できる必要があります。 ホスト フィーチャ レイヤーを使用している場合は、ArcGIS GeoAnalytics Server を使用することをお勧めします。 データがローカルではない場合は、ツールの実行時間は長くなります。 ArcGIS GeoAnalytics Server を使用して解析を実行する方法については、GeoAnalytics Tools をご参照ください。
ArcGIS AllSource の標準フィーチャ解析ツールボックスの [エリア内での集計 (Summarize Within)] ツールを使用して、同様の解析を実行することもできます。
パラメーター
arcpy.geoanalytics.SummarizeWithin(summarized_layer, out_feature_class, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {group_by_field}, {add_minority_majority}, {add_percentages}, {group_by_summary})
名前 | 説明 | データ タイプ |
summarized_layer |
ポリゴンまたはビンごとに集計するポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。 | Feature Layer |
out_feature_class | 交差するジオメトリおよび属性を含む出力フィーチャクラスの名前。 | Feature Class |
polygon_or_bin | summarized_layer 値をポリゴン別またはビン別のいずれで集計するかを指定します。
| String |
bin_type | フィーチャを集約するために生成するビンの形状を指定します。
| String |
bin_size (オプション) | 入力フィーチャを集約するビンのサイズと単位を表す距離間隔。 | Linear Unit |
summary_polygons (オプション) | 入力集計レイヤー内のフィーチャの集計に使用するポリゴン。 | Feature Layer |
sum_shape | サマリー レイヤー (ポリゴンまたはビン) 内にあるラインの長さ、またはポリゴンの面積を計算するかどうかを指定します。 サマリー シェープと交差するポイント、ライン、およびポリゴンの数は常に含まれます。
| Boolean |
shape_units (オプション) | シェープ属性のサマリーで使用する計測単位を指定します。 入力の summarized_layer 値がポイントである場合は、各入力ポリゴン内のポイント数が加算されるだけなので、集計エリアの単位は不要です。 入力サマリー フィーチャがラインである場合は、距離単位を指定します。 入力サマリー フィーチャがポリゴンである場合は、面積単位を指定します。
| String |
standard_summary_fields [standard_summary_fields,...] (オプション) | 指定されたフィールドに関して計算される統計情報。
フィールドが個数を表すか、レートを表すかを指定します。
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (オプション) | 指定されたフィールドに関して計算される加重統計を指定します。
フィールドが個数を表すか、レートを表すかを指定します。
| Value Table |
group_by_field (オプション) | 一意の属性値ごとに統計を個別に計算するために使用する入力サマリー フィーチャのフィールド。 たとえば、入力サマリー フィーチャに危険物を保管している会社の位置ポイントを含み、フィールドの 1 つが、保管されている危険物のタイプを記述したコードを含む HazardClass であるとします。 HazardClass の一意の値のそれぞれについて集計を計算するには、そのフィールドをグループ化フィールドとして使用します。 | Field |
add_minority_majority (オプション) | 各境界内のグループ フィールドごとに最少頻値 (最も支配的でない) 属性値または最頻値 (最も支配的) 属性値が追加されるかどうかを指定します。 このパラメーター値が ADD_MIN_MAJ の場合、Minority_ と Majority_ の接頭辞を持つ 2 つの新しいフィールドが出力レイヤーに追加されます。 このパラメーターは、group_by_field パラメーターに値が指定された場合のみ適用されます。
| Boolean |
add_percentages (オプション) | 割合フィールドを追加するかどうかを指定します。 このパラメーターが ADD_PERCENT の場合は、各入力ポリゴンについて、一意の各グループ値のパーセンテージが計算されます。 このパラメーターは、group_by_field パラメーターに値が入力され、add_minority_majority パラメーターに値が指定された場合のみ適用されます。
| Boolean |
group_by_summary (オプション) | 集計別にグループを格納する出力テーブル。 | Table |
コードのサンプル
次の Python ウィンドウ スクリプトは、SummarizeWithin 関数の使用方法を示しています。
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
# Set local variables
summarizedLayer = "Rivers"
summaryPolys = "Basins"
summaryStatistics = [["Width", "MEAN", "RATE"]]
weightedSummaryStatistics = [["DOC", "STDDEV", "COUNT"]]
out = 'SummarizedRivers'
# Run SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)