plyr: summarise – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

summarise

Summarise a data frame.

Description

Summarise works in an analogous way to mutate, except instead of adding columns to an existing data frame, it creates a new data frame. This is particularly useful in conjunction with ddply as it makes it easy to perform group-wise summaries.

Usage

summarise(.data, ...)

Arguments

`.data`	the data frame to be summarised
`...`	further arguments of the form var = value

Note

Be careful when using existing variable names; the corresponding columns will be immediately updated with the new data and this can affect subsequent operations referring to those variables.

Examples

# Let's extract the number of teams and total period of time
# covered by the baseball dataframe
summarise(baseball,
 duration = max(year) - min(year),
 nteams = length(unique(team)))
# Combine with ddply to do that for each separate id
ddply(baseball, "id", summarise,
 duration = max(year) - min(year),
 nteams = length(unique(team)))

plyr

Tools for Splitting, Applying and Combining Data

v1.8.6

MIT + file LICENSE

Authors

Hadley Wickham [aut, cre]

Initial release