StandardConfig_KSW.m

function ops = StandardConfig_KSW(XMLfile,varargin)

% Loads xml parameters (Neuroscope)
xml = LoadXml(XMLfile);

% Define rootpath
rootpath          = fileparts(XMLfile);

% set default values
ops.GPU                 = 1; % whether to run this code on an Nvidia GPU (much faster, mexGPUall first)
ops.parfor              = 0; % whether to use parfor to accelerate some parts of the algorithm
ops.verbose             = 1; % whether to print command line progress
ops.showfigures         = 0; % whether to plot figures during optimization

ops.datatype            = 'dat';  % binary ('dat', 'bin') or 'openEphys'
ops.fbinary             = [XMLfile(1:end-3) 'dat']; % will be created for 'openEphys'

ops.fproc = fullfile(rootpath,'temp_wh.dat');

ops.root                = rootpath; % 'openEphys' only: where raw files are

ops.fs                  = xml.SampleRate;        % sampling rate
ops.NchanTOT            = xml.nChannels;           % total number of channels

ops.Nchan               = 0; % number of active channels
for ii=1:xml.nElecGps
    ops.Nchan           = ops.Nchan + length(xml.ElecGp{ii});
end

ops.Nfilt              =   xml.nChannels*6 - mod(xml.nChannels*6,32);           % number of filters to use (2-4 times more than Nchan, should be a multiple of 32)
if ops.Nfilt > 1024;
    ops.Nfilt = 1024;
elseif ops.Nfilt == 0
    ops.Nfilt = 32;
end

if isfield(xml.SpkGrps(1),'nSamples')
    ops.nt0                 = xml.SpkGrps(1).nSamples; % samples per spike/template
else
    disp('No specification of nSamples in SpikeGroups, using default of 32 samples')
    ops.nt0 = 32;
end
ops.nNeighPC            = min([12 ops.Nchan]); % visualization only (Phy): number of channnels to mask the PCs, leave empty to skip (12)
ops.nNeigh              = 16; % visualization only (Phy): number of neighboring templates to retain projections of (16)

% options for channel whitening
ops.whitening           = 'full'; % type of whitening (default 'full', for 'noSpikes' set options for spike detection below)
ops.nSkipCov            = 1; % compute whitening matrix from every N-th batch (1)
ops.whiteningRange      = 32; % how many channels to whiten together (Inf for whole probe whitening, should be fine if Nchan<=32)

% define the channel map as a filename (string) or simply an array
ops.chanMap             = fullfile(rootpath,'chanMap.mat'); % make this file using createChannelMapFile.m
ops.criterionNoiseChannels = 0.2; % fraction of "noise" templates allowed to span all channel groups (see createChannelMapFile for more info).
% ops.chanMap = 1:ops.Nchan; % treated as linear probe if a chanMap file

% other options for controlling the model and optimization
ops.Nrank               = 3;    % matrix rank of spike template model (3)
ops.nfullpasses         = 6;    % number of complete passes through data during optimization (6)
ops.maxFR               = 20000;  % maximum number of spikes to extract per batch (20000)
ops.fshigh              = 300;   % frequency for high pass filtering
% ops.fslow             = 2000;   % frequency for low pass filtering (optional)
ops.ntbuff              = 64;    % samples of symmetrical buffer for whitening and spike detection
ops.scaleproc           = 200;   % int16 scaling of whitened data
ops.NT                  =  4*32*1028+ ops.ntbuff;% this is the batch size (try decreasing if out of memory)
% for GPU should be multiple of 32 + ntbuff

% the following options can improve/deteriorate results.
% when multiple values are provided for an option, the first two are beginning and ending anneal values,
% the third is the value used in the final pass.
ops.Th               = [4 10 10];    % threshold for detecting spikes on template-filtered data ([6 12 12])
ops.lam              = [5 20 20];   % large means amplitudes are forced around the mean ([10 30 30])
ops.nannealpasses    = 4;            % should be less than nfullpasses (4)
ops.momentum         = 1./[20 800];  % start with high momentum and anneal (1./[20 1000])
ops.shuffle_clusters = 1;            % allow merges and splits during optimization (1)
ops.mergeT           = .1;           % upper threshold for merging (.1)
ops.splitT           = .1;           % lower threshold for splitting (.1)

% options for initializing spikes from data
ops.initialize      = 'no'; %'fromData' or 'no'
ops.spkTh           = .25;      % spike threshold in standard deviations (4)
ops.loc_range       = [3  1];  % ranges to detect peaks; plus/minus in time and channel ([3 1])
ops.long_range      = [30  6]; % ranges to detect isolated peaks ([30 6])
ops.maskMaxChannels = 5;       % how many channels to mask up/down ([5])
ops.crit            = .65;     % upper criterion for discarding spike repeates (0.65)
ops.nFiltMax        = 10000;   % maximum "unique" spikes to consider (10000)

% load predefined principal components (visualization only (Phy): used for features)
%dd                  = load('PCspikes2.mat'); % you might want to recompute this from your own data
%ops.wPCA            = dd.Wi(:,1:7);   % PCs

% options for posthoc merges (under construction)
ops.fracse  = 0.1; % binning step along discriminant axis for posthoc merges (in units of sd)
ops.epu     = Inf;

ops.ForceMaxRAMforDat   = 0; % maximum RAM the algorithm will try to use; on Windows it will autodetect.

% change specified option
for n=1:length(varargin)/2
    ops.(varargin{2*n-1})=varargin{2*n};
end

end