# Taurus colors

Taurus uses color codes on many of its widgets. The color names follow the Web Colors standard, except for the custom ones that start with “Taurus -“.

Colors are used to represent two main things:

- the state of a taurus device

- the quality of (the reading of) an attribute.

## Taurus Device state colors

Taurus Device states, as defined in `taurus.core.TaurusDevState` are represented by the following colors:

Taurus color guide

Colors for the Taurus Device States (scheme-agnostic)
State | Background | Foreground | Preview
--- | --- | --- | ---
Ready | Lime (0,255,0) | Black (0,0,0) | Ready
NotReady | Red (255,0,0) | Black (0,0,0) | NotReady
Undefined | Gray (128,128,128) | Black (0,0,0) | Undefined

## Taurus Attribute Value Quality colors

The quality of an attribute measures the reliability of the current read value for that attribute. The meanings of the qualities are:

- Invalid: there was some problem when trying to read the attribute (the value should not be trusted)

- Valid: the attribute was read correctly (no reason to suspect its value validity)

- Alarm: the value is valid, but it exceeded its defined alarm limits

- Warning: like Alarm but for the warning limits

- Changing: the attribute was read correctly but it is being changed at the time of reading (so its value is likely to differ if re-read)

Taurus Attribute value qualities are represented by the following colors:

Taurus color guide

Colors for Taurus Attribute quality
Quality | Background | Foreground | Preview
--- | --- | --- | ---
Invalid | Gray (128,128,128) | White (255,255,255) | -----
Valid | Lime (0,255,0) | Black (0,0,0) | 10.89 mV
Alarm | Dark Orange (255,140,0) | White (255,255,255) | 76.54 mV
Warning | Dark Orange (255,140,0) | White (255,255,255) | 64.23 mV
Changing | Taurus - Cornflower Blue (128,160,255) | Black (0,0,0) | 20.45 mV

## Tango-specific Device state colors

Tango Device states are richer than the generic ones. The following is a table of the colors used to represent Tango-specific device states handled by the `taurus.core.tango` scheme:

Taurus color guide

color scheme for the State
State | Background | Foreground | Preview
--- | --- | --- | ---
On | Lime (0,255,0) | Black (0,0,0) | ON
Off | White (255,255,255) | Black (0,0,0) | OFF
Close | White (255,255,255) | Green (0,128,0) | CLOSE
Open | Lime (0,255,0) | Black (0,0,0) | OPEN
Insert | White (255,255,255) | Black (0,0,0) | INSERT
Extract | Lime (0,255,0) | Black (0,0,0) | EXTRACT
Moving | Taurus - Cornflower Blue (128,160,255) | Black (0,0,0) | MOVING
Standby | Yellow (255,255,0) | Black (0,0,0) | STANDBY
Fault | Red (255,0,0) | Black (0,0,0) | FAULT
Init | Taurus - Dark Khaki (204,204,122) | Black (0,0,0) | INIT
Running | Taurus - Cornflower Blue (128,160,255) | Black (0,0,0) | RUNNING
Alarm | Dark Orange (255,140,0) | White (255,255,255) | ALARM
Disable | Magenta (255,0,255) | Black (0,0,0) | DISABLE
Unknown | Gray (128,128,128) | Black (0,0,0) | UNKNOWN
<empty> | Gray (128,128,128) | Black (0,0,0) | -----