Wiki-admin at 13:19, 4 October 2018

2018-10-04T13:19:48Z

Wiki-admin: Created page with "= Example 2: Visual speller = TOC = Part 3 = <- Go back to Part 2 - Continue with Part 4 -> I..."

2018-10-04T13:18:51Z

Created page with "= Example 2: Visual speller = __TOC__ = Part 3 = <- Go back to Part 2 - Continue with Part 4 -> I..."

New page

= Example 2: Visual speller =
__TOC__
= Part 3 =

[[BrainStreamExampleSpellerPart2|<- Go back to Part 2]] - [[BrainStreamExampleSpellerPart4|Continue with Part 4 ->]]

In the previous parts of this visual speller example, all actions were executed by the BrainStream Matlab session. In this section, we will describe how to enable [[BrainStreamParallelMode|parallel processing]]. All actions related to stimulus presentation will be handled by a [[BrainStreamParallelMode#SecClients|client]].

Below, the new flowcharts of the experiment are shown. Actions indicated in orange are executed at the BrainStream Matlab session, whereas actions indicated in blue are executed at the client.

[[File:DocsSectionsExampleSpellerPart3_Flowchart_main_4.png|672px|331x]]

''Figure 1: Main flowchart. In the stimulus presentation import-table, actions are defined for the BrainStream Matlab session as well as the client (see Figure 2).''

At the start of the experiment, the speller is intialized on the client. The client then sends a marker to BrainStream to trigger the initTrain function. The advantage of this construction is that you are always sure that the stimulus client is correctly initialized before the actual experiment starts.

[[File:DocsSectionsExampleSpellerPart3_Flowchart_plugin_3.png|745px|315x]]

''Figure 2: Import-table flowchart''

In the import-table flowchart you can see why it is advantageous to use parallel processing: if the action of updating the codebook (at the BrainStream session) is delayed or takes more than 0.07 seconds, the duration of the stimulus (at the client) is not affected.

In order to build this experiment, we first need to indicate that we want to use parallel processing and define the client. This can be done in the block file speller_common.blk:
<pre>[RunMode]
Parallel=1;

[Clients]
stim = 'localhost';</pre>

Thus, the name of the client is 'stim'. Furthermore, 'stim' is an [[BrainStreamParallelMode#SecClients|internal client]] of type 'localhost'. This means that in order to run the experiment, we must start a second Matlab session manually and connect this session to the BrainStream session by typing the command <tt>connect_brainstream_client('localhost')</tt> in the client's command window.

Now that we have specified the client in the block file, we can direct the execution of any action to this client. We can do this by specifying the name of the client in the 'client' column of the Actions table:

[[File:DocsSectionsExampleSpellerPart3_stim1.png|668px|266x]]

''Figure 3'':<em> Actions sheet of the speller_train table</em>

[[File:DocsSectionsExampleSpellerPart3_stim2_2.png|529px|406x]]

''Figure 4: Actions sheet of the speller_common table''
== Evaluation ==

---

[[BrainStreamExampleSpellerPart2|<- Go back to Part 2]] - [[BrainStreamExampleSpellerPart4|Continue with Part 4 ->]]

@@ Line 32: / Line 32: @@
 Now that we have specified the client in the block file, we can direct the execution of any action to this client. We can do this by specifying the name of the client in the 'client' column of the Actions table:
-[[File:DocsSectionsExampleSpellerPart3_stim1.png|668px|266x]]
+[[File:DocsSectionsExampleSpellerPart3_Stim1.png|668px|266x]]
 ''Figure 3'':<em> Actions sheet of the speller_train table</em>
-[[File:DocsSectionsExampleSpellerPart3_stim2_2.png|529px|406x]]
+[[File:DocsSectionsExampleSpellerPart3_Stim2_2.png|529px|406x]]
 ''Figure 4: Actions sheet of the speller_common table''

BrainStreamExampleSpellerPart3 - Revision history

Wiki-admin at 13:19, 4 October 2018

Wiki-admin: Created page with "= Example 2: Visual speller = __TOC__ = Part 3 = <- Go back to Part 2 - Continue with Part 4 -> I..."

Wiki-admin: Created page with "= Example 2: Visual speller = TOC = Part 3 = <- Go back to Part 2 - Continue with Part 4 -> I..."