Generate Adjoining Sheets Features (Topographic Production Tools)

Summary

Generates the features necessary for display in an adjoining sheets diagram on a specification-driven topographic map.

The tool will create the following:

Sheet polygons for labeling
Sheet lines for symbolizing sheets from different series uniquely
Coastal polygons for displaying open water
Coastal polylines for displaying shoreline
A calculated area of interest (AOI) for generating the feature grid for the diagram

Usage

At a minimum, the tool will create the following feature classes in the target feature dataset:
- ASG_SHEETS_A
- ASG_SHEETS_L
- ASG_AOI
If the Input Land Features parameter value is specified, the ASG_COAST_A feature class will be created if the land features do not fully cover the calculated AOI for the adjoining sheets diagram. When the ASG_COAST_A feature class is created, the tool will also create the ASG_COAST_L feature class and calculate and clip coastline features for display in the adjoining sheets diagram.
The Area Of Interest parameter value must have only one selected feature.
Attributes from the Area Of Interest parameter value will be copied to the output ASG_SHEETS_A and ASG_SHEETS_L feature classes to support labeling and display requirements within the adjoining sheets diagram.
The Scale and Area Of Interest parameter values will be used together to locate surrounding sheets. The extent of the Area Of Interest parameter value will be expanded by a factor in the latest map specification guidance to determine how many surrounding sheets are included in the adjoining sheets diagram. Typically, the resulting diagrams represent nine sheets including the AOI at the center.
When using a custom AOI, the optional Buffer Size parameter can be specified to define which sheets are included in the adjoining sheets diagram. Set the Scale parameter to None to use the Buffer Size parameter.

Label	Explanation	Data type
Input Feature Dataset	An existing feature dataset that will contain the ASG_ feature classes. The feature classes will be created if they do not exist.	Feature Dataset
Area Of Interest	A feature layer with a single selected feature that will be used to identify the center and surrounding AOIs. Adjoining sheets features will be created from the selected AOI and the intersecting AOIs as required.	Feature Layer
Input Land Features (Optional)	Land features that will be used to generate adjoining sheets features in the ASG_COAST_A and ASG_COAST_L feature classes in the target feature dataset.	Feature Layer
Scale (Optional)	Specifies the factor by which the extent of the Area Of Interest parameter value will be expanded. The expanded extent will be used to select adjoining AOIs. Data from the adjoining AOIs will be included in the adjoining sheets diagram. 1:25000—The specification MIL-T-89301A will be used as a guide to determine how to expand the width and height of the extent of the Area Of Interest parameter value. 1:50000—The specification MIL-T-89301A will be used to determine how to expand the width and height of the extent of the Area Of Interest parameter value. This is the default. 1:100000—The specification MIL-T-89306 will be used to determine how to expand the width and height of the extent of the Area Of Interest parameter value. None—No guide will be used to determine how to expand the width and height of the extent of the Area Of Interest parameter value. Instead, the Buffer Size parameter will become available to define the expansion.	String
Clip AOI to Sheets (Optional)	Specifies whether the AOI created for the extent of the adjoining sheets diagram will be clipped to the extents of the sheets to be displayed. Checked—The AOI feature will be clipped by the sheets to be displayed in the adjoining sheet diagram and may have an irregular shape. This is the default. Unchecked—The AOI feature will not be clipped and will retain its originally calculated rectangular shape. This may result in partial sheets being displayed in the adjoining sheets diagram.	Boolean
Buffer Size (Optional)	The size of the buffer that will be used to select sheets over a custom AOI. This parameter is active when the Scale parameter is set to None.	Linear Unit

Derived output

Label	Explanation	Data type
Modified Feature Dataset	The feature dataset with updated ASG features.	Feature Dataset

arcpy.topographic.GenerateAdjoiningSheetsFeatures(in_feature_dataset, area_of_interest, {land_features}, {scale}, {clip_aoi_to_sheets}, {buffer_size})

