Graphics arrays and insets

This module defines the classes MultiGraphics and GraphicsArray. The class MultiGraphics is the base class for 2-dimensional graphical objects that are composed of various Graphics objects, arranged in a given canvas. The subclass GraphicsArray is for Graphics objects arranged in a regular array.

AUTHORS:

  • Eric Gourgoulhon (2019-05-24): initial version, refactoring the class GraphicsArray that was defined in the module graphics.

class sage.plot.multigraphics.GraphicsArray(array)[source]

Bases: MultiGraphics

This class implements 2-dimensional graphical objects that constitute an array of Graphics drawn on a single canvas.

The user interface is through the function graphics_array().

INPUT:

  • array – either a list of lists of Graphics elements (generic case) or a single list of Graphics elements (case of a single-row array)

EXAMPLES:

An array made of four graphics objects:

sage: g1 = plot(sin(x^2), (x, 0, 6), axes_labels=['$x$', '$y$'],
....:           axes=False, frame=True, gridlines='minor')
sage: y = var('y')
sage: g2 = streamline_plot((sin(x), cos(y)), (x,-3,3), (y,-3,3),
....:                      aspect_ratio=1)
sage: g3 = graphs.DodecahedralGraph().plot()
sage: g4 = polar_plot(sin(5*x)^2, (x, 0, 2*pi), color='green',
....:                 fontsize=8) \
....:      + circle((0,0), 0.5, rgbcolor='red', fill=True, alpha=0.1,
....:               legend_label='pink')
sage: g4.set_legend_options(loc='upper right')
sage: G = graphics_array([[g1, g2], [g3, g4]])
sage: G
Graphics Array of size 2 x 2

>>> from sage.all import *
>>> g1 = plot(sin(x**Integer(2)), (x, Integer(0), Integer(6)), axes_labels=['$x$', '$y$'],
...           axes=False, frame=True, gridlines='minor')
>>> y = var('y')
>>> g2 = streamline_plot((sin(x), cos(y)), (x,-Integer(3),Integer(3)), (y,-Integer(3),Integer(3)),
...                      aspect_ratio=Integer(1))
>>> g3 = graphs.DodecahedralGraph().plot()
>>> g4 = polar_plot(sin(Integer(5)*x)**Integer(2), (x, Integer(0), Integer(2)*pi), color='green',
...                 fontsize=Integer(8))      + circle((Integer(0),Integer(0)), RealNumber('0.5'), rgbcolor='red', fill=True, alpha=RealNumber('0.1'),
...               legend_label='pink')
>>> g4.set_legend_options(loc='upper right')
>>> G = graphics_array([[g1, g2], [g3, g4]])
>>> G
Graphics Array of size 2 x 2

g1 = plot(sin(x^2), (x, 0, 6), axes_labels=['$x$', '$y$'],
          axes=False, frame=True, gridlines='minor')
y = var('y')
g2 = streamline_plot((sin(x), cos(y)), (x,-3,3), (y,-3,3),
                     aspect_ratio=1)
g3 = graphs.DodecahedralGraph().plot()
g4 = polar_plot(sin(5*x)^2, (x, 0, 2*pi), color='green',
                fontsize=8) \
     + circle((0,0), 0.5, rgbcolor='red', fill=True, alpha=0.1,
              legend_label='pink')
g4.set_legend_options(loc='upper right')
G = graphics_array([[g1, g2], [g3, g4]])
G
../../_images/multigraphics-1.svg

If one constructs the graphics array from a single list of graphics objects, one obtains a single-row array:

sage: G = graphics_array([g1, g2, g3, g4])
sage: G
Graphics Array of size 1 x 4

>>> from sage.all import *
>>> G = graphics_array([g1, g2, g3, g4])
>>> G
Graphics Array of size 1 x 4

G = graphics_array([g1, g2, g3, g4])
G
../../_images/multigraphics-2.svg

We note that the overall aspect ratio of the figure is 4/3 (the default), which makes g1 elongated, while the aspect ratio of g2, which has been specified with the parameter aspect_ratio=1 is preserved. To get a better aspect ratio for the whole figure, one can use the option figsize in the method show():

sage: G.show(figsize=[8, 3])

>>> from sage.all import *
>>> G.show(figsize=[Integer(8), Integer(3)])

G.show(figsize=[8, 3])
../../_images/multigraphics-3.svg

We can access individual elements of the graphics array with the square-bracket operator:

sage: G = graphics_array([[g1, g2], [g3, g4]])  # back to the 2x2 array
sage: print(G)
Graphics Array of size 2 x 2
sage: G[0] is g1
True
sage: G[1] is g2
True
sage: G[2] is g3
True
sage: G[3] is g4
True

>>> from sage.all import *
>>> G = graphics_array([[g1, g2], [g3, g4]])  # back to the 2x2 array
>>> print(G)
Graphics Array of size 2 x 2
>>> G[Integer(0)] is g1
True
>>> G[Integer(1)] is g2
True
>>> G[Integer(2)] is g3
True
>>> G[Integer(3)] is g4
True

G = graphics_array([[g1, g2], [g3, g4]])  # back to the 2x2 array
print(G)
G[0] is g1
G[1] is g2
G[2] is g3
G[3] is g4

Note that with respect to the square-bracket operator, G is considered as a flattened list of graphics objects, not as an array. For instance, G[0, 1] throws an error:

sage: G[0, 1]
Traceback (most recent call last):
...
TypeError: list indices must be integers or slices, not tuple

>>> from sage.all import *
>>> G[Integer(0), Integer(1)]
Traceback (most recent call last):
...
TypeError: list indices must be integers or slices, not tuple

G[0, 1]

G[:] returns the full (flattened) list of graphics objects composing G:

sage: G[:]
[Graphics object consisting of 1 graphics primitive,
Graphics object consisting of 1 graphics primitive,
Graphics object consisting of 51 graphics primitives,
Graphics object consisting of 2 graphics primitives]

>>> from sage.all import *
>>> G[:]
[Graphics object consisting of 1 graphics primitive,
Graphics object consisting of 1 graphics primitive,
Graphics object consisting of 51 graphics primitives,
Graphics object consisting of 2 graphics primitives]

G[:]

The total number of Graphics objects composing the array is returned by the function len:

sage: len(G)
4

>>> from sage.all import *
>>> len(G)
4

len(G)

The square-bracket operator can be used to replace elements in the array:

sage: G[0] = g4
sage: G
Graphics Array of size 2 x 2

>>> from sage.all import *
>>> G[Integer(0)] = g4
>>> G
Graphics Array of size 2 x 2

G[0] = g4
G
../../_images/multigraphics-4.svg
append(g)[source]

Append a graphics to the array.

Currently not implemented.

ncols()[source]

Number of columns of the graphics array.

EXAMPLES:

sage: R = rainbow(6)
sage: L = [plot(x^n, (x,0,1), color=R[n]) for n in range(6)]
sage: G = graphics_array(L, 2, 3)
sage: G.ncols()
3
sage: graphics_array(L).ncols()
6

>>> from sage.all import *
>>> R = rainbow(Integer(6))
>>> L = [plot(x**n, (x,Integer(0),Integer(1)), color=R[n]) for n in range(Integer(6))]
>>> G = graphics_array(L, Integer(2), Integer(3))
>>> G.ncols()
3
>>> graphics_array(L).ncols()
6

R = rainbow(6)
L = [plot(x^n, (x,0,1), color=R[n]) for n in range(6)]
G = graphics_array(L, 2, 3)
G.ncols()
graphics_array(L).ncols()
nrows()[source]

Number of rows of the graphics array.

EXAMPLES:

sage: R = rainbow(6)
sage: L = [plot(x^n, (x,0,1), color=R[n]) for n in range(6)]
sage: G = graphics_array(L, 2, 3)
sage: G.nrows()
2
sage: graphics_array(L).nrows()
1

>>> from sage.all import *
>>> R = rainbow(Integer(6))
>>> L = [plot(x**n, (x,Integer(0),Integer(1)), color=R[n]) for n in range(Integer(6))]
>>> G = graphics_array(L, Integer(2), Integer(3))
>>> G.nrows()
2
>>> graphics_array(L).nrows()
1

