Resumen
Extrae identificadores únicos que se mueven por el espacio y el tiempo a intervalos definidos por el usuario en un dataset de rastreo de puntos.
Uso
La herramienta identifica identificadores únicos de las entidades de entrada que se mueven en un intervalo especificado de tiempo y distancia entre entidades. Las entidades de entrada deben tener el tiempo habilitado.
Para aprender a habilitar el tiempo en un dataset, consulte Establecer las propiedades de tiempo en los datos.
Al seleccionar un campo para utilizarlo como el identificador único, seleccione un campo que contenga números enteros o texto. De esta forma, la agrupación de entidades será más eficiente y devolverá una salida óptima.
Los intervalos de menor separación espacial y temporal se procesan más rápido. Por ejemplo, una diferencia horaria de 10 minutos y una separación espacial de 100 metros se procesará mucho más rápido que una diferencia horaria de 1 hora y una separación espacial de 1 kilómetro.
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 de las Entidades de entrada.
- Y: la coordenada y de la entidad de viaje. La coordenada estará en las unidades de proyección de las Entidades de entrada.
- X_cotraveler: la coordenada x de la entidad compañera de viaje. La coordenada estará en las unidades de proyección de las Entidades de entrada.
- Y_cotraveler: la coordenada y de la entidad compañera de viaje. La coordenada estará en las unidades de proyección de las 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 las Entidades de entrada y la compañera de viaje evaluada. La distancia estará en las unidades lineales de las Entidades de entrada.
- time_difference: la separación temporal entre la entidad identificada en las 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. Dos entidades compañeras de viaje (A, B) compartirán la misma cotraveling_pair_id tanto para (A, B) como para (B, A).
Existe una tabla de resumen opcional que se puede crear a partir de las entidades de salida. 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 la misma unique_pair_id 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 unique_pair_id.
Sintaxis
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})| Parámetro | 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. Se calcularán las separaciones espacial y temporal para cada entidad de rastreo de puntos. | Feature Class |
id_field | Un campo de las 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 |
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 de las 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 |
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. Esta opción solo está habilitada cuando el valor del parámetro Crear tabla de resumen está establecido en True. | Table |
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"
# 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)Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí