ArcMap

Detect NonMonotonic Routes

Summary

Checks routes for nonmonotonic calibration of the m-values on vertices. Nonmonotonic calibration occurs when a route does not contain either strictly increasing or strictly decreasing m-values on its vertices.

Usage

  • If two consecutive vertices have the same m-value, it is considered nonmonotonic calibration.

  • If there is no polyline between two consecutive vertices with the same m-value, the tool will output a record without a shape.

  • The output feature class contains the paths between nonmonotonic vertices.

  • The output feature class contains the following fields: NetworkName, RouteID, FromMeasure, ToMeasure, FromDate, and ToDate.

Syntax

arcpy.locref.DetectNonMonotonicRoutes(in_network, out_feature, in_monotonicity_type, in_from_date_field, in_to_date_field, in_route_id_field)
ParameterExplanationData Type
in_network

The network containing the routes to be validated.

Feature Layer
out_feature

The feature class containing polylines for nonmonotonic paths.

Feature Class
in_monotonicity_type

Specifies the type of monotonicity that will be checked on the routes.

  • ANY —The output will contain polylines for any m-values that are neither strictly increasing nor strictly decreasing.
  • STRICTLY_INCREASING —The output will contain polylines for any m-values that are not strictly increasing.
  • STRICTLY_DECREASING —The output will contain polylines for any m-values that are not strictly decreasing.
String
in_from_date_field

The attribute or field of the input Network Layer containing the From Date of the route.

Field
in_to_date_field

The attribute or field of the input Network Layer containing the To Date of the route.

Field
in_route_id_field

The attribute or field of the input Network Layer containing the Route ID field.

Field

Code sample

DetectNonMonotonicRoutes example (Python window)

The following Python window script demonstrates how to use DetectNonMonotonicRoutes in immediate mode.

# tool variables
in_network = "MileMarker"
out_features = "NonMonotonic_Output"
mono_type = "STRICTLY_DECREASING"
fromdate_field = "FROM_DATE"
todate_field = "TO_DATE"
routeid_field = "ROUTE_ID"

# set current workspace
arcpy.env.workspace = "C:/data/Outputs.gdb"

# execute the tool
arcpy.DetectNonMonotonicRoutes_locref(in_network, out_features, mono_type, fromdate_field, todate_field, routeid_field)
DetectNonMonotonicRoutes example (stand-alone script)

The following Python script demonstrates how to use DetectNonMonotonicRoutes as a stand-alone Python script.

# Name: DetectNon-MonotonicRoutes.py
# Description: Convert Roads and Highways Network Layer to Feature Layer and Detect Non-Monotonic Routes in a file geodatabase

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("Highways")

# Local variables
network = "C:/Data/NY_Data.gdb/LRSN_MilePoint"
nonMonotonicOutput = "C:/Data/Outputs.gdb/NonMonotonic_Output"

# Process: Detect Non-monotonic Routes
arcpy.env.overwriteOutput = 1
arcpy.DetectNonMonotonicRoutes_locref(network, nonMonotonicOutput, "Any", "From_Date", "To_Date", "Route_Id")

Environments

Licensing information

  • Basic: Requires Roads and Highways
  • Standard: Requires Roads and Highways
  • Advanced: Requires Roads and Highways

Related topics