Skip to content

Commit 77a6c55

Browse files
committed
Chore: adding new contig length filter option to docs
1 parent 0426a7e commit 77a6c55

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed

docs/usage/run.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Setting up the metavirs pipeline is fast and easy! In its most basic form, <code
99

1010
## 2. Synopsis
1111
```text
12-
$ metavirs run [--help] [--aggregate] \
12+
$ metavirs run [--help] [--aggregate] [--length-filter LENGTH_FILTER] \
1313
[--mode <slurm,local>] [--job-name JOB_NAME] \
1414
[--dry-run] [--silent] [--sif-cache SIF_CACHE] \
1515
[--singularity-cache SINGULARITY_CACHE] \
@@ -58,6 +58,16 @@ Each of the following arguments are optional, and do not need to be provided.
5858
>
5959
> ***Example:*** `--aggregate`
6060
61+
---
62+
`--length-filter LENGTH_FILTER`
63+
> **Filter contigs by total length (bp).**
64+
> *type: integer*
65+
> *default: 500*
66+
>
67+
> The contig length filter is used to remove any annotated contigs less than this threshold. Annotating small contigs can lead to lower-confidence classifications. This filter is only applied to metaspades contigs.
68+
>
69+
> ***Example:*** `--length-filter 750`
70+
6171
### 2.3 Orchestration options
6272

6373
Each of the following arguments are optional, and do not need to be provided.
@@ -136,7 +146,7 @@ Each of the following arguments are optional, and do not need to be provided.
136146
---
137147
`--threads THREADS`
138148
> **Max number of threads for each process.**
139-
> *type: int*
149+
> *type: integer*
140150
> *default: 2*
141151
>
142152
> Max number of threads for each process. This option is more applicable when running the pipeline with `--mode local`. It is recommended setting this vaule to the maximum number of CPUs available on the host machine.
@@ -184,6 +194,7 @@ module load snakemake
184194
--output /data/$USER/metavirs_out \
185195
--mode slurm \
186196
--aggregate \
197+
--length-filter 500 \
187198
--dry-run
188199

189200
# Step 1B.) Run the viral metagenomics
@@ -195,7 +206,8 @@ module load snakemake
195206
./metavirs run --input .tests/*.gz \
196207
--output /data/$USER/metavirs_out \
197208
--mode slurm \
198-
--aggregate
209+
--aggregate \
210+
--length-filter 500
199211
```
200212

201213
### 3.2 BigSky
@@ -207,9 +219,9 @@ srun -N 1 -n 1 --time=1:00:00 --mem=8gb --cpus-per-task=2 --pty bash
207219

208220
# Add any missing dependencies to $PATH,
209221
# adds singularity, snakemake, and metavirs
222+
module purge
210223
source /gs1/RTS/OpenOmics/bin/dependencies.sh
211224

212-
213225
# Step 1A.) Dry-run the pipeline,
214226
# this will display what steps will
215227
# be run or what steps still remain.
@@ -219,6 +231,7 @@ metavirs run --input .tests/*.gz \
219231
--sif-cache /gs1/RTS/OpenOmics/SIFs/ \
220232
--resource-bundle /gs1/RTS/OpenOmics/references/metavirs/ \
221233
--aggregate \
234+
--length-filter 500 \
222235
--dry-run
223236

224237
# Step 1B.) Run the viral metagenomics
@@ -232,5 +245,6 @@ metavirs run --input .tests/*.gz \
232245
--mode slurm \
233246
--sif-cache /gs1/RTS/OpenOmics/SIFs/ \
234247
--resource-bundle /gs1/RTS/OpenOmics/references/metavirs/ \
235-
--aggregate
248+
--aggregate \
249+
--length-filter 500
236250
```

0 commit comments

Comments
 (0)