R = rainbow(6)
L = [plot(x^n, (x,0,1), color=R[n]) for n in range(6)]
G = graphics_array(L, 2, 3)
G.nrows()
graphics_array(L).nrows()
position(index)[source]

Return the position and relative size of an element of self on the canvas.

INPUT:

  • index – integer specifying which element of self

OUTPUT:

  • a 4-tuple (left, bottom, width, height) giving the location and relative size of the element on the canvas, all quantities being expressed in fractions of the canvas width and height

EXAMPLES:

sage: g1 = plot(sin(x), (x, -pi, pi))
sage: g2 = circle((0,1), 1.)
sage: G = graphics_array([g1, g2])
sage: import numpy  # to ensure numpy 2.0 compatibility
sage: if int(numpy.version.short_version[0]) > 1:
....:     numpy.set_printoptions(legacy="1.25")
sage: G.position(0)  # tol 5.0e-3
(0.025045451349937315,
 0.03415488992713045,
 0.4489880779745068,
 0.9345951100728696)
sage: G.position(1)  # tol 5.0e-3
(0.5170637412999687,
 0.20212705964722733,
 0.4489880779745068,
 0.5986507706326758)

>>> from sage.all import *
>>> g1 = plot(sin(x), (x, -pi, pi))
>>> g2 = circle((Integer(0),Integer(1)), RealNumber('1.'))
>>> G = graphics_array([g1, g2])
>>> import numpy  # to ensure numpy 2.0 compatibility
>>> if int(numpy.version.short_version[Integer(0)]) > Integer(1):
...     numpy.set_printoptions(legacy="1.25")
>>> G.position(Integer(0))  # tol 5.0e-3
(0.025045451349937315,
 0.03415488992713045,
 0.4489880779745068,
 0.9345951100728696)
>>> G.position(Integer(1))  # tol 5.0e-3
(0.5170637412999687,
 0.20212705964722733,
 0.4489880779745068,
 0.5986507706326758)

g1 = plot(sin(x), (x, -pi, pi))
g2 = circle((0,1), 1.)
G = graphics_array([g1, g2])
import numpy  # to ensure numpy 2.0 compatibility
if int(numpy.version.short_version[0]) > 1:
    numpy.set_printoptions(legacy="1.25")
G.position(0)  # tol 5.0e-3
G.position(1)  # tol 5.0e-3
class sage.plot.multigraphics.MultiGraphics(graphics_list)[source]

Bases: WithEqualityById, SageObject

Base class for objects composed of Graphics objects.

Both the display and the output to a file of MultiGraphics objects are governed by the method save(), which is called by the rich output display manager, via graphics_from_save().

The user interface is through the functions multi_graphics() (generic multi-graphics) and graphics_array() (subclass GraphicsArray).

INPUT:

  • graphics_list – list of graphics along with their positions on the common canvas; each element of graphics_list is either

    • a pair (graphics, position), where graphics is a Graphics object and position is the 4-tuple (left, bottom, width, height) specifying the location and size of the graphics on the canvas, all quantities being in fractions of the canvas width and height

    • or a single Graphics object; its position is then assumed to occupy the whole canvas, except for some padding; this corresponds to the default position (left, bottom, width, height) = (0.125, 0.11, 0.775, 0.77)

EXAMPLES:

A multi-graphics made from two graphics objects:

sage: g1 = plot(sin(x^3), (x, -pi, pi))
sage: g2 = circle((0,0), 1, color='red')
sage: G = multi_graphics([g1, (g2, (0.2, 0.55, 0.3, 0.3))])
sage: G
Multigraphics with 2 elements

>>> from sage.all import *
>>> g1 = plot(sin(x**Integer(3)), (x, -pi, pi))
>>> g2 = circle((Integer(0),Integer(0)), Integer(1), color='red')
>>> G = multi_graphics([g1, (g2, (RealNumber('0.2'), RealNumber('0.55'), RealNumber('0.3'), RealNumber('0.3')))])
>>> G
Multigraphics with 2 elements

g1 = plot(sin(x^3), (x, -pi, pi))
g2 = circle((0,0), 1, color='red')
G = multi_graphics([g1, (g2, (0.2, 0.55, 0.3, 0.3))])
G
../../_images/multigraphics-5.svg

