Examples¶
Note
The demos and examples simulate processes and machines; they are not meant to control real equipment (see the safety notice).
Start with the showcase
Batch reactor R-101: a complete operator station on a simulated reactor (PackML state machine, recipe, PID faceplate, alarms, trends, event log, plant model), the same in marimo, in JupyterLite and, from Julia, in KaimonSlate.jl. It opens the table below.
Run them in your browser¶
Start here: nothing to install. Each demo is a reactive notebook (marimo) running in your browser: move a control and the cells that depend on it run again. Each demo is also available as a JupyterLite notebook. The first load downloads the Python runtime and takes a few seconds (see Try it in the browser).
The References column names the standards and methods a demo illustrates. They inspired the widgets; the library does not claim conformity with them (see Standards and references).
| Sector | Reactive notebook (marimo) | What it shows | References | Also in JupyterLite |
|---|---|---|---|---|
| Chemical and process control (showcase) | Batch reactor R-101 | A complete operator station: PackML state machine, editable recipe, PID faceplate, valves, pumps, agitator, alarms, trend, event log, plant model; a fault to simulate | ISA-TR88.00.02 (PackML), ISA-88 / IEC 61512-1 (recipe), ISA-101, ISA-18.2 / IEC 62682, IEC 60073, IEC 62264 | notebook |
| All sectors (tour) | Gallery | Every widget family: knobs and indicators, Boolean controls, charts, alarms, styles | IEC 60073 (lamp colors) | notebook |
| Water and wastewater | Lift station | Wet well with duty / standby pumps, alternation, level alarms, a pump trip and its reset | ISA-18.2 / IEC 62682 (alarm list), ISA-5.1 (tags, pump symbol), IEC 60073 | notebook |
| Chemical and process control | PID tuning | Closed-loop step response of a process with dead time; overshoot and settling time follow the Kp, Ti, Td knobs | ISA-101 (analog indicator) | notebook |
| Food, beverage and packaging | Operator station | Filling line following the machine state model, with stack light, PID faceplate, annunciator and alarm list | ISA-TR88.00.02 (PackML states), ISA-18.1 (annunciator), ISA-18.2 / IEC 62682 (alarm list), ISA-101 (faceplate), IEC 60073 (stack light) | notebook |
| Laboratory, test and measurement | Signal analysis | Waveform selector, frequency and noise knobs; signal, spectrum, RMS level and dominant frequency | SI prefixes (units) | notebook |
| Laboratory, test and measurement | Virtual instrument bench | Function generator, oscilloscope and multimeter front panels built from widgets | SI prefixes (units) | notebook |
| Machines and processes (methods) | Operating modes | GEMMA, ISA-88 and PackML state models side by side; choosing a situation drives the three models to it through their own commands | GEMMA (ADEPA, 1981), ISA-88 / IEC 61512-1 (procedural states), ISA-TR88.00.02 (PackML states) | notebook |
| Machine panels | SVG faceplates | Front panels drawn in a vector editor and animated from Python: a tank with FILL / DRAIN push buttons, a HAND / AUTO selector, a pilot lamp, a voltmeter and a pressure gauge | notebook | |
| Machine panels | Push buttons | Plain push buttons (latch, jog) and illuminated push buttons whose lamps show the machine state | IEC 60073 (cap and lamp colors) | notebook |
| Machine panels | Switches and selectors | Two-position switches, HAND / OFF / AUTO and spring-return selectors, a four-position rotary selector | IEC 60073 (lamp colors), ISA-5.1 (pump and motor symbols) | notebook |
Download and run locally¶
Most notebooks of the examples/ folder run a live simulation in a
background thread, so they need a local Jupyter or marimo (set the
environment variable AWI_EXAMPLE_SECONDS to limit their duration).
Download them from the repository:
| Sector | Notebook | References |
|---|---|---|
| All sectors (tour) | Gallery, marimo panel | IEC 60073, ISA-18.2 / IEC 62682 (alarm indicator) |
| Water and wastewater | Tank level supervision | ISA-18.2 / IEC 62682 (alarm banner), ISA-5.1 (tags, symbols) |
| Chemical and process control | First-order process with PID tuning | IEC 60204-1, ISO 13850 (emergency stop look only, see the safety notice) |
| Food, beverage and packaging | Filling line operator station | ISA-TR88.00.02 (PackML states), ISA-18.1, ISA-18.2 / IEC 62682, ISA-101, IEC 60073 |
| Laboratory, test and measurement | Real-time signal acquisition | SI prefixes (units) |
All sectors¶
Gallery (examples/gallery.ipynb)¶
The numeric and Boolean widgets in control and indicator modes, a waveform chart and an alarm indicator. The widget catalog covers every widget.

marimo (examples/marimo_panel.py)¶
marimo edit examples/marimo_panel.py
Water and wastewater¶
Tank level supervision with alarms (examples/tank_supervision.ipynb)¶
Pump, tank and outflow valve on a synoptic; LO/HI/HIHI alarms with deadband feed an ISA-18.2 alarm banner; AUTO hysteresis control or MANUAL operation from the faceplates.

Chemical and process control¶
First-order process with PID tuning (examples/pid_first_order.ipynb)¶
A plant \(K/(\tau s + 1)\) with a PID controller (derivative on measurement, anti-windup): tune Kp, Ti and Td live, step the setpoint, stop with the emergency stop and measure the response with cursors.

Food, beverage and packaging¶
Filling line operator station (examples/filling_line.ipynb)¶
A bottle filling line driven by the ISA-TR88.00.02 state model, with a HAND / OFF / AUTO selector, a stack light, a PID faceplate for the product temperature, the fill weight on a high-performance indicator, an ISA-18.1 annunciator and an alarm list with shelving.

Laboratory, test and measurement¶
Real-time signal acquisition (examples/signal_acquisition.ipynb)¶
Two channels at 1 kHz on a strip chart, a spectrogram of channel 0, RMS level on a VU meter and the dominant frequency on a seven-segment display.
