Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


NPM version

Interactive and easy-to-use phylogenetic tree viewer for the web build on TnT.tree.

Getting Started

Install the module with: npm install exelixis and build it with npm run prepublish Have a look at the examples by starting the server with npm run sniper

var exe = require('exelixis');
var createTree = exe.createTree;
var updateTree = exe.updateTree;


Default opts

Following default settings can be customized.

var opts = {
		el : document.getElementById("yourDiv"),
		tree : {
			data : "(homo_sapiens:12,(mus_musculus:12,(danio_rerio:13,(pan_troglodytes:9,(taeniopygia_guttata:10,callithrix_jacchus:11):12):12):10);",	
			width : 500,
			scale : false,
			layoutInput : "vertical",
		label : {
			fontsize : 12,
			usePics : false, 
			pics : {
				//pictureSource : pics,
				pictureWidth : 30,
				pictureHeight : 40,
		nodes : {
			toggle : false, 
			select: false, 
			size : 5,
			fill : "grey",
			stroke : "black",
			selectedFill : "steelblue",
			selectedSize : 4,


Change this to the div element you want to plot in your tree


  • data (string) takes as input your newick string
  • width (int) is the width of your tree
  • height (int) is the height of your labels (currently under work)
  • scale (boolean) scales the tree according to its branch lengths given in the newick string
  • layoutInput ("vertical" or "radial") changes tree layout


  • fontsize (int) sets the fontsize
  • usePics (boolean) use pictures in the label


  • pictureSource (array) links to the png picture array you want to display. PicturesID has to be the same as the taxa names in the newick string.
  • pictureWidth (int) sets the width of the picture
  • pictureHeight (int) sets the picture height


  • toggle (boolean) clicking nodes will toggle its subtree
  • select (boolean) change node to color selectedFill and size selectedSize when clicked
  • fill (color) nodefill color
  • stroke (color) nodestroke color


Parameter: opts a json containing settings

The 'createTree' method returns a phylogenetic tree.

How to use this method

var tree = createTree();

not using any opts creates a tree with default opts


Parameter: tree a tree object returned by createTree() , opts a json containing settings

The 'updateTree' method updates all opts properties which are given in opts with animations on runtime and saves its opts. All opts properties which are not mentioned stays the same as previously.

How to use this method

updateTree(tree, {tree:{data: "(Ape,(Bear,(Clown,Dolphin)))", width: 300, heigth: 20}});


All contributions are welcome.


If you have any problem or suggestion please open an issue here.


This software is licensed under the Apache 2 license, quoted below.

Copyright (c) 2015, David

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Interactive and easy-to-use phylogenetic tree viewer for the web





No releases published


No packages published
You can’t perform that action at this time.