Open In App

Matplotlib.pyplot.legend() in Python

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

A legend is an area describing the elements of the graph. In the Matplotlib library, there’s a function called legend() which is used to place a legend on the axes. In this article, we will learn about the Matplotlib Legends.

Python Matplotlib.pyplot.legend() Syntax

Syntax: matplotlib.pyplot.legend([“blue”, “green”], bbox_to_anchor=(0.75, 1.15), ncol=2)

Attributes:

  • shadow: [None or bool] Whether to draw a shadow behind the legend.It’s Default value is None.
  • markerscale: [None or int or float] The relative size of legend markers compared with the originally drawn ones.The Default is None.
  • numpoints: [None or int] The number of marker points in the legend when creating a legend entry for a Line2D (line).The Default is None.
  • fontsize: The font size of the legend.If the value is numeric the size will be the absolute font size in points.
  • facecolor: [None or “inherit” or color] The legend’s background color.
  • edgecolor: [None or “inherit” or color] The legend’s background patch edge color.

Matplotlib.pyplot.legend() in Python

Matplotlib.pyplot.legend() function is a utility given in the Matplotlib library for Python that gives a way to label and differentiate between multiple plots in the same figure

The attribute Loc in legend() is used to specify the location of the legend. The default value of loc is loc= “best” (upper left). The strings ‘upper left’, ‘upper right’, ‘lower left’, and ‘lower right’ place the legend at the corresponding corner of the axes/figure.

The attribute bbox_to_anchor=(x, y) of the legend() function is used to specify the coordinates of the legend, and the attribute ncol represents the number of columns that the legend has. Its default value is 1.

Python Matplotlib legend() Function Examples

Below are some examples that can see the Matplotlib interactive mode setup using Matplotlib.pyplot.legend() in Python:

Add a Legend to a Matplotlib

In this example, a simple quadratic function \( y = x^2 \) is plotted against the x-values [1, 2, 3, 4, 5]. A legend labeled “single element” is added to the plot, clarifying the plotted data.

Python3




import numpy as np
import matplotlib.pyplot as plt
 
# X-axis values
x = [1, 2, 3, 4, 5]
 
# Y-axis values
y = [1, 4, 9, 16, 25]
 
# Function to plot
plt.plot(x, y)
 
# Function add a legend
plt.legend(['single element'])
 
# function to show the plot
plt.show()


Output :

graph

Change the Position of the Legend

In this example, two data series, represented by `y1` and `y2`, are plotted. Each series is differentiated by a specific color, and the legend provides color-based labels “blue” and “green” for clarity.

Python3




# importing modules
import numpy as np
import matplotlib.pyplot as plt
 
# Y-axis values
y1 = [2, 3, 4.5]
 
# Y-axis values
y2 = [1, 1.5, 5]
 
# Function to plot
plt.plot(y1)
plt.plot(y2)
 
# Function add a legend
plt.legend(["blue", "green"], loc="lower right")
 
# function to show the plot
plt.show()


Output :

graph

Combine Multiple labels in legend

In this example, two curves representing `y1` and `y2` are plotted against the `x` values. Each curve is labeled with a distinct legend entry, “Numbers” and “Square of numbers”, respectively, providing clarity to the viewer.

Python3




import numpy as np
import matplotlib.pyplot as plt
 
# X-axis values
x = np.arange(5)
 
# Y-axis values
y1 = [1, 2, 3, 4, 5]
 
# Y-axis values
y2 = [1, 4, 9, 16, 25]
 
# Function to plot
plt.plot(x, y1, label='Numbers')
plt.plot(x, y2, label='Square of numbers')
 
# Function add a legend
plt.legend()
 
# function to show the plot
plt.show()


Output :

graph

Plotting Sine and Cosine Functions with Legends in Matplotlib

In this example, both the sine and cosine functions are plotted against the range [0, 10] on the x-axis. The plot includes legends distinguishing the sine and cosine curves, enhancing visual clarity.

Python3




import numpy as np
import matplotlib.pyplot as plt
 
x = np.linspace(0, 10, 1000)
fig, ax = plt.subplots()
 
ax.plot(x, np.sin(x), '--b', label='Sine')
ax.plot(x, np.cos(x), c='r', label='Cosine')
ax.axis('equal')
 
leg = ax.legend(loc="lower left")


Output:

Place the Legend Outside the Plot in Matplotlib

In this example, two functions y = x and y = 3x are plotted against the x-values. The legend is strategically positioned above the plot with two columns for improved layout and clarity.

Python3




# importing modules
import numpy as np
import matplotlib.pyplot as plt
 
# X-axis values
x = [0, 1, 2, 3, 4, 5, 6, 7, 8]
 
# Y-axis values
y1 = [0, 3, 6, 9, 12, 15, 18, 21, 24]
# Y-axis values
y2 = [0, 1, 2, 3, 4, 5, 6, 7, 8]
 
# Function to plot
plt.plot(y1, label="y = x")
plt.plot(y2, label="y = 3x")
 
# Function add a legend
plt.legend(bbox_to_anchor=(0.75, 1.15), ncol=2)
plt.show()


Output:

graph



Last Updated : 10 Jan, 2024
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads