jdxSrSSKJr SSKrSSKJrJr SSKJr SSKJ r SSK J r SSKJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJ r J!r!J"r"J#r#J$r$J%r%J&r&J'r'J(r(J)r)J*r* Sr+\RX"\-5r.SS jr/SS jr0SS jr1\4SS jjr2"S S5r3"SS\35r4"SS\35r5g!\ a Nf=f)aOffice Math Markup Language (OMML) to LaTeX converter. This module provides functionality to convert Office Math Markup Language (OMML) elements from Word documents into LaTeX format. It handles various mathematical constructs including fractions, subscripts, superscripts, matrices, limits, and special characters. Adapted from https://github.com/xiilei/dwml/blob/master/dwml/omml.py on 23/01/2025. ) annotationsN)AnyIterator)_Element)UnicodeToLatexEncoder)ALNARR BACKSLASHBLANKBRKCHARSCHRCHR_BO CHR_DEFAULT D_DEFAULT F_DEFAULTFUNC FUNC_PLACEGROUPING_FUNCSLIM_FUNCLIM_TOLIM_UPP MATH_CHARSPOS POS_DEFAULTRAD RAD_DEFAULTSUBSUPDFMTz<{http://schemas.openxmlformats.org/officeDocument/2006/math}c## [R"U5nUR[S-5Hn[ [ U55v M g7f)zLoad and convert OMML elements from a stream. Args: stream: Input stream containing OMML XML data. Yields: LaTeX string representation of each oMath element found. oMathN)ETparsefindallOMML_NSstr oMath2Latex)streamtreeomaths \/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docling/backend/docx/latex/omml.pyloadr0?s= 88F Dg/0+e$%%1A Ac## [R"U5nUR[S-5Hn[ [ U55v M g7f)zLoad and convert OMML elements from a string. Args: string: XML string containing OMML data. Yields: LaTeX string representation of each oMath element found. r%N)r& fromstringr(r)r*r+)stringrootr.s r/ load_stringr6Ms= == Dg/0+e$%%1r1cSn/nURSS5nUHCnU[;a#U[:waUR[U-5 OURU5 UnME [R "U5$)zEscape special LaTeX characters in a string. Args: strs: Input string to escape. Returns: String with LaTeX special characters properly escaped. Nz\\\)replacer r appendr join)strslastnew_chrcs r/ escape_latexr@[sh DG <<t $D  JTY. NN9q= ) NN1   ::g c@UbU(dU$URX5$U$)atGet a value from a dictionary store or return the key/default. When default is provided, this function always returns a non-None string. Args: key: Key to look up in the store. default: Default value if key is None. store: Dictionary to look up the key in. If None, returns key directly. Returns: Value from store, the key itself, or the default value. )get)keydefaultstores r/get_valrGps$ s8UYYs%88rAc\rSrSr%Sr0rS\S'S S SjjrS SSjjrS SSjjr S SS jjr SS jr S r g) Tag2MethodzBBase class for processing XML elements by mapping tags to methods.dict[str, Any]tag2methNcURRnUc URR[S5nU"U5nU(aU"X5$g)zCall the appropriate method for an XML element based on its tag. Args: elm: XML element to process. stag: Optional simplified tag name (without namespace). Returns: Result of the method call, or None if no method is found. N)rLrCtagr9r))selfelmstag getmethodmethods r/ call_methodTag2Method.call_methodsFMM%% <77??7B/D4 $$ $rAc## [U5Hun[UR;aMURR[S5nU(aXB;aMGUR X4S9nUcUR X45nUcMoXEU4v Mw g7f)zProcess children of an element and yield results as tuples. Args: elm: Parent XML element. include: Optional tuple of tag names to include. If None, includes all. Yields: Tuple of (tag_name, processed_result, element) for each child. rN)rRN)listr)rOr9rUprocess_unknow)rPrQinclude_erRts r/process_children_list Tag2Method.process_children_lists}s)Bbff$66>>'2.DD/   /Ay''19B- sBBcX[5nURX5H upEnXSU'M U$)zProcess children of an element and return results as a dictionary. Args: elm: Parent XML element. include: Optional tuple of tag names to include. If None, includes all. Returns: Dictionary mapping tag names to their processed results. )dictr])rPrQrZ latex_charsrRr\es r/process_children_dict Tag2Method.process_children_dicts3f 44SBJDQ ! CrAcZ[R"SURX555$)zProcess children of an element and return concatenated string result. Args: elm: Parent XML element. include: Optional tuple of tag names to include. If None, includes all. Returns: Concatenated string of all processed children. c3l# UH*upn[U[5(dUO [U5v M, g7fN) isinstancerIr*).0rRr\rbs r/ .Tag2Method.process_children..s0 "JJDQ$Az22A>"Js24)r r;r])rPrQrZs r/process_childrenTag2Method.process_childrens-zz "&"<")Gr+i.z,Convert OMML oMath elements to LaTeX format.zdict[str, str]_t_dict)boxnumdendegrbr_oMath2Latex__direct_tagscP[SSSS9UlURU5Ulg)z[Initialize OMML to LaTeX converter. Args: element: Root oMath XML element to convert. z braces-allkeepF)replacement_latex_protectionunknown_char_policyunknown_char_warningN)rurl_latex)rPelements r/roMath2Latex.__init__4s- )>)5 &!&)  ++G4 rAc:URRSS5$)z,Return LaTeX string with normalized spacing.z  )latexr9rs r/roMath2Latex.__str__Aszz!!$,,rAc"UR5$rrrs r/roMath2Latex.__unicode__ErrAclX R;aURU5$USSS:Xa [U5$g)zHandle unknown element types. Args: elm: XML element. stag: Simplified tag name. Returns: Processed children for direct tags, Pr object for property tags, or None for other unknown tags. Nr)rrlrrps r/rYoMath2Latex.process_unknowIs; %% %((- - "#Y$ c7NrAcUR$)z:Get the LaTeX representation. Returns: LaTeX string. )rrs r/roMath2Latex.latex[s{{rAcURU5n[USR[S[S9nSU;aX2S4-$U$)zwProcess accent element. Args: elm: XML element containing accent. Returns: LaTeX string with accent applied. accPrACC_VALrErF%srb)rcrGrrr)rPrQc_dictlatex_ss r/do_accoMath2Latex.do_accdsQ++C0 7O  Y)?s  7?Sk^+ +NrAcURU5nUSn[UR[S[S9nSU;aUR XBS4--$UR U-$)zProcess bar element (overline/underline). Args: elm: XML element containing bar. Returns: LaTeX string with bar applied. barPrBAR_VALrrrb)rcrGrrrrrPrQrprrs r/do_baroMath2Latex.do_barwsb++C0 G_"&&+i*@L 7?77g67 777W$ $rAcFURU5nUSn[Sn[UR[S[S9n[UR [S[S9nUR [U(dUO [U5USU(dUO [U5S.--nU$)zProcess delimiter element. Args: elm: XML element containing delimiter. Returns: LaTeX string with delimiters applied. dPrnullleftrrightrb)rrr) rcrrGrr#rrr r@)rPrQrrrs_vale_valdelims r/do_doMath2Latex.do_ds++C0 E]  9V+ww jj/ 58IJ J  rAcURU5nURSS5nUR[URSS55$)zProcess function application element. Args: elm: XML element containing function application. Returns: LaTeX function string. fNamerNrb)rcrCr9r)rPrQr func_names r/do_funcoMath2Latex.do_func+sB++C0JJw+   VZZR-@AArAc/nURU5Hup4nUS:Xau[R"U5(aUR[U5 MA[R SU5 [ U[5(aURU5 MM[ U[5(dMURU5 M [R"U5n[U;aU$U[-$)zProcess function name element. Args: elm: XML element containing function name. Returns: LaTeX function name with placeholder. rz0Function not supported, will default to text: %s) r]rrCr:rrrhr*r r;r)rPrQrarRr\rbs r/do_fnameoMath2Latex.do_fname8s 44S9JDQs{88A;;&&tAw/LL!SUVW!!S))#**1-*As##""1%: JJ{ #!Oq7Z7rAcURU5nUSn[UR[S[S9nSU;aUR XBS4--$UR U-$)aFProcess group character element (e.g., underbrace, overbrace). According to OMML spec, when chr is not specified and pos is not specified, the default position is "bot" (bottom), which corresponds to underbrace. Args: elm: XML element containing group character. Returns: LaTeX string with group character applied. groupChrPr GROUPCHR_VALrrrb)rcrGrrrrrs r/ do_groupchroMath2Latex.do_groupchrOsc++C0 L !"&&+n*ESQ 7?77g67 777W$ $rAcURU5nURS5nURS5nU(a [XCS.-$[SU0-$)ztProcess radical (root) element. Args: elm: XML element containing radical. Returns: LaTeX radical string. rbr)rrr)rcrCrr)rPrQrrdeg_texts r/do_radoMath2Latex.do_raddsO++C0zz#::e$ 88 8&$/ /rAc [S[R"URUSS9VVVs/sHup#oCPM snnn50-$s snnnf)zyProcess equation array element. Args: elm: XML element containing equation array. Returns: LaTeX array string. rrbr)r r r;r]rPrQrRr\rbs r/do_eqarroMath2Latex.do_eqarrusO CHH%)%?%?V%?%TU%Tzt%TU   UsAcB^URUSS9nURSS5mURSS5n[R"T5nU(aUSU0-$[U4Sj[55(aTSUS3$[ R S TS 35 TSUS3$) zProcess lower limit element. Args: elm: XML element containing lower limit. Returns: LaTeX string with lower limit applied. rblimrrbrNr.c3L># UHnTRUS35v M g7f)rN)r)rifuncrs r/rj(oMath2Latex.do_limlow..s#Gt$r{++s!$z_{rzLimit function z2 not in LIM_FUNC dictionary, using fallback format)rcrCranyrrr)rPrQt_dictr.rrs @r/ do_limlowoMath2Latex.do_limlows++C+Fzz#r"jj#,,t$ eS\) ) GG G GV3se2& & dV#U V s3%r""rAcvURUSS9n[URS5URS5S.-$)zProcess upper limit element. Args: elm: XML element containing upper limit. Returns: LaTeX string with upper limit applied. r-rr.rb)r.r)rcrrC)rPrQr3s r/ do_limuppoMath2Latex.do_limupps:++C+FE!2FJJsOLLLrAcj^URU5R[S[S5mTR5mTR [ [ -5(aTSSR5mT(a7[ U4Sj[55(dTRS[ S-5mT$)aeProcess limit content element. This processes the lower limit of limLow and upper limit of limUpp. It handles special formatting for limit labels including: - Replacing `rightarrow` with `to` - Stripping trailing line breaks - Escaping spaces in plain text labels Args: elm: XML element containing limit content. Returns: Processed limit string. rNrc3,># UH oT;v M g7frgro)richarresults r/rj%oMath2Latex.do_lim..sDfnsr)rlr9rrrr r2r)rPrQr=s @r/do_limoMath2Latex.do_lims&&s+33F1IvayI ??9y0 1 1CR['')F #DDDD^^CS9F rAc/nURU5H'up4nUS:XaMUS:XdMURU5 M) [S[R"U50-$)zjProcess matrix element. Args: elm: XML element containing matrix. Returns: LaTeX matrix string. mPrmrr)r]r:r"r r;)rPrQrowsrRr\rbs r/do_moMath2Latex.do_msX44S9JDQu} A : FCHHTN+++rAc [R"URUSS9VVVs/sHup#oCPM snnn5$s snnnf)zvProcess matrix row element. Args: elm: XML element containing matrix row. Returns: LaTeX matrix row string. r(r)rr;r]r)s r/do_mroMath2Latex.do_mrs@xx!%!;!;C!;!P Q!P:4AQ!P Q  Qs< c/nSnURU5H8upEnUS:Xa[URS[S9nM'UR U5 M: U[ R "U5-$)zProcess n-ary operator element (e.g., sum, product, integral). Args: elm: XML element containing n-ary operator. Returns: LaTeX n-ary operator string. rNnaryPrz\intr)r]rGrrr:r r;)rPrQresborRr\rbs r/do_naryoMath2Latex.do_narysa 44S9JDQxQUUG6B 1 : EJJsO##rA-rz\times )u–u—u−r×_MATH_CHAR_MAPcXR;aURU$URRU5nURS5SLaIURS5(a3UR S5SLaUR S5(a SUSSS3nSU;a$UR SS5nUR SS5nUR 5RS 5(aS US 3nU$) zProcess Unicode character and convert to LaTeX. Args: s: Unicode character to process. Returns: LaTeX representation of the character. rFrrr:r ensuremathz \ensuremath{z\textz \text{z} )rRrunicode_to_latexrrr9strip)rPs out_latex_strs r/process_unicodeoMath2Latex.process_unicodes ## #&&q) )//2  LL  &((-- 35(&&s++ a 34A6M = ()11/3GM)11#s;M    + +H 5 5' c:MrAcf/n/nURS[S35nU(a<UH6nURU5nURU5 URU5 M8 [ [ R "U55n[ R "U5nSU;aSU;aURSS5nSU;aSU;aURSS5nURR5HAupU [;dMX=(d S;dM!SU 3U;dM,URSU 3U 5nMC U$) zProcess run element containing text. Args: elm: XML element containing text run. Returns: LaTeX string with text properly escaped and formatted. z./r\rz\{rz\}rNr8) findtextr)rYr:r@r r;r9rRitemsr ) rPrQ_str _base_str found_textrWrXproc_str base_proc_strorigmappeds r/do_roMath2Latex.do_r"s \\Bwiq/2  $ 4 4Q 7  M*  #   4 01 9- m #(9''s3H m #(9''s3H !//557LD%-2.MX-#++bM6B 8rAaccrbarsSubsSupsSubSuprrfr0rgroupChrdradeqArrlimLowlimUpp)r.mrCnary)rrN)rrrrvrr)rr*rsbool)rr*rr*rsr*)rWr*rsr*),rwrxryrzr{r#rr|rrrrrYpropertyrrrrr staticmethodrrrrrr rrrrr!r%r*r4r7r?rErHrNrRrYrerLr}rorAr/r+r+.s6G^%FM?F 5-$&%$2  > >  " " 0&   , B8.%*0"  #: M6,"  $( &NNB&P v T v     :  v v T   K T v  )!" )#$ +HrAr+)r,rrs Iterator[str])r4r*rsrx)r<r*rsr*)rDrrrEr*rFz dict | Nonersr*)6r{ __future__rloggingtypingrr lxml.etreeetreer&rpylatexenc.latexencoder ImportError%docling.backend.docx.latex.latex_dictrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r) getLoggerrwrr0r6r@rGrIrr+rorAr/rs#  <> I" & &*AD&__DFFRr*rm  sB00B98B9