Point Angle and Position Wizard

Point Angle and Position

Identifies the closest polyline from the reference layer to each point and calculates: the angle of the closest polyline segment, the position, stationing of the point along the polyline and the distance to the polyline

Inputs:

Point feature layer
Reference polyline layer
Search tolerance - the maximum distance to search for features in the distance layer
Keep Input Spatial Reference - If selected the output will have the spatial reference of the input dataset, else the spatial reference of the reference dataset will be used

Outputs:

A new Point feature class. The attribute table of the resulting feature class will have three new fields
- [ET_Angle] - the angle of the closest segment of the closest to the point polyline. The angle is in degrees 0.00 = North, clockwise.
- [ET_Pos] - the distance from the start point of the closest polyline to the point along the polyline as a percentage of the total length of the polyline.
- [ET_Station] - the actual distance from the start point of the closest polyline to the point along the polyline, measured in the map units
- [ET_Dist] - the shortest distance from the point to the closest polyline measured in the map units
- [ET_Side] - indicates on which side of the polyline is the point (introduced in version 10.2).
- [ET_M]/[ET_Z] - the M(Z) value interpolated from the closest polyline (if the reference dataset is of PolylineM(Z) type)
- [ET_Closest] - the ID of the closest polyline from the reference dataset.

Notes:

If the distance from a point to the closest feature from the distance layer is larger than the Search Tolerance then the [ET_Angle] will have a value of 0, [ET_Pos] and [ET_Station] will have values of -1
The units of the Search Tolerance should be the units of spatial reference of the input dataset if the user has selected the Keep Source Spatial Reference option. Otherwise - the units of spatial reference of the reference dataset.
The distances are calculated in the units of spatial reference of the input dataset if the user has selected the Keep Source Spatial Reference option. Otherwise - the units of spatial reference of the reference dataset.
All the attributes of the input point dataset are transferred to the output

(Go to TOP)

Parameters

Expression	Explanation
Function Name	PointsAngleAndPosition
<input dataset>	A String representing the input layer. Must be of Point type.
<reference dataset>	A String representing the reference layer. Must be of Polyline type
<output dataset>	A String - the full name of the output layer.
<search tolerance>	A Double representing the Search tolerance to be used. The units of the tolerance are the units of spatial reference of the input dataset if KeepSourceSref = TRUE. Otherwise - the units of spatial reference of the reference dataset.
{KeepSourceSref}	A Boolean indicating whether the output to have the spatial reference of the input layer. If False or 0, the spatial reference of the reference layer will be used.

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, "PointsAngleAndPosition", "input dataset", "reference dataset", "output dataset", "search tolerance", "KeepSourceSref"])
.NET using ETGWRun.exe	StartInfo.FileName = ETGWPath StartInfo.Arguments = "PointsAngleAndPosition" "input dataset" "reference dataset" "output dataset" "search tolerance" "KeepSourceSref"
.NET using ETGWOutX.dll	PointsAngleAndPosition(input dataset,reference dataset, output dataset, search tolerance, KeepSourceSref)
ArcPy	arcpy.PointsAngleAndPosition(input dataset, reference dataset, output dataset, "search tolerance" , "KeepSourceSref")

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)