Help

Create Elevation Guide Data

Summary

Esri Defense Mapping cartographic production tool that creates data required for an Elevation Guide Box in defense-specific map templates. This tool uses banding and thinning tools to create elevation bands, spot heights, and hydro features for the guide box.

Usage

  • If the Input Hydro Exclusion Features parameter is not set, Product Type is used to locate exclusion hydro features in Input Geodatabase. For MDG* product types, the tool searches for a CoastA feature class within an MGCP feature dataset. For LDG* product types, the tool searches for a HydrographySrf feature class within an LTDS feature dataset.

  • Product Type sets contour interval if the Contour Interval parameter is not populated. For products LDG50_NSG, MDG50_MGCP, and MDG50_TLM, contour interval is set to 20. For products LDG100_NSG, MDG100_MGCP, and MDG100_TLM, contour interval is set to 40.

  • If the Input Spot Height Features is not set, Product Type and Data Model Version are used to locate spot height features in Input Geodatabase. For MDG* product types, the tool uses TRD3 or TRD4 data model dataset naming conventions. For LDG* product types, the tool searches for a HypsographyPnt feature class within an LTDS feature dataset.

  • If the Input Hydro Lines parameter is not set, Product Type is used to locate hydro line features. For MDG* product types, the tool searches for a WatrcrsL feature class in an MGCP feature dataset. For LDG* product types, it searches for a HydrographyCrv in an LTDS feature dataset.

  • If the Input Hydro Areas parameter is not set, Product Type is used to locate hydro area features. For MDG* product types, the tool searches for a WatrcrsA feature class in an MGCP feature dataset. For LDG* product types, it searches for a HydrographySrf in an LTDS feature dataset.

Syntax

CreateElevationGuideData_defense (Input_Geodatabase, Input_Area_of_Interest, Product_Type, Data_Model_Version, Input_Rasters, Input_Hydro_Exclusion_Features, {Contour_Interval}, {Minimum_Feature_Area}, {Smoothing_Tolerance}, Input_Spot_Height_Features, Input_Hydro_Lines, Input_Hydro_Areas, {Minimum_Hydro_Order}, {Minimum_Feature_Size})
ParameterExplanationData Type
Input_Geodatabase

Geodatabase that contains the CARTO feature dataset and EGB* feature classes. Data created for the elevation guide box is appended to the feature classes in this geodatabase.

Workspace
Input_Area_of_Interest

A feature layer with a single selected feature that defines a processing extent for banding operations and a clipping extent for spot heights, input hydro areas, and lines.

Feature Layer
Product_Type

Indicates the type of Defense Mapping cartographic product that will include an Elevation Guide Box. Product Type is used with Data Model Version to refine input hydro exclusion, line, and area features, and input spot height features.

  • MDG50_MGCP —Elevation Guide box for an MDG50_MGCP product
  • MDG100_MGCP —Elevation Guide box for an MDG100_MGCP product
  • MDG50_TLM —Elevation Guide box for an MDG50_TLM product
  • MDG100_TLM —Elevation Guide box for an MDG100_TLM product
  • LDG50_NSG —Elevation Guide box for an LDG50_NSG product
  • LDG100_NSG —Elevation Guide box for an LDG100_NSG product
String
Data_Model_Version

Indicates the Defense Mapping data model version. This parameter is used with Product Type to refine input hydro exclusion, line, and area features, and input spot height features.

  • TRD2 —TRD2 data model for use with MDG* product types
  • TRD3 —TRD3 data model for use with MDG* product types
  • TRD4 —TRD4 data model for use with MDG* product types
  • LTDS_4_0 —LTDS 4 data model for use with LDG* product types
  • LTDS_5_0 —LTDS 5 data model for use with LDG* product types
String
Input_Rasters
[Input_Rasters,...]

Rasters to use to create elevation bands and supply elevation values to Elevation Guide Box data. If you specify more than one raster, all must have the same bit depth and number of bands.

Raster Layer
Input_Hydro_Exclusion_Features

A feature layer that defines a large water body area to exclude from the elevation band area computation.

Feature Layer
Contour_Interval
(Optional)

Elevation band contour interval in meters. If not set, the value is controlled by the Product Type parameter.

String
Minimum_Feature_Area
(Optional)

Indicates a minimum area for output polygons created during the elevation banding process. The default is 0.00016 square decimal degrees.

Double
Smoothing_Tolerance
(Optional)

Controls the smoothing tolerance used by the Smooth Polygon tool during elevation banding processing. Smoothing adds vertices to sharp angles. Larger values create more generalized elevation bands. The default is 0.02 decimal degrees.

Linear Unit
Input_Spot_Height_Features

Feature layer or class that contains spot heights. If this parameter is not set, the Product Type and Data Model Version parameters control which feature class is used from the Input Geodatabase.

Feature Layer
Input_Hydro_Lines

Hydro lines features used in the Elevation Guide Box data. These features are generalized through a thinning process. If this parameter is not set, the Product Type parameter controls which feature class is used from the Input Geodatabase.

Feature Layer
Input_Hydro_Areas

Hydro area features used in the Elevation Guide Box data. These features are generalized through a thinning process. If this parameter is not set, the Product Type parameter controls which feature class is used from the Input Geodatabase.

Feature Layer
Minimum_Hydro_Order
(Optional)

The minimum hydro order value used to eliminate features. The tool will thin hydro features that have a stream order value less than this number. This value is used when generalizing Input Hydro Lines and Areas. The default value is 20.

Long
Minimum_Feature_Size
(Optional)

Minimum area used to eliminate small, nonmain hydro polygons. This value is used when generalizing Input Hydro Areas. The default value is 0.

Double

Code sample

CreateElevationGuideData example (Python window)

The following code example demonstrates how to use the CreateElevationGuideData tool.

# set gp environment
arcpy.env.addOutputsToMap = True

# local variables
geodb="c:/data/CARTO.gdb"
areaOfInterest = "C:/Program Files (x86)/ArcGIS/EsriDefenseMapping/Desktop10.1/ReferenceData/MapIndex.mdb/MapIndex/TLM100_Index"
areaOfInterestLyr="TLM100IDX"
whereclause="NRN='V695X1856'"
productType="MDG50_TLM"
dataModel="TRD2"

# raster N35.DT2 is located in c:/data/W121
raster="c:/data/W121/N36.DT2"
rasterLyr="n36"

# make a feature layer from the raster and area of interest
arcpy.MakeRasterLayer_management(raster,rasterLyr)
arcpy.MakeFeatureLayer_management(areaOfInterest,areaOfInterestLyr)
arcpy.SelectLayerByAttribute_management(areaOfInterestLyr,"NEW_SELECTION",whereclause)

desc=arcpy.Describe(areaOfInterestLyr)
fidlist=desc.FIDSet.split(";")
if len(fidlist) == 1:
	# execute the CreateElevationGuideData
	arcpy.CreateElevationGuideData_defense(geodb,areaOfInterestLyr,productType,dataModel,rasterLyr)

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: No
  • ArcGIS Desktop Advanced: Requires Defense Mapping and Spatial Analyst and 3D Analyst

Related topics