TIN 三角形 (3D Analyst 工具)

汇总

将三角面从 TIN 数据集导出至面要素，并为每个三角形提供坡度、坡向以及山体阴影和标签值的可选属性。

插图

TIN 三角形图示

用法

坡度和坡向计算基于三角形平面。如果 TIN 坐标系的线性单位使用角度测量（如十进制度），则无法正确计算坡度。
XY 和 Z 线性单位需要使用相同的测量单位，才能获得准确的坡度和山体阴影计算结果。如果单位不同，但定义了 TIN 的垂直和水平坐标系，则系统会自动确定合适的 Z 因子。否则，可以使用 Z 因子参数明确定义要应用于高程值的转换系数。
坡向值以度数表示，假设北向为 0°。值沿顺时针方向递增并在 Aspect 字段中记录。对于 TIN 中的任意平三角形，将分配坡向值 -1。
坡度可以度数或百分比形式返回，记录值的字段名称取决于在坡度单位参数中进行的选择：
- PERCENT—坡度值将存储在名为 Slope_Pct 的字段中。
- DEGREE—坡度值将存储在名为 Slope_Deg 的字段中。
山体阴影值反映了由光源生成的局部地貌，它采用山体阴影参数中指定的方位角和垂直角。北向的方位角视为 0°，亮度值以介于 0 到 255 之间的数字表示，数字越小，阴影越暗。
标签值字段参数仅在 TIN 的标签值已明确定义的情况下激活。

标注	说明	数据类型
输入 TIN	要处理的 TIN 数据集。	TIN Layer
输出要素类	将生成的要素类。	Feature Class
坡度单位（可选）	将用于计算坡度的测量单位。 Percent—Slope is expressed as a percentage value. This is the default. Degree—Slope is expressed as the angle of inclination from a horizontal plane.	String
Z 因子（可选）	Z 值将乘上的系数。此值通常用于转换 z 线性单位来匹配 x,y 线性单位。默认值为 1，此时高程值保持不变。如果输入表面的空间参考具有已指定线性单位的 z 基准面，则此参数不可用。	Double
山体阴影方位角，高度角（可选）	为要素图层输出应用山体阴影效果时指定光源的方位角和高度角。方位角的范围为 0 至 360 度，高度角的范围为 0 至 90。方位角为 45 度，高度角为 30 度的输入形式为 "HILLSHADE 45, 30"。	String
标签值字段（可选）	将存储三角形标签值的输出要素中的字段名称。该参数默认为空，将导致标签值无法写入输出。	String

arcpy.3d.TinTriangle(in_tin, out_feature_class, {units}, {z_factor}, {hillshade}, {tag_field})

名称	说明	数据类型
in_tin	要处理的 TIN 数据集。	TIN Layer
out_feature_class	将生成的要素类。	Feature Class
units （可选）	将用于计算坡度的测量单位。 `PERCENT`—Slope is expressed as a percentage value. This is the default. `DEGREE`—Slope is expressed as the angle of inclination from a horizontal plane.	String
z_factor （可选）	Z 值将乘上的系数。此值通常用于转换 z 线性单位来匹配 x,y 线性单位。默认值为 1，此时高程值保持不变。如果输入表面的空间参考具有已指定线性单位的 z 基准面，则此参数不可用。	Double
hillshade [HILLSHADE <azimuth>, <angle>,...] （可选）	为要素图层输出应用山体阴影效果时指定光源的方位角和高度角。方位角的范围为 0 至 360 度，高度角的范围为 0 至 90。方位角为 45 度，高度角为 30 度的输入形式为 "HILLSHADE 45, 30"。	String
tag_field （可选）	将存储三角形标签值的输出要素中的字段名称。该参数默认为空，将导致标签值无法写入输出。	String

代码示例

TinTriangle 示例 1（Python 窗口）

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.TinTriangle("tin", "tin_triangle.shp", units="DEGREE",
                      z_factor=1, hillshade="HILLSHADE 310,45", tag_field="tag")

TinTriangle 示例 2（独立脚本）

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

'''****************************************************************************
Name: TinTriangle Example
Description: This script demonstrates how to use the
             TinTriangle tool to extract triangles from each TIN in the
             target workspace.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data" # the target workspace

# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")

# Verify the presence of TINs in the list
if TINList:
    for dataset in TINList:
        # Set Local Variables
        TINList = arcpy.ListDatasets("*", "Tin")
        slopeUnits = "PERCENT"
        zfactor = 1
        hillshade = "HILLSHADE 300, 45" # defines hillshade azimuth & angle
        tagField = "Tag"
        Output = dataset + "_triangles.shp" # name of the output file
        # Run TinTriangle
        arcpy.ddd.TinTriangle(dataset, Output, slopeUnits, zfactor,
                              hillshade, tagField)
        print("Finished.")
else:
    print("There are no TIN(s) in the " + arcpy.env.workspace + " directory.")

环境

当前工作空间, 输出坐标系, 范围, 地理变换, XY 分辨率, XY 容差, Z 分辨率, Z 容差, 输出 XY 值域, 输出 Z 值域, 输出配置关键字, 自动提交

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

TIN 三角形 (3D Analyst 工具)

汇总

插图

用法

参数

环境

许可信息

相关主题