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.
| String |
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
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.
| String |
Codebeispiel
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")
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)