Since no position was given for g1, it occupies the whole canvas. Moreover, we note that g2 has been drawn over g1 with a white background. To have a transparent background instead, one has to construct g2 with the keyword transparent set to True:

sage: g2 = circle((0,0), 1, color='red', transparent=True)
sage: G = multi_graphics([g1, (g2, (0.2, 0.55, 0.3, 0.3))])
sage: G
Multigraphics with 2 elements

>>> from sage.all import *
>>> g2 = circle((Integer(0),Integer(0)), Integer(1), color='red', transparent=True)
>>> G = multi_graphics([g1, (g2, (RealNumber('0.2'), RealNumber('0.55'), RealNumber('0.3'), RealNumber('0.3')))])
>>> G
Multigraphics with 2 elements

g2 = circle((0,0), 1, color='red', transparent=True)
G = multi_graphics([g1, (g2, (0.2, 0.55, 0.3, 0.3))])
G
../../_images/multigraphics-6.svg

We can add a new graphics object to G via the method append():

sage: g3 = complex_plot(zeta, (-20, 10), (-20, 20),
....:                   axes_labels=['$x$', '$y$'], frame=True)
sage: G.append(g3, pos=(0.63, 0.12, 0.3, 0.3))
sage: G
Multigraphics with 3 elements

>>> from sage.all import *
>>> g3 = complex_plot(zeta, (-Integer(20), Integer(10)), (-Integer(20), Integer(20)),
...                   axes_labels=['$x$', '$y$'], frame=True)
>>> G.append(g3, pos=(RealNumber('0.63'), RealNumber('0.12'), RealNumber('0.3'), RealNumber('0.3')))
>>> G
Multigraphics with 3 elements

g3 = complex_plot(zeta, (-20, 10), (-20, 20),
                  axes_labels=['$x$', '$y$'], frame=True)
G.append(g3, pos=(0.63, 0.12, 0.3, 0.3))
G
../../_images/multigraphics-7.svg

We can access the individual elements composing G with the square-bracket operator:

sage: print(G[0])
Graphics object consisting of 1 graphics primitive
sage: G[0] is g1
True
sage: G[1] is g2
True
sage: G[2] is g3
True

>>> from sage.all import *
>>> print(G[Integer(0)])
Graphics object consisting of 1 graphics primitive
>>> G[Integer(0)] is g1
True
>>> G[Integer(1)] is g2
True
>>> G[Integer(2)] is g3
True

print(G[0])
G[0] is g1
G[1] is g2
G[2] is g3

G[:] returns the full list of graphics objects composing G:

sage: G[:]
[Graphics object consisting of 1 graphics primitive,
 Graphics object consisting of 1 graphics primitive,
 Graphics object consisting of 1 graphics primitive]
sage: len(G)
3

>>> from sage.all import *
>>> G[:]
[Graphics object consisting of 1 graphics primitive,
 Graphics object consisting of 1 graphics primitive,
 Graphics object consisting of 1 graphics primitive]
>>> len(G)
3

G[:]
len(G)
append(graphics, pos=None)[source]

Append a graphics object to self.

INPUT:

  • graphics – the graphics object (instance of Graphics) to be added to self

  • pos – (default: None) 4-tuple (left, bottom, width, height) specifying the location and size of graphics on the canvas, all quantities being in fractions of the canvas width and height; if None, graphics is assumed to occupy the whole canvas, except for some padding; this corresponds to the default position (left, bottom, width, height) = (0.125, 0.11, 0.775, 0.77)

EXAMPLES:

Let us consider a multigraphics with 2 elements:

sage: g1 = plot(chebyshev_T(4, x), (x, -1, 1), title='n=4')
sage: g2 = plot(chebyshev_T(8, x), (x, -1, 1), title='n=8',
....:           color='red')
sage: G = multi_graphics([(g1, (0.125, 0.2, 0.4, 0.4)),
....:                     (g2, (0.55, 0.4, 0.4, 0.4))])
sage: G
Multigraphics with 2 elements

