Relevés de site cellulaire vers classe d’entités (Analyse criminelle et sécurité)

Résumé

Crée les points du site cellulaire et les polygones de secteurs basés sur la latitude, la longitude, l’azimut, la largeur du faisceau, et le rayon en entrée enregistrés dans une table de site cellulaire.

Utilisation

  • Les polygones de secteurs cellulaires créés par cet outil sont des représentations visuelles de valeurs fournies et ne doivent pas être considérés comme les limites exactes des secteurs, les étendues des largeurs de faisceau et les distances radiales pouvant différer.

  • Les opérateurs de téléphonie mobile fournissent des informations sur les sites cellulaires en divers formats et styles. Il n’est pas rare de recevoir des données dans un format ou une structure non tabulaire. La valeur de paramètre Input Cell Site Table (Table de site cellulaire en entrée) doit désigner une table dont les noms de colonne figurent en haut.

  • La table fournie par l’opérateur de téléphonie mobile peut contenir le relevé détaillé des appels (CDR) et les informations sur le site cellulaire sur une seule ligne. Lorsqu’une table se présente de cette façon, elle doit être séparée en deux tables. Utilisez la table contenant les champs d’identifiants, l’azimut, la largeur du faisceau et le rayon en entrée de cet outil.

  • La table fournie par l’opérateur de téléphonie mobile peut contenir des informations sur le site cellulaire concernant plusieurs secteurs cellulaires sur une seule ligne d’une table. Lorsqu’une table se présente de cette façon, des informations sur le secteur supplémentaires doivent être séparées dans une autre ligne.

    Si, par exemple, le paramètre Input Cell Site Table (Table de site cellulaire en entrée) comporte 10 enregistrements avec les champs Beginning Switch Identifier, Beginning Site Identifier, Beginning Sector Identifier, Beginning Sector Latitude, Beginning Sector Longitude, Beginning Sector Beamwidth, Ending Switch Identifier, Ending Site Identifier, Ending Sector Identifier, Ending Sector Latitude, Ending Sector Longitude et Ending Sector Beamwidth, reformatez cette table en une nouvelle table contenant les champs Switch Identifier, Site Identifier, Sector Identifier, Sector Latitude, Sector Longitude, Sector Azimuth et Sector Beamwidth. La nouvelle table contiendra 20 enregistrements, les 10 premiers enregistrements désignant les valeurs des informations sur le secteur de début et les 10 derniers enregistrements désignant les valeurs des informations sur le secteur de fin. Dans le cas où les secteurs de début et de fin partagent les mêmes informations pour des enregistrements particuliers de la table d’origine, l’outil considère que le secteur de fin est un double et l’ignore.

  • Le paramètre Input Cell Site Table (Table de site cellulaire en entrée) doit comporter un ID unique pour chaque enregistrement, représentant chaque antenne du secteur de site cellulaire. Si l’outil détermine qu’il existe un doublon d’ID unique dans la table, seul un enregistrement est ajouté aux sorties.

  • Les sorties de cet outil peuvent être utilisées comme entrées de l’outil Registres de téléphone portable vers classe d’entités d’adresses.

  • Un système de coordonnées projetées en sortie est nécessaire pour calculer plus précisément les propriétés relatives au rayon du secteur, à la largeur du faisceau et à l’azimut. Le système de coordonnées en sortie devrait être le même système de coordonnées que celui de la carte, pour garantir la plus grande précision.

  • Les enregistrements en entrée contenant des valeurs nulles ou vides dans le champ SITEX ou SITEY sont ignorés.

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

    • UNIQUEID—Identifiant unique des antennes de secteurs cellulaires.
    • SITEX—Coordonnées x des entités Input Cell Site Table (Table de site cellulaire en entrée).
    • SITEY—Coordonnées y des entités Input Cell Site Table (Table de site cellulaire en entrée).
    • AZIMUTH—Azimut des entités Input Cell Site Table (Table de site cellulaire en entrée) ou des azimuts dérivés selon la valeur Default Start Azimuth (Azimut de départ par défaut).
    • BEAMWIDTH—Largeur du faisceau (angle) de l’entité Input Cell Site Table (Table de site cellulaire en entrée) ou de la valeur Default Beamwidth (Largeur du faisceau par défaut).
    • RADIUS—Longueur radiale (distance du signal) de l’entité Input Cell Site Table (Table de site cellulaire en entrée) ou de la valeur Default Radius (Rayon par défaut).
    • RADIUSUNIT—Unité linéaire de la valeur de distance.
    • AZIMSRC—Source à partir de laquelle la valeur d’azimut est dérivée.
      • INPUT—Valeur attribuée lorsque le paramètre Azimuth Field (Champ Azimuth) est utilisé.
      • DEFAULT—Valeur attribuée lorsque le paramètre Default Start Azimuth (Azimut de départ par défaut) est utilisé.
    • BEAMSRC—Source à partir de laquelle la valeur de la largeur du faisceau est dérivée.
      • INPUT—Valeur attribuée lorsque le paramètre Beamwidth Field (Champ Largeur de faisceau) est utilisé.
      • DEFAULT—Valeur attribuée lorsque le paramètre Default Beamwidth (Largeur du faisceau par défaut) est utilisé.
    • RADIUSSRC—Source à partir de laquelle la valeur de rayon est dérivée.
      • INPUT—Valeur attribuée lorsque le paramètre Radius Field (Champ Rayon) est utilisé.
      • DEFAULT—Valeur attribuée lorsque le paramètre Default Radius Length (Longueur du rayon par défaut) est utilisé.

    Les valeurs des champs RADIUSSRC, BEAMSRC et AZIMSRC identifient la manière dont la représentation du polygone de secteur cellulaire est générée.

  • 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). 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). 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 d’identifiant suivants sont ajoutés à la sortie s’ils sont spécifiés dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) :

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

