File size: 2,183 Bytes
9afd7b7
e611d1f
 
 
 
9afd7b7
9aa7c61
9afd7b7
 
 
 
 
e611d1f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
---
title: B-cell Epitope Prediction Server
emoji: 🧬
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.36.2
app_file: app.py
pinned: false
license: mit
---

# 🧬 B-cell Epitope Prediction Server

A web-based interface for B-cell epitope prediction using the ReCEP model.

## 📋 How to Use

### 1. Input Protein Structure

Choose one of two input methods:

#### Option A: PDB ID
- Enter a 4-character PDB ID (e.g., "5I9Q")
- Specify the chain ID (e.g., "A")

#### Option B: Upload PDB File
- Upload a PDB structure file (.pdb or .ent format)
- Optionally specify a custom PDB ID
- Specify the chain ID

### 2. Configure Prediction Parameters

#### Basic Parameters:
- **Chain ID**: Target protein chain (default: A)

#### Advanced Parameters (Optional):
- **Radius**: Spherical region radius in Ångstroms (default: 19.0)
- **Top-k Regions**: Number of top regions to analyze (default: 7)
- **Encoder**: Protein encoder type (ESM-C only now)
- **Device Configuration**: CPU or GPU processing (CPU Only now)
- **Threshold**: Custom prediction threshold (leave empty for auto, required)

### 3. View Results

The application provides:

#### Prediction Summary
- Protein information (PDB ID, chain, length, sequence)
- Prediction statistics (epitope count, coverage rate, etc.)
- Top-k region centers
- Predicted epitope residues
- Binding region residues

#### Download Options
- **JSON Results**: Complete prediction data with metadata
- **CSV Results**: Residue-level predictions for analysis
- **3D Visualization**: Interactive HTML file with 3Dmol.js viewer

### 4. 3D Visualization

The downloadable HTML file includes:
- **Display Modes**: 
  - Predicted Epitopes: Highlight predicted epitope residues
  - Probability Gradient: Color residues by prediction confidence
- **Representation Styles**: Cartoon, Surface, Stick, Sphere
- **Interactive Controls**: Rotate, zoom, pan, reset view, save image

## 📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

**Note**: This is a research tool for B-cell epitope prediction. Results should be validated through experimental methods for clinical or commercial applications.