Записи сотовых телефонов в класс пространственных объектов (Анализ преступности и безопасности)

Сводка

Импортирует записи сотовых телефонов от провайдеров беспроводной сети и связывает эти записи с классами объектов вышек сотовой связи и секторов, сгенерированными инструментом Записи сотовых вышек в класс объектов на основе полей идентификаторов.

Использование

  • Значения параметра Входные точки сотовых вышек должны быть созданы инструментом Записи сотовых вышек в класс объектов.

  • Параметры Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов будут содержать только телефонные записи, которые были успешно связаны с входной вышкой и секторами на основе соответствующих полей идентификатора. Значения параметров Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов не соответствуют актуальному местоположению сотового телефона.

  • Поставщики беспроводных сетей предоставляют записи о сотовых телефонах или записи о вызовах (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 - значение, назначаемое, когда запись сотового телефона связана с сектором в конце вызова или любым сектором во время вызова, отличным от сектора в начале вызова.

    Если инструментом задается, что запись сотового телефона связана с одним и тем же сектором и в начале, и в конце вызова, отдельный объект для сектора сотовой связи, соответствующего концу вызова, не создается.

  • Выходные предполагаемые точки вызова будут содержать все связанные поля параметров Выходные точки сотовых вышек записей сотовых телефонов и Выходные секторы сотовых вышек записей сотовых телефонов.

    Следующие поля будут добавлены к параметру Выходные расчетные точки вызовов:

    • 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, если Входная таблица записей телефонов не содержит уникальных идентификаторов для всех антенн сотовых секторов.

  • Тип идентификатора— имя поля, которое будет включено в выходные классы пространственных объектов.
  • Поле— имя полей, которые однозначно идентифицируют антенны сотового сектора. К выходному классу объектов будут добавлены следующие поля:

Для Типа идентификатора доступны следующие опции:

  • Уникальный ID— уникальный идентификатор антенны сотовой ячейки
  • ID базовой станции— уникальный идентификатор сотовой площадки
  • ID сектора— уникальный идентификатор сотового сектора
  • ID коммутатора— уникальный идентификатор коммутатора беспроводной сети
  • LAC ID— уникальный идентификатор кода области расположения
  • Идентификатор каскада— уникальный идентификатор каскада беспроводной сети
  • ID ячейки— идентификатор сектора внутри кода области расположения
Value Table
subscriber_field

Поле входной таблицы, которое содержит номер телефона или идентификатор подписчика.

Field
destination_field
(Дополнительный)

Поле входной таблицы, которое содержит номер телефона или идентификатор вызываемого абонента.

Field
additional_id_fields
[additional_id_fields,...]
(Дополнительный)

Задает тип дополнительного поля уникальных ID и поля, добавляемые к выходному объекту.

Используйте тип Уникальный ID, во Входной таблице записей телефонов есть уникальный идентификатор для всех антенн сотовых секторов. Используйте комбинацию других значений Типа ID, если Входная таблица записей телефонов не содержит уникальных идентификаторов для всех антенн сотовых секторов.

  • Тип идентификатора— имя поля, которое будет включено в выходные классы пространственных объектов.
  • Поле— имя полей, которые однозначно идентифицируют антенны сотового сектора. К выходному классу объектов будут добавлены следующие поля:

Для Типа идентификатора доступны следующие опции:

  • Уникальный ID— уникальный идентификатор антенны сотовой ячейки
  • ID базовой станции— уникальный идентификатор сотовой площадки
  • ID сектора— уникальный идентификатор сотового сектора
  • ID коммутатора— уникальный идентификатор коммутатора беспроводной сети
  • LAC ID— уникальный идентификатор кода области расположения
  • Идентификатор каскада— уникальный идентификатор каскада беспроводной сети
  • ID ячейки— идентификатор сектора внутри кода области расположения
Value Table
start_time_field
(Дополнительный)

Поле входной таблицы, содержащее дату и время начала телефонного звонка или события данных.

Field
duration_field
(Дополнительный)

Поле входной таблицы, содержащее длительность телефонного звонка в секундах.

Field
end_time_field
(Дополнительный)

Поле таблицы, содержащее дату и время окончания телефонного звонка или события данных.

Field
convert_utc
(Дополнительный)

Определяет, будут ли начальная и конечная дата и время входных записей конвертированы во локальный часовой пояс или останутся в формате всемирного координированного времени (UTC).

  • CONVERTДата и время начала и окончания входных записей будут преобразованы из формата UTC в локальный часовой пояс.
  • NO_CONVERTДата и время начала и окончания входных записей преобразованы не будут. Это значение по умолчанию.
Boolean
location_x_field
(Дополнительный)

Поле во входной таблице, которое содержит x-координату предполагаемого местоположения телефона, предоставленного поставщиком беспроводной сети.

Field
location_y_field
(Дополнительный)

Поле во входной таблице, которое содержит y-координату предполагаемого местоположения телефона, предоставленного поставщиком беспроводной сети.

Field
location_coordinate_system
(Дополнительный)

Система координат предполагаемого местоположения телефона (координаты x и y). Система координат по умолчанию - WGS84.

Coordinate System
out_call_points
(Дополнительный)

Класс точечных объектов, содержащий приблизительные места совершения телефонных звонков, предоставленные поставщиком беспроводной сети.

Feature Class

Пример кода

CellPhoneRecordsToFeatureClass, пример 1 (окно Python)

Пример скрипта окна 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, пример 2 (автономное окно)

Автономный скрипт – пример использования функции 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: Да

Связанные разделы