liveBook · Manning

Context

As explained in Data Storytelling with Altair and AI

Textual context is written material that provides background or explanation around a data visualization.

Context is the surrounding information that lets an audience understand a visualization: relevant events, circumstances, explanations, text, images, symbols, and sources. It turns an extracted pattern into knowledge by answering the question “Why does this situation happen?” rather than leaving readers with a chart alone. section 1.4.2 section 7.1

Build context after identifying the main point. Use it as the story’s background to set the scene and raise interest; then use a call to action to invite next steps. An exploratory chart may reveal an insight, but an explanatory visualization supplies the background and motivation needed to communicate it to a particular audience. section 5.2.1 section 5.1.2

Choose context that explains the insight and suits the audience:

  • Add factual explanations of conditions, events, or comparisons that account for a pattern. section 1.4.2 section 2.3.2
  • Use commentary before the insight to establish background; use annotations to attach an explanation directly to the chart. section 7.1 section 7.3
  • Reinforce a message with visual cues such as highlights, images, or a baseline when they clarify why selected values matter. section 4.5.2
  • Place context before the main point—at the top, left, or within the chart. A top subtitle can provide an overview or credit a data source. section 8.6 section 8.6.1

Explain participation, not just percentages

A pet-event chart shows far more cats than dogs. The number of advertised websites supplies useful context: 150 cat sites versus 28 dog sites. Calculating participants per advertised website gives rates of 7.59 for cats and 4.64 for dogs, helping explain the difference. A title, header, and pet images then make that context easier to read. section 1.4.2

Annotate a tourism trend

Portugal’s tourist arrivals rose by more than 200% over 25 years. A chart annotation attributes this increase to the introduction of low-cost flights, while a small passenger-traffic line chart provides supporting context. In Altair, create annotation text with mark_text(), build the supporting trend with mark_line(), and combine the charts. section 2.3.2

Textual context must be calibrated to readers. Adults may not need an explanation of money, while children may need denominations and the monetary system explained. For generated commentaries or annotations, specify a ChatGPT role, audience, topic, and text type; iterate by adjusting these elements until the wording fits. section 7.1 section 7.3

Table 1.3 Data related to pets involved in the event, with a focus on the participants’ rates
Pet
Number of Participants
Percentage
Number of Advertised Websites
Participants-to-website rate (# of participants/#
of websites)
Cat
1138
88.56
150
7.59
Dog
130
10.12
28
4.64

Compare raw participation counts, advertised-site counts, and participant-to-website rates to see how a derived measure provides explanatory context. section 1.4.2

How Data Storytelling with Altair and AI covers it

How deep it goes
Defines context, demonstrates textual and visual forms, and provides Altair and ChatGPT procedures for adding it.
Examples
Uses pet participation rates, Portugal tourism and low-cost flights, sports baselines, homelessness, and fake-news charts.
What it assumes
Assumes an extracted chart insight while teaching context as the next step toward an explanatory data story.
What you can do after
Apply it via Altair and ChatGPT to add audience-tailored annotations, subtitles, supporting charts, and visual cues.
How it connects
Connects context with the DIKW pyramid, data storytelling, annotations, commentaries, call to action, and audience.

Also explained in

Compare how 18 books explain context →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Data Storytelling with Altair and AI. The section links point to the parts of the book it draws on.