Skip to content

Widget catalog

Every widget of the catalog is available; each has a page saying what it shows and which convention it follows, with its example. Each is a TypeScript front-end module extending anywidget-instruments, with its common traits (value, label, unit, min, max, theme, size, disabled, visible, tooltip). The examples use the Python host binding; from Julia, Rust or a web page, the same widgets take the same traits.

Every picture opens a notebook

On the page of a widget, click its picture to drive it in a marimo notebook, in your browser, with no installation.

All widgets are indicators: the value is set by the kernel and only displayed. A vehicle display is read, not operated, while driving.

Dials

  • Speedometer


    Speedometer, day theme Speedometer, night theme

    Vehicle speed, rounded up after conversion, never down; a speed limit marked on the scale.

  • Tachometer


    Tachometer, day theme Tachometer, night theme

    Engine speed in thousands of rpm, red zone, shift light, and the ready state of a hybrid.

  • FuelGauge


    FuelGauge, day theme FuelGauge, night theme

    Fuel from E to F, the reserve zone, and the fuel pump symbol lit in it, towards the filler flap.

  • TemperatureGauge


    TemperatureGauge, day theme TemperatureGauge, night theme

    Coolant temperature, cold and hot zones, and its tell-tale lit red when hot.

Tell-tales

  • TellTale


    TellTale, day theme TellTale, night theme

    One tell-tale: the symbol of its function, lit in the colour of its meaning, never of the theme.

  • TellTaleCluster


    TellTaleCluster, day theme TellTaleCluster, night theme

    A row of tell-tales: the direction indicators side by side, then the lit ones by colour.

Digital displays

  • TripComputer


    TripComputer, day theme TripComputer, night theme

    Instant and average consumption, fuel or energy used, distance, time, range — per hour below 5 km/h.

  • Odometer


    Odometer, day theme Odometer, night theme

    Total and trip distance on drums, never rounded up.

  • GearIndicator


    GearIndicator, day theme GearIndicator, night theme

    The engaged gear, and an up or down shift arrow.

Electric and hybrid

A vehicle driven by an electric motor, alone or with an engine, is read through the charge of its battery, the power it draws or regenerates, and an energy consumption (EV-001 .. EV-008). Power is positive when the drivetrain drives the wheels, negative when it regenerates.

  • PowerMeter


    PowerMeter, day theme PowerMeter, night theme

    Power in kW, the regeneration zone below zero, REGEN and READY.

  • StateOfChargeGauge


    StateOfChargeGauge, day theme StateOfChargeGauge, night theme

    Battery charge, the low zone and its symbol, CHARGING.

  • PowerFlow


    PowerFlow, day theme PowerFlow, night theme

    Engine, battery and wheels: where the power goes, by arrows and in words.

Layout

  • Cluster


    Cluster, day theme Cluster, night theme

    An instrument panel of any of them, with the head-up display mode.

Units

Every widget reads its value in metric units by default and shows it in the unit system chosen for it — metric, imperial (UK) or us — or in a unit of its own:

aa.Speedometer(87.3, unit_system="us")                # 87.3 km/h in, 55 mph shown
aa.TemperatureGauge(90, unit_system="us", unit="°C")  # one quantity in a unit of its own

Fuel economy is the quantity to watch: L/100 km and mpg are reciprocal, so a scale converted from one to the other is turned round — its better end stays marked as better — and a figure that would be infinite, at a standstill, is not shown.

Day and night

theme takes the values of anywidget-instruments — "auto", "light", "dark", "system" — and "day" and "night" (LEG-003): the day theme is the light one; the night theme is dark, dimmer than the dark theme, with no large bright area (LEG-004). Tell-tale colours do not change with the theme. The pictures of this catalog show the day theme, or the night theme with a dark reading preference.

aa.Speedometer(87.3, theme="night")

What every dial does

Every dial reads its value, its scale, its zones and its limits in input_unit (the metric unit of its quantity by default) and draws them in the unit of its unit system, or in its own unit. Common traits:

  • min, max — the scale, with major and minor ticks on round values (DIAL-001);
  • zones — coloured arcs, {"from", "to", "kind"} with kind one of "danger", "warning", "cold", "charge" (DIAL-005);
  • resolution — the step of the readout, the value as text below the needle (DIAL-002);
  • animate — the needle glides to a new value; never under the reduced-motion preference (DIS-003, A11Y-002);
  • max_age — a value older than this is marked STALE (ROB-001).

A value above or below the scale stops the needle at its end and lights a marker there (DIAL-003); NaN or an infinity leaves the needle where it was and reads INVALID (DIAL-004); no value yet reads NO VALUE, with no needle (ROB-002). A value changing more than twice a second is held half a second at a time rather than flicker (DIS-002).

Dials with no value, above the scale and invalid, day themeDials with no value, above the scale and invalid, night theme