Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -2,27 +2,28 @@
2	2
3	3	It is a Jupyter widget intended for the visualization of brain signals represented as time series.
4	4
	5	+
5	5	== Inputs ==
6	6
7		-Time series can be given as inputs in two forms:
	8	+It supports time series inputs of two types:
8	8
9	9	* TVB TimeSeries datatype
10	10	* Numpy arrays
11	11
12		-This widget supports 2D, 3D, and 4D arrays. In all three cases, there is a fixed shape that the TimeSeries widget expects:
	13	+The widget supports 2-, 3-, and 4-dimensional arrays. In all three cases, there is a fixed shape that the TimeSeries widget expects:
13	13
14	14	* for **2D**: (no_timepoints, no_channels)
15	15	* for **3D**: (no_timepoints, state_variable/mode, no_channels)
16	16	* for **4D**: (no_timepoints, state_variable, no_channels, mode)
17	17
18		-~* Note that the TVB TimeSeries datatype is always 4D and already has the expected shape.
	19	+~* Note that the TVB TimeSeries datatype is always is always 4D and already has the expected shape.
19	19
	21	+
20	20	== Requirements and installation ==
21	21
22		-Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and Jupyter extensions should be installed:
	24	+Before installing the tvb-widgets library containing the TimeSeries widget, the following python libraries and  Jupyter Notebook extensions should be installed:
23	23
24	24	* **Libraries:**
25		-** [[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:**
...	...	@@ -35,45 +35,9 @@
35	35	)))
36	36	)))
37	37
38		-Then, to install the tvb-widgets library, just type:
	39	+Then, to install the tvb-widgets library just type:
39	39
40	40	(% class="box" %)
41	41	(((
42	42	pip install tvb-widgets
43	43	)))
44		-
45		-== API usage ==
46		-
47		-First, the correct matplotlib backend must be set, which enables the interaction with the TimeSeries widget, by running the following command:
48		-
49		-(% class="box" %)
50		-(((
51		-%matplotlib widget
52		-)))
53		-
54		- Then, the **TimeSeriesWidget** (from the tvb-widgets API) and the **//display//** function should be imported:
55		-
56		-(% class="box" %)
57		-(((
58		-from tvbwidgets.api import TimeSeriesWidget
59		-from IPython.core.display_functions import display
60		-)))
61		-
62		-Assuming that the user has already created or imported a valid input, this is how the widget can be initialized and how an input can be assigned to it, using the //**add_datatype** //method (example below assumes that **//tsr//  **is a TVB TimeSeries datatype):
63		-
64		-(% class="box" %)
65		-(((
66		-tsw = TimeSeriesWidget()
67		-tsw.add_datatype(tsr)
68		-)))
69		-
70		-Finally, to display and interact with the TimeSeries widget, the **//get_widget//**// //method is used inside the //**display **//function:
71		-
72		-(% class="box" %)
73		-(((
74		-display(tsw)
75		-)))
76		-
77		-{{html}}
78		-<iframe src="https://drive.google.com/file/d/1g4ryY1VIFMUD14Mb6Dq_KVb0b2_XU4VX/preview" width="840" height="480" allow="autoplay"></iframe>
79		-{{/html}}