Сбор данных из внешних источников и внутренних сенсоров с помощью NextGIS Logger

Эта страница является черновиком статьи.

Описание инструмента для сбора данных с сенсоров мобильного устройства.

NextGIS Logger - сборщик данных с окружающих источников информации и внутренних сенсоров для устройств с операционной системой Android 3.0+ (Honeycomb).

NextGIS Logger может собирать данные в двух режимах:

• Логгер - собирает данные постоянно и сохраняет их в Логе 1. Это сервис.
• Метки - собирает данные дискретно, по запросу пользователя и сохраняет их в Логе 2.

Приложение может работать в двух режимах по-отдельности или параллельно. Данные логов связаны друг с другом временными метками.

Создано в

Веб ГИС для вашей организации по доступной цене

Где взять

Программу можно скачать с Google Play (предпочтительный способ) или в виде APK (скачать). Если вы устанавливаете из APK, нужно разрешить установку из "Unknown sources" в настройках системы, секция "Security". Официальная страница программы - на сайте разработчика - NextGIS.

NextGIS Logger это программное обеспечение с открытым исходным кодом. Лицензия - GPL v2. Код можно получить на Github.

Интерфейс и использование

После установки найдите иконку приложения в списке программ.

В приложении 4 основных экрана:

Основной экран

• Сессии
  • Кнопка "Открыть/Закрыть" - открывают новую или закрывают открытую сессию и сохраняют все данные. Для каждой сессии создается папка с набором файлов на диске. Текущая сессия не может быть быть закрыта пока не остановлен логгер.
• Режимы
  • Кнопка "Запустить логгер/Остановить логгер" - запускает или останавливает запись лога 1. Пока не создана сессия логгер запустить нельзя.
  • Кнопка "Метки" - открывает окно с перечнем маркеров. Пока не создана сессия маркеры ставить нельзя.
• Текстовые поля показывающие полезную информацию о сессии.

Основной экран приложения

Метки

Метки - это такие же точки лога, но расставляемые не автоматически, а когда скажет пользователь, так же им можно задавать свои имена. Список маркеров может быть пустой или его можно заполнить указав в настройках приложения файл с маркерами с очень простой структурой:

ID,NAME
1,marker1
2,marker2
3,marker3

Расставленные метки попадают в свой собственный лог.

На экране меток можно:

• ввести любое имя и создать метку с таким именем
• вводить часть имени метки в поле поиска и список маркеров автоматически отфильтруется по введенной строке.
• выбирать найденные метки, чтобы они попали в лог
• в течение 4 секунд отменять поставленные метки

Метки

=Сессии

Что бы ограничить один лог от другого используются сессии.

Сессия можно управлять на экране сессий. На нем можно:

• Увидеть список сессий записанных на устройстве
• Выбрать все сессии
• Поделиться выбранными сессиями стандартными методами (Dropbox, Gmail и т.д.)
• Удалить выбранные сессии

Сессии

Данные в реальном времени

Все собранные данные попадают в лог, предназначенный для чтения машинами. Вы же можете ознакомиться с данными непосредственно в процессе их сбора переключившись в режим просмотра данных в реальном времени (Live data). Чтобы переключиться нужно нажать на FAB, круглую кнопку в нижнем правом углу экрана.

Данные собраны в два экрана: всё по базовым станциям сотовой сети и данные по сенсорам (включая GPS).

Данные по базовым станциям

Данные по сенсорам

Настройки

Вам наверняка нужно собирать что-то конкретное и список меток у вас свой, всё это можно настроить.

• Основные настройки:
  • Строка идентификации - здесь можно указать имя или инициалы или что-то еще, эта строка будет использоваться для названия сессий и для точек лога
  • Период сбора информации в секундах (от 1 секунды)
  • Использование файла меток - здесь можно указать файл с метками (он создается отдельно), если его не указать, можно вводить названия меток в процессе сбора данных.
  • Пытаться использовать API 17+ для поиска соседних базовых станций.
  • Держать экран включенным - для списка меток.

• Сенсоры:
  • Акселерометр - включить в лог данные с акселерометра
  • Линейный акселерометр - использовать линейный акселерометр (если он есть)
  • Магнетометр - включить в лог данные с магнетометра
  • Ориентация - писать лог ориентации
  • Гироскоп - включить в лог данные с гироскопа

