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

Scope

Блок не рекомендован для использования.

Отображение сигналов, сгенерированных во время моделирования.

scope

Описание

Блок Scope (Осциллограф) отображает сигналы во временной области.

Осциллограф оптимизирован для общего моделирования во временной области.

Особенности осциллографа:

  • Триггеры — установите триггеры для синхронизации повторяющихся сигналов и приостановки отображения при возникновении событий.

  • Cursor Measurements — измерьте значения сигнала с помощью вертикальных и горизонтальных курсоров.

  • Signal Statistics — отобразите максимум, минимум, разность между пиками, среднее значение, медиану и среднеквадратичное значение выбранного сигнала.

  • Peak Finder — найдите максимумы, показывая значения по оси X, в которых они происходят.

  • Двухуровневые измерения — измерьте переходы, выбросы, провалы и циклы.

Особенности отображения объема:

  • Управление симуляцией — отладьте модели из окна Scope с помощью кнопок Run, Step Forward и Step Backward на панели инструментов.

  • Multiple signal — постройте несколько сигналов на той же оси Y (отображение), используя несколько входных портов.

  • Multiple y-axes (displays) — отобразите несколько осей Y. Все оси Y имеют общий временной диапазон по оси X.

  • Modify parameters — измените значения параметров осциллографа до и во время симуляции.

  • Axis autoscaling — автомасштабирование осей во время или в конце симуляции. Поля рисуются вверху и внизу осей.

  • Отобразите данные после симуляции — данные Scope сохраняются во время симуляции. Если осциллограф закрыт в начале симуляции, когда вы открываете осциллограф после симуляции, осциллограф отображает результаты симуляции для присоединенных входных сигналов.

Если у вас высокая частота дискретизации или длительное время моделирования, вы можете столкнуться с проблемами с памятью или производительностью системы, поскольку осциллограф сохраняет данные внутри. Чтобы ограничить объем данных, сохраняемых для визуализации области, используйте свойство Limit data points to last.

Ограничения

  • Не используйте блоки области действия в библиотеке. Если вы помещаете блок области внутри блока библиотеки с заблокированной ссылкой или в заблокированной библиотеке, будет отображена ошибка при попытке открыть окно области. Чтобы отобразить внутренние данные из библиотечного блока, добавьте выходной порт в библиотечный блок, а затем соедините порт с блоком Scope в вашей модели.

  • При пошаговом прохождении модели область видимости обновляется только при запуске блока области видимости. Это означает, что время, отображаемое в строке состояния, может не совпадать с модельным временем.

  • При подключении к постоянному сигналу блок осциллографа может отображать одну точку.

  • Осциллограф показывает промежутки на дисплее, когда значение сигнала равно NaN.

  • Когда вы визуализируете несколько сигналов на основе кадров в осциллографе, некоторые выборки сигналов с размером кадра 1 могут не отображаться. Чтобы визуализировать эти сигналы, переместите сигналы с размером кадра 1 в отдельную область видимости.

  • Дисплеи осциллографа имеют ограничения в режиме Rapid Accelerator.

  • Когда Scope находится в подсистеме ForEach, в области отображается только последний индекс.

Порты

Вход

Port_1 — сигнал или сигналы для визуализации
скаляр | вектор | матрица | массив | bus | nonvirtual bus

Подключите сигналы, которые вы хотите визуализировать. Можно задействовать до 96 входных портов. Входные сигналы могут иметь следующие характеристики:

  • Тип — непрерывный (на основе выборки) или дискретный (на основе выборки и кадра).

  • Тип данных — любой тип данных, который поддерживается.

  • Размерность — скалярная, одномерная (вектор), двухмерная (матрица) или многомерная (массив). Отображение нескольких каналов в одном сигнале в зависимости от размерности.

Ограничения ввода

  • Когда вход представляет постоянный сигнал, осциллограф строит одну точку.

  • Осциллограф показывает промежутки на дисплее, когда значение сигнала равно NaN.

  • Когда вы визуализируете несколько сигналов на основе кадров в осциллографе, некоторые выборки сигналов с размером кадра 1 могут не отображаться. Чтобы визуализировать эти сигналы, переместите сигналы с размером кадра 1 в отдельную область видимости.

Поддержка шины

К осциллографу можно подключить невиртуальную шину и массивы сигналов шины. Чтобы отобразить сигналы шины, используйте нормальный режим или режим симуляции акселератора. Осциллограф отображает сигнал каждого элемента шины в том порядке, в котором элементы появляются на шине, сверху вниз. Вложенные элементы шины выравниваются.

