You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/usage.md
+22-20Lines changed: 22 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -919,6 +919,8 @@ For malt, this only applies when `--malt_min_support_mode` is set to 'reads'. De
919
919
920
920
Specify the path to the _directory_ containing your taxonomic classifer's database (malt or kraken).
921
921
922
+
For Kraken2, it can be either the path to the _directory_ or the path to the `.tar.gz` compressed directory of the Kraken2 database.
923
+
922
924
#### `--percent_identity`
923
925
924
926
Specify the minimum percent identity (or similarity) a squence must have to the reference for it to be retained. Default is 85
@@ -928,13 +930,13 @@ Specify the minimum percent identity (or similarity) a squence must have to the
928
930
Use this to run the program in 'BlastN', 'BlastP', 'BlastX' modes to align DNA and DNA, protein and protein, or DNA reads against protein references respectively.
929
931
respectively. Ensure your database matches the mode. Check the [MALT manual](http://ab.inf.uni-tuebingen.de/data/software/malt/download/manual.pdf) for more details. Default: 'BlastN'
930
932
931
-
Only when `--metagenomic_tool malt`
933
+
Only when `--metagenomic_tool malt` is also supplied is also supplied
932
934
933
935
#### `--malt_alignment_mode`
934
936
935
937
Specify what alignment algorithm to use. Options are 'Local' or 'SemiGlobal'. Local is a BLAST like alignment, but is much slower. Semi-global alignment aligns reads end-to-end. Default: 'SemiGlobal'
936
938
937
-
Only when `--metagenomic_tool malt`
939
+
Only when `--metagenomic_tool malt` is also supplied
938
940
939
941
940
942
#### `--malt_top_percent`
@@ -943,113 +945,113 @@ Specify the top percent value of the LCA algorthim. From the [MALT manual](http:
943
945
read, only those matches are used for taxonomic placement whose bit disjointScore is within
944
946
10% of the best disjointScore for that read.". Default: 1.
945
947
946
-
Only when `--metagenomic_tool malt`
948
+
Only when `--metagenomic_tool malt` is also supplied
947
949
948
950
949
951
#### `--malt_min_support_mode`
950
952
951
953
Specify whether to use a percentage, or raw number of reads as the value used to decide the minimum support a taxon requires to be retained.
952
954
953
-
Only when `--metagenomic_tool malt`
955
+
Only when `--metagenomic_tool malt` is also supplied
954
956
955
957
956
958
#### `--malt_min_support_percent`
957
959
958
960
Specify the minimum number of reads (as a percentage of all assigned reads) a given taxon is required to have to be retained as a positive 'hit' in the RMA6 file. This only applies when `--malt_min_support_mode` is set to 'percent'. Default 0.01.
959
961
960
-
Only when `--metagenomic_tool malt`
962
+
Only when `--metagenomic_tool malt` is also supplied
961
963
962
964
#### `--malt_max_queries`
963
965
964
966
Specify the maximum number of alignments a read can have. All further alignments are discarded. Default: 100
965
967
966
-
Only when `--metagenomic_tool malt`
968
+
Only when `--metagenomic_tool malt` is also supplied
967
969
968
970
#### `--malt_memory_mode`
969
971
970
972
How to load the database into memory. Options are 'load', 'page' or 'map'. 'load' directly loads the entire database into memory prior seed look up, this is slow but compatible with all servers/file systems. 'page' and 'map' perform a sort of 'chunked' database loading, allow seed look up prior entire database loading. Note that Page and Map modes do not work properly not with many remote filesystems such as GPFS. Default is 'load'.
971
973
972
-
Only when `--metagenomic_tool malt`
974
+
Only when `--metagenomic_tool malt` is also supplied
973
975
974
976
#### `--run_maltextract`
975
977
976
978
Turn on MaltExtract for MALT aDNA characteristics authentication of metagenomic output from MALT.
977
979
978
980
More can be seen in the [MaltExtract documentation](https://github.com/rhuebler/)
979
981
980
-
Only when `--metagenomic_tool malt`
982
+
Only when `--metagenomic_tool malt` is also supplied
981
983
982
984
#### `maltextract_taxon_list`
983
985
984
986
Path to a `.txt` file with taxa of interest you wish to assess for aDNA characteristics. In `.txt` file should be one taxon per row, and the taxon should be in a valid [NCBI taxonomy](https://www.ncbi.nlm.nih.gov/taxonomy) name format.
985
987
986
-
Only when `--metagenomic_tool malt`
988
+
Only when `--metagenomic_tool malt` is also supplied
987
989
988
990
#### `maltextract_ncbifiles`
989
991
990
992
Path to directory containing containing the NCBI resource tree and taxonomy table files (ncbi.tre and ncbi.map; avaliable at the [HOPS repository](https://github.com/rhuebler/HOPS/Resources)).
991
993
992
-
Only when `--metagenomic_tool malt`
994
+
Only when `--metagenomic_tool malt` is also supplied
993
995
994
996
#### `maltextract_filter`
995
997
996
998
Specify which MaltExtract filter to use. This is used to specify what types of characteristics to scan for. The default will output statistics on all alignments, and then a second set with just reads with one C to T mismatch in the first 5 bases. Further details on other parameters can be seen in the [HOPS documentation](https://github.com/rhuebler/HOPS/#maltextract-parameters). Options: 'def_anc', 'ancient', 'default', 'crawl', 'scan', 'srna', 'assignment'. Default: 'def_anc'.
997
999
998
-
Only when `--metagenomic_tool malt`
1000
+
Only when `--metagenomic_tool malt` is also supplied
999
1001
1000
1002
#### `maltextract_toppercent`
1001
1003
1002
1004
Specify percent of top alignments for each read to be considered for each node. Default: 0.01.
1003
1005
1004
-
Only when `--metagenomic_tool malt`
1006
+
Only when `--metagenomic_tool malt` is also supplied
1005
1007
1006
1008
#### `maltextract_destackingoff`
1007
1009
1008
1010
Turn off destacking. If left on, a read that overlap with another read will be removed (leaving a depth coverage of 1).
1009
1011
1010
-
Only when `--metagenomic_tool malt`
1012
+
Only when `--metagenomic_tool malt` is also supplied
1011
1013
1012
1014
#### `maltextract_downsamplingoff`
1013
1015
1014
1016
Turn off downsampling. By default, downsampling is on and will randomly select 10,000 reads if the number of reads on a node exceeds this number. This is to speed up processing, under the assumption at 10,000 reads the species is a 'true positive'.
1015
1017
1016
-
Only when `--metagenomic_tool malt`
1018
+
Only when `--metagenomic_tool malt` is also supplied
1017
1019
1018
1020
#### `maltextract_duplicateremovaloff`
1019
1021
1020
1022
Turn off duplicate removal. By default, reads that are an exact copy (i.e. same start, stop coordinate and exact sequence match) will be removed as it is considered a PCR duplicate.
1021
1023
1022
-
Only when `--metagenomic_tool malt`
1024
+
Only when `--metagenomic_tool malt` is also supplied
1023
1025
1024
1026
#### `maltextract_matches`
1025
1027
1026
1028
Export alignments of hits for each node in BLAST format. By default turned off.
1027
1029
1028
-
Only when `--metagenomic_tool malt`
1030
+
Only when `--metagenomic_tool malt` is also supplied
1029
1031
1030
1032
#### `maltextract_megansummary`
1031
1033
1032
1034
Export 'minimal' summary files (i.e. without alignments) that can be loaded into [MEGAN6](https://doi.org/10.1371/journal.pcbi.1004957). By default turned off.
1033
1035
1034
-
Only when `--metagenomic_tool malt`
1036
+
Only when `--metagenomic_tool malt` is also supplied
1035
1037
1036
1038
#### `maltextract_percentidentity`
1037
1039
1038
1040
Minimum percent identity alignments are required to have to be reported. Higher values allows fewer mismatches between read and reference sequence, but therefore will provide greater confidence in the hit. Lower values allow more mismatches, which can account for damage and divergence of a related strain/species to the reference. Recommended to set same as MALT parameter or higher. Default: 85.0.
1039
1041
1040
-
Only when `--metagenomic_tool malt`
1042
+
Only when `--metagenomic_tool malt` is also supplied
1041
1043
1042
1044
#### `maltextract_topalignment`
1043
1045
1044
1046
Use the best alignment of each read for every statistic, except for those concerning read distribution and coverage. Default: off.
1045
1047
1046
-
Only when `--metagenomic_tool malt`
1048
+
Only when `--metagenomic_tool malt` is also supplied
1047
1049
1048
1050
#### `maltextract_singlestranded`
1049
1051
1050
1052
Switch damage patterns to single-stranded mode. Default: off.
1051
1053
1052
-
Only when `--metagenomic_tool malt`
1054
+
Only when `--metagenomic_tool malt` is also supplied
0 commit comments