Summary
Identifies types of contours and applies hypsographic codes to input features.
Usage
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).
Caution:
This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.
Syntax
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})
Parameter | Explanation | Data Type |
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 (Optional) | The interval or distance between index contour lines. The default is 100. | Long |
index_code (Optional) |
The value used to populate the contour_code_field parameter when index contours are identified. The default is 1. | String |
intermediate_code (Optional) | The value used to populate the contour_code_field parameter when intermediate contours are identified. The default is 2. | String |
depression_code (Optional) | The value used to populate the contour_code_field parameter when depression contours are identified. The default is 5. | String |
depression_intermediate_code (Optional) | The value used to populate the contour_code_field parameter when depression intermediate contours are identified. The default is 6. | String |
Derived Output
Name | Explanation | Data Type |
updated_contour_features | Contour feature class where contour codes were updated. | Feature Layer |
Code sample
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
# 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)
# 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')
Environments
Licensing information
- Basic: No
- Standard: Requires Production Mapping
- Advanced: Requires Production Mapping