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