Summary
Esri Defense Mapping cartographic production tool that produces a complete map document (.mxd) based on a specified map product. This tool uses an area of interest feature, product geodatabase, and elevation data to create a product-specific map document.
Usage
At least one Area of Interest (AOI) feature must be selected.
The raster extent must be equal to or greater than the AOI extent.
You must have administrative privileges to the following locations:
- Default workspace, as defined in the environments setting
- Scratch workspace, as defined in the environments setting
- <user documents directory>\ArcGIS
- Output MXD workspace defined in the Map Document Workspace parameter
- Output folder for the geodatabase defined in the Input Geodatabase parameter
You must unzip the zipped files contained within your installation of Defense Mapping (located in the ReferenceData and Geonames folders) before executing this tool.
Multiple output map documents are created if the Input Area of Interest has more than one selected feature.
The Input Area of Interest must have an NRN field. NRN values uniquely identify each processed area of interest. The tool returns The selected AOI does not have the necessary fields to create Grids if the NRN field does not exist.
If Input Area of Interest contains more than one selected feature, the map creation process occurs for each selected feature. A new map document is created per feature. Features are uniquely identified by their NRN values.
If Area of Interest contains more than one selected feature and Open Map Document is checked (OPEN_MAP_DOCUMENT in Python), the tool will open the last map document created.
Syntax
CreateRapidGraphic(workspace, aoi, product, version, document_workspace, {input_rasters}, {export_type}, {map_template}, {map_info_table}, {create_outputfolder}, {in_contour_interval})| Parameter | Explanation | Data Type |
workspace | Geodatabase in which the tool stores grid, elevation, and feature data used to create the output map document. | Workspace |
aoi | A feature layer that describes the processing extent. The feature layer must have one or more selected features. Each selected feature's NRN value is appended to the name of the output map document. | Layer |
product | Indicates the type of Defense Mapping cartographic product to create. This parameter controls the grids created during processing, the type of defense mapping template used for the output map document, and the scale used when generating data and graphics.
| String |
version | Indicates the Defense Mapping data model version. This parameter is used with the product parameter to determine the type of defense mapping template used for the output map document. It is optionally used with the product parameter to create an Elevation Guide Box in the output map document.
| String |
document_workspace | The folder to which the tool writes output map documents. Output map documents are named after each processed NRN value. | Folder |
input_rasters [input_rasters,...] (Optional) | Indicates the rasters to use to create elevation bands. If you specify more than one raster, all input rasters must have the same bit depth and number of bands. If there is no raster, the tool will not process the Elevation Guide data frame, prompting a warning. | Raster Layer |
export_type (Optional) | Indicates the type of export. This parameter is used with the product parameter to determine the Defense Mapping settings.
| String |
map_template (Optional) | The path to the custom map document that will be used to produce a complete map. If a custom template is not used, this tool will extract a template from the installation folder based on product type, data model version, and reference scale. A custom map template may only be created from an installed Rapid Graphic map document. Modifications allowed for a custom map template include adding and removing individual data layers, adding and removing graphic elements, changing graphic elements, adding and removing dynamic elements, and changing element tab properties of dynamic surround elements. Modifications not allowed for a custom map template include renaming data frames, modifying data frame properties, removing all data layers, renaming layers, changing area or size, and positioning properties of dynamic surround elements. | ArcMap Document |
map_info_table (Optional) | Input table that contains the Field_Name and Element_Part fields. These fields control the mapping between feature attributes and graphic elements. It defaults to the PopMapInfo table within the MapIndex database stored in <Installation location>\ArcGIS\ESRIDefenseMapping\Desktop10.5.1\ReferenceData. | Table |
create_outputfolder (Optional) | Allows the option to store your output in the same folder as your geodatabase.
| Boolean |
in_contour_interval (Optional) | Indicates the contour interval used to determine the closest contour available when calculating the band area. Bands are created with their limits aligned to the set contour interval, except for low and high values which will represent their actual calculated values.
| String |
Code sample
CreateRapidGraphic example (Python window)
The following code example demonstrates how to execute the CreateRapidGraphic function.
# set gp environment
arcpy.env.addOutputsToMap = True
geodb="c:/data/MGCP_TRD_4_0.gdb"
areaOfInterest = "C:/Program Files (x86)/ArcGIS/EsriDefenseMapping/Desktop10.1/ReferenceData/MapIndex.mdb/MapIndex/TLM100_Index"
areaOfInterestLyr="TLM100IDX"
whereclause="NRN='V695X1856'"
productType="MDG50_TLM"
version="TRD_4_0"
mapDocumentWork="c:/data"
# 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 CreateRapidGraphic tool
arcpy.CreateRapidGraphic_defense(geodb, areaOfInterestLyr, productType, version, mapDocumentWork, rasterLyr)
Environments
Licensing information
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: No
- ArcGIS Desktop Advanced: Requires Production Mapping and Defense Mapping and Spatial Analyst and 3D Analyst