Update COGO (Editing)

Summary

Updates the COGO attributes of COGO-enabled line features to match their line shape geometries.

The following COGO attributes will be updated:

• Direction
• Distance
• Radius
• Arc Length

Directions, distances, and radii can optionally be scaled and rotated by a ground to grid correction.

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 input line feature class must be COGO enabled.

  Learn more about enabling COGO for a line feature class

Parameters

Dialog

Label	Explanation	Data Type
Input Line Features	The COGO-enabled line features that will be updated.	Feature Layer
Update Distance, Radius, and Arc Length (Optional)	Specifies how the input line's Distance, Radius, and Arc Length COGO attributes will be updated. Overwrite all values—All values (including NULL values) will be updated to match the shape length. This is the default. Update NULL values only—Only NULL values will be updated to match the shape length. Update values using a minimum difference—Values that differ from the shape length by more than the specified tolerance will be updated to match the shape length. Do not update any values—Values will not be updated.	String
Minimum Distance Difference (Optional)	The minimum distance difference between the line shape length and the value in the Distance, Radius, and Arc Length fields. If the difference in the distances is larger than the specified tolerance, the attribute value in the Distance, Radius, or Arc Length fields will be updated to match the line shape length. The default value is 0 meters.	Linear Unit
Update Directions (Optional)	Specifies how the input's Direction COGO attributes will be updated. Overwrite all values—All values (including NULL values) will be updated to match shape direction. This is the default. Update NULL values only—Only NULL values will be updated to match the shape direction. Update values using a minimum difference—Values that differ from the shape direction by more than the specified tolerance will be updated to match the shape direction. Do not update any values—Values will not be updated.	String
Minimum Direction Difference (seconds) (Optional)	The minimum direction difference (in seconds) between the line shape direction and the value in the Direction field. If the difference in the directions is larger than the specified tolerance, the attribute value in the Direction field will be updated to match the line shape direction. The default value is 0.	Double
Minimum Direction Lateral Offset (Optional)	The minimum allowable distance between the endpoint of the line shape and the endpoint of the line drawn using the value in the Direction field. A lateral offset tolerance can be used for very long lines in which small changes in direction can result in large differences in line endpoints. The default value is 0 meters.	Linear Unit
Combined Scale Factor (Optional)	A scale factor based on a ground to grid correction that will be applied to the line's shape length. The scale factor can be provided as a number or derived from an Arcade expression using the line's attribute fields. The updated distance populated in the Distance, Radius, and Arc Length fields is a result of the shape length multiplied by the scale factor.	Calculator Expression
Direction Offset (seconds) (Optional)	A rotation based on a ground to grid correction that will be applied to the line's shape direction. The rotation offset can be provided as a value in seconds or derived from an Arcade expression using the line's attribute fields. The updated direction populated in the line's Direction field is the line shape direction rotated by the specified direction offset.	Calculator Expression

Derived Output

Label	Explanation	Data Type
Updated Line Features	The updated line features.	Parcel Layer

Python

arcpy.management.UpdateCOGO(in_line_features, {distances_type}, {distance_tolerance}, {direction_type}, {minimum_direction_difference}, {minimum_direction_lateral_offset}, {combined_scale_factor}, {direction_offset})

Name	Explanation	Data Type
in_line_features	The COGO-enabled line features that will be updated.	Feature Layer
distances_type (Optional)	Specifies how the input line's Distance, Radius, and Arc Length COGO attributes will be updated. OVERWRITE—All values (including NULL values) will be updated to match the shape length. This is the default. UPDATE_NULL_ONLY—Only NULL values will be updated to match the shape length. USE_MINIMUM_DIFFERENCE—Values that differ from the shape length by more than the specified tolerance will be updated to match the shape length. DO_NOT_UPDATE—Values will not be updated.	String
distance_tolerance (Optional)	The minimum distance difference between the line shape length and the value in the Distance, Radius, and Arc Length fields. If the difference in the distances is larger than the specified tolerance, the attribute value in the Distance, Radius, or Arc Length fields will be updated to match the line shape length. The default value is 0 meters.	Linear Unit
direction_type (Optional)	Specifies how the input's Direction COGO attributes will be updated. OVERWRITE—All values (including NULL values) will be updated to match shape direction. This is the default. UPDATE_NULL_ONLY—Only NULL values will be updated to match the shape direction. USE_MINIMUM_DIFFERENCE—Values that differ from the shape direction by more than the specified tolerance will be updated to match the shape direction. DO_NOT_UPDATE—Values will not be updated.	String
minimum_direction_difference (Optional)	The minimum direction difference (in seconds) between the line shape direction and the value in the Direction field. If the difference in the directions is larger than the specified tolerance, the attribute value in the Direction field will be updated to match the line shape direction. The default value is 0.	Double
minimum_direction_lateral_offset (Optional)	The minimum allowable distance between the endpoint of the line shape and the endpoint of the line drawn using the value in the Direction field. A lateral offset tolerance can be used for very long lines in which small changes in direction can result in large differences in line endpoints. The default value is 0 meters.	Linear Unit
combined_scale_factor (Optional)	A scale factor based on a ground to grid correction that will be applied to the line's shape length. The scale factor can be provided as a number or derived from an Arcade expression using the line's attribute fields. The updated distance populated in the Distance, Radius, and Arc Length fields is a result of the shape length multiplied by the scale factor.	Calculator Expression
direction_offset (Optional)	A rotation based on a ground to grid correction that will be applied to the line's shape direction. The rotation offset can be provided as a value in seconds or derived from an Arcade expression using the line's attribute fields. The updated direction populated in the line's Direction field is the line shape direction rotated by the specified direction offset.	Calculator Expression

Derived Output

Name	Explanation	Data Type
updated_line_features	The updated line features.	Parcel Layer

Code sample

UpdateCOGO example (Python window)

The following Python window script demonstrates how to use the UpdateCOGO function to update line COGO attributes in immediate mode.

import arcpy

arcpy.edit.UpdateCOGO('Lot_Lines', 'USE_MINIMUM_DIFFERENCE', '1 Feet', 
                      'USE_MINIMUM_DIFFERENCE', '20')

Environments

This tool does not use any geoprocessing environments.