fleximeter

2. Command List

Commands are displayed in verbose form, followed by a short form in parentheses. Obviously, a user will prefer the short form for efficiency. If you use a command that is unavailable, the program will display an error message. (For example, you cannot display an interval-class vector for an ordered pcseg, or a twelve-tone matrix for an unordered pcset.)

Pitch classes are displayed in integer notation (0123456789AB). While the program always displays A and B in uppercase, pitch-class input is not case-sensitive. Microtonal pitch-classes are displayed as 2-digit integers (00, 01, 02, ..., 21, 22, 23). Pitches are displayed as integers, where middle C is 0, pitches below middle C are negative, and pitches above middle C are positive. When entering pitch-classes, individual pcs should not be separated by space or comma. When entering pitches or microtonal pitch-classes, individual pitches should be separated by a comma and no space. For example, 59B is a pc-string and -5,0,10,15 is a p-string.

When working with unordered pitch-class collections, pcsets do not need to be in the prime form for their set-classes. However, all transformations are performed on the current pcset. If you want all transformations to be relative to the prime form of a set-class, you will need to load a prime form either by entering it manually using the load command, or automatically using the load prime command.

Commands marked with a * may be followed by a pc-string or p-string. The only commands that change the collection currently in memory are the Load commands; therefore, a command like info 015 will not change the set that is currently being stored.

2.1. Commands for all collections

*info, n	Displays the current collection.
*load, l	Input a new collection.
*search, h	Input pitches or pitch-classes to find all transformations that produce a collection with the provided pitches or pitch-classes. Order only matters for pcsegs and psegs. If you include a pitch (or pitches) after the “Search” command, it will search for the provided input. Otherwise, you will enter continuous search mode, where you can perform multiple searches – type 'q' to quit.

2.2. Commands for csegs

*matrix, mx	Display COM matrix. If no parameters are provided, the COM matrix will compare the current cseg with itself. If one parameter is provided, that cseg will be compared with the current cseg. If two parameters are provided, those two csegs will be compared with each other.
*load prime, lp	Convert current cseg to cseg-class prime form. If you include pitches after the LP command, the LP command loads a new cseg and converts it to the prime form of its cseg-class.

2.3. Commands for ordered collections

bip	Displays the BIP for cardinality n. The cardinality may be provided as an argument.
*complement, c	Display complement (pcsegs only). Complements are provided as unordered pcsets.
imb	Display list of consecutive imbricated set-classes of cardinality n. The cardinality may be provided as an argument.
*intervals, int	Displays the interval sequence of the collection. This command may be followed by a transformation name to get the interval sequence of that transformation.
*subsegs, s	Display all subsegs of the current collection.
*validate row renerator, vrg	Determines if an interval sequence in p- or pc-space would produce a segment with no duplicated pitch-classes. Useful for validating rows or subsegs of rows.

2.4. Commands for pcsets

*angle	Calculate the angle¹ between two pcsets. You can provide the two pcsets after the Angle command, separated by a space. Otherwise, you will be prompted to enter the pcsets.
calculate, cc	A continuous search mode for pcset-class prime forms. This feature is useful if you are not sure how to organize pitch-classes for analysis. Type 'q' to quit. The last pcset entered is stored in memory.
*complement, c	Display complement.
complement prime, cp	Display complement set-class in prime form.
*k	Display set-class complex K.
*kh	Display set-class complex Kh.
*info, n	For all pcsets, this command displays the prime form, Forte name, Carter name, interval-class vector, complement prime form, and Z-relation prime form (if any).
*intersect max, ix	Displays the intersection of two sets. Rather than merely intersecting both sets, the second set will be transposed and/or inverted to create the largest intersection possible.
*interval-class vector, icv	Display interval-class vector for current set.
*load prime, lp	Convert current pcset to set-class prime form. If you include pitches after the LP command, the LP command loads a new set and converts it to the prime form of its set-class. For example, LP 83B9 loads set-class [0137], one of the two all-interval tetrachord set-classes.
*subsets prime, sp	Display the prime form of each set-class contained as a subset of the current pcset, along with the number of occurrences of each set-class.
*union compact, uc	Displays the union of two sets. Rather than merely combining both sets, the second set will be transposed and/or inverted to create the most compact union possible.
*z-relation, z	Display Z-related set-class in prime form.

2.5. Commands for rows

load random, lr	Loads a random twelve-tone pcseg (row).
load random air, lair	Loads a random all-interval twelve-tone row.
matrix, mx	Display matrix of twelve-tone row.

2.6. Commands for unordered collections

*intersect, in	Displays the intersection of two sets. If only one set is provided with the command, that set is intersected with the current set. If two sets are provided, those two are intersected. If no sets are provided, you will be prompted to enter two sets to intersect.
*subsets, s	Display all subsets of the current collection.
*union, u	Displays the union of two sets. If only one set is provided with the command, that set is combined with the current set. If two sets are provided, those two are combined. If no sets are provided, you will be prompted to enter two sets to combine.

2.7. General commands

mode c	Enter contour mode, for working with c-pitches. Contour mode automatically enables ordered mode as well.
mode forte, mode f	Prefer Forte names for pc set-classes
mode l	Calculate set-class prime forms by packing to the left
mode prime, mode n	Prefer prime form names for pc set-classes. The program defaults to this mode on startup.
mode o	Enter ordered mode.
mode om	Enter ordered mode for 24-tone microtonal pitch-classes.
mode op	Enter ordered mode for pitches.
mode opc	Enter ordered mode for 12-tone pitch-classes.
mode p	Enter pitch mode.
mode pc	Enter pitch-class mode. The program defaults to this mode on startup.
mode r	Calculate set-class prime forms by packing from the right. The program defaults to this mode on startup.
mode u	Enter unordered mode. The program defaults to this mode on startup.
mode um	Enter unordered mode for 24-tone microtonal pitch-classes.
mode up	Enter unordered mode for pitches.
mode upc	Enter unordered mode for 12-tone pitch-classes.
quit, q	Exit the program.

2.8. Transformations (case sensitive)

Transformations may be performed together as a command string. The last transformation in the string will be performed first, then the next-to-last transformation, and so forth. You must include an integer with the M and T transformations. M is not automatically interpreted as M₅. For example, the transformation string M7T9I first inverts the collection, then transposes it by 9, and finally multiplies it by 7. If the collection is unordered, the result of the transformation will be displayed in sorted order. Also note that all transformations are performed mod 12. Therefore, T85 produces the same result as T1. Transpositions of pcsets are performed on the provided set – if you intend to transform relative to the prime form of a set-class, you must load a prime form. Negative numbers are not supported.

Multiple transformation strings may be performed simultaneously. For example, if you enter T5M5I IM7T5I at the prompt, both transformation strings will be evaluated individually, and the results will be displayed in a list. This is useful if you wish to compare the results of different transformation strings.

You can also provide a specific collection as the final item in a list of transformation strings. For example, T5M5I 08A1 transforms {08A1} by T₅M₅I. If you are in unordered pc-mode, 08A1 will be evaluated as a pcset. In ordered pc-mode, 08A1 will be evaluated as a pcseg, and so forth. This feature makes it possible to transform subsidiary collections without changing what is currently stored in memory.

I	Invert (same as M11). This is a TTO.
Mn	Multiply. Supports any multiplier that is an integer. This is a TTO if the multiplier is 1, 5, 7, or 11.
R	Retrograde (ordered collections only)
rn	Rotate (ordered collections only)
Tn	Transpose. This is a TTO.

Notes

¹Damon Scott and Eric J. Isaacson, "The Interval Angle: A Similarity Measure for Pitch-Class Sets," Perspectives of New Music 36:2 (Summer, 1998), 107-142.