Raster kopieren (Data Management)

Zusammenfassung

Speichert eine Kopie eines Raster-Datasets oder konvertiert ein Mosaik-Dataset in ein einzelnes Raster-Dataset.

Verwendung

  • Sie können die Ausgabe in den Formaten BIL, BIP, BMP, BSQ, COG, CRF, ENVI DAT, ERDAS IMAGINE, GIF, JPEG, JPEG 2000, MRF, NetCDF, PNG, TIFF und Esri Grid oder als Geodatabase-Raster-Dataset speichern.

  • Fügen Sie beim Speichern eines Raster-Datasets in einer Geodatabase dem Namen des Raster-Datasets keine Dateierweiterung hinzu. Wenn Sie das Raster-Dataset in einem Dateiformat speichern, geben Sie die Dateierweiterung folgendermaßen an:

    • .bil für Esri BIL
    • .bip für Esri BIP
    • .bmp für BMP
    • .bsq für Esri BSQ
    • .crf für CRF
    • .dat für ENVI DAT
    • .img für ERDAS IMAGINE
    • .gif für GIF
    • .jpg für JPEG
    • .jp2 für JPEG 2000
    • .mrf für MRF
    • .nc für NetCDF
    • .png für PNG
    • .tif für TIFF und für die Cloud optimiertes GeoTIFF
    • .zarr für Zarr
    • 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. 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.

  • Wenn Sie World-File zum Definieren der Rasterkoordinaten verwenden in den Raster- und Bilddaten-Optionen aktivieren, wird ein World-File ausgegeben. Wenn ein World-File vorhanden ist, wird es überschrieben. Im Ausgabe-Raumbezug kann es zu einer Verschiebung um einen halben Pixel kommen.

  • Für dateibasierte Raster muss der Parameter Hintergrundwert ignorieren auf denselben Wert wie der Parameter NoData-Wert gesetzt werden, damit der Hintergrundwert ignoriert wird. File-Geodatabase-Raster und Enterprise-Geodatabase-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 in den Geoverarbeitungsumgebungen Werte für Komprimierungstyp und Komprimierungsqualität festlegen.

  • Das GIF-Format unterstützt nur Einzelband-Raster-Datasets.

  • In ArcGIS AllSource kann eine .mrf-Datei nach der Erstellung nicht kopiert, umbenannt oder gelöscht werden. Eine .mrf-Datei kann auf Daten, die an einem anderen Speicherort gespeichert sind, verweisen. Es ist nicht immer möglich, den Lese- oder Schreibstatus der Dateien zu bestimmen.

  • Mit dem Parameter Pixeltyp legen Sie fest, welche Bittiefe für das Ausgabe-Raster-Dataset verwendet wird. Beim Auswählen eines anderen Pixeltyps erfolgt eine erneute Skalierung der Raster-Werte. 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 in der Liste der unterstützten Sensoren.

  • Die Erstellung einer Datei im Format "Für die Cloud optimiertes GeoTIFF" (Cloud Optimized GeoTIFF, COG) aus einem Raster ist ein aus zwei Schritten bestehender Prozess, da die interne GeoTIFF-Struktur mit COG-Spezifikationen geordnet werden muss. Im ersten Schritt wird aus dem Eingabe-Raster mit Pyramiden, Statistiken und weiteren Metadaten eine temporäre Datei im Format GeoTIFF generiert. Diese temporäre Datei im Format GeoTIFF wird anschließend kopiert, um eine Datei im Format COG zu generieren.

    Daraus ergibt sich für die Generierung von COG-Dateien die Anforderung, dass auf der Festplatte Speicherplatz frei sein muss, der mindestens zwei Mal der Größe des Quellbildes entspricht. Der genaue Wert hängt auch von der Komprimierung des Eingabe-Rasters und der Ausgabedatei im Format COG ab.

  • Der Typ des für Ausgaben unterstützten NetCDF-Formats folgt den Konventionen für NetCDF-CF-Metadaten.

  • Das NetCDF-Format unterstützt nur Einzelbanddaten. Für multidimensionale und Multibanddaten wie Satellitendaten wird das erste Band verwendet.

  • Der Parameter Multidimensionale Umgruppierung erstellen dient der Optimierung des Datenzugriffs. Standardmäßig speichert eine .crf-Datei jeden multidimensionalen Ausschnitt in einem separaten Ordner, wobei jeder Ausschnitt in Kacheln aufgeteilt wird. Wenn Sie eine Umgruppierung durchführen, werden die Daten nicht nach Ausschnitt und Kachel, sondern entlang der Dimensionen in Blöcke (Chunks) aufgeteilt. Dadurch werden Analysen, wie zum Beispiel das Erstellen von zeitlichen Profilen, schneller.

  • Wenn Sie eine Ausdehnung außerhalb der Grenzen des Raster-Datasets angeben, wird der Bereich, der keine Daten enthält, mit NoData-Werten gefüllt.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das zu kopierende Raster- oder Mosaik-Dataset.

Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service
Ausgabe-Raster-Dataset

