含障碍的等值线 (空间分析)

摘要

根据栅格表面创建等值线。如果包含障碍要素,则允许在障碍两侧独立生成等值线。

用法

语法

ContourWithBarriers (in_raster, out_contour_feature_class, {in_barrier_features}, {in_contour_type}, {in_contour_values_file}, {explicit_only}, {in_base_contour}, {in_contour_interval}, {in_indexed_contour_interval}, {in_contour_list}, {in_z_factor})
参数说明数据类型
in_raster

输入表面栅格。

Raster Layer
out_contour_feature_class

输出等值线要素。

Feature Class
in_barrier_features
(可选)

输入障碍要素。

Feature Layer
in_contour_type
(可选)

要创建的等值线的类型。

  • POLYLINES 用等值线或等值线图表示输入栅格。
  • POLYGONS 用闭合面表示等值线。

当前版本的“含障碍的等值线”仅支持折线 (polyline) 输出。如果使用面输出选项,则会将其忽略并会创建折线 (polyline) 输出。

String
in_contour_values_file
(可选)

也可通过文本文件指定起始等值线、等值线间距、计曲线间距和建立等值线的值。

File
explicit_only
(可选)

只使用建立等值线的值。未指定起始等值线、等值线间距和计曲线间距。

  • NO_EXPLICIT_VALUES_ONLY 必须指定默认的等值线间距。
  • EXPLICIT_VALUES_ONLY 仅指定建立等值线的值。
Boolean
in_base_contour
(可选)

起始等值线值。

根据需要生成高于和低于该值的等值线可覆盖输入栅格的整个值范围。默认值为零。

Double
in_contour_interval
(可选)

等值线间的间距或距离。

该值可为任意正数。

Double
in_indexed_contour_interval
(可选)

此外,也会在输出要素类中按此间距生成等值线并相应地进行标记。

Double
in_contour_list
[in_explicit_contour,...]
(可选)

要创建等值线的值。

Double
in_z_factor
(可选)

在生成等值线时使用的单位转换因子。默认值为 1。

等值线是基于输入栅格中的 z 值生成的,所采用的测量单位通常为米或英尺。如果使用默认值 1,等值线将采用与输入栅格中的 z 值相同的单位。要以不同于 z 值的单位创建等值线,请为 z 因子设置适当的值。注意,对于此工具,没有必要使地面 x,y 单位与表面 z 单位保持一致。

例如,如果输入栅格中的高程值单位为英尺,但您希望以米为单位来生成等值线,则可将 z 因子设置为 0.3048(因为 1 英尺 = 0.3048 米)。

Double

代码示例

含障碍的等值线示例 1(Python 窗口)

此例使用输入障碍要素以及指定的起始等值线和等值线间距参数,根据 Esri Grid 栅格创建了等值线。输出等值线区域为 shapefile 中的折线 (polyline)。

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ContourWithBarriers("elevation", "C:/sapyexamples/output/outcontourwithbarriers.shp", "elevation_barrier.shp", "POLYLINES",
                    "", "", 0, 300)
含障碍的等值线示例 2(独立脚本)

此例使用输入障碍要素以及指定的起始等值线和等值线间距参数,根据 Esri Grid 栅格创建了等值线。输出等值线区域为 shapefile 中的折线 (polyline)。

# Name: ContourWithBarriers_Ex_02.py
# Description: Creates contours from a raster surface.
#           The inclusion of barrier features will allow one to independently generate contours on either side of a barrier.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
inBarrier = "elevation_barrier.shp"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
contourList = [600, 935, 1237.4]
baseContour = 0
outContours = "C:/sapyexamples/output/outcontourwithbarriers02.shp"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Contour
ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES", inTextFile, 
                    explicitValues, baseContour, contourInterval, "", 
                    contourList, "")

环境

相关主题

许可信息

ArcView: 需要 Spatial Analyst 或 3D Analyst
ArcEditor: 需要 Spatial Analyst 或 3D Analyst
ArcInfo: 需要 Spatial Analyst 或 3D Analyst

7/10/2012