Сводка
Импортирует записи сотовых телефонов от провайдеров беспроводной сети и связывает эти записи с классами объектов вышек сотовой связи и секторов, сгенерированными инструментом Записи сотовых вышек в класс объектов на основе полей идентификаторов.
Использование
Значения параметра Входные точки сотовых вышек должны быть созданы инструментом Записи сотовых вышек в класс объектов.
Параметры Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов будут содержать только телефонные записи, которые были успешно связаны с входной вышкой и секторами на основе соответствующих полей идентификатора. Значения параметров Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов не соответствуют актуальному местоположению сотового телефона.
Поставщики беспроводных сетей предоставляют записи о сотовых телефонах или записи о вызовах (CDR) в различных форматах и стилях. Нередко данные получают в нетабличном формате или в виде схемы. Значение параметра Входная таблица записей телефона должно быть таблицей с именами столбцов вверху.
Таблица, предоставленная поставщиком беспроводной сети, может содержать CDR и информацию о сотовой вышке в одной строке. Если таблица структурирована таким образом, она должна быть разделена на две. Используйте таблицу, содержащую информацию о вызове (идентификаторы, номера телефонов, даты, время, продолжительность вызова и координаты) в качестве входных данных для этого инструмента.
В выходных классах объектов для каждой записи (вызов или событие данных) параметра Входная таблица телефонных записей создается объект.
К выходному классу объектов будут добавлены следующие поля,:
- SUBSCRIBER - номер телефона подписчика в параметре Входная таблица телефонных записей. Все нечисловые символы будут удалены из входных данных.
- UNIQUEID - уникальный идентификатор антенн секторов сотовых вышек.
Следующие поля будут добавлены к выходному классу при использовании заданного параметра:
- DESTPHONE - номер телефона вызываемого абонента в параметре Входная таблица телефонных записей. Добавляется к выходным данным при использовании параметра Целевое поле номера телефона. Из выходных данных удаляются все нечисловые символы.
- STARTTIME - поле начальной даты и времени в параметре Входная таблица телефонных записей. Добавляется к выходным данным при использовании параметра Поле начальной даты и времени.
- DURATION - продолжительность звонка в секундах в параметре Входная таблица телефонных записей. Значения длительности в формате HH:MM:SS будут конвертированы в общее число секунд. Добавляется к выходным данным при использовании параметра Поле длительности либо двух параметров: Поле начальной даты и времени и Поле конечной даты и времени.
- ENDTIME - поле конечной даты и времени в параметре Входная таблица телефонных записей. Добавляется к выходным данным при использовании параметра Поле конечной даты и времени либо двух параметров: Поле начальной даты и времени и Длительность
Таблица, предоставляемая поставщиком беспроводной сети, может включать в себя информационную таблицу сотовой площадки с одним полем уникального идентификатора для определения всех уникальных записей или комбинацию полей идентификатора для определения уникальных записей в таблице. Например, таблица может содержать поля идентификатора площадки и идентификатора сектора для однозначного определения некоторых записей, но другие записи в таблице однозначно определяются с помощью полей идентификатора кода области расположения и идентификатора ячейки.
- Когда есть только одно поле уникального идентификатора для входной таблицы, установите значение Тип идентификатора как Уникальный идентификатор для параметра Поля идентификатора сектора ячейки или Дополнительные поля идентификатора сектора ячейки и для того же параметра, заполните опцию Поле с помощью поля, представляющего уникальный идентификатор.
- Если для таблицы предусмотрено много полей идентификаторов, указывающих на уникальность, то все поля идентификаторов должны быть добавлены в выходные данные. Для каждого поля идентификатора выберите Тип идентификатора, который определяет тип идентификатора в параметре Поля идентификатора сектора ячейки или Дополнительные поля идентификатора сектора ячейки, и в том же параметре заполните параметр Поле с помощью соответствующего поля, содержащего информацию об идентификаторе. Инструмент объединит эти поля идентификаторов и заполнит одно уникальное поле идентификатора в выходных классах объектов под названием UNIQUEID.
В выходные данные будут добавлены следующие поля, если они заданы в параметрах Поля ID сектора сотовой сети или Дополнительные поля ID сектора сотовой сети:
- SITEID— Уникальный идентификатор сотовой площадки
- SECTORID— Уникальный идентификатор сотового сектора
- SWITCHID— Уникальный идентификатор коммутатора беспроводной сети
- LACID— Уникальный идентификатор кода области расположения
- CASCADEID— Уникальный идентификатор каскада беспроводной сети
- CELLID— Уникальный идентификатор сектора внутри кода области расположения
Если входная таблица записей телефонов содержит записи вызовов, которые охватывают несколько секторов сотовой сети, должны быть заполнены оба параметра: Поля ID сектора сотовой сетии Дополнительные поля ID сектора сотовой сети. Параметр Поля ID сектора сотовой сети должен содержать идентификаторы, связанные с начальным сектором, а параметр Дополнительные поля ID сектора сотовой сети должен содержать конечный сектор или любой сектор, отличный от начального сектора в записи вызова.
Если во входной таблице записей телефона содержатся записи о событиях данных или в записи вызова упоминается только один сектор, необходимо заполнить только параметр: Поля ID сектора сотовой сети.
При использовании параметра Дополнительные поля ID сектора сотовой сети генерируются следующее поле и значения:
- IDTYPE - поле, определяющее, является ли запись вызова основным или дополнительным сектором записи вызова.
- PRIMARY - значение, назначаемое, если запись мобильного телефона связана с сектором в начале вызова.
- ADDITIONAL - значение, назначаемое, когда запись сотового телефона связана с сектором в конце вызова или любым сектором во время вызова, отличным от сектора в начале вызова.
Если инструментом задается, что запись сотового телефона связана с одним и тем же сектором и в начале, и в конце вызова, отдельный объект для сектора сотовой связи, соответствующего концу вызова, не создается.
- IDTYPE - поле, определяющее, является ли запись вызова основным или дополнительным сектором записи вызова.
Выходные предполагаемые точки вызова будут содержать все связанные поля параметров Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов.
Следующие поля будут добавлены к параметру Выходные расчетные точки вызовов:
- PHONEX - расчетная координата x местоположения вызова, предоставленная поставщиком беспроводной сети.
- PHONEY - расчетная координата y местоположения вызова, предоставленная поставщиком беспроводной сети.
Если значение записи в поле SUBSCRIBER - null, оно будет проигнорировано и не будет импортировано в выходные классы объектов.
Если в полях 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})
Parameter | Объяснение | Тип данных |
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, если Входная таблица записей телефонов не содержит уникальных идентификаторов для всех антенн сотовых секторов.
Для Типа идентификатора доступны следующие опции:
| Value Table |
subscriber_field | Поле входной таблицы, которое содержит номер телефона или идентификатор подписчика. | Field |
destination_field (Дополнительный) | Поле входной таблицы, которое содержит номер телефона или идентификатор вызываемого абонента. | Field |
additional_id_fields [additional_id_fields,...] (Дополнительный) | Задает тип дополнительного поля уникальных 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)
Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да