EVENT ANNOTATIONS
Prefix Field Source Example
~E The value of Event 60
~Y1 ET value 420
~Y2 BT value 372
~descr The Description field of the Event Gas 10
~type The Type field of the Event Power
~sldrunit The value of the Slider Unit for this Event kPa
~dCHARGE Number of seconds since CHARGE 522
~dFCs Number of seconds after FCs
Best used inside double quotes (see notes below)
Displays '*' prior to FCs
47
~preFCs Number of seconds before FCs
Best used inside single quotes or back ticks (see notes below)
Displays '*' after FCs
50
~DTR Development time ratio. Note: DTR=0 before FCs
100*(t{Event}-t{FCs})/(t{FCs}-t{CHARGE})
12
~deg The degree symbol °
~mode Temperature mode ('C' or 'F') F
~degmode Degree symbol with Temperature mode °C
~quot Quote symbol "
~squot Single quote symbol '


EXAMPLES
Assumptions: The event value is 50. In the case of Gas the value 50 corresponds to either 5.0kPh or 50%.
For a sensory milestone (see notes above) the value 50 corresponds to the "Hay" aroma.
Annotation Field Displays
Gas ~E @~Y2~degmode Gas 50 @340°F
Gas ~E% @~Y2~mode Gas 50% @340F
Gas ~E/10kPh @~Y2~mode Gas 5.0kPh @340F
Gas ~E% '@~Y2 ~degmode'"@~DTR% DTR" Before FCs:
Gas 50% @340 °F

After FCs:
Gas 50% @12% DTR
Gas ~E% '@~Y2 ~degmode`, ~preFCs sec before FCs`'"@~DTR% DTR" More than 90 seconds before FCs:
Gas 50% @340 °F

Less than 90 seconds before FCs:
Gas 50% @340 °F, 50 sec before FCs

After FCs:
Gas 50% @12% DTR
{20Fresh Cut Grass|50Hay|80Baking Bread|100A Point} @~Y2~degmode Hay @340 °F


NOTES:
 
Event annotations apply only for 'Step' and 'Step+' Events settings
Anything between double quotes " will show only after FCs. Example: "~E1 @~DTR%"
Anything between single quotes ' will show only before FCs. Example: '~E1 @~degmode'
Anything between back ticks ` will show only within 90 seconds before FCs. Example: `~E1 `FCs~dFCs sec`
When combining back ticks with single or double quotes the back ticks should be inside the quotes.
Background event annotations can be seen during a roast when 'Annotations' is checked in the Profile Background window.
Simple scaling of the event value is possible. Use a single math operator ('*', '/', '+' or '-') immediately following the field name "E". For example:
'~E/10' will divide the E value by 10.
'~E+5' adds 5 to the the value of E.
Another style of annotations allows to replace an event's numeric value with a text string, known as a nominal value. One example where this can be useful is when an event is used to record sensory milestones. The value 20 might be used for 'Fresh Cut Grass' aroma, 50 for 'Hay', 80 for 'Baking Bread', and 100 to represent the 'A Point'.

This form of annotation must be enclosed in curly brackets '{}'. Entries are numeric values immediately followed by their nominal representation text. Entries are separated by the vertical bar '|'. The following Annotation string implements this example.
{~E|20Fresh Cut Grass|50Hay|80Baking Bread|100A Point}

Note that if the event value does not match any value in the Annotation definition a blank string will be returned. In the example above an event value of 30 will return a blank string. The easiest way to ensure these values match is to use Custom Buttons to for the Event.
When annotations overlap to the oint they can not be read, try reducing the value of the 'Allowed Annotation Overlap' found on the Annotations configuration page. The default value for this etting is 100%.