Encontrar coincidencias espacio-tiempo (Análisis de criminalidad y seguridad)

Resumen

Identifica coincidencias entre dos clases de entidad según la proximidad, la extensión de tiempo o ambas.

Uso

  • Las clases de entidad de salida contendrán todas las entidades de las clases de entidad de entrada que cumplan los criterios de coincidencia. Una sola entidad de cualquier clase de entidad de entrada puede coincidir con más de una entidad diferente. En este caso, la entidad se copia a la salida tantas veces como sea necesario para conservar las coincidencias de entidad únicas.

  • Se crearán clases de entidad de salida vacías cuando no se encuentre ninguna coincidencia en las entidades de entrada.

  • Los campos y entidades de entrada se transfieren a las clases de entidad de salida.

  • Si se especifica Espacio y tiempo o Solo tiempo para el parámetro Tipos de coincidencia de salida, las clases de entidad de entrada deben contener un campo de fecha.

  • Los campos siguientes se agregarán a la salida:

    • MATCHID: el valor de identificador que define la relación de las clases de entidad de salida. Este campo se puede utilizar para crear una relación de uno a uno entre las clases de entidad de salida.
    • MATCHTYPE: un valor asignado a cada entidad que describe el tipo de criterio de coincidencia entre las entidades de entrada.
      • B: ambas entidades de entrada se encuentran cerca entre sí durante el mismo periodo de tiempo, por ejemplo, una llamada que ocurrió en el Teléfono 2 a 305 metros y 30 minutos de una llamada que ocurrió en el Teléfono 1. Este es un tipo de coincidencia de Espacio y tiempo.
      • S: ambas entidades de entrada se encuentran cerca entre sí, por ejemplo, una llamada que ocurrió en el Teléfono 2 a 305 metros del Teléfono 1, pero no dentro de la extensión de tiempo de 30 minutos. Este es un tipo de coincidencia de Solo espacio.
      • T: ambas entidades de entrada se encuentran dentro del mismo periodo de tiempo, por ejemplo, una llamada que ocurrió en el Teléfono 2 a 30 minutos de una llamada que ocurrió en el Teléfono 1, pero no a 305 metros. Este es un tipo de coincidencia de Solo tiempo.

Sintaxis

FindSpaceTimeMatches(in_primary_features, in_comparison_features, out_primary_feature_class, out_comparison_feature_class, match_types, {search_radius}, {temporal_search_radius}, {primary_start_date_field}, {comparison_start_date_field}, {primary_end_date_field}, {comparison_end_date_field})
ParámetroExplicaciónTipo de datos
in_primary_features

La clase de entidad de entrada principal.

Feature Layer
in_comparison_features

La clase de entidad de entrada de comparación.

Feature Layer
out_primary_feature_class

La clase de entidad de salida que contiene entidades de las entidades principales de entrada en las que se dieron tipos coincidentes de salida.

Feature Class
out_comparison_feature_class

La clase de entidad de salida que contiene entidades de las entidades de comparación de entrada en las que se dieron tipos coincidentes de salida.

Feature Class
match_types
[match_types,...]

Especifica los tipos de coincidencias que se van a comparar.

  • SPACE_AND_TIMESe compararán las coincidencias basadas en la extensión de tiempo y la proximidad definidas en el radio de búsqueda espacial y temporal, por ejemplo, 25 metros y 10 minutos.
  • SPACE_ONLYSe compararán solo las coincidencias basadas en la proximidad definida en el radio de búsqueda espacial, por ejemplo, 25 metros.
  • TIME_ONLYSe compararán solo las coincidencias basadas en la extensión de tiempo definida en el radio de búsqueda temporal, por ejemplo, 10 minutos.
String
search_radius
(Opcional)

El radio que se utiliza para buscar entre clases de entidad de entrada.

Linear Unit
temporal_search_radius
(Opcional)

La extensión de tiempo utilizada para buscar entre clases de entidad de entrada.

Time Unit
primary_start_date_field
(Opcional)

El campo de hora y fecha de inicio principal de las entidades principales de entrada.

Field
comparison_start_date_field
(Opcional)

El campo de hora y fecha de inicio de comparación de las entidades de comparación de entrada.

Field
primary_end_date_field
(Opcional)

El campo de hora y fecha de finalización principal de las entidades principales de entrada. Si se especifica, el rango de tiempo definido por la fecha de inicio y finalización y el radio de búsqueda temporal se utilizarán para buscar entidades de comparación. El radio de búsqueda temporal se puede establecer en 0 para comparar solo el tiempo definido por el rango de tiempo de la entidad.

Field
comparison_end_date_field
(Opcional)

El campo de hora y fecha de finalización de comparación de las entidades de comparación de entrada. Si se especifica, el rango de tiempo definido por la fecha de inicio y finalización y el radio de búsqueda temporal se utilizarán para evaluar las relaciones con las entidades principales. El radio de búsqueda temporal se puede establecer en 0 para comparar solo el tiempo definido por el rango de tiempo de la entidad.

Field

Muestra de código

Ejemplo 1 de FindSpaceTimeMatches (ventana de Python)

El siguiente script muestra cómo utilizar la función FindSpaceTimeMatches en el modo inmediato.

import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.FindSpaceTimeMatches("CDR_Phone_1_Sites",
                            "CDR_Phone_2_Sites",
                            "CDR_Phone_1_Sites_Matches",
                            "CDR_Phone_2_Sites_Matches",
                            "SPACE_AND_TIME",
                            "1000 Meters",
                            "30 Minutes",
                            "starttime",
                            "starttime",
                            "endtime",
                            "endtime")
Ejemplo 2 de FindSpaceTimeMatches (script independiente)

El siguiente script muestra cómo utilizar la función FindSpaceTimeMatches en un script independiente.

# Description: Use the FindSpaceTimeMatches function to create two feature 
#              classes with matches based on proximity, time extent, or both 
#              proximity and time extent.
# Import required modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Set local variables
in_primary_features = "CDR_Phone_1_Sites"
in_comparison_features = "CDR_Phone_2_Sites"
out_primary_feature_class = "CDR_Phone_1_Sites_Matches"
out_comparison_feature_class = "CDR_Phone_2_Sites_Matches"
match_types = ["SPACE_AND_TIME","SPACE_ONLY","TIME_ONLY"]
search_radius = "1000 Meters"
temporal_search_radius = "30 Minutes"
primary_start_date_field = "starttime"
comparison_start_date_field = "starttime"
primary_end_date_field = "endtime"
comparison_end_date_field = "endtime"
# Execute the FindSpaceTimeMatches tool
arcpy.ca.FindSpaceTimeMatches(in_primary_features,
                              in_comparison_features,
                              out_primary_feature_class,
                              out_comparison_feature_class,
                              match_types,
                              search_radius,
                              temporal_search_radius,
                              primary_start_date_field ,
                              comparison_start_date_field,
                              primary_end_date_field,
                              comparison_end_date_field)

Información de licenciamiento

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

Temas relacionados