PoS: Probability of trial ans clinical success for a prospective...

Description Usage Arguments Details Author(s) See Also Examples

View source: R/PoS.R

Description

This function can be used to determine probability of trial success and clinical success based on the prior distribution for each of continuous, binary and time-to-event endpoints. The calculation is carried out assuming normal distribution for estimated parameter and normal prior distribution.

Usage

1
2
3
4
5
6
PoS(type, nsamples, null.value = NULL, alternative = "greater", 
    N = NULL, D = NULL, a = 1, 
    succ.crit = "trial", Z.crit.final = 1.96, alpha.final = 0.025, 
    clin.succ.threshold = NULL, se.exp = NULL, 
    meandiff.prior = NULL, mean.prior = NULL, sd.prior = NULL, 
    propdiff.prior = NULL, prop.prior = NULL, hr.prior = NULL, D.prior = NULL)

Arguments

type

Type of the endpoint. It could be cont for continuous, bin for binary and surv for survival endpoint.

nsamples

Number of samples. For continuous and binary case, it can be 1 or 2. For survival endpoint, it can be only 2.

null.value

The specified value under null hypothesis. Default is 0 for continuous and binomial case and 1 for survival case.

alternative

Direction of alternate hypothesis. Can be "greater" or "less". Default is "less" for test of HR and "greater" otherwise.

N

Total sample size at final analysis. Cannot be missing for continuous and binary endpoint.

D

Total number of events at final analysis. Cannot be missing for survival endpoint.

a

Allocation ratio in two sample case.

succ.crit

Specify "trial" for trial success (i.e., null hypothesis is rejected at final analysis) or "clinical" for clinical success (i.e., estimated value at the final analysis is greater than clinically meaningful value as specified under clin.succ.threshold.)

Z.crit.final

The rejection boundary at final analysis in Z-value scale. Either alpha.final or Z.crit.final must be specified when determining trial success.

alpha.final

The rejection boundary at final analysis in alpha (1-sided) scale (e.g., 0.025). Either alpha.final or Z.crit.final must be specified when determining trial success.

clin.succ.threshold

Clinically meaningful value. Required when succ.crit="clinical".

se.exp

Expected standard error to be observed in the study. Must be specified in continuous case and two-sample binary case.

meandiff.prior

Mean value of prior distribution for mean difference. Relevant for two-sample continuous case.

mean.prior

Mean value of prior distribution for mean. Relevant for one-sample continuous case.

sd.prior

Standard deviation of prior distribution for mean difference (2-sample continuous case) or mean (1-sample continuous case) or prop (2-sample binary case) or difference of proportion (1-sample binary case) or log(HR) (2 sample survival case).

propdiff.prior

Mean value of prior distribution for difference in proportion. Relevant for two-sample binomial case.

prop.prior

Mean value of prior distribution for proportion. Relevant for one-sample binomial case.

hr.prior

Mean value of prior distribution for hazards ratio (HR). Relevant for two-sample survival case.

D.prior

Ignored if sd.prior is specified. If sd.prior is not specified then sd.prior is determined as 2/D.prior. Relevant for two-sample survival case.

Details

This function can be used to determine probability of success (PoS) for a prospective trial for each of continuous (one-sample or two-samples), binary (one-sample or two-samples) and time-to-event endpoints (two-samples). The PoS is calculated based on the prior distribution and expected standard error in the estimate in trial. The calculation PoS is carried out assuming normal distribution for estimated parameter and normal prior distribution. This function can be used to determine clinical success (succ.crit="clinical") and trial success (succ.crit="trial"). For clinical success, clin.succ.threshold must be specified. For trial success, Z.crit.final or alpha.final must be specified.

Author(s)

Madan Gopal Kundu <madan_g.kundu@yahoo.com>

See Also

succ_ia_betabinom_one, succ_ia_betabinom_two, succ_ia

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#--- Example 1
PoS(type="cont", nsamples=2, null.value=-0.05, alternative="greater", 
        N=1552, a=1,  
        succ.crit="trial", Z.crit.final=1.97,
        se.exp=0.12*sqrt(1/776 + 1/776),
        meandiff.prior=0, sd.prior=0.02) 

#--- Example 2
PoS(type="bin", nsamples=2, null.value=0, alternative="greater", 
        N=210, a=2,  
        succ.crit="trial", Z.crit.final=2.012,
        se.exp=0.5*sqrt(1/140 + 1/70),
        propdiff.prior=0.20, sd.prior=sqrt(0.06)) 

PoS(type="bin", nsamples=2, null.value=0, alternative="greater", 
        N=210, a=2,  
        succ.crit="clinical", clin.succ.threshold =0.15,
        se.exp=0.5*sqrt(1/140 + 1/70),
        propdiff.prior=0.20, sd.prior=sqrt(0.06)) 

#--- Example 4
PoS(type="surv", nsamples=2, null.value=1, alternative="less", 
        D=441,  
        succ.crit="trial", Z.crit.final=1.96,
        hr.prior=0.71, D.prior=133) 

PoS(type="surv", nsamples=2, null.value=1, alternative="less", 
        D=441,  
        succ.crit="clinical", clin.succ.threshold =0.8,
        hr.prior=0.71, D.prior=133) 

LongCART documentation built on May 31, 2021, 9:09 a.m.

Related to PoS in LongCART...