Detectar incidentes (Herramientas de GeoAnalytics Server)

Resumen

Crea una capa que detecta entidades que cumplen una condición determinada.

Heredado:

La extensión ArcGIS GeoAnalytics Server va a quedar obsoleta en ArcGIS Enterprise. La última versión de GeoAnalytics Server se incluyó con ArcGIS Enterprise 11.3. Esta herramienta de geoprocesamiento está disponible a través de ArcGIS Enterprise 11.3 y versiones anteriores.

Ilustración

Flujo de trabajo de Detectar incidentes

Uso

• Esta herramienta de geoprocesamiento está disponible con ArcGIS Enterprise 10.6 o posterior.

• La siguiente tabla describe la terminología para la herramienta Detectar incidentes:

  Plazo	Descripción
  Recorrido	Una secuencia de entidades que tenga la función de tiempo habilitada con el tipo de tiempo de instante. Las entidades están definidas para estar en la secuencia por un campo de identificación de recorrido y están ordenadas por el tiempo. Por ejemplo, una ciudad podría tener una flota de camiones quitanieves que registren su ubicación cada 10 minutos. El Id. del vehículo podría representar los diferentes recorridos.
  Incidente	Entidades que cumplen una condición de interés.
  Instante	Un único momento en el tiempo representado por una hora de inicio y sin hora de finalización. Las entradas de Detectar incidentes deben tener un instante de tipo temporal.
  Intervalo	Una duración de tiempo representada por una hora de inicio y una hora de finalización.
  Entidad de interés	Describe la entidad que se está analizando. Durante el análisis, se analizan todas las entidades.

• Los incidentes son entidades que cumplen una condición específica.

• Detectar incidentes generará una nueva salida. No modificará la entrada.

• Detectar incidentes se completa en tablas o entidades de puntos, líneas o áreas. La capa de entrada debe tener el tiempo habilitado con entidades que representen un instante en el tiempo.

• Solo se utilizarán entidades de entrada que presenten una entrada de tiempo. Cualquier entidad que no tenga entrada de tiempo será excluida.

• Los recorridos se representan mediante la combinación única de campos de recorridos. Por ejemplo, si los campos flightID y Destination se utilizan como identificadores de pista, los elementos [ID007, Solden] y [ID007, Tokyo] se encontrarían en dos pistas distintas, ya que tienen valores diferentes en el campo Destination.

• Las condiciones se crean usando expresiones Arcade. Se requiere una condición de inicio y una condición de fin es opcional. Si solo aplica una condición inicial, el incidente comienza cuando la condición inicial se evalúa como verdadera y finaliza cuando la condición inicial se evalúa como falsa. Por ejemplo, si los valores de un recorrido son [0, 10, 15, 20, 40, 10, 12, -2, -12] y la condición inicial es $feature["values"] > 15, las entidades que son incidentes son aquellas con [True] y serían [0: False, 10: False, 15: False, 20: True, 40: True, 10: False, 12: False, -2: False, -12: False]; solo los valores por encima de 15 son incidentes. Si aplica una condición final de $feature["values"] < 0, el resultado sería [0: False, 10: False, 15: False, 20: True, 40: True, 10: True, 12: True, -2: False, -12: False]. En este ejemplo, el incidente comienza cuando se cumple la condición inicial y cada entidad secuencial es un incidente hasta que la condición final sea verdadera. Estos parámetros se describen en la siguiente tabla:

  Posición	1	2	3	4	5	6	7	8	9
  Valor	0	10	15	20	40	10	12	-2	-12
  Inicial: $feature["values"] > 15 y sin Final	False	False	False	True	True	False	False	False	False
  Inicial: $feature["values"] > 15 y Final: $feature["values"] < 0	False	False	False	True	True	True	True	False	False

  Aplicar segmentos de intervalos de tiempo realiza un seguimiento en un intervalo definido. Por ejemplo, si establece el límite de intervalo de tiempo en 1 día, a partir de las 9:00 AM del 1 de enero de 1990, cada recorrido se truncará a las 9:00 AM cada día. Esta división acelera el tiempo de cálculo, ya que crea recorridos más pequeños para el análisis. Si a su análisis le conviene dividir por un límite de intervalo de tiempo recurrente, le recomendamos que lo haga para procesar big data.

• Las condiciones se crean mediante expresiones de Arcade y pueden tener en cuenta los recorridos.

  Más información sobre las expresiones de GeoAnalytics Server Arcade con Detectar incidentes

• Un recorrido puede tener múltiples incidentes.

• Las entidades de salida recuperarán los campos en la entrada, así como los siguientes campos adicionales:

  • IncidentID—Un Id. único dado a toda entidad que sea un incidente.

  • IncidentStatus—Un campo de cadena de caracteres que representa el estatus de un incidente. El valor será null si la entidad no es un incidente, Started si la entidad es el primer incidente que cumple la condición de inicio, OnGoing si la entidad es todavía un incidente y Ended cuando una entidad ya no sea un incidente. Una sola vía puede tener varios segmentos de incidentes. Por ejemplo, un recorrido con valores [0, 10, 15, 20, 40, 10, 12, -2, -12] y una condición inicial de $feature["values"] > 15 resultará en valores IncidentStatus de [0: null, 10: null, 15: null, 20: Started, 40: OnGoing, 10: Ended, 12: null, -2: null, -12: null].

  • IncidentDuration—El tiempo, en milisegundos, en el que ocurre un incidente. Se calcula como la diferencia entre la entidad de interés y la entidad que comenzó el incidente.

  • Instant_Datetime—La hora a la que ocurre una entidad.

