RM-GEN

[GENERIC-FUNCTION]


OMTristan
Function Reference
ARGUMENTS:
  - funda Fundam a [default = 4800]
  - fundb Fundam b [default = 5400]
  - hqa Harm a [default = 2]
  - hqb Harm b [default = 3]
&optional
 
  - type Type [default = (quote chord)]
  - output Output [default = (quote excluded)]
  - unit Unit [default = (quote midic)]

Description:

Simulates the ring-modulation between the harmonic series on <funda> and the harmonic series on <fundb>. The arguments <hqa> and <hqb> determine the number of partials present for each fundamental. The frequencies of each partial of the harmonic series on <funda> is added to and subtracted from the frequency of each partial of the harmonic series on <fundb>; thus, all possible addition and difference tones are calculated.

If the arguments <hqa> or <hqb> are lists, only the listed partials will be included in the calculations.

The optional argument <unit> determines whether <funda> and <fundb> are given in midicents, ('midic'), or in hertz ('freq'). If 'freq' is selected entries and output are all in hertz.

The optional argument <type> is used to determine the format of the output. The value 'seq' returns a list of chords in which each successive chord represents the notes involving the next partial or partials. Thus the first chord contains: funda ± fundb; the second: 2*funda ± fundb, funda ± 2*fundb and 2*funda ± 2*fundb; etc. The value 'chord' returns a single chord containing all the notes of all the combinations and differences.

The optional argument <output> determines whether the notes <funda> and <fundb> are included ('inclu') or excluded ('exclu') from the output list or lists.



Auto doc generation by OpenMusic 7.0 © 2022 IRCAM