LaTeX printing support#

In order to support latex formatting, an object should define a special method _latex_(self) that returns a string, which will be typeset in a mathematical mode (the exact mode depends on circumstances).

This module focuses on using LaTeX for printing. For the use of LaTeX for rendering math in HTML by MathJax, see MathJax defined in sage.misc.html.

AUTHORS:

  • William Stein: original implementation

  • Joel B. Mohler: latex_variable_name() drastic rewrite and many doc-tests

class sage.misc.latex.Latex(debug=False, slide=False, density=150, pdflatex=None, engine=None)#

Bases: LatexCall

Enter, e.g.,

%latex
The equation $y^2 = x^3 + x$ defines an elliptic curve.
We have $2006 = \sage{factor(2006)}$.

in an input cell in the notebook to get a typeset version. Use %latex_debug to get debugging output.

Use latex(...) to typeset a Sage object. Use LatexExpr to typeset LaTeX code that you create by hand.

Use %slide instead to typeset slides.

Warning

You must have dvipng (or dvips and convert) installed on your operating system, or this command will not work.

EXAMPLES:

sage: latex(x^20 + 1)
x^{20} + 1
sage: latex(FiniteField(25,'a'))
\Bold{F}_{5^{2}}
sage: latex("hello")
\text{\texttt{hello}}
sage: LatexExpr(r"\frac{x^2 - 1}{x + 1} = x - 1")
\frac{x^2 - 1}{x + 1} = x - 1

LaTeX expressions can be added; note that a space is automatically inserted:

sage: LatexExpr(r"y \neq") + latex(x^20 + 1)
y \neq x^{20} + 1
add_macro(macro)#

Append to the string of extra LaTeX macros, for use with %latex and %html.

INPUT:

  • macro – string

EXAMPLES:

sage: latex.extra_macros()
''
sage: latex.add_macro("\\newcommand{\\foo}{bar}")
sage: latex.extra_macros()
'\\newcommand{\\foo}{bar}'
sage: latex.extra_macros("")  # restore to default
add_package_to_preamble_if_available(package_name)#

Adds a \usepackage{package_name} instruction to the latex preamble if not yet present there, and if package_name.sty is available in the LaTeX installation.

INPUT:

  • package_name – a string

See also

add_to_preamble(s)#

Append to the string s of extra LaTeX macros, for use with %latex.

EXAMPLES:

sage: latex.extra_preamble()
''
sage: latex.add_to_preamble("\\DeclareMathOperator{\\Ext}{Ext}")

At this point, a notebook cell containing

%latex
$\Ext_A^*(\GF{2}, \GF{2}) \Rightarrow \pi_*^s*(S^0)$

will be typeset correctly.

sage: latex.add_to_preamble("\\usepackage{xypic}")
sage: latex.extra_preamble()
'\\DeclareMathOperator{\\Ext}{Ext}\\usepackage{xypic}'

Now one can put various xypic diagrams into a %latex cell, such as