Чтобы регистрировать невиртуальные сигналы шины с областью действия, установите для параметра Save format значение Dataset. Вы можете использовать любой формат сохранения для регистрации сигналов виртуальной шины.

Типы данных: Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128, Fixed

Характеристики

Свойства конфигурации

Main

Open at simulation start — укажите, когда окно Scope открывается
выключено (по умолчанию для Scope) | включено

Установите этот флажок, чтобы открыть окно осциллографа при запуске моделирования.

Display the full path — отображать путь к блоку в строке заголовка
выключено (по умолчанию) | включено

Установите этот флажок, чтобы помимо имени блока отображать путь к блоку.

Number of input ports — количество входных портов в блоке области видимости
1 (по умолчанию) | целое число

Задайте количество входных портов в блоке Scope в виде целого числа. Максимальное количество входных портов 96.

Layout — количество и расположение дисплеев
1 на 1 (по умолчанию) | расположение по осям m на n

Укажите количество и расположение дисплеев. Максимальный макет — 16 строк на 16 столбцов.

Если количество дисплеев равно количеству портов, сигналы от каждого порта появляются на отдельных дисплеях. Если количество дисплеев меньше количества портов, на последнем дисплее появляются сигналы от дополнительных портов. Для макетов с несколькими столбцами и строками порты отображаются вниз, а затем поперек.

Sample time — интервал между шагами расчета
−1 (по умолчанию) | скаляр

Укажите интервал между шагами расчета как неотрицательное число. Чтобы наследовать шаг расчета, установите для этого параметра значение −1.

Input processing — метод обработки сигнала
Elements as channels (sample based) (по умолчанию) | Columns as channels (frame based)
  • Elements as channels (sample based) — блок обрабатывает каждый элемент как уникальный образец.

  • Columns as channels (frame based) — блок обрабатывает значения сигнала в канале как группу значений из нескольких временных интервалов. Фреймовая обработка доступна только для дискретных входных сигналов.

Maximize axes — максимальный размер графиков
выключено (по умолчанию) | Auto | включено
  • Auto — если свойства Заголовок и Y-метка не указаны, максимизировать все графики.

  • включено — максимизируйте все участки. Значения в заголовке и Y-метке скрыты.

  • выключено — не максимизируйте участки.

Время

Time span — длина оси X для отображения
Auto (по умолчанию) | User defined | One frame period
  • Auto — разница между временем начала и окончания симуляции.

    Блок вычисляет начальное и конечное время временного диапазона, используя свойства Time display offset и Time span. Например, если для параметра Time display offset установлено значение 10, а для параметра Time span — значение 20, диапазон устанавливает временной диапазон от 10 до 30.

  • User defined — введите любое значение меньше, чем общее время моделирования.

  • One frame period — используйте период кадра входного сигнала для блока Time Scope. Этот параметр доступен только в том случае, если для параметра Input processing установлено значение Columns as channels (frame based).

Time span overrun action — отобразить данные за пределами видимой оси X
Wrap (по умолчанию) | Scroll

Укажите, как отображать данные за пределами видимого диапазона оси X.

Эффект от этой опции можно увидеть только при медленном построении больших моделей или малых размеров шага.

  • Wrap — нарисуйте полный экран данных слева направо, очистите экран, а затем перезапустите рисование данных слева.

  • Scroll — переместите данные влево, так как новые данные рисуются справа. Этот режим интенсивно использует графику и может повлиять на производительность во время выполнения.

Time units — Единицы оси X
None (по умолчанию) | Metric | Seconds
  • Metric — отображение единиц времени на основе длины интервала времени.

  • Seconds — отображение времени в секундах.

  • None — не отображать единицы времени.

Time display offset — смещение по оси X
0 (по умолчанию) | скаляр | вектор

Сместите ось X на указанное значение времени в виде действительного числа или вектора действительных чисел.

Для входных сигналов с несколькими каналами можно ввести скаляр или вектор:

  • Scalar — сместите все каналы входного сигнала на одно и то же значение времени.

  • Вектор — независимое смещение каналов.

Time-axis labels — отображение меток оси X
Bottom Displays Only (по умолчанию) | All | None

