Generate Adjoining Sheets Features (Topographic Production)

Summary

Generates features necessary for display in a typical topographic map adjoining sheets diagram.

Features generated include: sheet polygons for labeling, sheet lines for symbolizing sheets from different series uniquely, coastal polygons for displaying open water with coastal polylines for displaying shoreline, and a calculated area of interest (AOI) for generating a feature grid for the diagram.

Usage

  • At a minimum, the following feature classes will be created in the target feature dataset:

    • ASG_SHEETS_A
    • ASG_SHEETS_L
    • ASG_AOI

  • If input land features are provided, the ASG_COAST_A feature class will be created if the supplied land features do not fully cover the calculated AOI for the adjoining sheets diagram. If 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.

  • Area of Interest must have only one selected feature.

  • Attributes from the Area of Interest feature layer 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 parameters are used together to locate surrounding areas of interest. The extent of the Area of Interest is expanded by a factor specified in MIL-T-89301A for scale 1:50000 or MIL-T-89306 for scale 1:100000. For scale 1:25000, the factor is interpreted from MIL-T-89301A. The expanded extent is used to select adjoining areas of interest to include in the adjoining sheets diagram.

Syntax

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

An existing feature dataset that will contain the ASG_ feature classes. The tool will create these feature classes if they do not exist.

Feature Dataset
area_of_interest

A feature layer with a single selected feature 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 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)

Defines a factor by which the extent of the area_of_interest is expanded. The expanded extent is used to select adjoining areas of interest. Data from the adjoining areas of interest is included in the adjoining sheets diagram.

  • 1:25000—Uses specification MIL-T-89301A as a guide to determine how to expand the width and height of the extent of the area_of_interest.
  • 1:50000—Uses specification MIL-T-89301A to determine how to expand the width and height of the extent of the area_of_interest. This is the default.
  • 1:100000—Uses specification MIL-T-89306 to determine how to expand the width and height of the extent of the area_of_interest.

String
clip_aoi_to_sheets
(Optional)

Determines if the AOI created for the extent of the adjoining sheets diagram will be clipped to the extents of the sheets to be displayed. If set to CLIP_AOI, the AOI for the adjoining sheets diagram will be modified from its originally calculated rectangular shape to include any irregular map sheet extents that will be included or excluded in the diagram.

  • CLIP_AOIThe 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_AOIThe 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

Derived Output

NameExplanationData Type
modified_feature_dataset

The feature dataset with updated ASG features.

Feature Dataset

Code sample

GenerateAdjoiningSheetsFeatures example (stand-alone script)

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

# Name: GenerateAdjoiningSheetsFeatures_sample.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

# Check Out Extensions
arcpy.CheckOutExtension('Foundation')

# Setting the environment
arcpy.env.overwriteOutput = True

# Setting Local Variables
in_feature_dataset = r'C:\Temp\Test.gdb\Features'
aoi_features = r'C:\Temp\Test.gdb\Product_Index'
land_features = r'C:\Temp\Test.gdb\Land_Polygons'
scale = '1:50000'
clip_aoi_to_sheets = 'DONT_CLIP_AOI'

# Create layer and select single AOI for processing
area_of_interest = arcpy.management.MakeFeatureLayer(aoi_features, 'AOI').getOutput(0)
arcpy.management.SelectLayerByAttribute(area_of_interest, "NEW_SELECTION", "PRODUCT_ID = 'V795X16573'")

# 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)

# Check In Extensions
arcpy.CheckInExtension('Foundation')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires Production Mapping
  • Advanced: Requires Production Mapping

Related topics