Main Window
The Tetrad main window has three parts:
A menu bar across the top, for sessions, settings, logging and ready-made pipelines.
A desktop below it, holding one window per open session.
An optional logging pane along the bottom, shown while logging is on.
Each session window has two parts of its own: a box palette down the left side and a workbench filling the rest. All work in Tetrad is done by placing boxes on the workbench, connecting them with arrows, and double-clicking them.

In a typical session you will:
Place boxes on the workbench and connect them (for example, Data → Search).
Double-click each box to fill it in: load the data, pick and run the algorithm, and so on.
Inspect each result inside the box that produced it.
Save the session for later.
Sessions
A session is one workbench together with everything on it: the boxes, the arrows between them, and the contents of every box — data, graphs, models and results. A session is saved and loaded as a single file from the File menu.
Several sessions can be open at once, each in its own window on the desktop. The Window menu lists the open sessions so you can bring one to the front.
The box palette
The palette on the left of every session window is a column of buttons. The top two are tools; the rest each add one kind of box. They appear in this order, in groups separated by a small gap.
Tools
Select and Move — select boxes, or groups of boxes, and drag them around the workbench. This is the resting tool; the palette returns to it after most actions.
Draw Edge — draw an arrow from one box to another, declaring that the first box’s contents are an input to the second.
Working with data: load, constrain, search, look
Data — load, view, transform and audit data.
Knowledge — background knowledge: tiers, and required and forbidden edges.
Search — run a search algorithm.
Latent Clusters — cluster measured variables by their latent causes. To search over the clusters, make this box a parent of a Search box.
Graph — draw, edit and analyze a graph.
Compare — compare graphs or models, and check a graph against data.
Modeling and inference on a graph
Parametric Model — choose a model family for a graph.
Estimator — fit a parametric model to data.
Updater — update a fitted model on evidence or interventions.
Regression — run a regression.
Instantiated Model — a model with specific parameter values.
Simulation and benchmarking
Simulation — generate data from a model.
Grid Search — compare algorithms and settings, on your own data or on simulated data.
Annotation
Note — a text note on the workbench.
The Box by Box section documents the boxes in this same order.
Earlier versions had a Latent Structure button between Latent Clusters and Graph. It was removed in October 2026; see Latent Structure Box (removed).
The workbench
Placing a box. Click a box button in the palette, then click the workbench where the box should go. The palette then returns to Select and Move. To place several boxes of the same kind, hold Shift while clicking; the box button stays selected until you release it.
Connecting boxes. Click Draw Edge, then drag from one box to another. The arrow means that the first box feeds the second: Data → Search gives the search its data, and Knowledge → Search gives it background knowledge. Draw Edge stays selected so you can draw several arrows in a row; click Select and Move when you are done.
Opening a box. Double-click a box. The first time, Tetrad asks whatever it needs in order to create the box’s contents, such as which kind of model or which algorithm. After that, double-clicking opens the box’s editor in its own window. A result lives inside the box that produced it: the graph from a search is in the Search box, and a fitted model is in the Estimator box.
The right-click menu. Right-clicking a box offers:
Create Contents, Edit Contents and Destroy Contents — make, open or discard what the box holds. Destroying the contents keeps the box and its arrows.
Propagate changes downstream — fill in this box and every box downstream of it, overwriting any contents those boxes already have.
Rename Box, Clone Box and Delete Box.
Edit Parameters… — edit the box’s parameters.
Help — a short description of the box.
Settings
Tetrad → Settings… opens a dialog with three tabs:
General — Dark Mode, Show experimental algorithms everywhere (which is what reveals the methods marked experimental; see Experimental Methods), and UI font size.
Numbers — the numeric formatting used throughout the application.
Logging — where log output is written: only to the logging pane, or also to a log file.
In earlier versions these settings were a File → Settings submenu. That submenu is gone; use the Tetrad menu.
Logging pane
When you choose Logging → Start Logging, a logging pane opens along the bottom of the main window, below the desktop, and shows log output from algorithms and tools as they run. Choosing Logging → Stop Logging hides the pane and, if file logging is enabled, closes the current log file.
For a long-running algorithm, the logging pane is the place to watch progress and warnings.