Skip to main content

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 .txt output 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

filtpostqc_eu-0.1.3.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

filtpostqc_eu-0.1.3-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

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

Hashes for filtpostqc_eu-0.1.3.tar.gz
Algorithm Hash digest
SHA256 b4c5912805c6be43aeb8d3b570e09367849951299ce10585f52c529e8b7fc40b
MD5 539a6b927b3afef2f05742d4a9852fff
BLAKE2b-256 3cb4e74409c6dcca24c8f1d523de61b9829ffa22720c74aadae4279a943f12ad

See more details on using hashes here.

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

Hashes for filtpostqc_eu-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 524c995bb1fc771200dca9defc551f3ce6cb6c41d5e6743f71519c40b4ac4da9
MD5 25b64f87b6368ee9df426bc9e9e1034f
BLAKE2b-256 012ffd67740d4781dd0d083277ea7b28c4def4ca5217bcb0fb22f76801d8516c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page