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 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