Buscar compañeros de viaje (Inteligencia)

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

  • ONE_FEATURECLASS Se detectarán compañeras de viaje en una clase de entidad. Esta es la opción predeterminada.
  • TWO_FEATURECLASSESSe detectarán las compañeras de viaje entre dos clases de entidad.
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:

  • Las compañeras de viaje se desplazan dentro de las entidades de entrada.
  • Las compañeras de viaje se desplazan dentro de las entidades secundarias.
  • Las compañeras de viaje se desplazan entre las entidades de entrada y las entidades secundarias.

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.

  • NO_SUMMARY_TABLENo se creará la tabla de resumen. Esta es la opción predeterminada.
  • CREATE_SUMMARY_TABLESe creará la tabla de resumen.
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

Ejemplo de FindCotravelers (script independiente)

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)
Ejemplo de FindCotravelers (script independiente)

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)

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Sí

Temas relacionados