-
Notifications
You must be signed in to change notification settings - Fork 8
Expand file tree
/
Copy pathnextflow_schema.json
More file actions
921 lines (920 loc) · 50 KB
/
nextflow_schema.json
File metadata and controls
921 lines (920 loc) · 50 KB
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
{
"$schema": "http://json-schema.org/draft-07/schema",
"$id": "https://raw.githubusercontent.com/jhuapl-bio/taxtriage/main/nextflow_schema.json",
"title": "nf-core/taxtriage pipeline parameters",
"description": "APHL pipeline for triage classification reports.",
"type": "object",
"definitions": {
"input_output_options": {
"title": "Input/output options (Required)",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "Define where the pipeline should find input data samplesheet, database, and save output data. Submitters should remove host reads in the sequencing files/data prior to identification of unknown pathogens and sharing of sequencing files/data sets. Additionally, all specimens should be de-identified, such that no personal identifying information (PII) can be associated with the sample. To prevent unauthorized use of the data, sequencing files/data shared between submitting parties and JHU/APL should only be used for activities related to this project. JHU/APL will not share data or results with any partner other than the originating lab without express-written consent.",
"properties": {
"input": {
"type": "string",
"format": "file-path",
"mimetype": "text/csv",
"pattern": "^\\S+\\.csv$",
"schema": "assets/schema_input.json",
"description": "Path to comma-separated file containing information about the samples in the experiment.",
"help_text": "You will need to create a design file with information about the samples in your experiment before running the pipeline. Use this parameter to specify its location. It has to be a comma-separated file with 6 columns in a header row and at least one row for info. See [usage docs](https://raw.githubusercontent.com/jhuapl-bio/taxtriage/main/examples/Samplesheet_git.csv).",
"fa_icon": "fas fa-file-csv",
"default": "https://raw.githubusercontent.com/jhuapl-bio/taxtriage/main/examples/Samplesheet.csv"
},
"db": {
"type": "string",
"fa_icon": "fas fa-book",
"default": "test",
"format": "directory-path",
"description": "Path to database for Kraken2. If using with --download-db, choose from download options {minikraken2, flukraken2}"
},
"annotate": {
"type": "boolean",
"default": false,
"description": "Enable annotation of VF and AMR and Transporter Genes.",
"help_text": "Requires --annotate_proteins and --annotate_meta. If set to true, it will annotate the VF, AMR, and Transporter Genes that are present in the --annotate_proteins file. This is disabled by default because it adds a lot of time to the pipeline runtime. Not to be confused with get_features, which is a more general annotation of pulling metadata for any proteins in the --annotate_proteins file rather than just VF and AMR and Transporter Genes.",
"fa_icon": "fas fa-file-signature"
},
"metaphlan": {
"type": "string",
"fa_icon": "fas fa-book",
"format": "directory-path",
"description": "Path to database for Metaphlan"
},
"centrifuge": {
"type": "boolean",
"fa_icon": "fas fa-book",
"description": "Enable centrifuge classifier instead of kraken2. Set db with --db as always"
},
"outdir": {
"type": "string",
"format": "directory-path",
"description": "Output directory full of files. Report will be generated at <PATH>/multiqc/multiqc_report.html",
"fa_icon": "fas fa-file-signature"
},
"fastq_1": {
"type": "string",
"format": "file-path",
"pattern": "^\\S+\\.(fastq|fq)(\\.gz)?$",
"errorMessage": "File must be a fastq or compressed (ends in .fastq.gz, .fq.gz, .fastq or .fq). Will overwrite --input parameter if specified.",
"description": "Path to the first fastq file. If using paired-end reads, this is the forward read.",
"fa_icon": "fas fa-file-signature"
},
"fastq_2": {
"type": "string",
"format": "file-path",
"pattern": "^\\S+\\.(fastq|fq)(\\.gz)?$",
"description": "Path to the second fastq file. If using paired-end reads, this is the reverse read.",
"fa_icon": "fas fa-file-signature"
},
"sample": {
"type": "string",
"description": "Sample name. If left blank it retrieves the basename of the fastq_1 file",
"fa_icon": "fas fa-file-signature"
},
"trim": {
"type": "boolean",
"description": "Whether or not to trim your fastq file(s)",
"fa_icon": "fas fa-file-signature"
},
"seq_summary": {
"type": "string",
"description": "OXFORD only sequencing summary file",
"fa_icon": "fas fa-file-signature"
},
"type": {
"type": "string",
"description": "1",
"fa_icon": "fas fa-file-signature",
"enum": ["blood", "skin", "stool", "nasal", "unknown", "sterile"]
},
"platform": {
"type": "string",
"description": "Sequencing platform. If left blank it retrieves the platform from the samplesheet",
"fa_icon": "fas fa-file-signature",
"enum": ["ILLUMINA", "OXFORD", "PACBIO"]
}
},
"required": ["db", "outdir"],
"anyOf": [{ "required": ["input"] }, { "required": ["fastq_1"] }],
"errorMessage": {
"anyOf": "Either the 'input' parameter or the 'fastq_1' parameter must be provided. Also, ensure that db and outdir have a value."
}
},
"prelim_and_qc": {
"title": "Preliminary and QC",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "Run general maintenance scripts to prep the data prior to classifications/analysis, inlcuding some plotting",
"properties": {
"remove_taxids": {
"description": "Taxid numbers in double quotes ( e.g. \"9606\" for human). For multiple, example: \"9606 2\" removes human AND all Bacteria",
"fa_icon": "fas fa-file-signature",
"type": "string",
"default": "9606"
},
"subsample": {
"type": ["number", "null"],
"description": "Pull a random number of reads from the reads to be analyzed. Useful for testing only. ",
"fa_icon": "fas fa-file-signature"
},
"downsample": {
"type": "boolean",
"description": "Downsample your fastq file(s) using khmer",
"fa_icon": "fas fa-file-signature"
}
}
},
"metagenomics_parameters": {
"title": "Metagenomics Parameters",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "Define where the pipeline should find input data and save output data.",
"properties": {
"top_per_taxa": {
"type": "string",
"description": "Custom downselect of taxid:limit:rank. For example, it would be 10239:4:S to at minimum present the top 4 species of viruses. Add more with a space",
"help_text": "Example: 10239:4:S 2:10:S is the top 10 bacteria species, top 4 viral species at minimum are included",
"default": "10239:10:S 2:10:S 4751:5:S"
},
"low_memory": {
"type": "boolean",
"fa_icon": "fas fa-book",
"description": "Dont load db to memory, run from I/O"
},
"download_taxdump": {
"type": "boolean",
"fa_icon": "fas fa-download",
"description": "Download the ncbi taxonomy database and decompress it. "
},
"download_db": {
"type": "boolean",
"fa_icon": "fas fa-download",
"description": "Download the preset database indicated in --db to --outdir."
},
"taxtab": {
"type": "string",
"hint": "Options: [default, krona, or a file path to a taxonomy.tab file]",
"description": "Taxonomy tab file for krona plots",
"fa_icon": "fas fa-file-signature"
},
"add_irregular_top_hits": {
"type": "boolean",
"description": "Add irregular distribution genomes to the top hits",
"fa_icon": "fas fa-file-signature"
},
"microbert": {
"type": "string",
"description": "To enable microbert or not, testing space currently",
"fa_icon": "fas fa-file-signature",
"default": null
},
"microbert_maxlen": {
"type": ["integer", "null"],
"description": "What max length you would like to use for microbert clustering. Default is 2000. We do not recommend going above 5k bp",
"fa_icon": "fas fa-file-signature",
"default": null
},
"classifiers": {
"type": "string",
"description": "List of classifiers, separated by a space. Choose from [kraken2, metaphlan, centrifuge]",
"fa_icon": "fas fa-file-signature",
"default": "kraken2"
},
"taxdump": {
"type": "string",
"format": "file-path",
"hint": "Path to a directory that contains ncbi taxonomy dmp files (must contain names.dmp, nodes.dmp)",
"description": "",
"fa_icon": "fas fa-file-signature"
},
"save_output_fastqs": {
"type": "boolean",
"fa_icon": "fas fa-book",
"description": "Save all read classifications as a txt file"
},
"save_unaligned": {
"type": "boolean",
"fa_icon": "fas fa-book",
"description": "Save all unaligned reads as a txt file for reflex analysis"
},
"remove_commensal": {
"type": "boolean",
"fa_icon": "fas fa-book",
"description": "Save all read classifications as a txt file"
},
"save_k2_read_assignment": {
"type": "boolean",
"description": "Save the kraken2 per-read classification output file. Default is FALSE",
"fa_icon": "fas fa-file-signature"
},
"save_classified_fastq": {
"type": "boolean",
"description": "Save classified fastqs from k2 and use them downstream - all classified are passed, unclassified are discarded",
"fa_icon": "fas fa-file-signature"
},
"top_hits_count": {
"type": ["number", "null"],
"default": 5,
"description": "Top N organisms to report per sample",
"fa_icon": "fas fa-file-signature"
},
"k2_confidence": {
"type": ["number", "null"],
"description": "Kraken2 confidence, default (empty) is 0.0. Must be between 0 and 1",
"fa_icon": "fas fa-file-signature"
},
"k2_minimum_hit_groups": {
"type": ["number", "null"],
"description": "Kraken2 minimum hit groups for LCA to be called",
"fa_icon": "fas fa-file-signature"
},
"filter_kraken2": {
"type": "string",
"format": "directory-path",
"schema": "assets/schema_input.json",
"description": "Path to a kraken2 database. Typically, this would be the human reads database for human-derived samples. Deprecated! Choose --remove_taxids insteads",
"help_text": "",
"fa_icon": "fas fa-file-csv"
}
}
},
"alignment_parameters": {
"title": "Alignment",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "Alignment Parameter adjustments",
"properties": {
"remove_reference_file": {
"type": "string",
"format": "file-path",
"description": "Local FASTA file to remove host reads from your files. Used prior to kraken2.",
"fa_icon": "fas fa-file-signature",
"default": null
},
"include_singletons_hostremoval": {
"type": "boolean",
"description": "-f 12 instead of -f 4 for removing hostreads. Removes reads where BOTH reads are unmapped instead of just one side",
"fa_icon": "fas fa-file-signature",
"default": false
},
"include_singletons_removal": {
"type": "boolean",
"description": "Keep singleton (unpaired) reads in paired-end datasets after host removal. By default (false), singletons are discarded. Has no effect on single-end reads. Automatically overridden to false when --use_denovo or --use_diamond is specified.",
"fa_icon": "fas fa-file-signature",
"default": false
},
"no_split_prefix": {
"type": "boolean",
"description": "DON'T split the alignment fasta files for minimap2 to reduce RAM overhead",
"fa_icon": "fas fa-file-signature",
"default": false
},
"use_megahit_longreads": {
"type": "boolean",
"description": "Use MEGAHIT for Long Reads (Oxford or Pacbio) instead of the default",
"fa_icon": "fas fa-file-signature"
},
"annotate_proteins": {
"type": ["string", "null"],
"description": "A FASTA file of proteins to pull annotations for with DIAMOND BLASTX. This is used in conjunction with --use_diamond. It can be a custom file or one of the following presets: nr, refseq, or pathogens",
"fa_icon": "fas fa-file-signature"
},
"annotate_meta": {
"type": ["string", "null"],
"description": "A metadata file that contains the headers of the proteins in the --annotate_proteins file and the relevant metadata you want to pull for those proteins. This is used in conjunction with --use_diamond. It can be a custom file or one of the following presets: nr, refseq, or pathogens",
"fa_icon": "fas fa-file-signature"
},
"pident": {
"type": ["number", "null"],
"description": "Minimum percent identity for DIAMOND BLASTX. Must be between 0 and 100. This is used in conjunction with --annotate_proteins.",
"fa_icon": "fas fa-file-signature",
"default": 75
},
"spades_hmm": {
"type": "string",
"description": "Use custom hmm from SPAdes for your reads",
"fa_icon": "fas fa-file-signature"
},
"use_bt2": {
"type": "boolean",
"description": "Dont use minimap2 for short reads, use bowtie2 instead",
"fa_icon": "fas fa-file-signature"
},
"use_hisat2": {
"type": "boolean",
"description": "Dont use minimap2 for short reads, use hisat2 instead. This process takes much much longer than bt2 or minimap2",
"fa_icon": "fas fa-file-signature"
},
"use_diamond": {
"type": "boolean",
"description": "Use DIAMOND BLASTX on the following BAM from the alignment step(s)",
"fa_icon": "fas fa-file-signature"
},
"use_denovo": {
"type": "boolean",
"description": "Use De Novo Assembly. Default is Flye for Longreads and Megahit for short",
"fa_icon": "fas fa-file-signature"
},
"skip_report": {
"type": "boolean",
"description": "Skip the pathogen report",
"fa_icon": "fas fa-file-signature"
},
"skip_consensus": {
"type": "boolean",
"description": "Skip the consensus report",
"fa_icon": "fas fa-file-signature"
},
"skip_variants": {
"type": "boolean",
"description": "Skip the variant report",
"fa_icon": "fas fa-file-signature"
},
"skip_realignment": {
"type": "boolean",
"description": "Dont do re-alignment post kraken2 classification",
"fa_icon": "fas fa-file-signature"
},
"skip_confidence": {
"type": "boolean",
"description": "Dont do confidence metrics post-alignment",
"fa_icon": "fas fa-file-signature"
},
"assembly": {
"type": "string",
"format": "file-path",
"schema": "assets/schema_input.json",
"description": "Path to an assembly file. This contains the taxid and relative genome file that can be pulled from Entrez (ncbi). If not called, it auto downloads in the pipeline and requires internet connectivity",
"help_text": "",
"fa_icon": "fas fa-file-csv"
},
"get_pathogens": {
"type": "boolean",
"schema": "assets/schema_input.json",
"description": "Pull remote pathogens reference file from GH",
"help_text": "Available at: https://github.com/jhuapl-bio/datasets/raw/main/references/pathogens.fasta.gz",
"fa_icon": "fas fa-file-csv"
},
"conf_sens": {
"type": "boolean",
"description": "Sensitive mode for confidence metrics. Uses all BAM query alignments rather than the reference from the alignment. Considered I/O intensive and much slower. ",
"hint": "Useful if there are a lot of variants present in the alignments, otherwise keep disabled",
"fa_icon": "fas fa-file-signature"
},
"min_conf": {
"type": ["number", "null"],
"description": "Minimum Confidence for reporting.",
"hint": "This is the minimum confidence (0-100 scale) for a given taxa to be reported in the final report. Must be between 0 and 100. All items, regardless of conf, will still be present in the annotation txt file.",
"fa_icon": "fas fa-file-signature"
},
"disable_auto_weights": {
"type": "boolean",
"description": "Disable the automatic setting of TASS Score weights based on sample type and platform. If set to true, it uses the default weights for all sample types rather than adjusting them based on the sample type-specific thresholds determined in our testing.",
"fa_icon": "fas fa-file-signature"
},
"gini_weight": {
"type": ["number", "null"],
"description": "Gini Weight to the TASS Score. This is the measure of how spread out the depths/coverages are in an alignment to an organism. The more spread out or evenly distributed the regions, the higher the score.",
"fa_icon": "fas fa-file-signature"
},
"breadth_weight": {
"type": ["number", "null"],
"description": "Minimum Log-based breadth weight for TASS Score calculation",
"fa_icon": "fas fa-file-signature"
},
"minhash_weight": {
"type": ["number", "null"],
"description": "Weight for minhash filtering. It is the combination of % of reads removed + % of breadth new / 2 ",
"fa_icon": "fas fa-file-signature"
},
"mapq_weight": {
"type": ["number", "null"],
"description": "MapQ Weight to the TASS Score. If filtering on 20+, this will likely all be 1 or close to 1. Disabled by default",
"fa_icon": "fas fa-file-signature"
},
"disparity_score_weight": {
"type": ["number", "null"],
"description": "The weight for giving more of a bonus for more prevalent organisms. Unused by default",
"fa_icon": "fas fa-file-signature"
},
"hmp_weight": {
"type": ["number", "null"],
"description": "TASS Score weight for HMP percentile, recommend disabling if sample is unknown",
"fa_icon": "fas fa-file-signature"
},
"dispersion_factor": {
"type": ["number", "null"],
"description": "TASS Score Dispersion factor. This is the measure of how spread out the depths/coverages are in an alignment to an organism. The more spread out or evenly distributed the regions, the higher the score.",
"fa_icon": "fas fa-file-signature"
},
"alpha": {
"type": ["number", "null"],
"description": "TASS Score Alpha. This is the measure of how much weight to put on the breadth vs depth of coverage for a given alignment to an organism. The higher the alpha, the more weight put on breadth rather than depth.",
"fa_icon": "fas fa-file-signature",
"default": 1
},
"reward_factor": {
"type": ["number", "null"],
"description": "TASS Score Reward factor. This is the measure of how spread out the depths/coverages are in an alignment to an organism. The more spread out or evenly distributed the regions, the higher the score.",
"fa_icon": "fas fa-file-signature"
},
"mapq_gini_power": {
"type": ["number", "null"],
"description": "Power exponent for MAPQ-adjusted Gini. gini *= highmapq_fraction^power. Penalizes Gini score for organisms dominated by low-MAPQ reads. Default: 1.0. Set to 0 to disable.",
"fa_icon": "fas fa-file-signature"
},
"mapq_breadth_power": {
"type": ["number", "null"],
"description": "Power exponent for MAPQ-adjusted breadth. breadth *= highmapq_fraction^power. Higher values penalize low-MAPQ organisms more aggressively. Default: 1.0 (e.g. 10% high-MAPQ reads → breadth scaled by 0.1).",
"fa_icon": "fas fa-file-signature"
},
"auto_score_power": {
"type": "boolean",
"description": "Automatically compute score_power after optimization so that the mean TP TASS score hits the optimize_tp_target. Requires --optimize and --optimize_tp_target. Overrides score_power if both are set.",
"default": false,
"fa_icon": "fas fa-file-signature"
},
"score_power": {
"type": ["number", "null"],
"description": "Power transform (gamma) applied to TASS scores. Values < 1 lift compressed scores (e.g. 0.09^0.5=0.30). Preserves monotonic ordering so thresholds still separate TP/FP. Default: no transform.",
"fa_icon": "fas fa-file-signature"
},
"depth_concentration_power": {
"type": "number",
"description": "Power exponent for depth-concentration penalty on Gini. Penalizes organisms where reads map to a tiny region of a large genome (high depth, negligible coverage). Set to 0 to disable.",
"default": 0,
"fa_icon": "fas fa-file-signature"
},
"jump_threshold": {
"type": ["number", "null"],
"description": "Jump Threshold",
"hint": "Set a manual jump threshold for a region definition. If the change in depth is greater or less than the current for the upcoming region, then define the new region.",
"fa_icon": "fas fa-file-signature"
},
"gap_allowance": {
"type": "number",
"description": "Gap Allowance For Confidence",
"max": 1,
"min": 0,
"default": 0.1,
"hint": "For the merging of regions, this is the allowed 0-depth gap between regions in the bedgraph before a new region is allowed. It is the proportion 0-1 of the full reference length. Default is 0.1 or 10%",
"fa_icon": "fas fa-file-signature"
},
"pathogens": {
"type": "string",
"format": "file-path",
"description": "Path to pathogens csv file. See documentation for format and info.",
"fa_icon": "fas fa-file-csv"
},
"organisms": {
"type": "string",
"hint": "Options: Comma-separated taxids or organism names to match to ncbi assembly info. See --assembly for more info. If using organism names, make sure to set it to fuzzy-matching with --fuzzy ",
"description": "Either a string of taxids separated by a space, or organisms names with '' enclosure, separated by space for each enclosed name with ''",
"fa_icon": "fas fa-file-signature"
},
"organisms_file": {
"type": "string",
"format": "file-path",
"hint": "Options: [string or single column list of taxids or organism names]. If using organism names, make sure to set it to fuzzy-matching with --fuzzy ",
"description": "Either a file or string of taxids separated by a space, or organisms names with '' enclosure",
"fa_icon": "fas fa-file-signature"
},
"fuzzy": {
"type": "boolean",
"description": "Fuzzy matching for organism names",
"fa_icon": "fas fa-file-signature"
},
"min_reads_align": {
"type": "number",
"default": 3,
"description": "Minimum reads threshold for realignment",
"fa_icon": "fas fa-file-signature"
},
"min_mapq_host": {
"type": ["number", "null"],
"default": null,
"description": "Minimum MapQ Score for host alignment. If null, the default value will be used.",
"fa_icon": "fas fa-file-signature"
},
"zscore_accepted": {
"type": "number",
"hint": "This is the value (minimum) accepted when calculating distribution filtering from HHS data for a given sample type match. Value is + and -",
"description": "Minimum zscore for outline assumptions from HHS",
"fa_icon": "fas fa-file-signature"
},
"minmapq": {
"type": "number",
"description": "Minimum MapQ Score for alignment",
"fa_icon": "fas fa-file-signature"
},
"minq": {
"type": "number",
"default": 1,
"description": "Minimum BaseQ Score for filtering",
"fa_icon": "fas fa-file-signature"
},
"mmap2_window": {
"type": "string",
"description": "Window size for minimap2 alignment",
"fa_icon": "fas fa-file-signature"
},
"mmap2_fraction_filter": {
"type": "number",
"description": "filter out top FLOAT fraction of repetitive minimizers",
"fa_icon": "fas fa-file-signature"
},
"bt2_indices": {
"type": "string",
"format": "file-path",
"description": "Path to Bowtie2 indices (directory). If not called, it auto creates it from the relevant FASTA file for each sample. Only usable with --reference_fasta",
"fa_icon": "fas fa-file-signature"
},
"bt2_scoremin": {
"type": "string",
"description": "Bowtie2 score-min parameter",
"fa_icon": "fas fa-file-signature"
},
"refresh_download": {
"type": "boolean",
"description": "Redownload all references from NCBI",
"fa_icon": "fas fa-file-signature"
},
"genome": {
"type": "string",
"description": "Name of iGenomes reference.",
"fa_icon": "fas fa-book",
"help_text": "If using a reference genome configured in the pipeline using iGenomes, use this parameter to give the ID for the reference. This is then used to build the full paths for all required reference genome files e.g. `--genome GRCh38`. \n\nSee the [nf-core website docs](https://nf-co.re/usage/reference_genomes) for more details."
},
"igenomes_base": {
"type": "string",
"format": "directory-path",
"description": "Directory / URL base for iGenomes references.",
"default": "https://ngi-igenomes.s3.eu-west-1.amazonaws.com/igenomes",
"fa_icon": "fas fa-cloud-download-alt"
},
"igenomes_ignore": {
"type": "boolean",
"description": "Do not load the iGenomes reference config.",
"fa_icon": "fas fa-ban",
"hidden": true,
"help_text": "Do not load `igenomes.config` when running the pipeline. You may choose this option if you observe clashes between custom parameters and those supplied in `igenomes.config`."
},
"assembly_file_type": {
"type": "string",
"description": "Assembly text file format. Can be a kraken2 fasta (kraken2) or the one pulled from ncbi (ncbi)",
"fa_icon": "fas fa-folder-open",
"enum": ["kraken2", "ncbi"],
"default": "ncbi"
},
"reference_fasta": {
"type": "string",
"format": "file-path",
"schema": "assets/schema_input.json",
"description": "Reference FASTA file to use instead of using ncbi API to pull genomes. Useful for offlined pipelines",
"help_text": "",
"fa_icon": "fas fa-file-csv"
},
"recursive_reference": {
"type": "boolean",
"description": "Search for the FASTA files in a directory from the --reference_fasta param",
"fa_icon": "fas fa-ban"
},
"decompress_pre_megahit": {
"type": "boolean",
"description": "Decompress your fastq file(s) pre assembly with megahit only",
"help_text": "For a minor bug on cluster environments where megahit can't work on compressed files",
"fa_icon": "fas fa-ban"
},
"thresholds_json": {
"type": ["string", "null"],
"format": "file-path",
"schema": "assets/schema_input.json",
"default": null,
"description": "Path to a json file that contains the sample type and platform specific thresholds for the TASS Score. If not provided, it uses the default thresholds determined in our testing.",
"help_text": "",
"fa_icon": "fas fa-file-csv"
},
"distributions": {
"type": "string",
"format": "file-path",
"schema": "assets/schema_input.json",
"description": "List of all metagenome distributions that contain abundances found in public HMP data for each taxa and body site combination",
"help_text": "",
"default": "https://raw.githubusercontent.com/jhuapl-bio/taxtriage/main/assets/taxid_abundance_stats.hmp.tsv.gz",
"fa_icon": "fas fa-file-csv"
}
}
},
"skips": {
"title": "Skip Steps",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "Not all steps are required to make a report, choose what to skip upfront. Be aware some analysis plots will be missing depending on what you skip.",
"properties": {
"skip_plots": {
"type": "boolean",
"description": "Skip upfront QC plotting to save time",
"fa_icon": "fas fa-file-signature"
},
"skip_stats": {
"type": "boolean",
"description": "Skip generating stats for each individual taxa per sample",
"fa_icon": "fas fa-file-signature"
},
"skip_fastp": {
"type": "boolean",
"description": "Skip QC trimming",
"fa_icon": "fas fa-file-signature"
},
"skip_kraken2": {
"type": "boolean",
"description": "Skip Kraken2. Will not work with \"unknown taxa\" mode. You must provide a reference FASTA if this is toggled on.",
"fa_icon": "fas fa-file-signature"
},
"skip_refpull": {
"type": "boolean",
"description": "Skip downloading references from NCBI",
"hint": "Must provide a local reference fasta file. This is only useful if you want K2 outputs in tandem with a local ref file output",
"fa_icon": "fas fa-file-signature"
},
"skip_krona": {
"type": "boolean",
"description": "Skip Krona Plots",
"fa_icon": "fas fa-file-signature"
},
"skip_features": {
"type": "boolean",
"description": "Skip the feature download step(s). Used during the protein alignment step",
"fa_icon": "fas fa-file-signature"
},
"skip_pathogens": {
"type": "boolean",
"description": "Skip the pathogen detection step(s)",
"fa_icon": "fas fa-file-signature",
"default": false
},
"unknown_sample": {
"type": "boolean",
"description": "Dont consider HMP distributions",
"fa_icon": "fas fa-file-signature"
},
"ignore_missing": {
"type": "boolean",
"description": "Ignore Missing K2 or DIAMOND Scores for final TASS Score confidence",
"fa_icon": "fas fa-ban"
},
"reference_assembly": {
"type": "boolean",
"description": "Perform Reference-Based Assembly. Performs variant analysis by default (mandatory)",
"fa_icon": "fas fa-file-signature"
},
"pathogenicity": {
"type": "boolean",
"description": "Align your assembly (denovo) to pathogen references for pathogenicity analysis. Returns a TSV set for both VFs and AMR hits",
"fa_icon": "fas fa-file-signature"
},
"get_features": {
"type": "boolean",
"description": "Start generating annotations from alignments that take place. Requires LOTS of RAM for large data files/genomes",
"fa_icon": "fas fa-file-signature"
},
"get_variants": {
"type": "boolean",
"description": "Start generating variant call analysis relative to aligned reads to references",
"fa_icon": "fas fa-file-signature"
},
"compress_species": {
"type": "boolean",
"description": "Compress taxonomy at species level within the ODR or MultiQC.",
"fa_icon": "fas fa-file-signature"
},
"fast": {
"type": "boolean",
"description": "Instead of building minhash signatures from the .fna file references, compare only across the reads/queries aligned",
"fa_icon": "fas fa-file-signature"
},
"enable_matrix": {
"type": "boolean",
"description": "Enable the generation of the final report matrix for high ANI similarity. The column will be included in the report if so.",
"fa_icon": "fas fa-file-signature"
},
"no_subkey": {
"type": "boolean",
"description": "Dont use the subkey odr, puts each row as a strain rather than grouping them into a parent taxid. This can be useful for looking at strain level differences, but can be very unwieldy if there are a lot of strains that are above the ANI threshold for potential organisms.",
"fa_icon": "fas fa-file-signature"
},
"sort_alphabetical": {
"type": "boolean",
"description": "Sort the tables on alphabetical order rather than TASS. If disabled, it sorts on TASS score descending",
"fa_icon": "fas fa-file-signature"
},
"show_potentials": {
"type": "boolean",
"description": "Show all known/listed potential organisms in the final discovery report",
"fa_icon": "fas fa-file-signature"
},
"show_opportunistics": {
"type": "boolean",
"description": "Show all known/listed opportunistic organisms in the final discovery report",
"fa_icon": "fas fa-file-signature"
},
"show_commensals": {
"type": "boolean",
"description": "Show all known/listed commensal organisms in the final discovery report",
"fa_icon": "fas fa-file-signature"
},
"show_unidentified": {
"type": "boolean",
"description": "Show all non or non-identification organisms in the final discovery report",
"fa_icon": "fas fa-file-signature"
},
"ani_threshold": {
"type": "number",
"description": "ANI threshold for reporting potential organisms in the final discovery report",
"fa_icon": "fas fa-file-signature",
"default": 0.95
},
"mintass": {
"type": "number",
"description": "Minimum TASS Score for reporting potential organisms in the final multi run analysis report (HTML, all.odr.html)",
"fa_icon": "fas fa-file-signature",
"default": 1.0
},
"integrate_strain_table": {
"type": "boolean",
"description": "Integrate the strain level table into the main table rather than as a separate table. This is the table that has all the strains that are above the ANI threshold for potential organisms. This is disabled by default because it can be very large and unwieldy if there are a lot of potential organisms.",
"fa_icon": "fas fa-file-signature",
"default": false
},
"skip_multiqc": {
"type": "boolean",
"description": "Skip upfront QC plotting to save time",
"fa_icon": "fas fa-file-signature"
},
"rank": {
"type": "string",
"description": "What rank to bin hits in the report in the final report. Default is genus, but you can choose from [species, genus, family, order, class, phylum]",
"fa_icon": "fas fa-file-signature",
"default": "genus"
}
}
},
"general": {
"title": "General Info",
"type": "object",
"fa_icon": "fas fa-terminal",
"description": "",
"properties": {
"email": {
"type": "string",
"description": "Email address for completion summary.",
"fa_icon": "fas fa-envelope",
"help_text": "Set this parameter to your e-mail address to get a summary e-mail with details of the run sent to you when the workflow exits. If set in your user config file (`~/.nextflow/config`) then you don't need to specify this on the command line for every run.",
"pattern": "^([a-zA-Z0-9_\\-\\.]+)@([a-zA-Z0-9_\\-\\.]+)\\.([a-zA-Z]{2,5})$"
},
"email_on_fail": {
"type": "boolean",
"description": "only email if set to true",
"fa_icon": "fas fa-envelope"
},
"plaintext_email": {
"type": "boolean",
"description": "Send email in plaintext",
"fa_icon": "fas fa-envelope"
},
"monochrome_logs": {
"type": "boolean",
"description": "Monochrome logs",
"fa_icon": "fas fa-file-signature"
},
"help": {
"type": "boolean",
"description": "Print help message",
"fa_icon": "fas fa-file-signature"
},
"validate_params": {
"type": "boolean",
"description": "Validate parameters",
"fa_icon": "fas fa-file-signature"
},
"show_hidden_params": {
"type": "boolean",
"description": "Show hidden parameters",
"fa_icon": "fas fa-file-signature"
},
"config_profile_contact": {
"type": "string",
"description": "Configuration profile contact",
"fa_icon": "fas fa-file-signature"
},
"publish_dir_mode": {
"type": "string",
"default": "copy",
"description": "Publish directory mode",
"fa_icon": "fas fa-file-signature"
},
"multiqc_logo": {
"type": "string",
"description": "Path to a logo image file to use in the MultiQC report",
"fa_icon": "fas fa-file-signature"
},
"max_multiqc_email_size": {
"type": "string",
"description": "Maximum MultiQC email size. Default is 25.MB",
"default": "25.MB",
"fa_icon": "fas fa-file-signature"
},
"custom_config_version": {
"type": "string",
"default": "master",
"description": "Custom config version",
"fa_icon": "fas fa-file-signature"
},
"custom_config_base": {
"type": "string",
"default": "https://raw.githubusercontent.com/nf-core/configs/master",
"description": "Custom config base",
"fa_icon": "fas fa-file-signature"
},
"enable_conda": {
"type": "boolean",
"description": "Enable Conda. This is disabled atm. ",
"fa_icon": "fas fa-file-signature"
},
"max_cpus": {
"type": "number",
"description": "Maximum number of CPUs to use for the pipeline",
"fa_icon": "fas fa-microchip",
"default": null
},
"max_memory": {
"type": "string",
"description": "Maximum amount of memory to use for the pipeline",
"fa_icon": "fas fa-memory",
"default": null
},
"force_mem": {
"type": "string",
"description": "Force the aligners and kraken2 to use a specific amount of memory rather than the max/process default",
"fa_icon": "fas fa-memory",
"help_text": "This is a string that is a number followed by GB or MB e.g. 10GB or 100MB. If left empty it opts for the default memory of the process or the max_memory (if specified), whichever is smaller.",
"default": null
},
"max_time": {
"type": "string",
"description": "Maximum amount of time to use for the pipeline",
"fa_icon": "fas fa-clock",
"default": null
},
"default_download": {
"type": "string",
"description": "Default download database",
"fa_icon": "fas fa-file-signature"
},
"multiqc_title": {
"type": "string",
"description": "MultiQC report title. Printed as page header, used for filename if not otherwise specified.",
"fa_icon": "fas fa-file-signature"
},
"blastdb": {
"type": "string",
"description": "Blast Database (local or remote, local must be absolute path)",
"fa_icon": "fas fa-file-signature"
},
"config_profile_name": {
"type": "string",
"description": "Configuration profile name",
"fa_icon": "fas fa-file-signature"
},
"config_profile_description": {
"type": "string",
"description": "Configuration profile description",
"fa_icon": "fas fa-file-signature"
},
"config_profile_url": {
"type": "string",
"description": "Configuration profile URL",
"fa_icon": "fas fa-file-signature"
},
"seq_center": {
"type": "string",
"description": "Sequencing center",
"fa_icon": "fas fa-file-signature"
},
"multiqc_config": {
"type": "string",
"format": "file-path",
"description": "Config file for multiqc",
"fa_icon": "fas fa-file-signature"
}
}
}
},
"allOf": [
{
"$ref": "#/definitions/input_output_options"
}
]
}