R: Tidiers for data.frame objects

data.frame_tidiers {broom} | R Documentation

## Tidiers for data.frame objects

### Description

These perform tidy summaries of data.frame objects. `tidy` produces summary statistics about each column, while `glance` simply reports the number of rows and columns. Note that `augment.data.frame` will throw an error.

### Usage

    ## S3 method for class 'data.frame'
    tidy(x, ...)

    ## S3 method for class 'data.frame'
    augment(x, data, ...)

    ## S3 method for class 'data.frame'
    glance(x, ...)

### Arguments

`x` | A data.frame
`...` | extra arguments: for `tidy`, these are passed on to `describe` from `psych` package
`data` | data, not used

### Details

The `tidy` method calls the psych method `describe` directly to produce its per-columns summary statistics.

### Value

`tidy.data.frame` produces a data frame with one row per original column, containing summary statistics of each:

`column` | name of original column
`n` | Number of valid (non-NA) values
`mean` | mean
`sd` | standard deviation
`median` | median
`trimmed` | trimmed mean, with trim defaulting to .1
`mad` | median absolute deviation (from the median)
`min` | minimum value
`max` | maximum value
`range` | range
`skew` | skew
`kurtosis` | kurtosis
`se` | standard error

`glance` returns a one-row data.frame with

`nrow` | number of rows
`ncol` | number of columns
`complete.obs` | number of rows that have no missing values
`na.fraction` | fraction of values across all rows and columns that are missing

### See Also

`describe`

### Examples

    td <- tidy(mtcars)
    td

    glance(mtcars)

    library(ggplot2)
    # compare mean and standard deviation
    ggplot(td, aes(mean, sd)) + geom_point() +
         geom_text(aes(label = column), hjust = 1, vjust = 1) +
         scale_x_log10() + scale_y_log10() + geom_abline()

[Package broom version 0.4.2 Index]