ポリゴンの按分 (解析ツール)

サマリー

ターゲットポリゴンレイヤーの空間オーバーレイに基づき、入力ポリゴンレイヤーの属性を集計します。また、ターゲットポリゴンに属性を割り当てます。ターゲットポリゴンは、各ターゲットが重複している入力ポリゴンからの数値属性を集計します。一般的に、このプロセスは按分として知られています。

このツールを使用して、別のフィーチャと重なっているフィーチャの割合に基づき、フィーチャの母集団を推定することができます。

注意:

レイヤーへの情報付加 ツールは、集約および按分の詳細な設定を使用してデータを集計します。

ポリゴンの按分 ツールは レイヤーへの情報付加 ツールと似ています。ただし、ポリゴンの按分 が指定された按分を使用するのに対して、レイヤーへの情報付加 は按分に米国国勢調査区ポイントかグローバル居住地ポイントを使用します。詳細については、「データの割り当て」をご参照ください。

図

使用法

デフォルトでは、重なっているエリアの割合により、転送される属性の割合が決定されます。あるいは、推定フィーチャ パラメーターを使用して、ポイントの割合またはラインの長さを使用して割合を作成できます。
按分属性のデフォルトの統計は合計統計です。合計統計は、人口などの個数ベースの属性を按分する場合にのみ適しています。平均統計と 中央値 統計は、按分方法 パラメーターが面積に設定されている場合に使用でき、人口の割合など比率ベースの属性を按分する場合に適しています。

転送される属性の量を調整するには、入力ポリゴンの加重フィールドを正規化して使用します。加重フィールドが 0 の場合、入力からターゲットに按分される属性が 0 に設定されます。
推定フィーチャ パラメーター値が指定されている場合、属性が転送される方法を決定するために、その値が面積の代わりに使用されます。 入力ポリゴン パラメーター値がカウントされるには、推定フィーチャがその値と交差している必要があります。推定フィーチャが ターゲットポリゴン パラメーター値とも交差している場合に、属性が入力フィーチャからターゲットに転送されます。
ターゲットジオメトリー、または入力ジオメトリーとターゲットジオメトリーの交差部分を出力ジオメトリーに含めるには、ターゲットジオメトリーの維持 パラメーターを使用します。
このツールは、並列処理ファクター環境を優先します。この環境が設定されていない場合 (デフォルト) や 100 に設定されている場合、フル並列処理が有効になり、ツールはコンピューター上のすべての論理コアに作業を分配しようとします。この環境を 0 に設定すると、並列処理は無効になります。ファクターを 1 ～ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を特定します。この数式の結果が 0 または 1 の場合、並列処理は有効化されません。

ラベル	説明	データタイプ
入力ポリゴン	数値属性を含むポリゴンフィーチャで、ターゲットポリゴンジオメトリーに集計されます。	Feature Layer
按分フィールド	入力ポリゴンの数値フィールド。各ターゲットポリゴン別に集計され、出力フィーチャクラスに記録されます。値テーブル列: Apportion Field—The apportioned field attribute values that will be used to calculate the specified statistic. Statistic Method—The statistic method that will be used on the apportioned values. Sum—The values for the specified field will be added together. Use this statistic for count-based attributes. This is the default. Mean—The average for the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area. Median—The median of the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area.	Value Table
ターゲットポリゴン	ポリゴンフィーチャとそれらに按分されたフィールドで、出力フィーチャクラスにコピーされます。	Feature Layer
出力フィーチャクラス	ターゲットポリゴンの属性とジオメトリー、および入力ポリゴンの指定された割り当てフィールドを含む出力フィーチャクラス	Feature Class
按分方法	入力ポリゴンのフィールドをターゲットポリゴンに按分するための方法を指定します。面積—各入力ポリゴンが各ターゲットフィーチャの集計値に占める量は、2 つのフィーチャ間の重なるエリアによって決定されます。入力フィーチャが 2 つのターゲットフィーチャと同じ量だけオーバーラップしている場合、按分されたフィールドは 2 つに分割され、両方のターゲットフィーチャの合計値の半分ずつを占めます。これがデフォルトです。長さ—入力フィーチャの属性は、各ターゲットフィーチャに含まれるラインの量の割合に基づいて分割されます。入力フィーチャに交差しているラインのみが計算に含まれます。入力フィーチャ外部のラインは除外されます。たとえば、1 つのターゲットフィーチャが 750 メートルのラインをカバーし、別のターゲットフィーチャが 250 メートルのラインをカバーしている場合は、入力フィーチャの属性値の 75% (750 / 1000) が最初のターゲットフィーチャに集約され、入力フィーチャの属性値の 25% (250 / 1000) が 2 番目のターゲットフィーチャに集約されます。ポイント—入力フィーチャの属性は、入力フィーチャと重なっている各ターゲットフィーチャ部分の内部にあるポイント数に基づいて分割されます。入力フィーチャ外部のポイントは除外されます。必要に応じて、加重フィールドを指定することで、各ターゲットフィーチャ内部のすべてのポイントの合計加重値を使用して、入力フィーチャの属性値の分割方法を決定できます。たとえば、2 つのターゲットフィーチャが 1 つの入力フィーチャと重なっている場合に、最初のターゲットフィーチャ内部に 2 つのポイント、2 番目のターゲットフィーチャ内部に 8 つのポイントが存在するとすれば、入力フィーチャの属性値の 20% (2 / 10) が最初のターゲットフィーチャに集約され、入力フィーチャの属性値の 80% (8 / 10) が 2 番目のターゲットフィーチャに集約されます。	String
推定フィーチャ (オプション)	ターゲットポリゴンに按分する入力ポリゴンの按分フィールドの割合を推定するために使用される入力ポイント/ポリラインフィーチャ。これは、割合を作成するために、交差部分内のポイントまたはラインの量を入力フィーチャ内部の量で除算することを示しています。	Feature Layer
加重フィールド (オプション)	ターゲットポリゴンレイヤーの数値フィールド。按分する入力ポリゴンのフィールドの按分値を、どのターゲットポリゴンにより多く付与するかを調整するために使用します。加重の高いターゲットには、高い割合のフィールド値が按分されます。推定フィーチャが指定されている場合、推定フィーチャと交差するターゲットポリゴンに按分される値を調整する推定値の数値フィールドが加重フィールドになります。	Field
ターゲットジオメトリーの保持 (オプション)	出力フィーチャクラスがターゲットポリゴンレイヤーの元のジオメトリーを保持するかどうかを指定します。オン—出力フィーチャクラスがターゲットポリゴンレイヤーの元のジオメトリーを保持します。これがデフォルトです。オフ—出力フィーチャクラスは、ターゲットポリゴンと入力ポリゴンのジオメトリーの交差部分になります。入力ポリゴンに重なるターゲットポリゴンのエリアのみが、出力に含まれます。	Boolean

arcpy.analysis.ApportionPolygon(in_features, apportion_fields, target_features, out_features, method, {estimation_features}, {weight_field}, {maintain_geometries})

