ArcMap

Thin Spot Heights

Available with Production Mapping license.

Summary

Creates a band-specific elevation spot heights feature class from a spot heights feature class and elevation bands feature class. The resulting feature class is used by the Elevation Guide Bar surround element for display purposes.

Usage

  • You must run the Bands From Raster geoprocessing tool prior to running this tool in order to create the elevation band feature class used in the Input Elevation Band Features (in_elevation_band_features) parameter.

  • You will need to have an existing spot heights feature class in order to select spot heights.

  • Spot heights are determined based on the extent of the area of interest (AOI) and an existing elevation band feature class.

  • The resulting band-specific elevation spot heights feature class will have an elevation attribute. This attribute originates from the input spot heights feature class and contains height values. It also has an AOI attribute for the name of AOI polygon features used in the thinning process.

  • The tool creates a maximum of 10 spot height features in the Output Feature Class (out_feature_class). These features are the 9 highest points and the lowest point in the extent chosen.

  • Below sea level spot heights are shown with a negative number.

Syntax

arcpy.production.ThinSpotHeights(in_spot_height_features, in_spot_height_field, in_elevation_band_features, out_feature_class, {in_aoi_features}, {in_aoi_field})
ParameterExplanationData Type
in_spot_height_features

The spot heights feature class or feature layer that contains the spot height features to thin.

Feature Layer
in_spot_height_field

The spot height field that contains the spot height values.

Field
in_elevation_band_features

The elevation band feature class or feature layer that is created using the Bands From Raster geoprocessing tool.

Feature Layer
out_feature_class

The new or existing spot heights feature class that contains the spot heights after the thinning process is performed. When an existing feature class is used, thinning will overwrite the existing spot heights in the feature class.

Feature Class
in_aoi_features
(Optional)

The area of interest (AOI) feature class that is used to clip input spot height features. The thinning algorithm is executed on each extent of the AOI feature and results are written to the output elevation spot heights feature class specified in the out_feature_class parameter.

Feature Layer
in_aoi_field
(Optional)

The field that contains a unique identifier for each feature in aoi_field.

Field

Code sample

ThinSpotHeights example (Python window)

The following ArcGIS Python window script shows how to use the ThinSpotHeights tool.

# NOTE: This script requires ArcGIS Production Mapping and Spatial Analyst

import arcpy

# variables used by gp tools
cellSize='0.0005'
cellType="MAXIMUM_LENGTH"
contourField="elevation"
contourL = "TopographicMap/ContourL"
elevations="TopographicMap/ElevationP"
elevationsLayer="elevationsLayer"
priorityFld='NONE'
raster = "contour_raster"
rasBnds = "raster_bands"
thinned = "thinned_heights"
workspace="c:/data/Austin.gdb"

# set gp environment
arcpy.env.workspace=workspace
arcpy.env.overwriteOutput = True
arcpy.env.addOutputsToMap = True

# Bands from Raster requires a Raster - use the PolylineToRaster tool to
# create a raster from the Austin.gdb sample data
arcpy.PolylineToRaster_conversion(contourL,contourField, raster, cellType, priorityFld, cellSize)

# execute Bands From Raster using the contours raster just created
arcpy.BandsFromRaster_production(raster, "10", rasBnds)

# create a feature layer from elevation points
arcpy.MakeFeatureLayer_management(elevations,elevationsLayer)

# execute Thin Spot Heights using elevation points and the output of
# BandsFromRaster
arcpy.ThinSpotHeights_production(elevationsLayer, "Elevation", rasBnds, thinned)

Environments

Licensing information

  • Basic: No
  • Standard: Requires Production Mapping
  • Advanced: Requires Production Mapping

Related topics