GridSpec for complex layouts in Matplotlib - Step-by-Step Execution

Concept Flow - GridSpec for complex layouts

Create Figure

↓

Define GridSpec with rows and cols

↓

Assign subplots to GridSpec cells

↓

Plot data in each subplot

↓

Adjust layout and display figure

The flow shows creating a figure, defining a grid layout, placing subplots in grid cells, plotting data, and displaying the final complex layout.

Execution Sample

Matplotlib

import matplotlib.pyplot as plt
import matplotlib.gridspec as gridspec

fig = plt.figure()
gs = gridspec.GridSpec(3, 3)
ax1 = fig.add_subplot(gs[0, :2])
ax1.plot([1,2,3])

This code creates a figure, defines a 3x3 grid, places a subplot spanning first row and first two columns, and plots a simple line.

Execution Table

Step	Action	GridSpec Cell	Subplot Created	Plot Action	Result
1	Create figure	-	Figure created	-	Empty figure ready
2	Define GridSpec	3 rows x 3 cols	-	-	GridSpec layout defined
3	Add subplot ax1	Row 0, Cols 0-1	ax1	Plot line [1,2,3]	Line plotted in ax1
4	Add subplot ax2	Row 0, Col 2	ax2	Plot scatter points	Scatter plotted in ax2
5	Add subplot ax3	Rows 1-2, Cols 0-2	ax3	Plot bar chart	Bar chart plotted in ax3
6	Adjust layout	-	-	-	Layout adjusted to avoid overlap
7	Show figure	-	-	-	Figure displayed with complex layout

💡 All subplots placed and plotted, layout adjusted, figure shown.

Variable Tracker

Variable	Start	After Step 3	After Step 4	After Step 5	Final
fig	None	Figure object	Figure object	Figure object	Figure object
gs	None	GridSpec(3x3)	GridSpec(3x3)	GridSpec(3x3)	GridSpec(3x3)
ax1	None	AxesSubplot at row0 cols0-1	AxesSubplot at row0 cols0-1	AxesSubplot at row0 cols0-1	AxesSubplot at row0 cols0-1
ax2	None	None	AxesSubplot at row0 col2	AxesSubplot at row0 col2	AxesSubplot at row0 col2
ax3	None	None	None	AxesSubplot at rows1-2 cols0-2	AxesSubplot at rows1-2 cols0-2

Key Moments - 3 Insights

Why does ax1 use gs[0, :2] instead of gs[0, 0:2]?

gs[0, :2] is a shorthand for selecting columns 0 and 1 in row 0. Both are equivalent, but :2 is simpler and common in GridSpec indexing as shown in execution_table step 3.

How does GridSpec allow a subplot to span multiple rows or columns?

GridSpec slicing like gs[1:3, 0:3] selects multiple rows and columns, creating a larger subplot area. This is shown in step 5 where ax3 spans rows 1-2 and all columns.

What happens if subplots overlap in GridSpec?

Overlapping subplots cause plots to overwrite each other visually. Adjusting layout or carefully assigning GridSpec slices prevents overlap, as done in step 6.

Visual Quiz - 3 Questions

Look at the execution_table at step 3, which GridSpec cells does ax1 occupy?

A Rows 1 and 2, all columns

B Row 0, Columns 0 and 1

C Row 0, Column 2 only

D Entire grid

💡 Hint

Check the 'GridSpec Cell' column in execution_table row 3.

At which step is the subplot that spans multiple rows created?

A Step 3

B Step 4

C Step 5

D Step 6

💡 Hint

Look for 'Rows 1-2' in the 'GridSpec Cell' column in execution_table.

If we change ax3 to only span row 1 and columns 0-2, how does variable_tracker change?

A ax3 would be at row 1 cols 0-2

B ax3 would be at rows 1-2 cols 0-2

C ax3 would be at row 0 cols 0-1

D ax3 would be None

💡 Hint

Check the 'ax3' row in variable_tracker and compare the 'After Step 5' value.

Concept Snapshot

GridSpec lets you create complex subplot layouts by dividing a figure into a grid.
Use slicing like gs[row_start:row_end, col_start:col_end] to assign subplot positions.
Subplots can span multiple rows or columns.
Adjust layout to avoid overlap.
Use fig.add_subplot(gs[...]) to add subplots.
Useful for detailed, custom figure designs.

Full Transcript

This visual execution trace shows how to use matplotlib's GridSpec for complex layouts. First, a figure is created. Then a GridSpec object divides the figure into a grid of rows and columns. Subplots are assigned to specific grid cells or spans using slicing. Each subplot is created and plotted with data. The layout is adjusted to prevent overlap. Variables like fig, gs, and axes track the state of the figure and subplots. Key moments clarify slicing syntax and subplot spanning. The quiz tests understanding of GridSpec cell assignments and subplot spans. This method helps create detailed, customized figure layouts in matplotlib.