-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
116 lines (81 loc) · 3.99 KB
/
README.Rmd
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# mhcnuggetsr
<!-- badges: start -->
[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-green.svg)](https://www.tidyverse.org/lifecycle/#stable)
[![CRAN status](https://www.r-pkg.org/badges/version/mhcnuggetsr)](https://CRAN.R-project.org/package=mhcnuggetsr)
[![](http://cranlogs.r-pkg.org/badges/grand-total/mhcnuggetsr)]( https://CRAN.R-project.org/package=mhcnuggetsr)
[![](http://cranlogs.r-pkg.org/badges/mhcnuggetsr)](https://CRAN.R-project.org/package=mhcnuggetsr)
Branch |[![GitHub Actions](man/figures/GitHubActions.png)](https://github.com/richelbilderbeek/mhcnuggetsr/actions) | [![Codecov logo](man/figures/Codecov.png)](https://www.codecov.io)
---------|--------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------
`master `|![R-CMD-check](https://github.com/richelbilderbeek/mhcnuggetsr/workflows/R-CMD-check/badge.svg?branch=master) | [![codecov.io](https://codecov.io/github/richelbilderbeek/mhcnuggetsr/coverage.svg?branch=master)](https://codecov.io/github/richelbilderbeek/mhcnuggetsr/branch/master)
`develop`|![R-CMD-check](https://github.com/richelbilderbeek/mhcnuggetsr/workflows/R-CMD-check/badge.svg?branch=develop)| [![codecov.io](https://codecov.io/github/richelbilderbeek/mhcnuggetsr/coverage.svg?branch=develop)](https://codecov.io/github/richelbilderbeek/mhcnuggetsr/branch/develop)
<!-- badges: end -->
> mhcnuggetsr is broken, see [here](https://github.com/richelbilderbeek/mhcnuggetsr/issues/13),
> as the import of the `MHCnuggets` Python package by `reticulate``
> fails. If you know how to fix this, please contact me
R package to work with [MHCnuggets](https://github.com/KarchinLab/mhcnuggets).
The goal of `mhcnuggetsr` is to predict the half maximal inhibitory concentration
of peptides for an MHC haplotype.
It does by calling [MHCnuggets](https://github.com/KarchinLab/mhcnuggets).
## Installation
You can install the released version of mhcnuggetsr from [GitHub](https://github.com/) with:
```
remotes::install_github("richelbilderbeek/mhcnuggetsr")
```
Install MHCnuggets using the non-CRAN extension
[mhcnuggetsrinstall](https://github.com/richelbilderbeek/mhcnuggetsrinstall):
```
# {r install}
library(mhcnuggetsr)
if (!is_mhcnuggets_installed()) {
remotes::install_github("richelbilderbeek/mhcnuggetsrinstall")
mhcnuggetsrinstall::install_mhcnuggets()
mhcnuggetsr_self_test()
}
```
## Example
Here is how to get the IC50 values (in nM) for the peptides in
an example file:
```
# {r example}
library(testthat)
library(mhcnuggetsr)
if (is_mhcnuggets_installed()) {
mhcnuggets_options <- create_mhcnuggets_options(
mhc = "HLA-A02:01"
)
df <- predict_ic50(
peptides = "AIAACAMLLV",
mhcnuggets_options = mhcnuggets_options
)
expect_equal(df$ic50, 5578.77)
}
```
## How can I suppress the output when making a prediction?
One cannot until MHCnuggets allows to do so.
Issue is posted [here](https://github.com/KarchinLab/mhcnuggets/issues/17).
## There is a feature I miss
See [CONTRIBUTING](CONTRIBUTING.md), at `Submitting use cases`
## I want to collaborate
See [CONTRIBUTING](CONTRIBUTING.md), at 'Submitting code'
## I think I have found a bug
See [CONTRIBUTING](CONTRIBUTING.md), at 'Submitting bugs'
## There's something else I want to say
Sure, just add an Issue. Or send an email.
## External links
* [MHCnuggets GitHub repo](https://github.com/KarchinLab/mhcnuggets)
## References
Article about MHCnuggets:
* Shao, Xiaoshan M., et al. "High-throughput prediction of MHC class I and II
neoantigens with MHCnuggets." Cancer Immunology Research 8.3 (2020): 396-408.