c@0: %% MASSEF.execute c@0: % Run MASSEF using input mixtures and separators. c@0: % c@0: %% Syntax c@0: % c@0: % massef.execute(mixtures,separators) c@0: % massef.execute(mixtures) c@0: % c@0: % |massef.execute(mixtures,separators)| runs the multichannel audio source c@0: % separation evaluation framework (MASSEF) using the instance |massef|, the array of objects |mixtures| and the array (or cell array) of c@14: % instances of separation algorithms contained in |separators|. Separation c@14: % is performed for all combinations of separators and mixtures. The c@14: % separation algorithm instances contained in |separators| should conform c@14: % to the . c@0: % c@0: % The |execute| method performs evaluations of the algorithm according to c@0: % the data returned by the algorithm, and the options provided to c@0: % . c@0: % c@0: % If the separation algorithm returns a signal, then |MASSEF.execute| c@0: % evaluates: c@0: % c@0: % * signal-to-noise ratio (SNR); c@0: % * signal-to-ideal-noise ratio (SINR) (the SNR with respect to the signal c@0: % reconstructed using the ideal binary and ratio masks). c@0: % c@0: % In addition, if |evalPEASS| is true, then PEASS and BSSeval evaluation is c@0: % performed. If |evalSTOI| is true, then STOI evaluation is performed. c@0: % c@0: % If the separation algorithm returns a mask, and if the ideal mask c@0: % dimensions match the estimated mask dimensions, then |MASSEF.execute| c@0: % evaluates: c@0: % c@0: % * ideal mask ratio (IMR) with respect to the ideal binary and ratio c@0: % masks. c@0: % c@0: % If the separation algorithm returns a mask but no signals, then MASSEF c@0: % attempts to calculate the estimate signal in order to calculate the c@0: % signal-related metrics mentioned above. c@0: % c@0: % The |execute| method also calculates and evaluates the ideal binary and c@0: % ratio masks using the signal-related metrics utilised for the algorithm c@0: % evaluation. The masks are calculated using the settings that are local to c@14: % each object. c@0: % c@0: % Lastly, the framework captures the estimated azimuth and elevation of the c@0: % targets and interferer(s), if they are returned. c@0: % c@0: % Once the evaluation is complete, the object, c@0: % which contains the results data in |MASSEF.results| as a c@0: % object, is saved to the file c@0: % given by |MASSEF.results_filename|. The separation and mixture objects c@0: % are also saved. c@0: % c@0: % |massef.execute(mixtures)| evaluates only the ideal masks. c@0: % c@0: %% See also c@0: % , , c@0: % , c@0: % , c@0: % . c@0: % c@0: % c@0: %

c@0: %