Airqtl

Airqtl is an efficient method to map expression quantitative trait loci (eQTLs) and infer causal gene regulatory networks (cGRNs) from population-scale single-cell studies. The core of airqtl is Array of Interleaved Repeats (AIR), an efficient data structure to store and process donor-level data in the cell-donor hierarchical setting. Airqtl offers over 8 orders of magnitude of acceleration of eQTL mapping with linear mixed models, arising from its superior time complexity and Graphic Processing Unit (GPU) utilization.

This respository is being actively updated. Please check back often.

Installation

Airqtl is on PyPI. To install airqtl, you should first install Pytorch 2. Then you can install airqtl with pip: pip install airqtl or from github: pip install git+https://github.com/grnlab/airqtl.git. Make sure you have added airqtl's install path into PATH environment before using the command-line interface (See FAQ). Airqtl's installation can take several minutes including installing dependencies.

Usage

Airqtl provides both command-line and python interfaces. For starters, you can run airqtl by typing airqtl -h on command-line. Try our tutorial below and adapt it to your own dataset.

Tutorials

Currently we provide one tutorial to map cell state-specific single-cell eQTLs and infer cGRNs from the Randolph et al dataset in docs/tutorials.

Issues

Pease raise an issue on github.

References

• "Airqtl dissects cell state-specific causal gene regulatory networks with efficient single-cell eQTL mapping" (2025) by Lingfei Wang. bioRxiv.

FAQ

• What does airqtl stand for?

  Array of Interleaved Repeats for Quantitative Trait Loci

• Why do I see this error: AssertionError: Torch not compiled with CUDA enabled?

  This is because you installed a CPU-only pytorch but tried to run it on GPU. You have several options:

  1. To run pytorch on CPU, set device='cpu' in Snakefile.config of the tutorial pipeline you use.
  2. To run pytorch on GPU, reinstall pytorch with GPU support at Installation.

• I installed airqtl but typing ``airqtl`` says 'command not found'.

  See below.

• How do I use a specific python version for airqtl's command-line interface?

  You can always use the python command to run airqtl, such as python3 -m airqtl to replace command airqtl. You can also use a specific path or version for python, such as python3.12 -m airqtl or /usr/bin/python3.12 -m airqtl. Make sure you have installed airqtl for this python version.