matplotlib.texmanager#

Support for embedded TeX expressions in Matplotlib.

Requirements:

• LaTeX.

• *Agg backends: dvipng>=1.6.

• PS backend: PSfrag, dvips, and Ghostscript>=9.0.

• PDF and SVG backends: if LuaTeX is present, it will be used to speed up somepost-processing steps, but note that it is not used to parse the TeX stringitself (only LaTeX is supported).

To enable TeX rendering of all text in your Matplotlib figure, setrcParams["text.usetex"] (default:False) to True.

TeX and dvipng/dvips processing results are cachedin ~/.matplotlib/tex.cache for reuse between sessions.

TexManager.get_rgba can also be used to directly obtain raster output as RGBANumPy arrays.

classmatplotlib.texmanager.TexManager[source]#

Bases:object

Convert strings to dvi files using TeX, caching the results to a directory.

The cache directory is calledtex.cache and is located in the directoryreturned byget_cachedir.

Repeated calls to this constructor always return the same instance.

classmethodget_basefile(tex,fontsize,dpi=None)[source]#

Return a filename based on a hash of the string, fontsize, and dpi.

classmethodget_custom_preamble()[source]#

Return a string containing user additions to the tex preamble.

classmethodget_font_preamble()[source]#

Return a string containing font configuration for the tex preamble.

classmethodget_grey(tex,fontsize=None,dpi=None)[source]#

Return the alpha channel.

classmethodget_rgba(tex,fontsize=None,dpi=None,rgb=(0,0,0))[source]#

Return latex's rendering of the tex string as an RGBA array.

Examples

>>>texmanager=TexManager()>>>s=r"\TeX\ is $\displaystyle\sum_n\frac{-e^{i\pi}}{2^n}$!">>>Z=texmanager.get_rgba(s,fontsize=12,dpi=80,rgb=(1,0,0))

classmethodget_text_width_height_descent(tex,fontsize,renderer=None)[source]#

Return width, height and descent of the text.

classmethodmake_dvi(tex,fontsize)[source]#

Generate a dvi file containing latex's layout of tex string.

Return the file name.

classmethodmake_png(tex,fontsize,dpi)[source]#

Generate a png file containing latex's rendering of tex string.

Return the file name.

classmethodmake_tex(tex,fontsize)[source]#

Generate a tex file to render the tex string at a specific font size.

Return the file name.