Changes for page Widget TimeSeries
Last modified by ldomide on 2023/05/23 14:34
From version 15.1
edited by rominabaila
on 2022/04/12 11:31
on 2022/04/12 11:31
Change comment:
There is no comment for this version
To version 32.1
edited by rominabaila
on 2023/05/15 10:51
on 2023/05/15 10:51
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,29 +1,46 @@ 1 +Source code: [[https:~~/~~/github.com/the-virtual-brain/tvb-widgets>>url:https://github.com/the-virtual-brain/tvb-widgets]] 2 + 3 +This is part of a Pypi release: [[https:~~/~~/pypi.org/project/tvb-widgets/>>url:https://pypi.org/project/tvb-widgets/]] 4 + 5 +//**tvb-widgets**// is also already installed in the official image released for EBRAINS lab, where you can test it directly. 6 + 1 1 == Purpose == 2 2 3 -It is a Jupyter widget intended for the visualization of brain signals represented as time series.9 +It is a Jupyter Widget intended for the visualization of brain signals represented as time series. 4 4 11 +== Backends == 5 5 13 +Starting with //**tvb-widgets 1.5.0**, //the TS widget comes in 2 forms, corresponding to the 2 different libraries (we called them backends) used for plotting: **matplotlib **and **plotly**. The matplotlib backend, build on top of the **mne** library, offers more advanced scientifical features, while the plotly backend has a more appealing look and moves faster when talking about the basic interactions. 14 + 15 +Below you can see the TS widget with each backend option (first one using the matplotlib backend, the second one using the plotly backend). 16 + 17 +(% style="text-align:center" %) 18 +[[image:matplotlib.png]] 19 + 20 +(% style="text-align:center" %) 21 +[[image:plotly.png]] 22 + 6 6 == Inputs == 7 7 8 - It supports time series inputsoftwotypes:25 +Time series can be given as inputs in two forms: 9 9 10 10 * TVB TimeSeries datatype 11 11 * Numpy arrays 12 12 13 -Th ewidget supports 2-, 3-, and 4-dimensionalarrays. In all three cases, there is a fixed shape that the TimeSeries widget expects:30 +This widget supports 2D, 3D, and 4D arrays. In all three cases, there is a fixed shape that the TimeSeries widget expects: 14 14 15 15 * for **2D**: (no_timepoints, no_channels) 16 16 * for **3D**: (no_timepoints, state_variable/mode, no_channels) 17 17 * for **4D**: (no_timepoints, state_variable, no_channels, mode) 18 18 19 -~* Note that the TVB TimeSeries datatype is always is always4D and already has the expected shape.36 +~* Note that the TVB TimeSeries datatype is always 4D and already has the expected shape. 20 20 21 - 22 22 == Requirements and installation == 23 23 24 -Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and Notebook extensions should be installed:40 +Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and Jupyter extensions should be installed: 25 25 26 26 * **Libraries:** 43 +** [[mne>>https://mne.tools/0.24/install/index.html]] version 0.24 27 27 ** [[ipympl>>https://github.com/matplotlib/ipympl#installation]] 28 28 * ((( 29 29 **Extensions:** ... ... @@ -43,7 +43,6 @@ 43 43 pip install tvb-widgets 44 44 ))) 45 45 46 - 47 47 == API usage == 48 48 49 49 First, the correct matplotlib backend must be set, which enables the interaction with the TimeSeries widget, by running the following command: ... ... @@ -53,7 +53,7 @@ 53 53 %matplotlib widget 54 54 ))) 55 55 56 - Then, the TimeSeries widget (from the tvb-widgets API) and the display function should be imported:72 + Then, the **TimeSeriesWidget** (from the tvb-widgets API) and the **//display//** function should be imported: 57 57 58 58 (% class="box" %) 59 59 ((( ... ... @@ -73,9 +73,9 @@ 73 73 74 74 (% class="box" %) 75 75 ((( 76 -display(tsw .get_widget())92 +display(tsw) 77 77 ))) 78 78 79 79 {{html}} 80 -<iframe src="https:// drive.google.com/file/d/1g4ryY1VIFMUD14Mb6Dq_KVb0b2_XU4VX/preview"width="840"height="480" allow="autoplay"></iframe>96 +<iframe width="840" height="480" src="https://www.youtube.com/embed/VmueiXMxbVk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> 81 81 {{/html}}
- matplotlib.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.rominabaila - Size
-
... ... @@ -1,0 +1,1 @@ 1 +184.9 KB - Content
- plotly.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.rominabaila - Size
-
... ... @@ -1,0 +1,1 @@ 1 +351.7 KB - Content