UnivAIRRse: A Unified Framework for Organizing and Comparing Adaptive Immune Receptor Repertoire Simulators
Authors:
- Nika AbdollahiNANika Abdollahi
- Sara KavehSKSara Kaveh
- Sogand ShayestehSogand Shayesteh
- Shayesteh MommahedSMShayesteh Mommahed
- Yasamin AlemzadehYAYasamin Alemzadeh
- Reihaneh ZarrinRZReihaneh Zarrin
- Fatemeh Chaker HosseiniFHFatemeh Chaker Hosseini
- Parsa EsmaeiliPEParsa Esmaeili
- Reza HassanzadehRHReza Hassanzadeh
- Sofia KossidaSofia Kossida
- Changiz EslahchiCEChangiz Eslahchi
Preprint
Abstract
Adaptive immune receptor repertoire sequencing (AIRR-seq) enables large-scale profiling of B- and T-cell receptor diversity and has become a cornerstone of modern computational immunology. However, AIRR-seq provides only a partial and lossy molecular snapshot of immune dynamics, lacking explicit ground truth for clonal ancestry, lineage trajectories, antigen specificity, and longitudinal immune evolution. This limitation complicates benchmarking, method validation, and mechanistic interpretation of repertoire analysis pipelines. Here, we introduce UnivAIRRse, a unified hierarchical framework that organizes AIRR simulators within a shared conceptual coordinate system spanning five operational levels, from observed sequence data to the theoretical generative potential of the adaptive immune system. By explicitly distinguishing sequence-, clonal-, specificity-, repertoire-, and generative-level representations, UnivAIRRse enables systematic comparison of simulator assumptions, biological scope, abstraction level, and application focus. To our knowledge, this is the first review to formalize such a unified structure across biological, computational, and functional layers of AIRR simulation. Using this framework, we review how simulation supports benchmarking, strengthens computational inference, and enables multi-scale investigation of immune repertoire formation and evolution. We identify persistent limitations in existing simulators, including incomplete biological context, limited modularity, restricted interoperability, and overreliance on AIRR-seq as a molecular proxy for complex spatiotemporal immune processes. To operationalize this framework, we provide an interactive web-based AIRR Simulation Landscape Explorer (publicly available at https://www.imgt.org/AIRR-Simulator/ ) that enables dynamic filtering and comparison of simulators across biological scope, abstraction level, output fidelity, and application focus. Finally, we outline emerging directions toward digital-twin–ready immune simulation, emphasizing modular architectures, longitudinal multi-omic integration, uncertainty quantification, and dynamic model updating. By providing a coherent conceptual and operational coordinate system, UnivAIRRse establishes a foundation for reproducible, interpretable, and clinically actionable modeling of adaptive immune repertoires, bridging current simulation practices with the next generation of predictive and personalized immunological modeling. Abstract Figure:Keywords
This publication has 55 references indexed in Scilit:
- Challenges and future directions of AIRR-seq-based diagnosticsImmunoInformatics, 2025
- Single-cell immune repertoire analysisNature Methods, 2024
- Mathematical Characterization of Private and Public Immune Receptor SequencesBulletin of Mathematical Biology, 2023
- Understanding repertoire sequencing data through a multiscale computational model of the germinal centernpj Systems Biology and Applications, 2023
- Reference-based comparison of adaptive immune receptor repertoiresCell Reports Methods, 2022
- Mining adaptive immune receptor repertoires for biological and clinical information using machine learningCurrent Opinion in Systems Biology, 2020
- Digital Twins and Cyber–Physical Systems toward Smart Manufacturing and Industry 4.0: Correlation and ComparisonEngineering, 2019
- High-throughput immune repertoire analysis with IGoRNature Communications, 2018
- Digital Twin: Mitigating Unpredictable, Undesirable Emergent Behavior in Complex Systems2016
- Theoretical studies of clonal selection: Minimal antibody repertoire size and reliability of self-non-self discriminationJournal of Theoretical Biology, 1979