tufte-sparklines
Skill1 starsChanged 4 months agoMITView on GitHub
Use when a number, table, or dashboard metric needs its history shown in the space of a word; when embedding data graphics in prose, tables, or clinical, financial, sports, and scientific displays; when choosing sparkline aspect ratio, color, or anchoring method; or when arguing for higher information density against low-resolution charts and slides.
In this repository38 other files it gives its agents.
- tufte-aesthetics-and-techniqueSkill
- tufte-analytical-designSkill
- tufte-annotation-as-thinkingSkill
- tufte-causal-reasoning-in-graphicsSkill
- tufte-chartjunkSkill
- tufte-cognitive-styleSkill
- tufte-color-in-information-designSkill
- tufte-data-densitySkill
- tufte-data-forensicsSkill
- tufte-data-ink-ratioSkill
- tufte-data-mapsSkill
- tufte-disinformation-designSkill
- tufte-escaping-flatlandSkill
- tufte-evidence-corruptionSkill
- tufte-graphical-competenceSkill
- tufte-graphical-excellenceSkill
- tufte-graphical-integritySkill
- tufte-instructions-at-point-of-needSkill
- tufte-integration-of-modesSkill
- tufte-layering-and-separationSkill
- tufte-link-differentiationSkill
- tufte-listsSkill
- tufte-mapped-picturesSkill
- tufte-meetings-and-documentsSkill
- tufte-micro-macro-readingsSkill
- tufte-multifunctioning-elementsSkill
- tufte-narrative-and-sequenceSkill
- tufte-parallelismSkill
- tufte-presentation-of-artifactsSkill
- tufte-redundant-encodingSkill
- tufteSkill
- tufte-small-multiplesSkill
- tufte-space-time-graphicsSkill
- tufte-tables-and-text-tablesSkill
- tufte-typography-for-dataSkill
- tufte-visual-confectionsSkill
- tufte-visual-indexSkill
- tufte-visual-thinkingSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 215
If a sparkline is a word, a page of sparklines is sentences and paragraphs.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Sparklines: Intense, Simple, Word-Sized Graphics
Overview
A sparkline is a small, high-resolution graphic embedded directly in a sentence, a table cell, or beside a number — a "dataword" with the same intensity of visual distinctions as a printed word. It shows the full shape and history of a measure at word scale, not precise read-off values. The core problem it solves: a lone number or a recent-change column has no context, so readers over-weight the latest value (recency bias); a sparkline puts the current reading inside its entire past in the space of a word.
The chapter is titled Sparklines: Intense, Simple, Word-Sized Graphics in Beautiful Evidence (printed pp. 46–63 — chapter plate p. 46, title page p. 47). All page citations below are the book's printed page numbers.
The goal in one line: de-ceremonialize the data graphic. Tufte's stated end-point (p. 63) is that data graphics stop being a special occasion — a framed thing in a separate place, captioned "Fig. 17-B" on some slide. The variable that changes is frequency, not quality. Charts are events; sparklines are everywhere. Every design rule below follows from wanting data graphics to be as unremarkable as words.
§1. Definition and the Three Properties
Tufte builds the term from a clinical example. The most common data display is a noun plus a number (glucose 6.6). A single number gains meaning only in context, so replace it with a data-line of the patient's last 80 glucose readings sitting just left of the number. Because that free-floating line has no scale, it is dequantified — but the rightmost point is anchored to the printed number, and a red color accent ties the two representations of the most recent reading together. Add a gray band for the normal range and readings above/below the band horizon read instantly as elevated/reduced. Stack glucose, respiration, and temperature lines and you get fast parallel comparison across many variables and thousands of measurements.
"Sparklines are datawords: data-intense, design-simple, word-sized graphics." — Tufte, Beautiful Evidence, p. 47
Three properties, all non-negotiable:
| Property | What it means | What violates it |
| Data-intense | Hundreds of points packed per unit area at typographic resolution | Showing only 3–5 points in sparkline space |
| Design-simple | No axes, tick marks, gridlines, legends, or labels on the mark itself | Adding an axis, point labels, or a legend |
| Word-sized | Height ≈ surrounding text (roughly 1 line / x-height); a financial sparkline runs ~14 letterspaces wide | A mark taller than the type, or one needing its own framed area |
A sparkline is NOT:
- A shrunk full chart (full charts keep axes, labels, legends; sparklines omit all scaffold).
- A thumbnail (a thumbnail miniaturizes the whole design; a sparkline removes it).
- A summary statistic (it preserves the full sequence's shape, not one number).
The payoff phrase is writing with data graphics: a glucose sparkline reads like the sentence "the last 80 readings of glucose, compared to normal limits, with the most recent reading marked in red" (p. 49).
§2. The Typographic Argument — why word-sized works
Sparklines borrow the resolving power readers already use for type. Letterforms carry enormous fine detail, and Tufte quantifies it:
| Unit (11-pt text) | Visual distinctions made |
| Single letter | 20 to 200 |
| Word of 6–7 letters (average English word length) | 100 to 1,000 |
If routine reading operates at that resolution, data graphics can too — hence "small, intense, wordlike graphics" (p. 48). Words present an overall shape plus letter-by-letter detail and are read by quick recognition; sparklines present an overall shape plus local detail and are read the same way, just more carefully and slowly. A new sparkline form is intelligible to most readers by its second publication — "pretty good for a brand new word" (p. 54).
Worked example (p. 48): two fund sparklines, Vanguard 500 Index vs PIMCO Total Return, each tracking ~250 trading days and thus 249 daily changes, set inline for visually parallel comparison. A second inline mark packs 3 years of daily history (2,250 numbers — prices, changes, and trading volumes) for one insurance stock, bounded by 68.0 … 59.5.
§3. Historical Precedent — datawords are old
Three distinct lineages Tufte cites; keep them separate.
(a) Small graphics living inside text for centuries (p. 49):
- Sparkline-like space-fillers in a 1400 Book of Hours.
- Illuminated initials in medieval manuscripts.
- Email emoticons (
:-)). - Tiny imagelike symbols in railroad timetables.
- Chinese characters set together with English text.
(b) Galileo's Saturn, 1613 — the key precedent (p. 49): In Istoria e dimostrazioni intorno alle macchie solari, Galileo rendered Saturn's shape as two visual-noun sparklines set inside a sentence — one shape for the view through a perfect instrument, a different shape where optics fail — with no break between text and image. Tufte calls Galileo's word/image sentence one of the best analytical designs ever, and the founding precedent for embedding small detailed data-lines in prose.
(c) Sparkline-like high-resolution performances elsewhere (pp. 52, 58):
- E. J. Marey's physiological traces scratched by a pointer onto a smoked-carbon plotting field (1868).
- Swiss national topographic maps — fine contour lines flowing over a surface of place-names and elevation numbers.
- Albrecht Dürer's 1514 engraving (Saint Jerome in His Cell) — engraving lines so fine they are hard to reproduce cleanly even now.
- Multi-channel EEG traces.
These are not sparklines, but they prove that high-resolution, design-restrained linear marks embedded in a verbal/numeric context have served analysis for centuries. Tufte's verdict: all serious analytical graphics should be this good.
§4. The Density Argument
Type is a low-resolution medium; the eye is a high-resolution instrument. Sparklines exploit the gap.
| Display type | Maximum density | Source |
| Numeric / text table | ~300 characters/in² (~50 char/cm²) | p. 50 |
| Graphical display, eye discrimination limit | 0.1 mm → 250 distinctions/linear inch → ~60,000/in² (~10,000/cm²) | p. 50 |
| High-resolution graphics in practice | 1,200 numbers/in² (200 numbers/cm²) | p. 53 |
Two concrete, separate tables prove it — do not merge them:
Euro foreign-exchange table (p. 50): consuming only ~14 letterspaces per cell, the table reports 24 numbers accurate to 5 significant digits; the added sparklines show about 14,000 numbers readable to 1–2 significant digits. The trade is the whole point:
"The idea is to be approximately right rather than exactly wrong." — Tufte, Beautiful Evidence, p. 50
Popular mutual-funds table (p. 51): the redesigned sparkline version's data area is only 21% larger than the original numeric table's, yet it shows about 5,000 more numbers. (Typeface swap to Gill Sans helps recover the space.)
Scaling to publication:
- Newspaper finance: at 8 lines/inch, ~160 sparklines per column → ~400,000 additional daily graphical prices and changes per 5-column page (p. 51).
- Scientific journals: only ~3–5% of published graphics reach sparkline-like resolution today; by 2006 the median Nature/Science data graphic carried >1,000 numbers, and their published data densities doubled over the preceding decade as scientific measurement and resolution improved (p. 53, corroborated at p. 138) — Tufte argues this should be far higher.
- Overall: sparklines run at 5 to 100× the resolution of conventional graphics and tables (p. 63).
Density also fixes attention span: a year of daily history beside the current number reduces recency bias. Tables that show only current levels or recent changes reinforce it.
§5. Design Rules — Do / Don't
| Do | Don't |
| Strip all axes, ticks, gridlines | Add an x- or y-axis to "help" |
| Leave the mark unlabeled; anchor with surrounding numbers | Label individual data points |
| Use color only to name a data fact (endpoints, low/high, anomaly) | Use color decoratively or as category encoding |
| Keep height ≈ the surrounding type | Make the mark taller than the text line |
| Print single-color, or flat 2-color mix (magenta + yellow = red), or stochastic color | Use 4-color process for fine lines (gritty misregistration) |
| Use thin, lightweight data-lines | Use heavy strokes (moiré when stacked) |
| Drop frames, or use hairlines only | Use strong cell borders (the frame out-shouts the data) |
| Share one global scale when magnitudes must be compared | Let each sparkline auto-scale independently for a comparison task |
Functional color encoding (Tufte's own assignments):
- Red = oldest and newest value in a series (links the line to its flanking numbers).
- Blue = yearly low and high.
- Red whisker = a binary marker (e.g., the losing team was held scoreless).
- Gray band = the normal / reference range.
Rule: color names a specific data fact, never decorates.
§6. Quantification Without Labels — four anchoring methods
Word-size precludes overt scales, so re-attach values by context (p. 61):
- Implicit data-scaling box — flanking numbers form the scale, e.g.
1.1025 [sparkline] 1.1907 low 1.0783 high 1.2858; the line's vertical range is bounded by the printed low/high. Tufte calls this probably the best method. - Gray reference band — a shaded band marks normal limits; inside/outside reads without numbers (clinical glucose, EEG baseline).
- Color-linked endpoint numbers — matched colors tie exact points in the line to the precise numbers beside it.
- Global scale bars / labels — one shared scale governs a whole cluster of sparklines that must be compared.
Occasionally a sparkline is also scaled by very small inline type. Removing labels without one of these methods is a failure mode (see §13).
§7. Aspect Ratio
Width ÷ height is the single most consequential production choice; for all statistical graphics the perceived data-shape changes with it. Tufte's demonstration: six sparklines of identical data with the y-scale stepped up 25% per copy while x is held constant — the shape reads completely differently each time.
Tufte's worked aspect ratios:
| Sparkline | Aspect ratio (≈) |
| Financial exchange rate (12 months) | 5 : 1 |
| Full baseball season (162 games) | 20 : 1 |
| DNA chromosome sequence | 300 : 1 |
Cleveland's banking-to-45° rule (endorsed): slopes and velocities in a time-series are judged best when the hill-slopes average ~45° (uphill or downhill) over every cycle. Aim for a lumpy profile, not spiky (extreme vertical) or flat (near-zero vertical range). Tufte's sunspot example (yearly counts, 1749–1924): the 45°-banked version reveals that cycles rise fast and decline slowly — a fact invisible in the spiky rendering of the same data.
Practical procedure:
- Take the maximum reasonable vertical space allowed by the word-size constraint.
- Stretch the horizontal (time) axis until the profile is lumpy / averages ~45°.
- For multiples, compute one global aspect ratio by averaging across all data-lines, so series of different variance share a coherent scale.
- Let the analytical task override when it suggests something better.
§8. Variations — the catalog
| Variation | What it does | Tufte's example |
| Endpoint markers | Mark first/last value (red) → "where it started, where it is now" | Glucose / FX endpoints |
| Reference band | Gray band = normal range; inside/outside is the signal | Blood glucose, EEG |
| Anomaly highlight | One series colored against a muted stack to expose divergence | PIMCO (sole bond fund) in red vs the stacked pile of 9 stock funds (p. 51) |
| Binary data-whiskers | Up = win/occurrence, down = loss/non-occurrence; encodes several variables at once | Baseball: 2 sparklines carry 5 variables for 162 games (p. 54) |
| Variable-length whiskers | Whisker length signals intensity/degree, not just yes/no | Mouse-neuron firing in an intensity/frequency space (p. 55) |
| Dataword | A sparkline set inline as a word, no caption or figure label | "the win/loss sequence for the season's first 39 games" + the mark (p. 54) |
| Dotdashplot | Scatterplot whose frame axes become sparklines of the marginal distributions | VDQI pp. 133–135; 3-D version maps a hyperbolic paraboloid (p. 57) |
| Stacked / multiplied | Align many series on one time axis — "multiply a good design" | 2004 MLB: 6 paragraphs, 6 leagues, 30 teams; tables hold 500 digits; sparklines trace 4,856 win/loss outcomes (p. 54) |
| Bumps chart | Many interwoven rank-lines; line crossings = overtakes/rank changes | 800 interwoven sparklines, 3,252 contests, 12 seasons × 4 race-days, 66+ crews; red = "blades" (bumped up 4×), blue = one leader's 12-year thread (pp. 56–57) |
Binary-whisker encoding can stack channels onto one mark: direction = win/loss, presence of a horizontal line = home/away, a short red whisker = shutout, whisker length = margin — five variables in one 162-game ribbon.
§9. Domain Applications
Financial / economic
- One sparkline per currency or fund, daily prices for 12 or 65 months, set beside the numeric columns.
- Multiple sparklines per noun (price, % change, % change off index) — just as multiple numeric columns report different performance measures.
- Beats recency bias by showing the full year against the latest move.
Medical / clinical
- EEG: 8 channel traces (with a scale bar) opening on calm background and shifting into polyspike bursts (Kooi, 1971).
- Blood glucose with a gray normal-limits band; the line leaving the band is the signal.
- Neurophysiology: mouse-neuron rates across an intensity/frequency grid (Zhang et al., Nature 2003); mouse activity over 19 days on a 48-hour grid exposing circadian cycles (Hattar et al., Nature 2003).
- Why: monitoring produces a torrent of numbers; sparkline-scale graphics are essential to find and contextualize clinically relevant events (p. 52).
Scientific / genomic
- Human chromosome 7 map: 10 of 13 data-lines run at sparkline resolution; scale bar = 10 Mb = 10,000,000 base pairs; the sequence spans 153,000,000 base pairs (Hillier et al., Nature 2003).
- Two distinct mergesort figures (keep separate):
- p. 47 — a 9-step sequence (read down the columns) merge-sorting 5 different input-file types, depicting 4 variables and 18,000 numbers in small multiples (Sedgewick, Algorithms in C, p. 353).
- p. 53 — 7 sequential passes sorting a 200-element file in bottom-up mergesort (Sedgewick, Algorithms in C, p. 350).
Sports
- 162-game win/loss ribbons per team, stackable for league comparison.
- Competitive path = wins − losses (net games over .500) — the shape of the whole season's story.
General / cartography
- Analogous to Swiss topographic contour lines flowing over place-names and elevation numbers — images, numbers, and words in one field.
- Any process emitting sequential numeric or binary outcomes is a candidate.
§10. Layout & Scale of Many Sparklines
"The graphical idea here is make it wordlike and typographic." — Tufte, Beautiful Evidence, p. 63
If a sparkline is a word, a page of sparklines is sentences and paragraphs.
Density target for serious monitoring (financial trading, sporting events, control rooms, scientific/medical analysis, system administration):
- 500 sparklines on A3 paper (≈ 25 × 45 cm / 11 × 17 in).
- Data-equivalent of ~15 large computer screens or ~300 PowerPoint slides.
- Decisive advantage: data is adjacent in space, not stacked in time — the entire history sits in one eyespan.
Spatial adjacency enables: comparison, search, pattern-finding, exploration, replication, review — all without navigation.
§11. Production Reality & the Mode-Segregation Critique
Production today is hard (p. 61). An elegant sparkline currently needs three integrated programs: (1) page-layout, (2) graphic-design (full control of type, tables, linework), and (3) statistical-analysis (to generate hundreds of chartjunk-free lines for export). A quick-and-dirty path is to cut, paste, and resize existing data-lines down to sparkline scale. Once templates are built, ongoing production can run on automatic pilot.
Why the tooling fights you. Standard software segregates evidence by mode — word, number, image, graph — each in its own application. That contradicts the spirit of sparklines, which make no distinction among words, numbers, images, and graphics: it is all evidence. A good evidence system should be centered on the evidence-document, not on a bureaucracy of operating systems and single-mode apps. Tufte's precedent is the Xerox Star (1970s, Xerox PARC): users saw only documents and never a free-standing application — text, graphics, tables, and formulas were all edited inside documents. The intellectual architecture of a report should not mirror the chaos of the software that produced it.
§12. Resolution
| Medium | Resolution | Use |
| Paper / film / metal | >1,200 dpi, cheap | Best medium; required for high-density analytical work |
| Computer monitor | ~10% of paper | Coarse type and detail-poor sparklines; fine for exploration, not dense analysis |
Recommendation: for serious clinical / financial / scientific work, print on paper and use the screen for interactivity (navigation, selection). Combining the two is often the best of both.
§13. Named Failure Modes
FM1 — Moiré from equal figure/ground. Closely spaced lines vibrate when data-lines (figure) and the gaps (ground) are roughly equal in size, worst when they contrast strongly in value. Fix: lighten the data-line weight; mute data/background contrast.
FM2 — 4-color process grit. CMYK dots misregister, so thin lines and small type go gritty. Fix: single color, flat 2-color mix (magenta + yellow = red), or stochastic color.
FM3 — Strong frames. Heavy cell borders become the loudest element; the activated negative space between frames reads stronger than the data. Fix: drop frames or use hairlines. Test: "Do the prominent visual effects convey relevant content?" If the frame is the most prominent thing, it is wrong.
FM4 — Independent auto-scaling for comparison. Each series scaled to its own range makes a big flat series look like a small volatile one. Fix: one global scale when magnitude comparison is the task.
FM5 — Spiky or flat aspect ratio. Too tall = every wiggle looks dramatic; too wide = real variation is flattened away. Fix: bank to ~45° (Cleveland); aim lumpy.
FM6 — Dequantification without anchoring. Stripping labels but providing none of the four anchoring methods leaves no readable values. Fix: always pair with §6 method (implicit box, reference band, color-linked numbers, or global scale bar).
FM7 — Binary sparklines that show white space, not data. Poorly spaced win/loss whiskers read as accidental arrangements of white space rather than as the binary outcomes. Fix: re-space and re-weight whiskers so the outcome pattern, not the gaps, dominates.
§14. When to Use a Sparkline vs a Full Chart
| Condition | Sparkline | Full chart |
| Reader needs shape / trend | Yes | Yes |
| Reader needs precise read-off values | No | Yes |
| Graphic lives inside a table or sentence | Yes | No |
| Many series compared at once in compact space | Yes (stacked) | No (too large) |
| Standalone explanatory graphic for a slide | No | Yes |
| Hundreds of points per series | Yes (suits density) | Yes, but wasteful |
| Binary / sequential-outcome data | Yes (data-whiskers) | Rarely |
| Anomaly hunt across many series at once | Yes (stacked + color) | No |
| Reader new to the form | Works by 2nd exposure (dataword) | Yes |
Sparklines push statistical graphics up to the routine resolving power of the human eye-brain system, so data graphics stop being a framed special occasion ("Fig. 17-B" on a slide) and become everywhere — giving us a straightforward, contextual look at intense evidence and a chance to be approximately right rather than exactly wrong (p. 63).
§15. The Resolution Upgrade You Already Have (p. 63)
Tufte closes the chapter with a thought experiment worth repeating whenever a team is waiting on better tooling.
Imagine new software, or a new display technology, that hugely improved the resolution of data graphics — how valuable would that be? Then observe: sparklines deliver exactly that improvement by design, at 5 to 100× the resolution of conventional graphics and tables, through direct, public, open-source methods rather than through a vendor's roadmap.
The reframe: adopting sparklines is a refusal of the tooling-upgrade treadmill. It is a design decision, not a procurement decision, and it is available today at zero technology cost. This pairs directly with §11's critique of single-mode applications — the constraint that keeps most displays low-resolution is the application architecture, not the screen, the printer, or the eye.
| Waiting for | Available now |
| A vendor to ship a higher-resolution charting feature | 5–100× resolution from a design change you can make this week |
| A new display technology | Paper at >1,200 dpi, already on the desk (§12) |
| A tool that integrates words, numbers, and images | Sparklines, which make no distinction among them by construction |
Source: Beautiful Evidence, Edward Tufte — chapter "Sparklines: Intense, Simple, Word-Sized Graphics," printed pp. 46–63.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

