ArcMap

Suppress Spot Heights

Summary

Esri Defense Mapping cartographic production tool that suppresses the symbol for spot heights based on the input product type. Suppressing a symbol refers to setting a representation invisible.

Usage

  • This tool uses the Make Representations Invisible tool to suppress spot height symbols.

  • The Input Area of Interest must have an NRN field. The NRN field uniquely identifies an area of interest within the input area of interest features.

  • Suppression uses a search radius to locate spot heights that are close to one another. Spot heights are sorted by elevation in descending order. This tool suppresses lower spot heights that fall within the search radius of a higher spot height.

  • Suppression refers to making a representation within a feature class invisible. If no representation has been defined on the Input Spot Height Features, the tool returns Error 000735: Representation: Value is required.

Syntax

SuppressSpotHeights(Input_Area_of_Interest, Product_Type, Data_Model_Version, Search_Distance, Input_Spot_Height_Features, Delete_Spot_Height_Features, {Input_Contours})
ParameterExplanationData Type
Input_Area_of_Interest

A feature layer that describes the processing extent. The tool suppresses spot heights found in each feature in the feature layer. Select features in this feature layer to limit the processing area.

Feature Layer
Product_Type

Used with Data_Model_Version to determine the Defense Mapping specification. The specification equates to a representation name in a Defense Mapping data model.

  • ICM25 —Representations specific to product ICM25
  • JOG_A —Representations specific to product JOG_A
  • MTM50 —Representations specific to product MTM50
  • MTM100 —Representations specific to product MTM100
  • TM25 —Representations specific to product TM25
  • TM50 —Representations specific to product TM50
  • TM100 —Representations specific to product TM100
String
Data_Model_Version

Used with Product_Type to determine the Defense Mapping specification. The specification equates to a representation name in a Defense Mapping data model.

  • TDS_6_1 —Representations specific to TDS*, ICM*, or JOG* product types
  • TDS_7 —Representations specific to TDS*, ICM*, or JOG* product types
  • TRD_4_2 —Representations specific to MTM* product types
  • TRD_4_3 —Representations specific to MTM* product types
  • TRD_4_4 —Representations specific to MTM* product types
  • TRD_4_5 —Representations specific to MTM* product types
  • VMap1JOGA —Representations specific to JOG* product types
String
Search_Distance

Search distance to locate spot heights that are close to other spot heights. Spot heights found within this distance will be made invisible.

Linear unit
Input_Spot_Height_Features

An existing Defense Mapping point feature layer in which representations will be made invisible.

Feature Layer
Delete_Spot_Height_Features

Determines if this tool will delete spot heights or suppress the representation.

  • SUPPRESS_FEATURES —Suppresses the representation of the point features. This is the default.
  • DELETE_FEATURES —Deletes spot height features.
Boolean
Input_Contours
(Optional)

The input contour features for which the spot heights symbol will be suppressed.

Feature Layer

Code sample

SuppressSpotHeights example (Python window)

The following code sample demonstrates how to use the SuppressSpotHeights function.

# set gp environment
arcpy.env.workspace="c:/data/defense.gdb"
arcpy.env.addOutputsToMap = True

# local variables
areaOfInterest = "C:/Program Files (x86)/ArcGIS/EsriDefenseMapping/Desktop10.1/ReferenceData/MapIndex.mdb/MapIndex/TLM100_Index"
areaOfInterestLyr="TLM100IDX"
whereclause="NRN='V695X1856'"
productType="MDG100_MGCP"
dataModel="TRD2"
searchDistance="1300 meters"
spotHeightFeatures="Features/ElevP"
spotHeightFeaturesLyr="ElevPLyr"
deleteSpotHeightFeatures = "DELETE_FEATURES"

# make a feature layer from area of interest and spot heights
arcpy.MakeFeatureLayer_management(spotHeightFeatures,spotHeightFeaturesLyr)
arcpy.MakeFeatureLayer_management(areaOfInterest,areaOfInterestLyr)
arcpy.SelectLayerByAttribute_management(areaOfInterestLyr,"NEW_SELECTION",whereclause)

desc=arcpy.Describe(areaOfInterestLyr)
fidlist=desc.FIDSet.split(";")
if len(fidlist) == 1:
    # suppress the spot heights
    arcpy.SuppressSpotHeights_defense(areaOfInterestLyr, productType, dataModel,searchDistance,spotHeightFeaturesLyr,deleteSpotHeightFeatures)

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: No
  • ArcGIS Desktop Advanced: Requires Defense Mapping

Related topics