|
0
|
1 <tool id="fusion-inspector" name="Fusion Inspector" version="1.0.0" profile="17.05">
|
|
|
2 <description>In silico Validation of Fusion Transcript Predictions</description>
|
|
|
3 <requirements>
|
|
|
4 <requirement type="package" version="1.1.0">fusion-inspector</requirement>
|
|
|
5 </requirements>
|
|
|
6 <command detect_errors="default">
|
|
|
7 <![CDATA[
|
|
|
8 FusionInspector
|
|
|
9 --fusions $fusion_candidates_list
|
|
|
10 --genome_lib "${genome_ref_lib.fields.path}"
|
|
|
11 --left_fq $left_input
|
|
|
12 --right $right_input
|
|
|
13 --out_dir "subdir"
|
|
|
14 --out_prefix "finspector"
|
|
|
15 --prep_for_IGV
|
|
|
16 --align_utils $method
|
|
|
17 #if $trinity_status.trinity=="true"
|
|
|
18 --include_Trinity
|
|
|
19 #end if
|
|
|
20 ]]>
|
|
|
21 </command>
|
|
|
22 <stdio>
|
|
|
23 <exit_code range="1:" level="fatal" description="Error returned from pipeline" />
|
|
|
24 </stdio>
|
|
|
25 <regex match="Must investigate error above."
|
|
|
26 source="stderr"
|
|
|
27 level="fatal"
|
|
|
28 description="Unknown error encountered" />
|
|
|
29 <inputs>
|
|
|
30 <param format="tabular" name="fusion_candidates_list" type="data" multiple="True" label="Choose candidate list:" help="Fusion predictions"/>
|
|
|
31 <param format="fastq" name="left_input" type="data" label="Left/Forward strand reads" help=""/>
|
|
|
32 <param format="fastq" name="right_input" type="data" label="Right/Reverse strand reads" help=""/>
|
|
|
33
|
|
|
34 <param name="method" type="select" label="Choose method:">
|
|
|
35 <option value="HISAT">HISAT</option>
|
|
|
36 <option value="STAR">STAR</option>
|
|
|
37 <option value="GSNAP">GSNAP</option>
|
|
|
38 </param>
|
|
|
39 <conditional name="trinity_status">
|
|
|
40 <param name="trinity" type="select" label="Use Trinity:">
|
|
|
41 <option value="true">True</option>
|
|
|
42 <option value="false">False</option>
|
|
|
43 </param>
|
|
|
44 </conditional>
|
|
|
45 <param name="genome_ref_lib" type="select" label="Select a reference genome">
|
|
|
46 <options from_data_table="ctat_genome_ref_libs">
|
|
|
47 <filter type="sort_by" column="2" />
|
|
|
48 <validator type="no_options" message="No indexes are available" />
|
|
|
49 </options>
|
|
|
50 </param>
|
|
|
51 </inputs>
|
|
|
52 <outputs>
|
|
|
53 <data format="text" name="finspector_idx" label="fidx" from_work_dir="subdir/finspector.fa.fai"/>
|
|
|
54 <data format="text" name="cytoBand" label="cytoBand" from_work_dir="subdir/cytoBand.txt"/>
|
|
|
55 <data format="fasta" name="finspector_fa" label="finspector_fasta" from_work_dir="subdir/finspector.fa"/>
|
|
|
56 <data format="bed" name="finspector_bed" label="finspector_bed" from_work_dir="subdir/finspector.bed"/>
|
|
|
57 <data format="tabular" name="FusionJuncSpan" label="FusionJuncSpan" from_work_dir="subdir/finspector.igv.FusionJuncSpan"/>
|
|
|
58 <data format="bed" name="junction_bed" label="junction_bed" from_work_dir="subdir/finspector.junction_reads.bam.bed"/>
|
|
|
59 <data format="bam" name="junction_bam" label="junction_bam" from_work_dir="subdir/finspector.junction_reads.bam"/>
|
|
|
60 <data format="bam" name="spanning_bam" label="spanning_bam" from_work_dir="subdir/finspector.spanning_reads.bam"/>
|
|
|
61 <data format="bed" name="spanning_bed" label="spanning_bed" from_work_dir="subdir/finspector.spanning_reads.bam.bed"/>
|
|
|
62 <data format="bed" name="trinity_bed" label="trinity_bed" from_work_dir="subdir/finspector.gmap_trinity_GG.fusions.gff3.bed.sorted.bed">
|
|
|
63 <filter>trinity_status['trinity'] == "true"</filter>
|
|
|
64 </data>
|
|
|
65 <data format="text" name="fusionPredictions" label="fusion_predictions.final" from_work_dir="subdir/finspector.fusion_predictions.final"/>
|
|
|
66 <data format="text" name="fusionPredictionsAbridged" label="fusion_predictions_abridged" from_work_dir="subdir/finspector.fusion_predictions.final.abridged"/>
|
|
|
67 <data format="json" name="fusion_json" label="fusion_json" from_work_dir="subdir/finspector.fusion_inspector_web.json"/>
|
|
|
68 </outputs>
|
|
|
69 <tests>
|
|
|
70 <test>
|
|
|
71 <param name="fusion_candidates_list" value="FusionInspector/fusion_targets.A.txt,FusionInspector/fusion_targets.B.txt,FusionInspector/fusion_targets.C.txt" />
|
|
|
72 <param name="left_input" value="FusionInspector/test.reads_1.fastq.gz" />
|
|
|
73 <param name="right_input" value="FusionInspector/test.reads_2.fastq.gz" />
|
|
|
74 <param name="method" value="STAR" />
|
|
|
75 <param name="trinity" value="false" />
|
|
|
76 <output name="finspector_idx" file="FusionInspector/test.reads_1_2.fa.fai" />
|
|
|
77 <output name="cytoBand" file="FusionInspector/test.reads_1_2.cytoBand.tail.txt" compare="contains" />
|
|
|
78 <output name="finspector_fa" file="FusionInspector/test.reads_1_2.fa" />
|
|
|
79 <output name="finspector_bed" file="FusionInspector/test.reads_1_2.bed.sorted" sort="true" />
|
|
|
80 <output name="FusionJuncSpan" >
|
|
|
81 <assert_contents>
|
|
|
82 <has_line_matching expression=".+" />
|
|
|
83 <has_line line="#scaffold	fusion_break_name	break_left	break_right	num_junction_reads	num_spanning_frags	spanning_frag_coords" />
|
|
|
84 </assert_contents>
|
|
|
85 </output>
|
|
|
86 <!-- sorted output sometimes matches, but simetimes not, so now I just test for similar size. -->
|
|
|
87 <output name="junction_bed" file="FusionInspector/test.reads_1_2.junction_reads.bam.bed.sorted" sort="true" compare="sim_size" >
|
|
|
88 <assert_contents>
|
|
|
89 <has_line_matching expression=".+" />
|
|
|
90 <has_n_columns n="12" />
|
|
|
91 </assert_contents>
|
|
|
92 </output>
|
|
|
93 <output name="junction_bam" >
|
|
|
94 <assert_contents>
|
|
|
95 <has_line_matching expression=".+" />
|
|
|
96 <!-- The following checks for the magic number at the start of the bam file -->
|
|
|
97 <has_text_matching expression="\x1F\x8B" />
|
|
|
98 </assert_contents>
|
|
|
99 </output>
|
|
|
100 <output name="spanning_bam" >
|
|
|
101 <assert_contents>
|
|
|
102 <has_line_matching expression=".+" />
|
|
|
103 <!-- The following checks for the magic number at the start of the bam file -->
|
|
|
104 <has_text_matching expression="\x1F\x8B" />
|
|
|
105 </assert_contents>
|
|
|
106 </output>
|
|
|
107 <output name="spanning_bed" file="FusionInspector/test.reads_1_2.spanning_reads.bam.bed.sorted" sort="true" />
|
|
|
108 <!--
|
|
|
109 Since trinity is false in this test, trinity_bed does not exist.
|
|
|
110 <output name="trinity_bed" />
|
|
|
111 <assert_contents>
|
|
|
112 <has_line_matching expression=".+" />
|
|
|
113 </assert_contents>
|
|
|
114 </output>
|
|
|
115 -->
|
|
|
116 <output name="fusionPredictions" >
|
|
|
117 <assert_contents>
|
|
|
118 <has_line_matching expression=".+" />
|
|
|
119 <has_line line="#fusion_name	JunctionReads	SpanningFrags	Splice_type	LeftGene	LeftBreakpoint	RightGene	RightBreakpoint	JunctionReads	SpanningFrags	Annotations	TrinityGG" />
|
|
|
120 </assert_contents>
|
|
|
121 </output>
|
|
|
122 <output name="fusionPredictionsAbridged" >
|
|
|
123 <assert_contents>
|
|
|
124 <has_line_matching expression=".+" />
|
|
|
125 <has_line line="#fusion_name	JunctionReads	SpanningFrags	Splice_type	LeftGene	LeftBreakpoint	RightGene	RightBreakpoint	Annotations	TrinityGG" />
|
|
|
126 </assert_contents>
|
|
|
127 </output>
|
|
|
128 <!-- So far in my testing of the fusion_json, I have had up to 18 different lines
|
|
|
129 (9 positions values switched between two entries)- 64 gives some padding. -->
|
|
|
130 <output name="fusion_json" file="FusionInspector/test.reads_1_2.web.json" lines_diff="64" />
|
|
|
131
|
|
|
132 </test>
|
|
|
133 </tests>
|
|
|
134 <help>
|
|
|
135 .. class:: infomark
|
|
|
136
|
|
|
137 FusionInspector is a component of the Trinity Cancer Transcriptome Analysis Toolkit (CTAT). FusionInspector assists in fusion transcript discovery by performing a supervised analysis of fusion predictions, attempting to recover and re-score evidence for such predictions. Please read more here_.
|
|
|
138
|
|
|
139 .. _here: https://github.com/FusionInspector/FusionInspector/wiki
|
|
|
140
|
|
|
141 **To Visualize Output**
|
|
|
142
|
|
|
143 After completion, results can be visualized in galaxy. Click on the output json file name in the history (on the right). A more detailed view of that file will be shown. Click on the button in the middle that looks like a bar chart. The visualization should now open for you to explore results.
|
|
|
144
|
|
|
145 **There are several output files for the CTAT Fusion Inspector Pipeline. Files of interest include:**
|
|
|
146
|
|
|
147 1. **fidx**: Finspector_fasta index file (required for visualization).
|
|
|
148
|
|
|
149 2. **cytoBand**: Cytogenetic information for hg19.
|
|
|
150
|
|
|
151 3. **finspector_fasta**: The candidate fusion-gene contigs.
|
|
|
152
|
|
|
153 4. **finspector_bed**: The reference gene structure annotations for fusion partners.
|
|
|
154
|
|
|
155 5. **FusionJuncSpan**: Tabular details on junction reads and spanning reads.
|
|
|
156
|
|
|
157 6. **junction_bed**: Alignments of the breakpoint-junction supporting reads.
|
|
|
158
|
|
|
159 7. **junction_bam**: Alignments of the breakpoint-junction supporting reads.
|
|
|
160
|
|
|
161 8. **spanning_bam**: Alignments of the breakpoint-spanning paired-end reads.
|
|
|
162
|
|
|
163 9. **spanning_bed**: Alignments of the breakpoint-spanning paired-end reads.
|
|
|
164
|
|
|
165 10. **trinity_bed**: Fusion-guided Trinity assembly.
|
|
|
166
|
|
|
167 11. **fusion_predictions.final**: All fusion evidence described.
|
|
|
168
|
|
|
169 12. **fusion_predictions_abridged**: encompasses all information in fusion_predictions.final excluding the names of the reads.
|
|
|
170
|
|
|
171 13. **fusion_json**: A logistical file that enables the visualization.
|
|
|
172
|
|
|
173 </help>
|
|
|
174 <cite>
|
|
|
175 </cite>
|
|
|
176 </tool>
|