Der Name und das Format für das Raster-Dataset, das erstellt wird.

  • .bil: Esri BIL
  • .bip: Esri BIP
  • .bmp: BMP
  • .bsq: Esri BSQ
  • .crf: CRF
  • .dat: ENVI DAT
  • .img: ERDAS IMAGINE
  • .gif: GIF
  • .jpg: JPEG
  • .jp2: JPEG 2000
  • .mrf: MRF
  • .nc: NetCDF
  • .png: PNG
  • .tif: TIFF und für die Cloud optimiertes GeoTIFF
  • .zarr: Zarr
  • Keine Erweiterung für Esri Grid

Fügen Sie beim Speichern eines Raster-Datasets in einer Geodatabase dem Namen des Raster-Datasets keine Dateierweiterung hinzu.

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

Raster Dataset
Konfigurationsschlüsselwort
(optional)

Die Speicherparameter (Konfiguration) für eine Geodatabase. Konfigurationsschlüsselwörter werden vom Datenbankadministrator eingerichtet.

String
Hintergrundwert ignorieren
(optional)

Die unerwünschten Werte, die um die ursprünglichen Raster-Daten erstellt wurden, werden entfernt. 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 muss Hintergrundwert ignorieren auf denselben Wert wie NoData-Wert gesetzt werden, damit der Hintergrundwert ignoriert wird. Enterprise- und Geodatabase-Raster funktionieren auch ohne diesen zusätzlichen Schritt.

Double
NoData-Wert
(optional)

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

String
1-Bit-Daten in 8-Bit konvertieren
(optional)

Gibt an, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert wird. 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 eine Geodatabase. Wenn 1-Bit-Raster-Datasets in einem Dateisystem gespeichert werden, verfügen diese über 8-Bit-Pyramiden-Layer. In einer Geodatabase können 1-Bit-Raster-Datasets jedoch nur über 1-Bit-Pyramiden-Layer verfügen. Dies führt zu einer geringeren Anzeigequalität. Indem die Daten in einer Geodatabase in 8 Bit konvertiert werden, werden Pyramiden-Layer nicht mit 1 Bit, sondern mit 8 Bit erstellt. Dadurch wird das Raster-Dataset korrekt angezeigt.

  • Deaktiviert: Es erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • Aktiviert: Das Eingabe-Raster wird konvertiert.
Boolean
Colormap in RGB
(optional)

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

  • Deaktiviert: Es erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • Aktiviert: Das Eingabe-Dataset wird konvertiert.
Boolean
Pixeltyp
(optional)

