MixMHCpred3.0 is a pan-Allele predictor designed for predicting peptide bindings to MHC alleles and can also perform sequence alignment and binding motif plotting.
The product is provided free of charge, and, therefore, on an "as is" basis, without warranty of any kind.
FOR-PROFIT USERS: If you plan to use MixMHCpred (version 3.0) or any data provided with the script in any for-profit application, you are required to obtain a separate license. To do so, please contact Nadette Bulgin (nbulgin@lcr.org) at the Ludwig Institute for Cancer Research Ltd.
If you use MixMHCpred3.0 in a publication, please cite: Tadros et al., Predicting MHC-I ligands across alleles and species: How far can we go?, BioRxiv (2024) (available here).
For scientific questions, please contact David Gfeller (David.Gfeller@unil.ch)
Copyright (2024) David Gfeller
- A pan-Allele predictor (Use of neural networks)
- Expanded training set of MHC alleles of human and other species
- Sequence Alignment
- HTML file to visualize the binding motifs and peptide length distributions (Optional)
- Python 3.x installed (available here: https://www.python.org/downloads/)
- Bash shell (default on macOS and Linux)
- For Windows users:
- Recommnded: to run MixMHCpred including full functionality, we recommend using the Windows Subsystems for Linux (WSL; installation instruction https://learn.microsoft.com/en-us/windows/wsl/install). This allows running MixMHCpred as if on a Linux system - you can then follow the commands indicated for Linux to install and run MixMHCpred.
- If you cannot use WSL, most functionality of MixMHCpred will work except the part to align new MHC allele sequences and make predictions for these new alleles. You nevertheless need to have bash available on the Windows computer as MixMHCpred is called through a bash script. If bash scripts cannot already be run on your computer, you could install git-bash for example to use this terminal instead of the cmd.exe (commands are more similar to Linux/Mac OS when using this terminal). It is available here: https://gitforwindows.org/. Depending on if you are using git-bash, cmd.exe or powershell, the commands to install/run MixMHCpred on Windows may vary a bit; we assume here that git-bash is used here.
-
Download the MixMHCpred3.0 repository to your local machine.
-
Ensure that Python 3.x is correctly installed and accessible from your terminal or command prompt.
-
Verify that the script
MixMHCpredis executable:chmod +x MixMHCpred- For Mac: Depending on your security setup, you may have to manually allow MixMHCpred executable to run (Systems Preferences -> Security & Privacy -> General)
-
Install Required Packages: Run the
install_packagesexecutable to install the necessary Python packages and MAFFT (see license https://mafft.cbrc.jp/alignment/software/license.txt). This step ensures that all dependencies are correctly set up for MixMHCpred3.0 to function.chmod +x install_packages ./install_packagesor manually install the required python packages (available in
code/setup_pythonLibrary.txt) and MAFFT alignment tool (available in https://mafft.cbrc.jp/alignment/software/) -
Python Virtual Environment (Recommended): It's often recommended to create and use a Python virtual environment for running MixMHCpred3.0. This helps in managing dependencies and avoiding conflicts with other Python projects. You can create a virtual environment by running:
python3 -m venv mixmhcpred_envActivate the virtual environment
- on Mac/Linux (or Windows with WSL):
source mixmhcpred_env/bin/activate- on Windows (if using git-bash):
source mixmhcpred_env/Scripts/activateInstall Required Packages
chmod +x install_packages ./install_packages -
(Optional) To run MixMHCpred from anywhere on your computer, add it in your path or simply run:
chmod +x setup_path ./setup_pathin MixMHCpred3.0 directory
The script is invoked from the command line with various parameters that control its operation. Here is the basic syntax:
./MixMHCpred --help
-i, --input: Absolute or relative path to the input file (FASTA format or list of peptides).-o, --output: Name of the output file or directory.-a, --alleles: List of MHC alleles separated by commas (e.g.,A0301,A2402,B1501,B3906,C0303,C0702).-s, --Sequence: Name of the FASTA file of sequences to align.-p, --peptides_scoring: Enable (1) or disable (0) binding predictions. Default is 1 for peptides scoring, 0 for sequence alignment.-m, --output_motifs: Enable (1) or disable (0) plotting of logos and creation of an HTML file for motifs. Default is 0.
- The script requires either
-a/--allelesor-s/--Sequenceto be specified. - If
-s/--Sequenceis used,-a/--allelesshould not be included, and vice versa. - Ensure there are no spaces in the path to the MixMHCpred directory, as they are not supported.
- if you added MixMHCpred to your path, you can run the tool
MixMHCpredinstead of./MixMHCpred. - Only for Windows: the option
-s/--Sequencefor predicting a new MHC-I sequence will not work.
Predicting peptide binding to specific MHC alleles:
./MixMHCpred -i input/test.txt -o output/test_out.txt -a A0101,A2501,B0801,B1801
Compare your results with output/out_compare.txt.
Predicting peptide binding to specific MHC alleles and plotting motifs:
./MixMHCpred -i input/test.txt -o output/test_out -a A0101,A2501,B0801,B1801 -m 1
Aligning sequences from a FASTA file:
./MixMHCpred -s input/To_align_sequences.fasta -o output/sequences_predictions
Aligning sequences from a FASTA file, plotting motifs:
./MixMHCpred -s input/To_align_sequences.fasta -o output/sequences_predictions -m 1
Aligning sequences from a FASTA file, plotting motifs and predicting peptide binding:
./MixMHCpred -s input/To_align_sequences.fasta -o output/sequences_predictions -m 1 -i input/test.txt -p 1
- Ensure all file paths are correctly specified and exist.
- Make sure there are no spaces in the paths.
For issues, questions, or contributions, please refer to the project's GitHub repository or contact the maintainer at [david.gfeller@unil.ch].
