BranchPy
Log in

Omega

Most users do not need this command for normal workflows. Omega is for deep variable-range analysis across the full path space. Use it after you are comfortable with Analyze, Flowchart, and Pilot.

Derive variable bounds and co-occurrence signals from a Pilot run.

What Omega is

Omega is the analysis layer that runs after Pilot. It reads Pilot’s enumerated execution paths and computes:

  • Value bounds — the observed min/max/range for each tracked variable across all paths.
  • Co-occurrence signals — which variable combinations appear together (or never together) across paths.
  • Impossible-combo candidates — variable states that are structurally unreachable given the path set.

Omega does not re-parse your source files. It processes Pilot’s output (.branchpy/stats2/stats2.json) and writes its own report (.branchpy/stats2/omega.json).

When to use Omega

  • You have run Pilot and want to understand variable ranges across the full path space.
  • You are debugging surprising variable states at specific story beats.
  • You need the Omega report as input to FlowchartPlus Narrative mode.

Pipeline position

branchpy analyze   →  builds CFG + analysis model
branchpy pilot     →  enumerates paths, tracks variable timelines
branchpy omega     →  derives bounds and co-occurrence from Pilot output

FlowchartPlus Narrative mode requires all three.

How to run (UI)

  1. Open the Control Center and run Analyze, then Pilot.
  2. Select Omega once Pilot completes.
  3. Review bounds summary and co-occurrence findings.

Run via CLI

branchpy omega --project-root <path>

Note: Omega currently uses --project-root instead of the global --project flag used by other commands. This inconsistency is flagged for normalization in a future release. Both paths resolve the same project root.

Common options:

branchpy omega --project-root <path> [--value-cap <N>] [--combo-cap <N>]
Flag Default Purpose
--project-root current directory Path to Ren’Py project root
--value-cap 50 Max distinct values tracked per variable
--combo-cap 2000 Max impossible-combo candidates evaluated

Omega reads from .branchpy/stats2/stats2.json (Pilot output) and writes to .branchpy/stats2/omega.json.

Requires

  • A completed Pilot run (.branchpy/stats2/stats2.json must exist).
  • Ren’Py Free tier or above (license-gated).

What Omega does not do

  • It does not re-run Analyze or Pilot.
  • It does not modify your source files.
  • It does not replace Pilot’s variable timeline data — it enriches it.

Learn more: Technical/analysis