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

Графики

Окно графиков graphs icon 1 — один из основных инструментов визуализации сигналов Engee.

Визуализация результатов симуляции помогает понять и настроить поведение модели. Engee позволяет визуализировать результаты следующим образом:

График сигнала

Познакомимся с окном графиком поближе с помощью примера.

Окно графиков отображает только записываемые сигналы.

graph logging 1

Укажите с какими сигналами вы хотите работать, включив им запись signal logging 1.

Создайте модель, используя блоки Sine Wave и Terminator, и включите запись сигналов между ними. Все параметры модели оставляем по умолчанию. Итоговая модель будет выглядеть так:

graph beginning 1

Запустим симуляцию кнопкой Запустить модель start simulation button. График симуляции синусоидального сигнала отобразится в окне графиков на координатной плоскости. Прежде чем график отобразится, вы можете выбрать тип отображения сигнала и сам сигнал:

prework log sim settings graph

Выберите тип Сигналы во временной области signal graph 1 и сигнал Sine Wave.1, чтобы получить график синусоидального сигнала:

graph explaination

Для удобства задайте имя сигналу, дважды щелкнув по линии. Позже к этому сигналу можно обращаться по имени, а не по номеру порта или имени переменной (для физических блоков).

В разделе Инструменты окна графиков приведено описание инструментов для настройки и работы с графиками и координатными плоскостями.

Еще больше средств визуализации Engee представлено в разделе Другие инструменты визуализации.

Спектр сигнала

Если график сигнала в частотной области не отображается — системе не хватает данных. Для построения графика требуется как минимум 1536 точек данных. Это количество вычисляется по формуле:

Минимальное необходимое число точек рассчитано исходя из оконной функции Хеннинга. Чтобы получить нужное количество точек, вы можете либо увеличить Simulation time (время симуляции), либо уменьшить Sample time (шаг расчета). Формула применима как к Time Based, так и к Sample Based блокам.

График в частотной области представляет спектр сигнала, показывая, какие частоты присутствуют в этом сигнале. Создайте модель, используя блоки Pulse Generator и Terminator.

Запустите симуляцию кнопкой Запустить модель start simulation button. После симуляции откройте окно графиков graphs icon 1 и выберите тип отображения Сигналы в частотной области signal graph 2.

После сохранения вы получите спектр сигнала блока Pulse Generator:

pulse gen freq graph 3

Вы можете воспользоваться спектроанализатором в окне графиков для дополнительных настроек спектра сигналов вашей модели. Для этого выберите кнопку Настройки settings button 1 и перейдите в раздел Анализ спектра:

spector analyzer 1

Сравнение сигналов

Создайте модель из двух блоков Sine Wave и двух блоков Terminator. Включите запись сигналов. Все значения параметров блоков и настроек модели оставьте по умолчанию, но для блока Sine Wave-1 увеличьте частоту (Frequency) с 1 до 2.

Для наглядности задайте имя сигналам. Для этого дважды нажмите по сигналу от блока Sine Wave-1 и задайте имя x, а для Sine Wave-2 задайте имя y. Итоговая модель будет выглядеть так:

sine wave model example 2

Наведите курсор мыши на координатную плоскость — это выведет инструменты для работы с графиками:

signal comparison 2

С помощью кнопки Меню сигналов signal menu 1 переключитесь на Сигналы во временной области signal graph 1 и выберите оба сигнала.

В новой координатной плоскости снова наведите курсор и выведете инструменты, выберите Сравнить данные при наведении signal comparison 1. Выберите нужную точку на графике и сравните значения сигналов между собой:

signal comparison 3

Вы можете работать с сигналами одной симуляции на разных координатных плоскостях, для этого используйте кнопку Добавить координатную плоскость add graph button и выберите нужный сигнал и тип его отображения. Если вы хотите скопировать текущий график, то используйте комбинацию Копировать copy button 1 и Вставить paste button 1.

Зависимость одного сигнала от другого

Используем модель из предыдущего пункта. Откройте окно графиков graphs icon 1 и выберите тип отображения Зависимость одного сигнала от другого signal graph 3.

После выбора типа отображения и сигналов получите следующий график (фигура Лиссажу):

graph lissajous curve 1

Мгновенное значение

Соберем следующую модель:

table graph 1

Запустите симуляцию модели. После симуляции выберите тип Табличный вид отображения графика signal graph 4. В окне графиков откроется таблица с мгновенными значениями сигналов:

img sim 15 4

Для переключения на другие типы отображения используйте pen button graphs.

Сигнальное созвездие

Сигнальное созвездие signal constellation (или диаграмма созвездия) — это графический метод представления модулированных сигналов в цифровой связи. Оно используется для визуализации символов, передаваемых в модулированном сигнале, и помогает анализировать качество передачи данных и обнаруживать искажения.

Подробнее читайте в статье.

Построение массива

Построение массива massive icon — это процесс визуализации данных, организованных в массивы, на графиках. Он позволяет интерпретировать числовые данные как функции от времени или других переменных, отображая их как непрерывные линии и точки:

massive graph 1

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

Глазковая диаграмма

