annotate igvtools_tile.xml @ 0:2eb1e2924c1a

Uploaded
author jjohnson
date Tue, 17 Jan 2012 21:53:25 -0500
parents
children ae2bc4e5fefc
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
1 <tool id="igvtools_tile" name="IGVtools tile" version="1.0">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
2 <description>convert a sorted data input file to a binary tiled data (.tdf) file</description>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
3 <command interpreter="bash">igvtools tile
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
4 #if $zoom.__str__ != '':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
5 -z $zoom
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
6 #end if
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
7 #if $window_functions.__str__ != '':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
8 -f '$window_functions'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
9 #end if
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
10 #if $probe.__str__ != '':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
11 -p '$probe'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
12 #end if
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
13 ## IGVTools relies on the file extension to determine format
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
14 #if $input.datatype.file_ext == 'wig':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
15 #set $input_name='input_file.wig'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
16 #elif $input.datatype.file_ext == 'igv.snp':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
17 #set $input_name='input_file.snp'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
18 #elif $input.datatype.file_ext == 'igv.gct':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
19 #set $input_name='input_file.gct'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
20 #elif $input.datatype.file_ext == 'igv.cn':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
21 #set $input_name='input_file.cn'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
22 #elif $input.datatype.file_ext == 'igv':
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
23 #set $input_name='input_file.igv'
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
24 #end if
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
25 `ln -s $input $input_name; echo $input_name` $output_tdf $refGenomeSource.ref
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
26 </command>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
27 <inputs>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
28 <conditional name="refGenomeSource">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
29 <param name="refGenomeSource_type" type="select" label="Will you select a reference genome from your history or use a built-in reference?">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
30 <option value="built-in">Use a built-in reference</option>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
31 <option value="history">Use one from the history</option>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
32 </param>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
33 <when value="built-in">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
34 <param name="ref" type="select" label="Select a reference genome">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
35 <options from_file="igv_indices.loc">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
36 <column name="dbkey" index="0" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
37 <column name="name" index="1" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
38 <column name="value" index="2" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
39 <filter type="sort_by" column="1" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
40 <validator type="no_options" message="No indexes are available" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
41 </options>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
42 </param>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
43 </when>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
44 <when value="history">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
45 <param name="ref" type="data" format="igv.genome" metadata_name="dbkey" label="Select a reference from history" />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
46 </when>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
47 </conditional>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
48 <param name="input" type="data" format="wig,igv,igv.cn,igv.snp,igv.gct" label="Input file" help="The input WIG,CN,IGV,GCT,SNP feature file"/>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
49 <param name="zoom" type="integer" value="7" optional="true" label="-z maximum zoom level to precompute"
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
50 help="The default value is 7 and is sufficient for most files. To reduce file
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
51 size at the expense of IGV performance this value can be reduced." />
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
52 <param name="window_functions" type="select" display="checkboxes" multiple="True" label="-f Functions to calculate over windows"
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
53 help="If none are selected, will default to mean">
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
54 <option value="mean" selected="true">mean</option>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
55 <option value="min">min</option>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
56 <option value="max">max</option>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
57 </param>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
58 <param name="probe" type="data" format="bed" optional="true" label="Probe file for GCT input"
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
59 help="Specifies a bed file to be used to map probe identifiers to locations.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
60 This option is useful when preprocessing .gct files.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
61 The bed file should contain 4 columns:
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
62 chr start end name
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
63 where name is the probe name in the .gct file."/>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
64 </inputs>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
65 <outputs>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
66 <data format="igv.tdf" name="output_tdf" metadata_source="input" label="${tool.name} on ${on_string}: igv.tdf" from_work_dir="output.tdf"/>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
67 </outputs>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
68 <tests>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
69 </tests>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
70 <help>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
71 **What it does**
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
72
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
73 The IGVTools_ tile command converts a sorted data input file to a binary tiled data (.tdf) file. Use this command to pre-process large datasets for improved IGV performance.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
74
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
75 .. _IGVTools: http://www.broadinstitute.org/software/igv/igvtools_commandline
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
76 .. _IGV: http://www.broadinstitute.org/igv/
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
77
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
78 ------
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
79
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
80 To cite your use of IGV in your publication::
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
81
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
82 James T. Robinson, Helga Thorvaldsdottir, Wendy Winckler, Mitchell Guttman, Eric S. Lander, Gad Getz, Jill P. Mesirov.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
83 Integrative Genomics Viewer. Nature Biotechnology 29, 24-26 (2011)
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
84
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
85 ------
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
86
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
87 **Input formats**
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
88
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
89 Supported input file formats are: .wig, .cn, .snp, .igv, and .gct.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
90
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
91 ------
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
92
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
93 **Outputs**
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
94
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
95 The output format is IGV tiled data file (TDF) file (.tdf)
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
96
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
97 -------
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
98
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
99
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
100 **IGVTools count parameter list**
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
101
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
102 This is an exhaustive list of igvtools count options:
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
103
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
104 For **count**::
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
105
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
106 -z Integer Specifies the maximum zoom level to precompute. The default
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
107 value is 7 and is sufficient for most files. To reduce file
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
108 size at the expense of IGV performance this value can be
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
109 reduced.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
110
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
111 -p file Specifies a "bed" file to be used to map probe identifiers
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
112 to locations. This option is useful when preprocessing . gct
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
113 files. The bed file should contain 4 columns:
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
114 chr start end name
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
115 where name is the probe name in the .gct file.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
116
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
117 -f list A comma delimited list specifying window functions to use
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
118 when reducing the data to precomputed tiles. Possible
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
119 values are min, max, and mean. By default only the mean
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
120 is calculated.
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
121
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
122
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
123
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
124 </help>
2eb1e2924c1a Uploaded
jjohnson
parents:
diff changeset
125 </tool>