交差部分のクロス集計 (解析ツール)

サマリー

2 つのフィーチャクラス間の交差部分を計算し、交差しているフィーチャの面積、長さ、個数をクロス集計します。

図

使用法

ゾーンは、ゾーンフィールド パラメーターと同じ値を持つ 入力ゾーンフィーチャ パラメーターのすべてのフィーチャで構成されます。同様に、クラスは クラスフィールド パラメーターと同じ値を持つ 入力クラスフィーチャ パラメーターのすべてのフィーチャで構成されます。フィーチャは、同じゾーンまたはクラス内で隣接している必要はありません。このツールは、ゾーンがクラスごとにどの程度交差しているかを、面積とゾーン面積に対する割合から計算します。
クラスフィールド の値を指定しないと、入力クラスフィーチャ パラメーターのすべてのフィーチャが、単一のクラスと見なされます。そのため、出力テーブル 値の各ゾーンには、1 レコードが含まれます。
クラスフィールド の値を指定すると、ゾーンに含まれるクラスの数を n とした場合、出力テーブル 値には各ゾーンに対して n レコードが含まれます。たとえば、あるゾーンに 4 つのクラスがある場合、出力テーブル 値のそのゾーンの部分には 4 レコードが含まれます。
合計フィールド パラメーターを使用して、入力クラスフィーチャ パラメーターの数値属性をゾーンごとに合計できます。クラスの合計値は、ゾーンを交差するクラスの割合に基づく合計値の比率を表します。

注意:

合計フィールド には、比率や密度などの相対的な値または正規化された値ではなく、分割してゾーン間で分配可能な、絶対的な値を持つフィールドを使用します。
入力ゾーンフィーチャ 値よりも高い次元の 入力クラスフィーチャ 値はサポートされません。
- 入力ゾーンフィーチャ 値がポイントである場合、入力クラスフィーチャ 値にはポリゴンもラインも指定できません。
- 入力ゾーンフィーチャ 値がラインである場合、入力クラスフィーチャ 値にポリゴンを指定できません。
入力ゾーンフィーチャ および 入力クラスフィーチャ 値がポリゴンである場合、出力テーブルの統計は面積の計算に基づきます。

入力クラスフィーチャ 値がラインである場合、出力テーブルの統計は長さの計算に基づきます。

入力クラスフィーチャ 値がポイントである場合、出力テーブルの統計はフィーチャ数に基づきます。
入力ゾーンフィーチャ および 入力クラスフィーチャ 値が同じ次元 (両方ポリゴン、両方ライン、または両方ポイント) である場合、出力の PERCENTAGE フィールドは、クラスと交差するゾーンフィーチャの割合を記録します。

入力ゾーンフィーチャ および 入力クラスフィーチャ 値が異なる次元 (ポリゴンゾーンとラインクラス、ポリゴンゾーンとポイントクラス、またはラインゾーンとポイントクラス) である場合、出力テーブルの PERCENTAGE フィールドは、ゾーンポリゴンと交差するクラスの割合を記録します。

PERCENTAGE フィールドは、入力ゾーンフィーチャ または 入力クラスフィーチャ パラメーターのフィーチャがオーバーラップしている場合には、100% より大きい値を記録することがあります。
入力ゾーンフィーチャ および 入力クラスフィーチャ 値がポリゴンである場合にのみ、AREA フィールドが出力テーブルに追加されます。 AREA フィールドには、入力クラスフィーチャ 値が交差する 入力ゾーンフィーチャ 値の面積が含まれます。

入力クラスフィーチャ 値がラインである場合、LENGTH フィールドが出力テーブルに追加されます。 LENGTH フィールドには、入力ゾーンフィーチャ および 入力クラスフィーチャ 値の間の交差の長さが含まれます。

入力クラスフィーチャ 値がポイントである場合、PNT_COUNT フィールドが出力テーブルに追加されます。 PNT_COUNT フィールドには、入力ゾーンフィーチャ 値と交差する 入力クラスフィーチャ のポイントの数が含まれします。
フィーチャレイヤーを使用していて、フィーチャが選択されている場合は、選択されたフィーチャのみが計算に使用されます。
ゾーンおよびクラスのフィーチャの交差部分の判定は、インターセクト ツールと同じルールに従います。
ピボットテーブル ツールを使用して 出力テーブル 値を変換すると、各ゾーンにつき 1 つのレコードを含む、クラス属性を属性フィールドに分けたテーブルに変換できます。 ピボットテーブル ツールのパラメーターには、次の値を入力します:
- 入力テーブル— 交差部分のクロス集計 の 出力テーブル
- 入力フィールド— 交差部分のクロス集計 の ゾーンフィールド
- ピボットフィールド— 交差部分のクロス集計 の クラスフィールド
- 値フィールド— 交差部分のクロス集計 の 合計フィールド、または AREA、LENGTH、PERCENTAGE

ラベル	説明	データタイプ
入力ゾーンフィーチャ	ゾーンの特定に使用するフィーチャです。	Feature Layer
ゾーンフィールド	ゾーンの定義に使用する 1 つまたは複数の属性フィールドです。	Field
入力クラスフィーチャ	クラスの特定に使用するフィーチャです。	Feature Layer
出力テーブル	ゾーンとクラス間の交差部分のクロス集計が含まれるテーブルです。	Table
クラスフィールド (オプション)	クラスの定義に使用される 1 つまたは複数の属性フィールドです。	Field
合計フィールド (オプション)	入力クラスフィーチャパラメーターから集計されるフィールド。	Field
XY 許容値 (オプション)	フィーチャまたはその頂点が同一と見なされる範囲を決定する距離です。デフォルト値は、入力ゾーンフィーチャパラメーター値の x,y 許容値です。注意: このパラメーターの値を変更すると、エラーまたは予期しない結果が発生する可能性があります。このパラメーターは変更しないことをお勧めします。ツールダイアログボックスのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の x,y 許容値プロパティが使用されます。	Linear Unit
出力単位 (オプション)	面積計測または長さの計測の計算に使用する単位を指定します。入力クラスフィーチャがポイントの場合は、出力単位を設定できません。不明—単位は不明です。キロメートル—単位はキロメートルになります。メートル—単位はメートルになります。デシメートル—単位はデシメートルです。センチメートル—単位はセンチメートルです。ミリメートル—単位はミリメートルです。法定マイル—単位は法定マイルです。国際海里—単位は国際海里です。国際ヤード—単位は国際ヤードです。国際フィート—単位は国際フィートです。国際インチ—単位は国際インチです。米国測量マイル—単位は米国測量マイルです。米国測量海里—単位は米国測量海里です。米国測量ヤード—単位は米国測量ヤードです。米国測量フィート—単位は米国測量フィートです。インチ—単位は米国測量インチです。度 (10 進)—単位は度 (10 進) です。ポイント—単位はポイントです。アール—単位はアールです。平方キロメートル—単位は平方キロメートルになります。平方メートル—単位は平方メートルになります。平方デシメートル—単位は平方デシメートルです。平方センチメートル—単位は平方センチメートルです。平方ミリメートル—単位は平方ミリメートルです。平方法定マイル—単位は平方法定マイルです。平方国際海里—面積単位は平方国際海里。平方国際ヤード—単位は平方国際ヤードです。平方国際フィート—単位は平方国際フィートです。平方国際インチ—単位は平方国際インチです。平方米国測量マイル—単位は平方米国測量マイルです。平方米国測量海里—面積単位は平方米国測量海里。平方米国測量ヤード—単位は平方米国測量ヤードです。平方米国測量フィート—単位は平方米国測量フィートです。平方米国測量インチ—単位は平方米国測量インチです。米国測量エーカー—単位は米国測量エーカーです。ヘクタール—単位はヘクタールになります。エーカー—単位は国際エーカーです。	String

arcpy.analysis.TabulateIntersection(in_zone_features, zone_fields, in_class_features, out_table, {class_fields}, {sum_fields}, {xy_tolerance}, {out_units})

名前	説明	データタイプ
in_zone_features	ゾーンの特定に使用するフィーチャです。	Feature Layer
zone_fields [zone_fields,...]	ゾーンの定義に使用する 1 つまたは複数の属性フィールドです。	Field
in_class_features	クラスの特定に使用するフィーチャです。	Feature Layer
out_table	ゾーンとクラス間の交差部分のクロス集計が含まれるテーブルです。	Table
class_fields [class_fields,...] (オプション)	クラスの定義に使用される 1 つまたは複数の属性フィールドです。	Field
sum_fields [sum_fields,...] (オプション)	`in_class_features` パラメーターから集計されるフィールド。	Field
xy_tolerance (オプション)	フィーチャまたはその頂点が同一と見なされる範囲を決定する距離です。デフォルト値は、`in_zone_features` パラメーター値の x,y 許容値です。注意: このパラメーターの値を変更すると、エラーまたは予期しない結果が発生する可能性があります。このパラメーターは変更しないことをお勧めします。ツールダイアログボックスのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の x,y 許容値プロパティが使用されます。	Linear Unit
out_units (オプション)	面積計測または長さの計測の計算に使用する単位を指定します。入力クラスフィーチャがポイントの場合は、出力単位を設定できません。 `UNKNOWN`—単位は不明です。 `KILOMETERS`—単位はキロメートルになります。 `METERS`—単位はメートルになります。 `DECIMETERS`—単位はデシメートルです。 `CENTIMETERS`—単位はセンチメートルです。 `MILLIMETERS`—単位はミリメートルです。 `MILES_INTERNATIONAL`—単位は法定マイルです。 `NAUTICAL_MILES_INTERNATIONAL`—単位は国際海里です。 `YARDS_INTERNATIONAL`—単位は国際ヤードです。 `FEET_INTERNATIONAL`—単位は国際フィートです。 `INCHES_INTERNATIONAL`—単位は国際インチです。 `MILES`—単位は米国測量マイルです。 `NAUTICAL_MILES`—単位は米国測量海里です。 `YARDS`—単位は米国測量ヤードです。 `FEET`—単位は米国測量フィートです。 `INCHES`—単位は米国測量インチです。 `DECIMAL_DEGREES`—単位は度 (10 進) です。 `POINTS`—単位はポイントです。 `ARES`—単位はアールです。 `SQUARE_KILOMETERS`—単位は平方キロメートルになります。 `SQUARE_METERS`—単位は平方メートルになります。 `SQUARE_DECIMETERS`—単位は平方デシメートルです。 `SQUARE_CENTIMETERS`—単位は平方センチメートルです。 `SQUARE_MILLIMETERS`—単位は平方ミリメートルです。 `SQUARE_MILES`—単位は平方法定マイルです。 `SQUARE_NAUTICAL_MILES`—面積単位は平方国際海里。 `SQUARE_YARDS`—単位は平方国際ヤードです。 `SQUARE_FEET`—単位は平方国際フィートです。 `SQUARE_INCHES`—単位は平方国際インチです。 `SQUARE_MILES_US`—単位は平方米国測量マイルです。 `SQUARE_NAUTICAL_MILES_US`—面積単位は平方米国測量海里。 `SQUARE_YARDS_US`—単位は平方米国測量ヤードです。 `SQUARE_FEET_US`—単位は平方米国測量フィートです。 `SQUARE_INCHES_US`—単位は平方米国測量インチです。 `ACRES_US`—単位は米国測量エーカーです。 `HECTARES`—単位はヘクタールになります。 `ACRES`—単位は国際エーカーです。	String

