Raster kopieren (Data Management)
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
-
Sie können die Ausgabe in den Formaten BIL, BIP, BMP, BSQ, DAT, GIF, Esri Grid, IMG, JPEG, JPEG 2000, PNG, TIFF oder einem beliebigen Geodatabase-Raster-Dataset speichern.
-
Beim Speichern eines Raster-Datasets in einer Geodatabase darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden. Wenn Sie das Raster-Dataset in einem Dateiformat speichern, müssen Sie die Dateierweiterung angeben:
- .bil für Esri BIL
- .bip für Esri BIP
- .bmp für BMP
- .bsq für Esri BSQ
- .dat für ENVI-DAT
- .gif für GIF
- .img für ERDAS IMAGINE
- .jpg für JPEG
- .jp2 für JPEG 2000
- .png für PNG
- .tif für TIFF
- Keine Erweiterung für Esri Grid
Dieses Werkzeug kann verwendet werden, um den Pixeltyp von einer Bit-Tiefe zu einer anderen zu skalieren. Wenn Sie die Pixeltiefe skalieren, wird das Raster auf dieselbe Weise angezeigt, aber die Werte werden auf die angegebene Bit-Tiefe skaliert.
-
Die Ausgabe dieses Werkzeugs ist immer ein Raster-Dataset, auch wenn die Raster-Datasets in einen Raster-Katalog geladen werden. Dieses Werkzeug akzeptiert ein Mosaik-Dataset als Eingabe, die Ausgabe ist dennoch ein Raster-Dataset – der Inhalt des Mosaik-Datasets wird mosaikiert, um ein Raster-Dataset zu erstellen.
-
Mit diesem Werkzeug können Raster-Datasets in einen Raster-Katalog geladen werden. Wenn Sie Raster-Datasets in einen Raster-Katalog laden möchten, müssen Sie den vollständigen Pfad des Raster-Katalogs als Ausgabe-Speicherort eingeben oder den Raster-Katalog in das Ausgabe-Textfeld ziehen und dort ablegen.
-
Wenn Sie dieses Werkzeug zum Laden der Raster-Datasets in den Raster-Katalog verwenden, muss nach Abschluss des Ladevorgangs das Werkzeug Standardmäßiges räumliches Indexgitter berechnen ausgeführt werden.
Weitere Informationen zu Geodatabase-Elementen –Größe des räumlichen Indexgitters
-
Für dateibasierte Raster und Personal-Geodatabase-Raster muss Hintergrundwert ignorieren auf denselben Wert wie NoData gesetzt werden, damit der Hintergrundwert ignoriert wird. File-Geodatabase-Raster und ArcSDE-Raster funktionieren auch ohne diesen zusätzlichen Schritt.
-
Beim Speichern eines Raster-Datasets in einer JPEG-Datei, einer JPEG 2000-Datei oder einer Geodatabase können Sie im Dialogfeld "Umgebungseinstellungen" einen Komprimierungstyp und eine Komprimierungsqualität festlegen.
-
Das GIF-Format unterstützt nur Einzelband-Raster-Datasets.
-
Mit dem Parameter "Pixeltyp" legen Sie fest, welche Bittiefe für das Ausgabe-Raster-Dataset verwendet wird. Beim Auswählen eines anderen Pixeltyps wird eine erneute Skalierung der Raster-Werte durchgeführt. 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. Weitere Informationen zur Bittiefe unterstützter Exportformate finden Sie unter Unterstützte Dateiformate für Raster-Datasets.
Syntax
Parameter | Erläuterung | Datentyp |
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:
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.
| 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.
| 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.
| 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.
| 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.
| Boolean |
Codebeispiel
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")
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()