| ラベル | 説明 | データ タイプ |
集計レイヤー |
ポリゴンまたはビンごとに集計するポイント フィーチャ、ライン フィーチャ、またはポリゴン フィーチャ。 | 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)] を使用して、標準の統計情報と地理空間的に加重した統計情報を計算できます。 標準の統計情報は、加重なしで統計値を集計したものです。 加重統計情報では、ポリゴン内のラインの割合、またはポリゴン内のポリゴンの割合を地理空間的に加重した値を使用して、値を計算します。 加重統計情報は、ポリゴン内のポイントには適用されません。
以下の表にあるオプションを使用して、各ポリゴン内の集計対象レイヤーの長さと面積を計算できます。 オプションは、集計対象レイヤーのジオメトリに基づきます。
入力フィーチャ 説明 オプション ポイント
各ポリゴン内の集計ポイントの数
なし
ライン
各ポリゴン内の集計ラインの長さ
- マイル
- ヤード
- フィート
- キロメートル
- メートル
面積
各ポリゴン内の集計ポリゴンの面積
- 平方マイル
- 平方ヤード
- 平方フィート
- 平方キロメートル
- 平方メートル
- ヘクタール
- エーカー
標準統計情報を計算できます。 ラインとエリアでは、すべての加重統計情報が算出されます。 標準集計フィールド統計情報と加重集計フィールド統計情報はどちらも、[集計ポリゴン] レイヤーと交差している [集計レイヤー] パラメーター内のフィーチャのデータに適用されます。 加重集計フィールド統計情報に、[集計ポリゴン] パラメーターのフィーチャが [集計対象レイヤー] パラメーター内の各フィーチャと交差している割合に基づく重みが乗算されます。
標準統計情報には、8 つのオプションがあります (個数、合計、平均、最小、最大、範囲、標準偏差、および分散)。 文字列統計情報には、2 つのオプションがあります (個数および任意)。 加重統計情報には、集計対象レイヤー内の数値フィールドに対して算出される 8 つのオプションがあります (個数、合計、平均、最小、最大、範囲、標準偏差、分散)。
文字列データの場合は、加重統計情報が算出されません。 [フィールド] 値および [統計情報] 値が指定されるたびに、行がこのツールのウィンドウに追加されるため、複数の統計情報を計算することができます。 集計結果を結果レイヤーのテーブルまたはポップアップに表示できます。 デフォルトでは、[集計ポリゴン] 値と交差しているフィーチャの個数が常に算出されます。
ビニングによる解析では、入力が投影されているか、出力座標系が投影座標系に設定されている必要があります。 データが投影座標系内になく、投影座標系を設定していない場合、解析するデータの範囲に基づいて投影法が使用されます。
必要に応じて、[フィールドでグループ化] 値を選択し、一意の属性値ごとに統計情報が別々に計算されるようにすることができます。 [フィールドでグループ化] 値を選択すると、各フィーチャと統計情報を [フィールドでグループ化] 値に基づいて表示する集計テーブルも作成されます。
[フィールドでグループ化] 値が選択されると、[最少頻値属性および最頻値属性の追加] パラメーターと [グループの割合の追加] パラメーターを使用できます。 最少頻値と最頻値は、[フィールドでグループ化] パラメーターに含まれる最も優位性の低い値と最も優位性の高い値であり、優位性はそれぞれの値のポイント数、全長、または合計面積で決定されます。
[最少頻値属性および最頻値属性の追加] パラメーターをオンにすると、2 つのフィールドが結果レイヤーに追加されます。 これらのフィールドには、各結果フィーチャの最少頻値と最頻値である [フィールドでグループ化] パラメーターの値が表示されます。
[グループの割合の追加] パラメーターは、[最少頻値属性および最頻値属性の追加] がオンになったときのみ使用可能になります。 [グループの割合の追加] パラメーターをオンにすると、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 フィールドでグループを作成した場合、minority_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 Pro の 標準フィーチャ解析ツールボックスの [エリア内での集計 (Summarize Within)] ツールを使用して、同様の解析を実行することもできます。
パラメーター
arcpy.gapro.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 (オプション) | 各境界内のグループ フィールドごとに最少頻値 (最も支配的でない) 属性値または最頻値 (最も支配的) 属性値が追加されるかどうかを指定します。 存在する場合、Majority_ と Minority_ の接頭辞を持つ 2 つの新しいフィールドが出力レイヤーに追加されます。 このパラメーターは、group_by_field パラメーターが使用されている場合のみ適用されます。
| Boolean |
add_percentages (オプション) | 割合フィールドを追加するかどうかを指定します。 存在する場合、各入力ポリゴンについて、一意の各グループ値のパーセンテージが計算されます。 このパラメーターは、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"]]
weighedSummaryStatistics = [["DOC", "SUM"]]
out = 'SummarizedRivers'
# Execute SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)ライセンス情報
- Basic: No
- Standard: No
- Advanced: Yes