This plugin provides features for iterating through an arbitrarily complex sets of objects. They are provided both as procedures, to make it easier to write scripts that use those iterative features, and as scripts, to encapsulate the most commonly needed applications.
Install using CPrAN:
cpran install vieweach
You can download an archive of the latest version for manual installation, but you’ll have to also manually install the dependencies yourself. You can manually install the plugin just like any other Praat plugin.
The procedures are written in such a way that their behaviour can be almost completely redefined by means of procedure redefinition, which is a way to implement something akin to code hooks in Praat.
In simple terms, this means that the code that gets executed at specific times during the iteration are designed to be modified. This makes the procedures incredibly versatile.
The first set of procedures (
the core iterative features, which uses
Strings objects to
represent sets of objects to iterate over. This makes it possible to seamlessly
iterate over objects that reside in the Object list, on disk, or in a
combination of both.
The second set of procedures (
demonstrates one possible application of
for_each to allow for easy navigation
both back and forth over the specified (sets of) objects, opening the
appropriate editor window for each when available.
The first one will execute a specified script during each
iteration, and select all the objects created over those iterations at the end.
The script also makes it possible to specify whether the iteration should be
done directly over the selected objects, by selecting one object per type for
each iteration, or by using the selected objects (either
objects) as sets of objects.
As an example, if told to iterate over the selected objects, and given a script with the instructions
name$ = extractWord$(selected$(), " ") Copy: name$
then the resulting selection after completion would be a copy of all the initially selected objects.
The second comes in two flavours, and will iterate over either objects in the
[Object list] or [on disk] and provide an editor for each, if applicable. If
the selection includes only
TextGrid objects, then the script will
automatically pair these for each iteration. The navigation over the objects is
robust enough to support the deletion of objects with no ill effects.
The provided scripts and the tests provide a good example of the versatility made possible thanks to procedure redefinition. Take a look at the code for ideas, or visit the wiki for the full documentation of the available hooks and start writing your own scripts!