Introduction to Matplotlib in Python0%

Introduction to Matplotlib in Python

Intermediate8 min read•Updated: 2026-10-01

Introduction to Matplotlib in Python

Data visualization is a vital discipline in modern software engineering, data science, machine learning, and business analytics. While raw numbers and tables convey exact quantities, graphical visualizations immediately reveal patterns, trends, correlations, and anomalies. In Python, Matplotlib is the foundational plotting library upon which the entire scientific visualization ecosystem (including Seaborn, Pandas plotting, and scikit-learn) is built.

1. Installing Matplotlib

Install the library into your active virtual environment:

1python -m pip install matplotlib

Import the standard plotting module:

1import matplotlib.pyplot as plt

2. The Anatomy of a Matplotlib Figure

To master Matplotlib, you must understand its hierarchical object architecture:

Visual Architecture Blueprint

+-------------------------------------------------------------+
| Figure (The complete canvas / window)                       |
|                                                             |
|  Title: Global Sales 2026                                   |
|  +-------------------------------------------------------+  |
|  | Axes (The actual coordinate plot area)                |  |
|  |                                                       |  |
|  | Y-Axis (Ticks & Labels)                               |  |
|  |   ^                                                   |  |
|  |   |           * (Data Point)                          |  |
|  |   |         /                                         |  |
|  |   |   *---*                                           |  |
|  |   +---------------------------> X-Axis                |  |
|  +-------------------------------------------------------+  |
+-------------------------------------------------------------+

Figure: The top-level bounding container holding all axes, titles, subtitles, colorbars, and legends.
Axes: The actual plotting coordinate region where data is drawn. A single Figure can contain multiple Axes (subplots).
Axis: The numerical number lines (X and Y) defining limits, ticks, and tick labels.
Artist: Virtually everything visible on the canvas (lines, text, patches, markers) is an Artist.

3. The Two Matplotlib Interfaces: Pyplot vs. Object-Oriented

Matplotlib offers two programming paradigms:

A. The State-Based Pyplot Interface (`plt.plot`)

Emulates MATLAB's stateful syntax. It keeps track of the "current" figure and axes automatically. Great for quick exploratory checks in interactive notebooks, but harder to maintain in complex applications:

1import matplotlib.pyplot as plt
2 
3x = [1, 2, 3, 4, 5]
4y = [10, 25, 40, 55, 80]
5 
6plt.plot(x, y)
7plt.title("Pyplot State-Based Plot")
8plt.xlabel("X Axis")
9plt.ylabel("Y Axis")
10plt.show()

B. The Object-Oriented (OO) Interface (Recommended!)

Explicitly creates and manipulates Figure and Axes objects. This is the industry standard for clean, scalable, multi-plot code:

1import matplotlib.pyplot as plt
2 
3months = ["Jan", "Feb", "Mar", "Apr", "May"]
4revenue = [12000, 15000, 18500, 22000, 31000]
5 
6# 1. Create Figure and Axes explicitly
7fig, ax = plt.subplots(figsize=(8, 4.5))
8 
9# 2. Plot on the specific Axes object
10ax.plot(months, revenue, color="#2563eb", linewidth=2.5, marker="o")
11 
12# 3. Configure titles and labels using ax.set_*
13ax.set_title("Monthly Revenue Growth (2026)", fontsize=14, fontweight="bold")
14ax.set_xlabel("Month", fontsize=11)
15ax.set_ylabel("Revenue (₹)", fontsize=11)
16ax.grid(True, linestyle="--", alpha=0.6)
17 
18# 4. Display or Save
19plt.tight_layout()
20plt.show()

4. Saving Plots to Disk: `savefig()`

In web servers, automated reporting scripts, and backend pipelines, you save charts as high-resolution images or vector graphics instead of displaying interactive GUI windows:

1import matplotlib.pyplot as plt
2 
3fig, ax = plt.subplots()
4ax.plot([1, 2, 3], [4, 5, 6])
5 
6# Save as high-resolution PNG (300 DPI)
7fig.savefig("sales_chart.png", dpi=300, bbox_inches="tight")
8 
9# Save as scalable vector graphic (SVG) for web publishing
10fig.savefig("sales_chart.svg", format="svg", bbox_inches="tight")
11 
12plt.close(fig)  # Release memory

Setting bbox_inches="tight" ensures no labels or legends are cropped off at the image margins.

⚠️ Common Intermediate Mistakes & Gotchas

1. Forgetting `plt.show()`

In standalone Python scripts, plots are not displayed on screen until plt.show() is invoked.

2. Mismatched X and Y Array Dimensions

Matplotlib requires X and Y sequences to have the exact same number of data points. If len(x) != len(y), it raises a ValueError: x and y must have same first dimension.

💻 Try It Yourself: Basic Temperature Trend Plot

Scenario

Plot daily temperatures recorded over one week in Shikohabad using Matplotlib. Add gridlines, axis labels, markers, and a descriptive title.

Complete Solution

1import matplotlib.pyplot as plt
2 
3days = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
4temperatures = [28.5, 30.0, 31.2, 29.8, 32.5, 33.0, 31.8]
5 
6plt.figure(figsize=(8, 4.5))
7plt.plot(days, temperatures, marker="o", color="#2563eb", linewidth=2, label="Daily High (°C)")
8plt.title("Weekly Temperature Trend - Shikohabad", fontsize=14, fontweight="bold")
9plt.xlabel("Day of Week", fontsize=11)
10plt.ylabel("Temperature (°C)", fontsize=11)
11plt.grid(True, linestyle="--", alpha=0.6)
12plt.legend()
13plt.tight_layout()
14plt.savefig("temperature_trend.png", dpi=150)
15print("Temperature trend plot saved to 'temperature_trend.png'.")
16plt.close()

Expected Output

1Temperature trend plot saved to 'temperature_trend.png'.

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

In Matplotlib's object architecture, what is the difference between a Figure and an Axes?

Question 2

Why is the Object-Oriented (OO) interface (fig, ax = plt.subplots()) preferred over stateful plt.plot() for production code?

Question 3

Which method is used to save a Matplotlib chart to a high-resolution image file on disk?

Question 4

What does the parameter bbox_inches="tight" do when saving a figure?

Question 5

What standard method is called to release memory resources associated with a figure after saving it?

🚀 What's Next?

In the next lesson, we will continue your intermediate Python journey with Line, Bar and Pie Charts (13: Data Visualization Basics).

👉 Continue to Next Lesson: Line, Bar and Pie Charts →

Next Lesson

Line, Bar and Pie Charts

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Project: Package-Ready Mini App	Line, Bar and Pie Charts

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

PreviousPrevNext

MSK Institute • Shikohabad

Loading Page Content...

Preparing courses, live labs, and learning resources.सामग्री लोड हो रही है, कृपया प्रतीक्षा करें...

Connecting serverPlease wait...

💻 Practical Labs🚀 Free Demo📜 Verified Certificates

Line, Bar and Pie Charts

Introduction to Matplotlib in Python

Intermediate8 min read•Updated: 2026-10-01

Study Materials Cheatsheet

Introduction to Matplotlib in Python

1. Installing Matplotlib

Install the library into your active virtual environment:

1python -m pip install matplotlib

Import the standard plotting module:

1import matplotlib.pyplot as plt

2. The Anatomy of a Matplotlib Figure

To master Matplotlib, you must understand its hierarchical object architecture:

Visual Architecture Blueprint

+-------------------------------------------------------------+
| Figure (The complete canvas / window)                       |
|                                                             |
|  Title: Global Sales 2026                                   |
|  +-------------------------------------------------------+  |
|  | Axes (The actual coordinate plot area)                |  |
|  |                                                       |  |
|  | Y-Axis (Ticks & Labels)                               |  |
|  |   ^                                                   |  |
|  |   |           * (Data Point)                          |  |
|  |   |         /                                         |  |
|  |   |   *---*                                           |  |
|  |   +---------------------------> X-Axis                |  |
|  +-------------------------------------------------------+  |
+-------------------------------------------------------------+

Figure: The top-level bounding container holding all axes, titles, subtitles, colorbars, and legends.
Axes: The actual plotting coordinate region where data is drawn. A single Figure can contain multiple Axes (subplots).
Axis: The numerical number lines (X and Y) defining limits, ticks, and tick labels.
Artist: Virtually everything visible on the canvas (lines, text, patches, markers) is an Artist.

3. The Two Matplotlib Interfaces: Pyplot vs. Object-Oriented

Matplotlib offers two programming paradigms:

A. The State-Based Pyplot Interface (`plt.plot`)

1import matplotlib.pyplot as plt
2 
3x = [1, 2, 3, 4, 5]
4y = [10, 25, 40, 55, 80]
5 
6plt.plot(x, y)
7plt.title("Pyplot State-Based Plot")
8plt.xlabel("X Axis")
9plt.ylabel("Y Axis")
10plt.show()

B. The Object-Oriented (OO) Interface (Recommended!)

Explicitly creates and manipulates Figure and Axes objects. This is the industry standard for clean, scalable, multi-plot code:

1import matplotlib.pyplot as plt
2 
3months = ["Jan", "Feb", "Mar", "Apr", "May"]
4revenue = [12000, 15000, 18500, 22000, 31000]
5 
6# 1. Create Figure and Axes explicitly
7fig, ax = plt.subplots(figsize=(8, 4.5))
8 
9# 2. Plot on the specific Axes object
10ax.plot(months, revenue, color="#2563eb", linewidth=2.5, marker="o")
11 
12# 3. Configure titles and labels using ax.set_*
13ax.set_title("Monthly Revenue Growth (2026)", fontsize=14, fontweight="bold")
14ax.set_xlabel("Month", fontsize=11)
15ax.set_ylabel("Revenue (₹)", fontsize=11)
16ax.grid(True, linestyle="--", alpha=0.6)
17 
18# 4. Display or Save
19plt.tight_layout()
20plt.show()

4. Saving Plots to Disk: `savefig()`

In web servers, automated reporting scripts, and backend pipelines, you save charts as high-resolution images or vector graphics instead of displaying interactive GUI windows:

1import matplotlib.pyplot as plt
2 
3fig, ax = plt.subplots()
4ax.plot([1, 2, 3], [4, 5, 6])
5 
6# Save as high-resolution PNG (300 DPI)
7fig.savefig("sales_chart.png", dpi=300, bbox_inches="tight")
8 
9# Save as scalable vector graphic (SVG) for web publishing
10fig.savefig("sales_chart.svg", format="svg", bbox_inches="tight")
11 
12plt.close(fig)  # Release memory

Setting bbox_inches="tight" ensures no labels or legends are cropped off at the image margins.

⚠️ Common Intermediate Mistakes & Gotchas

1. Forgetting `plt.show()`

In standalone Python scripts, plots are not displayed on screen until plt.show() is invoked.

2. Mismatched X and Y Array Dimensions

Matplotlib requires X and Y sequences to have the exact same number of data points. If len(x) != len(y), it raises a ValueError: x and y must have same first dimension.

💻 Try It Yourself: Basic Temperature Trend Plot

Scenario

Plot daily temperatures recorded over one week in Shikohabad using Matplotlib. Add gridlines, axis labels, markers, and a descriptive title.

Complete Solution

1import matplotlib.pyplot as plt
2 
3days = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
4temperatures = [28.5, 30.0, 31.2, 29.8, 32.5, 33.0, 31.8]
5 
6plt.figure(figsize=(8, 4.5))
7plt.plot(days, temperatures, marker="o", color="#2563eb", linewidth=2, label="Daily High (°C)")
8plt.title("Weekly Temperature Trend - Shikohabad", fontsize=14, fontweight="bold")
9plt.xlabel("Day of Week", fontsize=11)
10plt.ylabel("Temperature (°C)", fontsize=11)
11plt.grid(True, linestyle="--", alpha=0.6)
12plt.legend()
13plt.tight_layout()
14plt.savefig("temperature_trend.png", dpi=150)
15print("Temperature trend plot saved to 'temperature_trend.png'.")
16plt.close()

Expected Output

1Temperature trend plot saved to 'temperature_trend.png'.

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

In Matplotlib's object architecture, what is the difference between a Figure and an Axes?

Question 2

Why is the Object-Oriented (OO) interface (fig, ax = plt.subplots()) preferred over stateful plt.plot() for production code?

Question 3

Which method is used to save a Matplotlib chart to a high-resolution image file on disk?

Question 4

What does the parameter bbox_inches="tight" do when saving a figure?

Question 5

What standard method is called to release memory resources associated with a figure after saving it?

🚀 What's Next?

In the next lesson, we will continue your intermediate Python journey with Line, Bar and Pie Charts (13: Data Visualization Basics).

👉 Continue to Next Lesson: Line, Bar and Pie Charts →

Next Lesson

Line, Bar and Pie Charts

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Project: Package-Ready Mini App	Line, Bar and Pie Charts

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

Introduction to Matplotlib in Python

1. Installing Matplotlib

2. The Anatomy of a Matplotlib Figure

3. The Two Matplotlib Interfaces: Pyplot vs. Object-Oriented

A. The State-Based Pyplot Interface (plt.plot)

B. The Object-Oriented (OO) Interface (Recommended!)

4. Saving Plots to Disk: savefig()

⚠️ Common Intermediate Mistakes & Gotchas

1. Forgetting plt.show()

2. Mismatched X and Y Array Dimensions

💻 Try It Yourself: Basic Temperature Trend Plot

Scenario

Complete Solution

Expected Output

Practice Quiz

🚀 What's Next?

Line, Bar and Pie Charts

Related Lessons

Practice Quiz

Loading Page Content...

Introduction to Matplotlib in Python

1. Installing Matplotlib

2. The Anatomy of a Matplotlib Figure

3. The Two Matplotlib Interfaces: Pyplot vs. Object-Oriented

A. The State-Based Pyplot Interface (plt.plot)

B. The Object-Oriented (OO) Interface (Recommended!)

4. Saving Plots to Disk: savefig()

⚠️ Common Intermediate Mistakes & Gotchas

1. Forgetting plt.show()

2. Mismatched X and Y Array Dimensions

💻 Try It Yourself: Basic Temperature Trend Plot

Scenario

Complete Solution

Expected Output

Practice Quiz

🚀 What's Next?

Line, Bar and Pie Charts

Related Lessons

Practice Quiz

A. The State-Based Pyplot Interface (`plt.plot`)

4. Saving Plots to Disk: `savefig()`

1. Forgetting `plt.show()`

A. The State-Based Pyplot Interface (`plt.plot`)

4. Saving Plots to Disk: `savefig()`

1. Forgetting `plt.show()`