PlugInChain documentation - Universität Oldenburg

pressing the edit button for the pluginlist. This will open the file ‘Pluginlistname.cfg’ in the
MATLAB editor. In the current example, ‘Pluginlist.cfg’ is shown in the editor in the upper
right-hand side of Fig. 1.2. It was accessed by pressing the button edit just right of the field
displaying the loaded pluginlist.
The buttons on the right hand side of the listed plugins enable control over the initialization
file *_init.m and the processing main file *_main.m. They are only needed for developing new
plugins and to provide quick access for editing the plugin files. In the current example, the
main file of the plugin ‘plotData_main.m’ is shown on the lower right-hand side of Fig. 1.2..
It was accessed by pressing the button Main right of the field displaying the plugin ‘plotData’.
The plugin structure and corresponding files will be discussed in more detail in section 3.
1.2.4 Signal processing control
The button Start can be used to start the signal processing of the PlugInChain. First, all plugins
are initialized by calling the function pluginname_init.m of all plugins from the frameworks
base function pluginchain_init.m. The first plugin ‘readData’ is reading during initialization
phase the needed parameters for building up the ‘signal’ structure (e.g. from the header
of a wav-file). The processing of the input signal is then performed by calling the function
pluginname_main.m of each plugin from the frameworks processing file pluginchain_process.m,
whereas the function readData_main.m reads the signal data and stores it in
the ‘signal’ structure of the PlugInChain. The execution of the PlugInChain can be stopped by
pressing the button Stop. Note that under MATLAB this is only possible between different
processing steps and will not break a long calculation.
1.2.5 Batch processing
Each plugin is initialized with loading the configuration parameters from the configuration
file (see lower right-hand side of Fig. 1.2). So far, a parameter was assigned exactly one value.
If the PlugInChain should process data with several different values for a specific configuration
parameter, a ‘batch variable’ can be used. A batch variable can be defined by appending
the character # at the end of the parameter name. For example the configuration parameter
myVariable=0.3 can be defined as a batch variable myVariable# = {0.3,0.4,0.5}, whereby
its multiple values (alphanumerical) need brackets ‘{}‘ and are stored in a cell array.
It's also possible to use MATLAB code to initialize parameters. The batch processing can, e.g.
be really useful if several audio files should be processed. Assume that the text file ‘batch.txt’
contains a list of audio files as shown in Fig. 1.3.
1: ./waves/PeterHahne_kurz.wav
2: ./waves/PeterHahne.wav
3: ./waves/TestMeddis.wav
4: ./waves/testsinmod.wav
Figure 1.3: Text file batch.txt containing a list of audio files.
Typing the following line in the configuration file
targetname# = textread('batch.txt',[char(37),'s'],'delimiter','\n');
loads the file batch.txt into the batch variable targetname#.
8