Summary
Automates the creation of a Zone of Confidence (ZOC) diagram. These diagrams allow mariners to assess the quality of the hydrographic data from which the chart was compiled. Processes are run on a production database with the Nautical Chart schema and include adding layers to the table of contents, creating grids and graticules, creating category of zone of confidence in data (CATZOC) outlines, adding land area (LNDARE) features, and setting symbology.
Usage
Run this tool on a data frame that does not contain data and is separate from the main chart panel. An area of interest (AOI) can exist in the data frame and each ZOC diagram should be contained within its own data frame. For example, if your nautical chart contains two ZOC diagrams plus the main panel, three data frames are required.
You can run the Create ZOC Diagram tool on a chart product that was created by importing data into a database with the Nautical Chart schema.
There are two options for choosing the map document on which the Create ZOC Diagram tool will be run: use either a path to an existing map document stored on a local machine (or on some other machine to which you have write access) or the current map document in ArcMap.
Any new layers added to the map document will be added to the active data frame unless one is selected from the optional Data Frame parameter.
Layers added to the table of contents are symbolized using the layer file named CATZOC.lyr and are installed with ArcGIS Maritime in the following location:
For 64-bit Windows operating systems—<Install location>\Program Files (x86)\ArcGIS\MaritimeCharting\Desktop<version>\Charting\Cartography\Symbology
For 32-bit Windows operating systems—<Install location>\Program Files\ArcGIS\MaritimeCharting\Desktop<version>\Charting\Cartography\Symbology
The output grids are stored in the GRD_Grid feature dataset in the production database, and the grid layers are added to the map document under a group layer named Grids.
The polygon geometry that represents the area of interest must be a simple polygon. It cannot contain multipart features or holes.
Syntax
arcpy.nautical.CreateZOCDiagram(Area_Of_Interest, ZOC_Diagram_Scale, Chart_Database, Map_Document_Type, ArcMap_Document, Data_Frame)
Parameter | Explanation | Data Type |
Area_Of_Interest | The polygon layer that contains the area of interest for the chart extent. This layer should contain exactly one feature or exactly one feature should be selected. This is the feature that will be used as the Area Of Interest. | Layer |
ZOC_Diagram_Scale | The scale of the zone of confidence diagram. For example, for a scale of 1:20,000, use a value of 20000. | Double |
Chart_Database | The geodatabase that contains the chart data in the Nautical Chart schema. | Workspace |
Map_Document_Type | Specifies the map document where the chart finishing processes will run.
| String |
ArcMap_Document | The map document where the chart finishing processes will run. This parameter is not used when Map Document Type is set to CURRENT_MXD. | ArcMap Document |
Data_Frame | The name of the data frame in the selected ArcMap document on which the Chart Finishing processes will run. If no value is specified, the active data frame will be used. | String |
Code sample
CreateZOCDiagram example (Python window)
The following Python window script demonstrates how to use the CreateZOCDiagram function.
# Name: CreateZOCDiagram.py
# Description: Creates a zone of confidence diagram from an aoi and scale
# Author: Esri
# Date: January 2016
# Define variables
aoi = "C:/Data/Charts/AOI.lyr"
scale = 520000
proddb = "C:/Data/Charts/GB4X0000.gdb"
mxdtype = "PATH_TO_MXD"
mxdpath = "C:/Data/Charts/MyNauticalChart.mxd"
dfname = "ZOCdiagram"
# Execute the tool
arcpy.CreateZOCDiagram_nautical(aoi, scale, proddb, mxdtype, mxdpath, dfname)
Environments
Licensing information
- Basic: No
- Standard: No
- Advanced: Requires ArcGIS Maritime