Contour

描述

通过连接栅格数据集中具有相同值的点来创建等值线的栅格对象。等值线是作为可视化栅格创建的等值线。

讨论

有关此函数工作原理的详细信息,请参阅等值线栅格函数。

栅格对象的引用栅格数据集是临时的。要将其设置为永久,可以调用栅格对象的 save 方法。

语法

Contour (raster, {adaptive_smoothing}, {contour_type}, {z_base}, {number_of_contours}, {contour_interval}, {nth_contour_line_in_bold}, {z_factor})
参数说明数据类型
raster

输入栅格。

Raster
adaptive_smoothing

应用于等值线的平滑处理数量。值较低时,将生成颗粒度较大而平滑度较低的等值线;值较高时,将生成平滑度较高、锯齿状较少的等值线。

(默认值为 2.5)

Double
contour_type

要创建的等值线类型。

  • contour lines 连接相等高程的点以创建表示常量高程的线。
  • contour fill 用量化高程值填充每两个等值线之间的区域。
  • smooth surface only 对输入高程图层进行平滑处理,但不产生等值线。

(默认值为 contour lines)

String
z_base

起始等值线值。根据需要生成高于和低于该值的等值线以覆盖输入栅格的整个值范围。

值 0 通常代表平均海平面,具体取决于源高程数据集。

(默认值为 0)

Double
number_of_contours

要生成的等值线的数量。这可以动态地调整等值线间距以适应显示器中的地形,同时保持标准化间距,例如,1、5、10 等。

(默认值为 0)

Integer
contour_interval

等值线间的高度差。

在相对平坦的区域将使用较小的等值线间距,而在可变地形或山地中则使用较大的等值线间距。

(默认值为 100)

Double
nth_contour_line_in_bold

计曲线,以粗线表示。

(默认值为 5)

Integer
z_factor

z-factor 是用于转换高程值的比例因子,它有如下两种用途:

  • 将高程单位(例如米或英尺)转换为数据集的水平坐标单位(可能是英尺、米或度)。
  • 为实现视觉效果添加垂直夸大。

如果 x,y 单位和 z 单位采用相同的测量单位,则应将 z 因子设置为 1。计算最终输出表面时,将用 z 因子乘以输入表面的 z 值。

(默认值为 1)

Double
返回值
数据类型说明
Raster

输出栅格。

代码示例

Contour 示例 1

本示例将针对给定数据集创建等值线。

from arcpy.ia import *
out_contour_raster = Contour("contour_input.tif", "", "smooth surface only", "", "", 150, 10, 2)
out_contour_raster.save("C:/arcpyexamples/outputs/contour_surface.tif")
Contour 示例 2

本示例将针对给定数据集创建等值线。

# Import system modules
import arcpy
from arcpy.ia import *

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
in_raster = "contour_input.tif"

# Execute Contour function
out_contour_raster = Contour(in_raster, 3, "contour fill", 10, 20, 10, 3)

# Save the output
out_contour_raster.save("C:/arcpyExamples/outputs/contour_fill.tif")