Skip to content

rtables

0.6.17

Reporting Tables

13packages dependsuggested by 4
73.7Kdownloads / year
90.4%test coverage
13/13flavors OK

Overview

About

Reporting tables often have structure that goes beyond simple rectangular data. The 'rtables' package provides a framework for declaring complex multi-level tabulations and then applying them to data. This framework models both tabulation and the resulting tables as hierarchical, tree-like objects which support sibling sub-tables, arbitrary splitting or grouping of data in row and column dimensions, cells containing multiple values, and the concept of contextual summary computations. A convenient pipe-able interface is provided for declaring table layouts and the corresponding computations, and then applying them to data.

Changes in 0.6.17

New Features

  • Added restrict_facets function factory for use with make_split_fun @gmbecker
  • Exported previously internal make_subset_expr for use when constructing custom splitting behavior
  • Exported previously internal splv_extra and splv_extra<- accessors for getting and setting child-specific extra arguments on SplitValue objects.
  • Exported previously internal value_expr accessor for retrieving the subsetting expression from a SplitValue or ValueWrapper object.
  • The .alt_df* family of afun arguments now receive subsets of df when alt_counts_df is not specified in the build_table call; previously resulted in an error.
  • Exported previously internal RefFootnote constructor for reference footnote objects.
  • Added accessor methods for RowsVerticalSection objects: row_cells, obj_format, obj_format<-, obj_na_str, obj_na_str<-, cell_values
  • Added c method for directly combining RowsVerticalSection objects
  • Added vignette: Guided Tour (Advanced) @gmbecker
  • Added vignette: Guided Tour (Advanced) - Custom Analysis And Summary Functions @gmbecker
  • Added vignette: Guided Tour (Advanced) - Analysis Functions - Split Context @gmbecker
Show all changes in 0.6.17Hide the rest of the changes in 0.6.17
  • Added vignette: Guided Tour (Advanced) - Analysis Functions - Combining Existing afuns @gmbecker
  • Added vignette: Guided Tour (Advanced) - Analysis Functions - (stub) Useful Building Blocks @gmbecker
  • Added vignette: Guided Tour (Advanced) - Custom Split Functions @gmbecker
  • Added vignette: Guided Tour (Advanced) - Custom Split Functions - (stub) make_split_fun @gmbecker
  • Added vignette: Guided Tour (Advanced) - Custom Split Functions - Behavioral Building Block @gmbecker
  • Added vignette: Guided Tour (Advanced) - Custom Split Functions - (stub) Worked Examples @gmbecker
  • Added vignette: Guided Tour (Advanced) - (stub) TableTree Objects @gmbecker
  • Added vignette: Guided Tour (Advanced) - (stub) TableTree Objects - (stub) Accessing Table Values @gmbecker
  • Added vignette: Guided Tour (Advanced) - (stub) TableTree Objects - (stub) Custom Scoring Functions For Sorting @gmbecker
  • Added vignette: Guided Tour (Advanced) - (stub) TableTree Objects - (stub) Custom Pruning Functions @gmbecker
  • Added at_sibling parameter to split_rows_by* and analyze functions, enabling placement of a new layout directive as a direct sibling of a previously declared split or analysis @gmbecker
  • Added get_anchor_list() function for inspecting the available sibling anchors in an existing layout @gmbecker
  • label_pos now accepts "default" as a value, which resolves to "visible" when at_sibling is non-NULL and "hidden" otherwise @gmbecker

Bug Fixes

  • indent_mod<- RowsVerticalSection method now correctly recycles length 1 values @gmbecker
  • Fixed uniqify_child_names emitting messages ending in a literal FALSE due to passing call. = FALSE to message(), which does not accept that argument @gmbecker
  • content functions now receive correct .ref_group value instead of a data.frame with zero rows, when requested. #1117 @gmbecker
  • Fix in the now exported RefFootnote in check for disallowed values in symbol argument

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 17.9 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-04
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-07
  • OK13 OK2026-05-13
Show 4 earlier changesHide 4 earlier changes
  • WARNING12 OK, 1 WARNING2026-05-09
  • ERROR12 OK, 1 ERROR2026-05-03
  • OK12 OK2026-04-25
  • NOTE11 OK, 3 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.6.17
