
    h8F                   3   % S r SSKJr  SSKJrJr  SSKJr  SSKrSSK	r	SSK
r
SSKrSSKrSSKrSSKrSSKJrJrJr  SSKJr  SSKrSSKrSSKrSSKJr  SS	KJrJr  SS
KJr  SSKJr  SSKJr  SSKJr  SSKJr  SSKJr  SSK J!r!J"r"J#r#  SSK$J%r%J&r&J'r'  SSK(J)r)J*r*  SSKJ+r+J,r,J-r-  SSK.J/r/  SSK0J1r1  SSK0J2r2  SSK3J4r4J5r5  SSK6J7r7  SSK8J9r9J:r:J;r;  SSKJ<r<  SSK=J>r>  SSK?J@r@  SSKAJBrBJCrC  SSKDrE\(       a  SSKFJGrGJHrHJIrIJJrJ  SSKKrKSSKLrLSSKMrMSSKJNrNJOrOJPrPJQrQ  SS KRJSrS  SSKTrUSS!KVJWrW  SSK0rSSK.rSSK rSS"KXJYrY  SS#KZJ[r[  SS$K J\r\  SS%K?J]r]  SS&K^J_r_J`r`  SS'KaJbrbJcrcJdrdJereJfrfJgrgJhrh  SS(KJiri  SS)KjJkrkJlrlJmrm  SS*K$Jnrn  SS+KoJprp  SS,KqJrrr  SS-KJsrsJtrt  SS.KuJvrvJwrwJxrx  SS/KyJzrzJ{r{J|r|  SS0K=J}r}  SS1K~JrJrJrJrJr  SS2KJr  \S" S35      r\Q" S45      r\Q" S55      rSS6KAJr  SS7KJrJr  SS8KJrJr  SS9KuJrJrJr  SS:KuJr  SS;KJrJrJr  S<S=KJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJr  \GRV                  " \5      r\@r\Br\ GS6     GS7S> jj5       r\      GS8S? j5       r GS6     GS9S@ jjr/ SAQrSB r\" SC/ SDQ5      r\GRh                  qGS:SE jrGS:SF jrGS:SG jr\GRr                  GRt                  r\" \GRv                  5      GS:SH j5       r\" \/GRx                  5         GS;       GS<SJ jj5       rSqSK\SL'   GS=SM jrGS>SN jrGS:SO jrSP rSQ rGS:SR jrGS?SS jrGS@ST jrGS@SU jrGSASV jr\" \GR                  5      GSBSW j5       r\" \GR                  5        GSC     GSDSX jj5       r\" \GR                  5      GS:SY j5       r\" \GR                  GR                  5      SZ 5       r\" \GR                  GR                  5      S[ 5       r\" \GR                  GR                  5      S\ 5       r GSE       GSFS_ jjr   GSGSSSI\%S`Sa.                 GSHSb jjjrSc rGSISd jrGSJSe jrGSKSf jrGSLSg jrGSMSh jr\" \!GR                  5      GSNSi j5       r\" \!GR                  5      GSOSj j5       rGS6GSPSk jjrGS:Sl jrGS:Sm jr\" \%GR                  5      GS:Sn j5       rGSQSo jr\%GR                  R                   (       aO  \%GR                  R                   GR                  SpSq5      GR                  SrSs5      GR                  StSu5      \l         \GR                   GS6   GSRSv jj5       rGS6GSSSw jjrGSTSx jrGS:Sy jr\GR                  GSUSz j5       r\  GSVS{S{S{S{S{S{S{S|.                   GSWS} jjj5       r\  GSVS{S{S{S{S{S{S~.                   GSXS jjj5       r\  GSVS{S{S{S{S{S{S{S|.                   GSYS jjj5       r GSZS`S`SISSSSS|.                   GSYS jjjr\S{S{S{S{S{S{S{S{S.                     GS[S jj5       r\S{S{S{S{S{S{S{S{S.                     GS\S jj5       r\S{S{S{S{S{S{S{S{S.                     GS]S jj5       rS`S`SSSSSSS.                     GS^S jjr  GS_           GS`S jjrGS6GSaS jjrGS6GSaS jjrGS6GSbS jjrGS6GScS jjrGSdS jrGSdS jr  GSCS`S.       GSeS jjjr  GSCS`S.       GSeS jjjr    GSf         GSgS jjr   GSG       GShS jjr\GR                  " SSIS9GSiS j5       rGSiS jr\" \%GR                  5         GSG       GSjS jj5       rGSCGSkS jjrGSCGSlS jjrGSmS jr\" \GR                  GR                  5       GS6     GSnS jj5       r\" \GR                  GR                  5            GSoS j5       rGS6GSpS jjGr GSqS jGr\S   (       at  \GR                  " 5       G\" \5GR                  " \4GR
                  5      5      SS1-
  ;   a6  \GR                  " 5       (       a  \GR                  " S\+GR                  5        \" \%GR                  5               GSrSS.                       GSsS jjj5       Gr	\" \%GR                  5       GS6         GStS jj5       Gr\" \%GR                  5      GSUS j5       Gr\" \%GR                  5      GSuS j5       Gr\" \%GR                  5      S<SSI\#GR                   \#GR"                  \#GR$                  4             GSvS jj5       Gr\" \%GR&                  5            GSw             GSxS jj5       Gr\" \%GR(                  5      GSyS j5       Gr\" \%GR*                  5      SSSSS.         GSzS jj5       Gr\" \%GR,                  5      GS{GS|S jj5       Gr\" \1GR.                  5      SS.   GS}S jj5       Gr\" \1GR0                  5           GS~SS.             GSS jjj5       Gr\" \1GR2                  5           GS               GSS jj5       Gr\" \1GR4                  5      GSS j5       Gr\" \1GR6                  5         GS       GSS jj5       Gr\" \1GR8                  5      GSGSS jj5       Gr\" \1GR:                  5       GS         GSS jj5       Gr\" \1GR<                  5       GS6SIS.     GSS jjj5       Gr\" \1GR>                  5       GS6SS.       GSS jjj5       Gr\" \1GR@                  5      GSGSS jj5       Gr \" \1GRB                  5       GS         GSS jj5       Gr!\" \1GRD                  5        GSSSS.           GSS jjj5       Gr"\" \1GRF                  5      SS.GSS jj5       Gr#\" \1GRH                  5        GSSSS.           GSS jjj5       Gr$\" \1GRJ                  5       GS6SSSS.           GSS jjj5       Gr%\" \1GRL                  5                                  GSSS.                                                           GSS jjj5       Gr&\" \1GRN                  5      SS.     GSS jj5       Gr'\" \1GRP                  5      GS6GSS jj5       Gr(\" \1GRR                  5      SS^S\<GRT                  \<GRV                  SSSS4	SS.                       GSS jjj5       Gr)\" \1GRX                  5      SS.GSS jj5       Gr,\" \1GRZ                  5      SS.GSS jj5       Gr-\" \1GR\                  5                GSSS.                         GSS jjj5       Gr.\" \1GR^                  5       GS6S`SS`SS.           GSS jjj5       Gr/\" \1GR`                  5                   GSSS.                               GSS jjj5       Gr0\" \1GRb                  5             GSSS.                 GSS jjj5       Gr1\" \1GRd                  5      SS.GSS jj5       Gr2\" \1GRf                  5          GSSS.             GSS jjj5       Gr3\" \1GRh                  5          GSSS.             GSS jjj5       Gr4\" \1GRj                  5         GS       GSS jj5       Gr5\" \1GRl                  5      SS]SSSSSSSSSSS\EGRn                  SS`S4SS.                                       GSS jjj5       Gr6\" \1GRp                  5                    GSSS.                               GSS jjj5       Gr8\" \1GRr                  5       GS6SSS`SS.           GSS jjj5       Gr9\" \1GRt                  5            GSSS.                 GSS jjj5       Gr:\" \1GRv                  5         GSSS.             GSS jjj5       Gr;\" \1GRx                  5        GSCSSSSSSSSSSISSSSS.                                 GSS jjj5       Gr<\" \1GR                  5      GSQS j5       r\" \1GRz                  5       GS     GSS jj5       Gr=\" \1GR|                  5      GSqS j5       Gr>\" \1GR~                  5            GSwSS.               GSS jjj5       Gr?\" \1GR                  5      SSSIS.         GSS jj5       Gr@\" \1GR                  5      GS:S j5       GrA\" \1GR                  5      GS:S j5       GrB\" \1GR                  5      SSSSSSSSS.                 GSS jj5       GrC\" \1GR                  5      SSSSSSSS`SS.	                   GSS jj5       GrD\" \1GR                  5           GS~SS.             GSS jjj5       GrE\" \1GR                  5                     GSSISSS.                                     GSS jjj5       GrF\" \1GR                  5      SISISS.       GSS jj5       GrG\" \1GR                  5          GSSS.             GSS jjj5       GrH\" \1GR                  5                GSSS.                       GSS jjj5       GrI\" \1GR                  5      SS.GSS jj5       GrJ\" \1GR                  5                  GSS j5       GrK\" \1GR                  5               GSSSS`SS.                             GSS jjj5       GrL\" \1GR                  5      GSqS j5       GrM\" \1GR                  5      GSqS j5       GrN\" \1GR                  5                     GSSS.                                 GSGS  jjj5       GrO\" \1GR                  5           GS             GSGS jj5       GrP\" \1GR                  5      GSSSGSSGS.GS j5       GrQ\" \1GR                  5      SSSSSSSGS.               GSGS jj5       GrR\" \1GR                  5      GSSGS	.       GSGS
 jj5       GrS\" \1GR                  5                    GSSS.GS jj5       GrT\" \1GR                  5                   GSGS j5       GrU\" \1GR                  5       GS6         GStGS jj5       Gr
\" \1GR                  5      GSGSGS jj5       GrV\" \1GR                  5      SSSSSSGS.             GSGS jj5       GrW\" \1GR                  5      GS 5       GrX\" \1GR                  5      GS 5       GrY\" \1GR                  5      GSSSSSGSSGS.GS j5       GrZ\" \1GR                  5      GS 5       Gr[\" \1GR                  5                 GSSS.                         GSGS jjj5       Gr\\" \1GR                  5         GSSS.             GSGS jjj5       Gr]\" \1GR                  5      SI\<GRT                  SIS4SS.             GSGS jjj5       Gr^\" \1GR                  5      GSGS j5       Gr`\" \1GR                  5         GSGSGS.           GSGS jjj5       Grb\" \1GR                  5        GSCSGS.         GSGS jjj5       Grd\" \1GR                  5        GSCSGS.         GSGS  jjj5       Grf\" \1GR                  5      GSGS! j5       Grh\" \1GR                  5      GSGS" j5       GrjGS:GS# jGrkGS:GS$ jGrlGS:GS% jGrmGS:GS& jGrnGS:GS' jGroGS:GS( jGrpGS:GS) jGrqGS:GS* jGrrGS:GS+ jGrsGS:GS, jGrtGS:GS- jGruGS:GS. jGrvGS:GS/ jGrwGS:GS0 jGrxGS:GS1 jGryGS:GS2 jGrzGS:GS3 jGr{GS:GS4 jGr|GS:GS5 jGr}g(  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)
    plt.show()

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 </api/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)
    plt.show()


See :ref:`api_interfaces` for an explanation of the tradeoffs between the
implicit and explicit interfaces.
    )annotations)AbstractContextManager	ExitStack)EnumN)TYPE_CHECKINGcastoverload)cycler)_api)get_backendrcParams)cm)style)_pylab_helpers)interactive)cbook)
