Convert M-Value Units Of Measure

Summary

Converts the measure (m) values of a dataset from one unit to another. The m-values of the input dataset are modified upon executing this tool.

Usage

• This tool is used for the HPMS 2012 models.

  Note:

  Any uncalibrated routes in the network get an m-value of zero (0) after executing this tool; therefore, you should calibrate all the routes in the network prior to running this tool.

  For more information on calibrating a route, please see Calibrate a route.

Syntax

ConvertMValueUnitsOfMeasure_locref (in_network, in_source_unit_of_measure, in_target_unit_of_measure, in_precision)

Parameter	Explanation	Data Type
in_network	The source network feature.	Feature Layer
in_source_unit_of_measure	The unit of measure of the source network layer.	String
in_target_unit_of_measure	The unit of measure to which the source network layer values will convert.	String
in_precision	The number of decimals for the target units.	Long

Code sample

ConvertMValueUnitsOfMeasure example 1 (Python window)

The following script demonstrates how to use the ConvertMValueUnitsOfMeasure function in immediate mode.

# tool variables
in_network = "network_lyr"
in_source_unit_of_measure = "feet"
in_target_unit_of_measure = "miles"
in_precision = "3"

# set current workspace
arcpy.env.workspace="C:/Data/NY_Data.gdb/LRSN_MilePoint"

# execute the tool
arcpy.ConvertMValueUnitsOfMeasure_locref(in_network, in_source_unit_of_measure, in_target_unit_of_measure, in_precision)

ConvertMValueUnitsOfMeasure example 2 (stand-alone script)

The following python script demonstrates how to use ConvertMValueUnitsOfMeasure in a stand alone python script.

# Name: ConvertM-ValueUnitsOfMeasure.py
# Description: Converts the measure (m) values of a dataset from one unit to another. The m-values of the input dataset are modified upon executing this tool.
# Requires: Esri Roads and Highways Solution

# Import arcpy module
import arcpy

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

# Local variables:
network = r"C:/Data/NY_Data.gdb/LRSN_MilePoint"

# Make a feature layer for network
arcpy.MakeFeatureLayer_management(network, "network_lyr")

# Process: Convert M-value Units Of Measure
arcpy.ConvertMValueUnitsOfMeasure_locref("network_lyr", "Feet", "Miles", "3")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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