Сервис спектрометра

Сервис спектрометра service_spectrometer является стандартным приложением для сбора данных в МР-консоли. Данный сервис реализован через REST API, используя библиотеку Django. Сервис проводит последовательный запуск компонентов и выгрузку данных в соответствии с указанными в http-запросе параметрами. Запрос можно сформировать вручную через командную строку либо через браузер, пользуясь API VIEW по URL localhost:8000/api. Перед началом работы необходимо авторизироваться в админ-панели по URL localhost:8000/admin. Если работаете через curl в запросе надо передавать данные для авторизации.

API предусматривает post/get-методы списка используемых устройств, post-метод запуска сбора с заданными параметрами, get-методы состояния сбора, параметров сбора и собранных данных.

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

1. Отдельные URLPATH в каталоге api (mstate, mparams, mdata)

2. Вызов через URLPATH api/measurement/<id>/<state/info/data>

Через URLPATH measurement также реализован post-запрос запуска консоли. Для начала сбора пользователь должен передать сервису следующие параметры:

1. Параметры осциллографа (device model, sample rate, points=[...], channels, ranges=[...], ntriggers, averaging, trigger channel, threshold, direction, automeasure time, enabled)

Значения ranges и direction указаны в ps4000aApi.h. Threshold и automeasure time ограничены 2 байтами.

1. Параметры синхронизатора (device model, file, port)

2. Параметры SDR (device model, sample rate, freq, ampl, gain, file)

3. Параметры ГРУ (device model, ip, file, enabled)|

4. Другие параметры (engine, infostr)

Шаблон json-тела запроса приведен в директории сервиса.

Сбор и анализ данных

Сбор данных начинается после отправки get-запроса по URL api/measurement. Состояние измерения сохраняется в state-объекте. Получить доступ к состоянию можно по URL api/measurement/<id>/state. В состоянии описан статус и retcode для каждого компонента. Если все компоненты отработали правильно в состоянии выставляется флаг data_ready, после чего разрешается читать записанные данные.

Данные запрашиваются get-запросом по URL api/measurement/<id>/data. По умолочанию присылаются все записи (все каналы по каждому триггеру и повторению для усреднения), закодированные в строку Base64. Можно запросить конкретную запись через inline-параметры запроса: data_num и averaging_num. К примеру: api/measurement/<id>/data/?data_num=1&averaging_num=5.

Первичная обработка данных

В директории сервиса приложен Python-скрипт с классом декодера данных из json-ответа от сервера. Пользователь должен выгрузить ответ сервера в файл после чего загрузить его в объект класса декодера. Класс декодера реализует следующие методы:

1. Запрос сырых данных getRawData(channel_num, data_num, averaging_num)
2. Запрос декодированных данных getDataDecoded(channel_num, data_num, averaging_num, points)
3. Запрос отмасштабированных данных в соответсвии с максимальной амплитудой канала getDataScaled(channel_num, data_num, averaging_num, points, channel_range)

4. Запрос спектра getDataSpectrum(channel_num, data_num, averaging_num, points, channel_range, zero_fill). Возвращает dictionary вида ():

   {
   "spectrum": np.array(float) # амплитуды y-ось
   "freqs": np.array(float) # частоты x-ось
   "phases": np.array(float) # фазы
   }
   

Инструкция по запуску

Запуск производится через bat-файлы приложенные к сервису:

1. autorun_default_venv - создать виртуальное окружение Python, установить зависимости и запустить сервис
2. autorun_default - установить зависимости и запустить сервис
3. autorun_defult_simple - запустить сервер, без установки зависимостей

Остановка сервиса выполняется через autokill.bat.