Comparar rásteres (Administración de datos)

Resumen

Compara las propiedades de dos datasets ráster o datasets de mosaico.

Uso

• La herramienta devuelve mensajes que muestran el resultado de la comparación.

• Las tolerancias de atributo y parámetro permiten que las comparaciones tengan una cantidad específica de desviación.

Sintaxis

arcpy.management.RasterCompare(in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})

Parámetro	Explicación	Tipo de datos
in_base_raster	El primer dataset ráster o de mosaico que se va a comparar.	Raster Layer; Mosaic Layer
in_test_raster	El segundo dataset ráster o de mosaico que se va a comparar con el primero.	Raster Layer; Mosaic Layer
compare_type (Opcional)	El tipo de ráster que se va a comparar. RASTER_DATASET —Compara dos datasets ráster. GDB_RASTER_DATASET —Compara dos datasets ráster en una geodatabase. MOSAIC_DATASET —Compara dos datasets de mosaico.	String
ignore_option [ignore_option,...] (Opcional)	Las propiedades que no desea incluir en la comparación. Para determinar la lista completa de propiedades, abra el cuadro de diálogo de la herramienta y visualice la lista de valores para el parámetro Ignorar opciones. La herramienta Comparar tipo determinará qué valores de Opciones de Ignorar son válidas. BandCount —Ignorar número de bandas. Extent —Ignorar la extensión. Columns And Rows —Ignorar el número de columnas y filas. Pixel Type —Ignorar el tipo de píxel. NoData —Ignorar el valor NoData. Spatial Reference —Ignorar el sistema de referencia espacial. Pixel Value —Ignorar los valores de píxel. Colormap —Ignorar si existe un mapa de color. Raster Attribute Table —Ignorar si existe una tabla de atributos. Statistics —Ignorar las estadísticas. Metadata —Ignorar cualquier metadato. Pyramids Exist —Ignorar si existen pirámides. Compression Type —Ignorar el tipo de compresión.	String
continue_compare (Opcional)	Si se detecta alguna falta de coincidencia, detiene la comparación. NO_CONTINUE_COMPARE —Detiene la comparación si se detecta alguna falta de coincidencia. Esta es la opción predeterminada. CONTINUE_COMPARE —Continúa comparando los datasets ráster si se detecta una falta de coincidencia.	Boolean
out_compare_file (Opcional)	Crea un archivo de texto que contiene los resultados de la comparación.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Opcional)	Incluya algo de flexibilidad al comparar la precisión de los parámetros. Puede aplicar la misma tolerancia a todos los parámetros, o bien puede aplicar tolerancias distintas a parámetros individuales. El tipo de tolerancia se puede definir como un valor o como una fracción. Por ejemplo, si el valor base es 100 y se establece una tolerancia de fracción en 0,00001, la tolerancia de comparación será 100 * 0,001 (100 * 0,00001).	Value Table
attribute_tolerances [[Field, Tolerance],...] (Opcional)	Los campos que desea comparar para ver si están dentro de una tolerancia. El valor de tolerancia es un valor expresado en las unidades del atributo.	Value Table
omit_field [omit_field,...] (Opcional)	El campo o los campos que se omitirán durante la comparación.	String

Salida derivada

Nombre	Explicación	Tipo de datos
compare_status	El estado de comparación será 'true' si no se encuentra ninguna diferencia y 'false' si se detectan diferencias.	Booleano

Muestra de código

Ejemplo 1 de RasterCompare (ventana de Python)

Esta es una muestra de Python para la herramienta 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")

Ejemplo 2 de RasterCompare (script independiente)

Esta es una muestra de Python para la herramienta 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()

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí