User Manual

SEARCHING
543
When you choose Events must match all settings,
the Search command will include an event in the
search results only if it matches all of the settings in
the group. In the example below, the only notes that
will be found by the search are ones whose pitch is
between C3 and C4 AND whose on-velocity is less
than 64 AND whose duration is less than 1|000.
Figure 46-6: Grouping search settings. In this example, only notes
that match all the settings will be found by the search. Combining
groups with other settings/groups
Grouping can be a powerful tool for finding exactly
what you are looking for in your searches. When
you use the Events must match all settings option in
a group, you are basically making the group act as a
single unit in qualifying data for the search. In
other words, when you combine it with other
individual search settings within its enclosing
group — or even other groups — it will following
the same logic as if it were an individual setting.
Controlling search logic with groups
Grouping can be used to create logical distinctions
between search settings. Consider the following
example. Let’s say you wanted to find all notes that
are out of range for a certain instrument. So you
enter the settings shown below.
But now lets say that you wanted to further restrict
the above search to notes with a duration less that 1
beat. If you just added a duration setting without
grouping, as shown below, you would not get the
result you want because the duration setting would
select any notes with a duration less that 1 beat, not
just ones above C4 and below C1.
You would not be able to fix this problem by
changing the Events may match any settings option
to Events must match all settings because you would
end up with a invalid search: you’d be searching for
notes that are both above C4 and below C1 at the
same time — an impossibility.
By grouping the settings as shown below, however,
you set up a search logic that is exactly what you
want:
As you can see, this setup is like saying “I want all
notes whose durations are less than 1 beat AND
whose pitch is EITHER above C4 OR below C1.”
Nesting grouped settings
Groups of settings can be nested as deeply as you
need to achieve the search logic you want, as shown
below in Figure 46-7. Just remember: to make the
group act as a whole (e.g. all of the settings within
the group must be met before data will be included
in the search result), use the Events must match all