Skip to content

Explore a bigraph

Below is a live, interactive bigraph-loom explorer — the same viewer the Workbench serves at /loom-explore, exported here so it runs with no server. (In a git/editable Workbench install the loom bundle may be unbuilt, so the live /loom-explore route can 404 until scripts/build_loom.sh is run — the exported explorer below needs no server either way.) Pan and zoom, expand a node to drill into a sub-composite, and inspect how processes and steps wire to shared stores.

Open in a new tab ↗

Add your own composite

The picker is driven by a small manifest, so adding a composite takes two steps — no build:

  1. Drop its JSON into docs/assets/loom/composites/ (the same shape the Workbench's Composite Explorer and loom save-points export: an object with state, parameters, default_n_steps, name, and description).
  2. Add a row to docs/assets/loom/composites/manifest.json:
{
  "composites": [
    { "id": "my-model", "label": "My model", "file": "my-model.json",
      "description": "One line about it." }
  ]
}

To embed a specific composite on any other page, drop in an iframe pointing at the same bundle and hand it a manifest (or a single composite file) — the small script in docs/javascripts/loom-embed.js does the composite:load handshake.

Or link straight to the standalone explorer, no server, no opener — the explorer loads the composite from the URL itself:

  • assets/loom/index.html?id=<id>&static=1 — resolves <id> against the sibling composites/manifest.json (the "Open in a new tab" link above uses exactly this);
  • assets/loom/index.html?src=<url-to-composite.json> — loads any composite JSON directly;
  • …&manifest=<url> — resolve ?id= against a manifest elsewhere.
Keeping it current

The bundle under docs/assets/loom/ is the workbench's vendored loom build. To refresh it, rebuild vivarium_workbench/loom/_dist (scripts/build_loom.sh) and re-copy it here (minus the *.map source maps).