geometric¶

Syntax¶

geometric(mean)

Parameters¶

mean: A numeric expression representing the mean value for the distribution.

Returns¶

Returns an integral number consistent with a geometric distribution.

Description¶

This action returns a variate of a geometric distribution. This distribution is described at the link http://www.cplusplus.com/reference/random/geometric_distribution/, and produces random positive random integers where each value represents the number of unsuccessful trials before a first success in a sequence of trials, each with a probability of success equal to the given mean.

The action returns a single value for the current agent that is consistent with the distribution. Over a large number of agents, the returned values will collectively represent the specified distribution.

Examples¶

The following state will make entering agents collectively wait with a geometric distribution of individual hourly wait times.

state Test {
    wait(geometric(1 / 0.3))
    default(Excluded)
}

The following uses the same distribution to produce daily rather than hourly wait times.

state Test {
    wait(24 * geometric(1 / 0.3))
    default(Excluded)
}