标注 | 说明 | 数据类型 |
输入栅格 | 输入栅格数据集。 栅格可以是整型或浮点型。 | Raster Layer |
输出 ASCII 栅格文件 | 输出 ASCII 栅格文件。 | File |
摘要
将栅格数据集转换为表示栅格数据的 ASCII 文件。
使用情况
-
输入栅格数据集可以是任何有效的栅格数据集。
ASCII 文件的结构由包含一组关键字的标题信息组成,后跟按行优先顺序的像元值。
文件的格式一般为:
NCOLS xxx NROWS xxx XLLCORNER xxx YLLCORNER xxx CELLSIZE xxx NODATA_VALUE xxx row 1 row 2 . . row n
关键字的定义如下:
NCOLS 和 NROWS 是由 ASCII 文件所定义的栅格的列数和行数。
XLLCORNER 和 YLLCORNER 是左下角栅格像元的左下角坐标。
CELLSIZE 是栅格的像元大小。
NODATA_VALUE 是用于表示 NoData 像元的值。
在像元值的数据流中,数据的第 1 行是栅格的顶部,第 2 行在第 1 行下方,依此类推。
ASCII 栅格文件示例如下:
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 是 ASCII 文件中表示输入栅格中 NoData 像元的值。 此值通常留给那些“真”值未知的像元专用。
栅格数据的每一行数据在文件中以回车符结尾。
整型和浮点型栅格数据都可以转换为 ASCII 栅格文件。
此工具只将左下角像元的左下角作为原点写入。 复制栅格工具也支持将左下角像元的中心作为原点。
从 ArcGIS AllSource 3.2 版本开始,默认工具输出为具有 .asc 扩展名(而非 .txt 扩展名)的 ASCII 文件。 对于具有 .txt 扩展名的现有 ASCII 文件,建议使用 .asc 扩展名对文件进行重命名。
参数
arcpy.conversion.RasterToASCII(in_raster, out_ascii_file)
名称 | 说明 | 数据类型 |
in_raster | 输入栅格数据集。 栅格可以是整型或浮点型。 | Raster Layer |
out_ascii_file | 输出 ASCII 栅格文件。 | File |
代码示例
将栅格数据集转换为表示栅格数据的 ASCII 文件。
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToASCII("elevation", "c:/output/sa500.asc")
将栅格数据集转换为表示栅格数据的 ASCII 文件。
# Name: RasterToASCII_Ex_02.py
# Description: Converts a raster dataset to an ASCII file representing
# raster data.
# Requirements: None
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outASCII = "c:/output/elevation.asc"
# Run RasterToASCII
arcpy.conversion.RasterToASCII(inRaster, outASCII)