8.2. Searching the Set Class Library for Names, Z-relations, and Super-Sets

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 pentacluster

To 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-15A

The 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