Attention: The Collaboratory IAM will down for up to 1 hour on Monday, the 7th of July 2025 starting from 5pm CEST (my timezone) for up to 1 hour. Any and all services, which require a user login with an EBRAINS account, will be un-available during that time


Changes for page Widget TimeSeries

Last modified by ldomide on 2023/05/23 14:34

From version 16.1
edited by rominabaila
on 2022/04/12 13:13
Change comment: There is no comment for this version
To version 26.1
edited by paulapopa
on 2023/03/24 07:58
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.rominabaila
1 +XWiki.paulapopa
Content
... ... @@ -1,28 +1,34 @@
1 -== Purpose ==
1 +Source code: [[https:~~/~~/github.com/the-virtual-brain/tvb-widgets>>url:https://github.com/the-virtual-brain/tvb-widgets]]
2 2  
3 -It is a Jupyter widget intended for the visualization of brain signals represented as time series.
3 +This is part of a Pypi release: [[https:~~/~~/pypi.org/project/tvb-widgets/>>url:https://pypi.org/project/tvb-widgets/]]
4 4  
5 +//**tvb-widgets**// is also already installed in the official image released for EBRAINS lab, where you can test it directly.
5 5  
7 +== Purpose ==
8 +
9 +It is a Jupyter Widget intended for the visualization of brain signals represented as time series.
10 +
6 6  == Inputs ==
7 7  
8 -It supports time series inputs of two types:
13 +Time series can be given as inputs in two forms:
9 9  
10 10  * TVB TimeSeries datatype
11 11  * Numpy arrays
12 12  
13 -The widget supports 2-, 3-, and 4-dimensional arrays. In all three cases, there is a fixed shape that the TimeSeries widget expects:
18 +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 4D and already has the expected shape.
24 +~* Note that the TVB TimeSeries datatype is always 4D and already has the expected shape.
20 20  
21 21  == Requirements and installation ==
22 22  
23 -Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and  Jupyter Notebook extensions should be installed:
28 +Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and Jupyter extensions should be installed:
24 24  
25 25  * **Libraries:**
31 +** [[mne>>https://mne.tools/0.24/install/index.html]] version 0.24
26 26  ** [[ipympl>>https://github.com/matplotlib/ipympl#installation]]
27 27  * (((
28 28  **Extensions:**
... ... @@ -42,7 +42,6 @@
42 42  pip install tvb-widgets
43 43  )))
44 44  
45 -
46 46  == API usage ==
47 47  
48 48  First, the correct matplotlib backend must be set, which enables the interaction with the TimeSeries widget, by running the following command:
... ... @@ -52,7 +52,7 @@
52 52  %matplotlib widget
53 53  )))
54 54  
55 - Then, the TimeSeries widget (from the tvb-widgets API) and the display function should be imported:
60 + Then, the **TimeSeriesWidget** (from the tvb-widgets API) and the **//display//** function should be imported:
56 56  
57 57  (% class="box" %)
58 58  (((
... ... @@ -72,9 +72,9 @@
72 72  
73 73  (% class="box" %)
74 74  (((
75 -display(tsw.get_widget())
80 +display(tsw)
76 76  )))
77 77  
78 78  {{html}}
79 -<iframe src="https://drive.google.com/file/d/1g4ryY1VIFMUD14Mb6Dq_KVb0b2_XU4VX/preview" width="840" height="480" allow="autoplay"></iframe>
84 +<iframe width="840" height="480" src="https://www.youtube.com/embed/aDC2TJm2NxM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
80 80  {{/html}}
Public

TVB Widgets