README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# cards <a href="https://insightsengineering.github.io/cards/"><img src="man/figures/logo.png" align="right" height="120" alt="cards website" /></a>

<!-- badges: start -->
[![CRAN status](https://www.r-pkg.org/badges/version/cards)](https://CRAN.R-project.org/package=cards)
[![Codecov test coverage](https://codecov.io/gh/insightsengineering/cards/branch/main/graph/badge.svg)](https://app.codecov.io/gh/insightsengineering/cards?branch=main)
[![Downloads](https://cranlogs.r-pkg.org/badges/cards)](https://cran.r-project.org/package=cards)
[![R-CMD-check](https://github.com/insightsengineering/cards/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/insightsengineering/cards/actions/workflows/R-CMD-check.yaml)
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
<!-- badges: end -->

The [CDISC Analysis Results Standard](https://www.cdisc.org/standards/foundational/analysis-results-standard) aims to facilitate automation, reproducibility, reusability, and traceability of analysis results data (ARD).
The {cards} package creates these **C**DISC **A**nalysis **R**esult **D**ata **S**ets.

Use cases:

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

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

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

1. 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:

```r
install.packages("cards")
```

You can install the development version of cards from [GitHub](https://github.com/) with:

``` r
# install.packages("devtools")
devtools::install_github("insightsengineering/cards")
```

## Extensions

[![cardx website](https://raw.githubusercontent.com/insightsengineering/cardx/main/man/figures/logo.png){style="float: right" width="120"}](https://insightsengineering.github.io/cardx/)

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}](https://github.com/insightsengineering/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](https://insightsengineering.github.io/cards//main/articles/getting-started.html) page for examples using ARDs to calculate statistics to later include in tables.

```{r}
library(cards)

ard_continuous(ADSL, by = "ARM", variables = "AGE")
```

## Other Resources

- [Posit 2024 pharmaverse Workshop](https://posit-conf-2024.github.io/pharmaverse/#schedule): Follow the link for "Analysis Results Datasets" in the schedule.

- [2024 China Pharma R User Conference Keynote Address](https://www.danieldsjoberg.com/china-pharma-keynote-2024/material.html)