Reading computed values in prose

A number the canvas computes is read from the construct with a {{…}} expression, and rounded for the claim.

On this page

#Computed numbers in prose

A number produced by a fit, an integral, a control or any other construct that publishes one is read from the construct rather than typed into the prose. A typed number is right at the moment it was read off the screen and at no other: an edit to the data, a change of model or a moved slider leaves the sentence asserting what the picture beside it contradicts.

#Reading one in prose

A {{…}} expression names the construct and the member, in prose or in any rich-text attribute, so a sentence and a mark's own label quote the same number:

The fitted slope is {{round(#trend.slope, 2)}}, and the line explains
{{round(100 * #trend.r2, 1)}}% of the variation.

Derived attributes lists what each construct publishes, and Expressions how a live number is shaped as text.

#Rounding a live number

A live number shows about four significant figures unless the expression rounds it. Round for the claim being made rather than for the width of the number: a slope quoted to two decimals asserts that the second decimal means something, and two quantities printed to too few figures can read as equal when they are not.

A live value and a typed approximation of it in one sentence — about 0.34 beside the reading itself — bring back the disagreement reading the value was meant to prevent.

Last updated