Summary
Creates a complete map document (.mxd file) based on a specified map product. The tool uses an area of interest (AOI) feature, a product geodatabase, and elevation data to create a product-specific map document.
Usage
At least one 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 in your installation of Defense Mapping (located in the ReferenceData and Geonames folders) before running this tool.
Multiple output map documents will be created if the Area of Interest parameter has more than one selected feature.
The Area of Interest parameter must have an NRN field. NRN values uniquely identify each processed AOI. The tool returns The selected AOI does not have the necessary fields to create Grids message if the NRN field does not exist.
If the Area of Interest parameter contains more than one selected feature, the map creation process occurs for each selected feature. A map document is created per feature. Features are uniquely identified by their NRN values.
If the Area of Interest parameter value contains more than one selected feature and the Open Map Document parameter is checked, the tool will open the most recent map document created.
When the elevation range within a band is less than the contour interval, the number of bands may need to be reduced to improve representation of the landforms.
Syntax
arcpy.defense.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 | The geodatabase in which the grid, elevation, and feature data used to create the output map document will be stored. | Workspace |
aoi | A feature layer that describes the processing extent. The feature layer must have one or more selected features. The NRN value of each selected feature is appended to the name of the output map document. | Layer |
product | Specifies the type of Defense Mapping cartographic product that will be created. 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 | Specifies the Defense Mapping data model version. This parameter is used with the product parameter to determine the type of defense mapping template to use 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 output map documents will be written. Output map documents are named after each processed NRN value. | Folder |
input_rasters [input_rasters,...] (Optional) | The rasters that will be used 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 and will issue a warning. | Raster Layer |
export_type (Optional) | Specifies how the map document will be exported. 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 is 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 can only be created from an installed Rapid Graphic map document. Modifications that are 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 that are 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) | An input table that contains the Field_Name and Element_Part fields. These fields control the mapping between feature attributes and graphic elements. The default is the PopMapInfo table in the MapIndex database stored in <Installation location>\ArcGIS\ESRIDefenseMapping\Desktop<version>\ReferenceData. | Table |
create_outputfolder (Optional) | Specifies whether a folder will be created to store the output.
| Boolean |
in_contour_interval (Optional) | Specifies the contour interval that will be 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 low and high values, which will represent their actual calculated values.
| String |
Code sample
CreateRapidGraphic example (stand-alone script)
The following code example demonstrates the CreateRapidGraphic function.
# Importing arcpy
import arcpy
# Checking out necessary extensions
arcpy.CheckOutExtension('foundation')
arcpy.CheckOutExtension('defense')
arcpy.CheckOutExtension('Spatial')
arcpy.CheckOutExtension('3D')
# Setting variables to necessary data
workspace = r'C:\Data\MGCP_TRD_4_5.gdb'
area_of_interest = r'C:\DefenseProductFiles\ReferenceData\MapIndex.gdb\MapIndex\TM50_Index'
input_raster = r'C:\Data\Monterey.dt2'
custom_template = r'C:\Data\MTM50_TRD_4_5.mxd'
custom_info_table = r'C:\DefenseProductFiles\ReferenceData\MapIndex.gdb\PopMapInfo'
output_workspace = r'C:\Data\Output'
# Setting variables for input parameters
product_type = 'MTM50'
version = 'TRD_4_5'
export_type = 'PRODUCTION_PDF'
# Creating AOI feature layer
selection_query = "NRN = 'V795X16573'"
arcpy.management.MakeFeatureLayer(area_of_interest, 'AOI')
arcpy.management.SelectLayerByAttribute('AOI', 'NEW_SELECTION', selection_query)
# Running Rapid Graphic tool
arcpy.defense.CreateRapidGraphic(workspace, 'AOI', product_type, version, output_workspace, input_raster, export_type, custom_template, custom_info_table, 'DONT_CREATE_OUTPUTFOLDER')
# Checking in extensions
arcpy.CheckInExtension('foundation')
arcpy.CheckInExtension('defense')
arcpy.CheckInExtension('Spatial')
arcpy.CheckInExtension('3D')
Environments
Licensing information
- Basic: No
- Standard: No
- Advanced: Requires Production Mapping and Defense Mapping and Spatial Analyst and 3D Analyst