Skip to content

Commit dd657c4

Browse files
committed
Updated README
1 parent e8cdf3f commit dd657c4

1 file changed

Lines changed: 15 additions & 7 deletions

File tree

README.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,21 @@ scTagger matches barcodes of short- and long-reads of single-cell RNA-seq experi
44
## Installation
55

66

7+
### Running with Snakemake
8+
We provided a simple `Snakefile` alongside a `config.yaml` file that runs the three stages of scTagger as well as Cell Ranger (assumes Cell Ranger is in path).
9+
10+
711
### Running manually
8-
scTagger has a single python file in the py directory containing different functions to match long-reads and short-reads barcodes.
12+
scTagger has a single python script containing different functions to match long-reads and short-reads barcodes.
913

10-
The hole pipeline contains three steps that you can run each part separately:
14+
The whole pipeline contains three steps that you can run each part separately:
1115

1216
#### Extract long-reads segment
13-
The first step of the scTagger pipeline is to extract a segment where the probability of seeing a barcode is more than in other places. To run this step, you can use the following command.
17+
The first step of the scTagger pipeline is to extract a segment where the probability of seeing a barcode is more than in other places.
18+
To run this step, you can use the following command.
1419

1520
```
16-
py/scTagger.py extract_lr_bc -r "path/to/long/read/fastq" -o "path/to/output/file" -p "path/to/output/plots"
21+
./scTagger.py extract_lr_bc -r "path/to/long/read/fastq" -o "path/to/output/file" -p "path/to/output/plots"
1722
```
1823

1924
**Augments**
@@ -43,7 +48,7 @@ py/scTagger.py extract_lr_bc -r "path/to/long/read/fastq" -o "path/to/output/fil
4348
The second step is to extract the top short-reads barcodes that cover most of the reads.
4449

4550
```
46-
py/scTagger.py extract_top_sr_bc -i "path/to/bam/file" -o "path/to/output/file" -p "path/to/output/plot"
51+
./scTagger.py extract_top_sr_bc -i "path/to/bam/file" -o "path/to/output/file" -p "path/to/output/plot"
4752
```
4853

4954
**Arguments**
@@ -66,7 +71,7 @@ py/scTagger.py extract_top_sr_bc -i "path/to/bam/file" -o "path/to/output/file"
6671
#### Match long-reads segment with short-reads barcode
6772
The last step is to match long read segments with selected barcodes from short reads
6873
```
69-
py/scTagger.py match_trie -lr "path/to/output/extract/long-read/segment" -sr "path/to/output/extract/top/short-read" -o "path/to/output/file" -t "number of threads"
74+
./scTagger.py match_trie -lr "path/to/output/extract/long-read/segment" -sr "path/to/output/extract/top/short-read" -o "path/to/output/file" -t "number of threads"
7075
```
7176

7277
**Arguments**
@@ -91,8 +96,11 @@ py/scTagger.py match_trie -lr "path/to/output/extract/long-read/segment" -sr "pa
9196
* Fourth column is the long-read segment, and the Fifth column is a list of all short-read barcodes with minimum edit distance
9297
* A bar plot that shows the number of long reads by the minimum edit distance of their match barcode
9398

99+
## Citing scTaggger
100+
scTagger was first accepted to RECOMB-seq 2022 and is now published by iScience:
101+
102+
*Ghazal Ebrahimi, Baraa Orabi, Meghan Robinson, Cedric Chauve, Ryan Flannigan, and Faraz Hach. "Fast and accurate matching of cellular barcodes across short-and long-reads of single-cell RNA-seq experiments." iScience (2022). DOI:[10.1016/j.isci.2022.104530](https://doi.org/10.1016/j.isci.2022.104530)*
94103

95104

96-
Note: This is an active development branch.
97105
Please check the [paper](https://github.com/vpc-ccg/scTagger/tree/paper) branch of this repository for the archived paper experiements and implementation.
98106

0 commit comments

Comments
 (0)