1. 程式人生 > 程式設計 >淺談matplotlib中FigureCanvasXAgg的用法

淺談matplotlib中FigureCanvasXAgg的用法

背景知識:

FigureCanvasXAgg就是一個渲染器,渲染器的工作就是drawing,執行繪圖的這個動作。渲染器是使物體顯示在螢幕上

主要內容:

將一個figure渲染的canvas變為一個Qt widgets,figure顯示的過程是需要管理器(manager),需要FigureCanvasBase來管理。報錯資訊'FigureCanvasQTAgg' object has no attribute 'manager'

將一個navigation toolbar渲染成Qt widgets

使用使用者事件來實時更新matplotlib plot

matplotlib針對GUI設計了兩層結構概念:canvas,renderer。

下面我將以預設自帶的後端 tkAgg:from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg as FigureCanvas為例,為大家講解畫布與渲染器的知識。

一. canvas(畫布)

對應抽象的類:FigureCanvasBase and FigureManagerBase

作用:

儲存對影象的引用

更新影象通過對畫布的引用

定義執行註冊的事件方法

將本地工具箱事件轉為matplotlib事件抽象框架

定義繪製渲染圖片的方法

停止和開始nono-GUI事件迴圈

1. 追尋matplotlib.figure.Figure.show( )

以下引自matplotlib.figure.Figure.show( ) 原始碼和註釋:

#matplotlib.figure.Figure.show( )
def show(self,warn=True):
 """
 If using a GUI backend with pyplot,display the figure window.

 If the figure was not created using
 :func:`~matplotlib.pyplot.figure`,it will lack a
 :class:`~matplotlib.backend_bases.FigureManagerBase`,and
 will raise an AttributeError.

 Parameters
 ----------
 warm : bool
  If ``True``,issue warning when called on a non-GUI backend

 Notes
 -----
 For non-GUI backends,this does nothing,in which case a warning will
 be issued if *warn* is ``True`` (default).
 """
 try:
  manager = getattr(self.canvas,'manager')
 except AttributeError as err:
  raise AttributeError("%s\n"
        "Figure.show works only "
        "for figures managed by pyplot,normally "
        "created by pyplot.figure()." % err)

 if manager is not None:
  try:
   manager.show()
   return
  except NonGuiException:
   pass

它是通過manager.show()來實現畫圖的動作的。

2. 追尋plt.show()

而在==plt.show( )==的原始碼中我們可以查到:

#plt.show()
from matplotlib.backends import pylab_setup
_show = pylab_setup()
def show(*args,**kw):

 global _show
 return _show(*args,**kw)

而我們繼續查詢就得到了,這是在backends包的__init__.py模組裡的程式碼,程式碼說了一大堆,無非就是說它返回了四個物件:backend_mod,new_figure_manager,draw_if_interactive,show。而show就是show = getattr(backend_mod,'show',do_nothing_show)得到的其中backend_mod就是要匯入模組的絕對路徑,之後驗證的show就是matplotlib.backends.backend_tkagg._BackendTkAgg,繼續追尋之後我們得到class _BackendTkAgg(_BackendTk): FigureCanvas = FigureCanvasTkAgg,之後我們用help函式得到

show(block=None) method of builtins.type instance
 Show all figures.
 
 `show` blocks by calling `mainloop` if *block* is ``True``,or if it
 is ``None`` and we are neither in IPython's ``%pylab`` mode,nor in
 `interactive` mode.

我們繼續刨根,尋找從FigureCanvas開始的類的關係和其方法,類的繼承結構關係如下圖

淺談matplotlib中FigureCanvasXAgg的用法

然後終於在FigureCnavasTk類的宣告中找到了這樣的一句宣告:

show = cbook.deprecated("2.2",name="FigureCanvasTk.show",alternative="FigureCanvasTk.draw")(
        lambda self: self.draw())

也就是說show歸根結底是backend裡的一個FigureCanvasTk.draw()的一個變形 !

pylab_setup程式碼如下:

