描述
用于从无线网络提供商处导入手机记录,并将这些记录与蜂窝基站记录转要素类工具根据标识符字段生成的蜂窝基站和扇区要素类相关联。
使用方法
必须使用蜂窝基站记录转要素类工具生成输入蜂窝基站点参数值。
输出手机记录基站点和输出手机记录扇区参数将仅包含根据匹配的 ID 字段成功链接到输入蜂窝基站和扇区的手机记录。输出电话记录基站点和输出电话记录扇区参数值不表示手机的实际位置。
无线网络提供商将以各种格式和样式提供手机记录或呼叫详细信息记录 (CDR)。以非表格格式或方案接收数据并不罕见。输入电话记录表参数值必须为在顶部具有列名称的表。
无线网络提供商提供的表可能在一行中包含 CDR 和蜂窝基站信息。以这种方式构造表时,必须将其分为两个表。可以使用包含呼叫信息(标识符、电话号码、日期、时间、通话时长和坐标)的表作为此工具的输入。
将在输出要素类中为输入电话记录表参数的每个记录(呼叫或数据事件)创建一个要素。
以下字段将添加到输出要素类中:
- SUBSCRIBER - 输入电话记录表参数的订阅者电话号码。将从输出中移除所有非数值字符。
- UNIQUEID - 蜂窝扇区天线的唯一标识符。
如果使用指定参数,则以下字段将添加到输出中:
- DESTPHONE - 输入电话记录表参数的被呼叫者电话号码。如果使用目标电话号码字段参数,则其将添加到输出中。将从输出中移除所有非数值字符。
- STARTTIME - 输入电话记录表参数的起始日期和时间字段。如果使用起始日期和时间字段参数,则其将添加到输出中。
- DURATION - 输入电话记录表参数的电话通话时长,以秒为单位。格式为 HH:MM:SS 的时长值将转换为总秒数。如果使用时长字段参数,或者同时使用起始日期和时间字段和结束日期和时间字段参数,则其将添加到输出中。
- ENDTIME - 输入电话记录表参数的结束日期和时间字段。如果使用结束日期和时间字段参数,或者同时使用起始日期和时间字段和时长参数,则其将添加到输出中。
无线网络提供商提供的表格中可能包含蜂窝基站信息表,其中将使用唯一 ID 字段定义所有唯一记录,或使用标识符字段组合定义表中的唯一记录。例如,表中可能包含站点标识符和扇区标识符字段,以唯一定义一些记录,但是表中的其他记录将通过位置区号标识符和蜂窝标识符字段来唯一定义。
- 当为输入表提供唯一 ID 字段时,需要将蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中的 ID 类型选项设置为唯一 ID,并在同一参数中填充表示唯一 ID 的字段选项。
- 当为表提供多个 ID 字段以指示唯一性时,必须将所有 ID 字段均添加到输出中。对于每个 ID 字段,选择用于定义蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中的 ID 类型的 ID 类型,并在同一参数中填充字段选项及其中包含 ID 信息的相关字段。该工具将组合这些 ID 字段,并在名为 UNIQUEID 的输出要素类中填充单个唯一 ID 字段。
如果在蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中指定了以下字段,则会将其添加到输出中:
- SITEID - 蜂窝基站唯一标识符
- SECTORID - 蜂窝扇区唯一标识符
- SWITCHID - 无线网络交换机唯一标识符
- LACID - 位置区号唯一标识符
- CASCADEID - 无线网络 Cascade 中扇区的唯一标识符
- CELLID - 位置区号中扇区的唯一标识符
如果输入电话记录表包含跨多个蜂窝扇区的呼叫记录,则必须填充蜂窝扇区 ID 字段和附加蜂窝扇区 ID 字段参数。蜂窝扇区 ID 字段参数必须包含与起始扇区相关联的标识符,并且附加扇区 ID 字段参数必须包含结束扇区或者呼叫记录中起始扇区以外的任何扇区。
如果输入电话记录表包含数据事件记录或者呼叫记录中仅引用一个扇区,则必须仅填充蜂窝扇区 ID 字段参数。
如果使用附加蜂窝扇区 ID 字段参数,则将生成以下字段和值:
- IDTYPE - 标识呼叫记录是呼叫记录的主要扇区还是附加扇区的字段。
- PRIMARY - 在开始呼叫时,将手机记录链接到扇区时分配的值。
- ADDITIONAL - 如果扇区与呼叫开始时的扇区不同,则将手机记录链接到通话结束时的扇区或者链接到通话时长内的任何扇区时分配的值。
如果该工具确定手机记录已链接到通话开始和结束时的相同扇区,则不会为表示通话结束的蜂窝扇区创建单独的要素。
- IDTYPE - 标识呼叫记录是呼叫记录的主要扇区还是附加扇区的字段。
输出估计呼叫点将包含输出电话记录基站点和输出电话记录基站扇区参数的所有相关字段。
以下字段也将添加到输出估计呼叫点参数:
- PHONEX - 无线网络提供商提供的呼叫位置的估计 x 坐标。
- PHONEY - 无线网络提供商提供的呼叫位置的估计 y 坐标。
如果 SUBSCRIBER 字段记录为空,则其将被忽略并且将不会导入到输出要素类中。
如果 STARTTIME 和 DURATION 字段具有值,而 ENDTIME 字段没有值,则该工具将在输出要素类中生成 ENDTIME 值。
如果 STARTTIME 和 ENDTIME 字段具有值,而 DURATION 字段没有值,则该工具将在输出要素类中生成 DURATION 值。
语法
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})
参数 | 说明 | 数据类型 |
in_table | 输入表,其中包含无线网络提供商提供的呼叫记录或电话数据事件记录。 | Table View |
in_site_features | 要素类,其中包含蜂窝基站记录转要素类工具生成的蜂窝基站点。 | Feature Layer |
in_sector_features | 要素类,其中包含蜂窝基站记录转要素类工具生成的蜂窝基站扇区。 | Feature Layer |
out_site_feature_class | 包含电话记录基站点的点要素类。 将为链接到蜂窝基站点的每条电话记录生成一个点。 | Feature Class |
out_sector_feature_class | 包含电话记录扇区的面要素类。 将为链接到蜂窝基站扇区的每条电话记录生成一个扇区面。 | Feature Class |
id_fields [id_fields,...] | 指定唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表包含所有蜂窝扇区天线的唯一标识符时,请使用唯一 ID 类型。当输入电话记录表不包含所有蜂窝扇区天线的通用唯一标识符时,请结合使用其他 ID 类型值。
ID 类型选项如下:
| Value Table |
subscriber_field | 输入表中的字段,该输入表包含订阅者的电话号码或标识符。 | Field |
destination_field (可选) | 输入表中的字段,该输入表包含被呼叫者的电话号码或标识符。 | Field |
additional_id_fields [additional_id_fields,...] (可选) | 指定附加唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表包含所有蜂窝扇区天线的唯一标识符时,请使用唯一 ID 类型。当输入电话记录表不包含所有蜂窝扇区天线的通用唯一标识符时,请结合使用其他 ID 类型值。
ID 类型选项如下:
| Value Table |
start_time_field (可选) | 输入表中的字段,该输入表包含电话呼叫或数据事件的起始日期和时间字段。 | Field |
duration_field (可选) | 输入表中的字段,该输入表包含电话通话时长,以秒为单位。 | Field |
end_time_field (可选) | 输入表中的字段,该输入表包含电话呼叫或数据事件的结束日期和时间字段。 | Field |
convert_utc (可选) | 指定将输入记录的起始及结束日期和时间转换为本地系统的时区,还是保留为协调世界时间 (UTC)。
| Boolean |
location_x_field (可选) | 输入表中的字段,该输入表包含无线网络提供商提供的估计电话位置的 x 坐标。 | Field |
location_y_field (可选) | 输入表中的字段,该输入表包含无线网络提供商提供的估计电话位置的 y 坐标。 | Field |
location_coordinate_system (可选) | x,y 坐标的估计电话位置坐标系。默认坐标系为 WGS84。 | Coordinate System |
out_call_points (可选) | 点要素类,其中包含无线网络提供商提供的估计呼叫位置。 | Feature Class |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CellPhoneRecordsToFeatureClass 函数。
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")
以下独立脚本演示了如何在脚本中使用 CellPhoneRecordsToFeatureClass 函数。
# 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)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是