clgui(1) perform 3D interactive Quartet Tree Reconstruction on a distance matrix to produce a binary tree


clgui [ distmatrix.clb ] [ ]


clgui tries to find an optimal tree to represent a distance matrix calculated in realtime. It uses the Quartet Tree Reconstruction method. The program starts with a random tree, and continues to try small modifications to improve the tree score. Eventually, the tree will stop easily improving. Move the camera with the mouse and keyboard, or experiment with the w (wireframe) and other commands. Explore the 3D virtual space to understand the statistical relationships among your data.

Double clicking with both mouse buttons will reset the camera view.

clgui can calculate distance matrix files in realtime. If a large amount of data must be processed, it is better to precalculate the distance matrix. Input files for this program can be created by ncd (1). This provides a smoother and more convenient way to create a binary distance matrix file via the -b command line option.

When starting clgui, you can begin with a clean slate and no options. Or one may just specify a distance matrix filename on the command line when starting clgui. If you do not specify a name, it will look for a file called distmatrix.clb in the current directory and load it immediately if found. If you specify both a distance matrix and a tree file, then clgui will provide an interactive 3D display to explore the tree by moving, panning, and zooming the camera.

To create trees with more control, use the maketree command from the libqsearch package. For more information on the details of this algorithm, please see Clustering by Compression by Cilibrasi and Vitanyi in IEEE Trans. Information Theory, 51:4(2005) or at url


There are no options for clgui yet.


per-user configuration file, overrides systemwide default; see complearn(5) for further details.




If any of the files cannot be read, an error will be printed and the program exits with a nonzero exit code.