Gtld common info

Материал из GTL-wiki
Версия от 14:45, 28 февраля 2026; AlekseyCube (обсуждение | вклад) (→‎Описание JSDoc)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Краткое описание

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

Источник сигнала вибрации

Источником сигнала вибрации является массив аналоговых входов, позволяющий принимать данные из определенных каналов АЦП, и передавать их в другие объекты. На выходе получаем поток данных оцифрованного сигнала вибрации.

gtl.analog_inputs[i]
i - индекс аналогового входа (выходить индексом за пределы доступных аналоговых входов не рекомендуется)

Количество доступных аналоговых входов можно проверить следующим образом:

gtl.analog_inputs.length;

Если требуется представить результаты измерения спектров вибрации в относительных единицах (дБ), то необходимо установить соответствующее опорное значение (на примере входа с нулевым индексом):

gtl.analog_inputs[0].reference = 1e-6;
1 м/c2 = 120 дБ виброускорения (0 дБ = 10-6 м/с2)
1 мм/c = 120 дБ виброскорости (0 дБ = 10-6 мм/с)
1 мкм = 120 дБ вибросмещения (0 дБ = 10-6 мкм)

Описание JSDoc

/**
 * Массив аналоговых входов (`analog_inputs`) объекта `gtl` служит источником
 * данных о вибрации. Он принимает сигналы с заданных каналов
 * аналого‑цифрового преобразователя (АЦП) и предоставляет
 * в виде числового массива для дальнейшей обработки.
 *
 * Индекс элемента массива (`i`) напрямую
 * соответствует номеру канала АЦП (например, `gtl.analog_inputs[0]` —
 * данные с первого канала).
 *
 * Количество доступных аналоговых входов (т.е. общее число каналов АЦП,
 * из которых можно получать данные) определяется свойством `length`:
 * `gtl.analog_inputs.length`. Это стандартное свойство массива JavaScript,
 * возвращающее число элементов в массиве.
 *
 * @type {Array<number>}
 *   Массив числовых значений. Длина массива определяется количеством
 *   настроенных каналов АЦП.
 *
 * @property {number} length
 *   Количество доступных аналоговых входов (число каналов АЦП).
 *   Используется для:
 *   - проверки общего числа доступных каналов;
 *   - организации циклов перебора всех каналов;
 *   - валидации индекса `i` перед обращением к `gtl.analog_inputs[i]`.
 *
 * @example
 * // Получение данных с третьего канала АЦП
 * const vibrationData = gtl.analog_inputs[2];
 *
 *
 * @example
 * // Проверка количества доступных аналоговых входов
 * const numInputs = gtl.analog_inputs.length;
 * gtl.log.info("Доступно аналоговых входов:", numInputs);
 *
 *
 * @see {@link gtl} Основной объект системы.
 */
gtl.analog_inputs;