annotate picard_FilterSamReads.xml @ 138:987dbea3b72f draft

Uploaded
author devteam
date Thu, 27 Feb 2014 01:00:20 -0500
parents eaa932566ace
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
115
eaa932566ace Uploaded
devteam
parents:
diff changeset
1 <tool name="FilterSamReads" id="picard_FilterSamReads" version="1.106.0">
eaa932566ace Uploaded
devteam
parents:
diff changeset
2 <description>Includes or excludes aligned reads or a list of reads from a BAM or SAM file</description>
eaa932566ace Uploaded
devteam
parents:
diff changeset
3 <requirements><requirement type="package" version="1.106.0">picard</requirement></requirements>
eaa932566ace Uploaded
devteam
parents:
diff changeset
4 <command interpreter="bash">
eaa932566ace Uploaded
devteam
parents:
diff changeset
5 generic_outformat_wrapper.sh FilterSamReads $outFile $outputFormat
eaa932566ace Uploaded
devteam
parents:
diff changeset
6 FILTER="${conditionfilter.Filter}"
eaa932566ace Uploaded
devteam
parents:
diff changeset
7 INPUT=$input_file
eaa932566ace Uploaded
devteam
parents:
diff changeset
8 #if $conditionfilter.Filter == "includeReadList" or $conditionfilter.Filter == "excludeReadList" :
eaa932566ace Uploaded
devteam
parents:
diff changeset
9 #if str( $READ_LIST_FILE ):
eaa932566ace Uploaded
devteam
parents:
diff changeset
10 READ_LIST_FILE="${READ_LIST_FILE}"
eaa932566ace Uploaded
devteam
parents:
diff changeset
11 #end if
eaa932566ace Uploaded
devteam
parents:
diff changeset
12 #end if
eaa932566ace Uploaded
devteam
parents:
diff changeset
13
eaa932566ace Uploaded
devteam
parents:
diff changeset
14 #if str( $SORT_ORDER ):
eaa932566ace Uploaded
devteam
parents:
diff changeset
15 SORT_ORDER="${SORT_ORDER}"
eaa932566ace Uploaded
devteam
parents:
diff changeset
16 #end if
eaa932566ace Uploaded
devteam
parents:
diff changeset
17
eaa932566ace Uploaded
devteam
parents:
diff changeset
18
eaa932566ace Uploaded
devteam
parents:
diff changeset
19 VALIDATION_STRINGENCY=LENIENT
eaa932566ace Uploaded
devteam
parents:
diff changeset
20 QUIET=True
eaa932566ace Uploaded
devteam
parents:
diff changeset
21 TMP_DIR="${__new_file_path__}"
eaa932566ace Uploaded
devteam
parents:
diff changeset
22 </command>
eaa932566ace Uploaded
devteam
parents:
diff changeset
23
eaa932566ace Uploaded
devteam
parents:
diff changeset
24 <stdio>
eaa932566ace Uploaded
devteam
parents:
diff changeset
25 <exit_code range="0" level="warning" description="Tool finished correctly" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
26 </stdio>
eaa932566ace Uploaded
devteam
parents:
diff changeset
27
eaa932566ace Uploaded
devteam
parents:
diff changeset
28 <inputs>
eaa932566ace Uploaded
devteam
parents:
diff changeset
29 <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."/>
eaa932566ace Uploaded
devteam
parents:
diff changeset
30 <conditional name="conditionfilter">
eaa932566ace Uploaded
devteam
parents:
diff changeset
31 <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]}"
eaa932566ace Uploaded
devteam
parents:
diff changeset
32 label="Filter">
eaa932566ace Uploaded
devteam
parents:
diff changeset
33 <option value="includeAligned" selected ="true">includeAligned</option>
eaa932566ace Uploaded
devteam
parents:
diff changeset
34 <option value="excludeAligned">excludeAligned</option>
eaa932566ace Uploaded
devteam
parents:
diff changeset
35 <option value="includeReadList">includeReadList</option>
eaa932566ace Uploaded
devteam
parents:
diff changeset
36 <option value="excludeReadList">excludeReadList</option>
eaa932566ace Uploaded
devteam
parents:
diff changeset
37 </param>
eaa932566ace Uploaded
devteam
parents:
diff changeset
38 <when value="includeReadList">
eaa932566ace Uploaded
devteam
parents:
diff changeset
39 <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="" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
40 </when>
eaa932566ace Uploaded
devteam
parents:
diff changeset
41 <when value="excludeReadList">
eaa932566ace Uploaded
devteam
parents:
diff changeset
42 <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="" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
43 </when>
eaa932566ace Uploaded
devteam
parents:
diff changeset
44 </conditional>
eaa932566ace Uploaded
devteam
parents:
diff changeset
45
eaa932566ace Uploaded
devteam
parents:
diff changeset
46 <param name="SORT_ORDER" value="Sort order" type="text" label="SortOrder of the OUTPUT SAM or BAM file, otherwise use the SortOrder of the INPUT file. Default value: null." help="Possible values: {unsorted, queryname, coordinate}" size="100" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
47
eaa932566ace 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." />
eaa932566ace Uploaded
devteam
parents:
diff changeset
49
eaa932566ace Uploaded
devteam
parents:
diff changeset
50
eaa932566ace Uploaded
devteam
parents:
diff changeset
51 <param name="outputFormat" type="boolean" checked="True" truevalue="bam" falsevalue="sam" label="Output BAM instead of SAM" help="Uncheck for SAM output" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
52
eaa932566ace Uploaded
devteam
parents:
diff changeset
53 </inputs>
eaa932566ace Uploaded
devteam
parents:
diff changeset
54
eaa932566ace Uploaded
devteam
parents:
diff changeset
55 <outputs>
eaa932566ace Uploaded
devteam
parents:
diff changeset
56 <data name="outFile" format="bam" label="${tool.name} on ${on_string}: filtered ${outputFormat}">
eaa932566ace Uploaded
devteam
parents:
diff changeset
57 <change_format>
eaa932566ace Uploaded
devteam
parents:
diff changeset
58 <when input="outputFormat" value="sam" format="sam" />
eaa932566ace Uploaded
devteam
parents:
diff changeset
59 </change_format>
eaa932566ace Uploaded
devteam
parents:
diff changeset
60 </data>
eaa932566ace Uploaded
devteam
parents:
diff changeset
61 </outputs>
eaa932566ace Uploaded
devteam
parents:
diff changeset
62
eaa932566ace Uploaded
devteam
parents:
diff changeset
63 <help>
eaa932566ace Uploaded
devteam
parents:
diff changeset
64 Picard documentation says:
eaa932566ace Uploaded
devteam
parents:
diff changeset
65
eaa932566ace Uploaded
devteam
parents:
diff changeset
66
eaa932566ace Uploaded
devteam
parents:
diff changeset
67 FilterSamReads
eaa932566ace Uploaded
devteam
parents:
diff changeset
68
eaa932566ace Uploaded
devteam
parents:
diff changeset
69 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.
eaa932566ace Uploaded
devteam
parents:
diff changeset
70
eaa932566ace Uploaded
devteam
parents:
diff changeset
71 Option Description
eaa932566ace Uploaded
devteam
parents:
diff changeset
72 INPUT=File The SAM or BAM file that will be filtered. Required.
eaa932566ace Uploaded
devteam
parents:
diff changeset
73 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]}
eaa932566ace Uploaded
devteam
parents:
diff changeset
74 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.
eaa932566ace Uploaded
devteam
parents:
diff changeset
75 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}
eaa932566ace Uploaded
devteam
parents:
diff changeset
76 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}
eaa932566ace Uploaded
devteam
parents:
diff changeset
77 OUTPUT=File SAM or BAM file to write read excluded results to Required.
eaa932566ace Uploaded
devteam
parents:
diff changeset
78
eaa932566ace Uploaded
devteam
parents:
diff changeset
79
eaa932566ace Uploaded
devteam
parents:
diff changeset
80 </help>
eaa932566ace Uploaded
devteam
parents:
diff changeset
81 </tool>