Engee documentation

Signal visualization

The window "Signal visualization" it is intended for visualization of model signals. To visualize graphs using code, use the tool Charts charts icon.

The window "Signal visualization» graphs icon 1 — one of the main visualization tools in Engee.

The window "Signal visualization» graphs icon 1 displays only recordable signal logging 1 the signals. To enable recording, select the option "Log»:

graph logging 1 en

Visualization of signals helps to understand and adjust the behavior of the model. Engee allows you to visualize signals as follows:

Signal Visualization Tools are used to work with graphs and coordinate planes.

Even more Engee visualization tools are presented in the Other Engee visualization Tools section.

The resulting graphs are easily exported (see Exporting a graph) in PNG or CSV format.

Use useful options to make it easier to work with the visualization window.:

  • Expand/compress charts horizontally and vertically:

    graph compression en

  • Compress the coordinate plane vertically:

    graph compression 1 en

  • Hold down the name of the signal and move it to the graph (to set the name of the signal, double-click on it and enter the desired name):

    graph compression 2 en

  • Work with the signals of the same simulation on different coordinate planes. To do this, click Add chart add graph button en and select the desired signal and the type of its display.

Time domain signals   signal graph 1

Create a model using blocks Sine Wave and Terminator, and turn on the recording signal logging 1 there are no signals between them. Leave all parameters and settings as default. The final model will look like this:

graph beginning 1 en

Start the simulation by clicking "Start» start simulation button. At the end of the simulation, to display the graph, click "Signal Menu» signal menu 1, select the display type signal graph 1 and the signal is A sine wave generator:

prework log sim settings graph en

Now the graph of the sinusoidal signal simulation will be displayed in the visualization window. graphs icon 1 on the coordinate plane:

graph explaination en

Signals in the frequency domain   signal graph 2

If the graph of the signal is in the frequency domain signal graph 2 it is not displayed — the system does not have enough data. The graph requires at least 1536 data points. This amount is calculated using the formula:

The minimum required number of points is calculated based on Henning’s window function. To get the required number of points, you can either increase the Simulation time or decrease the Sample time. The formula applies to both Time-Based and Sample-Based blocks.

The frequency domain graph represents the spectrum of a signal, showing which frequencies are present in that signal. Create a model using blocks Pulse Generator and Terminator. Leave the default settings and enable recording. signal logging 1 signals between blocks:

pulse generator model new en

Set the simulation time to at least 16 seconds (otherwise there won’t be enough data points) and start the simulation with the button Start start simulation button. After the simulation, open the visualization window graphs icon 1 and select the display type Frequency domain signals signal graph 2.

After saving, you will receive the block’s signal spectrum. Pulse Generator:

pulse gen freq graph 3 en

Additional settings of the model’s signal spectrum are available using spectrum analyzer graph windows. For this:

Dependence of one signal on another   signal graph 3

Create two models from blocks Sine Wave and Terminator, and turn on the recording signal logging 1 there are no signals between them. Keep all the values of the block parameters and model settings by default, but for the Sine Wave-1 block, increase the frequency from 1 to 2.

For clarity, give a name to the signals by double—clicking on the signal from the block. Sine Wave and set the name to x, and for Sine Wave-1 set the name to y. The final model will look like this:

sine wave model example 2 en

Start the simulation with the button Start start simulation button. In the visualization window, select the display type. Dependence of one signal on another signal graph 3 to open the signal selection window. Select x for the x-based signal and y for the y-based signal, respectively:

signal choosing 1 en

As a result, you will get the following graph (Lissajous figure):

graph lissajous curve 1 en

Graphs can also be compared in the time domain. signal graph 1. Use the same model. In the visualization window, use the button Signal Menu signal menu 1 switch to Time Domain Signals signal graph 1 and select both signals.

Next, hover the cursor over the coordinate plane, select Two cursors signal comparison 1 in the tools menu. Select the desired point on the chart and compare the values of the signals with each other:

signal comparison 3 en

Signals in tabular form   signal graph 4

Assemble the following model from blocks Sine Wave, Constant, Identity Matrix and Terminator:

table graph 1 en

For the block Constant set the value [1, 2, 3, 4]. Next, start the simulation with the button Start start simulation button. After the simulation, select the type in the visualization window Signals in tabular form signal graph 4 to open a table with instantaneous signal values:

img sim 15 4 en

To switch to other display types, use pen button graphs.

A frame in the time domain   frame based icon 1

Time domain frame frame based icon 1 — the model processes multiple data elements in one time step. Read more about frame-by-frame signal processing in Engee in the article Signal processing by frames and counts.

The signal constellation   signal constellation

Constellation diagram signal constellation A constellation diagram is a graphical method of representing modulated signals in digital communications. It is used to visualize the symbols transmitted in a modulated signal, and helps analyze the quality of data transmission and detect distortions. Read more in the article Signal constellations.

Building an array   massive icon

Array plot massive icon — this is the process of graphical visualization of data organized into arrays. It allows you to interpret numerical data as functions of time or other variables, displaying them as continuous lines and points.:

massive graph 1 en

Eye diagram   eye diagramm 1

