Learn R Programming

plyr (version 1.5.2)

maply: Call function with arguments in array or data frame, returning an array.

Description

Call function with arguments in array or data frame, returning an array. Call a multi-argument function with values taken from columns of an data frame or array, and combine results into an array

Usage

maply(.data, .fun, ..., .expand=TRUE, .progress="none",
    .parallel=FALSE)

Arguments

.data
matrix or data frame to use as source of arguments
.fun
function to be called with varying arguments
...
other arguments passed on to .fun
.expand
should output be 1d (expand = FALSE), with an element for each row; or nd (expand = TRUE), with a dimension for each variable.
.progress
name of the progress bar to use, see create_progress_bar
.parallel
if TRUE, apply function in parallel, using parallel backend provided by foreach

Value

  • if results are atomic with same type and dimensionality, a vector, matrix or array; otherwise, a list-array (a list with dimensions)

Details

The m*ply functions are the plyr version of mapply, specialised according to the type of output they produce. These functions are just a convenient wrapper around a*ply with margins = 1 and .fun wrapped in splat.

This function combines the result into an array. If there are no results, then this function will return a vector of length 0 (vector()).

References

Hadley Wickham (2011). The Split-Apply-Combine Strategy for Data Analysis. Journal of Statistical Software, 40(1), 1-29. http://www.jstatsoft.org/v40/i01/.

Examples

Run this code
maply(cbind(mean = 1:5, sd = 1:5), rnorm, n = 5)
maply(expand.grid(mean = 1:5, sd = 1:5), rnorm, n = 5)
maply(cbind(1:5, 1:5), rnorm, n = 5)

Run the code above in your browser using DataLab