j :dSrSSKJr SSKJrJrJrJrJrJ r SSK J r J r SSK Jr SSKJr SSKJrJrJrJr SSKJrJr SS KJr SS KJr SS KJrJrJ r SS jr!SS jr"SSjr#SSjr$SSjr%SSjr&SSjr'SSjr(SSjr)S Sjr*g)!uResolve figure footnotes from two sources and carry them into the document. The correction agent reads each scanned page's image and reports both ends of the association: the markers printed on the figures' labels and the note lines printed on the page. The correction sweep in `quber.core.figures.correct` records them on the pictures. This module ties marker to note and writes the result where a reader finds it. Two sources answer each marker. The agent's image read is one; the parse's own footnote-labelled text on the page — retained by the track's graft — is the other. Both are keyed by the same canonical marker, so `(1)`, `1` and a superscript one meet. Agreement corroborates the note. Disagreement, an unresolved marker, and a note no marker points at all become review flags on the run, never silent drops. A marker the agent judged a cross-reference to a named section resolves to a heading pointer, the same way a table's does. Notes are pooled across a page's figures because one printed note block serves several charts; the marker on each figure decides which notes are its. The document carries the result the way it does for tables: each resolved note is inserted as a footnote node right after the picture, so a marker inside a chart and its note at the page foot are linked in the document itself. The parse's own footnote text stays where the page prints it. Placement then goes to the value, not just the chart. The agent reports which printed label carries each marker, and that label is matched against the figure's value table; the note attaches to the matching cells' records in the digest. A marker whose label matches no value is flagged unplaced, and the note still sits after the picture. No flag is raised when the figure has no digest record or no value table, or when none of its labels keeps a word other than a stop word once the marker is stripped. Such a note is left unplaced silently. ) annotations)AnyDictListOptionalSequenceTuple)DoclingDocument PictureItem) DocItemLabel)logger)DigestedFigure PageDigest PlacedNote ResolvedNote)FOOTNOTE_MARKS_FIELDFOOTNOTES_FIELD)PageScan) label_words)canonical_markerresolve_footnotessplit_leading_markerc /n[U5nURVs0sHoURU_M nnUGHnUR(dMURn[ X(5V s0sH"oR (dMU R U _M$ n n [X5n [Xv5up[5n0nURGH(nURUR=(d S5nUcM-[U RUR/55nU RUR=(d S5n 0n0n[UR[ S5=(d /GHn[#URS5=(d S5n[%U5nU(dM;UR'U5 UU;aR[)UU[#URS5=(d S5U U UU5unnU(aUR+U5 UUU'UUnUcMUU;a&UR-SS9UU'UR+UU5 UR/U/5R+[#URS5=(d S55 GM UR15H2unnUR3[5UURU/5X55 M4 U(dGM[7XU5 U cGM!UU lGM+ U R15H3ununnU(dMUU;dMUR+S US U<S 35 M5 GM U$s snfs sn f) uResolve every scanned page's figure markers and write the results. Mutates `document` — each picture's resolved notes are inserted after it — and the digests, whose figures receive their resolutions and whose value cells receive the notes placed on them. Returns the review flags. NmarkerkindfootnoteT)deeplabelpage z: the page prints note z* and no marker on its figures points at it) _headingspicturesself_reffigurespage _page_figuresnode_id_document_notes _agent_notessetget picture_reflistchunk_idgetattrmetarstrradd_resolveappend model_copy setdefaultitemsextend_place_on_values _insert_notes footnotes)documentscansdigestsflagsheadingspictureby_refscanr%figuredigest_figures page_notes agent_notesgeneral_by_ref referenced resolutionsrecordresolvedminelabelsmarkrkeynoteflagtemplate_texts ?/home/mande/repo/quber/src/quber/core/figures/dpt3/footnotes.pyresolve_figure_footnotesrV1sE"H7?7H7H I7HG'7HF I|| yy?LW?[n?[V_m_m0&..&0?[n%X4 &24&@# "u :< llFjj!3!3!9r:G+/0B0B7CSCSUW0X+YH#''(=2>F,.D+-F .BDIOROTXXh/526&v.s#k)!)DHHV,: ;#" "JD$ T*'+K$&s+#d? ( 3 3 3 >DIOODI.!!#r*11#dhhw6G6M22NO7P8"ZZ\ T -dFJJsB4GVW*xh:%'/F$S#V%0$5$5$7 C&%ss*, D6!8 C++%8wD LIJ osL<&M>Mc US:XaO[U//XeU1S9nUR(a$[XRSRS/S9S4$SSUSU<S 34$UR U5nUR U5n UcU c SSUSU<S 34$Uc[X =(d S S /S9S4$U c[XS S/S9S4$[ US U 5(a[XS SS /SS9S4$[XS SS /S9SUSU<SUS <SU <34$)zCOne marker's resolution and, when something needs review, its flag.section)r@ section_keysrr@rtextsourcesNr z: figure marker z= names a section of the document and no heading opens with itug is defined by no note — neither the agent's read of the page nor the page's own footnote text has itrr<agentT)rr[r\ corroborated: note u9 reads differently in the two sources — the agent read z, the page's own text says )rrLrr[r+_agree) rrPrrGrFr@r%pointerr^printeds rUr3r3s{ y#VHb$Y\X]^   v4D4DQ4G4L4LWaVbceii iD6)&4$ $  OOC EnnS!G }D6)&4O O   }6 2 |TVZZZ6a7)LdRR eAh  1X?Tcg h   FqGZ;PQ vWVJ&_ 8,1' > cnSRUR55R5RS5nSRUR55R5RS5n[ U5=(a, [ U5=(a X#:H=(d X#;=(d X2;$)zDo two reads of one note say the same thing? Whitespace and case are rendering; one read extending the other is the same note cut at a different point, not a different note.  .)joinsplitcasefoldrstripbool)oneotherabs rUraras| &&(//4A ((*11#6A 7 ?tAw ?AF$>af$>?rdc HUbUR(d/$SnUHn[URURS55nU(dM1SnURHxnURHenUH\n U[U R 5::dMU R R[URUR S95 SUl M^ Mg Mz M UR(dU(d/$SRSU55n SUSUR<S U S 3/$) a<Attach the note to the value cells whose text carries one of its labels. A label the marker sits on is the join: every word of it (minus the marker itself) must appear in the cell's text. The marker follows its label whether the model drew one figure or two around it. A note none of its labels place is flagged, and it stays on the picture; a marker printed on a figure's title has no value to sit on, which is what the flag records. Nothing is flagged when the figure has no value table, or when no label keeps a word other than a stop word once the marker is removed. FrT)rr[, c3H# UHo(dM [U5v M g7fN)repr).0rs rU #_place_on_values..sA5 U s ""r r`z sits on z\ and the figure's value table has no value under that label; the note is on the picture only) valuesrreplacerrowsr[r;r4rplacedrh) rQrNrDr%triedrwordstablerowcellrcs rUr9r9s ~V]] EEMM$++r:; ]]EzzD DII 66--j RVR[R[.\]&*  "#  {{% iiAAAG vWT[[O9WI>I I rdc [X5up4UHnUR(a)URSUR3R5O URnUR5(aXd;aMeUR [ R XcSS9nM [R"SUR[U5SRSU555 g)uInsert each resolved note as a footnote node right after the picture. The same carriage a table's footnotes get: a body node after the element renders as a paragraph below it and keeps the reading order. The node carries no provenance box, so nothing sweeping printed regions matches it. A note already sitting after the picture is not inserted again, so a rerun over an enriched parse — which is what reusing stored scans produces — leaves the document as it was rather than doubling every note. rfT)rr[siblingafterz=Figure footnotes: picture {} carries {} resolved note(s) ({})rrc3J# UHoR=(d Sv M g7f)unmarkedN)r)rvrQs rUrw _insert_notes..s>++++s!#N) _trailing_notesrr[strip insert_textr FOOTNOTEr infor#lenrh)r<rAnotesanchorexistingrQr[s rUr:r:s'x9F7;{{$++a {+113 zz||t/ %%L,A,Adh%i   KKG E  >>> rdc|Un[5nUR(aURRU5OSnUcX#4$URVs/sHoURPM nnUR U;aX#4$XfR UR 5S-SHnURS5(a+UR[URSS5S5OSnUb/UR[R:wdUR(a X#4$URUR 5 UnM X#4$s snf)u^The run of footnote nodes already following the picture: the last one, to anchor new insertions behind it, and their texts, to skip re-inserting. Only a prov-less footnote belongs to the run — one this module inserted on an earlier pass. A printed footnote the parse positioned on the page never matches, so it is never mistaken for an insertion. Nr]z#/texts//)r*parentresolvechildrencrefr#index startswithtextsintrsplitrr rprovr2r[) r<rArrrchildrefsrefitems rUrrsFH18W^^ # #H -TF ~$*OO 4O5JJOD 4t#JJw//01467=@^^J=W=Wx~~c#**S!"4Q"789]a <4::)>)>>$))     TYY 8   5sD9c T0n0nURGHnURUR=(d S5nUcM-[UR[ S5=(d /Hn[ URS5=(d S5n[ URS5=(d S5R5nU(dM`[U5n U (aURXU45 MURUR/5R[SUS/S95 M GM X#4$)uUThe notes the agent read off this page, pooled, plus the unmarked ones. Marked notes pool across the page's figures — one printed note block serves several charts — keyed by canonical marker, each keeping its printed marker and text. An unmarked general note has no marker to pool under and stays with the figure the agent read it for. rNrr[r^rZ) r$r+r,r/r0rr1rrr6r#r4r) rCrBpooledgeneralrKrAentryrr[rPs rUr)r)s*,F-/G,,**V//526 ? W\\?DAGRGE8,23Fuyy(.B/557D"6*C!!#~6""7#3#3R8?? yIH  ?rdcF0nURHnUR[R:waM#UR(aURSR U:waMS[ UR=(d S5nUcMvURUSUS5 M U$)zThe page's own footnote text, keyed by the marker each line opens with. These are the footnote-labelled items the parse produced and the track's graft retained. A line opening with no marker defines nothing to key on. rrr]) rrr rrpage_norr[r6)r<r%rrparseds rUr(r(2s E ::.. . yyDIIaL00D8 %diio26     VAYq 2 LrdcN/nURHnUR[R:wd(UR=(d SR 5(dMKUR URUR(aURSROS45 M U$)zGThe document's section headings with their pages, for section pointers.rr) rrr SECTION_HEADERr[rr4rr)r<foundrs rUr!r!Dsr#%E ::44 4TYY_"r%digests rUr&r&Ns) [[ F#)#54 =2=rdN)r<r r=zSequence[PageScan]r>Dict[int, PageDigest]return List[str])rr1rPr1rr1rGzDict[str, Tuple[str, str]]rFDict[str, str]r@List[Tuple[str, int]]r%rrz,Tuple[Optional[ResolvedNote], Optional[str]])rmr1rnr1rrl) rQrrNz Sequence[str]rDzOptional[DigestedFigure]r%rrr)r<r rAr rzSequence[ResolvedNote]rNone)r<r rAr rzTuple[Any, set[str]])rCrrBzDict[str, PictureItem]rz@Tuple[Dict[str, Tuple[str, str]], Dict[str, List[ResolvedNote]]])r<r r%rrr)r<r rr)r>rr%rrzList[DigestedFigure])+__doc__ __future__rtypingrrrrrr docling_core.types.doc.documentr r docling_core.types.doc.labelsr logurur quber.core.figures.dpt3.modelsrrrrquber.core.figures.graftrrquber.core.figures.modelsrquber.core.figures.valuesrquber.core.fusion.footnotesrrrrVr3rar9r:rr)r(r!r&rdrUrs%B#==H6__J.1aaQQ Q#Q Qh' ' ' ', '  ' $ ' '2'T@$ $ $ %$  $  $N22 2E>$>rd