-PhYrdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZddlmZddlmZddlmZddlmZddlmZddlZdd lmZmZdd lmZm Z m!Z!d d l"m#Z#m$Z$d d l%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+d dl,m-Z-d dl.m/Z/m0Z0m1Z1d dl2m3Z3m4Z4d dl5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;d dlZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGejHjIJdZKGddZLdZMdZNdZOdZPdZQdZRdZSdZTdZUdZVd ZWd!ZXdOd#ZYd$ZZd%Z[d&Z\dPd(Z]d)Z^dQd+Z_d,Z`d-Za dQd.Zbd/ZcdRd0Zdejed1ZfGd2d3Zgd4Zhd5Zid6Zjd7Zkd8Zld9Zmd:Znd;Zod<ZpdSd=Zqd>Zrd?Zsd@ZtdAZudBZvdCZwdDZxd"dEdFZyd"dEdGZzdSdHZ{dIZ|dJdKdLZ}dMZ~edNZdS)TzreST file generator. Generate the rst files for the examples by iterating over the python example files. Files that generate images should start with 'plot'. N) lru_cache)StringIO)Path)copyfile)indent)time) ConfigErrorExtensionError)blueboldred)glr_path_staticpy_source_parser)THUMBNAIL_PARENT_DIVTHUMBNAIL_PARENT_DIV_CLOSE_make_ref_regex_thumbnail_div_write_backreferencesidentify_names) BlockParser)_add_jupyterlite_badge_logogen_binder_rstgen_jupyterlite_rst)jupyter_notebook save_notebook)ImagePathIterator_find_image_ext _reset_dict _scraper_dict clean_modules save_figures) _W_KW_collect_gallery_files_combine_backreferences_format_toctree _replace_md5 _write_json get_md5sumoptipng scale_imagestatus_iterator zip_fileszsphinx-galleryceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZedZedZdZdZdS) _LoggingTeez/A tee object to redirect streams to the logger.c~t|_||_d|_|d|_d|_dS)NFutf-8)logger src_filename logger_bufferset_std_and_reset_positionclosedencoding)selfr4s V/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx_gallery/gen_rst.py__init__z_LoggingTee.__init__Rs? ( '')))  cttjtstjtjf|_|xt_t_d|_t|_|SNT) isinstancesysstdoutr/stderrorigs first_writeroutputr9s r:r6z&_LoggingTee.set_std_and_reset_position\sL#*k22 2*cj1DJ"&& SZjj  r<ctjtj|j\t_t_dSN)r@rAflushrBrCrFs r: restore_stdz_LoggingTee.restore_stdds>  !% CJJJr<cl|j||jr)|jd|jdd|_|j|z}|}|r"|ddvr|d|_|dd}nd|_|D]}|jd|dS) NzOutput from %sbrown)colorFz r1%s)rEwriterDr3verboser4r5 splitlines)r9datalineslines r:rPz_LoggingTee.writeis $   % K   0$2C7  S S S$D !D(!!  $DHF**"'rD #2#JEE!#D  , ,D K  d + + + + , ,r<c|j|jr)|jd|jd|_dSdS)NrOr1)rErIr5r3rQrFs r:rIz_LoggingTee.flush}sT    $ K  d&8 9 9 9!#D    $ $r<cdSrHrFs r:closez_LoggingTee.closes r<c4|jSrH)rEfilenorFs r:r[z_LoggingTee.fileno{!!###r<c4|jSrH)rEisattyrFs r:r^z_LoggingTee.isattyr\r<cdSNFrXrFs r:readablez_LoggingTee.readableur<cdSr`rXrFs r:seekablez_LoggingTee.seekablerbr<c4|jSrH)rEtellrFs r:rfz_LoggingTee.tells{!!!r<cdSr>rXrFs r:writablez_LoggingTee.writablestr<c|jjSrH)rEerrorsrFs r:rjz_LoggingTee.errorss {!!r<c|jjSrH)rEnewlinesrFs r:rlz_LoggingTee.newliness {##r<c|SrHrXrFs r: __enter__z_LoggingTee.__enter__s r<c.|dSrH)rJ)r9type_valuetbs r:__exit__z_LoggingTee.__exit__s r<N)__name__ __module__ __qualname____doc__r;r6rJrPrIrYr[r^rardrfrhpropertyrjrlrnrsrXr<r:r/r/Os"99   ,,, ,,,($$$   $$$$$$"""""X"$$X$r<r/z% .. rst-class:: sphx-glr-horizontal zD * .. image:: /%s :class: sphx-glr-multi-img z0 .. image:: /%s :class: sphx-glr-single-img z?.. rst-class:: sphx-glr-script-out .. code-block:: none {0} zm .. rst-class:: sphx-glr-timing **Total running time of the script:** ({0:.0f} minutes {1:.3f} seconds) z .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_ z|.. raw:: html
{0}


