ArcMap

Comparaison de rasters

Résumé

Analyse les propriétés de deux jeux de données raster ou de deux mosaïques.

Utilisation

  • L'outil renvoie des messages qui affichent le résultat de la comparaison.

  • Les tolérances de paramètre et d'attribut autorisent un certain degré d'écart dans le cadre de vos comparaisons.

Syntaxe

arcpy.management.RasterCompare(in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})
ParamètreExplicationType de données
in_base_raster

Premier jeu de données raster ou première mosaïque à comparer.

Raster Layer; Mosaic Layer
in_test_raster

Second jeu de données raster ou seconde mosaïque à comparer.

Raster Layer; Mosaic Layer
compare_type
(Facultatif)

Spécifie le type des rasters à comparer.

  • RASTER_DATASET —Deux jeux de données raster sont comparés.
  • GDB_RASTER_DATASET —Deux jeux de données raster d'une géodatabase sont comparés.
  • GDB_RASTER_CATALOG —Deux catalogues raster d'une géodatabase sont comparés.
  • MOSAIC_DATASET —Deux jeux de données mosaïque sont comparés.
String
ignore_option
[ignore_option,...]
(Facultatif)

Spécifie les propriétés ignorées dans la comparaison.

  • BandCount —Nombre de canaux à ignorer.
  • Extent —L'étendue est ignorée.
  • Columns And Rows —Le nombre de colonnes et de lignes est ignoré.
  • Pixel Type —Le type de pixel est ignoré.
  • NoData —La valeur NoData est ignorée.
  • Spatial Reference —Le système de référence spatiale est ignoré.
  • Pixel Value —Les valeurs de pixel sont ignorées.
  • Colormap —Les cartes de couleur existantes sont ignorées.
  • Raster Attribute Table —Les tables attributaires existantes sont ignorées.
  • Statistics —Les statistiques sont ignorées.
  • Metadata —Les métadonnées sont ignorées.
  • Pyramids Exist —Les pyramides existantes sont ignorées.
  • Compression Type —Le type de compression est ignoré.
String
continue_compare
(Facultatif)

Indique si la comparaison s'arrête en cas de non concordance.

  • NO_CONTINUE_COMPARE —La comparaison s'arrête en cas de non concordance. Il s’agit de l’option par défaut.
  • CONTINUE_COMPARE —La comparaison se poursuit en cas de non concordance.
Boolean
out_compare_file
(Facultatif)

Fichier texte contenant les résultats de la comparaison.

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

Tolérances qui déterminent la plage dans laquelle les valeurs sont considérées comme égales. Vous pouvez appliquer une même tolérance à tous les paramètres ou appliquer une tolérance différente à chaque paramètre.

Le type de tolérance défini peut être une valeur ou une fraction. Par exemple, si la valeur de base est de 100 et que vous définissez la tolérance de fraction sur 0,00001, la tolérance de comparaison est comprise entre 100 * 0,001 et 100 * 0,00001.

Value Table
attribute_tolerances
[[Field, Tolerance],...]
(Facultatif)

Champs à comparer pour savoir s'ils sont compris dans une tolérance. La valeur de tolérance est exprimée dans les unités de l'attribut.

Value Table
omit_field
[omit_field,...]
(Facultatif)

Le ou les champs à omettre lors de la comparaison.

String

Sortie dérivée

NomExplicationType de données
compare_status

Le statut de la comparaison est défini sur true si aucune différence n'est constatée et sur false dans le cas contraire.

Boolean

Exemple de code

Exemple d'utilisation de l'outil RasterCompare 1 (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de la fonction 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")
Exemple d'utilisation de l'outil RasterCompare 2 (script autonome)

Il s’agit d’un exemple Python d’utilisation de la fonction 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()

Environnements

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes