Annunciator¶
Grid of alarm windows following an ISA-18.1 sequence (IND-040 .. IND-043).
Not a safety-related system
The alarms shown here may be delayed, lost or stale. It is for visualization, teaching, simulation and supervision; it is not a safety-related system and must not perform a safety function. See the safety notice.

Alarms and events · Widget catalog · API reference ·
schema annunciator.schema.json
Example¶
The traits of the picture above:
ai.Annunciator(label="Annunciator", sequence="R", first_out=True, size=(440, 170))
Traits¶
| Trait | Type | Default | Set by | Description |
|---|---|---|---|---|
size |
array | [420,170] |
host | [width, height] in CSS pixels. |
value |
array of object | [] |
derived | Windows {tag, text, color, active, state, first}. The host sets the process condition (active). The states, the first-out mark and the horn are derived through the sequence and the operator actions: by the host when it owns the state (Python: set(), acknowledge(), ...), otherwise by the front end, which writes them back (HOST-004). |
columns |
integer | 4 |
host | Windows per row. |
sequence |
"A", "M", "R" |
"A" |
host | ISA-18.1 sequence: A automatic reset, M manual reset, R ringback. Changing it restarts every window (active: alert, else normal). |
first_out |
boolean | false |
host | Mark the first window to alarm until reset (IND-042). |
horn |
boolean | false |
derived | True while an alert or ringback is not silenced (no sound is played). Derived. |
test |
boolean | false |
host, widget | Lamp test, while the TEST button is held. |
Common traits (8), shared with other widgets
| Trait | Type | Default | Set by | Description |
|---|---|---|---|---|
mode |
"control", "indicator" |
"control" |
host | "control": the user sets the value; "indicator": display only. |
label |
string | "" |
host | Plain text, never interpreted as HTML (SEC-002). |
disabled |
boolean | false |
host | Greyed out, input rejected. |
visible |
boolean | true |
host | |
tooltip |
string | "" |
host | Plain text shown on hover. |
style |
"modern", "classic", "system" |
"modern" |
host | |
theme |
"auto", "light", "dark", "system" |
"auto" |
host | "auto": the style decides; "system": the host page or the operating system (STYLE-007). |
skin |
object | {} |
host | Replaceable drawing parts: part name -> SVG source, sanitized (STYLE-005, STYLE-006). |
Set by: host, the program (Python, Julia, ...); widget, the user through the widget;
derived, computed from other traits by the host that owns the state, or by the widget.
See the trait contract.