annotate falco-call.xml @ 92:c5b9f2a093d4 draft default tip

Uploaded
author stef
date Tue, 28 Jul 2015 06:04:43 -0400
parents 07c810e4061c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
48
788a9085e424 Uploaded
stef
parents:
diff changeset
1 <tool id="falco-call" name="falco-call" version="0.0.1">
788a9085e424 Uploaded
stef
parents:
diff changeset
2
788a9085e424 Uploaded
stef
parents:
diff changeset
3 <requirements>
788a9085e424 Uploaded
stef
parents:
diff changeset
4
788a9085e424 Uploaded
stef
parents:
diff changeset
5 <requirement type="package" version="0.1.19">samtools</requirement>
69
2d757208b0c1 Uploaded
stef
parents: 60
diff changeset
6 <requirement type="package" version="3.0.1">R</requirement>
86
6be0171ad589 Uploaded
stef
parents: 79
diff changeset
7 <requirement type="set_environment">FALCO_PATH</requirement>
48
788a9085e424 Uploaded
stef
parents:
diff changeset
8
788a9085e424 Uploaded
stef
parents:
diff changeset
9 </requirements>
788a9085e424 Uploaded
stef
parents:
diff changeset
10
788a9085e424 Uploaded
stef
parents:
diff changeset
11 <description>FALCO: Amplicon Analysis Pipeline</description>
788a9085e424 Uploaded
stef
parents:
diff changeset
12
788a9085e424 Uploaded
stef
parents:
diff changeset
13 <command interpreter="bash">
86
6be0171ad589 Uploaded
stef
parents: 79
diff changeset
14 falco-call.sh $falco_cfg \$FALCO_PATH;
48
788a9085e424 Uploaded
stef
parents:
diff changeset
15 </command>
788a9085e424 Uploaded
stef
parents:
diff changeset
16
788a9085e424 Uploaded
stef
parents:
diff changeset
17 <stdio>
788a9085e424 Uploaded
stef
parents:
diff changeset
18 <!-- Anything higher than 0 means the bash script didnt finish -->
788a9085e424 Uploaded
stef
parents:
diff changeset
19 <exit_code range="1:" level="fatal" description="Bash script didnt finish correctly, check log" />
788a9085e424 Uploaded
stef
parents:
diff changeset
20 </stdio>
788a9085e424 Uploaded
stef
parents:
diff changeset
21
788a9085e424 Uploaded
stef
parents:
diff changeset
22 <inputs>
788a9085e424 Uploaded
stef
parents:
diff changeset
23 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
24 <!-- General inputs -->
788a9085e424 Uploaded
stef
parents:
diff changeset
25 <!-- ==================== -->
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
26 <param name="jobName" type="text" optional="false" label="Analysis/ouput name" help="Supply a name for the outputs to remind you what they contain. The string entered here will also be the sample-name in the VCF" value="TEST">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
27 <validator type="empty_field" />
07c810e4061c Uploaded
stef
parents: 86
diff changeset
28 <validator type="regex" message="This field may contain only non-whitespace characters">\S+</validator>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
29 </param>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
30
48
788a9085e424 Uploaded
stef
parents:
diff changeset
31 <conditional name="genomeSource">
788a9085e424 Uploaded
stef
parents:
diff changeset
32 <param name="refGenomeSource" type="select" label="You can select a reference genome from your history or use a built-in index">
788a9085e424 Uploaded
stef
parents:
diff changeset
33 <option value="indexed">Use a built-in index</option>
788a9085e424 Uploaded
stef
parents:
diff changeset
34 <option value="history">Use one from history</option>
788a9085e424 Uploaded
stef
parents:
diff changeset
35 </param>
788a9085e424 Uploaded
stef
parents:
diff changeset
36 <when value="indexed">
788a9085e424 Uploaded
stef
parents:
diff changeset
37 <param name="indices" type="select" label="Select a reference genome">
788a9085e424 Uploaded
stef
parents:
diff changeset
38 <options from_data_table="all_fasta">
788a9085e424 Uploaded
stef
parents:
diff changeset
39 <filter type="sort_by" column="2" />
788a9085e424 Uploaded
stef
parents:
diff changeset
40 <validator type="no_options" message="No indexes are available in table" />
788a9085e424 Uploaded
stef
parents:
diff changeset
41 </options>
788a9085e424 Uploaded
stef
parents:
diff changeset
42 </param>
788a9085e424 Uploaded
stef
parents:
diff changeset
43 </when>
788a9085e424 Uploaded
stef
parents:
diff changeset
44 <when value="history">
788a9085e424 Uploaded
stef
parents:
diff changeset
45 <param name="ownFile" type="data" format="fasta" metadata_name="dbkey" label="Select a reference from history" />
788a9085e424 Uploaded
stef
parents:
diff changeset
46 </when>
788a9085e424 Uploaded
stef
parents:
diff changeset
47 </conditional>
788a9085e424 Uploaded
stef
parents:
diff changeset
48
788a9085e424 Uploaded
stef
parents:
diff changeset
49 <param name="bam" type="data" multiple="false" optional="false" format="bam" label="Input BAM" help="Select BAM file" />
788a9085e424 Uploaded
stef
parents:
diff changeset
50
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
51 <param format="tabular" name="filter_file" optional="True" type="data" label="FILTER File" help="When left empty, built-in list of genomic positions is used"/>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
52 <param format="txt" name="manifest_file" optional="True" type="data" label="MANIFEST File" help="When left empty, built-in panel is used (TruSeq Amplicon Cancer Panel)"/>
48
788a9085e424 Uploaded
stef
parents:
diff changeset
53
788a9085e424 Uploaded
stef
parents:
diff changeset
54 <!-- ==================== -->
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
55 <!-- Optional hisotry output: copynumber TXT file -->
48
788a9085e424 Uploaded
stef
parents:
diff changeset
56 <!-- ==================== -->
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
57 <param name="txt2history" type="select" label="Also output falco specific TXT files to history" help="These text files are much larger but are required for the falco-report tool, so usually you only want these in a workflow and auto-delete them at the end">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
58 <option value="false">no</option>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
59 <option value="true">yes</option>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
60 </param>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
61
07c810e4061c Uploaded
stef
parents: 86
diff changeset
62 <!-- ==================== -->
07c810e4061c Uploaded
stef
parents: 86
diff changeset
63 <!-- Option to perform a test run with built in data -->
07c810e4061c Uploaded
stef
parents: 86
diff changeset
64 <!-- ==================== -->
07c810e4061c Uploaded
stef
parents: 86
diff changeset
65 <param name="testRun" type="select" label="Run with test data" help="Use built-in HCT116 data instead of input BAMs. This dataset contains only one amplicon.">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
66 <option value="false">no</option>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
67 <option value="true">yes</option>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
68 </param>
48
788a9085e424 Uploaded
stef
parents:
diff changeset
69
788a9085e424 Uploaded
stef
parents:
diff changeset
70 </inputs>
788a9085e424 Uploaded
stef
parents:
diff changeset
71
788a9085e424 Uploaded
stef
parents:
diff changeset
72 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
73 <!-- This config is sourced by tool -->
788a9085e424 Uploaded
stef
parents:
diff changeset
74 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
75 <configfiles>
788a9085e424 Uploaded
stef
parents:
diff changeset
76 <configfile name="falco_cfg">
788a9085e424 Uploaded
stef
parents:
diff changeset
77 filter_file=$filter_file
788a9085e424 Uploaded
stef
parents:
diff changeset
78 manifest_file=$manifest_file
788a9085e424 Uploaded
stef
parents:
diff changeset
79 bam_file=$bam
788a9085e424 Uploaded
stef
parents:
diff changeset
80 bam_name=$bam.name
788a9085e424 Uploaded
stef
parents:
diff changeset
81 html_out=$html_output
788a9085e424 Uploaded
stef
parents:
diff changeset
82 vcf_out=$vcf_output
59
73eda23fb8fd Uploaded
stef
parents: 58
diff changeset
83 qc_ann_qual_out=$qc_ann_qual_output
73eda23fb8fd Uploaded
stef
parents: 58
diff changeset
84 qc2_ann_txt_out=$qc2_ann_txt_output
73eda23fb8fd Uploaded
stef
parents: 58
diff changeset
85 qc_targets_txt_out=$qc_targets_txt_output
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
86 also_output_txt=$txt2history
07c810e4061c Uploaded
stef
parents: 86
diff changeset
87 test_run=$testRun
59
73eda23fb8fd Uploaded
stef
parents: 58
diff changeset
88
48
788a9085e424 Uploaded
stef
parents:
diff changeset
89 out_path=${html_output.files_path}
58
e7de191375e6 Uploaded
stef
parents: 57
diff changeset
90 job_name=$jobName
48
788a9085e424 Uploaded
stef
parents:
diff changeset
91 ## reference source
788a9085e424 Uploaded
stef
parents:
diff changeset
92 REF_SOURCE="${genomeSource.refGenomeSource}"
788a9085e424 Uploaded
stef
parents:
diff changeset
93 #if $genomeSource.refGenomeSource == "history":
788a9085e424 Uploaded
stef
parents:
diff changeset
94 ##build index on the fly
788a9085e424 Uploaded
stef
parents:
diff changeset
95 REF_FILE="${genomeSource.ownFile}"
788a9085e424 Uploaded
stef
parents:
diff changeset
96 DB_KEY="${dbkey}"
788a9085e424 Uploaded
stef
parents:
diff changeset
97 #else:
788a9085e424 Uploaded
stef
parents:
diff changeset
98 ##use precomputed indexes
52
493bbb54ca1a Uploaded
stef
parents: 51
diff changeset
99 REF_FILE="${genomeSource.indices.fields.path}"
48
788a9085e424 Uploaded
stef
parents:
diff changeset
100 #end if
788a9085e424 Uploaded
stef
parents:
diff changeset
101 </configfile>
788a9085e424 Uploaded
stef
parents:
diff changeset
102 </configfiles>
788a9085e424 Uploaded
stef
parents:
diff changeset
103
788a9085e424 Uploaded
stef
parents:
diff changeset
104 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
105 <!-- Main output is an html based report, additional on request -->
788a9085e424 Uploaded
stef
parents:
diff changeset
106 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
107 <outputs>
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
108 <data format="html" name="html_output" label="FALCO-calling (${jobName})">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
109 <filter>(txt2history == 'true')</filter>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
110 </data>
48
788a9085e424 Uploaded
stef
parents:
diff changeset
111 <data format="vcf" name="vcf_output" label="FALCO-calling (${jobName}): VCF" />
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
112 <data format="tabular" name="qc_ann_qual_output" label="FALCO-calling (${jobName}): qc_ann_qual">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
113 <filter>(txt2history == 'true')</filter>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
114 </data>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
115 <data format="tabular" name="qc2_ann_txt_output" label="FALCO-calling (${jobName}): qc2_ann">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
116 <filter>(txt2history == 'true')</filter>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
117 </data>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
118 <data format="tabular" name="qc_targets_txt_output" label="FALCO-calling (${jobName}): qc_targets">
07c810e4061c Uploaded
stef
parents: 86
diff changeset
119 <filter>(txt2history == 'true')</filter>
07c810e4061c Uploaded
stef
parents: 86
diff changeset
120 </data>
48
788a9085e424 Uploaded
stef
parents:
diff changeset
121 </outputs>
788a9085e424 Uploaded
stef
parents:
diff changeset
122
788a9085e424 Uploaded
stef
parents:
diff changeset
123 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
124 <!-- Tests still to be done -->
788a9085e424 Uploaded
stef
parents:
diff changeset
125 <!-- ==================== -->
788a9085e424 Uploaded
stef
parents:
diff changeset
126
788a9085e424 Uploaded
stef
parents:
diff changeset
127 <!--
788a9085e424 Uploaded
stef
parents:
diff changeset
128 <tests>
788a9085e424 Uploaded
stef
parents:
diff changeset
129 <test>
788a9085e424 Uploaded
stef
parents:
diff changeset
130 <param name="input1" value="input1" />
788a9085e424 Uploaded
stef
parents:
diff changeset
131 <param name="input2" value="input2" />
788a9085e424 Uploaded
stef
parents:
diff changeset
132 </test>
788a9085e424 Uploaded
stef
parents:
diff changeset
133 </tests>
788a9085e424 Uploaded
stef
parents:
diff changeset
134 -->
788a9085e424 Uploaded
stef
parents:
diff changeset
135
788a9085e424 Uploaded
stef
parents:
diff changeset
136 <help>
788a9085e424 Uploaded
stef
parents:
diff changeset
137 .. class:: infomark
788a9085e424 Uploaded
stef
parents:
diff changeset
138
788a9085e424 Uploaded
stef
parents:
diff changeset
139 **Introduction**
788a9085e424 Uploaded
stef
parents:
diff changeset
140
788a9085e424 Uploaded
stef
parents:
diff changeset
141 This tool is a wrapper for the variant caller FALCO_ which is part of the Amplicon Analysis Pipeline (AAP)
788a9085e424 Uploaded
stef
parents:
diff changeset
142
788a9085e424 Uploaded
stef
parents:
diff changeset
143 .. _FALCO: https://github.com/tgac-vumc/falco/
788a9085e424 Uploaded
stef
parents:
diff changeset
144
788a9085e424 Uploaded
stef
parents:
diff changeset
145 Calls and annotates genomic variants for each amplicon in a design.
788a9085e424 Uploaded
stef
parents:
diff changeset
146
788a9085e424 Uploaded
stef
parents:
diff changeset
147 **Notes**
788a9085e424 Uploaded
stef
parents:
diff changeset
148
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
149 Because each amplicon is analysed separately, when two amplicons overlap this can cause the same variant position to be present twice in the output VCF. This is intentional, you can use this to evaluate the quality of the variant call beyond the amplicon reads.
48
788a9085e424 Uploaded
stef
parents:
diff changeset
150
788a9085e424 Uploaded
stef
parents:
diff changeset
151 -----
788a9085e424 Uploaded
stef
parents:
diff changeset
152
788a9085e424 Uploaded
stef
parents:
diff changeset
153 **Citation**
788a9085e424 Uploaded
stef
parents:
diff changeset
154
90
07c810e4061c Uploaded
stef
parents: 86
diff changeset
155 For the underlying tool please cite: Daoud Sie et al. Performance of amplicon-based next generation DNA sequencing for diagnostic gene mutation profiling in oncopathology (Cell Oncol 2014 Oct;37(5):353-61). Pubmed_
48
788a9085e424 Uploaded
stef
parents:
diff changeset
156
788a9085e424 Uploaded
stef
parents:
diff changeset
157 .. _Pubmed: http://www.ncbi.nlm.nih.gov/pubmed/25209392
788a9085e424 Uploaded
stef
parents:
diff changeset
158
788a9085e424 Uploaded
stef
parents:
diff changeset
159 </help>
788a9085e424 Uploaded
stef
parents:
diff changeset
160
788a9085e424 Uploaded
stef
parents:
diff changeset
161 </tool>