Skip to main content

Setup and Input

The setup screen has two entry points:

Entry pointUse whenBackend required
Example LibraryYou want to open bundled precomputed datasets.No for generated browser examples; yes for backend-driven processing.
New ProjectYou want to upload local trees and/or an MSA.Yes for uploads, interpolation, and tree inference.

The backend status badge reports whether upload processing and MSA inference are available. In GitHub Pages demo mode, use generated examples unless you are running the local backend, Docker workflow, or desktop app.

Input Files

InputAccepted roleNotes
Tree fileOrdered tree series for interpolation.Use Newick-style tree files such as .nwk, .newick, or .tree.
MSA fileAlignment context or sliding-window tree inference.Backend-supported parsers include FASTA, CLUSTAL, PHYLIP, Nexus, and MSF-style alignments.
CSV taxa metadataTaxa coloring groups.Loaded from the Taxa Coloring window, not from the setup screen.

Workflow Modes

Files providedProcessing mode
Tree file onlyNormalize the ordered tree series and build transition frames.
Tree file plus MSABuild tree transitions and map alignment columns to the tree sequence.
MSA onlySplit the alignment into overlapping windows, infer one tree per window, then build transition frames.

Sliding Window Settings

These settings apply when an MSA is uploaded.

SettingMeaning
Window Size (sites)Number of alignment columns included in each window.
Step Size (sites)Distance between consecutive window starts. Smaller steps create more overlapping windows and more input trees.

When trees and an MSA are uploaded together, the same window and step values map alignment coordinates onto the uploaded tree sequence. When only an MSA is uploaded, they control the slices used for inference.

Tree Adjustments

SettingMeaning
Midpoint rootingRoots inferred or uploaded trees at the midpoint before transition construction.

Use midpoint rooting when the input series is unrooted or inconsistent and you want a stable visual reference. Preserve input rooting when the biological interpretation depends on a known root.

Tree Inference Engine

Tree inference settings apply only to MSA-only workflows.

EngineUse when
IQ-TREEYou want model-based inference with optional branch support annotations.
FastTreeYou want faster approximate inference for responsive exploratory runs.

IQ-TREE Settings

SettingMeaning
IQ-TREE Fast SearchSends IQ-TREE fast-search options for more responsive runs. This is disabled when UFBoot is selected.
Substitution Model: JC/GTRJC assumes equal rates and frequencies. GTR estimates rates and base frequencies.
Gamma Rate HeterogeneityAdds site-rate variation to the selected model.
Support ModeSelects no support run, UFBoot, SH-aLRT, or SH-aLRT plus UFBoot.
UFBoot replicatesNumber of ultrafast bootstrap replicates when UFBoot is enabled.
SH-aLRT replicatesNumber of SH-aLRT replicates when SH-aLRT is enabled.
Bootstrap NNISends IQ-TREE -bnni for bootstrap support refinement.

Branch support annotations can later be selected in the workspace under Style -> Geometry & Labels -> Branch Annotation.

FastTree Settings

SettingMeaning
PseudocountsSends FastTree -pseudo.
Skip ML OptimizationSends FastTree -noml.

FastTree settings trade detail for speed. They are most useful for exploratory datasets where rapid feedback is more important than a final inference run.