A CLI tool to apply post-GWAS QC filtering to Regenie merged summary statistics using EU-based variant filters.
Project description
FiltpostQC-EU
Author: Etienne Kabongo Affiliation: Audrey Grant Lab – Computational Genomics, McGill University Contact: etienne.kabongo@mcgill.ca
🧬 FiltpostQC-EU: Post-GWAS Filtering Tool for Regenie Results
FiltpostQC-EU is a robust and lightweight Python CLI tool developed to perform post-GWAS variant-level quality control on summary statistics generated by the REGENIE software. It filters variants based on an external European QC filter file and optionally formats the results for FUMA downstream annotation.
✨ Key Features
- ✅ Input: Accepts Regenie merged summary statistics.
- 📊 Filtering: Retains only variants present in a QC-filter file (e.g., MAF, INFO, HWE).
- 🧪 Output: Supports filtered
.txtoutput and/or FUMA-compatible files. - 🧠 Bioinformatics-Ready: Designed for UK Biobank and large-scale GWAS datasets.
- ⚙️ CLI Interface: Fully command-line operable with detailed help menu.
📦 Installation
pip install FiltpostQC-EU
Or from source:
git clone https://github.com/EtienneNtumba/FiltpostQC-EU.git
cd FiltpostQC-EU
pip install .
🚀 Usage
filtpostqc-eu -i path/to/regenie_merged.txt \
-f path/to/filter.tsv \
-o filtered_output.txt \
--fuma fuma_output.txt \
--format both
Arguments
| Argument | Description |
|---|---|
-i, --input |
Path to merged Regenie file (required) |
-f, --filter |
QC filter file (e.g., MAF/HWE/INFO based) (required) |
-o, --output |
Output for filtered Regenie results (default: filtered_output.txt) |
--fuma |
Output path for FUMA-formatted file (default: fuma_output.txt) |
--format |
Output format: filtered, fuma, or both (default: both) |
--version |
Print the tool version |
📂 Input Format
Merged Regenie File (P0_GWAS_qc_merged.txt)
Must contain columns like:
Name Chr Pos Ref Alt Trait Effect Pval Num_Cases Num_Controls Info
QC Filter File (EUR_QC_filter_regenie.tsv)
Must contain at least:
Name Chr Pos Ref Alt
🧬 FUMA Output Format
The FUMA-compatible file will include:
Chr,Pos,Name,Ref,Alt,Num_Cases,Num_Controls,Beta,Se,Pval
👨🔬 About the Developer
This tool was created by Etienne Kabongo, computational biologist and research assistant in the Audrey Grant Lab at McGill University.
Our research focuses on large-scale genomic analyses, GWAS pipelines, and post-GWAS interpretation frameworks.
📄 License
MIT License
📬 Contact
For feedback, bug reports, or feature requests, feel free to contact:
- ✉️ Etienne Kabongo:
etienne@example.com
⭐ Acknowledgements
- Regenie: For efficient GWAS computation
- FUMA: For functional mapping and annotation
"Reliable QC is the foundation of reproducible GWAS."
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file filtpostqc_eu-0.1.3.tar.gz.
File metadata
- Download URL: filtpostqc_eu-0.1.3.tar.gz
- Upload date:
- Size: 4.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b4c5912805c6be43aeb8d3b570e09367849951299ce10585f52c529e8b7fc40b
|
|
| MD5 |
539a6b927b3afef2f05742d4a9852fff
|
|
| BLAKE2b-256 |
3cb4e74409c6dcca24c8f1d523de61b9829ffa22720c74aadae4279a943f12ad
|
File details
Details for the file filtpostqc_eu-0.1.3-py3-none-any.whl.
File metadata
- Download URL: filtpostqc_eu-0.1.3-py3-none-any.whl
- Upload date:
- Size: 5.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
524c995bb1fc771200dca9defc551f3ce6cb6c41d5e6743f71519c40b4ac4da9
|
|
| MD5 |
25b64f87b6368ee9df426bc9e9e1034f
|
|
| BLAKE2b-256 |
012ffd67740d4781dd0d083277ea7b28c4def4ca5217bcb0fb22f76801d8516c
|