Help

Product Library Chart Automation

Summary

Runs selected chart-finishing processes on a nautical chart product created with Product Library. Processes include adding layers to the TOC, generating cartographic limits, creating grids and graticules, converting labels to annotation, and masking annotation.

A description of each process can be found in Chart automation finishing processes.

Usage

  • The selected chart-finishing processes are run on a chart product that was created using the Product Library window. To use chart automation on a product created without Product Library, see the Chart Automation tool.

  • The group layer added by the Add Layers to TOC process is named Nautical.lyr and is installed with ArcGIS for Maritime: Charting in the following location:

    • For 64-bit Windows operating systems—<Installation location>\Program Files(x86)\ArcGIS\MaritimeCharting\Desktop10.3\Charting\Cartography\Symbology
    • For 32-bit Windows operating systems—<Installation location>\Program Files\ArcGIS\MaritimeCharting \Desktop10.3\Charting\Cartography\Symbology

  • During the Make Grids and Graticules Layer process, if the value for the MAPSCALE attribute in the Product Library's Chart AOI feature class is NULL, the scale defined in the COMPILATIONSCALE attribute is used instead.

  • The output grids are stored in the GRD_Grids feature dataset in the production database and the grid layers are added to the map document under a group layer named Grids.

  • The selected features using the Generate Cartographic Limits tool are converted to polylines and erased where their boundary is coincident with a CoastlineL feature.

  • Using the Convert Labels To Annotation tool process, if the labels are turned on in the layer’s properties, feature-linked annotation is generated for that layer at the reference scale of the data frame, and the labels for that layer are then turned off.

  • The output annotation feature classes are stored in the production database and the annotation layers are added to the map document under a group layer named Anno.

Syntax

ProductLibraryChartAutomation(Chart_Finishing_Processes, Chart_Panels)
ParameterExplanationData Type
Chart_Finishing_Processes
[Chart_Finishing_Processes,...]

The finishing processes that can be run.

  • Add Layers to TOC —Adds a rendered and ordered group layer with all nautical layers to the data frame associated with the chart panel. It updates the data sources in each layer to the workspace path of the production database of the chart panel.
  • Create Grids and Graticules —Creates a grids and graticules layer using the appropriate nautical grids XML for the INT2 standard based on the map scale (or compilation scale) defined in the product area of interest (AOI) feature class. Adds the output grid layer to the map document. The data frame’s coordinate system, rotation, scale, size, and shape are updated based on the properties of the grids.
  • Generate Cartographic Limits —Runs the Generate Cartographic Limits tool on all applicable layers and subtypes and appends the results to the A_L feature classes located under the CartographicFeatures feature dataset in the production database. Adds the output feature classes as layers to the Table Of Contents window if they are not already loaded in the map document.
  • Generate Light Sectors —Creates light sector features based on a specified point feature class. Light sectors typically appear on nautical charts and depict the distance a light can be seen from its source. Light sectors are based on light features in the AidsToNavigationP feature class in the ArcGIS for Maritime: Charting.
  • Convert Labels to Annotation —Converts labels in all layers to feature-linked annotation and adds the resulting annotation layer to the map document. The process runs on all layers in the data frame associated with the chart panel.
  • Mask Annotation —Creates one-point mask polygons on all features in the DepthsLAnno layer or where they commonly intersect polyline features in the map. It also sets the masked and masking layers in the Advanced Drawing Options dialog box.
String
Chart_Panels

The data frame names in the current map document. The selected chart-finishing processes will run on all of the data frames selected.

String

Code sample

ProductLibraryChartAutomation example

The following code sample demonstrates how to use the tool with a product created in the product library.

# NOTE: You must have a product library set and run this tool within ArcGIS

# Variables
finishing_processes="Add Layers to TOC;Convert Labels to Annotation"
chart_panels="MainPanel;InsetPanel"


# Execute the tool
arcpy.ProductLibraryChartAutomation_nautical(finishing_processes, chart_panels)

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: No
  • ArcGIS Desktop Advanced: Requires Maritime Charting

Related topics