Dose-level summary of the simulation results

Usage

My_Summary_Dose_Level(
  sim_data,
  sim_summary,
  true_dlt_func,
  design,
  mcmc_option,
  progress_interval = 1
)

Arguments

sim_data: results of each simulation, results of crmPack::simulate().
sim_summary: summary results of the simulation, from crmPack::summary().
true_dlt_func: a user supplied function, takes only one parameter named dose, and returns the DLT rate of the given dose.
design: the design object used in the simulation
mcmc_option: MCMC option, an object from crmPack::McmcOptions()
progress_interval: integer, the interval to report progress when summarizing the simulation results

Value

a data.frame storing the summary results of the simulated data. Each row is for one dose and the returning data frame contains the following columns:

dose, the dose level
true_dlt_rate, the underlying DLT rate of the dose level
est_dlt_rate, est_dlt_rate_lower, est_dlt_rate_upper, the estimated MEAN, the lower and upper bound of 90%? CI of DLT rate for each dose level.
prop_selected, proportion in these simulations the dose is selected as the final recommended dose.
prob_target， prob_overdose, prob_underdose, estimated probability for each dose level that its DLT rate fall in the target, overdose, underdose interval. These are the average value over these simulations.
num_treated, average over all simulations the number of subjects treated in each simulation
num_dlt, average over all simulations the number of subjects experienced DLT in each simulation
prop_dlt, average over all simulations the proportion of "DLT subjects" over "treated subjects"