%latex
\[ \xymatrix{ \circ \ar `r[d]^{a} `[rr]^{b} `/4pt[rr]^{c} `[rrr]^{d}
`_dl[drrr]^{e} [drrr]^{f} & \circ & \circ & \circ \\ \circ & \circ &
\circ & \circ } \]

Reset the preamble to its default, the empty string:

sage: latex.extra_preamble('')
sage: latex.extra_preamble()
''
blackboard_bold(t=None)#

Controls whether Sage uses blackboard bold or ordinary bold face for typesetting ZZ, RR, etc.

INPUT:

  • t – boolean or None

OUTPUT:

If t is None, return the current setting (True or False).

If t is True, use blackboard bold (\mathbb); otherwise use boldface (\mathbf).

EXAMPLES:

sage: latex.blackboard_bold()
False
sage: latex.blackboard_bold(True)
sage: latex.blackboard_bold()
True
sage: latex.blackboard_bold(False)
check_file(file_name, more_info='')#

INPUT:

  • file_name – a string

  • more_info – a string (default: “”)

Emit a warning if the local LaTeX installation does not include file_name. The string more_info is appended to the warning message. The warning is only emitted the first time this method is called.

EXAMPLES:

sage: latex.check_file("article.cls")       # optional - latex
sage: latex.check_file("some_inexistent_file.sty")
Warning: `some_inexistent_file.sty` is not part of this computer's TeX installation.
sage: latex.check_file("some_inexistent_file.sty")
sage: latex.check_file("some_inexistent_file.sty", "This file is required for blah. It can be downloaded from: http://blah.org/")
Warning: `some_inexistent_file.sty` is not part of this computer's TeX installation.
This file is required for blah. It can be downloaded from: http://blah.org/

This test checks that the bug in github issue #9091 is fixed:

sage: latex.check_file("article.cls", "The article class is really critical.")    # optional - latex
engine(e=None)#

Set Sage to use e as latex engine when typesetting with view(), in %latex cells, etc.

INPUT:

  • e – ‘latex’, ‘pdflatex’, ‘xelatex’ or None

If e is None, return the current engine.

If using the XeLaTeX engine, it will almost always be necessary to set the proper preamble with extra_preamble() or add_to_preamble(). For example:

latex.extra_preamble(r'''\usepackage{fontspec,xunicode,xltxtra}
\setmainfont[Mapping=tex-text]{some font here}
\setmonofont[Mapping=tex-text]{another font here}''')

EXAMPLES:

sage: latex.engine()
'pdflatex'
sage: latex.engine("latex")
sage: latex.engine()
'latex'
sage: latex.engine("xelatex")
sage: latex.engine()
'xelatex'
eval(x, globals, strip=False, filename=None, debug=None, density=None, pdflatex=None, engine=None, locals={})#

Compile the formatted tex given by x as a png and writes the output file to the directory given by filename.

INPUT:

  • globals – a globals dictionary

  • x – string to evaluate.

  • strip – ignored

  • filename – output filename

  • debug – whether to print verbose debugging output

  • density – how big output image is.

  • pdflatex – whether to use pdflatex. This is deprecated. Use engine option instead.

  • engine – latex engine to use. Currently latex, pdflatex, and xelatex are supported.

  • locals - extra local variables used when evaluating Sage code in x.

Warning

When using latex (the default), you must have ‘dvipng’ (or ‘dvips’ and ‘convert’) installed on your operating system, or this command will not work. When using pdflatex or xelatex, you must have ‘convert’ installed.

OUTPUT:

If it compiled successfully, this returns an empty string '', otherwise it returns None.

EXAMPLES:

sage: fn = tmp_filename()
sage: latex.eval("$\\ZZ[x]$", locals(), filename=fn) # not tested
''
sage: latex.eval(r"\ThisIsAnInvalidCommand", {}) # optional -- latex ImageMagick
An error occurred...
No pages of output...
extra_macros(macros=None)#

String containing extra LaTeX macros to use with %latex and %html.

INPUT:

  • macros – string (default: None)

If macros is None, return the current string. Otherwise, set it to macros. If you want to append to the string of macros instead of replacing it, use latex.add_macro.

EXAMPLES:

sage: latex.extra_macros("\\newcommand{\\foo}{bar}")
sage: latex.extra_macros()
'\\newcommand{\\foo}{bar}'
sage: latex.extra_macros("")
sage: latex.extra_macros()
''
extra_preamble(s=None)#

String containing extra preamble to be used with %latex.

INPUT:

  • s – string or None

If s is None, return the current preamble. Otherwise, set it to s. If you want to append to the current extra preamble instead of replacing it, use latex.add_to_preamble.

You will almost certainly need to use this when using the XeLaTeX engine; see below or the documentation for engine() for a suggested preamble.

EXAMPLES:

sage: latex.extra_preamble("\\DeclareMathOperator{\\Ext}{Ext}")
sage: latex.extra_preamble()
'\\DeclareMathOperator{\\Ext}{Ext}'
sage: latex.extra_preamble("\\"+r"usepackage{fontspec,xunicode,xltxtra}\setmainfont[Mapping=tex-text]{UnBatang}\setmonofont[Mapping=tex-text]{UnDotum}")
sage: latex.extra_preamble()
'\\usepackage{fontspec,xunicode,xltxtra}\\setmainfont[Mapping=tex-text]{UnBatang}\\setmonofont[Mapping=tex-text]{UnDotum}'
sage: latex.extra_preamble("")
sage: latex.extra_preamble()
''
has_file(file_name)#

INPUT:

  • file_name – a string

Tests whether the local LaTeX installation includes file_name.

EXAMPLES:

sage: latex.has_file("article.cls")      # optional - latex
True
sage: latex.has_file("some_inexistent_file.sty")
False
matrix_column_alignment(align=None)#

Changes the column-alignment of the LaTeX representation of matrices.

INPUT:

  • align - a string ('r' for right, 'c' for center, 'l' for left) or None.

OUTPUT:

If align is None, then returns the current alignment-string. Otherwise, set this alignment.

The input align can be any string which the LaTeX array-environment understands as a parameter for aligning a column.

EXAMPLES:

sage: a = matrix(1, 1, [42])
sage: latex(a)
\left(\begin{array}{r}
42
\end{array}\right)
sage: latex.matrix_column_alignment('c')
sage: latex(a)
\left(\begin{array}{c}
42
\end{array}\right)
sage: latex.matrix_column_alignment('l')
sage: latex(a)
\left(\begin{array}{l}
42
\end{array}\right)

Restore defaults:

sage: latex.matrix_column_alignment('r')
matrix_delimiters(left=None, right=None)#

Change the left and right delimiters for the LaTeX representation of matrices

INPUT:

  • left, right - strings or None

If both left and right are None, then return the current delimiters. Otherwise, set the left and/or right delimiters, whichever are specified.

Good choices for left and right are any delimiters which LaTeX understands and knows how to resize; some examples are:

  • parentheses: ‘(’, ‘)’

  • brackets: ‘[’, ‘]’

  • braces: ‘\{’, ‘\}’

  • vertical lines: ‘|’

  • angle brackets: ‘\langle’, ‘\rangle’

Note

Putting aside aesthetics, you may combine these in any way imaginable; for example, you could set left to be a right-hand bracket ‘]’ and right to be a right-hand brace ‘\}’, and it will be typeset correctly.

EXAMPLES:

sage: a = matrix(1, 1, [17])
sage: latex(a)
\left(\begin{array}{r}
17
\end{array}\right)
sage: latex.matrix_delimiters("[", "]")
sage: latex(a)
\left[\begin{array}{r}
17
\end{array}\right]
sage: latex.matrix_delimiters(left="\\{")
sage: latex(a)
\left\{\begin{array}{r}
17
\end{array}\right]
sage: latex.matrix_delimiters()
['\\{', ']']

Restore defaults:

sage: latex.matrix_delimiters("(", ")")
vector_delimiters(left=None, right=None)#

Change the left and right delimiters for the LaTeX representation of vectors

INPUT:

  • left, right – strings or None

If both left and right are None, then return the current delimiters. Otherwise, set the left and/or right delimiters, whichever are specified.

Good choices for left and right are any delimiters which LaTeX understands and knows how to resize; some examples are:

  • parentheses: ‘(’, ‘)’

  • brackets: ‘[’, ‘]’

  • braces: ‘\{’, ‘\}’

  • vertical lines: ‘|’

  • angle brackets: ‘\langle’, ‘\rangle’

Note

Putting aside aesthetics, you may combine these in any way imaginable; for example, you could set left to be a right-hand bracket ‘]’ and right to be a right-hand brace ‘\}’, and it will be typeset correctly.

EXAMPLES:

sage: a = vector(QQ, [1,2,3])
sage: latex(a)
\left(1,\,2,\,3\right)
sage: latex.vector_delimiters("[", "]")
sage: latex(a)
\left[1,\,2,\,3\right]
sage: latex.vector_delimiters(right="\\}")
sage: latex(a)
\left[1,\,2,\,3\right\}
sage: latex.vector_delimiters()
['[', '\\}']

Restore defaults:

sage: latex.vector_delimiters("(", ")")
class sage.misc.latex.LatexCall#

Bases: object

Typeset Sage objects via a __call__ method to this class, typically by calling those objects’ _latex_ methods. The class Latex inherits from this. This class is used in latex_macros, while functions from latex_macros are used in Latex, so this is here primarily to avoid circular imports.

EXAMPLES:

sage: from sage.misc.latex import LatexCall
sage: LatexCall()(ZZ)
\Bold{Z}
sage: LatexCall().__call__(ZZ)
\Bold{Z}

This returns an instance of the class LatexExpr:

sage: type(LatexCall()(ZZ))
<class 'sage.misc.latex.LatexExpr'>
class sage.misc.latex.LatexExamples#

Bases: object

A catalogue of Sage objects with complicated _latex_ methods. Use these for testing latex(), view(), the Typeset button in the notebook, etc.

The classes here only have __init__, _repr_, and _latex_ methods.

EXAMPLES:

sage: from sage.misc.latex import latex_examples
sage: K = latex_examples.knot()
sage: K
LaTeX example for testing display of a knot produced by xypic...
sage: latex(K)
\vtop{\vbox{\xygraph{!{0;/r1.5pc/:}
[u] !{\vloop<(-.005)\khole||\vcrossneg \vunder- }
[] !{\ar @{-}@'{p-(1,0)@+}+(-1,1)}
[ul] !{\vcap[3]>\khole}
[rrr] !{\ar @{-}@'{p-(0,1)@+}-(1,1)}
}}}
class diagram#

Bases: SageObject

LaTeX example for testing display of commutative diagrams. See its string representation for details.

EXAMPLES:

sage: from sage.misc.latex import latex_examples
sage: CD = latex_examples.diagram()
sage: CD
LaTeX example for testing display of a commutative diagram...
class graph#

Bases: SageObject

LaTeX example for testing display of graphs. See its string representation for details.

EXAMPLES:

sage: from sage.misc.latex import latex_examples
sage: G = latex_examples.graph()
sage: G
LaTeX example for testing display of graphs...
class knot#

Bases: SageObject

LaTeX example for testing display of knots. See its string representation for details.

EXAMPLES:

sage: from sage.misc.latex import latex_examples
sage: K = latex_examples.knot()
sage: K
LaTeX example for testing display of a knot...
class pstricks#

Bases: SageObject

LaTeX example for testing display of pstricks output. See its string representation for details.

EXAMPLES:

sage: from sage.misc.latex import latex_examples
sage: PS = latex_examples.pstricks()
sage: PS
LaTeX example for testing display of pstricks...
class sage.misc.latex.LatexExpr#

Bases: str

A class for LaTeX expressions.

Normally, objects of this class are created by a latex() call. It is also possible to generate LatexExpr directly from a string, which must contain valid LaTeX code for typesetting in math mode (without dollar signs). In the Sage notebook, use pretty_print() or the “Typeset” checkbox to actually see the typeset LaTeX code; alternatively, from either the command-line or the notebook, use the view() function.

INPUT:

  • str – a string with valid math mode LaTeX code (or something which can be converted to such a string).

OUTPUT:

  • LatexExpr wrapping the string representation of the input.

EXAMPLES:

sage: latex(x^20 + 1)
x^{20} + 1
sage: LatexExpr(r"\frac{x^2 + 1}{x - 2}")
\frac{x^2 + 1}{x - 2}

LatexExpr simply converts to string without doing anything extra, it does not call latex():

sage: latex(ZZ)
\Bold{Z}
sage: LatexExpr(ZZ)
Integer Ring

The result of latex() is of type LatexExpr:

sage: L = latex(x^20 + 1)
sage: L
x^{20} + 1
sage: type(L)
<class 'sage.misc.latex.LatexExpr'>

A LatexExpr can be converted to a plain string:

sage: str(latex(x^20 + 1))
'x^{20} + 1'
sage.misc.latex.None_function(x)#

Returns the LaTeX code for None.

INPUT:

  • x – None

EXAMPLES:

sage: from sage.misc.latex import None_function
sage: print(None_function(None))
\mathrm{None}
sage.misc.latex.bool_function(x)#

Returns the LaTeX code for a boolean x.

INPUT:

  • x – boolean

EXAMPLES:

sage: from sage.misc.latex import bool_function
sage: print(bool_function(2==3))
\mathrm{False}
sage: print(bool_function(3==(2+1)))
\mathrm{True}
sage.misc.latex.builtin_constant_function(x)#

Returns the LaTeX code for a builtin constant x.

INPUT:

  • x – builtin constant

See also

Python built-in Constants http://docs.python.org/library/constants.html

EXAMPLES:

sage: from sage.misc.latex import builtin_constant_function
sage: builtin_constant_function(True)
'\\mbox{\\rm True}'
sage: builtin_constant_function(None)
'\\mbox{\\rm None}'
sage: builtin_constant_function(NotImplemented)
'\\mbox{\\rm NotImplemented}'
sage: builtin_constant_function(Ellipsis)
'\\mbox{\\rm Ellipsis}'
sage.misc.latex.coeff_repr(c)#

LaTeX string representing coefficients in a linear combination.

INPUT:

  • c – a coefficient (i.e., an element of a ring)

OUTPUT:

A string

EXAMPLES:

sage: from sage.misc.latex import coeff_repr
sage: coeff_repr(QQ(1/2))
'\\frac{1}{2}'
sage: coeff_repr(-x^2)
'\\left(-x^{2}\\right)'
sage.misc.latex.dict_function(x)#

Return the LaTeX code for a dictionary x.

INPUT:

  • x – a dictionary

EXAMPLES:

sage: from sage.misc.latex import dict_function
sage: x,y,z = var('x,y,z')
sage: print(dict_function({x/2: y^2}))
\left\{\frac{1}{2} \, x : y^{2}\right\}
sage: d = {(1,2,x^2): [sin(z^2), y/2]}
sage: latex(d)
\left\{\left(1, 2, x^{2}\right) :
       \left[\sin\left(z^{2}\right), \frac{1}{2} \, y\right]\right\}
sage.misc.latex.float_function(x)#

Returns the LaTeX code for a python float x.

INPUT:

  • x – a python float

EXAMPLES:

sage: from sage.misc.latex import float_function
sage: float_function(float(3.14))
3.14
sage: float_function(float(1e-10))
1 \times 10^{-10}
sage: float_function(float(2e10))
20000000000.0
sage.misc.latex.has_latex_attr(x)#

Return True if x has a _latex_ attribute, except if x is a type, in which case return False.

EXAMPLES:

sage: from sage.misc.latex import has_latex_attr
sage: has_latex_attr(identity_matrix(3))
True
sage: has_latex_attr("abc")  # strings have no _latex_ method
False

Types inherit the _latex_ method of the class to which they refer, but calling it is broken:

sage: T = type(identity_matrix(3)); T
<class 'sage.matrix.matrix_integer_dense.Matrix_integer_dense'>
sage: hasattr(T, '_latex_')
True
sage: T._latex_()
Traceback (most recent call last):
...
TypeError: ..._latex_... needs an argument
sage: has_latex_attr(T)
False
sage.misc.latex.have_convert()#

Return True if this computer has the program convert.

If this computer does not have convert installed, you may obtain it (along with the rest of the ImageMagick suite) from http://www.imagemagick.org

EXAMPLES:

sage: from sage.misc.latex import have_convert
sage: have_convert() # random
True
sage.misc.latex.have_dvipng()#

Return True if this computer has the program dvipng.

If this computer does not have dvipng installed, you may obtain it from http://sourceforge.net/projects/dvipng/

EXAMPLES:

sage: from sage.misc.latex import have_dvipng
sage: have_dvipng() # random
True
sage.misc.latex.have_latex()#

Return True if this computer has the program latex.

If this computer does not have LaTeX installed, you may obtain it from http://ctan.org/.

EXAMPLES:

sage: from sage.misc.latex import have_latex
sage: have_latex() # random
True
sage.misc.latex.have_pdflatex()#

Return True if this computer has the program pdflatex.

If this computer does not have pdflatex installed, you may obtain it from http://ctan.org/.

EXAMPLES:

sage: from sage.misc.latex import have_pdflatex
sage: have_pdflatex() # random
True
sage.misc.latex.have_xelatex()#

Return True if this computer has the program xelatex.

If this computer does not have xelatex installed, you may obtain it from http://ctan.org/.

EXAMPLES:

sage: from sage.misc.latex import have_xelatex
sage: have_xelatex() # random
True
sage.misc.latex.latex(x, combine_all=False)#

Return a LatexExpr built out of the argument x.

INPUT:

  • x – a Sage object

  • combine_all – boolean (Default: False) If combine_all is True and the input is a tuple, then it does not return a tuple and instead returns a string with all the elements separated by a single space.

OUTPUT:

A LatexExpr built from x

EXAMPLES:

sage: latex(Integer(3))  # indirect doctest
3
sage: latex(1==0)
\mathrm{False}
sage: print(latex([x,2]))
\left[x, 2\right]

Check that github issue #11775 is fixed:

sage: latex((x,2), combine_all=True)
x 2
sage.misc.latex.latex_extra_preamble()#

Return the string containing the user-configured preamble, sage_latex_macros, and any user-configured macros. This is used in the eval() method for the Latex class, and in _latex_file_(); it follows either LATEX_HEADER or SLIDE_HEADER (defined at the top of this file) which is a string containing the documentclass and standard usepackage commands.

EXAMPLES:

sage: from sage.misc.latex import latex_extra_preamble
sage: print(latex_extra_preamble())

\newcommand{\ZZ}{\Bold{Z}}
\newcommand{\NN}{\Bold{N}}
\newcommand{\RR}{\Bold{R}}
\newcommand{\CC}{\Bold{C}}
\newcommand{\QQ}{\Bold{Q}}
\newcommand{\QQbar}{\overline{\QQ}}
\newcommand{\GF}[1]{\Bold{F}_{#1}}
\newcommand{\Zp}[1]{\Bold{Z}_{#1}}
\newcommand{\Qp}[1]{\Bold{Q}_{#1}}
\newcommand{\Zmod}[1]{\ZZ/#1\ZZ}
\newcommand{\CDF}{\Bold{C}}
\newcommand{\CIF}{\Bold{C}}
\newcommand{\CLF}{\Bold{C}}
\newcommand{\RDF}{\Bold{R}}
\newcommand{\RIF}{\Bold{I} \Bold{R}}
\newcommand{\RLF}{\Bold{R}}
\newcommand{\SL}{\mathrm{SL}}
\newcommand{\PSL}{\mathrm{PSL}}
\newcommand{\lcm}{\mathop{\operatorname{lcm}}}
\newcommand{\Bold}[1]{\mathbf{#1}}
sage.misc.latex.latex_variable_name(x, is_fname=False)#

Return latex version of a variable name.

Here are some guiding principles for usage of this function:

  1. If the variable is a single letter, that is the latex version.

  2. If the variable name is suffixed by a number, we put the number in the subscript.

  3. If the variable name contains an ‘_’ we start the subscript at the underscore. Note that #3 trumps rule #2.

  4. If a component of the variable is a Greek letter, escape it properly.

  5. Recurse nicely with subscripts.

Refer to the examples section for how these rules might play out in practice.

EXAMPLES:

sage: from sage.misc.latex import latex_variable_name
sage: latex_variable_name('a')
'a'
sage: latex_variable_name('abc')
'\\mathit{abc}'
sage: latex_variable_name('sigma')
'\\sigma'
sage: latex_variable_name('sigma_k')
'\\sigma_{k}'
sage: latex_variable_name('sigma389')
'\\sigma_{389}'
sage: latex_variable_name('beta_00')
'\\beta_{00}'
sage: latex_variable_name('Omega84')
'\\Omega_{84}'
sage: latex_variable_name('sigma_alpha')
'\\sigma_{\\alpha}'
sage: latex_variable_name('nothing1')
'\\mathit{nothing}_{1}'
sage: latex_variable_name('nothing1', is_fname=True)
'{\\rm nothing}_{1}'
sage: latex_variable_name('nothing_abc')
'\\mathit{nothing}_{\\mathit{abc}}'
sage: latex_variable_name('nothing_abc', is_fname=True)
'{\\rm nothing}_{{\\rm abc}}'
sage: latex_variable_name('alpha_beta_gamma12')
'\\alpha_{\\beta_{\\gamma_{12}}}'
sage: latex_variable_name('x_ast')
'x_{\\ast}'
sage.misc.latex.latex_varify(a, is_fname=False)#

Convert a string a to a LaTeX string: if it’s an element of common_varnames, then prepend a backslash. If a consists of a single letter, then return it. Otherwise, return either “{\rm a}” or “\mbox{a}” if “is_fname” flag is True or False.

INPUT:

  • a – string

OUTPUT:

A string

EXAMPLES:

sage: from sage.misc.latex import latex_varify
sage: latex_varify('w')
'w'
sage: latex_varify('aleph')
'\\mathit{aleph}'
sage: latex_varify('aleph', is_fname=True)
'{\\rm aleph}'
sage: latex_varify('alpha')
'\\alpha'
sage: latex_varify('ast')
'\\ast'
sage.misc.latex.list_function(x)#

Returns the LaTeX code for a list x.

INPUT: x - a list

EXAMPLES:

sage: from sage.misc.latex import list_function
sage: list_function([1,2,3])
'\\left[1, 2, 3\\right]'
sage: latex([1,2,3])  # indirect doctest
\left[1, 2, 3\right]
sage: latex([Matrix(ZZ,3,range(9)), Matrix(ZZ,3,range(9))]) # indirect doctest
\left[\left(\begin{array}{rrr}
0 & 1 & 2 \\
3 & 4 & 5 \\
6 & 7 & 8
\end{array}\right), \left(\begin{array}{rrr}
0 & 1 & 2 \\
3 & 4 & 5 \\
6 & 7 & 8
\end{array}\right)\right]
sage.misc.latex.png(x, filename, density=150, debug=False, do_in_background=False, tiny=False, pdflatex=True, engine='pdflatex')#

Create a png image representation of x and save to the given filename.

INPUT:

  • x – object to be displayed

  • filename – file in which to save the image

  • density – integer (default: 150)

  • debug – bool (default: False): print verbose output

  • do_in_background – bool (default: False): Unused, kept for backwards compatibility

  • tiny – bool (default: False): use ‘tiny’ font

  • pdflatex – bool (default: True): use pdflatex. This option is deprecated. Use engine option instead. See below.

  • engine – (default: 'pdflatex') 'latex', 'pdflatex', or 'xelatex'

EXAMPLES:

sage: from sage.misc.latex import png
sage: import tempfile
sage: with tempfile.NamedTemporaryFile(suffix=".png") as f:  # random, optional - latex imagemagick
....:     png(ZZ[x], f.name)
sage.misc.latex.repr_lincomb(symbols, coeffs)#

Compute a latex representation of a linear combination of some formal symbols.

INPUT:

  • symbols – list of symbols

  • coeffs – list of coefficients of the symbols

OUTPUT:

A string

EXAMPLES:

sage: t = PolynomialRing(QQ, 't').0
sage: from sage.misc.latex import repr_lincomb
sage: repr_lincomb(['a', 's', ''], [-t, t - 2, t^12 + 2])
'-t\\text{\\texttt{a}} + \\left(t - 2\\right)\\text{\\texttt{s}} + \\left(t^{12} + 2\\right)'
sage: repr_lincomb(['a', 'b'], [1,1])
'\\text{\\texttt{a}} + \\text{\\texttt{b}}'

Verify that a certain corner case works (see github issue #5707 and github issue #5766):

sage: repr_lincomb([1,5,-3],[2,8/9,7])
'2\\cdot 1 + \\frac{8}{9}\\cdot 5 + 7\\cdot -3'

Verify that github issue #17299 (latex representation of modular symbols) is fixed:

sage: x = EllipticCurve('64a1').modular_symbol_space(sign=1).basis()[0]         # optional - sage.schemes
sage: from sage.misc.latex import repr_lincomb
sage: latex(x.modular_symbol_rep())                                             # optional - sage.schemes
\left\{\frac{-3}{11}, \frac{-1}{4}\right\} - \left\{\frac{3}{13}, \frac{1}{4}\right\}

Verify that it works when the symbols are numbers:

sage: x = FormalSum([(1,2),(3,4)])
sage: latex(x)
2 + 3\cdot 4

Verify that it works when bv in CC raises an error:

sage: x = FormalSum([(1,'x'),(2,'y')])
sage: latex(x)
\text{\texttt{x}} + 2\text{\texttt{y}}
sage.misc.latex.str_function(x)#

Return a LaTeX representation of the string x.

The main purpose of this function is to generate LaTeX representation for classes that do not provide a customized method.

If x contains only digits with, possibly, a single decimal point and/or a sign in front, it is considered to be its own representation. Otherwise each line of x is wrapped in a \texttt command and these lines are assembled in a left-justified array. This gives to complicated strings the closest look to their “terminal representation”.

Warning

Such wrappers cannot be used as arguments of LaTeX commands or in command definitions. If this causes you any problems, they probably can be solved by implementing a suitable _latex_ method for an appropriate class.

INPUT:

  • x – a string.

OUTPUT:

A string

EXAMPLES:

sage: from sage.misc.latex import str_function
sage: str_function('34')
'34'
sage: str_function('34.5')
'34.5'
sage: str_function('-34.5')
'-34.5'
sage: str_function('+34.5')
'+34.5'
sage: str_function('hello_world')
'\\text{\\texttt{hello{\\char`\\_}world}}'
sage: str_function('-1.00000?') # trac 12178
'-1.00000?'
sage.misc.latex.tuple_function(x, combine_all=False)#

Returns the LaTeX code for a tuple x.

INPUT:

  • x – a tuple

  • combine_all – boolean (Default: False) If combine_all is True, then it does not return a tuple and instead returns a string with all the elements separated by a single space. It does not collapse tuples which are inside tuples.

EXAMPLES:

sage: from sage.misc.latex import tuple_function
sage: tuple_function((1,2,3))
'\\left(1, 2, 3\\right)'

Check that github issue #11775 is fixed:

sage: tuple_function((1,2,3), combine_all=True)
'1 2 3'
sage: tuple_function(((1,2),3), combine_all=True)
'\\left(1, 2\\right) 3'
sage.misc.latex.view(objects, title='Sage', debug=False, sep='', tiny=False, pdflatex=None, engine=None, viewer=None, tightpage=True, margin=None, mode='inline', combine_all=False, **kwds)#

Compute a latex representation of each object in objects, compile, and display typeset. If used from the command line, this requires that latex be installed.

INPUT:

  • objects – list (or object)

  • title – string (default: 'Sage'): title for the document

  • debug – bool (default: False): print verbose output

  • sep – string (default: ‘’): separator between math objects

  • tiny – bool (default: False): use tiny font.

  • pdflatex – bool (default: False): use pdflatex. This is deprecated. Use 'engine' option instead.

  • engine – string or None (default: None). Can take the following values:

    • None – the value defined in the LaTeX global preferences latex.engine() is used.

    • 'pdflatex' – compilation does tex -> pdf

    • 'xelatex' – compilation does tex -> pdf

    • 'latex' – compilation first tries tex -> dvi -> png and if an error occurs then tries dvi -> ps -> pdf. This is slower than 'pdflatex' and known to be broken when overfull hbox are detected.

  • viewer – string or None (default: None): specify a viewer to use; currently the only options are None and 'pdf'.

  • tightpage – bool (default: True): use the LaTeX package ‘preview’ with the ‘tightpage’ option.

  • margin – float or None (default: None): adds a margin of margin mm; has no affect if the option tightpage is False.

  • mode – string (default: 'inline'): 'display' for displaymath or 'inline' for inline math

  • combine_all – bool (default: False): If combine_all is True and the input is a tuple, then it does not return a tuple and instead returns a string with all the elements separated by a single space.

