a Sic@s^dZddlmZddlmZddlZddlZddlZddlZddl m Z ddl Z ddl Z ddl Z ddlZddlmZddlZddlZddlZddlmZddlmZmZdd lmZmZdd lmZdd lmZdd lmZmZdd lmZmZm Z ddl!m"Z"m#Z#ddlm$Z$m%Z%m&Z&m'Z'ddl(m)Z*ddl+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddlm2Z2ddl3m4Z4ddlm5Z5ddl6m7Z8m9Z9ddl:m;Z<ddl=Z>ddl:m?Z?ddl@mAZAddlBmCZCmDZDddlEmFZFmGZGmHZHmIZIddlJmKZKmLZLmMZMddlNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZaebecZddd d!Zeed"gd#Zfefjgahd$d%Zid&d'Zjd(d)ZkejljmZmeeejnd*d+Zneee,jodd-d.Zod/d0Zpdaqd1d2Zrd3d4Zsd5d6Ztd7d8Zud9d:Zvd;d<Zwd=d>Zxd?d@ZydAdBZzdCdDZ{eeej|dEdFZ|eeej}ddGdHZ}eeej~dIdJZ~eeejjdKdLZeeejjdMdNZeeejjdOdPZddSdTZedUdVdddddd,edWfdXdYZdZd[Zd\d]Zd^d_Zd`daZdbdcZdddeZeeejdfdgZeeejdhdiZddjdkZdldmZdndoZeeejdpdqZdrdsZejjr\ejjdtdue_ejddvdwZddxdyZdzd{Zd|d}Zejd~dZddWdWd,dddddddZdWdWddddddddZdddZdddZdddZdddZdddZddZddZddWdddZddWdddZdddZdddZhdZddZeeejdddZdddZdddZe5jje_ddZeeejjdddZeeejjddZdddZddZe$dr&e$ee*ddhvr&er&ee$dejeeejdddZeeejdddZeeejddZeeejddZeeejƒddd,ejejejfddZeeejƃdddZeeejǃddÄZeeejȃdddddŜddDŽZeeejɃdddʄZeee.jʃdd˜dd̈́Zeee.j˃ddd˜ddτZeee.j̃ddd҄Zeee.j̓ddԄZeee.j΃dddׄZeee.jσdddلZeee.jЃdddۄZeee.jуd,dܜddބZeee.j҃dddߜddZeee.jӃdddZeee.jԃdddZeee.jՃddddddZeee.jփdd˜ddZeee.j׃ddddddZeee.j؃dddddddZeee.jكddd˜ddZeee.jڃdd˜ddZeee.jۃdddZeee.j܃ddRde2je2jddddf dd˜ddZeee.j߃dd˜ddZeee.jdd˜ddZeee.jddd˜ddZeee.jddd˜ddZeee.jddd˜d d Zeee.jdd˜d d Zeee.jddd˜d dZeee.jddd˜ddZeee.jdddZeee.jddQddddddddddde>jddWfdd˜ddZeee.jddd˜ddZeee.jddddWddddZeee.jddd˜d d!Zeee.jddd˜d"d#Zeee.jddd,d$dddd%d&d'Zeee.jd(d)Zeee.jdd*d+Zeee.jd,d-Zeee.jddd˜d.d/Zeee.jddd,d0d1d2Zeee.jd3d4Zeee.jd5d6Zeee.jdddddddd7d8d9Zeee.jdddddddWdd:d;d<Zeee.jddd˜d=d>Zeee.jdd,ddBdCdDZeee.jd,d,ddEdFdGZeee.jddd˜dIdJZeee.jddd˜dKdLZeee.jdd˜dMdNZeee.jdOdPZeee.jdddWddQdRdSZeee.jdTdUZeee.jdVdWZeee.jddd˜dXdYZeee.jdd\d]Zeee.jd^dd_dd`dadbZeee.jdddddejjdddcdddeZeee.jdfddgdhdiZeee.jddd˜dldmZeee.j ddrdsZ eee.jddtduZeee.j ddvdwZ eee.j dՐddddddxdydzZ eee.j d{d|Z eee.j d}d~Z eee.jddddddddddZeee.jddZeee.jddd˜ddZeee.jddd˜ddZeee.jd,e2jd,dfdd˜ddZeee.jddZeee.jdddddZeee.jdddddZeee.jdddddZeee.jddZeee.jddZddZddZ ddZ!ddZ"ddZ#ddZ$ddZ%ddZ&ddZ'ddZ(ddZ)ddZ*ddZ+ddZ,ddZ-ddZ.ddZ/ddZ0ddZ1dS(a `matplotlib.pyplot` is a state-based interface to matplotlib. It provides an implicit, MATLAB-like, way of plotting. It also opens figures on your screen, and acts as the figure GUI manager. pyplot is mainly intended for interactive plots and simple cases of programmatic plot generation:: import numpy as np import matplotlib.pyplot as plt x = np.arange(0, 5, 0.1) y = np.sin(x) plt.plot(x, y) The explicit object-oriented API is recommended for complex plots, though pyplot is still usually used to create the figure and often the axes in the figure. See `.pyplot.figure`, `.pyplot.subplots`, and `.pyplot.subplot_mosaic` to create figures, and :doc:`Axes API ` for the plotting methods on an Axes:: import numpy as np import matplotlib.pyplot as plt x = np.arange(0, 5, 0.1) y = np.sin(x) fig, ax = plt.subplots() ax.plot(x, y) See :ref:`api_interfaces` for an explanation of the tradeoffs between the implicit and explicit interfaces. ) ExitStack)EnumN)Number)cycler)_api)rcsetupstyle)_pylab_helpers interactive)cbook) _docstring)FigureCanvasBase MouseButton)Figure FigureBase figaspect)GridSpec SubplotSpec)rcParamsrcParamsDefault get_backend rcParamsOrig)interactive_bk)Artist)AxesSubplot) PolarAxes)mlab)get_scale_names)cm) _colormaps register_cmap)_color_sequences) Normalize)Line2D)Text Annotation)Polygon RectangleCircleArrow)ButtonSliderWidget) TickHelper FormatterFixedFormatter NullFormatter FuncFormatterFormatStrFormatterScalarFormatter LogFormatterLogFormatterExponentLogFormatterMathtextLocator IndexLocator FixedLocator NullLocator LinearLocator LogLocator AutoLocatorMultipleLocator MaxNLocatorcCst|durtt|St|g}t|dddurTtjj |}|rL| ||j }q |dddD] }||}qb|S)N __wrapped__) functoolspartial_copy_docstring_and_deprecatorsr copygetattrr deprecation DECORATORSgetappendrB)methodfunc decorators decoratorrQM/var/www/html/django/DPS/env/lib/python3.9/site-packages/matplotlib/pyplot.pyrF\s    rF_ReplDisplayHook)NONEPLAINIPYTHONcCstrtdSN) matplotlibis_interactivedraw_allrQrQrQrR_draw_all_if_interactiveusr[cCs|ttjurdStjd}|s(tjadS|}|s>tjadS|j dt tjaddl m }|t }|rx||dS)a\ Connect to the display hook of the current shell. The display hook gets called when the read-evaluate-print-loop (REPL) of the shell has finished the execution of a command. We use this callback to be able to automatically update a figure in interactive mode. This works both with IPython and with vanilla python shells. NIPython post_executer) backend2gui)_REPL_DISPLAYHOOKrSrVsysmodulesrKrU get_ipythoneventsregisterr[ZIPython.core.pylabtoolsr^rZ enable_gui)Z mod_ipythonipr^Zipython_gui_namerQrQrRinstall_repl_displayhookzs    rfcCs4ttjur*ddlm}|}|jdttjadS)z6Disconnect from the display hook of the current shell.r)rbr]N) r_rSrVr\rbrc unregisterr[rT)rbrerQrQrRuninstall_repl_displayhooks   rhcOstj|i|SrW)rX set_loglevelargskwargsrQrQrRrisriTcCs|durt}|j||dS)N) include_self)gcffindobj)omatchrmrQrQrRrosrocCs&t|jdstjddddS|jjS)Nrequired_interactive_framework3.6zMSupport for FigureCanvases without a required_interactive_framework attribute)name)hasattr FigureCanvasrwarn_deprecatedrr backend_modrQrQrR#_get_required_interactive_frameworks  rzcCstdurtttdtS)z Ensure that a backend is selected and return it. This is currently private, but may be made public in the future. Nbackend) _backend_modswitch_backenddict __getitem__rrQrQrQrR_get_backend_modsrc sddltd|tjurt}dddddd d d }||d}|durR|g}ng}|gd 7}|D]6}z t|WntyYqfYqf0|t d <dSqftd d t d <dSt t |j t}|dur t}|r |r ||kr td|||tdd}Gfdddjj|durtfddtdfdd }fdd}_|_|_td|j|td <td <adD]} tt| t| _ q|j!_"t#dS)a Close all open figures and set the Matplotlib backend. The argument is case-insensitive. Switching to an interactive backend is possible only if no event loop for another interactive backend has started. Switching to and from non-interactive backends is always possible. Parameters ---------- newbackend : str The name of the backend to use. rNallqtagggtk3agggtk4aggwxaggtkaggmacosxagg)qtgtk3gtk4wxtkrheadless)rrrrrrr{zdCannot load backend {!r} which requires the {!r} interactive framework, as {!r} is currently runningnew_figure_managercseZdZeedS)z#switch_backend..backend_modN)__name__ __module__ __qualname__localsupdatevarsrQrxrQrRry srycs ||SrW) new_manager)numfigure) canvas_classrQrRnew_figure_manager_given_figure(sz7switch_backend..new_figure_manager_given_figure) FigureClasscs||i|}||SrWrQ)rrrkrlfig)rrQrRr+sz*switch_backend..new_figure_managercs$r tj}|r |jdSrW)rYr Gcf get_activecanvas draw_idlemanager)rXrQrRdraw_if_interactive/s z+switch_backend..draw_if_interactivezLoaded backend %s version %s.)rrshow)$Zmatplotlib.backendscloser_auto_backend_sentinelr "_get_running_interactive_frameworkrKr} ImportErrorr importlib import_module_backend_module_namervrzformatrHZ backend_basesZ_Backendrrrr_logdebugZbackend_versionrrr|inspect signatureglobals __signature__backendsr{rf) Z newbackendZcurrent_frameworkmappingZ best_guess candidates candidateZrequired_frameworkrr func_namerQ)ryrrXrrRr}s~            r}cCs*ttr&ttjkr&tddS)NzFStarting a Matplotlib GUI outside of the main thread will likely fail.)rzr threading get_native_id main_thread native_idr warn_externalrQrQrQrR_warn_if_gui_out_of_main_threadLs  rcOsttj|i|S)z%Create a new figure manager instance.)rrrrjrQrQrRrXsrcOstj|i|S)z Redraw the current figure if in interactive mode. .. warning:: End users will typically not have to call this function because the the interactive mode takes care of this. )rrrjrQrQrRr_s rcOsttj|i|S)a Display all open figures. Parameters ---------- block : bool, optional Whether to wait for all figures to be closed before returning. If `True` block and run the GUI main loop until all figure windows are closed. If `False` ensure that all figure windows are displayed and return immediately. In this case, you are responsible for ensuring that the event loop is running to have responsive figures. Defaults to True in non-interactive mode and to False in interactive mode (see `.pyplot.isinteractive`). See Also -------- ion : Enable interactive mode, which shows / updates the figure after every plotting command, so that calling ``show()`` is not necessary. ioff : Disable interactive mode. savefig : Save the figure to an image file instead of showing it on screen. Notes ----- **Saving figures to file and showing a window at the same time** If you want an image file as well as a user interface window, use `.pyplot.savefig` before `.pyplot.show`. At the end of (a blocking) ``show()`` the figure is closed and thus unregistered from pyplot. Calling `.pyplot.savefig` afterwards would save a new and thus empty figure. This limitation of command order does not apply if the show is non-blocking or if you keep a reference to the figure and use `.Figure.savefig`. **Auto-show in jupyter notebooks** The jupyter backends (activated via ``%matplotlib inline``, ``%matplotlib notebook``, or ``%matplotlib widget``), call ``show()`` at the end of every cell by default. Thus, you usually don't have to call it explicitly there. )rrrrjrQrQrRrls,rcCstS)a% Return whether plots are updated after every plotting command. The interactive mode is mainly useful if you build plots from the command line and want to see the effect of each command while you are building the figure. In interactive mode: - newly created figures will be shown immediately; - figures will automatically redraw on change; - `.pyplot.show` will not block by default. In non-interactive mode: - newly created figures and changes to figures will not be reflected until explicitly asked to be; - `.pyplot.show` will block by default. See Also -------- ion : Enable interactive mode. ioff : Disable interactive mode. show : Show all figures (and maybe block). pause : Show all figures, and block for a time. )rXrYrQrQrQrR isinteractivesrcCs.t}|trtnttdt|S)a Disable interactive mode. See `.pyplot.isinteractive` for more details. See Also -------- ion : Enable interactive mode. isinteractive : Whether interactive mode is enabled. show : Show all figures (and maybe block). pause : Show all figures, and block for a time. Notes ----- For a temporary change, this can be used as a context manager:: # if interactive mode is on # then figures will be shown on creation plt.ion() # This figure will be shown immediately fig = plt.figure() with plt.ioff(): # interactive mode will be off # figures will not automatically be shown fig2 = plt.figure() # ... To enable optional usage as a context manager, this function returns a `~contextlib.ExitStack` object, which is not intended to be stored or accessed by the user. F)rcallbackrionioffrXr rhstackrQrQrRrs ! rcCs.t}|trtnttdt|S)a Enable interactive mode. See `.pyplot.isinteractive` for more details. See Also -------- ioff : Disable interactive mode. isinteractive : Whether interactive mode is enabled. show : Show all figures (and maybe block). pause : Show all figures, and block for a time. Notes ----- For a temporary change, this can be used as a context manager:: # if interactive mode is off # then figures will not be shown on creation plt.ioff() # This figure will not be shown immediately fig = plt.figure() with plt.ion(): # interactive mode will be on # figures will automatically be shown fig2 = plt.figure() # ... To enable optional usage as a context manager, this function returns a `~contextlib.ExitStack` object, which is not intended to be stored or accessed by the user. T)rrrrrrXr rfrrQrQrRrs ! rcCsLtj}|dur>|j}|jjr(|tdd||n t |dS)a Run the GUI event loop for *interval* seconds. If there is an active figure, it will be updated and displayed before the pause, and the GUI event loop (if any) will run during the pause. This can be used for crude animation. For more complex animation use :mod:`matplotlib.animation`. If there is no active figure, sleep for *interval* seconds instead. See Also -------- matplotlib.animation : Proper animations show : Show all figures and optional block until all figures are closed. NF)block) r rrrrstalerrZstart_event_looptimesleep)intervalrrrQrQrRpause s   rcKstj|fi|dSrW)rXrc)grouprlrQrQrRr&srcCs t||SrW)rX rc_context)rfnamerQrQrRr+srcCsttrtdSrW)rX rcdefaultsrYrZrQrQrQrRr0srcOstjj|g|Ri|SrW)rXartistgetpobjrkrlrQrQrRr:srcOstjj|g|Ri|SrW)rXrrKrrQrQrRrK?srKcOstjj|g|Ri|SrW)rXrsetprrQrQrRrDsrdcCsztdrtdt}|tjttddlm}tgdd|||f|j ddd gd d d d dddddddd|S)a Turn on `xkcd `_ sketch-style drawing mode. This will only have effect on things drawn after this function is called. For best results, the "Humor Sans" font should be installed: it is not included with Matplotlib. Parameters ---------- scale : float, optional The amplitude of the wiggle perpendicular to the source line. length : float, optional The length of the wiggle along the line. randomness : float, optional The scale factor by which the length is shrunken or expanded. Notes ----- This function works by a number of rcParams, so it will probably override others you have set before. If you want the effects of this function to be temporary, it can be used as a context manager, for example:: with plt.xkcd(): # This figure will be in XKCD-style fig1 = plt.figure() # ... # This figure will be in regular style fig2 = plt.figure() z text.usetexz3xkcd mode is not compatible with text.usetex = Truer) patheffects)xkcdz xkcd Scriptz Humor Sansz Comic Neuez Comic Sans MSg,@w) linewidth foregroundg?g@whitegFblack)z font.familyz font.sizez path.sketchz path.effectszaxes.linewidthzlines.linewidthzfigure.facecolorzgrid.linewidthz axes.gridzaxes.unicode_minuszaxes.edgecolorzxtick.major.sizezxtick.major.widthzytick.major.sizezytick.major.width) r RuntimeErrorrrr~rrGrXrZ withStroke)scalelengthZ randomnessrrrQrQrRrIs4$  rrs facecolorFc Ksrt|tr4|jjdurtdtj|jj|jSt } | rJt | dnd} d} |dur`| }nPt|t r|} t } | | vr| dkrt d| }q| | } | | }nt|}tj|}|durXtd}t| |krdkrnnt d|d tt|f||||||d |}|jj}| r4|| tj|tttjurXt|_|rj|jj|jjS) a Create a new figure, or activate an existing figure. Parameters ---------- num : int or str or `.Figure` or `.SubFigure`, optional A unique identifier for the figure. If a figure with that identifier already exists, this figure is made active and returned. An integer refers to the ``Figure.number`` attribute, a string refers to the figure label. If there is no figure with the identifier or *num* is not given, a new figure is created, made active and returned. If *num* is an int, it will be used for the ``Figure.number`` attribute, otherwise, an auto-generated integer value is used (starting at 1 and incremented for each new figure). If *num* is a string, the figure label and the window title is set to this value. If num is a ``SubFigure``, its parent ``Figure`` is activated. figsize : (float, float), default: :rc:`figure.figsize` Width, height in inches. dpi : float, default: :rc:`figure.dpi` The resolution of the figure in dots-per-inch. facecolor : color, default: :rc:`figure.facecolor` The background color. edgecolor : color, default: :rc:`figure.edgecolor` The border color. frameon : bool, default: True If False, suppress drawing the figure frame. FigureClass : subclass of `~matplotlib.figure.Figure` If set, an instance of this subclass will be created, rather than a plain `.Figure`. clear : bool, default: False If True and the figure already exists, then it is cleared. layout : {'constrained', 'tight', `.LayoutEngine`, None}, default: None The layout mechanism for positioning of plot elements to avoid overlapping Axes decorations (labels, ticks, etc). Note that layout managers can measurably slow down figure display. Defaults to *None* (but see the documentation of the `.Figure` constructor regarding the interaction with rcParams). **kwargs Additional keyword arguments are passed to the `.Figure` constructor. Returns ------- `~matplotlib.figure.Figure` Notes ----- Newly created figures are passed to the `~.FigureCanvasBase.new_manager` method or the `new_figure_manager` function provided by the current backend, which install a canvas and a manager on the figure. If you are creating many figures, make sure you explicitly call `.pyplot.close` on the figures you are not using, because this will enable pyplot to properly clean up the memory. `~matplotlib.rcParams` defines the default values, which can be modified in the matplotlibrc file. Nz*The passed figure is not managed by pyplotr.rz)close('all') closes all existing figures.zfigure.max_open_warningz More than a figures have been opened. Figures created through the pyplot interface (`matplotlib.pyplot.figure`) are retained until explicitly closed and may consume too much memory. (To control this warning, see the rcParam `figure.max_open_warning`). Consider using `matplotlib.pyplot.close()`.)figsizedpir edgecolorframeonr) isinstancerrr ValueErrorr rZ set_activer get_fignumsmaxstr get_figlabelsrrindexintZget_fig_managerrlenRuntimeWarningr set_labelZ_set_new_active_managerrr_rSrU_auto_draw_if_interactiveZstale_callbackclear)rrrrrrrrrlZallnumsZnext_numZ fig_label all_labelsZinumrZmax_open_warningrrQrQrRrs^P              rcCsV|rRtrR|jsR|jjsR|j|jWdn1sH0YdS)z An internal helper function for making sure that auto-redrawing works as intended in the plain python repl. Parameters ---------- fig : Figure A figure object which is assumed to be associated with a canvas N)rXrYrZ is_savingZ_is_idle_drawingZ_idle_draw_cntxr)rvalrQrQrRrs  rcCs$tj}|dur|jjStSdS)a Get the current figure. If there is currently no figure on the pyplot figure stack, a new one is created using `~.pyplot.figure()`. (To test whether there is currently a figure on the pyplot figure stack, check whether `~.pyplot.get_fignums()` is empty.) N)r rrrrrrQrQrRrn1s rncCstj|p|tvS)z3Return whether the figure with the given id exists.)r rZ has_fignumrrrQrQrR fignum_existsAsrcCs ttjjS)z)Return a list of existing figure numbers.)sortedr rZfigsrQrQrQrRrFsrcCs(tj}|jddddd|DS)z(Return a list of existing figure labels.cSs|jSrWr)mrQrQrRNzget_figlabels..)keycSsg|]}|jjqSrQ)rr get_label).0rrQrQrR Orz!get_figlabels..)r rZget_all_fig_managerssort)managersrQrQrRrKs rcCs tjjS)ah Return the figure manager of the current figure. The figure manager is a container for the actual backend-depended window that displays the figure on screen. If no current figure exists, a new one is created, and its figure manager is returned. Returns ------- `.FigureManagerBase` or backend-dependent subclass thereof )rnrrrQrQrQrRget_current_fig_managerRsrcCstj||SrW)rnr mpl_connect)srNrQrQrRconnectcsrcCstj|SrW)rnrmpl_disconnect)cidrQrQrR disconnecthsr cCs|dur,tj}|durdStj|n|dkr@tjnt|trXtj|nxt|drrtj|jn^t|trt }||vrt | |}tj|n(t|t rtj |ntdt|dS)al Close a figure window. Parameters ---------- fig : None or int or str or `.Figure` The figure to close. There are a number of ways to specify this: - *None*: the current figure - `.Figure`: the given `.Figure` instance - ``int``: a figure number - ``str``: a figure name - 'all': all figures NrrzDclose() argument must be a Figure, an int, a string, or None, not %s)r rrdestroyZ destroy_allrrrurrrrrZ destroy_fig TypeErrortype)rrrrrQrQrRrms*      rcCstdS)zClear the current figure.N)rnrrQrQrQrRclfsrcCstjdS)a Redraw the current figure. This is used to update a figure that has been altered, but not automatically re-drawn. If interactive mode is on (via `.ion()`), this should be only rarely needed, but there may be ways to modify the state of a figure without marking it as "stale". Please report these cases as bugs. This is equivalent to calling ``fig.canvas.draw_idle()``, where ``fig`` is the current figure. N)rnrrrQrQrQrRdraws rcOs$t}|j|i|}|j|SrW)rnsavefigrr)rkrlrresrQrQrRrs rcOstj|i|SrW)rnlegendrjrQrQrR figlegendsrzlegend(z figlegend(cKs\t}|dd}|durF|dur2|jfi|S|j|fi|Sn|j|fi|SdS)a6 Add an Axes to the current figure and make it the current Axes. Call signatures:: plt.axes() plt.axes(rect, projection=None, polar=False, **kwargs) plt.axes(ax) Parameters ---------- arg : None or 4-tuple The exact behavior of this function depends on the type: - *None*: A new full window Axes is added using ``subplot(**kwargs)``. - 4-tuple of floats *rect* = ``[left, bottom, width, height]``. A new Axes is added with dimensions *rect* in normalized (0, 1) units using `~.Figure.add_axes` on the current figure. projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional The projection type of the `~.axes.Axes`. *str* is the name of a custom projection, see `~matplotlib.projections`. The default None results in a 'rectilinear' projection. polar : bool, default: False If True, equivalent to projection='polar'. sharex, sharey : `~.axes.Axes`, optional Share the x or y `~matplotlib.axis` with sharex and/or sharey. The axis will have the same limits, ticks, and scale as the axis of the shared Axes. label : str A label for the returned Axes. Returns ------- `~.axes.Axes`, or a subclass of `~.axes.Axes` The returned axes class depends on the projection used. It is `~.axes.Axes` if rectilinear projection is used and `.projections.polar.PolarAxes` if polar projection is used. Other Parameters ---------------- **kwargs This method also takes the keyword arguments for the returned Axes class. The keyword arguments for the rectilinear Axes class `~.axes.Axes` can be found in the following table but there might also be other keyword arguments if another projection is used, see the actual Axes class. %(Axes:kwdoc)s Notes ----- If the figure already has an Axes with key (*args*, *kwargs*) then it will simply make that axes current and return it. This behavior is deprecated. Meanwhile, if you do not want this behavior (i.e., you want to force the creation of a new axes), you must use a unique set of args and kwargs. The Axes *label* attribute has been exposed for this purpose: if you want two Axes that are otherwise identical to be added to the figure, make sure you give them unique labels. See Also -------- .Figure.add_axes .pyplot.subplot .Figure.add_subplot .Figure.subplots .pyplot.subplots Examples -------- :: # Creating a new full window Axes plt.axes() # Creating a new Axes with specified dimensions and a grey background plt.axes((left, bottom, width, height), facecolor='grey') positionN)rnpop add_subplotadd_axes)argrlrposrQrQrRaxessW rcCs|durt}|dS)zS Remove an `~.axes.Axes` (defaulting to the current axes) from its figure. N)gcaremoveaxrQrQrRdelaxes srcCst|j|j|dS)zT Set the current Axes to *ax* and the current Figure to the parent of *ax*. N)rscarrQrQrRr )s r cCs tS)zClear the current axes.)rclarQrQrQrRr!1sr!c sbt}|d|}|d|}||ur\|r\||urP|dkrPtd|d|dd|d<}t|dkrld}t|dkrt|d trtd d |vsd |vrt d t }t ||}|j D]Ftdr|kr|ikrqqj|j|i|krqq|j|i||fdd|j D}|rJtjddd|D]}t|qNS)a; Add an Axes to the current figure or retrieve an existing Axes. This is a wrapper of `.Figure.add_subplot` which provides additional behavior when working with the implicit API (see the notes section). Call signatures:: subplot(nrows, ncols, index, **kwargs) subplot(pos, **kwargs) subplot(**kwargs) subplot(ax) Parameters ---------- *args : int, (int, int, *index*), or `.SubplotSpec`, default: (1, 1, 1) The position of the subplot described by one of - Three integers (*nrows*, *ncols*, *index*). The subplot will take the *index* position on a grid with *nrows* rows and *ncols* columns. *index* starts at 1 in the upper left corner and increases to the right. *index* can also be a two-tuple specifying the (*first*, *last*) indices (1-based, and including *last*) of the subplot, e.g., ``fig.add_subplot(3, 1, (1, 2))`` makes a subplot that spans the upper 2/3 of the figure. - A 3-digit integer. The digits are interpreted as if given separately as three single-digit integers, i.e. ``fig.add_subplot(235)`` is the same as ``fig.add_subplot(2, 3, 5)``. Note that this can only be used if there are no more than 9 subplots. - A `.SubplotSpec`. projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional The projection type of the subplot (`~.axes.Axes`). *str* is the name of a custom projection, see `~matplotlib.projections`. The default None results in a 'rectilinear' projection. polar : bool, default: False If True, equivalent to projection='polar'. sharex, sharey : `~.axes.Axes`, optional Share the x or y `~matplotlib.axis` with sharex and/or sharey. The axis will have the same limits, ticks, and scale as the axis of the shared axes. label : str A label for the returned axes. Returns ------- `.axes.SubplotBase`, or another subclass of `~.axes.Axes` The axes of the subplot. The returned axes base class depends on the projection used. It is `~.axes.Axes` if rectilinear projection is used and `.projections.polar.PolarAxes` if polar projection is used. The returned axes is then a subplot subclass of the base class. Other Parameters ---------------- **kwargs This method also takes the keyword arguments for the returned axes base class; except for the *figure* argument. The keyword arguments for the rectilinear base class `~.axes.Axes` can be found in the following table but there might also be other keyword arguments if another projection is used. %(Axes:kwdoc)s Notes ----- Creating a new Axes will delete any preexisting Axes that overlaps with it beyond sharing a boundary:: import matplotlib.pyplot as plt # plot a line, implicitly creating a subplot(111) plt.plot([1, 2, 3]) # now create a subplot which represents the top plot of a grid # with 2 rows and 1 column. Since this subplot will overlap the # first, the plot (and its axes) previously created, will be removed plt.subplot(211) If you do not want this behavior, use the `.Figure.add_subplot` method or the `.pyplot.axes` function instead. If no *kwargs* are passed and there exists an Axes in the location specified by *args* then that Axes will be returned rather than a new Axes being created. If *kwargs* are passed and there exists an Axes in the location specified by *args*, the projection type is the same, and the *kwargs* match with the existing Axes, then the existing Axes is returned. Otherwise a new Axes is created with the specified parameters. We save a reference to the *kwargs* which we use for this comparison. If any of the values in *kwargs* are mutable we will not detect the case where they are mutated. In these cases we suggest using `.Figure.add_subplot` and the explicit Axes API rather than the implicit pyplot API. See Also -------- .Figure.add_subplot .pyplot.subplots .pyplot.axes .Figure.subplots Examples -------- :: plt.subplot(221) # equivalent but more general ax1 = plt.subplot(2, 2, 1) # add a subplot with no frame ax2 = plt.subplot(222, frameon=False) # add a polar subplot plt.subplot(223, projection='polar') # add a red subplot that shares the x-axis with ax1 plt.subplot(224, sharex=ax1, facecolor='red') # delete ax2 from the figure plt.delaxes(ax2) # add ax2 to the figure again plt.subplot(ax2) # make the first axes "current" again plt.subplot(221) projectionpolarzpolar=z, yet projection=z1. Only one of these arguments should be supplied.r)r.r.r.rrzbThe subplot index argument to subplot() appears to be a boolean. Did you intend to use subplots()?nrowsncolszhsubplot() got an unexpected keyword argument 'ncols' and/or 'nrows'. Did you intend to call subplots()?get_subplotspeccs&g|]}|krj|jr|qSrQbboxfully_overlapsrotherrrQrRrszsubplot..rsAuto-removal of overlapping axes is deprecated since %(since)s and will be removed %(removal)s; explicitly call ax.remove() as needed.message)objectrKrrrrboolrrr rnrZ_from_subplot_argsrrur&Z_projection_initZ _process_projection_requirementsrr rwr) rkrlunsetr"r#rraxes_to_delete ax_to_delrQrrRsubplot9sL           r4)sharexshareysqueeze width_ratios height_ratios subplot_kw gridspec_kwc Ks2tfi| } | j|||||||||d } | | fS)a Create a figure and a set of subplots. This utility wrapper makes it convenient to create common layouts of subplots, including the enclosing figure object, in a single call. Parameters ---------- nrows, ncols : int, default: 1 Number of rows/columns of the subplot grid. sharex, sharey : bool or {'none', 'all', 'row', 'col'}, default: False Controls sharing of properties among x (*sharex*) or y (*sharey*) axes: - True or 'all': x- or y-axis will be shared among all subplots. - False or 'none': each subplot x- or y-axis will be independent. - 'row': each subplot row will share an x- or y-axis. - 'col': each subplot column will share an x- or y-axis. When subplots have a shared x-axis along a column, only the x tick labels of the bottom subplot are created. Similarly, when subplots have a shared y-axis along a row, only the y tick labels of the first column subplot are created. To later turn other subplots' ticklabels on, use `~matplotlib.axes.Axes.tick_params`. When subplots have a shared axis that has units, calling `~matplotlib.axis.Axis.set_units` will update each axis with the new units. squeeze : bool, default: True - If True, extra dimensions are squeezed out from the returned array of `~matplotlib.axes.Axes`: - if only one subplot is constructed (nrows=ncols=1), the resulting single Axes object is returned as a scalar. - for Nx1 or 1xM subplots, the returned object is a 1D numpy object array of Axes objects. - for NxM, subplots with N>1 and M>1 are returned as a 2D array. - If False, no squeezing at all is done: the returned Axes object is always a 2D array containing Axes instances, even if it ends up being 1x1. width_ratios : array-like of length *ncols*, optional Defines the relative widths of the columns. Each column gets a relative width of ``width_ratios[i] / sum(width_ratios)``. If not given, all columns will have the same width. Equivalent to ``gridspec_kw={'width_ratios': [...]}``. height_ratios : array-like of length *nrows*, optional Defines the relative heights of the rows. Each row gets a relative height of ``height_ratios[i] / sum(height_ratios)``. If not given, all rows will have the same height. Convenience for ``gridspec_kw={'height_ratios': [...]}``. subplot_kw : dict, optional Dict with keywords passed to the `~matplotlib.figure.Figure.add_subplot` call used to create each subplot. gridspec_kw : dict, optional Dict with keywords passed to the `~matplotlib.gridspec.GridSpec` constructor used to create the grid the subplots are placed on. **fig_kw All additional keyword arguments are passed to the `.pyplot.figure` call. Returns ------- fig : `.Figure` ax : `~.axes.Axes` or array of Axes *ax* can be either a single `~.axes.Axes` object, or an array of Axes objects if more than one subplot was created. The dimensions of the resulting array can be controlled with the squeeze keyword, see above. Typical idioms for handling the return value are:: # using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplots(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2) The names ``ax`` and pluralized ``axs`` are preferred over ``axes`` because for the latter it's not clear if it refers to a single `~.axes.Axes` instance or a collection of these. See Also -------- .pyplot.figure .pyplot.subplot .pyplot.axes .Figure.subplots .Figure.add_subplot Examples -------- :: # First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar")) axs[0, 0].plot(x, y) axs[1, 1].scatter(x, y) # Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') # Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') # Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') # Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True) ) r$r%r5r6r7r:r;r9r8)rsubplots) r$r%r5r6r7r8r9r:r;fig_kwraxsrQrQrRr<s r<.)r5r6r8r9empty_sentinelr:r;c Ks0tfi|} | j||||||||d} | | fS)a Build a layout of Axes based on ASCII art or nested lists. This is a helper function to build complex GridSpec layouts visually. .. note:: This API is provisional and may be revised in the future based on early user feedback. See :doc:`/tutorials/provisional/mosaic` for an example and full API documentation Parameters ---------- mosaic : list of list of {hashable or nested} or str A visual layout of how you want your Axes to be arranged labeled as strings. For example :: x = [['A panel', 'A panel', 'edge'], ['C panel', '.', 'edge']] produces 4 axes: - 'A panel' which is 1 row high and spans the first two columns - 'edge' which is 2 rows high and is on the right edge - 'C panel' which in 1 row and 1 column wide in the bottom left - a blank space 1 row and 1 column wide in the bottom center Any of the entries in the layout can be a list of lists of the same form to create nested layouts. If input is a str, then it must be of the form :: ''' AAE C.E ''' where each character is a column and each line is a row. This only allows only single character Axes labels and does not allow nesting but is very terse. sharex, sharey : bool, default: False If True, the x-axis (*sharex*) or y-axis (*sharey*) will be shared among all subplots. In that case, tick label visibility and axis units behave as for `subplots`. If False, each subplot's x- or y-axis will be independent. width_ratios : array-like of length *ncols*, optional Defines the relative widths of the columns. Each column gets a relative width of ``width_ratios[i] / sum(width_ratios)``. If not given, all columns will have the same width. Convenience for ``gridspec_kw={'width_ratios': [...]}``. height_ratios : array-like of length *nrows*, optional Defines the relative heights of the rows. Each row gets a relative height of ``height_ratios[i] / sum(height_ratios)``. If not given, all rows will have the same height. Convenience for ``gridspec_kw={'height_ratios': [...]}``. empty_sentinel : object, optional Entry in the layout to mean "leave this space empty". Defaults to ``'.'``. Note, if *layout* is a string, it is processed via `inspect.cleandoc` to remove leading white space, which may interfere with using white-space as the empty sentinel. subplot_kw : dict, optional Dictionary with keywords passed to the `.Figure.add_subplot` call used to create each subplot. gridspec_kw : dict, optional Dictionary with keywords passed to the `.GridSpec` constructor used to create the grid the subplots are placed on. **fig_kw All additional keyword arguments are passed to the `.pyplot.figure` call. Returns ------- fig : `.Figure` The new figure dict[label, Axes] A dictionary mapping the labels to the Axes objects. The order of the axes is left-to-right and top-to-bottom of their position in the total layout. )r5r6r9r8r:r;r@)rsubplot_mosaic) Zmosaicr5r6r8r9r@r:r;r=rZax_dictrQrQrRrAs^rAc  s|durt}|\}}t|||}|j|||d} |j| fi|fdd|jD} | rltjddd| D] } t| qpS)a1 Create a subplot at a specific location inside a regular grid. Parameters ---------- shape : (int, int) Number of rows and of columns of the grid in which to place axis. loc : (int, int) Row number and column number of the axis location within the grid. rowspan : int, default: 1 Number of rows for the axis to span downwards. colspan : int, default: 1 Number of columns for the axis to span to the right. fig : `.Figure`, optional Figure to place the subplot in. Defaults to the current figure. **kwargs Additional keyword arguments are handed to `~.Figure.add_subplot`. Returns ------- `.axes.SubplotBase`, or another subclass of `~.axes.Axes` The axes of the subplot. The returned axes base class depends on the projection used. It is `~.axes.Axes` if rectilinear projection is used and `.projections.polar.PolarAxes` if polar projection is used. The returned axes is then a subplot subclass of the base class. Notes ----- The following call :: ax = subplot2grid((nrows, ncols), (row, col), rowspan, colspan) is identical to :: fig = gcf() gs = fig.add_gridspec(nrows, ncols) ax = fig.add_subplot(gs[row:row+rowspan, col:col+colspan]) N)rowspancolspancs&g|]}|krj|jr|qSrQr'r*rrQrRr8sz subplot2grid..rsr,r-) rnrZ_check_gridspec_existsZnew_subplotspecrrrrwr) shapelocrBrCrrlrowscolsgsZ subplotspecr2r3rQrrR subplot2grids) rIcCs|durt}|}|S)a  Make and return a second axes that shares the *x*-axis. The new axes will overlay *ax* (or the current axes if *ax* is *None*), and its ticks will be on the right. Examples -------- :doc:`/gallery/subplots_axes_and_figures/two_scales` N)rtwinxrax1rQrQrRrJEs rJcCs|durt}|}|S)a Make and return a second axes that shares the *y*-axis. The new axes will overlay *ax* (or the current axes if *ax* is *None*), and its ticks will be on the top. Examples -------- :doc:`/gallery/subplots_axes_and_figures/two_scales` N)rtwinyrKrQrQrRrMUs rMcCsJ|durt}|jjj}t|dr*|St|dr>|dStddS)zr Launch a subplot tool window for a figure. Returns ------- `matplotlib.widgets.SubplotTool` Nconfigure_subplots trigger_toolr<zHsubplot_tool can only be launched for figures with an associated toolbar)rnrrtoolbarrurNrOr)Z targetfigtbrQrQrR subplot_tooles    rRcCs&t}|dur| }||dS)a@ Turn the axes box on or off on the current axes. Parameters ---------- on : bool or None The new `~matplotlib.axes.Axes` box state. If ``None``, toggle the state. See Also -------- :meth:`matplotlib.axes.Axes.set_frame_on` :meth:`matplotlib.axes.Axes.get_frame_on` N)rZ get_frame_onZ set_frame_on)onrrQrQrRboxys rTcOs*t}|s|s|S|j|i|}|S)a Get or set the x limits of the current axes. Call signatures:: left, right = xlim() # return the current xlim xlim((left, right)) # set the xlim to left, right xlim(left, right) # set the xlim to left, right If you do not specify args, you can pass *left* or *right* as kwargs, i.e.:: xlim(right=3) # adjust the right leaving left unchanged xlim(left=1) # adjust the left leaving right unchanged Setting limits turns autoscaling off for the x-axis. Returns ------- left, right A tuple of the new x-axis limits. Notes ----- Calling this function with no arguments (e.g. ``xlim()``) is the pyplot equivalent of calling `~.Axes.get_xlim` on the current axes. Calling this function with arguments is the pyplot equivalent of calling `~.Axes.set_xlim` on the current axes. All arguments are passed though. )rZget_xlimset_xlimrkrlrretrQrQrRxlims rXcOs*t}|s|s|S|j|i|}|S)a Get or set the y-limits of the current axes. Call signatures:: bottom, top = ylim() # return the current ylim ylim((bottom, top)) # set the ylim to bottom, top ylim(bottom, top) # set the ylim to bottom, top If you do not specify args, you can alternatively pass *bottom* or *top* as kwargs, i.e.:: ylim(top=3) # adjust the top leaving bottom unchanged ylim(bottom=1) # adjust the bottom leaving top unchanged Setting limits turns autoscaling off for the y-axis. Returns ------- bottom, top A tuple of the new y-axis limits. Notes ----- Calling this function with no arguments (e.g. ``ylim()``) is the pyplot equivalent of calling `~.Axes.get_ylim` on the current axes. Calling this function with arguments is the pyplot equivalent of calling `~.Axes.set_ylim` on the current axes. All arguments are passed though. )rget_ylimset_ylimrVrQrQrRylims r[minorcKst}|dur,|j|d}|dur:tdn|j||d}|durd|j|d}|D]}||qRn|j|fd|i|}||fS)a Get or set the current tick locations and labels of the x-axis. Pass no arguments to return the current values without modifying them. Parameters ---------- ticks : array-like, optional The list of xtick locations. Passing an empty list removes all xticks. labels : array-like, optional The labels to place at the given *ticks* locations. This argument can only be passed if *ticks* is passed as well. minor : bool, default: False If ``False``, get/set the major ticks/labels; if ``True``, the minor ticks/labels. **kwargs `.Text` properties can be used to control the appearance of the labels. Returns ------- locs The list of xtick locations. labels The list of xlabel `.Text` objects. Notes ----- Calling this function with no arguments (e.g. ``xticks()``) is the pyplot equivalent of calling `~.Axes.get_xticks` and `~.Axes.get_xticklabels` on the current axes. Calling this function with arguments is the pyplot equivalent of calling `~.Axes.set_xticks` and `~.Axes.set_xticklabels` on the current axes. Examples -------- >>> locs, labels = xticks() # Get the current locations and labels. >>> xticks(np.arange(0, 1, step=0.2)) # Set label locations. >>> xticks(np.arange(3), ['Tom', 'Dick', 'Sue']) # Set text labels. >>> xticks([0, 1, 2], ['January', 'February', 'March'], ... rotation=20) # Set text labels and properties. >>> xticks([]) # Disable xticks. Nr\zAxticks(): Parameter 'labels' can't be set without setting 'ticks'r])rZ get_xticksr Z set_xticksZget_xticklabels_internal_updateZset_xticklabelstickslabelsr]rlrlocslrQrQrRxtickss+   rdcKst}|dur,|j|d}|dur:tdn|j||d}|durd|j|d}|D]}||qRn|j|fd|i|}||fS)a Get or set the current tick locations and labels of the y-axis. Pass no arguments to return the current values without modifying them. Parameters ---------- ticks : array-like, optional The list of ytick locations. Passing an empty list removes all yticks. labels : array-like, optional The labels to place at the given *ticks* locations. This argument can only be passed if *ticks* is passed as well. minor : bool, default: False If ``False``, get/set the major ticks/labels; if ``True``, the minor ticks/labels. **kwargs `.Text` properties can be used to control the appearance of the labels. Returns ------- locs The list of ytick locations. labels The list of ylabel `.Text` objects. Notes ----- Calling this function with no arguments (e.g. ``yticks()``) is the pyplot equivalent of calling `~.Axes.get_yticks` and `~.Axes.get_yticklabels` on the current axes. Calling this function with arguments is the pyplot equivalent of calling `~.Axes.set_yticks` and `~.Axes.set_yticklabels` on the current axes. Examples -------- >>> locs, labels = yticks() # Get the current locations and labels. >>> yticks(np.arange(0, 1, step=0.2)) # Set label locations. >>> yticks(np.arange(3), ['Tom', 'Dick', 'Sue']) # Set text labels. >>> yticks([0, 1, 2], ['January', 'February', 'March'], ... rotation=45) # Set text labels and properties. >>> yticks([]) # Disable yticks. Nr\zAyticks(): Parameter 'labels' can't be set without setting 'ticks'r])rZ get_yticksr Z set_yticksZget_yticklabelsr^Zset_yticklabelsr_rQrQrRytickss+   recKsrt}t|tstdtdd||||fDrL|sL|j}|j}n|j|f|||d|\}}||fS)a Get or set the radial gridlines on the current polar plot. Call signatures:: lines, labels = rgrids() lines, labels = rgrids(radii, labels=None, angle=22.5, fmt=None, **kwargs) When called with no arguments, `.rgrids` simply returns the tuple (*lines*, *labels*). When called with arguments, the labels will appear at the specified radial distances and angle. Parameters ---------- radii : tuple with floats The radii for the radial gridlines labels : tuple with strings or None The labels to use at each radial gridline. The `matplotlib.ticker.ScalarFormatter` will be used if None. angle : float The angular position of the radius labels in degrees. fmt : str or None Format string used in `matplotlib.ticker.FormatStrFormatter`. For example '%f'. Returns ------- lines : list of `.lines.Line2D` The radial gridlines. labels : list of `.text.Text` The tick labels. Other Parameters ---------------- **kwargs *kwargs* are optional `.Text` properties for the labels. See Also -------- .pyplot.thetagrids .projections.polar.PolarAxes.set_rgrids .Axis.get_gridlines .Axis.get_ticklabels Examples -------- :: # set the locations of the radial gridlines lines, labels = rgrids( (0.25, 0.5, 1.0) ) # set the locations and labels of the radial gridlines lines, labels = rgrids( (0.25, 0.5, 1.0), ('Tom', 'Dick', 'Harry' )) z"rgrids only defined for polar axescss|]}|duVqdSrWrQ)rprQrQrR rzrgrids..)raanglefmt) rrrrryaxisZ get_gridlinesget_ticklabelsZ set_rgrids)ZradiirarhrirlrlinesrQrQrRrgridsXs;    rmcKsnt}t|tstdtdd|||fDrJ|sJ|j}|j}n|j|f||d|\}}||fS)a Get or set the theta gridlines on the current polar plot. Call signatures:: lines, labels = thetagrids() lines, labels = thetagrids(angles, labels=None, fmt=None, **kwargs) When called with no arguments, `.thetagrids` simply returns the tuple (*lines*, *labels*). When called with arguments, the labels will appear at the specified angles. Parameters ---------- angles : tuple with floats, degrees The angles of the theta gridlines. labels : tuple with strings or None The labels to use at each radial gridline. The `.projections.polar.ThetaFormatter` will be used if None. fmt : str or None Format string used in `matplotlib.ticker.FormatStrFormatter`. For example '%f'. Note that the angle in radians will be used. Returns ------- lines : list of `.lines.Line2D` The theta gridlines. labels : list of `.text.Text` The tick labels. Other Parameters ---------------- **kwargs *kwargs* are optional `.Text` properties for the labels. See Also -------- .pyplot.rgrids .projections.polar.PolarAxes.set_thetagrids .Axis.get_gridlines .Axis.get_ticklabels Examples -------- :: # set the locations of the angular gridlines lines, labels = thetagrids(range(45, 360, 90)) # set the locations and labels of the angular gridlines lines, labels = thetagrids(range(45, 360, 90), ('NE', 'NW', 'SW', 'SE')) z&thetagrids only defined for polar axescss|]}|duVqdSrWrQ)rparamrQrQrRrgrzthetagrids..)rari) rrrrrxaxisZ get_ticklinesrkZset_thetagrids)anglesrarirlrrlrQrQrR thetagridss8    rq>rginputr waitforbuttonpressrrcs:dddhtttttfddtDS)z< Get a sorted list of all of the plotting commands. colormapscolorsget_plot_commandsc3s@|]8\}}|ds|vrt|rt|ur|VqdS)_N) startswithr isfunction getmodule)rrtrexcludeZ this_modulerQrRrgs  z$get_plot_commands..)_NON_PLOT_COMMANDSrtrrzrvrritemsrQrQr{rRrvs rvcKs<|durt}|durtdtj|f||d|}|S)NzNo mappable was found to use for colorbar creation. First define a mappable such as an image (with imshow) or a contour set (with contourf).)caxr)gcirrncolorbar)ZmappablerrrlrWrQrQrRrs rcCs&t}|durtd|||dS)a[ Set the color limits of the current image. If either *vmin* or *vmax* is None, the image min/max respectively will be used for color scaling. If you want to set the clim of multiple images, use `~.ScalarMappable.set_clim` on every image, for example:: for im in gca().get_images(): im.set_clim(0, 0.5) Nz1You must first define an image, e.g., with imshow)rrset_clim)vminvmaximrQrQrRclim srcCstj||dS)Nrtlut)r _get_cmaprrQrQrRget_cmap srcCs2t|}td|jdt}|dur.||dS)aD Set the default colormap, and applies it to the current image if any. Parameters ---------- cmap : `~matplotlib.colors.Colormap` or str A colormap instance or the name of a registered colormap. See Also -------- colormaps matplotlib.cm.register_cmap matplotlib.cm.get_cmap image)cmapN)rrrtrset_cmap)rrrQrQrRr%s rcCstj||SrW)rXrimread)rrrQrQrRr=srcKstjj||fi|SrW)rXrimsave)rarrrlrQrQrRrBsrcKsVt|}|dkrt}nt|t|d}|gd}|j|fi|}t||S)aa Display an array as a matrix in a new figure window. The origin is set at the upper left hand corner and rows (first dimension of the array) are displayed horizontally. The aspect ratio of the figure window is that of the array, unless this would make an excessively short or narrow figure. Tick labels for the xaxis are placed on top. Parameters ---------- A : 2D array-like The matrix to be displayed. fignum : None or int or False If *None*, create a new figure window with automatic numbering. If a nonzero integer, draw into the figure with the given number (create it if it does not exist). If 0, use the current axes (or create one if it does not exist). .. note:: Because of how `.Axes.matshow` tries to set the figure aspect ratio to be the one of the array, strange things may happen if you reuse an existing figure. Returns ------- `~matplotlib.image.AxesImage` Other Parameters ---------------- **kwargs : `~matplotlib.axes.Axes.imshow` arguments r)r)g333333?g ףp= ??r)np asanyarrayrrrrmatshowsci)AfignumrlrrrrQrQrRrGs' rcOs@tr&t}t|ts0tdn tdd}|j|i|S)z Make a polar plot. call signature:: polar(theta, r, **kwargs) Multiple *theta*, *r* arguments are supported, with format strings, as in `plot`. zMTrying to create polar plot on an Axes that does not have a polar projection.r#)r") rnZget_axesrrrrrrplot)rkrlrrQrQrRr#{s    r#backend_fallbackWebAggnbAggr{c Ks(tj|f||||||||| d | S)N) xoyoalphanormrrroriginresize)rnfigimage) XrrrrrrrrrrlrQrQrRrs rcKstj|||fd|i|SNfontdict)rntextxyrrrlrQrQrRfigtextsrcCs tSrW)rnrrQrQrQrRrsrcCs tSrW)rn_gcirQrQrQrRrsrcCstj||||||dS)NntimeoutZ show_clicksZ mouse_addZ mouse_popZ mouse_stop)rnrrrrQrQrRrrs rrcCstj||||||dS)NleftbottomrighttopZwspaceZhspace)rnsubplots_adjustrrQrQrRrs rcKstj|fi|SrW)rnsuptitle)trlrQrQrRrsrgHzG?padZh_padZw_padrectcCstj||||dS)Nr)rn tight_layoutrrQrQrRrsrrCcCstj|dS)Nr)rnrsrrQrQrRrssrs)datacKs(tj|fi|durd|ini|SNr)racorr)rrrlrQrQrRrsrcKs4tj|f|||||d|dur(d|ini|SN)FsFcwindowpad_tosidesr)rangle_spectrumrrrrrrrrlrQrQrRrs rrcKs"tj||f|||||d|S)N)xytextxycoords textcoords arrowpropsannotation_clip)rannotate)rxyrrrrrrlrQrQrRrsrcKstj||||fi|SrW)rarrow)rrdxdyrlrQrQrRrsrbothcCstj|||dS)Nenableaxistight)r autoscalerrQrQrRr srcKstjf|||d|S)N)rxminxmax)raxhline)rrrrlrQrQrRr srcKstj||f||d|S)N)rr)raxhspan)yminymaxrrrlrQrQrRr sr)emitcOstj|d|i|S)Nr)rr)rrkrlrQrQrRr sr)slopecKstj|f||d|S)N)xy2r)raxline)Zxy1rrrlrQrQrRr srcKstjf|||d|S)N)rrr)raxvline)rrrrlrQrQrRr# srcKstj||f||d|S)N)rr)raxvspan)rrrrrlrQrQrRr) sr皙?center)alignrcKs2tj||f|||d|dur&d|ini|S)N)widthrrr)rbar)rheightrrrrrlrQrQrRr/ srcOs&tj|i|durd|ini|Sr)rbarbsrrkrlrQrQrRr9 srcKs2tj||f|||d|dur&d|ini|S)N)rrrr)rbarh)rrrrrrrlrQrQrRrA srz%gedge)ri label_typepaddingcKstj|f||||d|S)N)rarirr)r bar_label) containerrarirrrlrQrQrRrK srcCsZtj|f||||||||| | | | | |||||||||||||d|durRd|iniS)N)notchsymvertwhis positionswidths patch_artist bootstrap usermediansconf_intervalsmeanline showmeansshowcapsshowbox showfliersboxpropsra flierprops medianprops meanpropscapprops whiskerprops manage_ticks autorangezorder capwidthsr)rboxplot)rrrrrrrrrrrrrrrrrrarrrrrrrr r rrQrQrRr U s  r cKs*tj||fi|durd|ini|Sr)r broken_barh)ZxrangesZyrangerrlrQrQrRr n sr cKstj|fd|i|S)Nlevels)rclabel)CSr rlrQrQrRrv srdefaultc  Ks>tj||f|||||||| | d | dur2d| ini| S)N) NFFTrrdetrendrnoverlaprr scale_by_freqr)rcohere) rrrrrrrrrrrrrlrQrQrRr| s rcOs<tj|i|durd|ini|}|jdur8t||Sr)rcontour_Arrrkrl__retrQrQrRr srcOs<tj|i|durd|ini|}|jdur8t||Sr)rcontourfrrrrQrQrRr src  Ks@tj||f|||||||| | | d | dur4d| ini| SN) rrrrrrrrr return_liner)rcsd)rrrrrrrrrrrrrrlrQrQrRr s rrcKsFtj||f|||||||| | | | | |d |dur:d|ini|S)N) yerrxerrriecolor elinewidthcapsize barsabovelolimsuplimsxlolimsxuplims erroreverycapthickr)rerrorbar)rrrr rir!r"r#r$r%r&r'r(r)r*rrlrQrQrRr+ sr+ horizontalsolidc Ks6tj|f||||||d|dur*d|ini|S)N) orientation lineoffsets linelengths linewidthsru linestylesr)r eventplot) rr.r/r0r1rur2rrlrQrQrRr3 sr3cOs&tj|i|durd|ini|Sr)rfillrrQrQrRr4 sr4cKs4tj||f||||d|dur(d|ini|S)N)y2where interpolatestepr)r fill_between)ry1r5r6r7r8rrlrQrQrRr9 sr9cKs4tj||f||||d|dur(d|ini|S)N)x2r6r8r7r)r fill_betweenx)rx1r;r6r8r7rrlrQrQrRr< sr<majorcKstjf|||d|S)N)visiblewhichr)rgrid)r?r@rrlrQrQrRrA srAlinearZfacecKsXtj||f|||||||| | | | | ||||d|dur@d|ini|}t||S)N)Cgridsizebinsxscaleyscaleextentrrrrrr1 edgecolorsreduce_C_functionmincnt marginalsr)rhexbinr)rrrCrDrErFrGrHrrrrrr1rIrJrKrLrrlrrQrQrRrM s rMmidverticalcKsFtj|f||||||||| | | | | |d|dur:d|ini|S)N)rErangedensityweights cumulativerhisttyperr.rwidthlogcolorlabelstackedr)rhist)rrErPrQrRrSrrTrr.rUrVrWrXrYrrlrQrQrRrZ srZ)r.baseliner4rcKs2tj|f||||d|dur&d|ini|S)N)edgesr.r[r4r)rstairs)valuesr\r.r[r4rrlrQrQrRr] sr] c KsHtj||f||||||d|dur,d|ini| } t| d| S)N)rErPrQrRcmincmaxrrC)rhist2dr) rrrErPrQrRr`rarrlrrQrQrRrb s rbcKs4tj|||f|||d|dur(d|ini|SN)rur2rXr)rhlines)rrrrur2rXrrlrQrQrRrd" srd@)interpolation_stage filternorm filterradresampleurlrc KsRtj|f||||||||| | | | | |d|dur:d|ini|}t||S)N)rraspect interpolationrrrrrHrfrgrhrirjr)rimshowr)rrrrkrlrrrrrHrfrgrhrirjrrlrrQrQrRrm- s rmcOstj|i|SrW)rrrjrQrQrRr@ srcKstjf||d|S)N)rr)rlocator_params)rrrlrQrQrRrnF srncOstj|i|SrW)rloglogrjrQrQrRroL sroc Ks6tj|f||||||d|dur*d|ini|S)N)rrrrrrr)rmagnitude_spectrum) rrrrrrrrrlrQrQrRrpR s rprrrcGstj||||dS)Nrq)rmargins)rrrrrrQrQrRrr] srrcCs tSrW)rminorticks_offrQrQrQrRrsc srscCs tSrW)r minorticks_onrQrQrQrRrti srt)shadingrrrrrrc Os@tj|||||||d|dur(d|ini|} t| | S)N)rurrrrrr)rpcolorr) rurrrrrrrkrlrrQrQrRrvo s rv)rrrrrru antialiasedrc OsBtj||||||||d|dur*d|ini| } t| | S)N)rrrrrrurwr)r pcolormeshr) rrrrrrurwrrkrlrrQrQrRrx| s rxcKs4tj|f|||||d|dur(d|ini|Sr)rphase_spectrumrrQrQrRry s ry333333?皙?rr) normalizercCsFtj|f||||||||| | | | | |||d|dur>d|iniS)N)exploderaruautopct pctdistanceshadow labeldistance startangleradius counterclock wedgeprops textpropsrframe rotatelabelsr}r)rpie)rr~rarurrrrrrrrrrrrr}rrQrQrRr sr)scalexscaleyrcOs,tj|||d|dur d|ini|S)N)rrr)rr)rrrrkrlrQrQrRr srrpcKs4tj||f||||d|dur(d|ini|S)N)ritzxdateydater)r plot_date)rrrirrrrrlrQrQrRr src  Ks>tj|f||||||||| | d | dur2d| ini| Sr)rpsd) rrrrrrrrrrrrrlrQrQrRr s rcOs2tj|i|durd|ini|}t||Sr)rquiverrrrQrQrRr srcKstj|||||fi|SrW)r quiverkey)QrYUrXrlrQrQrRr sr)rI plotnonfiniterc KsNtj||f|||||||| | | | d | dur6d| ini|}t||S)N) rcmarkerrrrrrr1rIrr)rscatterr)rrrrrrrrrrr1rIrrrlrrQrQrRr s rcOstj|i|SrW)rsemilogxrjrQrQrRr srcOstj|i|SrW)rsemilogyrjrQrQrRr srcKsXtj|f||||||||| | | | | ||d|dur皙?cCsVtj||||f|||||| | | | | ||||d|dur@d|ini}t|j|S)N)rQrrWrr arrowsize arrowstyle minlength transformr  start_points maxlengthintegration_directionbroken_streamlinesr)r streamplotrrl)rruvrQrrWrrrrrrr rrrrrrrQrQrRr. s rrrrclosedc Ks.tjf|||||||||| | | | d | S)N) cellText cellColourscellLoc colWidths rowLabels rowColoursrowLoc colLabels colColourscolLocrEr(r\)rtable)rrrrrrrrrrrEr(r\rlrQrQrRrC srcKstj|||fd|i|Sr)rrrrQrQrRrS srcKstjfd|i|S)Nr)r tick_params)rrlrQrQrRrY srrr scilimits useOffset useLocale useMathTextcCstj||||||dS)Nr)rticklabel_formatrrQrQrRr_ s rcOs(tj|i|}|jdur$t||SrW)r tricontourrrrkrlrrQrQrRrj srcOs(tj|i|}|jdur$t||SrW)r tricontourfrrrrQrQrRrr srg?flatrrrrrru facecolorsc Os.tj||||||||d|} t| | S)Nr)r tripcolorr) rrrrrrurrkrlrrQrQrRrz s rcOstj|i|SrW)rtriplotrjrQrQrRr sr?c  Cs8tj|f||||||||| d | dur0d| iniS)N) rrrr showextrema showmedians quantilespoints bw_methodr)r violinplot) datasetrrrrrrrrrrrQrQrRr srcKs4tj|||f|||d|dur(d|ini|Src)rvlines)rrrrur2rXrrlrQrQrRr srcKs4tj||f||||d|dur(d|ini|S)N)normedr usevlinesmaxlagsr)rxcorr)rrrrrrrrlrQrQrRr srcCs t|SrW)r_sci)rrQrQrRr sr)rcKstj|f||||d|S)N)rrErr)r set_title)rXrrErrrlrQrQrRtitle sr)rEcKstj|f|||d|SN)rlabelpadrE)r set_xlabel)xlabelrrrErlrQrQrRr srcKstj|f|||d|Sr)r set_ylabel)ylabelrrrErlrQrQrRr srcKstj|fi|SrW)r set_xscalevaluerlrQrQrRrF srFcKstj|fi|SrW)r set_yscalerrQrQrRrG srGcCs tddS)z Set the colormap to 'autumn'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. autumnNrrQrQrQrRr srcCs tddS)z Set the colormap to 'bone'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. boneNrrQrQrQrRr srcCs tddS)z Set the colormap to 'cool'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. coolNrrQrQrQrRr srcCs tddS)z Set the colormap to 'copper'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. copperNrrQrQrQrRr srcCs tddS)z Set the colormap to 'flag'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. flagNrrQrQrQrRr srcCs tddS)z Set the colormap to 'gray'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. grayNrrQrQrQrRr srcCs tddS)z Set the colormap to 'hot'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. hotNrrQrQrQrRr srcCs tddS)z Set the colormap to 'hsv'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. hsvNrrQrQrQrRr& srcCs tddS)z Set the colormap to 'jet'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. jetNrrQrQrQrRr1 srcCs tddS)z Set the colormap to 'pink'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. pinkNrrQrQrQrRr< srcCs tddS)z Set the colormap to 'prism'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. prismNrrQrQrQrRrG srcCs tddS)z Set the colormap to 'spring'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. springNrrQrQrQrRrR srcCs tddS)z Set the colormap to 'summer'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. summerNrrQrQrQrRr] srcCs tddS)z Set the colormap to 'winter'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. winterNrrQrQrQrRrh srcCs tddS)z Set the colormap to 'magma'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. magmaNrrQrQrQrRrs srcCs tddS)z Set the colormap to 'inferno'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. infernoNrrQrQrQrRr~ srcCs tddS)z Set the colormap to 'plasma'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. plasmaNrrQrQrQrRr srcCs tddS)z Set the colormap to 'viridis'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. viridisNrrQrQrQrRr srcCs tddS)z Set the colormap to 'nipy_spectral'. This changes the default colormap as well as the colormap of the current image if there is one. See ``help(colormaps)`` for more information. nipy_spectralNrrQrQrQrRr sr)N)NNT)NN)r.rr)N)N)N)r.r.)r.r.N)N)N)N)N)NN)NN)NNNN)NNN)NNN)NN)NN)N)N) rrNNNNNNF)N)NNNNNN)rC)NNNNN)NrNNN)TrN)rrr.)rr.)N)rrr.)rr.)rN)rN)N)NNNNNNNNNNNNNNNNNNNNNNTFNN)N) NNNNNNNNNN) NNrNNNFFFFFr.N)r,r.r.NNr-)rNFN)rNNF)Nr>r)NNFNFNrrNrONFNNF)N)r_NFNNN)Nr-r) NNNNNNNNN)rN)NNNNNN)NNNNN)NNNNrzFr{rr.TNNr|FF)rpNTF) NNNNNNNNNN) NNNNNNNNN)NNNNNNNNNNNNNNN)rNNrr)r.NNNNr.rrNNNrerT) NNrNNNrNNrrNr)N)r) NTrFTFNrN)Nr-r)NNN)NN)NN(2__doc__ contextlibrenumrrDrrloggingnumbersrrer`rrrrXZmatplotlib.colorbarZmatplotlib.imagerrrr r r r Zmatplotlib.backend_basesr rZmatplotlib.figurerrrZmatplotlib.gridspecrrrrrrZmatplotlib.rcsetuprZ_interactive_bkmatplotlib.artistrZmatplotlib.axesrrZmatplotlib.projectionsrrZmatplotlib.scalerr matplotlib.cmr rtr!matplotlib.colorsr"color_sequencesnumpyrr#Zmatplotlib.linesr$Zmatplotlib.textr%r&Zmatplotlib.patchesr'r(r)r*Zmatplotlib.widgetsr+r,r-tickerr/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rA getLoggerrrrFrSrTr_r[rfrhrrZrirorzr|rr}rrrrrrrrrrrrrrKrrmake_keyword_onlyrrrnrrrrrrrr rrrrrrreplacededent_interpdrrr r!r4r<rArIrJrMrRrTrXr[rdrermrqr}rvrrrrrrrrrr#_get_backend_or_nonesetrr~ __setitem__rrrrrrrrrLEFTRIGHTZMIDDLErrrrsrrrrrrrrrrrrrrrr r rrZ detrend_noneZwindow_hanningrrrr+r3r4r9r<rArMmeanrZr]rbrdrmrnrorprrrsrtrvrxryrrrrrrrrrrrrrrI_deprecated_parameterr8rrrrrrrrrrrrrrrrrrrrrFrrGrrrrrrrrrrrrrrrrrrrrQrQrQrRs"                T  %   z  0((        E     *  a  K   h ?    %%?? G D       4