Sound.SC3.Lang.Random.Gen

RandomGen based sclang random number functions.

Documentation

rand :: (RandomGen g, Random n, Num n) => n -> g -> (n, g)

SimpleNumber.rand is randomR in (0,n).

kvariant :: Int -> (g -> (a, g)) -> g -> ([a], g)

Construct variant of f generating k values.

nrand :: (RandomGen g, Random n, Num n) => Int -> n -> g -> ([n], g)

Variant of rand generating k values.

 fst (nrand 10 (5::Int) (mkStdGen 246873)) == [0,5,4,0,4,5,3,2,3,1]

rand2 :: (RandomGen g, Random n, Num n) => n -> g -> (n, g)

SimpleNumber.rand2 is randomR in (-n,n).

nrand2 :: (RandomGen g, Random a, Num a) => Int -> a -> g -> ([a], g)

Variant of rand2 generating k values.

rrand :: (Random n, RandomGen g) => n -> n -> g -> (n, g)

SimpleNumber.rrand is curry randomR.

nrrand :: (RandomGen g, Random a, Num a) => Int -> a -> a -> g -> ([a], g)

Variant of rrand generating k values.

choose :: RandomGen g => [a] -> g -> (a, g)

SequenceableCollection.choose selects an element at random.

nchoose :: RandomGen g => Int -> [a] -> g -> ([a], g)

Variant of choose generating k values.

exprand :: (Floating n, Random n, RandomGen g) => n -> n -> g -> (n, g)

SimpleNumber.exprand generates exponentially distributed random number in the given interval.

nexprand :: (Floating n, Random n, RandomGen g) => Int -> n -> n -> g -> ([n], g)

Variant of exprand generating k values.

coin :: (RandomGen g, Random a, Ord a, Fractional a) => a -> g -> (Bool, g)

SimpleNumber.coin is True at given probability, which is in range (0,1).

ncoin :: (RandomGen g, Random a, Ord a, Fractional a) => Int -> a -> g -> ([Bool], g)

Variant of coin generating k values.

 fst (ncoin 5 0.5 (mkStdGen 0)) == [True,True,False,True,False]

scramble :: RandomGen g => [t] -> g -> ([t], g)

List.scramble shuffles the elements.

 fst (scramble [1..5] (mkStdGen 0)) == [1,5,2,3,4]

wchoose :: (RandomGen g, Random a, Ord a, Fractional a) => [b] -> [a] -> g -> (b, g)

SequenceableCollection.wchoose selects an element from a list given a list of weights which sum to 1.