# HG changeset patch
# User iuc
# Date 1709734148 0
# Node ID 84cc0dc92b0c13368a44679f09dc0ce25d534e23
# Parent  5c8a23ccb14ac88ef63d3d13e6e195e87c075dd9
planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/data_managers/data_manager_build_bracken_database/ commit c0f150357d52e21443197b2ec1427feb9fc7971e

diff -r 5c8a23ccb14a -r 84cc0dc92b0c data_manager/bracken_build_database.xml
--- a/data_manager/bracken_build_database.xml	Mon May 22 19:24:35 2023 +0000
+++ b/data_manager/bracken_build_database.xml	Wed Mar 06 14:09:08 2024 +0000
@@ -39,16 +39,16 @@
             </options>
         </param>
         <conditional name="check_prebuilt">
-            <param name="prebuilt" type="select" label="Use Pre-built DB">
+            <param name="prebuilt" type="select" label="Use Pre-built DB" help="Use existing pre-built DB. This only works for kraken DBs, that already contain additional bracken DBs. This is the case for DBs downloaded from https://benlangmead.github.io/aws-indexes/k2.">
                 <option value="no">No</option>
                 <option value="yes">Yes</option>
             </param>
             <when value="no">
-                <param name="kmer_len" type="integer" min="8" max="256" value="35" label="K-mer length" />
-                <param name="read_len" type="integer" min="8" max="1000" value="100" label="Read length" />
+                <param name="kmer_len" type="integer" min="8" max="256" value="35" label="K-mer length" help="The K-mer length of the bracken DB should be identical to the K-mer length used to build the kraken2 DB." />
+                <param name="read_len" type="integer" min="8" max="1000" value="100" label="Read length" help="The read length of the bracken DB should be the same as the length of the reads to be analysis (one read in case of paired reads)." />
             </when>
             <when value="yes">
-                <param name="read_len" type="select" label="Read length" >
+                <param name="read_len" type="select" label="Read length" help="The read length of the bracken DB should be the same as the length of the reads to be analysis (one read in case of paired reads). The prebuilt DBs where built using the same K-mer length as the kraken2 DB.">
                     <option value="50">50</option>
                     <option value="75">75</option>
                     <option value="100" selected="true">100</option>
@@ -59,7 +59,7 @@
                 </param>
             </when>
 	</conditional>
-	<param name="database_name" type="text" label="Database Name" />
+	<param name="database_name" type="text" label="Database Name" help="Please add a clear reference to the corresponding kraken2 DB the read length to the name." />
     </inputs>
     <outputs>
         <data name="out_file" format="data_manager_json" />
@@ -76,6 +76,24 @@
         </test>
     </tests>
     <help>
+A bracken DB can only be built as an addition to an existing kracken2 DB (see `Bracken docs`_).
+
+.. _Bracken docs: https://github.com/jenniferlu717/Bracken?tab=readme-ov-file#step-1-generate-the-bracken-database-file-databasexmerskmer_distrib-1
+
+======================================
+Using prebuilt DBs
+====================================== 
+
+The prebuilt option does use existing bracken DBs, that are shipped with kraken2 DBs. This is the case for DBs downloaded from https://benlangmead.github.io/aws-indexes/k2.
+All prebuilt databases contain a Kraken 2 database along with Bracken databases built for 50, 75, 100, 150, 200, 250 and 300 read lengths (refering to the lenght of the sequenced reads to be analysis using that database (one read in case of paired reads)).
+In this case the data manager points to the same DB as the kracken2 DB.
+**The prebuilt option must not be used for custom kraken2 DBs ! For this the bracken DB needs to be build.**
+
+======================================
+Building new DBs
+======================================
+
+Use the same K-mer length as the kraken2 DB and choose read lengths that are close to the read length of analysis you want to perform (one read in case of paired reads).
     </help>
     <citations>
         <citation type="doi">10.7717/peerj-cs.104</citation>