BrainStreamProgrmmersGuide - Revision history

Wiki-admin: /* bs_change_processing */

2018-09-26T08:04:58Z

bs_change_processing

Wiki-admin: /* bs_insert_multiple_markers */

2018-09-26T08:01:58Z

bs_insert_multiple_markers

Wiki-admin: /* bs_insert_marker */

2018-09-26T08:00:04Z

bs_insert_marker

Wiki-admin: /* bs_send_buffer_marker */

2018-09-26T07:59:46Z

bs_send_buffer_marker

Wiki-admin at 07:58, 26 September 2018

2018-09-26T07:58:17Z

Wiki-admin: /* bs_disp */

2018-09-26T07:56:41Z

bs_disp

Wiki-admin: /* bs_folder */

2018-09-26T07:56:14Z

bs_folder

Wiki-admin: /* bs_get_custom_out */

2018-09-26T07:54:28Z

bs_get_custom_out

Wiki-admin: /* bs_custom_out */

2018-09-26T07:52:42Z

bs_custom_out

Wiki-admin: /* bs_trace */

2018-09-26T07:41:56Z

bs_trace

@@ Line 422: / Line 422: @@
 {| class="wikitable"
 |-
-| event || BrainStream event structure |||
+| event || colspan="3"|BrainStream event structure
 |-
-| mod || modifier indicating what needs to change in the scheduled processing |||
+| mod || colspan="3"|modifier indicating what needs to change in the scheduled processing
 |-
-| ^ || options for mod: |||
+|  || colspan="3"|options for mod:
 |-
-| ^ || ^ || 'FINISHAPPLICATION' || finish application, normal shutdown via BS EXIT
+|  ||  || 'FINISHAPPLICATION' || finish application, normal shutdown via BS EXIT
 |-
-| ^ || ^ || 'FINISHEXPERIMENT' || same as FINISHAPPLICATION
+|  ||  || 'FINISHEXPERIMENT' || same as FINISHAPPLICATION
 |-
-| ^ || ^ || 'QUITAPPLICATION' || quit application, alternative shutdown via BS QUIT
+|  ||  || 'QUITAPPLICATION' || quit application, alternative shutdown via BS QUIT
 |-
-| ^ || ^ || 'QUITEXPERIMENT' || same as QUITAPPLICATION
+|  ||  || 'QUITEXPERIMENT' || same as QUITAPPLICATION
 |-
-| ^ || ^ || 'FINISHEVENT' || discard execution of any queued actions for this event
+|  ||  || 'FINISHEVENT' || discard execution of any queued actions for this event
 |-
-| ^ || ^ || 'ABORTAPPLICATION' || immediately abort
+|  ||  || 'ABORTAPPLICATION' || immediately abort
 |}

@@ Line 394: / Line 394: @@
 {| class="wikitable"
 |-
-| event || BrainStream event structure |
+| event || colspan="2"|BrainStream event structure
 |-
-| name || name of the marker |
+| name || colspan="2"|name of the marker
 |-
-| delaytime || time of insertion in seconds relative to actions own execution time (&gt;=0)y |
+| delaytime || colspan="2"|time of insertion in seconds relative to actions own execution time (&gt;=0)y
 |-
-| interval || time in seconds between insertions of markers |
+| interval || colspan="2"|time in seconds between insertions of markers
 |-
-| number || number of times the marker has to be inserted |
+| number || colspan="2"|number of times the marker has to be inserted
 |-
-| priority || <p>option to change execution order in case multiple actions have equal execution times</p> |
+| priority || colspan="2"|<p>option to change execution order in case multiple actions have equal execution times</p>
 |-
-| ^ || 'low' || (default) put behind all other actions with equal execution times
+|  || 'low' || (default) put behind all other actions with equal execution times
 |-
-| ^ || 'high' || put before all other actions with equal execution times
+|  || 'high' || put before all other actions with equal execution times
 |}

@@ Line 383: / Line 383: @@
 === bs_insert_marker ===
