Generate Location Diagram Features (Topographic Production Tools)

Summary

Generates location diagram features for a Joint Operations Graphic (JOG), Operational Navigation Chart (ONC), or Tactical Pilotage Chart (TPC) map sheet. The location diagram must include JOG_Index features, WAC_Index features, ONC_Index features, or LandPoly features for the area surrounding the processed sheet.

Note:

A product data file installer is available for ArcGIS Topographic Mapping. The product files contain a geodatabase named MapIndex.gdb that is necessary for generating features used in this tool.

Usage

At a minimum, the following feature classes will be generated in the target feature dataset:
- LD_AOI—This feature class will store the extent of the entire diagram, a 5-by-5 grid, as one feature.
- JOG_AOI—This feature class will store the Area of Interest parameter value at the center of the 5-by-5 grid from the selected sheet.
- JOG_SHEETS_A—This feature class will be generated to support labeling and display requirements.
- JOG_SHEETS_L—This feature class will be generated to support labeling and display requirements.
- JOG_ONC—This feature class will be generated if ONC_Index features are provided.
- JOG_WAC—This feature class will be generated if WAC_Index features are provided.
- JOG_COAST_A—This feature class will be generated if input land features are provided.
- JOG_COAST_L—This feature class will be generated if input coastline features are provided.
The Area of Interest parameter value must have only one selected feature.
If the input feature dataset contains existing feature classes, they will be deleted before the tool generates location diagram features.

Label	Explanation	Data type
Input Feature Dataset	The feature dataset that will contain the location diagram feature classes. The tool will create these features classes if they do not exist.	Feature Dataset
Area of Interest	A polygon feature layer with a single selected feature that will be used to identify the center and surrounding areas of interest.	Feature Layer
Sheet Identifier Field	An attribute field that will be used to identify the generated sheet features. The default value of `JOG_SHEET` will be used if the field is present in the layer provided for the Area of Interest parameter value. Otherwise, provide a different field.	Field
WAC Features	The World Aeronautical Chart features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
ONC Features	The ONC features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
Land Features	The land features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
Specification (Optional)	Specifies the type of map product for which the location diagram features will be generated. JOG—The location diagram features for a Joint Operations Graphic will be generated. This is the default. ONC—The location diagram features for an Operational Navigation Chart will be generated. This option activates the TPC Features parameter, Smoothing Tolerance parameter, and Hydro Settings (optional) category containing the following parameters: Hydro Line Features, Hydro Area Features, Minimum Hydro Line Length, Minimum Hydro Line Spacing, Minimum Hydro Area Length, and Minimum Hydro Area Width. TPC—The location diagram features for a Tactical Pilotage Chart will be generated. This option activates the Smoothing Tolerance parameter and the Hydro Settings (optional) category containing the following parameters: Hydro Line Features, Hydro Area Features, Minimum Hydro Line Length, Minimum Hydro Line Spacing, Minimum Hydro Area Length, and Minimum Hydro Area Width.	String
TPC Features (Optional)	The TPC features that will be used to generate the location diagram feature classes in the input geodatabase. This parameter is available when generating location diagram features for an ONC map product.	Feature Layer
Smoothing Tolerance (Optional)	The tolerance that will be used by the smoothing algorithm. The larger the value, the more generalized the output location diagram features. This parameter is available when generating location diagram features for ONC or TPC map products. The default is 0.002 decimal degrees.	Linear Unit
Hydro Line Features (Optional)	The hydrology line features that will be used to generate the output of a thinned hydrology dataset. Only the output features will be generalized through this thinning process. This parameter is available when generating location diagram features for ONC or TPC map products.	Feature Layer
Hydro Area Features (Optional)	The hydrology area features that will be used to generate the thinned hydrology dataset. Only the output features will be generalized through this thinning process. This parameter is available when generating location diagram features for ONC or TPC map products.	Feature Layer
Minimum Hydro Line Length (Optional)	The minimum length that will be used to eliminate hydrology features. The tool will thin hydrology features that have a length less than this value. This value will be used when generalizing input hydro lines and areas. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
Minimum Hydro Line Spacing (Optional)	The shortest distance between hydrographic segments that will display at the output scale. If the spacing between two parallel trending features is smaller than this value, one of the features will be hidden. This parameter defines the density of the resulting thinned hydrography. It should correspond to the distance between two parallel trending features that is visually significant to include at the final scale. When the density of features is too high (that is, the features are too closely spaced), at least one feature will be hidden. This can result in important features or features longer than the Minimum Hydro Line Length value being hidden. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
Minimum Hydro Area Length (Optional)	The length that will be used to split and classify hydrographic polygons as short or long. Polygons will be split at any location where the edge-to-edge distance is equal to this value. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
Minimum Hydro Area Width (Optional)	The width that will be used to split and classify hydrographic polygons as narrow or wide. Polygons will be split at any location where the edge-to-edge distance is equal to this value. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
Minimum Island Area (Optional)	The minimum area necessary for an island or hole to be included in the resulting features.	Areal Unit

