
Class for Simulation Results Enrichment Rates
Source:R/class_simulation_results.R
SimulationResultsEnrichmentRates.RdA class for simulation results rates in enrichment designs.
Details
Use getSimulationEnrichmentRates()
to create an object of this type.
Fields
adaptationsIndicates whether or not an adaptation takes place at interim k. Is a logical vector of length
kMaxminus 1.allocationRatioPlannedThe planned allocation ratio (
n1 / n2) for the groups. For multi-arm designs, it is the allocation ratio relating the active arm(s) to the control. Is a single positive numeric value.calcSubjectsFunctionAn optional function that can be entered to define how sample size is recalculated. By default, recalculation is performed with conditional power with specified
minNumberOfSubjectsPerStageandmaxNumberOfSubjectsPerStage.conditionalPowerThe conditional power at each stage of the trial. Is a single numeric value between 0 and 1.
conditionalPowerAchievedThe calculated conditional power, under the assumption of observed or assumed effect sizes. Is a numeric matrix.
directionUpperSpecifies the direction of the alternative, only applicable for one-sided testing. Default is
TRUEwhich means that larger values of the test statistics yield smaller p-values. Is a single logical value.earlyStopThe probability to stopping the trial either for efficacy or futility. Is a numeric vector.
effectListThe list of subsets, prevalences and effect sizes with columns and number of rows reflecting the different situations to be considered.
effectMeasureCriterion for treatment arm/population selection, either based on test statistic (
"testStatistic") or effect estimate ("effectEstimate"). Is a single character value.epsilonValueNeeds to be specified if
typeOfSelection = "epsilon". Is a single numeric value.expectedNumberOfSubjectsThe expected number of subjects under specified alternative.
futilityPerStageThe per-stage probabilities of stopping the trial for futility. Is a numeric matrix.
futilityStopIn simulation results data set: indicates whether trial is stopped for futility or not.
intersectionTestThe multiple test used for intersection hypotheses in closed systems of hypotheses. Is a single character value.
iterationsThe number of iterations used for simulations. Is a single numeric value representing a whole number.
maxNumberOfIterationsThe number of simulation iterations. Is a single numeric value representing a whole number.
maxNumberOfSubjectsPerStageDetermines the maximum number of subjects per stage for data-driven sample size recalculation. For two treatment arms, is the number of subjects for both treatment arms. For multi-arm designs, is the minimum number of subjects per selected active arm. Is a numeric vector of length
kMaxcontaining whole numbers.minNumberOfSubjectsPerStageDetermines the minimum number of subjects per stage for data-driven sample size recalculation. For two treatment arms, is the number of subjects for both treatment arms. For multi-arm designs, is the minimum number of subjects per selected active arm. Is a numeric vector of length
kMaxcontaining whole numbers.numberOfPopulationsThe number of populations in an enrichment design. Is a numeric matrix.
piControlH1The assumed probability in the reference group, for which the conditional power was calculated. Is a single numeric value between 0 and 1.
piTreatmentH1The assumed probabilities in the active arm under which the sample size recalculation was performed and the conditional power was calculated.
plannedSubjectsDetermines the number of cumulated (overall) subjects when the interim stages are planned. For two treatment arms, is the number of subjects for both treatment arms. For multi-arm designs, refers to the number of subjects per selected active arm. Is a numeric vector of length
kMaxcontaining whole numbers.populationsThe number of populations in an enrichment design. Is a single numeric value representing a whole number.
rejectAtLeastOneThe probability to reject at least one of the (multiple) hypotheses. Is a numeric vector.
rejectedPopulationsPerStageThe simulated number of rejected populations per stage.
rValueNeeds to be specified if
typeOfSelection = "rBest". Is a single numeric value.sampleSizesThe sample sizes for each group and stage. Is a numeric vector of length number of stages times number of groups containing whole numbers.
seedThe seed used for random number generation. Is a single numeric value.
selectedPopulationsThe selected populations in enrichment designs.
selectPopulationsFunctionAn optional function that can be entered to define the way of how populations are selected.
stratifiedAnalysisFor enrichment designs, typically a stratified analysis should be chosen. When testing means and rates, a non-stratified analysis can be performed on overall data. For survival data, only a stratified analysis is possible. Is a single logical value.
successCriterionDefines when the study is stopped for efficacy at interim.
"all"stops the trial if the efficacy criterion has been fulfilled for all selected treatment arms/populations,"atLeastOne"stops if at least one of the selected treatment arms/populations is shown to be superior to control at interim. Is a single character value.successPerStageThe simulated success probabilities per stage where success is defined by user. Is a numeric matrix.
thresholdThe selection criterion: treatment arm/population is only selected if
effectMeasureexceedsthreshold. Either a single numeric value or a numeric vector of lengthactiveArmsreferring to a separate threshold condition for each treatment arm.typeOfSelectionThe way the treatment arms or populations are selected at interim. Is a single character value.