Giter VIP home page Giter VIP logo

hmmhc's Introduction

hmMHC

A hidden Markov model-based MHC II binding predictor. Currently, only H2-IAb predictions are supported. The predictor is described in the paper

Elise Alspach et al. MHC-II neoantigens shape tumour immunity and response to immunotherapy. Nature (2019), available at https://www.nature.com/articles/s41586-019-1671-8

Installation

hmMHC can be installed on Linux and macOS via a combination of conda and pip install. Windows is not supported. Python 3 is not supported.

$ conda create -n hmmhc -c bioconda python=2.7 ghmm=0.9 'icu=58.*'
$ conda activate hmmhc
$ pip install git+https://github.com/artyomovlab/hmmhc#egg=hmmhc

Command line example

Input from command line and output to stout:

$ hmmhc-predict --allele H2-IAb --peptides VNGYNEAIVHVVETP IKSEHPGLSIGDVAK KESVVSGKAVPREEL

Input from csv and output to csv:

$ hmmhc-predict --allele H2-IAb --input example_input.csv --output output.csv

See hmmhc-predict -h for further details.

Python example

from hmmhc import hmMHC
predictor = hmMHC('H2-IAb')

peptides = ['VNGYNEAIVHVVETP', 'IKSEHPGLSIGDVAK', 'KESVVSGKAVPREEL']

predictor.predict(peptides)

Output

The predictor outputs a list of peptides with the predicted -10 log odds scores and corresponding percentile ranks. Percentile ranks are computed from -10 log odds scores based on model calibration on a large set of random natural peptides. For both metrics, smaller values correspond to higher binding likelihood. See Methods section in the paper for further details.

Dependencies

hmMHC relies on General Hidden Markov Model library (GHMM) by A. Schliep et al., see http://ghmm.sourceforge.net/.

Latest version

The latest version of hmMHC is available at https://github.com/artyomovlab/hmmhc.

hmmhc's People

Contributors

ikizhvatov avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

Forkers

ieee820 owenustc

hmmhc's Issues

Converting SNP data into peptides that will work in this model

Hello,

It's not really an issue, but I was wondering if you had any advice for turning SNP data where I know the amino acid change into a peptide or peptides that will work in this model. I assume with the 14-20 AA length requirement that one should try many different peptides for the one gene mutation? So for example AAAXAAAAAAAAA or AAAAAAAXAAA Where you try the mutation out with different amounts of amino acids in front of it and behind it at the different lengths supported? Thanks for any advice!

Model structure?

Hi, a simple yet very elegant model. Thanks for sharing it. I just wonder if you could please elaborate a bit more about the architecture of the model? More specifically, I would like to know what the states are representing here? Is the it a 3-state model? or sFig1a is just a general illustration.
Also, am I right the think that the reason sticking to python2 (and not 3) is that GHMM is currently supported by py2 and not py3?

Peptide length limitation

Currently this code works for peptides in 12 -24 AA range. it appears this in enforced for the percentile calculation. Would removing this limitation still allow for the log odd calcualtions?

Human prediction

Hello,@ikizhvatov
I have some questions while using the hmmhc.How can I use it to predict human data? Maybe there's a way to train human data.

Could you answer me? Thanks!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.