| athenaCL Tutorial Manual: Second Edition, Version 1.4.8 | ||
|---|---|---|
| Prev | Chapter 8. Tutorial 8: Tools for Pitch Analysis | Next |
The SCf command, for SetClass Find, allows the user to search the entire set class library. There are three kinds of searches available: search by name, by Z-relation, and by super-set.
For example, to search for all sets that have the word "blues" in their known titles, enter the command SCf, select "n" for search by name, and enter a search string:
Example 8-4. Searching for a set by name
[PI()TI()] :: scf
select a find method: name, z-relation, or super-sets? (n, z, s): n
enter a search string: blues
found 9 sets with matching names:
{set,value}
9-7A nonatonic blues
8-26 blues, Spanish phrygian
8-23 Greek, blues, quartal octachord, diatonic octad
8-13A blues octatonic
8-11B blues octatonic
7-27B modified blues
6-47B blues scale
5-35 major pentatonic, black-key scale, blues pentatonic,
slendro, quartal pentamirror
5-4A blues pentaclusterTo search the set class library for all sets with a Z relation, enter SCf followed by "z". This displays each set and its corresponding Z-related pair.
Example 8-5. Viewing all z-related pairs
[PI()TI()] :: scf
select a find method: name, z-relation, or super-sets? (n, z, s): z
found 46 z-related sets:
{set,value}
4-15A 4-29A
4-29A 4-15A
5-12 5-36A
5-17 5-37
5-18A 5-38A
5-36A 5-12
5-37 5-17
5-38A 5-18A
6-3A 6-36A
6-4 6-37
6-6 6-38
6-10A 6-39A
6-11A 6-40A
6-12A 6-41A
6-13 6-42
6-17A 6-43A
6-19A 6-44A
6-23 6-45
6-24A 6-46A
6-25A 6-47A
6-26 6-48
6-28 6-49
6-29 6-50
6-36A 6-3A
6-37 6-4
6-38 6-6
6-39A 6-10A
6-40A 6-11A
6-41A 6-12A
6-42 6-13
6-43A 6-17A
6-44A 6-19A
6-45 6-23
6-46A 6-24A
6-47A 6-25A
6-48 6-26
6-49 6-28
6-50 6-29
7-12 7-36A
7-17 7-37
7-18A 7-38A
7-36A 7-12
7-37 7-17
7-38A 7-18A
8-15A 8-29A
8-29A 8-15AThe SCf command can also search for super-sets, all sets with a particular subset. That is, given a set, SCf can find all sets that have this set as a subset, and produce a ranked list of results. In the example below the user finds all sets the have set 6-40 as a sub-set. The value given for each set is the number of times the sub-set is embedded.
Example 8-6. Viewing superset data
[PI()TI()] :: scf
select a find method: name, z-relation, or super-sets? (n, z, s): s
select a sub-set to search...
enter a pitch set, sieve, or set-class: 6-40
SC 6-40A as (C4,C#4,D4,D#4,F4,G#4)? (y, n, or cancel): y
found 41 super-sets containing 6-40A:
{set,value}
12-1 24
11-1 12
10-3 6
10-2 6
10-5 6
10-1 6
10-4 4
10-6 4
9-9 4
9-7A 3
9-2A 3
9-3A 3
9-1 2
8-23 2
8-3 2
9-6 2
9-5A 2
8-6 2
8-7 2
9-4A 2
9-10 2
8-10 2
8-11A 1
8-13A 1
8-12A 1
8-14A 1
7-14A 1
7-23A 1
8-15A 1
8-16A 1
9-8A 1
8-18A 1
7-10A 1
8-2A 1
7-18A 1
8-22A 1
6-40A 1
7-3A 1
8-4A 1
7-36A 1
9-11A 1