Crear rutas (Referenciación lineal)—ArcGIS Pro

Resumen

Crea rutas desde líneas existentes. Las entidades de línea de entrada que comparten un identificador en común se fusionarán para crear una única ruta.

Uso

Los valores únicos del valor del parámetro Campo de identificador de rutas se escriben en el parámetro Clase de entidad de ruta de salida.
Utilice las herramientas Crear capa de entidades o Crear tabla de consultas para reducir el número de líneas que se utilizarán para crear rutas.
Si el valor del parámetro Clase de entidad de rutas de salida se escribirá en una geodatabase, establezca los entornos Tolerancia M, Resolución M y Dominio M.
Al establecer la fuente de medición como la longitud de las entidades para acumular medidas utilizando longitudes geométricas, las longitudes 2D y 3D están disponibles. Para valores de longitud 2D, utilice la longitud de la entidad. Para valores de longitud 3D, cree una regla de atributos de cálculo en un nuevo campo con desencadenadores de inserción o actualización que devuelvan la función Length3DArcGIS Arcade.
Más información sobre la creación y administración de reglas de atributos
Use un parámetro Factor de medición para convertir entre unidades de medición de ruta. Por ejemplo, para convertir de pies a millas, utilice un factor de 0,00018939394.
Use un valor de parámetro Desplazamiento de medición en las aplicaciones cuya medida de inicio en cada ruta tenga que ser un valor distinto de 0.
El parámetro Ignorar espacios espaciales no se utiliza cuando el parámetro Fuente de medición se especifica como Valores de dos campos. Se debe a que los valores de medición se basan en los valores de los parámetros Campo de medición inicial y Campo de medición final.
Cuando el parámetro Origen de mediciones se especifica como Longitud de entidades o Valores de un campo único, el valor del parámetro Prioridad de coordenadas se determina colocando el rectángulo mínimo de delimitación alrededor de las entidades de entrada que se fusionarán para crear una ruta.
Si se especifica el parámetro Fuente de medición como Valores de dos campos, no es necesario especificar una prioridad de coordenadas porque la dirección de medición está implícita en los valores de los parámetros Campo de medición inicial y Campo de medición final.
Un índice de atributos en el campo identificador de rutas acelera el proceso de segmentación dinámica. Si va a utilizar el valor del parámetro Clase de entidad de rutas de salida para la segmentación dinámica, se recomienda que cree un índice de atributos.
Si esta herramienta rechaza alguna entidad, se crea un archivo de texto en la ruta de archivo temporal para almacenar información sobre esas entidades, por ejemplo, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (donde Create_Output es el nombre de la clase de entidad de la ruta de salida).
La configuración del entorno La salida tiene valores M se ignorará. El valor del parámetro Clase de entidad de ruta de salida tendrá valores m (valores de medición).

Parámetros

