0 ×


IBIS Helmholtz-Node extension for KNIME Workbench version by IBIS KNIME Team

This node is a wrapper for Ensembl's Variant Effect Predictor (VEP) which annotates genomic variants. The tool provides various annotation options and allows you to include individual plugins. The node supports the application of the LOFTEE plugin which assesses the confidence of loss-of-function variant.



Coding only
If this box is checked, VEP will only return consequences that affect coding regions of transcripts.
Choose transcript set
VEP uses Ensembl transcripts (=GENCODE Comprehensive) by default. By choosing GENCODE Basic your analysis is limited to transcripts without fragmented or problematic transcripts. Alternatively, you can choose the RefSeq transcript set (requires the RefSeq cache or not using the cache).
Check this box, if you want VEP to output the prediction term and score of amino acid substitutions predicted by SIFT.
Check this box, if you want VEP to output the prediction term and score of amino acid substitutions predicted by PolyPhen.
Gene symbol
VEP adds the gene symbol (where available) to the output.
Adds the biotype of the transcript or regulatory feature.
Further flags
Commit further options to VEP (whitespace separated).


Number of forks
Enable forking, using the specified number of forks. Forking can dramatically improve the runtime of the script. If LOFTEE is used, it will run ignoring the conservation file as there occur errors when the file is accessed by multiple threads.
Buffer size
Sets the internal buffer size, corresponding to the number of variations that are read in to memory simultaneously. Set this lower to use less memory at the expense of longer run time, and higher to use more memory with a faster run time.
Use cache
It is recommended to use a cache as accessing data in the cache is much faster than accessing it from the database. The cache is usually build during the installation of the Ensembl API. Otherwise, you can find information in the VEP documentation (see VEP link above).
Cache directory
Set the path to the cache directory.
(Default: "$HOME/.vep/")
Path to FastA file
Specify a FastA file or a directory containing FastA files to use to look up reference sequence. The file is required for the flags --hgvs or --check_ref when the cache is used. Moreover, the plugin LOFTEE won't work properly if no FastA file is given! The FastA can be downladed using the VEP installation script. In general, it is located in the cache directory (which is shown as default).


Choose format of annotation file
VEP outputs a tab separated file by default. It can also create a GVF or JSON file or add the annotations to the input VCF file.
Choose format of statistics file
VEP can create a statistics file in html or plain text format.
Folder for output files
Set the path to a folder where the output files should be stored.
If "Overwrite" is checked, existing files will be overwritten.


Plugin directory
Set the path to the plugin directory.
(Default: "$HOME/.vep/Plugins")
Further plugins
Commit further plugins to VEP. If you want to use multiple plugins, separate each plugin by whitespace.


Check this box if you want to use LOFTEE. Requires the plugin file in the plugin directory.
Path to human_ancestor.fa.gz
You can find a download link for this file following the LOFTEE link above.
Path to phylocsf.sql
You can find a download link for this file following the LOFTEE link above. The conservation file will be ignored, if forking is enabled.

Preference page

Set a threshold for repeated execution. Only used if HTE is enabled in the preference page.
Path to variant_effect_predictor.pl
Set the path to the VEP perl script. It can usually be found in ensembl-tools-release-../scripts/variant_effect_predictor.
Samtools PATH
Set the path to the SAMTOOLS executable (required by the LOFTEE plugin).

Input Ports

Cell 0: Path to VCF file.

Output Ports

Cell 0: Path to annotation file in the specified format.


The node offers a direct view of its standard out and the standard error of the tool.

Best Friends (Incoming)

Best Friends (Outgoing)


To use this node in KNIME, install KNIME4NGS from the following update site:


You don't know what to do with this link? Read our NodePit Product and Node Installation Guide that explains you in detail how to install nodes to your KNIME Analytics Platform.

Wait a sec! You want to explore and install nodes even faster? We highly recommend our NodePit for KNIME extension for your KNIME Analytics Platform. Browse NodePit from within KNIME, install nodes with just one click and share your workflows with NodePit Space.


You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.