Derived output

Label	Explanation	Data type
Modified Feature Dataset	The updated input feature dataset that contains the location diagram feature classes.	Feature Dataset

arcpy.topographic.GenerateLocationDiagramFeatures(in_feature_dataset, area_of_interest, sheet_id_field, wac_features, onc_features, land_features, {specification}, {tpc_features}, {smooth_tolerance}, {hydro_line_features}, {hydro_area_features}, {hydroline_minlength}, {hydroline_minspacing}, {hydroarea_minlength}, {hydroarea_minwidth}, {min_island_area})

Name	Explanation	Data type
in_feature_dataset	The feature dataset that will contain the location diagram feature classes. The tool will create these features classes if they do not exist.	Feature Dataset
area_of_interest	A polygon feature layer with a single selected feature that will be used to identify the center and surrounding areas of interest.	Feature Layer
sheet_id_field	An attribute field that will be used to identify the generated sheet features. You can use the `JOG_SHEET` field as the value for this parameter if the field is present in the layer specified by the `area_of_interest` parameter value.	Field
wac_features	The World Aeronautical Chart features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
onc_features	The ONC features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
land_features	The land features that will be used to generate the location diagram feature classes in the input geodatabase. The default path is specified for this parameter if the Topographic Mapping product files are installed.	Feature Layer
specification (Optional)	Specifies the type of map product for which the location diagram features will be generated. `JOG`—The location diagram features for a Joint Operations Graphic will be generated. This is the default. `ONC`—The location diagram features for an Operational Navigation Chart will be generated. This option activates the following additional parameters: `tpc_features`, `smooth_tolerance`, `hydro_line_features`, `hydro_area_features`, `hydroline_minlength`, `hydroline_minspacing`, `hydroarea_minlength`, and `hydroarea_minwidth`. `TPC`—The location diagram features for a Tactical Pilotage Chart will be generated. This option activates the following additional parameters: `smooth_tolerance`, `hydro_line_features`, `hydro_area_features`, `hydroline_minlength`, `hydroline_minspacing`, `hydroarea_minlength`, and `hydroarea_minwidth`.	String
tpc_features (Optional)	The TPC features that will be used to generate the location diagram feature classes in the input geodatabase. This parameter is available when generating location diagram features for an ONC map product.	Feature Layer
smooth_tolerance (Optional)	The tolerance that will be used by the smoothing algorithm. The larger the value, the more generalized the output location diagram features. This parameter is available when generating location diagram features for ONC or TPC map products. The default is 0.002 decimal degrees.	Linear Unit
hydro_line_features [hydro_line_features,...] (Optional)	The hydrology line features that will be used to generate the output of a thinned hydrology dataset. Only the output features will be generalized through this thinning process. This parameter is available when generating location diagram features for ONC or TPC map products.	Feature Layer
hydro_area_features [hydro_area_features,...] (Optional)	The hydrology area features that will be used to generate the thinned hydrology dataset. Only the output features will be generalized through this thinning process. This parameter is available when generating location diagram features for ONC or TPC map products.	Feature Layer
hydroline_minlength (Optional)	The minimum length that will be used to eliminate hydrology features. The tool will thin hydrology features that have a length less than this value. This value will be used when generalizing input hydro lines and areas. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
hydroline_minspacing (Optional)	The shortest distance between hydrographic segments that will display at the output scale. If the spacing between two parallel trending features is smaller than this value, one of the features will be hidden. This parameter defines the density of the resulting thinned hydrography. It should correspond to the distance between two parallel trending features that is visually significant to include at the final scale. When the density of features is too high (that is, the features are too closely spaced), at least one feature will be hidden. This can result in important features or features longer than the `hydroline_minlength` value being hidden. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
hydroarea_minlength (Optional)	The length that will be used to split and classify hydrographic polygons as short or long. Polygons will be split at any location where the edge-to-edge distance is equal to this value. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
hydroarea_minwidth (Optional)	The width that will be used to split and classify hydrographic polygons as narrow or wide. Polygons will be split at any location where the edge-to-edge distance is equal to this value. This parameter is available when generating location diagram features for ONC or TPC map products.	Linear Unit
min_island_area (Optional)	The minimum area necessary for an island or hole to be included in the resulting features.	Areal Unit

