How to implement encoding in Altair

In Altair, encoding is a fundamental concept used to map data attributes to visual properties of a chart, such as position, color, size, shape, and more. The encoding process is a key part of creating informative data visualizations. To implement encoding in Altair, we typically define the encoding within the alt.Chart object using the encode() method.

Encoding in Altair

Here’s a step-by-step guide to implementing encoding in Altair:

  1. Importing Altair: We import the Altair library in our Python code.

import altair as alt
Importing Altair

  1. Loading data: We need a dataset to visualize. We can use pandas or other data manipulation libraries to load our data.

import pandas as pd
# Load your data into a Pandas DataFrame
data = pd.read_csv('your_data.csv')
Loading data

  1. Creating an Altair chart: We use the alt.Chart function to create the base chart object. We pass our data to this function.

chart = alt.Chart(data)
Creating a chart

  1. Defining encoding: The .encode() method maps data attributes to visual properties. We can chain the .encode() calls to specify multiple encodings. The syntax for encoding is as follows:

chart.encode(
    x='X-Axis Data Attribute',
    y='Y-Axis Data Attribute',
    color='Color Data Attribute',
    size='Size Data Attribute',
    tooltip=['Tooltip1', 'Tooltip2']
)
Encoding the data

  • x, y: Map data attributes for the x and y positions on the chart

  • color: Map data attributes for color

  • size: Map data attributes for size

  • tooltip: Map data attributes for the tooltip for interactivity (multiple attributes can be included in a list)

  1. Specifying chart type: We specify the type of chart we want to create by chaining a chart method, such as .mark_bar(), .mark_point(), .mark_line(), etc., to the chart object.

  2. Display the chart: Finally, we display the chart. There are different methods for rendering the chart for using Altair in a different environment.

Example

Let’s create a scatter plot with X values on the x-axis, Y values on the y-axis, and color-coded points based on the Color attribute.

import altair as alt
import pandas as pd
import os
data = pd.DataFrame({
    'X': [1, 2, 3, 4, 5],
    'Y': [10, 20, 15, 30, 25],
    'Color': ['A', 'B', 'A', 'B', 'A'],
    'Size': [100, 200, 150, 300, 250],
    'Tooltip': ['Point 1', 'Point 2', 'Point 3', 'Point 4', 'Point 5']
})
chart = alt.Chart(data).mark_point().encode(
    x='X',
    y='Y',
    color='Color',
    size='Size',
    tooltip='Tooltip'
)
chart.save('chart.html')
os.system('cat chart.html')

Explanation

  • Lines 1–3: We import Altair and the necessary libraries.

  • Lines 5–11: We create a pandas DataFrame named data with three columns: X, Y, and Color. It contains dummy data.

  • Lines 13–19: We initialize an Altair chart using the data DataFrame as the data source. We configure the chart with the .mark_point() method specifying that the chart should use points for data representation. We encode the data with .encode(x='X', y='Y', color='Color'). It defines how the data attributes should be visualized. In this case, X is mapped to the x-axis, Y to the y-axis, and Color determines the color of the points. The size channel maps a data attribute to the size of the visual elements (points). The tooltip encoding channel specifies the text that appears in a tooltip when we hover over a data point in the chart.

  • Line 20: We save the chart using chart.save('chart.html'). It exports the chart to an HTML file named chart.html.

  • Line 21: We display the chart on the console.

This code essentially creates a scatter plot using Altair, saves it as an HTML file, and then shows its content in the console.

Unlock your potential: Data visualization with the Altair series, all in one place!

To continue your exploration of data visualization using the Altair library, check out our series of Answers below:

Free Resources

Copyright ©2025 Educative, Inc. All rights reserved