Seaborn figure-level vs axes-level in Matplotlib

Introduction

Seaborn helps you make charts easily. Figure-level and axes-level functions decide how much control you get over the chart layout.

When you want a quick full chart with titles and legends ready.

When you want to combine multiple plots in one figure.

When you want to customize parts of the chart like axes or colors.

When you want to create complex layouts with multiple plots.

When you want to add extra decorations like titles or legends easily.

Syntax

Matplotlib

Figure-level function:
seaborn.function_name(data=..., x=..., y=..., ...)

Axes-level function:
ax = matplotlib.pyplot.subplot()
seaborn.function_name(data=..., x=..., y=..., ax=ax, ...)

Figure-level functions create the whole figure and manage layout automatically.

Axes-level functions draw on a specific part (axes) of an existing figure, giving more control.

Examples

This is a figure-level call that creates a full scatter plot with axes and legend.

Matplotlib

import seaborn as sns
sns.scatterplot(data=df, x='age', y='height')

This uses an axes-level function to draw the scatter plot on a specific axes.

Matplotlib

import matplotlib.pyplot as plt
fig, ax = plt.subplots()
sns.scatterplot(data=df, x='age', y='height', ax=ax)
plt.show()

Sample Program

This code shows both figure-level and axes-level histograms of penguin flipper lengths by species. The first plot is made by seaborn managing the figure. The second plot uses matplotlib to create the figure and axes, then seaborn draws on that axes.

Matplotlib

import seaborn as sns
import matplotlib.pyplot as plt

# Sample data
penguins = sns.load_dataset('penguins')

# Figure-level plot: creates figure and axes automatically
fig1 = sns.histplot(data=penguins, x='flipper_length_mm', hue='species', multiple='stack')
plt.title('Figure-level: Flipper Length Distribution')
plt.show()

# Axes-level plot: create figure and axes first, then plot on axes
fig2, ax2 = plt.subplots()
sns.histplot(data=penguins, x='flipper_length_mm', hue='species', multiple='stack', ax=ax2)
ax2.set_title('Axes-level: Flipper Length Distribution')
plt.show()

Important Notes

Figure-level functions include: relplot, catplot, displot, pairplot, jointplot.

Axes-level functions include: scatterplot, histplot, boxplot, violinplot, kdeplot.

Use figure-level when you want quick plots with built-in layout.

Use axes-level when you want to combine plots or customize layout deeply.

Summary

Figure-level functions create the whole figure and manage layout automatically.

Axes-level functions draw on specific axes you create, giving more control.

Choose figure-level for quick, simple plots; axes-level for detailed customization.

Practice

1. Which of the following best describes a figure-level function in Seaborn?

easy

A. It creates a complete plot including figure and axes automatically.

B. It only modifies existing axes without creating a new figure.

C. It is used to customize axis labels after plotting.

D. It requires manual creation of figure and axes before plotting.

Solution

1. Step 1: Understand figure-level function role

   Figure-level functions in Seaborn create the entire plot including figure and axes automatically.

2. Step 2: Compare with axes-level functions

   Axes-level functions only draw on existing axes and do not create the figure.

3. Final Answer:

   It creates a complete plot including figure and axes automatically. -> Option A

4. Quick Check:

   Figure-level = creates full plot [OK]

Hint: Figure-level functions create whole plots; axes-level modify existing axes [OK]

Common Mistakes:

• Confusing figure-level with axes-level functions
• Thinking figure-level functions require manual axes creation
• Assuming axes-level functions create figures automatically

2. Which of the following is the correct way to use an axes-level function in Seaborn on existing axes?

easy

A. sns.scatterplot(data=df, x='age', y='height')

B. sns.scatterplot(ax=ax, data=df, x='age', y='height')

C. sns.relplot(data=df, x='age', y='height')

D. sns.relplot(ax=ax, data=df, x='age', y='height')

Solution

1. Step 1: Identify axes-level function usage

   Axes-level functions like scatterplot can accept an ax parameter to plot on existing axes.

2. Step 2: Check options for correct syntax

   sns.scatterplot(ax=ax, data=df, x='age', y='height') correctly passes ax=ax to scatterplot, an axes-level function.