Etiqueta	Explicación	Tipo de datos
Entidades de línea de entrada	Las entidades a partir de las cuales se crearán las rutas.	Feature Layer
Campo Identificador de rutas	El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID.	Field
Clase de entidad de ruta de salida	La clase de entidad que se va a crear. La clase de entidad puede ser un shapefile o una clase de entidad de geodatabase.	Feature Class
Fuente de medición	Especifica cómo se acumularán las mediciones. Longitud de entidades—Las longitudes geométricas de las entidades de entrada se utilizarán para acumular las mediciones. Esta es la opción predeterminada. Valores de un campo único—El valor que se almacenó en un solo campo se utilizará para acumular las mediciones. Valores de dos campos—Los valores almacenados en los campos de medición inicial y final se utilizarán para acumular las mediciones.	String
Campo de medición inicial (Opcional)	Un campo que contiene los valores de medición. Este parámetro es obligatorio cuando el valor del parámetro Fuente de medición es Valores de un campo único o Valores de dos campos.	Field
Campo de medición final (Opcional)	Un campo numérico que contiene valores de medición. Este parámetro es obligatorio cuando el valor del parámetro Fuente de medición es Valores de dos campos.	Field
Prioridad de coordenadas (Opcional)	Especifica la posición desde la que se acumularán las mediciones para cada ruta de salida. Este parámetro se ignora cuando el valor del parámetro Fuente de medición es Valores de dos campos. Esquina superior izquierda—Las mediciones se acumularán desde el punto más cercano hasta la esquina superior izquierda del rectángulo mínimo de delimitación. Esta es la opción predeterminada. Esquina inferior izquierda—Las mediciones se acumularán desde el punto más cercano hasta la esquina inferior izquierda del rectángulo mínimo de delimitación. Esquina superior derecha—Las mediciones se acumularán desde el punto más cercano hasta la esquina superior derecha del rectángulo mínimo de delimitación. Esquina inferior derecha—Las mediciones se acumularán desde el punto más cercano hasta la esquina inferior derecha del rectángulo mínimo de delimitación.	String
Factor de medición (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
Desplazamiento de medición (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
Ignorar espacios (Opcional)	Especifica si se ignorarán los espacios cuando se calculen las medidas de las rutas disconexas. Este parámetro se aplica cuando el valor del parámetro Fuente de medición es Longitud de entidades o Valores de un campo único. Activado: se ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada. No activado: se ignoran los espacios. Los valores de medición de las rutas inconexas tendrán espacios. La distancia del espacio se calcula utilizando la distancia recta entre los extremos de las partes inconexas.	Boolean
Crear índice (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. Activado: se creará un índice de atributo. Esta es la opción predeterminada. Desactivado: no se creará ningún índice de atributo.	Boolean

arcpy.lr.CreateRoutes(in_line_features, route_id_field, out_feature_class, measure_source, {from_measure_field}, {to_measure_field}, {coordinate_priority}, {measure_factor}, {measure_offset}, {ignore_gaps}, {build_index})

Nombre	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. El campo puede ser un campo numérico, de texto o GUID.	Field
out_feature_class	La clase de entidad que se va a crear. La clase de entidad puede ser un shapefile o una clase de entidad de geodatabase.	Feature Class
measure_source	Especifica cómo se acumularán las mediciones. LENGTH—Las longitudes geométricas de las entidades de entrada se utilizarán para acumular las mediciones. Esta es la opción predeterminada. ONE_FIELD—El valor que se almacenó en un solo campo se utilizará para acumular las mediciones. TWO_FIELDS—Los valores almacenados en los campos de medición inicial y final se utilizarán para acumular las mediciones.	String
from_measure_field (Opcional)	Un campo que contiene los valores de medición. Este parámetro es obligatorio cuando el valor del parámetro measure_source es ONE_FIELD o TWO_FIELDS.	Field
to_measure_field (Opcional)	Un campo numérico que contiene valores de medición. Este parámetro es obligatorio cuando el valor del parámetro measure_source es TWO_FIELDS.	Field
coordinate_priority (Opcional)	Especifica la posición desde la que se acumularán las mediciones para cada ruta de salida. Este parámetro se ignora cuando el valor del parámetro measure_source es TWO_FIELDS. UPPER_LEFT—Las mediciones se acumularán desde el punto más cercano hasta la esquina superior izquierda del rectángulo mínimo de delimitación. Esta es la opción predeterminada. LOWER_LEFT—Las mediciones se acumularán desde el punto más cercano hasta la esquina inferior izquierda del rectángulo mínimo de delimitación. UPPER_RIGHT—Las mediciones se acumularán desde el punto más cercano hasta la esquina superior derecha del rectángulo mínimo de delimitación. LOWER_RIGHT—Las mediciones se acumularán desde el punto más cercano hasta la esquina inferior derecha del rectángulo mínimo de delimitación.	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 el valor del parámetro measure_source es LENGTH o ONE_FIELD. IGNORE—Se ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada. NO_IGNORE—No se ignoran los espacios. Los valores de medición de las rutas inconexas tendrán espacios. La distancia del espacio se calcula utilizando la distancia recta entre los extremos de las partes inconexas.	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. INDEX—Se creará un índice de atributo. Esta es la opción predeterminada. NO_INDEX—No se creará ningún índice de atributo.	Boolean

Muestra de código

Ejemplo 1 de CreateRoutes (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función CreateRoutes.


import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.CreateRoutes(base_roads.shp, "route1", "newRoutes", "LENGTH", None, None, 
                      "LOWER_LEFT", 0.00018939394)

Ejemplo 2 de CreateRoutes (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función CreateRoutes con datos de shapefile en un script independiente de Python.

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

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_lines = "base_roads.shp"
rid = "route1" 
out_routes = "create_output1" 

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "LENGTH", None, None, 
                      "LOWER_LEFT", 0.00018939394)

Ejemplo 3 de CreateRoutes (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función CreateRoutes con datos de geodatabase de archivos en un script independiente de Python.

# 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

# Set workspace
arcpy.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 result to the roads feature dataset

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "ONE_FIELD", m_fld, None, 
                      "LOWER_LEFT")

Ejemplo 4 de CreateRoutes (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función CreateRoutes en un script independiente de Python con datos de geodatabases corporativas.

# Description:  Create routes from lines. The lines are in an enterprise
# geodatabase. The TWO_FIELDS option will be used to set the measures.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
# base_roads is a stand-alone feature class
in_lines = arcpy.ValidateTableName("base_roads", wkspc)
rid = "route1"
fr_fld = "begmp1"
to_fld = "endmp1" 
out_routes = "create_output3"  # Write the result to a stand-alone feature class

# Run CreateRoutes
arcpy.lr.CreateRoutes(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

Entornos

Espacio de trabajo actual, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Extensión, La salida tiene valores Z, Espacio de trabajo temporal

Información de licenciamiento

Basic: Sí
Standard: Sí
Advanced: Sí

Temas relacionados

¿Algún comentario sobre este tema?