[ Table Of Contents | Keyword Index ]

tclassp_spectrum(n) 0.5 doc "tclassp - Spectral analysis"


tclassp_spectrum - tclassp spectrum

Table Of Contents



Short-term spectral analysis of the signal in <file> using the Fast Fourier Transform. The default is to calculate unsmoothed narrow-band spectra with the size of the analysis window equal to the length of the FFT. The output from the FFT will be converted to a power spectrum in dB from 0 Hz up to and including the Nyquist rate. Alternatively, the utility can calculate smoothed spectra or cepstra. In the latter case the number of coefficients per output record will also equal the FFT length / 2 + 1 (i.e. be non-mirrored). ::tclassp::spectrum is an ASSP AOPTS command and takes the following general form .

::tclassp::spectrum method ?arg arg ...?


All AOPTS subcommands are implemented.

::tclassp::spectrum cget option

Returns the current setting of the option option. option may be any option appropraite for the underlying analysis function, see OPTIONS below.

::tclassp::spectrum configure option ?value? ?option? ?value?

For each option-value pair sets option to value. If the last option is missing its corresponding value the current value is returned. option may be any option appropraite for the underlying analysis function, see OPTIONS below.

Currently not standard behaviour, will be changed

::tclassp::spectrum exec fileNameList

Performs spectral analysis on all files whose names are given in FileNameList. FileNameList must be a proper Tcl list. Returns the number of files processed successfully

::tclassp::spectrum info

This command returns a list of information on the AOPTS command. The first three elements of the list are

  1. the name of the analysis function

  2. the major version number

  3. the minor version number

The remaining elements consist of key-value pairs listing all available options of the analysis function and the the option type. Option type is useful for the creation of graphical user interfaces and may be:

  • bool: Options with a boolean value, best represented with check boxes

  • text: Options with a more or less free value, best represented with entry fields

  • radio: Options with a short range of fixed values, best represented by radio buttons

  • combo: Options with longer ranges of fixed values, best represented by combo boxes

  • spin: Options with continuos numerical value ranges, best represented by spin boxes

tkassp makes use of these otpion types to generate GUIs more or less automatically. In some cases, option type is the empty string to indicate that the option is not to be used in a GUI in the same way as the other options, see OPTIONS for details.

::tclassp::spectrum reset

Resets all options to the default.

::tclassp::spectrum version

Returns the version of the ASSP analysis function.


The following options do not affect the resulting analysis. They do not have an option type as defined for the AOPTSname info command. These options are available for all analysis commands.

-extension outputExtension

Defines the value of the output extension when the analysis result is written to file. Defaults to the value of -spectType in lower case.

-outDir outputDirectory

Defines the directory in which the resulting file (if any) is stored. Defaults to the working directory (pwd).

-counter counterVariable

If counterVariable is a fully qualified variable name, it is incremented each time the AOPTSname exec command finishes processing a file. This is useful to track the progress of the analysis especially for long file lists. If counterVariable is empty (the default) no counting is performed.

-stop stopVariable

If stopVariable is a fully qualified variable name, it is read each time the AOPTSname exec command start processing a file. Setting stopVariable to true will cause the abortion of the running AOPTSname exec command. This is useful if the necessity to abort time-consuming processes of of long file lists should arise. If stopVariable is the empty string (the default) aborting processes is not possible.

The following options will affect the results of the anaysis functions. Some are available in all ASSP analysis functions but not in all of them:

-begin beginTime

Start time of the analysis in ms. Defaults to begin of signal.

-end endTime

End time of the analysis in ms. Defaults to end of signal.

-central useCenterTime

If useCenterTime is true, a single frame analysis with the analysis window centered at the time specified in -begin will be performed. Overrules specifications of -end and -winShift. Defaults to false.

-spectType type

Set type of spectral analysis to type. type maybe:

  • "DFT": unsmoothed spectrum (default)

  • "LPS": Linear Prediction smoothed spectrum

  • "CSS": cepstral smoothed spectrum

  • "CEP": cepstrum

-resolution frequency

set FFT length to the smallest value which results in a frequency resolution of frequency Hz or better (default: 40.0)

-fftLength number

Set FFT length to number points (overrules default settings and -resolution option)

-winSize windowSize

Specifies the length of the anaysis window in ms.

-effLength useEffectivLength

Boolean value determining whether -winSize is interpreted as the effective or as the exact length of the analysis window.

-winShift windowShift

Specifies the size of the window shift in ms.

-window windowFunction

Specifies the code name of the window function to use. Valid window functions are listed in the tclassp manual page.

-bandwidth bandwidth

Sets analysis bandwidth to bandwidth Hz. Defaults to 0 Hz.


This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category tclassp of the ASSP Library Tracker. Please also report any ideas for enhancements you may have for either package and/or documentation.

See Also