---
name: "clgui"
section: "1"
platform: "linux"
package: "complearn-gui"
version: "1.0.7-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/clgui"
---

# clgui(1)

perform 3D interactive Quartet Tree Reconstruction on a distance matrix to produce a binary tree

## 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.

## SEE ALSO

**complearn**(5), [**ncd**(1)](/ncd/1.md), [**maketree**(1)](/maketree/1.md)