Raster kopieren (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Hiermit können Sie eine Kopie eines Raster-Datasets erstellen, Raster-Datasets in einen Raster-Katalog laden oder ein Mosaik-Dataset in ein Raster-Dataset konvertieren.

Verwendung

Syntax

CopyRaster_management (in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap})
ParameterErläuterungDatentyp
in_raster

Name und Speicherort des zu kopierenden Raster-Datasets

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
out_rasterdataset

Name und Speicherort des zu erstellenden Raster-Datasets.

Wenn Sie das Raster-Dataset in einem Dateiformat speichern, müssen Sie die Dateierweiterung angeben:

  • .bil – Esri BIL
  • .bip – Esri BIP
  • .bmp – BMP
  • .bsq – Esri BSQ
  • .dat – ENVI-DAT
  • .gif – GIF
  • .img – ERDAS IMAGINE
  • .jpg – JPEG
  • .jp2 – JPEG 2000
  • .png – PNG
  • .tif – TIFF
  • Keine Erweiterung für Esri Grid

Beim Speichern eines Raster-Datasets in einer Geodatabase darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden.

Beim Speichern des Raster-Datasets als JPEG-, JPEG 2000- oder TIFF-Datei bzw. in einer Geodatabase können Sie einen Komprimierungstyp und eine Komprimierungsqualität festlegen.

Raster Dataset; Raster Catalog
config_keyword
(optional)

Legt die Speicherparameter (Konfiguration) für eine File- und eine ArcSDE-Geodatabase fest. Personal-Geodatabases unterstützen keine Konfigurationsschlüsselwörter.

ArcSDE-Konfigurationsschlüsselwörter werden vom Datenbankadministrator eingerichtet.

String
background_value
(optional)

Verwenden Sie diese Option, um unerwünschte Werte zu entfernen, die um die ursprünglichen Raster-Daten erstellt wurden. Der angegebene Wert wird von den anderen wichtigen Daten im Raster-Dataset unterschieden. Beispielsweise wird ein Wert von 0 entlang der Grenzen des Raster-Datasets von den Nullwerten innerhalb des Raster-Datasets unterschieden.

Der angegebene Pixelwert wird im Ausgabe-Raster-Dataset auf "NoData" gesetzt.

Für dateibasierte Raster und Personal-Geodatabase-Raster muss "Hintergrundwert ignorieren" auf denselben Wert wie "NoData" gesetzt werden, damit der Hintergrundwert ignoriert wird. ArcSDE- und File-Geodatabase-Raster funktionieren auch ohne diesen zusätzlichen Schritt.

Double
nodata_value
(optional)

Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt.

String
onebit_to_eightbit
(optional)

Wählen Sie aus, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert werden soll. Bei dieser Konvertierung wird der Wert 1 des Eingabe-Raster-Datasets im Ausgabe-Raster-Dataset in 255 geändert. Dies eignet sich besonders für das Importieren von 1-Bit Raster-Datasets in ArcSDE. Wenn 1-Bit-Raster-Datasets in ein Dateisystem gespeichert werden, verfügen diese über 8-Bit-Pyramiden-Layer. In ArcSDE können 1-Bit-Raster-Datasets jedoch nur über 1-Bit-Pyramiden-Layer verfügen. Dies führt zu einer minderwertigen Anzeigequalität. Indem die Daten in ArcSDE in 8 Bit konvertiert werden, werden Pyramiden-Layer nicht mit 1 Bit, sondern mit 8 Bit erstellt. Dadurch wird das Raster-Dataset korrekt angezeigt.

  • NONEEs findet keine Konvertierung statt. Dies ist die Standardeinstellung.
  • OneBitTo8BitDas Eingabe-Raster wird konvertiert.
Boolean
colormap_to_RGB
(optional)

Wenn das Eingabe-Raster-Dataset über eine Colormap verfügt, kann das Ausgabe-Raster-Dataset in ein Dataset mit drei Bändern konvertiert werden. Dies erweist sich beim mosaikartigen Einfügen von Rastern mit unterschiedlichen Colormaps als nützlich.

  • NONEEs erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • ColormapToRGBDas Eingabe-Dataset wird konvertiert.
Boolean
pixel_type
(optional)

Gibt die Bittiefe des Ausgabe-Raster-Datasets an. Wenn hierbei keine Angabe erfolgt, entspricht die Bittiefe der Ausgabe der Bittiefe der Eingabe.