3. Final Answer:

   sns.scatterplot(ax=ax, data=df, x='age', y='height') -> Option B

4. Quick Check:

   Axes-level functions use ax= parameter [OK]

Hint: Axes-level functions accept ax= parameter to plot on existing axes [OK]

Common Mistakes:

• Using figure-level functions with ax= parameter (not supported)
• Confusing relplot (figure-level) with scatterplot (axes-level)
• Omitting ax= when plotting on existing axes

3. What will the following code output?

import seaborn as sns
import matplotlib.pyplot as plt

df = sns.load_dataset('tips')
fig, ax = plt.subplots()
sns.scatterplot(data=df, x='total_bill', y='tip', ax=ax)
plt.title('Scatterplot on existing axes')
plt.show()

medium

A. A scatterplot of total_bill vs tip on a new figure with default title

B. An empty plot with no points

C. A scatterplot of total_bill vs tip on the existing axes with custom title

D. An error because scatterplot cannot accept ax parameter

Solution

1. Step 1: Analyze code creating figure and axes

   The code creates a figure and axes with plt.subplots() and stores axes in ax.

2. Step 2: Understand scatterplot with ax parameter

   scatterplot is axes-level and plots on the given ax. Title is set on the figure.

3. Final Answer:

   A scatterplot of total_bill vs tip on the existing axes with custom title -> Option C

4. Quick Check:

   Axes-level plot on existing axes = scatterplot with ax= [OK]

Hint: Axes-level plots use ax= to draw on existing axes [OK]

Common Mistakes:

• Expecting scatterplot to create new figure automatically
• Thinking ax= causes error with scatterplot
• Assuming title applies only to figure-level plots

4. Identify the error in this code snippet:

import seaborn as sns
import matplotlib.pyplot as plt

df = sns.load_dataset('tips')
fig, ax = plt.subplots()
sns.relplot(data=df, x='total_bill', y='tip', ax=ax)
plt.show()

medium

A. plt.show() must be called before relplot

B. plt.subplots() is missing required arguments

C. DataFrame 'df' is not loaded correctly

D. relplot does not accept ax parameter; it creates its own figure

Solution

1. Step 1: Check relplot function parameters

   relplot is a figure-level function and does not accept an ax parameter.

2. Step 2: Understand error cause

   Passing ax=ax to relplot causes an error because it manages figure creation internally.

3. Final Answer:

   relplot does not accept ax parameter; it creates its own figure -> Option D

4. Quick Check:

   Figure-level functions ignore ax= and raise error if given [OK]

Hint: Figure-level functions like relplot do NOT accept ax= [OK]

Common Mistakes:

• Passing ax= to figure-level functions
• Confusing relplot with scatterplot usage
• Assuming plt.subplots() is incorrect here

5. You want to create a figure with two different plots side by side: a histogram and a scatterplot. Which approach correctly uses Seaborn's figure-level and axes-level functions together?

hard

A. Use sns.histplot() on one axes and sns.scatterplot() on another axes created by plt.subplots().

B. Use sns.relplot() twice, each creating its own figure, then combine figures manually.

C. Use sns.histplot() with ax= parameter and sns.relplot() without ax= on the same axes.

D. Use sns.relplot() with ax= parameter for both plots on shared axes.

Solution

1. Step 1: Understand figure-level vs axes-level functions

   relplot is figure-level and creates its own figure; histplot and scatterplot are axes-level and can plot on existing axes.

2. Step 2: Plan side-by-side plots

   Creating subplots with plt.subplots() and plotting axes-level functions on each axes allows side-by-side plots in one figure.

3. Step 3: Evaluate options

   Use sns.histplot() on one axes and sns.scatterplot() on another axes created by plt.subplots(). correctly uses axes-level functions on subplots. Options A, B, and D misuse figure-level functions or ax= parameter.

4. Final Answer:

   Use sns.histplot() on one axes and sns.scatterplot() on another axes created by plt.subplots(). -> Option A

5. Quick Check:

   Axes-level functions + subplots = combined figure [OK]

Hint: Use axes-level functions with plt.subplots() for combined plots [OK]

Common Mistakes:

• Trying to use relplot with ax= parameter
• Using multiple figure-level functions expecting one figure
• Mixing figure-level and axes-level functions on same axes