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 some post-processing steps, but note that it is not used to parse the TeX string itself (only LaTeX is supported).
To enable TeX rendering of all text in your Matplotlib figure, set
rcParams["text.usetex"]
(default: False
) to True.
TeX and dvipng/dvips processing results are cached in ~/.matplotlib/tex.cache for reuse between sessions.
TexManager.get_rgba
can also be used to directly obtain raster output as RGBA
NumPy arrays.
- class matplotlib.texmanager.TexManager[source]#
Bases:
object
Convert strings to dvi files using TeX, caching the results to a directory.
The cache directory is called
tex.cache
and is located in the directory returned byget_cachedir
.Repeated calls to this constructor always return the same instance.
- classmethod get_basefile(tex, fontsize, dpi=None)[source]#
Return a filename based on a hash of the string, fontsize, and dpi.
- classmethod get_custom_preamble()[source]#
Return a string containing user additions to the tex preamble.
- classmethod get_font_preamble()[source]#
Return a string containing font configuration for the tex preamble.
- classmethod get_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))
- classmethod get_text_width_height_descent(tex, fontsize, renderer=None)[source]#
Return width, height and descent of the text.
- classmethod make_dvi(tex, fontsize)[source]#
Generate a dvi file containing latex's layout of tex string.
Return the file name.
- classmethod make_png(tex, fontsize, dpi)[source]#
Generate a png file containing latex's rendering of tex string.
Return the file name.