Syntaxe

arcpy.ca.CellSiteRecordsToFeatureClass(in_table, out_site_feature_class, out_sector_feature_class, id_fields, x_field, y_field, in_coordinate_system, out_coordinate_system, {azimuth_field}, {default_azimuth}, beamwidth_field, {beamwidth_type}, {default_beamwidth}, radius_field, {radius_unit}, {default_radius_length})
ParamètreExplicationType de données
in_table

Table en entrée contenant les informations sur le site cellulaire fournies par l’opérateur de réseau sans fil.

Table View
out_site_feature_class

Classe d’entités contenant les points du site cellulaire en sortie.

Feature Class
out_sector_feature_class

Classe d’entités contenant les secteurs du site cellulaire en sortie.

Feature Class
id_fields
[id_fields,...]

Specifies the unique ID field type and the fields that will be added to the output feature.

Use the Unique ID value when the Input Cell Site Table parameter has a unique identifier for all cell sector antennas. Use a combination of other ID Type values when the Input Cell Site Table parameter does not contain a universal unique identifier for all cell sector antennas.

  • ID Type—The field name to be included in the output feature classes.
  • Field—The name of the fields that uniquely identify the cell sector antennas. These will be added to the output feature class.

ID Type options are as follows:

  • Unique ID—Uniquely identifies a cell sector antenna
  • Site ID—Uniquely identifies a cell site
  • Sector ID—Uniquely identifies a cell sector
  • Switch ID—Uniquely identifies a wireless network switch
  • LAC ID—Uniquely identifies the Location Area Code
  • Cascade ID—Uniquely identifies the sector in the wireless network cascade
  • Cell ID—Identifies the sector within an Location Area Code
Value Table
x_field

Champ de la table en entrée contenant la coordonnée x du site cellulaire.

Field
y_field

Champ de la table en entrée contenant la coordonnée y du site cellulaire.

Field
in_coordinate_system

Système des coordonnées spécifiées dans les paramètres X Field (Champ X) et Y Field (Champ Y).

Coordinate System
out_coordinate_system

Système de coordonnées projetées des sites et secteurs en sortie.

Coordinate System
azimuth_field
(Facultatif)

Champ figurant dans la table en entrée qui contient la direction du signal de l’antenne (secteur cellulaire).

Les valeurs du champ d’azimut doivent être exprimées en degrés positifs compris entre 0 et 360, mesurés dans le sens horaire, à partir du nord.

Field
default_azimuth
(Facultatif)

Valeur de l’azimut de départ des signaux d’antennes (secteurs cellulaires) à utiliser lorsque le champ d’azimut n’est pas spécifié.

Si, par exemple, trois secteurs cellulaires existent à la même position et que ce paramètre est défini sur 0 degré. Le premier secteur est généré avec un azimut de 0 degré, le deuxième secteur avec un azimut de 120 degrés et le troisième secteur avec un azimut de 240 degrés.

