With the GUI tool you can
- visualize channels
- compare channels from multiple files in the same plot
- see channel, conversion and source metadata as stored in the MDF file
- access library functionality for single files (convert, export, cut, filter, resample, scramble) and multiple files (concatenate, stack)
After you pip install asammdf using
pip install asammdf[gui] there will be a new script called asammdf.exe in the python_installation_folder\Scripts folder.
The following dependencies are required by the GUI
The Single files page is used to open several files individually for visualization and processing (for example exporting to csv or hdf5).
- Opened files tabs
- Channel tree display mode
- Complete channels tree
- Command buttons
- Plot/Sub-plots area
- Numeric window
- Plot window
- Sub-plot channel selection list
- Sub-plot graphics area
- Sub-plot channels statistics panel
- File operations
1. Opened files tabs¶
In the single files mode, you can open multiple files in parallel. The tab names have the title set to the short file name, and the complete file path can be seen as the tab tooltip.
There is no restriction, so the same file can be opened several times.
2. Channel tree display mode¶
The channel tree can be displayed in two ways
- as a naturally sorted list
- grouped using the internal file structure
3. Complete channels tree¶
This tree contains all the channels found in the measurement.
Double clicking a channel name will display a pop-up window with the channel information (CNBLOCK, CCBLOCK and SIBLOCK/CEBLOCK)
Only the channels that are checked in the channels tree will be selected for plotting when the Plot button is pressed. Checking or unchecking channels will not affect the current plot or sub-plots.
5. Plot/Sub-plots area¶
If sub-plots are enabled then multiple plots can be used. The sub-plots can be re-aranged using drag & drop.
6. Numeric window¶
Numeric windows can handle a lot more channels than plot windows. You can use a numeric window to see the channel values at certain time stamps. The time stamps can be selected using the spin box or the slider.
7. Plot window¶
Plot windows are used to grphically display the channel samples. pyqtgraph is used for the plots; to get the best performance consider the following tips
- limit the number of channels: plotting hundreds of channels can get really slow
- disabling dots will make the plots a lot more responsive
8. Sub-plot channel selection list¶
When the Plot button is pressed the checked channels will populate the Selected channels list.
Selecting items from the Selected channels list will display their Y-axis on the left side of the plot. Individual axis for each signal can also be toggled and they will show on the right side of the plot.
It is also necessary to select a single item when the Statistics panel is active to compute the statistics for the item’s channel.
Each item has five elements
- display enable checkbox
- color select button
- channel name and unit label
- channel value label 
- common axis checkbox
- individual axis checkbox 
The channel name can be copied to the clipboard using Ctrl+C.
Double clicking an item will open a range editor dialog
Here we can specify a range value visual alert. When the cursor is active and the current channel value is within the specified range, the item background will change to the selected color.
9. Sub-plot graphics area¶
The initial plot will have all channels homed (see the H keyboard shortcut)
The cursor is toggled using the C keyboard shortcut, and with it the channel values will be displayed for each item in the Selected channels list. The cursor can also be invoked by clicking the plot area.
The Ctrl+H and Ctrl+B keyboard shortcuts will
- change the axis values for integer channels to hex and bin mode
- change the channel value display mode for each integer channel item in the Selected channels list
Using the R keyboard shortcut will toggle the range, and with it the channel values will be displayed for each item in the Selected channels list. When the range is enabled, using the H keyboard shortcut will not home to the whole time range, but instead will use the range time interval.
The Statistics panel is toggle using the M keyboard shortcut
You can insert new computed channels by pressing the insert key. This will allow either to compute basic operations using the plot channels, or to apply a function on one of the plot channels.
The currently active plot’s channels can be saved to a new file by pressing Ctrl+S. The channels from all sub-plots can be saved to a new file by pressing Ctrl+Shift+S.
The sub-plots can be tiled as a grid, vertically or horizontally
Drag & Drop¶
Channels can be draged and dropped between sub-plots for easier configuration.
The Multiple files toolbox page is used to concatenate or stack multiple files.
The files list can be rearranged in the list (1) by drag and dropping lines. Unwanted files can be deleted by selecting them and pressing the DEL key. The files order is considered from top to bottom.
Use CTRL+F to search channels from all the opened files. The channel names are prefixed with the measurement index.
|||(1, 2) If the cursor is present then zooming will center on it.|
|||Clicking the plot will move the left margin of the region. Pressing CTRL while clicking the plot will move the right margin of the region.|
|||(1, 2) New in asammdf 5.7.0|
|||the value is only displayed if the cursor or range are active. For the cursor is will show the current value, and for the range it will show the value delta between the range start and stop timestamps|
|||New in asammdf 5.7.0|
|||(1, 2, 3) New in asammdf 5.20.0|