Comparaison de rasters (Gestion des données)

Synthèse

Compare les propriétés de deux jeux de données raster ou de deux jeux de données mosaïque.

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.

Paramètres

ÉtiquetteExplicationType de données
Raster de base en entrée

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

Raster Layer; Mosaic Layer
Raster test en entrée

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

Raster Layer; Mosaic Layer
Type de comparaison
(Facultatif)

Spécifie le type des rasters à comparer.

  • Jeu de données rasterDeux jeux de données raster sont comparés.
  • Jeu de données raster de géodatabaseDeux jeux de données raster d'une géodatabase sont comparés.
  • MosaïqueDeux jeux de données mosaïque sont comparés.
String
Ignorer les options
(Facultatif)

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

  • Nombre de canauxNombre de canaux à ignorer.
  • ÉtendueL'étendue est ignorée.
  • Colonnes et lignesLe nombre de colonnes et de lignes est ignoré.
  • Type de pixelLe type de pixel est ignoré.
  • NoDataLa valeur NoData est ignorée.
  • Référence spatialeLe système de référence spatiale est ignoré.
  • Valeur du pixelLes valeurs de pixel sont ignorées.
  • Palette de couleursLes cartes de couleur existantes sont ignorées.
  • Table attributaire de rasterLes tables attributaires existantes sont ignorées.
  • StatistiquesLes statistiques sont ignorées.
  • MétadonnéesLes métadonnées sont ignorées.
  • Des pyramides existent.Les pyramides existantes sont ignorées.
  • Type de compressionLe type de compression est ignoré.
  • Type de source de donnéesLe type de source de données est ignoré.
String
Continuer la comparaison
(Facultatif)

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

  • Désactivé : indique si la comparaison s'arrête en cas de non concordance. Il s’agit de l’option par défaut.
  • Activé : indique si la comparaison se poursuit en cas de non concordance.
Boolean
Fichier de comparaison en sortie
(Facultatif)

Fichier texte contenant les résultats de la comparaison.

File
Tolérance des paramètres
(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 peut être une valeur ou une fraction.

Si le type de tolérance est une fraction, la tolérance de chaque pixel est différente car chaque pixel a une valeur différente. Par exemple, si une fraction de tolérance est définie sur 0.5, la tolérance est calculée comme suit :

  • Si un pixel a la valeur 0.2, la tolérance est de 0.1, car 0.5 * 0.2 = 0.1.
  • Si un pixel a la valeur 3, la tolérance est de 1.5, car 0.5 * 3 = 1.5.

Value Table
Tolérance d'attribut
(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
Ignorer des champs
(Facultatif)

Le ou les champs à omettre lors de la comparaison.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Comparer le statut

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

arcpy.management.RasterCompare(in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})
NomExplicationType 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_DATASETDeux jeux de données raster sont comparés.
  • GDB_RASTER_DATASETDeux jeux de données raster d'une géodatabase sont comparés.
  • MOSAIC_DATASETDeux 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.

  • BandCountNombre de canaux à ignorer.
  • ExtentL'étendue est ignorée.
  • Columns And RowsLe nombre de colonnes et de lignes est ignoré.
  • Pixel TypeLe type de pixel est ignoré.
  • NoDataLa valeur NoData est ignorée.
  • Spatial ReferenceLe système de référence spatiale est ignoré.
  • Pixel ValueLes valeurs de pixel sont ignorées.
  • ColormapLes cartes de couleur existantes sont ignorées.
  • Raster Attribute TableLes tables attributaires existantes sont ignorées.
  • StatisticsLes statistiques sont ignorées.
  • MetadataLes métadonnées sont ignorées.
  • Pyramids ExistLes pyramides existantes sont ignorées.
  • Compression TypeLe type de compression est ignoré.
  • Data Source TypeLe type de source de données est ignoré.
String
continue_compare
(Facultatif)

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

  • NO_CONTINUE_COMPARELa comparaison s'arrête en cas de non concordance. Il s’agit de l’option par défaut.
  • CONTINUE_COMPARELa 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 peut être une valeur ou une fraction.

Si le type de tolérance est une fraction, la tolérance de chaque pixel est différente car chaque pixel a une valeur différente. Par exemple, si une fraction de tolérance est définie sur 0.5, la tolérance est calculée comme suit :

  • Si un pixel a la valeur 0.2, la tolérance est de 0.1, car 0.5 * 0.2 = 0.1.
  • Si un pixel a la valeur 3, la tolérance est de 1.5, car 0.5 * 3 = 1.5.

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 obtenue

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