7 releases

0.1.6	Mar 23, 2021
0.1.5	Mar 23, 2021

#18 in #gaussian

MIT license

16KB
357 lines

randcli

CLI as a Pseudo Random Number Generator

How?

$ rand 'gauss'
0.7164763224859116  # ~ Gaussian(mu=0, vr=1)
# 'gauss' is same to 'gauss()' or 'gauss(0, 1)'

$ rand 'gauss(1, 100)'
3.6845312036504216  # ~ Gaussian(mu=1, vr=100)

$ rand 'seed(42) | gauss(0, 100)'
8.327121583181412  # ~ Gaussian(0, 1) with fixed seed=42

$ rand 'seed(42) | gauss(0, 100) | int'
8  # Truncated into Int

Functions

Category	Name	Effect	Type	Default Args	Example
Seed	seed	Set Random Seed	unsigned int -> () -> ()		`seed(42)`
Truncate	int	Truncate a float into int	() -> number -> int		`int`
..	floor	same to `int`	() -> number -> int		`floor`
..	round	trancate into nearst int	() -> number -> int		`round`
Distribution	gauss	Gaussian Distribution (mean, variance)	(number, number) -> () -> number	(0, 1)	`gauss()` `gauss(0, 1)`
..	uniform	Uniform Distribution of [min, max)	(number, number) -> () -> number	(0, 1)	`uniform(1, 2)`
..	exp	Exponential Distribution (lambda)	number -> () -> number	1	`exp(0.5)`
..	binom	Binomial Distribution (n, p)	(unsigned int, number) -> () -> number		`binom(10, 0.5)`
..	bernoulli	Alias to `binom(1, p)`	number -> () -> number	0.5	`bernoulli(0.5)`

Type Notation forms X -> Y -> Z, which means

It requires X data as arguments
- E.g. 42 for seed(42)
And then catches Y data from the previous pipe |
- E.g. int function reads a number data from the previous functions
Lastly outputs Z data
- E.g. Distribution functions will output a number data

Type () is None data.

Install

cargo install randcli

Dependencies

~6.5MB
~113K SLoC