Crear red LRS a partir de un dataset existente (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Crea una red LRS mediante una clase de entidad de polilínea existente.

Uso

  • Crea una red LRS en un sistema de referenciación lineal (LRS) de ArcGIS Location Referencing.

  • La clase de entidad de entrada debe estar vacía y residir en un dataset de entidades que contenga un dataset LRS. La clase de entidad de entrada no debe estar ya registrada con una red LRS Location Referencing existente.

  • Si el espacio de trabajo de entrada contiene más de un LRS, el LRS seleccionado se utilizará para el registro de red.

  • El nombre de la clase de entidad de entrada debe tener 26 caracteres o menos.

  • La resolución x,y y la tolerancia x,y de la clase de entidad de entrada deben coincidir con la configuración de resolución y tolerancia del LRS Location Referencing.

    Más información sobre la configuración de tolerancia y resolución del LRS en ArcGIS Pipeline Referencing y la configuración de tolerancia y resolución en ArcGIS Roads and Highways.

  • La unidad de medida y la tolerancia m de la red LRS de salida se derivarán a partir de la referencia espacial de la clase de entidad de línea de centro dentro del espacio de trabajo de la clase de entidad de entrada.

  • De forma predeterminada, la herramienta generará una red LRS que no admite líneas. Para crear una red LRS que admita líneas, habilite el parámetro Incluir campos para admitir líneas y asigne los campos adicionales requeridos para una red de líneas LRS (Id. de línea, nombre de línea y orden de línea). Para crear una red derivada de LRS, habilite el parámetro Derivar a partir de la red de línea y proporcione la red de líneas LRS a la que se registrará la red derivada de LRS.

  • Esta herramienta no modifica la clase de entidad de entrada y, en su lugar, agregará información a las tablas de metadatos internas para registrar la clase de entidad de entrada como la clase de entidad de red LRS.

  • Una clase de entidad solo se puede registrar como una clase de entidad de red LRS cada vez. Elimine la red LRS a la que está registrada una clase de entidad para utilizar una clase de entidad que ya esté registrada.

  • Los campos de entrada solo se pueden asignar a un parámetro de campo de red LRS a la vez.

  • La salida de esta herramienta es una red LRS que residirá en el mismo espacio de trabajo que la clase de entidad de entrada.

  • El Id. de ruta puede ser un único campo o una concatenación de varios campos. Si la red utiliza un Id. de ruta concatenado, todos los campos que componen el Id. de ruta deben estar presentes en la clase de entidad de red.

  • Al utilizar una geodatabase corporativa como entrada de esta herramienta, el usuario actual de la base de datos no puede ser SDE ni DBO.

Parámetros

EtiquetaExplicaciónTipo de datos
Clase de entidad de red LRS

La clase de entidad de entrada que se registrará como la red LRS. El nombre de la clase de entidad debe tener 26 caracteres o menos. La clase de entidad debe residir en una geodatabase que contenga un LRS de Pipeline Referencing. El nombre de esta clase de entidad se utilizará como el nombre de la red LRS.

Feature Layer
Nombre de LRS

El nombre de LRS en el que se registrará la nueva red LRS. El LRS debe residir en la misma geodatabase que la Clase de entidad de red LRS.

String
Campo Id. de ruta

El campo en la Clase de entidad de red LRS que se asignará como Id. de ruta de red LRS. Debe ser un tipo de campo de cadena de caracteres o GUID.

Field
Campo de nombre de ruta

Un campo de cadena de caracteres de la Clase de entidad de red LRS que se asignará como nombre de ruta de red LRS.

Field
Campo de fecha inicial

Un campo de fecha en la Clase de entidad de red LRS que se asignará como la fecha inicial de la red LRS.

Field
Campo de fecha final

Un campo de fecha de la Clase de entidad de red LRS que se asignará como fecha final de la red LRS.

Field
Derivar a partir de la red de línea
(Opcional)

Especifica si la red se configurará como una red derivada de LRS.

  • Activado: la salida de esta herramienta será una red derivada de LRS. También se debe proporcionar el parámetro Nombre de red de línea.
  • Desactivado: la salida de esta herramienta no será una red derivada de LRS. Esta es la opción predeterminada.
Boolean
Nombre de red de línea
(Opcional)

El nombre de la red de líneas LRS con la que se registrará la red derivada de LRS de salida. La red de líneas LRS de entrada debe residir en el mismo espacio de trabajo de geodatabase que la Clase de entidad de red LRS. Este parámetro solo se usa si el parámetro Derivar a partir de la red de línea está activado.

String
Incluir campos para admitir líneas
(Opcional)

Especifica si la red se configurará para admitir líneas.

  • Activado: la salida de esta herramienta será una red de líneas LRS. También se deben proporcionar los parámetros Campo de Id. de línea, Campo de nombre de línea y Campo de orden de línea.
  • Desactivado: la salida de esta herramienta no será una red de líneas LRS. Esta es la opción predeterminada.
Boolean
Campo de Id. de línea
(Opcional)

El campo en la Clase de entidad de red LRS que se asignará como Id. de línea de red LRS. Este parámetro solo se utiliza si el parámetro Incluir campos para admitir líneas está activado. Debe ser un tipo de campo de cadena de caracteres o GUID y debe coincidir con el tipo de campo y la longitud del campo de Id. de ruta en la tabla de secuencia de líneas centrales. La entrada del parámetro Campo de Id. de línea también debe tener el mismo tipo de campo que la entrada del parámetro Campo de Id. de ruta.

Field
Campo de nombre de línea
(Opcional)

Un campo de cadena de caracteres de la Clase de entidad de red LRS que se asignará como el nombre de línea de red LRS. Este parámetro solo se utiliza si el parámetro Incluir campos para admitir líneas está activado.

Field
Campo de orden de línea
(Opcional)

Un campo de tipo entero de la Clase de entidad de red LRS que se asignará como orden de línea de red LRS. Este parámetro solo se utiliza si el parámetro Incluir campos para admitir líneas está activado. Este debe ser un tipo de campo de tipo entero largo.

Field
Configuración de campo de Id. de ruta
(Opcional)

Especifica la configuración de Id. de ruta para la red LRS.

  • Id. de ruta generado automáticamenteEl campo Id. de ruta será un GUID generado automáticamente. El nombre de ruta se puede configurar como un campo LRS. Esta es la opción predeterminada.
  • Id. de ruta de campo únicoEl campo Id. de ruta será un único campo generado por el usuario. Solo se admiten redes sin líneas.
  • Id. de ruta de varios camposEl campo Id. de ruta será un campo generado por el usuario concatenado desde más de un campo para formar el Id. de ruta. Solo se admiten redes sin líneas.
String
Campos
(Opcional)

Los campos individuales de la Clase de entidad de red LRS que se utilizarán para formar el Id. de ruta. Este parámetro solo se utiliza si el valor del parámetro Configuración de campo de Id. de ruta está establecido en Id. de ruta de varios campos. Los campos deben ser tipos de campo de cadena de caracteres o enteros.

Field

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de red de salida

La capa de entidad de red actualizada.

Feature Layer

arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, {derive_from_line_network}, {line_network_name}, {include_fields_to_support_lines}, {line_id_field}, {line_name_field}, {line_order_field}, {route_id_configuration}, {individual_route_id_fields})
NombreExplicaciónTipo de datos
in_feature_class

