Surface Slope (3D Analyst)

Summary

Creates polygon features that represent ranges of slope values for triangulated surfaces.

Illustration

Surface Slope

Usage

  • The surface normal of each triangle, which is given by the vector cross-product of two triangle edges, is used to determine slope in percent or degrees. Percent slope describes the surface normal's ratio of change in height to change in horizontal distance, whereas degree slope is the angle of inclination between the surface normal and a horizontal plane.

  • Each resulting polygon represents a range of slope values based on the classification breaks used when executing the tool. The default classification breaks divide slope measurements into nine groups and are indicated below:

    SLOPE CODEPERCENT DEGREE RANGE

    1

    0.00 — 1.00

    0.00 — 0.57

    2

    1.00 — 2.15

    0.57 — 1.43

    3

    2.15 — 4.64

    1.43 — 2.66

    4

    4.64 — 10.0

    2.66 — 5.71

    5

    10.00 — 21.50

    5.71 — 12.13

    6

    21.50 — 46.40

    12.13 — 24.89

    7

    46.40 — 100.0

    24.89 — 45.00

    8

    100.0 — 1000.0

    45.00 — 84.29

    9

    1000.0 <

    84.29 — 90.0

  • Slope classifications may be customized by specifying a table with up to two fields of numeric values in the Class Breaks Table parameter. The first column identifies the break points of the slope classification. If a second column is provided, its values will be used to associate a code that gets attributed for each polygon feature. If the table below was used, all slope values from 0 to 10 will be represented by a code of 1, 10 to 25 by a code of 2, and so on. The class break units of the table are set in the Slope Units (units) parameter.

    CLASS_BREAKCODE

    10.0

    1

    25.0

    2

    40.0

    3

    70.0

    4

    The table can be in any supported format (.dbf, .txt, or geodatabase table). The name of the fields are irrelevant, as the first will always be used for the class breaks and the second for the aspect codes.

Parameters

LabelExplanationData Type
Input Surface

The TIN, terrain, or LAS dataset whose slope measurements will be written to the output polygon feature.

LAS Dataset Layer; Terrain Layer; TIN Layer
Output Feature Class

The feature class that will be produced.

Feature Class
Slope Units
(Optional)

The units of measure to be used in calculating slope.

  • PercentSlope is expressed as a percentage value. This is the default.
  • DegreeSlope is expressed as the angle of inclination from a horizontal plane.
String
Class Breaks Table
(Optional)

A table containing classification breaks that will be used to group the output features. The first column of this table will indicate the break point, whereas the second will provide the classification code.

Table
Slope Field
(Optional)

The field containing slope values.

String
Z Factor
(Optional)

The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z datum with a specified linear unit.

Double
Pyramid Level Resolution
(Optional)

The z-tolerance or window-size resolution of the terrain pyramid level that will be used. The default is 0, or full resolution.

Double

arcpy.ddd.SurfaceSlope(in_surface, out_feature_class, {units}, {class_breaks_table}, {slope_field}, {z_factor}, {pyramid_level_resolution})
NameExplanationData Type
in_surface

The TIN, terrain, or LAS dataset whose slope measurements will be written to the output polygon feature.

LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class

The feature class that will be produced.

Feature Class
units
(Optional)

The units of measure to be used in calculating slope.

  • PERCENTSlope is expressed as a percentage value. This is the default.
  • DEGREESlope is expressed as the angle of inclination from a horizontal plane.
String
class_breaks_table
(Optional)

A table containing classification breaks that will be used to group the output features. The first column of this table will indicate the break point, whereas the second will provide the classification code.

Table
slope_field
(Optional)

The field containing slope values.

String
z_factor
(Optional)

The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z datum with a specified linear unit.

Double
pyramid_level_resolution
(Optional)

The z-tolerance or window-size resolution of the terrain pyramid level that will be used. The default is 0, or full resolution.

Double

Code sample

SurfaceSlope example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

arcpy.env.workspace = "C:/data"
arcpy.SurfaceSlope_3d("sample.gdb/featuredataset/terrain", "slope.shp", "PERCENT")
SurfaceSlope example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''****************************************************************************
Name: SurfaceSlope Example
Description: This script demonstrates how to use the
             SurfaceAspect and SurfaceSlope tools to generate a polygon
             that contains the intersection of both
****************************************************************************'''

# Import system modules
import arcpy

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

# List all TINs in workspace
listTINs = arcpy.ListDatasets("","TIN")

# Determine whether the list contains any TINs
if len(listTINs) > 0:
    for dataset in listTINs:
        print(dataset)
        # Set Local Variables
        aspect = arcpy.CreateUniqueName("Aspect.shp")
        slope = arcpy.CreateUniqueName("Slope.shp")
        outFC = dataset + "_Aspect_Slope.shp"
        #Execute SurfaceAspect
        arcpy.SurfaceAspect_3d(dataset, aspect)
        #Execute SurfaceSlope
        arcpy.SurfaceSlope_3d(dataset, slope)
        #Execute SurfaceSlope
        print("Starting Intersect")
        arcpy.Intersect_analysis(aspect + " #;" + slope + " #", outFC, "ALL")
        print("Completed intersect for " + dataset)
else:
    print("There are no TINs in the " + env.workspace + " directory.")

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics