Further Reading: Altair
Tier 1: Essential Reading
Altair Documentation. altair-viz.github.io The official Altair documentation. Organized by chart type with interactive examples. The tutorial section is the best introduction to Altair's grammar; the gallery is a showcase of what is possible.
Vega-Lite Documentation. vega.github.io/vega-lite/docs/ The specification for the language Altair generates. Worth reading even as an Altair user — the Vega-Lite docs explain concepts (like selections, transforms, and composition) in more depth than the Altair docs. Essential reference.
Wilkinson, Leland. The Grammar of Graphics. 2nd ed. Springer, 2005. The theoretical foundation for grammar-of-graphics visualization. Academic and dense, but the core ideas are all there. Not required reading for Altair users, but valuable if you want to understand the history and theory.
Tier 2: Recommended Specialized Sources
Wickham, Hadley. ggplot2: Elegant Graphics for Data Analysis. 3rd ed. Springer, 2016. Wickham's practitioner-oriented book on ggplot2. Covers the layered grammar of graphics with many examples. The concepts transfer directly to Altair; only the syntax differs. Freely available at ggplot2-book.org.
Wickham, Hadley, and Garrett Grolemund. R for Data Science. 1st ed. O'Reilly, 2016. 2nd ed. with Mine Çetinkaya-Rundel, 2023. The definitive introduction to the tidyverse and ggplot2. Read the visualization and data-manipulation chapters even if you do not plan to use R — the conceptual material transfers to Python and Altair. Freely available at r4ds.hadley.nz.
Satyanarayan, Arvind, Dominik Moritz, Kanit Wongsuphasawat, and Jeffrey Heer. "Vega-Lite: A Grammar of Interactive Graphics." IEEE Transactions on Visualization and Computer Graphics 23, no. 1 (2017): 341-350. The paper introducing Vega-Lite, from the UW Interactive Data Lab. Describes the design decisions and evaluates the resulting tool. Freely available from the UW lab.
VanderPlas, Jake et al. "Altair: Interactive Statistical Visualizations for Python." Journal of Open Source Software 3, no. 32 (2018): 1057. The short JOSS paper introducing Altair. Useful for a quick overview of the library's motivation and design.
Wickham, Hadley. "A Layered Grammar of Graphics." Journal of Computational and Graphical Statistics 19, no. 1 (2010): 3-28. Wickham's formalization of the layered grammar of graphics, published in an academic journal. The theoretical companion to ggplot2's design. Useful for understanding why Altair and ggplot2 are structured the way they are.
Tier 3: Tools and Online Resources
| Resource | URL / Source | Description |
|---|---|---|
| Altair example gallery | altair-viz.github.io/gallery/ | The official Altair example gallery. Hundreds of example charts with complete code. Browse when you are looking for inspiration or need to recall an idiom. |
| Vega-Lite example gallery | vega.github.io/vega-lite/examples/ | The Vega-Lite gallery, for when you want to see what is possible at the JSON-spec level. Useful for understanding capabilities Altair does not expose directly. |
| Plotnine | plotnine.readthedocs.io | A Python port of ggplot2 that produces matplotlib-based output. An alternative grammar-of-graphics option for Python users who prefer ggplot2 syntax and do not need interactivity. |
| VegaFusion | vegafusion.io | A Rust/Arrow-based data transformer for Vega-Lite that removes the 5000-row limit. Install with pip install vegafusion and enable with alt.data_transformers.enable("vegafusion"). |
| Observable | observablehq.com | A JavaScript notebook platform that uses Vega-Lite extensively. Worth exploring to see grammar-of-graphics in a JavaScript context. |
| The Vega editor | vega.github.io/editor/ | An interactive JSON editor where you can write Vega-Lite specs and see them render in real time. Useful for debugging and for understanding how Altair translates to Vega-Lite. |
| Altair GitHub repository | github.com/altair-viz/altair | The Altair source code and issue tracker. Check here for recent changes and open issues. |
A note on reading order: If you want one additional source, read the Altair documentation's tutorial section — it is written for beginners, has interactive examples, and covers most of what you need for day-to-day Altair work. For theoretical depth, Wickham's "A Layered Grammar of Graphics" paper is short and authoritative. For practical ggplot2-to-Altair transfer, Wickham's ggplot2 book is the best single source.