OrgACRN
/
sof
mirror of https://github.com/thesofproject/sof.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
sof/tools/tune/tdfb/bf_defaults.m

64 lines
1.8 KiB
Mathematica
Raw Normal View History

Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
function bf = bf_defaults()
% Recording array general setup
TDFB Improve directivity index and WNG Added singular value decomposition algorithm for diagonal matrix calculation. Added filters for side lobe artifacts. Signed-off-by: ShriramShastry <malladi.sastry@intel.com>
2021-08-02 15:09:52 +08:00
bf.taylorwin_sidelobe = -30;
bf.chebwin_sidelobe = 30;
bf.taylorwin_nbar = 4;
bf.type_filt = 'hann'; % filter
Tools: Tune: Add option for delay-and-sum to beamformer design The delay-and-sum beamformer has highest white noise gain (WNG) performance. It's good id suppressing microphone self noise. The beam is steered with pure delay adjust in the all-pass filter bank. Default type is still super directive. Use DSB or SDB as beamformer type to select. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2021-01-30 01:31:54 +08:00
bf.type = 'SDB'; % SDB for superdirectivem, DSB for delay and sum
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
bf.fs = 16e3; % Design for 16 kHz sample rate
bf.c = 343; % Speed of sound in 20C
bf.steer_az = 0; % Azimuth 0 deg
bf.steer_el = 0; % Elevation 0 deg
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.steer_r = 5.0; % Distance 5.0m
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
bf.fir_length = 64; % 64 tap FIR filters
TDFB Improve directivity index and WNG Added singular value decomposition algorithm for diagonal matrix calculation. Added filters for side lobe artifacts. Signed-off-by: ShriramShastry <malladi.sastry@intel.com>
2021-08-02 15:09:52 +08:00
bf.kaiser_beta = 10; % Beta for kaiser window method FIR design
Tools: Tune: TDFB: Updates to design scripts for sound direction estimate This patch contains improvements to TDFB setup scripts and examples those are related to sound direction estimation. The changes are add of 15 degree angle spacing to enum control, add of rotated noise sound create for sound direction testing in simulated acoustics. The example line, circular, and xyz array scripts are updated for single dual mono beam that is controllable in 15 degree or 30 degree steps. All the two beam design examples are moved into example_two_beams.m. The patch also contains noise field covariance matrix diagonal load increase to -40 dB. I noticed uneven frequency response in some designs due to numerical instability. The increased diagonal load makes the automatic design procedure more robust at minimal hit in noise suppression performance. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2021-11-18 23:55:14 +08:00
bf.mu_db = -40; % dB of diagonal loading to noise covariance matrix
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
bf.do_plots = 1;
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.plot_box = 0.20; % Show 20cm wide plot cube for array geometry
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
bf.array_angle = [0 0 0]; % Array rotation angles for xyz
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.tplg_fn = '';
bf.sofctl_fn = '';
Tools: Tune: TDFB: Add support for IPC4 and tplg2 blobs This patch adds generation of.conf format blobs for tplg2 with IPC4 format blob. The blob ABI header retrieving is changed to common helper functions path those already have the support. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2023-10-02 15:55:48 +08:00
bf.tplg1_path = '../../topology/topology1/m4/tdfb';
bf.tplg2_path = '../../topology/topology2/include/components/tdfb';
bf.sofctl3_path = '../../ctl/ipc3/tdfb';
bf.sofctl4_path = '../../ctl/ipc4/tdfb';
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.data_path = './data';
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
bf.endian = 'little';
bf.fn = 1;
bf.sinerot_a = 10^(-20/20);
bf.sinerot_f = 2e3;
bf.sinerot_t = 1.0;
bf.sinerot_az_step = 5;
bf.sinerot_az_start = -180;
bf.sinerot_az_stop = 180;
bf.diffuse_t = 1;
bf.diffuse_lev = -20;
bf.random_t = 1;
bf.random_lev = -20;
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.num_output_channels = 1;
bf.num_output_streams = 1;
bf.input_channel_select = [];
Tools: Tune: Add multiple angles and beam off settings add to TDFB blob This patch essentially adds support for steer_az/steer_el to be vector instead of scalar. The beam off preset is added by default automatically for N-channel in N-channel out configurations. Microphone (x,y,z) coordinates are passed in to blob for direction of arrival reporting. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-12-11 01:59:42 +08:00
bf.output_channel_mix_beam_off = [];
Tools: Tune: TDFB: Simplify typical usage of bf_design(), bf_export() The bf_defaults() now sets the default directory locations for for bf_export() so it does not need to be set in every script. Also the defaults for input channels and output mixing are set to that in typical design they do not need to be set. The default distance for look direction is set to 5.0m so it is better guaranteed in far field for even relatively large arrays. The far field assumes planar sound waves. The design equations do not fully support near field with spherical waves. The FFT length is changed to 1024 to enable design of longer filter bank filters. There's no compromise in performance for for e.g. length 64. The incorrect use of mic_n (number of microphones) is replaced by num_filters. It's possible define beamformer that ignores some mic channels so these are not the same. The automatic systematic design file names are now created for all array types, not just line. The script is made more flexible to run without need to export data and clutter just to quickly interactively check from plots what kind of beam pattern and other characteristic some array, e.g. circular with some radius and mic count gives. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-10-27 00:41:47 +08:00
bf.output_channel_mix = [];
bf.output_stream_mix = [];
bf.num_filters = [];
Tools: Tune: Add multiple angles and beam off settings add to TDFB blob This patch essentially adds support for steer_az/steer_el to be vector instead of scalar. The beam off preset is added by default automatically for N-channel in N-channel out configurations. Microphone (x,y,z) coordinates are passed in to blob for direction of arrival reporting. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-12-11 01:59:42 +08:00
bf.angle_enum_mult = 30;
bf.angle_enum_offs = 0;
bf.track_doa = 0;
bf.beam_off_defined = 1;
Tools: Tune: TDFB: Updates to design scripts for sound direction estimate This patch contains improvements to TDFB setup scripts and examples those are related to sound direction estimation. The changes are add of 15 degree angle spacing to enum control, add of rotated noise sound create for sound direction testing in simulated acoustics. The example line, circular, and xyz array scripts are updated for single dual mono beam that is controllable in 15 degree or 30 degree steps. All the two beam design examples are moved into example_two_beams.m. The patch also contains noise field covariance matrix diagonal load increase to -40 dB. I noticed uneven frequency response in some designs due to numerical instability. The increased diagonal load makes the automatic design procedure more robust at minimal hit in noise suppression performance. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2021-11-18 23:55:14 +08:00
bf.array = '';
Tools: Tune: Add multiple angles and beam off settings add to TDFB blob This patch essentially adds support for steer_az/steer_el to be vector instead of scalar. The beam off preset is added by default automatically for N-channel in N-channel out configurations. Microphone (x,y,z) coordinates are passed in to blob for direction of arrival reporting. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-12-11 01:59:42 +08:00
bf.mic_x = [];
bf.mic_y = [];
bf.mic_z = [];
bf.mic_n = 0;
Tools: Fixes to TDFB tune and test scripts Matlab does not support isfile(), so another command is used to check if a file exists. The new way works both in Octave and Matlab. The bf_defaults.m is fixed to properly initialize empty strings to cell arrays. It's needed with minimal command like usage as shown in SOF Docs examples. In bf_design.m the num_filters determination is moved after array helpers because other than line and circle do not use mic_n parameter. The bug resulted to zero num_filters. In bf_merge.m the unused bf3 and bf4 are removed. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-12-11 02:10:00 +08:00
bf.array_id = {''};
Tools: Tune: TDFB: Updates to design scripts for sound direction estimate This patch contains improvements to TDFB setup scripts and examples those are related to sound direction estimation. The changes are add of 15 degree angle spacing to enum control, add of rotated noise sound create for sound direction testing in simulated acoustics. The example line, circular, and xyz array scripts are updated for single dual mono beam that is controllable in 15 degree or 30 degree steps. All the two beam design examples are moved into example_two_beams.m. The patch also contains noise field covariance matrix diagonal load increase to -40 dB. I noticed uneven frequency response in some designs due to numerical instability. The increased diagonal load makes the automatic design procedure more robust at minimal hit in noise suppression performance. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2021-11-18 23:55:14 +08:00
bf.noiserot_fn = {''};
Tools: Fixes to TDFB tune and test scripts Matlab does not support isfile(), so another command is used to check if a file exists. The new way works both in Octave and Matlab. The bf_defaults.m is fixed to properly initialize empty strings to cell arrays. It's needed with minimal command like usage as shown in SOF Docs examples. In bf_design.m the num_filters determination is moved after array helpers because other than line and circle do not use mic_n parameter. The bug resulted to zero num_filters. In bf_merge.m the unused bf3 and bf4 are removed. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-12-11 02:10:00 +08:00
bf.sinerot_fn = {''};
bf.diffuse_fn = {''};
bf.random_fn = {''};
bf.mat_fn = {''};
Tools: Tune: TDFB: Add support for IPC4 and tplg2 blobs This patch adds generation of.conf format blobs for tplg2 with IPC4 format blob. The blob ABI header retrieving is changed to common helper functions path those already have the support. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2023-10-02 15:55:48 +08:00
bf.export_note = '';
Tools: Tune: TDFB: Add howto instructions to generated tplg blobs Set field export_howto to instruction that was used to create the blob. The tplg2 .conf and tplg1 .m4 files will contain the command in the beginning of file. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2023-10-23 19:16:32 +08:00
bf.export_howto = '';
Tools: Tune: Add TDFB configuration tool This patch adds the tool for creating beamformer configurations. The microphone array geometry and beam angle (azimuth, elevation) need to be specified. See the example scripts and sample array helper functions. The FIR blob quantize function needed a minor change to prevent strip of trailing zero coefficients. The beamformer filter bank needs to use equal length filters. Signed-off-by: Seppo Ingalsuo <seppo.ingalsuo@linux.intel.com>
2020-05-12 00:27:27 +08:00
end