BINICA Run stand-alone binary version of runica() from the Matlab command line. Saves time and memory relative to runica(). If stored in a float file, data are not read into Matlab, and so may be larger than Matlab can handle owing to memory limitations.

Usage: >> [wts,sph] = binica( datavar, 'key1', arg1, 'key2', arg2 ...);
else
>> [wts,sph] = binica('datafile', chans, frames, 'key1', arg1, ...);

Inputs:
datavar   
(chans,frames) data matrix in the Matlab workspace
datafile   
quoted 'filename' of float data file multiplexed by channel
channels   
number of channels in datafile (not needed for datavar)
frames   
number of frames (time points) in datafile (only)

Optional flag,argument pairs:
'extended'   
int>=0 [0 default: assume no subgaussian comps] Search for subgaussian comps: 'extended',1 is recommended
'pca'   
int>=0 [0 default: don't reduce data dimension] NB: 'pca' reduction not recommended unless necessary
'sphering'   
'on'/'off' first 'sphere' the data {default: 'on'}
'lrate'   
(0
'blocksize'   
int>=0 [0 default: heuristic, from data size]
'maxsteps'   
int>0 {default: 512}
'stop'   
(0
'weightsin'   
Filename string of inital weight matrix of size (comps,chans) floats, else a weight matrix variable in the current Matlab workspace (copied to a local .inwts files). You may want to reduce the starting 'lrate' arg (above) when resuming training, and/or to reduce the 'stop' arg (above). By default, binary ica begins with the identity matrix after sphering.
'verbose   
'on'/'off' {default: 'off'}

Less frequently used input flags:
'posact'   
('on'/'off') Make maximum value for each comp positive. NB: 'off' recommended. {default: 'off'}
'annealstep'   
(0
'annealdeg'   
(0
'bias'   
'on'/'off' {default: 'on'}
'momentum'   
(0

Outputs:
wts   
output weights matrix, size (ncomps,nchans)
sph   
output sphere matrix, size (nchans,nchans) Both files are read from float files left on disk
stem   
random integer used in the names of the .sc, .wts, .sph, and if requested, .intwts files

Author: Scott Makeig, SCCN/INC/UCSD, La Jolla, 2000

See also: runica()

See the matlab file binica.m (may require other functions)

Back to functions