Epi (version 2.56)

mat2pol: Plot columns of a matrix as stacked areas.

Description

matrix to polygon: Plot columns of a matrix as stacked areas.

Usage

mat2pol( pm,
       perm = 1:ncol(pm),
          x = as.numeric(rownames(pm)),
        col = rainbow(ncol(pm)),
         yl = 0:1,
     append = FALSE,
        ... )

Value

A matrix of ncol(pm)+1 columns with the first equal to 0, and the remaining the cumulative sum of the columns of

pm[perm].

The function is called for its side effect - the stacked polygons.

Arguments

pm

Numerical matrix.

perm

integer vector of length ncol(pm), used to permute the columns of pm.

x

Numeric. The x-axis of the plot.

col

Colors of the areas.

yl

y-axis limits.

append

Logical. Should the polygons be added to an exiating plot

...

Further parameters passed to plot.

Author

Bendix Carstensen

Details

The function is originally intended to plot stacked probabilities, hence the default of 0:1 for the y-axis.

Examples

M <- cbind( sort(runif(10)), sort(runif(10)), sort(runif(10)) )
pm <- sweep( M, 1, apply(M,1,sum), "/" )
mat2pol( pm )