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.2.tar.gz (4.4 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.2-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file filtpostqc_eu-0.1.2.tar.gz.

File metadata

  • Download URL: filtpostqc_eu-0.1.2.tar.gz
  • Upload date:
  • Size: 4.4 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.2.tar.gz
Algorithm Hash digest
SHA256 d8c9d322b4a24b166148197305e8abd05a317547b04f79f89c3c1307990e1231
MD5 e49f7fb7c7d7c7fc3839a627c464c9ad
BLAKE2b-256 3acc9f039b8170c7869515b77d021856e26c45559f6d0db3f1db0f61aeea2540

See more details on using hashes here.

File details

Details for the file filtpostqc_eu-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: filtpostqc_eu-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 4.9 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 108536cc2044763ff41b65309cf4b61ef85d60de54994999a676f287fcf39970
MD5 01336a012c32dbac8b920f7d62a8eb21
BLAKE2b-256 40525fd453350d791a58e789f3b43fa3c9344ea5162f5459bcc39a56b9efd8b2

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