Skip to content

Benchmarking uncertainty quantification methods on proteins.

License

Notifications You must be signed in to change notification settings

microsoft/protein-uq

Repository files navigation

Protein UQ

License: MIT DOI

Benchmark for uncertainty quantification (UQ) in protein engineering.

Citation

If you use this code, please cite the following manuscript:

@article{protein-uq,
  title={Benchmarking Uncertainty Quantification for Protein Engineering},
  author={Greenman, Kevin P. and Amini, Ava P. and Yang, Kevin K.},
  journal={TBD},
  doi={TBD},
  year={2023}
}

Reproducing Results from the Manuscript

Environment Installation

  1. Install Anaconda or Miniconda if you have not yet done so.
  2. conda install -c conda-forge mamba (optional, but recommended, if you do not already have mamba installed)
  3. git clone [email protected]:microsoft/protein-uq.git
  4. cd protein-uq
  5. mamba env create -f environment.yml or conda env create -f environment.yml (mamba is recommended for faster installation)
  6. conda activate protein-uq

Prepare Data in protein-uq repo

  1. cd data
  2. for d in {aav,gb1,meltome}; do (cd $d; unzip splits.zip); done

Creating ESM Embeddings

We used the FLIP repository to generate ESM embeddings for our models. The following commands can be used to reproduce the embeddings used in this work:

  1. cd .. (to leave the protein-uq directory)
  2. git clone --recurse-submodules [email protected]:J-SNACKKB/FLIP.git (--recurse-submodules is required to clone the ESM submodule of the FLIP repo)
  3. cd splits
  4. for d in {aav,gb1,meltome}; do (cd $d; unzip splits.zip); done
  5. cd ../baselines
  6. wget https://dl.fbaipublicfiles.com/fair-esm/models/esm1b_t33_650M_UR50S.pt (this file is 7.3 GB)
  7. wget https://dl.fbaipublicfiles.com/fair-esm/regression/esm1b_t33_650M_UR50S-contact-regression.pt
  8. flip_esm_embedding_commands.sh - This script contains the commands used to generate the ESM embeddings with train-val-test splits for the 8 tasks used in this work. These commands should be run from the baselines/ directory of the FLIP repository, and the protein-uq conda env must be activated. Each command will take a while.

The embeddings will be saved in the FLIP/baselines/embeddings/ directory. Pre-computed embeddings for the AAV landscape can also be downloaded from Zenodo.

Training and Evaluating Models with Uncertainty Quantification

A list of commands to perform all training and inference for our models in series is provided in src/models/train_all_commands_series.sh. The following is an example command:

python train_all.py --split gb1_1 --model ridge --representation ohe --uncertainty ridge --dropout 0.0 --scale --seed 0

In practice, we used the LLMapReduce command on the MIT SuperCloud to make the most efficient use of resources using the cluster's scheduler and run our jobs in parallel. Original LLMapReduce commands are provided in src/models/LLMapReduce_commands.txt.

Active Learning

A list of commands to perform all of our active learning experiments is provided in src/active_learning/active_learning_commands_series.sh. The following is an example command:

python active_learning.py --split gb1_1 --model ridge --representation esm --uncertainty ridge --scale --num_folds 3 --al_strategy random --num_al_loops 5 --al_topk 100 --mean --dropout 0.0

In practice, we used the LLMapReduce command on the MIT SuperCloud to make the most efficient use of resources using the cluster's scheduler and run our jobs in parallel. Original LLMapReduce commands are provided in src/active_learning/LLMapReduce_commands.txt.

Plotting Results

The following notebooks provided in the notebooks/ directory can be used to reproduce the figures and tables in the manuscript:

  • plot_results_1.ipynb: Figures 2, 3, S1, S2, S4; Tables S1-S22
  • plot_results_2.ipynb: Figures 4, S3
  • plot_results_active_learning.ipynb: Figures 5, S5-S57

These notebooks require output files in the src/models/results/ and src/active_learning/al_results/ directories, which can be reproduced using the commands above.

Example Notebook

The Jupyter notebook at notebooks/example.ipynb provides an example of how to train a model and make predictions with uncertainty quantification.

Support

Open bug reports and ask questions on GitHub issues. See SUPPORT for details.

License

This project is licensed under the terms of the MIT license. See LICENSE for additional details.

Contributing

See CONTRIBUTING.

Security

See SECURITY.