Available with 3D Analyst license.
Summary
Creates a feature class of selected contour values from a raster surface.
Usage
Contours do not extend beyond the spatial extent of the raster, and they are not generated in areas of NoData; therefore, adjacent contour inputs should first be edgematched into a continuous feature dataset. As an alternative to edgematching, you can merge the adjacent rasters before computing contours.
Contours can be generated in areas of negative raster values. The contour values will be negative in such areas. Negative contour intervals are not allowed.
The contour values do not need to be sorted in order.
If you have the ArcGIS Spatial Analyst extension available, smoother but less accurate contours can be obtained by preprocessing the input raster with a Focal Statistics operation with the MEAN option or the Filter tool with the LOW option.
If the output extent is changed from the default, Resampling of the input raster may occur. To avoid this, and to ensure consistent results, set the Snap Raster environment to be the input raster.
When the input raster needs to be resampled, the Bilinear technique will be used. An example of when an input raster may be resampled is when the output coordinate system, extent, or cell size is different from that of the input.
Syntax
ContourList_3d (in_raster, out_polyline_features, contour_values)
| Parameter | Explanation | Data Type |
in_raster |
The input surface raster. | Raster Layer |
out_polyline_features | The output contour polyline features. | Feature Class |
contour_values [contour_value,...] | List of z-values for which to create contours. | Double |
Code Sample
ContourList example 1 (Python window)
This example creates contours for three elevation values from an Esri Grid raster and outputs them as a shapefile.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ContourList_3d("elevation", "C:/sapyexamples/output/outcontourlist.shp",
"600; 935; 1237.4")
ContourList example 2 (stand-alone script)
This example creates contours for three elevation values from an Esri Grid raster and outputs them as a shapefile.
# Name: ContourList_3d_Ex_02.py
# Description: Creates contours or isolines based on a list of contour values.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
contourIntervalList = "600; 935; 1237.4"
outContours = "C:/output/outcontlist.shp"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute ContourList
arcpy.ContourList_3d(inRaster, outContours, contourIntervalList)
Environments
- Auto Commit
- Cell Size
- Current Workspace
- Default Output Z Value
- Extent
- Geographic Transformations
- M Resolution
- M Tolerance
- Maintain Spatial Index
- Output CONFIG Keyword
- Output Coordinate System
- Output has M values
- Output has Z values
- Output M Domain
- Output XY Domain
- Output Z Domain
- Scratch Workspace
- Snap Raster
- XY Resolution
- XY Tolerance
- Z Resolution
- Z Tolerance
Licensing Information
- ArcGIS for Desktop Basic: Requires 3D Analyst or Spatial Analyst
- ArcGIS for Desktop Standard: Requires 3D Analyst or Spatial Analyst
- ArcGIS for Desktop Advanced: Requires 3D Analyst or Spatial Analyst