Crear rutas (Referenciación 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 del campo Identificador de rutas se escriben en la clase de entidad de ruta de salida.

  • Use la herramienta Crear capa de entidades o Crear tabla de consulta para reducir eficazmente el número de líneas que se utilizarán para crear rutas.

  • Si la Clase de entidad de ruta de salida se escribirá en una geodatabase, se debe establecer un entorno con Tolerancia M, Resolución M y Dominio M adecuados.

  • Use un 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 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 Omitir huecos espaciales no se utiliza si se ha especificado la opción Valores de dos campos Origen de mediciones. Se debe a que los valores de medición se dictan desde los valores Campo de medición inicial y Campo de medición final.

  • Si se utiliza la opción Longitud de entidades o Valores de un solo campo Origen de mediciones, la 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 utiliza la opción Valores de dos campos Origen de mediciones, no es necesario especificar una prioridad de coordenadas porque la dirección de medición depende de los valores del Campo de medición inicial y el 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 ruta de salida para la segmentación dinámica, se recomienda que elija tener un índice de atributo creado.

  • Si la herramienta Crear rutas rechaza entidades, 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 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 (de medición).

Parámetros

EtiquetaExplicaciónTipo 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.

Field
Clase de entidad de rutas de salida

La clase de entidad que se creará. Puede ser una clase de entidad de shapefile o de geodatabase.

Feature Class
Fuente de medición

Especifica cómo se obtendrán las mediciones.

  • Longitud de entidadesLas 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 únicoEl valor que se almacenó en un solo campo se utilizará para acumular las mediciones.
  • Valores de dos camposLos valores almacenados en los campos de medición inicial y final se utilizarán para establecer las mediciones.
String
Campo de medición inicial
(Opcional)

Un campo que contiene los valores de medición. Este campo debe ser numérico y se requiere cuando el origen de mediciones es Valores de un solo campo o Valores de dos campos.

Field
Campo de medición final
(Opcional)

Un campo que contiene los valores de medición. Este campo debe ser numérico y se requiere cuando el origen de mediciones es Valores de dos campos.

Field
Prioridad de coordenadas
(Opcional)

La posición desde la que se acumularán las mediciones para cada ruta de salida. Este parámetro se ignora cuando el origen de mediciones es Valores de dos campos.

  • Esquina superior izquierdaLas 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 izquierdaLas 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 derechaLas 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 derechaLas 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 si el origen de mediciones es Longitud de entidades o Valores de un solo campo.

  • Activada: se ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada.
  • Desactivada: no ignorar 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.

  • Activada: crear un índice de atributos. Esta es la opción predeterminada.
  • Desactivada: no crear un índice de atributos.
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})
NombreExplicaciónTipo 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.

  • LENGTHLas longitudes geométricas de las entidades de entrada se utilizarán para acumular las mediciones. Esta es la opción predeterminada.
  • ONE_FIELDEl valor que se almacenó en un solo campo se utilizará para acumular las mediciones.
  • TWO_FIELDSLos valores almacenados en los campos de medición inicial y final se utilizarán para establecer 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 el origen de mediciones 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 el origen de mediciones 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 el origen de mediciones es TWO_FIELDS.

  • UPPER_LEFTLas 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_LEFTLas mediciones se acumularán desde el punto más cercano hasta la esquina inferior izquierda del rectángulo mínimo de delimitación.
  • UPPER_RIGHTLas mediciones se acumularán desde el punto más cercano hasta la esquina superior derecha del rectángulo mínimo de delimitación.
  • LOWER_RIGHTLas 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 si el origen de mediciones es LENGTH o ONE_FIELD.

  • IGNORESe ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada.
  • NO_IGNORENo 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.

  • INDEXCrea un índice de atributos. Esta es la opción predeterminada.
  • NO_INDEXNo crea un índice de atributos.
Boolean

Muestra de código

Ejemplo 1 de CreateRoutes (ventana de Python)

En el siguiente script de la ventana de Python se muestra cómo utilizar la función CreateRoutes en la ventana de Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CreateRoutes_lr(base_roads.shp, "route1", "newRoutes", "LENGTH", "#", "#", 
                      "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.

# 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.
# 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" 
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "LENGTH", "#", "#", 
                      "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.

# 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
# 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
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "ONE_FIELD", m_fld, "#", 
                      "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 de Python independiente utilizando datos de geodatabase corporativa.

# Name CreateRoutes_Example4.py
# Description:  Create routes from lines. The lines are in an enterprise 
# geodatabase. The TWO_FIELD 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 standalone 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 standalone feature class
# Execute CreateRoutes
arcpy.CreateRoutes_lr(in_lines, rid, out_routes, "TWO_FIELDS", fr_fld, to_fld)

Información de licenciamiento

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

Temas relacionados