>>> from sage.all import *
>>> g1 = plot(chebyshev_T(Integer(4), x), (x, -Integer(1), Integer(1)), title='n=4')
>>> g2 = plot(chebyshev_T(Integer(8), x), (x, -Integer(1), Integer(1)), title='n=8',
...           color='red')
>>> G = multi_graphics([(g1, (RealNumber('0.125'), RealNumber('0.2'), RealNumber('0.4'), RealNumber('0.4'))),
...                     (g2, (RealNumber('0.55'), RealNumber('0.4'), RealNumber('0.4'), RealNumber('0.4')))])
>>> G
Multigraphics with 2 elements

g1 = plot(chebyshev_T(4, x), (x, -1, 1), title='n=4')
g2 = plot(chebyshev_T(8, x), (x, -1, 1), title='n=8',
          color='red')
G = multi_graphics([(g1, (0.125, 0.2, 0.4, 0.4)),
                    (g2, (0.55, 0.4, 0.4, 0.4))])
G
../../_images/multigraphics-8.svg

We append a third plot to it:

sage: g3 = plot(chebyshev_T(16, x), (x, -1, 1), title='n=16',
....:           color='brown')
sage: G.append(g3, pos=(0.55, 0.11, 0.4, 0.15))
sage: G
Multigraphics with 3 elements

>>> from sage.all import *
>>> g3 = plot(chebyshev_T(Integer(16), x), (x, -Integer(1), Integer(1)), title='n=16',
...           color='brown')
>>> G.append(g3, pos=(RealNumber('0.55'), RealNumber('0.11'), RealNumber('0.4'), RealNumber('0.15')))
>>> G
Multigraphics with 3 elements

g3 = plot(chebyshev_T(16, x), (x, -1, 1), title='n=16',
          color='brown')
G.append(g3, pos=(0.55, 0.11, 0.4, 0.15))
G
../../_images/multigraphics-9.svg

We may use append to add a title:

sage: title = text("Chebyshev polynomials", (0, 0), fontsize=16,
....:              axes=False)
sage: G.append(title, pos=(0.18, 0.8, 0.7, 0.1))
sage: G
Multigraphics with 4 elements

>>> from sage.all import *
>>> title = text("Chebyshev polynomials", (Integer(0), Integer(0)), fontsize=Integer(16),
...              axes=False)
>>> G.append(title, pos=(RealNumber('0.18'), RealNumber('0.8'), RealNumber('0.7'), RealNumber('0.1')))
>>> G
Multigraphics with 4 elements

title = text("Chebyshev polynomials", (0, 0), fontsize=16,
             axes=False)
G.append(title, pos=(0.18, 0.8, 0.7, 0.1))
G
../../_images/multigraphics-10.svg

See also

inset()

inset(graphics, pos=None, fontsize=None)[source]

Add a graphics object as an inset.

INPUT:

  • graphics – the graphics object (instance of Graphics) to be added as an inset

  • pos – (default: None) 4-tuple (left, bottom, width, height) specifying the location and relative size of the inset on the canvas, all quantities being expressed in fractions of the canvas width and height; if None, the value (0.7, 0.7, 0.2, 0.2) is used

  • fontsize – (default: None) integer, font size (in points) for the inset; if None, the value of 6 points is used, unless fontsize has been explicitly set in the construction of graphics (in this case, it is not overwritten here)

OUTPUT: instance of MultiGraphics

EXAMPLES:

Let us consider a graphics array of 2 elements:

sage: G = graphics_array([plot(sin, (0, 2*pi)),
....:                     plot(cos, (0, 2*pi))])
sage: G
Graphics Array of size 1 x 2

>>> from sage.all import *
>>> G = graphics_array([plot(sin, (Integer(0), Integer(2)*pi)),
...                     plot(cos, (Integer(0), Integer(2)*pi))])
>>> G
Graphics Array of size 1 x 2

G = graphics_array([plot(sin, (0, 2*pi)),
                    plot(cos, (0, 2*pi))])
G
../../_images/multigraphics-11.svg

and add some inset at the default position:

sage: c = circle((0,0), 1, color='red', thickness=2, frame=True)
sage: G.inset(c)
Multigraphics with 3 elements