Eye diagram eye diagramm 1 — It is a tool for analyzing digital signals, which helps to identify errors and distortions in data transmission. It displays repeatedly superimposed time sections of the signal, creating an image resembling an eye. This allows you to visually see signal distortions such as: intersymbol interference (ISI), noise, duty cycle distortion, and other interference.

An important advantage of the eye diagram is the ability to evaluate the quality of data transmission by the width and shape of the "eye" — the more open the "eye", the better the signal transmission.

glass diagramm 2 en

The diagram is used to analyze noisy signals in order to understand how well data is transmitted over the communication channel. For example, an eye diagram helps to identify deviations from an ideal signal caused by factors such as frequency offsets or phase errors.

Intensity chart   intensivity diag

Intensity Scope — It is a visualization tool that is used to display the power distribution or amplitude of a signal depending on coordinates or time parameters. It helps to analyze changes in signal intensity at different points in space or in time, which is especially useful in radar and digital signal processing (DSP).

The intensity diagram allows you to visually assess how the signal energy is distributed in the study area. For example, in optical systems, it helps to analyze the distribution of light in a beam, to identify the focusing and divergence of rays. In radio engineering and acoustics, it is used to study radiation patterns and signal levels in various directions.

monostatic graph 1

Signal Visualization Tools

Depending on the choice of the type of signal display, different graphs are obtained that are useful for individual situations. But this is only part of the functionality of the window "Signal visualizationNext, let’s look at the toolbar and its features.

To view the available visualization window tools graphs icon 1 move the mouse cursor over the coordinate plane. There are two sets of tools available in total:

img15a

_ Overview of the Signal Visualization window tools_

The first set

The second set

The first set contains everything you need to work with graphs.:

img15a 1

  1. Signal Menu — navigation menu between coordinate planes.

  2. Zoom — performs scaling of the coordinate plane. It becomes possible to select an area and enlarge its contents. To return to the default scale, double-click on the coordinate plane with the left mouse button.

  3. Pan — a tool for moving a graph on a coordinate plane. Allows you to move the chart in any direction using the mouse cursor.

  4. Zoom in — Zooms in on the coordinate plane.

  5. Zoom out — reduces the scale of the coordinate plane.

  6. Autoscale — returns the default scale value of the coordinate plane.

  7. Download plot as a png — Saves the coordinate plane to a PNG file.

  8. One cursor — displays values on a graph when you hover the mouse pointer over it.

  9. Two cursors — Displays values on all charts.

  10. Settings — opens the chart and coordinate plane settings. Chart setup consists of three sections:

    • Plot and axis — section for managing the display of graphs and coordinate planes:

      menu settings 1

    • Signals — signal display control section. Signal control is available if a specific signal is selected on the coordinate plane of the graph window. graphs icon 1.

      graphs signal settings

    • Spectrum analyzer — additional spectrum settings section (for more information, see the article Spectrum analyser). The section is available if the signal display type "Signals in the frequency domain   signal graph 2" is selected.

      spector analyzer 1 en

The second set is designed to work with two or more coordinate planes.:

img15b

  1. Up — moves the coordinate plane one cell higher.

  2. Down — moves the coordinate plane to the cell below.

  3. Copy — copies the coordinate plane. It does not copy to the clipboard, and you cannot paste the copied coordinate plane anywhere other than the graph window. The copied plane can be inserted only through the button Paste img 15 1 4.

  4. Paste — inserts the copied coordinate plane.

  5. Copy to clipboard — copies the coordinate plane to the clipboard. You can insert a plane into Engee and other third-party programs.

  6. Delete — removes the plane.

Button Delete delete button graphs It will automatically appear on the action bar when adding a new coordinate plane.

To add a new coordinate plane, use the button add graph button en. This button will allow you to adjust the plane before adding it and will re-display the menu for displaying signals and display types. The new plane will be added above the old one by default. You can change their order using the tools.

To add a new tab in the visualization window, use the button New tab new tab graph button and give her a name. In the created tab, you can work with new or existing simulation results in the usual mode.

img 15 1 2 en

For convenience, the tabs can be positioned vertically.:

vertical tabs 1 envertical tabs 2 en

Exporting a graph

There are three ways to export a chart
  • Save the coordinate plane as an image using the button Download plot as a png save as png button. The image will be automatically uploaded to your computer using the path specified in your operating system.

  • Insert the image of the coordinate plane into Engee and into third-party programs using the button Copy to clipboard clipboard copy 1.

  • You cannot export the graph to CSV directly, but you can export its signal data using the block To CSV. To do this, set up a block To CSV to output the desired model signal and in the parameter File name In the block, specify the name of the future CSV file (untitled.csv by default). The CSV file will be saved in file browser Engee under the specified name.

Other Engee visualization Tools

If your visualization tasks are much broader than described in the previous sections, then Engee offers you other tools as well. Review them to choose the best solution for visualizing the results of your models.:

  • Data Inspector allows you to view, analyze and compare the results of both one and several simulations (runs).

  • The simout variable allows you to work with the simulation results of the model via the command line or script editor, for example, using the library Plots.