CLGUI(1)
NAME
clgui - perform 3D interactive Quartet Tree Reconstruction on a distance matrix to produce a binary tree
SYNOPSIS
clgui [ distmatrix.clb ] [ treefile.dot ]
DESCRIPTION
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 http://xxx.lanl.gov/abs/cs.CV/031204
OPTIONS
There are no options for clgui yet.
FILES
- $HOME/.complearn/complearn.conf
- per-user configuration file, overrides systemwide default; see complearn(5) for further details.
ENVIRONMENT
none
DIAGNOSTICS
If any of the files cannot be read, an error will be printed and the
program exits with a nonzero exit code.