NavigationContext

One of the types of objects in Praat. The NavigationContext contains the information that the TextGridNavigator needs to search for a match on one tier of a TextGrid.

## What is inside a NavigationContext?

Topic label set
  defines the labels that we want to find. As an example consider the following set of vowel labels { "u", "o", "a", "i", "e" }. Our intention is to find only those intervals in the specified tier of the TextGrid that match with one of these labels.
Topic match criterion
  defines the type of match you want. To name just a few of the possible options: is equal to or is not equal to or contains or does not contain or starts with or does not start with. Many more match criteria can be chosen and these criteria come in pairs where the second one of the pair is the negation of the first.
Combine topic matches with
  defines whether the match criteria of the labels in the topic set have to be combined by OR or by AND. Consider the topic set defined above. If the topic match criterion chosen was is equal to then we would want the match for the current interval label in the tier to succeeed only if the expression (currentLabel$ = "u" OR currentLabel$ = "o" OR currentLabel$ = "a" OR currentLabel$ = "i" OR currentLabel$ = "e") evaluates as true, i.e. if one of the labels of the topic set matches the current label in the tier then we would have a match. On the other hand, if the chosen match criterium were the opposite, not equal to, then we would want our match for the current interval label to succeed only if the expression (currentLabel$ ≠ "u" AND currentLabel$ ≠ "o" AND currentLabel$ ≠ "a" AND currentLabel$ ≠ "i" AND currentLabel$ ≠ "e") evaluates as true. Therefore, in general, for labels that are single words, a positive match criterion, like is equal to, we would choose OR while for a negative match criterion, like is not equal to we would choose AND. However, for labels that are multi-word both AND as well as OR combinations can be useful.
Before label set
  defines the labels that the label of the preceding interval has to match if the current interval label matches the topic label set. This makes the search context-sensitive because it is not enough that the current interval label matches (in a specified way) the topic set but also the label of the preceding interval has to match the before set. If, for example, the before set contains "p", "t" and "k" then in combination with the topic labels defined above this would limit the search to only those vowels that are preceded by a plosive.
Combine before matches with
  defines, just like for the topic match criterion, the kind of match you are looking for only now for the labels of the before set.
Before match boolean
  defines, also in analogy with the description of the topic match boolean, the relation between the matches of the labels in the before set.
After label set
  defines the labels that the label of the following interval has to match if the current interval label matches the topic label set. An example set could consist of "m" and "n". In combination with the topic set we would search for vowels followed by a nasal.
After match criterion and Combine after matches with
  have the same meaning as defined above for the topic and before sets.
Context combination criterion
  defines how the before and after sets have to be combined in the matching. The possible options are before, or after or before and after or before or after, not both or before or after, or both or finally no before and no after. Given the topic, before and after labels examples defined above, choosing before and after would limit the search to vowels preceded by a plosive and followed by a nasal.
Exclude topic labels boolean
  when on, only the before and / or the after label set will be used in matching. Of course this effect could also be reached by leaving the topic set empty.

### Links to this page

- TextGrid: To TextGridNavigator...
- TextGridNavigator & TextGrid: Add search tier...