Annotations
  • 01 Sep 2023
  • 3 Minutes to read
  • Dark
    Light

Annotations

  • Dark
    Light

Article summary

Overview

Annotations are used to add more context to a chart by adding a layer of content. Each annotation layer can contain one or more annotations.

The types of annotation layers available include:

  • Time Series: Enables you to add additional time series to the chart. The source is another line chart that can come from different data sets.
  • Interval: Enables you to add marked date intervals to represent something. The annotation source can be:
    • Superset Annotation (see below); or,
    • Table: Table Chart that includes Start & End Dates to mark date intervals.
  • Event: Similar to interval, but one date.
  • Formula: Formula based on depend variable x that is the milliseconds since Epoch Date (1 Jan 1970).
Annotations

Annotations can be difficult to apply and display. If your annotation is not displaying correctly, check the instructions below or try recreating your chart.


Interval Annotation

Interval annotation will mark time blocks on the chart. The source data of Interval annotation can be defined via the Annotation feature or extracted from a table with start and end dates.

Let's learn how to define annotations within a layer and then apply them to a line chart. In the walkthrough below, we will highlight the different generations on a birth name trend chart from 1965 to 2008.

Create Annotation Layer

In the Toolbar, hover your cursor over Settings and then select Annotation Layers.

Select_Annotations

Select + Annotation Layer.

Add_Annotation_Layer

The Add annotation layer panel appears.

In the Annotation Layer Name field, enter a name for the new layer. Next, in the Description text-entry field, enter a brief description of the layer.

When done, select Add.

New_Annotation_Layer

The Annotation screen appears. Now we can start adding annotations!

Blank_Annotations

Add Annotations

We will create three annotations based on the following generational categories:

  • Gen X (1965-1980)
  • Millennials (1981-1996)
  • Gen Z (1997-2012)

Start by selecting + Annotation.

The Add annotation panel appears.

In the Annotation Name field, enter a memorable name for the annotation.

In the Date field, define starting & ending dates and, optionally, times. In this example, we are selecting the interval from January 1 1965 to December 31 1980.

In the Description field, enter a brief description of the annotation and then select Add.

Add_Gen_X

The new annotation appears in the list.

Annotation_List

For this walkthrough, we have repeated the process to add Millennials and Gen Z:

Completed_Annotations

Add Annotation Layer to a Chart

In this walkthrough we will use the Birth Name Trends chart as our base and then apply our annotation layer on top of that.

Open the chart, scroll down to the Annotations and Layers section, and then select + Add annotation layer.

Start by configuring options in the Layer configuration section.

In the Name field, enter a name for the chart-specific layer.

In the Annotation Layer Type field, select Interval and then, in the Annotation Source field, select Superset annotation.

Lastly, in the Annotation Layer field, select the annotation layer you just created.

In the Display cofiguration section, feel free to experiment with different styles to achieve the look & feel that you like.

When done, select Apply to see your configuration applied on the chart. To finalize, select OK.

Add_New_Layer

The intervals are highlighted and labeled on the chart.

Interval_Highlighted

Event Annotation

Event annotations work in the same way as Intervals.

In this example, we created a series of annotations based on major historical events:

List_of_Events2

...we then configured the annotation layer for the chart.

During the configuration, note that the Annotation Layer Type field is now set to Event.

Configure_Events

Select OK and view the chart:

Events1

Create and manage time annotations with Google Sheet

You can easily create and modify all your time annotations from a Google Sheet and apply them to Preset.

First create a Google Sheet with all your time Events and Intervals

image.png

Then connect this sheet to preset and create a dataset

You can now create two tables charts, one for Events and one for Intervals

image.png

image.png

Now, let’s add this data as Annotation Layers to a Chart
We’ll be using a Line Chart created with the Vehicle Sales example data.

When configuring the Annotation Layer, we’ll select Table as the Annotation Source, and then find the table chart we have just created.

This is the configuration for the Interval Annotation Layer:
image.png

This the configuration for the Event Annotation Layer:
image.png

You can now add those annotations to any of your charts.
Here is an example with a line chart:
image.png

If you add new events to your dataset, the annotations will be added to the charts, which makes it convenient and easy to manage in a central place


Was this article helpful?

What's Next