# ------------------------------------------------ # CITATION.cff file created with {cffr} R package # See also: https://docs.ropensci.org/cffr/ # ------------------------------------------------ cff-version: 1.2.0 message: 'To cite package "iconic" in publications use:' type: software license: MIT title: 'iconic: Causal Model Selection with Genetic Instruments and Negative Controls' version: 0.99.5 doi: 10.64898/2026.08.26.26361466 abstract: 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) . authors: - family-names: Bresnahan given-names: Sean T. email: seantbresnahan3@gmail.com orcid: https://orcid.org/0000-0001-6685-1930 - family-names: Xiong given-names: Charis email: charis.xiong@gmail.com preferred-citation: type: article title: 'ICONIC: An R Package for Integrating Instrumental Variable- and Negative-Control-Informed Causal Discovery and Diagnostics in Multiomic Studies' authors: - family-names: Bresnahan given-names: Sean T. email: seantbresnahan3@gmail.com orcid: https://orcid.org/0000-0001-6685-1930 - family-names: Xiong given-names: Charis email: charis.xiong@gmail.com - family-names: Head given-names: S. Taylor - family-names: Chang given-names: Yung-Han - family-names: Bhattacharya given-names: Arjun - family-names: Huang given-names: Jonathan Yinhao journal: medRxiv year: '2026' doi: 10.64898/2026.08.26.26361466 notes: Preprint repository: https://bioc.r-universe.dev repository-code: https://github.com/sbresnahan/iconic commit: c7ba0c57d6d6eccf9c683986746cc6ce84146d8a url: https://seantbresnahan.com/iconic/ date-released: '2026-11-17' contact: - family-names: Bresnahan given-names: Sean T. email: seantbresnahan3@gmail.com orcid: https://orcid.org/0000-0001-6685-1930