Merge pull request #506 from andrewcsmith/patch-2
[supercollider.git] / HelpSource / Classes / StandardL.schelp
blob1bc448ff0091e3328c850738457798341f3f2bec
1 class:: StandardL
2 summary:: Standard map chaotic generator
3 categories:: UGens>Generators>Chaotic
4 related:: Classes/StandardN
6 description::
7 A linear-interpolating sound generator based on the difference equations:
9 code::
10         x[n+1] = (x[n] + y[n+1]) % 2pi
11         y[n+1] = (y[n] + k * sin(x[n])) % 2pi
13 warning:: revise formulae conversion to c like code ::
15 The standard map is an area preserving map of a cylinder discovered by the plasma physicist Boris Chirikov.
17 classmethods::
18 method:: ar
19 argument:: freq
20 Iteration frequency in Hertz
21 argument:: k
22 Perturbation amount
23 argument:: xi
24 Initial value of x
25 argument:: yi
26 Initial value of y
28 examples::
29 code::
30 // vary frequency
31 { StandardL.ar(MouseX.kr(20, SampleRate.ir)) * 0.3 }.play(s);
34 code::
35 // mouse-controlled param
36 { StandardL.ar(SampleRate.ir/2, MouseX.kr(0.9,4)) * 0.3 }.play(s);
39 code::
40 // as a frequency control
41 { SinOsc.ar(StandardL.ar(40, MouseX.kr(0.9,4))*800+900)*0.4 }.play(s);