Derived output

Name	Explanation	Data type
modified_feature_dataset	The updated input feature dataset that contains the location diagram feature classes.	Feature Dataset

Code sample

GenerateLocationDiagramFeatures example (stand-alone script)

The following code sample demonstrates how to use the GenerateLocationDiagramFeatures function.

# Name: GenerateLocationDiagramFeatures_sample.py
# Description: Creates the Location Diagram for a Joint Operations Graphic (JOG) map sheet.
# The Location Diagram needs the JOG_Index features, WAC_Index features, ONC_Index features,
# and the LandPoly features for the area surrounding the processed sheet.

# Import System Modules
import arcpy

# Setting the environment
arcpy.env.overwriteOutput = True

# Create layer and select single AOI for processing
arcpy.management.MakeFeatureLayer(r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\Mapindex.gdb\MapIndex\JOG_Index', 'JOG')
arcpy.management.SelectLayerByAttribute('JOG', 'NEW_SELECTION', "NRN = '1501ANJ1012'")

# Setting Local Variables
in_feature_dataset = r'C:\Data\JOG.gdb\LD'
area_of_interest = 'JOG'
sheet_id_field = 'JOG_SHEET'
wac_features = r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\Mapindex.gdb\MapIndex\WAC_Index'
onc_features = r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\Mapindex.gdb\MapIndex\ONC_Index'
land_features = r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\Mapindex.gdb\Reference\LandPoly'
specification = 'JOG'
tpc_features = ''
smooth_tolerance = '0.002 DecimalDegrees'
hydro_line_features  = None
hydro_area_features = None
hydroline_minlength = None
hydroline_minspacing = None
hydroarea_minlength = None
hydroarea_minwidth = None
min_island_area = ''

# Use the Generate Adjoining Sheet Features tool to create data required for the Adjoining Sheet Guide
arcpy.topographic.GenerateLocationDiagramFeatures(in_feature_dataset, area_of_interest, sheet_id_field, wac_features, onc_features,
                                                  land_features, specification, tpc_features, smooth_tolerance, hydro_line_features,
                                                  hydro_area_features, hydroline_minlength, hydroline_minspacing, hydroarea_minlength,
                                                  hydroarea_minwidth, min_island_area)

Environments

Scratch Workspace

Licensing information

Basic: No
Standard: No
Advanced: Requires Topographic Mapping

Generate Location Diagram Features (Topographic Production Tools)

Summary

Note:

Usage

Parameters

Derived output

Environments

Licensing information

Related topics