要素类 Z 转 ASCII (3D Analyst 工具)

汇总

将 3D 要素导出到存储有 GENERATE、XYZ 或剖面数据的 ASCII 文本文件。

用法

剖面选项将写入一个两列 ASCII 文件，以将 3D 线要素转换为可用于生成折线图的记录。源要素类的每条线都会写入一个独立文件，文件名后附加该线的唯一 ID。 ASCII 文件中的每一行将包含从线起点到折点 (D) 的距离，后接该折点的高程。在将生成的 ASCII 文件加载到绘图应用程序中时，第一列用于定义 x 轴，第二列用于定义 y 轴。

<!--```nohighlight 0 z₁ D₁ z₂ D₂ z₃ D₃ z₄

XYZ 选项将 x、y 和 z 坐标写入为浮点值，每行代表一个点记录。

<!--```nohighlight x₁ y₁ z₁ x₂ y₂ z₂ x₃ y₃ z₃ x₄ y₄ z₄


> [!NOTE]
> 点和多点要素写入同一个文件，而每个面和折线要素写入一个独立的文本文件，该文件名后附有要素 ID。 多部件要素的每个部件将写入一个独立文件，文件名中的要素 ID 后跟部件编号。

GENERATE 格式不支持标头行，但它将所有输入要素存储在一个文件中。
- 点要素与其各自的 ID 和 XYZ 坐标一起存储，最后一行用 END 关键字表示：
  
  <!--```nohighlight ID₁ x₁ y₁ z₁ id₂ x₂ y₂ z₂ id₃ x₃ y₃ z₃ id₄ x₄ y₄ z₄END
```
> [!NOTE]
> 源自原始要素类中的同一记录的多点要素共享同一 ID。
```
- 线和面要素由 END 关键字分隔，两个连续 END 关键字表示文件的结尾：
  
  <!--```nohighlight id₁ x₁ y₁ z₁ x₂ y₂ z₂ x₃ y₃ z₃ x₄ y₄ z₄ END
  
  id₂ x₁ y₁ z₁ x₂ y₂ z₂ END
  
  END
```
> [!NOTE]
> 面要素的第一个和最后一个 XYZ 坐标始终相同。
```

标注	说明	数据类型
输入要素	导出到 ASCII 文件的 3D 点、多点、折线或面要素类。	Feature Layer
输出位置	将在其中写入输出文件的文件夹。	Folder
输出文本文件	生成的 ASCII 文件的名称。如果线或面要素类导出为 XYZ 格式，则将使用文件名作为基本名称。因为 XYZ 格式仅支持每个文件一条线或一个面，因此每个要素都将具有唯一的文件输出。多部件要素的各部件也将写入单独的文件。文件名将附有每个要素的 OID，以及使各文件名唯一所需的任何附加字符。	String
ASCII 格式（可选）	指定要创建的 ASCII 文件的格式。 GENERATE—Writes output in the GENERATE format. This is the default. XYZ—Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. Profile—Writes profile information for line features that can be used in external graphing applications.	String
分隔符（可选）	指定将指示文本文件表的列中条目间隔的分隔符。 Space—A space will be used to delimit field values. This is the default. Comma—A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
十进制记数法（可选）	指定用于确定输出文件中存储的有效数字位数的方法。 Automatically Determined—The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. Specified Number—The number of significant digits is defined in the Digits after Decimal parameter.	String
小数点后的位数（可选）	在写入输出文件的浮点值小数后写入的数字位数。当十进制记数法参数设置为指定数目（在 Python 中为 `decimal_format=FIXED`）时，将使用此参数。	Long
小数分隔符（可选）	指定将用于区分数字的整数部分与其小数部分的小数分隔符。 Point—A point is used as the decimal character. This is the default. Comma—A comma is used as the decimal character.	String

派生输出

标注	说明	数据类型
更新的文件夹	将在其中写入输出文件的文件夹。	Folder; File

