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.

• Lorsque vous utilisez cet outil dans Python, vous obtenez le statut de la comparaison à partir de l’objet Result renvoyé à l’aide de la position d’index 1.(result[1]). La valeur est 'true' si aucune différence n’est trouvée et 'false' dans le cas contraire.

  En savoir plus sur l’utilisation des outils dans Python

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster de base en entrée	Raster ou jeu de données mosaïque qui sera comparé à la valeur du paramètre Raster test en entrée. Cette valeur de paramètre correspond aux données que vous avez déclarées comme valides. Ces données de base comportent le contenu et les informations appropriés.	Raster Layer; Mosaic Layer
Raster test en entrée	Raster ou jeu de données mosaïque qui sera comparé à la valeur du paramètre Raster de base en entrée. Cette valeur de paramètre correspond aux données que vous avez modifiées en mettant à jour ou en compilant de nouvelles informations.	Raster Layer; Mosaic Layer
Type de comparaison (Facultatif)	Spécifie le type des rasters à comparer. Jeu de données raster—Deux jeux de données raster sont comparés. Jeu de données raster de géodatabase—Deux jeux de données raster d'une géodatabase sont comparés. Jeu de données mosaïque—Deux 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 canaux—Nombre de canaux à ignorer. Étendue—L'étendue est ignorée. Colonnes et lignes—Le nombre de colonnes et de lignes est ignoré. Type de pixel—Le type de pixel est ignoré. NoData—La valeur NoData est ignorée. Référence spatiale—Le système de référence spatiale est ignoré. Valeur du pixel—Les valeurs de pixel sont ignorées. Palette de couleurs—Les cartes de couleur existantes sont ignorées. Table attributaire de raster—Les tables attributaires existantes sont ignorées. Statistiques—Les statistiques sont ignorées. Métadonnées—Les métadonnées sont ignorées. Des pyramides existent.—Les pyramides existantes sont ignorées. Type de compression—Le type de compression est ignoré. Type de source de données—Le type de source de données est ignoré.	String
Continuer la comparaison (Facultatif)	Indique si la comparaison continue une fois qu’elle a détecté la première différence entre les entrées. Désactivé : l’outil arrête la comparaison dès qu’une première différence est rencontrée. Il s’agit de l’option par défaut. Activé : l’outil poursuit la comparaison après la première différence.	Boolean
Fichier de comparaison en sortie (Facultatif)	Le fichier en sortie contient toutes les similitudes et toutes les différences trouvées entre les entrées. Il s'agit d'un fichier texte délimité par des virgules qui peut être visualisé et utilisé comme une table dans ArcGIS. Le fichier en sortie contient toutes les similitudes et toutes les différences trouvées entre les entrées. Il s'agit d'un fichier texte délimité par des virgules qui peut être visualisé et utilisé comme une table dans ArcGIS.	File
Tolérance des paramètres (Facultatif)	Tolérances qui déterminent la plage dans laquelle les valeurs seront 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)	Valeur numérique déterminant la plage dans laquelle les valeurs attributaires sont considérées comme égales. Ce paramètre s’applique uniquement aux champs numériques.	Value Table
Ignorer des champs (Facultatif)	Le ou les champs à omettre lors de la comparaison. Les définitions et valeurs tabulaires de ces champs seront ignorées.	String

Sortie obtenue

Étiquette	Explication	Type de données
Comparer le statut	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.	Boolean

Python

arcpy.management.RasterCompare(in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})

Nom	Explication	Type de données
in_base_raster	Raster ou jeu de données mosaïque qui sera comparé à la valeur du paramètre in_test_raster. Cette valeur de paramètre correspond aux données que vous avez déclarées comme valides. Ces données de base comportent le contenu et les informations appropriés.	Raster Layer; Mosaic Layer
in_test_raster	Raster ou jeu de données mosaïque qui sera comparé à la valeur du paramètre in_base_raster. Cette valeur de paramètre correspond aux données que vous avez modifiées en mettant à jour ou en compilant de nouvelles informations.	Raster Layer; Mosaic Layer
compare_type (Facultatif)	Spécifie le type des rasters à comparer. RASTER_DATASET—Deux jeux de données raster sont comparés. GDB_RASTER_DATASET—Deux jeux de données raster d'une géodatabase sont comparés. MOSAIC_DATASET—Deux 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. BandCount—Nombre de canaux à ignorer. Extent—L'étendue est ignorée. Columns And Rows—Le nombre de colonnes et de lignes est ignoré. Pixel Type—Le type de pixel est ignoré. NoData—La valeur NoData est ignorée. Spatial Reference—Le système de référence spatiale est ignoré. Pixel Value—Les valeurs de pixel sont ignorées. Colormap—Les cartes de couleur existantes sont ignorées. Raster Attribute Table—Les tables attributaires existantes sont ignorées. Statistics—Les statistiques sont ignorées. Metadata—Les métadonnées sont ignorées. Pyramids Exist—Les pyramides existantes sont ignorées. Compression Type—Le type de compression est ignoré. Data Source Type—Le type de source de données est ignoré.	String
continue_compare (Facultatif)	Indique si la comparaison continue une fois qu’elle a détecté la première différence entre les entrées. NO_CONTINUE_COMPARE—L’outil arrête la comparaison dès qu’une première différence est rencontrée. Il s’agit de l’option par défaut. CONTINUE_COMPARE—L’outil poursuit la comparaison après la première différence.	Boolean
out_compare_file (Facultatif)	Le fichier en sortie contient toutes les similitudes et toutes les différences trouvées entre les entrées. Il s'agit d'un fichier texte délimité par des virgules qui peut être visualisé et utilisé comme une table dans ArcGIS.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Facultatif)	Tolérances qui déterminent la plage dans laquelle les valeurs seront 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)	Valeur numérique déterminant la plage dans laquelle les valeurs attributaires sont considérées comme égales. Ce paramètre s’applique uniquement aux champs numériques.	Value Table
omit_field [omit_field,...] (Facultatif)	Le ou les champs à omettre lors de la comparaison. Les définitions et valeurs tabulaires de ces champs seront ignorées.	String

Sortie obtenue

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.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction RasterCompare (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de la fonction RasterCompare.

import arcpy
arcpy.management.RasterCompare("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.management.RasterCompare("raster_base.tif","raster_test.tif","RASTER_DATASET",
                                   "","CONTINUE_COMPARE","compareresult.txt","","","")

    ##Compare two Raster Catalog with ignore options
    arcpy.management.RasterCompare("fgdb.gdb/rc_base","fgdb.gdb/rc_test","RASTER_CATALOG",
                                   "IsManaged;Extent","CONTINUE_COMPARE","compareresult2.txt",
                                   "","","DATE")

    ##Compare two Mosaic Dataset with torelance
    arcpy.management.RasterCompare("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