h_next_best_ncrm_loss_plot

<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 which creates the plot for <code>nextBest-NextBestNCRMLoss()</code>
method.

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_ncrm_loss_plot function

<dl><dt>prob_mat</dt>
<dd>(<code>numeric</code>) matrix with probabilities of a grid doses
to be in a given interval. If <code>is_unacceptable_specified</code> is <code>TRUE</code>, there
must be 4 intervals (columns) in <code>prob_mat</code>: <code>underdosing</code>, <code>target</code>,
<code>excessive</code>, <code>unacceptable</code>. Otherwise, there must be 3 intervals (columns):
<code>underdosing</code>, <code>target</code>, <code>overdose</code>. Number of rows must be equal to number
of doses in a grid.</dd>
<dt>posterior_loss</dt>
<dd>(<code>numeric</code>) posterior losses.</dd>
<dt>max_overdose_prob</dt>
<dd>(<code>number</code>) maximum overdose posterior
probability that is allowed.</dd>
<dt>dose_grid</dt>
<dd>(<code>numeric</code>) dose grid.</dd>
<dt>max_eligible_dose_level</dt>
<dd>(<code>number</code>) maximum eligible dose level in
the <code>dose_grid</code>.</dd>
<dt>doselimit</dt>
<dd>(<code>number</code>) the maximum allowed next dose.</dd>
<dt>next_dose</dt>
<dd>(<code>number</code>) next best dose.</dd>
<dt>is_unacceptable_specified</dt>
<dd>(<code>flag</code>) is unacceptable interval specified?</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 which creates the plot for <code>nextBest-NextBestNCRMLoss()</code>
method.

Building the Plot for nextBest-NextBestNCRMLoss Method. — h_next_best_ncrm_loss_plot

<dl>

<dt>prob_mat</dt>
<dd>(<code>numeric</code>) matrix with probabilities of a grid doses
to be in a given interval. If <code>is_unacceptable_specified</code> is <code>TRUE</code>, there
must be 4 intervals (columns) in <code>prob_mat</code>: <code>underdosing</code>, <code>target</code>,
<code>excessive</code>, <code>unacceptable</code>. Otherwise, there must be 3 intervals (columns):
<code>underdosing</code>, <code>target</code>, <code>overdose</code>. Number of rows must be equal to number
of doses in a grid.</dd>


<dt>posterior_loss</dt>
<dd>(<code>numeric</code>) posterior losses.</dd>


<dt>max_overdose_prob</dt>
<dd>(<code>number</code>) maximum overdose posterior
probability that is allowed.</dd>


<dt>dose_grid</dt>
<dd>(<code>numeric</code>) dose grid.</dd>


<dt>max_eligible_dose_level</dt>
<dd>(<code>number</code>) maximum eligible dose level in
the <code>dose_grid</code>.</dd>


<dt>doselimit</dt>
<dd>(<code>number</code>) the maximum allowed next dose.</dd>


<dt>next_dose</dt>
<dd>(<code>number</code>) next best dose.</dd>


<dt>is_unacceptable_specified</dt>
<dd>(<code>flag</code>) is unacceptable interval specified?</dd>

</dl>

Building the Plot for <code>nextBest-NextBestNCRMLoss</code> Method.

h_next_best_ncrm_loss_plot: Building the Plot for `nextBest-NextBestNCRMLoss` Method.

Description

Usage

Arguments