La clase de entidad de entrada que se registrará como la red LRS. El nombre de la clase de entidad debe tener 26 caracteres o menos. La clase de entidad debe residir en una geodatabase que contenga un LRS de Pipeline Referencing. El nombre de esta clase de entidad se utilizará como el nombre de la red LRS.

Feature Layer
lrs_name

El nombre de LRS en el que se registrará la nueva red LRS. El LRS debe residir en la misma geodatabase que in_feature_class.

String
route_id_field

El campo de in_feature_class que se asignará como Id. de ruta de red LRS. Debe ser un tipo de campo de cadena de caracteres o GUID.

Field
route_name_field

Un campo de cadena de caracteres de in_feature_class que se asignará como nombre de ruta de red LRS.

Field
from_date_field

Un campo de fecha en in_feature_class que se asignará como la fecha inicial de la red LRS.

Field
to_date_field

Un campo de fecha en in_feature_class que se asignará como la fecha final de la red LRS.

Field
derive_from_line_network
(Opcional)

Especifica si la red se configurará como una red derivada de LRS.

  • DERIVELa salida de esta herramienta será una red derivada de LRS. También se debe proporcionar el parámetro line_network_name.
  • DO_NOT_DERIVELa salida de esta herramienta no será una red derivada de LRS. Esta es la opción predeterminada.
