Package: pwrFDR 3.2.4

pwrFDR: FDR Power

Computing Average and TPX Power under various BHFDR type sequential procedures. All of these procedures involve control of some summary of the distribution of the FDP, e.g. the proportion of discoveries which are false in a given experiment. The most widely known of these, the BH-FDR procedure, controls the FDR which is the mean of the FDP. A lesser known procedure, due to Lehmann and Romano, controls the FDX, or probability that the FDP exceeds a user provided threshold. This is less conservative than FWE control procedures but much more conservative than the BH-FDR proceudre. This package and the references supporting it introduce a new procedure for controlling the FDX which we call the BH-FDX procedure. This procedure iteratively identifies, given alpha and lower threshold delta, an alpha* less than alpha at which BH-FDR guarantees FDX control. This uses asymptotic approximation and is only slightly more conservative than the BH-FDR procedure. Likewise, we can think of the power in multiple testing experiments in terms of a summary of the distribution of the True Positive Proportion (TPP), the portion of tests truly non-null distributed that are called significant. The package will compute power, sample size or any other missing parameter required for power defined as (i) the mean of the TPP (average power) or (ii) the probability that the TPP exceeds a given value, lambda, (TPX power) via asymptotic approximation. All supplied theoretical results are also obtainable via simulation. The suggested approach is to narrow in on a design via the theoretical approaches and then make final adjustments/verify the results by simulation. The theoretical results are described in Izmirlian, G (2020) Statistics and Probability letters, "<doi:10.1016/j.spl.2020.108713>", and an applied paper describing the methodology with a simulation study is in preparation. See citation("pwrFDR").

Authors:Grant Izmirlian [aut, cre]

pwrFDR_3.2.4.tar.gz
pwrFDR_3.2.4.zip(r-4.5)pwrFDR_3.2.4.zip(r-4.4)pwrFDR_3.2.4.zip(r-4.3)
pwrFDR_3.2.4.tgz(r-4.5-any)pwrFDR_3.2.4.tgz(r-4.4-any)pwrFDR_3.2.4.tgz(r-4.3-any)
pwrFDR_3.2.4.tar.gz(r-4.5-noble)pwrFDR_3.2.4.tar.gz(r-4.4-noble)
pwrFDR_3.2.4.tgz(r-4.4-emscripten)pwrFDR_3.2.4.tgz(r-4.3-emscripten)
pwrFDR.pdf |pwrFDR.html
pwrFDR/json (API)

# Install 'pwrFDR' in R:
install.packages('pwrFDR', repos = c('https://izmirlig.r-universe.dev', 'https://cloud.r-project.org'))

On CRAN:

Conda:

This package does not link to any Github/Gitlab/R-forge repository. No issue tracker or development information is available.

2.58 score 19 scripts 405 downloads 32 exports 72 dependencies

Last updated 2 months agofrom:292071f22f. Checks:5 OK, 3 NOTE. Indexed: yes.

TargetResultLatest binary
Doc / VignettesOKFeb 13 2025
R-4.5-winNOTEFeb 13 2025
R-4.5-macNOTEFeb 13 2025
R-4.5-linuxNOTEFeb 13 2025
R-4.4-winOKFeb 13 2025
R-4.4-macOKFeb 13 2025
R-4.3-winOKFeb 13 2025
R-4.3-macOKFeb 13 2025

Exports:%,%%over%arg.valsbacksolve.seFDPoalphabacksolve.seTPPoavgpwrbasic.tmPrintcc.ROCcCDF.RomcCDF.ToMcCDF.VoRCDF.PvalCDF.Pval.apsi.eq.uCDF.Pval.au.eq.uCDF.Pval.HAcontrolFDPcriteriondetaildistses.ROCgentempfilenmif.0.rmif.na.xif.y.zjoin.tbllogitlogitInvnnapwrFDRpwrFDR.gridsd.rtm.Romsd.rtm.ToMsd.rtm.VoR

Dependencies:askpassbase64encbslibcachemclicolorspacecpp11data.tabledigestevaluatefansifarverfastmapflextablefontawesomefontBitstreamVerafontLiberationfontquiverfsgdtoolsggplot2gluegtablehighrhtmltoolsisobandjquerylibjsonliteknitrlabelinglatticelifecyclemagrittrMASSMatrixmemoisemgcvmimemunsellmvtnormnlmeofficeropensslpillarpkgconfigR6raggrappdirsRColorBrewerRcpprlangrmarkdownsassscalesstringistringrsyssystemfontsTableMonstertextshapingtibbletinytexutf8uuidvctrsviridisLitewithrxfunxml2xtableyamlzip

Using pwrFDR

Rendered frompwrFDR-vignette.Rnwusingutils::Sweaveon Feb 13 2025.

Last update: 2025-01-14
Started: 2024-12-18

Readme and manuals

Help Manual

Help pageTopics
Division operator with divide by zero clobbering%over%
Extracts the full argument list and call attribute.arg.vals
Find missing argument giving required se[FDP]/alpha (or se[TPP]/average.power)backsolve.seFDPoalpha backsolve.seTPPoavgpwr
Wrapper to Print a Basic Nicely Formatted Tablebasic.tmPrint
Computes the optimal number of controls per case in hypothesis tests involving the ROC. Included here with the intent that it can be used in conjunction with 'pwrFDR' to allow power/sample size calculation for multiple tests of ROC curve based hypothesis. See details.cc.ROC
Computes the complimentary CDF for the significant call proportion, R_m/m.cCDF.Rom
Computes the complimentary CDF for the true positive proportion, T_m/M_m.cCDF.ToM
Computes the complimentary CDF for the false discovery proportion, V_m/R_m.cCDF.VoR
CDF of pooled (H0 and HA) population p-valuesCDF.Pval
Calculates the fixed point for the Romano procedure.CDF.Pval.apsi.eq.u
Function which solves the implicit equation u = G( u alpha)CDF.Pval.au.eq.u
CDF of p-values for test statistics distribted under HA.CDF.Pval.HA
Helper function for the BHFDX FDP control methodcontrolFDP
BH-FDR and Romano Criterioncriterion
The detail extraction function for simulated power objectsdetail
The Distribution family objectdists
Computes the equivalent Z-test effect size in hypothesis tests involving the ROC. Included here with the intent that it can be used in conjunction with 'pwrFDR' to allow power/sample size calculation for multiple tests of ROC curve based hypothesis. See details.es.ROC
Generate a tempfile namegentempfilenm
A helper function- remove if zero.if.0.rm
A helper function - substitute 'NA's with a specified 'x'.if.na.x
A helper function - substitute 'y''s with a specified 'z'.if.y.z
Combine pwrFDR Resultsjoin.tbl
Computes the logit transformlogit
Computes the inverse logit transformlogitInv
A helper function- turns a missing column into 'NA's inside of a with statementnna
The paste operator%,% paste
Ensemble power or sample size under selected control of the FDPpwrFDR
Evaluate 'pwrFDR' on a grid.pwrFDR.grid
Extractor function for asymptotic sd[R_m/m] under selected FDP control methodsd.rtm.Rom
Extractor function for asymptotic sd[T_m/M_m] under selected FDP control methodsd.rtm.ToM
Extractor function for asymptotic sd[V_m/R_m] under selected FDP control methodsd.rtm.VoR