Skip to content

Quickstart

Three ways to launch

Explore Mode — view existing SAGE26 results using a full path to your .par file:

visage --par /path/to/SAGE26/input/millennium.par

Launch Mode — install, set up and run SAGE26, build a lightcone with LightSAGE, or calibrate with SAGEswarm. Run from your SAGE26 root (or the folder you want SAGE26 in) so ViSAGE finds your .par files and the tools automatically:

cd /path/to/SAGE26
visage

Lightcone Mode — view a LightSAGE cli_lightcone HDF5 output (built in Launch Mode's LightSAGE, or from a manual run):

visage --lightcone /path/to/lightcone.h5

See the Launch Mode and Lightcone Mode guides for details.

Explore Mode examples

miniMillennium

Open the printed URL (default http://localhost:8080) in any browser.

Launch on microUchuu

visage --par input/microuchuu.par --snap 49

Common options

# Start at a specific snapshot
visage --par input/millennium.par --snap 32

# Use a specific port
visage --par input/millennium.par --port 8888

# Limit haloes per snapshot (faster on slower machines)
visage --par input/millennium.par --max-halos 20000

# Use all CPUs for loading
visage --par input/millennium.par --n-jobs -1

First steps in the viewer

  1. The scene loads at the requested snapshot (default: z=0, snap 63).
  2. Use the timeline slider in the toolbar to jump to any snapshot.
  3. Press ▶ Play to animate through cosmic time.
  4. Toggle Dark Matter Haloes or Galaxies off in the Structure tab (right panel).
  5. Change Colour by to ssfr to highlight star-forming galaxies.
  6. Double-click a galaxy to select it, then press Show info (end of the Structure tab) for its card, and Go to fly there.
  7. Press HD (next to the Isolate magnifier) for a detailed model of the galaxy and its group. Esc returns to the normal view.