Mercurial > repos > iuc > kleborate
comparison kleborate.xml @ 0:383036561810 draft
planemo upload for repository https://github.com/katholt/Kleborate commit 7a486326f6d0ca87c1c41e857732319d31372799
author | iuc |
---|---|
date | Fri, 09 Sep 2022 13:15:07 +0000 |
parents | |
children | 374b2e9ade86 |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:383036561810 |
---|---|
1 <tool id="kleborate" name="Kleborate" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="21.05"> | |
2 <description>screen genome assemblies of Klebsiella pneumoniae</description> | |
3 <macros> | |
4 <token name="@TOOL_VERSION@">2.2.0</token> | |
5 <token name="@VERSION_SUFFIX@">0</token> | |
6 </macros> | |
7 <requirements> | |
8 <requirement type="package" version="@TOOL_VERSION@">kleborate</requirement> | |
9 <requirement type="package" version="2.0.0">kaptive</requirement> | |
10 </requirements> | |
11 <version_command>kleborate --version</version_command> | |
12 <command detect_errors="aggressive"><![CDATA[ | |
13 | |
14 ## Symlink input files for human-readable names in output table | |
15 #for $a in $assemblies | |
16 ln -s '$a' '$a.element_identifier' && | |
17 #end for | |
18 | |
19 kleborate | |
20 $resistance | |
21 -o '$outfile' | |
22 #if $kaptive_k | |
23 $kaptive_k | |
24 --kaptive_k_outfile '$kaptive_k_outfile' | |
25 #end if | |
26 #if $kaptive_o | |
27 $kaptive_o | |
28 --kaptive_o_outfile '$kaptive_o_outfile' | |
29 #end if | |
30 #if $min_identity | |
31 --min_identity $min_identity | |
32 #end if | |
33 #if $min_coverage | |
34 --min_coverage $min_coverage | |
35 #end if | |
36 #if $min_spurious_identity | |
37 --min_spurious_identity $min_spurious_identity | |
38 #end if | |
39 #if $min_spurious_coverage | |
40 --min_spurious_coverage $min_spurious_coverage | |
41 #end if | |
42 --assemblies | |
43 #for $a in $assemblies | |
44 '$a.element_identifier' | |
45 #end for | |
46 1> '$concise' | |
47 ]]></command> | |
48 | |
49 <inputs> | |
50 <param argument="--assemblies" type="data" format="fasta" multiple="true" label="FASTA file(s) of assemblies" help="you may provide multiple assemblies for screening"/> | |
51 | |
52 <param argument="--resistance" type="select" label="Turn on resistance genes screening?"> | |
53 <option value="">no</option> | |
54 <option value="--resistance" selected="true">yes</option> | |
55 </param> | |
56 | |
57 <param argument="--kaptive_k" type="boolean" truevalue="--kaptive_k" falsevalue="" checked="false" label="Turn on screening of K loci?" help="Screen for capsule synthesis loci (K-loci) using the 'Kaptive' tool"/> | |
58 <param argument="--kaptive_o" type="boolean" truevalue="--kaptive_o" falsevalue="" checked="false" label="Turn on screening of O loci?" help="Screen for lipopolysaccharide loci (O-loci) using the 'Kaptive' tool" /> | |
59 | |
60 <param argument="--min_identity" type="integer" min="0" max="100" value="90" label="Minimum alignment percent identity for main results" help="Must be a value between 0 and 100" /> | |
61 <param argument="--min_coverage" type="integer" min="0" max="100" value="80" label="Minimum alignment percent coverage for main results" help="Must be a value between 0 and 100" /> | |
62 <param argument="--min_spurious_identity" type="integer" min="0" max="100" value="80" label="Minimum alignment percent identity for spurious results" help="Must be a value between 0 and 100" /> | |
63 <param argument="--min_spurious_coverage" type="integer" min="0" max="100" value="40" label="Minimum alignment percent coverage for spurious results" help="Must be a value between 0 and 100"/> | |
64 </inputs> | |
65 | |
66 <outputs> | |
67 <data name="concise" format="tabular" label="${tool.name} on ${on_string}: Concise Results" /> | |
68 <data name="outfile" format="tabular" label="${tool.name} on ${on_string}: Full Results" /> | |
69 <data name="kaptive_k_outfile" format="tabular" label="${tool.name} on ${on_string}: K-loci screening results" > | |
70 <filter>kaptive_k</filter> | |
71 </data> | |
72 <data name="kaptive_o_outfile" format="tabular" label="${tool.name} on ${on_string}: O-loci screening results" > | |
73 <filter>kaptive_o</filter> | |
74 </data> | |
75 </outputs> | |
76 | |
77 <tests> | |
78 <test expect_num_outputs="4"><!-- test with resistance, kaptive k and kaptive o outputs --> | |
79 <param name="assemblies" value="KP011_S63.scfd.fasta,KP012_S64.scfd.fasta" /> | |
80 <param name="resistance" value="--resistance"/> | |
81 <param name="kaptive_k" value="--kaptive_k"/> | |
82 <param name="kaptive_o" value="--kaptive_o"/> | |
83 <output name="concise" ftype="tabular" file="Kleborate_concise_results.txt" /> | |
84 <output name="outfile" ftype="tabular" file="Kleborate_results.txt" /> | |
85 <output name="kaptive_k_outfile" ftype="tabular" file="Kleborate_kaptive_k_results.txt" /> | |
86 <output name="kaptive_o_outfile" ftype="tabular" file="Kleborate_kaptive_o_results.txt" /> | |
87 </test> | |
88 <test expect_num_outputs="2"><!-- test without extra options --> | |
89 <param name="assemblies" value="KP011_S63.scfd.fasta,KP012_S64.scfd.fasta" /> | |
90 <param name="resistance" value=""/> | |
91 <param name="kaptive_k" value=""/> | |
92 <param name="kaptive_o" value=""/> | |
93 <output name="concise" ftype="tabular" file="Kleborate_concise_results_vanilla.txt" /> | |
94 <output name="outfile" ftype="tabular" file="Kleborate_results_vanilla.txt" /> | |
95 </test> | |
96 | |
97 </tests> | |
98 | |
99 <help><![CDATA[ | |
100 **What it does** | |
101 | |
102 Kleborate is a tool to screen genome assemblies of Klebsiella pneumoniae and the Klebsiella pneumoniae species complex (KpSC) for: | |
103 | |
104 - MLST sequence type | |
105 - species (e.g. K. pneumoniae, K. quasipneumoniae, K. variicola, etc.) | |
106 - ICEKp associated virulence loci: yersiniabactin (ybt), colibactin (clb), salmochelin (iro), hypermucoidy (rmpA) | |
107 - virulence plasmid associated loci: salmochelin (iro), aerobactin (iuc), hypermucoidy (rmpA, rmpA2) | |
108 - antimicrobial resistance determinants: acquired genes, SNPs, gene truncations and intrinsic β-lactamases | |
109 - K (capsule) and O antigen (LPS) serotype prediction, via wzi alleles and Kaptive | |
110 | |
111 For Klebsiella species outside of the KpSC, Kleborate will accurately determine the species and will report the presence of any accessory genes detected (AMR, virulence, K & O types); however species-focused markers (mutational resistance, MLST) and divergent forms of the virulence, K and O loci will not be reported. | |
112 | |
113 More information can be found on the Kleborate `wiki`_. | |
114 | |
115 .. _wiki: https://github.com/katholt/Kleborate/wiki | |
116 | |
117 | |
118 **Outputs** | |
119 | |
120 Kleborate outputs the following concise results table (in this example with with resistance and K-loci screening enabled): | |
121 | |
122 =============== ===================== ===== =============== ============== ===== ========== ==== ========== ==== =========== ===== =========================== ========= ============ ====== ========== | |
123 strain species ST virulence_score Yersiniabactin YbST Colibactin CbST Aerobactin AbST Salmochelin SmST RmpADC RmST rmpA2 wzi K_locus | |
124 --------------- --------------------- ----- --------------- -------------- ----- ---------- ---- ---------- ---- ----------- ----- --------------------------- --------- ------------ ------ ---------- | |
125 GCF_002248955.1 Klebsiella pneumoniae ST15 0 - 0 - 0 - 0 - 0 - 0 - wzi29 KL106 | |
126 GCF_003095495.1 Klebsiella pneumoniae ST258 0 - 0 - 0 - 0 - 0 - 0 - wzi154 KL107 | |
127 GCF_000009885.1 Klebsiella pneumoniae ST23 4 ybt 2;ICEKp1 326 - 0 iuc 1 1 iro 1,iro 3 19,18 rmp 3; ICEKp1,rmp 1; KpVP-1 30-1LV,26 rmpA2_3-47% wzi1 KL1 | |
128 GCF_900501255.1 Klebsiella pneumoniae ST86 3 - 0 - 0 iuc 1 1 iro 1 1 rmp 1; KpVP-1 26 rmpA2_9*-50% wzi2 KL2 (KL30) | |
129 =============== ===================== ===== =============== ============== ===== ========== ==== ========== ==== =========== ===== =========================== ========= ============ ====== ========== | |
130 | |
131 | |
132 Additional details can be found in the full results table, and the Kaptive screening of K-loci and O-loci each generate additional output tables. | |
133 | |
134 **Scores** | |
135 | |
136 Kleborate outputs a simple categorical virulence score, and if resistance screening is enabled, an antimicrobial resistance score as well. These scores provide a rough categorisation of the strains to facilitate monitoring resistance-virulence convergence. | |
137 Virulence score | |
138 | |
139 The virulence score ranges from 0 to 5: | |
140 | |
141 - 0 = negative for all of yersiniabactin (ybt), colibactin (clb), aerobactin (iuc) | |
142 - 1 = yersiniabactin only | |
143 - 2 = yersiniabactin and colibactin (or colibactin only) | |
144 - 3 = aerobactin (without yersiniabactin or colibactin) | |
145 - 4 = aerobactin with yersiniabactin (without colibactin) | |
146 - 5 = yersiniabactin, colibactin and aerobactin | |
147 | |
148 Note neither the salmochelin (iro) locus nor rmpADC are explicitly considered in the virulence score, for simplicity. The iro and rmpADC loci typically appear alongside the aerobactin (iuc) locus on the Kp virulence plasmids, and so presence of iuc (score of 3-5) generally implies presence of iro and rmpADC. However we prioritise iuc in the calculation of the score, as aerobactin is specifically associated with growth in blood and is a stronger predictor of the hypervirulence phenotype (see this review). The iro and rmpADC loci are also occasionally present with ybt, in the ICEKp variant - ICEKp1, but this will still score 1. | |
149 Resistance score | |
150 | |
151 The resistance score ranges from 0 to 3: | |
152 | |
153 - 0 = no ESBL, no carbapenemase (regardless of colistin resistance) | |
154 - 1 = ESBL, no carbapenemase (regardless of colistin resistance) | |
155 - 2 = Carbapenemase without colistin resistance (regardless of ESBL genes or OmpK mutations) | |
156 - 3 = Carbapenemase with colistin resistance (regardless of ESBL genes or OmpK mutations) | |
157 | |
158 | |
159 **Confidence** | |
160 | |
161 Kaptive K and O loci screening will indicate the best matching locus and types, and its confidence in the match: | |
162 | |
163 - Perfect = the locus was found in a single piece with 100% coverage and 100% identity to the reference. | |
164 - Very high = the locus was found in a single piece with ≥99% coverage and ≥95% identity, with no missing genes and no extra genes. | |
165 - High = the locus was found in a single piece with ≥99% coverage, with ≤ 3 missing genes and no extra genes. | |
166 - Good = the locus was found in a single piece or with ≥95% coverage, with ≤ 3 missing genes and ≤ 1 extra genes. | |
167 - Low = the locus was found in a single piece or with ≥90% coverage, with ≤ 3 missing genes and ≤ 2 extra genes. | |
168 - None = did not qualify for any of the above. | |
169 | |
170 | |
171 **Spurious hits** | |
172 | |
173 The default criteria for detection of virulence and resistance genes targeted for genotyping in Kleborate are minimum nucleotide identity ≥90% and minimum nucleotide sequence coverage ≥80% (these parameters can be changed in the tool settings). | |
174 | |
175 To alert users to the possibility that target genes may be missed because of contig breaks or other assembly quality issues, Kleborate will also report the presence of 'spurious' BLAST hits that pass more relaxed criteria (default ≥80% identity, ≥40% coverage), in the dedicated columns spurious_virulence_hits and spurious_resistance_hits. | |
176 ]]></help> | |
177 | |
178 <citations> | |
179 <citation type="doi">10.1038/s41467-021-24448-3</citation> <!-- Kleborate publication --> | |
180 <citation type="doi">10.1099/mgen.0.000102</citation><!-- Kaptive publication --> | |
181 </citations> | |
182 </tool> |