Gtld common info

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

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

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

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

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];
 *
 * // Перебор всех каналов и вывод данных в консоль
 * gtl.analog_inputs.forEach((value, channelIndex) => {
 *   console.log(`Канал ${channelIndex}: ${value} В`);
 * });
 *
 * @example
 * // Проверка количества доступных аналоговых входов
 * const numInputs = gtl.analog_inputs.length;
 * console.log(`Доступно аналоговых входов: ${numInputs}`);
 *
 *
 * @example
 * // Безопасное обращение к каналу с проверкой индекса
 * const targetChannel = 5;
 * if (targetChannel < gtl.analog_inputs.length) {
 *   const data = gtl.analog_inputs[targetChannel];
 *   console.log(`Данные с канала ${targetChannel}: ${data}`);
 * } else {
 *   console.error(`Канал ${targetChannel} недоступен. Максимум: ${gtl.analog_inputs.length - 1}`);
 * }
 *
 * @see {@link gtl} Основной объект системы.
 */
gtl.analog_inputs;