Name	Explanation	Data type
in_feature_dataset	An existing feature dataset that will contain the ASG_ feature classes. The feature classes will be created if they do not exist.	Feature Dataset
area_of_interest	A feature layer with a single selected feature that will be used to identify the center and surrounding AOIs. Adjoining sheets features will be created from the selected AOI and the intersecting AOIs as required.	Feature Layer
land_features (Optional)	Land features that will be used to generate adjoining sheets features in the ASG_COAST_A and ASG_COAST_L feature classes in the target feature dataset.	Feature Layer
scale (Optional)	Specifies the factor by which the extent of the `area_of_interest` parameter value will be expanded. The expanded extent will be used to select adjoining areas of interest. Data from the adjoining AOIs will be included in the adjoining sheets diagram. `1:25000`—The specification MIL-T-89301A will be used as a guide to determine how to expand the width and height of the extent of the `area_of_interest` parameter value. `1:50000`—The specification MIL-T-89301A will be used to determine how to expand the width and height of the extent of the `area_of_interest` parameter value. This is the default. `1:100000`—The specification MIL-T-89306 will be used to determine how to expand the width and height of the extent of the `area_of_interest` parameter value. `None`—No guide will be used to determine how to expand the width and height of the extent of the `area_of_interest` parameter value. Instead, the `buffer_size` parameter will become available to define the expansion.	String
clip_aoi_to_sheets (Optional)	Specifies whether the AOI created for the extent of the adjoining sheets diagram will be clipped to the extents of the sheets to be displayed. `CLIP_AOI`—The AOI feature will be clipped by the sheets to be displayed in the adjoining sheet diagram and may have an irregular shape. This is the default. `DONT_CLIP_AOI`—The AOI feature will not be clipped and will retain its originally calculated rectangular shape. This may result in partial sheets being displayed in the adjoining sheets diagram.	Boolean
buffer_size (Optional)	The size of the buffer that will be used to select sheets over a custom AOI. This parameter is active when the `Scale` parameter is set to `None`.	Linear Unit

Derived output

Name	Explanation	Data type
modified_feature_dataset	The feature dataset with updated ASG features.	Feature Dataset

Code sample

GenerateAdjoiningSheetsFeatures example 1 (stand-alone script)

The following code sample demonstrates how to use the GenerateAdjoiningSheetsFeatures function to create the features necessary for an adjoining sheet diagram typically found in a topographic map product.

# Name: GenerateAdjoiningSheetsFeatures_sample1.py
# Description: Use the Generate Adjoining Sheets Features tool to create the features necessary for an adjoining sheet
# diagram typically found in a topographic map product.

# Import System Modules
import arcpy

# Setting the environment
arcpy.env.overwriteOutput = True

# Setting Local Variables
in_feature_dataset = r'C:\Data\TM.gdb\ASG'
aoi_features = r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\MapIndex.gdb\MapIndex\TM50_Index'
land_features = r'C:\Users\Public\Documents\ArcGIS Topographic Mapping\Product Files\ReferenceData\MapIndex.gdb\Reference\LandPoly'
scale = '1:50000'
clip_aoi_to_sheets = 'CLIP_AOI'
buffer_size = ''

# Create layer and select single AOI for processing
area_of_interest = arcpy.management.MakeFeatureLayer(aoi_features, 'AOI')
arcpy.management.SelectLayerByAttribute(area_of_interest, "NEW_SELECTION", "NRN = 'V791521541'")

# Use the Generate Adjoining Sheet Features tool to create data required for the Adjoining Sheet Guide
arcpy.topographic.GenerateAdjoiningSheetsFeatures(in_feature_dataset, area_of_interest, land_features, scale,
                                                  clip_aoi_to_sheets, buffer_size)

GenerateAdjoiningSheetsFeatures example 2 (stand-alone script)

The following code sample demonstrates how to use the GenerateAdjoiningSheetsFeatures function to create a custom adjoining sheet diagram for a topographic map product.

# Name: GenerateAdjoiningSheetsFeatures_sample2.py
# Description: Use the Generate Adjoining Sheets Features tool to create a custom adjoining sheet
# diagram for a topographic map product.

# Import System Modules
import arcpy

# Setting the environment
arcpy.env.overwriteOutput = True

# Setting Local Variables
in_feature_dataset = r'C:\Data\TM.gdb\ASG'
aoi_features = r'C:\Data\MapIndex.gdb\MapIndex\TM50_Index'
land_features = r'C:\Data\MapIndex.gdb\Reference\LandPoly'
scale = 'None'
clip_aoi_to_sheets = 'CLIP_AOI'
buffer_size = '100 Meters'

# Create layer and select single AOI for processing
area_of_interest = arcpy.management.MakeFeatureLayer(aoi_features, 'AOI')
arcpy.management.SelectLayerByAttribute(area_of_interest, "NEW_SELECTION", "NRN = 'CUSTOM_AOI_1'")

# Use the Generate Adjoining Sheet Features tool to create data required for the Adjoining Sheet Guide
arcpy.topographic.GenerateAdjoiningSheetsFeatures(in_feature_dataset, area_of_interest, land_features, scale,
                                                  clip_aoi_to_sheets, buffer_size)

Environments

This tool does not use any geoprocessing environments.

Licensing information

Basic: No
Standard: No
Advanced: Requires Topographic Mapping

Generate Adjoining Sheets Features (Topographic Production Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics