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 Traverse 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

LabelExplanationData Type
Input Line Features

The line feature class that will be COGO enabled.

Feature Layer

Derived Output

LabelExplanationData Type
Output Feature Class

The COGO enabled dataset.

Table View

arcpy.management.EnableCOGO(in_line_features)
NameExplanationData Type
in_line_features

The line feature class that will be COGO enabled.

Feature Layer

Derived Output

NameExplanationData 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.

Related topics