栅格转 ASCII (转换)

摘要

将栅格数据集转换为表示栅格数据的 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 Pro 3.2 版本开始，默认工具输出为具有 .asc 扩展名（而非 .txt 扩展名）的 ASCII 文件。 对于具有 .txt 扩展名的现有 ASCII 文件，建议使用 .asc 扩展名对文件进行重命名。

参数

对话框

标注	说明	数据类型
输入栅格	输入栅格数据集。 栅格可以是整型或浮点型。	Raster Layer
输出 ASCII 栅格文件	输出 ASCII 栅格文件。	File

Python

arcpy.conversion.RasterToASCII(in_raster, out_ascii_file)

名称	说明	数据类型
in_raster	输入栅格数据集。 栅格可以是整型或浮点型。	Raster Layer
out_ascii_file	输出 ASCII 栅格文件。	File

代码示例

RasterToASCII 示例 1（Python 窗口）

将栅格数据集转换为表示栅格数据的 ASCII 文件。

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToASCII("elevation", "c:/output/sa500.asc")

RasterToASCII 示例 2（独立脚本）

将栅格数据集转换为表示栅格数据的 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)

环境

自动提交, 像元大小, 像元大小投影方法, 当前工作空间, 范围, 地理变换, 输出配置关键字, 输出坐标系, 临时工作空间

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是