comparison transit_gumbel.xml @ 0:92496521fd39 draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/transit/ commit 73c6b2baf9dda26c6809a4f36582f7cbdb161ea1
author iuc
date Mon, 22 Apr 2019 14:41:48 -0400
parents
children c980be2c002c
comparison
equal deleted inserted replaced
-1:000000000000 0:92496521fd39
1 <?xml version="1.0"?>
2 <tool id="transit_gumbel" name="Gumbel" version="@VERSION@+galaxy1">
3 <description>- determine essential genes</description>
4 <macros>
5 <import>macros.xml</import>
6 </macros>
7 <expand macro="requirements" />
8 <command detect_errors="exit_code"><![CDATA[
9 @LINK_INPUTS@
10 transit gumbel $input_files annotation.dat transit_out.txt
11 @STANDARD_OPTIONS@
12 -s $samples -b $burnin -m $smallest -t $trim
13 ]]>
14 </command>
15 <inputs>
16 <expand macro="standard_inputs">
17 <param name="samples" argument="-s" type="integer" value="10000" label="Number of samples" />
18 <param name="burnin" argument="-b" type="integer" value="500" label="Number of Burn-in samples" />
19 <param name="smallest" argument="-m" type="integer" value="1" label="Smallest read-count to consider" />
20 <param name="trim" argument="-t" type="integer" value="1" label="Trimming interval for values" />
21 </expand>
22 </inputs>
23 <outputs>
24 <expand macro="outputs" />
25 </outputs>
26 <tests>
27 <test>
28 <param name="inputs" ftype="wig" value="transit-in1-rep1.wig,transit-in1-rep2.wig" />
29 <param name="controls" ftype="wig" value="transit-co1-rep1.wig,transit-co1-rep2.wig,transit-co1-rep3.wig" />
30 <param name="annotation" ftype="gff3" value="transit-in1.gff3" />
31 <param name="samples" value="1000" />
32 <param name="burnin" value="100" />
33 <param name="replicates" value="Replicates" />
34 <output name="sites" file="gumbel-sites1.txt" ftype="tabular" compare="sim_size" />
35 </test>
36 </tests>
37
38 <help><![CDATA[
39 .. class:: infomark
40
41 **What it does**
42
43 -------------------
44
45 The **Gumbel** method can be used to determine which genes are essential in a single condition. It does a gene-by-gene analysis of the insertions at TA sites with each gene, makes a call based on the longest consecutive sequence of TA sites without insertion in the genes, calculates the probability of this using a Bayesian model.
46
47 Note : Intended only for Himar1 datasets.
48
49 -------------------
50
51 **Inputs**
52
53 -------------------
54
55 Input files for HMM need to be:
56
57 - .wig files: Tabulated files containing one column with the TA site coordinate and one column with the read count at this site.
58 - annotation .prot_table: Annotation file generated by the `Convert Gff3 to prot_table for TRANSIT` tool.
59
60
61 -------------------
62
63 **Parameters**
64
65 -------------------
66
67 Optional Arguments:
68 -s <integer> := Number of samples. Default: -s 10000
69 -b <integer> := Number of Burn-in samples. Default -b 500
70 -m <integer> := Smallest read-count to consider. Default: -m 1
71 -t <integer> := Trims all but every t-th value. Default: -t 1
72 -r <string> := How to handle replicates. Sum or Mean. Default: -r Sum
73 --iN <float> := Ignore TAs occuring at given fraction of the N terminus. Default: -iN 0.0
74 --iC <float> := Ignore TAs occuring at given fraction of the C terminus. Default: -iC 0.0
75
76
77 - Samples: Gumbel uses Metropolis-Hastings (MH) to generate samples of posterior distributions. The default setting is to run the simulation for 10,000 iterations. This is usually enough to assure convergence of the sampler and to provide accurate estimates of posterior probabilities. Less iterations may work, but at the risk of lower accuracy.
78 - Burn-In: Because the MH sampler many not have stabilized in the first few iterations, a “burn-in” period is defined. Samples obtained in this “burn-in” period are discarded, and do not count towards estimates.
79 - Trim: The MH sampler produces Markov samples that are correlated. This parameter dictates how many samples must be attempted for every sampled obtained. Increasing this parameter will decrease the auto-correlation, at the cost of dramatically increasing the run-time. For most situations, this parameter should be left at the default of “1”.
80 - Minimum Read: The minimum read count that is considered a true read. Because the Gumbel method depends on determining gaps of TA sites lacking insertions, it may be susceptible to spurious reads (e.g. errors). The default value of 1 will consider all reads as true reads. A value of 2, for example, will ignore read counts of 1.
81 - Replicates: Determines how to deal with replicates by averaging the read-counts or summing read counts across datasets. This should not have an affect for the Gumbel method, aside from potentially affecting spurious reads.
82
83
84 -------------------
85
86 **Outputs**
87
88 -------------------
89
90 ============================================= ========================================================================================================================
91 **Column Header** **Column Definition**
92 --------------------------------------------- ------------------------------------------------------------------------------------------------------------------------
93 Orf Gene ID
94 Name Gene Name
95 Desc Gene Description
96 k Number of Transposon Insertions Observed within the ORF.
97 n Total Number of TA dinucleotides within the ORF.
98 r Span of nucleotides for the Maximum Run of Non-Insertions.
99 s Span of nucleotides for the Maximum Run of Non-Insertions.
100 zbar Posterior Probability of Essentiality.
101 State Call Essentiality call for the gene. Depends on FDR corrected thresholds. E=Essential U=Uncertain, NE=Non-Essential, S=too short
102 ============================================= ========================================================================================================================
103
104
105
106 Note: Technically, Bayesian models are used to calculate posterior probabilities, not p-values (which is a concept associated with the frequentist framework). However, we have implemented a method for computing the approximate false-discovery rate (FDR) that serves a similar purpose. This determines a threshold for significance on the posterior probabilities that is corrected for multiple tests. The actual thresholds used are reported in the headers of the output file (and are near 1 for essentials and near 0 for non-essentials). There can be many genes that score between the two thresholds (t1 < zbar < t2). This reflects intrinsic uncertainty associated with either low read counts, sparse insertion density, or small genes. If the insertion_density is too low (< ~30%), the method may not work as well, and might indicate an unusually large number of Uncertain or Essential genes.
107
108 -------------------
109
110 **More Information**
111
112 -------------------
113
114 See `TRANSIT documentation`
115
116 - TRANSIT: https://transit.readthedocs.io/en/latest/index.html
117 - `TRANSIT Gumbel`: https://transit.readthedocs.io/en/latest/transit_methods.html#gumbel
118 ]]></help>
119
120 <expand macro="citations" />
121
122 </tool>