Gtld common info: различия между версиями

Материал из GTL-wiki
Перейти к навигации Перейти к поиску
Метка: ручная отмена
Нет описания правки
Строка 17: Строка 17:
1 мкм = 120 дБ вибросмещения (0 дБ = 10-6 мкм)
1 мкм = 120 дБ вибросмещения (0 дБ = 10-6 мкм)
</pre>
</pre>
== Описание 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;

Версия от 14:34, 28 февраля 2026

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

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

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

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

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;