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 autorisent un certain degré d'écart dans le cadre de vos comparaisons.

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 quel paramètre Ignorer les options est valide. BandCount —Ignorez le nombre de canaux. Extent —Ignorez l'étendue. Columns And Rows —Ignorez le nombre de colonnes et de lignes. Pixel Type —Ignorez le type de pixel. NoData —Ignorez la valeur NoData. Spatial Reference —Ignorez le système de référence spatiale. Pixel Value —Ignorez les valeurs des pixels. Colormap —Ignorez la disponibilité d'une palette de couleurs. Raster Attribute Table —Ignorez la disponibilité d'une table attributaire. Statistics —Ignorez les statistiques. Metadata —Ignorez les métadonnées. Pyramids Exist —Ignorez la disponibilité de pyramides. Compression Type —Ignorez le type de compression.	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. Il s'agit de l'option par défaut. 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 cette valeur sous forme de 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 calculée comme suit : 100 * 0,00001 = 0,001. Vous pouvez ajuster sept types de tolérance de 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)	Le ou les champs à omettre lors de la comparaison.	String

Exemple de code

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

Il s'agit d'un exemple Python d'utilisation de l'outil 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 l'outil 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