フィーチャ比較（Feature Compare） (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

2 つのフィーチャクラスまたはレイヤを比較して、比較結果を返します。[フィーチャ比較（Feature Compare）] は、ジオメトリ、テーブル値、空間参照、およびフィールド定義の相違点をレポートできます。

使用法

構文

FeatureCompare_management (in_base_features, in_test_features, sort_field, {compare_type}, {ignore_options}, {xy_tolerance}, {m_tolerance}, {z_tolerance}, {attribute_tolerances}, {omit_field}, {continue_compare}, {out_compare_file})
パラメータ説明データ タイプ
in_base_features

入力ベース フィーチャが入力テスト フィーチャと比較されます。入力ベース フィーチャは、正しいデータを参照します。このベース データは正しいジオメトリ定義、フィールド定義、および空間参照を保持しています。

Feature Layer
in_test_features

入力テスト フィーチャが入力ベース フィーチャに対して比較されます。入力テスト フィーチャは、新規フィーチャの編集またはコンパイルによって変更を行ったデータを参照します。

Feature Layer
sort_field
[sort_field,...]

入力ベース テーブルと入力テスト テーブル内のレコードをソートするために使用するフィールド（複数も可）。レコードは昇順で並べ替えられます。入力ベース フィーチャと入力テスト フィーチャの両方に共通するフィールドでソートすることで、各入力データセットの同じ行を確実に比較できるようになります。

Value Table
compare_type
(オプション)

比較タイプ。「ALL」がデフォルトです。デフォルトでは、比較対象のフィーチャのすべてのプロパティが比較されます。

  • ALL —フィーチャクラスのすべてのプロパティが比較されます。これはデフォルト設定です。
  • GEOMETRY_ONLY —フィーチャクラスのジオメトリのみが比較されます。
  • ATTRIBUTES_ONLY —属性とその値のみが比較されます。
  • SCHEMA_ONLY —フィーチャクラスのスキーマのみが比較されます。
  • SPATIAL_REFERENCE_ONLY —2 つのフィーチャクラスの空間参照のみが比較されます。
String
ignore_options
[ignore_option,...]
(オプション)

これらのプロパティは、比較時に比較されません。

  • IGNORE_M —メジャー プロパティが比較されません。
  • IGNORE_M —標高プロパティが比較されません。
  • IGNORE_POINTID —ポイント ID プロパティが比較されません。
  • IGNORE_EXTENSION_PROPERTIES —エクステンション プロパティを比較しません。
  • IGNORE_SUBTYPES —サブタイプを比較しません。
  • IGNORE_RELATIONSHIPCLASSES —リレーションシップ クラスが比較されません。
  • IGNORE_REPRESENTATIONCLASSES —リプレゼンテーション クラスが比較されません。
String
xy_tolerance
(オプション)

フィーチャが同一と見なされる範囲を指定する距離。エラーを最小限に抑えるため、この比較許容値には、できるだけ小さい値を選択してください。デフォルトで、この比較許容値は入力ベース フィーチャの XY 許容値になります。

Linear unit
m_tolerance
(オプション)

メジャー許容値は、メジャーが同一と見なされるためのメジャー値間の最小距離範囲です。

Double
z_tolerance
(オプション)

Z 許容値は、Z 座標が同一と見なされるための Z 座標値間の最小距離範囲です。

Double
attribute_tolerances
[[Field, {Tolerance}],...]
(オプション)

属性値が等しいと考えられる範囲を決める数値。これは数値フィールド タイプにのみ適用されます。

Value Table
omit_field
[omit_field,...]
(オプション)

比較時に除外されるフィールド。これらのフィールドのフィールド定義とテーブル値は無視されます。

String
continue_compare
(オプション)

最初の不一致を検出した後にすべてのプロパティを比較するかどうかを示します。

  • NO_CONTINUE_COMPARE —最初の不一致を検出した後に停止します。これはデフォルト設定です。
  • CONTINUE_COMPARE —最初の不一致を検出した後に他のプロパティを比較します。
Boolean
out_compare_file
(オプション)

このファイルには、[入力ベース フィーチャ] と [入力テスト フィーチャ] 間の類似点と相違点がすべて含まれます。このファイルは、ArcGIS でテーブルとして表示および使用できる、カンマ区切りテキスト ファイルです。

File

コードのサンプル

FeatureCompare（フィーチャ比較）ツールの例（Python ウィンドウ）

次の Python ウィンドウ スクリプトは、イミディエイト モードで FeatureCompare（フィーチャ比較）関数を使用する方法を示しています。

import arcpy
arcpy.FeatureCompare_management(r'C:/Workspace/baseroads.shp', r'C:/Workspace/newroads.shp', 'ROAD_ID', 'ALL', 'IGNORE_M;IGNORE_Z', '0.001 METERS', 0, 0, 'Shape_Length 0.001', '#', 'CONTINUE_COMPARE', e = r'C:/Workspace/roadcompare.txt')
FeatureCompare（フィーチャ比較）ツールの例（スタンドアロン スクリプト）

スタンドアロン スクリプトで FeatureCompare（フィーチャ比較）ツールを使用する方法の例。

# Name: FeatureCompare.py
# Description: Compare two feature classes and return comparison result.

# import system modules 
import arcpy

try:
    # Set local variables
    base_features = "C:/Workspace/baseroads.shp"
    test_features = "C:/Workspace/newroads.shp"
    sort_field = "ROAD_ID"
    compare_type = "ALL"
    ignore_option = "IGNORE_M;IGNORE_Z"
    xy_tolerance = "0.001 METERS"
    m_tolerance = 0
    z_tolerance = 0
    attribute_tolerance = "Shape_Length 0.001"
    omit_field = "#"
    continue_compare = "CONTINUE_COMPARE"
    compare_file = "C:/Workspace/roadcompare.txt"
 
    # Process: FeatureCompare
    compare_result = arcpy.FeatureCompare_management(base_features, test_features, sort_field, compare_type, ignore_option, xy_tolerance, m_tolerance, z_tolerance, attribute_tolerance, omit_field, continue_compare, compare_file)
    print compare_result.getOutpuput(1)
    print arcpy.GetMessages()
 
except:
    # Print error message if an error occurs
    print arcpy.GetMessages()

環境

このツールはジオプロセシング環境を使用していません

関連トピック

[データ比較] ツールセットの概要

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
Copyright © 1995-2014 Esri. All rights reserved.
7/28/2014