annotate analyze_covariates.xml @ 2:7af531c41dd7 draft default tip

Added a dependency on R, since the Analyze Covariates tool generates an R script for plotting residual error.
author devteam
date Wed, 02 Apr 2014 16:03:58 -0400
parents e531148fb585
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
1 <tool id="gatk_analyze_covariates" name="Analyze Covariates" version="0.0.5">
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
2 <description>- draw plots</description>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
3 <requirements>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
4 <requirement type="package" version="1.4">gatk</requirement>
2
7af531c41dd7 Added a dependency on R, since the Analyze Covariates tool generates an R script for plotting residual error.
devteam
parents: 1
diff changeset
5 <requirement type="package" version="2.11.0">R</requirement>
0
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
6 </requirements>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
7 <macros>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
8 <import>gatk_macros.xml</import>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
9 </macros>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
10 <command interpreter="python">gatk_wrapper.py
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
11 --max_jvm_heap_fraction "1"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
12 --stdout "${output_log}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
13 --html_report_from_directory "${output_html}" "${output_html.files_path}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
14 -p 'java
1
e531148fb585 Uploaded tool definition that correctly references JAVA_JAR_PATH.
devteam
parents: 0
diff changeset
15 -jar "\$JAVA_JAR_PATH/AnalyzeCovariates.jar"
0
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
16 -recalFile "${input_recal}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
17 -outputDir "${output_html.files_path}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
18 ##--num_threads 4 ##hard coded, for now
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
19 ##-log "${output_log}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
20 ##-Rscript,--path_to_Rscript path_to_Rscript; on path is good enough
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
21 #if $analysis_param_type.analysis_param_type_selector == "advanced":
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
22 --ignoreQ "${analysis_param_type.ignore_q}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
23 --numRG "${analysis_param_type.num_read_groups}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
24 --max_quality_score "${analysis_param_type.max_quality_score}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
25 --max_histogram_value "${analysis_param_type.max_histogram_value}"
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
26 ${analysis_param_type.do_indel_quality}
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
27 #end if
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
28 '
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
29 </command>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
30 <inputs>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
31 <param name="input_recal" type="data" format="csv" label="Covariates table recalibration file" help="-recalFile,--recal_file &amp;lt;recal_file&amp;gt;" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
32 <conditional name="analysis_param_type">
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
33 <param name="analysis_param_type_selector" type="select" label="Basic or Advanced options">
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
34 <option value="basic" selected="True">Basic</option>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
35 <option value="advanced">Advanced</option>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
36 </param>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
37 <when value="basic">
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
38 <!-- Do nothing here -->
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
39 </when>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
40 <when value="advanced">
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
41 <param name="ignore_q" type="integer" value="5" label="Ignore bases with reported quality less than this number." help="-ignoreQ,--ignoreQ &amp;lt;ignoreQ&amp;gt; "/>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
42 <param name="num_read_groups" type="integer" value="-1" label="Only process N read groups." help="-numRG,--numRG &amp;lt;numRG&amp;gt;"/>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
43 <param name="max_quality_score" type="integer" value="50" label="Max quality score" help="-maxQ,--max_quality_score &amp;lt;max_quality_score&amp;gt;"/>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
44 <param name="max_histogram_value" type="integer" value="0" label="Max histogram value" help="-maxHist,--max_histogram_value &amp;lt;max_histogram_value&amp;gt;"/>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
45 <param name="do_indel_quality" type="boolean" truevalue="--do_indel_quality" falsevalue="" label="Do indel quality" help="--do_indel_quality"/>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
46 </when>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
47 </conditional>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
48 </inputs>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
49 <outputs>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
50 <data format="html" name="output_html" label="${tool.name} on ${on_string} (HTML)" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
51 <data format="txt" name="output_log" label="${tool.name} on ${on_string} (log)" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
52 </outputs>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
53 <tests>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
54 <test>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
55 <param name="input_recal" value="gatk/gatk_count_covariates/gatk_count_covariates_out_1.csv" ftype="csv" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
56 <param name="analysis_param_type_selector" value="basic" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
57 <output name="output_html" file="gatk/gatk_analyze_covariates/gatk_analyze_covariates_out_1.html" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
58 <output name="output_log" file="gatk/gatk_analyze_covariates/gatk_analyze_covariates_out_1.log.contains" compare="contains" />
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
59 </test>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
60 </tests>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
61 <help>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
62 **What it does**
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
63
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
64 Create collapsed versions of the recal csv file and call R scripts to plot residual error versus the various covariates.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
65
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
66 For more information on base quality score recalibration using the GATK, see this `tool specific page &lt;http://www.broadinstitute.org/gsa/wiki/index.php/Base_quality_score_recalibration&gt;`_.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
67
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
68 To learn about best practices for variant detection using GATK, see this `overview &lt;http://www.broadinstitute.org/gsa/wiki/index.php/Best_Practice_Variant_Detection_with_the_GATK_v3&gt;`_.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
69
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
70 If you encounter errors, please view the `GATK FAQ &lt;http://www.broadinstitute.org/gsa/wiki/index.php/Frequently_Asked_Questions&gt;`_.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
71
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
72 ------
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
73
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
74 **Inputs**
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
75
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
76 GenomeAnalysisTK: AnalyzeCovariates accepts an recal CSV file.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
77
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
78
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
79 **Outputs**
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
80
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
81 The output is in CSV and HTML files with links to PDF graphs and a data files.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
82
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
83
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
84 Go `here &lt;http://www.broadinstitute.org/gsa/wiki/index.php/Input_files_for_the_GATK&gt;`_ for details on GATK file formats.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
85
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
86 -------
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
87
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
88 **Settings**::
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
89
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
90 recal_file The input recal csv file to analyze
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
91 output_dir The directory in which to output all the plots and intermediate data files
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
92 path_to_Rscript The path to your implementation of Rscript. For Broad users this is maybe /broad/tools/apps/R-2.6.0/bin/Rscript
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
93 path_to_resources Path to resources folder holding the Sting R scripts.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
94 ignoreQ Ignore bases with reported quality less than this number.
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
95 numRG Only process N read groups. Default value: -1 (process all read groups)
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
96 max_quality_score The integer value at which to cap the quality scores, default is 50
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
97 max_histogram_value If supplied, this value will be the max value of the histogram plots
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
98 do_indel_quality If supplied, this value will be the max value of the histogram plots
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
99
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
100 @CITATION_SECTION@
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
101 </help>
332a7de8f98a Imported from capsule None
devteam
parents:
diff changeset
102 </tool>