ArcMap

Сравнить растры

Сводка

Сравнивает свойства двух наборов растровых данных или данных мозаики.

Использование

  • Инструмент выдает сообщение с результатами сравнения.

  • Допуски параметров и атрибутов позволяют проводить гибкое сравнение.

Синтаксис

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

Второй из наборов растровых данных или данных мозаики, который будет сравниваться с первым.

Raster Layer; Mosaic Layer
compare_type
(Дополнительный)

Задает тип сравниваемых растров.

  • RASTER_DATASET —Будут сравниваться два набора растровых данных.
  • GDB_RASTER_DATASET —Будут сравниваться два набора растровых данных в базе геоданных.
  • GDB_RASTER_CATALOG —Будут сравниваться два каталога растров в базе геоданных.
  • MOSAIC_DATASET —Будут сравниваться два набора данных мозаики.
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)

Пример скрипта Python для функции RasterCompare.

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 (автономный скрипт)

Пример скрипта Python для функции RasterCompare.

##====================================
##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: Да

Связанные разделы