Readme for hdf-0.15

hdf - haskell data flow ----------------------- [Haskell][hs] library for uniform rate audio signal processing. It generates [C][c] code that requires either `RDL` (from [sc3-rdu][sc3-rdu]) or `jack-dl` (from [rju][rju]). The [SC2][sc2] [analog bubbles][ab] graph can be written: ~~~~ let o = lf_saw (mce2 8.0 7.23) 0.0 * 3.0 + 80.0 m = lf_saw 0.4 0.0 * 24.0 + o s = sin_osc (midi_cps m) 0.0 * 0.04 c = comb_n [0,1] 0.4 s 0.2 4.0 in out c ~~~~ The data flow graph this generates is: ![](sw/hdf/svg/analog-bubbles.svg) The generated C-code (for `jack-dl`) is [c/gen/analog-bubbles.c](sw/hdf/c/gen/analog-bubbles.c). Slightly more elaborate, the [berlin 1977][b7] graph can be written: ~~~~ let clock_rate = 9 clock_time = 1 / clock_rate clock = impulse clock_rate 0 -- sequencer trigger tr = trigger clock note = sequ 0 [55,60,63,62,60,67,63,58] tr -- midi note pattern sequencer tr_16 = pulse_divider tr 16 0 -- divide tr by 16 note' = sequ 1 [-12,-7,-5,0,2,5] tr_16 + note -- transpose freq = midi_cps note' -- convert midi note to cycles per second env = decay2 clock (0.05 * clock_time) (2 * clock_time) amp = env * 0.1 + 0.02 -- amplitude envelope filt = env * (sin_osc 0.17 0 * 800) + 1400 -- filter frequency pw = sin_osc (mce2 0.08 0.09) 0 * 0.45 + 0.5 -- pulse width LFO(s) s = lf_pulse freq 0 pw * amp -- not bandlimited in out (comb_n [0,1] 0.2 (rlpf s filt 0.15) (mce2 0.2 0.17) 1.5) ~~~~ The data flow graph this generates is: ![](sw/hdf/svg/berlin-1977.svg) The generated C-code (for `jack-dl`) is [c/gen/berlin-1977.c](sw/hdf/c/gen/berlin-1977.c). <!-- These are from the small set of example [graphs][ix]. --> hdf implements `text-dl` for testing. [hs]: http://haskell.org/ [c]: http://c2.com/cgi/wiki?CeeLanguage [sc3-rdu]: http://rd.slavepianos.org/?t=sc3-rdu [rju]: http://rd.slavepianos.org/?t=rju [ab]: sw/hsc3-graphs/gr/analog-bubbles.scd [b7]: sw/hsc3-graphs/gr/berlin-1977.scd [sc2]: http://audiosynth.com/ [ix]: http://rd.slavepianos.org/?t=hdf&e=md/ix.md © [rohan drape][rd], 2006-2014, [gpl] [rd]: http://rd.slavepianos.org/ [gpl]: http://gnu.org/copyleft/