annotate picard_FilterSamReads.xml @ 107:5b10a8aea040 draft

Uploaded
author devteam
date Tue, 25 Feb 2014 00:45:51 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
107
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
1 <tool name="FilterSamReads" id="picard_FilterSamReads" version="1.106.0">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
2 <description>Produces a new SAM or BAM file by including or excluding aligned reads or a list of reads names supplied in the READ_LIST_FILE from the INPUT SAM or BAM file.</description>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
3 <requirements><requirement type="package" version="1.106.0">picard</requirement></requirements>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
4 <command interpreter="bash">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
5 generic_outformat_wrapper.sh FilterSamReads $output1 $outformat
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
6 FILTER="${conditionfilter.Filter}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
7 #if str( $READ_LIST_FILE ):
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
8 READ_LIST_FILE="${READ_LIST_FILE}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
9 #end if
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
10 #if str( $SORT_ORDER ):
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
11 SORT_ORDER="${SORT_ORDER}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
12 #end if
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
13 #if str( $WRITE_READS_FILES ):
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
14 WRITE_READS_FILES="${WRITE_READS_FILES}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
15 #end if
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
16 #if str( $OUTPUT ):
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
17 OUTPUT="${OUTPUT}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
18 #end if
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
19
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
20 VALIDATION_STRINGENCY=LENIENT
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
21 QUIET=True
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
22 TMP_DIR="${__new_file_path__}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
23 </command>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
24
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
25 <stdio>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
26 <exit_code range="0" level="warning" description="Tool finished correctly" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
27 </stdio>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
28
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
29 <inputs>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
30 <param format="bam,sam" name="input_file" type="data" label="SAM/BAM dataset that will be filterd" help="If empty, upload or import a SAM/BAM dataset."/>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
31 <conditional name="conditionfilter">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
32 <param name="Filter" type="select" help="Required. Possible values: {includeAligned [OUTPUT SAM/BAM will contain aligned reads only. INPUT SAM/BAM must be in queryname SortOrder. (Note that *both* first and second of paired reads must be aligned to be included in the OUTPUT SAM or BAM)], excludeAligned [OUTPUT SAM/BAM will contain un-mapped reads only. INPUT SAM/BAM must be in queryname SortOrder. (Note that *both* first and second of pair must be aligned to be excluded from the OUTPUT SAM or BAM)], includeReadList [OUTPUT SAM/BAM will contain reads that are supplied in the READ_LIST_FILE file], excludeReadList [OUTPUT bam will contain reads that are *not* supplied in the READ_LIST_FILE file]}"
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
33 label="Filter">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
34 <option value="includeAligned" selected ="true">includeAligned</option>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
35 <option value="excludeAligned">excludeAligned</option>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
36 <option value="includeReadList">includeReadList</option>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
37 <option value="excludeReadList">excludeReadList</option>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
38 </param>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
39 <when value="includeReadList">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
40 <param format="data" name="READ_LIST_FILE" type="data" label="Read List File containing reads that will be included or excluded from the OUTPUT SAM or BAM file. Default value: null." help="" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
41 </when>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
42 <when value="excludeReadList">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
43 <param format="data" name="READ_LIST_FILE" type="data" label="Read List File containing reads that will be included or excluded from the OUTPUT SAM or BAM file. Default value: null." help="" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
44 </when>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
45 </conditional>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
46 <param format="text" name="SORT_ORDER" type="string" label="SortOrder of the OUTPUT SAM or BAM file, otherwise use the SortOrder of the INPUT file. Default value: null. Possible values: {unsorted, queryname, coordinate}" help="" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
47
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
48 <param name="allowIncDictConcord" type="boolean" checked="False" truevalue="true" falsevalue="false" label="Allow incomplete dict concordance?" help="Allows a partial overlap of the BAM contigs with the new reference sequence contigs." />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
49
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
50 <param name="WRITE_READS_FILES" type="boolean" checked="True" truevalue="true" falsevalue="false" label="Create .reads files (for debugging purposes)" help="" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
51
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
52 <param name="outputFormat" type="boolean" checked="True" truevalue="bam" falsevalue="sam" label="Output BAM instead of SAM" help="Uncheck for SAM output" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
53
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
54 </inputs>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
55
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
56 <outputs>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
57 <data name="outFile" format="bam" label="${tool.name} on ${on_string}: filtered ${outputFormat}">
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
58 <change_format>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
59 <when input="outputFormat" value="sam" format="sam" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
60 </change_format>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
61 </data>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
62 </outputs>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
63
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
64
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
65
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
66
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
67 <tests>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
68 <!-- Here is a command line that works:
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
69 java -jar ...
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
70
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
71 <param name="inputFile" value="XXCHANGEMEE-input" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
72 <output name="outFile" file="XXCHANGEMEE-correct-output" lines_diff="2" ftype="XXCHANGEMEE" />
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
73 </test> -->
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
74 </tests>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
75 <help>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
76 Picard documentation says:
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
77
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
78
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
79 FilterSamReads
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
80
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
81 Produces a new SAM or BAM file by including or excluding aligned reads or a list of reads names supplied in the READ_LIST_FILE from the INPUT SAM or BAM file.
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
82
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
83 Option Description
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
84 INPUT=File The SAM or BAM file that will be filtered. Required.
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
85 FILTER=Filter Filter. Required. Possible values: {includeAligned [OUTPUT SAM/BAM will contain aligned reads only. INPUT SAM/BAM must be in queryname SortOrder. (Note that *both* first and second of paired reads must be aligned to be included in the OUTPUT SAM or BAM)], excludeAligned [OUTPUT SAM/BAM will contain un-mapped reads only. INPUT SAM/BAM must be in queryname SortOrder. (Note that *both* first and second of pair must be aligned to be excluded from the OUTPUT SAM or BAM)], includeReadList [OUTPUT SAM/BAM will contain reads that are supplied in the READ_LIST_FILE file], excludeReadList [OUTPUT bam will contain reads that are *not* supplied in the READ_LIST_FILE file]}
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
86 READ_LIST_FILE=File Read List File containing reads that will be included or excluded from the OUTPUT SAM or BAM file. Default value: null.
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
87 SORT_ORDER=SortOrder SortOrder of the OUTPUT SAM or BAM file, otherwise use the SortOrder of the INPUT file. Default value: null. Possible values: {unsorted, queryname, coordinate}
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
88 WRITE_READS_FILES=Boolean Create .reads files (for debugging purposes) Default value: true. This option can be set to 'null' to clear the default value. Possible values: {true, false}
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
89 OUTPUT=File SAM or BAM file to write read excluded results to Required.
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
90
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
91
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
92 </help>
5b10a8aea040 Uploaded
devteam
parents:
diff changeset
93 </tool>