Identify Contours (Topographic Production)

摘要

Identifies types of contours and applies hypsographic codes to input features.

使用情况

• This tool processes each input contour and identifies the contour type. It uses the underlying raster and contour features to determine the type of contour. It then updates the contour code field with the appropriate domain code.

• This tool identifies the following types of contours:

  • Index
  • Intermediate
  • Depression index
  • Depression intermediate

警告：

此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略，请参阅修改或更新输入数据的工具。

• If more than one input raster is used, all input rasters must have the same cell size, band count, and pixel type. All input rasters should also use the same elevation units (meters or feet).

• If the Number of Depression Contours to Identify parameter value is negative or zero, the tool will not run.

参数

对话框

标注	说明	数据类型
Input Contours	The input contours that will be updated with the specified contour codes.	Feature Layer
Input Rasters	The rasters used to derive elevations of points inside contours to correctly identify the types of contours.	Raster Layer; Mosaic Layer
Contour Height field	The field in the input contour feature class that contains elevation values. This field type must be numeric.	Field
Contour Code field	The field in the input contour feature class that will be updated with the appropriate domain code.	Field
Contour Index Interval (可选)	The interval or distance between index contour lines. The default is 100.	Long
Index Code (可选)	The value used to populate the Contour Code field parameter when index contours are identified. The default is 1.	String
Intermediate Code (可选)	The value used to populate the Contour Code field parameter when intermediate contours are identified. The default is 2.	String
Depression Code (可选)	The value used to populate the Contour Code field parameter when depression contours are identified. The default is 5.	String
Depression Intermediate Code (可选)	The value used to populate the Contour Code field parameter when depression intermediate contours are identified. The default is 6.	String
Number of Depression Contours to Identify (可选)	The number of contours in a depression that will be coded as depressions. The value provided must be greater than zero. If no value is provided, all of the contours in the depression will be coded as depressions.	Long

派生输出

标注	说明	数据类型
Updated Contours	Contour feature class where contour codes were updated.	Feature Layer

Python

arcpy.topographic.IdentifyContours(in_contour_features, in_rasters, contour_height_field, contour_code_field, {contour_index_interval}, {index_code}, {intermediate_code}, {depression_code}, {depression_intermediate_code}, {depression_contours_count})

名称	说明	数据类型
in_contour_features	The input contours that will be updated with the specified contour codes.	Feature Layer
in_rasters [in_rasters,...]	The rasters used to derive elevations of points inside contours to correctly identify the types of contours.	Raster Layer; Mosaic Layer
contour_height_field	The field in the input contour feature class that contains elevation values. This field type must be numeric.	Field
contour_code_field	The field in the input contour feature class that will be updated with the appropriate domain code.	Field
contour_index_interval (可选)	The interval or distance between index contour lines. The default is 100.	Long
index_code (可选)	The value used to populate the contour_code_field parameter when index contours are identified. The default is 1.	String
intermediate_code (可选)	The value used to populate the contour_code_field parameter when intermediate contours are identified. The default is 2.	String
depression_code (可选)	The value used to populate the contour_code_field parameter when depression contours are identified. The default is 5.	String
depression_intermediate_code (可选)	The value used to populate the contour_code_field parameter when depression intermediate contours are identified. The default is 6.	String
depression_contours_count (可选)	The number of contours in a depression that will be coded as depressions. The value provided must be greater than zero. If no value is provided, all of the contours in the depression will be coded as depressions.	Long

派生输出

名称	说明	数据类型
updated_contour_features	Contour feature class where contour codes were updated.	Feature Layer

代码示例

IdentifyContours example (stand-alone script)

This Python stand-alone sample codes contours with proper attribution for Index, Intermediate, and Depression contours.

# Name: IdentifyContours_sample.py
# Description: Coding contours with proper attribution for Index, Intermediate, and Depression contours

# Import System Modules
import arcpy

# Check Out Extensions
arcpy.CheckOutExtension('Foundation')

# Setting the environment
arcpy.env.overwriteOutput = True

# Setting Local Variables
contours = r'C:\Data\MGCP_TRD_4_4.gdb\MGCP_Delta\ContourL'
rasters = r'C:\Data\Rasters\Haiti.dt2'
height_field = 'ZVH'
code_field = 'HQC'
index = 100
index_code = 1
intermediate_code = 2
depression_code = 5
depression_intermediate_code = 6
depression_contours_count = None

# Calling the Identify Contours to properly attribute contours in ContourL feature class
arcpy.topographic.IdentifyContours(contours, rasters, height_field, code_field, index, index_code, intermediate_code, depression_code, depression_intermediate_code, depression_contours_count)

# Getting all messages, warnings, and errors from the tool run and printing the results back to the user
messages = arcpy.GetMessages(0)
warnings = arcpy.GetMessages(1)
errors = arcpy.GetMessages(2)
arcpy.AddMessage('Tool Messages: {}\nTool Warnings: {}\nTool Errors{}\n'.format(messages, warnings, errors))

# Check In Extensions
arcpy.CheckInExtension('Foundation')

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 需要 Production Mapping
• Advanced: 需要 Production Mapping