>>> from sage.all import *
>>> c = circle((Integer(0),Integer(0)), Integer(1), color='red', thickness=Integer(2), frame=True)
>>> G.inset(c)
Multigraphics with 3 elements

c = circle((0,0), 1, color='red', thickness=2, frame=True)
G.inset(c)
../../_images/multigraphics-12.svg

We may customize the position and font size of the inset:

sage: G.inset(c, pos=(0.3, 0.7, 0.2, 0.2), fontsize=8)
Multigraphics with 3 elements

>>> from sage.all import *
>>> G.inset(c, pos=(RealNumber('0.3'), RealNumber('0.7'), RealNumber('0.2'), RealNumber('0.2')), fontsize=Integer(8))
Multigraphics with 3 elements

G.inset(c, pos=(0.3, 0.7, 0.2, 0.2), fontsize=8)
../../_images/multigraphics-13.svg
matplotlib(figure=None, figsize=None, **kwds)[source]

Construct or modify a Matplotlib figure by drawing self on it.

INPUT:

  • figure – (default: None) Matplotlib figure (class matplotlib.figure.Figure) on which self is to be displayed; if None, the figure will be created from the parameter figsize

  • figsize – (default: None) width or [width, height] in inches of the Matplotlib figure in case figure is None; if figsize is None, Matplotlib’s default (6.4 x 4.8 inches) is used

  • kwds – options passed to the matplotlib() method of each graphics object constituting self

OUTPUT:

  • a matplotlib.figure.Figure object; if the argument figure is provided, this is the same object as figure.

EXAMPLES:

Let us consider a GraphicsArray object with 3 elements:

sage: G = graphics_array([plot(sin(x^k), (x, 0, 3))
....:                     for k in range(1, 4)])

>>> from sage.all import *
>>> G = graphics_array([plot(sin(x**k), (x, Integer(0), Integer(3)))
...                     for k in range(Integer(1), Integer(4))])

G = graphics_array([plot(sin(x^k), (x, 0, 3))
                    for k in range(1, 4)])

If matplotlib() is invoked without any argument, a Matplotlib figure is created and contains the 3 graphics element of the array as 3 Matplotlib Axes:

sage: fig = G.matplotlib()
sage: fig
<Figure size 640x480 with 3 Axes>
sage: type(fig)
<class 'matplotlib.figure.Figure'>

>>> from sage.all import *
>>> fig = G.matplotlib()
>>> fig
<Figure size 640x480 with 3 Axes>
>>> type(fig)
<class 'matplotlib.figure.Figure'>

fig = G.matplotlib()
fig
type(fig)

Specifying the figure size (in inches):

sage: G.matplotlib(figsize=(8., 5.))
<Figure size 800x500 with 3 Axes>

>>> from sage.all import *
>>> G.matplotlib(figsize=(RealNumber('8.'), RealNumber('5.')))
<Figure size 800x500 with 3 Axes>

G.matplotlib(figsize=(8., 5.))

If a single number is provided for figsize, it is considered to be the width; the height is then computed according to Matplotlib’s default aspect ratio (4/3):

sage: G.matplotlib(figsize=8.)
<Figure size 800x600 with 3 Axes>

>>> from sage.all import *
>>> G.matplotlib(figsize=RealNumber('8.'))
<Figure size 800x600 with 3 Axes>

G.matplotlib(figsize=8.)

An example of use with a preexisting created figure, created by pyplot:

sage: import matplotlib.pyplot as plt
sage: fig1 = plt.figure(1)
sage: fig1
<Figure size 640x480 with 0 Axes>
sage: fig_out = G.matplotlib(figure=fig1)
sage: fig_out
<Figure size 640x480 with 3 Axes>

>>> from sage.all import *
>>> import matplotlib.pyplot as plt
>>> fig1 = plt.figure(Integer(1))
>>> fig1
<Figure size 640x480 with 0 Axes>
>>> fig_out = G.matplotlib(figure=fig1)
>>> fig_out
<Figure size 640x480 with 3 Axes>

import matplotlib.pyplot as plt
fig1 = plt.figure(1)
fig1
fig_out = G.matplotlib(figure=fig1)
fig_out

