Modificar red LRS (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

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

Uso

  • La clase de entidad de entrada debe representar una red LRS Location Referencing.

  • Esta herramienta no elimina ninguna red LRS, clases de entidad, campos ni datos.

  • Esta herramienta actualiza las tablas de metadatos internas que almacenan información sobre la red LRS de entrada.

  • Esta herramienta permite la reasignación de campos de red LRS, tales como Id. de ruta, nombre de ruta, fecha y campos de medición. Si se habilita que se admitan líneas, los campos de Id. de línea, nombre de línea y orden de línea también se pueden reasignar.

  • Cualquier campo nuevo que se utilizará para la asignación de campos se debe crear en la clase de entidad Red LRS subyacente antes de utilizar esta herramienta.

  • La capacidad de una red LRS de admitir líneas, como en el caso de una red de ingeniería, se puede agregar o quitar con esta herramienta.

  • Si hay una red que admite líneas en el espacio de trabajo de geodatabase de la red LRS de entrada, se puede configurar una red derivada de LRS con esta herramienta. Una red derivada de LRS existente también se puede dar de baja de una red de líneas LRS y registrarse con una red de líneas LRS diferente.

  • Un campo de la red LRS de entrada solo se puede asignar a un único campo de red LRS.

  • El Campo 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.

  • La capacidad de una red LRS de admitir una red de Id. de ruta generada por el usuario se puede agregar o eliminar con esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Clase de entidad de red LRS

La clase de entidad de red LRS de entrada que se va a modificar.

Feature Layer
Campo Id. de ruta
(Opcional)

El campo de la clase de entidad de entrada que se asignará como Id. de ruta de red LRS. El tipo de campo debe coincidir con el tipo de campo RouteId de la tabla Centerline_Sequence y debe ser un tipo de campo de cadena de caracteres o GUID.

Field
Campo de nombre de ruta
(Opcional)

Un campo de cadena de caracteres en la clase de entidad de entrada que se asignará como el nombre de ruta de red LRS.

Field
Campo de fecha inicial
(Opcional)

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

Field
Campo de fecha final
(Opcional)

Un campo de fecha en la clase de entidad de entrada que se asignará como fecha final de la red LRS.

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

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

  • Tal cualLa propiedad derivada de red LRS actual no cambiará. Esta es la opción predeterminada.
  • DerivarLa red derivada de LRS de entrada se modificará para que se convierta en una red derivada de LRS. También se debe proporcionar el parámetro line network name para especificar de qué red LRS se debe derivar.
  • No derivarLa red derivada de LRS de entrada se modificará para que ya no sea una red derivada de LRS.
String
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 entrada. La red de líneas LRS de entrada debe residir en el mismo espacio de trabajo de geodatabase y LRS 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á definido como Derivar.

String
Incluir campos para admitir líneas
(Opcional)

Determina si la red LRS actual se configurará para admitir líneas.

  • Tal cualLa propiedad de admitir línea de red LRS actual no cambiará. Esta es la opción predeterminada.
  • IncluirLa red LRS de entrada se modificará para agregar la compatibilidad con líneas. También se deben proporcionar los parámetros de campo Id. de línea, campo de nombre de línea y campo de orden de línea, y los campos válidos para asignarlos a estos parámetros deben existir en la clase de entidad de red LRS.
  • No incluirLa red LRS de entrada se modificará para quitar la compatibilidad con líneas.
String
Campo de Id. de línea
(Opcional)

El campo en la clase de entidad de entrada 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á definido como Incluir. El tipo de campo debe coincidir con el tipo de campo RouteId de la tabla Centerline_Sequence y debe ser un tipo de campo de cadena de caracteres de exactamente 38 caracteres o un tipo de campo GUID.

Field
Campo de nombre de línea
(Opcional)

Un campo de cadena de caracteres en la clase de entidad de entrada 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á definido como Incluir.

Field
Campo de orden de línea
(Opcional)

El campo en la clase de entidad de entrada 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á definido como Incluir. Este debe ser un tipo de campo de tipo entero largo.

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

Determina la configuración de Id. de ruta de una red LRS.

  • Tal cualLa configuración de Id. de ruta de red LRS actual no se cambiará. Esta es la opción predeterminada.
  • Id. de ruta generado automáticamenteEl campo Id. de ruta será un GUID generado automáticamente y el nombre de ruta se puede configurar como un campo LRS.
  • Id. de ruta de campo únicoSolo se admite para redes sin líneas.
  • Id. de ruta de varios camposSolo se admite para redes sin líneas. Se necesita más de un campo para formar el Id. de ruta concatenado.
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 en el parámetro Configuración de campo Id. de ruta se ha definido la opción Id. de ruta de varios campos. Los campos deben ser tipos de campo de número entero o de cadena de caracteres.

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.ModifyLRSNetwork(in_feature_class, {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 red LRS de entrada que se va a modificar.

Feature Layer
route_id_field
(Opcional)

El campo de la clase de entidad de entrada que se asignará como Id. de ruta de red LRS. El tipo de campo debe coincidir con el tipo de campo RouteId de la tabla Centerline_Sequence y debe ser un tipo de campo de cadena de caracteres o GUID.

Field
route_name_field
(Opcional)

Un campo de cadena de caracteres en la clase de entidad de entrada que se asignará como el nombre de ruta de red LRS.

Field
from_date_field
(Opcional)

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

Field
to_date_field
(Opcional)

Un campo de fecha en la clase de entidad de entrada que se asignará como fecha final de la red LRS.

Field
derive_from_line_network
(Opcional)

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

  • AS_ISLa propiedad derivada de red LRS actual no cambiará. Esta es la opción predeterminada.
  • DERIVELa red derivada de LRS de entrada se modificará para que se convierta en una red derivada de LRS. También se debe proporcionar el parámetro line network name para especificar de qué red LRS se debe derivar.
  • DO_NOT_DERIVELa red derivada de LRS de entrada se modificará para que ya no sea una red derivada de LRS.
String
line_network_name
(Opcional)

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

String
include_fields_to_support_lines
(Opcional)

Determina si la red LRS actual se configurará para admitir líneas.

  • AS_ISLa propiedad de admitir línea de red LRS actual no cambiará. Esta es la opción predeterminada.
  • INCLUDELa red LRS de entrada se modificará para agregar la compatibilidad con líneas. También se deben proporcionar los parámetros de campo Id. de línea, campo de nombre de línea y campo de orden de línea, y los campos válidos para asignarlos a estos parámetros deben existir en la clase de entidad de red LRS.
  • DO_NOT_INCLUDELa red LRS de entrada se modificará para quitar la compatibilidad con líneas.
String
line_id_field
(Opcional)

El campo en la clase de entidad de entrada que se asignará como Id. de línea de red LRS. Este parámetro solo se utiliza si el parámetro include_fields_to_support_lines está establecido en INCLUDE. El tipo de campo debe coincidir con el tipo de campo RouteId de la tabla Centerline_Sequence y debe ser un tipo de campo de cadena de caracteres de exactamente 38 caracteres o un tipo de campo GUID.

Field
line_name_field
(Opcional)

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

Field
line_order_field
(Opcional)

El campo en la clase de entidad de entrada que se asignará como orden de línea de red LRS. Este parámetro solo se utiliza si el parámetro include_fields_to_support_lines está establecido en INCLUDE. Este debe ser un tipo de campo de tipo entero largo.

Field
route_id_configuration
(Opcional)

Determina la configuración de Id. de ruta de una red LRS.

  • AS_ISLa configuración de Id. de ruta de red LRS actual no se cambiará. Esta es la opción predeterminada.
  • AUTOGENERATED_ROUTE_IDEl campo Id. de ruta será un GUID generado automáticamente y el nombre de ruta se puede configurar como un campo LRS.
  • SINGLE_FIELD_ROUTE_IDSolo se admite para redes sin líneas.
  • MULTI_FIELD_ROUTE_IDSolo se admite para redes sin líneas. Se necesita más de un campo para formar el Id. de ruta concatenado.
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 en el parámetro route_id_configuration se ha definido la opción MULTI_FIELD_ROUTE_ID. Los campos deben ser tipos de campo de número entero o de cadena de caracteres.

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 ModifyLRSNetwork 1 (ventana de Python)

Muestra cómo usar la herramienta ModifyLRSNetwork en la ventana de Python.

# Name: Modify_LRS_Network_ex1.py
# Description: Modifies an existing linear referencing system (LRS) in the specified workspace.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\DerivedNetwork"
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 = "EngineeringNetwork"

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

# Execute the tool
arcpy.locref.ModifyLRSNetwork(in_feature_class, route_id_field, route_name_field, from_date_field, to_date_field,
                              derive_from_line_network, line_network_name)
                              
# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo de ModifyLRSNetwork 2 (script independiente)

Demuestra cómo utilizar la herramienta ModifyLRSNetwork como un script independiente de Python.

# Name: Modify_LRS_Network_ex2.py
# Description: Modify an LRS Network to change field mapping for date fields. All other parameters will remain as is.
# Requires: ArcGIS Location Referencing

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

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate_New"
To_Date = "ToDate_New"
Derive = "DO_NOT_DERIVE"
Derive_From = None
Line_Support = "INCLUDE"
Line_ID = "LineId"
Line_Name = "LineName"
Line_Order = "LineOrder"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(Input_Network, 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 ModifyLRSNetwork 3 (ventana de Python)

Muestra cómo utilizar la herramienta ModifyLRSNetwork en la ventana de Python para modificar el campo de Id. de ruta y admitir un Id. de ruta de un solo campo generado por el usuario.

# Name: ModifyLRSNetwork example 3 (Python window)
# Description: ModifyLRSNetwork example 3 (Python window)
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\Network1"
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.ModifyLRSNetwork(in_feature_class, 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 ModifyLRSNetwork 4 (ventana de Python)

Muestra cómo utilizar la herramienta ModifyLRSNetwork en la ventana de Python para modificar el campo de Id. de ruta y admitir un Id. de ruta de varios campos generado por el usuario.

# Name: ModifyLRSNetwork example 4 (Python window)
# Description: ModifyLRSNetwork example 4 (Python window)
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\Network1"
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.ModifyLRSNetwork(in_feature_class, 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 ModifyLRSNetwork 5 (script independiente)

Muestra cómo utilizar la herramienta ModifyLRSNetwork como script de Python independiente para modificar el campo de Id. de ruta y admitir un Id. de ruta de un solo campo generado por el usuario.

# Name: ModifyLRSNetwork example 5 (stand-alone script)
# Description: ModifyLRSNetwork example 5 (stand-alone script)
# Requires: ArcGIS Location Referencing

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

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
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.ModifyLRSNetwork(Input_Network, 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 ModifyLRSNetwork 6 (script independiente)

Muestra cómo utilizar la herramienta ModifyLRSNetwork como script de Python independiente para modificar el campo de Id. de ruta y admitir un Id. de ruta de varios campos generado por el usuario.

# Name: ModifyLRSNetwork example 6 (stand-alone script)
# Description: ModifyLRSNetwork example 6 (stand-alone script)
# Requires: ArcGIS Location Referencing

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

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
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.ModifyLRSNetwork(Input_Network, 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