Документация Engee

RITM Spectrum Ex

Передача спектральных данных.

Тип: CFunction

Путь в библиотеке:

/RITM/RITM Plot/RITM Spectrum Ex

Описание

Для работы с блоком установите/обновите пакет поддержки блоков РИТМ.

Блок RITM Spectrum Ex предназначен для передачи спектральных данных из модели Engee на монитор КПМ «РИТМ». Блок позволяет отображать один или несколько спектров на одном графике.

В отличие от потокового графика, блок передает на монитор КПМ «РИТМ» целый кадр данных: массив частот и один или несколько массивов амплитуд.

Допущения и ограничения

  • Один блок создает один спектральный график на дашборде монитора КПМ «РИТМ».

  • На одном графике можно отображать до восьми спектров.

  • Первый вход freq задает значения по оси .

  • Входы ampl1, …, amplN задают значения спектров по оси .

  • Все входные векторы должны иметь одинаковую длину.

  • При изменении количества спектров автоматически изменяется количество входных портов блока.

  • При изменении параметра Количество точек спектра: изменяется ожидаемая размерность входных сигналов.

  • При значении расположения −1 график размещается на дашборде автоматически.

  • При включенном фиксированном диапазоне значения параметров Минимум Y: и Максимум Y: используются для задания вертикального диапазона графика.

Порты

Вход

# freq — значения по оси
вектор

Details

Вектор значений по оси : частоты, номера бинов или другие координаты спектра.

Размерность входных портов задается параметром Количество точек спектра:. Например, если для этого параметра установлено значение 1024, то входные порты имеют размерность (1024,); а если значение 2048, то — (2048,).

Размерности входного вектора freq и всех входных векторов amplN должны совпадать.

Типы данных

Float64

Поддержка комплексных чисел

Нет

# ampl1 — амплитуды спектра
вектор

Details

Вектор амплитуд спектра . Количество входных портов зависит от параметра Количество спектров:.

Размерность входных портов задается параметром Количество точек спектра:. Например, если для этого параметра установлено значение 1024, то входные порты имеют размерность (1024,); а если значение 2048, то — (2048,).

Размерности всех входных векторов amplN и входного вектора freq должны совпадать.

Типы данных

Float64

Поддержка комплексных чисел

Нет

Параметры

Основные параметры:

# Расположение графика на дашборде (-1 для автоматического расположения): — индекс позиции графика на дашборде

Details

Индекс позиции графика на дашборде монитора КПМ «РИТМ». Значение −1 включает автоматическое расположение.

Значение по умолчанию

-1

Имя для программного использования

m_plot_index

Настраиваемый

Нет

Вычисляемый

Да

# Название графика: — заголовок графика

Details

Заголовок графика, отображаемый на мониторе КПМ «РИТМ».

Значение по умолчанию

"Spectrum"

Имя для программного использования

m_title

Настраиваемый

Нет

Вычисляемый

Да

# Количество точек спектра: — количество точек в каждом входном векторе

Details

Количество точек в каждом входном векторе freq и amplN.

Значение по умолчанию

1024

Имя для программного использования

m_points_amount

Настраиваемый

Нет

Вычисляемый

Да

# Количество спектров: — количество спектров, отображаемых на одном графике
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Details

Количество спектров, отображаемых на одном графике. Допустимые значения: от 1 до 8.

Значения

1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Значение по умолчанию

1

Имя для программного использования

m_spectrum_count

Настраиваемый

Нет

Вычисляемый

Да

# Подпись оси X: — подпись горизонтальной оси

Details

Текстовая подпись горизонтальной оси.

Значение по умолчанию

"freq"

Имя для программного использования

m_x_label

Настраиваемый

Нет

Вычисляемый

Да

# Подпись оси Y: — подпись вертикальной оси

Details

Текстовая подпись вертикальной оси.

Значение по умолчанию

"ampl"

Имя для программного использования

m_y_label

Настраиваемый

Нет

Вычисляемый

Да

# Фиксировать диапазон Y: — включает или отключает фиксированный диапазон по оси
false | true

Details
Значения

false | true

Значение по умолчанию

false (выключено)

Имя для программного использования

m_fixed_y_range

Настраиваемый

Нет

Вычисляемый

Да

# Минимум Y: — минимальное значение оси

Details

Минимальное значение оси .

Зависимости

Чтобы использовать этот параметр, установите для параметра Фиксировать диапазон Y: значение true.

Значение по умолчанию

0.0

Имя для программного использования

m_fixed_y_min

Настраиваемый

Нет

Вычисляемый

Да

# Максимум Y: — максимальное значение оси

Details

Максимальное значение оси .

Зависимости

Чтобы использовать этот параметр, установите для параметра Фиксировать диапазон Y: значение true.

Значение по умолчанию

1.0

Имя для программного использования

m_fixed_y_max

Настраиваемый

Нет

Вычисляемый

Да

Спектр 1

# Подпись в легенде: — имя спектра

Details

Имя спектра, отображаемое в легенде графика.

Значение по умолчанию

"spectrum_1"

Имя для программного использования

m_spectrum_1_name

Настраиваемый

Нет

Вычисляемый

Да

# Толщина линии: — толщина линии спектра
Тонкая | Средняя | Толстая

Details
Значения

Тонкая | Средняя | Толстая

Значение по умолчанию

Тонкая

Имя для программного использования

m_spectrum_1_width

Настраиваемый

Нет

Вычисляемый

Да

# Цвет линии: — цвет линии спектра
Красный | Оранжевый | Зелёный | Бирюзовый | Голубой | Синий | Фиолетовый | Пурпурный

Details
Значения

Красный | Оранжевый | Зелёный | Бирюзовый | Голубой | Синий | Фиолетовый | Пурпурный

Значение по умолчанию

Синий

Имя для программного использования

m_spectrum_1_color

Настраиваемый

Нет

Вычисляемый

Да