Укажите, как отображаются метки оси X (время):

  • All — отобразите метки оси X на всех осях Y.

  • None — не отображать метки. При выборе None также снимается флажок Show time-axis label.

  • Bottom displays only — отобразите метку оси X на нижней оси Y.

Зависимости

Чтобы использовать это свойство, установите:

  • Show time-axis label для включения.

  • Maximize axes в выключенное положение.

Свойство Active display определяет, на какой дисплей воздействовать.

Show time-axis label — отображать или скрывать метки оси X
выключено (по умолчанию) | включено

Установите этот флажок, чтобы отобразить метку оси X для активного дисплея.

Зависимости

Чтобы использовать это свойство, задайте для меток оси времени значение All или Bottom Displays Only.

Свойство Active display определяет, на какой дисплей воздействовать.

Отображать

Active display — выбранный дисплей
1 (по умолчанию) | положительное число

Выбранный дисплей. Используйте это свойство, чтобы контролировать, какое отображение изменяется при изменении свойств стиля и свойств, специфичных для осей.

Укажите желаемое отображение, используя положительное целое число, которое соответствует индексу размещения по столбцам. Для макетов с несколькими столбцами и строками отображаемые номера отображаются вниз, а затем поперек.

Title — отображаемое имя
%<SignalLabel> (по умолчанию) | string

Название для дисплея. Значение по умолчанию %<SignalLabel> использует имя входного сигнала для заголовка.

Зависимости

Свойство Active display определяет, на какой дисплей воздействовать.

Show legend — отображать легенду сигнала
выключено (по умолчанию) | включено

Переключить легенду сигнала. Имена, перечисленные в легенде, являются именами сигналов из модели. Для сигналов с несколькими каналами индекс канала добавляется после имени сигнала. Непрерывные сигналы имеют прямые линии перед их именами, а дискретные сигналы имеют ступенчатые линии.

Из легенды вы можете управлять видимыми сигналами. Этот элемент управления эквивалентен изменению видимости в свойствах стиля. В легенде осциллографа щелкните имя сигнала, чтобы скрыть сигнал в осциллографе. Чтобы отобразить сигнал, щелкните имя сигнала еще раз. Чтобы показать только один сигнал, щелкните правой кнопкой мыши имя сигнала, которое скрывает все остальные сигналы. Чтобы показать все сигналы, нажмите Esc.

Легенда показывает только первые 20 сигналов. Никакими дополнительными сигналами нельзя управлять из легенды.

Зависимости

Свойство Active display определяет, на какой дисплей воздействовать.

Show grid — показать внутренние линии сетки
включено (по умолчанию) | выключено

Установите этот флажок, чтобы показать линии сетки.

Зависимости

Свойство Active display определяет, на какой дисплей воздействовать.

Plot signals as magnitude and phase — разделить отображение на графики амплитуды и фазы
выключено (по умолчанию) | включено
  • включено — отобразите графики амплитуды и фазы. Если сигнал действительный, строит абсолютное значение сигнала для величины. Фаза составляет 0 градусов для положительных значений и 180 градусов для отрицательных значений. Эта функция полезна для входных сигналов с комплексным знаком. Если вход является сигналом с действительным знаком, установка этого флажка возвращает абсолютное значение сигнала для величины.

  • выключено — отобразите график сигнала. Если сигнал комплексный, наносит действительную и мнимую части на одну и ту же ось Y.

Зависимости

Свойство Active display определяет, на какой дисплей воздействовать.

Y-limits (Minimum) — минимальное значение оси Y
-10 (по умолчанию) | действительный скаляр

Задайте минимальное значение оси Y как действительное число.

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

Да

Зависимости

Если вы выбираете Plot signal as value and Phase, это свойство применяется только к графику величины. Пределы оси Y фазового графика всегда равны [−180 180].

Свойство Active display определяет, на какой дисплей воздействовать.

Y-limits (Maximum) — максимальное значение оси Y
10 (по умолчанию) | действительный скаляр

Задайте максимальное значение оси Y как действительное число.

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

Да

Зависимости

Если вы выбираете Plot signal as value and Phase, это свойство применяется только к графику величины. Пределы оси Y фазового графика всегда равны [−180 180].

Свойство Active display определяет, на какой дисплей воздействовать.

Y-label — метка оси Y
отсутствует (по умолчанию) | Amplitude | string

Укажите текст для отображения по оси Y. Чтобы отобразить единицы сигнала, добавьте %<SignalUnits> к метке. В начале симуляции %SignalUnits заменяет единицы, связанные с сигналами.

