TIN 比較 (TIN Compare) (データ管理)

サマリー

2 つの TIN を比較して、比較結果を返します。

使用法

  • このツールは、比較結果を示すメッセージを返します。 デフォルトでは、ツールは入力間の最初の相違点を検出した後に実行を停止します。 相違点をすべてレポートする場合は、[比較を継続] パラメーターをオンにします。

  • このツールを使って、ジオメトリ、TIN ノードおよび三角形のタグ、および空間参照についての差異をレポートできます。

  • [出力比較ファイル] パラメーター値には、[入力ベース TIN] パラメーター値および [入力テスト TIN] パラメーター値の間のすべての類似点と相違点が含まれます。 このファイルは、ArcGIS でテーブルとして表示および使用できる、カンマ区切りテキスト ファイルです。 たとえば、これを検索して、差異のあるすべての行のすべての ObjectID 値を取得できます。

  • このツールを Python で使用する場合、1 のインデックス位置 (result[1]) を使用して、返された Result オブジェクトから比較状況を取得します。 相違点が検出されない場合は値が 'true'、相違点が検出された場合は 'false' になります。

    Python でのツールの使用についての詳細

パラメーター

ラベル説明データ タイプ
入力ベース TIN

[入力テスト TIN] パラメーター値と比較されるデータ。 このパラメーター値は、有効と宣言したデータです。 このベース データには、正しいコンテンツおよび情報が含まれます。

TIN Layer
入力テスト TIN

[入力ベース TIN] パラメーター値と比較されるデータ。 このパラメーター値は、新しい情報の編集またはコンパイルによって変更を行ったデータです。

TIN Layer
比較するタイプ
(オプション)

使用される比較タイプを指定します。

  • すべてすべてのプロパティが比較されます。 これがデフォルトです。
  • プロパティのみノードおよび三角形に割り当てられる、ジオメトリおよび TIN タグ値の両方が比較されます。
  • 空間参照のみ座標系情報が比較されます。
String
比較を継続
(オプション)

入力間の最初の相違点を検出した後も比較を継続するかどうかを指定します。

  • オフ - ツールは、最初の相違点を検出した後に動作を停止します。 これがデフォルトです。
  • オン - ツールは、最初の相違点を検出した後も動作を継続します。

Boolean
出力比較ファイル
(オプション)

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

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

File

派生した出力

ラベル説明データ タイプ
比較状況

相違点が検出されない場合は比較状況が 'true'、相違点が検出された場合は 'false' になります。

Boolean

arcpy.management.TINCompare(in_base_tin, in_test_tin, {compare_type}, {continue_compare}, {out_compare_file})
名前説明データ タイプ
in_base_tin

in_test_tin パラメーター値と比較されるデータ。 このパラメーター値は、有効と宣言したデータです。 このベース データには、正しいコンテンツおよび情報が含まれます。

TIN Layer
in_test_tin

in_base_tin パラメーター値と比較されるデータ。 このパラメーター値は、新しい情報の編集またはコンパイルによって変更を行ったデータです。

TIN Layer
compare_type
(オプション)

使用される比較タイプを指定します。

  • ALLすべてのプロパティが比較されます。 これがデフォルトです。
  • PROPERTIES_ONLYノードおよび三角形に割り当てられる、ジオメトリおよび TIN タグ値の両方が比較されます。
  • SPATIAL_REFERENCE_ONLY座標系情報が比較されます。
String
continue_compare
(オプション)

入力間の最初の相違点を検出した後も比較を継続するかどうかを指定します。

  • NO_CONTINUE_COMPAREツールは、最初の相違点を検出した後に動作を停止します。 これがデフォルトです。
  • CONTINUE_COMPAREツールは、最初の相違点を検出した後に動作を継続します。
Boolean
out_compare_file
(オプション)

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

File

派生した出力

名前説明データ タイプ
compare_status

相違点が検出されない場合は比較状況が 'true'、相違点が検出された場合は 'false' になります。

Boolean

コードのサンプル

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

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

import arcpy
arcpy.management.TINCompare(r'c:\Workspace\basetin', r'c:\Workspace\newtin', 
                            'ALL', 'CONTINUE_COMPARE', 
                            r'c:\Workspace\tincompare.txt')
TINCompare の例 2 (スタンドアロン スクリプト)

次の例では、スタンドアロン スクリプトで TINCompare ツールを使用する方法を示します。


# Description: Compare two TINs and return comparison result.

# Import system modules 
import arcpy

# Set local variables
base_tin = "C:/Workspace/basetin"
test_tin = "C:/Workspace/newtin"
compare_type = "ALL"
continue_compare = "CONTINUE_COMPARE"
compare_file = "C:/Workspace/tincompare.txt"

compare_result = arcpy.management.TINCompare(base_tin, test_tin, compare_type, 
                                             continue_compare, compare_file)
print(compare_result)
print(arcpy.GetMessages())

環境

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

関連トピック