Legt die Bit-Tiefe bzw. radiometrische Auflösung fest, die für das Raster- oder Mosaik-Dataset verwendet wird. Bei keiner Angabe wird der Wert des ersten Raster-Datasets verwendet.

  • 1 BitDer Pixeltyp ist eine 1-Bit-Ganzzahl ohne Vorzeichen. Zulässige Werte sind 0 und 1.
  • 2 BitDer Pixeltyp ist eine 2-Bit-Ganzzahl ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 3 liegen.
  • 4 BitDer Pixeltyp ist eine 4-Bit-Ganzzahl ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 15 liegen.
  • 8 Bit ohne VorzeichenDer Pixeltyp ist ein 8-Bit-Datentyp ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 255 liegen.
  • 8 Bit mit VorzeichenDer Pixeltyp ist ein 8-Bit-Datentyp mit Vorzeichen. Die unterstützten Werte können zwischen -128 und 127 liegen.
  • 16 Bit ohne VorzeichenDer Pixeltyp ist 16-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 65.535 liegen.
  • 16 Bit mit VorzeichenDer Pixeltyp ist ein 16-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -32.768 und 32.767 liegen.
  • 32 Bit ohne VorzeichenDer Pixeltyp ist 32-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 4.294.967.295 liegen.
  • 32 Bit mit VorzeichenDer Pixeltyp ist ein 32-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -2.147.483.648 und 2.147.483.647 liegen.
  • 32 Bit FloatDer Pixeltyp ist ein 32-Bit-Datentyp, der Dezimalstellen unterstützt.
  • 64 BitDer Pixeltyp ist ein 64-Bit-Datentyp, der Dezimalstellen unterstützt.
String
Pixelwert skalieren
(optional)

Gibt an, ob Pixelwerte skaliert werden. Wenn die Ausgabe einen anderen Pixeltyp als die Eingabe aufweist (z. B. 16 Bit zu 8 Bit), können Sie die Werte entsprechend dem neuen Bereich skalieren. 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.

  • Deaktiviert: Die Pixelwerte bleiben gleich und werden nicht skaliert. Werte, die nicht in den Wertebereich passen, werden verworfen. Dies ist die Standardeinstellung.
  • Aktiviert: 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 Bit-Tiefe skaliert.
Boolean
RGB zu Colormap
(optional)

Legt fest, ob ein 8-Bit-Dreiband-Raster-Dataset (RGB) in ein Einzelband-Raster-Dataset mit einer Colormap konvertiert wird. Bei diesem Vorgang wird Rauschen unterdrückt, das oft in gescannten Bildern vorgefunden wird, was ideal für Bildschirmaufnahmen, gescannte Karten oder gescannte Dokumente ist. Es wird nicht empfohlen für Satelliten- oder Luftbilddaten oder thematische Raster-Daten.

  • Deaktiviert: Das RGB-Raster-Dataset wird nicht konvertiert.
  • Aktiviert: Das RGB-Raster-Dataset wird in eine Colormap konvertiert.
Boolean
Format
(optional)

Legt das Ausgabe-Raster-Format fest.

  • TIFF-FormatAls Ausgabeformat wird TIFF verwendet.
  • Für die Cloud optimiertes GeoTIFFAls Ausgabeformat wird das für die Cloud optimierte GeoTIFF-Format verwendet.
  • ERDAS IMAGINE-FormatAls Ausgabeformat wird ERDAS IMAGINE verwendet.
  • BMP-FormatAls Ausgabeformat wird BMP verwendet.
  • GIF-FormatAls Ausgabeformat wird GIF verwendet.
  • PNG-FormatAls Ausgabeformat wird PNG verwendet.
  • JPEG-FormatAls Ausgabeformat wird JPEG verwendet.
  • JPEG 2000-FormatAls Ausgabeformat wird JPEG 2000 verwendet.
  • Esri Grid-FormatAls Ausgabeformat wird Esri Grid verwendet.
  • Esri BIL-FormatAls Ausgabeformat wird Esri BIL verwendet.
  • Esri BSQ-FormatAls Ausgabeformat wird Esri BSQ verwendet.
  • Esri BIP-FormatAls Ausgabeformat wird Esri BIP verwendet.
  • ENVI DAT-FormatAls Ausgabeformat wird ENVI DAT verwendet.
  • Cloud-Raster-FormatAls Ausgabeformat wird CRF verwendet.
  • Meta-Raster-FormatAls Ausgabeformat wird MRF verwendet.
  • NetCDF-FormatAls Ausgabeformat wird NetCDF verwendet.
  • Zarr-FormatAls Ausgabeformat wird Zarr verwendet.
