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

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

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

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

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

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

  • При использовании этого инструмента в 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: Да

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