ASCII in Raster (Conversion)

Zusammenfassung

Hiermit wird eine ASCII-Datei mit Raster-Daten in ein Raster-Dataset konvertiert.

Vorversion:

Dies ist ein veraltetes Werkzeug. Jetzt können Sie mit dem Werkzeug Raster kopieren eine ASCII-Datei mit Raster-Daten in ein Raster-Dataset konvertieren.

Wenn Sie das Textfeld der Schaltfläche "Durchsuchen" im Werkzeug Raster kopieren verwenden und die Eingabedatei nicht die Erweiterung .asc aufweist, können Sie die Datei umbenennen, sodass sie die Erweiterung aufweist. Alternativ können Sie den Filter im Dialogfeld Eingabe-Raster von Alle unterstützten Typen in Dateien ändern. Die empfohlene Option ist das Umbenennen der Datei.

Verwendung

• Die Eingabedatei ist eine Textdatei im ASCII-Format.

• Die Struktur der ASCII-Datei besteht aus Header-Informationen mit einer Reihe von Schlüsselwörtern und Zellwerten in zeilenweise aufsteigender Reihenfolge.

  Es gibt zwei Variationen der ASCII-Dateistruktur. Eine gibt den Ursprung anhand der Koordinaten der linken unteren Ecke der linken unteren Zelle, die andere gibt den Mittelpunkt der linken unteren Zelle an.

  Das Format der Datei lautet im Allgemeinen wie folgt:

      NCOLS xxx
      NROWS xxx
      XLLCORNER xxx
      YLLCORNER xxx
      CELLSIZE xxx
      NODATA_VALUE xxx
      row 1
      row 2
      .
      .
      row n

  Die Definitionen der Schlüsselwörter lauten wie folgt:

  • NCOLS und NROWS geben die durch die ASCII-Datei definierte Anzahl der Spalten und Zeilen im Raster an.

  • XLLCORNER und YLLCORNER stehen für die Koordinaten der unteren linken Ecke der unteren linken Zelle.

    Sie können den Ursprung auch mit den Koordinaten des Mittelpunktes der linken unteren Zelle angeben, indem Sie XLLCENTER und YLLCENTER verwenden.

  • CELLSIZE ist die Zellengröße des Rasters.

  • NODATA_VALUE ist der Wert, der die NoData-Zellen angibt.

  • Zellenwerte müssen durch Leerzeichen begrenzt sein. Am Ende der einzelnen Zeilen in der ASCII-Datei müssen keine Absatzzeichen gesetzt werden. Anhand der Spalten in der Kopfzeile wird festgelegt, wann eine neue Zeile beginnt.

• Beispiel für eine ASCII-Raster-Datei:

      NCOLS 480
      NROWS 450
      XLLCORNER 378922
      YLLCORNER 4072345
      CELLSIZE 30
      NODATA_VALUE -32768
      43 2 45 7 3 56 2 5 23 65 34 6 32 54 57 34
      35 45 65 34 2 6 78 4 2 6 89 3 2 7 45 23 5 ...

• NODATA_VALUE ist der Wert in der ASCII-Datei, der den NoData-Zellen im Ausgabe-Raster zugewiesen wird. Dieser Wert ist normalerweise den Zellen vorbehalten, deren wahrer Wert unbekannt ist. Wenn das Ausgabe-Raster erstellt wird, wird ein vom System generierter NoData-Wert anstelle von NODATA_VALUE verwendet.

• Die Anzahl der in der Datei enthaltenen Zellenwerte muss der Anzahl der Zeilen multipliziert mit der Anzahl der Spalten entsprechen. Ist dies nicht der Fall, wird eine Fehlermeldung ausgegeben.

• Als Ausgabe-Datentyp kommen entweder "Float" oder "Integer" infrage.

• Verwenden Sie das Werkzeug Projektion definieren nach der Erstellung des Ausgabe-Rasters, um das richtige Koordinatensystem anzuwenden.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-ASCII-Raster-Datei	Die zu konvertierende Eingabe-ASCII-Datei	File
Ausgabe-Raster	Das zu erstellende Ausgabe-Raster-Dataset. Wenn das Ausgabe-Raster nicht in einer Geodatabase gespeichert wird, müssen Sie beim TIFF-Dateiformat die Erweiterung .tif angeben, beim CRF-Dateiformat die Erweiterung .CRF, beim ERDAS IMAGINE-Dateiformat die Erweiterung .img und beim Esri Grid-Raster-Format keine Erweiterung.	Raster Dataset
Ausgabedatentyp (optional)	Gibt den Datentyp des Ausgabe-Raster-Datasets an. Integer—Es wird ein Raster-Dataset vom Typ "Integer" erstellt. Float—Es wird ein Raster-Dataset vom Typ "Floating Point" erstellt.	String

Python

arcpy.conversion.ASCIIToRaster(in_ascii_file, out_raster, {data_type})

Name	Erläuterung	Datentyp
in_ascii_file	Die zu konvertierende Eingabe-ASCII-Datei	File
out_raster	Das zu erstellende Ausgabe-Raster-Dataset. Wenn das Ausgabe-Raster nicht in einer Geodatabase gespeichert wird, müssen Sie beim TIFF-Dateiformat die Erweiterung .tif angeben, beim CRF-Dateiformat die Erweiterung .CRF, beim ERDAS IMAGINE-Dateiformat die Erweiterung .img und beim Esri Grid-Raster-Format keine Erweiterung.	Raster Dataset
data_type (optional)	Gibt den Datentyp des Ausgabe-Raster-Datasets an. INTEGER—Es wird ein Raster-Dataset vom Typ "Integer" erstellt. FLOAT—Es wird ein Raster-Dataset vom Typ "Floating Point" erstellt.	String

Codebeispiel

ASCIIToRaster – Beispiel 1 (Python-Fenster)

Hiermit wird eine ASCII-Datei mit Raster-Daten in ein Raster-Dataset konvertiert.

import arcpy
arcpy.ASCIIToRaster_conversion("c:/data/elevation.asc", "c:/output/elevation", 
                               "INTEGER")

ASCIIToRaster – Beispiel 2 (eigenständiges Skript)

Hiermit wird eine ASCII-Datei mit Raster-Daten in ein Raster-Dataset konvertiert.

# Name: ASCIIToRaster_Ex_02.py
# Description: Converts an ASCII file representing raster data to a raster 
#    dataset.

# Import system modules
import arcpy

# Set local variables
inASCII = "c:/data/elevation.asc"
outRaster = "c:/output/elevation02"
rasterType = "INTEGER"

# Execute ASCIIToRaster
arcpy.ASCIIToRaster_conversion(inASCII, outRaster, rasterType)

Umgebungen

Auto-Commit, Komprimierung, Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Pyramide, Raster-Statistiken, Scratch-Workspace, Kachelgröße

Sonderfälle

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja