表面等值线 (3D Analyst)

描述

创建派生自 terrain、TIN 或 LAS 数据集表面的等值线。

了解有关“表面等值线”工作原理的详细信息

插图

TIN Contour illustration

使用方法

  • 输出要素类为 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

代码示例

表面等值线 (SurfaceContour) 示例 1(Python 窗口)

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

arcpy.env.workspace = "C:/data"
arcpy.SurfaceContour_3d("sample.gdb/featuredataset/terrain", "contour.shp", 10)
表面等值线 (SurfaceContour) 示例 2(独立脚本)

下面的示例演示了如何在独立 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

相关主题