What is the difference between importing matplotlib and matplotlib.pyplot?

When working with matplotlib, you have two main import options: importing the entire matplotlib package or just the matplotlib.pyplot module. Understanding the difference helps you write more efficient code.

Importing matplotlib vs matplotlib.pyplot

When you import matplotlib, you're importing the entire plotting library with all its modules and subpackages. However, importing matplotlib.pyplot only imports the pyplot interface, which provides a MATLAB-like plotting experience.

# Importing entire matplotlib package
import matplotlib

# Importing only pyplot module
import matplotlib.pyplot as plt

Why Use matplotlib.pyplot?

The pyplot module is the most commonly used interface because it provides:

• A simple, state-based interface for plotting

• MATLAB-like syntax that's familiar to many users

• Faster import time since it loads only necessary components

• Direct access to plotting functions like plot(), show(), etc.

Example: Creating a Simple Plot

Here's how to create a basic plot using matplotlib.pyplot ?

import numpy as np
import matplotlib.pyplot as plt

# Set figure properties
plt.rcParams["figure.figsize"] = [7.50, 3.50]
plt.rcParams["figure.autolayout"] = True

# Create sample data
x = np.random.rand(10)
y = np.random.rand(10)

# Create the plot
plt.plot(x, y, 'bo-', label='Random Data')
plt.xlabel('X values')
plt.ylabel('Y values')
plt.title('Sample Plot')
plt.legend()

plt.show()

The output displays a scatter plot with connected points showing random data distribution.

Memory and Performance Comparison

Best Practices

For most plotting tasks, use the conventional import:

import matplotlib.pyplot as plt

This approach is widely adopted in the Python community and provides access to all essential plotting functions while keeping your code clean and efficient.

Conclusion

Import matplotlib.pyplot for standard plotting tasks as it's more efficient and provides the essential plotting interface. Only import the full matplotlib package when you need access to multiple specialized modules.