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

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

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

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

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

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

  • При использовании этого инструмента в Python получите статус сравнения из возвращенного объекта Result, используя положение индекса 1.(result[1]). Значение будет равно 'true', если не было найдено различий, и 'false' – если различия были обнаружены.

    Дополнительные сведения об инструментах в Python

Параметры

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

Набор растровых данных или набор данных мозаики, который будет сравниваться со значением параметра Входной тестовый растр. Значение этого параметра представляет собой данные, которые считаются корректными. Эти базовые данные имеют правильное содержание и информацию.

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

Набор растровых данных или набор данных мозаики, который будет сравниваться со значением параметра Входной исходный растр. Значение этого параметра представляет собой данные, в которые внесены изменения при редактировании или компиляции новой информации.

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

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

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

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

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

Определяет, будет ли продолжаться сравнение после обнаружения первого различия между входными данными.

  • Не отмечено — инструмент прекращает работу после обнаружения первого различия. Это значение по умолчанию
  • Отмечено — инструмент продолжает работу после обнаружения первого различия.

Boolean
Выходной файл сравнения
(Дополнительный)

Выходной файл будет хранить информацию обо всех совпадениях и отличиях входных данных. Это текстовый файл с запятой в качестве разделителя, который можно просмотреть и использовать как таблицу в ArcGIS.

Выходной файл будет хранить информацию обо всех совпадениях и отличиях входных данных. Это текстовый файл с запятой в качестве разделителя, который можно просмотреть и использовать как таблицу в ArcGIS.

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

Набор растровых данных или набор данных мозаики, который будет сравниваться со значением параметра in_test_raster. Значение этого параметра представляет собой данные, которые считаются корректными. Эти базовые данные имеют правильное содержание и информацию.

Raster Layer; Mosaic Layer
in_test_raster

Набор растровых данных или набор данных мозаики, который будет сравниваться со значением параметра in_base_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
(Дополнительный)

Выходной файл будет хранить информацию обо всех совпадениях и отличиях входных данных. Это текстовый файл с запятой в качестве разделителя, который можно просмотреть и использовать как таблицу в ArcGIS.

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
arcpy.management.RasterCompare("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.management.RasterCompare("raster_base.tif","raster_test.tif","RASTER_DATASET",
                                   "","CONTINUE_COMPARE","compareresult.txt","","","")

    ##Compare two Raster Catalog with ignore options
    arcpy.management.RasterCompare("fgdb.gdb/rc_base","fgdb.gdb/rc_test","RASTER_CATALOG",
                                   "IsManaged;Extent","CONTINUE_COMPARE","compareresult2.txt",
                                   "","","DATE")

    ##Compare two Mosaic Dataset with torelance
    arcpy.management.RasterCompare("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: Да

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