ラスタ比較（Raster Compare） (データ管理)
サマリ
2 つのラスタ データセット、2 つのラスタ カタログ、または 2 つのモザイク データセットのプロパティを比較し、比較結果を返します。
使用法
-
このツールは、比較結果を示すメッセージを返します。
-
パラメータと属性の許容値により、ゆとりの幅を指定して比較に設定することができます。
Python の構文では、ツール ダイアログを開いて、[比較対象外のプロパティ] パラメータの値のリストを表示する必要があります。[比較するタイプ] により、有効な [比較対象外のプロパティ] が決まります。
構文
| パラメータ | 説明 | データ タイプ |
in_base_raster |
テスト ラスタと比較される入力ラスタ。 入力として有効なのはラスタ データセット、ラスタ カタログ、またはモザイク データセットなどです。 | Raster Layer; Raster Catalog Layer; Mosaic Layer |
in_test_raster |
入力ベース ラスタと比較されるラスタ データセット。 入力として有効なのはラスタ データセット、ラスタ カタログ、またはモザイク データセットなどです。 | Raster Layer; Raster Catalog Layer; Mosaic Layer |
compare_type (オプション) |
比較のタイプ。
| String |
ignore_option [ignore_option,...] (オプション) |
指定されたプロパティは、比較時に比較されません。 ツール ダイアログを開き、[比較対象外のプロパティ] パラメータの値のリストを表示します。[比較するタイプ] により、有効な [比較対象外のプロパティ] が決まります。 | String |
continue_compare (オプション) |
最初の不一致を検出した後にすべてのプロパティを比較するかどうかを示します。
| Boolean |
out_compare_file (オプション) |
比較結果が格納されるテキスト ファイルの名前とパス。 | File |
parameter_tolerances [[Parameter, Tolerance, Type],...] (オプション) | パラメータ許容値により、パラメータ値と正確性の余裕度を比較できます。これにより、データの処理中に発生している可能性のあるわずかな変化を把握できます。 パラメータのタイプのリストに、許容値を設定するパラメータを選択します。パラメータごとに、許容値と許容値のタイプを設定する必要があります。許容値のタイプは、Value（許容値そのもの）か Fraction（比率）のいずれかです。Fraction タイプでは、ベース値に基づく比率が使用されます。したがって、比較のための許容値はベース値に比率を掛けた値になります。たとえば、ベース値が 100 のときに Fraction の許容値を 0.00001 に設定した場合、比較のための許容値は 100 * 0.00001 = 0.001 になります。
| Value Table |
attribute_tolerances [[Field, Tolerance],...] (オプション) |
属性許容値により、属性値と正確性の余裕度を比較できます。これにより、データの処理中に発生している可能性のあるわずかな変化を把握できます。 許容値を設定するパラメータごとにフィールド名と許容値を入力します。許容値は許容する実際の値であり、比率ではありません。 | Value Table |
omit_field [omit_field,...] (オプション) |
これらは比較の結果の中で除外したいフィールドです。比較から除外するフィールドを入力します。 ラスタ カタログ シナリオに対処するときには、カタログ アイテム内の属性ではなく、ラスタ カタログの属性列を比較します。 | String |
コードのサンプル
以下は、RasterCompare（ラスタ比較）を実行する Python サンプルです。
import arcpy
RasterCompare_management("C:/workspace/image1.tif","C:/workspace/image2.tif",\
"RASTER_DATASET","'Pyramids Exist'",\
"CONTINUE_COMPARE","C:/workspace/compare01.txt",\
"Pixel_Value 1 Value","Count 5","OID")
以下は、RasterCompare（ラスタ比較）を実行する Python サンプルです。
##====================================
##Raster Compare
##Usage: RasterCompare_management in_base_raster in_test_raster {RASTER_DATASET |
## GDB_RASTER_DATASET | GDB_RASTER_CATALOG |
## MOSAIC_DATASET} {ignore_option;ignore_option...}
## {NO_CONTINUE_COMPARE | CONTINUE_COMPARE}
## {out_compare_file} {Parameter {Tolerance} {Type};
## Parameter {Tolerance} {Type}...} {Field {Tolerance};
## Field {Tolerance}...} {omit_field;omit_field...}
try:
import arcpy
arcpy.env.workspace = "c:/workspace"
##Compare two Raster dataset
arcpy.RasterCompare_management("raster_base.tif","raster_test.tif","RASTER_DATASET",\
"","CONTINUE_COMPARE","compareresult.txt","","","")
##Compare two Raster Catalog with ignore options
arcpy.RasterCompare_management("fgdb.gdb/rc_base","fgdb.gdb/rc_test","RASTER_CATALOG",\
"IsManaged;Extent","CONTINUE_COMPARE","compareresult2.txt",\
"","","DATE")
##Compare two Mosaic Dataset with torelance
arcpy.RasterCompare_management("fgdb.gdb/md_base","fgdb.gdb/md_test","MOSAIC_DATASET",\
"IsEmbedded;Seamline","CONTINUE_COMPARE","compareresult3.txt",\
"All 0.00001 Fraction","HighPS 0.0001;LowPS 0.0001",\
"ItemTS;UriHash")
except:
print "Raster Compare exsample failed."
print arcpy.GetMessages()