- This function is deprecated, use bs_send_hardware_marker and bs_send_buffer_marker instead.
+This function is deprecated, use bs_send_hardware_marker and bs_send_buffer_marker instead.
 === bs_insert_multiple_markers ===

@@ Line 373: / Line 373: @@
 | reference || relative to which timepoint is the delay specified, either:
 |-
-| ^ || 'now': delay is specified relative to timepoint of bs_send_buffer_marker execution
+|  || 'now': delay is specified relative to timepoint of bs_send_buffer_marker execution
 |-
-| ^ || 'marker' (default): delay is specified relative to the onset of the event during which bs_send_buffer_marker is executed
+|  || 'marker' (default): delay is specified relative to the onset of the event during which bs_send_buffer_marker is executed
 |}

@@ Line 13: / Line 13: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | <tt>event</tt> || BrainStream event structure
@@ Line 28: / Line 28: @@
 Output
-{| border="1"
+{| class="wikitable"
 |-
 | <tt>value</tt> || content of requested key or default value if specified, otherwise an error is generated. Blocksettings structure if first argument is a filename
@@ Line 47: / Line 47: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | <tt>input</tt> || either blocksettings structure or the name of a blocksettings file, the latter option is useful to retrieveclean block file content without any comment lines
@@ Line 56: / Line 56: @@
 Output
-{| border="1"
+{| class="wikitable"
 |-
 | lines || cell array of lines (one per row)
@@ Line 72: / Line 72: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | expression || some expression that either results in true or false
@@ Line 83: / Line 83: @@
 Output
-{| border="1"
+{| class="wikitable"
 |-
 | opttrue || if expression is true
@@ Line 99: / Line 99: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | filename || name of blockfile with defined experiment definition table to be expanded
@@ Line 108: / Line 108: @@
 Output
-{| border="1"
+{| class="wikitable"
 |-
 | markers || all info BrainStream requires for its internal processing <br /> definition of all actions for all markers
@@ Line 130: / Line 130: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | url || string with name of the datafile or fieldtrip buffer url (i.e., something like: 'buffer://localhost:1972')
@@ Line 299: / Line 299: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || BrainStream event structure
@@ Line 317: / Line 317: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || BrainStream event structure
@@ Line 340: / Line 340: @@
 <pre>bs_send_hardware_marker(event, marker, datasource)</pre>Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || event structure
@@ Line 361: / Line 361: @@
 <pre>bs_send_buffer_marker(event, marker, datasource, delay, reference)</pre>Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || event structure
@@ Line 392: / Line 392: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || BrainStream event structure |
@@ Line 420: / Line 420: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
 | event || BrainStream event structure |||

@@ Line 236: / Line 236: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
-| event || BrainStream event structure (optional) |
+| event ||colspan=2| BrainStream event structure (optional)
 |-
-| text || string with requested folder reference |
+| text ||colspan=2| string with requested folder reference
 |-
-| ^ || 'RUNFOLDER' || folder with system related content
+|  || 'RUNFOLDER' || folder with system related content
 |-
-| ^ || 'BLOCK' || folder with block file
+|  || 'BLOCK' || folder with block file
 |-
-| ^ || 'SESSIONFOLDER' || folder with session related content
+|  || 'SESSIONFOLDER' || folder with session related content
 |-
-| ^ || 'SUBJECTFOLDER' || folder with subject related content
+|  || 'SUBJECTFOLDER' || folder with subject related content
 |-
-| ^ || 'EXPERIMENTFOLDER' || folder with experiment related content
+|  || 'EXPERIMENTFOLDER' || folder with experiment related content
 |-
-| ^ || 'REFERENCEFOLDER' || folder with currently executed blockfile
+|  || 'REFERENCEFOLDER' || folder with currently executed blockfile
 |-
-| ^ || 'BRAINSTREAMFOLDER' || brainstream core folder
+|  || 'BRAINSTREAMFOLDER' || brainstream core folder
 |-
-| ^ || 'ROOT' || brainstream root folder
+|  || 'ROOT' || brainstream root folder
 |-
-| ^ || 'RESOURCESFOLDER' || folder with user resources
+|  || 'RESOURCESFOLDER' || folder with user resources
 |-
-| ^ || 'LIBFOLDER' || folder with library tables
+|  || 'LIBFOLDER' || folder with library tables
 |-
-| ^ || 'PLUGINSFOLDER' || folder with plugin tables
+|  || 'PLUGINSFOLDER' || folder with plugin tables
 |-
-| ^ || 'FIELDTRIPFOLDER' || fieldtrip toolbox folder
+|  || 'FIELDTRIPFOLDER' || fieldtrip toolbox folder
 |-
-| ^ || 'EXAMPLES' || folder with examples
+|  || 'EXAMPLES' || folder with examples
 |-
-| ^ || 'TOOLBOXES' || folder with internally included toolboxes
+|  || 'TOOLBOXES' || folder with internally included toolboxes
 |}
 See also:
 === bs_disp ===
 bs_disp() outputs text to console (or screen). It is a wrapper function around Matlab disp function, intended to be used as function in the experiment definition table for displaying output to screen. Instead, you could also directly define the disp() function in the special [.DocsSectionsBuildingExperiments#SecFeval feval] column.

@@ Line 213: / Line 213: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
-| event || BrainStream event structure |
+| event || colspan=2|BrainStream event structure
 |-
-| mod || specifies what information to retrieve, options are: |
+| mod || colspan=2|specifies what information to retrieve, options are:
 |-
-| ^ || 'LOGFILE' || name of the logfile
+|  || 'LOGFILE' || name of the logfile
 |}
 Output
-{| border="1"
+{| class="wikitable"
 |-
 | value || requested info, dependent of mod

@@ Line 177: / Line 177: @@
 Input
-{| border="1"
+{| class="wikitable"
 |-
-| event || BrainStream event structure || ||
+| event || colspan=2|BrainStream event structure
 |-
-| mod || specifies what to change, options are: || ||
+| mod || colspan=2|specifies what to change, options are:
 |-
-| ^ || 'LOGFILE' || specify name of the logfile (overwrites the one composed by BrainStream based on runfolder) |
+|  || 'LOGFILE' || specify name of the logfile (overwrites the one composed by BrainStream based on runfolder)
 |-
-| ^ || ^ || value = name of the logfile (without path information) |
+|  ||  || value = name of the logfile (without path information)
 |-
-| ^ || 'DISABLEOUTPUT' || user can disable any output by BrainStream |
+|  || 'DISABLEOUTPUT' || user can disable any output by BrainStream
 |-
-| ^ || ^ || value = 0: normal output; 1: no output |
+|  ||  || value = 0: normal output; 1: no output
 |-
-| ^ || 'MESSAGE' || same as bs_msg() |
+|  || 'MESSAGE' || same as bs_msg()
 |-
-| ^ || ^ || value = a string with the message |
+|  ||  || value = a string with the message
 |-
-| ^ || 'WARNING' || same as bs_warn() |
+|  || 'WARNING' || same as bs_warn()
 |-
-| ^ || ^ || value = a string with the warning |
+|  ||  || value = a string with the warning
 |-
-| value || content for what should be changed (see mod) || ||
+| value ||colspan=2|content for what should be changed (see mod) ||
 |}

@@ Line 144: / Line 144: @@
 Input
-{| border="1"
+{|class="wikitable"
 |-
-| event || BrainStream event structure |
+| var
 |-
-| var || name of the user variable, notation according to the name specified in the experiment definition file, i.e., myvar or myvar.field |
+| mod
 |-
-| mod || options for mod are: |
 |-
-| ^ || 'add' || add variable to the list
 |-
-| ^ || 'remove' || remove variable from the list
-|-
+| 'clear'
-| ^ || 'clear' || remove all variables from the list
+| remove all variables from the list
 |}