Raster-Vergleich (Data Management Tools)

Zusammenfassung

Vergleicht die Eigenschaften von zwei Raster-Datasets oder zwei Mosaik-Datasets.

Verwendung

Mit dem Werkzeug werden Meldungen mit den Vergleichsergebnissen zurückgegeben.
Aufgrund der Parameter- und Attributtoleranzen weisen die Vergleiche eine bestimmte Abweichung auf.
Bei Verwendung des Werkzeugs in Python können Sie den Vergleichsstatus aus dem zurückgegebenen Objekt Result unter Verwendung der Indexposition 1 abrufen.(result[1]). Der Wert lautet 'true', wenn keine Unterschiede gefunden werden, und 'false', wenn Unterschiede festgestellt werden.

Weitere Informationen zur Verwendung von Werkzeugen in Python

Beschriftung	Erläuterung	Datentyp
Eingabe-Basis-Raster	Das Raster- oder Mosaik-Dataset, das mit dem Parameterwert Eingabe-Test-Raster verglichen wird. Bei diesem Parameterwert handelt es sich um die Daten, die Sie als gültig deklariert haben. Die Basisdaten verfügen über den richtigen Inhalt und die richtigen Informationen.	Raster Layer; Mosaic Layer
Eingabe-Test-Raster	Das Raster- oder Mosaik-Dataset, das mit dem Parameterwert Eingabe-Basis-Raster verglichen wird. Bei diesem Parameterwert handelt es sich um Daten, an denen Sie durch Bearbeiten oder Kompilieren neuer Informationen Änderungen vorgenommen haben.	Raster Layer; Mosaic Layer
Vergleichstyp (Optional)	Gibt den Typ der Raster an, das verglichen wird. Raster-Dataset—Es werden zwei Raster-Datasets verglichen. Geodatabase-Raster-Dataset—Es werden zwei Raster-Datasets in einer Geodatabase verglichen. Mosaik-Dataset—Es werden zwei Mosaik-Datasets verglichen.	String
Ausschlussoptionen (Optional)	Gibt die Eigenschaften an, die beim Vergleich ignoriert werden sollen. Bandanzahl—Die Anzahl der Bänder wird ignoriert. Ausdehnung—Die Ausdehnung wird ignoriert. Spalten und Zeilen—Die Anzahl der Spalten und Zeilen wird ignoriert. Pixeltyp—Der Pixeltyp wird ignoriert. NoData—Der NoData-Wert wird ignoriert. Raumbezug—Das Raumbezugssystem wird ignoriert. Pixelwert—Die Pixelwerte werden ignoriert. Colormap—Vorhandene Colormaps werden ignoriert. Raster-Attributtabelle—Vorhandene Attributtabellen werden ignoriert. Statistiken—Statistiken werden ignoriert. Metadaten—Metadaten werden ignoriert. Pyramiden vorhanden—Vorhandene Pyramiden werden ignoriert. Komprimierungstyp—Der Kompressionstyp wird ignoriert. Datenquellentyp—Der Datenquellentyp wird ignoriert.	String
Vergleich fortsetzen (Optional)	Gibt an, ob der Vergleich fortgesetzt wird, nachdem der erste Unterschied zwischen den Eingaben festgestellt wurde. Aktiviert—Die Ausführung des Werkzeugs wird fortgesetzt, nachdem der erste Unterschied gefunden wurde. Deaktiviert—Das Werkzeug hält an, sobald der erste Unterschied gefunden wurde. Dies ist die Standardeinstellung.	Boolean
Ausgabe-Vergleichsdatei (Optional)	Die Ausgabedatei, die alle Ähnlichkeiten und Unterschiede zwischen den Eingaben enthält. Diese Datei ist eine kommagetrennte Textdatei, die in ArcGIS als Tabelle angezeigt und verwendet werden kann. Die Ausgabedatei, die alle Ähnlichkeiten und Unterschiede zwischen den Eingaben enthält. Diese Datei ist eine kommagetrennte Textdatei, die in ArcGIS als Tabelle angezeigt und verwendet werden kann.	File
Parametertoleranz (Optional)	Die Toleranzen, die den Bereich bestimmen, in welchem die Werte als identisch betrachtet werden. Dieselbe Toleranz kann auf alle Parameter angewendet werden, oder auf einzelne Parameter werden unterschiedliche Toleranzen angewendet. Der Toleranztyp kann entweder ein Wert oder ein Bruch sein. Wenn der Toleranztyp einem Bruchteil entspricht, weicht die Toleranz der einzelnen Pixel voneinander ab, da jedes Pixel einen anderen Wert hat. Wenn beispielsweise ein Toleranzbruchteil auf 0,5 festgelegt ist, wird die Toleranz wie folgt berechnet: Wenn ein Pixel den Wert 0,2 hat, entspricht die Toleranz 0,1, da 0,5 * 0,2 = 0,1. Wenn ein Pixel den Wert 3 hat, entspricht die Toleranz 1,5, da 0,5 * 3 = 1,5. Spalten der Wertetabelle: 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
Attributtoleranz (Optional)	Der numerische Wert, mit dem festgelegt wird, in welchem Bereich Attributwerte als gleich betrachtet werden. Dieser Parameter ist nur für Zahlenfelder relevant. Spalten der Wertetabelle: 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
Felder weglassen (Optional)	Das Feld beziehungsweise die Felder, die beim Vergleich übergangen werden. Die Felddefinitionen und die Tabellenwerte für diese Felder werden ignoriert.	String
Ausgabe-Vergleichs-Raster (Optional)	Das Ausgabe-Raster, das die Unterschiede zwischen den Parameterwerten Eingabe-Basis-Raster und Eingabe-Test-Raster umfasst.	Raster Dataset

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Vergleichsstatus	Der Vergleichsstatus lautet `'true'`, wenn keine Unterschiede gefunden werden, und `'false'`, wenn Unterschiede festgestellt werden.	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})