Результаты

Логи сессий сохраняются каждый в свою папку, имя которых запрашивается при старте сессии. Все папки сессий хранятся на внешнем носителе в папке "nextgis_logger".

Логгер создаёт файл "cell_time_log.csv" где сохраняется информация с базовых станций GSM/3G и "sensor_time_log.csv", где хранятся данные с сенсоров.

Аналогично, метки сохраняются в файл "cell_time_mark.csv" где сохраняется информация с базовых станций GSM/3G и "sensor_time_mark.csv", где хранятся данные с сенсоров.

Структура данных

Базовые станции

• ID - идентификатор из файла меток ([еще](https://github.com/nextgis/gsm_logger/issues/3)). Логгер в качестве ID использует пустую строку "".
• Name - имя метки из файла меток ([еще](https://github.com/nextgis/gsm_logger/issues/3)) или введенное вручную. Логгер в качестве имени использует строку "ServiceLog".
• User - строка идентификации пользователя из настроек ([еще](https://github.com/nextgis/gsm_logger/issues/6)).
• TimeStamp - временная метка (можно сконвертировать в привычное время этим [инструментом](http://www.epochconverter.com)). Не уникальна. Пример: 1409513090236
• NetworkGen - текущее поколениеи сети (2G/3G/4G) ([еще](https://en.wikipedia.org/wiki/History_of_mobile_phones))
• NetworkType - текущий тип сети (EDGE/GPRS/UMTS/HSPA...)
• Active - 1 если это базовая станция, иначе - комбинация MCC-MNC-LAC-CID активной базовой станции если это станция-сосед.
• MCC - Mobile Country Code ([еще](http://en.wikipedia.org/wiki/Mobile_country_code)). Пример: 284
• MNC - Mobile Network Code ([еще](http://en.wikipedia.org/wiki/Mobile_country_code)). Пример: 5
• LAC - Location Area Code ([еще](http://en.wikipedia.org/wiki/Mobility_management#Location_area)). Пример: 380433
• CID - Cell ID ([еще](http://en.wikipedia.org/wiki/Cell_ID)). Пример: 5599
• PSC - Primary Scrambling Code для сети 3G. Диапазон значений: 0..511. Пример: 145
• Power - сила сигнала - [RSSI](http://en.wikipedia.org/wiki/Received_signal_strength_indication) для 2G и [RSCP](http://en.wikipedia.org/wiki/Received_signal_code_power) для 3G. Пример: -93

Сенсоры

• ID - см. аналогично выше
• Name - см. аналогично выше
• User - см. аналогично выше
• TimeStamp - см. аналогично выше
• Type - "Raw" если используется просто акселерометр, "Linear" если акселерометр линейный
• Accel_X - ускорение по оси X в м/с^2
• Accel_Y - ускорение по оси Y в м/с^2
• Accel_Z - ускорение по оси Z в м/с^2
• Azimuth - угол между направлением на магнитный полюс и осью Y, вокруг оси Z (0..359). 0=Север, 90=Восток, 180=Юг, 270=Запад
• Pitch - вращение по оси X (-180..180), значения положительные когда ось Z движется по направлнию к оси Y.
• Roll - вращение по оси Y (-90..90) возрастает по мере движения устройства по часовой стрелке
• Magnetic - measure the ambient magnetic field in the X, Y and Z axis. Value in micro-Tesla (uT).
• Gyro_X - Angular speed around the X-axis in radians/second
• Gyro_Y - Angular speed around the Y-axis in radians/second
• Gyro_Z - Angular speed around the Z-axis in radians/second
• GPS_Lat - Latitude, in degrees
• GPS_Lon - Longitude, in degrees
• GPS_Alt - Altitude above the WGS 84 reference ellipsoid, in meters
• GPS_Accuracy - GPS fix accuracy as the radius of 68% confidence, in meters
• GPS_Speed - Speed, in meters/second
• GPS_Bearing - Bearing is the horizontal direction of travel of this device, and is not related to the device orientation, in degrees.

Информация об устройстве

При открытии сессии создаётся файл "device_info.txt", он содержит информацию об устройстве.

• Manufacturer
• Brand
• Model
• Product
• Android version
• API version
• Kernel version
• Radio firmware version
• Logger version name
• Logger version code

Контакты

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