Зависимости

Если вы выбираете Plot signal as value and Phase, это свойство не применяется. Y-оси помечены Magnitude и Phase.

Свойство Active display определяет, на какой дисплей воздействовать.

Запись сигналов

Limit data points to last — ограничить значения буферизованных данных
выключено и 5000 (по умолчанию) | включено | положительное число

Ограничьте данные, сохраняемые областью внутри. По умолчанию все точки данных сохраняются, чтобы вы могли просмотреть визуализацию осциллографа после завершения моделирования. Для симуляций с установленным Stop time на inf, рассмотрите возможность выбора Limit data points to last.

Если вы не выберете Limit data points to last и у вас высокая частота дискретизации или длительное время моделирования, вы можете столкнуться с проблемами с памятью или производительностью системы.

При выборе этого свойства область сохраняет последние n точек данных, где n — указанное количество точек данных.

  • выключено — сохраните и постройте все значения данных.

  • включено — сохраните заданное количество значений данных для каждого сигнала. Если сигнал основан на кадрах, количество буферизованных значений данных равно заданному количеству значений данных, умноженному на размер кадра.

В некоторых случаях выбор этого свойства может привести к отображению сигналов менее чем за весь временной диапазон симуляции (например, если время расчета мало). Если осциллограф отображает часть ваших сигналов, рассмотрите возможность увеличения количества сохраняемых точек данных.

Зависимости

Это свойство ограничивает значения данных, отображаемые в осциллографе, и значения данных, сохраненные в переменной, заданной в Variable name.

Decimation — уменьшить количество данных осциллографа для отображения и сохранения
2 (по умолчанию) | включено | положительное число
  • включено — нанесите на график и зарегистрируйте (сохраните) данные области видимости для каждой N точки данных, где N — коэффициент прореживания введенный в текстовое поле. Значение 1 буферизует все значения данных.

  • выключено — сохранить все значения данных осциллографа.

Зависимости

Чтобы использовать это свойство, установите флажок Log data to workspace

Это свойство ограничивает значения данных, отображаемые в осциллографе, и значения данных, сохраненные в переменной, заданной в Variable name.

Log data to workspace — сохранение данных в рабочее пространство
выключено (по умолчанию) | включено

Установите этот флажок, чтобы включить ведение журнала и активировать свойства Variable name, Save format и Decimation. Это свойство не применяется к плавающим областям и средствам просмотра области.

Variable name — имя сохраняемой переменной данных
ScopeData (по умолчанию) | string

Задайте имя переменной для сохранения данных области видимости в рабочей области. Это свойство не применяется к плавающим областям и средствам просмотра области.

Зависимости

Чтобы использовать это свойство, установите флажок Log data to workspace

Save format — формат переменной
Dataset (по умолчанию) | Structure With Time | Structure | Array

Выберите формат переменных для сохранения данных в рабочее пространство. Это свойство не применяется к плавающим областям и средствам просмотра области.

  • Dataset — сохранить данные как Dataset объект, по умолчанию timeseries объект.

  • Structure With Time — сохранение данных в виде структуры с соответствующей информацией о времени.

  • Structure — сохранить данные как структуру.

  • Array — сохранение данных в виде массива со связанной информацией о времени. Этот формат не поддерживает данные переменного размера.

Зависимости

Чтобы использовать это свойство, установите флажок Log data to workspace

Свойства масштабирования осей

Axes scaling — режим масштабирования по оси Y
Manual (по умолчанию) | Auto | After N Updates
  • Manual — масштабируйте диапазон оси Y вручную с помощью кнопки панели инструментов Масштабировать пределы оси Y.

  • Auto — масштабируйте диапазон оси Y во время и после симуляции. При установке этого флажка отображается флажок Do not allow Y-axis limits to shrink. Если вы хотите, чтобы диапазон оси Y увеличивался и уменьшался с максимальным значением сигнала, установите Axes scaling в значение Auto и снимите флажок Do not allow Y-axis limits to shrink.

  • After N Updates — масштабировать ось Y после количества временных шагов, указанного в текстовом поле Number of updates (10 по умолчанию). Масштабирование происходит только один раз во время каждого запуска.

Do not allow Y-axis limits to shrink — не разрешать сжатие пределов по оси Y
включено (по умолчанию) | выключено

Разрешить пределы диапазона по оси Y увеличиваться, но не уменьшаться во время симуляции.

