setExtractorParams

(To be removed) Set nondefault parameter values for individual feature extractors

Since R2019b

The setExtractorParams function will be removed in a future release. Use setExtractorParameters instead. For more information, see Compatibility Considerations.

Syntax

setExtractorParams(aFE,featureName,params)

setExtractorParams(aFE,featureName)

Description

setExtractorParams(aFE,featureName,params) specifies parameters used to extract featureName.

setExtractorParams(aFE,featureName) returns the parameters used to extract featureName to default values.

Examples

Extract Pitch Using the LHS Method

Read in an audio signal.

[audioIn,fs] = audioread("Counting-16-44p1-mono-15secs.wav");

Create an audioFeatureExtractor object to extract pitch. Set the method of pitch extraction to "LHS".

aFE = audioFeatureExtractor(SampleRate=fs,pitch=true);
setExtractorParameters(aFE,"pitch",Method="LHS")

Call extract and plot the results.

f0 = extract(aFE,audioIn);
plot(f0)

Modify Spectral Rolloff Threshold and Mel Spectrum Parameters

Read in an audio signal.

[audioIn,fs] = audioread("Counting-16-44p1-mono-15secs.wav");

Create an audioFeatureExtractor object to extract the melSpectrum and spectralRolloffPoint. Specify ten bands for the mel spectrum and set the threshold for the rolloff point to 50% of the total energy.

aFE = audioFeatureExtractor(SampleRate=fs,melSpectrum=true,spectralRolloffPoint=true);
setExtractorParameters(aFE,"melSpectrum",NumBands=10)
setExtractorParameters(aFE,"spectralRolloffPoint",Threshold=0.5)

Call extract and plot the results.

features = extract(aFE,audioIn);
idx = info(aFE);

surf(10*log10(features(:,idx.melSpectrum)))
title("Mel Spectrum")

plot(features(:,idx.spectralRolloffPoint))
title("Spectral Rolloff Point")

To return individual audio feature extractors to their default values, call setExtractorParameters without specifying any parameters to set.

setExtractorParameters(aFE,"melSpectrum")
setExtractorParameters(aFE,"spectralRolloffPoint")

Call extract and plot the results.

features = extract(aFE,audioIn);
idx = info(aFE);

surf(10*log10(features(:,idx.melSpectrum)))
title("Mel Spectrum")

plot(features(:,idx.spectralRolloffPoint))
title("Spectral Rolloff Point")

Input Arguments

aFE — Input object

audioFeatureExtractor object

audioFeatureExtractor object.

featureName — Name of feature extractor

character array | string

Name of feature extractor, specified as a character array or string.

Data Types: char | string

params — Parameters to set

comma-separated name-value pairs | struct

Parameters to set, specified as comma-separated name-value pairs or as a struct.

Version History

Introduced in R2019b

R2024a: Warns

The setExtractorParams function issues a warning that it will be removed in a future release. Use setExtractorParameters instead.

R2022a: To be removed

The setExtractorParams function will be removed in a future release. Existing calls to setExtractorParams continue to run.