Raster-Vergleich (Data Management)—ArcGIS Pro

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 Werkzeuges 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 zum Verwenden von Werkzeugen in Python

Parameter

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. Deaktiviert: Das Werkzeug hält an, sobald der erste Unterschied gefunden wurde. Dies ist die Standardeinstellung. Aktiviert: Die Ausführung des Werkzeugs wird fortgesetzt, nachdem der erste Unterschied gefunden wurde.	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.	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.	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

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

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. NO_CONTINUE_COMPARE—Das Werkzeug hält an, sobald der erste Unterschied gefunden wurde. Dies ist die Standardeinstellung. CONTINUE_COMPARE—Die Ausführung des Werkzeugs wird fortgesetzt, nachdem der erste Unterschied gefunden wurde.	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.	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.	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

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

Lizenzinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema