Package: iconic 0.99.5
iconic: Causal Model Selection with Genetic Instruments and Negative Controls
Provides a model selection workflow for causal inference with genetic instruments and negative controls in observational omics data. The package fits eight estimators of the natural direct and indirect effects (NDE/NIE), diagnoses which are valid for the user's data via instrument-strength checks and negative-control validity screens (A1, A2, A2'), stress-tests them against confounding and pleiotropy violations, and recommends the estimator most likely to be unbiased. A hybrid generative texture model (a torch GAN for sample-level structure and a Gaussian copula for the mediator panel) lets the sensitivity analysis mirror the marginal and joint structure of the user's cohort. The modular API comprises iconic_data() to standardize data, iconic_diagnose() to assess estimator eligibility, iconic_estimate() to fit all eligible estimators, iconic_sensitivity() to sweep instrument exogeneity, iconic_recommend() to rank estimators by identification strength and robustness, and iconic_prospect() to plan future studies. infer_confounding() estimates held-fixed confounding parameters from the data. Multi-omic cohorts are supplied as MultiAssayExperiment objects (omics panels as experiments, sample-level exposure, instruments and covariates as colData), and analysis data can be exported back to MultiAssayExperiment. Helper functions construct exposure instruments (polygenic scores from GWAS summary statistics or PGS Catalog scoring files), mediator instruments (GenomicRanges-based cis-eQTL scans and elastic-net predicted-expression composites from RangedSummarizedExperiment or matrix inputs), and negative-control panels (principal components of residualized omics matrices). Time-to-event outcomes are supported on the Cox log-hazard-ratio and restricted-mean-survival-time scales. Binary outcomes are supported on the log-odds-ratio (logistic two-stage predictor-substitution outcome stage) and risk-difference (linear probability model) scales. The torch package is required for the generative texture model (sensitivity and prospective analysis); all other functionality works without it. The methods are described in Bresnahan et al. (2026) <doi:10.64898/2026.08.26.26361466>.
Authors:
iconic_0.99.5.tar.gz
iconic_0.99.5.zip(r-4.7-any)iconic_0.99.5.zip(r-4.6-any)iconic_0.99.5.zip(r-4.5-any)
iconic_0.99.5.tgz(r-4.6-any)iconic_0.99.5.tgz(r-4.5-any)
iconic_0.99.5.tar.gz(r-4.7-any)iconic_0.99.5.tar.gz(r-4.6-any)
iconic_0.99.5.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
iconic/json (API)
| # Install 'iconic' in R: |
| install.packages('iconic', repos = c('https://bioc.r-universe.dev', 'https://cloud.r-project.org')) |
Bug tracker:https://github.com/sbresnahan/iconic/issues
Pkgdown/docs site:https://seantbresnahan.com
statisticalmethodgeneticsmultiplecomparisonregressiontranscriptomicsrnaseqsurvivalgeneexpressionsnpgeneticvariabilitybioinformaticscausal-inferencecopulaepigenomicsgangenomicsinstrumental-variablesmediation-analysismendelian-randomizationnegative-controlsomicssensitivity-analysis
Last updated from:c7ba0c57d6. Checks:1 NOTE, 9 OK. Indexed: yes.
| Target | Result | Time | Files | Syslog |
|---|---|---|---|---|
| bioc-checks | NOTE | 216 | ||
| linux-devel | OK | 831 | ||
| source / vignettes | OK | 370 | ||
| linux-release | OK | 806 | ||
| macos-release | OK | 1043 | ||
| macos-oldrel | OK | 785 | ||
| windows-devel | OK | 903 | ||
| windows-release | OK | 878 | ||
| windows-oldrel | OK | 560 | ||
| wasm-release | OK | 136 |
Exports:analyze_mediation_robustanalyze_methods_parallelanalyze_methods_robustapply_fusion_weightsas_iconic_dataas_MultiAssayExperimentbeta_to_mbuild_mediator_instrumentsbuild_prs_ldpred2build_w_pcscall_cis_eqtlscheck_instrument_strengthcheck_torch_setupcomposite_p_valuefit_cocafit_coca_binfit_coca_mediationfit_coca_mediation_binfit_coca_mediation_survfit_coca_survfit_directfit_direct_binfit_direct_mediationfit_direct_mediation_binfit_direct_mediation_survfit_direct_survfit_iv2slsfit_iv2sls_binfit_iv2sls_mediationfit_iv2sls_mediation_binfit_iv2sls_mediation_survfit_iv2sls_mediation2fit_iv2sls_mediation2_binfit_iv2sls_mediation2_survfit_iv2sls_survfit_pgcfit_pgc_binfit_pgc_mediationfit_pgc_mediation_binfit_pgc_mediation_survfit_pgc_mediation2fit_pgc_mediation2_binfit_pgc_mediation2_survfit_pgc_scalarfit_pgc_scalar_mediationfit_pgc_survfit_unadj_binfit_unadj_mediationfit_unadj_mediation_binfit_unadj_mediation_survfit_unadj_survgan_mediation_sensitivitygan_pleiotropy_sensitivitygan_sensitivitygenerate_toy_dataiconic_dataiconic_diagnoseiconic_estimateiconic_method_colorsiconic_method_ordericonic_prospecticonic_recommendiconic_sensitivityinfer_confoundinglist_nc_modelsload_real_input_datanc_completeness_capturenc_completeness_checknc_cpgnc_independence_checknc_independence_check_gmnc_proxync_support_checknc_validity_checknc_validity_screenplot_biasplot_bias_boxplotplot_bias_distributionplot_degradation_surfaceplot_estimate_distributionplot_estimated_vs_trueplot_estimator_benchmarkplot_feature_correlation_sweepplot_gan_diagnosticsplot_instrument_strength_sweepplot_model_selectionplot_nc_coverage_comparisonplot_nc_validity_diagnosticsplot_pleiotropy_sweepplot_powerplot_prospective_analysisplot_sensitivity_heatmapplot_type1_boxplotplot_type1_errorplot_type1_vs_confqc_gwas_sumstatsrecommend_estimatorresidualize_matrixrun_mediation_simrun_null_mediation_simrun_null_simrun_simulationrun_single_iterationsample_feature_texturesample_texturescenario_manifestscore_pgs_panelsimulate_single_genetic_instrumentsweep_instrument_strengthsweep_mediation_null_by_confsweep_mediation_paramsweep_nc_validitysweep_null_by_confsweep_paramtrain_feature_texturetrain_gan_on_real_data
Dependencies:abindAERbackportsBiobaseBiocBaseUtilsBiocGenericsbootbroomcarcarDataclicolorspacecowplotcpp11DelayedArrayDerivdoBydplyrfarverforecastFormulafracdiffgenericsGenomicRangesggplot2gluegtableIRangesisobandlabelinglatticelifecyclelme4lmtestmagrittrMASSMatrixMatrixGenericsMatrixModelsmatrixStatsmgcvminqamodelrMultiAssayExperimentnlmenloptrnnetnumDerivpbkrtestpillarpkgconfigpurrrquantregR6rbibutilsRColorBrewerRcppRcppArmadilloRcppEigenRdpackreformulasrlangS4ArraysS4VectorsS7sandwichscalesSeqinfoSparseArraySparseMstringistringrSummarizedExperimentsurvivaltibbletidyrtidyselecttimeDateurcautf8vctrsviridisLitewithrXVectorzoo
Last update: 2026-11-17
Started: 2026-07-26
Last update: 2026-11-17
Started: 2026-07-22
Last update: 2026-11-17
Started: 2026-07-26
Last update: 2026-11-17
Started: 2026-07-26
Last update: 2026-11-17
Started: 2026-07-26
Last update: 2026-11-16
Started: 2026-08-12
