Red Geométrica de Trazado (Administración de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

Resuelve el problema de análisis de red especificada basada en las banderas, barreras, y las propiedades de peso especificado.

Uso

Sintaxis

TraceGeometricNetwork_management (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ámetroExplicaciónTipo 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.

  • FIND_COMMON_ANCESTORS Encontrar las entidades comunes que están aguas arriba de un conjunto de puntos en la red. Requiere que la dirección del flujo se establezca en la red geométrica.
  • FIND_CONNECTEDEncontrar las entidades que están conectadas a un punto determinado a través de la red.
  • FIND_LOOPS Buscar bucles en la red que se definen al determinar cada entidad conectada en la que colocó un marcador, las entidades que formen bucles sobre sí mismas (es decir, que no se puedan alcanzar más que desde una dirección).
  • FIND_DISCONNECTED Buscar todas las entidades que no están conectadas a un punto determinado a través de la red.
  • FIND_PATH_UPSTREAM Buscar una ruta de aguas arriba desde un punto en la red. La ruta encontrada puede ser solo una de varias rutas dependiendo de si la red contiene bucles. Los marcadores que se colocan en la red pueden ser una mezcla de marcadores de eje o de cruce. Requiere un peso para ser definido para el trazado y la dirección del flujo se establece en la red geométrica. Cuando no se especifica un peso, la ruta más corta se determina por la menor cantidad de entidades entre los dos puntos.
  • FIND_PATH Encontrar una ruta entre dos o más marcadores en la red. La ruta encontrada puede ser solo una de varias rutas entre las banderas, dependiendo de si la red contiene bucles. Los marcadores que se colocan en la red deben ser todos marcadores de eje o cruce. Cuando no se especifica un peso, la ruta más corta se determina por la menor cantidad de entidades entre los dos puntos.
  • TRACE_DOWNSTREAMBuscar todas las entidades de red que quedan aguas abajo (con la dirección del flujo) de un punto determinado de la red. Requiere que la dirección del flujo se establezca en la red geométrica.
  • FIND_UPSTREAM_ACCUMULATION Determinar el coste total de todas las entidades de red que quedan aguas arriba de un punto determinado de la red. Requiere definir un peso para el trazado y establecer la dirección del flujo en la red geométrica.
  • TRACE_UPSTREAM Buscar todas las entidades que se encuentran aguas arriba (en contra de la dirección de flujo) de un punto determinado de la red. Requiere que la dirección del flujo se establezca en la red geométrica.
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:

  • FIND_COMMON_ANCESTORS
  • FIND_CONNECTED
  • FIND_LOOPS
  • FIND_DISCONNECTED
  • TRACE_DOWNSTREAM
  • TRACE_UPSTREAM
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:

  • FIND_COMMON_ANCESTORS
  • FIND_CONNECTED
  • FIND_LOOPS
  • FIND_DISCONNECTED
  • TRACE_DOWNSTREAM
  • TRACE_UPSTREAM
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:

  • FIND_COMMON_ANCESTORS
  • FIND_CONNECTED
  • FIND_LOOPS
  • FIND_DISCONNECTED
  • TRACE_DOWNSTREAM
  • TRACE_UPSTREAM
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:

  • La entidad se conecta a solo otra entidad de red geométrica (callejones sin salida).
  • Se desactiva la entidad (incluidas las entidades de las clases de entidades desactivadas).
  • La entidad tiene una barrera en ella.
  • TRACE_ENDSIncluyen aquellas entidades que detienen el trazado.
  • NO_TRACE_ENDSIncluir todas las entidades. Esta es la opción predeterminada.
Boolean
in_trace_indeterminate_flow
(Opcional)

Indica si el trazado debería incluir todas las entidades o solo aquellas que detienen el trazado.

  • TRACE_INDETERMINATE_FLOWLas entidades de trazado tienen una dirección de flujo indeterminada o no iniciada.
  • NO_TRACE_INDETERMINATE_FLOWNo trazan entidades que tienen una dirección de flujo indeterminada o no iniciada. Esta es la opción predeterminada.

Solo se respetan cuando se establece uno de los tipos de tareas de trazado de flujo dependiente:

  • FIND_PATH_UPSTREAM
  • TRACE_DOWNSTREAM
  • FIND_UPSTREAM_ACCUMULATION
  • TRACE_UPSTREAM
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.

  • AS_ISLos rangos de peso especifican las entidades que pueden trazarse. Esta es la opción predeterminada.
  • NOTLos rangos de peso especifican las entidades que no pueden trazarse.
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.

  • AS_ISLos rangos de peso especifican las entidades que pueden trazarse. Esta es la opción predeterminada.
  • NOTLos rangos de peso especifican las entidades que no pueden trazarse.
Boolean

Ejemplo 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.gp.TraceGeometricNetwork(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.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")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014