READMEYes · 519 wordsVignettesYes · 38 · evaluation depends on the environmentNEWSYes · 100% structured · mentions 0.6.17Citation fileNoWebsiteYes · pkgdown
Help pages
128 (6 internal)includes a package overview page
Examples that run
100%87 run in a plain check (16 of them under a condition)
Exported functions with examples
74%
Documented parameters
98%
Return-value docs
90%
Help pages citing references
0%
Vignettes (38)
Show 28 moreHide 28 vignettes

Downloads

73.7K
CRAN downloads in the past year
Rank #1,347 · ~202/day · ~6.1K/mo
Daily download trend is not available in this view yet.
8.4K30 days
20.9K90 days
73.7K1 year
Compare downloads with other packages →
Also on550 r2u8 autocran2.5K conda_forge

Repository

260Stars
54Forks
48Open issues
0Open PRs
35Releases
1,274Commits
47Commit identities
rtablespharmaceuticals
1,274 commits · Last activity 2026-10-01 · Default branch at 0.6.17.9000, ahead of CRAN 0.6.17 (checked 2026-10-11) · Discussions: 5 posts
Responsiveness
How these are sampled
PRs merged (all time)
87%
Median days to close, 50 most recently updated closed issues
36
Median days to close, 50 most recently updated closed PRs
4

Stars over time

2025-09-24 · 2432026-10-02 · 260
Earlier repositories
PracticesBeta

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

Checks run against github.com/pharmaverse/rtables on 2026-10-11.

Continuous integration (2)
GitHub ActionsGitLab CI
Governance and community (4)
Code of conductContributing guideIssue templatesCODEOWNERS
Docs source (3)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-06

Coverage (1)
Coverage reporting
Show all practicesHide 3 practices
CRAN release process (1)
revdep/
Automation and maintenance (1)
pre-commit
Lint, format, editor (2)
lintrRStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen on or before 2026-07-25
    Commits: at least 1 crediting it in the message
  • GitHub Copilotfirst seen on or before 2026-08-25
    Commits: at least 2 crediting it in the message
Models named in its commits
  • Claude Sonnet 4.61 commit · Jul 2026
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
17 external dependencies (excludes base and recommended)

Installing rtables adds 11 packages (9 with compiled code, 16 MB of source tarballs). Heaviest: stringi 11 MB, formatters 2.4 MB, rlang 766 KB.

Depends (3)
R >= 4.1formattersmethods
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
13direct
5indirect
Depends 3 · Imports 10
Suggested by 4
Show all 17 packagesHide all 17 packages
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

People & History

People (10)
Author, Maintainer since 0.6.3 (2023) · added in 0.6.3
Author
Original creator of the package
Author · added in 0.6.0
Author · added in 0.6.3
Contributor · added in 0.6.17
Contributor · added in 0.6.3
Copyright holder, Funder · added in 0.6.3

Previously maintained by Gabriel Becker (0.3.6 to 0.6.1).

Releases (20)

Pick two releases to compare their code metrics.

  • 0.6.17Latest
    record
    2026-10-01 · current release · diff ↗ ·
    added 11 exports
    splv_extra<-, RefFootnote, SplitValue, get_anchor_dfs, get_full_lyt_df, get_kid_types, get_layout_dfs, get_row_anchor_df, get_row_anchor_list, splv_extra, value_expr
  • R
    R 4.6.0 released · 2026-04-24
  • 0.6.16
    record
    2026-04-22 · diff ↗ ·
    added 2 exports
    make_subset_expr, restrict_facets
  • 0.6.15
    record
    2025-12-14 · diff ↗
  • 0.6.14
    record
    2025-11-18 · diff ↗
  • 0.6.13
    record
    2025-06-19 · diff ↗ ·
    added 7 exports
    section_div_at_path<-, has_force_pag, section_div_at_path, section_div_info, subset_cols, tt_normalize_row_path, tt_row_path_exists
  • 0.6.12
    record
    2025-04-11 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 0.6.11
    record
    2025-01-10 · diff ↗ ·
    removed 9 exports
    export_as_docx, margins_landscape, margins_potrait, result_df_specs, section_properties_default, theme_docx_default, theme_html_default, tt_to_flextable, word_mm_to_pt
    added 2 exports
    obj_stat_names<-, obj_stat_names
  • 0.6.10
    record
    2024-09-20 · diff ↗ ·
    removed 2 exports
    section_properties_landscape, section_properties_portrait
    added 3 exports
    section_properties_default, theme_html_default, word_mm_to_pt
  • 0.6.9
    record
    2024-06-27 · diff ↗
  • 0.6.8
    record
    2024-06-20 · diff ↗ ·
    added 9 exports
    colcount_na_str<-, colcount_visible<-, facet_colcount<-, facet_colcounts_visible<-, colcount_na_str, colcount_visible, coltree_structure, facet_colcount, rm_all_colcounts
  • R
    R 4.4.0 released · 2024-04-24
  • 0.6.7
    record
    2024-04-15 · diff ↗ ·
    removed 2 exports
    summarize_rows, trim_zero_rows
    added 2 exports
    top_level_section_div<-, top_level_section_div
  • 0.6.6
    record
    2023-12-08 · diff ↗ ·
    added 12 exports
    col_footnotes<-, header_section_div<-, section_div<-, col_footnotes, export_as_docx, header_section_div, margins_landscape, margins_potrait, section_div, section_properties_landscape, section_properties_portrait, theme_docx_default
  • 0.6.3
    record
    2023-08-30 · diff ↗ ·
    removed 1 export
    rtables_aligns
    added 8 exports
    as_result_df, assert_valid_table, find_degen_struct, qtable, qtable_layout, result_df_specs, sanitize_table_struct, validate_table_struct