Boolean
line_network_name
(Opcional)

El nombre de la red de líneas LRS con la que se registrará la red derivada de LRS de salida. La red de líneas LRS de entrada debe residir en el mismo espacio de trabajo de geodatabase que in_feature_class. Este parámetro solo se utiliza si el valor del parámetro derive_from_line_network está establecido en DERIVE.

String
include_fields_to_support_lines
(Opcional)

Especifica si la red se configurará para admitir líneas.

  • INCLUDELa salida de esta herramienta será una red de líneas LRS. También deben proporcionarse los parámetros line_id_field, line_name_field y line_order_field.
  • DO_NOT_INCLUDELa salida de esta herramienta no será una red de líneas LRS. Esta es la opción predeterminada.
Boolean
line_id_field
(Opcional)

El campo de in_feature_class que se asignará como Id. de línea de red LRS. Este parámetro solo se utiliza si el valor del parámetro include_fields_to_support_lines está establecido en INCLUDE. Debe ser un tipo de campo de cadena de caracteres o GUID y debe coincidir con el tipo de campo y la longitud del campo de Id. de ruta en la tabla de secuencia de líneas centrales.

Field
line_name_field
(Opcional)

Un campo de cadena de caracteres de in_feature_class que se asignará como el nombre de línea de red LRS. Este parámetro solo se utiliza si el valor del parámetro include_fields_to_support_lines está establecido en INCLUDE.

Field
line_order_field
(Opcional)

Un campo de tipo entero de in_feature_class que se asignará como orden de línea de red LRS. Este parámetro solo se utiliza si el valor del parámetro include_fields_to_support_lines está establecido en INCLUDE.

Field
route_id_configuration
(Opcional)

Especifica la configuración de Id. de ruta para la red LRS.

  • AUTOGENERATED_ROUTE_IDEl campo Id. de ruta será un GUID generado automáticamente. El nombre de ruta se puede configurar como un campo LRS. Esta es la opción predeterminada.
  • SINGLE_FIELD_ROUTE_IDEl campo Id. de ruta será un único campo generado por el usuario. Solo se admiten redes sin líneas.
  • MULTI_FIELD_ROUTE_IDEl campo Id. de ruta será un campo generado por el usuario concatenado desde más de un campo para formar el Id. de ruta. Solo se admiten redes sin líneas.
String
individual_route_id_fields
[individual_route_id_fields,...]
(Opcional)

Los campos individuales de in_feature_class que se usarán para formar el Id. de ruta. Este parámetro solo se utiliza si el valor del parámetro route_id_configuration está establecido en MULTI_FIELD_ROUTE_ID. Los campos deben ser tipos de campo de cadena de caracteres o enteros.

Field

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

La capa de entidad de red actualizada.

Feature Layer

Muestra de código

Ejemplo de CreateLRSNetworkFromExistingDataset 1 (ventana de Python)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en la ventana de Python para crear una red de líneas LRS a partir de una clase de entidad de polilínea existente.

