Almanac: An API for Recommending Text Annotations For Time-Series Charts Using News Headlines
Abstract: Authors often add text annotations to charts to provide additional context for visually prominent features such as peaks, valleys, and trends. However, writing annotations that provide contextual information, such as descriptions of temporal events, often requires considerable manual effort. To address this problem, we introduce Almanac, a JavaScript API that recommends annotations sourced from the New York Times Archive of news headlines. Almanac consists of two independent parts: (1) a prominence feature detector and (2) a contextual annotation recommender. We demonstrate the utility of the API using D3.js and Vega-Lite to annotate a variety of time-series charts covering many different data domains. Preliminary user feedback shows that Almanac is useful to support the authoring of charts with more descriptive annotations.
- Persalog: Personalization of news article content. In Proceedings of the 2017 CHI Conference on Human Factors in Computing Systems, CHI ’17, p. 3188–3200. Association for Computing Machinery, New York, NY, USA, 2017.
- Towards data-driven generation of visualizations for automatically generated news articles. In Proceedings of the 22nd International Academic Mindtrek Conference, Mindtrek ’18, p. 100–109. Association for Computing Machinery, New York, NY, USA, 2018.
- Ares. California wildfires (2013-2020). https://www.kaggle.com/datasets/ananthu017/california-wildfire-incidents-20132020, 2020.
- D3 Data-Driven Documents. IEEE Transactions on Visualization and Computer Graphics, 17(12):2301–2309, Dec. 2011. doi: 10 . 1109/TVCG . 2011 . 185
- J. Brown. Simpsons viewership (1989-2016). https://www.kaggle.com/datasets/jonbown/simpsons-episodes-2016, 2022.
- NewsViews: an automated pipeline for creating custom geovisualizations for news. In Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, pp. 3005–3014. ACM. doi: 10 . 1145/2556288 . 2557228
- G&R. Presidential approval. https://www.gallup.com/analytics/213617/gallup-analytics.aspx, 2018.
- Communicating with interactive articles. Distill, 2020.
- Analysis of Faces in a Decade of US Cable TV News. In Proceedings of the 27th ACM SIGKDD Conference on Knowledge Discovery & Data Mining, KDD ’21, p. 3011–3021. Association for Computing Machinery, New York, NY, USA, 2021.
- S. Huber. Persistent homology in data science. In 3rd Int. Data Sci. Conf. (iDSC ’20), Data Science – Analytics and Applications. Dornbirn, Austria (virtual), May 2020.
- J. Hullman and N. Diakopoulos. Visualization rhetoric: Framing effects in narrative visualization. IEEE Transactions on Visualization and Computer Graphics, 17(12):2231–2240, 2011.
- Contextifier: Automatic generation of annotated stock visualizations. In Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI ’13, p. 2707–2716. Association for Computing Machinery, New York, NY, USA, 2013. doi: 10 . 1145/2470654 . 2481374
- A. V. Inc. Alpha vantage stock api. https://www.alphavantage.co/documentation/, 2022.
- E. Kandogan. Just-in-time annotation of clusters, outliers, and trends in point-based data visualizations. In 2012 IEEE Conference on Visual Analytics Science and Technology (VAST), pp. 73–82, 2012.
- Towards Understanding How Readers Integrate Charts and Captions: A Case Study with Line Charts. Association for Computing Machinery, New York, NY, USA, 2021.
- Autotator: Semi-automatic approach for accelerating the chart image annotation process. In Proceedings of the 2019 ACM International Conference on Interactive Surfaces and Spaces, ISS ’19, p. 315–318. Association for Computing Machinery, New York, NY, USA, 2019. doi: 10 . 1145/3343055 . 3360741
- Generating personalized spatial analogies for distances and areas. In Proceedings of the 2016 CHI Conference on Human Factors in Computing Systems, CHI ’16, pp. 38–48. ACM, New York, NY, USA, 2016.
- A. Kirmse and J. de Ferranti. Calculating the prominence and isolation of every mountain in the world. Progress in Physical Geography: Earth and Environment, 41(6):788–802, 2017.
- N. Kong and M. Agrawala. Perceptual interpretation of ink annotations on line charts. In Proceedings of the 22nd annual ACM symposium on User interface software and technology, pp. 233–236. ACM, 2009.
- N. Kong and M. Agrawala. Graphical overlays: Using layered elements to aid chart reading. IEEE Transactions on Visualization and Computer Graphics, 18(12):2631–2638, 2012.
- A. Lundgard and A. Satyanarayan. Accessible visualization via natural language descriptions: A four-level model of semantic content. IEEE Transactions on Visualization and Computer Graphics, 28:1073–1083, 2022.
- Introduction to Information Retrieval. p. 581, 2009.
- Observable. Observable notebooks. https://observablehq.com/, 2022.
- Chartaccent: Annotation for data-driven storytelling. 2017 IEEE Pacific Visualization Symposium (PacificVis), pp. 230–239, 2017.
- Vega-Lite: A Grammar of Interactive Graphics. p. 10.
- E. Segel and J. Heer. Narrative visualization: Telling stories with data. IEEE Transactions on Visualization and Computer Graphics, 16(6):1139–1148, 2010. doi: 10 . 1109/TVCG . 2010 . 179
- V. Setlur and H. Chung. Semantic resizing of charts through generalization: A case study with line charts. In 2021 IEEE Visualization Conference, IEEE VIS 2021 - Short Papers, New Orleans, LA, USA, October 24-29, 2021, pp. 1–5. IEEE, 2021.
- Tableau. Tableau dashboard extension. https://tableau.github.io/extensions-api/docs/trex_overview.html.
- N. Y. Times. New york times archive developer’s api. https://developer.nytimes.com/docs/archive-product/1/overview, 2022.
- Wikipedia. Wikipedia events. https://en.wikipedia.org/wiki/Category%3aEvents, 2022.
Paper Prompts
Sign up for free to create and run prompts on this paper using GPT-5.
Top Community Prompts
Collections
Sign up for free to add this paper to one or more collections.