PolyDocs: Distr_Test Options

Web Polygraph

Distr_Test documentation has been synchronized with Poly 1.2.2.

Polygraph has many built-in distributions. Often, it is handy to know how a particular distribution ``looks like''. Distr_Test dumps a histogram of a given distribution after drawing (sampling) a specified number of values from the distribution.

Distr_Test was introduced in Poly 1.2.2.

usage: distr_test [--option ...]
options:
help list of options
out <file> redirect console output
distr <str> distribution to test
hist_step <%> bin "size" in histogram output
count <int> number of trials (sample size)

Name:--out
Type:FileName
Default:console output

The out option allows you to specify a file where the results of the program execution should be sent.

Name:--distr
Type:NumDistr
Default:meas

The distr option specifies the distribution to sample. The syntax is identical to any other option that requires a distribution value. You must use plain numbers (i.e., no time or size scale) to specify distribution parameters (if any).

Note that drawn random values are truncated to integers before being accounted in a histogram. This approach mimics the usual Polygraph run-time behavior. However, a special care should be taken to specify large enough numbers as the parameters of the distribution.

Name:--hist_step
Type:string (comma separated list of names)
Default:no default

The hist_step option simply tells Polygraph the size of a histogram bin (in percents of the total contribution). For example, a value of 1% would lead to 100 lines per histogram while a 5% step results in 20 lines.

Name:--count
Type:int
Default:100,000

Count specifies how many samples Polygraph should take before producing the final histogram. Highly skewed and heavy tailed distributions usually require more samples to get a nice histogram.



$Id: distr_test_opts.sml,v 1.3 1999/05/21 06:51:14 rousskov Exp $