GWASMind Tutorial

A comprehensive guide to using GWASMind for interactive GWAS visualization and LLM-powered post-GWAS analysis.


Table of Contents

  1. Getting Started
  2. Uploading Your GWAS Data
  3. Interactive Manhattan Plot
  4. AI Chat Assistant
  5. Auto Locus Annotation & Gene Prioritization
  6. API Configuration

1. Getting Started

GWASMind is a web-based tool for visualizing and analyzing Genome-Wide Association Study (GWAS) results. Key features include:

Homepage showing upload and demo data options

Tip: New to GWASMind? Try our Demo Data (Asthma or Depression GWAS) to explore all features without uploading your own data!


2. Uploading Your GWAS Data

GWASMind accepts GWAS summary statistics in CSV, TSV, or TXT format.

Required Columns

Column Description
chromosome Chromosome number (1-22, X, Y, or chr1-chr22)
position Base pair position (1-based)
pvalue P-value from association test
ref Reference allele
alt Alternative allele

Optional Columns

Column Description
snp_id or rsid SNP identifier (rs number)
beta Effect size
se Standard error

File upload interface with column requirements

Note: Large datasets (>100K SNPs) will be intelligently sampled to maintain smooth performance while preserving statistically significant SNPs.


3. Interactive Manhattan Plot

The Manhattan plot is the main visualization, displaying -log₁₀(p-value) across all chromosomes.

Action Description
Scroll Zoom in/out on the plot
Drag Lasso selection for regions of interest
Shift + Drag Lasso selection for multiple regions
Double-click on chromosome Focus on that chromosome

Plot Controls

Lasso Selection

Draw a selection around SNPs of interest to analyze them:

  1. Click and drag on the plot to draw a selection region
  2. Selected SNPs will be highlighted
  3. A panel will show the selection summary
  4. Click "Label Gene" to annotate the lead SNP

Lasso selection highlighting a genomic region


4. AI Chat Assistant

The AI Chat panel allows you to ask questions about your selected SNPs and receive context-aware responses.

How to Use

  1. Select SNPs using the lasso tool on the Manhattan plot
  2. Click the "Describe selected SNPs" quick prompt, or type your own question
  3. The AI will analyze the selected region and provide insights

Example Questions

AI Chat panel with natural language

Tip: Please keep in mind that GWASMind is an AI system and may produce misleading results..


5. Auto Locus Annotation & Gene Prioritization

The Auto Analysis feature provides comprehensive annotation and gene prioritization for multiple GWAS loci at once.

Input Format

Prepare a file with your significant loci in one of these formats:

Format 1: rsID + Locus ID

rsid,locus_id
rs1002706,1
rs76527307,2
rs12345678,3

Format 2: Full coordinates

chr,pos,ref,alt,locus_id
1,169519049,T,C,1
1,206653061,G,A,2
2,102847563,A,G,3

Auto Analysis tab showing upload area and file format guidance

Analysis Steps

  1. Switch to the "Auto Analysis" tab in the right panel
  2. Enter your target phenotype (e.g., "Asthma", "Type 2 Diabetes")
  3. Upload your loci file or drag-and-drop
  4. Click "Start" to begin the analysis
  5. Watch real-time progress as each locus is annotated

Results

For each locus, GWASMind provides:

For Novel loci:

For Known loci:

Analysis results with locus cards and detail view

Export Results

Click the "XLSX" button to download a comprehensive Excel report containing all analysis results.


6. API Configuration

To use the AI features, you need to configure an LLM API. GWASMind supports multiple providers.

Supported Providers

Provider API Base URL Notes
DeepSeek https://api.deepseek.com Recommended, cost-effective
OpenAI https://api.openai.com/v1 GPT-5.1
Any OpenAI-compatible API Custom URL -

Configuration Steps

  1. Click the "Settings" button in the header
  2. Enter the API Base URL for your provider
  3. Enter your API Key
  4. Specify the model name (e.g., deepseek-chat, gpt-5.2)
  5. Click "Test Connection" to verify
  6. Click "Save" to store your settings

Settings modal with API configuration

Privacy: Your API key is stored locally in your browser and is never sent to our servers. All AI requests are made directly from your browser to the LLM provider.


Need Help?

If you have questions or encounter issues, please visit our Contact page or reach out to our team.