| Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades con la función de tiempo habilitada representan el identificador conocido que se usará para buscar compañeros de viaje. Los identificadores únicos, marcas de tiempo y ubicaciones se transferirán a la capa de salida para ayudar con el cálculo de la separación temporal y espacial. | Feature Layer |
Clase de entidad de salida | La clase de entidad de salida que contendrá los segmentos de rastreo de puntos identificados como compañeros de viaje con las capas de origen de entrada. Esta clase de entidad incluirá el origen con el que se asocia el segmento de rastreo de puntos especificado. La separación espacial y temporal se calculará para cada entidad de rastreo de puntos. | Feature Class |
Campo de Id. | Un campo del parámetro Entidades de entrada que se usará para obtener los identificadores únicos por rastreo de puntos. El campo se copiará a la clase de entidad de salida. | Field |
Distancia de búsqueda (Opcional) | La distancia máxima que pueden estar separadas las entidades antes de considerarse como que no son entidades compañeras de viaje. El valor predeterminado es 100 pies. | Linear Unit |
Diferencia horaria (Opcional) | La diferencia horaria máxima que pueden estar separadas las entidades antes de considerarse como que no son entidades compañeras de viaje. El valor predeterminado es 10 segundos. | Time Unit |
Tipo de entrada (Opcional) | Especifica si las compañeras de viaje se identificarán en una clase de entidad o entre dos.
| String |
Entidades secundarias (Opcional) | Una segunda clase de entidad para identificar compañeras de viaje. Las posibles compañeras de viaje se evaluarán con lo siguiente:
| Feature Layer |
Campo de Id. secundario (Opcional) | Un campo del parámetro Entidades secundarias que se usará para obtener los identificadores únicos por rastreo de puntos. El campo se copiará a la clase de entidad de salida. | Field |
Crear tabla de resumen (Opcional) | Especifica si se creará una tabla de resumen de salida.
| Boolean |
Tabla de resumen de salida (Opcional) | La tabla de salida que almacenará la información de resumen. Esta opción solo está habilitada cuando el parámetro Crear tabla de resumen está activado. Los archivos de salida deben ser tablas de una geodatabase de archivos, archivos de texto o archivos de valores separados por comas (CSV). | Table |
Incluir el filtro de duración mínima de viaje conjunto (Opcional) | Especifica si se aplicará un filtro que solo devuelva las compañeras de viaje que cumplen un tiempo mínimo de viaje juntas.
| Boolean |
Duración mínima de viaje conjunto (Opcional) | La cantidad mínima de tiempo durante el cual deben moverse dos entidades por el espacio y el tiempo que permanecen juntas antes de que se les considere compañeras de viaje. | Time Unit |
Resumen
Extrae identificadores únicos que se mueven por el espacio y el tiempo a intervalos especificados en un dataset de rastreo de puntos.
Uso
La herramienta identifica identificadores únicos de las entidades de entrada que se mueven dentro de un tiempo y distancia especificados entre ellas. Las entidades de entrada deben tener el tiempo habilitado.
Más información sobre cómo configurar las propiedades de tiempo en datos
Al seleccionar un campo para utilizarlo como el identificador único, seleccione un campo de enteros o de texto. De esta forma, la agrupación de entidades será más eficiente y devolverá una salida óptima. De manera óptima, el dataset contendrá un Id. de rastreo existente. Un buen ejemplo de identificador de rastreo es Identidad de Servicio Móvil Marítimo (MMSI). El campo Name de archivos GPX, señal de llamada a aeronaves u otros valores únicos se pueden agrupar en rastreos. Los identificadores únicos no deben ser únicos para cada fila. Si lo son, los rastreos no se pueden formar y no se identificará a ninguna compañera de viaje, en casos poco frecuentes, se generará un número significativo de falsos positivos.
Los intervalos de menor separación espacial y temporal se procesan más rápido. Por ejemplo, una diferencia de tiempo de 10 minutos y una separación espacial de 100 metros se procesará mucho más rápido que una diferencia de tiempo de 1 hora y una separación espacial de 1 kilómetro.
Para optimizar los parámetros Distancia de búsqueda y Diferencia de tiempo para devolver la cantidad adecuada de entidades compañeras de viaje, tenga en cuenta lo siguiente:
- Unos valores mayores en Distancia de búsqueda y Diferencia de tiempo identificarán más compañeras de viaje potenciales. Puede ser ideal si el espaciado promedio entre objetos en movimiento debe ser mayor, por ejemplo, para barcos o camiones grandes.
- Los valores más elevados de Distancia de búsqueda y Diferencia de tiempo también son ideales para datos que tienen una tasa de muestreo medida en minutos. Se debe a la probabilidad de que los objetos se desplacen más durante esos intervalos incrementados.
- Los valores de Distancia de búsqueda y Diferencia de tiempo más bajos identificarán menos compañeras de viaje potenciales. Puede ser ideal si el espaciado entre objetos en movimiento es menor, por ejemplo, personas, bicicletas o coches.
- Los valores de Distancia de búsqueda y Diferencia de tiempo más bajos son ideales para datos que se muestrean con una tasa de segundos o subsegundos. Con tasas de muestreo más bajas, el objeto tiene menos oportunidad de desplazarse, lo que permite que las tolerancias sean más ajustadas a la hora de detectar compañeras de viaje.
para peatones deben ser menores, mientras que deben ser mayores para los objetos grandes. El parámetro Filtro de duración mínima de viaje conjunto permite la especificación de una cantidad mínima de tiempo que dos entidades deben viajar juntas antes de que se consideren compañeras de viaje. Por ejemplo, si se especifica una duración mínima de viaje conjunto de 15 minutos, el tiempo a partir de la detección de la primera instancia de un evento de viaje conjunto y la última instancia de un evento de viaje conjunto debe ser al menos 15 minutos antes de que la herramienta devuelva el rastreo como un compañero de viaje válido. Si hay un gran número de falsos positivos resultantes de entidades como puertos, aparcamientos o eventos de viajes conjuntos con un número muy pequeño de rastreos, se recomienda que aplique un valor de Filtro de duración mínima de viaje conjunto y vuelva a ejecutar la herramienta. El valor de Filtro de duración mínima de viaje conjunto ayudará a eliminar la mayoría de los segmentos de rastreo más pequeños.
Cuando los valores de Distancia de búsqueda y Diferencia de tiempo se establecen en valores mayores, la herramienta puede identificar las entidades que pueden pasar o intersecarse como posibles compañeras de viaje. Para evitarlo, establezca el parámetro Filtro de duración mínima de viaje conjunto en un valor mayor que la tasa de muestreo de los datos.
Los objetos que pueden pasarse o intersecarse no son compañeros de viaje. Las entidades de salida representan las ubicaciones de las entidades compañeras de viaje. Se agregarán dos campos a las entidades de salida que indican la separación temporal y espacial entre viajeros y posibles compañeros de viaje, además de otros campos descriptivos.
Las entidades de salida incluirán los siguientes campos:
- traveler_id: el identificador único de la entidad de viaje. Es el identificador con el que se movía la entidad compañera de viaje y se puede considerar la entidad de origen.
- cotraveler_id: el identificador único de la entidad compañera de viaje. Es el identificador que se movía junto con la entidad de viaje y se puede considerar la entidad de destino.
- X: la coordenada x de la entidad de viaje. La coordenada estará en las unidades de proyección del parámetro Entidades de entrada.
- Y: la coordenada y de la entidad de viaje. La coordenada estará en las unidades de proyección del parámetro Entidades de entrada.
- X_cotraveler: la coordenada x de la entidad compañera de viaje. La coordenada estará en las unidades de proyección del parámetro Entidades de entrada.
- Y_cotraveler: la coordenada y de la entidad compañera de viaje. La coordenada estará en las unidades de proyección del parámetro Entidades de entrada.
- traveler_time: la fecha y hora de la entidad de viaje.
- cotraveler_time: la fecha y hora de la entidad compañera de viaje.
- distance_difference: la distancia entre la entidad identificada en el parámetro Entidades de entrada y la compañera de viaje evaluada. La distancia estará en las unidades lineales del parámetro Entidades de entrada.
- time_difference: la separación temporal entre la entidad identificada en el parámetro Entidades de entrada y la compañera de viaje evaluada. La diferencia horaria estará en segundos y puede ser un número positivo o negativo. Los números positivos indican entidades que se identifican como que ocurren después de la de viaje. Los números negativos indican entidades que se identifican como que ocurren antes de la de viaje.
- cotraveling_pair_id: un identificador único generado para cada par único de entidades compañeras de viaje.
El identificador cotraveling_pair_id se genera para proporcionar una opción para filtrar e identificar todas las combinaciones posibles de compañeras de viaje. Dos entidades compañeras de viaje (A, B) compartirán el mismo identificador tanto para (A, B) como para (B, A).
Cuando un par de rastreos se identifica como viaje conjunto, todas las instancias de ese par tendrán el mismo identificador cotraveling_pair_id. Se puede crear una tabla de resumen opcional. La tabla de resumen incluirá los siguientes campos:
- unique_pair_id: un identificador único generado para cada par único de entidades compañeras de viaje. Dos entidades compañeras de viaje (A, B) compartirán el mismo identificador tanto para (A, B) como para (B, A).
- traveler_id: el identificador único de la entidad de viaje. Es el identificador con el que se movía la entidad compañera de viaje y se puede considerar la entidad de origen.
- cotraveler_id: el identificador único de la entidad compañera de viaje. Es el identificador que se movía junto con la entidad de viaje y se puede considerar la entidad de destino.
- time_diff_max: la máxima separación temporal entre la viajera y la compañera de viaje.
- time_diff_min: la mínima separación temporal entre la viajera y la compañera de viaje.
- time_diff_mean: el valor medio de separación temporal entre la viajera y la compañera de viaje.
- time_diff_std: la desviación estándar de la separación temporal entre la viajera y la compañera de viaje.
- dist_diff_max: la máxima distancia de separación entre la viajera y la compañera de viaje.
- dist_diff_min: la mínima distancia de separación entre la viajera y la compañera de viaje.
- dist_diff_mean: el valor medio de distancia de separación entre la viajera y la compañera de viaje.
- dist_diff_std: la desviación estándar de la distancia de separación entre la viajera y la compañera de viaje.
- unique_pair_id_count: el número total de entidades identificadas como compañeras de viaje para el campo unique_pair_id.
La salida de la herramienta Buscar compañeros de viaje se puede visualizar en un gráfico de vínculos.
Más información sobre los gráficos de vínculos
Los gráficos de vínculos permiten clasificar los datasets complejos en sus partes componentes para ayudar a visualizar y explorar las relaciones de los datos. Esto se realiza mediante la creación de tipos de entidad y tipos de relación. Los tipos de entidad representan objetos discretos, como personas, lugares, organizaciones e identificadores únicos. Los campos traveler_id y cotraveler_id son ejemplos de tipos de datos que se pueden convertir en un tipo de entidad. La otra parte de un gráfico de vínculos son los tipos de relación. Los tipos de relación conectan los tipos de entidad individuales entre sí en el gráfico de vínculos. La visualización de las salidas de Buscar compañeros viajeros aumenta la comprensión de qué entidades están conectadas y si hay clústeres relevantes que garantizan una exploración más detallada.
Una vez que se crea un gráfico de vínculos, se pueden crear tipos de entidad y relación para la salida de Buscar compañeros viajeros. Se recomienda que active el parámetro Crear tabla de resumen. Los resultados de Buscar compañeros viajeros pueden ser grandes y pueden afectar al rendimiento del gráfico de vínculos. Ya use los valores opcionales de Crear tabla de resumen o Clase de entidad de salida, se recomienda que agregue un tipo de entidad desde los campos traveler_id y cotraveler_id creando una entidad multicampo.
Para crear un tipo de relación utilizando el valor de Tabla de resumen de salida o Clase de entidad de salida, use el tipo de clave Entidades. Establezca el valor del campo de clave de entidad de origen en traveler_id y el valor del campo clave de la entidad de destino en cotraveler_id.
Parámetros
arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table}, {include_min_cotraveling_duration}, {min_cotraveling_duration})| Nombre | Explicación | Tipo de datos |
input_features | Las entidades con la función de tiempo habilitada representan el identificador conocido que se usará para buscar compañeros de viaje. Los identificadores únicos, marcas de tiempo y ubicaciones se transferirán a la capa de salida para ayudar con el cálculo de la separación temporal y espacial. | Feature Layer |
out_featureclass | La clase de entidad de salida que contendrá los segmentos de rastreo de puntos identificados como compañeros de viaje con las capas de origen de entrada. Esta clase de entidad incluirá el origen con el que se asocia el segmento de rastreo de puntos especificado. La separación espacial y temporal se calculará para cada entidad de rastreo de puntos. | Feature Class |
id_field | Un campo del parámetro input_features que se usará para obtener los identificadores únicos por rastreo de puntos. El campo se copiará a la clase de entidad de salida. | Field |
search_distance (Opcional) | La distancia máxima que pueden estar separadas las entidades antes de considerarse como que no son entidades compañeras de viaje. El valor predeterminado es 100 pies. | Linear Unit |
time_difference (Opcional) | La diferencia horaria máxima que pueden estar separadas las entidades antes de considerarse como que no son entidades compañeras de viaje. El valor predeterminado es 10 segundos. | Time Unit |
input_type (Opcional) | Especifica si las compañeras de viaje se identificarán en una clase de entidad o entre dos.
| String |
secondary_features (Opcional) | Una segunda clase de entidad para identificar compañeras de viaje. Las posibles compañeras de viaje se evaluarán con lo siguiente:
| Feature Layer |
secondary_id_field (Opcional) | Un campo del parámetro secondary_features que se usará para obtener los identificadores únicos por rastreo de puntos. El campo se copiará a la clase de entidad de salida. | Field |
create_summary_table (Opcional) | Especifica si se creará una tabla de resumen de salida.
| Boolean |
out_summary_table (Opcional) | La tabla de salida que almacenará la información de resumen. Este parámetro solo está habilitado cuando el valor del parámetro create_summary_table está establecido en CREATE_SUMMARY_TABLE. Los archivos de salida deben ser tablas de una geodatabase de archivos, archivos de texto o archivos de valores separados por comas (CSV). | Table |
include_min_cotraveling_duration (Opcional) | Especifica si se aplicará un filtro que solo devuelva las compañeras de viaje que cumplen un tiempo mínimo de viaje juntas.
Especifica si se aplicará el filtro de duración mínima de compañera de viaje.
| Boolean |
min_cotraveling_duration (Opcional) | La cantidad mínima de tiempo durante el cual deben moverse dos entidades por el espacio y el tiempo que permanecen juntas antes de que se les considere compañeras de viaje. | Time Unit |
Muestra de código
El siguiente script de Python muestra cómo utilizar la función FindCotravelers en un script independiente sin la tabla de resumen de salida y con una clase de entidad de entrada.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field)El siguiente script de Python muestra cómo utilizar la función FindCotravelers en un script independiente con la tabla de resumen de salida y dos clases de entidad de entrada.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
filter_duration = "MIN_COTRAVELING_DURATION"
cotraveling_duration = "30 Minutes"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field_name,
search_distance,
time_difference,
"TWO_FEATURECLASSES",
unknown_features,
unknown_id_field,
summary_table,
summary_table_name,
filter_duration,
cotraveling_duration)Entornos
Casos especiales
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí