トップへ戻る

Identify Contours (Topographic Production)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

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 identify 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.

パラメーター

ダイアログPython

ラベル説明データ タイプ
Input Contours

The input contours that will be updated with the specified contour codes.

Feature Layer
Input Rasters

The rasters that will be 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 that will be used to populate the Contour Code Field parameter value when index contours are identified. The default is 1.

String
Intermediate Code
(オプション)

The value that will be used to populate the Contour Code Field parameter value when intermediate contours are identified. The default is 2.

String
Depression Code
(オプション)

The value that will be used to populate the Contour Code Field parameter value when depression contours are identified. The default is 5.

String
Depression Intermediate Code
(オプション)

The value that will be used to populate the Contour Code Field parameter value 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
Area of Interest
(オプション)

The layer that defines the processing extent. The layer must have only one selected feature.

Feature Layer
Z Factor
(オプション)

The conversion factor that will be used to convert the contour elevation value unit of measurement to match the raster's unit of measurement. The default is 1.

For example, if the elevation values in the input raster are in meters but the contours are in feet, set the z-factor to 3.28084 (1 meter = 3.28084 feet).

Double
Supplemental Contours
(オプション)

Specifies the interval at which supplemental contours will be created. Supplemental contours are used when the terrain change is not large enough to be depicted with consistent contour intervals.

  • None—No supplemental contours will be created. This is the default.
  • Half Auxiliary—Supplemental contours will be created at one-half the contour interval.
  • Quarter Auxiliary—Supplemental contours will be created at one-quarter the contour interval.
String
Half Auxiliary Code
(オプション)

The code value that will be stored in the Contour Code Field parameter value when a half auxiliary contour is identified. The default code will be 3 if the HQC field exists in the input contour feature class.

String
Quarter Auxiliary Code
(オプション)

The code value that will be stored in the Contour Code Field parameter value when a quarter auxiliary contour is identified. The default code will be 14 if the HQC field exists in the input contour feature class.

String
Depression Auxiliary Code
(オプション)

The code value that will be stored in the Contour Code Field parameter value when a depression auxiliary contour is identified. The default code will be 22 if the HQC field exists in the input contour feature class.

String
Contour Interval
(オプション)

The interval, or distance, between contour lines. This can be any positive number. The default is 20.

Double
Base Contour
(オプション)

The value that contours will be generated above and below to cover the entire value range of the input raster. The default is 0.

Double

派生した出力

ラベル説明データ タイプ
Updated Contours

The contour feature class where contour codes were updated.

Feature Layer

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}, {area_of_interest}, {z_factor}, {supplemental_contours}, {half_auxiliary_code}, {quarter_auxiliary_code}, {depression_auxiliary_code}, {contour_interval}, {base_contour})
名前説明データ タイプ
in_contour_features

The input contours that will be updated with the specified contour codes.

Feature Layer
in_rasters
[in_rasters,...]

The rasters that will be 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 that will be used to populate the contour_code_field parameter value when index contours are identified. The default is 1.

String
intermediate_code
(オプション)

The value that will be used to populate the contour_code_field parameter value when intermediate contours are identified. The default is 2.

String
depression_code
(オプション)

The value that will be used to populate the contour_code_field parameter value when depression contours are identified. The default is 5.

String
depression_intermediate_code
(オプション)

The value that will be used to populate the contour_code_field parameter value 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
area_of_interest
(オプション)

The layer that defines the processing extent. The layer must have only one selected feature.

Feature Layer
z_factor
(オプション)

The conversion factor that will be used to convert the contour elevation value unit of measurement to match the raster's unit of measurement. The default is 1.

For example, if the elevation values in the input raster are in meters but the contours are in feet, set the z-factor to 3.28084 (1 meter = 3.28084 feet).

Double
supplemental_contours
(オプション)

Specifies the interval at which supplemental contours will be created. Supplemental contours are used when the terrain change is not large enough to be depicted with consistent contour intervals.

  • NONE—No supplemental contours will be created. This is the default.
  • HALF_AUXILIARY—Supplemental contours will be created at one-half the contour interval.
  • QUARTER_AUXILIARY—Supplemental contours will be created at one-quarter the contour interval.
String
half_auxiliary_code
(オプション)

The code value that will be stored in the contour_code_field parameter value when a half auxiliary contour is identified. The default code will be 3 if the HQC field exists in the input contour feature class.

String
quarter_auxiliary_code
(オプション)

The code value that will be stored in the contour_code_field parameter value when a quarter auxiliary contour is identified. The default code will be 14 if the HQC field exists in the input contour feature class.

String
depression_auxiliary_code
(オプション)

The code value that will be stored in the contour_code_field parameter value when a depression auxiliary contour is identified. The default code will be 22 if the HQC field exists in the input contour feature class.

String
contour_interval
(オプション)

The interval, or distance, between contour lines. This can be any positive number. The default is 20.

Double
base_contour
(オプション)

The value that contours will be generated above and below to cover the entire value range of the input raster. The default is 0.

Double

派生した出力

名前説明データ タイプ
updated_contour_features

The 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

# Create feature layer for area of interest and select a single feature based on the NRN field
arcpy.management.MakeFeatureLayer(r'C:\Data\MapIndex.gdb\MapIndex\TM50_Index','TM50')
arcpy.management.SelectLayerByAttribute('TM50', "NEW_SELECTION", "NRN = 'V7914X17562'", None)

# Setting Local Variables
in_contour_features = r'C:\Data\TDS_7_1.gdb\TDS_CARTO\HypsographyCrv'
in_rasters = r'C:\Data\Monterey.dt2'
contour_height_field = 'ZVH'
contour_code_field = 'HQC'
contour_index_interval = 100
index_code = 1
intermediate_code = 2
depression_code = 5
depression_intermediate_code = 6
depression_contours_count = None
area_of_interest = 'TM50'
z_factor = 1
supplemental_contours = 'NONE'
half_auxiliary_code = '3'
quarter_auxiliary_code = '14'
depression_auxiliary_code = '22'
contour_interval = 20
base_contour = 0

# Calling the Identify Contours to properly attribute contours in HypsographyCrv feature class
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, area_of_interest,
                                   z_factor, supplemental_contours, half_auxiliary_code, quarter_auxiliary_code,
                                   depression_auxiliary_code, contour_interval, base_contour)

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

環境

範囲

ライセンス情報

  • Basic: No
  • Standard: 次のものが必要 Production Mapping
  • Advanced: 次のものが必要 Production Mapping

関連トピック

  • An overview of the Features toolset
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報