Глазковая диаграмма eye diagramm 1 — это инструмент для анализа цифровых сигналов, который помогает выявлять ошибки и искажения при передаче данных. Она отображает многократно наложенные временные участки сигнала, создавая изображение, напоминающее глаз. Это позволяет наглядно увидеть искажения сигнала, такие как интерсимвольная интерференция (ISI), шум, искажения рабочего цикла и другие помехи. Важным преимуществом глазковой диаграммы является возможность оценить качество передачи данных по ширине и форме «глаза» — чем более открыт «глаз», тем лучше передача сигнала.

glass diagramm 2

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

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

Инструменты окна графиков

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

Для просмотра доступных инструментов окна графиков graphs icon 1 наведите курсор мыши на координатную плоскость.

При работе с графиками вам доступно два набора инструментов:

img15a

Первый набор содержит все необходимое для работы с графиками:

img15a 1

  1. Меню сигналов — меню навигации между координатными плоскостями.

  2. Масштабировать — осуществляет масштабирование координатной плоскости. Появляется возможность выделить область и увеличить ее содержимое. Чтобы вернуть масштаб по умолчанию, дважды кликните на координатной плоскости левой кнопкой мыши.

  3. Панорамировать — инструмент перемещения графика на координатной плоскости. Позволяет двигать график в любом направлении с помощью курсора мыши.

  4. Увеличить масштаб — увеличивает масштаб координатной плоскости.

  5. Уменьшить масштаб — уменьшает масштаб координатной плоскости.

  6. Масштабировать автоматически — возвращает значение масштаба координатной плоскости по умолчанию.

  7. Скачать график в PNG — сохраняет координатную плоскость в файл с форматом PNG.

  8. Показывать ближайшие данные при наведении — отображает на графике значения при наведении на него указателя мыши.

  9. Сравнивать данные при наведении — отображает значения на всех графиках.

  10. Настройки — открывает настройки графиков и координатной плоскости. Настройка графиков состоит из трех разделов:

    • График и оси — раздел управления отображением графиков и координатных плоскостей:

      menu settings 1

    • Сигналы — раздел управления отображением сигналов. Управление сигналом доступно в случае, если вы выбрали конкретный сигнал на координатной плоскости окна графиков graphs icon 1.

      graphs signal settings

    • Анализ спектра — раздел дополнительной настройки спектра (подробнее см. в статье). Раздел доступен в случае, если выбран тип отображения сигнала «Сигналы в частотной области signal graph 2».

      spector analyzer 1

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

img15b

  1. Вверх — перемещает координатную плоскость на ячейку выше.

  2. Вниз — перемещает координатную плоскость на ячейку ниже.

  3. Копировать — копирует координатную плоскость. Не копирует в буфер обмена, вы не можете вставить скопированную координатную плоскость куда-либо кроме окна графиков. Скопированную плоскость можно вставить только через кнопку Вставить img 15 1 4.

  4. Вставить — вставляет скопированную координатную плоскость.

  5. Копировать в буфер обмена — копирует координатную плоскость в буфер обмена. Вы можете вставлять плоскость в Engee и другие сторонние программы.

  6. Удалить — удаляет плоскость.

Кнопка Удалить delete button graphs автоматически появится на панели действий при добавлении новой координатной плоскости.

Для добавления новой координатной плоскости используйте кнопку Добавить координатную плоскость add graph button. Эта кнопка позволит настроить плоскость до ее добавления и повторно выведет меню вывода сигналов и типов отображения. Новая плоскость будет по умолчанию добавлена выше старой. Изменить их порядок можно с помощью инструментов.

Для добавления новой вкладки в окне графиков используйте кнопку Новая вкладка new tab graph button и задайте ей имя. В созданной вкладке вы можете работать с новыми или уже имеющимися результатами симуляции в привычном режиме.

img 15 1 2

Экспорт графика

Вы можете экспортировать график тремя способами:

  • Сохраните координатную плоскость в виде изображения, используя кнопку Сохранить как PNG save as png button. Изображение будет автоматически загружено на ваш компьютер по пути, указанному в вашей операционной системе.

  • Вставляйте изображение координатной плоскости в Engee и в сторонние программы с помощью кнопки Копировать в буфер обмена clipboard copy 1.

  • Вы не можете экспортировать график в CSV напрямую, но можете экспортировать данные его сигнала с помощью блока To CSV. Для этого поставьте блок To CSV на выход желаемого сигнала модели и в параметре File name блока задайте имя будущего CSV-файла (untitled.csv по умолчанию). CSV-файл будет сохранен в файловом браузере Engee под указанным именем.

Другие инструменты визуализации Engee

Если ваши задачи визуализации гораздо шире, чем описано в предыдущих разделах, то Engee предлагает вам и другие инструменты. Ознакомьтесь с ними, чтобы выбрать лучшее решение для визуализации результатов ваших моделей:

  • Инспектор данных позволяет просматривать, анализировать и сравнивать результаты как одного, так и нескольких симуляций (прогонов).

  • Simout позволяет работать с результатами симуляции модели через командную строку или редактор скриптов, например, используя библиотеку Plots.