Cogo Inverse

Converts a polyline or a polygon data set to a feature class containing only single segmented polylines. For each segment the COGO attributes are calculated and added to the resulting attribute table. The attributes of the original features are copied to the output features.

Inputs:

A Polyline or Polygon feature layer

Options:

Direction Angle Type - the type of the output angle for the direction of the segments

Direction Angle Units
- DD - Decimal Degrees
- DMS - Degrees Minutes Seconds
- Rad - Radians
- Grad - Gradians (One gradian is equal to 1/400 circle)
- Gon - Gons - used in some European countries (One gon is equal to 1/400 circle)
Precision
- Linear - integer indicating the number of places after the decimal point for the output linear measurements
- Angular - integer indicating the number of places after the decimal point for the output angular measurements

Outputs:

New polyline feature class
Attribute fields added to the attribute table of the output feature class
- Always
  - [Direction] - the direction of the segment. The angle can be measured in arithmetic or geographic notation depending on the user choice
  - [Distance] - the length of the segment measured in the units of the original dataset
  - [Delta] - for circular arcs only. The central angle of the circular arc in degrees
  - [Radius] - for circular arcs only. The radius of the circular arc
  - [Tangent] - for circular arcs only. The distance from the Start/End points of the circular arc to the intersection point of the tangents
  - [ArcLength] - for circular arcs only. The length of the circular arc
  - [Delta] - for circular arcs only. The central angle of the circular arc
  - [Side] - the side of the circular arc compared with the tangent in the start point
- User choice
  - [XStart] - X coordinate of the start point of the segment
  - [YStart] - Y coordinate of the start point of the segment
  - [XEnd] - X coordinate of the end point of the segment
  - [YEnd] -Y coordinate of the end point of the segment
- User choice - shapes with Z values only
  - [ZStart] - Z coordinate of the start point of the segment
  - [ZEnd] - Z coordinate of the end point of the segment
  - [Slope] - the slope of the segment in degrees (from -90 to 90)
- User choice - shapes with M values only
  - [MStart] - M coordinate of the start point of the segment
  - [MEnd] - M coordinate of the end point of the segment

Notes :

The Z or M fields will be added only if the source dataset has Z/M values
ET GeoWizards 12.x cannot handle true arcs. If the source has true arcs they will be approximated and represented with staight segments.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	CogoInverse
<input dataset>	A String representing the input layer. Must be of Polyline or Polygon type.
<output dataset>	A String - the full name of the output layer.
<Point Coordinates>	A Boolean - indicates whether the coordinates of the Start and End point for each segment are to be added to the attribute table.
<Z Attributes>	A Boolean - indicates whether the Z/M coordinates of the Start and End point for each segment are to be added to the attribute table.
<Direction Type>	Required. A String indicating the direction type to be used. Valid values: "NorthAzimuth", "NA" "SouthAzimuth", "SA" "Polar" "QuadrantBearing", "QB"
<Direction Units>	Required. A String indicating the direction units to be used. Valid values: "DecimalDegrees", "DD" "DegreesMinutesSeconds", "DMS" "Radians" "Gradians"" "Gons", "QB"
{Linear Precision}	An Integer representing the number of places after the decimal point for the output linear measurements
{Angular Precision}	An Integer representing the number of places after the decimal point for the output angular measurements.

Running the function

ETGWPath used in the table below is the full path to ETGWRun.exe (E.G. "C:\Program Files\ETSpatial Techniques\ETGeo Wizards\ETGWRun.exe")

Language	Syntax
Python	subprocess.call([ETGWPath, "CogoInverse", "input dataset", "output dataset", "Point Coordinates", "Z Attributes", "Direction Type", "Direction Units", "Linear Precision", "Angular Precision"])
.NET using ETGWRun.exe	StartInfo.FileName = ETGWPath StartInfo.Arguments = "CogoInverse" "input dataset" "output dataset" "Point Coordinates" "Z Attributes" "Direction Type" "Direction Units" "Linear Precision" "Angular Precision"
.NET using ETGWOutX.dll	CogoInverse(input dataset, output dataset, Point Coordinates, Z Attributes, "Direction Type", Direction Units, "Linear Precision", Angular Precision)
ArcPy	arcpy.CogoInverse(input dataset, output dataset, "Point Coordinates" , "Z Attributes", "Direction Type", "Direction Units", "Linear Precision", "Angular Precision")

Notes:

<> - required parameter
{} - optional parameter
See examples for Python , .NET or ArcPy
The argument separator for StartInfo.Arguments is space. If a string might contain a space, you need to double quote it.

(Go to TOP)