Convert M-Value Units Of Measure

Résumé

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.

Utilisation

• This tool is used for the HPMS 2012 models.

  Remarque :

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

  Learn more about route calibration

Syntaxe

arcpy.locref.ConvertMValueUnitsOfMeasure(in_network, in_source_unit_of_measure, in_target_unit_of_measure, in_precision)

Paramètre	Explication	Type de données
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

Exemple de code

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")

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

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