String
Transformation anwenden
(optional)

Legt fest, ob eine mit dem Eingabe-Raster verknüpfte Transformation auf die Ausgabe angewendet wird. Mit dem Eingabe-Raster kann eine Transformation verknüpft sein, die nicht in der Eingabe gespeichert wird, z. B. ein World-File oder eine geometrische Funktion.

  • Deaktiviert: Es wird keine verknüpfte Transformation auf die Ausgabe angewendet.
  • Aktiviert: Es wird eine verknüpfte Transformation auf die Ausgabe angewendet.

  • Transformation wird nicht angewendetEs wird keine verknüpfte Transformation auf die Ausgabe angewendet.
  • Transformation wird angewendetEs wird eine verknüpfte Transformation auf die Ausgabe angewendet.
Boolean
Als multidimensional verarbeiten
(optional)

Gibt an, ob das Eingabe-Mosaik-Dataset als multidimensionales Raster-Dataset verarbeitet wird.

  • Deaktiviert: Die Eingabe wird nicht als multidimensionales Raster-Dataset verarbeitet. Wenn die Eingabe mehrdimensional ist, wird nur der Ausschnitt, der aktuell angezeigt wird, verarbeitet. Dies ist die Standardeinstellung.
  • Aktiviert: Die Eingabe wird als multidimensionales Raster-Dataset verarbeitet und zum Generieren eines neuen multidimensionalen Raster-Datasets werden alle Ausschnitte verarbeitet. Legen Sie Cloud-Raster-Format für den Parameter Format fest, um diese Option zu verwenden.
Boolean
Multidimensionale Umgruppierung erstellen
(optional)

Gibt an, ob die Umgruppierung für das multidimensionale Eingabe-Raster-Dataset erstellt wird, um den Datenzugriff zu optimieren. Bei der Umgruppierung werden die multidimensionalen Daten entlang jeder Dimension in Blöcke (Chunks) aufgeteilt, um die Performance beim Zugriff auf Pixelwerte in allen Ausschnitten zu optimieren.

  • Deaktiviert: Es wird keine Umgruppierung erstellt. Dies ist die Standardeinstellung.
  • Aktiviert: Das multidimensionale Eingabe-Raster-Dataset wird transponiert. Der Parameter Als mehrdimensional verarbeiten muss aktiviert sein, um diese Option zu verwenden.
Boolean

arcpy.management.CopyRaster(in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap}, {format}, {transform}, {process_as_multidimensional}, {build_multidimensional_transpose})
NameErläuterungDatentyp
in_raster

Das zu kopierende Raster- oder Mosaik-Dataset.

Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service
out_rasterdataset

Der Name und das Format für das Raster-Dataset, das erstellt wird.

  • .bil: Esri BIL
  • .bip: Esri BIP
  • .bmp: BMP
  • .bsq: Esri BSQ
  • .crf: CRF
  • .dat: ENVI DAT
  • .img: ERDAS IMAGINE
  • .gif: GIF
  • .jpg: JPEG
  • .jp2: JPEG 2000
  • .mrf: MRF
  • .nc: NetCDF
  • .png: PNG
  • .tif: TIFF und für die Cloud optimiertes GeoTIFF
  • .zarr: Zarr
  • Keine Erweiterung für Esri Grid

Fügen Sie beim Speichern eines Raster-Datasets in einer Geodatabase dem Namen des Raster-Datasets keine Dateierweiterung hinzu.

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

Raster Dataset
config_keyword
(optional)

Die Speicherparameter (Konfiguration) für eine Geodatabase. Konfigurationsschlüsselwörter werden vom Datenbankadministrator eingerichtet.

String
background_value
(optional)

