Resumen
Resuelve el problema de análisis de red especificada basada en las banderas, barreras, y las propiedades de peso especificado.
Uso
Esta herramienta no funciona con datasets de red (las redes utilizadas por la extensión ArcGIS Network Analyst).
Esta herramienta realiza una búsqueda espacial mediante el uso de marcadores y barreras de entrada para ubicar entidades coincidentes. Esto se utiliza, en el caso de los marcadores, para determinar las entidades que se deben originar del trazado y, en el caso de las barreras, para determinar las entidades que deben bloquear el trazado. Por lo tanto, los marcadores y barreras de entrada deben estar ubicados correctamente. En ModelBuilder, si no se sabe si los marcadores y barreras están ubicados correctamente, puede utilizar la herramienta Alinear para especificar con qué entidades deben coincidir los marcadores y las barreras.
La salida de esta herramienta es una capa de grupo que contiene una capa para cada clase de entidad contenida dentro de la red geométrica de entrada. Cualquiera de las entidades devueltas desde el trazado se seleccionarán dentro de sus respectiva capa. Cuando el mapa contiene capas de entrada, la capa de grupo de salida puede contener capas sin una selección; estas son las capas vacías de las cuales no se devolvieron entidades del trazado. En ModelBuilder, puede utilizar la herramienta Seleccionar datos para extraer capas específicas de la capa de grupo y la herramienta Crear_capa_de_entidades para crear una capa de entidades de la salida de la herramienta Seleccionar datos. Utilice la herramienta Obtener_conteo para determinar si alguna de las capas en la capa de grupo está vacía. Esto resulta especialmente útil cuando publica el modelo en ArcGIS Server, debido a que las capas de grupo no se admiten como un tipo de parámetro de salida en una tarea de geoprocesamiento. Debido a que no se admiten como salida directa, debe utilizar la herramienta Seleccionar datos para crear una única capa (que no sea de grupo) para la salida.
Esta herramienta no se puede ejecutar mientras edita una red geométrica en una geodatabase personal.
A diferencia de otros datasets, como la topología o datasets de red, las redes geométricas no tienen una capa asociada, por lo tanto, cuando se utiliza esta herramienta en ArcMap la red geométrica debe seleccionarse desde el disco. No hay opción para seleccionar la red geométrica como entrada desde una lista desplegable de capa.
Sintaxis
arcpy.management.TraceGeometricNetwork(in_geometric_network, out_network_layer, in_flags, in_trace_task_type, {in_barriers}, {in_junction_weight}, {in_edge_along_digitized_weight}, {in_edge_against_digitized_weight}, {in_disable_from_trace}, {in_trace_ends}, {in_trace_indeterminate_flow}, {in_junction_weight_filter}, {in_junction_weight_range}, {in_junction_weight_range_not}, {in_edge_along_digitized_weight_filter}, {in_edge_against_digitized_weight_filter}, {in_edge_weight_range}, {in_edge_weight_range_not})| Parámetro | Explicación | Tipo de datos |
in_geometric_network | La red geométrica en la que el trazado se realizará. | Geometric Network |
out_network_layer | El nombre de la capa de grupo que almacenará los resultados del trazado como un conjunto seleccionado. | Group Layer |
in_flags | Entidades de punto que representan un conjunto de marcadores que sirven como puntos de inicio de la operación de trazado. Por ejemplo, si está realizando un trazado aguas arriba, utilice un marcador para especificar dónde se iniciará el trazado aguas arriba. Los marcadores se pueden colocar en cualquier lugar a lo largo de los ejes o cruces, pero los cruces se considerarán primero cuando tanto un eje como un cruce se encuentren en la ubicación. | Feature Layer |
in_trace_task_type | Tarea de trazado que se realiza en la red geométrica especificada.
| String |
in_barriers (Opcional) | Entidades de punto que representan un conjunto de barreras. Las barreras definen lugares de la red a través de los cuales no pueden pasar los trazados. Si solo se desea trazar una parte específica de la red, se pueden usar barreras para aislar esa parte de la red. Las barreras se pueden colocar en cualquier lugar a lo largo de ejes o cruces, pero los cruces se considerarán primero cuando tanto un eje como un cruce se encuentren en la ubicación. La entidad se considerará desactivada y no se tendrá en cuenta durante el trazado a menos que se haya establecido el parámetro in_trace_ends con el valor TRACE_ENDS para buscar intencionadamente las entidades que detienen el trazado. | Feature Layer |
in_junction_weight (Opcional) | Un peso de cruce que se utiliza como un coste para recorrer cualquier cruce. El peso ya debe haberse definido para la red geométrica dada. Este parámetro está deshabilitado o se ignora cuando uno de los siguientes tipos de tareas de trazado de coste independiente se ha especificado:
| String |
in_edge_along_digitized_weight (Opcional) | Un peso de eje que se utiliza como un coste para atravesar un eje a lo largo de la dirección digitalizada de ese eje. El peso ya debe haberse definido para la red geométrica dada. Este parámetro está deshabilitado o se ignora cuando uno de los siguientes tipos de tareas de trazado de coste independiente se ha especificado:
| String |
in_edge_against_digitized_weight (Opcional) | Un peso de eje que se utiliza como un coste para atravesar un eje en contra de la dirección digitalizada de ese eje. El peso ya debe haberse definido para la red geométrica dada. Este parámetro está deshabilitado o se ignora cuando uno de los siguientes tipos de tareas de trazado de coste independiente se ha especificado:
| String |
in_disable_from_trace [in_disable_from_trace,...] (Opcional) | Lista de clases de entidad que están deshabilitadas de participar en el trazado. Especificar una clase de entidad como deshabilitada hace que la operación de trazado trate a todas las entidades en esa clase de entidad como discapacitados o que tienen una barrera ubicadas en ellos. Utilice esta opción para excluir a toda una clase de entidad en consideración durante el trazado. Por ejemplo, deshabilitando la capa de conmutadores en una red de distribución eléctrica, estableciendo el parámetro in_trace_ends con el valor TRACE_ENDS y trazando desde un punto determinado de la red, puede encontrar los conmutadores que hay que apagar para aislar este punto de la red; éstas serán las entidades en las que se detendrá la operación de trazado. | String |
in_trace_ends (Opcional) | Indica si el trazado debería incluir todas las entidades o solo aquellas que detienen el trazado. Utilice esta opción cuando necesite determinar qué entidades detienen el trazado. Para ser devuelto de la operación de trazado con esta opción, las entidades deben caer en una de las siguientes categorías:
| Boolean |
in_trace_indeterminate_flow (Opcional) | Indica si el trazado debería incluir todas las entidades o solo aquellas que detienen el trazado.
Solo se respetan cuando se establece uno de los tipos de tareas de trazado de flujo dependiente:
| Boolean |
in_junction_weight_filter (Opcional) | Ponderación que se utiliza para crear el filtro de ponderación de confluencia que se utiliza para filtrar entidades de confluencia durante el trazado. | String |
in_junction_weight_range (Opcional) | Especifica rangos válidos o no válidos de valores de peso para las entidades de red que se pueden trazar. Está deshabilitada cuando se establece un tipo de tarea de trazado de coste independiente. Para crear el filtro de un peso, debe especificar los rangos de peso válidos para las entidades. El filtro de un peso puede estar compuesto por varios rangos. Al especificar varios rangos de ponderación, delimítelos con comas. Los valores altos y bajos de un rango se separan con un guión. Los rangos que consisten en un solo valor no contienen ningún guión y se delimitan con comas. Por ejemplo: 0-2,3,6,7-10. | String |
in_junction_weight_range_not (Opcional) | Aplica el operador lógico NOT a los rangos de peso de cruce especificados. Por defecto, los rangos de peso de cruce que introduce especifican las entidades de cruce que se pueden trazar. Al activar esta opción, indica que las entidades de cruce con pesos en los rangos que introdujo no se pueden trazar.
| Boolean |
in_edge_along_digitized_weight_filter (Opcional) | El peso que se utiliza para crear el filtro de peso de eje, que se utiliza para filtrar entidades de eje durante el trazado. | String |
in_edge_against_digitized_weight_filter (Opcional) | El peso que se usa para crear el filtro de peso de eje en contra que se utiliza para filtrar entidades de eje durante el trazado. | String |
in_edge_weight_range (Opcional) | Especifica rangos válidos o no válidos de valores de peso para las entidades de red que se pueden trazar. Está deshabilitada cuando se establece un tipo de tarea de trazado de coste independiente. Para crear el filtro de un peso, debe especificar los rangos de peso válidos para las entidades. El filtro de un peso puede estar compuesto por varios rangos. Cuando especifica varios rangos de peso, debe delimitarlos con comas. Los valores altos y bajos de un rango se separan con un guión. Los rangos que consisten en un solo valor no contienen ningún guión y se delimitan con comas. Por ejemplo: 0-2,3,6,7-10. | String |
in_edge_weight_range_not (Opcional) | Aplica el operador lógico NOT a los rangos de ponderación de eje especificados. Por defecto, los rangos de peso de eje que introduce especifican las entidades de eje que se pueden trazar. Al activar esta opción, indica que las entidades de eje con pesos en los rangos que introdujo no se pueden trazar.
| Boolean |
Muestra de código
Ejemplo 1 de TraceGeometricNetwork (secuencia de comandos independiente)
La siguiente secuencia de comandos de Python independiente demuestra cómo utilizar la función TraceGeometricNetwork en una secuencia de comandos de Python para ejecutar un trazado Encontrar Conectado en una red geométrica con marcadores y sin barreras.
# Import arcpy module
import arcpy
# Local variables:
gnVersionFDS_Net = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/gnVersionFDS_1_Net"
Flags = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/Flags"
gnVersionFDS_1 = "gnVersionFDS_1_Net"
# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(gnVersionFDS_Net, gnVersionFDS_1, Flags, "FIND_CONNECTED", "", "", "", "", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "", "", "", "AS_IS")
Ejemplo 2 de TraceGeometricNetwork (secuencia de comandos independiente)
La siguiente secuencia de comandos de Python independiente demuestra cómo utilizar la función TraceGeometricNetwork en una secuencia de comandos de Python para ejecutar un trazado Encontrar Ruta en una red geométrica con marcadores y sin barreras, no con un peso llamado Friction_Factor y el filtro de un peso de 1 a 10.
# Import arcpy module
import arcpy
# Local variables:
Water_Net = "C:/GeometricNetworks/Montgomery.gdb/Water/Water_Net"
Flags = "C:/GeometricNetworks/Montgomery.gdb/Water/Flags"
Water_Net_2 = "Water_Net"
# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(Water_Net, Water_Net_2, Flags, "FIND_PATH", "", "", "Friction_Factor", "Friction_Factor", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "Friction_Factor", "Friction_Factor", "1-10", "AS_IS")
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí