Skip to content

broom

1.0.13Package record

Convert Statistical Objects into Tidy Tibbles

221packages dependsuggested by 158
8.1Mdownloads / year
86.3%test coverage
11/13flavors OK

Overview

About

Summarizes key information about statistical objects in tidy tibbles. This makes it easy to report results, create plots and consistently work with large numbers of models at once. Broom provides three verbs that each provide different types of information about a model. tidy() summarizes information about model components such as coefficients of a regression. glance() reports information about an entire model, such as goodness of fit measures like AIC and BIC. augment() adds information about individual observations to a dataset, such as fitted values or influence measures.

Changes in 1.0.13
  • Resolved an R CMD check WARNING on r-devel about namespace references in R/sysdata.rda by moving the joineRML test fixture to tests/testthat/fixtures/.

From NEWS.md in the release

Install

Health

CRAN checks
2ERROR11OK
Check messages
ERRORexamplesr-devel-linux-x86_64-debian-gcc
Running examples in ‘broom-Ex.R’ failed
The error most likely occurred in:

> base::assign(".ptime", proc.time(), pos = "CheckExEnv")
> ### Name: glance.survfit
> ### Title: Glance at a(n) survfit object
> ### Aliases: glance.survfit
> 
> ### ** Examples
> 
> ## Don't show: 
> if (rlang::is_installed(c("survival", "ggplot2"))) withAutoprint({ # examplesIf
+ ## End(Don't show)
+ 
+ # load libraries for models and data
+ library(survival)
+ 
+ # fit model
+ cfit <- coxph(Surv(time, status) ~ age + sex, lung)
+ sfit <- survfit(cfit)
+ 
+ # summarize model fit with tidiers + visualization
+ tidy(sfit)
+ glance(sfit)
+ 
+ library(ggplot2)
+ 
+ ggplot(tidy(sfit), aes(time, estimate)) +
+   geom_line() +
+   geom_ribbon(aes(ymin = conf.low, ymax = conf.high), alpha = .25)
+ 
+ # multi-state
+ fitCI <- survfit(Surv(stop, status * as.numeric(event), type = "mstate") ~ 1,
+   data = mgus1, subset = (start == 0)
+ )
+ 
+ td_multi <- tidy(fitCI)
+ 
+ td_multi
+ 
+ ggplot(td_multi, aes(time, estimate, group = state)) +
+   geom_line(aes(color = state)) +
+   geom_ribbon(aes(ymin = conf.low, ymax = conf.high), alpha = .25)
+ ## Don't show: 
+ }) # examplesIf
> library(survival)
> cfit <- coxph(Surv(time, status) ~ age + sex, lung)
> sfit <- survfit(cfit)
Error in a$specials[[i]] : subscript out of bounds
Calls: withAutoprint ... survfit.coxph -> model.matrix.coxph -> delete.response -> off
Execution halted
ERRORtestsr-devel-linux-x86_64-debian-gcc
Running ‘spelling.R’ [0s/0s]
  Running ‘testthat.R’ [14s/17s]
Running the tests in ‘tests/testthat.R’ failed.
Complete output:
  > # This file is part of the standard setup for testthat.
  > # It is recommended that you do not modify it.
  > #
  > # Where should you do additional test configuration?
  > # Learn more about the roles of various files in:
  > # * https://r-pkgs.org/testing-design.html#sec-tests-files-overview
  > # * https://testthat.r-lib.org/articles/special-files.html
  > 
  > library(testthat)
  > library(broom)
  > 
  > test_check("broom")
  
  Attaching package: 'modeldata'
  
  The following object is masked from 'package:datasets':
  
      penguins
  
  Multiple parameters; naming those columns ndf and ddf.
  Saving _problems/test-survival-coxph-84.R
  Saving _problems/test-survival-coxph-84.R
  [ FAIL 2 | WARN 1 | SKIP 99 | PASS 934 ]
  
  ══ Skipped tests (99) ══════════════════════════════════════════════════════════
  • On CRAN (99): 'test-aer.R:1:1', 'test-a
...[truncated]...
)) == head(results(newdata))
  Backtrace:
      ▆
   1. └─modeltests::check_augment_function(...) at test-survival-coxph.R:79:3
   2.   └─modeltests:::check_augment_data_specification(...)
   3.     └─testthat::expect_equal(...)
  ── Error ('test-survival-coxph.R:79:3'): augment.coxph ─────────────────────────
  Error in `data.frame(..., check.names = FALSE)`: arguments imply differing number of rows: 229, 228
  Backtrace:
      ▆
   1. └─modeltests::check_augment_function(...) at test-survival-coxph.R:79:3
   2.   └─modeltests:::check_augment_data_specification(...)
   3.     └─broom (local) aug(model, data = dl$tibble, newdata = new_dl$tibble)
   4.       └─broom::augment_columns(...)
   5.         ├─tibble::as_tibble(cbind(original, ret))
   6.         └─base::cbind(original, ret)
   7.           └─base::cbind(deparse.level, ...)
   8.             └─base::data.frame(..., check.names = FALSE)
  
  [ FAIL 2 | WARN 1 | SKIP 99 | PASS 934 ]
  Error:
  ! Test failures.
  Execution halted
ERRORwhether package can be installedr-devel-linux-x86_64-fedora-clang
Installation failed.
See ‘/data/localhost/ripley/R/packages/tests-clang/broom.Rcheck/00install.out’ for details.

CRAN check page ↗

Slowest check: 10.2 min · r-oldrel-windows-x86_64
Status changes
  • ERROR11 OK, 2 ERROR2026-10-24
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
Show 3 earlier changesHide 3 earlier changes
  • OK13 OK2026-05-16
  • WARNING13 OK, 1 WARNING2026-04-23
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.0.13
READMEYes · 433 wordsVignettesYes · 6 · dynamicNEWSYes · 100% structured · mentions 1.0.13Citation fileNoWebsiteYes · pkgdown
Help pages
235 (2 internal)includes a package overview page
Examples that run
98%207 run in a plain check (185 of them under a condition) · 4 never run
Exported functions with examples
14%
Documented parameters
100%
Return-value docs
57%
Help pages citing references
1%

Downloads

8.1M
CRAN downloads in the past year
Rank #112 · ~22.3K/day · ~678K/mo
Daily download trend is not available in this view yet.
575.3K30 days
1.6M90 days
8.1M1 year
Compare downloads with other packages →
Also on183.2K r2u125 autocran1.2M conda_forge19.5K c2d4u

Repository

1,526Stars
299Forks
12Open issues
6Open PRs
41Releases
1,944Commits
156Commit identities
rtidy-datamodeling
1,944 commits · Last activity 2026-05-14 · +0.1% stars, 30d · Default branch at 1.0.13.9000, ahead of CRAN 1.0.13 (checked 2026-10-21)
Responsiveness
How these are sampled
PRs merged (all time)
79%
Median days to close, 50 most recently updated closed issues
2
Median days to close, 50 most recently updated closed PRs
1

Stars over time

2025-09-24 · 1,4912026-10-09 · 1,526
PracticesBeta

15 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/tidymodels/broom on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (3)
Code of conductContributing guideCODEOWNERS
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-05-14 · The repository has a site deploy workflow

pkgdown site last built 2026-05-14

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Lint, format, editor (3)
AirVS CodeRStudio project
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

People & History

