gRbase (version 2.0.3)

api-tabNew: Create multidimensional arrays

Description

Alternative ways of creating arrays

Usage

tabNew(names, levels, values, normalize = "none", smooth = 0)

Value

An array.

Arguments

names

Names of variables defining table; either a character vector or a right hand sided formula.

levels

1. a list with specification of the levels of the factors in names or 2) a vector with number of levels of the factors in names. See 'examples' below.

values

values to go into the array.

normalize

Either "none", "first" or "all". Should result be normalized, see 'Details' below.

smooth

Should values be smoothed, see 'Details' below.

Author

Søren Højsgaard,

Details

1. If normalize="first" then for each configuration of all other variables than the first, the probabilities are normalized to sum to one. Thus f(a, b, c) becomes a conditional probability table of the form p(a | b, c).

2. If normalize="all" then the sum over all entries of f(a,b,c) is one.

3. If smooth is positive then smooth is added to values BEFORE normalization takes place.

Examples

universe <- list(gender=c('male', 'female'),
                 answer=c('yes', 'no'),
                 rain=c('yes', 'no'))
t1 <- tabNew(c("gender", "answer"), levels=universe, values=1:4)
t1
t2 <- tabNew(~gender:answer, levels=universe, values=1:4)
t2
t3 <- tabNew(~gender:answer, c(2, 2), values=1:4)
t3