Show 11 earlier eventsHide 11 earlier events
  • 0.6.1
    record
    2023-05-25 · diff ↗ ·
    removed 4 exports
    [, [<-, export_as_rtf, vpaginate_table
    added 3 exports
    ref_symbol<-, ref_symbol, split_rows_by_multivar
  • R
    R 4.3.0 released · 2023-04-21
  • 0.6.0
    record
    2023-03-03 · diff ↗ ·
    removed 2 exports
    obj_na_str<-, obj_na_str
    added 16 exports
    [, [<-, add_combo_facet, add_overall_facet, add_to_split_result, counts_wpcts, drop_facet_levels, export_as_rtf, head, make_split_fun, make_split_result, spl_context_to_disp_path, spl_variable, str, tail, trim_levels_in_facets
  • 0.5.1
    record
    2022-05-21 · diff ↗ ·
    added 4 exports
    horizontal_sep<-, obj_na_str<-, horizontal_sep, obj_na_str
  • R
    R 4.2.0 released · 2022-04-22
  • 0.5.0
    record
    2022-04-01 · diff ↗ ·
    removed 19 exports
    obj_label<-, obj_name<-, var_labels<-, CumulativeCutSplit, VarStaticCutSplit, analyze_against_ref_group, is_rcell_format, list_rcell_format_labels, make_row_df, matrix_form, obj_label, obj_name, propose_column_widths, sprintf_format, toString, var_labels, var_labels_remove, var_relabel, with_label
    added 10 exports
    colcount_format<-, indent_mod<-, colcount_format, do_base_split, indent_mod, ref_msg, rtables_aligns, table_shell, table_shell_str, vpaginate_table
  • 0.4.0
    record
    2021-10-06 · diff ↗ ·
    removed 1 export
    trim_levels_by_map
    added 15 exports
    col_fnotes_here<-, fnotes_at_path<-, label_at_path<-, all_zero, col_fnotes_here, export_as_pdf, insert_row_at_path, label_at_path, path_enriched_df, prune_zeros_only, rawvalues, trim_levels_to_map, tt_to_flextable, value_formats, value_names
  • 0.3.8
    record
    2021-07-13 · diff ↗ ·
    added 16 exports
    cell_footnotes<-, ref_index<-, row_footnotes<-, tt_at_path<-, cell_footnotes, clear_indent_mods, df_to_tt, export_as_tsv, export_as_txt, import_from_tsv, ref_index, row_footnotes, trim_levels_by_map, tt_at_path, update_ref_indexing, vars_in_layout
  • R
    R 4.1.0 released · 2021-05-18
  • 0.3.6
    record
    2021-01-22
  • R
    R 4.0.0 released · 2020-04-24

Package metadata

First published
2021-01-22
Total releases
20 / 5 yrs
License
Apache License 2.0 | file LICENSE OSI
Minimum R
≥ 4.1
Download size
7.0 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("rtables")
Zhu, J., F. Hoffmann-La Roche AG, Becker, G., Garolini, D., Mordig, M., Munoz Tord, D., Sabanés Bové, D., Waddell, A., Yogasekaram, A., & de la Rua, E. (2026). rtables: Reporting Tables (Version 0.6.17) [Computer software]. https://doi.org/10.32614/CRAN.package.rtables

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 rtables version 0.6.17 [Data set]. HJJB, LLC. Data release v2026-10-17. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-17, 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