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})
Parameter | Explanation | Data 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.
| 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.
| 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