Summary
The Create ZOC Diagram tool automates the creation of a Zone of Confidence (ZOC) diagram. These diagrams enable 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
This tool should be run 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, then 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: 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 that is loaded into 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 is installed with ArcGIS for Maritime: Charting in the following location:
For 64-bit Windows operating systems—<Install location>\ProgramFiles(x86)\ArcGIS\MaritimeCharting\Desktop10.6\Charting\Cartography\Symbology
For 32-bit Windows operating systems—<Install location>\ProgramFiles\ArcGIS\MaritimeCharting\Desktop10.6\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.
Syntax
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, if the scale is 1:20,000, you would enter 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 | Path to the map document where the chart finishing processes will run. If CURRENT_MXD is chosen for the Map_Document_Type parameter, this parameter will not be used. | 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 tool.
# 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
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: No
- ArcGIS Desktop Advanced: Requires Maritime Charting