Comparaison de rasters (Outils de gestion des données)

Résumé

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é en utilisant 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

Etiqueter	Explication	Type de données
Raster de base en entrée	Raster ou jeu de données mosaïque à comparer à la valeur du paramètre Input Test Raster (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 à comparer à la valeur du paramètre Input Base Raster (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. 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. Etendue—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. Activé—L’outil poursuit la comparaison après la première différence. Décoché—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.	Boolean
Fichier de comparaison en sortie (Facultatif)	Fichier en sortie qui 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. Fichier en sortie qui 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. Colonnes de la table de valeurs : Parameter—There are seven types of parameter tolerances you can adjust. All—The extents, pixel values, minimums, maximums, means, and standard deviations will be compared to determine if they are equal within the specified tolerance. Extent—If the difference of the extents is within the tolerance, they will be considered equal. Pixel values—If the difference of the pixel values is within the tolerance, they will be considered equal. Minimum—If the difference of the minimum values is within the tolerance, they will be considered equal. Maximum—If the difference of the maximum values is within the tolerance, they will be considered equal. Mean—If the difference of the mean values is within the tolerance, they will be considered equal. Standard deviation—If the difference of the standard deviations is within the tolerance, they will be considered equal. Tolerance—Set the tolerance type to a specified value or use that value as a fraction. Type—Set the type of tolerance value for the selected parameter. Fraction—The tolerance value will be a fraction of the value specified. Value—The tolerance value will be the value specified.	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. Colonnes de la table de valeurs : Field—The numeric field that the tolerance will be applied to. Tolerance—The numeric value that determines the range in which attribute values are considered equal. This only applies to numeric field types.	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
Raster de comparaison en sortie (Facultatif)	Raster en sortie comprenant les différences entre les valeurs des paramètres Input Base Raster (Raster de base en entrée) et Input Test Raster (Raster test en entrée).	Raster Dataset

Sortie dérivée

Etiqueter	Explication	Type de données
Comparer le statut	Le statut de comparaison est défini sur `'true'` si aucune différence n’est trouvé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}, {out_compare_raster})

Nom	Explication	Type de données
in_base_raster	Raster ou jeu de données mosaïque à comparer à 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 à comparer à 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. `CONTINUE_COMPARE`—L’outil poursuit la comparaison après la première différence. `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.	Boolean
out_compare_file (Facultatif)	Fichier en sortie qui 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. Colonnes de la table de valeurs : `Parameter`—There are seven types of parameter tolerances you can adjust. `All`—The extents, pixel values, minimums, maximums, means, and standard deviations will be compared to determine if they are equal within the specified tolerance. `Extent`—If the difference of the extents is within the tolerance, they will be considered equal. `Pixel_Value`—If the difference of the pixel values is within the tolerance, they will be considered equal. `Statistics_Minimum`—If the difference of the minimum values is within the tolerance, they will be considered equal. `Statistics_Maximum`—If the difference of the maximum values is within the tolerance, they will be considered equal. `Statistics_Mean`—If the difference of the mean values is within the tolerance, they will be considered equal. `Statistics_Standard_Deviation`—If the difference of the standard deviations is within the tolerance, they will be considered equal. `Tolerance`—Set the tolerance type to a specified value or use that value as a fraction. `Type`—Set the type of tolerance value for the selected parameter. `Fraction`—The tolerance value will be a fraction of the value specified. `Value`—The tolerance value will be the value specified.	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. Colonnes de la table de valeurs : `Field`—The numeric field that the tolerance will be applied to. `Tolerance`—The numeric value that determines the range in which attribute values are considered equal. This only applies to numeric field types.	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
out_compare_raster (Facultatif)	Raster en sortie comprenant les différences entre les valeurs des paramètres `in_base_raster` et `in_test_raster`.	Raster Dataset

Sortie dérivée

Nom	Explication	Type de données
compare_status	Le statut de 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 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 2 d’utilisation de RasterCompare (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

Comparaison de rasters (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes