Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

59 lines (50 sloc) 1.637 kb
\name{ldply}
\alias{ldply}
\title{Split list, apply function, and return results in a data frame.}
\usage{
ldply(.data, .fun = NULL, ..., .progress = "none",
.parallel = FALSE)
}
\arguments{
\item{.fun}{function to apply to each piece}
\item{...}{other arguments passed on to \code{.fun}}
\item{.progress}{name of the progress bar to use, see
\code{\link{create_progress_bar}}}
\item{.data}{list to be processed}
\item{.parallel}{if \code{TRUE}, apply function in
parallel, using parallel backend provided by foreach}
}
\value{
A data frame, as described in the output section.
}
\description{
For each element of a list, apply function then combine
results into a data frame.
}
\section{Input}{
This function splits lists by elements and combines the
result into a data frame.
}
\section{Output}{
The most unambiguous behaviour is achieved when
\code{.fun} returns a data frame - in that case pieces
will be combined with \code{\link{rbind.fill}}. If
\code{.fun} returns an atomic vector of fixed length, it
will be \code{rbind}ed together and converted to a data
frame. Any other values will result in an error.
If there are no results, then this function will return a
data frame with zero rows and columns
(\code{data.frame()}).
}
\references{
Hadley Wickham (2011). The Split-Apply-Combine Strategy
for Data Analysis. Journal of Statistical Software,
40(1), 1-29. \url{http://www.jstatsoft.org/v40/i01/}.
}
\seealso{
Other data frame output: \code{\link{adply}},
\code{\link{ddply}}
Other list input: \code{\link{laply}},
\code{\link{llply}}
}
\keyword{manip}
Jump to Line
Something went wrong with that request. Please try again.