Raster in ASCII (Conversion)
Zusammenfassung
Konvertiert ein Raster-Dataset in eine ASCII-Textdatei mit Raster-Daten.
Verwendung
-
Als Eingabe-Raster-Dataset sind alle gültigen Raster-Datasets zulässig.
-
Die Struktur der ASCII-Datei enthält Header-Informationen mit einer Reihe von Schlüsselwörtern und Zellenwerten in zeilenweise aufsteigender Reihenfolge.
Normalerweise hat die Datei das folgende Format:
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 steht für die Anzahl der Spalten und Zeilen im Raster, die von der ASCII-Datei definiert werden.
XLLCORNER und YLLCORNER steht für die Koordinaten der unteren linken Ecke der unteren linken Zelle.
CELLSIZE ist die Zellengröße des Rasters.
NODATA_VALUE ist der Wert, der NoData-Zellen darstellen soll.
Im Datenstrom der Zellenwerte ist Zeile 1 am Anfang des Rasters angeordnet, Zeile 2 liegt direkt darunter usw.
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 ...
-
Der unter NODATA_VALUE angegebene Wert ist der Wert in der ASCII-Datei, der NoData-Zellen im Eingabe-Raster darstellt. Dieser Wert ist normalerweise den Zellen vorbehalten, deren wahrer Wert unbekannt ist.
-
Jede Datenzeile im Raster wird in der Datei mit einem Absatzzeichen abgeschlossen.
-
Es können sowohl ganzzahlige Raster als auch Gleitkomma-Raster in eine ASCII-Raster-Datei konvertiert werden.
Bei diesem Werkzeug wird der Ursprung nur als linke untere Ecke der linken unteren Zelle geschrieben. Das Werkzeug ASCII in Raster unterstützt als Ursprung auch den Mittelpunkt der unteren linken Zelle.
Syntax
Parameter | Erläuterung | Datentyp |
in_raster |
Das Eingabe-Raster-Dataset. Das Raster kann ein Ganzzahl- oder ein Gleitkomma-Raster sein. | Raster Layer |
out_ascii_file |
Die ASCII-Raster-Datei für die Ausgabe. | File |
Codebeispiel
Konvertiert ein Raster-Dataset in eine ASCII-Datei mit Raster-Daten.
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.RasterToASCII_conversion("elevation", "c:/output/sa500.asc")
Konvertiert ein Raster-Dataset in eine ASCII-Datei mit Raster-Daten.
# Name: RasterToASCII_Ex_02.py
# Description: Converts a raster dataset to an ASCII file representing
# raster data.
# Requirements: None
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outASCII = "c:/output/elevation.asc"
# Execute RasterToASCII
arcpy.RasterToASCII_conversion(inRaster, outASCII)