コードのサンプル

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

Python ウィンドウで TabulateIntersection 関数を使用して、ゾーンごとに各植生タイプの面積を求めます。

import arcpy
arcpy.analysis.TabulateIntersection("Zones", "zone_id", "Vegetation",
                                    r"C:\Esri\veganalysis.gdb\vegtypeAreas",
                                    "VEGTYPE")

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

このスクリプトは、TabulateIntersection 関数をラップして、簡単な TabulateArea スクリプトツールを作成します。 TabulateArea スクリプトツールに入力できるのは、ポリゴンフィーチャのみです。

ゾーンフィールドおよびクラスフィールドは、それぞれ 1 つに制限されています。

'''
TabulateArea.py
Description: Shows how to wrap the TabulateIntersection tool to create a TabulateArea script tool
Requirements: Polygon Zone Feature Class, Polygon Class Feature Class

'''
import arcpy
import sys
import os

def AddMsgAndPrint(msg, severity=0):
    # Adds a Message (in case this is run as a tool)
    # and also prints the message to the screen (standard output)
    print(msg)

    # Split the message on \n first, so that if it's multiple lines,
    # a GPMessage will be added for each line
    try:
        for string in msg.split('\n'):
            # Add appropriate geoprocessing message
            if severity == 0:
                arcpy.AddMessage(string)
            elif severity == 1:
                arcpy.AddWarning(string)
            elif severity == 2:
                arcpy.AddError(string)
    except:
        pass

## Get Parameters
zoneFC = arcpy.GetParameterAsText(0)
zoneFld = arcpy.GetParameterAsText(1) # Only allow one field
classFC = arcpy.GetParameterAsText(2)
outTab = arcpy.GetParameterAsText(3)
classFld = arcpy.GetParameterAsText(4) # Optional and only allow one field
sum_Fields = ""
xy_tol = ""
outUnits = arcpy.GetParameterAsText(5)

## Validate parameters
# Inputs can only be polygons
zoneDesc = arcpy.Describe(zoneFC)
classDesc = arcpy.Describe(classFC)
if zoneDesc.shapeType != "Polygon" or classDesc.shapeType != "Polygon":
    AddMsgAndPrint("Inputs must be of type polygon.", 2)
    sys.exit()

# Only one zone field and class field
if zoneFld != "":
    if zoneFld.find(";") > -1 or classFld.find(";") > -1:
        AddMsgAndPrint("A maximum of one zone and/or class field is allowed.", 2)
        sys.exit()

# Run TabulateIntersection
try:
    arcpy.analysis.TabulateIntersection(zoneFC, zoneFld, classFC, outTab,
                                        classFld, sum_Fields, xy_tol, outUnits)
except:
    arcpy.AddMessage("Tabulate Intersection Failed.")

AddMsgAndPrint(arcpy.GetMessages(), 0)

環境

自動コミット, 出力データのコンフィグレーションキーワード, 出力データの XY ドメイン, 出力座標系, 地理座標系変換, 範囲, 完全に記述したフィールド名を保持, スクラッチワークスペース, XY 座標精度, XY 許容値

ライセンス情報

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

交差部分のクロス集計 (解析ツール)

サマリー

図

使用法

注意:

パラメーター

注意:

環境

ライセンス情報

関連トピック