Registres de téléphone portable vers classe d’entités (Analyse criminelle et sécurité)

Synthèse

Importe les registres de téléphone portable des fournisseurs de réseau et associe ces registres à un site cellulaire et aux classes d’entités sectorielles tels que générés par l’outil Registres de site cellulaire vers classe d’entités sur la base des champs d’identifiants.

Utilisation

  • Les valeurs du paramètre Points du site cellulaire en entrée doivent être générées à l’aide de l’outil Registres de site cellulaire vers classe d’entités.

  • Les paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) incluront uniquement les registres téléphoniques qui ont bien été liés au site cellulaire et secteurs en entrée sur la base des champs d’ID appariés. Les valeurs des paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) ne représentent pas l’emplacement réel du téléphone portable.

  • Les registres téléphoniques ou registres détaillés des appels sont transmis par les fournisseurs de réseau sans fil dans différents formats et styles. Il n’est pas rare de recevoir des données dans un format ou une structure non tabulaire. La valeur du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée) doit être une table dans laquelle les noms des colonnes apparaissent en haut.

  • La table transmise par le fournisseur de réseau sans fil peut contenir des registres détaillés des appels et des informations de site cellulaire dans une même ligne. Les tables structurées de cette façon doivent être séparées en deux tables. Utilisez la table contenant les informations relatives aux appels (identifiants, numéros de téléphone, dates, heure, durée d’appel et coordonnées) comme entrée pour cet outil.

  • Une entité est créée dans les classes d'entités en sortie pour chaque registre (appel ou événement de données) du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée)

  • Les champs suivants sont ajoutés aux classes d'entités en sortie :

    • SUBSCRIBERle numéro de téléphone de l’abonné du paramètre Table des registres téléphoniques en entrée. Tous les caractères non numériques sont supprimés de la sortie.
    • UNIQUEIDL’identifiant unique des antennes secteur cellulaires.

    Les champs suivants sont ajoutés à la sortie lorsque le paramètre spécifié est utilisé :

    • DESTPHONEle numéro de téléphone appelé du paramètre Table des registres téléphoniques en entrée. Ceci est ajouté à la sortie lorsque le paramètre Destination Phone Number Field (Champ du numéro de téléphone de destination) est utilisé. Tous les caractères non numériques sont supprimés de la sortie.
    • STARTTIMELe champ Date et heure de début du paramètre Table des registres téléphoniques en entrée. Ceci est ajouté à la sortie lorsque le paramètre Start Date and Time Field (Champ Date et heure de début) est utilisé.
    • DURATIONLa durée en secondes de l’appel téléphonique, du paramètre Table des registres téléphoniques en entrée. Les valeurs de durée au format HH:MM:SS seront converties en secondes totales. Ceci est ajouté à la sortie lorsque le paramètre Duration Field (Champ Durée) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et End Date and Time Field (Champ Date et heure de fin) sont utilisés tous les deux.
    • ENDTIMELe champ Date et heure de fin du paramètre Table des registres téléphoniques en entrée. Ceci est ajouté à la sortie lorsque le paramètre End Date and Time Field (Champ Date et heure de fin) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et Duration (Durée) sont utilisés tous les deux.

  • La table fournie par le fournisseur de réseau sans fil peut inclure une table des informations de site cellulaire avec un champ d’ID unique pour définir tous les enregistrements uniques ou une combinaison de champs d’identifiants pour définir des enregistrements uniques dans la table. Par exemple, une table peut contenir des champs d’identifiant de site et d’identifiant de secteur pour définir de manière unique certains enregistrements, mais d’autres enregistrements de la table sont définis de manière unique avec des champs d’identifiant LAC (Location Area Code) et d’identifiant cellulaire.

    • Lorsqu’un champ d’ID unique est fourni pour la table en entrée, définissez l’option ID Type (Type d’ID) sur Unique ID (ID unique) dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaire). Dans le même paramètre, renseignez l’option Field (Champ) avec le champ qui représente cet ID unique.
    • Lorsque de nombreux champs d’ID sont fournis pour la table afin d’indiquer l’unicité, tous les champs d’ID doivent être ajoutés à la sortie. Pour chaque champ d’ID choisissez la valeur de ID Type (Type d’ID) qui définit le type d’ID dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaire). Dans le même paramètre, renseignez l’option Field (Champ) avec le champ associé qui contient les informations de cet ID. L’outil combine des champs d’ID et renseigne un champ d’ID unique dans les classes d’entités en sortie nommé UNIQUEID.

    Les champs suivants seront ajoutés à la sortie s’ils sont spécifiés dans le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) :

    • SITEID : identifiant unique d’un site cellulaire
    • SECTORID : identifiant unique d’un secteur cellulaire
    • SWITCHID : identifiant unique d’un commutateur réseau sans fil
    • LACID : identifiant unique d’un code LAC (Location Area Code)
    • CASCADEID : identifiant unique du secteur dans la cascade de réseau sans fil
    • CELLID : identifiant unique du secteur dans un code LAC (Location Area Code)

    Lorsque la table de registres téléphoniques en entrée contient des registres d’appel qui couvrent plusieurs secteurs cellulaires, les paramètres Cell Sector ID Fields (Champs ID de secteur cellulaire) et Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doivent être renseignés. Le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit contenir les identifiants associés au secteur de départ, et le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doit contenir le secteur de fin ou tout autre secteur que le secteur de départ du registre d’appel.

    Lorsque la table des registres téléphoniques en entrée contient des registres d'événements de données ou que le registre d'appel ne recense qu’un seul secteur, seul le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit être renseigné.

  • Le champ et les valeurs suivants sont générés lorsque le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) est utilisé:

    • IDTYPEle champ indiquant si un registre d’appel correspond au secteur primaire ou à un secteur supplémentaire d’un registre d’appel.
      • PRIMAIRE : la valeur attribuée lorsqu'un registre de téléphone portable est associé à un secteur au début d'un appel.
      • SUPPLÉMENTAIRE : la valeur attribuée lorsqu'un registre de téléphone portable est associé à un secteur à la fin d’un appel ou à tout autre secteur que le secteur de départ au cours d’un appel.
    • LOCTIMELe champ contenant une valeur de date et d’heure unique de l’enregistrement d’appel selon que le champ IDTYPE comporte la valeur PRIMARY ou ADDITIONAL. La valeur du champ STARTTIME est attribuée au champ LOCTIME lorsque la valeur du champ IDTYPE est PRIMARY. La valeur du champ ENDTIME est attribuée au champ LOCTIME lorsque la valeur du champ IDTYPE est ADDITIONAL. Le champ LOCTIME permet de visualiser les entités selon une valeur de date et d’heure unique et l’emplacement estimé des appels.

    Si l’outil détermine que le secteur associé à un registre de téléphone portable est le même au début et à la fin de l’appel, aucune entité distincte n’est créée pour le secteur cellulaire représentant la fin de l’appel.

  • Les points d’appels en sortie estimés incluront tous les champs associés des paramètres Output Phone Records Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Records Site Sectors (Secteurs des sites de registres téléphoniques en sortie).

    Les champs suivants sont également ajoutés au paramètre Output Estimated Call Points (Points d’appels estimés en sortie)

    • PHONEX: les coordonnées x estimées de l’emplacement de l’appel telles que fournies par le fournisseur de réseau sans fil.
    • PHONEY: les coordonnées y estimées de l’emplacement de l’appel telles que fournies par le fournisseur de réseau sans fil.

  • Si le registre du champ SUBSCRIBER est nul, il est ignoré et n’est pas importé dans les classes d’entités en sortie.

  • Si les champs STARTTIME et DURATION contiennent des valeurs mais que le champ ENDTIME n’en contient pas, l’outil génère une valeur ENDTIME dans les classes d’entités en sortie.

  • Si les champs STARTTIME et ENDTIME contiennent des valeurs mais que le champ DURATION n’en contient pas, l’outil génère une valeur DURATION dans les classes d’entités en sortie.