Ce paramètre est utilisé lorsque le champ d’azimut n’est pas spécifié.

Les valeurs d’azimut doivent être exprimées en degrés positifs compris entre 0 et 360. La valeur par défaut est 0.

Double
beamwidth_field

Champ figurant dans la table en entrée qui contient la totalité ou la moitié de la largeur du faisceau du signal de l’antenne (secteur cellulaire).

La largeur du faisceau doit être exprimée en degrés positifs compris entre 0 et 360. Utilisez 360 pour les antennes omnidirectionnelles.

Field
beamwidth_type
(Facultatif)

Spécifie le type de la valeur de largeur du faisceau représentée dans la table de type de cellule en entrée.

  • FULL_BEAMWIDTHLa largeur totale du faisceau est représentée en entrée. Il s’agit de l’option par défaut.
  • HALF_BEAMWIDTHLa demi-largeur du faisceau est représentée en entrée.
String
default_beamwidth
(Facultatif)

Largeur du faisceau (en degrés) du signal de l’antenne (secteur cellulaire) à utiliser lorsque le champ de la largeur du faisceau n’est pas spécifié.

La valeur par défaut est de 90 degrés.

Double
radius_field

Champ figurant dans la table en entrée qui contient la longueur radiale (distance du signal) du signal de l’antenne (secteur cellulaire).

Field
radius_unit
(Facultatif)

Indique l’unité linéaire de mesure du champ de rayon.

  • KILOMETERSLes kilomètres sont l’unité.
  • METERSLes mètres sont l’unité.
  • MILESLes milles sont l’unité. Il s’agit de l’option par défaut.
  • YARDSLes yards sont l’unité.
  • FEETLes pieds sont l’unité.
String
default_radius_length
(Facultatif)

Longueur du rayon (distance du signal) du signal de l’antenne (secteur cellulaire) à utiliser lorsque le champ radial n’est pas spécifié.

La valeur par défaut est 2.

Double

Exemple de code

Exemple 1 d’utilisation de l’outil CellSiteRecordsToFeatureClass (fenêtre Python)

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

import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.CellSiteRecordsToFeatureClass("Sites_Phone_1",
                                       "Phone_1_Sites_out",
                                       "Phone_1_Sectors_out",
                                       "SWITCH_ID SWITCH;SITE_ID SITEID;SECTOR_ID SECTORID",
                                       "LATITUDE",
                                       "LONGITUDE",
                                       4326,
                                       102100)
Exemple 2 d’utilisation de l’outil CellSiteRecordsToFeatureClass (fenêtre autonome)

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

# Name: CellSiteRecordsToFeatureClass.py
# Description: Creates cell site points and sector polygons based on input cell 
#              site table.
# Import script modules
import arcpy
# Set the workspace
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Set local parameters
in_table = "Sites_Phone_1"
out_sites = "Phone_1_Sites_out"
out_sectors = "Phone_1_Sectors_out"
# Setup IDs
# [ID Type, Field]
switch_id = ["SWITCH_ID","SWITCH"]
site_id = ["SITE_ID","SITEID"]
sector_id = ["SECTOR_ID","SECTORID"]
id_fields = [switch_id, site_id, sector_id]
x_field = "LATITUDE"
y_field = "LONGITUDE"
in_coor_system = 4326
out_coor_system = 102100
# Input Table Contains information that defines how sectors and sites are 
# generated
azimuth_field = "AZIMUTH"
default_start_azimuth = 0
beamwidth_field = "BEAMWIDTH"
beamwidth_type = "FULL_BEAMWIDTH"
default_beamwidth = 90
radius_field = "RADIUS"
default_radius = "MILES"
default_radius_length = 2
arcpy.ca.CellSiteRecordsToFeatureClass(in_table,
                                       out_sites,
                                       out_sectors,
                                       id_fields,
                                       x_field,
                                       y_field,
                                       in_coor_system,
                                       out_coor_system,
                                       azimuth_field,
                                       default_start_azimuth,
                                       beamwidth_field,
                                       beamwidth_type,
                                       default_beamwidth,
                                       radius_field,
                                       default_radius,
                                       default_radius_length)

Informations de licence

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

Rubriques connexes