Note that the output figure is the same object as the input one:

sage: fig_out is fig1
True

>>> from sage.all import *
>>> fig_out is fig1
True

fig_out is fig1

It has however been modified by G.matplotlib(figure=fig1), which has added 3 new Axes to it.

Another example, with a figure created from scratch, via Matplolib’s Figure:

sage: from matplotlib.figure import Figure
sage: fig2 = Figure()
sage: fig2
<Figure size 640x480 with 0 Axes>
sage: G.matplotlib(figure=fig2)
<Figure size 640x480 with 3 Axes>
sage: fig2
<Figure size 640x480 with 3 Axes>

>>> from sage.all import *
>>> from matplotlib.figure import Figure
>>> fig2 = Figure()
>>> fig2
<Figure size 640x480 with 0 Axes>
>>> G.matplotlib(figure=fig2)
<Figure size 640x480 with 3 Axes>
>>> fig2
<Figure size 640x480 with 3 Axes>

from matplotlib.figure import Figure
fig2 = Figure()
fig2
G.matplotlib(figure=fig2)
fig2
plot()[source]

Return self since self is already a graphics object.

EXAMPLES:

sage: g1 = plot(cos, 0, 1)
sage: g2 = circle((0,0), 1)
sage: G = multi_graphics([g1, g2])
sage: G.plot() is G
True

>>> from sage.all import *
>>> g1 = plot(cos, Integer(0), Integer(1))
>>> g2 = circle((Integer(0),Integer(0)), Integer(1))
>>> G = multi_graphics([g1, g2])
>>> G.plot() is G
True

g1 = plot(cos, 0, 1)
g2 = circle((0,0), 1)
G = multi_graphics([g1, g2])
G.plot() is G
position(index)[source]

Return the position and relative size of an element of self on the canvas.

INPUT:

  • index – integer specifying which element of self

OUTPUT:

  • a 4-tuple (left, bottom, width, height) giving the location and relative size of the element on the canvas, all quantities being expressed in fractions of the canvas width and height

EXAMPLES:

sage: g1 = plot(sin(x^2), (x, 0, 4))
sage: g2 = circle((0,0), 1, rgbcolor='red', fill=True, axes=False)
sage: G = multi_graphics([g1, (g2, (0.15, 0.2, 0.1, 0.15))])
sage: G.position(0)  # tol 1.0e-13
(0.125, 0.11, 0.775, 0.77)
sage: G.position(1)  # tol 1.0e-13
(0.15, 0.2, 0.1, 0.15)

>>> from sage.all import *
>>> g1 = plot(sin(x**Integer(2)), (x, Integer(0), Integer(4)))
>>> g2 = circle((Integer(0),Integer(0)), Integer(1), rgbcolor='red', fill=True, axes=False)
>>> G = multi_graphics([g1, (g2, (RealNumber('0.15'), RealNumber('0.2'), RealNumber('0.1'), RealNumber('0.15')))])
>>> G.position(Integer(0))  # tol 1.0e-13
(0.125, 0.11, 0.775, 0.77)
>>> G.position(Integer(1))  # tol 1.0e-13
(0.15, 0.2, 0.1, 0.15)

g1 = plot(sin(x^2), (x, 0, 4))
g2 = circle((0,0), 1, rgbcolor='red', fill=True, axes=False)
G = multi_graphics([g1, (g2, (0.15, 0.2, 0.1, 0.15))])
G.position(0)  # tol 1.0e-13
G.position(1)  # tol 1.0e-13
save(filename, figsize=None, **kwds)[source]

Save self to a file, in various formats.

INPUT:

  • filename – string; the file name. The image format is given by the extension, which can be one of the following:

    • .eps,

    • .pdf,

    • .png,

    • .ps,

    • .sobj (for a Sage object you can load later),

    • .svg,

    • empty extension will be treated as .sobj.

  • figsize – (default: None) width or [width, height] in inches of the Matplotlib figure; if none is provided, Matplotlib’s default (6.4 x 4.8 inches) is used

  • kwds – keyword arguments, like dpi=..., passed to the plotter, see show()

EXAMPLES:

