pa.ABE {PowerTOST} | R Documentation |
Power analysis for average bioequivalence (ABE)
Description
An analysis tool for exploration/visualization of the impact of expected values (CV, theta0, reduced sample size due to drop-outs) on power of BE decision via ABE if these values deviate from the ones assumed in planning the sample size of the study.
Usage
pa.ABE(CV, theta0 = 0.95, targetpower = 0.8, minpower = 0.7, design = "2x2", ...)
## S3 method for class 'pwrA'
print(x, digits = 4, plotit = TRUE, ...)
## S3 method for class 'pwrA'
plot(x, pct = TRUE, ratiolabel = "theta0", cols = c("blue", "red"), ...)
Arguments
CV |
Coefficient of variation as ratio (not percent). |
theta0 |
‘True’ or assumed T/R ratio. Often named GMR. |
targetpower |
Power to achieve at least in sample size estimation. Must be >0 and <1. |
minpower |
Minimum acceptable power to have if deviating from assumptions for sample size plan. |
design |
Character string describing the study design. |
... |
More arguments to pass to |
Additional arguments of the S3 methods:
x |
Object of class |
digits |
Digits for rounding power in printing. The '...' argument is currently ignored
in |
plotit |
If set to |
pct |
If set to |
ratiolabel |
Label of the T/R-ratio. Can be set to any string, e.g. to |
cols |
Colors for the plots. |
Details
Power calculations are done via power.TOST()
and calculations of CV and theta0
which gave a power=minpower
are derived via R base uniroot
.
While one of the parameters (CV
, theta0
, n
) is varied, the respective two others are
kept constant. The tool shows the relative impact of single parameters on power.
The tool takes a minimum of 12 subjects as required in most BE guidances into account.
It should be kept in mind that this is not a substitute for the ‘Sensitivity Analysis’
recommended in ICH-E9. In a real study a combination of all effects occurs simultaneously.
It is up to you to decide on reasonable combinations and analyze their respective power.
Value
Returns a list with class "pwrA"
with the components
plan |
A data.frame with the result of the sample size estimation.
See output of |
paCV |
A data.frame with value pairs CV, pwr for impact of deviations from CV. |
paGMR |
A data.frame with value pairs theta0, pwr for impact of deviations from theta0 (GMR). |
paN |
A data.frame with value pairs N, pwr for impact of deviations from planned N (dropouts). |
method |
Method of BE decision. Here "ABE". |
minpower |
Minimum acceptable power. |
The class 'pwrA'
has the S3 methods print()
and plot()
.
See pa.scABE
for usage.
Note
The code of deviations from planned sample size tries to keep the degree of imbalance as low as possible between (sequence) groups. This results in a lesser decrease of power than more extreme dropout-patterns.
Author(s)
Idea and original code by H. Schütz with modifications by D. Labes to use PowerTOST infrastructure.
References
Schütz H. Deviating from assumptions. August 08, 2014. BEBA Forum
See Also
power.TOST, known.designs, pa.scABE, pa.NTIDFDA
Examples
# using the defaults
# design="2x2", targetpower=0.8, minpower=0.7, theta0/GMR=0.95
# BE margins from defaults of sampleN.TOST() 0.8 ... 1.25
# print & plot implicitly
pa.ABE(CV = 0.2)
# print & plot
res <- pa.ABE(CV = 0.2)
print(res, plotit = FALSE) # print only
plot(res, pct = FALSE, ratiolabel = "GMR") # changed from defaults