def pylab_setup(name=None):
 '''return new_figure_manager,draw_if_interactive and show for pyplot

 This provides the backend-specific functions that are used by
 pyplot to abstract away the difference between interactive backends.

 Parameters
 ----------
 name : str,optional
  The name of the backend to use. If `None`,falls back to
  ``matplotlib.get_backend()`` (which return :rc:`backend`).

 '''
 # Import the requested backend into a generic module object
 if name is None:
  # validates,to match all_backends
  name = matplotlib.get_backend()
 if name.startswith('module://'):
  backend_name = name[9:]
 else:
  backend_name = 'backend_' + name
  backend_name = backend_name.lower() # until we banish mixed case
  backend_name = 'matplotlib.backends.%s' % backend_name.lower()

 # the last argument is specifies whether to use absolute or relative
 # imports. 0 means only perform absolute imports.
 #得到模組的絕對路徑backend_mod,然後通過絕對路徑加.就可以呼叫各個抽象類
 #<module 'matplotlib.backends.backend_tkagg' from 'D:\\Python36\\lib\\site-packages\\matplotlib\\backends\\backend_tkagg.py'>預設實驗的!
 backend_mod = __import__(backend_name,globals(),locals(),[backend_name],0)

 # Things we pull in from all backends
 new_figure_manager = backend_mod.new_figure_manager

 # image backends like pdf,agg or svg do not need to do anything
 # for "show" or "draw_if_interactive",so if they are not defined
 # by the backend,just do nothing
 def do_nothing_show(*args,**kwargs):
  frame = inspect.currentframe()
  fname = frame.f_back.f_code.co_filename
  if fname in ('<stdin>','<ipython console>'):
   warnings.warn("""
Your currently selected backend,'%s' does not support show().
Please select a GUI backend in your matplotlibrc file ('%s')
or with matplotlib.use()""" %
       (name,matplotlib.matplotlib_fname()))

 def do_nothing(*args,**kwargs):
  pass

 backend_version = getattr(backend_mod,'backend_version','unknown')

 show = getattr(backend_mod,do_nothing_show)

 draw_if_interactive = getattr(backend_mod,'draw_if_interactive',do_nothing)

 _log.debug('backend %s version %s',name,backend_version)

 # need to keep a global reference to the backend for compatibility
 # reasons. See https://github.com/matplotlib/matplotlib/issues/6092
 global backend
 backend = name
 return backend_mod,show

3. 追尋plt.figure()

我們建立的這個figure必須有manager,否則則會報錯,如果是plt.figure初始化的,plt.figure( )原始碼如下:

plt.figure()示例

def figure():

 figManager = _pylab_helpers.Gcf.get_fig_manager(num)

 figManager = new_figure_manager(num,figsize=figsize,dpi=dpi,facecolor=facecolor,edgecolor=edgecolor,frameon=frameon,FigureClass=FigureClass,**kwargs)
 ......
 ......
 return figManager.canvas.figure

4. 追尋matplotlib.figure.Figure()

而在matplotlib.figure.Figure() 中,其初始化函式__init__(),並沒有預設生成manager這個屬性,所以在呼叫show的時候,就會報錯!如上其show函式定義的那樣

 def __init__(self,figsize=None,# defaults to rc figure.figsize
     dpi=None,# defaults to rc figure.dpi
     facecolor=None,# defaults to rc figure.facecolor
     edgecolor=None,# defaults to rc figure.edgecolor
     linewidth=0.0,# the default linewidth of the frame
     frameon=None,# whether or not to draw the figure frame
     subplotpars=None,# default to rc
     tight_layout=None,# default to rc figure.autolayout
     constrained_layout=None,# default to rc
           #figure.constrained_layout.use
     ):
  """
  Parameters
  ----------
  figsize : 2-tuple of floats
   ``(width,height)`` tuple in inches

  dpi : float
   Dots per inch

  facecolor
   The figure patch facecolor; defaults to rc ``figure.facecolor``

  edgecolor
   The figure patch edge color; defaults to rc ``figure.edgecolor``

  linewidth : float
   The figure patch edge linewidth; the default linewidth of the frame

  frameon : bool
   If ``False``,suppress drawing the figure frame

  subplotpars : :class:`SubplotParams`
   Subplot parameters,defaults to rc

  tight_layout : bool
   If ``False`` use *subplotpars*; if ``True`` adjust subplot
   parameters using `.tight_layout` with default padding.
   When providing a dict containing the keys
   ``pad``,``w_pad``,``h_pad``,and ``rect``,the default
   `.tight_layout` paddings will be overridden.
   Defaults to rc ``figure.autolayout``.

  constrained_layout : bool
   If ``True`` use constrained layout to adjust positioning of plot
   elements. Like ``tight_layout``,but designed to be more
   flexible. See
   :doc:`/tutorials/intermediate/constrainedlayout_guide`
   for examples. (Note: does not work with :meth:`.subplot` or
   :meth:`.subplot2grid`.)
   Defaults to rc ``figure.constrained_layout.use``.
  """
  Artist.__init__(self)
  # remove the non-figure artist _axes property
  # as it makes no sense for a figure to be _in_ an axes
  # this is used by the property methods in the artist base class
  # which are over-ridden in this class
  del self._axes
  self.callbacks = cbook.CallbackRegistry()

  if figsize is None:
   figsize = rcParams['figure.figsize']
  if dpi is None:
   dpi = rcParams['figure.dpi']
  if facecolor is None:
   facecolor = rcParams['figure.facecolor']
  if edgecolor is None:
   edgecolor = rcParams['figure.edgecolor']
  if frameon is None:
   frameon = rcParams['figure.frameon']

  if not np.isfinite(figsize).all():
   raise ValueError('figure size must be finite not '
        '{}'.format(figsize))
  self.bbox_inches = Bbox.from_bounds(0,*figsize)

  self.dpi_scale_trans = Affine2D().scale(dpi,dpi)
  # do not use property as it will trigger
  self._dpi = dpi
  self.bbox = TransformedBbox(self.bbox_inches,self.dpi_scale_trans)

  self.frameon = frameon

  self.transFigure = BboxTransformTo(self.bbox)

  self.patch = Rectangle(
   xy=(0,0),width=1,height=1,linewidth=linewidth)
  self._set_artist_props(self.patch)
  self.patch.set_aa(False)

  self._hold = rcParams['axes.hold']
  if self._hold is None:
   self._hold = True

  self.canvas = None
  self._suptitle = None

  if subplotpars is None:
   subplotpars = SubplotParams()

  self.subplotpars = subplotpars
  # constrained_layout:
  self._layoutbox = None
  # set in set_constrained_layout_pads()
  self.set_constrained_layout(constrained_layout)

  self.set_tight_layout(tight_layout)

  self._axstack = AxesStack() # track all figure axes and current axes
  self.clf()
  self._cachedRenderer = None

  # groupers to keep track of x and y labels we want to align.
  # see self.align_xlabels and self.align_ylabels and
  # axis._get_tick_boxes_siblings
  self._align_xlabel_grp = cbook.Grouper()
  self._align_ylabel_grp = cbook.Grouper()

