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" 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

BeschriftungErläuterungDatentyp
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.

  • IntegerEs wird ein Raster-Dataset vom Typ "Integer" erstellt.
  • FloatEs wird ein Raster-Dataset vom Typ "Floating Point" erstellt.
String

arcpy.conversion.ASCIIToRaster(in_ascii_file, out_raster, {data_type})
NameErläuterungDatentyp
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.

  • INTEGEREs wird ein Raster-Dataset vom Typ "Integer" erstellt.
  • FLOATEs 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.conversion.ASCIIToRaster("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"

# Run ASCIIToRaster
arcpy.conversion.ASCIIToRaster(inASCII, outRaster, rasterType)

Lizenzinformationen

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