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

ラベル	説明	データタイプ
入力ベースラスター	比較する最初のラスターまたはモザイクデータセット。	Raster Layer; Mosaic Layer
入力テストラスター	最初のラスターまたはモザイクデータセットと比較する 2 番目のラスターまたはモザイクデータセット。	Raster Layer; Mosaic Layer
比較するタイプ (オプション)	比較するラスターの種類を指定します。ラスターデータセット—2 つのラスターデータセットを比較します。ジオデータベースラスターデータセット—ジオデータベース内の 2 つのラスターデータセットを比較します。モザイクデータセット—2 つのモザイクデータセットを比較します。	String
比較対象外のプロパティ (オプション)	比較で無視されるプロパティを指定します。バンド数—バンド数は無視されます。範囲—範囲は無視されます。行と列の数—カラム数およびロウ数は無視されます。ピクセルタイプ—ピクセルタイプは無視されます。 NoData—NoData 値は無視されます。空間参照—空間参照系は無視されます。ピクセル値—ピクセル値は無視されます。カラーマップ—既存のカラーマップは無視されます。ラスター属性テーブル—既存の属性テーブルは無視されます。統計情報—統計情報は無視されます。メタデータ—メタデータは無視されます。既存のピラミッド—既存のピラミッドは無視されます。圧縮タイプ—圧縮タイプは無視されます。データソースタイプ—データソースタイプは無視されます。	String
比較を継続 (オプション)	不一致が発生した場合に、比較を停止するかどうかを指定します。オフ - 不一致が発生した場合、比較を停止します。これがデフォルトです。オン - 不一致が発生しても、比較を継続します。	Boolean
出力比較ファイル (オプション)	比較結果を含む出力テキストファイル。	File
パラメーター許容値 (オプション)	フィーチャが同一と見なされる範囲を決定する許容値。すべてのパラメーターに同じ許容値を適用するか、パラメーターごとに異なる許容値を適用することができます。許容値のタイプは、値としても端数としても使用できます。許容値のタイプが端数の場合は、ピクセルごとに別々の値が設定されているため、ピクセルごとに許容値が異なります。たとえば、許容値の端数が 0.5 に設定されている場合、許容値は次のように算出されます。ピクセルの値が 0.2 の場合、0.5 * 0.2 = 0.1 から、許容値は 0.1 になります。ピクセルの値が 3 の場合、0.5 * 3 = 1.5 から、許容値は 1.5 になります。	Value Table
属性許容値 (オプション)	比較されるフィールドが許容範囲内かどうかを判断します。許容値は属性の単位の値です。	Value Table
除外フィールド (オプション)	比較時に除外されるフィールド。	String

派生した出力

ラベル	説明	データタイプ
比較状況	相違点が検出されない場合は比較状況が true、相違点が検出された場合は false になります。	Boolean

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—圧縮タイプは無視されます。 Data Source Type—データソースタイプは無視されます。	String
continue_compare (オプション)	不一致が発生した場合に、比較を停止するかどうかを指定します。 NO_CONTINUE_COMPARE—不一致が発生した場合、比較を停止します。これがデフォルトです。 CONTINUE_COMPARE—不一致が発生しても、比較を継続します。	Boolean
out_compare_file (オプション)	比較結果を含む出力テキストファイル。	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (オプション)	フィーチャが同一と見なされる範囲を決定する許容値。すべてのパラメーターに同じ許容値を適用するか、パラメーターごとに異なる許容値を適用することができます。許容値のタイプは、値としても端数としても使用できます。許容値のタイプが端数の場合は、ピクセルごとに別々の値が設定されているため、ピクセルごとに許容値が異なります。たとえば、許容値の端数が 0.5 に設定されている場合、許容値は次のように算出されます。ピクセルの値が 0.2 の場合、0.5 * 0.2 = 0.1 から、許容値は 0.1 になります。ピクセルの値が 3 の場合、0.5 * 3 = 1.5 から、許容値は 1.5 になります。	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()

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

このトピックの内容