rvcat: Generate Categorical Random Variables

In jsta/rv: Simulation-Based Random Variable Objects

Description

Generates a random factor (i.e. a categorical random variable), given the probabilities of each category and their corresponding labels.

Usage

rvcat(n = 1, prob, levels = NULL)

Arguments

n	integer, number of random variables to generate
prob	vector of probabilities of successes of each trial (may be constant or an rv object)
levels	(character) labels for the categories

Details

The length of prob determines the number of bins.

The vector prob will be normalized to have sum 1.

Value

A random factor of length length(prob).

Author(s)

Jouni Kerman [e-mail]

References

Kerman, J. and Gelman, A. (2007). Manipulating and Summarizing Posterior Simulations Using Random Variable Objects. Statistics and Computing 17:3, 235-244.

See also vignette("rv").

See Also

rvfactor

Examples

  rvcat(1, prob=c(0.5, 0.3, 0.2)) # default levels: 1, 2, 3
  rvcat(1, prob=c(5, 3, 2)) # same as above
  p <- rvdirichlet(1, alpha=c(0.7, 0.3)) # prior probabilities
  rvcat(1, prob=p, levels=c("Group 1", "Group 2"))

jsta/rv documentation built on Feb. 12, 2022, 5:13 p.m.