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

サマリー

2 つのラスター データセットまたは 2 つのモザイク データセットのプロパティを比較します。

使用法

  • このツールは、比較結果を示すメッセージを返します。

  • パラメーターと属性の許容値により、偏差の量を指定した比較が可能になります。

パラメーター

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

比較する最初のラスターまたはモザイク データセット。

Raster Layer; Mosaic Layer
入力テスト ラスター

最初のラスターまたはモザイク データセットと比較する 2 番目のラスターまたはモザイク データセット。

Raster Layer; Mosaic Layer
比較するタイプ
(オプション)

比較するラスターの種類を指定します。

  • ラスター データセット2 つのラスター データセットを比較します。
  • ジオデータベース ラスター データセットジオデータベース内の 2 つのラスター データセットを比較します。
  • モザイク データセット2 つのモザイク データセットを比較します。
String
比較対象外のプロパティ
(オプション)

比較で無視されるプロパティを指定します。

  • バンド数バンド数は無視されます。
  • 範囲範囲は無視されます。
  • 行と列の数カラム数およびロウ数は無視されます。
  • ピクセル タイプピクセル タイプは無視されます。
  • NoDataNoData 値は無視されます。
  • 空間参照空間参照系は無視されます。
  • ピクセル値ピクセル値は無視されます。
  • カラーマップ既存のカラーマップは無視されます。
  • ラスター属性テーブル既存の属性テーブルは無視されます。
  • 統計情報統計情報は無視されます。
  • メタデータメタデータは無視されます。
  • 既存のピラミッド既存のピラミッドは無視されます。
  • 圧縮タイプ圧縮タイプは無視されます。
  • データ ソース タイプデータ ソース タイプは無視されます。
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_DATASET2 つのラスター データセットを比較します。
  • GDB_RASTER_DATASETジオデータベース内の 2 つのラスター データセットを比較します。
  • MOSAIC_DATASET2 つのモザイク データセットを比較します。
String
ignore_option
[ignore_option,...]
(オプション)

比較で無視されるプロパティを指定します。

  • BandCountバンド数は無視されます。
  • Extent範囲は無視されます。
  • Columns And Rowsカラム数およびロウ数は無視されます。
  • Pixel Typeピクセル タイプは無視されます。
  • NoDataNoData 値は無視されます。
  • 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()