Paramètres

ÉtiquetteExplicationType de données
Table des registres téléphoniques en entrée

La table en entrée contenant les registres d’appel ou registres d’événements de données téléphoniques fournis par le fournisseur de réseau sans fil.

Table View
Input Cell Site Points (Points du site cellulaire en entrée)

La classe d'entités contenant les points des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités.

Feature Layer
Secteurs de site cellulaire en entrée

La classe d'entités contenant les secteurs des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités.

Feature Layer
Points des sites de registres téléphoniques en sortie

La classe d'entités ponctuelles contenant les points des sites de registres téléphoniques.

Un point est généré par registre téléphonique associé aux points des sites cellulaires.

Feature Class
Secteurs de registres téléphoniques en sortie

La classe d'entités surfaciques contenant les secteurs de registres téléphoniques.

Un polygone de secteur est généré par registre téléphonique associé aux secteurs des sites cellulaires.

Feature Class
Champs d’ID du secteur cellulaire

Indique le type de champ d’ID unique et les champs qui seront ajoutés à l’entité en sortie.

Utilisez le type ID unique lorsque la valeur du paramètre Table des registres téléphoniques en entrée possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs Type d’ID lorsque la valeur du paramètre Table des registres téléphoniques en entrée ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.

  • ID Type (Type d’ID) : nom de champ à inclure dans les classes d’entités en sortie.
  • Field (Champ) : nom des champs qui identifient de manière unique les antennes de secteur cellulaire. Ils sont ajoutés dans la classe d’entités en sortie.