Beim Auswählen eines anderen Pixeltyps findet keine erneute Skalierung der Raster-Werte statt. Wenn der Pixeltyp herabgestuft wird, werden die Raster-Werte, die außerhalb des gültigen Bereichs für diese Pixeltiefe liegen, abgeschnitten und gehen verloren.

  • 1_BITEine 1-Bit-Ganzzahl ohne Vorzeichen. Zulässige Werte sind 0 und 1.
  • 2_BITEine 2-Bit-Ganzzahl ohne Vorzeichen. Werte von 0 bis 3 werden unterstützt.
  • 4_BITEine 4-Bit-Ganzzahl ohne Vorzeichen. Werte von 0 bis 15 werden unterstützt.
  • 8_BIT_UNSIGNEDEin 8-Bit-Datentyp ohne Vorzeichen. Werte von 0 bis 255 werden unterstützt.
  • 8_BIT_SIGNEDEin 8-Bit-Datentyp mit Vorzeichen. Werte von 128 bis 127 werden unterstützt.
  • 16_BIT_UNSIGNEDEin 16-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 65.535 liegen.
  • 16_BIT_SIGNEDEin 16-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -32.768 und 32.767 liegen.
  • 32_BIT_UNSIGNEDEin 32-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 4.294.967.295 liegen.
  • 32_BIT_SIGNEDEin 32-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -2.147.483.648 und 2.147.483.647 liegen.
  • 32_BIT_FLOATEin 32-Bit-Datentyp, der Dezimalstellen unterstützt.
  • 64_BITEin 64-Bit-Datentyp, der Dezimalstellen unterstützt.
String
scale_pixel_value
(optional)

Wenn die Ausgabe einen anderen Pixeltyp hat als die Eingabe (z. B. 16-Bit zu 8-Bit), können Sie angeben, dass die Werte entsprechend dem neuen Bereich skaliert werden sollen; andernfalls werden die Werte, die nicht in den neuen Pixelbereich passen, verworfen.

Bei einer Vergrößerung, z. B. von 8-Bit auf 16-Bit, werden Minimum und Maximum der 8-Bit-Werte auf Minimum und Maximum im 16-Bit-Bereich skaliert. Bei einer Verkleinerung, z. B. von 16-Bit auf 8-Bit, werden Minimum und Maximum der 16-Bit-Werte auf Minimum und Maximum im 8-Bit-Bereich skaliert.

  • NONEDie Pixelwerte bleiben unverändert und werden nicht skaliert. Werte, die nicht in den Wertebereich passen, werden verworfen. Dies ist die Standardeinstellung.
  • ScalePixelValueDie Pixelwerte werden auf den neuen Pixeltyp skaliert. Wenn Sie die Pixeltiefe skalieren, wird das Raster auf dieselbe Weise angezeigt, aber die Werte werden auf die angegebene Bit-Tiefe skaliert.
Boolean
RGB_to_Colormap
(optional)

Sie können ein 8-Bit-, 3-Band (RGB)-Raster-Dataset in ein Einzelband-Raster-Dataset mit einer Colormap konvertieren.

Bei diesem Vorgang wird Farbrauschen unterdrückt, das oft in gescannten Bildern gefunden wird, indem die Statistik für das Raster-Dataset untersucht wird und die Werte in 255 Quantile klassifiziert werden.

Dies ist ideal für Bildschirmaufnahmen, gescannte Karten oder gescannte Dokumente. Es wird nicht empfohlen für Satelliten- oder Luftbilddaten oder thematische Raster-Daten.

  • NONEDie Ausgabe erfolgt unverändert als 3-Band (RGB)-Raster-Dataset. Es findet keine Konvertierung in eine Colormap statt. Dies ist die Standardeinstellung.
  • RGBToColormapEin Einzelband-Raster-Dataset mit einer Colormap von 255 Farben wird erstellt.
Boolean

Codebeispiel

CopyRaster – Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für das Werkzeug "CopyRaster".

import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
                           "c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
                           "0","9","","","8_BIT_UNSIGNED")
CopyRaster – Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Skriptbeispiel für das Werkzeug "CopyRaster".

##====================================
##Copy Raster
##Usage: CopyRaster_management in_raster out_rasterdataset {config_keyword} {background_value} {nodata_value} {NONE | OneBitTo8Bit} 
##                             {NONE | ColormapToRGB} {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED 
##                             | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
try:
    import arcpy
    arcpy.env.workspace = r"C:\PrjWorkspace"
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
    ##Copy 1 BIT 
    arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013