https://github.com/merck/forestly

Interactive forest plot for adverse events analysis
https://github.com/merck/forestly

Last synced: about 1 year ago
JSON representation

Interactive forest plot for adverse events analysis

• Host: GitHub
• URL: https://github.com/merck/forestly
• Owner: Merck
• License: gpl-3.0
• Created: 2023-07-14T13:55:19.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-13T05:38:57.000Z (over 1 year ago)
• Last Synced: 2024-10-14T06:21:24.486Z (over 1 year ago)
• Language: R
• Homepage: https://merck.github.io/forestly/
• Size: 27.7 MB
• Stars: 12
• Watchers: 7
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# forestly 

[![R-CMD-check](https://github.com/Merck/forestly/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/Merck/forestly/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/Merck/forestly/branch/main/graph/badge.svg)](https://app.codecov.io/gh/Merck/forestly?branch=main)

[![CRAN status](https://www.r-pkg.org/badges/version/forestly)](https://cran.r-project.org/package=forestly)

[![CRAN Downloads](https://cranlogs.r-pkg.org/badges/forestly)](https://cran.r-project.org/package=forestly)

## Installation

The easiest way to get forestly is to install from CRAN:

```r

install.packages("forestly")

```

Alternatively, to use a new feature or get a bug fix,

you can install the development version of forestly from GitHub:

```r

# install.packages("remotes")

remotes::install_github("Merck/forestly")

```

## Overview

The forestly package creates interactive forest plots for clinical trial analysis & reporting.

- Safety analysis

  - Specific adverse events analysis

- Efficacy analysis (future work)

  - Subgroup analysis

We assume ADaM datasets are ready for analysis and

leverage [metalite](https://merck.github.io/metalite/) data structure to define

inputs and outputs.

## Workflow

The general workflow is:

1. `meta_forestly()` constructs input metadata for treatment analysis from ADaM datasets.

1. `prepare_ae_forestly()` prepares datasets for interactive forest plot.

1. `format_ae_forestly()` formats output layout.

1. `ae_forestly()` generates an interactive forest plot.

Here is a quick example

```r

library("forestly")

meta_forestly(

  dataset_adsl = forestly_adsl,

  dataset_adae = forestly_adae,

  parameter_term = "any;rel;ser",

  population_subset = SAFFL == "Y",

  observation_subset = SAFFL == "Y"

) |>

  prepare_ae_forestly(parameter = "any;rel;ser") |>

  format_ae_forestly() |>

  ae_forestly()

```

## Interactive features

The interactive features for safety analysis include:

- Select different AE criteria.

- Filter by incidence of AE in one or more groups.

- Reveal information by hovering the mouse over a data point.

- Search bars to find subjects with selected adverse events (AEs).

- Sort value by clicking the column header.

- Drill-down listing by clicking $\blacktriangleright$.

## References

- Paper: [2023 PHUSE US Connect](https://phuse.s3.eu-central-1.amazonaws.com/Archive/2023/Connect/US/Florida/PAP_DV07.pdf)

- Talk: [2021 R/Pharma Conference](https://rinpharma.com/publication/rinpharma_206/)