m[c@`sdZddlmZmZmZddlZddlmZmZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlmZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZmZddl Z!ddl"Z"ddl#m$Z$m%Z%dd l#m&Z&m'Z'd Z(e$d d e)fd YZ*e$d de*fdYZ+e$d de*fdYZ,e$d de*fdYZ-e$d de*fdYZ.e$d de*fdYZ/de)fdYZ0dZ1de)fdYZ2de3fdYZ4de5fd YZ6d!Z7d"Z8d#e)fd$YZ9e$d d%Z:d&Z;e$d d'Z<e$d d(Z=d)Z>d*Z?d+Z@e$d d,ZAd-ZBd.eCdd/ZEe jFd0dd1ZGd2ZHd3ZIeJd4ZKeHd5ZLe$d d6d7e)fd8YZMe$d d9eNfd:YZOe$d d;d<ZPe$d d=e)fd>YZQd?d@ZRdAe)fdBYZSeSZTe$d dCZUe$d dDe)fdEYZVe$d dFZWe$d dGdHdIZXejYdJZZiZ[dKZ\dLdddMZ]e$d dNZ^e$d dOdPZ_e$d ddQZ`e$d dRZae$d dSZbe$d dTZce$d dUZddVeNfdWYZedXe)fdYYZfe$d eCdZZge$d d[Zhe$d d\Zidd]Zjd^Zkd_Zle$d d`ZmeCdaZnejoeCdbZpdce)fddYZqdeZre$d dGdfdgZsdhZtdiddeCdjZue$d eJdkZvidldm6dndo6dpdq6drds6ZwdtejxewDZye$dudvZzdwZ{dxZ|dyZ}dzZ~d{Zd|d}Zd~e)fdYZde)fdYZdZdZdZidd6ed6ed6ed6ed6ZdZdZdZdddddZdZdZde)fdYZde)fdYZde)fdYZe jedejddZdZdZe jFdZdS(s A collection of utility functions and classes. Originally, many (but not all) were from the Python Cookbook -- hence the name cbook. This module is safe to import from anywhere within matplotlib; it imports matplotlib only at runtime. i(tabsolute_importtdivisiontprint_functionN(txrangetzip(trepeat(treftWeakKeyDictionaryi(t deprecatedtwarn_deprecated(tmplDeprecationtMatplotlibDeprecationWarningcC`st|try/tjtjdj}|s=d}nWn tt t fk r`d}nX|dkrzt j |St j ||Sn|S(Nsaxes.formatter.use_locale( t isinstancetbytestlocaletgetpreferredencodingt matplotlibtrcParamststriptNonet ValueErrort ImportErrortAttributeErrortsixt text_type(tstpreferredencoding((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt unicode_safe)s    s2.1t convertercB`s/eZdZdddZdZdZRS(s[ Base class for handling string -> python type with support for missing values tNullcC`s||_||_dS(N(tmissingt missingval(tselfRR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__init__Hs cC`s||jkr|jS|S(N(RR(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__call__LscC`s|j p||jkS(N(RR(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt is_missingQsN(t__name__t __module__t__doc__RR!R"R#(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRBs ttostrcB`seZdZdddZRS(sconvert to string or NoneRtcC`stj|d|d|dS(NRR(RR!(R RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!Xs(R$R%R&R!(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR'Ust todatetimecB`s)eZdZddddZdZRS(sconvert to a datetime or Nones%Y-%m-%dRcC`s tj|||||_dS(s8use a :func:`time.strptime` format string for conversionN(RR!tfmt(R R*RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!_scC`s<|j|r|jStj||j}tj|d S(Ni(R#RttimetstrptimeR*tdatetime(R Rttup((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"dsN(R$R%R&RR!R"(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR)\sttodatecB`s)eZdZddddZdZRS(sconvert to a date or Nones%Y-%m-%dRcC`s tj|||||_dS(s8use a :func:`time.strptime` format string for conversionN(RR!R*(R R*RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!nscC`s<|j|r|jStj||j}tj|d S(Ni(R#RR+R,R*R-tdate(R RR.((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"ssN(R$R%R&RR!R"(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR/ksttofloatcB`s&eZdZdddZdZRS(sconvert to a float or NoneRcC`stj||||_dS(N(RR!R(R RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!}scC`s |j|r|jSt|S(N(R#Rtfloat(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"sN(R$R%R&RR!R"(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR1zsttointcB`s&eZdZdddZdZRS(sconvert to an int or NoneRcC`stj||dS(N(RR!(R RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!scC`s |j|r|jSt|S(N(R#Rtint(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"sN(R$R%R&RR!R"(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR3st_BoundMethodProxycB`s_eZdZdZdZdZdZdZdZdZ dZ d Z RS( s Our own proxy object which enables weak references to bound and unbound methods and arbitrary callables. Pulls information about the function, class, and instance out of a bound method. Stores a weak reference to the instance to support garbage collection. @organization: IBM Corporation @copyright: Copyright (c) 2005, 2006 IBM Corporation @license: The BSD License Minor bugfixes by Michael Droettboom cC`st||_g|_yy@tjrBt|j|j|_nt|j |j|_Wnt k rwd|_nXtjr|j |_ |jj|_n|j|_ |j|_Wn,tk rd|_||_ d|_nXdS(N(thasht_hasht_destroy_callbacksRtPY3Rt__self__t_destroytinsttim_selft TypeErrorRt__func__tfunct __class__tklasstim_functim_classR(R tcb((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!s$          cC`s|jjt|dS(N(R8tappendR5(R tcallback((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytadd_destroy_callbackscC`s:x3|jD](}y||Wq tk r1q Xq WdS(N(R8tReferenceError(R twkRG((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR;s  cC`s9|jj}|d}|dk r5||d>> def oneat(x): ... print('eat', x) >>> def ondrink(x): ... print('drink', x) >>> from matplotlib.cbook import CallbackRegistry >>> callbacks = CallbackRegistry() >>> id_eat = callbacks.connect('eat', oneat) >>> id_drink = callbacks.connect('drink', ondrink) >>> callbacks.process('drink', 123) drink 123 >>> callbacks.process('eat', 456) eat 456 >>> callbacks.process('be merry', 456) # nothing will be called >>> callbacks.disconnect(id_eat) >>> callbacks.process('eat', 456) # nothing will be called In practice, one should always disconnect all callbacks when they are no longer needed to avoid dangling references (and thus memory leaks). However, real code in matplotlib rarely does so, and due to its design, it is rather difficult to place this kind of code. To get around this, and prevent this class of memory leaks, we instead store weak references to bound methods only, so when the destination object needs to die, the CallbackRegistry won't keep it alive. The Python stdlib weakref module can not create weak references to bound methods directly, so we need to create a proxy object to handle weak references to bound methods (or regular free functions). This technique was shared by Peter Parente on his `"Mindtrove" blog `_. Parameters ---------- exception_handler : callable, optional If provided must have signature :: def handler(exc: Exception) -> None: If not None this function will be called with any `Exception` subclass raised by the callbacks in `CallbackRegistry.process`. The handler may either consume the exception or re-raise. The callable must be pickle-able. The default handler is :: def h(exc): traceback.print_exc() cC`s+||_t|_d|_i|_dS(Ni(texception_handlertdictt callbackst_cidt _func_cid_map(R Ra((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!8s   cC`si|jd6S(NRa(Ra(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRNFscC`s|j|dS(N(R!(R tstate((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRPIscC`s|jj|tt|}||j|krD|j||S|j|j|jd7_|j}||j||<|jj|t||j||<|S(sCRegister *func* to be called when signal *s* is generated. i( Ret setdefaultRR5RHt _remove_proxyRdRcRb(R RR@tproxytcid((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytconnectLs  cC`sxttj|jD]f\}}y|j|||=Wntk rNnXt|j|dkr|j|=|j|=qqWdS(Ni(tlistRt iteritemsReRctKeyErrortlen(R Ritsignaltproxies((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRh^s%  cC`sxttj|jD]\}}y ||=Wntk rFqqXxbttj|jD]H\}}x9ttj|D]"\}}||kr||=qqWq`WdSqWdS(sCDisconnect the callback registered with callback id *cid*. N(RlRRmRcRnRe(R Rjt eventnamet callbackdRpt functionstfunctiontvalue((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt disconnectis%  " cO`s||jkrxttj|j|D]r\}}y|||Wq,tk ri|j|q,tk r}|jdk r|j|qq,Xq,WndS(s Process signal *s*. All of the functions registered to receive callbacks on *s* will be called with ``*args`` and ``**kwargs``. N( RcRlRRmRIRhRVRaR(R RRSRTRjRiR^((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytprocessys) ( R$R%R&R_R!RNRPRkRhRwRx(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR`s7     t silent_listcB`s>eZdZddZdZdZdZdZRS(s override repr when returning a list of matplotlib artists to prevent long, meaningless output. This is meant to be used for a homogeneous list of a given type cC`s)||_|dk r%|j|ndS(N(ttypeRtextend(R Rztseq((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!s  cC`sdt||jfS(Ns(RoRz(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__repr__scC`s t|S(N(trepr(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__str__scC`si|jd6|d6S(NRzR|(Rz(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRNscC`s"|d|_|j|ddS(NRzR|(RzR{(R Rf((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRPs N( R$R%R&RR!R}RRNRP(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRys     tIgnoredKeywordWarningcB`seZdZRS(se A class for issuing warnings about keyword arguments that will be ignored by matplotlib (R$R%R&(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRscG`se|}xX|D]P}|j|d}|dk r |dkrF|}q]tjd|tq q W|S(s Enforces the priority of a local variable over potentially conflicting argument(s) from a kwargs dict. The following possible output values are considered in order of priority: local_var > kwargs[keys[0]] > ... > kwargs[keys[-1]] The first of these whose value is not None will be returned. If all are None then None will be returned. Each key in keys will be removed from the kwargs dict in place. Parameters ---------- local_var: any object The local variable (highest priority) kwargs: dict Dictionary of keyword arguments; modified in place keys: str(s) Name(s) of keyword arguments to process, in descending order of priority Returns ------- out: any object Either local_var or one of kwargs[key] for key in keys Raises ------ IgnoredKeywordWarning For each key in keys that is removed from kwargs but not used as the output value s%"%s" keyword argument will be ignoredN(tpopRtwarningstwarnR(t local_varRTtkeystouttkeyt kwarg_val((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytlocal_over_kwdicts$     cC`s:d }|d d !}x |D]}|j|d }qW|S( s%remove latex formatting from mathtexts \mathdefaults\rms\cals\tts\its\t{t}iiR((s \mathdefaults\rms\cals\tts\its\RR(treplace(Rtremovetr((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt strip_maths   tBunchcB`s eZdZdZdZRS(s Often we want to just collect a bunch of stuff together, naming each item of the bunch; a dictionary's OK for that, but a small do- nothing class is even handier, and prettier to use. Whenever you want to group a few variables:: >>> point = Bunch(datum=2, squared=4, coord=12) >>> point.datum By: Alex Martelli From: https://code.activestate.com/recipes/121294/ cK`s|jj|dS(N(RKtupdate(R tkwds((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!scC`s*ddjdtjt|DS(Ns Bunch(%s)s, cs`s|]}d|VqdS(s%s=%sN((t.0tkv((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pys s(tjoinRRmtvars(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR}s (R$R%R&R!R}(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs  cC`stt|S(s'Return a list of unique elements of *x*(Rltset(tx((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytuniquescC`s'yt|Wntk r"tSXtS(s return true if *obj* is iterable(titerR>RWtTrue(tobj((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytiterables  cC`st|tjtjtjfS(s(Return True if *obj* looks like a string(R Rt string_typestnptstr_tunicode_(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytis_string_likescC`syt|stSt|rTt|tj rTy |j}WqTtk rPtSXnx|D]}t|s[tSq[WtS(s6Returns true if *obj* is iterable and contains strings( RRWRR RtndarraytvaluesRR(Rto((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytis_sequence_of_stringss     cC`s'yt|Wntk r"tSXtS(s#Returns true if *obj* can be hashed(R6R>RWR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt is_hashable&s  cC`stt|ddS(sCreturn true if *obj* looks like a file object with a *write* methodtwriteN(tcallabletgetattrR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytis_writable_file_like/scC`s.y|jdWntk r%tSXtSdS(si Returns `True` if the given writable file-like object requires Unicode to be written to it. R(N(RR>RRW(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytfile_requires_unicode4s  cC`st|tj ot| S(s;return true if *obj* is not string like and is not iterable(R RRR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt is_scalarAscC`st|tjtjfS(s(return true if *obj* looks like a number(R tnumberstNumberRtnumber(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt is_numlikeGstrUcC`s/ttdrFt|tjrFttj|d|d|d|St|tjr|jdr|j dd}t j ||}nZ|jdrd d l }|j dd}|j ||}ntj ||d|}t}n*t|d r|}t}n td |r+||fS|S( s *fname* can be an `os.PathLike` or a file handle. Support for gzipped files is automatic, if the filename ends in .gz. *flag* is a read/write flag for :func:`file` tPathLiketflagt return_openedtencodings.gztUR(s.bz2iNtseeks'fname must be a PathLike or file handle(thasattrtosR Rt to_filehandletfspathRRtendswithRtgziptopentbz2tBZ2FiletioRRWR(tfnameRRRtfhRtopened((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRLs*!     Rcc`s?t||t|\}}|r6| |VWdQXn|VdS(s;Pass through file objects and context-manage `.PathLike`\s.N(RR(t path_or_filetmodeRRR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt open_file_cmos cC`st|tjpt| S(s;Return whether the given object is a scalar or string like.(R RRR(tval((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytis_scalar_or_stringzscC`sit|tjst|Stdd|jd kr?tS|jd krUtStd|dS( s'Parses the string argument as a booleans2.2ssPassing one of 'on', 'true', 'off', 'false' as a boolean is deprecated; use an actual boolean (True/False) instead.tonttruetofftfalses;String "%s" must be one of: "on", "off", "true", or "false"N(RR(RR( R RRtboolR tlowerRRWR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt_string_to_bools  cC`stjdrtjd}ntjjtjd}tjj||}|rtjj|djd kr~d}nd}tjj|\}}|d krtj ||St ||Sn|Sd S( s Return a sample data file. *fname* is a path relative to the `mpl-data/sample_data` directory. If *asfileobj* is `True` return a file object, otherwise just a file path. Set the rc parameter examples.directory to the directory where we should look, if sample_data files are stored in a location different than default (which is 'mpl-data/sample_data` at the same level of 'matplotlib` Python module files). If the filename ends in .gz, the file is implicitly ungzipped. sexamples.directoryt sample_datais.csvs.xrcs.txtRtrbs.gzN(s.csvs.xrcs.txt( RRRtpathRt_get_data_pathtsplitextRRR(Rt asfileobjtrootRRtbasetext((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytget_sample_datas    cc`sTxM|D]E}||s%|dkr-|Vqxt||D] }|Vq=WqWdS(s Returns a generator of flattened nested containers For example: >>> from matplotlib.cbook import flatten >>> l = (('John', ['Hunter']), (1, 23), [[([42, (5, 23)], )]]) >>> print(list(flatten(l))) ['John', 'Hunter', 1, 23, 42, 5, 23] By: Composite of Holger Krekel and Luther Blissett From: https://code.activestate.com/recipes/121294/ and Recipe 1.12 in cookbook N(Rtflatten(R|tscalarptitemtsubitem((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs  s sorted(..., key=itemgetter(...))tSortercB`s>eZdZdZdddZddZeZeZRS(se Sort by attribute or item Example usage:: sort = Sorter() list = [(1, 2), (4, 8), (0, 3)] dict = [{'a': 3, 'b': 4}, {'a': 5, 'b': 2}, {'a': 0, 'b': 0}, {'a': 9, 'b': 9}] sort(list) # default sort sort(list, 1) # sort by index 1 sort(dict, 'a') # sort a list of dicts by key 'a' cC`sA|jg|D]\}}||^q}|r=||(n|S(N(tsort(R tdatatauxtinplacetjunktitresult((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt_helpers  # icC`s|dkr5|r%|j|}n t|}|Sgtt|D]}||||f^qH}|j|||SdS(N(RRtsortedtrangeRoR(R Rt itemindexRRRR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytbyItems    3cC`sKgtt|D]}t||||f^q}|j|||S(N(RRoRR(R Rt attributenameRRR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt byAttributes8N( R$R%R&RRRRRR"(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs   tXlatorcB`s)eZdZdZdZdZRS(so All-in-one multiple-string-substitution class Example usage:: text = "Larry Wall is the creator of Perl" adict = { "Larry Wall" : "Guido van Rossum", "creator" : "Benevolent Dictator for Life", "Perl" : "Python", } print(multiple_replace(adict, text)) xlat = Xlator(adict) print(xlat.xlat(text)) cC`s"tjdjttj|S(s= Build re object based on the keys of the current dictionary t|(tretcompileRtmaptescape(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt _make_regex scC`s||jdS(s( Handler invoked for each regex *match* i(tgroup(R tmatch((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"scC`s|jj||S(s. Translate *text*, returns the modified text. (Rtsub(R ttext((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytxlats(R$R%R&RR"R(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs  icC`sd}d}d}xp|jD]b}|jr|s@|}n|t|td}| sq||dkr||7}qqqW||d}|jdd}||d| S(s6 soundex module conforming to Odell-Russell algorithm t01230120022455012623010202R(tAiit0(tuppertisalphatordR(tnameRotsoundex_digitstsndxtfctcRM((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytsoundexs  RcB`skeZdZdZdZdZdZejrEdZ n dZ dZ dZ d Z RS( s0 Null objects always and reliably "do nothing." cO`sdS(N((R RSRT((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!:scO`s|S(N((R RSRT((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"=scC`sdS(NsNull()((R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR@scC`sdS(NsNull()((R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR}CscC`sdS(Ni((R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__bool__GscC`sdS(Ni((R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt __nonzero__JscC`s|S(N((R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt __getattr__MscC`s|S(N((R RRv((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt __setattr__PscC`s|S(N((R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt __delattr__Ss(R$R%R&R!R"RR}RR9RRR R R (((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR6s         icC`sntjr%tj|d|dtnEytj|d|Wn+tk ri}|jtjkrjqjnXdS(s make directory *newdir* recursively, and set *mode*. Equivalent to :: > mkdir -p NEWDIR > chmod MODE NEWDIR Rtexist_okN(RR9RtmakedirsRtOSErrorterrnotEEXIST(tnewdirRt exception((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytmkdirsWs tGetRealpathAndStatcB`seZdZdZRS(cC`s i|_dS(N(t_cache(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!kscC`s|jj|}|dkrtjj|}tjdkrH|}n!tj|}|j |j f}||f}||j|gt|D]-\}}||dD]}||f^q%q S(s3 return all possible pairs in sequence *x* i(t enumerate(RRRWR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytallpairswstmaxdictcB`s eZdZdZdZRS(s A dictionary with a maximum size; this doesn't override all the relevant methods to constrain the size, just setitem, so use with caution cC`s#tj|||_g|_dS(N(RbR!tmaxsizet _killkeys(R Ri((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!s  cC`sf||krOt||jkr<||jd=|jd=n|jj|ntj|||dS(Ni(RoRiRjRFRbt __setitem__(R tktv((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRks   (R$R%R&R!Rk(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRhs tStackcB`s}eZdZd dZdZdZdZdZdZ dZ dZ d Z d Z d Zd ZRS(s Implement a stack where elements can be pushed on and you can move back and forth. But no pop. Should mimic home / back / forward in a browser cC`s|j||_dS(N(tcleart_default(R tdefault((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!s cC`s(t|js|jS|j|jSdS(s#return the current element, or NoneN(Rot _elementsRpt_pos(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"scC`s |jjS(N(Rrt__len__(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRtscC`s|jj|S(N(Rrt __getitem__(R R*((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRuscC`s;t|j}|j|dkr4|jd7_n|S(s8move the position forward and return the current elementi(RoRrRs(R tn((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytforwardscC`s(|jdkr!|jd8_n|S(s5move the position back and return the current elementii(Rs(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytbackscC`sD|j|jd |_|jj|t|jd|_|S(s push object onto stack at current position - all elements occurring later than the current position are discarded i(RrRsRFRo(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytpushscC`s.t|jsdS|j|jd|S(s0push the first element onto the top of the stackNi(RoRrRy(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pythomescC`st|jdkS(Ni(RoRr(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytemptyscC`sd|_g|_dS(sempty the stackiN(RsRr(R ((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRos cC`s||jkrtdn|j}|jg}x7|D]/}||kra|j|q?|j|q?Wx|D]}|j|qyW|S(se raise *o* to the top of the stack and return *o*. *o* must be in the stack sUnknown element o(RrRRoRFRy(R Rtoldtbubblestthiso((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytbubbles     cC`sf||jkrtdn|j}|jx-|D]%}||krQq9q9|j|q9WdS(s!remove element *o* from the stacksUnknown element oN(RrRRoRy(R RR|R~((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs    N(R$R%R&RR!R"RtRuRwRxRyRzR{RoRR(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRns          cC`s|r@gt|D]$}t|tjr||f^q}nIgt|D]*}t|tjrM|j|f^qM}|j}g|D]'\}}|j|dkr|^qS(su return all attributes of *o* which match string in match. if case is True require an exact case match. i(tdirR RRRtfind(RRtcaseRtnamestorig((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytfinddirs'* cC`sdtj|DS(sAreverse the dictionary -- may lose data if values are not unique!cS`si|]\}}||qS(((RRlRm((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pys s (RRm(RM((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt reverse_dictsc`sfdtj|DS(sn Return a dictionary that contains those keys that appear in both d and keys, with values from d. c`s+i|]!\}}|kr||qS(((RRlRm(R(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pys s (RRm(RMR((Rs8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt restrict_dictscC`sGddlm}m}tj}tjdkry2|ddd|ddgd |jj}Wnt k rt d nXt |d j }ntjj d ry2|ddd|dd gd |jj}Wnt k rt dnXt |djd}n&tjj dry2|ddd|ddgd |jj}Wnt k rt dnXt |djd}ntjj dr0y5|tdddd|gd |jj}Wnt k rt dnXt |j jdjdd}nt dtj|S(s%return the memory consumed by processi(tPopentPIPEtsunos5tpss-ps%ds-otosztstdouts?report_memory works on Sun OS only if the 'ps' program is founditlinuxsrss,szs>report_memory works on Linux only if the 'ps' program is founditdarwinsrss,vszs?report_memory works on Mac OS only if the 'ps' program is foundtwinttasklists/nhs/fis pid eq %dsFreport_memory works on Windows only if the 'tasklist' program is foundit,R(s%We don't have a memory monitor for %s(tmatplotlib.compat.subprocessRRRtgetpidRRRt readlinesRtNotImplementedErrorR4Rt startswithR/tstrtreadR(RRRtpidta2tmem((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt report_memorysJ         +s0In safezip, len(args[0])=%d but len(args[%d])=%dcG`syt|d}xVt|dD]D\}}t||kr!tt||dt|fq!q!Wtt|S(s-make sure *args* are equal len before zippingii(RoRfRt _safezip_msgRlR(RStNxRRU((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytsafezipBs *cC`s*yt||SWntk r%tSXdS(s;return issubclass(x, klass) and return False on a TypeErrorN(t issubclassR>RW(RRB((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytissubclass_safeKs cC`stj|dtd|}|jjsB|j|jd}ny&tjj|dt }|j Wnt k r||SX|S(NtsubokRLtS( RtarrayRtdtypetisnativetbyteswapt newbyteordertmatmasked_invalidRWt shrink_maskR>(RRLtxm((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytsafe_masked_invalidUs  c`sddlddlmfdfdx5D]-}jd|f||igqSWdS(sY *objects* A list of objects to find cycles in. It is often useful to pass in gc.garbage to find the cycles that are preventing some objects from being garbage collected. *outstream* The stream for output. *show_progress* If True, print the number of objects reached as they are found. iN(t FrameTypec`sNx:t|D],\}}||dt|}jdtt|t|trxtj|D]Z\}}||krjdt |Pn||krmjdt |PqmqmWn^t|t rjd|j |n2t|t rjdnjt |jdq WjddS( Nis %s -- s[%s]s [key] = %ss[%d]s ( tuple )s -> s ( RfRoRRRzR RbRRmR~Rltindexttuple(RRtsteptnextRR(t outstream(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt print_pathvs$   c`sr jdt|nd|t|<j|}xw|D]o}||kre|qF|ksFt|rqFqFt||krF|||||gqFqFWdS(Ns%d (RRoRtidt get_referentsR (RR<tallt current_patht referentstreferent(RtgctobjectsRRRIt show_progress(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRIs   sExamining: %r (RRQRR(RRRR((RRRRRRIRs8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt print_cyclesfs ! tGroupercB`sYeZdZd dZdZdZdZdZdZdZ dZ RS( s This class provides a lightweight way to group arbitrary objects together into disjoint sets when a full-blown graph data structure would be overkill. Objects can be joined using :meth:`join`, tested for connectedness using :meth:`joined`, and all disjoint sets can be retrieved by using the object as an iterator. The objects being joined must be hashable and weak-referenceable. For example: >>> from matplotlib.cbook import Grouper >>> class Foo(object): ... def __init__(self, s): ... self.s = s ... def __repr__(self): ... return self.s ... >>> a, b, c, d, e, f = [Foo(x) for x in 'abcdef'] >>> grp = Grouper() >>> grp.join(a, b) >>> grp.join(b, c) >>> grp.join(d, e) >>> sorted(map(tuple, grp)) [(a, b, c), (d, e)] >>> grp.joined(a, b) True >>> grp.joined(a, c) True >>> grp.joined(a, d) False cC`s;i}|_x'|D]}t|g|t|\}}||rwt|t j j rw|j||s s2.2c'`sddfdY}g|D]}||^q }t}}xytrgg|D]}|j^qUD]}|rh|^qh}|rt|}|g|D]}||^qfVqEPqEWdS(s This generator takes a bunch of iterables that are ordered by func It sends out ordered tuples:: (func(row), [rows from all iterators matching func(row)]) It is used by :func:`matplotlib.mlab.recs_join` to join record arrays tmyiterc`s)eZdZfdZdZRS(cS`s'||_d|_|_|jdS(N(titRRRvtiternext(R R?((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR!s c`sPy(t|j|_|j|_Wn!tk rKd|_|_nXdS(N(RR?RvRt StopIterationR(R (R@(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR@s  cS`sVd}||jkr+|j}|jn'|jrR||jkrRtdn|S(NsIterator has been left behind(RRRvR@R(R Rtretval((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR"s  (R$R%R!R@R"((R@(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR>s N((RRR(R@t iterablesR>R?titerstminvalstminkeyt_f((R@s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytalign_iteratorss   5 'cC`stj|dt}|js"gStj|d |dk\}|d7}|j}|drrdg|}n|dr|jt|ntt |ddd|dddS(sq Return a list of (ind0, ind1) such that mask[ind0:ind1].all() is True and we cover all such regions RiiiNi( RRRRRttolistRFRoRlR(Rtidx((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytcontiguous_regionss      cC`soytj|}Wntk r2tdnX|jd|jd}|dkoh|ddk}|S(NsNmatplotlib display text must have all code points < 128 or use Unicode stringst$s\$ii(RRtUnicodeDecodeErrorRtcount(Rt dollar_countt even_dollars((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt is_math_texts  cC`sBt|dr.tjj|tjtjStj|tSdS(st Convert a sequence to a float array; if input was a masked array, masked values are converted to nans. RN(RRRRR2RR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt_to_unmasked_float_arrayscC`svt|d s%t|jdkr2tj|Sy|dddf|SWn!ttfk rqtj|SXdS(sy Converts a sequence of less than 1 dimension, to an array of 1 dimension; leaves everything else untouched. RiN(RRoRRt atleast_1dRt IndexErrorR>(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt _check_1ds% cC`stjt|tjr!|jn tj|}|jdkr^|jjtj kr^|gS|jdkrg|D]}tj |d^qtSt dj |dS(s Use Fortran ordering to convert ndarrays and lists of iterables to lists of 1D arrays. Lists of iterables are converted by applying `np.asarray` to each of their elements. 1D ndarrays are returned in a singleton list containing them. 2D ndarrays are converted to the list of their *columns*. *name* is used to generate the error message for invalid inputs. iiis"{} must have 2 or fewer dimensionsN(ii( RRSR RRRRRRztobject_RRtformat(R RR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRs 3$#idc C`sg}t|d}x|D]}i}tj|}tj|}tj|||}||||d<||d> x_s, y1_s, y2_s = pts_to_prestep(x, y1, y2) iiiNi(RtzerosRoR!(RRSR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytpts_to_presteps 6,8cG`stjdt|tdt|ddf}||ddddf<|ddddf|ddddf<||dddddf<|dddddf|dddddf<|S(s( Convert continuous line to post-steps. Given a set of ``N`` points convert to ``2N + 1`` points, which when connected linearly give a step function which changes values at the end of the intervals. Parameters ---------- x : array The x location of the steps. May be empty. y1, ..., yp : array y arrays to be turned into steps; all must be the same length as ``x``. Returns ------- out : array The x and y values converted to steps in the same order as the input; can be unpacked as ``x_out, y1_out, ..., yp_out``. If the input is length ``N``, each of these arrays will be length ``2N + 1``. For ``N=0``, the length will be 0. Examples -------- >> x_s, y1_s, y2_s = pts_to_poststep(x, y1, y2) iiiNi(RRkRoR!(RRSR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytpts_to_poststeps 6,8cG`stjdt|dt|f}tj|}|d |dd|ddddf<|ddddf<|d |dddf<|d|dddf<||dddddf<|dddddf|dddddf<|S(s Convert continuous line to mid-steps. Given a set of ``N`` points convert to ``2N`` points which when connected linearly give a step function which changes values at the middle of the intervals. Parameters ---------- x : array The x location of the steps. May be empty. y1, ..., yp : array y arrays to be turned into steps; all must be the same length as ``x``. Returns ------- out : array The x and y values converted to steps in the same order as the input; can be unpacked as ``x_out, y1_out, ..., yp_out``. If the input is length ``N``, each of these arrays will be length ``2N``. Examples -------- >> x_s, y1_s, y2_s = pts_to_midstep(x, y1, y2) iiiiN(RRkRot asanyarray(RRSR((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytpts_to_midsteps)@8cC`s ||fS(N((Rty((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt sRqRs steps-pres steps-posts steps-midcC`sXy|jj|jfSWn:tk rSt|}tj|jddt|fSXdS(s A helper function to get the index of an input to plot against if x values are not explicitly given. Tries to get `y.index` (works if this is a pd.Series), if that fails, return np.arange(y.shape[0]). This will be extended in the future to deal with more types of labeled data. Parameters ---------- y : scalar or array-like The proposed y-value Returns ------- x, y : ndarray The x and y values to plot. iRN(RRRRURRRR2(Rp((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytindex_of s   cC`sQt|tjrAy |dSWntk r1nXtdntt|S(Nis/matplotlib does not support generators as input(R t collectionstIteratorR>t RuntimeErrorRR(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytsafe_first_element, s  cC`s t|tjrt|S|S(s Converts dictview object to list(R Rst MappingViewRl(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytsanitize_sequence< sc C`sX|d krt}nt|}t}xtj|D]\}}g}g} xI|D]A} y'|j|j| | j| Wq\tk rq\Xq\W||kry'|j|j|| j|Wqtk rqXn|r=|d||R(tkwt alias_mappingtrequiredt forbiddentallowedR7t canonicalt alias_listttmpRyRRlt fail_keyst allowed_set((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytnormalize_kwargsA sR,        $ % %  %  cC`s$y |jSWntk r|SXdS(N(RR(Rpt default_name((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt get_label s  sLOCKERROR: matplotlib is trying to acquire the lock {!r} and has failed. This maybe due to any other process holding this lock. If you are sure no other matplotlib process is running try removing these folders and trying again. tLockedcB`sEeZdZdZdefdYZdZdZdZRS(s< Context manager to handle locks. Based on code from conda. (c) 2012-2013 Continuum Analytics, Inc. / https://www.continuum.io/ All Rights Reserved conda is distributed under the terms of the BSD 3-clause license. Consult LICENSE_CONDA or https://opensource.org/licenses/BSD-3-Clause. s.matplotlib_lockt TimeoutErrorcB`seZRS((R$R%(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR scC`sv||_dttj|_tjj|j|j|j|_tjj|j|jd|_t |_ dS(NR9s-*( RRRRR;RtLOCKFNt lock_pathRQRR(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR! s  %"cC`sd}d}xu|rbtj|j}|r^|dj|j r^tj||d8}qPqWtj|j}|j||syt j |j Wqt k rqXn t |_dS(Ni2g?ii(RRQRR;R+tsleept_lockstrRWRRR RRRWR(R tretriest sleeptimeROterr_str((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt __enter__ s     cC`sR|jrNxB|j|jfD]+}ytj|Wqtk rFqXqWndS(N(RRRRtrmdirR(R texc_typet exc_valueR\R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyt__exit__ s   ( R$R%R&RRuRR!RR(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR s    t _FuncInfocB`s5eZdZeddZddZddZRS(s* Class used to store a function. c`s||_||_tr*|_nfd|_|dkrWd|_n$t|ro||_n tddS(s Parameters ---------- function : callable A callable implementing the function receiving the variable as first argument and any additional parameters in a list as second argument. inverse : callable A callable implementing the inverse function receiving the variable as first argument and any additional parameters in a list as second argument. It must satisfy 'inverse(function(x, p), p) == x'. bounded_0_1: bool or callable A boolean indicating whether the function is bounded in the [0,1] interval, or a callable taking a list of values for the additional parameters, and returning a boolean indicating whether the function is bounded in the [0,1] interval for that combination of parameters. Default True. check_params: callable or None A callable taking a list of values for the additional parameters and returning a boolean indicating whether that combination of parameters is valid. It is only required if the function has additional parameters and some of them are restricted. Default None. c`sS(N((R(t bounded_0_1(s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRq scS`stS(N(R(R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyRq ss Invalid 'check_params' argument.N(RutinverseRt _bounded_0_1Rt _check_paramsR(R RuRRt check_params((Rs8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR! s       cC`s |j|S(s Returns a boolean indicating if the function is bounded in the [0,1] interval for a particular set of additional parameters. Parameters ---------- params : list The list of additional parameters. Default None. Returns ------- out : bool True if the function is bounded in the [0,1] interval for parameters 'params'. Otherwise False. (R(R tparams((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pytis_bounded_0_1% scC`s |j|S(s Returns a boolean indicating if the set of additional parameters is valid. Parameters ---------- params : list The list of additional parameters. Default None. Returns ------- out : bool True if 'params' is a valid set of additional parameters for the function. Otherwise False. (R(R R((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR; sN(R$R%R&RRR!RR(((s8lib/python2.7/site-packages/matplotlib/cbook/__init__.pyR s+ t_StringFuncParsercB`seZdZiZeddeeds$                             i  0     #   # /      ! (   _  .  C  N  4"-     G & $ %       k 7^$