SFS Toolbox for MatlabOctave.zip

function conf = SFS_config() %SFS_CONFIG returns a struct with the default configuration settings % % Usage: conf = SFS_config % % Output parameters: % conf - struct containing all configuration variables % % SFS_CONFIG() creates the struct conf containing the default % configuration values. If you want to create other entries, please set % them in your script (e.g. conf.fs = 48000) and pass the conf struct to % the desired function as last input (e.g. tapering_window(x0,conf)). % % Please don't edit this function to change your configuration settings! % % See also: SFS_start %***************************************************************************** % The MIT License (MIT) * % * % Copyright (c) 2010-2019 SFS Toolbox Developers * % * % Permission is hereby granted, free of charge, to any person obtaining a * % copy of this software and associated documentation files (the "Software"), * % to deal in the Software without restriction, including without limitation * % the rights to use, copy, modify, merge, publish, distribute, sublicense, * % and/or sell copies of the Software, and to permit persons to whom the * % Software is furnished to do so, subject to the following conditions: * % * % The above copyright notice and this permission notice shall be included in * % all copies or substantial portions of the Software. * % * % THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * % IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * % FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * % THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * % LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * % FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * % DEALINGS IN THE SOFTWARE. * % * % The SFS Toolbox allows to simulate and investigate sound field synthesis * % methods like wave field synthesis or higher order ambisonics. * % * % https://sfs.readthedocs.io sfstoolbox@gmail.com * %***************************************************************************** %% ===== Checking of input parameters =================================== nargmin = 0; nargmax = 0; narginchk(nargmin,nargmax); %% ===== Table of Contents =============================================== % % - Misc % - Audio % - Delayline % - Sound Field Synthesis (SFS) % * Dimensionality % * Driving functions % * Impulse responses % * 2.5D % * Tapering % - Sound Field Simulations % - Secondary Sources % - Wave Field Synthesis (WFS) % * Pre-equalization % - Spectral Division Method (SDM) % - Near-Field Compensated Higher Order Ambisonics (NFC-HOA) % - Local Sound Field Synthesis (LSFS) % - Binaural Reproduction % * Headphone compensation % * SoundScape Renderer % - Plotting % - References %% ===== Misc ============================================================ conf.tmpdir = '/tmp/sfs'; % string % Debugging level. We are supporting two levels: % 0 - normal mode % 1 - debug modus, showing interim results and plots conf.debug = 0; % 0 or 1 % Show a progress bar in selected loops (for example sound_field_mono). This can % be useful, if you are using a high number of secondary sources. conf.showprogress = false; % boolean %% ===== Audio =========================================================== % Audio and signal processing settings % % Samplingrate conf.fs = 44100; % / Hz % Speed of sound conf.c = 343; % / m/s %% ===== Delayline ======================================================= % Delaying of time signals. This can be critical as very often the wanted delays % are given as fractions of samples. This configuration section handles how % those delays should be handled. Beside choosing the actual delayline filter, % the signal can also be resampled before delaying. As the default setting, % integer only delays are used by rounding to the next larger integer delay. % If you want to use a fractional delayline, a setting with a high accuracy is: % conf.delayline.resampling = 'pm'; % conf.delayline.resamplingfactor = 8; % conf.delayline.resamplingorder = 64; % conf.delayline.filter = 'lagrange'; % conf.delayline.filterorder = 9; % Note, that the necessary interpolation accuracy highly depends on the % actual use case and parametrisation, compare Winter and Spors (2016). % % Delayline filter % 'integer' - round to nearest integer delay (default) % 'zoh' - round to next larger integer delay % 'lagrange' - lagrange interpolator (FIR Filter) % 'least_squares' - least squares FIR interpolation filter % 'thiran' - Thiran's allpass IIR filter % 'farrow' - use the Farrow structure (to be implemented) conf.delayline.filter = 'integer'; % string % Resample signal % 'none' - no resampling (default) % 'matlab' - use matlab's resample() function % 'pm' - use Parks-McClellan-Method to compute resample filter (firpm) conf.delayline.resampling = 'none'; % / string % Oversamplingfactor factor >= 1 % This should be in the order of (1/stepsize of fractional delays) conf.delayline.resamplingfactor = 100; % / 1 % Order of Parks-McClellan resample filter (only for 'pm') % This results in a filter length of resamplingfactor*resamplingorder conf.delayline.resamplingorder = 64; % Order of delayline filter (only for Lagrange, Least-Squares & Thiran) conf.delayline.filterorder = 0; % / 1 % Number of parallel filters in Farrow structure % (only for 'farrow'); conf.delayline.filternumber = 1; % / 1 %% ===== Sound Field Synthesis (SFS) ===================================== % Common sound field synthesis settings % % === Dimensionality === % Dimensionality of the secondary sources and the sound field synthesis driving % functions: % '2D' - line sources as secondary sources, arranged in a circle, line, ... % '2.5D' - point sources as secondary sources, arranged in a circle, line, ... % '3D' - point sources as secondary sources, arranged in a sphere, plane, ... conf.dimension = '2.5D'; % string % % === Driving functions === % Implementation of driving functions. For the default ones use 'default'. These % functions are described at https://sfs.readthedocs.io/. For possible other % flags have a look into the driving functions as they can be quite specific. % Most users can safely use the 'default' flag here. conf.driving_functions = 'default'; % string % % === Impulse responses === % Length of impulse responses used in the time domain driving functions % and for the creation of the binaural simulations. % Don't worry, SFS checks for you if conf.N is large enough. conf.N = 2048; % samples % % === 2.5D === % The amplitude will be correct at the point xref for 2.5D % synthesis. conf.xref = [0 0 0]; % / m % % === Tapering === % The truncation of the loudspeaker array leads to diffraction of the % synthesized sound field. It has been shown that the truncation can be % described by cylindrical waves originating from the edges of the array, see % Sect. 8.3.2 in Born, Wolf (1999) for the general principle and Sect. 3.2 in % Wierstorf (2014) for how it relates to WFS. Therefore a good method to reduce % artifacts due to the diffraction edge waves is to fade out the amplitude of % the driving function at the edges of the