OpenMusic Reference
famille
famille
(Zn module) -- returns a set complex of cardinality k
Syntax
famille n familly k howmany
Inputs
| name | data type(s) | comments |
|---|---|---|
| n | an integer | must be more than 2; defaults to 12 |
| familly | menu | the type of pitch set (set complex) to return. 6 options: tac , tai , tic , ttl , tp , tid. |
| k | a positive integer | defaults to 6; must be no larger than n /2 |
| howmany | a positive integer | allows you to limit the number of answers returned (the size of the set complex). Setting this value higher than the maximum number of possible sets may cause the function to return nil |
Output
| output | data type(s) | comments |
|---|---|---|
| first | a set complex: a tree representing a list of set classes |
Description
IN-DEPTH DESCRIPTION
famille produces pitch sets with certain properties, depending on your choice at the familly menu input. The calculation will be made in 12-tone space by default. To use other subdivisions of the octave as a base, set a new value at the n input. The sets will all have cardinality k . ( k elements). k must be less than or equal to half of n .
The howmany input allows you to limit the size of the set complex, i.e. the number of sets returned. Setting this higher than the maximum size of the complex may cause famille to return nil.
The familly menu input allows you to choose what kind of sets will be returned, i.e. what the unifying characteristic of the set complex will be. There are six families of pitch set available (some of the names are funny because they are acronyms for French terms):
-
tac - auto-complementary - set whose complement has the same intervallic structure.
-
tai - auto-inverse - set whose inversion has the same intervallic structure.
-
tic - inverse-complementary - set where some transposition of its inversion is identical to its complement.
-
ttl - limited transposition - set where one or more transpositions of the set yield the same pitch classes.
-
tp - partitioning - a set which partitions the octave into non-overlapping segments. The octave may thus be completely covered by one or more transpositions of the set, with no transpositions sharing any tones.
-
tid - idempotent - a set which is idempotent produces the same pitch classes when transposed to start on any of its members. In other words, all common-tone transpositions of the set are identical.
Examples
For examples, see the Zn tutorials.
| Prev | Home | Next |
|---|---|---|
| factorize | Up | fibo-ser |