sage: F = tmp_filename(ext='.png')
sage: L = [plot(sin(k*x), (x,-pi,pi)) for k in [1..3]]
sage: G = graphics_array(L)
sage: G.save(F, dpi=500, axes=False)

>>> from sage.all import *
>>> F = tmp_filename(ext='.png')
>>> L = [plot(sin(k*x), (x,-pi,pi)) for k in (ellipsis_range(Integer(1),Ellipsis,Integer(3)))]
>>> G = graphics_array(L)
>>> G.save(F, dpi=Integer(500), axes=False)

F = tmp_filename(ext='.png')
L = [plot(sin(k*x), (x,-pi,pi)) for k in [1..3]]
G = graphics_array(L)
G.save(F, dpi=500, axes=False)
save_image(filename=None, *args, **kwds)[source]

Save an image representation of self. The image type is determined by the extension of the filename. For example, this could be .png, .jpg, .gif, .pdf, .svg. Currently this is implemented by calling the save() method of self, passing along all arguments and keywords.

Note

Not all image types are necessarily implemented for all graphics types. See save() for more details.

EXAMPLES:

sage: plots = [[plot(m*cos(x + n*pi/4), (x, 0, 2*pi))
....:           for n in range(3)] for m in range(1,3)]
sage: G = graphics_array(plots)
sage: G.save_image(tmp_filename(ext='.png'))

>>> from sage.all import *
>>> plots = [[plot(m*cos(x + n*pi/Integer(4)), (x, Integer(0), Integer(2)*pi))
...           for n in range(Integer(3))] for m in range(Integer(1),Integer(3))]
>>> G = graphics_array(plots)
>>> G.save_image(tmp_filename(ext='.png'))

plots = [[plot(m*cos(x + n*pi/4), (x, 0, 2*pi))
          for n in range(3)] for m in range(1,3)]
G = graphics_array(plots)
G.save_image(tmp_filename(ext='.png'))
show(**kwds)[source]

Show self immediately.

This method attempts to display the graphics immediately, without waiting for the currently running code (if any) to return to the command line. Be careful, calling it from within a loop will potentially launch a large number of external viewer programs.

OPTIONAL INPUT:

  • dpi – dots per inch

  • figsize – width or [width, height] of the figure, in inches; the default is 6.4 x 4.8 inches

  • axes – boolean; if True, all individual graphics are endowed with axes; if False, all axes are removed (this overrides the axes option set in each graphics)

  • frame – boolean; if True, all individual graphics are drawn with a frame around them; if False, all frames are removed (this overrides the frame option set in each graphics)

  • fontsize – positive integer, the size of fonts for the axes labels (this overrides the fontsize option set in each graphics)

OUTPUT:

This method does not return anything. Use save() if you want to save the figure as an image.

EXAMPLES:

This draws a graphics array with four trig plots and no axes in any of the plots and a figure width of 4 inches:

sage: G = graphics_array([[plot(sin), plot(cos)],
....:                     [plot(tan), plot(sec)]])
sage: G.show(axes=False, figsize=4)

>>> from sage.all import *
>>> G = graphics_array([[plot(sin), plot(cos)],
...                     [plot(tan), plot(sec)]])
>>> G.show(axes=False, figsize=Integer(4))

G = graphics_array([[plot(sin), plot(cos)],
                    [plot(tan), plot(sec)]])
G.show(axes=False, figsize=4)
../../_images/multigraphics-14.svg

Same thing with a frame around each individual graphics:

sage: G.show(axes=False, frame=True, figsize=4)

>>> from sage.all import *
>>> G.show(axes=False, frame=True, figsize=Integer(4))

G.show(axes=False, frame=True, figsize=4)
../../_images/multigraphics-15.svg

Actually, many options are possible; for instance, we may set fontsize and gridlines:

sage: G.show(axes=False, frame=True, figsize=4, fontsize=8,
....:        gridlines='major')

>>> from sage.all import *
>>> G.show(axes=False, frame=True, figsize=Integer(4), fontsize=Integer(8),
...        gridlines='major')

G.show(axes=False, frame=True, figsize=4, fontsize=8,
       gridlines='major')
../../_images/multigraphics-16.svg