ラスター比較 (Raster Compare) (データ管理)

概要

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 (オプション)	比較するラスターのタイプ。 RASTER_DATASET —2 つのラスター データセットを比較します。 GDB_RASTER_DATASET —ジオデータベース 2 つのラスター データセットを比較します。 MOSAIC_DATASET —2 つのモザイク データセットを比較します。	String
ignore_option [ignore_option,...] (オプション)	比較に含めないプロパティ。 プロパティの全リストを決定するには、ツール ダイアログ ボックスを開いて、[オプションを無視] パラメーターの値のリストを表示します。[比較するタイプ] により、有効な [オプションを無視] が決まります。 BandCount —バンド数を無視します。 Extent —範囲を無視します。 Columns And Rows —カラムとロウの数を無視します。 Pixel Type —ピクセル タイプを無視します。 NoData —NoData 値を無視します。 Spatial Reference —空間参照系を無視します。 Pixel Value —ピクセル値を無視します。 Colormap —カラー マップが存在する場合は無視します。 Raster Attribute Table —属性テーブルが存在する場合は無視します。 Statistics —統計情報を無視します。 Metadata —メタデータを無視します。 Pyramids Exist —ピラミッドが存在する場合は無視します。 Compression Type —圧縮タイプを無視します。	String
continue_compare (オプション)	不一致が発生した場合、比較を停止します。 NO_CONTINUE_COMPARE —不一致が見つかった場合は比較を停止します。これがデフォルトです。 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: はい