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ámetro | Explicación | Tipo 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.
| 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
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")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)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí