Skip to content
GitLab
Commit 9aa13e8c authored by Marco Berzborn's avatar Marco Berzborn
Browse files

added some more documentation to sph mimo simulation

parent 50502600
Hide whitespace changes
Inline Side-by-side
applications/SphericalHarmonics/ita_sph_mimo_error_simulation.m
View file @ 9aa13e8c
function varargout = ita_sph_mimo_error_simulation(varargin)
%ITA_SPH_MIMO_ERROR_SIMULATION - Simulate aliasing and noise errors in
% spherical MIMO systems.
% This function
% This function simulates the mismatch errors from noise, sampling dispacement and aliasing
% for a MIMO system comprised of a spherical loudspeaker array and a spherical microphone
% array.
%
% Syntax:
% itaResult = ita_sph_mimo_error_simulation(options)
%
% Options (default):
% 'opt1' (defaultopt1) : description
% 'opt2' (defaultopt1) : description
% 'opt3' (defaultopt1) : description
% 'SNR' (60) : SNR at each transducer
% 'nRuns' (5) : calculate average of nRuns number of source-receiver orientations
% 'dirMeasurementFile' ( [] ) : Filename for a directivity file that is to be included
%
% Directivity files need to be in hdf5 format. The name of data fields need to be 'fullDirRe' and
% 'fullDirIm' for the real and imaginary part respectively.
%
% Example:
% audioObjOut = ita_sph_mimo_error_simulation(audioObjIn)
% [individualTerms, allTerms, totalError] = ita_sph_mimo_error_simulation(sourceParams, receiverParams, opts)
%
% See also:
% ita_toolbox_gui, ita_read, ita_write, ita_generate
......@@ -26,7 +31,7 @@ function varargout = ita_sph_mimo_error_simulation(varargin)
% </ITA-Toolbox>
% Author: Marco Berzborn -- Email: marco.berzborn@rwth-aachen.de
% Author: Marco Berzborn -- Email: marco.berzborn@akustik.rwth-aachen.de
% Created: 29-Mar-2016
......@@ -47,6 +52,7 @@ sArgs = struct('pos1_source','struct',...
'dirMeasurementFile',[]);
[source,receiver,sArgs] = ita_parse_arguments(sArgs,varargin);
% save all struct fields as variables for speed improvements in the parfor loop
receiverNmax = receiver.Nmax;
receiverSampling = receiver.sampling;
......@@ -74,7 +80,7 @@ simWNG = sArgs.simWNG;
yMIMOgroundTruth = zeros(sArgs.nRuns,1,numel(kVec));
% check if source and receiver sampling have a unique radius within a certain tolerance
if numel(unique(sourceSampling.r)) > 1
uniRSort = sort(unique(sourceSampling.r));
if uniRSort(1) > uniRSort(end)*(1-2*eps) && uniRSort(end) < uniRSort(1)*(1+2*eps)
......@@ -90,8 +96,10 @@ if numel(unique(receiverSampling.r)) > 1
end
end
% include measured source directivity
dirMeasurementFile = sArgs.dirMeasurementFile;
%% separate error bounds
% initialize constant variables
receiverYalias = ita_sph_base(receiverSampling,receiverNmaxAlias);
sourceYalias = ita_sph_base(sourceSampling,sourceNmaxAlias);
sourceGalias = ita_sph_aperture_function_sla(sourceSampling,sourceNmaxAlias,sourcerMem);
......@@ -100,11 +108,9 @@ sourceG = sourceGalias(:,1:(sourceNmax+1)^2);
sourceY = sourceYalias(:,1:(sourceNmax+1)^2);
receiverY = receiverYalias(:,1:(receiverNmax+1)^2);
%% init
% sma terms
% declare non constant variables
eMismatchReceiver = zeros(sArgs.nRuns,1,numel(freqVec));
eAliasReceiver = zeros(sArgs.nRuns,1,numel(freqVec));
% sla terms
eMismatchSource = zeros(sArgs.nRuns,1,numel(freqVec));
eAliasSource = zeros(sArgs.nRuns,1,numel(freqVec));
elapsedTime = zeros(sArgs.nRuns,1);
......@@ -185,6 +191,7 @@ for idxRun = 1:sArgs.nRuns
Msource = sourceB .* (sourceG.'.*sourceY');
end
else
% include measured source directivity
dirMat = h5read(dirMeasurementFile,'/dir/fullRe',[1,1,idxFreq],[sourceSampling.nPoints,(sourceNmaxAlias+1)^2,1]) +...
1i* h5read(dirMeasurementFile,'/dir/fullIm',[1,1,idxFreq],[sourceSampling.nPoints,(sourceNmaxAlias+1)^2,1]);
Msource = dirMat(:,1:(sourceNmax+1)^2).';
......@@ -235,8 +242,6 @@ for idxRun = 1:sArgs.nRuns
end
end
% alias error needed here since antialias bf needs them and parfor
% requires the variables to be initialized
if simSMA
if numel(unique(receiverSampling.r)) == 1
EreceiverAlias = receiverYalias*receiverBalias;
......@@ -256,7 +261,7 @@ for idxRun = 1:sArgs.nRuns
EsourceAlias = [];
end
% just use random dnm for simulation
% use random weighting coefficients for simulation
sourceLambda = sourceRandPattern / norm(sourceRandPattern) .* ita_sph_base(sourceLookDir,sourceNmax)' * 4*pi/(sourceNmax+1)^2;
receiverLambda = receiverRandPattern / norm(receiverRandPattern) .* ita_sph_base(receiverLookDir,receiverNmax)' * 4*pi/(receiverNmax+1)^2;
......
applications/SphericalHarmonics/ita_sph_modal_strength.m
View file @ 9aa13e8c
function varargout = ita_sph_modal_strength(varargin)
%ITA_SPH_MODAL_STRENGTH - +++ Short Description here +++
% This function ++++ FILL IN INFO HERE +++
%ITA_SPH_MODAL_STRENGTH - Calculate the modal strength function for a spherical array
% This function calculates the modal strength for a plane wave incident
% onto a spherical microphone aray. The output is a diagonal matrix if the sampling
% has a unique radius. If not, the output is a matrix with full rank. In case the wave
% number k is given as a vector the output is of size N x M x nBins.
%
% Syntax:
% audioObjOut = ita_sph_modal_strength(audioObjIn, options)
% B = ita_sph_modal_strength(sampling, Nmax, k, 'rigid')
%
% Options (default):
% 'opt1' (defaultopt1) : description
% 'opt2' (defaultopt1) : description
% 'opt3' (defaultopt1) : description
% 'transducer' (microphone) : microphone or loudspeaker array
% 'hankelKind' (2) : choose kind of Hankel function
%
% Example:
% audioObjOut = ita_sph_modal_strength(audioObjIn)
% B = ita_sph_modal_strength(sampling, Nmax, k, 'rigid')
%
% See also:
% ita_toolbox_gui, ita_read, ita_write, ita_generate
......@@ -25,7 +27,7 @@ function varargout = ita_sph_modal_strength(varargin)
% </ITA-Toolbox>
% Author: Marco Berzborn -- Email: marco.berzborn@rwth-aachen.de
% Author: Marco Berzborn -- Email: marco.berzborn@akustik.rwth-aachen.de
% Created: 26-Feb-2016
%% Initialization and Input Parsing
......
applications/SphericalHarmonics/ita_sph_sampling/ita_sph_sampling_displacement.m
View file @ 9aa13e8c
......@@ -4,15 +4,13 @@ function varargout = ita_sph_sampling_displacement(varargin)
% positions taken from a given sampling grid
%
% Syntax:
% audioObjOut = ita_sph_sampling_displacement(audioObjIn, options)
% samplingDisplaced = ita_sph_sampling_displacement(sampling, opts)
%
% Options (default):
% 'opt1' (defaultopt1) : description
% 'opt2' (defaultopt1) : description
% 'opt3' (defaultopt1) : description
% 'relativeError' ([0.1,0.1,0.1]) : relative displacement in percent/100
%
% Example:
% audioObjOut = ita_sph_sampling_displacement(audioObjIn)
% samplingDisplaced = ita_sph_sampling_displacement(sampling, [0.01,0.01,0.01])
%
% See also:
% ita_toolbox_gui, ita_read, ita_write, ita_generate
......@@ -26,7 +24,7 @@ function varargout = ita_sph_sampling_displacement(varargin)
% </ITA-Toolbox>
% Author: Marco Berzborn -- Email: marco.berzborn@rwth-aachen.de
% Author: Marco Berzborn -- Email: marco.berzborn@akustik.rwth-aachen.de
% Created: 29-Mar-2016
......@@ -66,4 +64,4 @@ if sArgs.relativeError(:,1) == 0
end
varargout{1} = samplingError;
end
\ No newline at end of file
end
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment