B ]”t\Cúã @s\dZddlZejdkredƒ‚ddlZddlmZddlZddlZ ddl Z ddl Z ddl Z ddl Z ddl mZddlZddlZddlZddlmZddlZddlZddlZddlZddlZddlZddlZddlZdd lmZmZdd l m!Z!m"Z"m#Z#m$Z$dd l m%Z%dd l&m'Z'm(Z(m)Z)ddl*Z*dd l+m,Z,e-e,ƒdƒZ.[,e /e0¡Z1dZ2dZ3dd„Z4y ddl5Z5Wnek r‚edƒ‚YnXy ddl6Z6Wnek r®edƒ‚YnXe4e6j.dƒsÌede6j.ƒ‚e4e*j.e2ƒsìede2e*j.fƒ‚e7edƒsdge_8dZ9d”dd„Z:dd „Z;e;ƒGd!d"„d"e<ƒZ=e >¡e ?d#¡e=ƒZ@WdQRXd•d$d%„ZAd&d'„ZBd(d)„ZCdeC_DdeC_Ed*d+„ZFd,d-„ZGdeG_Ed.d/„ZHd0d1„ZIeAd2ƒd3d4„ƒZJd5d6„ZKd7d8„ZLd9d:„ZMd;d<„ZNeAd=ƒd>d?„ƒZOeAd@ƒdAdB„ƒZPdCdD„ZQeAdEƒdFdG„ƒZRdHdI„ZSdJdK„ZTiZUdLdMdNdOdPœZVdQdRdRdSdTœZWeUeV™ZXGdUdV„dVeeYƒZZd–dXdY„Z[e \dZ¡Z]d[d\„Z^ej_d]d^„ƒZ`d_Zad—d`da„Zbd˜dcdd„Zce[ƒZdeY eedde¡rîejf gedde¡sîejf heTƒ¡\ZiZjejf kei¡Ziejf leiedde¡Zmemedde<e >¡4e ?d#e!¡eZed n¡ƒZoeZdfdg„e' p¡DƒƒZqWdQRXeHeddhƒeddh<eIeddiƒeddi<eddjrhe rejsdk¡dldm„Ztdndo„Zudpdq„Zvdrds„ZwGdtdu„duƒZxd™dvdw„Zyejz {dx¡r¾ejz {dx¡eddy<dzd{„Z|d|d}„Z}d~d„Z~d€d„Zd‚dƒd„gZ€d…d†„Zdšd‡dˆ„Z‚dWe‚_ƒd‰dŠ„Z„d‹Z…dŒd„Z†d›dŽd„Z‡e1 ˆde.¡e1 ˆd‘e~ƒ¡e1 ˆd’ej‰¡e1 ˆd“eŠej‹ƒ¡dS)œa³ This is an object-oriented plotting library. A procedural interface is provided by the companion pyplot module, which may be imported directly, e.g.:: import matplotlib.pyplot as plt or using ipython:: ipython at your terminal, followed by:: In [1]: %matplotlib In [2]: import matplotlib.pyplot as plt at the ipython shell prompt. For the most part, direct use of the object-oriented library is encouraged when programming; pyplot is primarily for working interactively. The exceptions are the pyplot commands :func:`~matplotlib.pyplot.figure`, :func:`~matplotlib.pyplot.subplot`, :func:`~matplotlib.pyplot.subplots`, and :func:`~pyplot.savefig`, which can greatly simplify scripting. Modules include: :mod:`matplotlib.axes` defines the :class:`~matplotlib.axes.Axes` class. Most pyplot commands are wrappers for :class:`~matplotlib.axes.Axes` methods. The axes module is the highest level of OO access to the library. :mod:`matplotlib.figure` defines the :class:`~matplotlib.figure.Figure` class. :mod:`matplotlib.artist` defines the :class:`~matplotlib.artist.Artist` base class for all classes that draw things. :mod:`matplotlib.lines` defines the :class:`~matplotlib.lines.Line2D` class for drawing lines and markers :mod:`matplotlib.patches` defines classes for drawing polygons :mod:`matplotlib.text` defines the :class:`~matplotlib.text.Text`, :class:`~matplotlib.text.TextWithDash`, and :class:`~matplotlib.text.Annotate` classes :mod:`matplotlib.image` defines the :class:`~matplotlib.image.AxesImage` and :class:`~matplotlib.image.FigureImage` classes :mod:`matplotlib.collections` classes for efficient drawing of groups of lines or polygons :mod:`matplotlib.colors` classes for interpreting color specifications and for making colormaps :mod:`matplotlib.cm` colormaps and the :class:`~matplotlib.image.ScalarMappable` mixin class for providing color mapping functionality to other classes :mod:`matplotlib.ticker` classes for calculating tick mark locations and for formatting tick labels :mod:`matplotlib.backends` a subpackage with modules for various gui libraries and output formats The base matplotlib namespace includes: :data:`~matplotlib.rcParams` a global dictionary of default configuration settings. It is initialized by code which may be overridden by a matplotlibrc file. :func:`~matplotlib.rc` a function for setting groups of rcParams values :func:`~matplotlib.use` a function for setting the matplotlib backend. If used, this function must be called immediately after importing matplotlib for the first time. In particular, it must be called **before** importing pyplot (if pyplot is imported). matplotlib was initially written by John D. Hunter (1968-2012) and is now developed and maintained by a host of others. Occasionally the internal documentation (python docstrings) will refer to MATLAB®, a registered trademark of The MathWorks, Inc. éN)ééa  Matplotlib 3.0+ does not support Python 2.x, 3.0, 3.1, 3.2, 3.3, or 3.4. Beginning with Matplotlib 3.0, Python 3.5 and above is required. See Matplotlib `INSTALL.rst` file for more information: https://github.com/matplotlib/matplotlib/blob/master/INSTALL.rst )ÚMutableMapping)Ú Parameter)ÚPathé)ÚcbookÚrcsetup)ÚMatplotlibDeprecationWarningÚdedentÚ get_labelÚsanitize_sequence)ÚmplDeprecation)Ú defaultParamsÚvalidate_backendÚcycler)Ú get_versionsÚversionz1.10.0aì@Article{Hunter:2007, Author = {Hunter, J. D.}, Title = {Matplotlib: A 2D graphics environment}, Journal = {Computing In Science \& Engineering}, Volume = {9}, Number = {3}, Pages = {90--95}, abstract = {Matplotlib is a 2D graphics package used for Python for application development, interactive scripting, and publication-quality image generation across user interfaces and operating systems.}, publisher = {IEEE COMPUTER SOC}, year = 2007 }cCslt|tƒr t dd¡| d¡}t|tƒr@t dd¡| d¡}|rdtj |¡}tj |¡}||kSdSdS)z.return True if a is greater than or equal to bz3.0z)compare_version arguments should be strs.ÚasciiFN)Ú isinstanceÚbytesrÚwarn_deprecatedÚdecodeÚ distutilsrZ LooseVersion)ÚaÚb©rú2lib/python3.7/site-packages/matplotlib/__init__.pyÚcompare_versions¯s      rzMatplotlib requires dateutilzMatplotlib requires pyparsingz2.0.1z1Matplotlib requires pyparsing>=2.0.1; you have %sz*Matplotlib requires numpy>=%s; you have %sÚargvZ modpythona+matplotlib.verbose is deprecated; Command line argument --verbose-LEVEL is deprecated. This functionality is now provided by the standard python logging library. To get more (or less) logging output: import logging logger = logging.getLogger('matplotlib') logger.set_level(logging.INFO)Úsilentú sys.stdoutcCs¼tjtjtjtjtjtjdœ}||}t ¡}||kr¸t |¡tjtj dœ}||kr`||}n:tj}yt |dƒ}Wn$t k r˜t   d |¡¡YnXt |¡}| |¡t |¡dS)z@ Use a --verbose-LEVEL level to set the logging level: )r ÚhelpfulÚdebugzdebug-annoyingÚinfoÚwarning)z sys.stdoutz sys.stderrÚwzBcould not open log file "{0}"for writing. Check your matplotlibrcN)ÚloggingZWARNINGÚINFOÚDEBUGÚ_logZgetEffectiveLevelZsetLevelÚsysÚstdoutÚstderrÚopenÚIOErrorÚwarningsÚwarnÚformatZ StreamHandlerZ addHandler)Ú level_strZfile_strZlevelmapZnewlevZoldlevÚstdÚfileoZconsolerrrÚ_set_logger_verbose_levelæs(     r6cCsFd}x$szVerbose.Nrz --verbose-r7z2.2)ÚmessagecCs| d¡tj|_dS)Nr )Ú set_levelr+r,r5)ÚselfrrrÚ__init__4s zVerbose.__init__cCs:|jdk r|j}||jkr0t d||jf¡n||_dS)z6set the verbosity to one of the Verbose.levels stringsNzEmatplotlib: unrecognized --verbose-* string "%s". Legal values are %s)Ú_commandLineVerboser9r0r1r?)rCr?rrrrB9s   zVerbose.set_levelcCs^tjtjdœ}||kr"|||_n8yt|dƒ}Wn"tk rRtd |¡ƒ‚YnX||_dS)N)z sys.stdoutz sys.stderrr&zgVerbose object could not open log file "{0}" for writing. Check your matplotlibrc verbose.fileo setting)r+r,r-r5r.r/Ú ValueErrorr2)rCÚfnamer4r5rrrÚ set_fileoEs  zVerbose.set_fileor"cCs | |¡rt||jddSdS)zƒ print message s to self.fileo if self.level>=level. Return value indicates whether a message was issued )ÚfileTF)ÚgeÚprintr5)rCÚsr?rrrÚreportWs zVerbose.reportTcs4tˆƒs t‚‡‡‡‡‡‡fdd„‰dˆ_ˆjˆ_ˆS)a8 return a callable function that wraps func and reports it output through the verbose handler if current verbosity level is higher than level if always is True, the report will occur on every function call; otherwise only on the first time the function is called cs4ˆ||Ž}ˆsˆjs0ˆ ˆ|ˆ¡}ˆjs0|ˆ_|S)N)Ú_spokerM)ÚargsÚkwargsÚretZspoke)ÚalwaysÚfmtÚfuncr?rCÚwrapperrrrUos   zVerbose.wrap..wrapperF)ÚcallableÚAssertionErrorrNÚ__doc__)rCrSrTr?rRr)rRrSrTr?rCrUrÚwrapcs z Verbose.wrapcCs|j|j|j|kS)z%return true if self.level is >= level)Úvaldr?)rCr?rrrrJ{sz Verbose.ge)r")r"T)Ú__name__Ú __module__Ú __qualname__rXr9Ú enumeraterZrEr+rr:r8r3rÚ deprecatedÚ _verbose_msgrDrBrHrMrYrJrrrrr<s$      r<Úignorecs<ˆdkrt tˆ¡Sd‰d‰t ˆ¡‡‡‡‡fdd„ƒ}|S)aL Decorator that logs a function's return value, and memoizes that value. After :: @_logged_cached(fmt) def func(): ... the first call to *func* will log its return value at the DEBUG level using %-format string *fmt*, and memoize it; later calls to *func* will directly return that value. NFcsˆsˆƒ‰d‰t ˆˆ¡ˆS)NT)r*r#r)ÚcalledrSrTrQrrrU™s  z_logged_cached..wrapper)Ú functoolsÚpartialÚ_logged_cachedÚwraps)rSrTrUr)rbrSrTrQrre†s   rec CshyHtjddgtjtjd}| ¡\}}| d¡ d¡d}| ¡d}|Stttfk rbdSXdS)NZdvipngz-version)r,r-rÚ réÿÿÿÿ) Ú subprocessÚPopenÚPIPEÚ communicaterÚsplitÚ IndexErrorrFÚOSError)rLr,r-ÚlineÚvrrrÚcheckdep_dvipng¥s    rrc Cs®tjdkr¢tjdkr"ddddg}ndg}xx|D]p}yPtj|dgtjtjd}| ¡\}}|jdkr€|dd …  d ¡}|t_|t_ Wq.t t t fk rœYq.Xq.Wtjtj fS) NÚwin32Zgswin32cZgswin64cZmgsZgsz --version)r,r-rrhr)Úcheckdep_ghostscriptÚ executabler+ÚplatformrirjrkrlÚ returncoderrrnrFro)Zgs_execsÚgs_execrLr,r-rqrrrrt²s"         rtc Cs|yZtjddgtjtjd}| ¡\}}| d¡ d¡}x |D]}d|kr<| ¡d}q`_. ZXDG_CONFIG_HOMEz.configN)rŠr‹Úgetr†rƒrrrrrÚ_get_xdg_config_dirBs r‘cCs&tj d¡p$tƒr"tttƒdƒƒSdS)z¨ Returns the XDG cache directory, according to the `XDG base directory spec `_. ZXDG_CACHE_HOMEz.cacheN)rŠr‹rr†rƒrrrrrÚ_get_xdg_cache_dirNs r’cCs¦tj d¡}|rt|ƒ ¡}n4tj d¡r:|r:t|dƒ}ntƒrNttƒdƒ}nd}|r y|j dddWnt k r|Yn$Xt  t |ƒtj ¡r | ¡r t |ƒStƒS)Nrˆ)ZlinuxZfreebsdÚ matplotlibz .matplotlibT)ÚparentsÚexist_ok)rŠr‹rrZresolver+rvr8r†ÚmkdirroÚaccessrƒÚW_OKÚis_dirr)Zxdg_baserŽrrrÚ_get_config_or_cache_dirZs   ršz CONFIGDIR=%scCs ttƒƒS)a Return the string representing the configuration directory. The directory is chosen as follows: 1. If the MPLCONFIGDIR environment variable is supplied, choose that. 2a. On Linux, follow the XDG specification and look first in `$XDG_CONFIG_HOME`, if defined, or `$HOME/.config`. 2b. On other platforms, choose `$HOME/.matplotlib`. 3. If the chosen directory exists and is writable, use that as the configuration directory. 4. If possible, create a temporary directory, and use it as the configuration directory. 5. A writable directory could not be found or created; return None. )ršr‘rrrrÚ get_configdirqsr›z CACHEDIR=%scCs ttƒƒS)z¾ Return the location of the cache directory. The procedure used to find the directory is the same as for _get_config_dir, except using `$XDG_CACHE_HOME`/`~/.cache` instead. )ršr’rrrrÚ get_cachedir…srœcCs`dtjkr,tjd}tj |¡s(tdƒ‚|Sdd„}x|ƒD]}| ¡r.get_candidate_pathsz(Could not find the matplotlib data filesN)rŠr‹r¡ÚisdirÚ RuntimeErrorr™rƒ)r¡r¢rrrÚ_get_data_paths     r¥zmatplotlib data path: %scCs*tdddkrtƒtdd<tddS)NÚdatapathr)rr¥rrrrÚ get_data_path¯sr§cCsZttƒƒ}i}x>ttj| d¡ƒD](}| t|j |j¡ƒg¡  t|ƒ¡q"Wt |  ¡ƒS)Nz**/*) rr§ÚfilterÚis_fileZglobÚ setdefaultrƒr Z relative_toÚappendÚlistÚitems)Z data_pathÚdr¡rrrÚget_py2exe_datafiles¶s  r¯cCsJdd„}x<|ƒD]2}tj |¡rt |¡j}t |¡s@t |¡rPqW|S)aØ Get the location of the config file. The file location is determined in the following order - `$PWD/matplotlibrc` - `$MATPLOTLIBRC` if it is a file (or a named pipe, which can be created e.g. by process substitution) - `$MATPLOTLIBRC/matplotlibrc` - `$MPLCONFIGDIR/matplotlibrc` - On Linux, - `$XDG_CONFIG_HOME/matplotlib/matplotlibrc` (if $XDG_CONFIG_HOME is defined) - or `$HOME/.config/matplotlib/matplotlibrc` (if $XDG_CONFIG_HOME is not defined) - On other platforms, - `$HOME/.matplotlib/matplotlibrc` if `$HOME` is defined. - Lastly, it looks in `$MATPLOTLIBDATA/matplotlibrc` for a system-defined copy. cssvtj t ¡d¡Vytjd}Wntk r6YnX|Vtj |d¡Vtj tƒd¡Vtj tƒd¡VdS)NÚ matplotlibrcZ MATPLOTLIBRC)rŠr¡ÚjoinÚgetcwdr‹ÚKeyErrorr›r§)r°rrrÚgen_candidatesÞsz(matplotlib_fname..gen_candidates)rŠr¡ÚexistsÚstatÚst_modeÚS_ISREGÚS_ISFIFO)r´rGr·rrrÚmatplotlib_fname¿s   rº)z2.1N)z2.2zfigure.facecolor)z2.2N)z3.0N)ztext.dvipnghackznbagg.transparentzplugins.directoryz pgf.debug)z2.1)z2.2)z3.0)z axes.holdz backend.qt4z backend.qt5ztext.latex.unicodec@sØeZdZdZdd„e ¡DƒZee  d¡dd„ƒƒZ ee  d¡dd„ƒƒZ ee  d¡d d „ƒƒZ ee  d¡d d „ƒƒZ ee  d¡d d„ƒƒZdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd „Zd!S)"ÚRcParamsz› A dictionary object including validation validating functions are defined and associated with rc parameters in :mod:`matplotlib.rcsetup` cCs"i|]\}\}}|tkr||“qSr)Ú_all_deprecated)r=ÚkeyÚdefaultÚ converterrrrr@s zRcParams.z3.0cCsdS)Nz=%s is deprecated and replaced with %s; please use the latter.r)rCrrrÚmsg_deprszRcParams.msg_deprcCsdS)Nz-%s is deprecated and ignored. Use %s instead.r)rCrrrÚmsg_depr_ignore!szRcParams.msg_depr_ignorecCsdS)NzM%s is deprecated. Please remove it from your matplotlibrc and/or style files.r)rCrrrÚ msg_depr_set&szRcParams.msg_depr_setcCsdS)NzK%s is obsolete. Please remove it from your matplotlibrc and/or style files.r)rCrrrÚ msg_obsolete,szRcParams.msg_obsoletecCsdS)Nz¬The {} rcParam was deprecated in version 2.2. In order to force the use of a specific Qt binding, either import that binding first, or set the QT_API environment variable.r)rCrrrÚmsg_backend_obsolete2szRcParams.msg_backend_obsoletecOs|j||ŽdS)N)Úupdate)rCrOrPrrrrD:szRcParams.__init__c Csfy:|tkr sz$RcParams.find_all..)ÚreÚcompiler»r­)rCÚpatternr)rírÚfind_all”s  zRcParams.find_allcs‡fdd„ˆDƒS)Ncsi|]}t ˆ|¡|“qSr)rÒrÙ)r=Úk)rCrrr@¥sz!RcParams.copy..r)rCr)rCrÚcopy¤sz RcParams.copyN)r[r\r]rXrr­rÑÚpropertyrr_rÀrÁrÂrÃrÄrDrÓrÙrãrærérêròrôrrrrr»s, )r»FcCsDtƒ}tj |¡s:d}tdd„t ¡Dƒƒ}t |¡|St ||ƒS)z\Return a :class:`matplotlib.RcParams` instance from the default matplotlib rc file. z*could not find rc file; returning defaultscSs$g|]\}\}}|tkr||f‘qSr)r¼)r=r½r¾Ú_rrrú °s zrc_params..) rºrŠr¡rµr»rr­r0r1Úrc_params_from_file)Ú fail_on_errorrGrArQrrrÚ rc_params¨s  rúz'http://|https://|ftp://|file://|file:\\cCst |¡dk S)z8Return True if string is an http, ftp, or file URL path.N)Ú URL_REGEXÚmatch)ÚfilenamerrrÚis_url¼srþc csxt|ƒr2tj |¡}dd„|DƒVWdQRXnBtj |¡}tjdd}|dkrVd}t ||d }|VWdQRXdS)Ncss|]}| d¡VqdS)zutf-8N)r)r=rprrrrîÅsz$_open_file_or_url..F)Ú do_setlocalezutf-8)Úencoding) rþÚurllibZrequestZurlopenrŠr¡Ú expanduserÚlocaleÚgetpreferredencodingr.)rGÚfrrrrÚ_open_file_or_urlÁs  rzline #%d "%s" in file "%s"c Csdd}i}t|ƒæ}yªx¤|D]œ}|d7}| dd¡d ¡}|s@q| dd¡}t|ƒdkrvt|||f}t d|¡q|\} } |  ¡} |  ¡} | |kr¨t d||f¡| ||f|| <qWWn4tk rðt d|tj d d pâd f¡‚YnXWd QRXt ƒ} xŒd D]„} | |kr|  | ¡\} }}|r6| | | <nTy | | | <WnFt k rˆ} z&t|||f}t d| || f¡Wd d } ~ XYnXqWxÎ|  ¡D]Â\} \} }}| tkr|rÂ| | | <nTy | | | <WnFt k r} z&t|||f}t d| || f¡Wd d } ~ XYnXnB| tkrBt| \} }tj| | |ddntd| ||ftjdqšW| S)zèReturn :class:`matplotlib.RcParams` from the contents of the given file. Unlike `rc_params_from_file`, the configuration class only contains the parameters specified in the file (i.e. default values are not filled in). rrú#ú:éz Illegal %sz$Duplicate key in file "%s", line #%dzSCannot decode configuration file %s with encoding %s, check LANG and LC_* variablesF)rÿzutf-8 (default)N)z verbose.levelz verbose.fileozBad val "%s" on %s %sz Please update your matplotlibrc.)rÈrÌzÏ Bad key "%s" on line %d in %s. You probably need to get an updated matplotlibrc file from http://github.com/matplotlib/matplotlib/blob/master/matplotlibrc.template or from the matplotlib source distribution)rI)rrmÚstripràÚ_error_details_fmtr0r1ÚUnicodeDecodeErrorrrr»Úpopr…r­rrÏrrrKr+r-)rGrùZcntZrc_tempÚfdrpZ strippedlineÚtupZ error_detailsr½rÔÚconfigÚmsgrrÕrrrÚ_rc_params_in_fileÒst          &   "    rTc Cs t||ƒ}|s|St ¡}t ¡$t dt¡tdd„|Dƒƒ}WdQRX| |¡|ddkrlt ƒ|d<d  |d¡rt   dd   |d¡¡t   d |¡|S) aReturn :class:`matplotlib.RcParams` from the contents of the given file. Parameters ---------- fname : str Name of file parsed for matplotlib settings. fail_on_error : bool If True, raise an error when the parser fails to convert a parameter. use_default_template : bool If True, initialize with default parameters before updating with those in the given file. If False, the configuration class only contains the parameters specified in the file. (Useful for updating dicts.) racSs$g|]\}\}}|tkr||f‘qSr)r¼)r=r½r¾rörrrr÷6s z'rc_params_from_file..Nr¦rÉztext.latex.preamblea  ***************************************************************** You have the following UNSUPPORTED LaTeX preamble customizations: %s Please do not ask for support with these customizations active. ***************************************************************** rgzloaded rc file %s)rrr­r0rçrèr r»rÅr§r±r*r$r#)rGrùZuse_default_templateZconfig_from_fileZ iter_paramsrrrrrø s       røzexamples.directorycCs$g|]\}\}}|tkr||f‘qSr)r¼)r=r½r¾r¿rrrr÷`s r÷zps.usedistillerz text.usetexzaxes.formatter.use_localerÉc Ksšddddddddœ}t|tƒr$|f}xp|D]h}xb| ¡D]V\}}| |¡pL|}d ||f}y |t|<Wq8tk rŒtd |||fƒ‚Yq8Xq8Wq*Wd S) aà Set the current rc params. *group* is the grouping for the rc, e.g., for ``lines.linewidth`` the group is ``lines``, for ``axes.facecolor``, the group is ``axes``, and so on. Group may also be a list or tuple of group names, e.g., (*xtick*, *ytick*). *kwargs* is a dictionary attribute name/value pairs, e.g.,:: rc('lines', linewidth=2, color='r') sets the current rc params and is equivalent to:: rcParams['lines.linewidth'] = 2 rcParams['lines.color'] = 'r' The following aliases are available to save typing for interactive users: ===== ================= Alias Property ===== ================= 'lw' 'linewidth' 'ls' 'linestyle' 'c' 'color' 'fc' 'facecolor' 'ec' 'edgecolor' 'mew' 'markeredgewidth' 'aa' 'antialiased' ===== ================= Thus you could abbreviate the above rc command as:: rc('lines', lw=2, c='r') Note you can use python's kwargs dictionary facility to store dictionaries of default parameters. e.g., you can customize the font rc as follows:: font = {'family' : 'monospace', 'weight' : 'bold', 'size' : 'larger'} rc('font', **font) # pass in the font dict as kwargs This enables you to easily switch between several configurations. Use ``matplotlib.style.use('default')`` or :func:`~matplotlib.rcdefaults` to restore the default rc params after changes. Z linewidthZ linestyleZcolorZ facecolorZ edgecolorZmarkeredgewidthZ antialiased)ZlwZlsÚcZfcZecZmewZaaz%s.%sz2Unrecognized key "%s" for group "%s" and name "%s"N)rrƒr­rÚrcParamsr³)ÚgrouprPÚaliasesÚgrórqrËr½rrrÚrcms$3    rc sTt ¡Bt dt¡ddlm‰t ¡t ‡fdd„t   ¡Dƒ¡WdQRXdS)a¹ Restore the rc params from Matplotlib's internal default style. Style-blacklisted rc params (defined in `matplotlib.style.core.STYLE_BLACKLIST`) are not updated. See Also -------- rc_file_defaults : Restore the rc params from the rc file originally loaded by Matplotlib. matplotlib.style.use : Use a specific style file. Call ``style.use('default')`` to restore the default style. rar)ÚSTYLE_BLACKLISTcsi|]\}}|ˆkr||“qSrr)r=rórq)rrrr@Ëszrcdefaults..N) r0rçrèrÚ style.corerrÚclearrÅÚrcParamsDefaultr­rr)rrÚ rcdefaults¶s    rc sHt ¡6t dt¡ddlm‰t ‡fdd„tDƒ¡WdQRXdS)zº Restore the rc params from the original rc file loaded by Matplotlib. Style-blacklisted rc params (defined in `matplotlib.style.core.STYLE_BLACKLIST`) are not updated. rar)rcsi|]}|ˆkrt||“qSr)Ú rcParamsOrig)r=ró)rrrr@Ûsz$rc_file_defaults..N) r0rçrèrrrrrÅrrr)rrÚrc_file_defaultsÏs   rc sRt ¡@t dt¡ddlm‰t|ƒ‰t ‡‡fdd„ˆDƒ¡WdQRXdS)z Update rc params from file. Style-blacklisted rc params (defined in `matplotlib.style.core.STYLE_BLACKLIST`) are not updated. rar)rcsi|]}|ˆkrˆ||“qSrr)r=ró)rÚ rc_from_filerrr@ìszrc_file..N) r0rçrèrrrrørrÅ)rGr)rr rÚrc_fileßs   r!c@s2eZdZdZd dd„Zdd„Zdd„Zd d „ZdS) Ú rc_contexta¿ Return a context manager for managing rc settings. This allows one to do:: with mpl.rc_context(fname='screen.rc'): plt.plot(x, a) with mpl.rc_context(fname='print.rc'): plt.plot(x, b) plt.plot(x, c) The 'a' vs 'x' and 'c' vs 'x' plots would have settings from 'screen.rc', while the 'b' vs 'x' plot would have settings from 'print.rc'. A dictionary can also be passed to the context manager:: with mpl.rc_context(rc={'text.usetex': True}, fname='screen.rc'): plt.plot(x, a) The 'rc' dictionary takes precedence over the settings loaded from 'fname'. Passing a dictionary only is also valid. For example a common usage is:: with mpl.rc_context(rc={'interactive': False}): fig, ax = plt.subplots() ax.plot(range(3), range(3)) fig.savefig('A.png', format='png') plt.close(fig) NcCsLt ¡|_y|rt|ƒ|r&t |¡Wntk rF| ¡‚YnXdS)N)rrôÚ_origr!rÅr…Ú_rc_context__fallback)rCrrGrrrrDs zrc_context.__init__cCs4|jd}t t|j¡|jdtjkr0|td<dS)NrÊ)r#rÒrÅrr rÐ)rCZupdated_backendrrrZ __fallback"s zrc_context.__fallbackcCs|S)Nr)rCrrrÚ __enter__+szrc_context.__enter__cCs | ¡dS)N)r$)rCÚexc_typeÚ exc_valueZexc_tbrrrÚ__exit__.szrc_context.__exit__)NN)r[r\r]rXrDr$r%r(rrrrr"ðs   r"cCsht|ƒ}t td¡|krnJdtjkrT|s:|r:tjddd|rdddlm }||ƒn|td<t d<dS) a. Set the matplotlib backend to one of the known backends. Parameters ---------- arg : str The backend to switch to. This can either be one of the 'standard' backend names: - interactive backends: GTK3Agg, GTK3Cairo, MacOSX, nbAgg, Qt4Agg, Qt4Cairo, Qt5Agg, Qt5Cairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo - non-interactive backends: agg, cairo, pdf, pgf, ps, svg, template or a string of the form: ``module://my.module.name``. Note: Standard backend names are case-insensitive here. warn : bool, optional If True, warn if this is called after pyplot has been imported and a backend is set up. defaults to False. force : bool, optional If True, attempt to switch the backend. An ImportError is raised if an interactive backend is selected, but another interactive backend has already started. This defaults to True. See Also -------- :ref:`backends` matplotlib.get_backend rÊzmatplotlib.pyplotzJmatplotlib.pyplot as already been imported, this call will have no effect.r )Ú stacklevelr)rÚN) rrÒrÙrr+Úmodulesr0r1Zmatplotlib.pyplotrÚr)r:r1ZforcerËrÚrrrÚuse2s&   r+Z MPLBACKENDrÊcCstdS)z_ Return the name of the current backend. See Also -------- matplotlib.use rÊ)rrrrrÚ get_backend|sr,cCs |td<dS)zz Set interactive mode to boolean b. If b is True, then draw after every plotting command, e.g., after xlabel Ú interactiveN)r)rrrrr-‡sr-cCstdS)z'Return true if plot mode is interactiver-)rrrrrÚis_interactivesr.cCstddkrdStdS)zÃReturn true if focus maintenance under TkAgg on win32 is on. This currently works only for python.exe and IPython.exe. Both IDLE and Pythonwin.exe fail badly when tk_window_focus is on.rÊZTkAggFztk.window_focus)rrrrrÚtk_window_focus•s r/zmatplotlib.testszmatplotlib.sphinxext.testszmpl_toolkits.testscCsÀddl}tjdkr8dtjkr(dkr8nn | ¡dksHddl}| ¡d}ddlm}|j|ksl|j dkrt   d   ||j|j dkrˆd nd ¡¡y ddl }Wntk rºtd ƒ‚YnXdS) Nrrs)ré)rr0éZCPythonz2.6.1)Úft2fontZlocalaMatplotlib is not built with the correct FreeType version to run tests. Set local_freetype=True in setup.cfg and rebuild. Expect many image comparison failures below. Expected freetype version {0}. Found freetype version {1}. Freetype build type is {2}localrÉznot z'matplotlib.test requires pytest to run.)rvr+Ú version_infoZpython_implementationÚ faulthandlerÚenabler“r2Z__freetype_version__Z__freetype_build_type__r0r1r2ÚpytestÚ ImportErrorrK)rvr4ZLOCAL_FREETYPE_VERSIONr2r6rrrÚ _init_tests¥s(      r8c s.tƒtj tj tj t¡d¡¡s,tdƒ‚tƒ}t   ¡}zÂt dƒ|rRt   |¡ddl }| dg¡}d} d} x>|D]6‰t‡fdd „tDƒƒr”d } Ptj ˆ¡rtd } d } PqtW| r¼|d g7}| rÈ|t7}|rÖ|d g7}|rì|d d|g7}|j|f|Ž} Wd| ¡dkrt ||d|r(t   |¡X| S)zrun the matplotlib test suiteZtestsz%Matplotlib test data is not installedZaggrNrTc3s|]}ˆ |¡VqdS)N)r8)r=Z module_path)r:rrrîÞsztest..Fz--pyargsz--covú-rq)r1)r8rŠr¡r£r±Údirnameržr7r,r+Úgetrecursionlimitr+Úsetrecursionlimitr6r ÚanyÚdefault_test_modulesrµÚmainÚlower) Ú verbosityZcoverageZswitch_backend_warnZrecursionlimitrPZ old_backendZold_recursionlimitr6rOZprovide_default_modulesZ use_pyargsZretcoder)r:rÚtestËsH          rBcCs4t|tƒs|Sy t||ƒStk r.|SXdS)zhEither returns data[key] or passes data back. Also converts input data to a sequence as needed. N)rrƒr r³)Údatar½rrrÚ _replacerþs   rDaa .. note:: In addition to the above described arguments, this function can take a **data** keyword argument. If such a **data** argument is given, the following arguments are replaced by **data[]**: {replaced} Objects passed as **data** must support item access (``data[]``) and membership test (`` in data``). cCsj|dkrd}nt|ƒ}d}|dkr(d}n2t|ƒdkr8d}|rD|d7}|jd t|ƒ¡d}|tj|d S) a$Add documentation for a *data* field to the given docstring. Parameters ---------- docstring : str The input docstring. replace_names : list of strings or None The list of parameter names which arguments should be replaced by `data[name]`. If None, all arguments are replaced if they are included in `data`. replace_all_args : bool If True, all arguments in *args get replaced, even if they are not in replace_names. Returns ------- The augmented docstring. NrÉz+* All positional and all keyword arguments.rz4* All arguments with the following names: '{names}'.z * All positional arguments.z', ')Únames)Zreplaced)r ràr2r±råÚ_DATA_DOC_APPENDIX)Z docstringÚ replace_namesÚreplace_all_argsZ_replrrrÚ _add_data_docs rIcs&ˆdk rtˆƒ‰‡‡‡‡fdd„}|S)aÔ A decorator to add a 'data' kwarg to any a function. The signature of the input function must include the ax argument at the first position :: def foo(ax, *args, **kwargs) so this is suitable for use with Axes methods. Parameters ---------- replace_names : list of strings, optional, default: None The list of parameter names which arguments should be replaced by `data[name]`. If None, all arguments are replaced if they are included in `data`. replace_all_args : bool, default: False If True, all arguments in *args get replaced, even if they are not in replace_names. label_namer : string, optional, default: None The name of the parameter which argument should be used as label, if label is not set. If None, the label keyword argument is not set. positional_parameter_names : list of strings or callable, optional The full list of positional parameter names (excluding an explicit `ax`/'self' argument at the first place and including all possible positional parameter in `*args`), in the right order. Can also include all other keyword parameter. Only needed if the wrapped function does contain `*args` and (replace_names is not None or replace_all_args is False). If it is a callable, it will be called with the actual tuple of *args and the data and should return a list like above. NOTE: callables should only be used when the names and order of *args can only be determined at runtime. Please use list of names when the order and names of *args is clear before runtime! .. note:: decorator also converts MappingView input data to list. Nc s,t ˆ¡}d}d}g}t|j ¡ƒ}x<|D]4}|jtjkr@d}q*|jtjkrRd}q*|  |j ¡q*Wtdtj dd}|r„|  d|¡n |  |¡|j |d}d‰|s°|dd…‰n¶ˆdkr¾d‰n¨tˆƒdkrÐg‰n–t|ƒdkr&ˆdkr&tˆt|dd…ƒƒdkr|dd…‰ntd  ˆj¡ƒ‚n@ˆdk rJtˆƒrDd‰g‰nˆ‰nˆrVg‰ntd  ˆj¡ƒ‚d ‰d ‰ˆr¢ˆr¢ˆˆkr¢ˆ ˆ¡‰d ˆkr¢ˆ d ¡‰ˆræˆsæ|sæˆsÊtd  ˆ¡ƒ‚nˆˆkrætd ˆˆ¡ƒ‚nt ˆ¡ddœ‡‡‡‡‡‡‡‡‡f dd„ ƒ} t| jˆˆƒ| _|| _| S)NFTrC)r¾rh)Ú parametersrrzeGot unknown 'replace_names' and wrapped function {!r} uses '*args', need 'positional_parameter_names'zqGot 'replace_names' and wrapped function {!r} uses *args, need 'positional_parameter_names' or 'replace_all_args'i'ÚlabelzUlabel_namer {!r} can't be found as the parameter without 'positional_parameter_names'zLlabel_namer {!r} can't be found in the parameter names (known argnames: %s).)rCcsÀˆ}ˆ}ˆ‰d}ˆdkr.tdd„|Dƒƒ}nˆrhˆ|ˆƒ‰ˆrhˆrhˆˆkrhˆ ˆ¡}dˆkrhˆ d¡}|t|ƒkr~||}n | ˆd¡}t|tƒs˜d}ˆ dks¨ˆ dkrÄt‡fdd„t|ƒDƒƒ}n6tˆƒt|ƒkrÜtdƒ‚t‡‡‡ fdd„t|ƒDƒƒ}ˆ dkr‡fdd „| ¡Dƒ}n‡‡ fd d „| ¡Dƒ}t|ƒ|kpHd|k}ˆr°|s°|t|ƒkrxt |||ƒ|d<n8ˆ|kr–t |ˆ|ƒ|d<nt j d ˆˆj ft d d ˆ|f|ž|ŽS)Ncss|]}t|ƒVqdS)N)r )r=rrrrrîÑszA_preprocess_data..param..inner..rKTc3s|]\}}tˆ|ƒVqdS)N)rD)r=Újr)rCrrrîêsz#Got more args than function expectsc3s,|]$\}}ˆ|ˆkr tˆ|ƒn|VqdS)N)rD)r=rLr)Ú _arg_namesrCrGrrrîòscsi|]\}}tˆ|ƒ|“qSr)rD)r=rórq)rCrrr@øszB_preprocess_data..param..inner..cs(i|] \}}|ˆkrtˆ|ƒn||“qSr)rD)r=rórq)rCrGrrr@ûsz™Tried to set a label via parameter %r in func %r but couldn't find such an argument. (This is a programming error, please report to the Matplotlib list!)r )r))ÚtupleÚindexràrrrƒr^r¤r­r r0r1r[ÚRuntimeWarning)ZaxrCrOrPZ _label_posZ_label_namer_posrKZuser_supplied_label) Ú arg_namesÚarg_names_at_runtimerTÚ label_namerÚlabel_namer_posÚ label_posÚpositional_parameter_namesrHrG)rMrCrÚinnerÄsV               z._preprocess_data..param..inner)ÚinspectZ signaturer¬rJÚvaluesZkindrZVAR_POSITIONALZ VAR_KEYWORDr«rËZ KEYWORD_ONLYÚinsertÚreplaceràÚsetrWr2r[rVrOrcrfrIrXZ __signature__) rTZsigZ _has_varargsZ_has_varkwargsrMZparamsÚpZ data_paramZnew_sigrW)rSrVrHrG)rQrRrTrTrUrÚparamfs|                  $O z_preprocess_data..param)r\)rGrHrSrVr^r)rSrVrHrGrÚ_preprocess_data>s %4r_zmatplotlib version %szinteractive is %szplatform is %szloaded modules: %s)r r!)N)F)F)FT)FT)NFTr)NFNN)ŒrXr+r3r7rŒZcollections.abcrÚ contextlibZdistutils.versionrrcÚioÚ importlibrXrrr'rŠZpathlibrrárïrr¶rir‰Zurllib.requestrr0rÉrr Zmatplotlib.cbookr r r r rZmatplotlib.rcsetuprrrZnumpyZ_versionrrƒÚ __version__Z getLoggerr[r*Z__version__numpy__Z __bibtex__rZdateutilZ pyparsingÚhasattrrr`r6r;Úobjectr<rçrèÚverbosererrrtrurr{r|r€r‚r†rr‘r’ršr›rœr¥r§r¯rºrÍrÏrÎr¼rÒr»rúrðrûrþÚcontextmanagerrr rrørrÙr¡ÚisabsrmZ_basedirZ_fnameÚrealpathr±Z _fullpathrôrr­rÚ setlocaleÚLC_ALLrrrr!r"r+r‹rr,r-r.r/r>r8rBZ__test__rDrFrIr_r#rvr¬r*rrrrÚes*             #c    "      7   N +     IB F   & /# ]