# Name: Create_LRS_Event_From_Existing_Dataset_ex1.py
# Description: Create an LRS Line Network in the Python window.
# Requires: ArcGIS Location Referencing 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = "RouteName"
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = "DO_NOT_DERIVE"
line_network_name = ""
include_fields_to_support_lines = "INCLUDE"
line_id_field = "LineId"
line_name_field = "LineName"
line_order_field = "LineOrder"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"
 
# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field,
                                                 from_date_field, to_date_field, derive_from_line_network,
                                                 line_network_name, include_fields_to_support_lines, line_id_field,
                                                 line_name_field, line_order_field)
                                                 

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 2 (script independiente)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en un script independiente de Python para crear una red LRS a partir de una clase de entidad de polilínea existente.

# Name: CreateLRSNetworkFromExisting_ex2.py
# Description: Create an LRS Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 3 (script independiente)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en un script independiente de Python para crear una red de líneas LRS a partir de una clase de entidad de polilínea existente.

# Name: CreateLRS_Line_NetworkFromExisting_ex3.py
# Description: Create an LRS Line Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"
Derive = "DO_NOT_DERIVE"
Derive_From = ""
Line_Support = "INCLUDE"
Line_ID = "LineId"
Line_Name = "LineName"
Line_Order = "LineOrder"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive,
                                                 Derive_From, Line_Support, Line_ID, Line_Name, Line_Order)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 4 (script independiente)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en un script independiente de Python para crear una red derivada de LRS a partir de una clase de entidad de polilínea existente.

# Name: CreateLRS_Derived_NetworkFromExisting_ex4.py
# Description: Create an LRS Derived Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\DerivedNetwork"
LRS_Name = "LRS"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate"
To_Date = "ToDate"
Derive = "DERIVE"
Derive_From = "EngineeringNetwork"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 5 (ventana de Python)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en la ventana de Python para crear un Id. de ruta de un solo campo definido por el usuario a partir de una clase de entidad de polilínea existente.

# Name: CreateLRSNetworkFromExisting_ex5.py
# Description: Create a user-defined, single-field route ID in an LRS Network.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines = ""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, Individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 6 (ventana de Python)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en la ventana de Python para crear un Id. de ruta de varios campos definido por el usuario a partir de una clase de entidad de polilínea existente.

# Name: CreateLRSNetworkFromExisting_ex6.py
# Description: Create a user-defined, single-field route ID in an LRS Network.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
lrs_name = "LRS"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines = ""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(in_feature_class, lrs_name, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, Individual_route_id_fields)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 7 (script independiente)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en la ventana de Python para crear una red de Id. de ruta de un solo campo definida por el usuario a partir de una clase de entidad de polilínea existente.

# Name: CreateLRSNetworkFromExisting_ex7.py
# Description: Create a user defined, single-field route ID in an LRS Network from an existing polyline feature class.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork "
LRS_Name = "LRS"
Route_ID = "RouteID"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de CreateLRSNetworkFromExistingDataset 8 (script independiente)

Utilice la herramienta CreateLRSNetworkFromExistingDataset en la ventana de Python para crear una red de Id. de ruta de varios campos definida por el usuario a partir de una clase de entidad de polilínea existente.

# Name: CreateLRSNetworkFromExisting_ex8.py
# Description: Create a user defined, multifield route ID network from an existing polyline feature class.
# Requires: Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_FC = r"C:\UPDM_Data\LRS.gdb\LRS\LRSNetwork"
LRS_Name = "LRS"
Route_ID = "RouteID"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Execute the tool
arcpy.locref.CreateLRSNetworkFromExistingDataset(Input_FC, LRS_Name, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Información de licenciamiento

  • Basic: Requiere ArcGIS Location Referencing
  • Standard: Requiere ArcGIS Location Referencing
  • Advanced: Requiere ArcGIS Location Referencing

Temas relacionados