_docstring)FigureCanvasBaseFigureManagerBaseMouseButton)Figure
FigureBase	figaspect)GridSpecSubplotSpec)rcsetuprcParamsDefaultrcParamsOrig)Artist)Axes)Subplot)BackendFilterbackend_registry)	PolarAxes)_ColorizerInterfaceColorizingArtist	Colorizer)mlab)get_scale_names)
_colormaps)_color_sequencesColormap)CallableHashableIterableSequence)AnyBinaryIOLiteralTypeVar)	ParamSpec)	ArrayLike)Tick)	_AxesBase)Event)ScalarMappable)
ContourSetQuadContourSet)
CollectionFillBetweenPolyCollectionLineCollectionPolyCollectionPathCollectionEventCollectionQuadMesh)Colorbar)BarContainerErrorbarContainerStemContainer)	SubFigure)Legend)GaussianKDE)	AxesImageFigureImage)
FancyArrow	StepPatchWedge)BarbsQuiver	QuiverKey)	ScaleBase)	ColorType
CoordsTypeHashableListLineStyleType
MarkerType)SubplotTool_P_R_T)	Normalize)Line2DAxLine)Text
Annotation)ArrowCircle	Rectangle)Polygon)ButtonSliderWidget   )
TickHelper	FormatterFixedFormatterNullFormatterFuncFormatterFormatStrFormatterScalarFormatterLogFormatterLogFormatterExponentLogFormatterMathtextLocatorIndexLocatorFixedLocatorNullLocatorLinearLocator
LogLocatorAutoLocatorMultipleLocatorMaxNLocatorc                    g N methodfuncs     C/var/www/html/env/lib/python3.13/site-packages/matplotlib/pyplot.py_copy_docstring_and_deprecatorsr      s     69    c                    g r~   r   r   s     r   r   r      s    >Ar   c                   Uc%  [        S[        R                  " [        U 5      5      $ [        R
                  " U 5      /n[        U S5      (       a`  [        R                  R                  R                  U 5      nU(       a  UR                  U5        U R                  n [        U S5      (       a  M`  US S S2    H  nU" U5      nM     [        X5        U$ )N.Callable[[Callable[_P, _R]], Callable[_P, _R]]__wrapped__)r   	functoolspartialr   r   copyhasattrr   deprecation
DECORATORSgetappendr   _add_pyplot_note)r   r   
decoratorspotential_decorator	decorators        r   r   r      s     |D%%&EvNP 	P 	HJ &-
(
("..99==fE12##	 &-
(
(
  "%	 &T"Kr   )zFigureBase._gciz_AxesBase._scizArtist.findobjc                   U R                   (       d  gUR                  nU[        ;   a  gSnSU;  a  SnUR                   SU 3nOUR	                  S5      (       a  SU-   nOUR	                  S5      (       a	  SUS	S -   nOeUR	                  S
5      (       a  SU-   nOIUR	                  S5      (       a	  SUSS -   nO*UR	                  S5      (       a  SU-   nO[        SU 35      eU(       a  SU S3nOSU S3n[        R                  " U R                   5      nSU;   a  UR                  SS5      u  pxOGUR                  S5      =n	S:w  a	  USU	 XiS pO'UR                  S5      =n	S:w  a	  USU	 XiS pOUS-   nSnU SU SU 3U l         g)a5  
Add a note to the docstring of *func* that it is a pyplot wrapper.

The note is added to the "Notes" section of the docstring. If that does
not exist, a "Notes" section is created. In numpydoc, the "Notes"
section is the third last possible section, only potentially followed by
"References" and "Examples".
NT.FzAxes.z.axes.z
_AxesBase.z
.axes.Axes	   zFigure.zFigureBase.z.Figure
   zFigureCanvasBase.z&Wrapped method from unexpected class: z:This is the :ref:`pyplot wrapper <pyplot_interface>` for `z`.zThis is equivalent to `z
Notes
-----ri   z
References
----------r   z
Examples
--------
 z
Notes
-----

.. note::

    )
__doc____qualname___NO_PYPLOT_NOTE
__module__
startswithRuntimeErrorinspectcleandocsplitfind)
r   wrapped_funcqualnamewrapped_func_is_methodlinkmessagedocbeforeafterindexs
             r   r   r      s    <<((H?"!
(!&))*!H:6			W	%	%("			\	*	*hqrl*			Y	'	'X~			]	+	+8BC=(			0	1	1X~CH:NOONtfTVW+D64 

4<<
(C3		"2A68867
7%B	>FUS[8823
3%	:FUS[ tX@	E7SDLr   _ReplDisplayHook)NONEPLAINIPYTHONc                 N    [         R                  " 5       (       a  [        5         g g r~   )
matplotlibis_interactivedraw_allr   r   r   _draw_all_if_interactiver     s      ""
 #r   c                 *   [         [        R                  L a  g[        R                  R                  S5      n U (       d  [        R                  q gU R                  5       nU(       d  [        R                  q gUR                  R                  S[        5        [        R                  q U R                  SS S:  a   SSKJn  UR                  [        5       5      nO [        R                   " [        5       5      u  pCU(       a  UR#                  U5        gg)aD  
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.
NIPythonpost_execute   )      r   )backend2gui)_REPL_DISPLAYHOOKr   r   sysmodulesr   r   get_ipythoneventsregisterr   version_infoIPython.core.pylabtoolsr   r   r#   resolve_backend
enable_gui)mod_ipythonipr   ipython_gui_name_s        r   install_repl_displayhookr     s     ,444
 ++//),K,22		 	 	"B,22II~'?@(00#g-
 	8&??;=9.>>{}M
&' r   c                     [         [        R                  L a-  SSKJn   U " 5       nUR
                  R                  S[        5        [        R                  q g)z6Disconnect from the display hook of the current shell.r   )r   r   N)	r   r   r   r   r   r   
unregisterr   r   )r   r   s     r   uninstall_repl_displayhookr   F  s>     ,444']
		^-EF(--r   c                 .    [         R                  " U 0 UD6$ r~   )r   set_loglevelargskwargss     r   r   r   T  s    ""D3F33r   Tc                :    U c
  [        5       n U R                  XS9$ )N)include_self)gcffindobj)omatchr   s      r   r   r   Y  s!     	yE99U966r   z.type[matplotlib.backend_bases._Backend] | None_backend_modc                     [         c  [        [        R                  " S5      5        [	        [
        [        R                  R                     [         5      $ )zt
Ensure that a backend is selected and return it.

This is currently private, but may be made public in the future.
backend)	r   switch_backendr   _getr   typer   backend_bases_Backendr   r   r   _get_backend_modr   g  s;      	x}}Y/0Z--667FFr   c                  ^^^^ SSK mU [        R                  L ay  [        R                  " 5       nU(       a!  [
        R                  " U5      =n(       a  U/nO/ nU/ SQ-  nU H  n [        U5        U[        S'     g   [        S5        S[        S'   g[        R                  " S5      n[
        R                  " U 5      mTR                  mTR                  nUbC  [        R                  " 5       nU(       a'  U(       a   X:w  a  [        SR                  XU5      5      e[!        TSS5      n[!        TSS5      n " U4S	 jS
TR"                  R$                  5      n	Uc1  U4S jm[&        S.U4S jjnSU4S jjn
TU	l        UU	l        U
U	l        [!        TSS5      n[.        R0                  " USS5      n[.        R0                  " [2        SS5      nUb  Ub7  X:w  a2  U(       d  [5        SU  S35      e[7        SU5      R8                  nXl        [<        R?                  SX	R@                  5        U S;   a,  SSK!J"n  SSK#J$n   URK                  S5      nU" U5      S:  a  Sn U =[        S'   [N        S'   U	q(S H3  n[.        RR                  " [!        U	U5      5      [U        5       U   l+        M5     U TRX                  l-        []        5         g! [         a     GMr  f = f! URL                   a     Nf = f)a  
Set the pyplot backend.

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.

If the new backend is different than the current backend then all open
Figures will be closed via ``plt.close('all')``.

Parameters
----------
newbackend : str
    The case-insensitive name of the backend to use.

r   N)macosxqtagggtk4agggtk3aggtkaggwxaggr   aggzdCannot load backend {!r} which requires the {!r} interactive framework, as {!r} is currently runningnew_figure_managershowc                  P   > \ rS rSr\" 5       R                  \"  Y 5      5        Srg)#switch_backend.<locals>.backend_modi  r   N)__name__r   r   __firstlineno__localsupdatevars__static_attributes__)modules   r   backend_modr     s    V%r   r   c                &   > TR                  X5      $ r~   )new_manager)numfigurecanvas_classs     r   new_figure_manager_given_figure7switch_backend.<locals>.new_figure_manager_given_figure  s    ++F88r   )FigureClassc               $   > U" U0 UD6nT" X5      $ r~   r   )r   r  r   r   figr   s        r   r   *switch_backend.<locals>.new_figure_manager  s    t.v.C23<<r   c                    > TR                   " 5       (       aA  [        R                  R                  5       n U (       a  U R                  R                  5         g g g r~   )r   r   Gcf
get_activecanvas	draw_idle)managerr   s    r   draw_if_interactive+switch_backend.<locals>.draw_if_interactive  sC    ((**(,,779NN,,.  +r   manager_classpyplot_showzBackend zH defines neither FigureCanvas.manager_class nor a toplevel show functionr1   zLoaded backend %s version %s.)ipymplwidget)_parse_to_version_infor  )r   r      zmodule://ipympl.backend_nbagg)r   r  r   returnNone)/matplotlib.backendsr   _auto_backend_sentinelr   "_get_running_interactive_frameworkr#   backend_for_gui_frameworkr   r   ImportErrorr   r   load_backend_moduleFigureCanvasrequired_interactive_frameworkformatgetattrr   r   r   r   r   r  r   getattr_staticr   
ValueErrorr   r  r   _logdebugbackend_versionimportlib.metadatametadatar   r  versionPackageNotFoundErrorr   r   	signatureglobals__signature__backendsr   r   )
newbackendcurrent_frameworkr   
candidates	candidateold_backendrequired_frameworkr   r   r   r  r  manager_pyplot_showbase_pyplot_show_pyplot_showimr  module_version	func_namer   r   r   r   s                      @@@@r   r   r   u  s   & W333!DDF,FF%' ' '!JJ G 	G
 $Iy) +4Y' $ 5!&+L#--	*K11*=F&&L%DD%!DDF"4%;::@&4E;GH H !)=tD664(D&j..77 & !	9 8> 	= 	=	/ , 	3  	&   	'
 L/4@M
 "00tT--.?PTU#/';":, '+ ,- - E=1=='JJ.668 )) 	(5	ZZ1N%n5	A<
 8BAHY/)4LJ	-4->->K+.-	)* K #-J _  B && 		s$   (K K 
KKK-,K-c                    Sn [        [        [           [        5       R                  5      nUR
                  (       a{  [        [        S5      (       a9  [        R                  " 5       [        R                  " 5       R                  :w  a  Sn O-[        R                  " 5       [        R                  " 5       La  Sn U (       a  [        R                  " S5        g g )NFget_native_idTzFStarting a Matplotlib GUI outside of the main thread will likely fail.)r   r   r   r   r  r  r   	threadingr:  main_thread	native_idcurrent_threadr   warn_external)warnr   s     r   _warn_if_gui_out_of_main_threadrA    s    D-.0@0B0O0OPL229o..
 &&(I,A,A,C,M,MM '')1F1F1HH	 r   c                 J    [        5         [        5       R                  " U 0 UD6$ )z%Create a new figure manager instance.)rA  r   r   r   s     r   r   r   %  s!    #%00$A&AAr   c                 6    [        5       R                  " U 0 UD6$ )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.
)r   r  r   s     r   r  r  ,  s     114B6BBr   c                 J    [        5         [        5       R                  " U 0 UD6$ )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.
)rA  r   r   r   s     r   r   r   9  s$    X $%""D3F33r   c                 ,    [         R                  " 5       $ )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.
)r   r   r   r   r   isinteractiverF  i  s    6 $$&&r   c                     [        5       n U R                  [        5       (       a  [        O[        5        [
        R                  " S5        [        5         U $ )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
context manager object, which is not intended to be stored or
accessed by the user.
F)r   callbackrF  ionioffr   r   r   stacks    r   rJ  rJ    s9    B KE	NN-//3t45! Lr   c                     [        5       n U R                  [        5       (       a  [        O[        5        [
        R                  " S5        [        5         U $ )a2  
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
context manager object, which is not intended to be stored or
accessed by the user.
T)r   rH  rF  rI  rJ  r   r   r   rK  s    r   rI  rI    s9    B KE	NN-//3t44 Lr   c                   [         R                  R                  5       nUbR  UR                  nUR                  R
                  (       a  UR                  5         [        SS9  UR                  U 5        g[        R                  " U 5        g)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   r  r  r  r   staler	  r   start_event_looptimesleep)intervalr
  r  s      r   pauserU    sb    "   ++-G==5)

8r   c                2    [         R                  " U 40 UD6  g r~   )r   rc)groupr   s     r   rW  rW    s    MM%"6"r   c                .    [         R                  " X5      $ r~   )r   
rc_context)rW  fnames     r   rZ  rZ     s    
   ++r   c                 x    [         R                  " 5         [         R                  " 5       (       a  [        5         g g r~   )r   
rcdefaultsr   r   r   r   r   r]  r]    s'      ""
 #r   c                J    [         R                  R                  " U /UQ70 UD6$ r~   )r   artistgetpobjr   r   s      r   r`  r`    #    !!#7777r   c                J    [         R                  R                  " U /UQ70 UD6$ r~   )r   r_  r   ra  s      r   r   r     s#      6t6v66r   c                J    [         R                  R                  " U /UQ70 UD6$ r~   )r   r_  setpra  s      r   rf  rf    rc  r   d   r   c                0   [         S   (       a  [        S5      e[        5       nUR                  [         R                  [         R
                  " 5       5        SSKJn  [         R                  " / SQSXU4UR                  SSS	9/S
SSSSSSSSSSS.5        U$ )a  
Turn on `xkcd <https://xkcd.com/>`_ sketch-style drawing mode.

This will only have an effect on things drawn after this function is called.

For best results, install the `xkcd script <https://github.com/ipython/xkcd-font/>`_
font; xkcd fonts are not packaged 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
Comic NeuezComic Sans MSg      ,@r  w)	linewidth
foregroundg      ?g       @whiteg        Fblackr      )zfont.familyz	font.sizezpath.sketchzpath.effectszaxes.linewidthzlines.linewidthzfigure.facecolorzgrid.linewidthz	axes.gridzaxes.unicode_minuszaxes.edgecolorzxtick.major.sizezxtick.major.widthzytick.major.sizezytick.major.width)
r   r   r   rH  _update_rawr   r   ri  r   
withStroke)scalelength
randomnessrL  ri  s        r   rj  rj  !  s    N AC 	C KE	NN8''9&OOMz2""Q3"?A##!! & Lr   F)	facecolor	edgecolorframeonr  clearc          
        [        5       n	[        U [        5      (       a  U R                  SS9n
U
R                  R
                  c  [        S5      e[        S XX44 5       5      (       d  U(       a  U(       a\  U
R                  R
                  R                  U	;   a8  [        R                  " SU
R                  R
                  R                   S35        [        R                  R                  U
R                  R
                  5        U
$ U	(       a  [        U	5      S-   OSnSnU c  Un O[        S	 XX44 5       5      (       d  U(       a  U(       a  X	;   a  [        R                  " SU  S35        [        U [        5      (       aF  U n[!        5       nX;  a  US
:X  a  [        R                  " S5        Un O!UR#                  U5      nX   n O[%        U 5      n [        R                  R'                  U 5      nUGc1  [(        S   n[+        U	5      Us=:X  a  S:  a"  O  O[        R                  " SU S3[,        5        [/        U 4XX4UUS.UD6nUR                  R0                  nU(       a  UR3                  U5        [(        S    HY  nUR5                  S5      u  nn[6        R8                  " U5      nUR5                  S5       H  n[;        UU5      nM     U" U5        M[     [        R                  R=                  U5        [?        5         [@        [B        RD                  L a  [F        Ul$        U(       a$  UR                  R0                  RK                  5         UR                  R0                  $ )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 : :mpltype:`color`, default: :rc:`figure.facecolor`
    The background color.

edgecolor : :mpltype:`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', 'compressed', 'tight', 'none', `.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.

    - 'constrained': The constrained layout solver adjusts Axes sizes
      to avoid overlapping Axes decorations.  Can handle complex plot
      layouts and colorbars, and is thus recommended.

      See :ref:`constrainedlayout_guide`
      for examples.

    - 'compressed': uses the same algorithm as 'constrained', but
      removes extra space between fixed-aspect-ratio Axes.  Best for
      simple grids of Axes.

    - 'tight': Use the tight layout mechanism. This is a relatively
      simple algorithm that adjusts the subplot parameters so that
      decorations do not overlap. See `.Figure.set_tight_layout` for
      further details.

    - 'none': Do not use a layout engine.

    - A `.LayoutEngine` instance. Builtin layout classes are
      `.ConstrainedLayoutEngine` and `.TightLayoutEngine`, more easily
      accessible by 'constrained' and 'tight'.  Passing an instance
      allows third parties to provide their own layout engine.

    If not given, fall back to using the parameters *tight_layout* and
    *constrained_layout*, including their config defaults
    :rc:`figure.autolayout` and :rc:`figure.constrained_layout.use`.

**kwargs
    Additional keyword arguments are passed to the `.Figure` constructor.

Returns
-------
`~matplotlib.figure.Figure`

Notes
-----
A newly created figure is 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.

Once this is done, :rc:`figure.hooks` are called, one at a time, on the
figure; these hooks allow arbitrary customization of the figure (e.g.,
attaching callbacks) or of associated elements (e.g., modifying the
toolbar).  See :doc:`/gallery/user_interfaces/mplcvd` for an example of
toolbar customization.

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.
Trootz*The passed figure is not managed by pyplotc              3  (   #    U  H  oS Lv   M
     g 7fr~   r   .0params     r   	<genexpr>figure.<locals>.<genexpr>  s     V1Ut#1U   zCIgnoring specified arguments in this call because figure with num: z already existsri   r   c              3  (   #    U  H  oS Lv   M
     g 7fr~   r   r~  s     r   r  r    s     T/SeT!/Sr  allz)close('all') closes all existing figures.zfigure.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()`.)figsizedpirv  rw  rx  r  zfigure.hooks:r   )&get_fignums
isinstancer   
get_figurer  r
  r!  anyr   r   r?  r   r  
set_activemaxstrget_figlabelsr   intget_fig_managerr   lenRuntimeWarningr   r   	set_labelr   	importlibimport_moduler  _set_new_active_managerr  r   r   r   _auto_draw_if_interactivestale_callbackry  )r   r  r  rv  rw  rx  r  ry  r   allnumsroot_fignext_num	fig_label
all_labelsinumr
  max_open_warningr  	hookspecsmodule_namedotted_namerb  parts                          r   r   r   h  s   l mG#z"">>t>,??""*IJJV'	1UVVVHOO,C,C,G,G7,R%__44889JK 	%%hoo&=&=>#*s7|aHI
{Ti/STTTCN,,/5AB c3I&J*%&&'RS!''	2mc(C   005G#$=>w<+0q0-. /> ?   %/ g#/ (./ nn##MM)$!.1I'0s';$K ..{;C#))#.c4( /H 2 	227; 	 0 6 66!:C##%>>   r   c                ^   U(       a  [         R                  " 5       (       az  U R                  R                  5       (       dZ  U R                  R                  (       d>  U R                  R                  5          U R                  R                  5         SSS5        ggggg! , (       d  f       g= f)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)r   r   r  	is_saving_is_idle_drawing_idle_draw_cntxr	  )r  vals     r   r  r  2  sy     	
))++JJ((**JJ//
 ZZ'')JJ  " *) 0 + , *)s   6B
B,c                     [         R                  R                  5       n U b  U R                  R                  $ [	        5       $ )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.)
)r   r  r  r  r   )r
  s    r   r   r   G  s5       ++-G~~$$$xr   c                    [        U [        5      (       a  [        R                  R	                  U 5      $ U [        5       ;   $ )z
Return whether the figure with the given id exists.

Parameters
----------
num : int or str
    A figure identifier.

Returns
-------
bool
    Whether or not a figure with id *num* exists.
)r  r  r   r  
has_fignumr  r   s    r   fignum_existsr  W  s=      c3 	%%c* MO#r   c                 H    [        [        R                  R                  5      $ )z)Return a list of existing figure numbers.)sortedr   r  figsr   r   r   r  r  l  s    .$$))**r   c                     [         R                  R                  5       n U R                  S S9  U  Vs/ s H&  oR                  R
                  R                  5       PM(     sn$ s  snf )z(Return a list of existing figure labels.c                    U R                   $ r~   r  )ms    r   <lambda>get_figlabels.<locals>.<lambda>t  s    r   )key)r   r  get_all_fig_managerssortr  r   	get_label)managersr  s     r   r  r  q  sK    !!668HMMoM&19:AHHOO%%':::s   -A#c                 >    [        5       R                  R                  $ )aD  
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
)r   r  r
  r   r   r   get_current_fig_managerr  x  s     5<<r   c                H    [        5       R                  R                  X5      $ r~   )r   r  mpl_connect)sr   s     r   connectr    s    5<<##A,,r   c                J    [        5       R                  R                  U 5        g r~   )r   r  mpl_disconnect)cids    r   
disconnectr    s    ELL$r   c                   U cB  [         R                  R                  5       nUc  g[         R                  R                  U5        gU S:X  a  [         R                  R	                  5         g[        U [        5      (       a   [         R                  R                  U 5        g[        U S5      (       a*  [         R                  R                  U R                  5        g[        U [        5      (       aL  [        5       nX;   a<  [        5       UR                  U 5         n[         R                  R                  U5        gg[        U [        5      (       a   [         R                  R                  U 5        g[        S[        U 5      -  5      e)a@  
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

Nr  r  zDclose() argument must be a Figure, an int, a string, or None, not %s)r   r  r  destroydestroy_allr  r  r   r  r  r  r   r   destroy_fig	TypeErrorr   )r  r
  r  r   s       r   closer    s%     { $$//1?&&w/	&&(	C		""3'	e		 	""377+	C		"_
-
 0 0 56C&&s+  
C	 	 &&s+ *,0I6 7 	7r   c                 4    [        5       R                  5         g)zClear the current figure.N)r   ry  r   r   r   clfr    s    EKKMr   c                 H    [        5       R                  R                  5         g)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.

See Also
--------
.FigureCanvasBase.draw_idle
.FigureCanvasBase.draw
N)r   r  r	  r   r   r   drawr    s    " ELLr   c                 r    [        5       nUR                  " U 0 UD6nUR                  R                  5         U$ r~   )r   savefigr  r	  )r   r   r  ress       r   r  r    s3    
%C ++t
&v
&CJJJr   c                 6    [        5       R                  " U 0 UD6$ r~   )r   legendr   s     r   	figlegendr    s    5<<(((r   z legend(z figlegend(zfig.legend(zplt.figlegend(zax.plot(z	plt.plot(c                    [        5       nUR                  SS5      nU c(  Uc  UR                  " S0 UD6$ UR                  " U40 UD6$ UR                  " U 40 UD6$ )aN  
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 : `~matplotlib.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

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')
positionNr   )r   popadd_subplotadd_axes)argr   r  poss       r   axesr    s`    ^ %C
**Z
&C
{;??,V,,<<.v..||C*6**r   c                >    U c
  [        5       n U R                  5         g)zK
Remove an `~.axes.Axes` (defaulting to the current Axes) from its figure.
N)gcaremove)axs    r   delaxesr  H  s     
zUIIKr   c                Z    U R                  SS9n[        U5        UR                  U 5        g)zL
Set the current Axes to *ax* and the current Figure to the parent of *ax*.
Fr{  N)r  r   sca)r  r  s     r   r  r  Q  s&     --U-
#C
3KGGBKr   c                 2    [        5       R                  5       $ )zClear the current Axes.)r  clar   r   r   r  r  ]  s     599;r   c                    [        5       nUR                  SU5      nUR                  SU5      nXBLa+  U(       a$  X2La  US:w  a  [        SU SU< S35      eS=US'   n[	        U 5      S:X  a  Sn [	        U 5      S:  a.  [        U S	   [        5      (       a  [        R                  " S
5        SU;   d  SU;   a  [        S5      e[        5       n[        R                  " XP5      nUR                   HA  nUR                  5       U:X  d  M  U0 :X  d"  UR                  UR                   " S0 UD6:X  d  MA    O   UR"                  " U 0 UD6nUR%                  U5        U$ )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 : `~matplotlib.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`

    The Axes of the subplot. The returned Axes can actually be an instance
    of a subclass, such as `.projections.polar.PolarAxes` for polar
    projections.

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
-----
.. versionchanged:: 3.8
    In versions prior to 3.8, any preexisting Axes that overlap with the new Axes
    beyond sharing a boundary was deleted. Deletion does not happen in more
    recent versions anymore. Use `.Axes.remove` explicitly if needed.

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)


projectionpolarzpolar=z, yet projection=z1. Only one of these arguments should be supplied.r   )ri   ri   ri   rp  r   zbThe subplot index argument to subplot() appears to be a boolean. Did you intend to use subplots()?nrowsncolszhsubplot() got an unexpected keyword argument 'ncols' and/or 'nrows'.  Did you intend to call subplots()?r   )objectr   r  r!  r  r  boolr   r?  r  r   r   _from_subplot_argsr  get_subplotspec_projection_init _process_projection_requirementsr  r  )r   r   unsetr  r  r  r  r  s           r   subplotr  e  sl   D HEL%0JJJw&Ee"zW'<0 ?B B  -43|z 4yA~ 4yA~*T!Wd33 ) 	* &Gv- N O 	O %C 
(
(
3Chh  C'2((<<FvFG  __d-f-GGBKIr   .)sharexshareysqueezewidth_ratiosheight_ratios
subplot_kwgridspec_kwc                   g r~   r   
r  r  r  r  r  r  r  r  r  fig_kws
             r   subplotsr         r   )r  r  r  r  r  r  c                   g r~   r   r  s
             r   r  r  ,  r   r   c                   g r~   r   r  s
             r   r  r  =  r   r   c               D    [        S0 U	D6n
U
R                  XX#XGXUS9	nX4$ )aF  
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
    `.Axis.set_units` will update each axis with the new units.

    Note that it is not possible to unshare axes.

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 : `~matplotlib.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  r  r  r  r  r  r  r  r   )r   r  )r  r  r  r  r  r  r  r  r  r  r  axss               r   r  r  N  s;    v 
6
C
,,U&#.$0  2C 8Or   )r  r  r  r  empty_sentinelr  r  per_subplot_kwc                   g r~   r   
mosaicr  r  r  r  r  r  r  r  r  s
             r   subplot_mosaicr
    s     69r   c                   g r~   r   r  s
             r   r
  r
    s     58r   c                   g r~   r   r  s
             r   r
  r
    s     ;>r   r   c               F    [        S0 U	D6n
U
R                  U XXCXgUUS9	nX4$ )a  
Build a layout of Axes based on ASCII art or nested lists.

This is a helper function to build complex GridSpec layouts visually.

See :ref:`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.  These values may be overridden by
    values in *per_subplot_kw*.

per_subplot_kw : dict, optional
    A dictionary mapping the Axes identifiers or tuples of identifiers
    to a dictionary of keyword arguments to be passed to the
    `.Figure.add_subplot` call used to create each subplot.  The values
    in these dictionaries have precedence over the values in
    *subplot_kw*.

    If *mosaic* is a string, and thus all keys are single characters,
    it is possible to use a single string instead of a tuple as keys;
    i.e. ``"AB"`` is equivalent to ``("A", "B")``.

    .. versionadded:: 3.7

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.

)r  r  r  r  r  r  r  r  r   )r   r
  )r	  r  r  r  r  r  r  r  r  r  r  ax_dicts               r   r
  r
  !  sC    j 
6
C  #%% ! G <r   c                    Uc
  [        5       nU u  pg[        R                  " XFU5      nUR                  XUS9n	UR                  " U	40 UD6$ )a
  
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.Axes`

    The Axes of the subplot. The returned Axes can actually be an instance
    of a subclass, such as `.projections.polar.PolarAxes` for polar
    projections.

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])
)rowspancolspan)r   r   _check_gridspec_existsnew_subplotspecr  )
shapelocr  r  r  r   rowscolsgssubplotspecs
             r   subplot2gridr    sS    X {eJD		(	(D	9B$$S7$KK??;1&11r   c                @    U c
  [        5       n U R                  5       nU$ )z
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`
)r  twinxr  ax1s     r   r  r          
zU
((*CJr   c                @    U c
  [        5       n U R                  5       nU$ )z
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`
)r  twinyr  s     r   r!  r!    r  r   c                6   U c
  [        5       n U R                  R                  R                  n[	        US5      (       a  SSKJn  [        X!5      R                  5       $ [	        US5      (       a!  SSKJ	n  [        X15      R                  S5        g[        S5      e)	z^
Launch a subplot tool window for a figure.

Returns
-------
`matplotlib.widgets.SubplotTool`
Nconfigure_subplotsr   )NavigationToolbar2trigger_tool)ToolContainerBaser  zHsubplot_tool can only be launched for figures with an associated toolbar)r   r  r
  toolbarr   matplotlib.backend_basesr$  r   r#  r&  r%  r!  )	targetfigtbr$  r&  s       r   subplot_toolr+    s     E					!	!	)	)Br'((?&+>>@@	^	$	$>#00< 1 2 	2r   c                j    [        5       nU c  UR                  5       (       + n UR                  U 5        g)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)r  get_frame_onset_frame_on)onr  s     r   boxr0    s+     
B	z""OOBr   c                 z    [        5       nU (       d  U(       d  UR                  5       $ UR                  " U 0 UD6nU$ )aJ  
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.
)r  get_xlimset_xlimr   r   r  rets       r   xlimr6  $  4    < 
B{{}
++t
&v
&CJr   c                 z    [        5       nU (       d  U(       d  UR                  5       $ UR                  " U 0 UD6nU$ )aX  
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.
)r  get_ylimset_ylimr4  s       r   ylimr;  I  r7  r   minorc                  [        5       nU c  UR                  US9nUb  [        S5      eOUR                  XS9n/ nUc,  UR	                  US9nU H  nUR                  U5        M     XV4$ UR                  " U4SU0UD6nXV4$ )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.

    .. warning::

        This only sets the properties of the current ticks, which is
        only sufficient if you either pass *ticks*, resulting in a
        fixed list of ticks, or if the plot is static.

        Ticks are not guaranteed to be persistent. Various operations
        can create, delete and modify the Tick instances. There is an
        imminent risk that these settings can get lost if you work on
        the figure further (including also panning/zooming on a
        displayed figure).

        Use `~.pyplot.tick_params` instead if possible.


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.
r<  zAxticks(): Parameter 'labels' can't be set without setting 'ticks'r=  )r  
get_xticksr  
set_xticksget_xticklabels_internal_updateset_xticklabelstickslabelsr=  r   r  locs
labels_outls           r   xticksrJ  n  s    @ 
B }}}5}) 6 7 7  }}U}0J~''e'4
Av& 
  ''FeFvF
r   c                  [        5       nU c  UR                  US9nUb  [        S5      eOUR                  XS9n/ nUc,  UR	                  US9nU H  nUR                  U5        M     XV4$ UR                  " U4SU0UD6nXV4$ )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.

    .. warning::

        This only sets the properties of the current ticks, which is
        only sufficient if you either pass *ticks*, resulting in a
        fixed list of ticks, or if the plot is static.

        Ticks are not guaranteed to be persistent. Various operations
        can create, delete and modify the Tick instances. There is an
        imminent risk that these settings can get lost if you work on
        the figure further (including also panning/zooming on a
        displayed figure).

        Use `~.pyplot.tick_params` instead if possible.

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.
r<  zAyticks(): Parameter 'labels' can't be set without setting 'ticks'r=  )r  
get_yticksr  
set_yticksget_yticklabelsrB  set_yticklabelsrD  s           r   yticksrP    s    ~ 
B }}}5}) 6 7 7  }}U}0J~''e'4
Av& 
  ''FeFvF
r   c                V   [        5       n[        U[        5      (       d  [        S5      e[	        S XX#4 5       5      (       a>  U(       d7  UR
                  R                  5       nUR
                  R                  5       nXg4$ U c  [        S5      eUR                  " U 4XUS.UD6u  pgXg4$ )ab  
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 Axesc              3  (   #    U  H  oS L v   M
     g 7fr~   r   )r  ps     r   r  rgrids.<locals>.<genexpr>]	  s     
:999r  z7'radii' cannot be None when other parameters are passed)rF  anglefmt)
r  r  r$   r   r  yaxisget_gridlinesget_ticklabelsr  
set_rgrids)radiirF  rU  rV  r   r  	lines_outrH  s           r   rgridsr]  	  s    B 
Bb)$$?@@

:ue9
:::6"$(("8"8":	!#!8!8!:
    
QRR "!B 3!B:@!B	  r   c                T   [        5       n[        U[        5      (       d  [        S5      e[	        S XU4 5       5      (       a>  U(       d7  UR
                  R                  5       nUR
                  R                  5       nXV4$ U c  [        S5      eUR                  " U 4XS.UD6u  pVXV4$ )aE  
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 Axesc              3  (   #    U  H  oS L v   M
     g 7fr~   r   r~  s     r   r  thetagrids.<locals>.<genexpr>	  s     
<&;UD=&;r  z8'angles' cannot be None when other parameters are passed)rF  rV  )
r  r  r$   r   r  xaxisget_ticklinesrY  r  set_thetagrids)anglesrF  rV  r   r  r\  rH  s          r   
thetagridsre  h	  s    z 
Bb)$$CDD

<vs&;
<<<V"$(("8"8":	!#!8!8!:
    
RSS " 1 1& !<9?!<4:!<	   r   z3.7)pendingc                 X    1 Skn [        5        Vs/ s H  nX;  d  M
  UPM     sn$ s  snf )z4
Get a sorted list of all of the plotting commands.
>   ginputr  r  r   waitforbuttonpressr  )_get_pyplot_commands)NON_PLOT_COMMANDSnames     r   get_plot_commandsrm  	  s:    
4 23 .3T, 3 . . .s   	''c                    ^ ^ SSS1[         km [        R                  " [        5      m[	        U U4S j[        5       R                  5        5       5      $ )N	colormapscolorsrm  c              3     >#    U  Ha  u  pUR                  S 5      (       a  M  UT;  d  M%  [        R                  " U5      (       d  MB  [        R                  " U5      TL d  M]  Uv   Mc     g7f)r   N)r   r   
isfunction	getmodule)r  rl  rb  excludethis_modules      r   r  '_get_pyplot_commands.<locals>.<genexpr>	  sb      6/s# 	(,G(; 	!!#& 	   %4 	/s   A,A,A,A,#	A,)ro  r   rs  rm  r  r*  items)rt  ru  s   @@r   rj  rj  	  sK     H&9FIFG##$56K 6%ioo/6 6 6r   c                v    U c  [        5       n U c  [        S5      e[        5       R                  " U 4XS.UD6nU$ )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  )gcir   r   colorbar)mappablery  r  r   r5  s        r   r{  r{  	  sJ     5  1 2 2 %..
<s
<V
<CJr   c                V    [        5       nUc  [        S5      eUR                  X5        g)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)rz  r   set_clim)vminvmaxr6  s      r   climr  	  s(     
B	zNOOKKr   c                    U c	  [         S   n [        U [        5      (       a  U $ [        R                  " [        [        5      U S9  Uc	  [        U    $ [        U    R                  U5      $ )a0  
Get a colormap instance, defaulting to rc values if *name* is None.

Parameters
----------
name : `~matplotlib.colors.Colormap` or str or None, default: None
    If a `.Colormap` instance, it will be returned. Otherwise, the name of
    a colormap known to Matplotlib, which will be resampled by *lut*. The
    default, None, means :rc:`image.cmap`.
lut : int or None, default: None
    If *name* is not already a Colormap instance and *lut* is not None, the
    colormap will be resampled to have *lut* entries in the lookup table.

Returns
-------
Colormap
z
image.cmap)rl  )r   r  r,   r   check_in_listr  r*   	resampled)rl  luts     r   get_cmapr  	  s`    $ |%$!!vj)5
{$$))#..r   c                    [        U 5      n [        SU R                  S9  [        5       nUb  UR	                  U 5        gg)z
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
get_cmap
image)cmapN)r  rW  rl  rz  set_cmap)r  r6  s     r   r  r  
  s8     D>DwTYY	B	~
D r   c                @    [         R                  R                  X5      $ r~   )r   r  imread)r[  r  s     r   r  r  +
  s     ""511r   c                F    [         R                  R                  " X40 UD6  g r~   )r   r  imsave)r[  arrr   s      r   r  r  2
  s     E1&1r   c                   [         R                  " U 5      n US:X  a  [        5       nO;Ub  [        U5      (       a  SnO[	        U 5      n[        XS9nUR                  S5      nUR                  " U 40 UD6n[        U5        U$ )u  
Display a 2D array as a matrix in a new figure window.

The origin is set at the upper left hand corner.
The indexing is ``(row, column)`` so that the first index runs vertically
and the second index runs horizontally in the figure:

.. code-block:: none

    A[0, 0]   ⋯ A[0, M-1]
       ⋮             ⋮
    A[N-1, 0] ⋯ A[N-1, M-1]

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
    If *None*, create a new, appropriately sized figure window.

    If 0, use the current Axes (creating one if there is none, without ever
    adjusting the figure size).

    Otherwise, create a new Axes on the figure with the given number
    (creating it at the appropriate size if it does not exist, but not
    adjusting the figure size otherwise).  Note that this will be drawn on
    top of any preexisting Axes on the figure.

Returns
-------
`~matplotlib.image.AxesImage`

Other Parameters
----------------
**kwargs : `~matplotlib.axes.Axes.imshow` arguments

r   N)r  )g333333?g
ףp=
??r  )	np
asanyarrayr  r  r   r   r  matshowsci)Afignumr   r  r  r  r6  s          r   r  r  9
  sy    X 	aA{U-"7"7G  lGV-\\45	A	 	 BGIr   c                     [        5       R                  5       (       a5  [        5       n[        U[        5      (       d  [
        R                  " SSS9  O	[        SS9nUR                  " U 0 UD6$ )al  
Make a polar plot.

call signature::

  polar(theta, r, [fmt], **kwargs)

This is a convenience wrapper around `.pyplot.plot`. It ensures that the
current Axes is polar (or creates one if needed) and then passes all parameters
to ``.pyplot.plot``.

.. note::
    When making polar plots using the :ref:`pyplot API <pyplot_interface>`,
    ``polar()`` should typically be the first command because that makes sure
    a polar Axes is created. Using other commands such as ``plt.title()``
    before this can lead to the implicit creation of a rectangular Axes, in which
    case a subsequent ``polar()`` call will fail.
z3.10a	  There exists a non-polar current Axes. Therefore, the resulting plot from 'polar()' is non-polar. You likely should call 'polar()' before any other pyplot plotting commands. Support for this scenario is deprecated in %(since)s and will raise an error in %(removal)s)r   r  )r  )	r   get_axesr  r  r$   r   warn_deprecatedr  plot)r   r   r  s      r   r  r  v
  s^    ( u~~U"i((  = W%77D#F##r   backend_fallbackwebaggnbaggr   )	colorizerc
               N    [        5       R                  " U 4UUUUUUUUU	U
S.
UD6$ )N)
xoyoalphanormr  r  r  originresizer  )r   figimage)Xr  r  r  r  r  r  r  r  r  r  r   s               r   r  r  
  sG      5>>	  r   c                >    [        5       R                  " XU4SU0UD6$ Nfontdict)r   textxyr  r  r   s        r   figtextr  
  !     5::aA;;F;;r   c                 2    [        5       R                  5       $ r~   )r   r  r   r   r   r  r  
  s    599;r   c                 2    [        5       R                  5       $ r~   )r   _gcir   r   r   rz  rz  
  s    5::<r      c           	     :    [        5       R                  U UUUUUS9$ )Nntimeoutshow_clicks	mouse_add	mouse_pop
mouse_stop)r   rh  r  s         r   rh  rh  
  s.     5<<
   r   c           	     6    [        5       R                  XX#XES9  g )Nleftbottomrighttopwspacehspace)r   subplots_adjustr  s         r   r  r  
  s      Ev  r   c                8    [        5       R                  " U 40 UD6$ r~   )r   suptitle)tr   s     r   r  r    s    5>>!&v&&r   gHzG?padh_padw_padrectc                4    [        5       R                  XX#S9  g )Nr  )r   tight_layoutr  s       r   r  r  	  s     E35Dr   c                0    [        5       R                  U S9$ )Nr  )r   ri  r  s    r   ri  ri    s    5##G#44r   )datac               J    [        5       R                  " U 40 Ub  SU0O0 DUD6$ Nr  )r  acorr)r  r  r   s      r   r  r    s*     5;;qSt/?fd^RSFSSr   c          	     V    [        5       R                  " U 4UUUUUS.Ub  SU0O0 DUD6$ N)FsFcwindowpad_tosidesr  )r  angle_spectrumr  r  r  r  r  r  r  r   s           r   r  r  #  O     5			 "-FD>2	 	 	r   c           	     F    [        5       R                  " U U4UUUUUS.UD6$ )N)xytextxycoords
textcoords
arrowpropsannotation_clip)r  annotate)r  xyr  r  r  r  r  r   s           r   r  r  <  s=     5>>
	 '	 	 	r   c                :    [        5       R                  " XX#40 UD6$ r~   )r  arrow)r  r  dxdyr   s        r   r  r  T  s    5;;qR.v..r   bothc                4    [        5       R                  XUS9  g )Nenableaxistight)r  	autoscaler  s      r   r  r  Z  s     EOO6EO:r   c                <    [        5       R                  " SXUS.UD6$ )N)r  xminxmaxr   )r  axhline)r  r  r  r   s       r   r  r  d      5===1d=f==r   c                <    [        5       R                  " X4X#S.UD6$ )N)r  r  )r  axhspan)yminymaxr  r  r   s        r   r  r  j       5==D$DVDDr   )emitc              <    [        5       R                  " U 4SU0UD6$ )Nr  )r  r  )r  r  r   s      r   r  r  r  s     5::c////r   )slopec               <    [        5       R                  " U 4XS.UD6$ )N)xy2r   )r  axline)xy1r  r   r   s       r   r  r  ~  s     5<<<<V<<r   c                <    [        5       R                  " SXUS.UD6$ )N)r  r  r  r   )r  axvline)r  r  r  r   s       r   r  r    r  r   c                <    [        5       R                  " X4X#S.UD6$ )N)r  r  )r  axvspan)r  r  r  r  r   s        r   r  r    r  r   center)alignr  c               T    [        5       R                  " U U4UUUS.Ub  SU0O0 DUD6$ )N)widthr  r
  r  )r  bar)r  heightr  r  r
  r  r   s          r   r  r    sL     599	  "-FD>2  r   c                H    [        5       R                  " U0 U b  SU 0O0 DUD6$ r  )r  barbsr  r   r   s      r   r  r    s)    5;;W43C&$WPVWWr   c               T    [        5       R                  " U U4UUUS.Ub  SU0O0 DUD6$ )N)r  r  r
  r  )r  barh)r  r  r  r  r
  r  r   s          r   r  r    sL     5::	  "-FD>2  r   z%gedge)rV  
label_typepaddingc               B    [        5       R                  " U 4UUUUS.UD6$ )N)rF  rV  r  r  )r  	bar_label)	containerrF  rV  r  r  r   s         r   r  r    s5     5??  r   verticalc                   [        5       R                  " U 40 SU_SU_SU_SU_SU_SU_SU_SU_S	U	_S
U
_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_SU_Ub  SU0D6$ 0 D6$ )Nnotchsymvertorientationwhis	positionswidthspatch_artist	bootstrapusermediansconf_intervalsmeanline	showmeansshowcapsshowbox
showfliersboxpropstick_labels
flierpropsmedianprops	meanpropscappropswhiskerpropsmanage_ticks	autorangezorder	capwidthslabelr  )r  boxplot)r  r  r  r  r  r   r!  r"  r#  r$  r%  r&  r'  r(  r)  r*  r+  r,  r-  r.  r/  r0  r1  r2  r3  r4  r5  r6  r7  r  s                                 r   r8  r8    sL   D 5==	  	
      "    &     !" #$ %&  '( )*  +, -. /0 "12 "34 56 78 9: !-FD>= < 46= r   c               J    [        5       R                  " X40 Ub  SU0O0 DUD6$ r  )r  broken_barh)xrangesyranger  r   s       r   r:  r:  &  s7     5.2.>VTNBKQ r   c                <    [        5       R                  " U 4SU0UD6$ )Nlevels)r  clabel)CSr>  r   s      r   r?  r?  4  s    5<<464V44r      defaultc               `    [        5       R                  " U U4UUUUUUUU	U
S.	Ub  SU0O0 DUD6$ )N)	NFFTr  r  detrendr  noverlapr  r  scale_by_freqr  )r  cohere)r  r  rD  r  r  rE  r  rF  r  r  rG  r  r   s                r   rH  rH  :  s^    $ 5<<		 # "-FD>2  r   c                |    [        5       R                  " U0 U b  SU 0O0 DUD6nUR                  b  [        U5        U$ r  )r  contour_Ar  r  r   r   __rets       r   rJ  rJ  ^  sH    EMM	$($464."AGE xxE
Lr   c                |    [        5       R                  " U0 U b  SU 0O0 DUD6nUR                  b  [        U5        U$ r  )r  contourfrK  r  rL  s       r   rO  rO  i  sH    ENN	$($464."AGE xxE
Lr   c               b    [        5       R                  " U U4UUUUUUUU	U
US.
Ub  SU0O0 DUD6$ N)
rD  r  r  rE  r  rF  r  r  rG  return_liner  )r  csd)r  r  rD  r  r  rE  r  rF  r  r  rG  rR  r  r   s                 r   rS  rS  t  sa    ( 599		 # "-FD>2  r   )complementaryr  compressr  c               T    [        5       R                  " U 4UUUUS.Ub  SU0O0 DUD6$ )N)weightsrT  r  rU  r  )r  ecdf)r  rW  rT  r  rU  r  r   s          r   rX  rX    sJ     5::	# "-FD>2  r   c               h    [        5       R                  " U U4UUUUUUUU	U
UUUUS.Ub  SU0O0 DUD6$ )N)yerrxerrrV  ecolor
elinewidthcapsize	barsabovelolimsuplimsxlolimsxuplims
erroreverycapthickr  )r  errorbar)r  r  rZ  r[  rV  r\  r]  r^  r_  r`  ra  rb  rc  rd  re  r  r   s                    r   rf  rf    sj    * 5>>		   "-FD>2!" # r   c               Z    [        5       R                  " U 4UUUUUUUS.Ub  SU0O0 DU	D6$ )N)r  lineoffsetslinelengths
linewidthsrp  r  
linestylesr  )r  	eventplot)
r!  r  rh  ri  rj  rp  r  rk  r  r   s
             r   rl  rl    sS     5?? "-FD>2  r   c                H    [        5       R                  " U0 U b  SU 0O0 DUD6$ r  )r  fillr  s      r   rn  rn    s(    5::tV$2BVvVVr   c               V    [        5       R                  " U U4UUUUS.Ub  SU0O0 DUD6$ )N)y2whereinterpolatestepr  )r  fill_between)r  y1rp  rq  rr  rs  r  r   s           r   rt  rt     sQ     5	
	 	 "-FD>2	 	 	r   c               V    [        5       R                  " U U4UUUUS.Ub  SU0O0 DUD6$ )N)x2rq  rs  rr  r  )r  fill_betweenx)r  x1rw  rq  rs  rr  r  r   s           r   rx  rx    sQ     5	
	 	 "-FD>2	 	 	r   c                >    [        5       R                  " SXUS.UD6  g )N)visiblewhichr  r   )r  grid)r{  r|  r  r   s       r   r}  r}  2  s     EJJAw$A&Ar   linearfacec                   [        5       R                  " U U40 SU_SU_SU_SU_SU_SU_SU_SU	_S	U
_S
U_SU_SU_SU_SU_SU_SU_SU_Ub  SU0O0 DUD6n[        U5        U$ )NCgridsizebinsxscaleyscaleextentr  r  r  r  r  rj  
edgecolorsreduce_C_functionmincnt	marginalsr  r  )r  hexbinr  )r  r  r  r  r  r  r  r  r  r  r  r  r  rj  r  r  r  r  r  r  r   rM  s                         r   r  r  =  s    2 ELL		  	
             ,!" #$ %& !-FD>2)* +E. JLr   c               h    [        5       R                  " U 4UUUUUUUUU	U
UUUUS.Ub  SU0O0 DUD6$ )N)r  rangedensityrW  
cumulativer  histtyper
  r  rwidthlogcolorr7  stackedr  )r  hist)r  r  r  r  rW  r  r  r  r
  r  r  r  r  r7  r  r  r   s                    r   r  r  r  sh    2 5::	  "-FD>2!" # r   )r  baselinern  r  c               T    [        5       R                  " U 4UUUUS.Ub  SU0O0 DUD6$ )N)edgesr  r  rn  r  )r  stairs)valuesr  r  r  rn  r  r   s          r   r  r    sJ     5<< "-FD>2  r   r   c          
     z    [        5       R                  " U U4UUUUUUS.Ub  SU0O0 DU	D6n
[        U
S   5        U
$ )N)r  r  r  rW  cmincmaxr  r   )r  hist2dr  )r  r  r  r  r  rW  r  r  r  r   rM  s              r   r  r    sd     ELL		  "-FD>2 E b	NLr   c               V    [        5       R                  " U UU4UUUS.Ub  SU0O0 DUD6$ N)rp  rk  r7  r  )r  hlines)r  r  r  rp  rk  r7  r  r   s           r   r  r    O     5<<		 	 "-FD>2	 	 	r         @)aspectinterpolationr  r  r  r  r  r  interpolation_stage
filternorm	filterradresampleurlr  c                   [        5       R                  " U 4UUUUUUUUU	U
UUUUUS.Ub  SU0O0 DUD6n[        U5        U$ )N)r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  )r  imshowr  )r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   rM  s                      r   r  r    sv    , ELL	#/!" "-FD>2#$ %E( JLr   c                 6    [        5       R                  " U 0 UD6$ r~   )r  r  r   s     r   r  r        5<<(((r   c                <    [        5       R                  " SXS.UD6  g )N)r  r  r   )r  locator_params)r  r  r   s      r   r  r  %  s     E:d:6:r   c                 6    [        5       R                  " U 0 UD6$ r~   )r  loglogr   s     r   r  r  -  r  r   c          
     X    [        5       R                  " U 4UUUUUUS.Ub  SU0O0 DUD6$ )N)r  r  r  r  r  rs  r  )r  magnitude_spectrum)	r  r  r  r  r  r  rs  r  r   s	            r   r  r  3  sR     5##	

 "-FD>2
 
 
r   r  r  r  c                6    [        5       R                  " X0XS.6$ )Nr  )r  margins)r  r  r  r  s       r   r  r  N  s     5=='!99r   c                 4    [        5       R                  5         g r~   )r  minorticks_offr   r   r   r  r  Y  s    Er   c                 4    [        5       R                  5         g r~   )r  minorticks_onr   r   r   r  r  _  s    Er   )shadingr  r  r  r  r  r  r  c                r    [        5       R                  " UU UUUUUUS.Ub  SU0O0 DU	D6n
[        U
5        U
$ )N)r  r  r  r  r  r  r  r  )r  pcolorr  )r  r  r  r  r  r  r  r  r   r   rM  s              r   r  r  e  sY     ELL	 "-FD>2 E JLr   )	r  r  r  r  r  r  r  antialiasedr  c        	        t    [        5       R                  " U	U UUUUUUUS.Ub  SU0O0 DU
D6n[        U5        U$ )N)r  r  r  r  r  r  r  r  r  )r  
pcolormeshr  )r  r  r  r  r  r  r  r  r  r   r   rM  s               r   r  r    s^     E	 "-FD>2 E JLr   c          	     V    [        5       R                  " U 4UUUUUS.Ub  SU0O0 DUD6$ r  )r  phase_spectrumr  s           r   r  r    r  r   )	normalizehatchr  c                   [        5       R                  " U 40 SU_SU_SU_SU_SU_SU_SU_SU_S	U	_S
U
_SU_SU_SU_SU_SU_SU_SU_Ub  SU0D6$ 0 D6$ )NexploderF  rp  autopctpctdistanceshadowlabeldistance
startangleradiuscounterclock
wedgeprops	textpropsr	  framerotatelabelsr  r  r  )r  pie)r  r  rF  rp  r  r  r  r  r  r  r  r  r  r	  r  r  r  r  r  s                      r   r  r    s    . 599	  	
     $   "      "!" #$ !-FD>' & 46' r   )scalexscaleyr  c                N    [        5       R                  " UU US.Ub  SU0O0 DUD6$ )N)r  r  r  )r  r  )r  r  r  r   r   s        r   r  r    s?     5::	 "-FD>2	
  r   c               V    [        5       R                  " U U4UUUUS.Ub  SU0O0 DUD6$ )N)rV  tzxdateydater  )r  	plot_date)r  r  rV  r  r  r  r  r   s           r   r  r    sO     5??			 	 "-FD>2	 	 	r   c               `    [        5       R                  " U 4UUUUUUUUU	U
S.
Ub  SU0O0 DUD6$ rQ  )r  psd)r  rD  r  r  rE  r  rF  r  r  rG  rR  r  r   s                r   r  r    s\    & 599	# "-FD>2  r   c                b    [        5       R                  " U0 U b  SU 0O0 DUD6n[        U5        U$ r  )r  quiverr  rL  s       r   r  r  ;  s>    ELL	$($464."AGE JLr   c                <    [        5       R                  " XX#U40 UD6$ r~   )r  	quiverkey)Qr  YUr7  r   s         r   r  r  E  s     5??1u777r   )r  r  plotnonfiniter  c                   [        5       R                  " U U4UUUUUUUU	U
UUUS.Ub  SU0O0 DUD6n[        U5        U$ )N)r  cmarkerr  r  r  r  r  rj  r  r  r  r  )r  scatterr  )r  r  r  r  r  r  r  r  r  r  rj  r  r  r  r  r   rM  s                    r   r  r  M  sr    ( EMM		 
# "-FD>2  !E$ JLr   c                 6    [        5       R                  " U 0 UD6$ r~   )r  semilogxr   s     r   r  r  x      5>>4*6**r   c                 6    [        5       R                  " U 0 UD6$ r~   )r  semilogyr   s     r   r  r  ~  r  r   c                   [        5       R                  " U 4UUUUUUUUU	U
UUUUUS.Ub  SU0O0 DUD6n[        US   5        U$ )N)rD  r  r  rE  r  rF  r  xextentr  r  rG  moders  r  r  r  r   )r  specgramr  )r  rD  r  r  rE  r  rF  r  r  r  r  rG  r  rs  r  r  r  r   rM  s                      r   r  r    sz    0 ENN	#!" "-FD>2#$ %E( b	NLr   c           	         [        5       R                  " U 4UUUUUS.UD6n[        U[        5      (       a  [	        U5        U$ )N)	precisionr  
markersizer  r  )r  spyr  r%   r  )Zr  r  r  r  r  r   rM  s           r   r  r    sQ     EII	 E %,--E
Lr   r   zero)rF  rp  r  r  r  c               Z    [        5       R                  " U /UQ7UUUUS.Ub  SU0O0 DUD6$ )N)rF  rp  r  r  r  )r  	stackplot)r  rF  rp  r  r  r  r   r   s           r   r  r    sT     5??				 	 "-FD>2	 	 	r   )linefmt	markerfmtbasefmtr  r7  r  r  c           
     V    [        5       R                  " UU UUUUUS.Ub  SU0D6$ 0 D6$ )N)r  r  r  r  r7  r  r  )r  stem)r  r  r  r  r7  r  r  r   s           r   r  r    sN     5::		 "-FD>	 	 46	 	r   pre)rq  r  c               V    [        5       R                  " U U/UQ7SU0Ub  SU0O0 DUD6$ )Nrq  r  )r  rs  )r  r  rq  r  r   r   s         r   rs  rs    sP     5::		 
 	
 "-FD>2  r   c                   [        5       R                  " U UUU4UUUUUU	U
UUUUUUUS.Ub  SU0O0 D6n[        UR                  5        U$ )N)r  rl  r  r  r  	arrowsize
arrowstyle	minlength	transformr5  start_points	maxlengthintegration_directionbroken_streamlinesr  )r  
streamplotr  lines)r  r  uvr  rl  r  r  r  r  r  r  r  r5  r  r  r	  r
  r  rM  s                       r   r  r    s{    . E					
 !3-%& "-FD>2'E* Lr   c                R    [        5       R                  " SU UUUUUUUUU	U
UUS.UD6$ )N)cellTextcellColourscellLoc	colWidths	rowLabels
rowColoursrowLoc	colLabels
colColourscolLocr  bboxr  r   )r  table)r  r  r  r  r  r  r  r  r  r  r  r  r  r   s                 r   r  r  <  sM    " 5;;   r   c                >    [        5       R                  " XU4SU0UD6$ r  )r  r  r  s        r   r  r  `  r  r   c                <    [        5       R                  " SSU 0UD6  g )Nr  r   )r  tick_params)r  r   s     r   r  r  h  s    E*4*6*r   r  r   	scilimits	useOffset	useLocaleuseMathTextc           	     <    [        5       R                  U UUUUUS9  g )Nr  )r  ticklabel_formatr  s         r   r%  r%  n  s+     E  r   c                 j    [        5       R                  " U 0 UD6nUR                  b  [        U5        U$ r~   )r  
tricontourrK  r  r   r   rM  s      r   r'  r'    s/    Ed-f-ExxE
Lr   c                 j    [        5       R                  " U 0 UD6nUR                  b  [        U5        U$ r~   )r  tricontourfrK  r  r(  s      r   r*  r*    s/    Et.v.ExxE
Lr   g      ?flatr  r  r  r  r  r  
facecolorsc                `    [        5       R                  " UU UUUUUUS.UD6n	[        U	5        U	$ )Nr,  )r  	tripcolorr  )
r  r  r  r  r  r  r-  r   r   rM  s
             r   r/  r/    sD     EOO	
 
E JLr   c                 6    [        5       R                  " U 0 UD6$ r~   )r  triplotr   s     r   r1  r1    s    5==$)&))r   c               b    [        5       R                  " U 4UUUUUUUUU	U
US.Ub  SU0D6$ 0 D6$ )N)r!  r  r  r"  r(  showextremashowmedians	quantilespoints	bw_methodsider  )r  
violinplot)datasetr!  r  r  r"  r(  r3  r4  r5  r6  r7  r8  r  s                r   r9  r9    sd    ( 5 "-FD>  46 r   c               V    [        5       R                  " U UU4UUUS.Ub  SU0O0 DUD6$ r  )r  vlines)r  r  r  rp  rk  r7  r  r   s           r   r<  r<    r  r   c               V    [        5       R                  " U U4UUUUS.Ub  SU0O0 DUD6$ )N)normedrE  	usevlinesmaxlagsr  )r  xcorr)r  r  r>  rE  r?  r@  r  r   s           r   rA  rA    sO     5;;			 	 "-FD>2	 	 	r   c                6    [        5       R                  U 5        g r~   )r  _sci)r6  s    r   r  r    s    EJJrNr   )r  c               >    [        5       R                  " U 4XX4S.UD6$ )N)r  r  r  r  )r  	set_title)r7  r  r  r  r  r   s         r   titlerF    s!     5??5U8#UfUUr   )r  c               >    [        5       R                  " U 4XUS.UD6$ N)r  labelpadr  )r  
set_xlabel)xlabelr  rI  r  r   s        r   rK  rK  #  .     5!#AG r   c               >    [        5       R                  " U 4XUS.UD6$ rH  )r  
set_ylabel)ylabelr  rI  r  r   s        r   rO  rO  2  rL  r   c                :    [        5       R                  " U 40 UD6  g r~   )r  
set_xscalevaluer   s     r   r  r  A      EU%f%r   c                :    [        5       R                  " U 40 UD6  g r~   )r  
set_yscalerR  s     r   r  r  G  rT  r   c                     [        S5        g)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.
autumnNr  r   r   r   rX  rX  M       Xr   c                     [        S5        g)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.
boneNrY  r   r   r   r\  r\  X       Vr   c                     [        S5        g)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.
coolNrY  r   r   r   r_  r_  c  r]  r   c                     [        S5        g)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.
copperNrY  r   r   r   ra  ra  n  rZ  r   c                     [        S5        g)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.
flagNrY  r   r   r   rc  rc  y  r]  r   c                     [        S5        g)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.
grayNrY  r   r   r   re  re    r]  r   c                     [        S5        g)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.
hotNrY  r   r   r   rg  rg         UOr   c                     [        S5        g)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.
hsvNrY  r   r   r   rj  rj    rh  r   c                     [        S5        g)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.
jetNrY  r   r   r   rl  rl    rh  r   c                     [        S5        g)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.
pinkNrY  r   r   r   rn  rn    r]  r   c                     [        S5        g)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.
prismNrY  r   r   r   rp  rp         Wr   c                     [        S5        g)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.
springNrY  r   r   r   rs  rs    rZ  r   c                     [        S5        g)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.
summerNrY  r   r   r   ru  ru    rZ  r   c                     [        S5        g)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.
winterNrY  r   r   r   rw  rw    rZ  r   c                     [        S5        g)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.
magmaNrY  r   r   r   ry  ry    rq  r   c                     [        S5        g)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.
infernoNrY  r   r   r   r{  r{         Yr   c                     [        S5        g)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.
plasmaNrY  r   r   r   r~  r~    rZ  r   c                     [        S5        g)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.
viridisNrY  r   r   r   r  r    r|  r   c                     [        S5        g)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_spectralNrY  r   r   r   r  r    s     _r   r~   )r   r1   r   zLiteral[None]r  r   )r   r1   r   Callable[_P, _R]r  r  )r   r1   r   zCallable[_P, _R] | Noner  zACallable[[Callable[_P, _R]], Callable[_P, _R]] | Callable[_P, _R]r  )NNT)r   zArtist | Noner   z.Callable[[Artist], bool] | type[Artist] | Noner   r  r  zlist[Artist])r  z'type[matplotlib.backend_bases._Backend])r-  r  r  r  )r  r  )r  r   )rT  floatr  r  )rX  r  r  r  )NN)rW  dict[str, Any] | Noner[  z'str | pathlib.Path | os.PathLike | Noner  zAbstractContextManager[None])ri   rg  r   )rs  r  rt  r  ru  r  r  r   )NNN)r   z%int | str | Figure | SubFigure | Noner  tuple[float, float] | Noner  float | Nonerv  ColorType | Nonerw  r  rx  r  r  ztype[Figure]ry  r  r  r   )r  r   )r   z	int | strr  r  )r  z	list[int])r  z	list[Any])r  zFigureManagerBase | None)r  r  r   zCallable[[Event], Any]r  r  )r  r  r  r  )r  z*None | int | str | Figure | Literal['all']r  r  )r  rI   )r  z(None | tuple[float, float, float, float]r  matplotlib.axes.Axes)r  matplotlib.axes.Axes | Noner  r  )r  r    r  r  )r  r    )..)r  
Literal[1]r  r  r  +bool | Literal['none', 'all', 'row', 'col']r  r  r  zLiteral[True]r  Sequence[float] | Noner  r  r  r  r  r  r  ztuple[Figure, Axes])r  r  r  r  r  r  r  r  r  zLiteral[False]r  r  r  r  r  r  r  r  r  ztuple[Figure, np.ndarray])r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  ztuple[Figure, Any])ri   ri   )r	  r  r  r  r  r  r  ArrayLike | Noner  r  r  r  r  r  r  r  r  z2dict[str | tuple[str, ...], dict[str, Any]] | Noner  r1   r  z.tuple[Figure, dict[str, matplotlib.axes.Axes]])r	  zlist[HashableList[_T]]r  r  r  r  r  r  r  r  r  r\   r  r  r  r  r  z0dict[_T | tuple[_T, ...], dict[str, Any]] | Noner  r1   r  z-tuple[Figure, dict[_T, matplotlib.axes.Axes]])r	  zlist[HashableList[Hashable]]r  r  r  r  r  r  r  r  r  r1   r  r  r  r  r  z<dict[Hashable | tuple[Hashable, ...], dict[str, Any]] | Noner  r1   r  z3tuple[Figure, dict[Hashable, matplotlib.axes.Axes]])r	  z;str | list[HashableList[_T]] | list[HashableList[Hashable]]r  r  r  r  r  r  r  r  r  r1   r  r  r  r  r  zdict[str | tuple[str, ...], dict[str, Any]] | dict[_T | tuple[_T, ...], dict[str, Any]] | dict[Hashable | tuple[Hashable, ...], dict[str, Any]] | Noner  r1   r  ztuple[Figure, dict[str, matplotlib.axes.Axes]] | tuple[Figure, dict[_T, matplotlib.axes.Axes]] | tuple[Figure, dict[Hashable, matplotlib.axes.Axes]])ri   ri   N)r  tuple[int, int]r  r  r  r  r  r  r  Figure | Noner  r  )r  r  r  r8   )r)  r  r  zSubplotTool | None)r/  bool | Noner  r  )r  tuple[float, float])rE  r  rF  Sequence[str] | Noner=  r  r  z*tuple[list[Tick] | np.ndarray, list[Text]])NNNN)
r[  r  rF  Sequence[str | Text] | NonerU  r  rV  
str | Noner  tuple[list[Line2D], list[Text]])rd  r  rF  r  rV  r  r  r  )r  z	list[str])r|  z(ScalarMappable | ColorizingArtist | Nonery  r  r  z<matplotlib.axes.Axes | Iterable[matplotlib.axes.Axes] | Noner  rD   )r  r  r  r  r  r  )rl  zColormap | str | Noner  
int | Noner  r,   )r  zColormap | strr  r  )r[  zstr | pathlib.Path | BinaryIOr  r  r  z
np.ndarray)r[  zstr | os.PathLike | BinaryIOr  r6   r  r  )r  r6   r  z
None | intr  rK   )r  list[Line2D])	r   r   NNNNNNF)r  r6   r  r  r  r  r  r  r  str | Normalize | Noner  str | Colormap | Noner  r  r  r  r   Literal['upper', 'lower'] | Noner  r  r  Colorizer | Noner  rL   )
r  r  r  r  r  r  r  r  r  r`   )r  zColorizingArtist | None)r  r  r  r  r  r  r  r   r  r   r  r   r  zlist[tuple[int, int]])NNNNNN)r  r  r  r  r  r  r  r  r  r  r  r  r  r  )r  r  r  r`   )
r  r  r  r  r  r  r  (tuple[float, float, float, float] | Noner  r  )r   )r  r  r  zNone | bool)r  r6   r  Etuple[np.ndarray, np.ndarray, LineCollection | Line2D, Line2D | None])NNNNN)r  r6   r  r  r  r  r  3Callable[[ArrayLike], ArrayLike] | ArrayLike | Noner  r  r  1Literal['default', 'onesided', 'twosided'] | Noner  %tuple[np.ndarray, np.ndarray, Line2D])Nr  NNN)r  r  r  r  r  r  r  rU   r  zCoordsType | Noner  r  r  r  r  ra   )
r  r  r  r  r  r  r  r  r  rM   )Tr  N)r  r  r  Literal['both', 'x', 'y']r  r  r  r  )r   r   ri   )r  r  r  r  r  r  r  r^   )r   ri   )
r  r  r  r  r  r  r  r  r  rd   )r  z5tuple[float, float, float, float] | bool | str | Noner  r  r  z!tuple[float, float, float, float])r  r  r  r  r   r  r  r_   )r  r  r  r  r  r  r  r^   )
r  r  r  r  r  r  r  r  r  rd   )g?N)r  float | ArrayLiker  r  r  r  r  float | ArrayLike | Noner
  Literal['center', 'edge']r  rE   )r  rP   )r  r  r  r  r  r  r  r  r
  r  r  rE   )r  rE   rF  r  rV  zstr | Callable[[float], str]r  r  r  r  r  zlist[Annotation])NNNr  NNNNNNNNNNNNNNNNNNNTFNNN)<r  ArrayLike | Sequence[ArrayLike]r  r  r  r  r  r  r  !Literal['vertical', 'horizontal']r   z"float | tuple[float, float] | Noner!  r  r"  r  r#  r  r$  r  r%  r  r&  r  r'  r  r(  r  r)  r  r*  r  r+  r  r,  r  r-  r  r.  r  r/  r  r0  r  r1  r  r2  r  r3  r  r4  r  r5  r  r6  r  r7  r  r  zdict[str, Any])r;  zSequence[tuple[float, float]]r<  r  r  r@   )r@  r;   r>  r  r  z
