Документация 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

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

Нет

Вычисляемый

Да