綜上所述,我們通過matplotlib.figure.Figure()來建立得到的fig,並不具備manager的屬性,而通過plt.figure()建立的fig,就預設建立了manager。

二 . renderer(渲染器),預設是tkagg

對應抽象的類:RendererBase and GraphicsContextBase

作用:

- 很多渲染操作都傳遞給一個額外的抽象:GraphicsContextBase,它為處理顏色、線條樣式、起始樣式、混合屬性和反混疊選項等的程式碼提供了一個乾淨的分離。

Qt & matplotlib示例程式碼

#import modules from Matplotlib
from matplotlib.backends.backend_qt4agg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.backends.backend_qt4agg import NavigationToolbar2QTAgg as NavigationToolbar
import matplotlib.pyplot as plt
#import random module to generate set
import random

class Window(QtGui.QDialog):
	def __init__(self,parent=None):
		super(Window,self).__init__(parent)
		#init figure and canvas
		self.figure = plt.figure()
		self.canvas = FigureCanvas(self.figure)
		#init nav toolbar
		self.toolbar = NavigationToolbar(self.canvas,self)
		# Add plot button
		self.button = QtGui.QPushButton('Plot')
		# connect button to custom slot (see later)
		self.button.clicked.connect(self.plot)
		# set the layout
		layout = QtGui.QVBoxLayout()
		layout.addWidget(self.toolbar)
		layout.addWidget(self.canvas)
		layout.addWidget(self.button)
		self.setLayout(layout)
	### our custom slot
	def plot(self):
		# random data
		data = [random.random() for i in range(25)]
		# create an axis
		ax = self.figure.add_subplot(1,1,1)
		# discards the old graph
		ax.hold(False)
		# plot data
		ax.plot(data,'*­')
		# refresh canvas
		self.canvas.draw()

三. Problems(GUI畫3D不能旋轉)

一個Axes3D建立callback函式給畫布上的圖形實現旋轉特性。如果說先給圖形(figure)增加axes或者其他配件的時候,在之後將圖形附加到畫布的時候,之前新增的axes的callback函式可能不能夠接收訊息事件,也就沒辦法在繪出的GUI實現旋轉的效能。

所以應該先將圖形附加到畫布上,然後再對圖形增加axes和其他的配件。

FigureCanvas(figure,canvas)

figure:需要附加的圖形(新增者),canvas提供渲染功能的物件(承載者)

每一次你呼叫FigureCanvas()的時候,你都是將圖形附加到新畫布上(這不是你所看到的的那個canvas),於是 the call-backs函式將不會被射擊(接收事件訊號),因為他們正在監聽一個你看不到的canvas。

四 . 附錄

淺談matplotlib中FigureCanvasXAgg的用法

以上這篇淺談matplotlib中FigureCanvasXAgg的用法就是小編分享給大家的全部內容了,希望能給大家一個參考,也希望大家多多支援我們。