U \ ¸aÆã@s®ddlZddlmZmZddlmZddlmZddl m Z m Z Gdd„dƒZ iZ e d¡d dd„ƒZeeƒZd d „Zejje e¡d e ej¡ejje e¡d dS)éN)Ú_apiÚ docstring)ÚAxes)ÚGridSpecÚ SubplotSpecc@s.eZdZdZdd„Zdd„Zejdddd d d „ƒZejdd d dd„ƒZ dd„Z dd„Z dd„Z ejddd e dd„ƒƒZejddd e dd„ƒƒZejddd e dd„ƒƒZe d¡dd „ƒZejdd!d d"d#„ƒZejdd$d d%d&„ƒZejdd'd d(d)„ƒZejdd*d d+d,„ƒZd-d.„Zd/d0„Zd1S)2Ú SubplotBasez¶ Base class for subplots, which are :class:`Axes` instances with additional methods to facilitate generating and manipulating a set of :class:`Axes` within a figure. cOs2|jj||ddddgf|Ž| t ||¡¡dS)a› Parameters ---------- fig : `matplotlib.figure.Figure` *args : tuple (*nrows*, *ncols*, *index*) or int The array of subplots in the figure has dimensions ``(nrows, ncols)``, and *index* is the index of the subplot being created. *index* starts at 1 in the upper left corner and increases to the right. If *nrows*, *ncols*, and *index* are all single digit numbers, then *args* can be passed as a single 3-digit number (e.g. 234 for (2, 3, 4)). **kwargs Keyword arguments are passed to the Axes (sub)class constructor. réN)Ú _axes_classÚ__init__Úset_subplotspecrZ_from_subplot_args)ÚselfZfigÚargsÚkwargs©rú=/tmp/pip-unpacked-wheel-wjyw_3jo/matplotlib/axes/_subplots.pyr szSubplotBase.__init__cCs(tdd„t|ƒjDƒƒ}t|f| ¡fS)Ncss&|]}t|tƒrt|tƒs|VqdS©N)Ú issubclassrr)Ú.0ÚcrrrÚ *s ÿz)SubplotBase.__reduce__..)ÚnextÚtypeÚ__mro__Ú$_picklable_subplot_class_constructorÚ __getstate__)r Ú axes_classrrrÚ __reduce__(sÿþzSubplotBase.__reduce__z3.4Úget_subplotspecz1(get_subplotspec returns a SubplotSpec instance.))Ú alternativeZaddendumcCs"| ¡ ¡\}}}}|||dfS)z*Get the subplot geometry, e.g., (2, 2, 3).r)rÚ get_geometry)r ZrowsÚcolsZnum1Znum2rrrr1szSubplotBase.get_geometryr )rcCs2t|||jd|d|_| ¡| |j¡dS)z;Change subplot geometry, e.g., from (1, 1, 1) to (2, 2, 3).)ÚfigurerN)rr!Ú _subplotspecÚ update_paramsZ set_positionÚfigbox)r ZnumrowsZnumcolsÚnumrrrÚchange_geometry9sÿÿzSubplotBase.change_geometrycCs|jS)z?Return the `.SubplotSpec` instance associated with the subplot.)r"©r rrrrAszSubplotBase.get_subplotspeccCs||_| | |j¡¡dS)z=Set the `.SubplotSpec`. instance associated with the subplot.N)r"Z _set_positionÚ get_positionr!)r Z subplotspecrrrr EszSubplotBase.set_subplotspeccCs |j ¡S)zrrrrr sL þ   ÿ              rcs|ˆdkrtjdddt‰zt‡fdd„t ¡DƒƒWStk rvtˆtƒrXˆYStdˆj tˆfdˆiƒYSXdS) aF Make a new class that inherits from `.SubplotBase` and the given axes_class (which is assumed to be a subclass of `.axes.Axes`). This is perhaps a little bit roundabout to make a new class on the fly like this, but it means that a new Subplot class does not have to be created for every type of Axes. Nz3.3z§Support for passing None to subplot_class_factory is deprecated since %(since)s; explicitly pass the default Axes class instead. This will become an error %(removal)s.)Úmessagec3s |]}|jtˆfkr|VqdSr)Ú __bases__r)rÚcls©rrrr·sÿz(subplot_class_factory..z %sSubplotr ) rZwarn_deprecatedrrrÚ__subclasses__Ú StopIterationrrr?rHrrHrÚsubplot_class_factory£s ÿ  þrKcCst|ƒ}| |¡S)zµ Stub factory that returns an empty instance of the appropriate subplot class when called with an axes class. This is purely to allow pickling of Axes and Subplots. )rKÚ__new__)rZ subplot_classrrrrÆsr)Z Axes_kwdoc)Z Subplot_kwdoc)N)Ú functoolsZ matplotlibrrZmatplotlib.artistZartistZmartistZmatplotlib.axes._axesrZmatplotlib.gridspecrrrZ_subplot_classesÚ lru_cacherKZSubplotrZinterpdÚupdateZkwdocZdedent_interpdr rrrrÚs