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
ThinSpotHeights(in_spot_height_features, in_spot_height_field, in_elevation_band_features, out_feature_class, {in_aoi_features}, {in_aoi_field})| Parameter | Explanation | Data 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 Esri 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
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: Requires Production Mapping
- ArcGIS Desktop Advanced: Requires Production Mapping