Changes

== Adding folders to the search path ==

== Adding folders to the search path ==

At startup, BrainStream adds the BrainStream core folder and nearly all its subfolders to the search path. If you need additional files or folders, you must make sure they are added to the search path. It is possible to specify these folders in the block file under the keys [.DocsSectionsBlockFile#TopicExperiment MatlabPathFnc] or [.DocsSectionsBlockFile#TopicExperiment MatlabPathAdd]. Alternatively, you can use Matlab's <tt>[[Http://www.mathworks.nl/help/techdoc/ref/addpath.htmlAddpath|http://www.mathworks.nl/help/techdoc/ref/addpath.html addpath]]</tt> function to add individual folders. If you want to add a folder with all its subfolders, use addpath in combination with <tt>[[Http://www.mathworks.nl/help/techdoc/ref/genpath.htmlGenpath|http://www.mathworks.nl/help/techdoc/ref/genpath.html genpath]]</tt>:

At startup, BrainStream adds the BrainStream core folder and nearly all its subfolders to the search path. If you need additional files or folders, you must make sure they are added to the search path. It is possible to specify these folders in the block file under the keys [[BrainStreamBlockFile#TopicExperiment|MatlabPathFnc]] or [[BrainStreamBlockFile#TopicExperiment|MatlabPathAdd]]. Alternatively, you can use Matlab's <tt>[[Http://www.mathworks.nl/help/techdoc/ref/addpath.htmlAddpath|http://www.mathworks.nl/help/techdoc/ref/addpath.html addpath]]</tt> function to add individual folders. If you want to add a folder with all its subfolders, use addpath in combination with <tt>[[Http://www.mathworks.nl/help/techdoc/ref/genpath.htmlGenpath|http://www.mathworks.nl/help/techdoc/ref/genpath.html genpath]]</tt>:

<pre>addpath(pwd);          %adds the current working directory to the search path

<pre>addpath(pwd);          %adds the current working directory to the search path

addpath(genpath(pwd)); %adds the current working directory and all its subfolders to the search path  

addpath(genpath(pwd)); %adds the current working directory and all its subfolders to the search path  

It is recommended to use relative path names when you specify a folder, whether it is in the blocksettings or in functions like <tt>addpath</tt>. This means that you specify the path name of the folder you want to add relative to a folder of which the location is already known. The advantage of using relative path names is that the proper folders will be added also if you work on a different computer.

It is recommended to use relative path names when you specify a folder, whether it is in the blocksettings or in functions like <tt>addpath</tt>. This means that you specify the path name of the folder you want to add relative to a folder of which the location is already known. The advantage of using relative path names is that the proper folders will be added also if you work on a different computer.

In BrainStream, you can make use of the <tt>[.DocsSectionsProgrmmersGuide#bs_folder bs_folder]</tt> function. For example, with input argument 'BLOCK', the output of this function is the path to the folder containing the block file of the experiment. If the block file is located in '/Volumes/BCI/my_bci/blockfile', and you want to add a folder which contains your functions and is located in '/Volumes/BCI/my_bci/functions', you can specify this folder like this:

In BrainStream, you can make use of the <tt>[[BrainStreamProgrmmersGuide#bs_folder|bs_folder]]</tt> function. For example, with input argument 'BLOCK', the output of this function is the path to the folder containing the block file of the experiment. If the block file is located in '/Volumes/BCI/my_bci/blockfile', and you want to add a folder which contains your functions and is located in '/Volumes/BCI/my_bci/functions', you can specify this folder like this:

<pre>functionfolder = fullfile(bs_folder('BLOCK'),..,'functions') % N.B. the '..' expression means going up one level</pre>

<pre>functionfolder = fullfile(bs_folder('BLOCK'),..,'functions') % N.B. the '..' expression means going up one level</pre>

== Output folders ==

== Output folders ==

BrainStream saves output in the folder specified in the [.DocsSectionsBuildingExperiments#SecBlock block file] under topic Files and key [.DocsSectionsBlockFile#KeyOutFolder OutFolder].

BrainStream saves output in the folder specified in the [[BrainStreamBuildingExperiments#SecBlock|block file]] under topic Files and key [[BrainStreamBlockFile#KeyOutFolder|OutFolder]].

The output folder contains:

The output folder contains:

<blockquote>

<blockquote>

[.DocsSectionsLogFile log file]: gives an overview of everything that happened during your experiment.

[[BrainStreamLogFile|log file]]: gives an overview of everything that happened during your experiment.

brainstream folder: contains copies of the user defined variables that have been saved with a 'save' statement in the Actions table.

brainstream folder: contains copies of the user defined variables that have been saved with a 'save' statement in the Actions table.