zf .. _sphx_glr_download_{0}: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example zv .. container:: sphx-glr-download sphx-glr-download-python :download:`Download {1} source code: {0} <{0}>` zx .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: {0} <{0}>` zj .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: {0} <{0}>` z# .. include:: {0}.recommendations pythonc4|A|ddt| }d||zd}nd}d}|D]}|r|dsd}nd|d||d}t |d }||zS) z4Return reStructuredText code block from code string.N rz :lineno-start: r1z :dedent: 1 )  z.. code-block::  )countlenlstriprR startswithr)codestrlanglineno blank_linesdedentrUcode_directiveindented_blocks r: codestr2rstrs mmD!c'..2B2B.C.C-CDD >f{&:>>> F""$$   44 F EBBBBBBBNGW--N N **r<c|}|d|dddz|dzS)Nrr.rN)groupssplit)xs r:_regrouprs:  A Q4!A$**S//"% %! ,,r<cTd\}}tj|dz|zd|}tj|dz|zt|}tj|dz|zd|}d}tj|dz|zd|}tj|dz|zt|}tj|dz|zd|}tjd d |}tjd d |}tjd d |}tjd d |}|dd}|S)z4Use regex to remove at least some sphinx directives.)z(\s|^):[^:\s]+:`z`(\W|$)z\S+\s*<([^>`]+)>z\1\2\3z~([^`]+)z([^`]+)z(\s|^)`z `([^`]+)`z \.?([^`]+)z\*\*([^\*]*)\*\*z\1z \*([^\*]*)\*z`([^`<>]+) <[^`<>]+>`\_\_?z :[a-z]+:`([^`<>]+)( <[^`<>]+>)?`z\\\)resubrreplace)stringpes r: _sanitize_rstrs/ +DAq VA++a/F C CF VA Oa'6 : :F VA NQ& 6 : :F A VA $q()V < z+extract_intro_and_title..<s5RRRq||E/B/BRs1vvPQzz!zzzr<rzaExample docstring should have a header for the example title. Please check the example file: {} z^(?!([\W _])\1{3,})(.+)Nz+Could not find a title in first paragraph: rrr{r|) rrrr formatrsearch MULTILINEgroupstriprr)filename docstring paragraphstitle_paragraphmatchtitleintro_paragraphintros r:extract_intro_and_titler7s!!##))&11JRRZRRRJ :! 44:F84D4D   !mO I0/2< P PE } L? L L    KKNN " "E":22ee 1 O F4o . .E % E % E %<r<bc t||}t|dz}tj|sdSt |5}|}dddn #1swxYwY||kS)zAChecks whether src_file has the same md5 hash as the one on disk.mode.md5FN)r)strospathexistsopenread)src_filersrc_md5 src_md5_filefile_csref_md5s r:md5sum_is_currentrXs---Gx==6)L 7>>, ' 'u l  !w,,..!!!!!!!!!!!!!!! g sA55A9<A9c&tjtj|d}tj|d|dd}|dd}||d}|'tj|d|}n]t |tstd ||d kr|t|d dzz }| |}~~~t|\} } tj tj |d } tj|d | d | } d|vrC|ddr-tjtd} ntj| r| } njtj| sI|d}|,tjtd}t|\} } ndStj | d d| } | dvrt!| | n4t#| | g|dRd|dvrt%| |dtj | d dd| }t'| |dS)aGenerate and Save the thumbnail image. Parameters ---------- image_path_template : str holds the template where to save and how to name the image src_file : str path to source python file script_vars : dict Configuration and run time variables file_conf : dict File-specific settings given in source file comments as: ``# sphinx_gallery_ = `` gallery_conf : dict Sphinx-Gallery configuration dictionary thumbTexist_okthumbnail_numberNthumbnail_pathrsrc_dirz=sphinx_gallery_thumbnail_number setting is not a number, got rimage_path_iterator sphx_glr_z_thumb.formatted_exceptionfailing_thumbnailzbroken_example.pngdefault_thumb_file no_image.pngz.new.)svggifthumbnail_size thumbnailscompress_imagescompress_images_args) fname_old)rrjoindirnamemakedirsgetr?intr rrrsplitextbasenamerrrr+r*r')image_path_templater script_vars file_conf gallery_conf thumb_dirrr image_paththumbnail_image_pathextbase_image_name thumb_fileimgdefault_thumb_pathrs r:save_thumbnailrfs" RW__-@AA7KKIK D))))!}}%7>>]]#3T::NN$:W\\,y"9>JJ *C00  ,',,  a   K0E$F G G! K K (//0@AA .*= / ; ;#g&&rw'7'7'A'ABB1EOi)R_)R)RS)R)RSSJ ++ T11+gll?,,.BCC , - - " W^^J ' ' )*>?  %!#!!"" ##566SSG$$Z003??#??J nj!!!!CEl3C&DEEEE <(9: : : J -C D E E E7##J//23B37>>>Iy111111r<Tctj|ddrAtj|d}tj|rdSdgt |dz}|D]O}dD]J}tj|||z}tj|r|ccSKP|r#td||dS)zGet gallery header from GALLERY_HEADER.[ext] or README.[ext] file. Returns `None` if user supplied an index.rst or no gallery header file found and `raise_error=False`. copyfile_regexz index.rstNz.txt source_suffix)GALLERY_HEADERREADMEreadmezExample directory {} does not have a GALLERY_HEADER file with one of the expected file extensions {}. Please write one to introduce your gallery.) rrrrrisfilesortedr r)dir_r raise_errorfpth extensionsrfnames r:_get_gallery_headerrs x -. <<w||D+.. 7>>$   4F<#@AAAJ;  E7<<eck22Dw~~d##      &&,fT:&>&>   4r<c .d}|dr |s|rtj|d}tj||d}t |dfit 5}|d|tj d||t|dkr$t|} || dddn #1swxYwY|S) zWrite `index.rst` file for subsection if user has not provided index file. Returns path to index file written or `None` if no index file written as user provided one. Nnested_sectionsz index.rst.newrwz .. _sphx_glr_{}: _r) rrrrelpathrr#rPrrseprr&) ruser_index_rst is_subsection target_dir index_contenttoctree_filenames index_pathhead_reffindexsubsection_index_toctrees r:_write_subsection_indexrsIJ%& 7~ 7- 7W\\*o>> 7??:|I/FGG *c + +U + + 7v LL*11(2B2B2632O2OPP    LL ' ' '$%%))+:;L+M+M( 5666 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 s+BD  DDcj|drfdtj|D}rfd|D}|D]s}tjtj||}tj||}t ||drdSdS)z'Copy non-example files to `target_dir`.rc>g|]}tj||SrX)rr)rr copyregexs r:rz+_copy_non_example_files..s+XXXURXiQV=W=WX5XXXr<cDg|]}|tjk|SrX)rname)rr header_fnames r:rz+_copy_non_example_files..s.VVVUd<>P>P>U5U5Uu5U5U5Ur<copy)rmethodN)rlistdirrnormpathrr') rrr rrrr target_filers ` @r:_copy_non_example_filesrs-.IIXXXXbj&9&9XXX  WVVVV'VVVG I IEw'' We(D(DEEH',,z599K [ H H H H HII  I Ir<c #d}t}d}|rEd}t|dd5}|} || z }dddn #1swxYwY|dz }tjd tjd } tj| d tj| d } tj| d d t| tg} t| td d} |tz }g}g}tj d}t| d|dt| }i}t}t #dr-ddlm}m}|t #|dddd}|#fd|D}t)|D]\}\}}\}}}| |}tjtj|}|d|<d|vrd|vsJd|vsJ|dd|<nKd|vr"d|vsJd |n%d|vr!d!|d|t/|||"t1||z d}t7d|||} || z }|d#|zd$|vr,t9|d$||||}!t;||!|t<z }t?||||}"|rd}tA||"||||fS)%aGenerate output example reST files for one gallery (sub)directory. Parameters ---------- src_dir: str, Path to root or sub gallery directory containing example files target_dir: str, Path where parsed examples (rst, python files, etc) will be outputted gallery_conf : Dict[str, Any] Gallery configurations. seen_backrefs: set, Back references encountered when parsing this gallery will be stored in this set. is_subsection: bool, Weather `src_dir` is a subsection dir. If subsection dir, we write a `index.rst` file with toctree listing every example file. Default=True. Returns ------- index_path: str or None Path to index rst file for the `src_dir`. None if user provided own index. index_content: str or None Gallery header content. `None` when user provided own index.rst. costs: List[Dict] List of dicts of costs for building each element of the gallery with keys "t", "mem", "src_file", and "target_dir". toctree_items: list, List of example file names we generated ReST for. backrefs_dir : dict[str, tuple] Dictionary where value is the backreference object and value is a tuple containing: example filename, full path to example source directory, full path to example target directory, intro, title. r1TFrr2)r8Nrrimagesr jupyterlitewithin_subsection_orderr)keyrzgenerating gallery for z... )lengthparallel)Paralleldelayedn_jobsrloky)r pre_dispatch batch_sizebackendc34K|]}|VdSrHrX)rrrp_funrrs r: z#generate_dir_rst..^sD""H LH EJ  ,,,,,,,,)**8 +!    hEMG3))bCJJ.>.>Av %* E@277e$$y'Fuc'R'RRDD55lCCCH7??8\)-DEEL@"K|Te"NCTeDJT%%++  JJJJJ f(&1122 0v>>>J,- )s*:&HL.|< = ``. Returns ------- code_output : str reST of output of executed code block, including images and captured output. NrFignore_repr_typesrX)__repr____str__r{r~r1z%\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~]) _repr_html_r)rrrtyperrEgetvalue expandtabsisspace CODE_OUTPUTrrcompiler HTML_HEADER)rexample_globalsrr images_rstrrrr ignore_repr captured_std ansi_escape captured_html code_outputs r:_get_code_outputrs|4IIEe$ + , W)L1D$Es4PS99~~VVK 2  k #1,#D#D Iy%..00;;==L+++ +&55)55 L0022"))&w*G*GHH  *EFFK??2|44LM!!#**6)W+E+EFF  JzJJ|JJ}JJJK r<cFtj||t_dS)zReset cwd and sys.path.N)rchdirr@r)cwdsys_paths r:_reset_cwd_syspathrsHSMMMCHHHr<c| |dj}|dr |jdkrdStj}|d}t |}t |t sJtjtj |tj tj} tj tjtjd|jtj} | du} t%j|j} | d|d <| d |d |d } ||d < t+d |jdz z|jz|dt.j|jzd}t5||||\}}|d ||| rd} t9|||}nd}t;|| t=|||||| }n`#t>$rS|tAtj!|||}d |d}| rt9|||YnwxYwt;|| |n)#t;|| |wxYw|S)aExecute the code block of the example file. Parameters ---------- compiler : codeop.Compile Compiler to compile AST of code block. block : sphinx_gallery.py_source_parser.Block The code block to be executed. example_globals: Dict[str, Any] Global variables for examples. script_vars : Dict[str, Any] Configuration and runtime variables. gallery_conf : Dict[str, Any] Gallery configurations. file_conf : Dict[str, Any] File-specific settings given in source file comments as: ``# sphinx_gallery_ = ``. Returns ------- code_output : str Output of executing code in reST. Nr{rQrqr1rz2^[\ \t]*#\s*sphinx_gallery_defer_figures[\ \t]*\n?multi_image_block multi_imagecapture_repr_blockrrr{rr)flags dont_inherit)rrr memory_deltaFz )"rrrgetcwdrr?r/rrrr deepcopyr@r3rrcontentrrextract_file_configrrrr PyCF_ONLY_ASTrrrJr"rrrrir[)rblockrrrrrrrrdefer_figs_matchneed_save_figures block_confrrrrrrrhs r:rJrJs4%k2; ' (EJ&,@,@r )++C:&H*844K k; / ////HRW__X & &'''}SX&&HHOOBIKK   y=   )D0!5emDDJ",0C!D!DK  >> nl>&BCCL )K /" EL1$ % 5  #hn4    !5 %# ! ! !  g N#**7333!!!   % %e[,GGJJJ 3)))&           ; ; ;!!!% LNNHk<  0:///   ;  \ : : : ;, 3)))!!!! 3)))!!!! s,5BH0 %J50AJ  J5 J  J55&KcP|d}tj||o|d}|S)a3Validate if script has to be run according to gallery configuration. Parameters ---------- src_file : str path to python script gallery_conf : dict Contains the configuration of Sphinx-Gallery Returns ------- bool True if script has to be executed filename_pattern plot_gallery)rr)rrrexecutes r:executable_scriptrBs1 $$67i((33T ^8TG Nr<c td)Nz>Cannot use input() builtin function in Sphinx-Gallery examples)r )prompts r:rLrLWs H  r<c t|\}}tjtjdd}|j}|dtd||d<tj dd}|dre|dtj d<t|d \} | ||tj d d<tj |d \} }nd } t} tj} | g|d <||d<t!} t#|dd5}|D]=}|| t+| |||||> dddn #1swxYwYt| z }|t_ t-|d |d <|drp|d xx| zcc<t/|ddzd5}|t3|dddddn #1swxYwYd|d<| |fS)aEExecute and capture output from python script already in block structure. Parameters ---------- script_blocks : list (label, content, line_number) List where each element is a tuple with the label ('text' or 'code'), the corresponding content string of block and the leading line number script_vars : dict Configuration and run time variables gallery_conf : dict Contains the configuration of Sphinx-Gallery file_conf : dict File-specific settings given in source file comments as: ``# sphinx_gallery_ = `` Returns ------- output_blocks : list List of strings where each element is the restructured text representation of the output of each block time_elapsed : float Time elapsed during execution r~Nr1)rwinputrrQrr reset_argvrcdSrHrXrXr<r:z execute_script..sdr<rr{rrrr*rTr%)r importlibutilmodule_from_specspec_from_loaderrupdaterLr@argvr.gccollectrcodeopCompiler/r/rr6r3rJrVrrPr)) script_blocksrrrrrr{r argv_origr memory_startt_startr output_blocksrr time_elapsedrs r:rQrQ]s:/|<.sL 'E7K uf&A&A'&J&JKXXr<remove_config_commentscjg|]/\}}}tj|||0SrX)rrr r s r:rz(_clean_script_blocks..sS   ,w   "v44W=={     r<rNN)rr)rrrrs ` r:_clean_script_blocksrs+8M ,-     0=    R ((**+%crc* %crc* - ''r<c dr |d}nd}td}t||||}|rt||dd fd fd|D}|d |vr|d =~|S) zBGet example backreferences for `script_blocks` and write _codeobj.inspect_global_variablesrN default_rolez.codeobjexclude_implicit_doc_regexcdjdi|}dD]}tj||r|cSdjdi|S)N{module}.{name}prefer_full_modulez{module_short}.{name}rX)rrr)cobj full_namepatternrs r:_normalize_namez,_get_backreferences.._normalize_namesp,%,44t44 #$89 ! !Gy),, !     !-&-55555r<c h|]]}|D]X}|dd#|ds"r djdi|M|Y^S)module doc_module is_explicitrrX)rrr)rcobjsrr exclude_regexrs r: z&_get_backreferences..s        > $ $\,%? @ @    " "(()A):)A)I)ID)I)IJJ     r<r)rrr(values) rrrnoderglobal_variables ref_regexexample_code_objr-rrs ` @@r:_get_backreferencesr&s./ &'89 ^ <==I%mY@PRVWW?K!1:>>> !=>M66666      %,,..   H#1A(A(A U # Or<ctjtj||}t }t ||z }t ||ddt||\}}||d\} } } t|| dj \} } t||}t|drFd}td||r|d rd }nt||d <|r| | d |fStj|d }tj|dtj|d}d|zdz}tj||}|t%||t|d}|r|ddvrt'||dt)| ||| \}}td||t+|| |t-||| |\} }t/| || ||}t1|\}}||dz}|sdx}}t3||||||t5|||| ||g}|j|dvr`t9| ||}|d}t=||t |d||dgz }t?||d|tA||| | ||d<dD]}||vr ||||<~|r|ddvrt'||d | | ||f|fS)!aGenerate the rst file for a given example. Parameters ---------- fname : str Filename of python script. target_dir : str Absolute path to directory in documentation where examples are saved. src_dir : str Absolute path to directory where source examples are stored. gallery_conf : dict Contains the configuration of Sphinx-Gallery. Returns ------- intro: str The introduction of the example. title : str The example title. cost : tuple A tuple containing the ``(time_elapsed, memory_used)`` required to run the script. out_vars : dict Variables used to run the script, possibly with entries: "stale" True if the example was stale. "backrefs" The backreferences. "passing" True if the example passed. "formatted_exception" Formatted string of the exception. r r*)r rT) return_noderrzmd5sum is current: run_stale_examplesFr&)rrrrrz _{0:03}.png)rQrrrreset_modules_order)beforebothr+z%s ran in : %.2g secondsrrrnotebook_extensionsz .ipynb.new.ipynb.zipr-)r%r)afterr,r1)!rrrrr4rr'rsplit_code_and_text_blocksrrrrr3debugrrrrr!rQrr rst_blocksrsave_rst_examplersuffixrr5rr-r&)rrrrrrBrrrrrr"rrr do_returnr:r image_fnamerrrr example_rstrr memory_used files_to_zip example_nb ipy_fnamers r:r0r0s5Fw We < <==HvvHz""U*K;vC@@@@"5,77FH%+%F%Fd&G&&"I}d+5-2B2JKKLE5"8\::J3/// 2  8;88999  501 5! $' $4$4!  2%1 1 Z22IK D))))g&&u--a0O/-?K',,y+>>%01DEE;'' K5l#89=OOOlE8444"0{L)##M< LL+X|DDDz9k:::#7 $$ M= K/|<>r<a .. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "{0}" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code.{2} .. rst-class:: sphx-glr-example-title .. _sphx_glr_{1}: z/.. GENERATED FROM PYTHON SOURCE LINES {0}-{1} r-c :t|dk}d}tt||D]\}\}} |dkrC|t|j|j|jdzz }|jdkr`| d|dr|jnd} t|j|| dz} |r || z }|| z }|| z }d | vr|d z }|| z }|j dsd nd} ||j| zz }|S) atGenerate the rst string containing the script prose, code and output. Parameters ---------- script_blocks : list (label, content, line_number) List where each element is a tuple with the label ('text' or 'code'), the corresponding content string of block and the leading line number output_blocks : list List of strings where each element is the restructured text representation of the output of each block file_conf : dict File-specific settings given in source file comments as: ``# sphinx_gallery_ = `` language : str The language to be used for syntax highlighting in code blocks. Must be a name or alias recognized by Pygments. gallery_conf : dict Contains the configuration of Sphinx-Gallery Returns ------- out : str rst notebook rr1rr{rz line_numbersN)rrzsphx-glr-script-outz | r) rr2rRST_BLOCK_HEADERrrrrrrrr) rrrrris_example_notebook_liker9bi script_blockrrcode_rstblock_separators r:r4r4s}< #=11A5K+4S 5V5V+W+WBB' '\; 66 +22##l&:&@&@&F&FF K   & &==n1MNN ## L0xOOORVV ( (x' {* {* (K77;.Kx' +2;;DAAKt  <//A AKK r<cht|}t||d}|tjd}|d}t |dk} |d} | du} d} | s| r| dz } | r| r| d z } n| r| d z } n| r| d z } t||| |z}||d kr1t|d \} }|t| |z }|dr |d|ddz }|t|z }|j |dv}| r(|r&t|||}t|d}||z }| r'|r%t||}t|d}||z }|r7|dj}|t$|z }|t&|j|z }|t(|djz }|ddr1t|j}|t,|z }|dr |t.z }|d}t1|dfit25}||dddn #1swxYwYt j|j}dt6jt6jzt6jzz }t j |||ztC|ddS)a=Saves the rst notebook to example_file including header & footer. Parameters ---------- example_rst : str rst containing the executed file content example_file : str Filename with full path of python example file in documentation folder language : str Name of the programming language the example is in time_elapsed : float Time elapsed in seconds while executing file memory_used : float Additional memory used during the run. gallery_conf : dict Sphinx-Gallery configuration dictionary rrbinderrrNr1z, or to run this example in your browser via zJupyterLite or BinderBinder JupyterLitemin_reported_time< show_memoryz**Estimated memory usage:** z .0fz MB r.z r/r0 recommenderenableshow_signaturez.rst.newriwr*r)"rr relative_torrrrEXAMPLE_HEADERrdivmodTIMING_CONTENTDOWNLOAD_LINKS_HEADERr6rrrr5r NOTEBOOK_DOWNLOAD CODE_DOWNLOAD ZIP_DOWNLOADstemRECOMMENDATIONS_INCLUDE SPHX_GLR_SIGrr#rPstatst_modeS_IWRITES_IWGRPS_IWOTHchmodr')r9 example_filerr:rr example_fname ref_fname binder_confis_binder_enabledjupyterlite_confis_jupyterlite_enabledinteractive_example_texttime_mtime_srbinder_badge_rstjupyterlite_rstipynb_download_filerecommend_fnamewrite_file_newfrro_masks r:r5r5s4 %%L 00i1HIIJJM%%bfc22Ix(KK((1,#M2-T9!S2S $RR 232 $;;  2 H,  2 M1  mY8PQQ   l#6777 b11~,,VV<<< M"POkOOOOO (// :::K '<8M+NNM(](), \RR!"2D99'' '-'-lLII $77& E*66x@@E(//0CDDD ='' (98DDDK<&&|'?'?'G'G'LMMMKM"8,G}--2.55oFFF $%$|# !--j99N nc + +U + +q   7> " " *Dt}t|3dlBCGH^TG^,,,c******sJ<<KKc d}d}|d|zvs J|||}|dkr |dg}n||vr|g}t|ttfs|g}t|}t|D]\}}|dkr|d}n0||vr|dt |}n|d|d t |}t|t r||vrd |}d |vrc|d d \} } ttj | | }n#t$rtd |d| d| wxYw|dkrg|tvrt|}n tj |}t|d}|}nQ#t$rtd|wxYw|dkr+|tvrtd|d|t|}|||<|dkr$tj|r||}|||<tj|rtd|d|t!|st|dt|S)aGet callables for the given conf key, returning tuple of callable(s). If value is a string, import, with the following exceptions: * `within_subsection_order` - add full path if value is a built-in aliases, instantiate if value is a class * `image_scrapers` - get value from `_scraper_dict` or import module and get `_get_sg_image_scraper` attribute * `reset_modules` - get value from `_reset_dict` )ExampleTitleSortKeyFileNameSortKeyFileSizeSortKeyNumberOfCodeLinesSortKey)rminigallery_sort_ordersubsection_orderr)image_scrapers reset_modulesrrnotebook_modification_functionz"['notebook_modification_function']=[z]=zsphinx_gallery.sorting.rrzUnknown string option z when importing z from ry_get_sg_image_scraperzUnknown string option for rzz: rz,Got class rather than callable instance for z must be callable)r?tupler/r2reprrrsplitrr import_modulerr r rinspectisclasscallable) rrrbuiltin_aliases singletonswhichwiwhatramodattrs r:r.r.esIO J DzQ Q Q QSV Q Q Q  E m789   eeT] + + KKEe$$/>/>D -  AAAHH J  ,,T ,,HH2222d4jj22H dC  &&777d{{ KKQ// T"9#:3#?#?FFDD %<<<*.<<69<< (((=(((.DDS(6t<<&t-DEE#tvv$SSS)*Qx*Q*QRRRS''{**%&U8&U&Ut&U&UVVV"4(E"I + + +0E0E +4==DE"I ?4  QxQQ4QQ ~~ ><<<== = > <<s1"D#D7.FF$cd|fS)NrrX)rfs r:_sg_call_memory_nooprs ;r<F)rc:|d}t}d}|rt|drlt|r|}nZ|dr5|r2td|dd|ddd|d<nt }||\}}n|rd|d<t|sJ||fS) NrLrrrzgallery_conf['show_memory']=z* disabled due to gallery_conf['parallel']=rF)rrr3rZ_get_memprof_call_memory)rrrLrrouts r:rrs}-K'KK4|N34 K  4%KK * % 4 44|M244#J/444/4 ]+*,,C+.( [[ 4.3 ]+ K     ##r<cnddlm}||ddd\}} |d}n#t$rYnwxYw||fS)NrrT)rretval multiprocess)rr TypeError)rfrr+rs r:_sg_call_memory_memprofrsi,,,,,,|DDDQQQHC !f      8Os # 00c ddlm}ttfS#t$rt dYdSwxYw)NrrzDPlease install 'memory_profiler' to enable peak memory measurements.)rrrr ImportErrorr3rZrs r:rrsl;000000'(8(:(:::  R   tt s$AA)ryN)r)T)NNrH)rwrr contextlibr rrrrrr[r@rSrk functoolsriorpathlibrshutilrtextwraprr sphinx.utilsphinx sphinx.errorsr r sphinx.util.consoler r r r1rrbackreferencesrrrrrr block_parserrinteractive_examplerrrnotebookrrscrapersrrrr r!r"utilsr#r$r%r&r'r(r)r*r+r,r-rlogging getLoggerr3r/ HLIST_HEADERHLIST_IMAGE_TEMPLATE SINGLE_IMAGErrSrZrrTrVrUrWrYrrrrrrrrrrFrirrcontextmanagerrvrxrrrrrrrrJrrLrQrrr&r0rQr@r4r5r.rrrrrXr<r:rst   55555555//////////////////&%%%%% 65555555                             & &'7 8 8 WWWWWWWW|         ++++&--- !!!HB    I2I2I2X8< I I I& hhhhVFFFT       0 0 0;;;;;;;;*1!1!1!h   &999x xxxv* _'_'_'D...$(((2$$$NN?N?N?b(HPAAAAAVb+b+b+b+b+JSSSSn7<$$$$$:  ; ;  ; ; ;r<