| 标注 | 说明 | 数据类型 |
输入表面 | 将处理的 TIN、terrain 或 LAS 数据集表面。 | LAS Dataset Layer; Terrain Layer; TIN Layer |
输出要素类 | 将生成的要素类。 | Feature Class |
等值线间距 | 等值线间的间距。 | Double |
起始等值线 (可选) | 定义要加上或减去等值线间距以描绘等值线的起始 z 值。默认值为 0.0。 | Double |
等值线字段 (可选) | 将与每条线均关联的等值线值存储在输出要素类中的字段。 | String |
等值线字段精度 (可选) | 等值线字段的精度。零将指定一个整数，数字 1-9 则指示字段将包含的小数位数。默认情况下，字段将为整数 (0)。 | Long |
计曲线间距 (可选) | 计曲线通常用于制图帮助以协助实现等值线可视化。计曲线间距的值通常比等值线间距的值大五倍。使用该参数会将计曲线间距字段定义的整型字段添加到输出要素类的属性表中，其中值 1 指示计曲线。 | Double |
计曲线间距字段 (可选) | 字段名称用于标识计曲线。该参数仅能在定义了计曲线间距后使用。默认情况下，字段名称是 Index。 | String |
Z 因子 (可选) | Z 值将乘上的系数。 此值通常用于转换 z 线性单位来匹配 x,y 线性单位。 默认值为 1，此时高程值保持不变。 如果输入表面的空间参考具有已指定线性单位的 z 基准，则此参数不可用。 | Double |
金字塔等级分辨率 (可选) | 将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。 默认值为 0，或全分辨率。 | Double |
插图
使用情况
输出要素类为 2D 形式且包含具有等值线值的属性。
使用间距和起始等值线选项可调整输出要素类的范围和分辨率。
使用外部等值线字段数据可将要素类转换为 3D。
在某些实例中，使用 TIN 表面创建等值线时可能不会生成最后一条有效等值线。这是计算机等值线软件常见的算法局限性。为确保生成全部有效等值线，请向起始等值线字段添加极小的负值以对数据进行轻微移动。
Z 因子参数仅会影响栅格和 TIN 的结果，不会影响 terrain 数据集。使用 terrain 数据集时，可指定使用 z 因子转换后的等值线间距。例如，如果希望等值线间距为一英尺，而 terrain 数据集表面以米为单位，则将等值线间距指定为 0.3048。另外，也可使用 Terrain 转栅格或 Terrain 转 TIN 地理处理工具将 terrain 数据集转换为栅格或 TIN。
参数
arcpy.ddd.SurfaceContour(in_surface, out_feature_class, interval, {base_contour}, {contour_field}, {contour_field_precision}, {index_interval}, {index_interval_field}, {z_factor}, {pyramid_level_resolution})| 名称 | 说明 | 数据类型 |
in_surface | 将处理的 TIN、terrain 或 LAS 数据集表面。 | LAS Dataset Layer; Terrain Layer; TIN Layer |
out_feature_class | 将生成的要素类。 | Feature Class |
interval | 等值线间的间距。 | Double |
base_contour (可选) | 定义要加上或减去等值线间距以描绘等值线的起始 z 值。默认值为 0.0。 | Double |
contour_field (可选) | 将与每条线均关联的等值线值存储在输出要素类中的字段。 | String |
contour_field_precision (可选) | 等值线字段的精度。零将指定一个整数，数字 1-9 则指示字段将包含的小数位数。默认情况下，字段将为整数 (0)。 | Long |
index_interval (可选) | 计曲线通常用于制图帮助以协助实现等值线可视化。计曲线间距的值通常比等值线间距的值大五倍。使用该参数会将 index_interval_field 定义的整型字段添加到输出要素类的属性表中，其中值 1 指示计曲线。 | Double |
index_interval_field (可选) | 字段名称用于标识计曲线。该名称仅能在定义了 index_interval 后使用。默认情况下，字段名称是 Index。 | String |
z_factor (可选) | Z 值将乘上的系数。 此值通常用于转换 z 线性单位来匹配 x,y 线性单位。 默认值为 1，此时高程值保持不变。 如果输入表面的空间参考具有已指定线性单位的 z 基准，则此参数不可用。 | Double |
pyramid_level_resolution (可选) | 将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。 默认值为 0，或全分辨率。 | Double |
代码示例
下面的示例演示了如何在 Python 窗口中使用此工具。
arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceContour("sample.gdb/featuredataset/terrain", "contour.shp", 10)下面的示例演示了如何在独立 Python 脚本中使用此工具。
'''****************************************************************************
Name: SurfaceContour Example
Description: This script demonstrates how to use the
SurfaceContour tool.
****************************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
outContour = arcpy.CreateUniqueName("contour.shp")
#Execute SurfaceContour
arcpy.ddd.SurfaceContour(inSurface, outContour, 10)