Functions
	computeFeature (cFeatureName, x, f_s, afWindow=None, iBlockLength=4096, iHopLength=2048)
	computes a feature from the audio data supported features are: 'SpectralCentroid', 'SpectralCrestFactor', 'SpectralDecrease', 'SpectralFlatness', 'SpectralFlux', 'SpectralKurtosis', 'SpectralMfccs', 'SpectralPitchChroma', 'SpectralRolloff', 'SpectralSkewness', 'SpectralSlope', 'SpectralSpread', 'SpectralTonalPowerRatio', 'TimeAcfCoeff', 'TimeMaxAcf', 'TimePeakEnvelope', 'TimeRms', 'TimeStd', 'TimeZeroCrossingRate',

	isSpectral (cName)
	helper functions

	isTemporal (cName)

	computeFeatureCl (cPath, cFeatureName, bPlotOutput=False)
	main

Variables
	parser = argparse.ArgumentParser(description='Compute feature from wav file')

	metavar

	required

	help

	args = parser.parse_args()

	cPath = args.infile

	cFeatureName = args.featurename

	bPlotOutput = args.plotoutput

Function Documentation

◆ computeFeature()

computeFeature	(	cFeatureName,
		x,
		f_s,
		afWindow = None,
		iBlockLength = 4096,
		iHopLength = 2048 )

computes a feature from the audio data supported features are: 'SpectralCentroid', 'SpectralCrestFactor', 'SpectralDecrease', 'SpectralFlatness', 'SpectralFlux', 'SpectralKurtosis', 'SpectralMfccs', 'SpectralPitchChroma', 'SpectralRolloff', 'SpectralSkewness', 'SpectralSlope', 'SpectralSpread', 'SpectralTonalPowerRatio', 'TimeAcfCoeff', 'TimeMaxAcf', 'TimePeakEnvelope', 'TimeRms', 'TimeStd', 'TimeZeroCrossingRate',

Parameters

cFeatureName	feature to compute, e.g. 'SpectralSkewness'
x	array with floating point audio data (dimension samples x channels)
f_s	sample rate of audio data
afWindow	FFT window of length iBlockLength (default: hann)
iBlockLength	internal block length (default: 4096 samples)
iHopLength	internal hop length (default: 2048 samples)

Returns: v: feature value; t: time stamps

Definition at line 43 of file computeFeature.py.

def computeFeature(cFeatureName, x, f_s, afWindow=None, iBlockLength=4096, iHopLength=2048):
 
    # mypackage = __import__(".Feature" + cFeatureName, package="pyACA")
    hFeatureFunc = getattr(pyACA, "Feature" + cFeatureName)
 
    # pre-processing
    x = ToolPreprocAudio(x)
 
    if isSpectral(cFeatureName):
        # compute window function for FFT
        if afWindow is None:
            afWindow = ToolComputeHann(iBlockLength)
 
        assert(afWindow.shape[0] == iBlockLength), "parameter error: invalid window dimension"
 
        # in the real world, we would do this block by block...
        [X, f, t] = computeSpectrogram(x, f_s, None, iBlockLength, iHopLength)
 
        # compute instantaneous feature
        v = hFeatureFunc(X, f_s)
 
    if isTemporal(cFeatureName):
        [v, t] = hFeatureFunc(x, iBlockLength, iHopLength, f_s)
 
    return v, t
 
 

Here is the call graph for this function:

◆ computeFeatureCl()

computeFeatureCl	(	cPath,
		cFeatureName,
		bPlotOutput = False )

main

Definition at line 90 of file computeFeature.py.

def computeFeatureCl(cPath, cFeatureName, bPlotOutput=False):
 
    # read audio file
    [f_s, afAudioData] = ToolReadAudio(cPath)
    
    # for debugging
    iBlockLength = 4096
    iHopLength = 2048
 
    # compute feature
    [v, t] = computeFeature(cFeatureName, afAudioData, f_s, None, iBlockLength, iHopLength)
 
    # plot feature output
    if bPlotOutput:
        plt.plot(t, v)
 
    return v, t
 
 

◆ isSpectral()

isSpectral ( cName )

helper functions

Definition at line 72 of file computeFeature.py.

def isSpectral(cName):
    bResult = False
    if "Spectral" in cName:
        bResult = True
 
    return bResult
 
 

Here is the caller graph for this function:

◆ isTemporal()

isTemporal ( cName )

Definition at line 80 of file computeFeature.py.

def isTemporal(cName):
    bResult = False
    if "Time" in cName:
        bResult = True
 
    return bResult
 
 

Here is the caller graph for this function:

Variable Documentation

◆ args

args = parser.parse_args()

Definition at line 122 of file computeFeature.py.

◆ bPlotOutput

bool bPlotOutput = args.plotoutput

Definition at line 125 of file computeFeature.py.

◆ cFeatureName

str cFeatureName = args.featurename

Definition at line 124 of file computeFeature.py.

◆ cPath

str cPath = args.infile

Definition at line 123 of file computeFeature.py.

◆ help

help

Definition at line 115 of file computeFeature.py.

◆ metavar

metavar

Definition at line 114 of file computeFeature.py.

◆ parser

parser = argparse.ArgumentParser(description='Compute feature from wav file')

Definition at line 113 of file computeFeature.py.

◆ required

required