Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Clinical VCF Variant Annotator & Precision Oncology Platform

Python Streamlit Ensembl VEP ClinVar RCSB PDB License

An enterprise-grade computational biology platform for parsing, annotating, and interpreting genomic variants from VCF files. Connects ClinVar pathogenicity scoring, Ensembl VEP REST API, 3D structural protein mapping, Pharmacogenomics (PGx) screening, and live precision oncology clinical trial retrieval.

Note

Product Demonstration: This repository serves as an architectural overview, feature documentation, and visual demonstration of the platform. Source code and underlying pipelines are maintained in private repositories for proprietary and client confidentiality purposes. Live interactive showcases are available at the Portfolio Website.


🧬 Overview

In clinical genomics and precision oncology, raw VCF v4.2 files contain thousands of genetic variants, making manual identification of pathogenic mutations time-consuming.

Clinical Variant Annotator provides a complete end-to-end analytical workflow:

  • Parses standard VCF v4.2 files, extracting read depth (DP), filter status, Allele Frequency (AF), and clinical significance (CLNSIG).
  • Visualizes patient variant landscapes across chromosomes and pathogenicity classifications (Pathogenic, Benign, VUS).
  • Dynamically fetches 3D protein structures from RCSB PDB and maps mutation loci interactively using py3Dmol.
  • Scans for actionable Pharmacogenomics (PGx) metabolic variants (CYP450 family, DPYD, TPMT) to prevent adverse drug reactions.
  • Connects detected pathogenic driver mutations (BRAF, BRCA1, NRAS) to live approved therapies on Open Targets and active Phase I-III trials on ClinicalTrials.gov.
  • Evaluates Variants of Uncertain Significance (VUS) using real-time PolyPhen-2 and SIFT functional impact predictions from the European Bioinformatics Institute (EBI).

📸 Visual Walkthrough & Core Features

1. Summary Dashboard & VCF Parsing

Upload raw .vcf files for instant automated processing. Displays summary metrics for total variants, pathogenic mutations, VUS, and targetable precision therapies.

Summary Dashboard


2. Variant Distribution Analytics

Interactive charts detailing patient variant distributions by clinical significance (Pathogenic vs. Benign vs. VUS) and chromosomal locus.

Variant Distribution Analytics


3. Universal 3D Protein Structure Mapper

Connects to RCSB PDB to dynamically map mutated genes to 3D protein structures. Interactive py3Dmol WebGL rendering allows zooming, rotation, and mutation locus inspection.

3D Structure View 1 3D Structure View 2 3D Structure View 3


4. Pharmacogenomics (PGx) & Clinical Reporting

Identifies actionable metabolic variants affecting drug metabolism (CYP2C19, DPYD, TPMT), warning clinicians of drug toxicity risks. Generates clean pathogenic variant tables with direct dbSNP links.

Pharmacogenomics and Clinical Report


5. Matched Clinical Trials & Precision Targets

Universal lookup connecting detected driver mutations to FDA-approved drug indications (Open Targets) and recruiting clinical trials (ClinicalTrials.gov).

Matched Clinical Trials


6. AI VUS Predictor (Ensembl VEP REST API Integration)

Real-time API integration fetching SIFT and PolyPhen-2 scores for Variants of Uncertain Significance, backed by sequencing quality control (QC) filtering (DP < 20, FILTER != PASS).

AI VUS Predictor 1 AI VUS Predictor 2


🚀 Key Features

  • VCF v4.2 Ingestion: Fast parsing of SNVs, indels, and multi-sample VCF files.
  • ClinVar & gnomAD Filtering: Filters out common population polymorphisms ($AF &lt; 0.01$) to isolate pathogenic variants.
  • 3D Structural Mapping: WebGL-based visualization of mutated protein domains via RCSB PDB integration.
  • PGx Toxicity Warnings: Automatic alerts for altered drug metabolism profiles (DPYD, TPMT, CYP450).
  • Live Precision Medicine APIs: Direct API connections to Ensembl VEP, NCBI ClinVar, Open Targets EBI, and ClinicalTrials.gov.

📥 Input & Output Specifications

Input

  • Genomic Files: Standard .vcf or .vcf.gz (hg19 / hg38 reference genome build).
  • Quality Cutoffs: Customizable Read Depth (DP) and Allele Frequency (AF) thresholds.

Output

  • Interactive Dashboard: Full multi-tab diagnostic interface.
  • Clinical Variant Summary: Exportable reports listing pathogenic findings, PGx warnings, and matched clinical trials.

💻 Tech Stack

  • Frontend & Dashboard: Streamlit, Altair, Pandas
  • Genomic APIs: Ensembl VEP REST API, NCBI ClinVar, RCSB PDB API, Open Targets EBI
  • 3D Molecular Rendering: py3Dmol / WebGL
  • Report Generation: FPDF2

📄 License

Distributed under the MIT License. See LICENSE for more information.

About

Clinical VCF variant annotation platform integrating Ensembl VEP, ClinVar, 3D PDB structural mapping, pharmacogenomics (PGx), and precision oncology clinical trials.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors