perpendicularsToPolylines

Perpendiculars from Points to Polylines

Draws a perpendicular polyline from each point to the closest polyline from the reference layer and calculates several attributes for each perpendicular line.

Inputs:

A point layer
A reference polyline layer
Search tolerance.
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:

New Polyline layer with lines from the source points and perpendicular to the closest polyline from the reference layer.
The attributes of the original points are transferred to the resulting lines.
The following fields are added to the attribute table of the resulting layer.
- [ET_Dist] - the distance from the original point to the closest polyline (the length of the perpendicular line)
- [ET_Pos] - the relative position of the original point along the closest polyline (in percent)
- [ET_Angle] - the angle (0 to 360) of the resulting perpendicular line in degrees starting North clockwise
- [ET_Station] - the absolute position of the original point along the closest polyline (in the units of the spatial reference of the input point layer)

Notes:

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 Source and the Snap datasets can have different spatial references as long as they have the same Geographic Coordinate systems.

Illustration:

(Go to TOP)

Parameters

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