OUTPUT:

Display typeset objects.

The output is displayed in a separate viewer displaying a dvi (or pdf) file, with the following: the title string is printed, centered, at the top. Beneath that, each object in objects is typeset on its own line, with the string sep inserted between these lines.

The value of sep is inserted between each element of the list objects; you can, for example, add vertical space between objects with sep='\\vspace{15mm}', while sep='\\hrule' adds a horizontal line between objects, and sep='\\newpage' inserts a page break between objects.

If pdflatex is True, then the latex engine is set to pdflatex.

If the engine is either pdflatex or xelatex, it produces a pdf file. Otherwise, it produces a dvi file, and if the program dvipng is installed, it checks the dvi file by trying to convert it to a png file. If this conversion fails, the dvi file probably contains some postscript special commands or it has other issues which might make displaying it a problem; in this case, the file is converted to a pdf file, which is then displayed.

Setting viewer to 'pdf' forces the use of a separate viewer, even in notebook mode. This also sets the latex engine to be pdflatex if the current engine is latex.

Setting the option tightpage to True (this is the default setting) tells LaTeX to use the package ‘preview’ with the ‘tightpage’ option. Then, each object is typeset in its own page, and that page is cropped to exactly the size of the object. This is typically useful for very large pictures (like graphs) generated with tikz. This only works when using a separate viewer. Note that the object are currently typeset in plain math mode rather than displaymath, because the latter imposes a limit on the width of the picture. Technically, tightpage adds

\\usepackage[tightpage,active]{preview}
\\PreviewEnvironment{page}

to the LaTeX preamble, and replaces the \\[ and \\] around each object by \\begin{page}$ and $\\end{page}. Setting tightpage to False turns off this behavior and provides the latex output as a full page. If tightpage is set to True, the Title is ignored.