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

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

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

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

Инструмент выдает сообщение с результатами сравнения.
Допуски параметров и атрибутов позволяют сравнениям иметь заданную величину отклонения.
При использовании этого инструмента в 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. Столбцы таблицы значений: Parameter–There are seven types of parameter tolerances you can adjust. All–The extents, pixel values, minimums, maximums, means, and standard deviations will be compared to determine if they are equal within the specified tolerance. Extent–If the difference of the extents is within the tolerance, they will be considered equal. Pixel values–If the difference of the pixel values is within the tolerance, they will be considered equal. Minimum–If the difference of the minimum values is within the tolerance, they will be considered equal. Maximum–If the difference of the maximum values is within the tolerance, they will be considered equal. Mean–If the difference of the mean values is within the tolerance, they will be considered equal. Standard deviation–If the difference of the standard deviations is within the tolerance, they will be considered equal. Tolerance–Set the tolerance type to a specified value or use that value as a fraction. Type–Set the type of tolerance value for the selected parameter. Fraction–The tolerance value will be a fraction of the value specified. Value–The tolerance value will be the value specified.	Value Table
Допуск атрибутов (Дополнительный)	Числовое значение, задающее диапазон, в котором значения будут считаться идентичными. Этот параметр используется только для числовых полей. Столбцы таблицы значений: Field–The numeric field that the tolerance will be applied to. Tolerance–The numeric value that determines the range in which attribute values are considered equal. This only applies to numeric field types.	Value Table
Пропустить поля (Дополнительный)	Одно или несколько полей, которые будут пропущены в процессе сравнения. Свойства и значения данных полей будут проигнорированы.	String
Выходной растр сравнения (Дополнительный)	Выходной растр, содержащий различия между значениями параметров Входного исходного растра и Входного тестового растра.	Raster Dataset

Производные выходные данные

Подпись	Объяснение	Тип данных
Статус сравнения	Статус сравнения будет `'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}, {out_compare_raster})

Имя	Объяснение	Тип данных
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 (Дополнительный)	Определяет, будет ли продолжаться сравнение после обнаружения первого различия между входными данными. `CONTINUE_COMPARE`–Инструмент продолжает работу после обнаружения первого различия. `NO_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. Столбцы таблицы значений: `Parameter`–There are seven types of parameter tolerances you can adjust. `All`–The extents, pixel values, minimums, maximums, means, and standard deviations will be compared to determine if they are equal within the specified tolerance. `Extent`–If the difference of the extents is within the tolerance, they will be considered equal. `Pixel_Value`–If the difference of the pixel values is within the tolerance, they will be considered equal. `Statistics_Minimum`–If the difference of the minimum values is within the tolerance, they will be considered equal. `Statistics_Maximum`–If the difference of the maximum values is within the tolerance, they will be considered equal. `Statistics_Mean`–If the difference of the mean values is within the tolerance, they will be considered equal. `Statistics_Standard_Deviation`–If the difference of the standard deviations is within the tolerance, they will be considered equal. `Tolerance`–Set the tolerance type to a specified value or use that value as a fraction. `Type`–Set the type of tolerance value for the selected parameter. `Fraction`–The tolerance value will be a fraction of the value specified. `Value`–The tolerance value will be the value specified.	Value Table
attribute_tolerances [[Field, {Tolerance}],...] (Дополнительный)	Числовое значение, задающее диапазон, в котором значения будут считаться идентичными. Этот параметр используется только для числовых полей. Столбцы таблицы значений: `Field`–The numeric field that the tolerance will be applied to. `Tolerance`–The numeric value that determines the range in which attribute values are considered equal. This only applies to numeric field types.	Value Table
omit_field [omit_field,...] (Дополнительный)	Одно или несколько полей, которые будут пропущены в процессе сравнения. Свойства и значения данных полей будут проигнорированы.	String
out_compare_raster (Дополнительный)	Выходной растр, содержащий различия между значениями параметров `in_base_raster` и `in_test_raster`.	Raster Dataset

Производные выходные данные

Имя	Объяснение	Тип данных
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: Да

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

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

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

Параметры

Производные выходные данные

Параметры среды

Информация о лицензировании

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