Skip to content

Commit 84deb26

Browse files
committed
add quickstart TOC and improved install instructions
* fix URL for codecov badge
1 parent 68f9468 commit 84deb26

File tree

2 files changed

+36
-15
lines changed

2 files changed

+36
-15
lines changed

README.Rmd

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ knitr::opts_chunk$set(
1818
<!-- badges: start -->
1919
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
2020
[![R-CMD-check](https://github.com/ClavelLab/maldipickr/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ClavelLab/maldipickr/actions/workflows/R-CMD-check.yaml)
21-
[![codecov](https://app.codecov.io/github/ClavelLab/maldipickr/branch/main/graph/badge.svg?token=JQABKDK2MB)](https://app.codecov.io/github/ClavelLab/maldipickr)
21+
[![codecov](https://codecov.io/github/ClavelLab/maldipickr/branch/main/graph/badge.svg?token=JQABKDK2MB)](https://app.codecov.io/github/ClavelLab/maldipickr)
2222
<!-- badges: end -->
2323

2424
* Are you using the MALDI-TOF[^maldi] Biotyper to identify bacterial isolates? **Yes**
@@ -32,7 +32,10 @@ data and cherry-pick representative spectra of microbial isolates.
3232

3333
## Quickstart
3434

35-
How to **cherry-pick bacterial isolates** with MALDI BioTyper.
35+
How to **cherry-pick bacterial isolates** with MALDI BioTyper:
36+
37+
* [using spectra data](#using-spectra-data)
38+
* [using taxonomic identification report](#using-taxonomic-identification-report)
3639

3740
### Using spectra data
3841

@@ -77,19 +80,27 @@ report_tbl %>%
7780
# and cherry-pick one representative spectra.
7881
# The chosen ones are indicated by `to_pick` column
7982
report_tbl %>%
80-
identification_to_clusters() %>%
83+
delineate_with_identification() %>%
8184
pick_spectra(report_tbl, criteria_column = "bruker_log") %>%
8285
dplyr::relocate(name, to_pick, bruker_species)
8386
```
8487

8588

8689
## Installation
8790

88-
You can install the development version of [`{maldipickr}`](https://github.com/ClavelLab/maldipickr) from [GitHub](https://github.com/) with:
91+
`{maldipickr}` was submitted to the CRAN for easy installation and awaits approval.
92+
93+
In the meantime, to install the latest release, use the following:
94+
95+
```{r install_latest_release, eval = FALSE}
96+
remotes::install_github("ClavelLab/[email protected]", build_vignettes = TRUE)
97+
```
98+
99+
100+
For the development version, use the following:
89101

90-
```{r install, eval=FALSE}
91-
# install.packages("devtools")
92-
devtools::install_github("ClavelLab/maldipickr", build_vignettes = TRUE)
102+
```{r install_github, eval = FALSE}
103+
remotes::install_github("ClavelLab/maldipickr", build_vignettes = TRUE)
93104
```
94105

95106
## Usage

README.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
state and is being actively
1010
developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
1111
[![R-CMD-check](https://github.com/ClavelLab/maldipickr/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ClavelLab/maldipickr/actions/workflows/R-CMD-check.yaml)
12-
[![codecov](https://app.codecov.io/github/ClavelLab/maldipickr/branch/main/graph/badge.svg?token=JQABKDK2MB)](https://app.codecov.io/github/ClavelLab/maldipickr)
12+
[![codecov](https://codecov.io/github/ClavelLab/maldipickr/branch/main/graph/badge.svg?token=JQABKDK2MB)](https://app.codecov.io/github/ClavelLab/maldipickr)
1313
<!-- badges: end -->
1414

1515
- Are you using the MALDI-TOF[^1] Biotyper to identify bacterial
@@ -26,7 +26,11 @@ spectra of microbial isolates.
2626

2727
## Quickstart
2828

29-
How to **cherry-pick bacterial isolates** with MALDI BioTyper.
29+
How to **cherry-pick bacterial isolates** with MALDI BioTyper:
30+
31+
- [using spectra data](#using-spectra-data)
32+
- [using taxonomic identification
33+
report](#using-taxonomic-identification-report)
3034

3135
### Using spectra data
3236

@@ -86,7 +90,7 @@ report_tbl %>%
8690
# and cherry-pick one representative spectra.
8791
# The chosen ones are indicated by `to_pick` column
8892
report_tbl %>%
89-
identification_to_clusters() %>%
93+
delineate_with_identification() %>%
9094
pick_spectra(report_tbl, criteria_column = "bruker_log") %>%
9195
dplyr::relocate(name, to_pick, bruker_species)
9296
#> Generating clusters from single report
@@ -103,13 +107,19 @@ report_tbl %>%
103107

104108
## Installation
105109

106-
You can install the development version of
107-
[`{maldipickr}`](https://github.com/ClavelLab/maldipickr) from
108-
[GitHub](https://github.com/) with:
110+
`{maldipickr}` was submitted to the CRAN for easy installation and
111+
awaits approval.
112+
113+
In the meantime, to install the latest release, use the following:
114+
115+
``` r
116+
remotes::install_github("ClavelLab/[email protected]", build_vignettes = TRUE)
117+
```
118+
119+
For the development version, use the following:
109120

110121
``` r
111-
# install.packages("devtools")
112-
devtools::install_github("ClavelLab/maldipickr", build_vignettes = TRUE)
122+
remotes::install_github("ClavelLab/maldipickr", build_vignettes = TRUE)
113123
```
114124

115125
## Usage

0 commit comments

Comments
 (0)