People (127)
Author, Maintainer since 1.0.11 (2025) · added in 1.0.11
Author · added in 0.7.0
Author · added in 0.5.0
Author · added in 0.3.6
Contributor · added in 0.7.0
Contributor · added in 0.4.1
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Show 114 more contributorsHide 114 contributors
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.0
Contributor · added in 0.4.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.4
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.3.6
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.4.1
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.3.6
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.1
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.9
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.3
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.3.7
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.3.7
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.4.1
Contributor · added in 0.7.11
Contributor · added in 1.0.1
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.10
Contributor · added in 0.7.0
Contributor · added in 0.4.1
Contributor · added in 0.4.1
Contributor · added in 0.7.0
Contributor · added in 0.7.11
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.1
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.1
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.5.0
Contributor · added in 0.7.0
Contributor · added in 0.3.6
Contributor · added in 0.7.1
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Contributor · added in 0.7.6
Contributor · added in 0.7.0
Contributor · added in 0.7.0
Copyright holder, Funder · added in 1.0.4

Previously maintained by Simon Couch (0.7.7 to 1.0.10) and Alex Hayes (0.5.1 to 0.7.6).

Listed in earlier versions (3)
Show 3 peopleHide 3 people
David Robinson <admiral.david@gmail.com> [aut, cre] Matthieu Gomez <mattg@princeton.edu> [ctb]
no longer listed · 0.3.4 to 0.3.5
no longer listed · 0.7.0 to 1.0.1
RStudio
no longer listed · 0.8.0 to 1.0.3
Releases (45)

Pick two releases to compare their code metrics.

Show 42 earlier eventsHide 42 earlier events

Package metadata

First published
2014-11-23
Total releases
45 / 12 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1
Download size
456 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("broom")
Hvitfeldt, E., Posit Software, PBC, Arel-Bundock, V., Arnold, J., Aust, F., Averick, M., Banks, S. E., Barrett, M., Barth, M., Bates, A., Bender, A., Bengtsson, H., Bivand, R., Bojanowski, M., Bolker, B., Briatte, F., Brunson, J. C., Bryan, J., Buerkner, P., Cahoon, J., Chiu, D., Christensen, E., Cimentada, J., Cooper, J., Couch, S., Crane, N., Demeshev, B., Denney, B., Dunkle Werner, K., Evans, M., Fannin, B., Freitas, W., Gabry, J., Gasparini, A., Geffert, L., Gegzna, V., Gomez, M., Gray, B., Gray, C., Gray, C. T., Hailperin, K., Hayashi, H., Hayes, A., Hesselberth, J., Hester, J., Holgersen, E., Hugh-Jones, D., Jackson, S., Jacobs, A., Jakobsen, N., Jarvis, C., Johnston, L., Junkka, J., Kay, M., Kennedy, P., Komsta, L., Krauska, E. A., Kuehn, M., Kuhn, M., Kuriwaki, S., Larmarange, J., Le Pennec, E., Lee, J., Lehman, M., Lendway, L., Lincoln, M., Littlefield, T., Macfarlane, G., Malmedal, H., Mannakee, B., Martherus, J., McDermott, G., Medina, L., Menne, D., Moore, A., Muhlenkamp, J., Novometsky, F., Nutter, B., Oller, S., Ooi, H., Ots, R., PJ, P., Patil, I., Pav, S., Preussner, J., Prosdocimi, I., Reinhart, A., Robinson, D., Robinson, S., Rodriguez, J., Rosseel, Y., Sanders, T., Schneider, B., Selzer, L., Simpson, G., Singh, S., Sjoberg, D. D., Smith, A., Soltoff, B., Sonnet, L., Stigler, M., Szocs, E., Szoecs, E., Tavares, H., Templer, S., Tham, W. Y., Tobalina, L., Tyre, D., Vervoort, R. W., Wallrich, L., Wang, A., Wang, A., Wang, C., Wang, C., Weylandt, M., Whalley, B., Whiting, K., Wickham, H., Wiernik, B. M., Wilber, J., Wilkinson Saldana, Z., Williams, N., Williams, N., Wundervald, B., Xiao, C., Yamamoto, J., Zarca, K., & Zhu, H. (2026). broom: Convert Statistical Objects into Tidy Tibbles (Version 1.0.13) [Computer software]. https://doi.org/10.32614/CRAN.package.broom

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for broom version 1.0.13 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy