3 ƽh@sdZddlmZddlZddlmZddlZddlZddlZddl Z ddl Z ddl m Z ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZddl m!Z!m"Z#m$Z$ddl%m&Z&dd l'm(Z(m)Z)m*Z*dd l+m,Z,m-Z-m.Z.dd l/m0Z0m1Z1m2Z2m3Z3m4Z4ej5ej6e7Z8dd dZ9GdddZ:Gddde:Z;Gddde;ZGddde:Z?Gddde:Z@Gddde:ZAGdd d ZBGd!d"d"eBZCGd#d$d$eCZDGd%d&d&eCZEGd'd(d(eEZFGd)d*d*eFZGGd+d,d,eFZHGd-d.d.eEZIGd/d0d0eIZJGd1d2d2eBZKd3ZLd4eLZMd5ZNGd6d7d7ZOGd8d9d9eOZPGd:d;d;eOZQGdd?d?eOZSGd@dAdAeOZTeTeTeSePePePePePePePeQeQeQeQeQeQeQeTeTdBZUdCdDZVGdEdFdFeWZXGdGdHdHZYGdIdJdJeYZZGdKdLdLeZZ[GdMdNdNeZZ\GdOdPdPeYZ]GdQdRdRe]Z^GdSdTdTeZZ_GdUdVdVe_Z`GdWdXdXe_ZaGdYdZdZeZZbGd[d\d\ebZcGd]d^d^ebZded_d`Zeeedad4dbdadeedad4dcdadeedad4dddadeedadadd4dbeedadadd4dceedadadd4ddeedadaddadeedad4dbddbdeee_fGdfdgdgeYZge!jhdhGdidjdjZie!jjdkdleejfjkDei_lWdQRXe!jhdhdmdnGdodpdpegZme!jhdhdqdnGdrdsdsegZne!jhdhdtdnGdudvdvegZoe!jhdhdwdnGdxdydyegZpe!jhdhdzdnGd{d|d|egZqe!jhdhd}dnGd~ddegZre!jhdhddnGdddegZsGddde`ZtGdddeaZuGdddeYZvGddde`ZwGddde`ZxGddde`ZyGdddZzezZ{ddZ|GdddZ}GdddZ~dddZdS)a0 A module for parsing a subset of the TeX math syntax and rendering it to a Matplotlib backend. For a tutorial of its usage, see :doc:`/tutorials/text/mathtext`. This document is primarily concerned with implementation details. The module uses pyparsing_ to parse the TeX expression. .. _pyparsing: https://pypi.org/project/pyparsing/ The Bakoma distribution of the TeX Computer Modern fonts, and STIX fonts are supported. There is experimental support for using arbitrary fonts, but results may vary without proper tweaking and metrics for those fonts. ) namedtupleN)StringIO)Image)CombineEmpty FollowedByForwardGroupLiteraloneOf OneOrMoreOptionalParseBaseExceptionParseFatalException ParserElement QuotedStringRegex StringEndSuppress ZeroOrMore)cbookcolorsrcParams)AFM)FT2ImageKERNING_DEFAULTLOAD_NO_HINTING)findfontFontPropertiesget_font)latex_to_bakomalatex_to_standardtex2uni latex_to_cmexstix_virtual_fontsTcCs||s t|S|dkrdSyt|Stk r4YnXyt|jdStk rv}ztdj||WYdd}~XnXdS)aB Return the integer index (from the Unicode table) of *symbol*. Parameters ---------- symbol : str A single unicode character, a TeX command (e.g. r'\pi') or a Type1 symbol name (e.g. 'phi'). math : bool, default: True If False, always treat as a single unicode character. -i"\z9'{}' is not a valid Unicode character or TeX/Type1 symbolN)ord TypeErrorr"stripKeyError ValueErrorformat)symbolmatherrr09/tmp/pip-build-7iwl8md4/matplotlib/matplotlib/mathtext.pyget_unicode_index0s r2c@s@eZdZdZddZddZddZdd Zd d Zd d Z dS)MathtextBackenda The base class for the mathtext backend-specific code. `MathtextBackend` subclasses interface between mathtext and specific Matplotlib graphics backends. Subclasses need to override the following: - :meth:`render_glyph` - :meth:`render_rect_filled` - :meth:`get_results` And optionally, if you need to use a FreeType hinting style: - :meth:`get_hinting_type` cCsd|_d|_d|_dS)Nr)widthheightdepth)selfr0r0r1__init__bszMathtextBackend.__init__cCs||_||_||_dS)z(Set the dimension of the drawing canvas.N)r4r5r6)r7whdr0r0r1set_canvas_sizegszMathtextBackend.set_canvas_sizecCs tdS)z_ Draw a glyph described by *info* to the reference point (*ox*, *oy*). N)NotImplementedError)r7oxoyinfor0r0r1 render_glyphmszMathtextBackend.render_glyphcCs tdS)zR Draw a filled black rectangle from (*x1*, *y1*) to (*x2*, *y2*). N)r=)r7x1y1x2y2r0r0r1render_rect_filledtsz"MathtextBackend.render_rect_filledcCs tdS)zp Return a backend-specific tuple to return to the backend after all processing is done. N)r=)r7boxr0r0r1 get_resultszszMathtextBackend.get_resultscCstS)z\ Get the FreeType hinting type to use with this particular backend. )r)r7r0r0r1get_hinting_typesz MathtextBackend.get_hinting_typeN) __name__ __module__ __qualname____doc__r8r<rArFrHrIr0r0r0r1r3Rsr3c@sHeZdZdZddZddZddZdd Zd d Zd d Z ddZ dS)MathtextBackendAggz Render glyphs and rectangles to an FTImage buffer, which is later transferred to the Agg image by the Agg backend. cCs4d|_d|_d|_d|_ddddg|_tj|dS)Nrbbox)r>r?imagemoderOr3r8)r7r0r0r1r8s zMathtextBackendAgg.__init__cCsBt|jd|t|jd|t|jd|t|jd|g|_dS)Nr)minrOmax)r7rBrCrDrEr0r0r1 _update_bboxszMathtextBackendAgg._update_bboxcCs@tj|||||jdkrr?r@r0r0r1rAs   zMathtextBackendAgg.render_glyphcCs|jdkr|j||||nhtt||dd}|dkr\||d}t||dd}nt|}|jjt||tj|||dS)NrOrRrg@)rQrWrVintrPZdraw_rect_filledrXrY)r7rBrCrDrEr5centeryr0r0r1rFs  z%MathtextBackendAgg.render_rect_filledcCsd|_|j}|j}tdd||j}|dd|dd|dd|ddg}d|_|j|d|d|d|d||d|d|t|d |d ||j|j|j|j|j|j|j |f}d|_ |S)NrOrrRrSrTrender) rQr5r6shiprOr<r>r?r4rP)r7rGused_charactersZ orig_heightZ orig_depthrOresultr0r0r1rHs* , zMathtextBackendAgg.get_resultscCsddlm}|jS)Nr) backend_agg)matplotlib.backendsriZget_hinting_flag)r7rir0r0r1rIs z#MathtextBackendAgg.get_hinting_typeN) rJrKrLrMr8rWr<rArFrHrIr0r0r0r1rNs  rNc@seZdZddZdS)MathtextBackendBitmapc Cs$tj|||\}}}}}}} ||fS)N)rNrH) r7rGrgr>r?r4r5r6rP charactersr0r0r1rHsz!MathtextBackendBitmap.get_resultsN)rJrKrLrHr0r0r0r1rksrkc@s:eZdZdZeddZddZddZdd Zd d Z d S) MathtextBackendPszT Store information to write a mathtext rendering to the PostScript backend. _PSResultz+width height depth pswriter used_characterscCst|_d|_dS)N)rpswriterlastfont)r7r0r0r1r8szMathtextBackendPs.__init__cCsv|j||j}|j}|j}||f|jkrN||f|_|jjd|d|d|jj|dd|dd|jddS)N/z findfont z scalefont setfont f z moveto /z glyphshow )r5offsetpostscript_namefontsizerprowrite symbol_name)r7r>r?r@rurvr0r0r1rAs zMathtextBackendPs.render_glyphcCs.d||j|||||f}|jj|dS)Nz%f %f %f %f rectfill )r5rorw)r7rBrCrDrEpsr0r0r1rFsz$MathtextBackendPs.render_rect_filledcCs,tdd||j|j|j|j|j|j|S)Nr)rfrnr4r5r6ro)r7rGrgr0r0r1rHs   zMathtextBackendPs.get_resultsN) rJrKrLrMrrnr8rArFrHr0r0r0r1rmsrmc@s:eZdZdZeddZddZddZdd Zd d Z d S) MathtextBackendPdfzCStore information to write a mathtext rendering to the PDF backend. _PDFResultz/width height depth glyphs rects used_characterscCsg|_g|_dS)N)glyphsrects)r7r0r0r1r8 szMathtextBackendPdf.__init__cCs:|jj}|j||j}|jj||||j|j|jfdS)N) r_fnamer5rtr|appendrvnumrx)r7r>r?r@filenamer0r0r1rAs  zMathtextBackendPdf.render_glyphcCs&|jj||j|||||fdS)N)r}rr5)r7rBrCrDrEr0r0r1rFsz%MathtextBackendPdf.render_rect_filledcCs0tdd||j|j|j|j|j|j|j|S)Nr)rfr{r4r5r6r|r})r7rGrgr0r0r1rHs  zMathtextBackendPdf.get_resultsN) rJrKrLrMrr{r8rArFrHr0r0r0r1rzsrzc@s0eZdZdZddZddZddZdd Zd S) MathtextBackendSvgzQ Store information to write a mathtext rendering to the SVG backend. cCsg|_g|_dS)N) svg_glyphs svg_rects)r7r0r0r1r8(szMathtextBackendSvg.__init__cCs4|j||j}|jj|j|j|j|||jfdS)N)r5rtrrr_rvrrZ)r7r>r?r@r0r0r1rA,szMathtextBackendSvg.render_glyphcCs*|jj||j|d||||fdS)NrR)rrr5)r7rBrCrDrEr0r0r1rF2sz%MathtextBackendSvg.render_rect_filledcCs8tdd|tj|j|jd}|j|j|j|j||fS)Nr)rr)rftypesSimpleNamespacerrr4r5r6)r7rGrgZ svg_elementsr0r0r1rH6s   zMathtextBackendSvg.get_resultsN)rJrKrLrMr8rArFrHr0r0r0r1r#s rc@s0eZdZdZddZddZddZdd Zd S) MathtextBackendPathzY Store information to write a mathtext rendering to the text path machinery. cCsg|_g|_dS)N)r|r})r7r0r0r1r8GszMathtextBackendPath.__init__cCs4|j||j}|j}|jj|j|j|||fdS)N)r5rtrr|rr_rv)r7r>r?r@thetextr0r0r1rAKsz MathtextBackendPath.render_glyphcCs&|jj||j|||||fdS)N)r}rr5)r7rBrCrDrEr0r0r1rFQsz&MathtextBackendPath.render_rect_filledcCs*tdd||j|j|j|j|j|jfS)Nr)rfr4r5r6r|r})r7rGrgr0r0r1rHTs   zMathtextBackendPath.get_resultsN)rJrKrLrMr8rArFrHr0r0r0r1rAs rc@s0eZdZdZddZddZddZdd Zd S) MathtextBackendCairozS Store information to write a mathtext rendering to the Cairo backend. cCsg|_g|_dS)N)r|r})r7r0r0r1r8cszMathtextBackendCairo.__init__cCs8||j|j}t|j}|jj|j|j|||fdS)N)rtr5chrrr|rr_rv)r7r>r?r@rr0r0r1rAgs z!MathtextBackendCairo.render_glyphcCs&|jj|||j||||fdS)N)r}rr5)r7rBrCrDrEr0r0r1rFmsz'MathtextBackendCairo.render_rect_filledcCs*tdd||j|j|j|j|j|jfS)Nr)rfr4r5r6r|r})r7rGrgr0r0r1rHqs   z MathtextBackendCairo.get_resultsN)rJrKrLrMr8rArFrHr0r0r0r1r]s rc@sreZdZdZddZddZddZdd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZdS)Fontsz An abstract base class for a system of fonts to use for mathtext. The class must be able to take symbol keys and font file names and return the character metrics. It also delegates to a backend class to do the actual drawing. cCs||_||_i|_dS)aG Parameters ---------- default_font_prop: `~.font_manager.FontProperties` The default non-math font, or the base font for Unicode (generic) font rendering. mathtext_backend: `MathtextBackend` subclass Backend to which rendering is actually delegated. N)default_font_propmathtext_backendrg)r7rrr0r0r1r8s zFonts.__init__cCs d|_dS)za Fix any cyclical references before the object is about to be destroyed. N)rg)r7r0r0r1destroysz Fonts.destroyc CsdS)av Get the kerning distance for font between *sym1* and *sym2*. *fontX*: one of the TeX font names:: tt, it, rm, cal, sf, bf or default/regular (non-math) *fontclassX*: TODO *symX*: a symbol in raw TeX form. e.g., '1', 'x' or '\sigma' *fontsizeX*: the fontsize in points *dpi*: the current dots-per-inch gr0) r7font1 fontclass1sym1 fontsize1font2 fontclass2sym2 fontsize2dpir0r0r1get_kernszFonts.get_kernTcCs|j||||||}|jS)a *font*: one of the TeX font names:: tt, it, rm, cal, sf, bf or default/regular (non-math) *font_class*: TODO *sym*: a symbol in raw TeX form. e.g., '1', 'x' or '\sigma' *fontsize*: font size in points *dpi*: current dots-per-inch *math*: whether sym is a math character Returns an object with the following attributes: - *advance*: The advance distance (in points) of the glyph. - *height*: The height of the glyph in points. - *width*: The width of the glyph in points. - *xmin*, *xmax*, *ymin*, *ymax* - the ink rectangle of the glyph - *iceberg* - the distance from the baseline to the top of the glyph. This corresponds to TeX's definition of "height". ) _get_inforZ)r7r_ font_classsymrvrr.r@r0r0r1 get_metricsszFonts.get_metricscCs6tj|||g\|_|_|_|jj|j|j|jdS)z Set the size of the buffer used to render the math expression. Only really necessary for the bitmap backends. N)rXrYr4r5r6rr<)r7r9r:r;r0r0r1r<szFonts.set_canvas_sizec CsB|j|||||}|jj|jjtj|j|jj |||dS)a Draw a glyph at - *ox*, *oy*: position - *facename*: One of the TeX face names - *font_class*: - *sym*: TeX symbol name or single character - *fontsize*: fontsize in points - *dpi*: The dpi to draw at. N) rrg setdefaultr_r~setaddrrrA) r7r>r?Zfacenamerrrvrr@r0r0r1rAszFonts.render_glyphcCs|jj||||dS)zL Draw a filled rectangle from (*x1*, *y1*) to (*x2*, *y2*). N)rrF)r7rBrCrDrEr0r0r1rFszFonts.render_rect_filledcCs tdS)zF Get the xheight for the given *font* and *fontsize*. N)r=)r7r_rvrr0r0r1 get_xheightszFonts.get_xheightcCs tdS)z Get the line thickness that matches the given font. Used as a base unit for drawing lines such as in a fraction or radical. N)r=)r7r_rvrr0r0r1get_underline_thicknessszFonts.get_underline_thicknesscCs|jS)z Get the set of characters that were used in the math expression. Used by backends that need to subset fonts so they know which glyphs to include. )rg)r7r0r0r1get_used_charactersszFonts.get_used_characterscCs|jj||j}|j|S)z Get the data needed by the backend to render the math expression. The return value is backend-specific. )rrHrr)r7rGrhr0r0r1rHs zFonts.get_resultscCs ||fgS)a Override if your font provides multiple sizes of the same symbol. Should return a list of symbols matching *sym* in various sizes. The expression renderer will select the most appropriate size for a given situation from this list. r0)r7fontnamerr0r0r1!get_sized_alternatives_for_symbol sz'Fonts.get_sized_alternatives_for_symbolN)T)rJrKrLrMr8rrrr<rArFrrrrHrr0r0r0r1rzs   rc@sReZdZdZddZddZddZdd Zdd d Zd dZ ddZ ddZ dS) TruetypeFontsza A generic base class for all font setups that use Truetype fonts (through FT2Font). cCsBtj|||i|_i|_t|}t|}||jd<||jd<dS)Ndefaultregular)rr8glyphd_fontsrr)r7rrr default_fontr0r0r1r8s zTruetypeFonts.__init__cCsd|_tj|dS)N)rrr)r7r0r0r1r&szTruetypeFonts.destroycCsl||jkr|j|}n|}|jj|}|dkrhtjj|rht|}||j|<||j|j<||j|jj<|S)N) fontmaprgetospathexistsrrulower)r7r_basename cached_fontr0r0r1 _get_font*s     zTruetypeFonts._get_fontcCs,|jdkr(|jdd|d|dSdS)NZCmex10@rSrTHg)rur5)r7r_rarvrr0r0r1 _get_offset7s zTruetypeFonts._get_offsetTc Cs|||||f}|jj|}|dk r&|S|j|||||\} } } }} | j||| j| |jjd} dd| jD\}}}}|j| | ||}t j | j d| j d| j d||||||| jd|| d }t j | || j|| | | |d}|j|<|S)N)flagscSsg|] }|dqS)gP@r0).0valr0r0r1 Jsz+TruetypeFonts._get_info..g@gP@) advancer5r4r[r]r^r\r`slanted)r_rvrurZrxrrart)rr _get_glyphset_sizeZ load_charrrIrOrrrZlinearHoriAdvancer5r4Z horiBearingYru)r7rrrrvrr.keyZbunchr_rrxrrar[r^r]r\rtrZrhr0r0r1r<s>   zTruetypeFonts._get_infocCsd|j|}|j|||jd}|dkrD|j|tdd||}|jS|dd|d|d}|S)Npcltzmathtext.defaultxxHeightgP@g(@gY@)rrZget_sfnt_tablerrr`)r7rrvrr_rrZrr0r0r1res   zTruetypeFonts.get_xheightcCsd||dS)Ng?g(@gR@g?r0)r7r_rvrr0r0r1rqsz%TruetypeFonts.get_underline_thicknessc Csl||krP||krP|j||||| } |j||||| } | j} | j| j| jtdStj|||||||||| S)Nr)rr_ get_kerningrrrr) r7rrrrrrrrrinfo1info2r_r0r0r1rwszTruetypeFonts.get_kernN)T) rJrKrLrMr8rrrrrrrr0r0r0r1rs   ) rc@s0eZdZdZdddddddd Zd d Zed jZdgddZ dhdidjdkdlgdmdndodpdqgdrdsdtdudvgdwdxdydzd{gd|d}d~dgddddgddddgddddgddddgddddgddddgddddgddddgddddgdddddgddddgddddgddgddgdYZ xdD]\Z Z e e e e <q WdddeZ dfS) BakomaFontsz Use the Bakoma TrueType fonts for rendering. Symbols are strewn about a number of font files, each of which has its own proprietary 8-bit encoding. cmsy10cmr10cmtt10cmmi10cmb10cmss10cmex10)calrmttitbfsfexcOs\t|||_tj|f||i|_x2|jjD]$\}}t|}||j|<||j|<q0WdS)N) StixFonts_stix_fallbackrr8r_fontmapitemsr)r7argskwargsrrfullpathr0r0r1r8s  zBakomaFonts.__init__z \int \ointTc Csd}d}||jkrD|tkrDt|\}} |dkp6||jk} |j|}n.t|dkrr|dk} |j|}|dk rrt|} |dk r|j| } | dkr|j| }|dkr|jj |||||S|| ||| fS)NrrRrr) rr _slanted_symbolsrlenr'get_char_indexget_glyph_namerr) r7rrrrvr.rxr_rrrgidr0r0r1rs&      zBakomaFonts._get_glyphr(r¡³µÃ)¢´¶!r{©n½}ªo¾[£r:"]¤i#¥j¹$¦kº%§l»&¨m¼'­D¿*®EÀ+pqrs²rqÂr%±.Ë,^bcr;~errg)rrrrrrz\lfloorz\rfloorz\lceilz\rceilz\langlez\ranglez \__sqrt__z \backslashrqz\widehatz \widetilde<> \leftparen \rightparent \leftbrace \rightbrace \leftbracket \rightbracket\{\}\[\]cCs|jj|||fgS)N)_size_alternativesr)r7rrr0r0r1rsz-BakomaFonts.get_sized_alternatives_for_symbolN)T)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr:)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr)rr )rr )rr )rr )rr )rr)rr)rr)rr)rr)rr)rr)rr)rr)rrq)rr)rr%)rrq)rr)rr)rr)rr)rr)rr)rr)rr;)rr)rr )rrr)rr!)rr:)rr )rr)rrr$rr%rr&rr'rr(rr)rr*rr+rr,rr-r) r/r0r1r2r3r4r5r6r7r8)rJrKrLrMrr8rsplitrrr.aliastargetrr0r0r0r1rsv    rc@sBeZdZdZdZddZedjZddZ d dd Z d d Z d S) UnicodeFontsaa An abstract base class for handling Unicode fonts. While some reasonably complete Unicode fonts (such as DejaVu) may work in some situations, the only Unicode font I'm aware of with a complete set of math symbols is STIX. This class will "fallback" on the Bakoma fonts when a required symbol can not be found in the font. Tc Ostd}tddk r$tdr dnd}tttdj|}|rD|||nd|_tj|f||i|_x.dj D]"}td|}t |}||j|<qlWt d}t |}||jd<t |jtrd d d d d dd}x0|j D]$\} } t | } | |j| <| |j| <qWdS)Nzmathtext.fallbackzmathtext.fallback_to_cmcm)stixstixsansr=zcal rm tt it bf sfz mathtext.rr STIXGeneralSTIXSizeOneSymSTIXSizeTwoSymSTIXSizeThreeSymSTIXSizeFourSymSTIXSizeFiveSym)rrRrSrT)rr StixSansFontsrr cm_fallbackrr8rr9rr isinstancer) r7rrZ fallback_rcrZtexfontpropr_Zstixsizedaltfontssizenamerr0r0r1r8s:      zUnicodeFonts.__init__z \int \ointcCs||fS)Nr0)r7rruniindexr0r0r1_map_virtual_font(szUnicodeFonts._map_virtual_fontc Csd}|jr$tj|}|dk r$d}d}|shyt||}d}Wn,tk rftd}tjdj|YnX|j |||\}}|}|r|dkr|dkrt |} t j | dd kst j | jd rd }|dkp||jk} d}|j|} | dk r| j|} | dkrd}|s|jrt|dkr.t|jtr.d }|jj||||} | dj}|ttjjkrbd }tjd||| S|dkrt|tr|jd |||Stjdj|||d }|j|} d}| j|} d} | j| }| |||| fS)NFrT?z#No TeX to unicode mapping for {!a}.rirLz GREEK CAPITALrrzComputer ModernzSubstituting symbol %s from %szTFont {!r} does not have a glyph for {!a} [U+{:x}], substituting with a dummy symbol.)rr)rr)use_cmexr#rr2r+r'_logwarningr,rOr unicodedatacategoryrM startswithrrrrIrJrr family_namelistrrvaluesr@r)r7rrrrvr. found_symbolrNZ new_fontnamecharrr_ glyphindexr!r~rxr0r0r1r+sl               zUnicodeFonts._get_glyphcCs|jr|jj||S||fgS)N)rIr)r7rrr0r0r1rqsz.UnicodeFonts.get_sized_alternatives_for_symbolN)T) rJrKrLrMrSr8rr9rrOrrr0r0r0r1r<s &  Fr<cs*eZdZdZddZdfdd ZZS) DejaVuFontsFcOst|trt|||_n t|||_t|||_tj|f||i|_ |j j ddddddx2|j j D]$\}}t |}||j |<||j |<qlWdS)NrArBrCrDrE)rRrSrTrFrG)rJDejaVuSerifFontsrrIrHrbakomarr8rrupdaterr)r7rrrrMrr0r0r1r8{s      zDejaVuFonts.__init__Tc st|dkr|jj|||||St|}|jd}|dk r\|j|}|dkr\tjd||||Stj|||||SdS)Nz\primerr)rarr2rrsuper) r7rrrrvr.rNr_r^) __class__r0r1rs  zDejaVuFonts._get_glyph)T)rJrKrLrSr8r __classcell__r0r0)rdr1r_xsr_c@s$eZdZdZddddddddZd S) r`zv A font handling class for the DejaVu Serif fonts If a glyph is not found it will fallback to Stix Serif z DejaVu SerifzDejaVu Serif:italiczDejaVu Serif:weight=boldz DejaVu SanszDejaVu Sans MonozDejaVu Serif Display)rrrrrrrN)rJrKrLrMrr0r0r0r1r`sr`c@s$eZdZdZddddddddZdS) DejaVuSansFontszt A font handling class for the DejaVu Sans fonts If a glyph is not found it will fallback to Stix Sans z DejaVu SanszDejaVu Sans:italiczDejaVu Sans:weight=boldzDejaVu Sans MonozDejaVu Sans Display)rrrrrrrN)rJrKrLrMrr0r0r0r1rfsrfc @sZeZdZdZddddddddd d d d d ZdZdZdZddZddZ e j ddZ dS)raa A font handling class for the STIX fonts. In addition to what UnicodeFonts provides, this class: - supports "virtual fonts" which are complete alpha numeric character sets with different font styles at special Unicode code points, such as "Blackboard". - handles sized alternative characters for the STIXSizeX fonts. r@zSTIXGeneral:italiczSTIXGeneral:weight=boldSTIXNonUnicodezSTIXNonUnicode:italiczSTIXNonUnicode:weight=boldrArBrCrDrE) rrrZnonunirmZnonuniitZnonunibfrrRrSrTrFrGFcOsPtj|f||i|_x2|jjD]$\}}t|}||j|<||j|<q$WdS)N)rr8rrrr)r7rrrrMrr0r0r1r8s  zStixFonts.__init__c CsPtj|}|jr.|dkr.|dkr.td}d}nd}|dk rt|trpy ||}Wntk rn|d}YnXd}t|}xJ||kr||d}||} || dkr|}q~|| d krPq~|d }q~W| d|ko| d knr|| d| d }| d}n|sd }td }|dkrHd|ko8dknrHd|}||fS)NrrrTFrrrSrRrTzmathtext.defaultrriiZnonuni)rr)rrr)r$r_sansrJdictr*rr) r7rrrNmappingZdoing_sans_conversionlohiZmidranger0r0r1rOs>         " &zStixFonts._map_virtual_fontc svddddddd}|j||}y t|Wntk rD||fgSXfdd td D}|d krr|dd }|S)Nrrrru⟨u⟩)z\{z\}z\[z\]r"r#cs,g|]$}j|jdkr|tfqS)r)rrr)rr)r7rNr0r1r%sz?StixFonts.get_sized_alternatives_for_symbol..z \__sqrt__rR)rr2r+rm)r7rrfixes alternativesr0)r7rNr1rs    z+StixFonts.get_sized_alternatives_for_symbolN) rJrKrLrMrrSrIrhr8rO functools lru_cacherr0r0r0r1rs& -rc@seZdZdZdZdS)rHzd A font handling class for the STIX fonts (that uses sans-serif characters by default). TN)rJrKrLrMrhr0r0r0r1rH.srHc@sdeZdZdZeejdZddddddd d Zd d Z d dZ dddZ ddZ ddZ ddZdS)StandardPsFontsz Use the standard postscript fonts for rendering to backend_ps Unlike the other font classes, BakomaFont and UnicodeFont, this one requires the Ps backend. z fonts/afmZpzcmi8aZpncr8aZpcrr8aZpncri8aZphvr8aZpncb8aZpsyr)rrrrrrNc Cstj||ti|_i|_t|d|jd}|dkrDtdd|jd}t|d}t|}WdQRX||_ ||jd<||jd<t |_ dS)NZafm)Zfontext directoryZ Helveticarbrr) rr8rmrfontsrbasepathopenrr~rro)r7rrfdrr0r0r1r8Is     zStandardPsFonts.__init__c Cs||jkr|j|}n|}|jj|}|dkr~tjj|j|d}t|d}t|}WdQRX||_ ||j|<||j|j <|S)Nz.afmrv) rrwrrrjoinrxryrr~ get_fontname)r7r_rrr~rzr0r0r1r[s     zStandardPsFonts._get_fontTcs||||f}|jj|}|dk r$|S|dkrNt|dksJtj|jd rNd}d} |tkrtt|\}} t| } d} n.t|dkr|} t| } d} nt j dj ||dk} |j |} | ry| j | }Wn.tk rt j d j | j|d} YnX| sd } t| } | j | }d }d |fd d| j| D\}}}}tj| j| | j| | j| ||||||||| d }tj| || j||| | |d|j|<|j|S)z0Load the cmfont, metrics and glyph with caching.NrrRrQrFTz.No TeX to built-in Postscript mapping for {!r}z2No glyph in standard Postscript font {!r} for {!r}rPrgMbP?csg|] }|qSr0r0)rr)scaler0r1rsz-StandardPsFonts._get_info..) rr4r5r[r]r^r\r`r)r_rvrurZrxrrart)rrrrVrWrXr!rr'rTrUr,rZ get_name_charr*r|Z get_bbox_charrrZget_width_charZget_height_char)r7rrrrvrr.rtupr\rrarr_rxrtr[r^r]r\rZr0)r}r1rksr             zStandardPsFonts._get_infoc Csn||krR||krR|j||||| } |j||||| } | j} | j| j| jd|Stj|||||||||| S)NgMbP?)rr_Z get_kern_distrarr) r7rrrrrrrrrrrr_r0r0r1rszStandardPsFonts.get_kerncCs|j|}|jd|S)NgMbP?)rr)r7r_rvrr0r0r1rs zStandardPsFonts.get_xheightcCs|j|}|jd|S)NgMbP?)rr)r7r_rvrr0r0r1rs z'StandardPsFonts.get_underline_thicknessN)T)rJrKrLrMstrrZ_get_data_pathrxrr8rrrrrr0r0r0r1rt6s N rtgffffff?g?rnc@s0eZdZdZdZdZdZdZdZdZ dZ d Z d S) FontConstantsBasez A set of constants that controls how certain things, such as sub- and superscripts are laid out. These are all metrics that can't be reliably retrieved from the font metrics in the font itself. g?g?gffffff?g333333?g?g?g?g?N) rJrKrLrM script_spacesubdropsup1sub1sub2delta delta_slanteddelta_integralr0r0r0r1rsrc@s,eZdZdZdZdZdZdZdZdZ dZ dS)ComputerModernFontConstantsg333333?g?g?g333333?N) rJrKrLrrrrrrrrr0r0r0r1rsrc@s$eZdZdZdZdZdZdZdZdS)STIXFontConstantsg?g?g333333?g?g333333?N) rJrKrLrrrrrrr0r0r0r1rs rc@seZdZdZdZdZdZdS)STIXSansFontConstantsg?g?g333333?g333333?N)rJrKrLrrrrr0r0r0r1r&src@s eZdZdS)DejaVuSerifFontConstantsN)rJrKrLr0r0r0r1r-src@s eZdZdS)DejaVuSansFontConstantsN)rJrKrLr0r0r0r1r1sr)z DejaVu SanszDejaVu Sans Monoz DejaVu Serifrrrrrrrr@rgrErDrCrBrAzBitstream Vera SanszBitstream VeracCs4tj|jj|jjt}|tkr0t|jt r0t S|S)N) _font_constant_mappingr font_outputrr_rYrrrJrHr)state constantsr0r0r1_get_font_constant_setNs rc@s eZdZdS)MathTextWarningN)rJrKrLr0r0r0r1rZsrc@s@eZdZdZddZddZddZdd Zd d Zd d Z dS)NodezA node in the TeX box model.cCs d|_dS)Nr)rL)r7r0r0r1r8asz Node.__init__cCs|jjS)N)rdrJ)r7r0r0r1__repr__dsz Node.__repr__cCsdS)Ngr0)r7nextr0r0r1rgszNode.get_kerningcCs|jd7_dS)z Shrinks one level smaller. There are only three levels of sizes, after which things will no longer get smaller. rRN)rL)r7r0r0r1shrinkjsz Node.shrinkcCs|jd8_dS)zb Grows one level larger. There is no limit to how big something can get. rRN)rL)r7r0r0r1growqsz Node.growcCsdS)Nr0)r7rrdr0r0r1rexsz Node.renderN) rJrKrLrMr8rrrrrer0r0r0r1r^src@s0eZdZdZddZddZddZdd Zd S) Boxz A node with a physical location.cCs tj|||_||_||_dS)N)rr8r4r5r6)r7r4r5r6r0r0r1r8s z Box.__init__cCsBtj||jtkr>|jt9_|jt9_|jt9_dS)N)rrrLNUM_SIZE_LEVELSr4 SHRINK_FACTORr5r6)r7r0r0r1rs   z Box.shrinkcCs8tj||jt9_|jt9_|jt9_dS)N)rrr4 GROW_FACTORr5r6)r7r0r0r1rs zBox.growcCsdS)Nr0)r7rBrCrDrEr0r0r1resz Box.renderN)rJrKrLrMr8rrrer0r0r0r1r|s rc@seZdZdZddZdS)Vboxz$A box with only height (zero width).cCstj|d||dS)Ng)rr8)r7r5r6r0r0r1r8sz Vbox.__init__N)rJrKrLrMr8r0r0r0r1rsrc@seZdZdZddZdS)Hboxz.A box with only width (zero height and depth).cCstj||dddS)Ng)rr8)r7r4r0r0r1r8sz Hbox.__init__N)rJrKrLrMr8r0r0r0r1rsrc@sReZdZdZdddZddZddZd d Zd d Zd dZ ddZ ddZ dS)Chara A single character. Unlike TeX, the font information and metrics are stored with each `Char` to make it easier to lookup the font metrics when needed. Note that TeX boxes have a width, height, and depth, unlike Type1 and TrueType which use a full bounding box and an advance in the x-direction. The metrics must be converted to the TeX model, and the advance (if different from width) must be converted into a `Kern` node when the `Char` is added to its parent `Hlist`. TcCsJtj|||_|j|_|j|_|j|_|j|_|j|_||_|j dS)N) rr8rrr_rrvrr._update_metrics)r7rrr.r0r0r1r8s z Char.__init__cCs d|jS)Nz`%s`)r)r7r0r0r1rsz Char.__repr__cCs`|jj|j|j|j|j|j|j}|_|jdkr<|j |_ n|j |_ |j |_ |j |j  |_ dS)Nrs)rrr_rrrvrr._metricsrr4r`r5r6)r7rZr0r0r1rs  zChar._update_metricscCs|jjS)N)rr)r7r0r0r1 is_slantedszChar.is_slantedc CsR|jj|j}d}t|trJ|jj|j|j|j |j |j|j|j |j |j }||S)z Return the amount of kerning between this and the given character. This method is called when characters are strung together into `Hlist` to create `Kern` nodes. g) rrr4rJrrrr_rrrvr)r7rrkernr0r0r1rs zChar.get_kerningcCs&|jj|||j|j|j|j|jdS)z4 Render the character to the canvas N)rrAr_rrrvr)r7rrdr0r0r1resz Char.rendercCsPtj||jtkrL|jt9_|jt9_|jt9_|jt9_dS)N) rrrLrrvrr4r5r6)r7r0r0r1rs   z Char.shrinkcCsFtj||jt9_|jt9_|jt9_|jt9_dS)N)rrrvrr4r5r6)r7r0r0r1rs  z Char.growN)T) rJrKrLrMr8rrrrrerrr0r0r0r1rs   rc@s0eZdZdZddZddZddZdd Zd S) Accentz The font metrics need to be dealt with differently for accents, since they are already offset correctly from the baseline in TrueType fonts. cCsJ|jj|j|j|j|j|j}|_|j|j |_ |j |j |_ d|_dS)Nr)rrr_rrrvrrr]r[r4r\r^r5r6)r7rZr0r0r1rs zAccent._update_metricscCstj||jdS)N)rrr)r7r0r0r1rs z Accent.shrinkcCstj||jdS)N)rrr)r7r0r0r1rs z Accent.growcCs6|jj||jj||jj|j|j|j|j|j dS)z5 Render the character to the canvas. N) rrArr[r^r_rrrvr)r7rrdr0r0r1re sz Accent.renderN)rJrKrLrMrrrrer0r0r0r1rs rcsLeZdZdZddZfddZeddZdd Zd d Z d d Z Z S)Listz0A list of nodes (either horizontal or vertical).cCs2tj|dddd|_||_d|_d|_d|_dS)Ngr)rr8 shift_amountchildrenglue_set glue_sign glue_order)r7elementsr0r0r1r8s z List.__init__c s4dtj|j|j|j|jdjdd|jDfS)Nz![%s <%.02f %.02f %.02f %.02f> %s]rscSsg|] }t|qSr0)repr)rrr0r0r1r&sz!List.__repr__..)rcrr4r5r6rr{r)r7)rdr0r1r!s z List.__repr__cCs4x.tt|dddD]}||dkr|SqWdS)z Determine the highest order of glue used by the members of this list. Helper function used by vpack and hpack. NrRrro)rmr)totalsrr0r0r1_determine_order(s zList._determine_ordercCsh|j|}||_||_||dkr2||||_n d|_d|_|dkrdt|jrdtjd||j j |dS)Ngrz %s %s: %r) rrrr glue_ratiorrrTrUrdrJ)r7rsignrZ error_typerr0r0r1 _set_glue4s   zList._set_gluecCsLx|jD] }|jqWtj||jtkrH|jt9_|jt9_dS)N)rrrrLrrrr)r7childr0r0r1rBs     z List.shrinkcCsBx|jD] }|jqWtj||jt9_|jt9_dS)N)rrrrrr)r7rr0r0r1rJs    z List.grow) rJrKrLrMr8r staticmethodrrrrrer0r0)rdr1rs  rc@s,eZdZdZd ddZddZd d d Zd S)HlistzA horizontal list of boxes. additionalTcCs$tj|||r|j|jdS)N)rr8rhpack)r7rr9rdo_kernr0r0r1r8Us zHlist.__init__cCsg}t|j}|rxht|D]\}|j|}||dkrF|j|d}nd}|j||j|}|dkrt|}|j|qW||_dS)z Insert `Kern` nodes between `Char` nodes to set kerning. The `Char` nodes themselves determine the amount of kerning they need (in `~Char.get_kerning`), and this function just creates the correct linked list. rRNg)rrrmrrKern)r7 new_childrenZ num_childrenrelemrZkerning_distancerr0r0r1r[s     z Hlist.kernc Csd}d}d}dgd}dgd}x|jD]}t|trZ||j7}t||j}t||j}q(t|tr||j7}tj |j rtj |j rt |dd} t||j| }t||j| }q(t|t r|j } || j7}|| j | j7<|| j| j7<q(t|tr(||j7}q(W||_||_|dkr2||7}||_||}|dkr`d|_d|_d|_dS|dkr||j|d|dn|j|d |d dS) a Compute the dimensions of the resulting boxes, and adjust the glue if one of those dimensions is pre-specified. The computed sizes normally enclose all of the material inside the new box; but some items may stick out if negative glue is used, if the box is overfull, or if a ``\vbox`` includes other boxes that have been shifted left. Parameters ---------- w : float, default: 0 A width. m : {'exactly', 'additional'}, default: 'additional' Whether to produce a box whose width is 'exactly' *w*; or a box with the natural width of the contents, plus *w* ('additional'). Notes ----- The defaults produce a box with the natural width of the contents. grFrrrNrROverfull Underfullro)rrJrr4rVr5r6rrXisinfgetattrGlue glue_spec stretch_orderstretch shrink_orderrrrrrr) r7r9rr:r;r total_stretch total_shrinkrrrr0r0r1rsJ               z Hlist.hpackN)rrT)rr)rJrKrLrMr8rrr0r0r0r1rRs 'rc@s,eZdZdZd ddZddejfddZdS) VlistzA vertical list of boxes.rcCstj|||jdS)N)rr8vpack)r7rr:rr0r0r1r8s zVlist.__init__c Csd}d}d}dgd}dgd}x|jD]} t| trt||| j7}| j}tj| jst| dd} t || j| }q(t| t r||7}d}| j } || j7}|| j | j 7<|| j| j7<q(t| tr||| j7}d}q(t| tr(tdq(W||_||kr|||7}||_n||_|dkr4||7}||_||}|dkrbd|_d|_d|_dS|dkr~|j|d|d n|j|d |d dS) ak Compute the dimensions of the resulting boxes, and to adjust the glue if one of those dimensions is pre-specified. Parameters ---------- h : float, default: 0 A height. m : {'exactly', 'additional'}, default: 'additional' Whether to produce a box whose height is 'exactly' *w*; or a box with the natural height of the contents, plus *w* ('additional'). l : float, default: np.inf The maximum height. Notes ----- The defaults produce a box with the natural height of the contents. grFrz1Internal mathtext error: Char node found in VlistrrNrRrrro)rrJrr5r6rXrr4rrVrrrrrrrr RuntimeErrorrrrr) r7r:rrr9r;rrrrrrr0r0r1rsT                z Vlist.vpackN)rr)rJrKrLrMr8rXinfrr0r0r0r1rs rc@s eZdZdZddZddZdS)Rulea A solid black rectangle. It has *width*, *depth*, and *height* fields just as in an `Hlist`. However, if any of these dimensions is inf, the actual value will be determined by running the rule up to the boundary of the innermost enclosing box. This is called a "running dimension". The width is never running in an `Hlist`; the height and depth are never running in a `Vlist`. cCstj|||||j|_dS)N)rr8r)r7r4r5r6rr0r0r1r8sz Rule.__init__cCs|jj||||||dS)N)rrF)r7rrdr9r:r0r0r1re!sz Rule.renderN)rJrKrLrMr8rer0r0r0r1rs rc@seZdZdZdddZdS)Hrulez.Convenience class to create a horizontal rule.NcCsB|dkr|jj|j|j|j}|d}}tj|tj|||dS)Ng?) rrr_rvrrr8rXr)r7r thicknessr5r6r0r0r1r8(s  zHrule.__init__)N)rJrKrLrMr8r0r0r0r1r%src@seZdZdZddZdS)Vrulez,Convenience class to create a vertical rule.cCs0|jj|j|j|j}tj||tjtj|dS)N) rrr_rvrrr8rXr)r7rrr0r0r1r83szVrule.__init__N)rJrKrLrMr8r0r0r0r1r0sr _GlueSpecz/width stretch stretch_order shrink shrink_ordergrRrSrT)filfillfilllneg_filneg_fill neg_filllemptyssc@sLeZdZdZejdeddZejdddddZ d d Z d d Z d S)ra Most of the information in this object is stored in the underlying ``_GlueSpec`` class, which is shared between multiple glue objects. (This is a memory optimization which probably doesn't matter anymore, but it's easier to stick to what TeX does.) z3.3cCsdS)NZnormalr0)r7r0r0r1 glue_subtypeOszGlue.glue_subtypecopyFcCsBtj|t|tr tj|}nt|tr0|}ntd||_dS)Nz.glue_type must be a glue spec name or instance)rr8rJrr_namedr+r)r7 glue_typerrr0r0r1r8Ts    z Glue.__init__cCs2tj||jtkr.|j}|j|jtd|_dS)N)r4)rrrLrr_replacer4r)r7r!r0r0r1r_s  z Glue.shrinkcCs(tj||j}|j|jtd|_dS)N)r4)rrrrr4r)r7r!r0r0r1res z Glue.growN)F) rJrKrLrMr deprecatedpropertyrZ_delete_parameterr8rrr0r0r0r1rGs  rz3.3c@s.eZdZdZd ddZddZedd Zd S) GlueSpecz See `Glue`.rcCs"||_||_||_||_||_dS)N)r4rrrr)r7r4rrrrr0r0r1r8os zGlueSpec.__init__cCst|j|j|j|j|jS)N)rr4rrrr)r7r0r0r1rws z GlueSpec.copycCs |j|S)N)_types)clsrr0r0r1factoryszGlueSpec.factoryN)rrrrr)rJrKrLrMr8r classmethodrr0r0r0r1rks  rcCs i|]\}}tf|j|qSr0)r_asdict)rrvr0r0r1 srz Glue('fil')) alternativec@seZdZddZdS)FilcCstj|ddS)Nr)rr8)r7r0r0r1r8sz Fil.__init__N)rJrKrLr8r0r0r0r1rsrz Glue('fill')c@seZdZddZdS)FillcCstj|ddS)Nr)rr8)r7r0r0r1r8sz Fill.__init__N)rJrKrLr8r0r0r0r1rsrz Glue('filll')c@seZdZddZdS)FilllcCstj|ddS)Nr)rr8)r7r0r0r1r8szFilll.__init__N)rJrKrLr8r0r0r0r1rsrzGlue('neg_fil')c@seZdZddZdS)NegFilcCstj|ddS)Nr)rr8)r7r0r0r1r8szNegFil.__init__N)rJrKrLr8r0r0r0r1rsrzGlue('neg_fill')c@seZdZddZdS)NegFillcCstj|ddS)Nr)rr8)r7r0r0r1r8szNegFill.__init__N)rJrKrLr8r0r0r0r1rsrzGlue('neg_filll')c@seZdZddZdS)NegFilllcCstj|ddS)Nr)rr8)r7r0r0r1r8szNegFilll.__init__N)rJrKrLr8r0r0r0r1rsrz Glue('ss')c@seZdZddZdS)SsGluecCstj|ddS)Nr)rr8)r7r0r0r1r8szSsGlue.__init__N)rJrKrLr8r0r0r0r1rsrcs eZdZdZfddZZS) HCenteredzl A convenience class to create an `Hlist` whose contents are centered within its enclosing box. cs&tjtdf|tdfdddS)NrF)r)rcr8r)r7r)rdr0r1r8szHCentered.__init__)rJrKrLrMr8rer0r0)rdr1rsrcs eZdZdZfddZZS) VCenteredzk A convenience class to create a `Vlist` whose contents are centered within its enclosing box. cs"tjtdf|tdfdS)Nr)rcr8r)r7r)rdr0r1r8szVCentered.__init__)rJrKrLrMr8rer0r0)rdr1rsrc@s8eZdZdZdZdZddZddZddZd d Z d S) ra A `Kern` node has a width field to specify a (normally negative) amount of spacing. This spacing correction appears in horizontal lists between letters like A and V when the font designer said that it looks better to move them closer together or further apart. A kern node can also appear in a vertical list, when its *width* denotes additional spacing in the vertical direction. rcCstj|||_dS)N)rr8r4)r7r4r0r0r1r8s z Kern.__init__cCs d|jS)Nzk%.02f)r4)r7r0r0r1rsz Kern.__repr__cCs&tj||jtkr"|jt9_dS)N)rrrLrr4r)r7r0r0r1rs  z Kern.shrinkcCstj||jt9_dS)N)rrr4r)r7r0r0r1rs z Kern.growN) rJrKrLrMr5r6r8rrrr0r0r0r1rs rc@seZdZdZddZdS)SubSuperClustera, A hack to get around that fact that this code does a two-pass parse like TeX. This lets us store enough information in the hlist itself, namely the nucleus, sub- and super-script, such that if another script follows that needs to be attached, it can be reconfigured on the fly. cCs"d|_d|_d|_tj|gdS)N)nucleussubrcrr8)r7r0r0r1r8szSubSuperCluster.__init__N)rJrKrLrMr8r0r0r0r1rsrc@seZdZdZdddZdS)AutoHeightChara A character as close to the given height and depth as possible. When using a font with multiple height versions of some characters (such as the BaKoMa fonts), the correct glyph will be selected, otherwise this will always just return a scaled version of the glyph. FNcCs|jj|j|}|jj|j|j|j}|j}||} x:|D]2\} } | |_t| |} | j| j | d|krr?rGr0r0r1__call__Fs z Ship.__call__cCs|dkr dS|dkrdS|S)NgeAgeger0)valuer0r0r1clampOs z Ship.clampcCs^d}d}|j}|j}|j}|j}|jd7_t|j|j|_|j}x|jD]} t | t r| j |j|j |j|j |j| j7_qNt | tr|j| j7_qNt | trt| jdkr|j| j7_nF|j} || j|_t | tr|j| n |j| | | j|_||_qNt | tr| j} | j} | j} tj| rL|j} tj| r^|j} | dkr| dkr|| |_| j |j|j |j|j | | ||_|j| 7_qNt | trN| j}|j|} |dkr2|dkr |j|kr2||j7}t||j |}n(|j!|kr2||j"7}t||j |}| |7} |j| 7_qNW|jd8_dS)NrgrR)#rrrrrrVrrrrJrrerrr4rrrrrr vlist_outrr5r6rXrrrrrroundrrr)r7rGcur_gcur_gluerrZ base_line left_edgerrZedge rule_height rule_depth rule_widthrr0r0r1rWsl                     zShip.hlist_outcCsNd}d}|j}|j}|jd7_t|j|j|_|j}|j|j8_|j}|j}x|j D]} t | t r|j| j 7_q^t | t rt| j dkr|j| j| j7_n\|j| j7_|| j|_|j} |j | _ t | tr|j| n |j| | | j|_||_q^t | tr| j} | j} | j } tj| r@|j } | | 7} | dkr8| dkr8|j| 7_| j|j|j|j|j| | q^t | tr&| j}|j |} |dkr|dkr|j|kr||j7}t||j|}n(|j |kr||j!7}t||j|}| |7} |j| 7_q^t | t"r^t#dq^W|jd8_dS)NrgrRz1Internal mathtext error: Char node found in vlist)$rrrrVrrrr5rrrJrr4rrr6rrrrrrXrrerrrrrrrrrrrr)r7rGr r rrr Ztop_edgerrZsave_vr r rrr0r0r1rsl                     zShip.vlist_outN) rJrKrLrMrrrrrr0r0r0r1r;s   ?rcs fdd}t}|j||S)z$Helper class to raise parser errors.cst||dS)N)r)rloctoks)msgr0r1 raise_errorszError..raise_error)rsetParseAction)rrrr0)rr1Errors  rcsjeZdZdZedddddZedjZedjZ ed jZ ee Be BZ ed jZ ed jZ ed jZed jZedjZedjZedjZedjZedjZddZddZGdddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d)d)d*d*d+d,d,d-dddyd. Z d/d0Z!d1d2Z"d3d4Z#e#Z$d5d6Z%d7d|iZ&d>d?Z'd@dAdBdCdDdEdFdGdHdGdCdDdEdFd@dIdJddsdtZ?dudvZ@dwdxZAZBS)}Parserz A pyparsing-based parser for strings containing math expressions. Raw text may also appear outside of pairs of ``$``. The grammar is based directly on that in TeX, though it cuts a few corners. rrRrSrT) displaystyle textstyleZ scriptstyleZscriptscriptstylea + * - \pm \sqcap \rhd \mp \sqcup \unlhd \times \vee \unrhd \div \wedge \oplus \ast \setminus \ominus \star \wr \otimes \circ \diamond \oslash \bullet \bigtriangleup \odot \cdot \bigtriangledown \bigcirc \cap \triangleleft \dagger \cup \triangleright \ddagger \uplus \lhd \amalga = < > : \leq \geq \equiv \models \prec \succ \sim \perp \preceq \succeq \simeq \mid \ll \gg \asymp \parallel \subset \supset \approx \bowtie \subseteq \supseteq \cong \Join \sqsubset \sqsupset \neq \smile \sqsubseteq \sqsupseteq \doteq \frown \in \ni \propto \vdash \dashv \dots \dotplus \doteqdota \leftarrow \longleftarrow \uparrow \Leftarrow \Longleftarrow \Uparrow \rightarrow \longrightarrow \downarrow \Rightarrow \Longrightarrow \Downarrow \leftrightarrow \longleftrightarrow \updownarrow \Leftrightarrow \Longleftrightarrow \Updownarrow \mapsto \longmapsto \nearrow \hookleftarrow \hookrightarrow \searrow \leftharpoonup \rightharpoonup \swarrow \leftharpoondown \rightharpoondown \nwarrow \rightleftharpoons \leadstoz, ; . ! \ldotp \cdotpz} \sum \prod \coprod \bigcap \bigcup \bigsqcup \bigvee \bigwedge \bigodot \bigotimes \bigoplus \biguplus zlim liminf limsup sup max minz \int \ointz.rm cal it tt sf bf default bb frak scr regularz arccos csc ker min arcsin deg lg Pr arctan det lim sec arg dim liminf sin cos exp limsup sinh cosh gcd ln sup cot hom log tan coth inf max tanhzr | \| / \backslash \uparrow \downarrow \updownarrow \Uparrow \Downarrow \Updownarrow . \vert \Vert \\|z( [ \{ < \lfloor \langle \lceilz) ] \} > \rfloor \rangle \rceilc Cstj}t|_t|_t|_t|_t|_t|_t|_ t|_ t|_ t|_ t|_ t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_t|_ t|_!t|_"t|_#t|_$t|_%t|_&t|_'t|_(t|_)t|_*t|_+t|_,t|_-t|_.t|_/t|_0x0t1|j2D] \}}|j3ds|j4|qW|j t5dK_ |jt5dK_|jt6dj7K_|jt6dj7K_|jt6dj7K_|j t6dj7K_ |jt6dK_|j(t8t9|j:K_(|j t;t6d |j|j |jt|jt8t9t?t@t5d jAtBBK_.|j-|j&|j.BjAK_-|jt5dK_|j t;|jt8t9|jCK_ |jtDt;|jt8|jE|jF|jK_|jt;|jt8t9|jGK_|j*tH|j|jK_*|j |jjIK_ |j%tD|jtJ|j/|jK_%|j!tD|jtK|j/|jK_!|jtD|j*tJ|j/|j K_|j t;|jt8t9|jLK_ |jt;|jt8dd|jLDK_|jtDt;t6d|j!|j!t|jt5d K_0|jtDt;t6d!|jtJ|j$|j0B|jt=:,.;!\?&'@()\[\]|%s])|(\\[%%${}\[\]_|])z [^A-Za-z]z'+cSsg|] }d|qS)r.r0)rrr0r0r1r sz#Parser.__init__..z\fraczExpected \frac{num}{den}z\dfraczExpected \dfrac{num}{den}z\binomzExpected \binom{num}{den}\}z\genfrac)rz.zmathtext.default)replacerrUrrRr_)r7rrrsymbolsrVr0)r7r1r)w s zParser.non_mathcCsf|j}|j|j|jf}|jj|}|dkrZ|jj|jtdd|j|j}|j }||j|<t ||S)Nzmathtext.defaultr) rRr_rvrrJrrrrrr)r7 percentagerrr4rZr0r0r1 _make_space s  zParser._make_spacegKqU?g0Bxq?g%?g1ZGU??) z\,z \thinspacez\/z\>z\:z\;z\ rz\enspacez\quadz\qquadz\!cCs.t|dkst|j|d}|j|}|gS)NrRr)rAssertionErrorr9rZ)r7rrrrrGr0r0r1r0 s z Parser.spacecCs|jt|dgS)Nr)rZfloat)r7rrrr0r0r1r  szParser.customspacec Cs|d}yt||j}Wn4tk rN}zt||d||WYdd}~XnX||jkrtdd|d|dddDd}||jkrt|d|jdks|dks||j kr|gSt |j d||j dgd d gSn||j kr|d krRtd d|d|dddDd}td d||ddDd}|dkrR|dkrR|gS|dkr||dj r||dj r|gSt ||j dgd d gS|gS)NrzUnknown symbol: %scss|]}|dkr|VqdS)rsNr0)rrr0r0r1 sz Parser.symbol..rRrrg?T)rrcss|]}|dkr|VqdS)rsNr0)rrr0r0r1r^ scss|]}|dkr|VqdS)rsNr0)rrr0r0r1r^ srrroro)rrRr+r_spaced_symbolsr_binary_operatorsrr9rBrrZ_punctuation_symbolsisdigit) r7rrrrr]r/Z prev_charZ next_charr0r0r1r- s4 &        & .z Parser.symbolcCs|d}t||d|dS)NrzUnknown symbol: %s)r)r7rrrrr0r0r1r5 szParser.unknown_symbolZAArA?N\circcCs|d}|j}|jj|j|j|j}|jj|d\}}} |dkrJtd|j } |ddk rh|d| _| j|d9_t |d| } |j } |ddk r|d| _| j|d9_t |d| } t | j | j }t| g}|j|dt| g}|j|dt|td|| |gS)NrzError parsing symbolrSrRexactly)NNrg)rRrrr_rvrr<rrrrrrVr4rrrr)r7rrrrrrZ under_descZ over_descr0Z over_stateZoverZ under_stateZunderr4Z over_centeredZunder_centeredr0r0r1r s4         zParser.c_over_cz\circumflexaccentz\combiningbrevez\combiningoverlinez\combininggraveaccentz\combiningacuteaccentz\combiningtildez\combiningdotabovez\combiningdiaeresisz\combiningrightarrowabovez \rightarrowz \leftarrow)ZhatZbrevebarZgraveacutetildedotZddotZvecr`r rrrZoverrightarrowZ overleftarrowmathringzwidehat widetilde widebarcsfddtDS)Ncs&g|]tfddDrqS)c3s |]}j|o|kVqdS)N)rX)ra)rr0r1r^ sz-Parser....)any)r)am)rr1r sz#Parser...)r")rqr0)rqr1 szParser.c Cst|dkst|j}|jj|j|j|j}t|ddkrFtd|d\}}||j krtt d||j |t d}nt |j ||}|dkr|j|jtt|j d|g} | j|j d t| td |d t|ggS) NrRrrSzError parsing accentr&)rrng@rhgg@)rr\rRrrr_rvrrr>rr4rr=rrrrrrr) r7rrrrrrrZ accent_boxZcenteredr0r0r1r s(   z Parser.accentcsF|j|jd_tfdd|dD}|j|d|_|S)Nrcsg|]}t|qSr0)r)rr)rr0r1r6 sz#Parser.function..r)rUrRr_rrT function_name)r7rrrrVr0)rr1r$2 s zParser.functioncCsT|j|j}d|_x(|dD]}t|tr d|_|jq W|jt|dS)Nrr)rUrRr_rJrrrTr)r7rrrrrr0r0r1r*; s  zParser.operatornamecCs*|jt|r&|ddd|j_gS)NrrF)rUrrRr_)r7rrrr0r0r1r2G szParser.start_groupcCst|d}|gS)Nr)r)r7rrrgrpr0r0r1r&N s z Parser.groupcCs |jgS)N)rT)r7rrrr0r0r1r!S szParser.end_groupcCs&t|dkst|d}||j_gS)NrRr)rr\rRr_)r7rrrrMr0r0r1r_W s z Parser.fontcCs:t|tr|j|jkSt|tr6t|dr6|j|jkSdS)NrsF)rJrr_overunder_symbolsrrDrs_overunder_functions)r7rr0r0r1 is_overunder] s    zParser.is_overundercCst|tr|j|jkSdS)NF)rJrr_dropsub_symbols)r7rr0r0r1 is_dropsubd s  zParser.is_dropsubcCst|tr|jSdS)NF)rJrr)r7rr0r0r1ri s zParser.is_slantedcCsdS)NFr0)r7rrr0r0r1is_between_bracketsn szParser.is_between_bracketsc%st|dkstd}d}d}d}g}xX|dD]L} t| trR| dkrR|t| 7}q.t| trp| jdkrp|d7}q.|j| q.W|}t|dkr|sttd}nt|dkr|s|dS|d}nt|dkrt|dkr|dntd}|dd\} } | dkr| }n| }nt|dkrt|d kr8|dntd}|dd\} } }}| |krz| dkrrtd ntd | dkr| }|}n| }|}ntd |j }|j j |j |j |j}|j j|j |j |j}|r(|dkrtg}x*t|D]}|jj|j||dgqW|j|j|j|r4g}d}|j}|dk r`|jt||j}|dk r~|jt||j}|dk rt|g}|j|d|j|t|dgt|g}|j|d|j||dk rt|g}|j|d|jt|d|g|j}t|}||j|_ t|g}|gS|}t|tr|j}t|rt|dtrt!|ddr|dd}|d}t!|dr|j"j#|_t|dd}n t|tr|j"j#|_t|g}t$|}|j}d}|j%|r|j}|j&|}|j&|}|j'|rr||j&|7}||j(||dd7}|j%|rnd|j&|j)|}d|j&|j)|}nd}|dkrtt||g} | j|j%|r||j*|}!n |j+|}!|!| _ ntt||g} | j|j%|r||j*|}"n |j,|}"|dkr|" | _ ntt||g}#|#j|j%|rH||j*|}!n |j-|}!d||"| j|#j|!}$|$dkr|"|$7}"t| t|"| j|#j|!|#g} |!| _ |j%|s| j|j.|7_t|| g}|gS)NrRrrrr grSrTrFrGzDouble subscriptzDouble superscriptzOSubscript/superscript sequence is too long. Use braces { } to remove ambiguity.z\primerhg@rF)rg@)rr)rSrT)rFrGror{roro)/rr\rJrrrrrrrRrrr_rvrrrrmrextendr-rrrwr4rrVrrr5rr6rrDrrrryrrrrrrrrr)%r7rrrrrrcZ napostrophesZnew_tokstokoprZop1Znext1Zop2Znext2rZrule_thicknessrrvlistrr4rVrh last_charrrZ lc_heightZ lc_baselineZ superkernZsubkernrZ shift_downZshift_uprdZclr)rdr0r1r3q s                                                      zParser.subsupercCs<|j}|jj|j|j|j}t|}||jdkrD|j|jt |g} t |g} t |j |j } | j | d| j | dt | td|dt||td|d| g} |jj|jtdd|j|j} | j| j| jd|d}|| _t| t|dgg}|s|r8|d krd }|d kr*d }|j|||S|S) Nrrhrg@zmathtext.default=rSg@rr)rRrrr_rvrr]_math_style_dictrrrVr4rrrrrrr5r\r^rrr_auto_sized_delimiter)r7ZldelimZrdelimZrulestylerdenrrZcnumZcdenr4rrZrrhr0r0r1_genfrac/ s@           zParser._genfraccCs6t|dkstt|ddks$t|jt|dS)NrRrrn)rr\rtuple)r7rrrr0r0r1r%Y szParser.genfraccCsht|dkstt|ddks$t|j}|jj|j|j|j}|d\}}|jdd||j d||S)NrRrrSrr) rr\rRrrr_rvrrr)r7rrrrrrrr0r0r1r"_ s  z Parser.fraccCsht|dkstt|ddks$t|j}|jj|j|j|j}|d\}}|jdd||j d||S)NrRrrSrr) rr\rRrrr_rvrrr)r7rrrrrrrr0r0r1r#k s  z Parser.dfraccCsJt|dkstt|ddks$t|d\}}|jddd|jd||S)NrRrrSrrgr)rr\rr)r7rrrrrr0r0r1rw s   z Parser.binomcsF|d\}}|jjjjjj}|j|j|d}|j|j}t d||dd} | j| j}| j| j}t t d||t d|g} t t td| g} | j|jjdd ||dkrt| jd d d }n&t fd d|D}|j|jt t |gg} | d| _t | t| j d | | g} | gS)Nrg@z \__sqrt__T)rrSrgY@g(@rhg?gcsg|]}t|qSr0)r)rr)rr0r1r szParser.sqrt..g333333?g@)rRrrr_rvrr5rr6rrrrrrrrr4rr)r7rrrrootbodyrr5r6checkZ padded_body rightsideZ root_vlistrVr0)rr1r1 s2     z Parser.sqrtc Cst|dkstt|ddks$t|dd}|j}|jj|j|j|j}|j|j |d}|j |j }t t |t dt|gg} | j||j|jdd|t| g} | gS) NrRrg@rgY@g(@rhg@)rr\rRrrr_rvrr5rr6rrrrr) r7rrrrrrr5r6rrVr0r0r1r+ s   zParser.overlinec Cs|j}t|r:tdd|D}tdd|D}d}n d}d}d}g}|dkrj|jt|||||d|j||dkr|jt|||||dt|} | S)Ncss|] }|jVqdS)N)r5)rrr0r0r1r^ sz/Parser._auto_sized_delimiter..css|] }|jVqdS)N)r6)rrr0r0r1r^ srg?r)r)rRrrVrrr}r) r7frontmiddlebackrr5r6rpartsrVr0r0r1r s$ zParser._auto_sized_delimitercCs|\}}}|j||j|S)N)rasList)r7rrrrrrr0r0r1r s zParser.auto_delimgKqUſrrcrdNrer[)rrrf)CrJrKrLrMrirrr9r`Z_relation_symbolsZ_arrow_symbolsr_rarurvrxr@r?rArBrCr8rOrHrRrTrUr'r(r.r)rZr9r0r r-r/r5r<rr=r>r:rr$r*r2r&r,r.r!r_rwryrrzr3rr%r"r#rr1r+rrrer0r0)rdr1rs              r  &&     ?*  (rc @seZdZdZeeeeee e edZ e e eeeedZddZdddZejd d d ZdddZdddZdddZdddZdS)MathTextParserN)bitmapZaggryZpdfsvgrZcairomacosx)r=Z dejavuserifZ dejavusansr>r?ZcustomcCs|j|_dS)z7Create a MathTextParser for the given backend *output*.N)r_output)r7outputr0r0r1r8 szMathTextParser.__init__rcCs|j|||tdtdS)aZ Parse the given math expression *s* at the given *dpi*. If *prop* is provided, it is a `.FontProperties` object specifying the "default" font to use in the math expression, used for all non-math text. The results are cached, so multiple calls to `parse` with the same expression should be fast. z ps.useafmzmathtext.fontset) _parse_cachedr)r7rrrKr0r0r1rO s zMathTextParser.parse2c Cs|dkrt}|jdkr&|r&t|}n(|j|j}tj|j|d}|||}|j} |jdkrjt |j _|jj ||| |} |j | j | j| j|j| S)Nry)fontset)rrrt_backend_mappingrZ_check_getitem_font_type_mappingZget_size_in_points_parserrrdrOr<r4r5r6rH) r7rrrKZ ps_useafmrrbackendZ fontset_classrvrGr0r0r1r s     zMathTextParser._parse_cachedxcCs:|jdkstt|d}|j|||d\}}tj||fS)a Parameters ---------- texstr : str A valid mathtext string, e.g., r'IQ: $\sigma_i=15$'. dpi : float The dots-per-inch setting used to render the text. fontsize : int The font size in points Returns ------- array : 2D uint8 alpha Mask array of rasterized tex. depth : int Offset of the baseline from the bottom of the image, in pixels. r)rL)rrK)rr\rrOrXZasarray)r7texstrrrvrKftimager6r0r0r1to_mask s zMathTextParser.to_maskblackc Cs|j|||d\}}tj|\}}} } tj|jd|jddftjd} d|| dddddf<d|| dddddf<d| | dddddf<|| ddddd f<| |fS) a0 Parameters ---------- texstr : str A valid mathtext string, e.g., r'IQ: $\sigma_i=15$'. color : color The text color. dpi : float The dots-per-inch setting used to render the text. fontsize : int The font size in points. Returns ------- array : (M, N, 4) array RGBA color values of rasterized tex, colorized with *color*. depth : int Offset of the baseline from the bottom of the image, in pixels. )rrvrrRrF)ZdtypeNrSrT)rmcolorsto_rgbarXzerosshapeZuint8) r7rcolorrrvrr6rr!rroZRGBAr0r0r1r7 s"zMathTextParser.to_rgbacCs.|j||||d\}}tj|j|dd|S)a/ Render a tex expression to a PNG file. Parameters ---------- filename A writable filename or fileobject. texstr : str A valid mathtext string, e.g., r'IQ: $\sigma_i=15$'. color : color The text color. dpi : float The dots-per-inch setting used to render the text. fontsize : int The font size in points. Returns ------- int Offset of the baseline from the bottom of the image, in pixels. )rrrvZpng)r,)rrZ fromarraysave)r7rrrrrvZrgbar6r0r0r1to_pngU szMathTextParser.to_pngcCs0|jdkstt|d}|j|||d\}}|S)aQ Parameters ---------- texstr : str A valid mathtext string, e.g., r'IQ: $\sigma_i=15$'. dpi : float The dots-per-inch setting used to render the text. Returns ------- int Offset of the baseline from the bottom of the image, in pixels. r)rL)rrK)rr\rrO)r7rrrvrKrr6r0r0r1 get_depthp s zMathTextParser.get_depth)rN)rr)rrr)rrr)rr)rJrKrLrrkrNrmrzrrrrrr`rfrrHr<rr8rOrrrsrrrrrr0r0r0r1r s,    rc Csddlm}ddlm}|dkr&t}td}|j|d|d\}} } } } |j|d| dfd } | jd| | ||d |j | | j |||d | S) a Given a math expression, renders it in a closely-clipped bounding box to an image file. Parameters ---------- s : str A math expression. The math portion must be enclosed in dollar signs. filename_or_obj : str or path-like or file-like Where to write the image data. prop : `.FontProperties`, optional The size and style of the text. dpi : float, optional The output dpi. If not set, the dpi is determined as for `.Figure.savefig`. format : str, optional The output format, e.g., 'svg', 'pdf', 'ps' or 'png'. If not set, the format is determined as for `.Figure.savefig`. r)figure)riNrr)rrKgR@)Zfigsize)Zfontproperties)rr,) matplotlibrrjrirrrOZFiguretextZFigureCanvasAggZsavefig) rZfilename_or_objrKrr,rriparserr4r5r6rZfigr0r0r1 math_to_image s   r)Tg)NNN)rM collectionsrrriorloggingrrrVnumpyrXZPILr pyparsingrrrrr r r r r rrrrrrrrrrrrrZmatplotlib.afmrZmatplotlib.ft2fontrrrZmatplotlib.font_managerrrrZmatplotlib._mathtext_datar r!r"r#r$ enablePackrat getLoggerrJrTr2r3rNrkrmrzrrrrrrr<r_r`rfrrHrtrrrrrrrrrrrWarningrrrrrrrrrrrrrrrrrrZ(_suppress_matplotlib_deprecation_warningrrrrrrrrrrrrrrrrrfrrrrr0r0r0r1s   L   "7K*kq,h2$   S=qO  $   ' '