Zusammenfassung
Importiert Mobilfunkdaten von Funknetzbetreibern und verknüpft diese Datensätze mit einer Funkzelle und Sektor-Feature-Classes, die mit dem Werkzeug Funkzellendaten in Feature-Class auf Grundlage der Kennungsfelder erstellt wurden.
Verwendung
Die Werte des Parameters Eingabe-Funkzellenpunkte müssen mit dem Werkzeug Funkzellendaten in Feature-Class generiert werden.
Die Parameter Ausgabe-Mobilfunkdatensatz-Funkzellenpunkte und Ausgabe-Mobilfunkdatensatz-Sektoren enthalten nur Mobilfunkdaten, die erfolgreich auf Grundlage übereinstimmender ID-Felder mit der Eingabefunkzelle und Eingabesektoren verknüpft wurden. Die Werte der Parameter Ausgabe-Mobilfunkdatensatz-Funkzellenpunkte und Ausgabe-Mobilfunkdatensatz-Sektoren stellen nicht die tatsächlichen Position des Mobiltelefons dar.
Funknetzbetreiber stellen Mobilfunkdaten oder Verbindungsdatensätze (Call Detail Records; CDRs) in verschiedenen Formaten und Stilen bereit. Häufig werden Daten nicht in einem Tabellenformat oder Tabellenschema empfangen. Der Wert des Parameters Mobilfunkdatensatz-Eingabetabelle muss eine Tabelle mit Spaltenüberschriften sein.
Die vom Funknetzbetreiber bereitgestellte Tabelle enthält möglicherweise CDR- und Funkzelleninformationen in einer Zeile. Wenn die Tabelle diese Struktur aufweist, muss sie in zwei Tabellen unterteilt werden. Verwenden Sie als Eingabe für dieses Werkzeug die Tabelle mit den Anrufinformationen (Kennungen, Telefonnummern, Datumsangaben, Zeit, Anrufdauer und Koordinaten).
Für jeden Datensatz (Anruf oder Datenereignis) des Parameters Mobilfunkdatensatz-Eingabetabelle wird ein Feature in den Ausgabe-Feature-Classes erstellt.
Den Ausgabe-Feature-Classes werden die folgenden Felder hinzugefügt:
- SUBSCRIBER: Die im Parameter Mobilfunkdatensatz-Eingabetabelle angegebene Teilnehmer-Telefonnummer. Alle nicht numerischen Zeichen werden aus der Ausgabe entfernt.
- UNIQUEID: Die eindeutige Kennung der Funkzellenantennen.
Die folgenden Felder werden der Ausgabe hinzugefügt, wenn der angegebene Parameter verwendet wird:
- DESTPHONE: Die im Parameter Mobilfunkdatensatz-Eingabetabelle angegebene Telefonnummer des Angerufenen. Diese wird der Ausgabe hinzugefügt, wenn der Parameter Zieltelefonnummer-Feld verwendet wird. Alle nicht numerischen Zeichen werden aus der Ausgabe entfernt.
- STARTTIME: Das Feld für Startdatum und -uhrzeit des Parameters Mobilfunkdatensatz-Eingabetabelle. Diese wird der Ausgabe hinzugefügt, wenn der Parameter Feld mit Startdatum und -uhrzeit verwendet wird.
- DURATION: Die Dauer (in Sekunden) des im Parameter Mobilfunkdatensatz-Eingabetabelle angegebenen Telefonanrufs. Werte für die Dauer im Format HH:MM:SS werden in eine Sekundenzahl konvertiert Dieses Feld wird der Ausgabe hinzugefügt, wenn der Parameter Dauer-Feld verwendet wird oder wenn sowohl der Parameter Feld mit Startdatum und -uhrzeit als auch der Parameter Feld mit Enddatum und -uhrzeit verwendet werden.
- ENDTIME: Das Feld für Enddatum und -uhrzeit des Parameters Mobilfunkdatensatz-Eingabetabelle. Dieses Feld wird der Ausgabe hinzugefügt, wenn der Parameter Feld mit Enddatum und -uhrzeit verwendet wird oder wenn sowohl der Parameter Feld mit Startdatum und -uhrzeit als auch der Parameter Dauer verwendet werden.
Die vom Funknetzbetreiber bereitgestellte Tabelle kann eine Tabelle mit Funkzelleninformationen mit einem eindeutigen ID-Feld enthalten, um alle eindeutigen Datensätze zu definieren. Sie kann aber auch eine Kombination von Kennungsfeldern zur Definition eindeutiger Datensätze in der Tabelle enthalten. Beispiel: Eine Tabelle kann die Felder "Site Identifier" und "Sector Identifier" enthalten, um einige Datensätze eindeutig zu definieren, aber andere Datensätze in der Tabelle werden mit der Kennung "Location Area Code Identifier" und den Feldern "Cell Identifier" eindeutig definiert.
- Wenn ein eindeutiges ID-Feld für die Eingabetabelle bereitgestellt wird, setzen Sie die Option ID-Typ im Parameter Zellensektor-ID-Felder oder Zusätzliche Zellensektor-ID-Felder auf Eindeutige ID. Geben Sie in demselben Parameter unter der Option Feld das Feld ein, das die eindeutige ID darstellt.
- Wenn zur Kennzeichnung von Eindeutigkeit für die Tabelle viele ID-Felder angegeben werden, müssen alle ID-Felder zur Ausgabe hinzugefügt werden. Wählen Sie für jedes ID-Feld den Wert ID-Typ aus, der den ID-Typ im Parameter Zellensektor-ID-Felder oder Zusätzliche Zellensektor-ID-Felder definiert. In demselben Parameter geben Sie unter der Option Feld das zugehörige Feld ein, das die ID-Informationen enthält. Das Werkzeug kombiniert diese ID-Felder und füllt ein eindeutiges ID-Feld in der Ausgabe-Feature-Class namens UNIQUEID.
Die folgenden Felder werden der Ausgabe hinzugefügt, wenn sie im Parameter Zellensektor-ID-Felder oder Zusätzliche Zellensektor-ID-Felder angegeben sind:
- SITEID: Die eindeutige Kennung einer Funkzelle
- SECTORID: Die eindeutige Kennung eines Zellensektors
- SWITCHID: Die eindeutige Kennung eines Funknetz-Switch
- LACID: Die eindeutige Kennung eines Location Area Codes
- CASCADEID: Die eindeutige Kennung des Sektors innerhalb der Funknetz-Kaskade
- CELLID Die eindeutige Kennung des Sektors in einem Location Area Code
Wenn die Mobilfunkdatensatz-Eingabetabelle Verbindungsdatensätze für mehrere Funkzellen enthält, müssen die Parameter Zellensektor-ID-Felder und Zusätzliche Zellensektor-ID-Felder ausgefüllt sein. Der Parameter Zellensektor-ID-Felder muss die Kennungen für den Startsektor enthalten, und der Parameter Zusätzliche Zellensektor-ID-Felder muss den Endsektor oder einen beliebigen anderen Sektor als den Startsektor im Verbindungsdatensatz enthalten.
Wenn die Mobilfunkdatensatz-Eingabetabelle Datenereignis-Datensätze enthält oder wenn im Verbindungsdatensatz nur ein Sektor referenziert wird, muss nur der Parameter Zellensektor-ID-Felder ausgefüllt sein.
Wenn der Parameter Zusätzliche Zellensektor-ID-Felder verwendet wird, werden das folgende Feld und die folgenden Werte generiert:
- IDTYPE: Dieses Feld gibt an, ob ein Verbindungsdatensatz ein primärer Sektor oder zusätzlicher Sektor eines Verbindungsdatensatzes ist.
- PRIMARY: Dieser Wert wird zugewiesen, wenn ein Mobilfunkdatensatz mit einem Sektor am Anfang des Anrufs verknüpft ist.
- ADDITIONAL: Dieser Wert wird zugewiesen, wenn ein Mobilfunkdatensatz mit einem Sektor am Ende eines Anrufs oder mit einem Sektor während des Anrufs verknüpft ist, falls sich der Sektor vom Sektor am Anfang des Anrufs unterscheidet.
Wenn das Werkzeug bestimmt, dass ein Mobilfunkdatensatz am Anfang und Ende des Anrufs mit demselben Sektor verknüpft ist, wird kein eigenes Feature für den Zellensektor erstellt, der das Ende eines Anrufs darstellt.
- IDTYPE: Dieses Feld gibt an, ob ein Verbindungsdatensatz ein primärer Sektor oder zusätzlicher Sektor eines Verbindungsdatensatzes ist.
Die geschätzten Ausgabe-Anrufpunkte enthalten alle verknüpften Felder der Parameter Ausgabe-Mobilfunkdatensatz-Funkzellenpunkte und Ausgabe-Mobilfunkdatensatz-Sektoren.
Dem Parameter Geschätzte Anrufpunkte ausgeben werden außerdem die folgenden Felder hinzugefügt:
- PHONEX: Die geschätzte X-Koordinate der vom Funknetzbetreiber angegebenen Anrufposition.
- PHONEY: Die geschätzte Y-Koordinate der vom Funknetzbetreiber angegebenen Anrufposition.
Wenn der Datensatz des Feldes SUBSCRIBER NULL ist, wird er ignoriert und nicht in die Ausgabe-Feature-Class importiert.
Wenn die Felder STARTTIME und DURATION Werte enthalten und das Feld ENDTIME keinen Wert enthält, generiert das Werkzeug in den Ausgabe-Feature-Classes einen ENDTIME-Wert.
Wenn die Felder STARTTIME und ENDTIME Werte enthalten und das Feld DURATION keinen Wert enthält, generiert das Werkzeug in den Ausgabe-Feature-Classes einen DURATION-Wert.
Syntax
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})
Parameter | Erklärung | Datentyp |
in_table | Die Eingabetabelle, die vom Funknetzbetreiber angegebene Verbindungsdatensätze oder Telefondatenereignis-Datensätze enthält. | Table View |
in_site_features | Die Feature-Class, die vom Werkzeug Funkzellendaten in Feature-Class generierte Funkzellenpunkte enthält. | Feature Layer |
in_sector_features | Die Feature-Class, die vom Werkzeug Funkzellendaten in Feature-Class generierte Funkzellensektoren enthält. | Feature Layer |
out_site_feature_class | Die Point-Feature-Class, die Mobilfunkdatensatz-Funkzellenpunkte enthält. Für jeden mit Funkzellenpunkten verknüpften Mobilfunkdatensatz wird ein Punkt generiert. | Feature Class |
out_sector_feature_class | Die Polygon-Feature-Class, die Mobilfunkdatensatz-Sektoren enthält. Für jeden mit Funkzellensektoren verknüpften Mobilfunkdatensatz wird ein Sektorpunkt generiert. | Feature Class |
id_fields [id_fields,...] | Gibt den Typ des eindeutigen ID-Feldes und die Felder an, die dem Ausgabe-Feature hinzugefügt werden. Verwenden Sie den Typ Eindeutige ID, wenn die Mobilfunkdatensatz-Eingabetabelle eine eindeutige Kennung für jede Zellensektorantenne enthält. Verwenden Sie eine Kombination anderer ID-Typ-Werte, wenn die Mobilfunkdatensatz-Eingabetabelle nicht für jede Zellensektorantenne eine UUID (Universally Unique Identifier) enthält.
Folgende Optionen für ID-Typ stehen zur Verfügung:
| Value Table |
subscriber_field | Das Feld in der Eingabetabelle, das die Telefonnummer oder Kennung des Teilnehmers enthält. | Field |
destination_field (optional) | Das Feld in der Eingabetabelle, das die Telefonnummer oder Kennung des Angerufenen enthält. | Field |
additional_id_fields [additional_id_fields,...] (optional) | Gibt den Typ des zusätzlichen Feldes für die eindeutige ID und die Felder an, die dem Ausgabe-Feature hinzugefügt werden. Verwenden Sie den Typ Eindeutige ID, wenn die Mobilfunkdatensatz-Eingabetabelle eine eindeutige Kennung für jede Zellensektorantenne enthält. Verwenden Sie eine Kombination anderer ID-Typ-Werte, wenn die Mobilfunkdatensatz-Eingabetabelle nicht für jede Zellensektorantenne eine UUID (Universally Unique Identifier) enthält.
Folgende Optionen für ID-Typ stehen zur Verfügung:
| Value Table |
start_time_field (optional) | Das Feld in der Eingabetabelle, das das Startdatums- und -uhrzeitfeld des Telefonanrufs oder Datenereignisses enthält. | Field |
duration_field (optional) | Das Feld in der Eingabetabelle, das die Dauer (in Sekunden) des Telefonanrufs oder Datenereignisses enthält. | Field |
end_time_field (optional) | Das Feld in der Eingabetabelle, das das Enddatum und die Enduhrzeit des Telefonanrufs oder Datenereignisses enthält. | Field |
convert_utc (optional) | Gibt an, ob das Start- und Enddatum und die Start- und Enduhrzeit der Eingabedatensätze in die Zeitzone des lokalen Systems konvertiert oder als koordinierte Weltzeit (UTC) angegeben werden.
| Boolean |
location_x_field (optional) | Das Feld in der Eingabetabelle, das die X-Koordinate des vom Funknetzbetreiber angegebenen geschätzten Telefonstandorts enthält. | Field |
location_y_field (optional) | Das Feld in der Eingabetabelle, das die Y-Koordinate des vom Funknetzbetreiber angegebenen geschätzten Telefonstandorts enthält. | Field |
location_coordinate_system (optional) | Das Koordinatensystem der XY-Koordinaten für den geschätzten Telefonstandort. Das Standardkoordinatensystem ist WGS84. | Coordinate System |
out_call_points (optional) | Die Point-Feature-Class, die die vom Funknetzbetreiber angegebenen geschätzten Anrufpositionen enthält. | Feature Class |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CellPhoneRecordsToFeatureClass im unmittelbaren Modus verwendet wird:
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")
Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion CellPhoneRecordsToFeatureClass in einem Skript:
# 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)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja