GridSpec for complex layouts in Matplotlib

Introduction

GridSpec helps you arrange multiple plots in a grid with different sizes and positions. It makes complex layouts easy to create.

You want to show several charts in one figure with different sizes.

You need to place one big plot next to smaller plots.

You want to control spacing between plots precisely.

You want to combine bar charts and line charts in one figure.

You want to create a dashboard-like layout with multiple plots.

Syntax

Matplotlib

import matplotlib.pyplot as plt
from matplotlib.gridspec import GridSpec

fig = plt.figure()
gs = GridSpec(nrows, ncols, figure=fig)

ax1 = fig.add_subplot(gs[row_start:row_end, col_start:col_end])

GridSpec divides the figure into a grid of rows and columns.

You select where each plot goes by slicing the grid with row and column ranges.

Examples

This creates a 2x2 grid. The bottom plot spans both columns.

Matplotlib

gs = GridSpec(2, 2, figure=fig)
ax1 = fig.add_subplot(gs[0, 0])  # Top-left plot
ax2 = fig.add_subplot(gs[0, 1])  # Top-right plot
ax3 = fig.add_subplot(gs[1, :])  # Bottom plot spanning two columns

Here, plots cover different parts of the grid for a custom layout.

Matplotlib

gs = GridSpec(3, 3, figure=fig)
ax1 = fig.add_subplot(gs[0, :2])  # Top row, first two columns
ax2 = fig.add_subplot(gs[1:, 2])  # Last two rows, last column

Sample Program

This code creates a figure with 4 plots arranged in a 2x3 grid. Each plot uses different grid cells to create a complex layout.

Matplotlib

import matplotlib.pyplot as plt
from matplotlib.gridspec import GridSpec

fig = plt.figure(figsize=(6, 4))
gs = GridSpec(2, 3, figure=fig)

ax1 = fig.add_subplot(gs[0, 0])
ax1.plot([1, 2, 3], [1, 4, 9])
ax1.set_title('Plot 1')

ax2 = fig.add_subplot(gs[0, 1:])
ax2.bar(['A', 'B', 'C'], [3, 7, 5])
ax2.set_title('Plot 2')

ax3 = fig.add_subplot(gs[1, :2])
ax3.scatter([1, 2, 3], [9, 5, 1])
ax3.set_title('Plot 3')

ax4 = fig.add_subplot(gs[1, 2])
ax4.hist([1, 2, 2, 3, 3, 3, 4])
ax4.set_title('Plot 4')

plt.tight_layout()
plt.show()

Important Notes

Use plt.tight_layout() to avoid overlapping labels and titles.

You can combine GridSpec with subplot_kw to customize each subplot.

Remember that row and column indices start at 0.

Summary

GridSpec divides a figure into a grid for flexible plot placement.

You select plot positions by slicing the grid rows and columns.

It helps create complex, clean layouts with multiple plots.

Practice

1. What is the main purpose of using GridSpec in matplotlib?

easy

A. To divide a figure into a flexible grid for placing subplots.

B. To change the color of the plot background.

C. To add titles to individual subplots automatically.

D. To save the figure in different file formats.

Solution

1. Step 1: Understand GridSpec's role

   GridSpec is designed to split a figure into rows and columns for subplot placement.

2. Step 2: Compare options

   Only To divide a figure into a flexible grid for placing subplots. describes this grid division purpose; others describe unrelated features.

3. Final Answer:

   To divide a figure into a flexible grid for placing subplots. -> Option A

4. Quick Check:

   GridSpec = flexible grid layout [OK]

Hint: GridSpec = grid layout for subplots [OK]

Common Mistakes:

• Confusing GridSpec with styling or saving functions
• Thinking GridSpec adds titles automatically
• Assuming GridSpec changes colors

2. Which of the following is the correct way to create a 2x3 GridSpec object named gs?

easy

A. gs = GridSpec(3, 2)

B. gs = GridSpec(2, 3)

C. gs = GridSpec(rows=3, cols=2)

D. gs = GridSpec(2)

