Chart labels, styles and units

Chart titles and exact-series labels are optional when model metadata provides a clear description.

Label and style exact lines

- chart:
    title: Inflation targets
    series:
      - variable: INFX(USA)
        label: USA
        style:
          color: blue
          line: solid
      - variable: INFX(CHN)
        label: China
        style:
          color: "#d62728"
          line: dot

Always quote a hexadecimal colour beginning with #, otherwise YAML treats it as a comment. Supported lines are solid, dot, dash, longdash, dashdot and longdashdot.

Standalone chartpack YAML uses the literal key color. Setup YAML uses colour in its concise chart declaration.

On a series-delta chart, an exact series’ color controls the bar colour. Line styles have no effect on bars.

For a short explanation beneath a chart, use caption on the chart. To print values on supported plots, use show_labels: true. Both need version: "1.4.0"; see chart display options.

Keep units compatible

Series sharing an axis must have the same units. Paired scatter is the exception that allows different units on X and Y, with common units required separately on each axis. Do not put a level index and a percentage-point deviation on the same axis. Use separate charts:

- chart:
    title: Inflation
    series:
      - variable: INFL(USA)
- chart:
    title: Real GDP
    series:
      - variable: GDPR(USA)

Use titles and captions that name the economic measure, comparison and units. For example, “Real GDP: percentage deviation from baseline” differs from “Inflation: percentage-point deviation from baseline”. Changing an axis title or caption does not convert the numbers or their units. If a chartpack is used for both levels and deviations, avoid a fixed caption that describes only one of them.

Heatmaps use their colour scale rather than series colours. Small multiples keep a common colour for each group across panels. Waterfalls use colours for increases, decreases and totals; per-series colours and line styles have no effect. color_by_sign: true overrides series colours on comparison bars.