VSABrains

Demo Guide

A simple, step‑by‑step way to use the demo and understand the visuals.

What the demo shows

  • How columns write events as trajectories on a grid.
  • How queries trigger replay and verification.
  • How semantic frames highlight higher‑level patterns (emotion, theme, conflict).

Typical workflow (3 minutes)

  1. Generate a story. Choose a story mode (clean vs contradictory).
  2. Add more events. Use the “add events” button to grow the history.
  3. Run queries. Try at least 10 query types to see different answer paths.
  4. Watch the animation. Use Play/Stop and the speed slider to follow the path.

How to read the grid

  • Dots/segments = where recent events were written.
  • Multiple colors = different columns and/or frame highlights.
  • Longer trails = longer history or denser activity.

Think of each column as a “witness.” The grid is their shared notebook.

Query tab (right panel)

The Query tab lets you ask direct questions such as: “Where is Alice?”, “Who has the key?”, or “Did a contradiction happen?”

  • Supported = the answer is backed by a replayed evidence chain.
  • Conflicting = the system found explicit contradictions.
  • Unsupported = no evidence found in the story.

CNL tab

CNL (Constrained Natural Language) is a small list of semantic frames used by the demo. It controls what “semantic lenses” are tracked (tone, theme, conflict, emotion, etc.).

Changing the CNL profile changes what the system can summarize quickly.

Frames tab

The Frames tab plays a “film” of where specific semantic frames occurred. It follows the story order and highlights the segments where a frame fired.

  • Legend = the most active frames and their weights.
  • Animation = where those frames happened in the grid.

Tips for clearer results

  • Use a slower animation speed when you want to see sequence order.
  • Increase columns to watch consensus smooth out noisy data.
  • Use contradictory stories to see verifier rules in action.