概要
2 つのラスター データセットまたはモザイク データセットのプロパティを比較します。
使用法
このツールは、比較結果を示すメッセージを返します。
パラメーターと属性の許容値により、偏差の量を指定した比較が可能になります。
構文
arcpy.management.RasterCompare(in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})| パラメーター | 説明 | データ タイプ |
in_base_raster | 比較する最初のラスターまたはモザイク データセット。 | Raster Layer; Mosaic Layer |
in_test_raster | 最初のラスターまたはモザイク データセットと比較する 2 番目のラスターまたはモザイク データセット。 | Raster Layer; Mosaic Layer |
compare_type (オプション) | 比較するラスターの種類を指定します。
| String |
ignore_option [ignore_option,...] (オプション) | 比較で無視されるプロパティを指定します。
| String |
continue_compare (オプション) | 不一致が発生した場合に、比較を停止するかどうかを指定します。
| Boolean |
out_compare_file (オプション) | 比較結果を含む出力テキスト ファイル。 | File |
parameter_tolerances [[Parameter, Tolerance, Type],...] (オプション) | フィーチャが同一と見なされる範囲を決定する許容値。 すべてのパラメーターに同じ許容値を適用するか、パラメーターごとに異なる許容値を適用することができます。 許容値のタイプは、値としても端数としても設定できます。 たとえば、ベース値が 100 の場合に端数の許容値を 0.00001 に設定すると、比較のための許容値は 100 * 0.001 (100 * 0.00001) になります。 | Value Table |
attribute_tolerances [[Field, Tolerance],...] (オプション) | 比較されるフィールドが許容範囲内かどうかを判断します。 許容値は属性の単位の値です。 | Value Table |
omit_field [omit_field,...] (オプション) | 比較時に除外されるフィールド。 | String |
派生した出力
| 名前 | 説明 | データ タイプ |
| compare_status | 相違点が検出されない場合は比較状況が true、相違点が検出された場合は false になります。 | Boolean |
コードのサンプル
RasterCompare (ラスター比較) の例 1 (Python ウィンドウ)
以下は、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 (ラスター比較) の例 2 (スタンドアロン スクリプト)
以下は、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()
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい