91

How can I add a newline to a plot's label (e.g. xlabel or ylabel) in matplotlib? For example,

plt.bar([1, 2], [4, 5])
plt.xlabel("My x label")
plt.ylabel(r"My long label with $\Sigma_{C}$ math \n continues here") 

Ideally I'd like the y-labeled to be centered too. Is there a way to do this? It's important that the label have both TeX (enclosed in '$') and the newline.

4 Answers 4

132

You can have the best of both worlds: automatic "escaping" of LaTeX commands and newlines:

plt.ylabel(r"My long label with unescaped {\LaTeX} $\Sigma_{C}$ math"
           "\n"  # Newline: the backslash is interpreted as usual
           r"continues here with $\pi$")

(instead of using three lines, separating the strings by single spaces is another option).

In fact, Python automatically concatenates string literals that follow each other, and you can mix raw strings (r"…") and strings with character interpolation ("\n").

2
  • Just a quick comment--this was the perfect solution for an easy way to label subplots with an (a), (b), etc. when that label should be below the plot and centered with the xlabel. This way plt.tight_layout() also sees the whole label and adjusts accordingly.
    – SeanM
    Jul 1, 2017 at 21:19
  • 4
    This should be the accepted answer. Also note that it works with Python string formatting, e.g. r"$\alpha$ : {0} " "\n" r"$\beta$ : {1}".format(a, b)
    – berkelem
    Sep 24, 2018 at 6:27
50

Your example is exactly how it's done, you use \n. You need to take off the r prefix though so python doesn't treat it as a raw string

4
  • 9
    You might want to proactively double-escape LaTeX commands to make sure they are not interpreted by Python: xlabel('$\\Sigma$') Apr 17, 2010 at 22:54
  • 8
    This answer is not correct. You either double escape the latex `` in a normal string (no r) or you follow @EOLs answer
    – aaren
    Sep 18, 2013 at 15:02
  • 2
    regarding centering: ylabel('this is vertical\ntest', multialignment='center') from matplotlib.org/examples/pylab_examples/multiline.html
    – Faber
    Dec 2, 2014 at 19:15
  • 2
    Unfortunately none of the proposed solutions work with the option rcParams["text.usetex"] = True
    – Samuel
    Jul 25, 2019 at 15:08
17
plt.bar([1, 2], [4, 5])
plt.xlabel("My x label")
plt.ylabel(r"My long label with $\Sigma_{C}$ math" + "\n" + "continues here")

Just concatenate the strings with a newline that isn't in raw string form.

3

The following matplotlib python script creates text with new line

ax.text(10, 70, 'shock size \n $n-n_{fd}$')

The following does not have new line. Notice the r before the text

ax.text(10, 70, r'shock size \n $n-n_{fd}$')

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy