Learn R Programming

precautionary

precautionary implements new layers of patient-centered safety analysis for phase 1 dose-escalation trials, adding diagnostics to examine the safety characteristics of these designs in light of expected inter-individual variation in pharmacokinetics and pharmacodynamics. See Norris (2020b), "Retrospective analysis of a fatal dose-finding trial" arXiv:2004.12755 and (2020c) "What Were They Thinking? Pharmacologic priors implicit in a choice of 3+3 dose-escalation design" arXiv:2012.05301.

Installation

Releases starting with 0.2.3 incorporate fast numerics implemented in Rust, a modern programming language that emphasizes performance and reliability---attributes crucial to applications such as the analysis of clinical trials.

These innovations have delayed review and acceptance by CRAN, pending which the newest features of precautionary will be available only here on GitHub.

# Install release version from GitHub
remotes::install_github("dcnorris/precautionary")

# Install obsolete version from CRAN (where review of new Rust library remains pending)
install.package("precautionary")

To date, those features of precautionary which depend on the Prolog code in exec/prolog/ have been prebuilt into the package, for example as the arrays T[,,,] written into R/sysdata.rda by exec/make_sysdata_TUb.R. Methodologists who wish to examine, recompute and verify these arrays are advised to install Scryer Prolog.

It is a near-term goal for precautionary to reveal more transparently Prolog's special contributions to its analysis of dose-escalation designs.

Usage

Please see the vignettes under the Articles tab above.

References

The precautionary package is the pointy end of the spear in a larger DTAT research programme, of which the following are key outputs. Several of these citations have accompanying online resources such as web applications. For the key references, lay explanations are available.

Copy Link

Version

Install

install.packages('precautionary')

Monthly Downloads

32

Version

0.2.6

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

David C. Norris

Last Published

August 9th, 2021

Functions in precautionary (0.2.6)

Boin-class

The BOIN design as a Cumulative-Cohort Design (CCD) subclass
Cpe-class

An R6 base class for designs requiring Complete Path Enumeration
Cpe3_3-class

An R6 class encapsulating precalculated CPE for 3+3 design
as.data.table.exact

Convert an object of class c('exact','precautionary','simulations') to a data.table
Ccd-class

An R6 class encapsulating Cumulative-Cohort Designs
cohorts_of_n

Override cohorts_of_n to include latent toxicity tolerances
Crm-class

An R6 class encapsulating CRM models This class wraps the functionality of package dfcrm, adding efficient Rust implementations of some numerical routines.
as.data.table.precautionary

Convert an object of class c('precautionary','simulations') to a data.table
crm

A package-local (as-yet, unexported) test harness adapted from dfcrm::crm().
HyperMTDi-class

An R6 base class for hyperpriors over MTDi distributions
exact

A wrapper function supporting exact simulation of dose-escalation trials.
extend

Extend an existing simulation, using one of several stopping criteria
format.safetytab

Format a phase 1 trial safety tabulation to show significant digits only
simulation_function.u_i

Get a function that simulates dose-escalation trials using latent u_i
crmh_xo

Rust implementation of dfcrm::crmh* integrands for w==1 case
simulate_trials

Simulate trials defined via package escalation
crmh

Rust implementation of dfcrm::crmh* integrands
hyper_mtdi_lognormal-class

Hyperprior for lognormal MTDi distributions
safety_kable

Output a kable for a simulation summary of class safetytab
print.precautionary

viola_dtp

Complete dose transition pathways (DTP) table for the VIOLA trial.
print.hyper

print.exact

mtdi_lognormal-class

A lognormal MTDi distribution
plan

Plan
phase1_sim

Override escalation:::phase1_sim to incorporate latent toxicity tolerances
plot_dutycycle

Plot duty cycle from performance report on a parallel computation
summary.precautionary

Specialize a method defined in package 'escalation' for class 'simulations'
precautionary-package

Safety Diagnostics for Dose-Escalation Trial Designs
test_draw_samples

Test performance of draw_samples function
summary.exact

Summarize an exact treatment of a dose-escalation design
stop_for_excess_toxicity_empiric

A supremely faster version of a function from dtpcrm v0.1.1
ordinalizer

Ordinalizers
plot,mtdi_generator,ANY-method

Visualize n samples from an mtdi_generator object
plot,mtdi_distribution,ANY-method

Visualize an mtdi_distribution object