linref_LocateFeatures

Locate features features along routes

Creates an event layer (table) from the input route dataset and a feature layer.

Polygon - Finds the route and measure information at the geometric intersection of the input polygon layer and the route layer and creates a line event polyline layer(or event table). The output table will contain a route identifier, the FROM and TO measures of the route on which each polygon was located. If a polygon intersects more than one route multiple records will be created in the output table for this polygon.
Polyline - Finds the route and measure information for the polylines or parts of them that are withing the search tolerance from the routes and creates a polyline layer (or event table). The output table will contain a route identifier, the FROM and TO measures of the route on which each polyline was located. If a polyline or parts of it are within the search tolerance to more than one route multiple records will be created in the output table for this polyline.
Point - Finds the route and measure information for the points from a Point layer and creates a point layer (or event table). Only the points that are within specified search tolerance of routes will be recorded in the output table. The output table will contain a route identifier and a measure for each point.

Inputs:

A PolylineM feature layer - the routes to be used
Route Identifier field - the values in this field will be recorded in the output event table
A Point, Polyline or Polygon feature layer which features will be located on the routes
Searc Tolerance if Points or Polylines are to be located.

A Point or Polyline layer or an event table( DBF or FileGdb) with event record for each event located on the route
If the Add Attributes option is selected the output table will contain all the original fields of the input dataset
Three/Two new fields will be added
- [ET_RouteID] - the route identifier field. The values will correspond to the route on which each polygon was located
- [ET_FromM] - the FROM measure of each event(Polygon and Polylines)
- [ET_ToM] - the TO measure of each event (Polygon and Polylines)
- [ET_Measure] - the measure of each event (Points)

Parameters

Expression	Explanation
Function Name	LocateFeaturesAlongRoutes
<input dataset>	A feature layer. Must be of Point, Polyline or Polygon type.
<Route Layer>	A String - feature layer. Must be of PolylineM type.
<output dataset>	A String - the full name of the output layer.
<Route Key Field>	A String - the name of the route ID field in the route dataset
{Search Tolerance}	A Double - the search tolerance (for Point or Polyline input datasets). For Polygons use 0
{Otput Table}	A Boolean - if TRUE only event table will be stored, if FALSE a feature layer will be saved.
{Add Atributes}	A Boolean - if TRUE the attributes of the input dataset will be copied to the result.

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, "LocateFeaturesAlongRoutes", "input dataset", "Route Layer", "output dataset", "Route Key Field", "Search Tolerance", "Otput Table", "Add Atributes"])
.NET using ETGWRun.exe	StartInfo.FileName = ETGWPath StartInfo.Arguments = "LocateFeaturesAlongRoutes" "input dataset" "Route Layer" "output dataset" "Route Key Field" "Search Tolerance" "Otput Table" "Add Atributes"
.NET using ETGWOutX.dll	LocateFeaturesAlongRoutes(input dataset, Route Layer, output dataset, Route Key Field, Search Tolerance, Otput Table, Add Atributes)
ArcPy	arcpy.LocateFeaturesAlongRoutes(input dataset, Route Layer, "output dataset", "Route Key Field", "Search Tolerance", "Otput Table", "Add Atributes")

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.