Example notebooks

Seven complete, runnable notebooks, each built around a job you'd actually do with Zelos: triage a battery pack, investigate a fault, gate a release, archive a bench run. Every one runs against the demo generator — no hardware required — and doubles as a template for your own signals.

Start every example the same way, in a spare terminal:

zelos live demo --backfill 5m --duration 30m

Then copy an example into a file and run it:

zelos notebook run <example>.md

• Hello, Zelos

  Your first five minutes: connect, browse the catalog, query a window, chart it, read live values.

• Find the weak cell

  Bench triage on a battery pack — rank the cells, spot the one that sags, and turn the diagnosis into a check.

• Watch the bench live

  Bounded live monitoring: current values, a ticking poll, and every transition the poll slept through.

• What happened at the fault?

  Pin the instant a fault fired, read every signal at that moment, and chart what the inverter did around it.

• A release gate in CI

  A parameterized pass/fail runbook: checks score every rule, one assertion gates the run, exit codes CI understands.

• Snapshot the bench, analyze forever

  Export live data to a .trz file and run the same analysis against the frozen copy.

• How much energy did this cycle take?

  Align a mixed-rate join, multiply volts by amps, integrate to joules — with the units carried for you.

How the examples fit together

Hello, Zelos is the on-ramp — start there if this is your first notebook. Find the weak cell, Watch the bench live, and What happened at the fault? are the investigation patterns: ranking, monitoring, and forensics. A release gate in CI turns a finding into automation, Snapshot the bench makes it portable, and How much energy did this cycle take? is the derivation pattern — the one to read when your answer is a quantity nothing publishes directly.

Each page shows the full notebook with a copy button — paste it into a file, run it, then swap the demo paths for your own signals. The format reference covers everything the files use: front matter, params, {.norun} fences, and environments. Six of the seven end green; the release gate ends red on demo data, which is the point of it — see Notebooks as tests.

Every example is named by its file and declares a description, so once you've copied a few they introduce themselves:

zelos notebook list

Charts need no plotting library

The examples chart with plot(), which emits Vega-Lite. The Zelos App renders it inline, and an HTML export renders it with no network access at all — so dependencies stays at zelos-sdk[notebook] and a rendered page opens anywhere.