插图
使用方法
输出要素类为 2D 形式且包含具有等值线值的属性。
使用间距和起始等值线选项可调整输出要素类的范围和分辨率。
使用外部等值线字段数据可将要素类转换为 3D。
在某些实例中，使用 TIN 表面创建等值线时可能不会生成最后一条有效等值线。这是计算机等值线软件常见的算法局限性。为确保生成全部有效等值线，请向起始等值线字段添加极小的负值以对数据进行轻微移动。
Z 因子参数仅会影响栅格和 TIN 的结果，不会影响 terrain 数据集。使用 terrain 数据集时，可指定使用 z 因子转换后的等值线间距。例如，如果希望等值线间距为一英尺，而 terrain 数据集表面以米为单位，则将等值线间距指定为 0.3048。另外，也可使用 Terrain 转栅格或 Terrain 转 TIN 地理处理工具将 terrain 数据集转换为栅格或 TIN。
语法
arcpy.3d.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 线性单位来匹配 XY 线性单位。默认值为 1，此时高程值保持不变。如果输入表面的空间参考具有已指定线性单位的 Z 基准，则将禁用此参数。 | Double |
pyramid_level_resolution （可选） | 此工具将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。默认值为 0（z 容差），或全分辨率（窗口大小）。 | Double |
代码示例
下面的示例演示了如何在 Python 窗口中使用此工具。
arcpy.env.workspace = "C:/data"
arcpy.SurfaceContour_3d("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.SurfaceContour_3d(inSurface, outContour, 10)许可信息
- Basic: 需要 3D Analyst
- Standard: 需要 3D Analyst
- Advanced: 需要 3D Analyst