##// END OF EJS Templates
Fix IPython.start_kernel()...
Fix IPython.start_kernel() Closes gh-4005

File last commit:

r11544:83f0c1d5
r12158:70d6bef5
Show More
pylab.py
143 lines | 5.4 KiB | text/x-python | PythonLexer
Fernando Perez
Create core.magics.pylab according to new API.
r6968 """Implementation of magic functions for matplotlib/pylab support.
"""
#-----------------------------------------------------------------------------
# Copyright (c) 2012 The IPython Development Team.
#
# Distributed under the terms of the Modified BSD License.
#
# The full license is in the file COPYING.txt, distributed with this software.
#-----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------
# Our own packages
from IPython.config.application import Application
MinRK
add `%pylab --no-import`...
r11324 from IPython.core import magic_arguments
Fernando Perez
Renamed @register_magics to @magics_class to avoid confusion....
r6973 from IPython.core.magic import Magics, magics_class, line_magic
Fernando Perez
Create core.magics.pylab according to new API.
r6968 from IPython.testing.skipdoctest import skip_doctest
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 from IPython.utils.warn import warn
Paul Ivanov
include sorted list of backends
r11446 from IPython.core.pylabtools import backends
Fernando Perez
Create core.magics.pylab according to new API.
r6968
#-----------------------------------------------------------------------------
# Magic implementation classes
#-----------------------------------------------------------------------------
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 magic_gui_arg = magic_arguments.argument(
MinRK
add `%pylab --no-import`...
r11324 'gui', nargs='?',
Paul Ivanov
include sorted list of backends
r11446 help="""Name of the matplotlib backend to use %s.
MinRK
add `%pylab --no-import`...
r11324 If given, the corresponding matplotlib backend is used,
otherwise it will be matplotlib's default
(which you can set in your matplotlib config file).
Paul Ivanov
include sorted list of backends
r11446 """ % str(tuple(sorted(backends.keys())))
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 )
Fernando Perez
Create core.magics.pylab according to new API.
r6968
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 @magics_class
class PylabMagics(Magics):
"""Magics related to matplotlib's pylab support"""
@skip_doctest
@line_magic
@magic_arguments.magic_arguments()
@magic_gui_arg
def matplotlib(self, line=''):
"""Set up matplotlib to work interactively.
This function lets you activate matplotlib interactive support
at any point during an IPython session.
It does not import anything into the interactive namespace.
Fernando Perez
Create core.magics.pylab according to new API.
r6968 If you are using the inline matplotlib backend for embedded figures,
you can adjust its behavior via the %config magic::
# enable SVG figures, necessary for SVG+XHTML export in the qtconsole
In [1]: %config InlineBackend.figure_format = 'svg'
# change the behavior of closing all figures at the end of each
# execution (cell), or allowing reuse of active figures across
# cells:
In [2]: %config InlineBackend.close_figures = False
Examples
--------
In this case, where the MPL default is TkAgg::
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 In [2]: %matplotlib
Using matplotlib backend: TkAgg
Fernando Perez
Create core.magics.pylab according to new API.
r6968
But you can explicitly request a different backend::
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 In [3]: %matplotlib qt
"""
args = magic_arguments.parse_argstring(self.matplotlib, line)
gui, backend = self.shell.enable_matplotlib(args.gui)
self._show_matplotlib_backend(args.gui, backend)
Fernando Perez
Create core.magics.pylab according to new API.
r6968
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 @skip_doctest
@line_magic
@magic_arguments.magic_arguments()
@magic_arguments.argument(
'--no-import-all', action='store_true', default=None,
help="""Prevent IPython from performing ``import *`` into the interactive namespace.
MinRK
move imports to %pylab description...
r11544 You can govern the default behavior of this flag with the
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 InteractiveShellApp.pylab_import_all configurable.
"""
)
@magic_gui_arg
def pylab(self, line=''):
"""Load numpy and matplotlib to work interactively.
This function lets you activate pylab (matplotlib, numpy and
interactive support) at any point during an IPython session.
MinRK
move imports to %pylab description...
r11544
%pylab makes the following imports::
import numpy
import matplotlib
from matplotlib import pylab, mlab, pyplot
np = numpy
plt = pyplot
from IPython.display import display
from IPython.core.pylabtools import figsize, getfigs
from pylab import *
from numpy import *
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328
MinRK
move imports to %pylab description...
r11544 If you pass `--no-import-all`, the last two `*` imports will be excluded.
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328
MinRK
move imports to %pylab description...
r11544 See the %matplotlib magic for more details about activating matplotlib
without affecting the interactive namespace.
Fernando Perez
Create core.magics.pylab according to new API.
r6968 """
MinRK
add `%pylab --no-import`...
r11324 args = magic_arguments.parse_argstring(self.pylab, line)
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 if args.no_import_all is None:
MinRK
add `%pylab --no-import`...
r11324 # get default from Application
if Application.initialized():
app = Application.instance()
try:
import_all = app.pylab_import_all
except AttributeError:
import_all = True
else:
# nothing specified, no app - default True
import_all = True
Fernando Perez
Create core.magics.pylab according to new API.
r6968 else:
MinRK
add `%pylab --no-import`...
r11324 # invert no-import flag
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 import_all = not args.no_import_all
gui, backend, clobbered = self.shell.enable_pylab(args.gui, import_all=import_all)
self._show_matplotlib_backend(args.gui, backend)
MinRK
update pylab messages...
r11533 print ("Populating the interactive namespace from numpy and matplotlib")
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328 if clobbered:
warn("pylab import has clobbered these variables: %s" % clobbered +
"\n`%pylab --no-import-all` prevents importing * from pylab and numpy"
)
def _show_matplotlib_backend(self, gui, backend):
"""show matplotlib message backend message"""
if not gui or gui == 'auto':
MinRK
update pylab messages...
r11533 print ("Using matplotlib backend: %s" % backend)
MinRK
add `%matplotlib` and `shell.enable_matplotlib`...
r11328