/
startup_bbci_toolbox.m
143 lines (122 loc) · 4.92 KB
/
startup_bbci_toolbox.m
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
%*******************************************************************
%Initialize the BBCI Toolbox:
%Hand over the directory for your (raw) data, which is in
%the Matlab variable 'MyDataDir' (e.g. 'D:\data' under Windows).
%If you have a tmp subfolder in the same directory,
%Start up the Toolbox as follows:
%"startup_bbci_toolbox('DataDir', MyDataDir);"
%If you want to choose a different folder for temporary files (e.g. 'D:\tmp\')
%Start up the Toolbox as follows:
%"startup_bbci_toolbox('DataDir', MyDataDir, 'TmpDir','/tmp/');"
%*******************************************************************
function startup_bbci_toolbox(varargin)
global BTB
% Find directory of the BBCI Toolbox and add it to the path
BBCI_DIR= fileparts(which(mfilename));
addpath(genpath(BBCI_DIR));
rmpath(genpath(fullfile(BBCI_DIR, '.git')));
% The subfolder 'external' is move to the end of the path, see below.
BBCI_PRIVATE_DIR= fullfile(fileparts(BBCI_DIR), 'bbci_private');
BTB= opt_proplistToStruct(varargin{:});
if ~isfield(BTB, 'TypeChecking'),
BTB.TypeChecking= 1;
end
BTB= opt_setDefaults(BTB, {'DataDir' '/home/bbci/data/' 'CHAR'});
if ~exist(BTB.DataDir, 'dir'),
warning('Optional argument ''DataDir'' should specify an existing folder.');
end
% Guess what the location of other directories could be
BBCI_RAW_DIR= fullfile(BTB.DataDir, 'bbciRaw/');
if ~exist(BBCI_RAW_DIR, 'dir'),
BBCI_RAW_DIR= BTB.DataDir;
end
BBCI_MAT_DIR= fullfile(BTB.DataDir, 'bbciMat/');
if ~exist(BBCI_MAT_DIR, 'dir'),
BBCI_MAT_DIR= BTB.DataDir;
end
PYFF_DIR= fullfile(fileparts(BBCI_DIR), 'pyff', 'src');
if ~exist(PYFF_DIR, 'dir'),
PYFF_DIR= '';
end
props= {'Dir' BBCI_DIR 'CHAR';
'DataDir' '' 'CHAR';
'RawDir' BBCI_RAW_DIR 'CHAR';
'MatDir' BBCI_MAT_DIR 'CHAR';
'PrivateDir' BBCI_PRIVATE_DIR 'CHAR';
'TmpDir' '' 'CHAR';
'PyffDir' PYFF_DIR 'CHAR';
'FigDir' '' 'CHAR';
'Tp' struct 'STRUCT';
'Acq' struct 'STRUCT';
'History' 1 '!BOOL';
'TypeChecking' 1 '!BOOL'
};
[BTB, isdefault]= opt_setDefaults(BTB, props);
% import dependencies if not done yet
if ~exist(fullfile(BTB.Dir, 'external', 'auto_import_performed'), 'file')
inp = input(sprintf(['\nThis is the first startup of the BBCI toolbox - Welcome!\n\n', ...
'You can now automatically download and import code from other sources.\n', ...
'This adds additional functionalities such as ICA and SSD to the BBCI toolbox.\n',...
'Following startups won''t ask for automatic imports. Manual imports are\n',...
'possible with ""bbci_import_dependencies()"" at any time.\n\n',...
'Type <yes> to download all dependencies (approx 10MB): ']), 's');
if strcmp(inp, 'yes') || strcmp(inp, 'y')
bbci_import_dependencies();
end
% write into file
fileID = fopen(fullfile(BTB.Dir, 'external', 'auto_import_performed'),'w');
fprintf(fileID, datestr(now()));
fclose(fileID);
end
% Put external folders to the end of the path, such that they cannot
% overload functions of the BBCI Toolbox:
IMPORT_PATH= genpath(fullfile(BBCI_DIR, 'external'));
rmpath(IMPORT_PATH);
path(path, IMPORT_PATH);
if exist(BTB.PrivateDir, 'dir'),
private_folders_to_add= {'utils', 'startup'};
for kk= 1:length(private_folders_to_add),
folder= fullfile(BTB.PrivateDir, private_folders_to_add{kk});
if exist(folder, 'dir'),
addpath(genpath(folder));
end
end
end
if isdefault.TmpDir
BTB.TmpDir= fullfile(BTB.DataDir, 'tmp');
if ~exist(BTB.TmpDir, 'dir'),
fprintf('!! Default TEMP dir not existing at\n %s\n', BTB.TmpDir);
fprintf('!! Setting TEMP dir to ''''\n');
BTB.TmpDir= '';
end
end
% Information about the test person (Tp)
props= {'Dir' BTB.TmpDir 'CHAR'
'Code' '' 'CHAR'
};
BTB.Tp= opt_setDefaults(BTB.Tp, props);
% Information about data acquistion
props= {'Prefix' 'a' 'CHAR'
'StartLetter' 'a' 'CHAR'
'Dir' BTB.TmpDir 'CHAR'
'Geometry' [] 'DOUBLE[1 4]'
'TriggerFcn' @bbci_trigger_parport 'FCN'
'TriggerParam' {} 'CELL'
};
BTB.Acq= opt_setDefaults(BTB.Acq, props);
switch computer
case 'PCWIN'
BTB.Acq.IoLib= which('inpout32.dll');
case 'PCWIN64'
BTB.Acq.IoLib= which('inpoutx64.dll');
end
if isfield(BTB.Acq, 'IoLib') && isfield(BTB.Acq, 'IoAddr'),
if isempty(BTB.Acq.TriggerParam) && ...
isequal(BTB.Acq.TriggerFcn, @bbci_trigger_parport),
BTB.Acq.TriggerParam= {BTB.Acq.IoLib, BTB.Acq.IoAddr};
end
else
fprintf('Parport not installed. Triggers will just be printed.\n');
BTB.Acq.TriggerFcn= @bbci_trigger_print;
end
evalin('base', 'global BTB');