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.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster base de entrada

El primer dataset ráster o de mosaico que se va a comparar.

Raster Layer; Mosaic Layer
Ráster test de entrada

El segundo dataset ráster o de mosaico que se va a comparar con el primero.

Raster Layer; Mosaic Layer
Comparar tipo
(Opcional)

Especifica el tipo de rásteres que se compararán.

  • Dataset rásterSe compararán dos datasets ráster.
  • Dataset ráster de geodatabaseSe compararán dos datasets ráster en una geodatabase.
  • dataset de mosaicoSe compararán dos datasets de mosaico.
String
Ignorar opciones
(Opcional)

Especifica las propiedades que se ignorarán en la comparación.

  • Recuento de bandasSe ignorará el número de bandas.
  • ExtensiónSe ignorará la extensión.
  • Columnas y filasSe ignorará el número de columnas y filas.
  • Tipo de píxelSe ignorará el tipo de píxel.
  • NoDataSe ignorará el valor NoData.
  • Referencia espacialSe ignorará el sistema de referencia espacial.
  • Valor de píxelSe ignorarán los valores de píxel.
  • Mapa de colorSe ignorarán los mapas de color existentes.
  • Tablas de atributos de rásterSe ignorarán las tablas de atributos existentes.
  • EstadísticasSe ignorarán las estadísticas.
  • MetadatosSe ignorarán los metadatos.
  • Existen pirámidesSe ignorarán las pirámides existentes.
  • Tipo de compresiónSe ignorará el tipo de compresión.
  • Tipo de fuente de datosSe ignorará el tipo de fuente de datos.
String
Continuar comparación
(Opcional)

Especifica si la comparación se detendrá si se detecta alguna falta de coincidencia.

  • Desactivado: la comparación se detendrá si se detecta alguna falta de coincidencia. Esta es la opción predeterminada.
  • Activado: la comparación continuará si se detecta una falta de coincidencia.
Boolean
Archivo de comparación de salida
(Opcional)

Un archivo de texto que contiene los resultados de la comparación.

File
Tolerancia de parámetro
(Opcional)

Las tolerancias que determinan el rango en el cual los valores se consideran 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)

Los campos que se compararán para determinar si están dentro de una tolerancia. El valor de tolerancia es un valor expresado en las unidades del atributo.

Value Table
Omitir campos
(Opcional)

El campo o los campos que se omitirán durante la comparación.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Estado de comparación

El estado de comparación será true si no se encuentra ninguna diferencia; será false si se encuentran diferencias.

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})
NombreExplicaciónTipo 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)

Especifica el tipo de rásteres que se compararán.

  • RASTER_DATASETSe compararán dos datasets ráster.
  • GDB_RASTER_DATASETSe compararán dos datasets ráster en una geodatabase.
  • MOSAIC_DATASETSe compararán dos datasets de mosaico.
String
ignore_option
[ignore_option,...]
(Opcional)

Especifica las propiedades que se ignorarán en la comparación.

  • BandCountSe ignorará el número de bandas.
  • ExtentSe ignorará la extensión.
  • Columns And RowsSe ignorará el número de columnas y filas.
  • Pixel TypeSe ignorará el tipo de píxel.
  • NoDataSe ignorará el valor NoData.
  • Spatial ReferenceSe ignorará el sistema de referencia espacial.
  • Pixel ValueSe ignorarán los valores de píxel.
  • ColormapSe ignorarán los mapas de color existentes.
  • Raster Attribute TableSe ignorarán las tablas de atributos existentes.
  • StatisticsSe ignorarán las estadísticas.
  • MetadataSe ignorarán los metadatos.
  • Pyramids ExistSe ignorarán las pirámides existentes.
  • Compression TypeSe ignorará el tipo de compresión.
  • Data Source TypeSe ignorará el tipo de fuente de datos.
String
continue_compare
(Opcional)

Especifica si la comparación se detendrá si se detecta alguna falta de coincidencia.

  • NO_CONTINUE_COMPARELa comparación se detendrá si se detecta alguna falta de coincidencia. Esta es la opción predeterminada.
  • CONTINUE_COMPARELa comparación continuará si se detecta una falta de coincidencia.
Boolean
out_compare_file
(Opcional)

Un archivo de texto que contiene los resultados de la comparación.

File
parameter_tolerances
[[Parameter, Tolerance, Type],...]
(Opcional)

Las tolerancias que determinan el rango en el cual los valores se consideran 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)

Los campos que se compararán para determinar 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

NombreExplicaciónTipo de datos
compare_status

El estado de comparación será true si no se encuentra ninguna diferencia; será false si se encuentran 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
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 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.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()