rv (version 2.3.1)

rvfactor: Categorical Random Variables (Random Factors)

Description

Creates or tests for objects of type ``rvfactor''.

Usage

rvfactor(x, ...) "rvfactor"(x, levels=NULL, ...) is.rvfactor(x) "as.rv"(x, ...) as.rvfactor(x, ...) "print"(x, all.levels=FALSE, ...)

Arguments

x

object to be coerced or tested.

levels

factor levels (labels for the levels)

all.levels

logical; whether to print all levels or not (see below for details)

...

other arguments

Value

rvfactor: an rvfactor object.is.rvfactor: TRUE or FALSE.as.rv.rvfactor: an rv object.as.rvfactor.rv: an rvfactor object.

Details

Internally random factors are integer-valued just like regular factors in R.

The number of levels to print when all.levels==FALSE can be set by rvpar(max.levels=...). By default this is set to 10.

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").

Examples

  # Probabilities of each integer of trunc(Z) where Z ~ N(0,1) ?
  x <- rvnorm(1)
  rvfactor(trunc(x))
  rvfactor(x>0)
  rvfactor(rvpois(1, lambda=0.5))