Comparaison de rasters

Résumé

Analysez 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 permettent de définir une marge donnée pour vos comparaisons.

• Pour la syntaxe Python, vous devez ouvrir la boîte de dialogue de l'outil pour afficher une liste de valeurs pour le paramètre Ignorer les options. Le Type de comparaison détermine le paramètre Ignorer les options qui est valide.

Syntaxe

RasterCompare_management (in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})

Paramètre	Explication	Type 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)	Type de raster à comparer. RASTER_DATASET —Comparez deux jeux de données raster. GDB_RASTER_DATASET —Comparez deux jeux de données raster dans une géodatabase. GDB_RASTER_CATALOG —Comparez deux catalogues d'images dans une géodatabase. MOSAIC_DATASET —Comparez deux mosaïques.	String
ignore_option [ignore_option,...] (Facultatif)	Propriétés que vous ne voulez pas inclure dans la comparaison. Pour connaître la liste complète des propriétés, ouvrez la boîte de dialogue de l'outil et affichez la liste des valeurs du paramètre Ignorer les options. Le Type de comparaison détermine le paramètre Ignorer les options qui est valide.	String
continue_compare (Facultatif)	En cas de non-concordance, arrêtez la comparaison. NO_CONTINUE_COMPARE —Arrêtez la comparaison en cas de non-concordance. CONTINUE_COMPARE —Continuez à comparer les jeux de données raster en cas de non-concordance.	Boolean
out_compare_file (Facultatif)	Créez un fichier texte contenant les résultats de la comparaison.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Facultatif)	Autorisez une certaine marge au niveau de la précision lors de la comparaison des paramètres. Vous pouvez préciser différentes tolérances pour chaque paramètre. Définissez le type de tolérance sur la valeur que vous entrez ou utilisez une fraction de cette valeur. Par exemple, si votre 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 calculée comme suit : 100 * 0,00001 = 0,001 Vous pouvez ajuster sept types de tolérances des paramètres. All —Comparez les étendues, les valeurs de pixels, les valeurs minimales et maximales, les moyennes et les écarts types pour voir s'ils sont égaux dans les limites de la tolérance spécifiée. Extent —Si la différence des étendues est constatée dans les limites de tolérance, considérez-les comme égales. Pixel_Value —Si la différence des valeurs de pixels est constatée dans les limites de tolérance, considérez-les comme égales. Statistics_Minimum —Si la différence des valeurs minimales est constatée dans les limites de tolérance, considérez-les comme égales. Statistics_Maximum —Si la différence des valeurs maximales est constatée dans les limites de tolérance, considérez-les comme égales. Statistics_Mean —Si la différence des valeurs moyennes est constatée dans les limites de tolérance, considérez-les comme égales. Statistics_Standard_Deviation —Si la différence des écarts-types est constatée dans les limites de tolérance, considérez-les comme égaux.	Value Table
attribute_tolerances [[Field, Tolerance],...] (Facultatif)	Les champs que vous voulez 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)	Liste des champs à ne pas comparer.	String

Exemple de code

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

Ceci est un exemple Python pour 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)

Ceci est un exemple Python pour 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

• Espace de travail courant
• Espace de travail temporaire

Informations de licence

• ArcGIS Desktop Basic: Oui
• ArcGIS Desktop Standard: Oui
• ArcGIS Desktop Advanced: Oui