<tocitem text="Jalview Documentation" target="home" expand="true">
<tocitem text="What's new" target="new" expand="true">
<tocitem text="Latest Release Notes" target="release"/>
- <tocitem text="Structure Chooser" target="pdbchooser"/>
- <tocitem text="Chimera Annotation Exchange" target="chimera.annotxfer"/>
+ <tocitem text="VCF Import" target="vcfimport"/>
+ <tocitem text="Feature Filters and Attribute Colourschemes" target="features.featureschemes" />
+
</tocitem>
<tocitem text="Editing Alignments" target="edit" />
<tocitem text="Select Columns by Annotation" target="selectcolbyannot" />
<tocitem text="Nucleic Acid Support" target="nucleicAcids" expand="false">
+ <tocitem text="Annotating from VCF" target="importvcf" />
<tocitem text="Viewing RNA structure" target="varna" />
<tocitem text="RNA Structure Consensus" target="calcs.alstrconsensus" />
<tocitem text="RNA Helices coloring" target="colours.rnahelices" />
--- /dev/null
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ *
+ * This file is part of Jalview.
+ *
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *
+ * Jalview is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ * PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>Importing Variants from VCF</title>
+</head>
+<body>
+ <p>
+ <strong>Importing Genomic Variants from VCF</strong>
+ </p>
+
+ <p>Jalview can annotate nucleotide sequences associated with
+ genomic loci with features representing variants imported from VCF
+ files. This new feature in Jalview 2.11, is currently tuned to work
+ best with tab indexed VCF files produced by the GATK Variant
+ Annotation Pipeline (with or without annotation provided by the
+ Ensembl Variant Effect Predictor), but other sources of VCF files
+ should also work.</p>
+ <p>
+ If your sequences have genomic loci, then a <strong>Taxon
+ name</strong> and <strong>chromosome location</strong> should be shown in
+ the Sequence Details report and the Sequence ID tooltip (providing
+ you have enabled it via the submenu in the <em><strong>View</strong></em>
+ menu). Jalview matches the assembly information provided in the VCF
+ file to the taxon name, using an internal lookup table. If a match
+ is found, Jalview employs the Ensembl API's lift-over services to
+ locate your sequences' loci in the VCF file assembly's reference
+ frame. If all goes well, after loading a VCF, Jalview will report
+ the number of variants added as sequence features via the alignment
+ window's status bar. These are added by default when loci are
+ retrieved from Ensembl.
+ </p>
+ <p>
+ <strong>Working with variants from organisms other than
+ H.sapiens.</strong>
+ </p>
+ <ol>
+ <li>Look in your VCF file to identify keywords in the
+ ##reference header that define what species and assembly name the
+ VCF was generated against.</li>
+ <li>Look at ensembl.org to identify the species' short name,
+ and the assembly's unique.</li>
+ <li>Add mappings to the <strong>VCF_SPECIES</strong> and <strong>VCF_ASSEMBLY</strong>
+ properties in your .jalview_properties file. For example:<pre>
+VCF_SPECIES=1000genomes=homo_sapiens,c_elegans=celegans
+VCF_ASSEMBLY=assembly19=GRCh37,hs37=GRCh37</pre><br /> <br />These allow
+ annotations to be mapped from both Human 1000genomes VCF files and
+ C.elegans files.
+ </li>
+ </ol>
+ <strong>Work in Progress!</strong>
+ <p>VCF support in Jalview is under active development. Please get
+ in touch via our mailing list if you have any questions, problems or
+ otherwise find it useful !</p>
+</body>
+</html>
annotations</a>.
</em></li>
<li><strong>Load VCF File<br>
- </strong><em>Load VCF annotations from a plain text or tab-indexed file.
- <br>This option is offered for nucleotide alignments, and requires at least one
- sequence to have known genomic coordinates.
- <br>Genomic coordinates are attached to entries retrieved from Ensembl.
- <br>Support for VCF was added in Jalview 2.11.
- </em></li>
+ </strong><em><a href="../features/importvcf.html">Load VCF annotations</a> from a plain text, or indexed file (.csi,.tsi).
+ <br>Only available for nucleotide alignments, and requires at least one
+ sequence to have known genomic coordinates.</em></li>
<li><strong>Close (Control W)</strong><br> <em>Close
the alignment window. Make sure you have saved your alignment
before you close - either as a Jalview project or by using the <strong>Save
git://source.jalview.org / jalview.git / commitdiff