Rechercher les correspondances spatio-temporelles (Analyse criminelle et sécurité)

Synthèse

Identifie les correspondances entre deux classes d'entités selon la proximité, l’étendue temporelle, ou les deux.

Utilisation

  • Les classes d’entités en sortie incluront toutes les entités des classes d’entités en entrée qui répondent au critère. Une entité de l’une ou l’autre classe d'entités en entrée peut avoir plusieurs entités correspondantes. Lorsque c’est le cas, l’entité est copiée en sortie autant de fois que nécessaire pour préserver les correspondances uniques des entités

  • Des classes d’entités en sortie vides sont créées lorsque aucune correspondance n’est trouvée dans les entités en entrée.

  • Les entités et champs en entrée sont reportés dans les classes d'entités en sortie.

  • Lorsque Space and time (Espace et temps) ou Time only (Temps uniquement) est spécifié pour le paramètre Output Match Types (Types de correspondance en sortie), les classes d’entités en entrée doivent comporter un champ de date.

  • Les champs suivants seront ajoutés à la sortie.

    • MATCHID : la valeur d’identifiant qui définit la relation des classes d’entités en sortie. Ce champ peut être utilisé pour créer une relation un à un entre les classes d’entités en sortie.
    • MATCHTYPE : une valeur attribuée à chaque entité qui décrit le type de critère de correspondance entre les entités en entrée.
      • B : les deux entités en entrée se trouvent à proximité l’une de l’autre pendant le même intervalle temporel, par exemple, un appel ayant eu lieu sur le téléphone 2 dans un rayon de 1 000 pieds et un intervalle de 30 minutes d’un appel ayant eu lieu sur le téléphone 1. Ceci est un type de correspondance Space and time (Espace et temps).
      • S : les deux entités en entrée se trouvent à proximité l’une de l’autre, par exemple dans le cas d’un appel ayant eu lieu sur le téléphone 2 dans un rayon de 1 000 pieds du téléphone 1 mais pas dans l’intervalle temporel de 30 minutes. Ceci est un type de correspondance Space only (Espace uniquement).
      • T : les deux entités en entrée se trouvent dans le même intervalle temporel, par exemple, un appel ayant eu lieu sur le téléphone 2 dans les 30 minutes d’un appel ayant eu lieu sur le téléphone 1 mais pas dans la distance de 1 000 pieds. Ceci est un type de concordance Time only (Temps uniquement).

Paramètres

ÉtiquetteExplicationType de données
Entités principales en entrée

La classe d'entités principales en entrée.

Feature Layer
Entités de comparaison en entrée

La classe d'entités de comparaison en entrée.

Feature Layer
Entités principales correspondantes en sortie

La classe d'entités en sortie contenant des entités issues des entités principales en entrée dans laquelle les types de correspondance en sortie se sont produits.

Feature Class
Entités de comparaison appariées en sortie

La classe d’entités en sortie contenant des entités issues des entités de comparaison en entrée dans laquelle les types de correspondance en sortie se sont produits.

Feature Class
Types de correspondance en sortie

Spécifie les types de correspondance à comparer.

  • Espace et tempsLes correspondances basées à la fois sur l’intervalle de temps et la proximité définis dans le rayon de recherche spatio-temporel seront comparées, par exemple, 25 mètres et 10 minutes.
  • Espace uniquementLes correspondances basées uniquement sur la proximité définie dans le rayon de recherche spatiale seront comparées, par exemple, 25 mètres.
  • Temps seulementLes correspondances basées uniquement sur l’intervalle de temps défini dans l’intervalle de recherche temporelle seront comparées, par exemple, 10 minutes.
String
Rayon de recherche
(Facultatif)

Le rayon de recherche utilisé entre les classes d’entités en entrée.

Linear Unit
Intervalle de recherche variable
(Facultatif)

La période de recherche utilisée entre les classes d’entités en entrée.

Time Unit
Champ Date de début des entités principales
(Facultatif)

Le champ Date et heure de début principales des entités principales en entrée.

