Thin Spot Heights (Production Mapping)
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
| 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 |
aoi_field (Optional) | The field that contains a unique identifier for each feature in aoi_field. | Field |
Code Sample
The following ArcGIS Python window script shows how to use the ThinSpotHeights tool. The script runs the BandsFromRaster tool to create input data for ThinSpotHeights. The script references Production Mapping sample data.
import arcpy # use the production mapping sample data n32_dt0 = "C:\\data\\Foundation_Data_Tutorials\\Reference\\DEM\\dted\\w117\\n32.dt0" ElevP = "C:\\data\\Foundation_Data_Tutorials\\MPS-Atlas\\GDB\\SoCal.gdb\\SoCal\\ElevP" # names for feature and raster layer ElevP_Layer = "ElevP_Layer" MakeRas_dt01 = "MakeRas_dt01" # output names rasterBands = "C:\\data\\work.gdb\\rasterBands" elev_thinned = "C:\\data\\work.gdb\\elev_thinned" # Make Feature Layer arcpy.MakeFeatureLayer_management(ElevP, ElevP_Layer) # import the production mapping toolbox arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx') # Make Raster Layer from the sample dted arcpy.MakeRasterLayer_management(n32_dt0, MakeRas_dt01, "", "-117.004166666667 31.9958333333333 -115.995833333333 33.0041666666667", "") # Bands From Raster to create one of the inputs for thin spot heights arcpy.BandsFromRaster_production(MakeRas_dt01, "10", rasterBands, "", "", "") # Thin Spot Heights arcpy.ThinSpotHeights_production(ElevP_Layer, "zv2", rasterBands, elev_thinned, "", "")