function [output,cf] = verhulst2015(insig,fs,fc_flag,varargin)
%VERHULST2015 Cochlear transmission-line model (improved)
%
% Usage: output = verhulst2015(insig,fs,fc,subject,irregularities,sheraPo)
%
% Input parameters:
% insig : the input signal to be processed. Each column is
% processed in parallel, so it is possible to run
% several simulations in parallel
% fs : sampling rate [Hz]
% fc_flag : list of frequencies specifying the probe positions
% along the basilar membrane, or 'all'to probe all
% 1000 cochlear sections, or 'abr' to probe 401 locations
% between 112 and 12000 Hz.
%
% Output parameters:
% V : velocity of the basilar membrane sections V(time,section,channel)
% Y : displacement of the basilar membrane sections Y(time,section,channel)
% E : sound pressure at the middle ear
% CF : center frequencies of the probed basiliar membrane sections
%
% This function computes the basilar membrane displacement and the
% velocity of the movement at different positions.
%
% See also: verhulst2015 verhulst2018 demo_verhulst2018 demo_verhulst2012
% verhulst2018_ihctransduction verhulst2015_cn
% verhulst2015_ic verhulst2018_auditorynerve exp_verhulst2012
% verhulst2012 verhulst2015
% verhulst2018 middleearfilter data_takanen2013 takanen2013_periphery
% exp_osses2022 exp_takanen2013 takanen2013
%
% License:
% --------
%
% This model is licensed under the UGent Academic License. Further usage details are provided
% in the UGent Academic License which can be found in the AMT directory "licences" and at
% <https://raw.githubusercontent.com/HearingTechnology/Verhulstetal2018Model/master/license.txt>.
%
% References:
% S. Verhulst, H. Bharadwaj, G. Mehraei, C. Shera, and
% B. Shinn-Cunningham. Functional modeling of the human auditory
% brainstem response to broadband stimulation. jasa, 138(3):1637--1659,
% 2015.
%
%
% Url: http://amtoolbox.org/amt-1.1.0/doc/models/verhulst2015.php
% #License: ugent
% #StatusDoc: Good
% #StatusCode: Good
% #Verification: Unknown
% #Requirements: MATLAB M-Signal PYTHON C
% #Author: Alejandro Osses (2020): primary implementation
% #Author: Piotr Majdak (2021): adaptations for the AMT 1.0
amt_info('once');
% ------ Checking of input parameters ------------
if nargin<3
error('%s: Too few input arguments.',upper(mfilename));
end;
if ~isnumeric(insig)
error('%s: insig must be numeric.',upper(mfilename));
end;
if ~isnumeric(fs) || ~isscalar(fs) || fs<=0
error('%s: fs must be a positive scalar.',upper(mfilename));
end;
definput.import={'verhulst2015'}; % load defaults from arg_verhulst2015
[flags,keyvals] = ltfatarghelper({},definput,varargin);
IrrPct = keyvals.IrrPct;
storeflag = ' ';
if flags.do_oae, storeflag = [storeflag 'e']; end
if flags.do_y , storeflag = [storeflag 'y']; end
if flags.do_ihc, storeflag = [storeflag 'i']; end
[Nr_signals,idx]=min(size(insig));
irregularities=keyvals.irr_on.*ones(1,Nr_signals);
%%% Fix model parameters so far: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
subject = keyvals.subject; % seed
non_linear_type = keyvals.non_linear_type;
% Number of neurones: 13-3-3 => no synaptopathy, any loss of neurones => synaptopathy
numH = keyvals.numH;
numM = keyvals.numM;
numL = keyvals.numL;
if idx == 1
error('If multiple signals are used as input make sure each column is one signal')
end
%%% Stage 1A. Outer ear: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
if flags.do_outerear
% Same outer ear filter as in other peripheral models (e.g., Jepsen2008)
hp_fir = headphonefilter(fs);% Getting the filter coefficients at fs
N = ceil(length(hp_fir)/2); % group delay for a FIR filter of order length(hp_fir)
M = size(insig,2);
insig = [insig; zeros(N,M)]; % group delay compensation: step 1 of 2.
insig = filter(hp_fir,1,insig); % filtering
insig = insig(N+1:end,1:M); % group delay compensation: step 2 of 2
end
%%% Stage 1B. Middle ear: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
if flags.do_middleear
[b,a] = middleearfilter(fs,'verhulst2015');
insig = filter(b,a,insig);
end
%%% Stage 2. Cochlear filter bank - Transmission line model: %%%%%%%%%%%%%%
% 2.1 Signal preprocessing:
fs_in = fs;
if fs ~= keyvals.fs_up
insig = resample(insig,keyvals.fs_up,fs);
fs = keyvals.fs_up;
end
stim=transpose(insig); % transpose it (python C-style row major order)
if(ischar(fc_flag)) %if probing all sections 1001 output (1000 sections plus the middle ear)
switch fc_flag
case 'all'
Nr_sections = 1000;
case 'half'
Nr_sections = 500;
case 'abr'
Nr_sections = 401;
otherwise
error('fc flag not recognised it should be either ''all'',''abr'',''half'', or a numeric array');
end
fc_str = fc_flag;
else
% then fc is a numeric array that will be passed as a column vector
fc_flag=round(fc_flag(:));
fc_str = 'custom CF(s)';
Nr_sections = length(fc_flag);
end
probes=fc_flag;
% Load poles for the selected hearing profile
poles=amt_load('verhulst2015','Poles.mat','Poles');
if ~isfield(poles.Poles,keyvals.hearing_profile)
error(['Hearing profile ' keyvals.hearing_profile ' not available.']);
end
sheraPo=poles.Poles.(keyvals.hearing_profile);
dir_model = fullfile(amt_basepath,'environments','verhulst2015',filesep);
dir_data = fullfile(dir_model,'out',filesep);
version_year = 2015;
% if ~exist(fullfile(dir_model,'tridiag.so'),'file')
% error('/environments/verhulst2015/tridiag.so library is missing. Run amt_mex');
% end
channels = Nr_signals;
amt_disp('VERHULST 2015: The following parameters will be passed to Python:',flags.disp);
amt_disp([' Number of signals to be processed: ',num2str(channels),' channels'],flags.disp);
amt_disp([' Cochlear hearing profile: ',keyvals.hearing_profile,' (poles between ',num2str(sheraPo(1)),' and ',num2str(sheraPo(end)),')'],flags.disp);
amt_disp([' Number of auditory nerve fibres: (',num2str([numH,numM,numL]),') (HSR,MSR,LSR)'],flags.disp);
amt_disp([' Number of cochlear sections to be stored: flag ',num2str(fc_str),' (all=1000, half=500, abr=401)'],flags.disp);
amt_disp([' Seed number: ',num2str(subject),' (subject ''variable'')'],flags.disp);
amt_disp([' Irregularities=',num2str(irregularities),' (1=on,0=off), IrrPrct=',num2str(IrrPct)],flags.disp);
amt_disp([' Non linear type=',num2str(non_linear_type),'(''vel'' or ''disp'')'],flags.disp);
amt_disp([' Extra variables to be saved: ',num2str(storeflag),' (storeflag)'],flags.disp);
%%% Storing input, change dir, run the model, and come back
amt_disp('Cochlear processing...','volatile');
act_path=pwd;
cd(dir_data);
fname = 'input.mat';
save(fname,'stim','fs','channels','subject','sheraPo','irregularities','probes', ... % this line: same parameters as verhulst2012.m
'dir_data','storeflag','IrrPct','non_linear_type','version_year','-v7');
[status,res] = system(sprintf('python %srun_cochlear_model.py',dir_model),'-echo');
cd(act_path);
if status ~= 0
%%% Then the simulation did not succeed
amt_disp();
amt_disp(res); % it re-prints the Python warning...
error('Something went wrong (see the Python warning above)')
end
fs_abr = keyvals.subfs; % default subfs = 20000 Hz
fs_an = keyvals.subfs;
DECIMATION = fs/keyvals.subfs;
L_samples = length(stim(1,:));
output = [];
fname2clean = []; % temporal files will be removed after simulating
bClean = 1;
amt_disp();
for i=1:Nr_signals
amt_disp(['Neural processing ' num2str(i) ' of ' num2str(Nr_signals)],'volatile');
fname=[dir_data 'cf',int2str(i),'.np'];
if i == 1
% Characteristic frequencies are read only once (the same for all Nr_signals)
f=fopen(fname,'r');
cf=fread(f,[Nr_sections,1],'double','n');
fclose(f);
end
if bClean; fname2clean{end+1} = fname; end
fname=[dir_data 'v' int2str(i) '.np'];
f=fopen(fname,'r');
v = fread(f,[Nr_sections,L_samples],'double','n')';
fclose(f);
if bClean; fname2clean{end+1} = fname; end
if flags.do_y
fname=[dir_data 'y' int2str(i) '.np'];
f=fopen(fname,'r');
output(i).y=resample(fread(f,[Nr_sections,L_samples],'double','n')',fs_in,fs);
fclose(f);
if bClean; fname2clean{end+1} = fname; end
end
if flags.do_oae
fname=[dir_data 'e',int2str(i),'.np'];
f=fopen(fname,'r');
output(i).oae=resample(fread(f,[L_samples,1],'double','n'),fs_in,fs);
fclose(f);
if bClean; fname2clean{end+1} = fname; end
end
output(i).fs_bm=fs_in;
%%% Stage 3. Inner hair cell model: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
outsig = verhulst2015_ihctransduction(v,fs,keyvals); % unscaled input
if flags.do_ihc
output(i).ihc = outsig;
end
% Reducing the sampling frequency: Decimation.
n = 30;
for ii = 1:size(outsig,2)
Vm_res(:,ii) = decimate(outsig(:,ii),DECIMATION,n,'fir'); % n-th order FIR filter before decimation
end
Vm_res(1:DECIMATION,:) = repmat(outsig(1,:),DECIMATION,1);
% Now that Vm_res has been decimated we can reduce the sampling frequency
% of v and ihc (if do_ihc):
v = resample(v,fs_in,fs);
if flags.do_v
output(i).v = v;
end
if flags.do_ihc
output(i).ihc = resample(output(i).ihc,fs_in,fs);
output(i).fs_ihc=fs_in;
end
if flags.do_an || flags.do_cn || flags.do_ic
%%% Stage 4: Auditory nerve model and Wave I: %%%%%%%%%%%%%%%%%%%%%%%%%
%% Re-code from ANF_Sarah.py
% HSR neurones
if numH ~= 0
kSR = keyvals.kSR_H;
anfH = verhulst2015_auditorynerve(Vm_res,fs_abr,kSR,cf);
else
error('There should be at least one HSR neurone, set numH to a non-null value...')
end
% MSR neurones
if numM ~= 0
kSR = keyvals.kSR_M;
anfM = verhulst2015_auditorynerve(Vm_res,fs_abr,kSR,cf);
else
anfM = zeros(size(Vm_res));
end
% LSR neurones
if numL ~= 0
kSR = keyvals.kSR_L;
anfL = verhulst2015_auditorynerve(Vm_res,fs_abr,kSR,cf);
else
anfL = zeros(size(Vm_res)); % empty array if no anfL, saves some computation power
end
if flags.do_anfH
output(i).anfH = anfH;
end
if flags.do_anfM
output(i).anfM = anfM;
end
if flags.do_anfL
output(i).anfL = anfL;
end
outsig = numL*anfL+numM*anfM+numH*anfH;
if flags.do_an
output(i).an_summed = outsig;
end
% Loading scaling constants for Wave I, III, and V:
M1 = keyvals.M1;
M3 = keyvals.M3;
M5 = keyvals.M5;
switch Nr_sections
case {401,500}
% same cochlear tuning in both configurations:
cal_factor = 1;
case 1000
% more ''dense'' cochlear resolution (twice as many channels):
cal_factor = 0.5;
otherwise
cal_factor = 1;
end
output(i).w1 = cal_factor*M1*sum(outsig,2);
%%% Stage 5: Cochlear nucleus: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Re-code from ICClicksRatio_withalpha.m
Tex = keyvals.Tex_cn;
Tin = keyvals.Tin_cn;
dly = keyvals.dly_cn;
A = keyvals.Acn;
S = keyvals.Scn;
outsig = verhulst2015_cn(outsig,fs_abr,Tex,Tin,dly,A,S);
if flags.do_cn
if ~iscell(outsig)
output(i).cn = outsig;
else
output(i).cn_mfb = outsig;
output(i).cn = il_sum_cell(outsig);
end
end
if flags.do_no_mfb
% Only one CN filter, 'outsig' is numeric:
output(i).w3 = cal_factor*M3*sum(outsig,2);
end
if flags.do_mfb
error('Not validated yet...')
% % CN from the modulation filter bank: outsig is a cell variable
% output(i).w3 = cal_factor*M3*sum(il_sum_cell(outsig),2);
end
%%% Stage 6: Inferior Colliculus: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Re-code from ICClicksRatio_withalpha.m
Tex = keyvals.Tex_ic;
Tin = keyvals.Tin_ic;
dly = keyvals.dly_ic;
A = keyvals.Aic;
S = keyvals.Sic;
outsig = verhulst2015_ic(outsig,fs_abr,Tex,Tin,dly,A,S);
if flags.do_ic
if ~iscell(outsig)
output(i).ic = outsig;
else
output(i).ic_mfb = outsig;
output(i).ic = il_sum_cell(outsig);
end
end
if flags.do_no_mfb
% Only one IC filter, 'outsig' is numeric:
output(i).w5 = cal_factor*M5*sum(outsig,2);
end
if flags.do_mfb
error('Not validated yet...')
% % IC from the modulation filter bank: outsig is a cell variable
% output(i).w5 = cal_factor*M5*sum(il_sum_cell(outsig),2);
end
end
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
output(i).cf = cf;
output(i).fs_abr=fs_abr;
output(i).fs_an=fs_an;
end
output(1).keyvals = keyvals;
if bClean==1
for i = 1:length(fname2clean)
try
delete(fname2clean{i});
end
end
end
cd(act_path);
amt_disp();