Raster kopieren (Data Management)
Zusammenfassung
Hiermit können Sie eine Kopie eines Raster-Datasets erstellen und Raster-Datasets in einen Raster-Katalog laden.
Verwendung
-
Sie können die Ausgabe in den Formaten BIL, BIP, BMP, BSQ, DAT, GIF, 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 GRID
-
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äßige räumliche Indexgitter berechnen" ausgeführt werden.
Weitere Informationen zu Geodatabase-Elementen – Gittergröße des räumlichen Indexes
-
Für dateibasierte Raster und Personal-Geodatabase-Raster muss der Wert für Hintergrund 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 Bit-Tiefe 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 herabstuft wird, werden die Raster-Werte, die außerhalb des gültigen Bereichs für diese Pixeltiefe liegen, abgeschnitten und gehen verloren. Weitere Informationen zur Bit-Tiefe unterstützter Exportformate finden Sie unter Technische Spezifikationen für Raster-Dataset-Formate.
Syntax
| Parameter | Erläuterung | Datentyp |
in_raster |
Name und Speicherort des zu kopierenden Raster-Datasets | 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 null 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 der Wert für "Hintergrund 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. | Double |
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 Bit-Tiefe des Ausgabe-Raster-Datasets an. Wenn hierbei keine Angabe erfolgt, entspricht die Bit-Tiefe der Ausgabe der Bit-Tiefe der Eingabe. Beim Auswählen eines anderen Pixeltyps findet keine erneute Skalierung der Raster-Werte statt. Wenn der Pixeltyp herabstuft wird, werden die Raster-Werte, die außerhalb des gültigen Bereichs für diese Pixeltiefe liegen, abgeschnitten und gehen verloren.
| String |
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()