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-DatasetEs werden zwei Raster-Datasets verglichen.
  • Geodatabase-Raster-DatasetEs werden zwei Raster-Datasets in einer Geodatabase verglichen.
  • Mosaik-DatasetEs werden zwei Mosaik-Datasets verglichen.
String
Ausschlussoptionen
(optional)

Gibt die Eigenschaften an, die beim Vergleich ignoriert werden sollen.

  • BandanzahlDie Anzahl der Bänder wird ignoriert.
  • AusdehnungDie Ausdehnung wird ignoriert.
  • Spalten und ZeilenDie Anzahl der Spalten und Zeilen wird ignoriert.
  • PixeltypDer Pixeltyp wird ignoriert.
  • NoDataDer NoData-Wert wird ignoriert.
  • RaumbezugDas Raumbezugssystem wird ignoriert.
  • PixelwertDie Pixelwerte werden ignoriert.
  • ColormapVorhandene Colormaps werden ignoriert.
  • Raster-AttributtabelleVorhandene Attributtabellen werden ignoriert.
  • StatistikenStatistiken werden ignoriert.
  • MetadatenMetadaten werden ignoriert.
  • Pyramiden vorhandenVorhandene Pyramiden werden ignoriert.
  • KomprimierungstypDer Kompressionstyp wird ignoriert.
  • DatenquellentypDer 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_DATASETEs werden zwei Raster-Datasets verglichen.
  • GDB_RASTER_DATASETEs werden zwei Raster-Datasets in einer Geodatabase verglichen.
  • MOSAIC_DATASETEs werden zwei Mosaik-Datasets verglichen.
String
ignore_option
[ignore_option,...]
(optional)

Gibt die Eigenschaften an, die beim Vergleich ignoriert werden sollen.

  • BandCountDie Anzahl der Bänder wird ignoriert.
  • ExtentDie Ausdehnung wird ignoriert.
  • Columns And RowsDie Anzahl der Spalten und Zeilen wird ignoriert.
  • Pixel TypeDer Pixeltyp wird ignoriert.
  • NoDataDer NoData-Wert wird ignoriert.
  • Spatial ReferenceDas Raumbezugssystem wird ignoriert.
  • Pixel ValueDie Pixelwerte werden ignoriert.
  • ColormapVorhandene Colormaps werden ignoriert.
  • Raster Attribute TableVorhandene Attributtabellen werden ignoriert.
  • StatisticsStatistiken werden ignoriert.
  • MetadataMetadaten werden ignoriert.
  • Pyramids ExistVorhandene Pyramiden werden ignoriert.
  • Compression TypeDer Kompressionstyp wird ignoriert.
  • Data Source TypeDer Datenquellentyp wird ignoriert.
String
continue_compare
(optional)

Gibt an, ob der Vergleich beendet wird, wenn ein Konflikt auftritt.

  • NO_CONTINUE_COMPAREDer Vergleich wird beendet, wenn ein Konflikt auftritt. Dies ist die Standardeinstellung.
  • CONTINUE_COMPAREDer 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()

Verwandte Themen