annotate cd_hit_est.xml @ 0:54d811ad2b52 draft

planemo upload for repository https://github.com/ASaiM/galaxytools/tree/master/tools/cdhit/ commit ea0424ae045ac797c080aeabab9a8536f7eb2f84-dirty

<tool id="cd_hit_est" name="CD-HIT-EST" version="1.3">
  <description>Cluster a nucleotide dataset into representative sequences</description>

  <macros>
    <import>cdhit_macros.xml</import>
  </macros>

  <expand macro="requirements"/>

  <command><![CDATA[
    cd-hit-est
      -i "$fasta_in" 
      -o rep_seq 
      -c $similarity 
      -n $wordsize $strand
   
      #include source=$common_cdhit_options#
  ]]></command>
  
  <inputs>
    <param name="fasta_in" type="data" format="fasta" label="EST Sequences to cluster" help="(-i)"/>

    <param name="similarity" type="float" value="0.9"  label="Similarity threshold" min=".75" max="1.0" help="(-c)"/>

    <param name="wordsize" type="integer" value="8" label="Word size" min="4" max="10" help="It is suggested to adjust word size in function of similarity threshold. 8,9 or 10  for threshold in [0.9;1.0] interval, 7 for [0.88;0.9], 6 for [0.85;0.88], 5 for [0.80;0.85], 4 for [0.75;0.8] (-n)"/>

    <param name="strand" type="boolean" truevalue="-r 1" falsevalue="" checked="false" label="Compare both strands?"/>

    <expand macro="common_cdhit_options" />
  </inputs>

  <outputs>
    <data format="txt" name="clusters_out" label="${tool.name} on ${on_string}: Clusters" from_work_dir="rep_seq.clstr"/>

    <data format="fasta" name="fasta_out" label="${tool.name} on ${on_string}: Representative sequences" from_work_dir="rep_seq"/>
  </outputs>
  
  <tests>
      <test>
        <param name="fasta_in" value="cd_hit_est_in.fa" />
        <param name="similarity" value="0.9"/>
        <param name="wordsize" value="8"/>
        <param name="strand" value="false"/>
        <param name="settings" value="no"/>
        <param name="tuning" value="default"/>
        <output name="clusters_out" file="est_clusters_output.txt"/>
        <output name="fasta_out" file="est_fasta_output.fasta"/>
      </test>
  </tests>

  <help><![CDATA[

**What it does**

CD-HIT_ stands for Cluster Database at High Identity with Tolerance. The program (cd-hit) takes a fasta format sequence database as input and produces a set of 'non-redundant' (nr) representative sequences as output. In addition cd-hit outputs a cluster file, documenting the sequence 'groupies' for each nr sequence representative. The idea is to reduce the overall size of the database without removing any sequence information by only removing 'redundant' (or highly similar) sequences. This is why the resulting database is called non-redundant (nr). Essentially, cd-hit produces a set of closely related protein families from a given fasta sequence database.

.. _CD-HIT: http://www.bioinformatics.org/cd-hit/

------

**Inputs**

cd-hit-est requires a fasta file as input. 

------

**Outputs**

The first output is a fasta file containing representative sequences.

The second output is a text file listing the mapping of sequences to the representative sequences::

	>Cluster 0
	0 2799aa, >PF04998.6|RPOC2_CHLRE/275-3073... *
	>Cluster 1
	0 2214aa, >PF06317.1|Q6Y625_9VIRU/1-2214... at 80%
	1 2215aa, >PF06317.1|O09705_9VIRU/1-2215... at 84%
	2 2217aa, >PF06317.1|Q6Y630_9VIRU/1-2217... *
	3 2216aa, >PF06317.1|Q6GWS6_9VIRU/1-2216... at 84%
	4 527aa, >PF06317.1|Q67E14_9VIRU/6-532... at 63%
	>Cluster 2
	0 2202aa, >PF06317.1|Q6UY61_9VIRU/8-2209... at 60%
	1 2208aa, >PF06317.1|Q6IVU4_JUNIN/1-2208... *
	2 2207aa, >PF06317.1|Q6IVU0_MACHU/1-2207... at 73%
	3 2208aa, >PF06317.1|RRPO_TACV/1-2208... at 69%
  ]]></help>

  <citations>
    <citation type="doi">10.1093/bioinformatics/btl158</citation>
    <citation type="doi">10.1093/bioinformatics/bts565</citation>
  </citations>
</tool>