Raster-Vergleich (Data Management)

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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Basis-Raster

Das erste Raster oder Mosaik-Dataset, das verglichen werden soll.

Raster Layer; Mosaic Layer
Eingabe-Test-Raster

Das zweite Raster oder Mosaik-Dataset, das mit dem ersten verglichen werden soll.

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 beendet wird, wenn ein Konflikt auftritt.

  • Deaktiviert: Der Vergleich wird beendet, wenn ein Konflikt auftritt. Dies ist die Standardeinstellung.
  • Aktiviert: Der Vergleich wird fortgesetzt, wenn ein Konflikt auftritt.
Boolean
Ausgabe-Vergleichsdatei
(optional)

Eine Textdatei mit den Vergleichsergebnissen.

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)

Die Felder, die verglichen werden sollen, um zu ermitteln, ob sie innerhalb einer Toleranz liegen. Der Toleranzwert ist ein Wert in den Einheiten des Attributs.

Value Table
Felder weglassen
(optional)

Das Feld beziehungsweise die Felder, die beim Vergleich übergangen werden.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
in_base_raster

Das erste Raster oder Mosaik-Dataset, das verglichen werden soll.

Raster Layer; Mosaic Layer
in_test_raster

Das zweite Raster oder Mosaik-Dataset, das mit dem ersten verglichen werden soll.

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 beendet wird, wenn ein Konflikt auftritt.

  • NO_CONTINUE_COMPARE—Der Vergleich wird beendet, wenn ein Konflikt auftritt. Dies ist die Standardeinstellung.
  • CONTINUE_COMPARE—Der Vergleich wird fortgesetzt, wenn ein Konflikt auftritt.
Boolean
out_compare_file
(optional)

Eine Textdatei mit den Vergleichsergebnissen.

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)

Die Felder, die verglichen werden sollen, um zu ermitteln, ob sie innerhalb einer Toleranz liegen. Der Toleranzwert ist ein Wert in den Einheiten des Attributs.

Value Table
omit_field
[omit_field,...]
(optional)

Das Feld beziehungsweise die Felder, die beim Vergleich übergangen werden.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
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
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")
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.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()

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen