U Åmœd®=ã@s$ddlZddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z m Z mZmZmZddl mZmZmZd d lm Z d d l mZmZmZd d lmZd dddddœZeee ¡ƒƒD]\ZZeee<qÈGdd„deƒZ e e!e e"ee"dffdœdd„Z#Gdd„dƒZ$e$ƒZ%dS)éN)Úcontextmanager)ÚIntEnum)ÚPath)Útime)Ú getLevelName)ÚAnyÚUnionÚOptionalÚIterableÚTextIO)ÚTupleÚListÚContextManageré)Úlogging)Ú_set_log_levelÚ _set_log_fileÚ _RootLogger)ÚLiteralÚERRORÚWARNINGÚINFOZHINTÚDEBUG)ÚerrorÚwarningÚinfoÚhintÚdebugc@sJeZdZdZdZdZdZdZee dœdd„ƒZ e de dd œd d „ƒZ d S) Ú Verbosityrrééé©ÚreturncCs tt|ƒS)N)rÚ_VERBOSITY_TO_LOGLEVEL©Úself©r'úI/home/sam/Atlas/atlas_env/lib/python3.8/site-packages/scanpy/_settings.pyÚlevel"szVerbosity.level)Ú verbosityr#ccs|t_|V|t_dS)z/ Temporarily override verbosity N)Úsettingsr*)r&r*r'r'r(Úoverride'szVerbosity.overrideN)Ú__name__Ú __module__Ú __qualname__rÚwarnrrrÚpropertyÚintr)rrr,r'r'r'r(rsr.)ÚvarÚvarnameÚtypescCsbt||ƒrdSt|tƒr |j}n,dd„|Dƒ}d d |dd…¡|d¡}t|›d|›ƒ‚dS)NcSsg|] }|j‘qSr')r-)Ú.0Útr'r'r(Ú 7sz_type_check..z{} or {}z, éÿÿÿÿz must be of type )Ú isinstanceÚtyper-ÚformatÚjoinÚ TypeError)r3r4r5Zpossible_types_strZ type_namesr'r'r(Ú _type_check1s  ÿr?c@s´eZdZdZdddddddd d d d d ddddddddœeeeeeeeeefeeefeeefeeefeedfeeedfeeeeedœdd„Z e e dœdd„ƒZ e j ee eefdœdd„ƒZ e edœdd„ƒZej edœdd„ƒZe edœdd „ƒZej ed!œd"d „ƒZe edœd#d$„ƒZej ed%œd&d$„ƒZe edœd'd(„ƒZej ed)œd*d(„ƒZe edœd+d,„ƒZej ed-œd.d,„ƒZe edœd/d0„ƒZej eeefd1œd2d0„ƒZe edœd3d4„ƒZej eeefd5œd6d4„ƒZe edœd7d8„ƒZej eeefd9œd:d8„ƒZe edœd;d<„ƒZej eeefd=œd>d<„ƒZe eedœd?d@„ƒZej eedAœdBd@„ƒZe eeefdœdCdD„ƒZej eeefdEœdFdD„ƒZe edœdGdH„ƒZej edIœdJdH„ƒZe eedœdKdL„ƒZej eeedfdMœdNdL„ƒZe edœdOdP„ƒZej eeeedfdQœdRdP„ƒZe e edœdSdT„ƒZ!e!j eedUœdVdT„ƒZ!e"dWZ#dceeeeeeeeeee#eeeed\œ d]d^„Z$e%d_d`„ƒZ&edœdadb„Z'dS)dÚ ScanpyConfigz# Config manager for scanpy. rÚÚh5adÚpdfFTz./write/z./cache/z./data/z ./figures/ÚlzférN)zN/AZdontknowZno_gateú?é2)r*Ú plot_suffixÚfile_format_dataÚfile_format_figsÚautosaveÚautoshowÚwritedirÚcachedirÚ datasetdirÚfigdirÚcache_compressionÚ max_memoryÚn_jobsÚlogfileÚcategories_to_ignoreÚ_frameonÚ_vector_friendlyÚ_low_resolution_warningÚn_pcs)r*rHrIrJrKrLrMrNrOrPrQrTrUrVrWrXcCs˜ttjƒ|_||_||_||_||_||_||_ ||_ ||_ ||_ | |_ | |_| |_| |_| |_||_||_||_||_tƒ|_|j|_d|_||_dS)Nr9)rrrZ _root_loggerrTr*rHrIrJrKrLrMrNrOrPrQrRrSrUrVrWrXrÚ_startZ_previous_timeZ_previous_memory_usageZN_PCS)r&r*rHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYr'r'r(Ú__init__Cs0 zScanpyConfig.__init__r"cCs|jS)a- Verbosity level (default `warning`) Level 0: only show 'error' messages. Level 1: also show 'warning' messages. Level 2: also show 'info' messages. Level 3: also show 'hint' messages. Level 4: also show very detailed progress for 'debug'ging. )Ú _verbosityr%r'r'r(r*s zScanpyConfig.verbosity)r*cCsœdd„tDƒ}t|tƒr ||_nht|tƒr6t|ƒ|_nRt|tƒrx| ¡}||krftd|›d|›ƒ‚qˆt| |¡ƒ|_nt |dttfƒt |t|jƒdS)NcSsg|]}t|tƒr|‘qSr')r:Ústr)r6Úvr'r'r(r8s z*ScanpyConfig.verbosity..zCannot set verbosity to z. Accepted string values are: r*) r$r:rr\r2r]ÚlowerÚ ValueErrorÚindexr?r)r&r*Zverbosity_str_optionsr'r'r(r*Žs ÿ    ÿcCs|jS)z3Global suffix that is appended to figure filenames.)Ú _plot_suffixr%r'r'r(rH¤szScanpyConfig.plot_suffix)rHcCst|dtƒ||_dS)NrH)r?r]rb)r&rHr'r'r(rH©s cCs|jS)z¬File format for saving AnnData objects. Allowed are 'txt', 'csv' (comma separated value file) for exporting and 'h5ad' (hdf5) for lossless saving. )Ú_file_format_datar%r'r'r(rI®szScanpyConfig.file_format_data)Ú file_formatcCs<t|dtƒdddh}||kr2td|›d|›ƒ‚||_dS)NrIÚtxtÚcsvrBzCannot set file_format_data to z. Must be one of )r?r]r`rc)r&rdZfile_format_optionsr'r'r(rI·s  ÿcCs|jS)zŸFile format for saving figures. For example 'png', 'pdf' or 'svg'. Many other formats work as well (see `matplotlib.pyplot.savefig`). )Ú_file_format_figsr%r'r'r(rJÂszScanpyConfig.file_format_figs)Ú figure_formatcCst|dtƒ||_dS)NZfigure_format_data)r?r]rg)r&rhr'r'r(rJËs cCs|jS)z¡ Automatically save figures in :attr:`~scanpy._settings.ScanpyConfig.figdir` (default `False`). Do not show plots/figures interactively. )Ú _autosaver%r'r'r(rKÐszScanpyConfig.autosave)rKcCst|dtƒ||_dS)NrK)r?Úboolri)r&rKr'r'r(rKÙs cCs|jS)z Automatically show figures if `autosave == False` (default `True`). There is no need to call the matplotlib pl.show() in this case. )Ú _autoshowr%r'r'r(rLÞszScanpyConfig.autoshow)rLcCst|dtƒ||_dS)NrL)r?rjrk)r&rLr'r'r(rLçs cCs|jS)zP Directory where the function scanpy.write writes to by default. )Ú _writedirr%r'r'r(rMìszScanpyConfig.writedir)rMcCst|dttfƒt|ƒ|_dS)NrM)r?r]rrl)r&rMr'r'r(rMóscCs|jS)zB Directory for cache files (default `'./cache/'`). )Ú _cachedirr%r'r'r(rNøszScanpyConfig.cachedir)rNcCst|dttfƒt|ƒ|_dS)NrN)r?r]rrm)r&rNr'r'r(rNÿscCs|jS)zU Directory for example :mod:`~scanpy.datasets` (default `'./data/'`). )Ú _datasetdirr%r'r'r(rOszScanpyConfig.datasetdir)rOcCs"t|dttfƒt|ƒ ¡|_dS)NrO)r?r]rÚresolvern)r&rOr'r'r(rO scCs|jS)zG Directory for saving figures (default `'./figures/'`). )Ú_figdirr%r'r'r(rPszScanpyConfig.figdir)rPcCst|dttfƒt|ƒ|_dS)NrP)r?r]rrp)r&rPr'r'r(rPscCs|jS)z| Compression for `sc.read(..., cache=True)` (default `'lzf'`). May be `'lzf'`, `'gzip'`, or `None`. )Ú_cache_compressionr%r'r'r(rQszScanpyConfig.cache_compression)rQcCs"|dkrtd|›dƒ‚||_dS)N>NÚgziprDz`cache_compression` (z") must be in {'lzf', 'gzip', None})r`rq)r&rQr'r'r(rQ%s  ÿcCs|jS)z_ Maximal memory usage in Gigabyte. Is currently not well respected.... )Ú _max_memoryr%r'r'r(rR.szScanpyConfig.max_memory)rRcCst|dttfƒ||_dS)NrR)r?r2Úfloatrs)r&rRr'r'r(rR7scCs|jS)zL Default number of jobs/ CPUs to use for parallel computing. )Ú_n_jobsr%r'r'r(rS<szScanpyConfig.n_jobs)rScCst|dtƒ||_dS)NrS)r?r2ru)r&rSr'r'r(rSCs cCs|jS)z4 The file path `logfile` was set to. )Ú_logpathr%r'r'r(ÚlogpathHszScanpyConfig.logpath)rwcCs.t|dttfƒt|ƒ d¡|_t|ƒ|_dS)NrTÚa)r?r]rÚopenrTrv)r&rwr'r'r(rwOscCs|jS)aX The open file to write logs to. Set it to a :class:`~pathlib.Path` or :class:`str` to open a new one. The default `None` corresponds to :obj:`sys.stdout` in jupyter notebooks and to :obj:`sys.stderr` otherwise. For backwards compatibility, setting it to `''` behaves like setting it to `None`. )Ú_logfiler%r'r'r(rTVs zScanpyConfig.logfile)rTcCsFt|dƒs|r||_n,|s.| ¡r(tjntj}||_d|_t|ƒdS)NÚwrite) ÚhasattrrwÚ_is_run_from_ipythonÚsysÚstdoutÚstderrrzrvr)r&rTr'r'r(rTcscCs|jS)z= Categories that are omitted in plotting etc. )Ú_categories_to_ignorer%r'r'r(rUnsz!ScanpyConfig.categories_to_ignore)rUcCs8t|ƒ}t|ƒD]\}}t|d|›dtƒq||_dS)Nzcategories_to_ignore[ú])ÚlistÚ enumerater?r]r)r&rUÚiÚcatr'r'r(rUus) ZpngZjpgZtifZtiffrCZpsZepsÚsvgZsvgzZpgfÚrawZrgbaéPé–éÚpng2x) ÚscanpyÚdpiÚdpi_saveÚframeonÚvector_friendlyÚfontsizeÚfigsizeÚ color_mapr<Ú facecolorÚ transparentÚipython_formatc CsÂ| ¡r,ddl} t| tƒr | g} | jj| Žddlm}||_| |_ |dk rT||d<|dk rd||d<| dk rt| |d<| dk rŒ| |d<| |d<|r¨d d l m }|||d |dk r¸||d <||_ dS) u© Set resolution/size, styling and format of figures. Parameters ---------- scanpy Init default values for :obj:`matplotlib.rcParams` suited for Scanpy. dpi Resolution of rendered figures – this influences the size of figures in notebooks. dpi_save Resolution of saved figures. This should typically be higher to achieve publication quality. frameon Add frames and axes labels to scatter plots. vector_friendly Plot scatter plots using `png` backend even when exporting as `pdf` or `svg`. fontsize Set the fontsize for several `rcParams` entries. Ignored if `scanpy=False`. figsize Set plt.rcParams['figure.figsize']. color_map Convenience method for setting the default color map. Ignored if `scanpy=False`. format This sets the default format for saving figures: `file_format_figs`. facecolor Sets backgrounds via `rcParams['figure.facecolor'] = facecolor` and `rcParams['axes.facecolor'] = facecolor`. transparent Save figures with transparent back ground. Sets `rcParams['savefig.transparent']`. ipython_format Only concerns the notebook/IPython environment; see :func:`~IPython.display.set_matplotlib_formats` for details. rN)ÚrcParamsz figure.dpiz savefig.dpizsavefig.transparentzfigure.facecolorzaxes.facecolorr)Úset_rcParams_scanpy)r’r”zfigure.figsize) r}ÚIPythonr:r]ÚdisplayZset_matplotlib_formatsZ matplotlibr˜rWrJZplotting._rcmodr™rV)r&rrŽrrr‘r’r“r”r<r•r–r—ršr˜r™r'r'r(Úset_figure_params‰s.1     zScanpyConfig.set_figure_paramscCsddl}t|ddƒS)z.Determines whether we're currently in IPython.rNZ __IPYTHON__F)ÚbuiltinsÚgetattr)rr'r'r(r}Ösz!ScanpyConfig._is_run_from_ipythoncCsd dd„t |¡Dƒ¡S)NÚ css2|]*\}}| d¡s|dks|›d|›VqdS)Ú_Úgetdocz = N)Ú startswith)r6Úkr^r'r'r(Ú Þs þz'ScanpyConfig.__str__..)r=ÚinspectÚ getmembersr%r'r'r(Ú__str__Ýs þzScanpyConfig.__str__) Tr‰rŠTTr‹NNrCNFrŒ)(r-r.r/Ú__doc__r]rjrrr r[r1rr*Úsetterr2rHrIrJrKrLrMrNrOrPr rQrtrRrSrwr rTr rUrZ_FormatrœÚ staticmethodr}r§r'r'r'r(r@>s ë      ì >     ÿ óó M r@)&r¥r~Ú contextlibrÚenumrÚpathlibrrrrÚtypingrrr r r r r rrArrrZ_compatrr$r„rƒÚvaluesr^r)rr]r;r?r@r+r'r'r'r(Ús4       û " *