Raster kopieren (Datenmanagement)

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 NULL-Werten 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.

  • NONE —Es findet keine Konvertierung statt. Dies ist die Standardeinstellung.
  • OneBitTo8Bit —Das 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.

  • NONE —Es erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • ColormapToRGB —Das 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_BIT —Eine 1-Bit-Ganzzahl ohne Vorzeichen. Zulässige Werte sind 0 und 1.
  • 2_BIT —Eine 2-Bit-Ganzzahl ohne Vorzeichen. Werte von 0 bis 3 werden unterstützt.
  • 4_BIT —Eine 4-Bit-Ganzzahl ohne Vorzeichen. Werte von 0 bis 15 werden unterstützt.
  • 8_BIT_UNSIGNED —Ein 8-Bit-Datentyp ohne Vorzeichen. Werte von 0 bis 255 werden unterstützt.
  • 8_BIT_SIGNED —Ein 8-Bit-Datentyp mit Vorzeichen. Werte von 128 bis 127 werden unterstützt.
  • 16_BIT_UNSIGNED —Ein 16-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 65.535 liegen.
  • 16_BIT_SIGNED —Ein 16-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -32.768 und 32.767 liegen.
  • 32_BIT_UNSIGNED —Ein 32-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 4.294.967.295 liegen.
  • 32_BIT_SIGNED —Ein 32-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -2.147.483.648 und 2.147.483.647 liegen.
  • 32_BIT_FLOAT —Ein 32-Bit-Datentyp, der Dezimalstellen unterstützt.
  • 64_BIT —Ein 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.

  • NONE —Die Pixelwerte bleiben unverändert und werden nicht skaliert. Werte, die nicht in den Wertebereich passen, werden verworfen. Dies ist die Standardeinstellung.
  • ScalePixelValue —Die 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 Bittiefe 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 Statistiken für das Raster-Dataset untersucht 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.

  • NONE —Die Ausgabe erfolgt unverändert als 3-Band (RGB)-Raster-Dataset. Es findet keine Konvertierung in eine Colormap statt. Dies ist die Standardeinstellung.
  • RGBToColormap —Ein 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

Überblick über das Toolset "Raster"
Umgebungseinstellungen für Raster-Daten
Unterstützte Dateiformate für Raster-Datasets

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
Copyright © 1995-2014 Esri. All rights reserved.
5/9/2014