list[Text])r  r6   r  r6   rD  r  r  r  r  r  rE  zDLiteral['none', 'mean', 'linear'] | Callable[[ArrayLike], ArrayLike]r  z,Callable[[ArrayLike], ArrayLike] | ArrayLikerF  r  r  r  r  z*Literal['default', 'onesided', 'twosided']rG  r  r  ztuple[np.ndarray, np.ndarray])r  r<   )
NNNNNNNNNN)r  r6   r  r6   rD  r  r  r  r  r  rE  KLiteral['none', 'mean', 'linear'] | Callable[[ArrayLike], ArrayLike] | Noner  r  rF  r  r  r  r  r  rG  r  rR  r  r  Etuple[np.ndarray, np.ndarray] | tuple[np.ndarray, np.ndarray, Line2D])r  r6   rW  r  rT  r  r  z"Literal['vertical', 'horizonatal']rU  r  r  r^   )NNr   NNNFFFFFri   N) r  r  r  r  rZ  r  r[  r  rV  r  r\  r  r]  r  r^  r  r_  r  r`  bool | ArrayLikera  r  rb  r  rc  r  rd  int | tuple[int, int]re  r  r  rF   )
horizontalri   ri   NNNsolid)r!  r  r  z!Literal['horizontal', 'vertical']rh  float | Sequence[float]ri  r  rj  float | Sequence[float] | Nonerp  &ColorType | Sequence[ColorType] | Noner  r  rk  z'LineStyleType | Sequence[LineStyleType]r  rB   )r  zlist[Polygon])r   NFN)r  r6   ru  ArrayLike | floatrp  r  rq  Sequence[bool] | Nonerr  r  rs  $Literal['pre', 'post', 'mid'] | Noner  r>   )r   NNF)r  r6   ry  r  rw  r  rq  r  rs  r  rr  r  r  r>   )Nmajorr  )r{  r  r|  z!Literal['major', 'minor', 'both']r  r  r  r  )(r  r6   r  r6   r  r  r  r  r  z-Literal['log'] | int | Sequence[float] | Noner  Literal['linear', 'log']r  r  r  r  r  r  r  r  r  r  r  r  r  r  rj  r  r  z#Literal['face', 'none'] | ColorTyper  z+Callable[[np.ndarray | list[float]], float]r  r  r  r  r  r  r  r@   )NNFNFNr  midr  NFNNF) r  r  r  z"int | Sequence[float] | str | Noner  r  r  r  rW  r  r  zbool | floatr  zArrayLike | float | Noner  z2Literal['bar', 'barstacked', 'step', 'stepfilled']r
  zLiteral['left', 'mid', 'right']r  r  r  r  r  r  r  r  r7  str | Sequence[str] | Noner  r  r  zgtuple[np.ndarray | list[np.ndarray], np.ndarray, BarContainer | Polygon | list[BarContainer | Polygon]])r  r6   r  r  r  r  r  r  rn  r  r  rN   )r   NFNNN)r  r6   r  r6   r  zFNone | int | tuple[int, int] | ArrayLike | tuple[ArrayLike, ArrayLike]r  r  r  r  rW  r  r  r  r  r  r  z3tuple[np.ndarray, np.ndarray, np.ndarray, QuadMesh])Nr  r   )r  r  r  r  r  r  rp  r  rk  rW   r7  r  r  r?   )"r  zArrayLike | PIL.Image.Imager  r  r  r  r  'Literal['equal', 'auto'] | float | Noner  r  r  r  r  r  r  r  r  r  r  r  r  r  r  z&Literal['data', 'rgba', 'auto'] | Noner  r  r  r  r  r  r  r  r  rK   )r  N)r  r  r  r  r  r  )r  r6   r  r  r  r  r  r  r  r  r  r  rs  )Literal['default', 'linear', 'dB'] | Noner  r  )
