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

Parameters

LabelExplanationData 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 valuesAll values (including NULL values) will be updated to match the shape length. This is the default.
  • Update NULL values onlyOnly NULL values will be updated to match the shape length.
  • Update values using a minimum differenceValues that differ from the shape length by more than the specified tolerance will be updated to match the shape length.
  • Do not update any valuesValues 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 valuesAll values (including NULL values) will be updated to match shape direction. This is the default.
  • Update NULL values onlyOnly NULL values will be updated to match the shape direction.
  • Update values using a minimum differenceValues that differ from the shape direction by more than the specified tolerance will be updated to match the shape direction.
  • Do not update any valuesValues 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

LabelExplanationData Type
Updated Line Features

The updated line features.

Parcel Layer

arcpy.edit.UpdateCOGO(in_line_features, {distances_type}, {distance_tolerance}, {direction_type}, {minimum_direction_difference}, {minimum_direction_lateral_offset}, {combined_scale_factor}, {direction_offset})
NameExplanationData 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.

  • OVERWRITEAll values (including NULL values) will be updated to match the shape length. This is the default.
  • UPDATE_NULL_ONLYOnly NULL values will be updated to match the shape length.
  • USE_MINIMUM_DIFFERENCEValues that differ from the shape length by more than the specified tolerance will be updated to match the shape length.
  • DO_NOT_UPDATEValues 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.

  • OVERWRITEAll values (including NULL values) will be updated to match shape direction. This is the default.
  • UPDATE_NULL_ONLYOnly NULL values will be updated to match the shape direction.
  • USE_MINIMUM_DIFFERENCEValues that differ from the shape direction by more than the specified tolerance will be updated to match the shape direction.
  • DO_NOT_UPDATEValues 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

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

Licensing information

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

Related topics