function dopOSCCIalert(label)
% dopOSCCI Mark II: dopOSCCIallert ~ 29-10-2010 (last edit)
%
% plays a wav file to alert user about:
% - crash/caught variable
% - finish of summary
%
% dopOSCCIalert(label)
% - where label = 'Caught' or 'Finish'
%
% calls wav file from ...\dopTools\genTools\
%

% -------------------------------------------------------------------------
%     'dopOSCCI' summarises functional transcranial Doppler ultrasonography
%     (fTCD) data.  The primary function of the software is to assess the
%     hemispheric lateralization of cognitive function.
%
%     Copyright (C) 2011 the Chancellor, Masters and Scholars of the
%     University of Oxford.
% 
%     This program is free software: you can redistribute it and/or modify
%     it under the terms of the GNU General Public License as published by
%     the Free Software Foundation, either version 3 of the License, or
%     (at your option) any later version.
% 
%     This program is distributed in the hope that it will be useful,
%     but WITHOUT ANY WARRANTY; without even the implied warranty of
%     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
%     GNU General Public License for more details.
% 
%     You should have received a copy of the GNU General Public License
%     along with this program.  If not, see <http://www.gnu.org/licenses/> 
%     or write to the Free Software Foundation, Inc., 51 Franklin Street,
%     Fifth Floor, Boston, MA 02110-1301, USA.
%
%     Authors: Nic Badcock, Georgina Holt, Anneka Holden, & Dorothy Bishop.
%       contact: nicholas.badcock@gmail.com
%
%     Type 'dopOSCCIlicense' for license details or see dopOSCCIlicense.txt
%

%% play sound
% to announce the crash/caught variable and finish
try
    % get the location of the dopOSCCI function - should be on matlab path
    dfl=which('dopOSCCI'); % dopOSCCI file location
    dl=fileparts(dfl); % dopOSCCI location
    
    % play sound...
    snl=[dl,'\dopTools\genTools\sound',label,'.wav']; % sound name location
    if exist(snl,'file')
        [Y,FS]=wavread(snl);
        wavplay(Y,FS,'async');
    end
catch err
    %% catch dopOSCCI error
    save(dopOSCCIdebug(mfilename)); rethrow(err);
end

clear dfl dl snl Y FS