Field
Champ Date de début des entités de comparaison
(Facultatif)

Le champ Date et heure de début de comparaison des entités de comparaison en entrée.

Field
Champ Date de fin des entités principales
(Facultatif)

Le champ Date et heure de fin principales des entités principales en entrée. Lorsqu’ils sont spécifiés, la plage temporelle définie par les dates de début et de fin et l’intervalle de recherche temporelle seront utilisés pour rechercher les entités de comparaison. L’intervalle de recherche temporelle peut être défini sur 0 pour comparer uniquement l’heure définie par la plage temporelle de l’entité.

Field
Champ Date de fin des entités de comparaison
(Facultatif)

Le champ Date et heure de fin de comparaison des entités de comparaison en entrée. Lorsqu’ils sont spécifiés, la plage temporelle définie par les dates de début et de fin et l’intervalle de recherche temporelle seront utilisés pour évaluer les relations avec les entités principales. L’intervalle de recherche temporelle peut être défini sur 0 pour comparer uniquement l’heure définie par la plage temporelle de l’entité.

Field

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})
NomExplicationType de données
in_primary_features

La classe d'entités principales en entrée.

Feature Layer
in_comparison_features

La classe d'entités de comparaison en entrée.

Feature Layer
out_primary_feature_class

La classe d'entités en sortie contenant des entités issues des entités principales en entrée dans laquelle les types de correspondance en sortie se sont produits.

Feature Class
out_comparison_feature_class

La classe d’entités en sortie contenant des entités issues des entités de comparaison en entrée dans laquelle les types de correspondance en sortie se sont produits.

Feature Class
match_types
[match_types,...]

Spécifie les types de correspondance à comparer.

  • SPACE_AND_TIMELes correspondances basées à la fois sur l’intervalle de temps et la proximité définis dans le rayon de recherche spatio-temporel seront comparées, par exemple, 25 mètres et 10 minutes.
  • SPACE_ONLYLes correspondances basées uniquement sur la proximité définie dans le rayon de recherche spatiale seront comparées, par exemple, 25 mètres.
  • TIME_ONLYLes correspondances basées uniquement sur l’intervalle de temps défini dans l’intervalle de recherche temporelle seront comparées, par exemple, 10 minutes.
String
search_radius
(Facultatif)

Le rayon de recherche utilisé entre les classes d’entités en entrée.

Linear Unit
temporal_search_radius
(Facultatif)

La période de recherche utilisée entre les classes d’entités en entrée.

Time Unit
primary_start_date_field
(Facultatif)

Le champ Date et heure de début principales des entités principales en entrée.

Field
comparison_start_date_field
(Facultatif)

Le champ Date et heure de début de comparaison des entités de comparaison en entrée.

Field
primary_end_date_field
(Facultatif)

Le champ Date et heure de fin principales des entités principales en entrée. Lorsqu’ils sont spécifiés, la plage temporelle définie par les dates de début et de fin et l’intervalle de recherche temporelle seront utilisés pour rechercher les entités de comparaison. L’intervalle de recherche temporelle peut être défini sur 0 pour comparer uniquement l’heure définie par la plage temporelle de l’entité.

Field
comparison_end_date_field
(Facultatif)

Le champ Date et heure de fin de comparaison des entités de comparaison en entrée. Lorsqu’ils sont spécifiés, la plage temporelle définie par les dates de début et de fin et l’intervalle de recherche temporelle seront utilisés pour évaluer les relations avec les entités principales. L’intervalle de recherche temporelle peut être défini sur 0 pour comparer uniquement l’heure définie par la plage temporelle de l’entité.

Field

Exemple de code

Exemple 1 d'utilisation de la fonction FindSpaceTimeMatches (fenêtre Python)

Le script ci-dessous illustre l’utilisation de la fonction FindSpaceTimeMatches en mode immédiat.

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")
Exemple 2 d'utilisation de la fonction FindSpaceTimeMatches (script autonome)

Le script ci-dessous illustre l'utilisation de la fonction FindSpaceTimeMatches dans un script autonome.

# 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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes