Skip to content

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

The numeric and Boolean widgets in control and indicator modes, a waveform chart and an alarm indicator. The widget catalog covers every widget.

Gallery

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.

Tank supervision

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.

PID tuning

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.

Filling line

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.

Signal acquisition