Comparaison de rasters (Gestion des données)

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è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. 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)	Intégrez une certaine flexibilité lors de la comparaison des niveaux de précision des paramètres. Vous pouvez appliquer une même tolérance à tous les paramètres ou bien 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 sera entre 100 * 0,001 et (100 * 0,00001).	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

Sortie dérivée

Nom	Explication	Type de données
compare_status	Le statut de la comparaison est défini sur 'true' si aucune différence n'est trouvée et sur 'false' dans le cas contraire.	Booléen

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

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