Red Geométrica de Trazado (Administración de datos)
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
| 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 |
Una clase de entidad de puntos que representa un conjunto de marcadores que sirven como puntos de inicio para 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) |
Una clase de entidad de puntos que representa un conjunto de barreras para definir lugares en la red más allá de los cuales los trazados no pueden continuar. Si solo está interesado en el trazado de una parte determinada de la red, puede utilizar 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 tratará discapacitados y no se considerará durante el trazado, a menos que haya establecido los resultados del Límite a entidades que detienen el parámetro del trazado al parámetro TRACE_ENDS para encontrar con determinación entidades que detengan 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, al deshabilitar la capa de interruptores en una red de distribución eléctrica, establecer los resultados de límite para las entidades que detienen el parámetro de trazado en TRACE_ENDS y hacer el trazado desde un punto determinado en la red, puede encontrar los interruptores que se deben retirar para aislar este punto de la red; estas serán las entidades donde 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) |
El peso que se utiliza para crear el filtro de peso de cruce que se utiliza para filtrar entidades de cruce 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. 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 se componen de un solo valor no contienen un guión y están delimitados por 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 marcar 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 se componen de un solo valor no contienen un guión y están delimitados por 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 peso de eje especificados. Por defecto, los rangos de peso de eje que introduce especifican las entidades de eje que se pueden trazar. Al marcar esta opción, indica que las entidades de eje con pesos en los rangos que introdujo no se pueden trazar.
| Boolean |
Ejemplo de código
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.gp.TraceGeometricNetwork(gnVersionFDS_Net, gnVersionFDS_1, Flags, "FIND_CONNECTED", "", "", "", "", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "", "", "", "AS_IS")
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.gp.TraceGeometricNetwork(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")