Die unerwünschten Werte, die um die ursprünglichen Raster-Daten erstellt wurden, werden entfernt. 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 muss Hintergrundwert ignorieren auf denselben Wert wie NoData-Wert gesetzt werden, damit der Hintergrundwert ignoriert wird. Enterprise- und 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)

Gibt an, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert wird. 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 eine Geodatabase. Wenn 1-Bit-Raster-Datasets in einem Dateisystem gespeichert werden, verfügen diese über 8-Bit-Pyramiden-Layer. In einer Geodatabase können 1-Bit-Raster-Datasets jedoch nur über 1-Bit-Pyramiden-Layer verfügen. Dies führt zu einer geringeren Anzeigequalität. Indem die Daten in einer Geodatabase 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 erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • OneBitTo8BitDas Eingabe-Raster wird konvertiert.
Boolean
colormap_to_RGB
(optional)

Gibt an, ob das Eingabe-Raster-Dataset in ein Ausgabe-Raster-Dataset mit drei Bändern konvertiert wird, wenn das Eingabe-Raster-Dataset über eine Colormap verfügt. 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)

Legt die Bit-Tiefe bzw. radiometrische Auflösung fest, die für das Raster- oder Mosaik-Dataset verwendet wird. Bei keiner Angabe wird der Wert des ersten Raster-Datasets verwendet.

  • 1_BITDer Pixeltyp ist eine 1-Bit-Ganzzahl ohne Vorzeichen. Zulässige Werte sind 0 und 1.
  • 2_BITDer Pixeltyp ist eine 2-Bit-Ganzzahl ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 3 liegen.
  • 4_BITDer Pixeltyp ist eine 4-Bit-Ganzzahl ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 15 liegen.
  • 8_BIT_UNSIGNEDDer Pixeltyp ist ein 8-Bit-Datentyp ohne Vorzeichen. Die unterstützten Werte können zwischen 0 und 255 liegen.
  • 8_BIT_SIGNEDDer Pixeltyp ist ein 8-Bit-Datentyp mit Vorzeichen. Die unterstützten Werte können zwischen -128 und 127 liegen.
  • 16_BIT_UNSIGNEDDer Pixeltyp ist 16-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 65.535 liegen.
  • 16_BIT_SIGNEDDer Pixeltyp ist ein 16-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -32.768 und 32.767 liegen.
  • 32_BIT_UNSIGNEDDer Pixeltyp ist 32-Bit-Datentyp ohne Vorzeichen. Zulässige Werte können zwischen 0 und 4.294.967.295 liegen.
  • 32_BIT_SIGNEDDer Pixeltyp ist ein 32-Bit-Datentyp mit Vorzeichen. Zulässige Werte können zwischen -2.147.483.648 und 2.147.483.647 liegen.
  • 32_BIT_FLOATDer Pixeltyp ist ein 32-Bit-Datentyp, der Dezimalstellen unterstützt.
  • 64_BITDer Pixeltyp ist ein 64-Bit-Datentyp, der Dezimalstellen unterstützt.
String
scale_pixel_value
(optional)

Gibt an, ob Pixelwerte skaliert werden. Wenn die Ausgabe einen anderen Pixeltyp als die Eingabe aufweist (z. B. 16 Bit zu 8 Bit), können Sie die Werte entsprechend dem neuen Bereich skalieren. 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)

Legt fest, ob ein 8-Bit-Dreiband-Raster-Dataset (RGB) in ein Einzelband-Raster-Dataset mit einer Colormap konvertiert wird. Bei diesem Vorgang wird Rauschen unterdrückt, das oft in gescannten Bildern vorgefunden wird, was ideal für Bildschirmaufnahmen, gescannte Karten oder gescannte Dokumente ist. Es wird nicht empfohlen für Satelliten- oder Luftbilddaten oder thematische Raster-Daten.

  • NONEDas RGB-Raster-Dataset wird nicht konvertiert.
  • RGBToColormapDas RGB-Raster-Dataset wird in eine Colormap konvertiert.
Boolean
format
(optional)

Legt das Ausgabe-Raster-Format fest.

  • TIFFAls Ausgabeformat wird TIFF verwendet.
  • COGAls Ausgabeformat wird das für die Cloud optimierte GeoTIFF-Format verwendet.
  • IMAGINE ImageAls Ausgabeformat wird ERDAS IMAGINE verwendet.
  • BMPAls Ausgabeformat wird BMP verwendet.
  • GIFAls Ausgabeformat wird GIF verwendet.
  • PNGAls Ausgabeformat wird PNG verwendet.
  • JPEGAls Ausgabeformat wird JPEG verwendet.
  • JP2Als Ausgabeformat wird JPEG 2000 verwendet.
  • GRIDAls Ausgabeformat wird Esri Grid verwendet.
  • BILAls Ausgabeformat wird Esri BIL verwendet.
  • BSQAls Ausgabeformat wird Esri BSQ verwendet.
  • BIPAls Ausgabeformat wird Esri BIP verwendet.
  • ENVIAls Ausgabeformat wird ENVI DAT verwendet.
  • CRFAls Ausgabeformat wird CRF verwendet.
  • MRFAls Ausgabeformat wird MRF verwendet.
  • NetCDFAls Ausgabeformat wird NetCDF verwendet.
  • ZARRAls Ausgabeformat wird Zarr verwendet.
String
transform
(optional)

Legt fest, ob eine mit dem Eingabe-Raster verknüpfte Transformation auf die Ausgabe angewendet wird. Mit dem Eingabe-Raster kann eine Transformation verknüpft sein, die nicht in der Eingabe gespeichert wird, z. B. ein World-File oder eine geometrische Funktion.

  • NONEEs wird keine verknüpfte Transformation auf die Ausgabe angewendet.
  • TransformEs wird eine verknüpfte Transformation auf die Ausgabe angewendet.
Boolean
process_as_multidimensional
(optional)

Gibt an, ob das Eingabe-Mosaik-Dataset als multidimensionales Raster-Dataset verarbeitet wird.

  • CURRENT_SLICEDie Eingabe wird nicht als multidimensionales Raster-Dataset verarbeitet. Wenn die Eingabe mehrdimensional ist, wird nur der Ausschnitt, der aktuell angezeigt wird, verarbeitet. Dies ist die Standardeinstellung.
  • ALL_SLICESDie Eingabe wird als multidimensionales Raster-Dataset verarbeitet und zum Generieren eines neuen multidimensionalen Raster-Datasets werden alle Ausschnitte verarbeitet. Legen Sie format für den Parameter CRF fest, um diese Option zu verwenden.
Boolean
build_multidimensional_transpose
(optional)

Gibt an, ob die Umgruppierung für das multidimensionale Eingabe-Raster-Dataset erstellt wird, bei der die Daten entlang jeder Dimension in Blöcke (Chunks) aufgeteilt werden, um die Performance beim Zugriff auf Pixelwerte in allen Ausschnitten zu optimieren.

  • NO_TRANSPOSEEs wird keine Umgruppierung erstellt. Dies ist die Standardeinstellung.
  • TRANSPOSEDas multidimensionale Eingabe-Raster-Dataset wird transponiert. Für den Parameter process_as_multidimensional muss ALL_SLICES festgelegt werden, um diese Option zu verwenden.
Boolean

Codebeispiel

CopyRaster – Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion 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}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})


try:
    import arcpy
    arcpy.env.workspace = r"C:\PrjWorkspace"
    
    ##Copy Multidimensional Raster Dataset to a new multidimensional dataset in Cloud raster format and with transpose for faster data access
    arcpy.management.CopyRaster('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
    
    ##Copy 1 BIT 
    arcpy.management.CopyRaster("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
    
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.management.CopyRaster("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()
CopyRaster – Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Skriptbeispiel für die Funktion CopyRaster.

##====================================
##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}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})

import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"

##Copy to new multidimensional dataset in cloud raster format and with transpose for faster data access
arcpy.management.CopyRaster(
	"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")

Verwandte Themen