Scenario-level summary of the simulation results

Usage

My_Summary_Scenario_Level(
  sim_data,
  true_dlt_func,
  design,
  mcmc_option,
  progress_interval = 1
)

My_Summary_Scenario_Level2(
  sim_data,
  true_dlt_func,
  design,
  mcmc_option,
  progress_interval = 1
)

Arguments

sim_data: results of each simulation, results of crmPack::simulate().
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

For `My_Summary_Scenario_Level()`

It returns a data.frame storing the summary results of the simulated data. This is a one-row data.frame that contains the following columns:

sim_num, number of simulations
dose_target_left and dose_target_right, the dose_target_cut given the dose grid (design@data@doseGrid) and true_dlt_func. More details about dose_target_cut can be found in Details section in Find_Dose_Cut().

Simply put, doses specified in the dose grid that fall in:
- [0, dose_target_cut[1]] are under dose
- (dose_target_cut[1], dose_target_cut[2]] are target dose
- (dose_target_cut[2], Inf) are over dose
prop_recommend_na, prop_recommend_underdose, prop_recommend_targetdose, prop_recommend_overdose: proportion in the simulation that the final recommended dose is NA(indicating all doses are over toxic), under dose, target dose or over dose.
subj_num: average number of subjects in each simulation
subj_num_min: minimum number of subjects in all simulations
subj_num_min2: minimum number of subjects in all simulations that can make a final dose recommendation.
subj_num_max: maximum number of subjects in all simulations subj_num = 0,
underdose_num, targetdose_num, overdose_num: average number of subjects in each simulation that have been treated with a dose in the under, target or over dose interval
dlt_num: average number of subjects in each simulation that experienced a DLT event
underdose_prop, targetdose_prop, overdose_prop: average proportion of subjects in each simulation that are treated with a dose that falls in the under, target, over dose interval.
dlt_prop: average proportion of subjects in each simulation that experienced a DLT event

For `My_Summary_Scenario_Level2()`

It returns an one-row data.frame then same as that of My_Summary_Scenario_Level() with the additional column:

max_dose_level_num: average number of subjects in each simulation that are treated with the maximum dose level in the dose grid

Note

Since it returns more info than My_Summary_Scenario_Level(), it is recommended to use My_Summary_Scenario_Level2().