Зависимости

Чтобы использовать это свойство, установите для Axes scaling значение Auto.

Number of updates — количество обновлений перед масштабированием
10 (по умолчанию) | целое число

Установите это свойство, чтобы отложить автоматическое масштабирование по оси Y.

Зависимости

Чтобы использовать это свойство, установите для Axes scaling значение After N Updates.

Scale axes limits at stop — масштабирование пределов осей при останове
включено (по умолчанию) | выключено
  • включено — масштабируйте оси, когда симуляция останавливается.

  • выключено — непрерывное масштабирование осей.

Зависимости

Чтобы использовать это свойство, установите для Axes scaling значение Auto.

Y-axis Data range (%) — процент оси Y для использования при построении графика
80 (по умолчанию) | целое число между [1, 100]

Укажите процент диапазона оси Y, используемого для построения графика. Если вы установите для этого свойства значение 100, данные на графике будут использовать весь диапазон оси Y.

Y-axis Align — выравнивание по оси Y
Center (по умолчанию) | Top | Bottom

Укажите, где выровнять данные графика по диапазону данных по оси Y, если для диапазона данных по оси Y задано значение менее 100 процентов.

  • Top — выровняйте сигналы с максимальными значениями диапазона оси Y.

  • Center — центрируйте сигналы между минимальным и максимальным значениями.

  • Bottom — выровняйте сигналы с минимальными значениями диапазона оси Y.

Autoscale X-axis limits — масштабировать пределы диапазона по оси X
выключено (по умолчанию) | включено

Масштабируйте диапазон оси X, чтобы соответствовать всем значениям сигнала. Если для параметра Axes scaling установлено значение Auto, масштабируются данные, находящиеся в настоящее время в пределах осей, а не весь сигнал в буфере данных.

X-axis Data range (%) — процент оси X для использования при построении графика
100 (по умолчанию) | целое число между [1, 100]

Укажите процент диапазона оси X для построения данных. Например, если вы установите для этого свойства значение 100, отображаемые данные будут использовать весь диапазон по оси X.

X-axis Align — выравнивание по оси X
Center (по умолчанию) | Left | Right

Укажите, где выровнять данные графика по диапазону данных по оси X, если для диапазона данных по оси X задано значение менее 100 процентов.

  • Right — выровняйте сигналы с максимальными значениями диапазона оси x.

  • Center — центрируйте сигналы между минимальным и максимальным значениями.

  • Left — выровняйте сигналы с минимальными значениями диапазона оси X.

Свойства стиля

Figure color — Цвет фона для окна
черный (по умолчанию) | цвет

Цвет фона области действия.

Plot type — как построить сигнал
Auto (по умолчанию) | Line | Stairs | Stem

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

Axes colors — Цвет фона и осей для отдельных дисплеев
черный (по умолчанию) | цвет

Выберите цвет фона для осей (дисплеев) с помощью первой цветовой палитры. Выберите сетку и цвет метки с помощью второй цветовой палитры.

Preserve colors for copy to clipboard — копировать область без изменения цветов
выключено (по умолчанию) | включено

Укажите, использовать ли отображаемый цвет области при копировании.

Когда вы выбираете Файл > Копировать в буфер обмена, программное обеспечение меняет цвет области на удобный для печати (белый фон, видимые линии). Если вы хотите скопировать и вставить область с отображаемыми цветами, установите этот флажок.

Properties for line — строка для изменения
Channel 1 (по умолчанию)

Выберите активную линию для настройки свойств стиля линии.

Visible — видимость линии
включено (по умолчанию) | выключено

Показать или скрыть сигнал на графике.

Зависимости

Значения Active display и Properties for line определяют, какая линия будет затронута.

Line — стиль линии
сплошная линия (стиль по умолчанию) | 0,75 (ширина по умолчанию) | желтый (цвет по умолчанию)

Выберите стиль линии, ширину и цвет.

Зависимости

Значения Active display и Properties for line определяют, какая линия будет затронута.

Marker — стиль маркера точки данных
None (по умолчанию) | форма маркера

Выберите форму маркера.

Зависимости

Значения Active display и Properties for line определяют, какая линия будет затронута.

Виртуальная шина не поддерживается. Невиртуальная шина поддерживается только в обычном и ускорительном режимах моделирования. Регистрация данных для невиртуальной шины поддерживается только в формате набора данных.