Solution

1. Step 1: Recall GridSpec syntax

   GridSpec takes number of rows first, then columns: GridSpec(nrows, ncols).

2. Step 2: Match 2 rows and 3 columns

   gs = GridSpec(2, 3) uses GridSpec(2, 3), which is correct for 2 rows and 3 columns.

3. Final Answer:

   gs = GridSpec(2, 3) -> Option B

4. Quick Check:

   GridSpec(rows, cols) = (2, 3) [OK]

Hint: Rows first, columns second in GridSpec() [OK]

Common Mistakes:

• Swapping rows and columns order
• Using keyword arguments incorrectly
• Passing only one number instead of two

3. What will be the shape of the subplot created by fig.add_subplot(gs[0:2, 1]) if gs = GridSpec(3, 3)?

medium

A. A subplot spanning rows 0 and 1 in column 1 (tall and narrow).

B. A subplot in row 0, column 1 only (small square).

C. A subplot spanning all rows in column 1 (very tall).

D. A subplot spanning rows 1 and 2 in column 1.

Solution

1. Step 1: Understand slicing in GridSpec

   gs[0:2, 1] selects rows 0 and 1 (two rows) in column 1.

2. Step 2: Determine subplot shape

   It creates a subplot spanning two rows vertically and one column horizontally, so tall and narrow.

3. Final Answer:

   A subplot spanning rows 0 and 1 in column 1 (tall and narrow). -> Option A

4. Quick Check:

   gs[0:2,1] = rows 0-1, col 1 [OK]

Hint: Slice rows then columns in GridSpec to get subplot size [OK]

Common Mistakes:

• Confusing row and column indices
• Assuming slice includes row 2
• Thinking it spans all rows

4. Identify the error in this code snippet using GridSpec:

fig = plt.figure()
gs = GridSpec(2, 2)
ax = fig.add_subplot(gs[2, 1])

medium

A. TypeError because gs is not callable.

B. SyntaxError due to missing parentheses in GridSpec.

C. IndexError because row index 2 is out of range for 2 rows.

D. No error; code runs fine.

Solution

1. Step 1: Check GridSpec size

   GridSpec(2, 2) creates 2 rows indexed 0 and 1 only.

2. Step 2: Check subplot indexing

   gs[2, 1] tries to access row 2, which does not exist, causing IndexError.

3. Final Answer:

   IndexError because row index 2 is out of range for 2 rows. -> Option C

4. Quick Check:

   Index out of range = IndexError [OK]

Hint: Check GridSpec row/column indices start at 0 [OK]

Common Mistakes:

• Assuming indices start at 1
• Confusing syntax errors with index errors
• Ignoring zero-based indexing

5. You want to create a figure with 3 subplots: one large plot on the left spanning all rows, and two smaller plots stacked vertically on the right. Which GridSpec slicing correctly achieves this layout for gs = GridSpec(2, 2)?

hard

A. Left plot: gs[0, :], Right top: gs[1, 0], Right bottom: gs[1, 1]

B. Left plot: gs[:, 1], Right top: gs[0, 0], Right bottom: gs[1, 0]

C. Left plot: gs[0, 0], Right top: gs[0, 1], Right bottom: gs[1, 1]

D. Left plot: gs[:, 0], Right top: gs[0, 1], Right bottom: gs[1, 1]

Solution

1. Step 1: Understand layout goal

   Left plot spans all rows in first column; right side has two stacked plots in second column.

2. Step 2: Match slicing to layout

   gs[:, 0] selects all rows in column 0 (left plot). gs[0, 1] and gs[1, 1] select top and bottom right plots.

3. Final Answer:

   Left plot: gs[:, 0], Right top: gs[0, 1], Right bottom: gs[1, 1] -> Option D

4. Quick Check:

   Use colon for full rows, index for columns [OK]

Hint: Use colon to span all rows or columns in GridSpec [OK]

Common Mistakes:

• Mixing row and column indices
• Using single indices instead of slices for spanning
• Swapping left and right columns