• Las entidades se ordenan secuencialmente en el tiempo por recorrido. Comenzando desde la primera entidad, la condición inicial se evalúa hasta que sea verdadera. Una vez que una entidad cumple la condición inicial, las siguientes entidades se evalúan hasta que la condición de inicio sea falsa (si no se especifica ninguna condición final) o hasta que la condición final sea verdadera (si una condición final está especificada). Una vez que se cumple esa condición, el incidente termina y el proceso comienza de nuevo. Puede haber varios segmentos de incidentes en un recorrido individual. Por ejemplo, para un recorrido con los valores de [10, 20, 30, 40, 50, 10, 20, 30, 40, 50, 10, 20] y una condición inicial de $feature["values"] > 20, habría dos segmentos de incidentes [10: null, 20: null, 30: Started, 40: OnGoing, 50: OnGoing, 10: Ended, 20: null, 30: Started, 40: OnGoing, 50: OnGoing, 10: Ended, 20: null].

• La duración de un incidente se calcula en milésimas de segundo como la hora de la entidad menos el comienzo de un incidente. La duración solo se calcula si la entidad tiene un estatus de Started, OnGoing o Ended. La duración de una entidad con el estatus de Started es siempre 0.

• Es posible mejorar el rendimiento de la herramienta Detectar incidentes realizando una o varias de las siguientes acciones:

  • Defina el entorno de extensión para analizar únicamente datos de interés.

  • Muestre únicamente las entidades del incidente.

  • Dividida sus recorridos con el parámetro División de límite de tiempo.

  • Utilice datos locales en los que se ejecute el análisis.

• Esta herramienta de geoprocesamiento está impulsada por ArcGIS GeoAnalytics Server. El análisis se realiza en GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

• Al ejecutar las herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no se encuentren en GeoAnalytics Server de forma local se transferirán a GeoAnalytics Server antes de que empiece el análisis. Esto significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

  Más información acerca del uso compartido de datos en el portal

  Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

Parámetros

• Dialog
• Python

Etiqueta	Explicación	Tipo de datos
Capa de entrada	Las entidades de entrada que contienen incidentes potenciales.	Record Set
Nombre de salida	El nombre del servicio de entidades de salida.	String
Campos de pistas	Uno o varios campos que se utilizarán para identificar recorridos únicos.	Field
Condición inicial	La condición que se utilizará para identificar incidentes. Las expresiones están escritas en Arcade y pueden incluir los operadores [+ - * / ] y varios campos. Si se agrega la capa al mapa, es posible usar los filtros Campos y Auxiliares para construir una expresión.	Calculator Expression
Condición final (Opcional)	La condición que se utilizará para poner fin a los incidentes. Si no se especifica ninguna condición final, los incidentes terminarán cuando la condición inicial deje de ser verdadera. Las expresiones están escritas en Arcade y pueden incluir operadores y varios campos. Si se agrega la capa al mapa, es posible usar los filtros Campos y Auxiliares para construir una expresión.	Calculator Expression
Modo de salida (Opcional)	Especifica las entidades que se van a devolver. Todas las entidades—Se devolverán todas las entidades de entrada. Esta es la opción predeterminada. Incidentes—Solo se devolverán las entidades que se hayan identificado como incidentes.	String
Data Store (Opcional)	Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas. Big data store espaciotemporal—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada. Data store relacional—La salida se almacenará en un data store relacional.	String
División de límite de tiempo (Opcional)	Un intervalo de tiempo en el que dividir los datos de entrada para el análisis. Un límite de tiempo permite analizar los valores dentro de un intervalo de tiempo definido. Por ejemplo, si utiliza un límite de tiempo de 1 día, desde el 1 de enero de 1980, los recorridos se dividirán al comienzo de cada día. Este parámetro solo está disponible en ArcGIS Enterprise 10.7 y versiones posteriores.	Time Unit
Referencia de límite de tiempo (Opcional)	El tiempo de referencia utilizado para dividir los datos de entrada para el análisis. Se crearán límites de tiempo para todo el intervalo de los datos y no es necesario que el tiempo de referencia se encuentre en el comienzo. Si no se especifica ningún tiempo de referencia, se utilizará el 1 de enero de 1970. Este parámetro solo está disponible en ArcGIS Enterprise 10.7 y versiones posteriores.	Date

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de salida	Las entidades de salida que cumplen una condición determinada.	Record Set

Entornos

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual

Casos especiales

Sistema de coordenadas de salida

The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

Información de licenciamiento

• Basic: Requiere ArcGIS GeoAnalytics Server
  Disponible con ArcGIS Enterprise 10.6
• Standard: Requiere ArcGIS GeoAnalytics Server
  Disponible con ArcGIS Enterprise 10.6
• Avanzado: Requiere ArcGIS GeoAnalytics Server
  Disponible con ArcGIS Enterprise 10.6

Temas relacionados

• Vista general del conjunto de herramientas Buscar ubicaciones
• Buscar una herramienta de geoprocesamiento
• Expresiones de Detectar expresiones