Сравнить растры (Управление данными)

Краткая информация

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной исходный растр

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

Raster Layer; Mosaic Layer
Входной тестовый растр

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

Raster Layer; Mosaic Layer
Тип сравнения
(Дополнительный)

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

  • Набор растровых данныхБудут сравниваться два набора растровых данных.
  • Набор растровых данных базы геоданныхБудут сравниваться два набора растровых данных в базе геоданных.
  • Набор данных мозаикиБудут сравниваться два набора данных мозаики.
String
Игнорировать опции
(Дополнительный)

Указывает свойства, которые будут игнорироваться при сравнении.

  • Число каналовБудет игнорироваться число каналов.
  • ЭкстентБудет игнорироваться экстент.
  • Строки и столбцыБудет игнорироваться число столбцов и строк.
  • Тип пикселаБудет игнорироваться тип пиксела.
  • NoDataБудет игнорироваться значение NoData.
  • Пространственная привязкаБудет игнорироваться система пространственной привязки.
  • Значение пикселаБудут игнорироваться значения пикселов.
  • Цветовая картаБудут игнорироваться существующие цветовые карты.
  • Таблица атрибутов растраБудут игнорироваться существующие таблицы атрибутов.
  • СтатистикаБудет игнорироваться статистика.
  • МетаданныеБудут игнорироваться метаданные.
  • Пирамидные слои существуютБудут игнорироваться существующие пирамидные слои.
  • Тип сжатияБудет игнорироваться тип сжатия.
  • Тип источника данныхТип источника данных будет проигнорирован.
String
Продолжить сравнение
(Дополнительный)

Указывает, будет ли останавливаться сравнение, если обнаружено несоответствие.

  • Не отмечено – сравнение остановится при обнаружении несоответствия. Это значение по умолчанию
  • Отмечено – сравнение будет продолжено при обнаружении несоответствия.
Boolean
Выходной файл сравнения
(Дополнительный)

Текстовый файл, содержащий результаты сравнения.

File
Допуск параметра
(Дополнительный)

Допуск, определяющий диапазон, в пределах которого значения рассматриваются как равные. Можно применить ко всем параметрам одинаковый допуск, или к отдельным параметрам могут быть применены различные допуски.

Тип допуска может быть выражен в виде абсолютного значения или дробного.

Если тип допуска выражен дробным значением, допуск для каждого пиксела будет разным, так как каждый пиксел имеет разное значение. Например, если значение допуска равно 0.5, допуск вычисляется следующим образом:

  • Если значение пиксела равно 0.2, допуск будет равен 0.1, так как 0.5 * 0.2 = 0.1.
  • Если значение пиксела равно 3, допуск будет равен 1.5, так как 0.5 * 3 = 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

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

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

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

  • RASTER_DATASETБудут сравниваться два набора растровых данных.
  • GDB_RASTER_DATASETБудут сравниваться два набора растровых данных в базе геоданных.
  • 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Будет игнорироваться тип сжатия.
  • 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.1, так как 0.5 * 0.2 = 0.1.
  • Если значение пиксела равно 3, допуск будет равен 1.5, так как 0.5 * 3 = 1.5.

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()