Contour

摘要

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

说明

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

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

语法

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

The input 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

The z-factor is a scaling factor used to convert the elevation values for the following purposes:

  • Convert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters, or degrees.
  • Add vertical exaggeration for visual effect.

If the x,y units and z units are in the same units of measure, the z-factor should be set to 1. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface.

(默认值为 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")