Sovereign 8s.is mirror of standardgalactic/fastGxE
  • C++ 96.4%
  • Python 2.5%
  • CMake 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-11-06 17:03:28 +01:00
.vscode Signed-off-by: Chao Ning 2025-10-16 15:17:33 +02:00
app/linux Signed-off-by: Chao Ning 2025-10-17 09:58:30 +02:00
docs Signed-off-by: chaoning <ningchao91@gmail.com> 2025-11-06 17:03:28 +01:00
example Signed-off-by: Chao Ning 2025-10-17 09:58:30 +02:00
external Signed-off-by: Chao Ning 2025-10-16 15:17:33 +02:00
fastgxe Signed-off-by: chaoning <ningchao91@gmail.com> 2025-10-29 11:05:49 +01:00
gmatrix Signed-off-by: Chao Ning 2025-10-16 15:17:33 +02:00
simu Signed-off-by: Chao Ning 2025-10-16 15:17:33 +02:00
test Signed-off-by: Chao Ning 2025-10-16 15:17:33 +02:00
utils Signed-off-by: chaoning <ningchao91@gmail.com> 2025-10-29 11:05:49 +01:00
CMakeLists.txt Signed-off-by: chaoning <ningchao91@gmail.com> 2025-10-29 11:05:49 +01:00
LICENSE.md Chao Ning 2025-03-10 13:57:32 -04:00
README.md Signed-off-by: chaoning <ningchao91@gmail.com> 2025-10-29 11:05:49 +01:00

# fastGxE: Powering genome-wide detection of genotype-environment interactions in biobank studies

Overview

scheme

fastGxE is a scalable and effective method designed for genome-wide GxE association analysis. fastGxE handles multiple environmental factors and examines one SNP at a time, decomposing the phenotype into SNP main effect, environmental main effects, GxE interaction effects, while controlling for polygenic effects, polygenic interaction effects, and noise heterogeneity (a). fastGxE evaluates various GxE effect size configurations and combines the resulting p-values into a single p-value to test whether the SNP interacts with at least one environmental factor (b). By explicitly modeling polygenic background and heteroscedastic noise, fastGxE generates calibrated p-values for identifying candidate GxE loci (c). Additionally, it utilizes mmSuSiE, an extension of the SuSiE algorithm, to identify the environmental factors driving the detected GxE interactions and employs the stratified Wald test to visualize and support these interactions (d).

Installation

Linux Executable

A statically compiled executable for 64-bit Linux systems is available: fastGxE Linux Executable. This can be used directly on compatible systems.

chmod +x fastgxe
./fastgxe -h

Prerequisites

Ensure the following dependencies are installed on your system:

  • C++ Compiler (GCC 9+ or Intel C++ Compiler)
  • CMake (Version 3.16 or higher)
  • Intel MKL (2024.1)
  • GSL (2.7)
  • Eigen (3.4.0)
  • LBFGSpp
  • OpenMP
  • CLI
  • spdlog

Installation Steps

1. Clone the Repository

git clone https://github.com/chaoning/fastGxE.git
cd fastGxE

2. Set Up Dependencies

Modify CMakeLists.txt to update the paths of external libraries (MKL, GSL, Eigen, LBFGSpp, etc.) according to your system.

3. Build the Project

Run the following commands to compile fastGxE:

mkdir build
cd build
cmake ..
cmake --build .

4. Run fastGxE

After compilation, you can execute FastGxE:

./fastgxe -h

Notes

  • If you encounter missing library errors, check that all paths in CMakeLists.txt are correctly configured.
  • Use make clean && make to rebuild after modifications.

How to use fastGxE

Check our vignettes.

Citing the work

If you find the fastGxE package or any of the source code in this repository useful for your work, please cite:

Chao Ning and Xiang Zhou (2025). Powering genome-wide detection of genotype-environment interactions in biobank studies.

Visit our group website for more statistical tools on analyzing genetics, genomics and transcriptomics data.