annotate overlapselect_wrapper.xml @ 0:84f5e02c76f3 draft default tip

Uploaded
author qfab
date Wed, 21 May 2014 03:30:16 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
1 <tool id="overlapselect_wrapper" name="overlap Select" version="1.0">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
2 <requirements>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
3 <requirement type='package' version="latest">overlapSelect</requirement>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
4 </requirements>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
5
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
6
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
7 <description>UCSC Overlap Select</description>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
8 <command interpreter="bash">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
9 overlapselect_wrapper.sh
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
10 #if $optionSpec.parType == "specify":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
11 #if $str($optionSpec.strand) == "true":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
12 -strand
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
13 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
14 #if $str($optionSpec.oppositeStrand) == "true":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
15 -oppositeStrand
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
16 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
17 #if $str($optionSpec.nonOverlapping) == "true":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
18 -nonOverlapping
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
19 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
20 #if $str($optionSpec.mergeOutput) == "true":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
21 -mergeOutput
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
22 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
23 -overlapBases=$optionSpec.overlapBases
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
24 -overlapThreshold=$optionSpec.overlapThreshold
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
25 -overlapThresholdCeil=$optionSpec.overlapThresholdCeil
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
26 #if $str($optionSpec.selectFormat) == "bed":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
27 -selectFmt=bed
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
28 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
29 #if $str($optionSpec.inFormat) == "bed":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
30 -inFmt=bed
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
31 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
32 #if $str($optionSpec.selectFormat) == "tab":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
33 -selectCoordCols=$optionSpec.selColStart
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
34 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
35 #if $str($optionSpec.inFormat) == "tab":
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
36 -inCoordCols=$optionSpec.inColStart
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
37 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
38 #else
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
39 -selectFmt=bed inFmt=bed
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
40 #end if
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
41 $selectFile
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
42 $inFile
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
43 $outFile
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
44 </command>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
45 <inputs>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
46 <param name="inFile" type="data" format="Tabular" metadata_name="dbkey" label="Select the query (input) file" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
47 <param name="selectFile" type="data" format="Tabular" metadata_name="dbkey" label="Select the reference (select) file" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
48 <conditional name="optionSpec">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
49 <param name="parType" type="select" label="Do you want to select your target from the list or from your history?" help="">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
50 <option value="default">Use Default Parameters</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
51 <option value="specify">Specify Parameters</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
52 </param>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
53 <when value="default">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
54 </when>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
55 <when value="specify">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
56 <param name="selectFormat" type="select" label="Query File Format -selectFmt">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
57 <option value="bed">Bed</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
58 <option value="tab">Tabular</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
59 </param>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
60 <param name="inFormat" type="select" label="Reference File Format -inFmt">
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
61 <option value="bed">Bed</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
62 <option value="tab">Tabular</option>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
63 </param>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
64 <param name="selColStart" type="integer" value="0" label="Query File is unstranded with chr starting at this column (0 based - i.e. 0=col1), followed by start and end (-1 to disable)-selectCoordCols" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
65 <param name="inColStart" type="integer" value="0" label="Reference File is unstranded with chr starting at this column (0 based - i.e. 0=col1), followed by start and end (-1 to disable)-inCoordCols" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
66 <param name="strand" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Only search on same strand -strand" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
67 <param name="oppositeStrand" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Only search on opposite strand -oppositeStrand" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
68 <param name="nonOverlapping" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Select non-overlapping instead of overlapping records" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
69 <param name="mergeOutput" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Merge Output -mergeOutput" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
70 <param name="overlapBases" type="integer" value="-1" label="Number of overlap minimum (-overlapBases) (-1 to disable)" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
71 <param name="overlapThreshold" type="float" value="0.0" label="Minimum fraction overlap" help="minimum fraction of an inFile record that must be overlapped by a single select record to be considered
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
72 overlapping. Note that this is only coverage by a single select record, not total coverage" />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
73 <param name="overlapThresholdCeil" type="float" value="1.1" label="Maximum fraction overlap" help="select only inFile records with less than this amount of overlap with a single record, provided they are selected by other criteria." />
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
74
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
75 </when> <!-- history -->
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
76 </conditional> <!-- optionSpec -->
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
77 </inputs>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
78 <outputs>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
79 <data format="interval" name="outFile" label="Overlapselect on ${selectFile.name} vs ${inFile.name} "/>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
80 </outputs>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
81 <tests>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
82 <test>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
83 <param name="inFile" value="NM_001206.gp"/>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
84 <param name="selectFile" value="mrna.psl"/>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
85 <output name="outFile" value="psl_over_NM_001206gp.psl"/>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
86 </test>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
87 </tests>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
88
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
89 <help>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
90 **Overlap Select Help**
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
91
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
92
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
93 **Options**
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
94
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
95 * selectCds - Use only CDS in the selectFile
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
96
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
97 * selectRange - Use entire range instead of blocks from records in the selectFile.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
98
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
99 * inFmt=fmt - specify inFile format, same values as -selectFmt.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
100
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
101 * inCoordCols=spec - inFile is tab-separate with coordinates specified by spec, in format described above.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
102
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
103 * inCds - Use only CDS in the inFile
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
104
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
105 * inRange - Use entire range instead of blocks of records in the inFile.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
106
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
107 * nonOverlapping - select non-overlapping instead of overlapping records
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
108
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
109 * strand - must be on the same strand to be considered overlapping
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
110
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
111 * oppositeStrand - must be on the opposite strand to be considered overlapping
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
112
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
113 * excludeSelf - don't compare records with the same coordinates and name. Warning: using only one of -inCds or -selectCds will result in different coordinates for the same record.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
114
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
115 * idMatch - only select overlapping records if they have the same id
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
116
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
117 * aggregate - instead of computing overlap bases on individual select entries, compute it based on the total number of inFile bases overlap by selectFile records. -overlapSimilarity and -mergeOutput will not work with this option.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
118
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
119 * overlapThreshold=0.0 - minimum fraction of an inFile record that must be overlapped by a single select record to be considered overlapping. Note that this is only coverage by a single select record, not total coverage.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
120
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
121 * overlapThresholdCeil=1.1 - select only inFile records with less than this amount of overlap with a single record, provided they are selected by other criteria.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
122
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
123 * overlapSimilarity=0.0 - minimum fraction of inFile and select records that: Note that this is only coverage by a single select record and this is; bidirectional inFile and selectFile must overlap by this amount. A value of 1.0 will select identical records (or CDS if both CDS options are specified. Not currently supported with *aggregate.*
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
124
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
125 * overlapSimilarityCeil=1.1 - select only inFile records with less than this amount of similarity with a single record. provided they are selected by other criteria.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
126
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
127 * overlapBases=-1 - minimum number of bases of overlap, lt 0 disables.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
128
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
129 * statsOutput - output overlap statistics instead of selected records. If no overlap criteria is specified, all overlapping entries are reported, Otherwise only the pairs passing the criteria are reported. This results in a tab-separated file with the columns: inId selectId inOverlap selectOverlap overBases: Where inOverlap is the fraction of the inFile record overlapped by the selectFile record and selectOverlap is the fraction of the select record overlap by inFile records. With -aggregate, output is: inId inOverlap inOverBases inBases
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
130
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
131 * statsOutputAll - like -statsOutput, however output all inFile records, including those that are not overlapped.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
132
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
133 * statsOutputBoth - like -statsOutput, however output all selectFile and inFile records, including those that are not overlapped.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
134
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
135 * mergeOutput - output file with be a merge of the input file with the selectFile records that selected it. The format is inRec selectRec. if multiple select records hit, inRec is repeated. This will increase
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
136 the memory required. Not supported with -nonOverlapping or -aggregate.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
137
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
138 * idOutput - output a tab-separated file of pairs of inId selectId with -aggregate, only a single column of inId is written
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
139
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
140 * dropped=file - output rows that were dropped to this file.
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
141
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
142 * verbose=n - verbose gt 1 prints some details,
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
143
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
144
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
145 </help>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
146 </tool>
84f5e02c76f3 Uploaded
qfab
parents:
diff changeset
147