annotate telescope_assign.xml @ 0:71fcee7f54df draft

"planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
author iuc
date Tue, 03 Sep 2019 18:11:46 -0400
parents
children 54144e379f6d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
1 <?xml version="1.0"?>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
2 <tool id="telescope_assign" name="Reassign reads" version="@VERSION@">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
3 <description>with TELESCOPE using a statistical model</description>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
4 <macros>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
5 <token name="@VERSION@">1.0.3</token>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
6 </macros>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
7 <requirements>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
8 <requirement type="package" version="@VERSION@">telescope</requirement>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
9 <requirement type="package" version="1.9">samtools</requirement>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
10 </requirements>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
11 <command detect_errors="exit_code"><![CDATA[
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
12 mkdir tempdir &&
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
13 mkdir outdir &&
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
14 telescope assign '$input_alignment' '$input_gtf'
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
15 --tempdir tempdir
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
16 --outdir outdir
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
17 --ncpu \${GALAXY_SLOTS:-1}
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
18 $updated_sam
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
19 #if str($advanced.advanced_options) == 'select':
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
20 --reassign_mode $advanced.reassign_mode
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
21 --conf_prob $advanced.conf_prob
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
22 --overlap_mode $advanced.overlap_mode
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
23 --overlap_threshold $advanced.overlap_threshold
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
24 --annotation_class $advanced.annotation_class
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
25 --pi_prior $advanced.pi_prior
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
26 --theta_prior $advanced.theta_prior
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
27 --em_epsilon $advanced.em_epsilon
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
28 --max_iter $advanced.max_iter
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
29 $advanced.use_likelihood
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
30 #end if
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
31 #if $updated_sam
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
32 &&
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
33 if [ -f outdir/telescope-updated.bam ] ; then
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
34 samtools sort outdir/telescope-updated.bam > '$updated_alignment' ;
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
35 else
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
36 echo 'Updated alignment file not found.' ;
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
37 exit 1 ;
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
38 fi
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
39 #end if
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
40 ]]></command>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
41 <inputs>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
42 <param name="input_alignment" type="data" format="sam,bam" label="Input SAM or BAM file" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
43 <param name="input_gtf" type="data" format="gtf" label="Input annotation" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
44 <param argument="--updated_sam" type="boolean" truevalue="--updated_sam" falsevalue="" label="Also output an updated BAM file with reassigned reads" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
45 <conditional name="advanced">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
46 <param name="advanced_options" type="select" label="Advanced options">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
47 <option value="defaults">Use defaults</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
48 <option value="select">Select values</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
49 </param>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
50 <when value="defaults" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
51 <when value="select">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
52 <param argument="--reassign_mode" type="select" label="Reassignment mode"
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
53 help="After EM is complete, each fragment is reassigned according to the expected value of its membership weights. The reassignment method is the method for resolving the &quot;best&quot; reassignment for fragments that have multiple possible reassignments. Available modes are: &quot;exclude&quot; - fragments with multiple best assignments are excluded from the final counts; &quot;choose&quot; - the best assignment is randomly chosen from among the set of best assignments; &quot;average&quot; - the fragment is divided evenly among the best assignments; &quot;conf&quot; - only assignments that exceed a certain threshold (see --conf_prob) are accepted; &quot;unique&quot; - only uniquely aligned reads are included. NOTE: Results using all assignment modes are included in the Telescope report by default. This argument determines what mode will be used for the &quot;final counts&quot; column. (default: exclude)">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
54 <option value="exclude">Exclude</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
55 <option value="choose">Choose</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
56 <option value="average">Average</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
57 <option value="conf">Conf</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
58 <option value="unique">Unique</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
59 </param>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
60 <param argument="--conf_prob" type="float" value="0.9" min="0" max="1" label="Minimum probability for high confidence assignment" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
61 <param argument="--overlap_mode" type="select" label="Overlap mode" help="The method used to determine whether a fragment overlaps feature">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
62 <option value="threshold">Threshold</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
63 <option value="intersection-strict">Strict intersection</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
64 <option value="union">Union</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
65 </param>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
66 <param argument="--overlap_threshold" type="float" value="0.2" min="0" max="1" label="Fraction of fragment that must be contained within a feature to be assigned to that locus" help="Ignored unless overlap mode is 'threshold'" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
67 <param argument="--annotation_class" type="select" label="Annotation class" help="Both htseq and intervaltree appear to yield identical results. Performance differences are TBD.">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
68 <option value="intervaltree">Interval tree</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
69 <option value="htseq">HTSeq</option>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
70 </param>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
71 <param argument="--pi_prior" type="integer" value="0" label="Prior on &#960;" help="Equivalent to adding n unique reads." />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
72 <param argument="--theta_prior" type="integer" value="0" label="Prior on &#952;" help="Equivalent to adding n non-unique reads." />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
73 <param argument="--em_epsilon" type="float" value="0.0000001" label="EM Algorithm &#965; cutoff" help="Default: 1e-7" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
74 <param argument="--max_iter" type="integer" value="100" label="EM Algorithm maximum iterations" help="Default: 100" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
75 <param argument="--use_likelihood" type="boolean" truevalue="--use_likelihood" falsevalue="" label="Use difference in log-likelihood as convergence criteria" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
76 </when>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
77 </conditional>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
78 </inputs>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
79 <outputs>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
80 <data name="output" format="tabular" from_work_dir="outdir/telescope-telescope_report.tsv" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
81 <data name="updated_alignment" format="bam">
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
82 <filter>updated_sam</filter>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
83 </data>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
84 </outputs>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
85 <tests>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
86 <test>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
87 <param name="input_alignment" value="telescope-in1.bam" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
88 <param name="input_gtf" value="telescope-in1.gtf" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
89 <param name="updated_sam" value="true" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
90 <output name="output" file="telescope-out1.tabular" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
91 <output name="updated_alignment" file="telescope-out1.bam" />
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
92 </test>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
93 </tests>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
94 <help><![CDATA[
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
95 Output
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
96 ------
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
97
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
98 Telescope has two main output files: the telescope report and an updated
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
99 SAM file (optional). The report file is most important for downstream
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
100 differential expression analysis since it contains the fragment count
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
101 estimates. The updated SAM file is useful for downstream locus-specific
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
102 analyses.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
103
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
104 Telescope report
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
105 ~~~~~~~~~~~~~~~~
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
106
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
107 The first line in the telescope report is a comment (starting with a
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
108 “#”) that contains information about the run such as the number of
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
109 fragments processed, number of mapped fragments, number of uniquely and
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
110 ambiguously mapped fragments, and number of fragments mapping to the
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
111 annotation. The total number of mapped fragments may be useful for
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
112 normalization.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
113
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
114 The rest of the report is a table with calculated expression values for
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
115 individual transposable element locations. The columns of the table are:
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
116
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
117 - ``transcript`` - Transcript ID, by default from "locus" field. See
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
118 --attribute argument to use a different attribute.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
119 - ``transcript_length`` - Approximate length of transcript. This is
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
120 calculated from the annotation, not the data, and is equal to the
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
121 spanning length of the annotation minus any non-model regions.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
122 - ``final_count`` - Total number of fragments assigned to transcript
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
123 after fitting the Telescope model. This is the column to use for
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
124 downstream analysis that models data as negative binomial, i.e.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
125 DESeq2.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
126 - ``final_conf`` - Final confident fragments. The number of fragments
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
127 assigned to transcript whose posterior probability exceeds a cutoff,
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
128 0.9 by default. Set this using the --conf_prob argument.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
129 - ``final_prop`` - Final proportion of fragments represented by
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
130 transcript. This is the final estimate of the π parameter.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
131 - ``init_aligned`` - Initial number of fragments aligned to transcript.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
132 A given fragment will contribute +1 to each transcript that it is
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
133 aligned to, thus the sum of this will be greater than the number of
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
134 fragments if there are multimapped reads.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
135 - ``unique_count`` - Unique count. Number of fragments aligning
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
136 uniquely to this transcript.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
137 - ``init_best`` - Initial number of fragments aligned to transcript
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
138 that have the "best" alignment score for that fragment. Fragments
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
139 that have the same best alignment score to multiple transcripts will
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
140 contribute +1 to each transcript.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
141 - ``init_best_random`` - Initial number of fragments aligned to
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
142 transcript that have the "best" alignment score for that fragment.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
143 Fragments that have the same best alignment score to multiple
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
144 transcripts will be randomly assigned to one transcript.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
145
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
146 Updated BAM file
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
147 ~~~~~~~~~~~~~~~~
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
148
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
149 The updated BAM file contains those fragments that has at least 1
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
150 initial alignment to a transposable element. The final assignment and
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
151 probabilities are encoded in the SAM tags:
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
152
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
153 - ``ZF:Z`` Assigned Feature - The name of the feature that alignment is
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
154 assigned to.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
155 - ``ZT:Z`` Telescope tag - A value of ``PRI`` indicates that this
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
156 alignment is the best hit for the feature and is used in the
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
157 likelihood calculations. Otherwise the value will be ``SEC``, meaning
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
158 that another alignment to the same feature has a higher score.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
159 - ``ZB:Z`` Best Feature = The name(s) of the highest scoring feature(s)
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
160 for the fragment.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
161 - ``YC:Z`` Specifies color for alignment as R,G,B. UCSC sanctioned tag,
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
162 see documentation `here.`_
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
163 - ``XP:Z`` Alignment probability - estimated posterior probability for
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
164 this alignment.
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
165
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
166 .. _here.: http://genome.ucsc.edu/goldenpath/help/hgBamTrackHelp.html
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
167
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
168 ]]>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
169 </help>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
170 <citations>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
171 <citation type="doi">10.1101/398172</citation>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
172 </citations>
71fcee7f54df "planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/telescope commit 2ad29725263c29d7612d2e150801c212eb9a2463"
iuc
parents:
diff changeset
173 </tool>