ArcMap

Suppress Spot Heights

Summary

ArcGIS 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 as invisible.

Usage

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

  • The Input Area of Interest parameter 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.

  • If no representation has been defined in the Input Spot Height Features parameter, the tool returns Error 000735: Representation: Value is required.

Syntax

arcpy.defense.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

Specifies the Defense Mapping specification in conjunction with the Data_Model_Version parameter. The specification equates to a representation name in a Defense Mapping data model.

  • ICM25 —Representations specific to product ICM25 will be used.
  • JOG_A —Representations specific to product JOG_A will be used.
  • MTM50 —Representations specific to product MTM50 will be used.
  • MTM100 —Representations specific to product MTM100 will be used.
  • TM25 —Representations specific to product TM25 will be used.
  • TM50 —Representations specific to product TM50 will be used.
  • TM100 —Representations specific to product TM100 will be used.
String
Data_Model_Version

Specifies the Defense Mapping specification in conjunction with the Product_Type parameter. 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 will be used.
  • TDS_7 —Representations specific to TDS*, ICM*, or JOG* product types will be used.
  • TDS_7_1 —Representations specific to TDS*, ICM*, or JOG* product types will be used.
  • TRD_4_2 —Representations specific to MTM* product types will be used.
  • TRD_4_3 —Representations specific to MTM* product types will be used.
  • TRD_4_4 —Representations specific to MTM* product types will be used.
  • TRD_4_5 —Representations specific to MTM* product types will be used.
  • TRD_4_5_1 —Representations specific to MTM* product types will be used.
  • TRD_4_6 —Representations specific to MTM* product types will be used.
  • VMap1JOGA —Representations specific to JOG* product types will be used.
String
Search_Distance

The distance that will be used 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

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

Feature Layer
Delete_Spot_Height_Features

Specifies whether spot heights will be deleted or the representation will be suppressed.

  • SUPPRESS_FEATURES —The representation of the point features will be suppressed. This is the default.
  • DELETE_FEATURES —Spot height features will be deleted.
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

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

Related topics