r  r  r  r  r  r  r  r  r  r  )r   r6   r  z)Literal['flat', 'nearest', 'auto'] | Noner  r  r  r  r  r  r  r  r  r  r  r  r  r=   )r   r6   r  r  r  r  r  r  r  r  r  r  r  r  r  z4Literal['flat', 'nearest', 'gouraud', 'auto'] | Noner  r  r  rC   )NNNNg333333?Fg?r   ri   TNN)r   r   FF)&r  r6   r  r  rF  r  rp  r  r  z#str | Callable[[float], str] | Noner  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r	  r  r  r  r  r  r  r  r  r  r  zKtuple[list[Wedge], list[Text]] | tuple[list[Wedge], list[Text], list[Text]])r   zfloat | ArrayLike | strr  r  r  r  r  r  )r   NTF)r  r6   r  r6   rV  r  r  zstr | datetime.tzinfo | Noner  r  r  r  r  r  )r  r6   rD  r  r  r  r  r  rE  r  r  r  rF  r  r  r  r  r  rG  r  rR  r  r  r  )r  rQ   )r  rQ   r  r  r  r  r  r  r7  r  r  rR   )	NNNNNNNNN)r  r  r  r  r  r  r  z2ArrayLike | Sequence[ColorType] | ColorType | Noner  zMarkerType | Noner  r  r  r  r  r  r  r  r  r  rj  r  r  z@Literal['face', 'none'] | ColorType | Sequence[ColorType] | Noner  r  r  r  r  rA   )NNNNNNNNNNNNNNN)"r  r6   rD  r  r  r  r  r  rE  r  r  r  rF  r  r  r  r  r  r  r  r  r  rG  r  r  z?Literal['default', 'psd', 'magnitude', 'angle', 'phase'] | Noners  r  r  r  r  r  r  z4tuple[np.ndarray, np.ndarray, np.ndarray, AxesImage])r   NNequalupper)r  r6   r  zfloat | Literal['present']r  r  r  r  r  r  r  zLiteral['upper', 'lower']r  rK   )r   zArrayLike | strr  r  r  r  r  r  r  r  r7  r  r  r  r  rG   )r  r6   r  r6   rq  zLiteral['pre', 'post', 'mid']r  r  )ri   NNNNri   z-|>g?NNNr  r  T)NNr  NNNr  NNr	  r  Nclosed)r  )r  r  r  r  )r  r  r   z0Literal['', 'sci', 'scientific', 'plain'] | Noner   ztuple[int, int] | Noner!  zbool | float | Noner"  r  r#  r  r  r  )NNr  g      ?FTFNrg  Nr  )r:  r  r!  r  r  r  r  r  r"  r  r(  r  r3  r  r4  r  r5  z(Sequence[float | Sequence[float]] | Noner6  r  r7  zMLiteral['scott', 'silverman'] | float | Callable[[GaussianKDE], float] | Noner8  zLiteral['both', 'low', 'high']r  zdict[str, Collection])r  r  r  r  r  r  rp  r  rk  rW   r7  r  r  r?   )r  r6   r  r6   r>  r  rE  z Callable[[ArrayLike], ArrayLike]r?  r  r@  r  r  r  )r6  r&   r  r  )r7  r  r  r  r  )Literal['left', 'center', 'right'] | Noner  r  r  r  r  r`   )
rK  r  r  r  rI  r  r  r  r  r`   )
rO  r  r  r  rI  r  r  z)Literal['bottom', 'center', 'top'] | Noner  r`   )rS  zstr | ScaleBaser  r  (~  r   
__future__r   
contextlibr   r   enumr   r   r  r   loggingr   r;  rR  typingr   r   r	   r
   r   matplotlib.colorbarmatplotlib.imager   r   r   r   r   r   r   r   r   r(  r   r   r   matplotlib.figurer   r   r   matplotlib.gridspecr   r   r   r   r   matplotlib.artistr   matplotlib.axesr    r!   r  r"   r#   matplotlib.projectionsr$   matplotlib.colorizerr%   r&   r'   r(   matplotlib.scaler)   matplotlib.cmr*   matplotlib.colorsr+   r,   numpyr  collections.abcr-   r.   r/   r0   datetimepathlibosr1   r2   r3   r4   typing_extensionsr5   	PIL.ImagePILnumpy.typingr6   matplotlib.axisr7   matplotlib.axes._baser8   r9   r:   matplotlib.contourr;   r<   matplotlib.collectionsr=   r>   r?   r@   rA   rB   rC   rD   matplotlib.containerrE   rF   rG   rH   matplotlib.legendrI   matplotlib.mlabrJ   rK   rL   matplotlib.patchesrM   rN   rO   matplotlib.quiverrP   rQ   rR   rS   matplotlib.typingrT   rU   rV   rW   rX   matplotlib.widgetsrY   rZ   r[   r\   r]   matplotlib.linesr^   r_   matplotlib.textr`   ra   rb   rc   rd   re   rf   rg   rh   tickerrj   rk   rl   rm   rn   ro   rp   rq   rr   rs   rt   ru   rv   rw   rx   ry   rz   r{   r|   	getLoggerr   r"  ro  color_sequencesr   r   r   r   r   r   r   r   r   r  r   r   r   r   __annotations__r   r   rA  r   r  r   rF  rJ  rI  rU  rW  rZ  r]  r_  r`  r   rf  rj  r   r  r   r  r  r  r  r  r  r  r  r  r  r  r  r  r  replaceinterpdr  r  r  r  r  r  r
  r  r  r!  r+  r0  r6  r;  rJ  rP  r]  re  
deprecatedrm  rj  r{  r  r  r  r  r  r  r  r  _get_backend_or_nonesetlist_builtinINTERACTIVEr  _setr  r  r  r  r  r  rz  rh  LEFTRIGHTMIDDLEr  r  r  ri  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r8  r:  r?  rH  detrend_nonewindow_hanningrJ  rO  rS  rX  rf  rl  rn  rt  rx  r}  r  meanr  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  rs  r  r  r  r%  r'  r*  r/  r1  r9  r<  rA  rC  r  rE  rF  rJ  rK  rN  rO  rQ  r  rV  r  rX  r\  r_  ra  rc  re  rg  rj  rl  rn  rp  rs  ru  rw  ry  r{  r~  r  r  r   r   r   <module>r     s"0  "L # 8      
   0 0      G  % % "  !6 6 ; ; 5 = = $   # ? , Q Q  , $ 8 FF66+&#$/.,=   - 
 ,(+7??::*  /	4B	B	B ( + , 7 7 & 5 5J J J J J J " 	" 
 99
9 49 
9 
BB'B,<B 
B %)
! G09T@ *,HI $)) 
)(X. && !!8!894 :4 !0<@7797 7 	7 17 @D< CGVr.B	C-4`'D%X%P8 !/# 0# !!6!67 $59,,2, ", 8, !!6!67 8 !!2!2!7!788 98 !!2!2!6!677 87 !!2!2!7!788 98
 @ABB#B7<BBR 26*.G! #'"& &G!	.G! (	G! 
G!  G!  G! G! G! G!  !G!T#* *+
; " !!1!=!=>- ?- !!1!@!@A% B%'7 '7T
( !0 1)	==--	]	+	 0	1	[	)  48V+	1V+ V+ V+r 	 r rj 
 ;>:= +.,/(+), 8	
 8  ) * & '  
  
 ;>:=+.,/(+), 8	
 8  ) * & '  
  
 ;>:=+.,/(+), 8	
 8  ) * & '  