Les options de ID Type (Type d’ID) sont les suivantes :

  • Unique ID (ID unique) : identifie de manière unique une antenne de secteur cellulaire.
  • Site ID (Identifiant du site) : identifie de manière unique un site cellulaire.
  • Sector ID (ID de secteur) : identifie de manière unique un secteur cellulaire.
  • Switch ID (ID de commutateur) : identifie de manière unique un commutateur réseau sans fil.
  • LAC ID (ID LAC) : identifie de manière unique le code LAC (Location Area Code).
  • Cascade ID (ID de cascade) : identifie de manière unique le secteur dans la cascade de réseau sans fil.
  • Cell ID (ID cellulaire) : identifie le secteur dans un code LAC (Location Area Code)
Value Table
Champ ID d’abonné

Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de l’abonné.

Field
Champ Numéro de téléphone de destination
(Facultatif)

Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de la personne appelée.

Field
Champs ID de secteur cellulaire supplémentaire
(Facultatif)

Spécifie le type de champ d’ID unique supplémentaire et les champs qui seront ajoutés à l’entité en sortie.

Utilisez le type ID unique lorsque la valeur du paramètre Table des registres téléphoniques en entrée possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs Type d’ID lorsque la valeur du paramètre Table des registres téléphoniques en entrée ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.

  • ID Type (Type d’ID) : nom de champ à inclure dans les classes d’entités en sortie.
  • Field (Champ) : nom des champs qui identifient de manière unique les antennes de secteur cellulaire. Ils sont ajoutés dans la classe d’entités en sortie.

Les options de ID Type (Type d’ID) sont les suivantes :

  • Unique ID (ID unique) : identifie de manière unique une antenne de secteur cellulaire.
  • Site ID (Identifiant du site) : identifie de manière unique un site cellulaire.
  • Sector ID (ID de secteur) : identifie de manière unique un secteur cellulaire.
  • Switch ID (ID de commutateur) : identifie de manière unique un commutateur réseau sans fil.
  • LAC ID (ID LAC) : identifie de manière unique le code LAC (Location Area Code).
  • Cascade ID (ID de cascade) : identifie de manière unique le secteur dans la cascade de réseau sans fil.
  • Cell ID (ID cellulaire) : identifie le secteur dans un code LAC (Location Area Code)
Value Table
Champ Date et heure de début
(Facultatif)

Le champ de la table en entrée contenant le champ de date et d’heure de début de l’appel téléphonique ou de l’événement de données.

Field
Champ Durée
(Facultatif)

Le champ de la table en entrée contenant la durée de l’appel téléphonique en secondes.

Field
Champ Date et heure de fin
(Facultatif)

Le champ de la table en entrée contenant la date et l’heure de fin de l’appel téléphonique ou de l’événement de données.

Field
Convertir les dates UTC au fuseau horaire local
(Facultatif)

Spécifie si les dates et heures de début et de fin des registres en entrée seront converties selon le fuseau horaire du système local ou seront conservées au format UTC.

  • Sélectionné : les dates et heures de début et de fin des registres en entrée seront converties à partir du format UTC au fuseau horaire du système local.
  • Non sélectionné : les dates et heures de début et de fin ne seront pas converties. Il s’agit de l’option par défaut.
Boolean
Champ X de l’emplacement estimé du téléphone
(Facultatif)

Le champ de la table en entrée contenant les coordonnées X de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil.

Field
Champ Y de l’emplacement estimé du téléphone
(Facultatif)

Le champ de la table en entrée contenant les coordonnées Y de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil.

Field
Système de coordonnées de l’emplacement estimé du téléphone
(Facultatif)

Le système de coordonnées (coordonnées x,y) de l’emplacement estimé du téléphone. Le système de coordonnées par défaut est WGS84.

Coordinate System
Points d’appel estimés en sortie
(Facultatif)

La classe d’entités ponctuelles contenant les emplacements d’appels estimés tels que fournis par le fournisseur du réseau sans fil.

Feature Class

arcpy.ca.CellPhoneRecordsToFeatureClass(in_table, in_site_features, in_sector_features, out_site_feature_class, out_sector_feature_class, id_fields, subscriber_field, {destination_field}, {additional_id_fields}, {start_time_field}, {duration_field}, {end_time_field}, {convert_utc}, {location_x_field}, {location_y_field}, {location_coordinate_system}, {out_call_points})
NomExplicationType de données
in_table

La table en entrée contenant les registres d’appel ou registres d’événements de données téléphoniques fournis par le fournisseur de réseau sans fil.

Table View
in_site_features

La classe d'entités contenant les points des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités.

Feature Layer
in_sector_features

La classe d'entités contenant les secteurs des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités.

Feature Layer
out_site_feature_class

La classe d'entités ponctuelles contenant les points des sites de registres téléphoniques.

Un point est généré par registre téléphonique associé aux points des sites cellulaires.

Feature Class
out_sector_feature_class

La classe d'entités surfaciques contenant les secteurs de registres téléphoniques.

Un polygone de secteur est généré par registre téléphonique associé aux secteurs des sites cellulaires.

Feature Class
id_fields
[id_fields,...]

Indique le type de champ d’ID unique et les champs qui seront ajoutés à l’entité en sortie.

Utilisez le type ID unique lorsque la valeur du paramètre Table des registres téléphoniques en entrée possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs Type d’ID lorsque la valeur du paramètre Table des registres téléphoniques en entrée ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.

  • ID Type (Type d’ID) : nom de champ à inclure dans les classes d’entités en sortie.
  • Field (Champ) : nom des champs qui identifient de manière unique les antennes de secteur cellulaire. Ils sont ajoutés dans la classe d’entités en sortie.

Les options de ID Type (Type d’ID) sont les suivantes :

  • Unique ID (ID unique) : identifie de manière unique une antenne de secteur cellulaire.
  • Site ID (Identifiant du site) : identifie de manière unique un site cellulaire.
  • Sector ID (ID de secteur) : identifie de manière unique un secteur cellulaire.
  • Switch ID (ID de commutateur) : identifie de manière unique un commutateur réseau sans fil.
  • LAC ID (ID LAC) : identifie de manière unique le code LAC (Location Area Code).
  • Cascade ID (ID de cascade) : identifie de manière unique le secteur dans la cascade de réseau sans fil.
  • Cell ID (ID cellulaire) : identifie le secteur dans un code LAC (Location Area Code)
Value Table
subscriber_field

Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de l’abonné.

Field
destination_field
(Facultatif)

Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de la personne appelée.

Field
additional_id_fields
[additional_id_fields,...]
(Facultatif)

Spécifie le type de champ d’ID unique supplémentaire et les champs qui seront ajoutés à l’entité en sortie.

Utilisez le type ID unique lorsque la valeur du paramètre Table des registres téléphoniques en entrée possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs Type d’ID lorsque la valeur du paramètre Table des registres téléphoniques en entrée ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.

  • ID Type (Type d’ID) : nom de champ à inclure dans les classes d’entités en sortie.
  • Field (Champ) : nom des champs qui identifient de manière unique les antennes de secteur cellulaire. Ils sont ajoutés dans la classe d’entités en sortie.

Les options de ID Type (Type d’ID) sont les suivantes :

  • Unique ID (ID unique) : identifie de manière unique une antenne de secteur cellulaire.
  • Site ID (Identifiant du site) : identifie de manière unique un site cellulaire.
  • Sector ID (ID de secteur) : identifie de manière unique un secteur cellulaire.
  • Switch ID (ID de commutateur) : identifie de manière unique un commutateur réseau sans fil.
  • LAC ID (ID LAC) : identifie de manière unique le code LAC (Location Area Code).
  • Cascade ID (ID de cascade) : identifie de manière unique le secteur dans la cascade de réseau sans fil.
  • Cell ID (ID cellulaire) : identifie le secteur dans un code LAC (Location Area Code)
