annotate variant_validate.xml @ 0:340633249b3d draft

Uploaded
author bgruening
date Mon, 02 Dec 2013 06:18:36 -0500
parents
children 8bcc13094767
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
340633249b3d Uploaded
bgruening
parents:
diff changeset
1 <tool id="gatk2_variant_validate" name="Validate Variants" version="0.0.7">
340633249b3d Uploaded
bgruening
parents:
diff changeset
2 <description></description>
340633249b3d Uploaded
bgruening
parents:
diff changeset
3 <expand macro="requirements" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
4 <macros>
340633249b3d Uploaded
bgruening
parents:
diff changeset
5 <import>gatk2_macros.xml</import>
340633249b3d Uploaded
bgruening
parents:
diff changeset
6 </macros>
340633249b3d Uploaded
bgruening
parents:
diff changeset
7 <command interpreter="python">
340633249b3d Uploaded
bgruening
parents:
diff changeset
8 gatk2_wrapper.py
340633249b3d Uploaded
bgruening
parents:
diff changeset
9 --stdout "${output_log}"
340633249b3d Uploaded
bgruening
parents:
diff changeset
10 -d "--variant:variant,%(file_type)s" "${reference_source.input_variant}" "${reference_source.input_variant.ext}" "input_variant"
340633249b3d Uploaded
bgruening
parents:
diff changeset
11 -p '
340633249b3d Uploaded
bgruening
parents:
diff changeset
12 @JAR_PATH@
340633249b3d Uploaded
bgruening
parents:
diff changeset
13 -T "ValidateVariants"
340633249b3d Uploaded
bgruening
parents:
diff changeset
14
340633249b3d Uploaded
bgruening
parents:
diff changeset
15 \$GATK2_SITE_OPTIONS
340633249b3d Uploaded
bgruening
parents:
diff changeset
16
340633249b3d Uploaded
bgruening
parents:
diff changeset
17 @THREADS@
340633249b3d Uploaded
bgruening
parents:
diff changeset
18
340633249b3d Uploaded
bgruening
parents:
diff changeset
19 #if $reference_source.reference_source_selector != "history":
340633249b3d Uploaded
bgruening
parents:
diff changeset
20 -R "${reference_source.ref_file.fields.path}"
340633249b3d Uploaded
bgruening
parents:
diff changeset
21 #end if
340633249b3d Uploaded
bgruening
parents:
diff changeset
22 ${warn_on_errors}
340633249b3d Uploaded
bgruening
parents:
diff changeset
23 ${do_not_validate_filtered_records}
340633249b3d Uploaded
bgruening
parents:
diff changeset
24 '
340633249b3d Uploaded
bgruening
parents:
diff changeset
25
340633249b3d Uploaded
bgruening
parents:
diff changeset
26 #if str( $dbsnp_rod_bind_type.dbsnp_rod_bind_type_selector ) == 'set_dbsnp':
340633249b3d Uploaded
bgruening
parents:
diff changeset
27 -d "--dbsnp:${dbsnp_rod_bind_type.dbsnp_rod_name},%(file_type)s" "${dbsnp_rod_bind_type.dbsnp_input_rod}" "${dbsnp_rod_bind_type.dbsnp_input_rod.ext}" "input_dbsnp_${dbsnp_rod_bind_type.dbsnp_rod_name}"
340633249b3d Uploaded
bgruening
parents:
diff changeset
28 #end if
340633249b3d Uploaded
bgruening
parents:
diff changeset
29
340633249b3d Uploaded
bgruening
parents:
diff changeset
30 #include source=$standard_gatk_options#
340633249b3d Uploaded
bgruening
parents:
diff changeset
31 </command>
340633249b3d Uploaded
bgruening
parents:
diff changeset
32 <inputs>
340633249b3d Uploaded
bgruening
parents:
diff changeset
33
340633249b3d Uploaded
bgruening
parents:
diff changeset
34 <conditional name="reference_source">
340633249b3d Uploaded
bgruening
parents:
diff changeset
35 <expand macro="reference_source_selector_param" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
36 <when value="cached">
340633249b3d Uploaded
bgruening
parents:
diff changeset
37 <param name="input_variant" type="data" format="vcf" label="Input variant file" help="-V,--variant &amp;lt;variant&amp;gt;" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
38 <param name="ref_file" type="select" label="Using reference genome" help="-R,--reference_sequence &amp;lt;reference_sequence&amp;gt;">
340633249b3d Uploaded
bgruening
parents:
diff changeset
39 <options from_data_table="gatk2_picard_indexes">
340633249b3d Uploaded
bgruening
parents:
diff changeset
40 <filter type="data_meta" key="dbkey" ref="input_variant" column="dbkey"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
41 </options>
340633249b3d Uploaded
bgruening
parents:
diff changeset
42 <validator type="no_options" message="A built-in reference genome is not available for the build associated with the selected input file"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
43 </param>
340633249b3d Uploaded
bgruening
parents:
diff changeset
44 </when>
340633249b3d Uploaded
bgruening
parents:
diff changeset
45 <when value="history"> <!-- FIX ME!!!! -->
340633249b3d Uploaded
bgruening
parents:
diff changeset
46 <param name="input_variant" type="data" format="vcf" label="Input variant file" help="-V,--variant &amp;lt;variant&amp;gt;" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
47 <param name="ref_file" type="data" format="fasta" label="Using reference file" help="-R,--reference_sequence &amp;lt;reference_sequence&amp;gt;" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
48 </when>
340633249b3d Uploaded
bgruening
parents:
diff changeset
49 </conditional>
340633249b3d Uploaded
bgruening
parents:
diff changeset
50
340633249b3d Uploaded
bgruening
parents:
diff changeset
51 <conditional name="dbsnp_rod_bind_type">
340633249b3d Uploaded
bgruening
parents:
diff changeset
52 <param name="dbsnp_rod_bind_type_selector" type="select" label="Provide a dbSNP reference-ordered data file" help="-D,--dbsnp &amp;lt;dbsnp&amp;gt;">
340633249b3d Uploaded
bgruening
parents:
diff changeset
53 <option value="set_dbsnp" selected="True">Set dbSNP</option>
340633249b3d Uploaded
bgruening
parents:
diff changeset
54 <option value="exclude_dbsnp">Don't set dbSNP</option>
340633249b3d Uploaded
bgruening
parents:
diff changeset
55 </param>
340633249b3d Uploaded
bgruening
parents:
diff changeset
56 <when value="exclude_dbsnp">
340633249b3d Uploaded
bgruening
parents:
diff changeset
57 <!-- Do nothing here -->
340633249b3d Uploaded
bgruening
parents:
diff changeset
58 </when>
340633249b3d Uploaded
bgruening
parents:
diff changeset
59 <when value="set_dbsnp">
340633249b3d Uploaded
bgruening
parents:
diff changeset
60 <param name="dbsnp_input_rod" type="data" format="vcf" label="ROD file" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
61 <param name="dbsnp_rod_name" type="hidden" value="dbsnp" label="ROD Name"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
62 </when>
340633249b3d Uploaded
bgruening
parents:
diff changeset
63 </conditional>
340633249b3d Uploaded
bgruening
parents:
diff changeset
64
340633249b3d Uploaded
bgruening
parents:
diff changeset
65 <param name="warn_on_errors" type="boolean" checked="False" truevalue="-warnOnErrors" falsevalue="" label="instead of terminating the run at the first error, print warning messages for each error seen." help="-warnOnErrors,--warnOnErrors"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
66 <param name="do_not_validate_filtered_records" type="boolean" checked="False" truevalue="-doNotValidateFilteredRecords" falsevalue="" label="do not try to validate records that are FILTERed." help="-doNotValidateFilteredRecords,--doNotValidateFilteredRecords"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
67
340633249b3d Uploaded
bgruening
parents:
diff changeset
68 <expand macro="gatk_param_type_conditional" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
69
340633249b3d Uploaded
bgruening
parents:
diff changeset
70 </inputs>
340633249b3d Uploaded
bgruening
parents:
diff changeset
71 <outputs>
340633249b3d Uploaded
bgruening
parents:
diff changeset
72 <data format="txt" name="output_log" label="${tool.name} on ${on_string} (log)" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
73 </outputs>
340633249b3d Uploaded
bgruening
parents:
diff changeset
74 <tests>
340633249b3d Uploaded
bgruening
parents:
diff changeset
75 <test>
340633249b3d Uploaded
bgruening
parents:
diff changeset
76 <param name="reference_source_selector" value="history" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
77 <param name="ref_file" value="phiX.fasta" ftype="fasta" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
78 <param name="input_variant" value="gatk/gatk_variant_annotator/gatk_variant_annotator_out_1.vcf" ftype="vcf" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
79 <param name="dbsnp_rod_bind_type_selector" value="set_dbsnp" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
80 <param name="dbsnp_input_rod" value="gatk/fake_phiX_variant_locations.vcf" ftype="vcf" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
81 <param name="warn_on_errors" value="True"/>
340633249b3d Uploaded
bgruening
parents:
diff changeset
82 <param name="do_not_validate_filtered_records" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
83 <param name="gatk_param_type_selector" value="basic" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
84 <output name="output_log" file="gatk/gatk_validate_variants/gatk_validate_variants_out_1.log.contains" compare="contains" />
340633249b3d Uploaded
bgruening
parents:
diff changeset
85 </test>
340633249b3d Uploaded
bgruening
parents:
diff changeset
86 </tests>
340633249b3d Uploaded
bgruening
parents:
diff changeset
87 <help>
340633249b3d Uploaded
bgruening
parents:
diff changeset
88 **What it does**
340633249b3d Uploaded
bgruening
parents:
diff changeset
89
340633249b3d Uploaded
bgruening
parents:
diff changeset
90 Validates a variants file.
340633249b3d Uploaded
bgruening
parents:
diff changeset
91
340633249b3d Uploaded
bgruening
parents:
diff changeset
92 For more information on using the ValidateVariants module, see this `tool specific page &lt;http://www.broadinstitute.org/gatk/gatkdocs/org_broadinstitute_sting_gatk_walkers_variantutils_ValidateVariants.html&gt;`_.
340633249b3d Uploaded
bgruening
parents:
diff changeset
93
340633249b3d Uploaded
bgruening
parents:
diff changeset
94 To learn about best practices for variant detection using GATK, see this `overview &lt;http://www.broadinstitute.org/gatk/guide/topic?name=best-practices&gt;`_.
340633249b3d Uploaded
bgruening
parents:
diff changeset
95
340633249b3d Uploaded
bgruening
parents:
diff changeset
96 If you encounter errors, please view the `GATK FAQ &lt;http://www.broadinstitute.org/gatk/guide/topic?name=faqs&gt;`_.
340633249b3d Uploaded
bgruening
parents:
diff changeset
97
340633249b3d Uploaded
bgruening
parents:
diff changeset
98 ------
340633249b3d Uploaded
bgruening
parents:
diff changeset
99
340633249b3d Uploaded
bgruening
parents:
diff changeset
100 **Inputs**
340633249b3d Uploaded
bgruening
parents:
diff changeset
101
340633249b3d Uploaded
bgruening
parents:
diff changeset
102 GenomeAnalysisTK: ValidateVariants accepts variant files as input.
340633249b3d Uploaded
bgruening
parents:
diff changeset
103
340633249b3d Uploaded
bgruening
parents:
diff changeset
104
340633249b3d Uploaded
bgruening
parents:
diff changeset
105 **Outputs**
340633249b3d Uploaded
bgruening
parents:
diff changeset
106
340633249b3d Uploaded
bgruening
parents:
diff changeset
107 The output is a log of variant validation.
340633249b3d Uploaded
bgruening
parents:
diff changeset
108
340633249b3d Uploaded
bgruening
parents:
diff changeset
109
340633249b3d Uploaded
bgruening
parents:
diff changeset
110 Go `here &lt;http://www.broadinstitute.org/gatk/guide/topic?name=intro&gt;`_ for details on GATK file formats.
340633249b3d Uploaded
bgruening
parents:
diff changeset
111
340633249b3d Uploaded
bgruening
parents:
diff changeset
112 -------
340633249b3d Uploaded
bgruening
parents:
diff changeset
113
340633249b3d Uploaded
bgruening
parents:
diff changeset
114 **Settings**::
340633249b3d Uploaded
bgruening
parents:
diff changeset
115
340633249b3d Uploaded
bgruening
parents:
diff changeset
116 doNotValidateFilteredRecords should we skip validation on filtered records?
340633249b3d Uploaded
bgruening
parents:
diff changeset
117 warnOnErrors should we just emit warnings on errors instead of terminating the run?
340633249b3d Uploaded
bgruening
parents:
diff changeset
118
340633249b3d Uploaded
bgruening
parents:
diff changeset
119 @CITATION_SECTION@
340633249b3d Uploaded
bgruening
parents:
diff changeset
120 </help>
340633249b3d Uploaded
bgruening
parents:
diff changeset
121 </tool>