Learn R Programming

cards

The CDISC Analysis Results Standard aims to facilitate automation, reproducibility, reusability, and traceability of analysis results data (ARD). The {cards} package creates these CDISC Analysis Result Data Sets.

Use cases:

  1. Quality Control (QC) of existing tables and figures.

  2. Pre-calculate statistics to be summarized in tables and figures.

  3. Medical writers may easily access statistics and place in reports without copying and pasting from reports.

  4. Provides a consistent format for results and lends results to be combined across studies for re-use and re-analysis.

Installation

Install cards from CRAN with:

install.packages("cards")

You can install the development version of cards from GitHub with:

# install.packages("pak")
pak::pak("pharmaverse/cards")

Extensions

The {cards} package exports three types of functions:

  1. Functions to create basic ARD objects.

  2. Utilities to create new ARD objects.

  3. Functions to work with existing ARD objects.

The {cardx} R package is an extension to {cards} that uses the utilities from {cards} and exports functions for creating additional ARD objects––including functions to summarize t-tests, Wilcoxon Rank-Sum tests, regression models, and more.

Getting Started

Review the Getting Started page for examples using ARDs to calculate statistics to later include in tables.

library(cards)

ard_summary(ADSL, by = "ARM", variables = "AGE")
#> # An ARD data frame: 24 × 10
#>    group1 group1_level       variable context stat_name stat_label  stat fmt_fun
#>    <chr>  <list>             <chr>    <chr>   <chr>     <chr>      <lis>  <list>
#>  1 ARM    Placebo            AGE      summary N         N          86          0
#>  2 ARM    Placebo            AGE      summary mean      Mean       75.2        1
#>  3 ARM    Placebo            AGE      summary sd        SD          8.59       1
#>  4 ARM    Placebo            AGE      summary median    Median     76          1
#>  5 ARM    Placebo            AGE      summary p25       Q1         69          1
#>  6 ARM    Placebo            AGE      summary p75       Q3         82          1
#>  7 ARM    Placebo            AGE      summary min       Min        52          1
#>  8 ARM    Placebo            AGE      summary max       Max        89          1
#>  9 ARM    Xanomeline High D… AGE      summary N         N          84          0
#> 10 ARM    Xanomeline High D… AGE      summary mean      Mean       74.4        1
#> # ℹ 14 more rows
#> # ℹ 2 more variables: warning <list>, error <list>

Copy Link

Version

Install

install.packages('cards')

Monthly Downloads

51,163

Version

0.9.0

License

Apache License 2.0

Issues

Pull Requests

Stars

Forks

Maintainer

Daniel D. Sjoberg

Last Published

August 21st, 2026

Functions in cards (0.9.0)

default_stat_labels

Defaults for Statistical Arguments
bind_ard

Bind ARDs
deprecated

Deprecated functions
cards.options

Options in {cards}
as_cards_fn

As card function
compare_ard

Compare ARDs
check_ard_structure

Check ARD Structure
as_nested_list

ARD as Nested List
.cli_condition_messaging

Print Condition Messages Saved in an ARD
diff_ard_hierarchical

Rate Differences for Stacked Hierarchical ARDs
.check_var_nms

Check Variable Names
.check_dichotomous_value

Perform Value Checks
cards-package

cards: Analysis Results Data
.cli_groups_and_variable

Locate Condition Messages in an ARD
.check_for_missing_combos_in_denom

Check for Missing Levels in denominator
.check_fmt_string

Check 'xx' Format Structure
.calculate_stats_as_ard

Calculate Continuous Statistics
.create_list_for_attributes

Create List for Attributes
.calculate_tabulation_statistics

Calculate Tabulation Statistics
card_list_shaft

Shaft for ARD list-columns
.check_no_ard_columns

Check Protected Column Names
.eval_ard_calls

Evaluate the ard_*() function calls
.process_denominator

Process denominator Argument
.default_fmt_fun

Add Default Formatting Functions
.fill_overall_grp_values

Fill Overall Group Variables
.message_or_error

Message or error
.lst_results_as_df

Prepare Results as Data Frame
.nesting_rename_ard_columns

Rename ARD Columns
.one_row_ard_to_nested_list

Convert One Row to Nested List
.derive_overall_labels

Derive overall labels
.trim_ard

Trim ARD
.detect_msgs

Detect Columns with Non-Null Contents
.fill_grps_from_variables

Back Fill Group Variables
.unique_and_sorted

ARD-flavor of unique()
eval_capture_conditions

Evaluate and Capture Conditions
.purrr_list_flatten

A list_flatten()-like Function
.is_named_list

Named List Predicate
.rename_last_group_as_variable

Rename Last Group to Variable
.process_nested_list_as_df

Convert Nested Lists to Column
.table_as_df

Results from table() as Data Frame
nest_for_ard

ARD Nesting
filter_ard_hierarchical

Filter Stacked Hierarchical ARDs
print.card

Print
maximum_variable_value

Maximum Value
mock

Mock ARDs
process_selectors

Process tidyselectors
label_round

Generate Formatting Function
get_ard_statistics

ARD Statistics as List
reexports

Objects exported from other packages
print_ard_conditions

Print ARD Condition Messages
rename_ard_groups

Rename ARD Group Columns
syntax

Selecting Syntax
replace_null_statistic

Replace NULL Statistics with Specified Value
sort_ard_hierarchical

Sort Stacked Hierarchical ARDs
round5

Rounding of Numbers
summary_functions

Summary Functions
selectors

ARD Selectors
tidy_ard_order

Standard Order of ARD
rename_ard_columns

Rename ARD Variables
tidy_as_ard

Build ARD from Tidier
update_ard

Update ARDs
unlist_ard_columns

Unlist ARD Columns
apply_fmt_fun

Apply Formatting Functions
ard_attributes

ARD Attributes
ard_formals

Argument Values ARD
ard_missing

Missing ARD Statistics
ard_hierarchical

Hierarchical ARD Statistics
ard_identity

ARD Identity
ard_mvsummary

Multivariate ARD Summaries
add_calculated_row

Add Calculated Row
alias_as_fmt_fun

Convert Alias to Function
adam

Example ADaM Data
ard_pairwise

Pairwise ARD
ard_tabulate

Tabulate ARD
ard_stack_hierarchical

Stacked Hierarchical ARD Statistics
ard_total_n

ARD Total N
ard_stack

Stack ARDs
ard_tabulate_value

Tabulate Value ARD
ard_strata

Stratified ARD
ard_tabulate_rows

Row Tabulate ARD
as_card

Data Frame as ARD
ard_summary

Univariate ARD Statistics