ArcMap

Comparar ráster

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ámetroExplicació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_DATASET —Se compararán dos datasets ráster.
  • GDB_RASTER_DATASET —Se compararán dos datasets ráster en una geodatabase.
  • GDB_RASTER_CATALOG —Se compararán dos catálogos de 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.
String
continue_compare
(Opcional)

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

  • NO_CONTINUE_COMPARE —La comparación se detendrá si se detecta alguna falta de coincidencia. Esta es la opción predeterminada.
  • CONTINUE_COMPARE —La 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 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 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()

Entornos

Información de licenciamiento

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

Temas relacionados