" "#`:?:?+/,0(,)-```7` 8` 	`
 )` *` &` '` `F 
 %(&)(+),IL99 9 	9
 #9 $9 9 &9 '9 G9 9 49 
9 
 %(&)(+),GJ8"8 8 	8
 #8 $8 8 &8 '8 E8 8 38 
8 
 %(&)(+),SV>(> > 	>
 #> $> > &> '> Q> > 9> 
>$ %)&*(,)- TX~G~ ~ 	~
 #~ $~ ~ &~ '~Q~ ~9~F &'1212!01212"12 
12
 12h    2 2. ."J"L ##'S 	SS S 	S 0Sn ##'R 	RR R 	R 0Rl #*.	L!L!'L! L! 
	L! %L!`  $*.I!I!'I! 
I!
 %I!X %. &.
6  !19='+GK6	$ 	E
  2" */ /:. !!1!1!8!89CG2,26@22 :2 !!1!1!8!892'2.72	2 :2: :z"$P  ))+ --m.G.GHIw ! 4466MM)W;;< !1 #'"&/3 #' 	 	
 !     -     2@ !-BF<<<<*?<	< .< !, -
 !- .
 !/(--(..)00
  	
    0& !!7!78



 
 
	

 
 
 

 9
 !1' 2'
 !!4!45 59E	E E 	E
 3E 
E 6E !!:!:;5 <5
 !,TTJT -T !!4!45 BF?C 
 	 @	
  = + 60 !/ *.!$((,#'
 ' 	
 " & !  0. !,/ -/
 !0&,;;
#; ; 
	; 1; !.> />
 !.=>E
EE$)E5:EE /E !+AE0 	0	>0 	0 '0 ,0 !- '+= 	=	=	#= 	= = .= !.> />
 !.=>E
EE$)E5:EE /E !*  #'+	 (0	  %	 %  +, !, X -X
 !+ !$%)	 (0	  #	 %  ,, !0  $ )-,2 
&	
 *   1( !. 5?/3"&'+ $ $('+ ! "&*(,(,)-'+&**.*."&;@> 
?@&@@ 
@ 	@
 3@ -@  @ %@ @ @ "@ %@ @ @ @  !@" #@$ $%@& &'@( &)@* '+@, %-@. $/@0 (1@2 3@4 5@6 7@8 (9@:  ;@@ A@ /@H !!1!12
 
		*		 	 3	 !-5 .5
 !- )-):):;?;N;N8A!% 
  		
 	' 9   6   #! .F !.  / !/  0 !*  BF?C!%#"  
!""" " 		"
 	"" @" " " =" " "$ K%" +"L !+ !%  6@	 	
 4   ,, !/ &*%)## $$ % %()!&" 
#&&& #& #	&
 
& & & & & & & & & && && '& 0&T !0 6B+,+,1559,0:A 
.2 ) )	
 / 3 * 8  18 !+ W ,W
 !!2!23 #'15 
 	 !	
  /  40 !!3!34 #'15 
 	 !	
 /   50 !+/6&,BB,B $B
 
B ,B !- &):>'/'/7;"&#'#6<EGWW"&'0* 
+000 0 $	0
 80 %0 %0 50  0 !0 0 0 0 0 40  C!0" #0$ %0&  '0. /0 .0h !+ 04(, $$'+CH-25?48(,*" 
#*&*
,* &* 	*
 * * %* A* +* 3* * 
* 2* &* *&'* ,*\ !- # 6@)*	 3	
 '   ., !- TV" $ 
 Q 	
     9 .< !-
 6: ' 

  3	
    .0 !- #'#'*
 7; $&*"&/37;BF 	%*"*
* !*
 4* * $* * *  * -* 5* @* * *  !*" 
#*( )* .*\ !-) .)
 !!4!45CG;
#;5@;	; 6; !-) .)
 !!8!89 BF?C7; 
 	 @	
  = 5 + :4 !. 	::: : 	:
  : /: !!4!45 6
 !!3!34 5
 !- :>#'"&"&	6  !	
        .: !1 #'"&"&DH	 !  	
     B   2> !!4!45 BF?C 
 	 @	
  = + 60 !* !%#'5937"%(,'+"(!*$ (,	)*** !* 3	*
 1* * *  * * * * &* %*  * *  !*$ %*& &'** Q+* +*\ !+ 		"   ," !0 '+ 
 
 	%	
    10 !*  BF?C!%#  
  
  	  		 
  @      =     " K#  + H !-  . !0888!8&+84788 18 !. #'<@ $"&#'15& TX"&	!&&&  & :	&
 &  & !& & & & /& Q&  & &$ %& /&T !/+ 0+
 !/+ 0+
 !/  BF"&*.?C!%LP7;%,( 
),,
, 	, 		,
, @, ,  , (, , =, , J,  5!," #,$ %,, :-, 0,` !* -.#6=(/)  	
 4 &  +0 !0D6 1  !+  5?	  	
   3  ,. !+
 ,1	 )	  ,& !1 
		 %,( 
), 2,` !,	
 -F !+BF<<<<*?<	< ,< !!1!12+ + 3+
 !!6!67 '->B(,%)!#
# < &	
 #   
 8( !1 2 !!1!12 3 !0 				 16 !.* /*
 !1 #'5? #:> +1!" 
#!,!! ! 3	!
 ! ! ! ! 8! !! )!$ %! 2!J !-
 6: ' 

  3	
    .0 !, 040A0A 
  .	
   K -0 !+ ,
 !0 '+59		V 	V	V#	V 
3	V 
		V 	V 
	V 1	V !1 '+!

 6:

#
 

 
3
 

 2
 !1 '+!

 6:

#
 

 
3
 

 2
 !1& 2&
 !1& 2&
 r   