h_next_best_mg_ci

<a href="https://lifecycle.r-lib.org/articles/stages.html#experimental"><img src="figures/lifecycle-experimental.svg?package=crmPack&version=2.0.0" alt="[Experimental]"></a>
Helper function for <code>nextBest-NextBestMaxGain()</code> method. It computes a
95% credibility intervals for given target dose and max gain dose.
It also returns a ratio of upper and lower bounds of the interval.

Implements a wide range of dose escalation
designs. The focus is on model-based designs, ranging from classical and
modern continual reassessment methods (CRMs) based on dose-limiting toxicity
endpoints to dual-endpoint designs taking into account a biomarker/efficacy
outcome. Bayesian inference is performed via MCMC sampling in JAGS, and it is easy
to setup a new design with custom JAGS code. However, it is also possible to
implement 3+3 designs for comparison or models with non-Bayesian estimation.
The whole package is written in a modular form in the S4 class system, making it
very flexible for adaptation to new models, escalation or stopping rules.
Further details are presented in
Sabanes Bove et al. (2019) <doi:10.18637/jss.v089.i10>.

Daniel Sabanes Bove

crmPack

Object-Oriented Implementation of Dose Escalation Designs

Wai Yin Yeung

Burak Kuersad Guenhan

Giuseppe Palermo

Thomas Jaki

Jiawen Zhu

Ziwei Liao

Dimitris Kontos

Marlene Schulte-Goebel

Doug Kelkhoff

Oliver Boix

Robert Adams

Clara Beck

John Kirkpatrick

Wojciech Wójciak

Guanya Peng

Prerana Chandratre

F. Hoffmann-La Roche AG 

Merck Healthcare KGaA 

Bayer AG 

RPACT GmbH 

h_next_best_mg_ci function

<dl><dt>dose_target</dt>
<dd>(<code>number</code>) target dose estimate.</dd>
<dt>dose_mg</dt>
<dd>(<code>number</code>) the dose corresponding to the maximum gain.</dd>
<dt>prob_target</dt>
<dd>(<code>proportion</code>) target DLT probability.</dd>
<dt>placebo</dt>
<dd>(<code>flag</code>) if <code>TRUE</code> the first dose level in the dose grid used
is considered as placebo. This is needed to adjust the max gain dose using
efficacy constant value. If the <code>placebo</code> was used, then the <code>model_eff@const</code>
is added to <code>dose_mg</code>.</dd>
<dt>model</dt>
<dd>(<code>ModelTox</code>) the DLT model.</dd>
<dt>model_eff</dt>
<dd>(<code>Effloglog</code>) the efficacy model.</dd></dl>

Arguments

<a href='https://lifecycle.r-lib.org/articles/stages.html#experimental'><img src='figures/lifecycle-experimental.svg' alt='[Experimental]' /></a>
Helper function for <code>nextBest-NextBestMaxGain()</code> method. It computes a
95% credibility intervals for given target dose and max gain dose.
It also returns a ratio of upper and lower bounds of the interval.

Credibility Intervals for Max Gain and Target Doses at nextBest-NextBestMaxGain Method. — h_next_best_mg_ci

<dl>

<dt>dose_target</dt>
<dd>(<code>number</code>) target dose estimate.</dd>


<dt>dose_mg</dt>
<dd>(<code>number</code>) the dose corresponding to the maximum gain.</dd>


<dt>prob_target</dt>
<dd>(<code>proportion</code>) target DLT probability.</dd>


<dt>placebo</dt>
<dd>(<code>flag</code>) if <code>TRUE</code> the first dose level in the dose grid used
is considered as placebo. This is needed to adjust the max gain dose using
efficacy constant value. If the <code>placebo</code> was used, then the <code>model_eff@const</code>
is added to <code>dose_mg</code>.</dd>


<dt>model</dt>
<dd>(<code>ModelTox</code>) the DLT model.</dd>


<dt>model_eff</dt>
<dd>(<code>Effloglog</code>) the efficacy model.</dd>

</dl>

Credibility Intervals for Max Gain and Target Doses at <code>nextBest-NextBestMaxGain</code> Method.

h_next_best_mg_ci: Credibility Intervals for Max Gain and Target Doses at `nextBest-NextBestMaxGain` Method.

Description

Usage

Arguments

References