名前	説明	データタイプ
in_features	数値属性を含むポリゴンフィーチャで、ターゲットポリゴンジオメトリーに集計されます。	Feature Layer
apportion_fields [[field, {statistic_type}],...]	入力ポリゴンの数値フィールド。各ターゲットポリゴン別に集計され、出力フィーチャクラスに記録されます。値テーブル列: `Apportion Field`—The apportioned field attribute values that will be used to calculate the specified statistic. `Statistic Method`—The statistic method that will be used on the apportioned values. `SUM`—The values for the specified field will be added together. Use this statistic for count-based attributes. This is the default. `MEAN`—The average for the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area. `MEDIAN`—The median of the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area.	Value Table
target_features	ポリゴンフィーチャとそれらに按分されたフィールドで、出力フィーチャクラスにコピーされます。	Feature Layer
out_features	ターゲットポリゴンの属性とジオメトリー、および入力ポリゴンの指定された割り当てフィールドを含む出力フィーチャクラス	Feature Class
method	入力ポリゴンのフィールドをターゲットポリゴンに按分するための方法を指定します。 `AREA`—各入力ポリゴンが各ターゲットフィーチャの集計値に占める量は、2 つのフィーチャ間の重なるエリアによって決定されます。入力フィーチャが 2 つのターゲットフィーチャと同じ量だけオーバーラップしている場合、按分されたフィールドは 2 つに分割され、両方のターゲットフィーチャの合計値の半分ずつを占めます。これがデフォルトです。 `LENGTH`—入力フィーチャの属性は、各ターゲットフィーチャに含まれるラインの量の割合に基づいて分割されます。入力フィーチャに交差しているラインのみが計算に含まれます。入力フィーチャ外部のラインは除外されます。たとえば、1 つのターゲットフィーチャが 750 メートルのラインをカバーし、別のターゲットフィーチャが 250 メートルのラインをカバーしている場合は、入力フィーチャの属性値の 75% (750 / 1000) が最初のターゲットフィーチャに集約され、入力フィーチャの属性値の 25% (250 / 1000) が 2 番目のターゲットフィーチャに集約されます。 `POINTS`—入力フィーチャの属性は、入力フィーチャと重なっている各ターゲットフィーチャ部分の内部にあるポイント数に基づいて分割されます。入力フィーチャ外部のポイントは除外されます。必要に応じて、加重フィールドを指定することで、各ターゲットフィーチャ内部のすべてのポイントの合計加重値を使用して、入力フィーチャの属性値の分割方法を決定できます。たとえば、2 つのターゲットフィーチャが 1 つの入力フィーチャと重なっている場合に、最初のターゲットフィーチャ内部に 2 つのポイント、2 番目のターゲットフィーチャ内部に 8 つのポイントが存在するとすれば、入力フィーチャの属性値の 20% (2 / 10) が最初のターゲットフィーチャに集約され、入力フィーチャの属性値の 80% (8 / 10) が 2 番目のターゲットフィーチャに集約されます。	String
estimation_features (オプション)	ターゲットポリゴンに按分する入力ポリゴンの按分フィールドの割合を推定するために使用される入力ポイント/ポリラインフィーチャ。これは、割合を作成するために、交差部分内のポイントまたはラインの量を入力フィーチャ内部の量で除算することを示しています。	Feature Layer
weight_field (オプション)	ターゲットポリゴンレイヤーの数値フィールド。按分する入力ポリゴンのフィールドの按分値を、どのターゲットポリゴンにより多く付与するかを調整するために使用します。加重の高いターゲットには、高い割合のフィールド値が按分されます。推定フィーチャが指定されている場合、推定フィーチャと交差するターゲットポリゴンに按分される値を調整する推定値の数値フィールドが加重フィールドになります。	Field
maintain_geometries (オプション)	出力フィーチャクラスがターゲットポリゴンレイヤーの元のジオメトリーを保持するかどうかを指定します。 `MAINTAIN_GEOMETRIES`—出力フィーチャクラスがターゲットポリゴンレイヤーの元のジオメトリーを保持します。これがデフォルトです。 `INTERSECT_GEOMETRIES`—出力フィーチャクラスは、ターゲットポリゴンと入力ポリゴンのジオメトリーの交差部分になります。入力ポリゴンに重なるターゲットポリゴンのエリアのみが、出力に含まれます。	Boolean

コードのサンプル

ApportionPolygon の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、ApportionPolygon 関数の使用方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"
arcpy.analysis.ApportionPolygon(
        "CensusBlockGroups", "Pop2020", "StoreServiceArea",
        "StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")

ApportionPolygon の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、エリアで加重された人口を国勢調査区グループレイヤーから店舗のサービスエリアポリゴンに送ります。

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = "Pop2020"
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"

arcpy.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas,
                                outputApp, apportionMethod, "", "",
                                keepTargetGeom)

# Summarize store service area populations by store admin region
outStats = "PopulationPerSalesRegion_tlb"
statsFields = [["Pop2020", "SUM"]]
regionField = "SalesRegion"  # Values such as North, North-East, etc.

arcpy.analysis.Statistics(outputApp, outStats, statsFields, regionField)

ApportionPolygon の例 3 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、平均と中間値を使用して、按分されたフィールドを推定する例を示しています。

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = [["POP2000", "MEAN"], ["SUM_Incide", "MEDIAN"]]
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"

arcpy.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas,
                                outputApp, apportionMethod, "", "",
                                keepTargetGeom)

環境

現在のワークスペース, スクラッチワークスペース, 出力座標系, 範囲, 並列処理ファクター

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

ポリゴンの按分 (解析ツール)

サマリー

注意:

図

使用法

パラメーター

環境

ライセンス情報

関連トピック