Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
# -*- encoding: utf-8 -*- r""" Graphics objects
This file contains the definition of the classes :class:`Graphics` and :class:`GraphicsArray`. Usually, you don't create these classes directly (although you can do it), you would use :func:`plot` or :func:`graphics_array` instead.
AUTHORS:
- Jeroen Demeyer (2012-04-19): split off this file from plot.py (:trac:`12857`) - Punarbasu Purkayastha (2012-05-20): Add logarithmic scale (:trac:`4529`) - Emily Chen (2013-01-05): Add documentation for :meth:`~sage.plot.graphics.Graphics.show` figsize parameter (:trac:`5956`) - Eric Gourgoulhon (2015-03-19): Add parameter axes_labels_size (:trac:`18004`)
"""
#***************************************************************************** # Copyright (C) 2006 Alex Clemesha <clemesha@gmail.com> # Copyright (C) 2006-2008 William Stein <wstein@gmail.com> # Copyright (C) 2010 Jason Grout # # Distributed under the terms of the GNU General Public License (GPL) # as published by the Free Software Foundation; either version 2 of # the License, or (at your option) any later version. # http://www.gnu.org/licenses/ #***************************************************************************** from __future__ import print_function, absolute_import from six.moves import zip from six import integer_types
import os from math import isnan import sage.misc.misc from sage.misc.html import html from sage.misc.temporary_file import tmp_filename from sage.misc.fast_methods import WithEqualityById from sage.structure.sage_object import SageObject from sage.misc.decorators import suboptions from .colors import rgbcolor
ALLOWED_EXTENSIONS = ['.eps', '.pdf', '.pgf', '.png', '.ps', '.sobj', '.svg'] DEFAULT_DPI = 100
# If do_verify is True, options are checked when drawing a # GraphicsPrimitive. See primitive.py do_verify = True
def is_Graphics(x): """ Return True if `x` is a Graphics object.
EXAMPLES::
sage: from sage.plot.graphics import is_Graphics sage: is_Graphics(1) False sage: is_Graphics(disk((0.0, 0.0), 1, (0, pi/2))) True """
class Graphics(WithEqualityById, SageObject): """ The Graphics object is an empty list of graphics objects. It is useful to use this object when initializing a for loop where different graphics object will be added to the empty object.
EXAMPLES::
sage: G = Graphics(); print(G) Graphics object consisting of 0 graphics primitives sage: c = circle((1,1), 1) sage: G+=c; print(G) Graphics object consisting of 1 graphics primitive
Here we make a graphic of embedded isosceles triangles, coloring each one with a different color as we go::
sage: h=10; c=0.4; p=0.5; sage: G = Graphics() sage: for x in srange(1,h+1): ....: l = [[0,x*sqrt(3)],[-x/2,-x*sqrt(3)/2],[x/2,-x*sqrt(3)/2],[0,x*sqrt(3)]] ....: G+=line(l,color=hue(c + p*(x/h))) sage: G.show(figsize=[5,5])
We can change the scale of the axes in the graphics before displaying.::
sage: G = plot(exp, 1, 10) # long time sage: G.show(scale='semilogy') # long time
TESTS:
From :trac:`4604`, ensure Graphics can handle 3d objects::
sage: g = Graphics() sage: g += sphere((1, 1, 1), 2) sage: g.show()
We check that graphics can be pickled (we can't use equality on graphics so we just check that the load/dump cycle gives a :class:`Graphics` instance)::
sage: g = Graphics() sage: g2 = loads(dumps(g)) sage: g2.show()
::
sage: isinstance(g2, Graphics) True
sage: hash(Graphics()) # random 42
.. automethod:: _rich_repr_ """
def __init__(self): """ Create a new empty Graphics objects with all the defaults.
EXAMPLES::
sage: G = Graphics() """
def set_aspect_ratio(self, ratio): """ Set the aspect ratio, which is the ratio of height and width of a unit square (i.e., height/width of a unit square), or 'automatic' (expand to fill the figure).
INPUT:
- ``ratio`` - a positive real number or 'automatic'
EXAMPLES: We create a plot of the upper half of a circle, but it doesn't look round because the aspect ratio is off::
sage: P = plot(sqrt(1-x^2),(x,-1,1)); P Graphics object consisting of 1 graphics primitive
So we set the aspect ratio and now it is round::
sage: P.set_aspect_ratio(1) sage: P.aspect_ratio() 1.0 sage: P Graphics object consisting of 1 graphics primitive
Note that the aspect ratio is inherited upon addition (which takes the max of aspect ratios of objects whose aspect ratio has been set)::
sage: P + plot(sqrt(4-x^2),(x,-2,2)) Graphics object consisting of 2 graphics primitives
In the following example, both plots produce a circle that looks twice as tall as wide::
sage: Q = circle((0,0), 0.5); Q.set_aspect_ratio(2) sage: (P + Q).aspect_ratio(); P+Q 2.0 Graphics object consisting of 2 graphics primitives sage: (Q + P).aspect_ratio(); Q+P 2.0 Graphics object consisting of 2 graphics primitives """ raise ValueError("the aspect ratio must be positive or 'automatic'") else:
def aspect_ratio(self): """ Get the current aspect ratio, which is the ratio of height to width of a unit square, or 'automatic'.
OUTPUT: a positive float (height/width of a unit square), or 'automatic' (expand to fill the figure).
EXAMPLES:
The default aspect ratio for a new blank Graphics object is 'automatic'::
sage: P = Graphics() sage: P.aspect_ratio() 'automatic'
The aspect ratio can be explicitly set different than the object's default::
sage: P = circle((1,1), 1) sage: P.aspect_ratio() 1.0 sage: P.set_aspect_ratio(2) sage: P.aspect_ratio() 2.0 sage: P.set_aspect_ratio('automatic') sage: P.aspect_ratio() 'automatic' """
def legend(self, show=None): r""" Set whether or not the legend is shown by default.
INPUT:
- ``show`` - (default: None) a boolean
If called with no input, return the current legend setting.
EXAMPLES:
By default no legend is displayed::
sage: P = plot(sin) sage: P.legend() False
But if we put a label then the legend is shown::
sage: P = plot(sin, legend_label='sin') sage: P.legend() True
We can turn it on or off::
sage: P.legend(False) sage: P.legend() False sage: P.legend(True) sage: P # show with the legend Graphics object consisting of 1 graphics primitive """ else:
def set_legend_options(self, **kwds): r""" Set various legend options.
INPUT:
- ``title`` - (default: None) string, the legend title
- ``ncol`` - (default: 1) positive integer, the number of columns
- ``columnspacing`` - (default: None) the spacing between columns
- ``borderaxespad`` - (default: None) float, length between the axes and the legend
- ``back_color`` - (default: 'white') This parameter can be a string denoting a color or an RGB tuple. The string can be a color name as in ('red', 'green', 'yellow', ...) or a floating point number like '0.8' which gets expanded to (0.8, 0.8, 0.8). The tuple form is just a floating point RGB tuple with all values ranging from 0 to 1.
- ``handlelength`` - (default: 0.05) float, the length of the legend handles
- ``handletextpad`` - (default: 0.5) float, the pad between the legend handle and text
- ``labelspacing`` - (default: 0.02) float, vertical space between legend entries
- ``loc`` - (default: 'best') May be a string, an integer or a tuple. String or integer inputs must be one of the following:
- 0, 'best'
- 1, 'upper right'
- 2, 'upper left'
- 3, 'lower left'
- 4, 'lower right'
- 5, 'right'
- 6, 'center left'
- 7, 'center right'
- 8, 'lower center'
- 9, 'upper center'
- 10, 'center'
- Tuple arguments represent an absolute (x, y) position on the plot in axes coordinates (meaning from 0 to 1 in each direction).
- ``markerscale`` - (default: 0.6) float, how much to scale the markers in the legend.
- ``numpoints`` - (default: 2) integer, the number of points in the legend for line
- ``borderpad`` - (default: 0.6) float, the fractional whitespace inside the legend border (between 0 and 1)
- ``font_family`` - (default: 'sans-serif') string, one of 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'
- ``font_style`` - (default: 'normal') string, one of 'normal', 'italic', 'oblique'
- ``font_variant`` - (default: 'normal') string, one of 'normal', 'small-caps'
- ``font_weight`` - (default: 'medium') string, one of 'black', 'extra bold', 'bold', 'semibold', 'medium', 'normal', 'light'
- ``font_size`` - (default: 'medium') string, one of 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large' or an absolute font size (e.g. 12)
- ``shadow`` - (default: True) boolean - draw a shadow behind the legend
- ``fancybox`` - (default: False) a boolean. If True, draws a frame with a round fancybox.
These are all keyword arguments.
OUTPUT: a dictionary of all current legend options
EXAMPLES:
By default, no options are set::
sage: p = plot(tan, legend_label='tan') sage: p.set_legend_options() {}
We build a legend without a shadow::
sage: p.set_legend_options(shadow=False) sage: p.set_legend_options()['shadow'] False
To set the legend position to the center of the plot, all these methods are roughly equivalent::
sage: p.set_legend_options(loc='center'); p Graphics object consisting of 1 graphics primitive
::
sage: p.set_legend_options(loc=10); p Graphics object consisting of 1 graphics primitive
::
sage: p.set_legend_options(loc=(0.5,0.5)); p # aligns the bottom of the box to the center Graphics object consisting of 1 graphics primitive """ else:
def get_axes_range(self): """ Returns a dictionary of the range of the axes for this graphics object. This is fall back to the ranges in get_minmax_data() for any value which the user has not explicitly set.
.. warning::
Changing the dictionary returned by this function does not change the axes range for this object. To do that, use the :meth:`set_axes_range` method.
EXAMPLES::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)]) sage: list(sorted(L.get_axes_range().items())) [('xmax', 3.0), ('xmin', 1.0), ('ymax', 5.0), ('ymin', -4.0)] sage: L.set_axes_range(xmin=-1) sage: list(sorted(L.get_axes_range().items())) [('xmax', 3.0), ('xmin', -1.0), ('ymax', 5.0), ('ymin', -4.0)] """
def set_axes_range(self, xmin=None, xmax=None, ymin=None, ymax=None): """ Set the ranges of the `x` and `y` axes.
INPUT:
- ``xmin, xmax, ymin, ymax`` - floats
EXAMPLES::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)]) sage: L.set_axes_range(-1, 20, 0, 2) sage: d = L.get_axes_range() sage: d['xmin'], d['xmax'], d['ymin'], d['ymax'] (-1.0, 20.0, 0.0, 2.0) """
axes_range = set_axes_range
def _get_axes_range_dict(self): """ Returns the underlying dictionary used to store the user's custom ranges for the axes on this object.
EXAMPLES::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)]) sage: L._get_axes_range_dict() {} sage: L.set_axes_range(xmin=-1) sage: L._get_axes_range_dict() {'xmin': -1.0} """
def fontsize(self, s=None): """ Set the font size of axes labels and tick marks.
Note that the relative size of the axes labels font w.r.t. the tick marks font can be adjusted via :meth:`axes_labels_size`.
INPUT:
- ``s`` - integer, a font size in points.
If called with no input, return the current fontsize.
EXAMPLES::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)]) sage: L.fontsize() 10 sage: L.fontsize(20) sage: L.fontsize() 20
All the numbers on the axes will be very large in this plot::
sage: L Graphics object consisting of 1 graphics primitive """ except AttributeError: self._fontsize = 10 return self._fontsize
def axes_labels_size(self, s=None): """ Set the relative size of axes labels w.r.t. the axes tick marks.
INPUT:
- ``s`` - float, relative size of axes labels w.r.t. to the tick marks, the size of the tick marks being set by :meth:`fontsize`.
If called with no input, return the current relative size.
EXAMPLES::
sage: p = plot(sin(x^2), (x, -3, 3), axes_labels=['$x$','$y$']) sage: p.axes_labels_size() # default value 1.6 sage: p.axes_labels_size(2.5) sage: p.axes_labels_size() 2.5
Now the axes labels are large w.r.t. the tick marks::
sage: p Graphics object consisting of 1 graphics primitive
""" except AttributeError: self._axes_labels_size = 1.6 return self._axes_labels_size
def axes(self, show=None): """ Set whether or not the `x` and `y` axes are shown by default.
INPUT:
- ``show`` - bool
If called with no input, return the current axes setting.
EXAMPLES::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)])
By default the axes are displayed.
::
sage: L.axes() True
But we turn them off, and verify that they are off
::
sage: L.axes(False) sage: L.axes() False
Displaying L now shows a triangle but no axes.
::
sage: L Graphics object consisting of 1 graphics primitive """ except AttributeError: self._show_axes = True return self._show_axes
def axes_color(self, c=None): """ Set the axes color.
If called with no input, return the current axes_color setting.
INPUT:
- ``c`` - an RGB color 3-tuple, where each tuple entry is a float between 0 and 1
EXAMPLES: We create a line, which has like everything a default axes color of black.
::
sage: L = line([(1,2), (3,-4), (2, 5), (1,2)]) sage: L.axes_color() (0, 0, 0)
We change the axes color to red and verify the change.
::
sage: L.axes_color((1,0,0)) sage: L.axes_color() (1.0, 0.0, 0.0)
When we display the plot, we'll see a blue triangle and bright red axes.
::
sage: L Graphics object consisting of 1 graphics primitive """
except AttributeError: self._axes_color = (0.0, 0.0, 0.0) return self._axes_color
def axes_labels(self, l=None): """ Set the axes labels.
INPUT:
- ``l`` - (default: None) a list of two strings or None
OUTPUT: a 2-tuple of strings
If l is None, returns the current ``axes_labels``, which is itself by default None. The default labels are both empty.
EXAMPLES: We create a plot and put x and y axes labels on it.
::
sage: p = plot(sin(x), (x, 0, 10)) sage: p.axes_labels(['$x$','$y$']) sage: p.axes_labels() ('$x$', '$y$')
Now when you plot p, you see x and y axes labels::
sage: p Graphics object consisting of 1 graphics primitive
Notice that some may prefer axes labels which are not typeset::
sage: plot(sin(x), (x, 0, 10), axes_labels=['x','y']) Graphics object consisting of 1 graphics primitive
TESTS:
Unicode strings are acceptable; see :trac:`13161`. Note that this does not guarantee that matplotlib will handle the strings properly, although it should.
::
sage: c = circle((0,0), 1) sage: c.axes_labels(['axe des abscisses', u'axe des ordonnées']) sage: c._axes_labels ('axe des abscisses', u'axe des ordonn\xe9es') """ raise TypeError("l must be a list or tuple") raise ValueError("l must have length 2")
def axes_label_color(self, c=None): r""" Set the color of the axes labels.
The axes labels are placed at the edge of the x and y axes, and are not on by default (use the ``axes_labels`` command to set them; see the example below). This function just changes their color.
INPUT:
- ``c`` - an RGB 3-tuple of numbers between 0 and 1
If called with no input, return the current axes_label_color setting.
EXAMPLES: We create a plot, which by default has axes label color black.
::
sage: p = plot(sin, (-1,1)) sage: p.axes_label_color() (0, 0, 0)
We change the labels to be red, and confirm this::
sage: p.axes_label_color((1,0,0)) sage: p.axes_label_color() (1.0, 0.0, 0.0)
We set labels, since otherwise we won't see anything.
::
sage: p.axes_labels(['$x$ axis', '$y$ axis'])
In the plot below, notice that the labels are red::
sage: p Graphics object consisting of 1 graphics primitive """ except AttributeError: self._axes_label_color = (0, 0, 0) return self._axes_label_color
def axes_width(self, w=None): r""" Set the axes width. Use this to draw a plot with really fat or really thin axes.
INPUT:
- ``w`` - a float
If called with no input, return the current ``axes_width`` setting.
EXAMPLES: We create a plot, see the default axes width (with funny Python float rounding), then reset the width to 10 (very fat).
::
sage: p = plot(cos, (-3,3)) sage: p.axes_width() 0.8 sage: p.axes_width(10) sage: p.axes_width() 10.0
Finally we plot the result, which is a graph with very fat axes.
::
sage: p Graphics object consisting of 1 graphics primitive """ except AttributeError: self._axes_width = True return self._axes_width
def tick_label_color(self, c=None): """ Set the color of the axes tick labels.
INPUT:
- ``c`` - an RGB 3-tuple of numbers between 0 and 1
If called with no input, return the current tick_label_color setting.
EXAMPLES::
sage: p = plot(cos, (-3,3)) sage: p.tick_label_color() (0, 0, 0) sage: p.tick_label_color((1,0,0)) sage: p.tick_label_color() (1.0, 0.0, 0.0) sage: p Graphics object consisting of 1 graphics primitive """ except AttributeError: self._tick_label_color = (0, 0, 0) return self._tick_label_color
def _repr_(self): r""" Return a string representation of the graphics objects.
OUTPUT:
String.
EXAMPLES:
We create a plot and call :meth:`show` on it, which causes it to be displayed as a plot::
sage: P = plot(cos, (-1,1)) sage: P.show()
Just doing this also displays the plot::
sage: P Graphics object consisting of 1 graphics primitive
Using the Python `repr` or `str` commands do not display the plot::
sage: repr(P) 'Graphics object consisting of 1 graphics primitive' sage: str(P) 'Graphics object consisting of 1 graphics primitive' sage: print(P) Graphics object consisting of 1 graphics primitive
TESTS::
sage: P._repr_() 'Graphics object consisting of 1 graphics primitive' """
def _rich_repr_(self, display_manager, **kwds): """ Rich Output Magic Method
See :mod:`sage.repl.rich_output` for details.
EXAMPLES::
sage: from sage.repl.rich_output import get_display_manager sage: dm = get_display_manager() sage: g = Graphics() sage: g._rich_repr_(dm) OutputImagePng container """ ('.png', types.OutputImagePng), ('.jpg', types.OutputImageJpg), ('.gif', types.OutputImageGif), ) ('.svg', types.OutputImageSvg), ('.pdf', types.OutputImagePdf), ) elif graphics == 'vector': preferred = prefer_vector + prefer_raster else: raise ValueError('unknown graphics output preference') self.save, kwds, file_ext, output_container)
def __str__(self): r""" Return string representation of this plot.
OUTPUT:
String.
EXAMPLES::
sage: S = circle((0,0), 2); S.__str__() 'Graphics object consisting of 1 graphics primitive' sage: str(S) 'Graphics object consisting of 1 graphics primitive' sage: print(S) Graphics object consisting of 1 graphics primitive """
def __getitem__(self, i): """ Returns the ith graphics primitive object:
EXAMPLES::
sage: G = circle((1,1),2) + circle((2,2),5); print(G) Graphics object consisting of 2 graphics primitives sage: G[1] Circle defined by (2.0,2.0) with r=5.0 """
def __len__(self): """ If G is of type Graphics, then len(G) gives the number of distinct graphics primitives making up that object.
EXAMPLES::
sage: G = circle((1,1),1) + circle((1,2),1) + circle((1,2),5); print(G) Graphics object consisting of 3 graphics primitives sage: len(G) 3 """
def __delitem__(self, i): """ If G is of type Graphics, then del(G[i]) removes the ith distinct graphic primitive making up that object.
EXAMPLES::
sage: G = circle((1,1),1) + circle((1,2),1) + circle((1,2),5); print(G) Graphics object consisting of 3 graphics primitives sage: len(G) 3 sage: del(G[2]) sage: print(G) Graphics object consisting of 2 graphics primitives sage: len(G) 2 """
def __setitem__(self, i, x): """ You can replace a GraphicPrimitive (point, line, circle, etc...) in a Graphics object G with any other GraphicPrimitive
EXAMPLES::
sage: G = circle((1,1),1) + circle((1,2),1) + circle((1,2),5); print(G) Graphics object consisting of 3 graphics primitives
::
sage: p = polygon([[1,3],[2,-2],[1,1],[1,3]]); print(p) Graphics object consisting of 1 graphics primitive
::
sage: G[1] = p[0] sage: G # show the plot Graphics object consisting of 3 graphics primitives """ raise TypeError("x must be a GraphicPrimitive")
def __radd__(self, other): """ Compute and return other + this graphics object.
This only works when other is a Python int equal to 0. In all other cases a TypeError is raised. The main reason for this function is to make summing a list of graphics objects easier.
EXAMPLES::
sage: S = circle((0,0), 2) sage: print(int(0) + S) Graphics object consisting of 1 graphics primitive sage: print(S + int(0)) Graphics object consisting of 1 graphics primitive
The following would fail were it not for this function::
sage: v = [circle((0,0), 2), circle((2,3), 1)] sage: print(sum(v)) Graphics object consisting of 2 graphics primitives """ raise TypeError
def __add__(self, other): """ If you have any Graphics object G1, you can always add any other amount of Graphics objects G2,G3,... to form a new Graphics object: G4 = G1 + G2 + G3.
The xmin, xmax, ymin, and ymax properties of the graphics objects are expanded to include all objects in both scenes. If the aspect ratio property of either or both objects are set, then the larger aspect ratio is chosen, with 'automatic' being overridden by a numeric aspect ratio.
If one of the graphics object is set to show a legend, then the resulting object will also be set to show a legend. Legend options are propagated if set. If the same legend option is present in both arguments, the latter value is used.
EXAMPLES::
sage: g1 = plot(abs(sqrt(x^3-1)), (x,1,5), frame=True) sage: g2 = plot(-abs(sqrt(x^3-1)), (x,1,5), color='red') sage: g1 + g2 # displays the plot Graphics object consisting of 2 graphics primitives
TESTS:
Extra keywords to show are propagated::
sage: (g1 + g2)._extra_kwds=={'aspect_ratio': 'automatic', 'frame': True} True sage: g1.set_aspect_ratio(2) sage: (g1+g2).aspect_ratio() 2.0 sage: g2.set_aspect_ratio(3) sage: (g1+g2).aspect_ratio() 3.0
As are legend options, :trac:`12936`::
sage: p1 = plot(x, x, 0, 1) sage: p2 = p1 sage: p1.set_legend_options(back_color = 'black') sage: p2.set_legend_options(shadow = False) sage: p3 = p1 + p2 sage: p3._legend_opts {'back_color': 'black', 'shadow': False}
If the same legend option is specified more than once, the latter takes precedence::
sage: p1 = plot(x, x, 0, 1) sage: p2 = p1 sage: p1.set_legend_options(shadow = True) sage: p2.set_legend_options(shadow = False) sage: p3 = p1 + p2 sage: p3._legend_opts {'shadow': False}
""" raise TypeError("other (=%s) must be a Graphics objects"%other) else:
def add_primitive(self, primitive): """ Adds a primitive to this graphics object.
EXAMPLES:
We give a very explicit example::
sage: G = Graphics() sage: from sage.plot.line import Line sage: from sage.plot.arrow import Arrow sage: L = Line([3,4,2,7,-2],[1,2,e,4,5.],{'alpha':1,'thickness':2,'rgbcolor':(0,1,1),'legend_label':''}) sage: A = Arrow(2,-5,.1,.2,{'width':3,'head':0,'rgbcolor':(1,0,0),'linestyle':'dashed','zorder':8,'legend_label':''}) sage: G.add_primitive(L) sage: G.add_primitive(A) sage: G Graphics object consisting of 2 graphics primitives """
def plot(self): """ Draw a 2D plot of this graphics object, which just returns this object since this is already a 2D graphics object.
EXAMPLES::
sage: S = circle((0,0), 2) sage: S.plot() is S True
It does not accept any argument (:trac:`19539`)::
sage: S.plot(1) Traceback (most recent call last): ... TypeError: plot() takes exactly 1 argument (2 given) sage: S.plot(hey="hou") Traceback (most recent call last): ... TypeError: plot() got an unexpected keyword argument 'hey' """
def plot3d(self, z=0, **kwds): """ Returns an embedding of this 2D plot into the xy-plane of 3D space, as a 3D plot object. An optional parameter z can be given to specify the z-coordinate.
EXAMPLES::
sage: sum([plot(z*sin(x), 0, 10).plot3d(z) for z in range(6)]) # long time Graphics3d Object """
@classmethod def _extract_kwds_for_show(cls, kwds, ignore=[]): """ Extract keywords relevant to show() from the provided dictionary.
EXAMPLES::
sage: kwds = {'f': lambda x: x, 'xmin': 0, 'figsize': [1,1], 'plot_points': (40, 40)} sage: G_kwds = Graphics._extract_kwds_for_show(kwds, ignore='xmin') sage: kwds # Note how this action modifies the passed dictionary {'f': <function <lambda> at 0x...>, 'plot_points': (40, 40), 'xmin': 0} sage: G_kwds {'figsize': [1, 1]}
This method is intended to be used with _set_extra_kwds(). Here is an idiom to ensure the correct keywords will get passed on to show()::
sage: options = {} # Usually this will come from an argument sage: g = Graphics() sage: g._set_extra_kwds(Graphics._extract_kwds_for_show(options)) """
def _set_extra_kwds(self, kwds): """ Set a dictionary of keywords that will get passed on to show().
TESTS::
sage: g = Graphics() sage: g._extra_kwds {} sage: g._set_extra_kwds({'figsize': [10,10]}) sage: g._extra_kwds {'figsize': [10, 10]} sage: g.show() # Now the (blank) plot will be extra large """
def _set_scale(self, figure, scale=None, base=None): """ Set the scale of the axes in the current figure. This function is only for internal use.
INPUT: - ``figure`` -- the matplotlib figure instance. - ``scale`` -- the scale of the figure. Values it can take are ``"linear"``, ``"loglog"``, ``"semilogx"``, ``"semilogy"``. See :meth:`show` for other options it can take. - ``base`` -- the base of the logarithm if a logarithmic scale is set. See :meth:`show` for the options it can take.
OUTPUT: The scale in the form of a tuple: (xscale, yscale, basex, basey)
EXAMPLES::
sage: p = plot(x,1,10) sage: fig = p.matplotlib() sage: p._set_scale(fig, scale='linear', base=2) ('linear', 'linear', 10, 10) sage: p._set_scale(fig, scale='semilogy', base=2) ('linear', 'log', 10, 2) sage: p._set_scale(fig, scale=('loglog', 2, 3)) ('log', 'log', 2, 3) sage: p._set_scale(fig, scale=['semilogx', 2]) ('log', 'linear', 2, 10)
TESTS::
sage: p._set_scale(fig, 'log') Traceback (most recent call last): ... ValueError: The scale must be one of 'linear', 'loglog', 'semilogx' or 'semilogy' -- got 'log' sage: p._set_scale(fig, ('loglog', 1)) Traceback (most recent call last): ... ValueError: The base of the logarithm must be greater than 1 """ raise ValueError("If the input is a tuple, it must be of " "the form (scale, base) or (scale, basex, basey)") else:
" 'semilogx' or 'semilogy' -- got '{0}'".format(scale))
else:
"than 1")
# This dictionary has the default values for the keywords to show(). When # show is invoked with keyword arguments, those arguments are merged with # this dictionary to create a set of keywords with the defaults filled in. # Then, those keywords are passed on to save().
# NOTE: If you intend to use a new parameter in show(), you should update # this dictionary to contain the default value for that parameter.
SHOW_OPTIONS = dict(# axes options axes=None, axes_labels=None, axes_labels_size=None, axes_pad=None, base=None, scale=None, xmin=None, xmax=None, ymin=None, ymax=None, # Figure options aspect_ratio=None, dpi=DEFAULT_DPI, fig_tight=True, figsize=None, fontsize=None, frame=False, title=None, title_pos=None, transparent=False, # Grid options gridlines=None, gridlinesstyle=None, hgridlinesstyle=None, vgridlinesstyle=None, # Legend options legend_options={}, show_legend=None, # Ticks options ticks=None, tick_formatter=None, ticks_integer=False, # Text options typeset='default')
@suboptions('legend', back_color='white', borderpad=0.6, borderaxespad=None, columnspacing=None, fancybox=False, font_family='sans-serif', font_size='medium', font_style='normal', font_variant='normal', font_weight='medium', handlelength=0.05, handletextpad=0.5, labelspacing=0.02, loc='best', markerscale=0.6, ncol=1, numpoints=2, shadow=True, title=None) def show(self, **kwds): r""" Show this graphics image 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`` - (default: 100) dots per inch
- ``figsize`` - (default: [8.0,6.0]) [width, height] inches. The maximum value of each of the width and the height can be 327 inches, at the default ``dpi`` of 100 dpi, which is just shy of the maximum allowed value of 32768 dots (pixels).
- ``fig_tight`` - (default: True) whether to clip the drawing tightly around drawn objects. If True, then the resulting image will usually not have dimensions corresponding to ``figsize``. If False, the resulting image will have dimensions corresponding to ``figsize``.
- ``aspect_ratio`` - the perceived height divided by the perceived width. For example, if the aspect ratio is set to ``1``, circles will look round and a unit square will appear to have sides of equal length, and if the aspect ratio is set ``2``, vertical units will be twice as long as horizontal units, so a unit square will be twice as high as it is wide. If set to ``'automatic'``, the aspect ratio is determined by ``figsize`` and the picture fills the figure.
- ``axes`` - (default: True)
- ``axes_labels`` - (default: None) list (or tuple) of two strings; the first is used as the label for the horizontal axis, and the second for the vertical axis.
- ``axes_labels_size`` - (default: current setting -- 1.6) scale factor relating the size of the axes labels with respect to the size of the tick marks.
- ``fontsize`` - (default: current setting -- 10) positive integer; used for axes labels; if you make this very large, you may have to increase figsize to see all labels.
- ``frame`` - (default: False) draw a frame around the image
- ``gridlines`` - (default: None) can be any of the following:
- None, False: do not add grid lines.
- True, "automatic", "major": add grid lines at major ticks of the axes.
- "minor": add grid at major and minor ticks.
- [xlist,ylist]: a tuple or list containing two elements, where xlist (or ylist) can be any of the following.
- None, False: don't add horizontal (or vertical) lines.
- True, "automatic", "major": add horizontal (or vertical) grid lines at the major ticks of the axes.
- "minor": add horizontal (or vertical) grid lines at major and minor ticks of axes.
- an iterable yielding numbers n or pairs (n,opts), where n is the coordinate of the line and opt is a dictionary of MATPLOTLIB options for rendering the line.
- ``gridlinesstyle, hgridlinesstyle, vgridlinesstyle`` - (default: None) a dictionary of MATPLOTLIB options for the rendering of the grid lines, the horizontal grid lines or the vertical grid lines, respectively.
- ``transparent`` - (default: False) If True, make the background transparent.
- ``axes_pad`` - (default: 0.02 on ``"linear"`` scale, 1 on ``"log"`` scale).
- In the ``"linear"`` scale, it determines the percentage of the axis range that is added to each end of each axis. This helps avoid problems like clipping lines because of line-width, etc. To get axes that are exactly the specified limits, set ``axes_pad`` to zero.
- On the ``"log"`` scale, it determines the exponent of the fraction of the minimum (resp. maximum) that is subtracted from the minimum (resp. added to the maximum) value of the axis. For instance if the minimum is `m` and the base of the axis is `b` then the new minimum after padding the axis will be `m - m/b^{\mathrm{axes\_pad}}`.
- ``ticks_integer`` - (default: False) guarantee that the ticks are integers (the ``ticks`` option, if specified, will override this)
- ``ticks`` - A matplotlib locator for the major ticks, or a number. There are several options. For more information about locators, type ``from matplotlib import ticker`` and then ``ticker?``.
- If this is a locator object, then it is the locator for the horizontal axis. A value of None means use the default locator.
- If it is a list of two locators, then the first is for the horizontal axis and one for the vertical axis. A value of None means use the default locator (so a value of [None, my_locator] uses my_locator for the vertical axis and the default for the horizontal axis).
- If in either case above one of the entries is a number `m` (something which can be coerced to a float), it will be replaced by a MultipleLocator which places major ticks at integer multiples of `m`. See examples.
- If in either case above one of the entries is a list of numbers, it will be replaced by a FixedLocator which places ticks at the locations specified. This includes the case of of the empty list, which will give no ticks. See examples.
- ``tick_formatter`` - A matplotlib formatter for the major ticks. There are several options. For more information about formatters, type ``from matplotlib import ticker`` and then ``ticker?``.
If the value of this keyword is a single item, then this will give the formatting for the horizontal axis *only* (except for the ``"latex"`` option). If it is a list or tuple, the first is for the horizontal axis, the second for the vertical axis. The options are below:
- If one of the entries is a formatter object, then it used. A value of None means to use the default locator (so using ``tick_formatter=[None, my_formatter]`` uses my_formatter for the vertical axis and the default for the horizontal axis).
- If one of the entries is a symbolic constant such as `\pi`, `e`, or `sqrt(2)`, ticks will be formatted nicely at rational multiples of this constant.
.. warning::
This should only be used with the ``ticks`` option using nice rational multiples of that constant!
- If one of the entries is the string ``"latex"``, then the formatting will be nice typesetting of the ticks. This is intended to be used when the tick locator for at least one of the axes is a list including some symbolic elements. This uses matplotlib's internal LaTeX rendering engine. If you want to use an external LaTeX compiler, then set the keyword option ``typeset``. See examples.
- ``title`` - (default: None) The title for the plot
- ``title_pos`` - (default: None) The position of the title for the plot. It must be a tuple or a list of two real numbers ``(x_pos, y_pos)`` which indicate the relative position of the title within the plot. The plot itself can be considered to occupy, in relative terms, the region within a unit square `[0,1]\\times[0,1]`. The title text is centered around the horizontal factor ``x_pos`` of the plot. The baseline of the title text is present at the vertical factor ``y_pos`` of the plot. Hence, ``title_pos=(0.5, 0.5)`` will center the title in the plot, whereas ``title_pos=(0.5, 1.1)`` will center the title along the horizontal direction, but will place the title a fraction `0.1` times above the plot.
- If the first entry is a list of strings (or numbers), then the formatting for the horizontal axis will be typeset with the strings present in the list. Each entry of the list of strings must be provided with a corresponding number in the first entry of ``ticks`` to indicate its position on the axis. To typeset the strings with ``"latex"`` enclose them within ``"$"`` symbols. To have similar custom formatting of the labels along the vertical axis, the second entry must be a list of strings and the second entry of ``ticks`` must also be a list of numbers which give the positions of the labels. See the examples below.
- ``show_legend`` - (default: None) If True, show the legend
- ``legend_*`` - all the options valid for :meth:`set_legend_options` prefixed with ``legend_``
- ``base`` - (default: 10) the base of the logarithm if a logarithmic scale is set. This must be greater than 1. The base can be also given as a list or tuple ``(basex, basey)``. ``basex`` sets the base of the logarithm along the horizontal axis and ``basey`` sets the base along the vertical axis.
- ``scale`` -- (default: ``"linear"``) string. The scale of the axes. Possible values are
- ``"linear"`` -- linear scaling of both the axes - ``"loglog"`` -- sets both the horizontal and vertical axes to logarithmic scale - ``"semilogx"`` -- sets only the horizontal axis to logarithmic scale. - ``"semilogy"`` -- sets only the vertical axis to logarithmic scale.
The scale can be also be given as single argument that is a list or tuple ``(scale, base)`` or ``(scale, basex, basey)``.
.. note::
- If the ``scale`` is ``"linear"``, then irrespective of what ``base`` is set to, it will default to 10 and will remain unused.
- ``xmin`` -- starting x value in the rendered figure.
- ``xmax`` -- ending x value in the rendered figure.
- ``ymin`` -- starting y value in the rendered figure.
- ``ymax`` -- ending y value in the rendered figure.
- ``typeset`` -- (default: ``"default"``) string. The type of font rendering that should be used for the text. The possible values are
- ``"default"`` -- Uses matplotlib's internal text rendering engine called Mathtext ( see https://matplotlib.org/users/mathtext.html ). If you have modified the default matplotlib settings, for instance via a matplotlibrc file, then this option will not change any of those settings. - ``"latex"`` -- LaTeX is used for rendering the fonts. This requires LaTeX, dvipng and Ghostscript to be installed. - ``"type1"`` -- Type 1 fonts are used by matplotlib in the text in the figure. This requires LaTeX, dvipng and Ghostscript to be installed.
OUTPUT:
This method does not return anything. Use :meth:`save` if you want to save the figure as an image.
EXAMPLES::
sage: c = circle((1,1), 1, color='red') sage: c.show(xmin=-1, xmax=3, ymin=-1, ymax=3)
You can make the picture larger by changing ``figsize`` with width, height each having a maximum value of 327 inches at default dpi::
sage: p = ellipse((0,0),4,1) sage: p.show(figsize=[327,10],dpi=100) sage: p.show(figsize=[328,10],dpi=80)
You can turn off the drawing of the axes::
sage: show(plot(sin,-4,4), axes=False)
You can also label the axes. Putting something in dollar signs formats it as a mathematical expression::
sage: show(plot(sin,-4,4), axes_labels=('$x$','$y$'))
You can add a title to a plot::
sage: show(plot(sin,-4,4), title='A plot of $\sin(x)$')
You can also provide the position for the title to the plot. In the plot below the title is placed on the bottom left of the figure.::
sage: plot(sin, -4, 4, title='Plot sin(x)', title_pos=(0.05,-0.05)) Graphics object consisting of 1 graphics primitive
If you want all the text to be rendered by using an external LaTeX installation then set the ``typeset`` to ``"latex"``. This requires that LaTeX, dvipng and Ghostscript be installed::
sage: plot(x, typeset='latex') # optional - latex Graphics object consisting of 1 graphics primitive
If you want all the text in your plot to use Type 1 fonts, then set the ``typeset`` option to ``"type1"``. This requires that LaTeX, dvipng and Ghostscript be installed::
sage: plot(x, typeset='type1') # optional - latex Graphics object consisting of 1 graphics primitive
You can turn on the drawing of a frame around the plots::
sage: show(plot(sin,-4,4), frame=True)
You can make the background transparent::
sage: plot(sin(x), (x, -4, 4), transparent=True) Graphics object consisting of 1 graphics primitive
Prior to :trac:`19485`, legends by default had a shadowless gray background. This behavior can be recovered by passing in certain ``legend_options``::
sage: p = plot(sin(x), legend_label='$\sin(x)$') sage: p.show(legend_options={'back_color': (0.9,0.9,0.9), ....: 'shadow': False})
We can change the scale of the axes in the graphics before displaying::
sage: G = plot(exp, 1, 10) sage: G.show(scale='semilogy')
We can change the base of the logarithm too. The following changes the vertical axis to be on log scale, and with base 2. Note that the ``base`` argument will ignore any changes to the axis which is in linear scale.::
sage: G.show(scale='semilogy', base=2) # long time # y axis as powers of 2
::
sage: G.show(scale='semilogy', base=(3,2)) # base ignored for x-axis
The scale can be also given as a 2-tuple or a 3-tuple.::
sage: G.show(scale=('loglog', 2.1)) # long time # both x and y axes in base 2.1
::
sage: G.show(scale=('loglog', 2, 3)) # long time # x in base 2, y in base 3
The base need not be an integer, though it does have to be made a float.::
sage: G.show(scale='semilogx', base=float(e)) # base is e
Logarithmic scale can be used for various kinds of plots. Here are some examples.::
sage: G = list_plot([10**i for i in range(10)]) # long time sage: G.show(scale='semilogy') # long time
::
sage: G = parametric_plot((x, x**2), (x, 1, 10)) sage: G.show(scale='loglog')
::
sage: disk((5,5), 4, (0, 3*pi/2)).show(scale='loglog',base=2)
::
sage: x, y = var('x, y') sage: G = plot_vector_field((2^x,y^2),(x,1,10),(y,1,100)) sage: G.show(scale='semilogx',base=2)
Add grid lines at the major ticks of the axes.
::
sage: c = circle((0,0), 1) sage: c.show(gridlines=True) sage: c.show(gridlines="automatic") sage: c.show(gridlines="major")
Add grid lines at the major and minor ticks of the axes.
::
sage: u,v = var('u v') sage: f = exp(-(u^2+v^2)) sage: p = plot_vector_field(f.gradient(), (u,-2,2), (v,-2,2)) sage: p.show(gridlines="minor")
Add only horizontal or vertical grid lines.
::
sage: p = plot(sin,-10,20) sage: p.show(gridlines=[None, "automatic"]) sage: p.show(gridlines=["minor", False])
Add grid lines at specific positions (using lists/tuples).
::
sage: x, y = var('x, y') sage: p = implicit_plot((y^2-x^2)*(x-1)*(2*x-3)-4*(x^2+y^2-2*x)^2, \ ....: (x,-2,2), (y,-2,2), plot_points=1000) sage: p.show(gridlines=[[1,0],[-1,0,1]])
Add grid lines at specific positions (using iterators).
::
sage: def maple_leaf(t): ....: return (100/(100+(t-pi/2)^8))*(2-sin(7*t)-cos(30*t)/2) sage: p = polar_plot(maple_leaf, -pi/4, 3*pi/2, color="red",plot_points=1000) # long time sage: p.show(gridlines=([-3,-2.75,..,3], range(-1,5,2))) # long time
Add grid lines at specific positions (using functions).
::
sage: y = x^5 + 4*x^4 - 10*x^3 - 40*x^2 + 9*x + 36 sage: p = plot(y, -4.1, 1.1) sage: xlines = lambda a,b: [z for z,m in y.roots()] sage: p.show(gridlines=[xlines, [0]], frame=True, axes=False)
Change the style of all the grid lines.
::
sage: b = bar_chart([-3,5,-6,11], color='red') sage: b.show(gridlines=([-1,-0.5,..,4],True), ....: gridlinesstyle=dict(color="blue", linestyle=":"))
Change the style of the horizontal or vertical grid lines separately.
::
sage: p = polar_plot(2 + 2*cos(x), 0, 2*pi, color=hue(0.3)) sage: p.show(gridlines=True, ....: hgridlinesstyle=dict(color="orange", linewidth=1.0), ....: vgridlinesstyle=dict(color="blue", linestyle=":"))
Change the style of each grid line individually.
::
sage: x, y = var('x, y') sage: p = implicit_plot((y^2-x^2)*(x-1)*(2*x-3)-4*(x^2+y^2-2*x)^2, ....: (x,-2,2), (y,-2,2), plot_points=1000) sage: p.show(gridlines=( ....: [ ....: (1,{"color":"red","linestyle":":"}), ....: (0,{"color":"blue","linestyle":"--"}) ....: ], ....: [ ....: (-1,{"color":"red","linestyle":":"}), ....: (0,{"color":"blue","linestyle":"--"}), ....: (1,{"color":"red","linestyle":":"}), ....: ] ....: ), ....: gridlinesstyle=dict(marker='x',color="black"))
Grid lines can be added to contour plots.
::
sage: f = sin(x^2 + y^2)*cos(x)*sin(y) sage: c = contour_plot(f, (x, -4, 4), (y, -4, 4), plot_points=100) sage: c.show(gridlines=True, gridlinesstyle={'linestyle':':','linewidth':1, 'color':'red'})
Grid lines can be added to matrix plots.
::
sage: M = MatrixSpace(QQ,10).random_element() sage: matrix_plot(M).show(gridlines=True)
By default, Sage increases the horizontal and vertical axes limits by a certain percentage in all directions. This is controlled by the ``axes_pad`` parameter. Increasing the range of the axes helps avoid problems with lines and dots being clipped because the linewidth extends beyond the axes. To get axes limits that are exactly what is specified, set ``axes_pad`` to zero. Compare the following two examples
::
sage: plot(sin(x), (x, -pi, pi),thickness=2)+point((pi, -1), pointsize=15) Graphics object consisting of 2 graphics primitives sage: plot(sin(x), (x, -pi, pi),thickness=2,axes_pad=0)+point((pi, -1), pointsize=15) Graphics object consisting of 2 graphics primitives
The behavior of the ``axes_pad`` parameter is different if the axis is in the ``"log"`` scale. If `b` is the base of the axis, the minimum value of the axis, is decreased by the factor `1/b^{\mathrm{axes\_pad}}` of the minimum and the maximum value of the axis is increased by the same factor of the maximum value. Compare the axes in the following two plots to see the difference.
::
sage: plot_loglog(x, (1.1*10**-2, 9990)) Graphics object consisting of 1 graphics primitive
sage: plot_loglog(x, (1.1*10**-2, 9990), axes_pad=0) Graphics object consisting of 1 graphics primitive
Via matplotlib, Sage allows setting of custom ticks. See above for more details.
Here the labels are not so useful::
sage: plot(sin(pi*x), (x, -8, 8)) Graphics object consisting of 1 graphics primitive
Now put ticks at multiples of 2::
sage: plot(sin(pi*x), (x, -8, 8), ticks=2) Graphics object consisting of 1 graphics primitive
Or just choose where you want the ticks::
sage: plot(sin(pi*x), (x, -8, 8), ticks=[[-7,-3,0,3,7],[-1/2,0,1/2]]) Graphics object consisting of 1 graphics primitive
Or no ticks at all::
sage: plot(sin(pi*x), (x, -8, 8), ticks=[[],[]]) Graphics object consisting of 1 graphics primitive
This can be very helpful in showing certain features of plots. ::
sage: plot(1.5/(1+e^(-x)), (x, -10, 10)) # doesn't quite show value of inflection point Graphics object consisting of 1 graphics primitive
::
sage: plot(1.5/(1+e^(-x)), (x, -10, 10), ticks=[None, 1.5/4]) # It's right at f(x)=0.75! Graphics object consisting of 1 graphics primitive
But be careful to leave enough room for at least two major ticks, so that the user can tell what the scale is::
sage: plot(x^2,(x,1,8),ticks=6).show() Traceback (most recent call last): ... ValueError: Expand the range of the independent variable to allow two multiples of your tick locator (option `ticks`).
We can also do custom formatting if you need it. See above for full details::
sage: plot(2*x+1,(x,0,5),ticks=[[0,1,e,pi,sqrt(20)],2],tick_formatter="latex") Graphics object consisting of 1 graphics primitive
This is particularly useful when setting custom ticks in multiples of `\pi`.
::
sage: plot(sin(x),(x,0,2*pi),ticks=pi/3,tick_formatter=pi) Graphics object consisting of 1 graphics primitive
But keep in mind that you will get exactly the formatting you asked for if you specify both formatters. The first syntax is recommended for best style in that case. ::
sage: plot(arcsin(x),(x,-1,1),ticks=[None,pi/6],tick_formatter=["latex",pi]) # Nice-looking! Graphics object consisting of 1 graphics primitive
::
sage: plot(arcsin(x),(x,-1,1),ticks=[None,pi/6],tick_formatter=[None,pi]) # Not so nice-looking Graphics object consisting of 1 graphics primitive
Custom tick labels can be provided by providing the keyword ``tick_formatter`` with the list of labels, and simultaneously providing the keyword ``ticks`` with the positions of the labels. ::
sage: plot(x, (x,0,3), ticks=[[1,2.5],[0.5,1,2]], tick_formatter=[["$x_1$","$x_2$"],["$y_1$","$y_2$","$y_3$"]]) Graphics object consisting of 1 graphics primitive
The following sets the custom tick labels only along the horizontal axis. ::
sage: plot(x**2, (x,0,2), ticks=[[1,2], None], tick_formatter=[["$x_1$","$x_2$"], None]) Graphics object consisting of 1 graphics primitive
If the number of tick labels do not match the number of positions of tick labels, then it results in an error.::
sage: plot(x**2, (x,0,2), ticks=[[2], None], tick_formatter=[["$x_1$","$x_2$"], None]).show() Traceback (most recent call last): ... ValueError: If the first component of the list `tick_formatter` is a list then the first component of `ticks` must also be a list of equal length.
When using logarithmic scale along the axis, make sure to have enough room for two ticks so that the user can tell what the scale is. This can be effected by increasing the range of the independent variable, or by changing the ``base``, or by providing enough tick locations by using the ``ticks`` parameter.
By default, Sage will expand the variable range so that at least two ticks are included along the logarithmic axis. However, if you specify ``ticks`` manually, this safety measure can be defeated::
sage: list_plot_loglog([(1,2),(2,3)], plotjoined=True, ticks=[[1],[1]]) doctest:...: UserWarning: The x-axis contains fewer than 2 ticks; the logarithmic scale of the plot may not be apparent to the reader. doctest:...: UserWarning: The y-axis contains fewer than 2 ticks; the logarithmic scale of the plot may not be apparent to the reader. Graphics object consisting of 1 graphics primitive
This one works, since the horizontal axis is automatically expanded to contain two ticks and the vertical axis is provided with two ticks::
sage: list_plot_loglog([(1,2),(2,3)], plotjoined=True, ticks=[None,[1,10]]) Graphics object consisting of 1 graphics primitive
Another example in the log scale where both the axes are automatically expanded to show two major ticks::
sage: list_plot_loglog([(2,0.5), (3, 4)], plotjoined=True) Graphics object consisting of 1 graphics primitive
When using ``title_pos``, it must be ensured that a list or a tuple of length two is used. Otherwise, an error is raised.::
sage; plot(x, -4, 4, title='Plot x', title_pos=0.05) Traceback (most recent call last): ... ValueError: 'title_pos' must be a list or tuple of two real numbers.
TESTS:
The following tests result in a segmentation fault and should not be run or doctested::
sage: p = ellipse((0,0),4,1) sage: p.show(figsize=[232,232],dpi=100) # not tested ------------------------------------------------------------------------ Unhandled SIGSEGV: A segmentation fault occurred. This probably occurred because a *compiled* module has a bug in it and is not properly wrapped with sig_on(), sig_off(). Python will now terminate. ------------------------------------------------------------------------ sage: p.show(figsize=[327,181],dpi=100) # not tested ------------------------------------------------------------------------ Unhandled SIGSEGV: A segmentation fault occurred. This probably occurred because a *compiled* module has a bug in it and is not properly wrapped with sig_on(), sig_off(). Python will now terminate. ------------------------------------------------------------------------
The following tests ensure we give a good error message for negative figsizes::
sage: P = plot(x^2,(x,0,1)) sage: P.show(figsize=[-1,1]) Traceback (most recent call last): ... ValueError: figsize should be positive numbers, not -1.0 and 1.0 sage: P.show(figsize=-1) Traceback (most recent call last): ... ValueError: figsize should be positive, not -1.0 sage: P.show(figsize=x^2) Traceback (most recent call last): ... TypeError: figsize should be a positive number, not x^2 sage: P.show(figsize=[2,3,4]) Traceback (most recent call last): ... ValueError: figsize should be a positive number or a list of two positive numbers, not [2, 3, 4] sage: P.show(figsize=[sqrt(2),sqrt(3)]) """
def xmin(self, xmin=None): """ EXAMPLES::
sage: g = line([(-1,1), (3,2)]) sage: g.xmin() -1.0 sage: g.xmin(-3) sage: g.xmin() -3.0 """ else:
def xmax(self, xmax=None): """ EXAMPLES::
sage: g = line([(-1,1), (3,2)]) sage: g.xmax() 3.0 sage: g.xmax(10) sage: g.xmax() 10.0 """ else:
def ymin(self, ymin=None): """ EXAMPLES::
sage: g = line([(-1,1), (3,2)]) sage: g.ymin() 1.0 sage: g.ymin(-3) sage: g.ymin() -3.0 """ else:
def ymax(self, ymax=None): """ EXAMPLES::
sage: g = line([(-1,1), (3,2)]) sage: g.ymax() 2.0 sage: g.ymax(10) sage: g.ymax() 10.0 """ else:
def get_minmax_data(self): r""" Return the x and y coordinate minimum and maximum
.. warning::
The returned dictionary is mutable, but changing it does not change the xmin/xmax/ymin/ymax data. The minmax data is a function of the primitives which make up this Graphics object. To change the range of the axes, call methods :meth:`xmin`, :meth:`xmax`, :meth:`ymin`, :meth:`ymax`, or :meth:`set_axes_range`.
OUTPUT:
A dictionary whose keys give the xmin, xmax, ymin, and ymax data for this graphic.
EXAMPLES::
sage: g = line([(-1,1), (3,2)]) sage: list(sorted(g.get_minmax_data().items())) [('xmax', 3.0), ('xmin', -1.0), ('ymax', 2.0), ('ymin', 1.0)]
Note that changing ymax doesn't change the output of get_minmax_data::
sage: g.ymax(10) sage: list(sorted(g.get_minmax_data().items())) [('xmax', 3.0), ('xmin', -1.0), ('ymax', 2.0), ('ymin', 1.0)]
The width/height ratio (in output units, after factoring in the chosen aspect ratio) of the plot is limited to `10^{-15}\dots 10^{15}`, otherwise floating point errors cause problems in matplotlib::
sage: l = line([(1e-19,-1), (-1e-19,+1)], aspect_ratio=1.0) sage: l.get_minmax_data() {'xmax': 1.00010000000000e-15, 'xmin': -9.99900000000000e-16, 'ymax': 1.0, 'ymin': -1.0} sage: l = line([(0,0), (1,1)], aspect_ratio=1e19) sage: l.get_minmax_data() {'xmax': 5000.50000000000, 'xmin': -4999.50000000000, 'ymax': 1.0, 'ymin': 0.0} """ xmin=0 sage.misc.misc.verbose("xmin was NaN (setting to 0)", level=0) xmax=0 sage.misc.misc.verbose("xmax was NaN (setting to 0)", level=0) ymin=0 sage.misc.misc.verbose("ymin was NaN (setting to 0)", level=0) ymax=0 sage.misc.misc.verbose("ymax was NaN (setting to 0)", level=0) else:
def _limit_output_aspect_ratio(self, xmin, xmax, ymin, ymax): """ Private helper function for :meth:`get_minmax_data`
INPUT:
- ``xmin``, ``xmax``, ``ymin``, ``ymax`` -- bounding box for the graphics.
OUTPUT:
A dictionary whose keys give the xmin, xmax, ymin, and ymax data for this graphic. Possibly enlarged in order to keep the width/height ratio (in output units, after factoring in the chosen aspect ratio) of the plot is limited to `10^{-15}\dots 10^{15}` to avoid floating point issues in matplotlib.
EXAMPLES::
sage: l = line([(0,0), (1,1)], aspect_ratio=1.0) sage: l._limit_output_aspect_ratio(1, 2, 1e19, 3) {'xmax': -4999.50000000000, 'xmin': 5000.50000000000, 'ymax': 3, 'ymin': 1.00000000000000e19} sage: l._limit_output_aspect_ratio(1, 2, 3, 1e19) {'xmax': 5000.50000000000, 'xmin': -4999.50000000000, 'ymax': 1.00000000000000e19, 'ymin': 3} sage: l = line([(0,0), (1,1)], aspect_ratio=1e16) sage: l._limit_output_aspect_ratio(0, 1, 2, 3) {'xmax': 5.50000000000000, 'xmin': -4.50000000000000, 'ymax': 3, 'ymin': 2} """ height = 1e15 * width / aspect_ratio ycenter = (ymax - ymin) / 2 ymin = ycenter - height/2 ymax = ycenter + height/2
def _matplotlib_tick_formatter(self, subplot, base=(10, 10), locator_options={}, scale=('linear', 'linear'), tick_formatter=(None, None), ticks=(None, None), xmax=None, xmin=None, ymax=None, ymin=None): r""" Take a matplotlib subplot instance representing the graphic and set the ticks formatting. This function is only for internal use.
INPUT: - ``subplot`` -- the subplot instance.
EXAMPLES::
sage: from matplotlib.figure import Figure sage: p = plot(x); d = p.get_minmax_data() sage: subplot = Figure().add_subplot(111) sage: p._objects[0]._render_on_subplot(subplot) sage: p._matplotlib_tick_formatter(subplot, **d) (<matplotlib.axes._subplots.AxesSubplot object at ...>, <matplotlib.ticker.MaxNLocator object at ...>, <matplotlib.ticker.MaxNLocator object at ...>, <matplotlib.ticker.OldScalarFormatter object at ...>, <matplotlib.ticker.OldScalarFormatter object at ...>) """ # This function is created to refactor some code that is repeated # in the matplotlib function LogFormatterMathtext, LogLocator, MaxNLocator, MultipleLocator, NullLocator, OldScalarFormatter)
#---------------------- Location of x-ticks ---------------------#
else: pass else: # x_locator is a number which can be made a float else: # not enough room for two major ticks 'variable to allow two multiples of your tick locator ' '(option `ticks`).')
#---------------------- Location of y-ticks ---------------------# else: pass else: # y_locator is a number which can be made a float else: # not enough room for two major ticks raise ValueError('Expand the range of the dependent ' 'variable to allow two multiples of your tick locator ' '(option `ticks`).')
#---------------------- Formatting x-ticks ----------------------# else: _multiple_of_constant(n,pos,x_const)) # We need to strip out '\\mathdefault' from the string x_formatter = FuncFormatter(lambda n,pos: LogFormatterMathtext(base=base[0])(n,pos).replace( "\\mathdefault","")) else: len(ticks[0]) != len(x_formatter)): "`tick_formatter` is a list then the first component " "of `ticks` must also be a list of equal length.") #---------------------- Formatting y-ticks ----------------------# else: _multiple_of_constant(n,pos,y_const)) # We need to strip out '\\mathdefault' from the string y_formatter = FuncFormatter(lambda n,pos: LogFormatterMathtext(base=base[1])(n,pos).replace( "\\mathdefault","")) else: len(ticks[1]) != len(y_formatter)): raise ValueError("If the second component of the list " "`tick_formatter` is a list then the second component " "of `ticks` must also be a list of equal length.")
# Check for whether there will be too few ticks in the log scale case. # If there are not enough ticks (2 or more) to determine that the scale # is non-linear, we throw a warning.
len(subplot.xaxis.get_ticklocs()) < 2):
len(subplot.yaxis.get_ticklocs()) < 2):
def _get_vmin_vmax(self, vmin, vmax, basev, axes_pad): r""" Determine the min/max value for a variable plotted on a logarithmic scale. The motivation is that we desire at least two ticks for a log plot; otherwise the reader may assume that the scale is linear. For internal use only.
We check if this case occurs (for e.g. assuming xmin < xmax):
floor(logxmin) ceil(logxmax) ----|---------+----------+----------|----------------------|-- logxmin logxmax
Or if this case occurs (assuming xmin < xmax):
floor(logxmin) floor(logxmax) ceil(logxmax) ----|---------+---------------------|-----+----------------|-- logxmin logxmax
INPUT:
- ``vmin`` - the current min for this variable (e.g. xmin or ymin)
- ``vmax`` - the current max for this variable (e.g. xmax or ymax)
- ``basev`` - the base of the logarithmic scale for this variable
- ``axes_pad`` - the padding for the axis. It determines the exponent of the fraction of the minimum (resp. maximum) that is subtracted from the minimum (resp. added to the maximum) value of the axis. For instance if the minimum is `m` and the base of the axis is `b` then the new minimum after padding the axis will be `m - m/b^{\mathrm{axes\_pad}}`.
OUTPUT:
A new (min,max) pair for this variable, suitable for its logarithmic scale.
EXAMPLES:
On a base-10 logarithmic scale, we should have ``vmin``/``vmax`` at least 10 units apart::
sage: p = Graphics() sage: p._get_vmin_vmax(1, 2, 10, None) (9/10, 10.0) sage: p._get_vmin_vmax(1, 5, 10, None) (9/10, 10.0) sage: p._get_vmin_vmax(1, 10, 10, None) (9/10, 11) sage: p._get_vmin_vmax(1, 11, 10, None) (9/10, 121/10) sage: p._get_vmin_vmax(1, 50, 10, None) (9/10, 55)
We can set the ``axes_pad`` separately::
sage: p._get_vmin_vmax(1, 50, 2, 2) (0.75, 62.5)
Nonpositive values of ``vmin`` are not accepted due to the domain of the logarithm function::
sage: p = Graphics() sage: p._get_vmin_vmax(-1,2,10, None) Traceback (most recent call last): ... ValueError: vmin must be positive
And ``vmax`` must be greater than ``vmin``::
sage: p._get_vmin_vmax(1,-2,10, None) Traceback (most recent call last): ... ValueError: vmin must be less than vmax
"""
else:
else: vmin = basev**math.floor(logvmin) if axes_pad > 0: vmax += vmax * basev**(-axes_pad) # pad the axes if we haven't expanded the axes earlier.
def matplotlib(self, filename=None, xmin=None, xmax=None, ymin=None, ymax=None, figsize=None, figure=None, sub=None, axes=None, axes_labels=None, axes_labels_size=None, fontsize=None, frame=False, verify=True, aspect_ratio = None, gridlines=None, gridlinesstyle=None, vgridlinesstyle=None, hgridlinesstyle=None, show_legend=None, legend_options={}, axes_pad=None, ticks_integer=None, tick_formatter=None, ticks=None, title=None, title_pos=None, base=None, scale=None, stylesheet='classic', typeset='default'): r""" Return a matplotlib figure object representing the graphic
EXAMPLES::
sage: c = circle((1,1),1) sage: print(c.matplotlib()) Figure(640x480)
To obtain the first matplotlib axes object inside of the figure, you can do something like the following.
::
sage: p=plot(sin(x), (x, -2*pi, 2*pi)) sage: figure=p.matplotlib() sage: axes=figure.axes[0]
For input parameters, see the documentation for the :meth:`show` method (this function accepts all except the transparent argument).
TESTS:
We verify that :trac:`10291` is fixed::
sage: p = plot(sin(x), (x, -2*pi, 2*pi)) sage: figure = p.matplotlib() sage: axes_range = p.get_axes_range() sage: figure = p.matplotlib() sage: axes_range2 = p.get_axes_range() sage: axes_range == axes_range2 True
We verify that legend options are properly handled (:trac:`12960`). First, we test with no options, and next with an incomplete set of options.::
sage: p = plot(x, legend_label='aha') sage: p.legend(True) sage: pm = p.matplotlib() sage: pm = p.matplotlib(legend_options={'font_size':'small'})
The title should not overlap with the axes labels nor the frame in the following plot (see :trac:`10512`)::
sage: plot(sin(x^2), (x, -3, 3), title='Plot of sin(x^2)', axes_labels=['x','y'],frame=True) Graphics object consisting of 1 graphics primitive
``typeset`` must not be set to an arbitrary string::
sage: plot(x, typeset='garbage') doctest:...: RichReprWarning: Exception in _rich_repr_ while displaying object: typeset must be set to one of 'default', 'latex', or 'type1'; got 'garbage'. Graphics object consisting of 1 graphics primitive
We verify that numerical options are changed to float before saving (:trac:`14741`). By default, Sage 5.10 changes float objects to the `RealLiteral` type. The patch changes them to float before creating `matplotlib` objects.::
sage: f = lambda x, y : (abs(cos((x + I * y) ** 4)) - 1) # long time sage: g = implicit_plot(f,(-4, 4),(-3, 3),linewidth=0.6) # long time sage: gm = g.matplotlib() # long time # without the patch, this goes BOOM -- er, TypeError """
stylesheet = 'classic'
else:
global do_verify
rcParams['ps.useafm'] = True rcParams['pdf.use14corefonts'] = True rcParams['text.usetex'] = True rcParams['ps.useafm'] = False rcParams['pdf.use14corefonts'] = False rcParams['text.usetex'] = True " or 'type1'; got '{}'.".format(typeset))
# in this case, figsize is a number and should be positive else:
# then the figsize should be two positive numbers
#the incoming subplot instance #add all the primitives to the subplot # Set the aspect ratio else:
#---------------- Set the axes limits and scale ------------------#
base=base)
# If any of the x-data are negative, we leave the min/max alone. else: xmax, xmin = self._get_vmin_vmax(xmax, xmin, basex, axes_pad) else:
# Likewise for the y-data. else: ymax, ymin = self._get_vmin_vmax(ymax, ymin, basey, axes_pad) else:
#-------------------------- Set the legend -----------------------#
family = lopts.pop('font_family', 'sans-serif'), size = lopts.pop('font_size', 'medium'), style = lopts.pop('font_style', 'normal'), weight = lopts.pop('font_weight', 'medium'), variant = lopts.pop('font_variant', 'normal') ) sage.misc.misc.warn("legend requested but no items are labeled") else: # color
axes = self._show_axes
# For now, set the formatter to the old one, since that is # sort of what we are used to. We should eventually look at # the default one to see if we like it better.
x_formatter, y_formatter) = self._matplotlib_tick_formatter( subplot, base=(basex, basey), locator_options=locator_options, scale=(xscale, yscale), tick_formatter=tick_formatter, ticks=ticks, xmax=xmax, xmin=xmin, ymax=ymax, ymin=ymin)
linewidth=self._axes_width) linewidth=self._axes_width)
# Note that the user may specify a custom xmin and xmax which # flips the axis horizontally. Hence we need to check for both # the possibilities in the if statements below. Similar # comments hold for ymin and ymax. elif xmax < xmin: subplot.spines['left'].set_visible(False) subplot.spines['right'].set_position(('outward',10)) subplot.yaxis.set_ticks_position('right') subplot.yaxis.set_label_position('right') yaxis='right' else:
elif ymax < ymin: subplot.spines['bottom'].set_visible(False) subplot.spines['top'].set_position(('outward',10)) subplot.xaxis.set_ticks_position('top') subplot.xaxis.set_label_position('top') xaxis='top' else:
# For now, set the formatter to the old one, since that is # sort of what we are used to. We should eventually look at # the default one to see if we like it better.
x_formatter, y_formatter) = self._matplotlib_tick_formatter( subplot, base=(basex, basey), locator_options=locator_options, scale=(xscale, yscale), tick_formatter=tick_formatter, ticks=ticks, xmax=xmax, xmin=xmin, ymax=ymax, ymin=ymin)
# Make ticklines go on both sides of the axes # if xmiddle: # for t in subplot.xaxis.get_majorticklines(): # t.set_marker("|") # t.set_markersize(8) # for t in subplot.xaxis.get_minorticklines(): # t.set_marker("|") # t.set_markersize(4)
# if ymiddle: # for t in subplot.yaxis.get_majorticklines(): # t.set_marker("|") # t.set_markersize(8) # for t in subplot.yaxis.get_minorticklines(): # t.set_marker("|") # t.set_markersize(4)
# Make the zero tick labels disappear if the axes cross # inside the picture, but only if log scale is not used yscale == 'linear'): subplot.yaxis.get_major_formatter(), skip_values=[0])) subplot.xaxis.get_major_formatter(), skip_values=[0]))
else:
# Make minor tickmarks, unless we specify fixed ticks or no ticks # We do this change only on linear scale, otherwise matplotlib # errors out with a memory error. LogLocator, NullLocator) else: # log scale subs=subs)) else: # log scale subs=subs))
# Set the color and fontsize of ticks labelcolor=self._tick_label_color, labelsize=self._fontsize, which='both')
else:
# Set up the default grid style
else: else:
else: else:
# We set the label positions according to where we are # drawing the axes. else: yaxis_labely=subplot.get_ylim()[0] yaxis_labeloffset=-8 yaxis_vert='top' xaxis_labely=1 xaxis_vert='top'
else:
y=0, units='points') y=xaxis_labely, transform=labeltrans)
y=yaxis_labeloffset, units='points') y=yaxis_labely, transform=labeltrans)
# This option makes the xlim and ylim limits not take effect # todo: figure out which limits were specified, and let the # free limits autoscale #subplot.autoscale_view(tight=True) len(title_pos) != 2): raise ValueError("'title_pos' must be a list or tuple " "of two real numbers.")
position=title_pos) else: else: # frame is false axes is not None, and neither is axes_labels # Then, the title is moved up to avoid overlap with axes labels
def save_image(self, filename=None, *args, **kwds): r""" 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 :meth:`save` method of self, passing along all arguments and keywords.
.. NOTE::
Not all image types are necessarily implemented for all graphics types. See :meth:`save` for more details.
EXAMPLES::
sage: c = circle((1,1), 1, color='red') sage: filename = os.path.join(SAGE_TMP, 'test.png') sage: c.save_image(filename, xmin=-1, xmax=3, ymin=-1, ymax=3) """
# ALLOWED_EXTENSIONS is the list of recognized formats. # filename argument is written explicitly so that it can be used as a # positional one, which is a very likely usage for this function. @suboptions('legend', back_color='white', borderpad=0.6, borderaxespad=None, columnspacing=None, fancybox=False, font_family='sans-serif', font_size='medium', font_style='normal', font_variant='normal', font_weight='medium', handlelength=0.05, handletextpad=0.5, labelspacing=0.02, loc='best', markerscale=0.6, ncol=1, numpoints=2, shadow=True, title=None) def save(self, filename, **kwds): r""" Save the graphics to an image file.
INPUT:
- ``filename`` -- string. The filename and the image format given by the extension, which can be one of the following:
* ``.eps``,
* ``.pdf``,
* ``.pgf``,
* ``.png``,
* ``.ps``,
* ``.sobj`` (for a Sage object you can load later),
* ``.svg``,
* empty extension will be treated as ``.sobj``.
All other keyword arguments will be passed to the plotter.
OUTPUT:
- none.
EXAMPLES::
sage: c = circle((1,1), 1, color='red') sage: filename = os.path.join(SAGE_TMP, 'test.png') sage: c.save(filename, xmin=-1, xmax=3, ymin=-1, ymax=3)
To make a figure bigger or smaller, use ``figsize``::
sage: c.save(filename, figsize=5, xmin=-1, xmax=3, ymin=-1, ymax=3)
By default, the figure grows to include all of the graphics and text, so the final image may not be exactly the figure size you specified. If you want a figure to be exactly a certain size, specify the keyword ``fig_tight=False``::
sage: c.save(filename, figsize=[8,4], fig_tight=False, ....: xmin=-1, xmax=3, ymin=-1, ymax=3)
You can also pass extra options to the plot command instead of this method, e.g. ::
sage: plot(x^2 - 5, (x, 0, 5), ymin=0).save(tmp_filename(ext='.png'))
will save the same plot as the one shown by this command::
sage: plot(x^2 - 5, (x, 0, 5), ymin=0) Graphics object consisting of 1 graphics primitive
(This test verifies that :trac:`8632` is fixed.)
TESTS:
Legend labels should save correctly::
sage: P = plot(x,(x,0,1),legend_label='$xyz$') sage: P.set_legend_options(back_color=(1,0,0)) sage: P.set_legend_options(loc=7) sage: filename=os.path.join(SAGE_TMP, 'test.png') sage: P.save(filename)
This plot should save with the frame shown, showing :trac:`7524` is fixed (same issue as :trac:`7981` and :trac:`8632`)::
sage: var('x,y') (x, y) sage: a = plot_vector_field((x,-y),(x,-1,1),(y,-1,1)) sage: filename=os.path.join(SAGE_TMP, 'test2.png') sage: a.save(filename)
The following plot should show the axes; fixes :trac:`14782` ::
sage: plot(x^2, (x, 1, 2), ticks=[[], []]) Graphics object consisting of 1 graphics primitive
"""
"', '".join(ALLOWED_EXTENSIONS) + "'!") else: rcParams['text.usetex']) # save the rcParams # You can output in PNG, PS, EPS, PDF, PGF, or SVG format, depending # on the file extension. # PGF is handled by a different backend from sage.misc.sage_ostools import have_program latex_implementations = [i for i in ["xelatex", "pdflatex", "lualatex"] if have_program(i)] if not latex_implementations: raise ValueError("Matplotlib requires either xelatex, " "lualatex, or pdflatex.") if latex_implementations[0] == "pdflatex": # use pdflatex and set font encoding as per # matplotlib documentation: # https://matplotlib.org/users/pgf.html#pgf-tutorial pgf_options= {"pgf.texsystem": "pdflatex", "pgf.preamble": [ r"\usepackage[utf8x]{inputenc}", r"\usepackage[T1]{fontenc}" ] } else: pgf_options = { "pgf.texsystem": latex_implementations[0], } from matplotlib import rcParams rcParams.update(pgf_options) from matplotlib.backends.backend_pgf import FigureCanvasPgf figure.set_canvas(FigureCanvasPgf(figure))
# matplotlib looks at the file extension to see what the renderer should be. # The default is FigureCanvasAgg for PNG's because this is by far the most # common type of files rendered, like in the notebook, for example. # if the file extension is not '.png', then matplotlib will handle it. else: # this messes up the aspect ratio! #figure.canvas.mpl_connect('draw_event', pad_for_tick_labels)
# tight_layout adjusts the *subplot* parameters so ticks aren't cut off, etc.
# Restore the rcParams to the original, possibly user-set values rcParams['text.usetex']) = rc_backup
def _latex_(self, **kwds): """ Return a string plotting ``self`` with PGF.
INPUT:
All keyword arguments will be passed to the plotter.
OUTPUT:
A string of PGF commands to plot ``self``
EXAMPLES::
sage: L = line([(0,0), (1,1)], axes=False) sage: L._latex_() # not tested '%% Creator: Matplotlib, PGF backend... """ tmpfilename = tmp_filename(ext='.pgf') self.save(filename=tmpfilename, **kwds) with open(tmpfilename, "r") as tmpfile: latex_list = tmpfile.readlines() from sage.misc.latex import latex latex.add_package_to_preamble_if_available('pgf') return ''.join(latex_list)
def description(self): r""" Print a textual description to stdout.
This method is mostly used for doctests.
EXAMPLES::
sage: print(polytopes.hypercube(2).plot().description()) Polygon defined by 4 points: [(1.0, 1.0), (-1.0, 1.0), (-1.0, -1.0), (1.0, -1.0)] Line defined by 2 points: [(-1.0, -1.0), (-1.0, 1.0)] Line defined by 2 points: [(-1.0, -1.0), (1.0, -1.0)] Line defined by 2 points: [(-1.0, 1.0), (1.0, 1.0)] Line defined by 2 points: [(1.0, -1.0), (1.0, 1.0)] Point set defined by 4 point(s): [(-1.0, -1.0), (-1.0, 1.0), (1.0, -1.0), (1.0, 1.0)] """ else:
class GraphicsArray(WithEqualityById, SageObject): """ GraphicsArray takes a (`m` x `n`) list of lists of graphics objects and plots them all on one canvas.
.. automethod:: _rich_repr_ """ def __init__(self, array): """ Constructor for ``GraphicsArray`` class. Normally used only via :func:`graphics_array` function.
INPUT: a list or list of lists/tuples, all of which are graphics objects
EXAMPLES::
sage: L = [plot(sin(k*x),(x,-pi,pi)) for k in range(10)] sage: G = graphics_array(L) sage: G.ncols() 10 sage: M = [[plot(x^2)],[plot(x^3)]] sage: H = graphics_array(M) sage: str(H[1]) 'Graphics object consisting of 1 graphics primitive'
TESTS::
sage: L = [[plot(sin),plot(cos)],[plot(tan)]] sage: graphics_array(L) Traceback (most recent call last): ... TypeError: array (=[[Graphics object consisting of 1 graphics primitive, Graphics object consisting of 1 graphics primitive], [Graphics object consisting of 1 graphics primitive]]) must be a list of lists of Graphics objects sage: G = plot(x,(x,0,1)) sage: graphics_array(G) Traceback (most recent call last): ... TypeError: array (=Graphics object consisting of 1 graphics primitive) must be a list of lists of Graphics objects sage: G = [[plot(x,(x,0,1)),x]] sage: graphics_array(G) Traceback (most recent call last): ... TypeError: every element of array must be a Graphics object
sage: hash(graphics_array([])) # random 42 """ else:
def _repr_(self): """ Representation 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: graphics_array(L,2,3) Graphics Array of size 2 x 3 """
def _rich_repr_(self, display_manager, **kwds): """ Rich Output Magic Method
See :mod:`sage.repl.rich_output` for details.
EXAMPLES::
sage: from sage.repl.rich_output import get_display_manager sage: dm = get_display_manager() sage: g = graphics_array([Graphics(), Graphics()], 1, 2) sage: g._rich_repr_(dm) OutputImagePng container """ ('.png', types.OutputImagePng), ('.jpg', types.OutputImageJpg), ('.gif', types.OutputImageGif), ) ('.svg', types.OutputImageSvg), ('.pdf', types.OutputImagePdf), ) elif graphics == 'vector': preferred = prefer_vector + prefer_raster else: raise ValueError('unknown graphics output preference') self.save, kwds, file_ext, output_container)
def __str__(self): """ String representation 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.__str__() 'Graphics Array of size 2 x 3' sage: str(G) 'Graphics Array of size 2 x 3' """
def nrows(self): """ 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 """
def ncols(self): """ 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 """
def __getitem__(self, i): """ Return the ``i``th element of the list of graphics in the (flattened) array.
EXAMPLES:
We can access and view individual plots::
sage: M = [[plot(x^2)],[plot(x^3)]] sage: H = graphics_array(M) sage: H[1] Graphics object consisting of 1 graphics primitive
They can also be represented::
sage: str(H[1]) 'Graphics object consisting of 1 graphics primitive'
Another example::
sage: L = [plot(sin(k*x),(x,-pi,pi))+circle((k,k),1,color='red') for k in range(10)] sage: G = graphics_array(L,5,2) sage: str(G[3]) 'Graphics object consisting of 2 graphics primitives' sage: G[3] Graphics object consisting of 2 graphics primitives """
def __setitem__(self, i, g): """ Set the ``i``th element of the list of graphics in the (flattened) array.
EXAMPLES::
sage: M = [[plot(x^2)],[plot(x^3)]] sage: H = graphics_array(M) sage: str(H[1]) 'Graphics object consisting of 1 graphics primitive'
We can check this is one primitive::
sage: H[1] # the plot of x^3 Graphics object consisting of 1 graphics primitive
Now we change it::
sage: H[1] = circle((1,1),2)+points([(1,2),(3,2),(5,5)],color='purple') sage: str(H[1]) 'Graphics object consisting of 2 graphics primitives'
And we visually check that it's different::
sage: H[1] # a circle and some purple points Graphics object consisting of 2 graphics primitives """
def _set_figsize_(self, ls): """ Set the figsize of all plots in the array.
This is normally only used via the ``figsize`` keyword in :meth:`save` or :meth:`show`.
EXAMPLES::
sage: L = [plot(sin(k*x),(x,-pi,pi)) for k in [1..3]] sage: G = graphics_array(L) sage: G.show(figsize=[5,3]) # smallish and compact
::
sage: G.show(figsize=[10,20]) # bigger and tall and thin; long time (2s on sage.math, 2012)
::
sage: G.show(figsize=8) # figure as a whole is a square """ # if just one number is passed in for figsize, as documented # now the list is a list
def __len__(self): """ Total number of elements 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 """ return len(self._glist)
def append(self, g): """ Appends a graphic to the array. Currently not implemented.
TESTS::
sage: from sage.plot.graphics import GraphicsArray sage: G = GraphicsArray([plot(sin),plot(cos)]) sage: G.append(plot(tan)) Traceback (most recent call last): ... NotImplementedError: Appending to a graphics array is not yet implemented """ # Not clear if there is a way to do this
def save(self, filename, dpi=DEFAULT_DPI, figsize=None, axes=None, **kwds): r""" Save the graphics array.
INPUT:
- ``filename`` -- string. The filename and the image format 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``.
- ``dpi`` - dots per inch
- ``figsize`` - width or [width, height] See documentation for :meth:`sage.plot.graphics.Graphics.show` for more details.
- ``axes`` - (default: True)
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) # long time (6s on sage.math, 2012)
TESTS::
sage: graphics_array([]).save(F) sage: graphics_array([[]]).save(F) """
#glist is a list of Graphics objects: #make a blank matplotlib Figure: global do_verify verify=do_verify, axes = axes, **kwds) verify=do_verify, axes=axes, **kwds)
def save_image(self, filename=None, *args, **kwds): r""" 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 :meth:`save` method of self, passing along all arguments and keywords.
.. NOTE::
Not all image types are necessarily implemented for all graphics types. See :meth:`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')) """
def _latex_(self, dpi=DEFAULT_DPI, figsize=None, axes=None, **args): """ Return a string plotting ``self`` with PGF.
INPUT:
All keyword arguments will be passed to the plotter.
OUTPUT:
A string of PGF commands to plot ``self``
EXAMPLES::
sage: A = graphics_array([[plot(sin), plot(cos)], ....: [plot(tan), plot(sec)]]) sage: A._latex_() # not tested '%% Creator: Matplotlib, PGF backend... """ tmpfilename = tmp_filename(ext='.pgf') self.save(filename=tmpfilename, **args) with open(tmpfilename, "r") as tmpfile: latex_list = tmpfile.readlines() return ''.join(latex_list)
def show(self, **kwds): r""" Show this graphics array 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] See the documentation for :meth:`sage.plot.graphics.Graphics.show` for more information.
- ``axes`` - (default: True)
- ``fontsize`` - positive integer
- ``frame`` - (default: False) draw a frame around the image
OUTPUT:
This method does not return anything. Use :meth:`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::
sage: G = graphics_array([[plot(sin), plot(cos)], [plot(tan), plot(sec)]]) sage: G.show(axes=False) """
def plot(self): """ Draw a 2D plot of this graphics object, which just returns this object since this is already a 2D graphics object.
EXAMPLES::
sage: g1 = plot(cos(20*x)*exp(-2*x), 0, 1) sage: g2 = plot(2*exp(-30*x) - exp(-3*x), 0, 1) sage: S = graphics_array([g1, g2], 2, 1) sage: S.plot() is S True """ |