Chart Automation (Nautical)

摘要

Runs selected chart finishing processes on a chart product. 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.

用法

• The selected chart finishing processes can be run on a chart product that was created using the Product Library window, or on a product independent of the product library that was created by importing data into a database with the Chart schema.

• The Product Type parameter can be used to choose between running the selected chart finishing processes on a product created with the product library or an independent product. If the tool will be run on an independent product, the Product AOI, Scale, and Product Database properties under the Independent Product category are required.

• When running on a product independent of the product library, any layers created will be added to the active data frame.

• Exactly one AOI polygon should be selected when working with an independent product.

• 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—<Install location>\Program Files\ArcGIS\MaritimeCharting\Desktop10.2\Charting\Cartography\Symbology
  • For 32-bit Windows operating systems—<Install location>\Program Files(x86)\ArcGIS\MaritimeCharting \Desktop10.2\Charting\Cartography\Symbology

• During the Create Grids and Graticules process, if the value for the MAPSCALE attribute 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 in the Generate Cartographic Limits process are converted to polylines and erased where their boundary is coincident with a CoastlineL feature.

• During the Convert Labels to Annotation 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.

语法

ChartAutomation_nautical (Product_Type, Chart_finishing_processes_to_run, {Run_on_all_chart_panels}, {Product_AOI}, {Scale}, {Product_Database})

参数	说明	数据类型
Product_Type	The type of chart product: Product Library —A product currently checked out from the product library geodatabase and opened in the current map document. The names of the data frames must match the names of the chart panels in the product. Independent Product —A product created by importing data into a geodatabase with the Chart schema. The product does not need to be associated with the product library.	String
Chart_finishing_processes_to_run	The finishing processes that can be run on the chart panel or panels. 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 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\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. 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. Sets masked and masking layers in the Advanced Drawing Options dialog box.	String
Run_on_all_chart_panels (可选)	Option to run the selected chart finishing processes on all chart panels associated with the data frames in the map document or just the chart panel associated with the active data frame. ALL_CHART_PANELS —The selected chart finishing processes will run on all chart panels in the product. This is the default. ACTIVE_PANEL —The selected chart finishing processes will only run on the chart panel associated with the active data frame in the map document.	Boolean
Product_AOI (可选)	The polygon layer that contains the area of interest for the product extent. Exactly one feature must be selected in this layer. This is the feature that will be used as the Product AOI.	Feature Layer
Scale (可选)	The scale of the chart product.	Double
Product_Database (可选)	The geodatabase that contains the chart data in the Nautical Chart schema.	Workspace

代码实例

ChartAutomation example 1

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

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

# tool variables
product_type = "Product Library"
finishing_processes="Add Layers to TOC;Mask Annotation"
chart_panels="ALL_CHART_PANELS"

# exec the tool
arcpy.ChartAutomation_nautical(product_type, finishing_processes, chart_panels)

ChartAutomation example 2

The following code sample demonstrates how to use the Chart Automation tool with a product independent of the product library database.

# NOTE: You must run this tool within ArcGIS
# NOTE: You must run this tool within ArcGIS 
# tool variables
product_type = "Independent Product"
finishing_processes="Add Layers to TOC;Mask Annotation"
product_aoi = "AOI"
scale = 22000
product_db = r"C:\Data\MyChartProduct.gdb"

# exec the tool
arcpy.ChartAutomation_nautical(product_type, finishing_processes, Product_AOI=product_aoi, Scale=scale, Product_Database=product_db)

环境

当前工作空间

许可信息

ArcGIS for Desktop Basic: 否

ArcGIS for Desktop Standard: 否

ArcGIS for Desktop Advanced: 需要 Maritime Charting