ArcMap

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.

Syntax

arcpy.locref.ConvertMValueUnitsOfMeasure(in_network, in_source_unit_of_measure, in_target_unit_of_measure, in_precision)
ParameterExplanationData 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.

# Name: ConvertM-ValueUnitsOfMeasure_arcmap.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.

# Import arcpy module
import arcpy

# 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 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.

# 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

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

Related topics