Comparar ráster (Administración de datos)

Resumen

Compara las propiedades de dos datasets ráster o dos 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.

• Cuando utilice esta herramienta en Python, obtenga el estado de la comparación a partir del objeto Result devuelto mediante el empleo de la posición de índice de 1 (result[1]). El valor será 'true' si no se encuentra ninguna diferencia y 'false' si se detecta alguna diferencia.

  Más información sobre el uso de herramientas en Python

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster base de entrada	Dataset de mosaico o ráster que se comparará con el valor del parámetro Ráster test de entrada. El valor de este parámetro son los datos que ha declarado válidos. Estos datos base tienen el contenido y la información correctos.	Raster Layer; Mosaic Layer
Ráster test de entrada	Dataset de mosaico o ráster que se comparará con el valor del parámetro Ráster base de entrada. El valor de este parámetro son los datos que modificó al editar o compilar información nueva.	Raster Layer; Mosaic Layer
Comparar tipo (Opcional)	Especifica el tipo de rásteres que se compararán. Dataset ráster—Se compararán dos datasets ráster. Dataset ráster de geodatabase—Se compararán dos datasets ráster en una geodatabase. dataset de mosaico—Se compararán dos datasets de mosaico.	String
Ignorar opciones (Opcional)	Especifica las propiedades que se ignorarán en la comparación. Recuento de bandas—Se ignorará el número de bandas. Extensión—Se ignorará la extensión. Columnas y filas—Se ignorará el número de columnas y filas. Tipo de píxel—Se ignorará el tipo de píxel. NoData—Se ignorará el valor NoData. Referencia espacial—Se ignorará el sistema de referencia espacial. Valor de píxel—Se ignorarán los valores de píxel. Mapa de color—Se ignorarán los mapas de color existentes. Tablas de atributos de ráster—Se ignorarán las tablas de atributos existentes. Estadísticas—Se ignorarán las estadísticas. Metadatos—Se ignorarán los metadatos. Existen pirámides—Se ignorarán las pirámides existentes. Tipo de compresión—Se ignorará el tipo de compresión. Tipo de fuente de datos—Se ignorará el tipo de fuente de datos.	String
Continuar comparación (Opcional)	Especifica si la comparación continuará tras encontrar la primera diferencia entre las entradas. Desactivado: la herramienta se detendrá tras encontrar la primera diferencia. Esta es la opción predeterminada. Activado: la herramienta continuará tras encontrar la primera diferencia.	Boolean
Archivo de comparación de salida (Opcional)	Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS. Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.	File
Tolerancia de parámetro (Opcional)	Las tolerancias que determinan el rango en el cual los valores se considerarán iguales. Puede aplicar la misma tolerancia a todos los parámetros, o bien puede aplicar tolerancias distintas a parámetros individuales. El tipo de tolerancia puede ser un valor o una fracción. Si el tipo de tolerancia es una fracción, la tolerancia para cada píxel será diferente, ya que cada píxel tiene un valor diferente. Por ejemplo, si una fracción de tolerancia se establece en 0,5, la tolerancia se calculará de la siguiente manera: Si un píxel tiene un valor de 0,2, la tolerancia será 0,1, dado que 0,5 * 0,2 = 0,1. Si un píxel tiene un valor de 3, la tolerancia será 1,5, dado que 0,5 * 3 = 1,5.	Value Table
Tolerancia de atributo (Opcional)	Valor numérico que determinará el rango en el cual los valores de atributos se consideran iguales. Este parámetro solo se aplica a los tipos de campos numéricos.	Value Table
Omitir campos (Opcional)	El campo o los campos que se omitirán durante la comparación. Se ignorarán las definiciones de campo y los valores tabulares para estos campos.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Estado de comparación	El estado de comparación será 'true' cuando no se encuentren diferencias y 'false' cuando se encuentren diferencias.	Boolean

Python

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

Nombre	Explicación	Tipo de datos
in_base_raster	Dataset de mosaico o ráster que se comparará con el valor del parámetro in_test_raster. El valor de este parámetro son los datos que ha declarado válidos. Estos datos base tienen el contenido y la información correctos.	Raster Layer; Mosaic Layer
in_test_raster	Dataset de mosaico o ráster que se comparará con el valor del parámetro in_base_raster. El valor de este parámetro son los datos que modificó al editar o compilar información nueva.	Raster Layer; Mosaic Layer
compare_type (Opcional)	Especifica el tipo de rásteres que se compararán. RASTER_DATASET—Se compararán dos datasets ráster. GDB_RASTER_DATASET—Se compararán dos datasets ráster en una geodatabase. MOSAIC_DATASET—Se compararán dos datasets de mosaico.	String
ignore_option [ignore_option,...] (Opcional)	Especifica las propiedades que se ignorarán en la comparación. BandCount—Se ignorará el número de bandas. Extent—Se ignorará la extensión. Columns And Rows—Se ignorará el número de columnas y filas. Pixel Type—Se ignorará el tipo de píxel. NoData—Se ignorará el valor NoData. Spatial Reference—Se ignorará el sistema de referencia espacial. Pixel Value—Se ignorarán los valores de píxel. Colormap—Se ignorarán los mapas de color existentes. Raster Attribute Table—Se ignorarán las tablas de atributos existentes. Statistics—Se ignorarán las estadísticas. Metadata—Se ignorarán los metadatos. Pyramids Exist—Se ignorarán las pirámides existentes. Compression Type—Se ignorará el tipo de compresión. Data Source Type—Se ignorará el tipo de fuente de datos.	String
continue_compare (Opcional)	Especifica si la comparación continuará tras encontrar la primera diferencia entre las entradas. NO_CONTINUE_COMPARE—La herramienta se detendrá tras encontrar la primera diferencia. Esta es la opción predeterminada. CONTINUE_COMPARE—La herramienta continuará tras encontrar la primera diferencia.	Boolean
out_compare_file (Opcional)	Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Opcional)	Las tolerancias que determinan el rango en el cual los valores se considerarán iguales. Puede aplicar la misma tolerancia a todos los parámetros, o bien puede aplicar tolerancias distintas a parámetros individuales. El tipo de tolerancia puede ser un valor o una fracción. Si el tipo de tolerancia es una fracción, la tolerancia para cada píxel será diferente, ya que cada píxel tiene un valor diferente. Por ejemplo, si una fracción de tolerancia se establece en 0,5, la tolerancia se calculará de la siguiente manera: Si un píxel tiene un valor de 0,2, la tolerancia será 0,1, dado que 0,5 * 0,2 = 0,1. Si un píxel tiene un valor de 3, la tolerancia será 1,5, dado que 0,5 * 3 = 1,5.	Value Table
attribute_tolerances [[Field, {Tolerance}],...] (Opcional)	Valor numérico que determinará el rango en el cual los valores de atributos se consideran iguales. Este parámetro solo se aplica a los tipos de campos numéricos.	Value Table
omit_field [omit_field,...] (Opcional)	El campo o los campos que se omitirán durante la comparación. Se ignorarán las definiciones de campo y los valores tabulares para estos campos.	String

Salida derivada

Nombre	Explicación	Tipo de datos
compare_status	El estado de comparación será 'true' cuando no se encuentren diferencias y 'false' cuando se encuentren diferencias.	Boolean

Muestra de código

Ejemplo 1 de RasterCompare (ventana de Python)

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

Ejemplo 2 de RasterCompare (script independiente)

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

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal