Crear rutas (Referencia lineal)
Resumen
Crea rutas desde líneas existentes. Las entidades de línea de entrada que comparten un identificador en común se fusionan para crear una única ruta.
Uso
-
Los valores únicos en el Campo Identificador de rutas se escriben en la Clase de entidad de rutas de salida.
-
Utilice las herramientas Crear capa de entidades o Realizar tabla de consultas para reducir eficazmente el número de líneas que se utilizarán para crear las rutas.
-
Si la Clase de entidad de rutas de salida se escribirá en una geodatabase, se debe establecer una Tolerancia M, Resolución M y un Dominio M apropiados.
-
Utilice un Factor de medición para convertir entre las unidades de medida de ruta. Por ejemplo, para convertir de pies a millas, utilice un factor de 0,00018939394.
-
Utilice un Desplazamiento de medición en las aplicaciones donde la medición de origen de cada ruta debe tener un valor distinto de 0.
-
El parámetro Ignorar espacios no se utiliza cuando se especificó la opción Fuente de medición TWO_FIELDS. Esto se debe a que los valores de medición se determinan por los valores Campo de medición inicial y Campo de medición final.
-
Cuando se utiliza la opción Fuente de medición LENGTH o ONE_FIELD, se determina la Prioridad de coordenadas al colocar el rectángulo mínimo de delimitación alrededor de las entidades de entrada que se fusionarán para crear una ruta.
-
Cuando se utiliza la opción Fuente de medición TWO_FIELDS, no es necesario especificar una prioridad de coordenadas porque la dirección de la medida está implícita por los valores en el Campo de medición inicial y el Campo de medición final.
-
Un índice de atributos en el campo de identificador de rutas acelera el proceso de segmentación dinámica. Si utilizará la Clase de entidad de rutas de salida para la segmentación dinámica, se recomienda que elija crear un índice de atributos.
-
Si la herramienta Crear rutas rechaza alguna de las entidades, se crea un archivo de texto en la ruta de archivo temporal para almacenar la información acerca de esas entidades. Por ejemplo, C:\Documents and Settings\patrickb\Configuración local\Temp\Create_Output0.txt (donde Create_Output es el nombre de la clase de entidad de ruta de salida).
-
Se ignorará la configuración del entorno outputMFlag. La Clase de entidad de rutas de salida tendrá valores M (medida).
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_line_features |
Las entidades a partir de las cuales se crearán las rutas. | Feature Layer |
route_id_field |
El campo que contiene los valores que identifican de manera única cada ruta. | Field |
out_feature_class |
La clase de entidad que se creará. Puede ser una clase de entidad de shapefile o de geodatabase. | Feature Class |
measure_source |
Especifica cómo se obtendrán las mediciones.
| String |
from_measure_field (Opcional) |
Un campo que contiene los valores de medición. Este campo debe ser numérico y se requiere cuando la fuente de medición es ONE_FIELD o TWO_FIELDS. | Field |
to_measure_field (Opcional) |
Un campo que contiene los valores de medición. Este campo debe ser numérico y se requiere cuando la fuente de medición es TWO_FIELDS. | Field |
coordinate_priority (Opcional) |
La posición desde la que se acumularán las mediciones para cada ruta de salida. Este parámetro se ignora cuando la fuente de medición es TWO_FIELDS.
| String |
measure_factor (Opcional) |
Un valor multiplicado por la longitud de medición de cada línea de entrada antes de que se fusionen para crear las mediciones de ruta. El valor predeterminado es 1. | Double |
measure_offset (Opcional) |
Un valor que se agregó a las mediciones de ruta después de que se fusionaron las líneas de entrada para crear una ruta. El valor predeterminado es 0. | Double |
ignore_gaps (Opcional) |
Especifica si se ignorarán los espacios cuando se calculen las medidas de las rutas disconexas. Este parámetro se aplica cuando la fuente de medición es LENGTH o ONE_FIELD.
| Boolean |
build_index (Opcional) |
Especifica si se creará un índice de atributos para el campo identificador de rutas que se escriba en la clase de entidad de rutas de salida.
| Boolean |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función CreateRoutes en la ventana de Python.
import arcpy from arcpy import env env.workspace = "C:/Data" arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función CreateRoutes con los datos de shapefile en una secuencia de comandos de Python independiente.
# Name CreateRoutes_Example2.py # Description: Create routes from lines. The lines are in a shapefile workspace. # The LENGTH option will be used to set the measures, and a measure factor # will be used to convert measure units from feet to miles. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data" # Set local variables in_lines = "base_roads.shp" rid = "route1" out_routes = "create_output1" # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "LENGTH", "#", "#", "LOWER_LEFT", 0.00018939394)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función CreateRoutes con los datos de geodatabase de archivos en una secuencia de comandos de Python independiente.
# Name CreateRoutes_Example3.py # Description: Create routes from lines. The lines are in a file geodatabase. # The ONE_FIELD option will be used to set the measures. # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.gdb" # Set local variables in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset rid = "route1" m_fld = "len_mile" out_routes = "roads/create_output2" # write the result to the roads feature dataset # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función CreateRoutes en una secuencia de comandos de Python independiente utilizando los datos de geodatabase personal.
# Name: CreateRoutes_Example4.py # Description: Create routes from lines. The lines are in a personal geodatabase. # The ONE_FIELD option will be used to set the measures. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.mdb" # Set local variables in_lines = "roads/base_roads" # base_roads exists in the roads feature dataset rid = "route1" m_fld = "len_mile" out_routes = "roads/create_output2" # write the result to the roads feature dataset # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", "LOWER_LEFT")
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función CreateRoutes en una secuencia de comandos de Python independiente utilizando los datos SDE.
# Name CreateRoutes_Example5.py # Description: Create routes from lines. The lines are in an enterprise geodatabase. # The TWO_FIELD option will be used to set the measures. # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "Database Connections/Connection to Jerry.sde" # Set local variables in_lines = gp.QualifyTableName("base_roads", wkspc) # base_roads is a standalone feature class rid = "route1" fr_fld = "begmp1" to_fld = "endmp1" out_routes = "create_output3" # write the result to a standalone feature class # Execute CreateRoutes arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)