表面等值线 (3D Analyst)

摘要

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

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

插图

TIN Contour illustration

使用情况

  • 输出要素类为 2D 形式且包含具有等值线值的属性。

  • 使用间距和起始等值线选项可调整输出要素类的范围和分辨率。

  • 使用外部等值线字段数据可将要素类转换为 3D。

  • 在某些实例中,使用 TIN 表面创建等值线时可能不会生成最后一条有效等值线。这是计算机等值线软件常见的算法局限性。为确保生成全部有效等值线,请向起始等值线字段添加极小的负值以对数据进行轻微移动。

  • Z 因子参数仅会影响栅格和 TIN 的结果,不会影响 terrain 数据集。使用 terrain 数据集时,可指定使用 z 因子转换后的等值线间距。例如,如果希望等值线间距为一英尺,而 terrain 数据集表面以米为单位,则将等值线间距指定为 0.3048。另外,也可使用 Terrain 转栅格Terrain 转 TIN 地理处理工具将 terrain 数据集转换为栅格或 TIN。

参数

标注说明数据类型
输入表面

将处理的 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

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

代码示例

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceContour("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.ddd.SurfaceContour(inSurface, outContour, 10)

相关主题