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})
Parameter | Explanation | Data 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.
| 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.
| Boolean |
Derived Output
Name | Explanation | Data Type |
modified_feature_dataset | The feature dataset with updated ASG features. | Feature Dataset |
Code sample
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
Licensing information
- Basic: No
- Standard: Requires Production Mapping
- Advanced: Requires Production Mapping