Enable COGO (Data Management)

Summary

Enables COGO on a line feature class and adds COGO fields and COGO-enabled labeling to a line feature class. COGO fields store dimensions that are used to create line features in relation to each other.

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• The tool adds the following COGO fields to the selected line feature class: Arc Length, Direction, Distance, Radius, and Radius2. All fields are of type double.

• The tool adds COGO-related labeling and symbology to the selected line feature class. Lines are drawn with added COGO symbology, and a label expression labels each line with its COGO dimensions if they exist.

• Run the Disable COGO tool to disable COGO on the line feature class. The COGO fields can be deleted.

• If one or more of the COGO fields already exist and are of the correct type, only the remaining, missing COGO fields are added.

• If a line feature class is COGO enabled, editing tools such as the Traverse tool populate the COGO fields with the dimensions provided.

• The Direction field stores the direction (bearing) of the line from its start point to its endpoint. The direction value is stored in the database as north azimuth (decimal degrees). You can display the direction in other units by setting display units for your project.

• The Distance field stores the distance (length) of the line. The distance is stored in the database in the linear unit of the projection. You can display the distance in other units by setting display units for your project.

• The ArcLength field stores the arc distance between the start point and endpoint of a curved line. The arc length distance is stored in the database in the linear unit of the projection. You can display the arc length distance in other units by setting display units for your project.

• The Radius field stores the distance between the curve center point and the curve line. The radius distance is stored in the database in the linear unit of the projection. You can display the radius distance in other units by setting display units for your project.

• The Radius2 field stores the second radius for a spiral curve. This radius can be set to infinity.

Parameters

Dialog

Label	Explanation	Data Type
Input Line Features	The line feature class that will be COGO enabled.	Feature Layer

Derived Output

Label	Explanation	Data Type
Output Feature Class	The COGO enabled dataset.	Table View

Python

arcpy.management.EnableCOGO(in_line_features)

Name	Explanation	Data Type
in_line_features	The line feature class that will be COGO enabled.	Feature Layer

Derived Output

Name	Explanation	Data Type
updated_line_Features	The COGO enabled dataset.	Table View

Code sample

EnableCOGO example 1 (Python window)

The following Python window script demonstrates how to use the EnableCOGO function in immediate mode.

import arcpy
arcpy.env.workspace = "E:\ArcGISXI\Mont\Montgomery.gdb"
arcpy.EnableCOGO_management("\Landbase\Road_cl")

EnableCOGO example 2 (stand-alone script)

The following stand-alone script demonstrates how to check for and enable COGO on a line feature class.

import arcpy

# Variable to contain the path of the feature class that is to be COGO enabled
lineFeatureClass = r"d:\test.gdb\myLineFC"

# Check to see if the feature class is already enabled by using .isCOGOEnabled on a Describe
if arcpy.Describe(lineFeatureClass).isCOGOEnabled == False:
    # If it returns False, run EnableCOGO_management and pass the feature class
    arcpy.EnableCOGO_management(lineFeatureClass)
else:
    print("{} is already COGO Enabled".format(lineFeatureClass))

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes