How vigneshreddykura/ecabsd works
ECABSD predicts binding-site residues for a target protein chain using its structure and an optional partner chain. The principal inference flow is CLI or web request → residue-graph construction → GATv2 encoding and cross-attention → per-residue probabilities, which can be exported. Separate product capabilities include batch inference, explainability, docking integration, and model training/evaluation. The README documents the model stages; source excerpts and the index support the cited code links. Docking and some web internals are not shown in enough detail to map their connections.
Main entry points: ecabsd_v3_model.py ECABSD Model · cli.py CLI · predict.py Single Prediction · app.py Web API
Components 17
Prediction Pipeline
- Batch Prediction
batch_predict.py - Single Prediction
predict.py - Residue Graphs
models/graph_construction.py - Residue Probabilities
predict.py
Model Development
- ECABSD Model
models/ecabsd_v3_model.py - GATv2 Encoder
models/ecabsd_v3_model.py - Cross-Attention
models/cross_attention.py - Paired Graph Dataset
data/dataset.py - Training
train.py - Evaluation
evaluate.py
Analysis and Outputs
- Explainability
explainability/gradcam.py - Attention Rollout
explainability/attention_rollout.py - Result Export
exports/csv_export.py - Docking Integration
docking/vina_runner.py
Other components
- Researcher
Connections 22
- Researcher → CLI: runs commands
cli.py - Researcher → Web API: submits structures
web/app.py - CLI → Single Prediction: runs prediction
cli.py - CLI → Batch Prediction: runs batch
cli.py - Batch Prediction → Single Prediction: calls prediction
batch_predict.py - Single Prediction → Residue Graphs: builds graphs
predict.py - Single Prediction → ECABSD Model: runs inference
predict.py - Residue Graphs → ECABSD Model: provides graph inputs
README.md - ECABSD Model → GATv2 Encoder: encodes residues
README.md - GATv2 Encoder → Cross-Attention: passes representations
README.md - Cross-Attention → ECABSD Model: informs classification
README.md - ECABSD Model → Residue Probabilities: predicts probabilities
README.md - Single Prediction → Residue Probabilities: produces results
predict.py - Web API → Residue Graphs: builds graphs
web/app.py - Web API → ECABSD Model: serves predictions
web/app.py - CLI → Training: runs training
cli.py - CLI → Evaluation: runs evaluation
cli.py - Training → Paired Graph Dataset: loads samples
train.py - Training → ECABSD Model: trains model
train.py - Evaluation → Paired Graph Dataset: loads samples
evaluate.py - Evaluation → ECABSD Model: evaluates model
- CLI → Result Export: exports results
cli.py