arcpy.3d.FeatureClassZToASCII(in_feature_class, output_location, out_file, {format}, {delimiter}, {decimal_format}, {digits_after_decimal}, {decimal_separator})

名称	说明	数据类型
in_feature_class	导出到 ASCII 文件的 3D 点、多点、折线或面要素类。	Feature Layer
output_location	将在其中写入输出文件的文件夹。	Folder
out_file	生成的 ASCII 文件的名称。如果线或面要素类导出为 XYZ 格式，则将使用文件名作为基本名称。因为 XYZ 格式仅支持每个文件一条线或一个面，因此每个要素都将具有唯一的文件输出。多部件要素的各部件也将写入单独的文件。文件名将附有每个要素的 OID，以及使各文件名唯一所需的任何附加字符。	String
format （可选）	指定要创建的 ASCII 文件的格式。 `GENERATE`—Writes output in the GENERATE format. This is the default. `XYZ`—Writes XYZ information of input features. One file will be created for each line or polygon in the input feature. `PROFILE`—Writes profile information for line features that can be used in external graphing applications.	String
delimiter （可选）	指定将指示文本文件表的列中条目间隔的分隔符。 `SPACE`—A space will be used to delimit field values. This is the default. `COMMA`—A comma will be used to delimit field values. This option is not applicable if the decimal separator is also a comma.	String
decimal_format （可选）	指定用于确定输出文件中存储的有效数字位数的方法。 `AUTOMATIC`—The number of significant digits needed to preserve the available precision, while removing unnecessary trailing zeros, is automatically determined. This is the default. `FIXED`—The number of significant digits is defined in the Digits after Decimal parameter.	String
digits_after_decimal （可选）	在写入输出文件的浮点值小数后写入的数字位数。当十进制记数法参数设置为指定数目（在 Python 中为 `decimal_format=FIXED`）时，将使用此参数。	Long
decimal_separator （可选）	指定将用于区分数字的整数部分与其小数部分的小数分隔符。 `DECIMAL_POINT`—A point is used as the decimal character. This is the default. `DECIMAL_COMMA`—A comma is used as the decimal character.	String

派生输出

名称	说明	数据类型
derived_output	将在其中写入输出文件的文件夹。	Folder; File

代码示例

FeatureClassZToASCII 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具：

arcpy.env.workspace = "C:/data"
arcpy.ddd.FeatureClassZToASCII("LidarPts.shp", "", "ASCII_LidarPts.txt",
                            "GENERATE", "COMMA", "FIXED", 6, "DECIMAL_POINT")

FeatureClassZToASCII 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具：

'''****************************************************************************
Name: FeatureClassZToASCII Example
Description: This script demonstrates how to use the
             FeatureClassZToASCII tool to create generate files for all
             z-aware point features in a given workspace.
****************************************************************************'''
import arcpy

try:
    # Set environment settings
    arcpy.env.workspace = 'C:/data'
    # List all points in the target workspace
    fcList = arcpy.ListFeatureClasses("*", "POINT")
    if fcList:
        # Set Local Variables
        outFolder = "C:/output"
        outFormat = "GENERATE"
        delimeter = "SPACE"
        decimal = "FIXED"
        digits = 3
        dec_sep = "DECIMAL_POINT"
        for fc in fcList:
            # Use Describe method to evaluate whether the feature class is z-aware
            desc = arcpy.Describe(fc)
            if desc.hasZ == True:
                # Define the output file name by replacing '.shp' with _ascii.txt
                outName = fc.replace('.shp', '') + "_ascii.txt"
                # Run FeatureClassZToASCII_3d
                arcpy.ddd.FeatureClassZToASCII(fc, outFolder, outName, outFormat, delimeter, decimal, digits, dec_sep)
    else:
        print("There are no feature classes in the " + env.workspace + " directory.")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

环境

当前工作空间, 范围, 输出坐标系, 地理变换

许可信息

基本: 是
标准: 是
高级: 是

要素类 Z 转 ASCII (3D Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题