Epi (version 2.41)

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

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.

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.

Details

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

Examples

# NOT RUN {
M <- cbind( sort(runif(10)), sort(runif(10)), sort(runif(10)) )
pm <- sweep( M, 1, apply(M,1,sum), "/" )
mat2pol( pm )
# }