Name	Erläuterung	Datentyp
in_base_raster	Das Raster- oder Mosaik-Dataset, das mit dem Parameterwert `in_test_raster` verglichen wird. Bei diesem Parameterwert handelt es sich um die Daten, die Sie als gültig deklariert haben. Die Basisdaten verfügen über den richtigen Inhalt und die richtigen Informationen.	Raster Layer; Mosaic Layer
in_test_raster	Das Raster- oder Mosaik-Dataset, das mit dem Parameterwert `in_base_raster` verglichen wird. Bei diesem Parameterwert handelt es sich um Daten, an denen Sie durch Bearbeiten oder Kompilieren neuer Informationen Änderungen vorgenommen haben.	Raster Layer; Mosaic Layer
compare_type (Optional)	Gibt den Typ der Raster an, das verglichen wird. `RASTER_DATASET`—Es werden zwei Raster-Datasets verglichen. `GDB_RASTER_DATASET`—Es werden zwei Raster-Datasets in einer Geodatabase verglichen. `MOSAIC_DATASET`—Es werden zwei Mosaik-Datasets verglichen.	String
ignore_option [ignore_option,...] (Optional)	Gibt die Eigenschaften an, die beim Vergleich ignoriert werden sollen. `BandCount`—Die Anzahl der Bänder wird ignoriert. `Extent`—Die Ausdehnung wird ignoriert. `Columns And Rows`—Die Anzahl der Spalten und Zeilen wird ignoriert. `Pixel Type`—Der Pixeltyp wird ignoriert. `NoData`—Der NoData-Wert wird ignoriert. `Spatial Reference`—Das Raumbezugssystem wird ignoriert. `Pixel Value`—Die Pixelwerte werden ignoriert. `Colormap`—Vorhandene Colormaps werden ignoriert. `Raster Attribute Table`—Vorhandene Attributtabellen werden ignoriert. `Statistics`—Statistiken werden ignoriert. `Metadata`—Metadaten werden ignoriert. `Pyramids Exist`—Vorhandene Pyramiden werden ignoriert. `Compression Type`—Der Kompressionstyp wird ignoriert. `Data Source Type`—Der Datenquellentyp wird ignoriert.	String
continue_compare (Optional)	Gibt an, ob der Vergleich fortgesetzt wird, nachdem der erste Unterschied zwischen den Eingaben festgestellt wurde. `CONTINUE_COMPARE`—Die Ausführung des Werkzeugs wird fortgesetzt, nachdem der erste Unterschied gefunden wurde. `NO_CONTINUE_COMPARE`—Das Werkzeug hält an, sobald der erste Unterschied gefunden wurde. Dies ist die Standardeinstellung.	Boolean
out_compare_file (Optional)	Die Ausgabedatei, die alle Ähnlichkeiten und Unterschiede zwischen den Eingaben enthält. Diese Datei ist eine kommagetrennte Textdatei, die in ArcGIS als Tabelle angezeigt und verwendet werden kann.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Optional)	Die Toleranzen, die den Bereich bestimmen, in welchem die Werte als identisch betrachtet werden. Dieselbe Toleranz kann auf alle Parameter angewendet werden, oder auf einzelne Parameter werden unterschiedliche Toleranzen angewendet. Der Toleranztyp kann entweder ein Wert oder ein Bruch sein. Wenn der Toleranztyp einem Bruchteil entspricht, weicht die Toleranz der einzelnen Pixel voneinander ab, da jedes Pixel einen anderen Wert hat. Wenn beispielsweise ein Toleranzbruchteil auf 0,5 festgelegt ist, wird die Toleranz wie folgt berechnet: Wenn ein Pixel den Wert 0,2 hat, entspricht die Toleranz 0,1, da 0,5 * 0,2 = 0,1. Wenn ein Pixel den Wert 3 hat, entspricht die Toleranz 1,5, da 0,5 * 3 = 1,5. Spalten der Wertetabelle: `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}],...] (Optional)	Der numerische Wert, mit dem festgelegt wird, in welchem Bereich Attributwerte als gleich betrachtet werden. Dieser Parameter ist nur für Zahlenfelder relevant. Spalten der Wertetabelle: `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,...] (Optional)	Das Feld beziehungsweise die Felder, die beim Vergleich übergangen werden. Die Felddefinitionen und die Tabellenwerte für diese Felder werden ignoriert.	String
out_compare_raster (Optional)	Das Ausgabe-Raster, das die Unterschiede zwischen den Parameterwerten `in_base_raster` und `in_test_raster` umfasst.	Raster Dataset

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
compare_status	Der Vergleichsstatus lautet `'true'`, wenn keine Unterschiede gefunden werden, und `'false'`, wenn Unterschiede festgestellt werden.	Boolean

Codebeispiel

RasterCompare: Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion 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")

RasterCompare: Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Beispiel für die Funktion 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())

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Raster-Vergleich (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen