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è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)

Type de raster à comparer.

  • RASTER_DATASETComparez deux jeux de données raster.
  • GDB_RASTER_DATASETComparez deux jeux de données raster dans une géodatabase.
  • MOSAIC_DATASETComparez 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.

  • BandCountIgnorez le nombre de canaux.
  • ExtentIgnorez l'étendue.
  • Columns And RowsIgnorez le nombre de colonnes et de lignes.
  • Pixel TypeIgnorez le type de pixel.
  • NoDataIgnorez la valeur NoData.
  • Spatial ReferenceIgnorez le système de référence spatiale.
  • Pixel ValueIgnorez les valeurs des pixels.
  • ColormapIgnorez la disponibilité d'une palette de couleurs.
  • Raster Attribute TableIgnorez la disponibilité d'une table attributaire.
  • StatisticsIgnorez les statistiques.
  • MetadataIgnorez les métadonnées.
  • Pyramids ExistIgnorez la disponibilité de pyramides.
  • Compression TypeIgnorez le type de compression.
String
continue_compare
(Facultatif)

En cas de non-concordance, arrêtez la comparaison.

  • NO_CONTINUE_COMPAREArrêtez la comparaison en cas de non-concordance. Il s’agit de l’option par défaut.
  • CONTINUE_COMPAREContinuez à 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

NomExplicationType 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()

Informations de licence

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

Rubriques connexes