Skip to content

Commit

Permalink
Update kreeq.md
Browse files Browse the repository at this point in the history
  • Loading branch information
cassidy-a-johnson authored Sep 22, 2023
1 parent 727a44e commit b02a5c2
Showing 1 changed file with 34 additions and 10 deletions.
44 changes: 34 additions & 10 deletions docs/kreeq.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,32 @@
Let's get some test files first:
```
mv testFiles-kreeq/* .
```
The standard notation for using kreeq is as follows:
```
kreeq validate -f input.[fasta|fastq][.gz] -r reads1.fastq[.gz] reads2.fastq[.gz] [...] [-k 21]
```

It accepts multiple read files as input, separated by space. To check out all options and flags use:

`kreeq -h`
It accepts multiple read files as input, separated by space. The two modes we will be using today are `validate` and `union`.
To check out all options and flags use:
```
kreeq -h
kreeq validate -h
kreeq union -h
```

You can test some typical usage with the files in the `testFiles` folder, e.g.:
Let's get some test files first:
```
mv gfastar/docs/testFiles-kreeq/* .
```

We will test some typical usage with the files moved from the `testFiles` folder, e.g.:
```
kreeq validate -f random1.fasta -r random1.fastq
kreeq validate -f random2.fasta -r random1.fastq random2.fastq
```

Importantly, the kreeq database can only be computed once on the read set, and reused for multiple analyses to save runtime:

```
kreeq validate -r random1.fastq -o db.kreeq
kreeq validate -f random1.fasta -d db.kreeq
kreeq validate -r random1.fastq -o random1.kreeq
kreeq validate -f random1.fasta -d random1.kreeq
```

Similarly, kreeq databases can be generated separately for multiple inputs and combined, with increased performance in HPC environments:
Expand All @@ -32,3 +38,21 @@ kreeq validate -r random2.fastq -o random2.kreeq
kreeq union -d random1.kreeq random2.kreeq -o union.kreeq
kreeq validate -f random1.fasta -d union.kreeq
```

Now working with real sequencing data:

Let's start by running `gfastats` to get a sense of what we are evaluating.
```
gfastats input.fa
```

Now we are ready to run kreeq:
```
kreeq validate -r filtered.fastq -o filtered.kreeq
kreeq validate -r filtered2.fastq -o filtered2.kreeq
kreeq union -d filtered.kreeq filtered2.kreeq -o filtered_union.kreeq
kreeq validate -f input.fa -d filtered_union.kreeq
```
```

0 comments on commit b02a5c2

Please sign in to comment.