Value Table
start_time_field
(Facultatif)

Le champ de la table en entrée contenant le champ de date et d’heure de début de l’appel téléphonique ou de l’événement de données.

Field
duration_field
(Facultatif)

Le champ de la table en entrée contenant la durée de l’appel téléphonique en secondes.

Field
end_time_field
(Facultatif)

Le champ de la table en entrée contenant la date et l’heure de fin de l’appel téléphonique ou de l’événement de données.

Field
convert_utc
(Facultatif)

Spécifie si les dates et heures de début et de fin des registres en entrée seront converties selon le fuseau horaire du système local ou seront conservées au format UTC.

  • CONVERTLes dates et heures de début et de fin des registres en entrée seront converties à partir du format UTC au fuseau horaire du système local.
  • NO_CONVERTLes dates et heures de début et de fin des registres en entrée ne seront pas converties. Il s’agit de l’option par défaut.
Boolean
location_x_field
(Facultatif)

Le champ de la table en entrée contenant les coordonnées X de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil.

Field
location_y_field
(Facultatif)

Le champ de la table en entrée contenant les coordonnées Y de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil.

Field
location_coordinate_system
(Facultatif)

Le système de coordonnées (coordonnées x,y) de l’emplacement estimé du téléphone. Le système de coordonnées par défaut est WGS84.

Coordinate System
out_call_points
(Facultatif)

La classe d’entités ponctuelles contenant les emplacements d’appels estimés tels que fournis par le fournisseur du réseau sans fil.

Feature Class

Exemple de code

Exemple 1 d'utilisation de l'outil CellPhoneRecordsToFeatureClass (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CellPhoneRecordsToFeatureClass en mode immédiat :

import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.CellPhoneRecordsToFeatureClass("CDR_Phone_1",
                                        "Phone_1_Sites",
                                        "Phone_1_Sectors",
                                        "CDR_Phone_1_Sites_out",
                                        "CDR_Phone_1_Sectors_out",
                                        "SWITCH_ID BEGSWITCH;SITE_ID BEGSITE;SECTOR_ID BEGSECTOR",
                                        "SUBSCRIBERID")
Exemple 2 d’utilisation de l’outil CellPhoneRecordsToFeatureClass (fenêtre autonome)

Le script autonome suivant est un exemple d’utilisation de la fonction CellPhoneRecordsToFeatureClass dans un script :

# Name: CellPhoneRecordsToFeatureClass.py
# Description: Imports cell phone records then associates those records with a 
#              cell site and sector feature classes based on identifier fields.

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"

# Set local variables
in_table = "CDR_Phone_1"
in_sites = "Phone_1_Sites"
in_sectors = "Phone_1_Sectors"
out_cdr_sites = "CDR_Phone_1_Sites_out"
out_cdr_sectors = "CDR_Phone_1_Sectors_out"

# Set up Beginning of Phone IDs
# [ID Type, Field]
begin_switch_id = ["SWITCH_ID","BEGSWITCH"]
begin_site_id = ["SITE_ID","BEGSITE"]
begin_sector_id = ["SECTOR_ID","BEGSECTOR"]
begin_id_fields = [begin_switch_id, begin_site_id, begin_sector_id]
subscriber_field = "SUBSCRIBERID"
destination_field = "DESTNUM"

# Set up End of Phone Call IDs
# [ID Type, Field]
end_switch_id = ["SWITCH_ID","ENDSWITCH"]
end_site_id = ["SITE_ID","ENDSITE"]
end_sector_id = ["SECTOR_ID","ENDSECTOR"]
end_id_fields = [end_switch_id, end_site_id, end_sector_id]

# Input Table Contains information about the duration of the call
start_date_field = "DATETIME"
duration_field = "DURATION"

arcpy.ca.CellPhoneRecordsToFeatureClass(in_table,
                                        in_sites,
                                        in_sectors,
                                        out_cdr_sites,
                                        out_cdr_sectors,
                                        begin_id_fields,
                                        subscriber_field,
                                        destination_field,
                                        end_id_fields,
                                        start_date_field,
                                        duration_field)

Informations de licence

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

Rubriques connexes