5ojSrSSKJr SSKrSSKrSSKJr SSKJr SSK J r Sr "SS \ 5r "S S \ 5r "S S \ 5rSSSjjrSSSjjrSSSjjrg)aOCR grounding well: page text read from a rendered image, with provenance. A scanned page or an image-bound figure has no native text layer, so a value extracted from it has nothing to ground against. The well fills that gap. It runs RapidOCR over a rendered page image and keeps every recognized fragment with its bounding box and confidence. For a render of an original PDF page the box is stored in PDF points, so a fragment grounds a value from a scanned region the same way a native text cell grounds a table cell. The well is evidence, never a correction target. Fragments are stored exactly as the engine read them; anything that interprets or repairs them happens in the consumer, against the fragment ids, so the trace from a value back to the pixels survives every downstream step. ) annotationsN)Path)Any) BaseModelgR@cL\rSrSr%SrS\S'S\S'S\S'S\S 'S \S 'S rg ) OcrFragmentz;One recognized text fragment and where it sits on the page.stridintpagetext!tuple[float, float, float, float]bboxfloat confidenceN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r1/home/mande/repo/quber/src/quber/core/ocr/well.pyrrs"E G I I ,+rrcp\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S 'SSSjjrSrg)PageWell(z(Every fragment read from one page image.r r r image int | Nonedpirwidthheightlist[OcrFragment] fragmentsc >Uup4pV/nURHnURupp[S[X5[X5- 5n [S[X5[X5- 5n[X- X- -S5nX-U- U:dMtUR U5 M U$)zAFragments whose area overlaps the region by at least min_overlap.ggư>)r&rmaxminappend)selfr min_overlaplefttoprightbottomhitsfragflftfrfbinter_winter_hareas rfragments_in_boxPageWell.fragments_in_box2s $( 5NND!YYNBB#s2~B =>G#s2R=>GBG,d3D!T)[8 D! # rrN)g?)rrr,rreturnr%)rrrrrrr:rrrrrr(sO2 I J O L M  !/  rrcB\rSrSr%SrS\S'S\S'S\S'S SjrS rg ) DocumentWellDz7The wells for every page read from one source document.r sourceenginezlist[PageWell]pagesclURHnURU:XdMUs $ [SU35e)Nzno well for page )rBr KeyError)r+page_nowells rr DocumentWell.pageKs6JJDyyG# *7)455rrN)rEr r<r)rrrrrrr rrrrr>r>DsA K K 6rr>c SSKJn U"SUS.S9$)a RapidOCR configured the way the tuned-financial preset runs it. docling propagates the CUDA device to RapidOCR's paddle and torch engines but not the default onnxruntime engine, so the CUDA execution provider is named explicitly here, matching TunedFinancialParser. r)RapidOCRT)z!EngineConfig.onnxruntime.use_cudaz.EngineConfig.onnxruntime.cuda_ep_cfg.device_id)params)rapidocrrI) device_idrIs r make_enginerMRs" 15>G  rc8SSKJn Uc [5nURU5nURupgSSS5 U"[ U55nU(a [ U- OSn /n [USS5n [USS5=(d /n [USS5=(d /n U b[[XU SS 95HununnnUVs/sHn[US5PM nnUVs/sHn[US 5PM nnU R[S US U3U[ U5[U5U -[U5U -[U5U -[U5U -4[U5S 95 M [U[ U5UWU -WU -U S9$!,(df  GNS=fs snfs snf)zRead one page image into a well. When dpi is given the fragment boxes are converted from pixels to PDF points, so they land in the coordinate frame of the original page. r)ImageNg?boxestxtsscoresF)strictpz.f)r r rrr)r r r"r#r$r&)PILrOrMopensizer POINTS_PER_INCHgetattr enumerateziprr*rr)r(r) image_pathrEr"rArOimgwidth_px height_pxresultscaler&rPrQrRiboxrscorerUxsyss r read_imagerhcs ~ J 3!hh C O $F%(Oc !cE#%I FGT *E 664 ( .BD VXt , 2F %.s5u/U%V !A!T5'*+s!%!+sB+'*+s!%!+sB+   7)2aS) TB%B%B%B%  %U|  &W"  *o 5   7 ,+sF?FF Fc*Uc [5n/n[R"5nUHn[U5SUS3- n[R "SS[ U5SS[ U5S[ U5[ U5[ U5/ S S S 9 [[U5RSUSS 355nU(d[S U35eUR[US XbUS95 M SSS5 [[ U5SUS9$!,(df  N"=f)z:Render the named pages of a PDF and read each into a well.Nr 04dpdftoppmz-rz-pngz-fz-lT)checkcapture_outputz*.pngz$pdftoppm produced no image for page r)r"rArK)r@rArB) rMtempfileTemporaryDirectoryr subprocessrunr sortedglobFileNotFoundErrorr*rhr>) pdfrBr"rA page_wellstmprEprefixrendereds r build_wellrzs~!#J  $ $ &#G#Y4}!55F NNHLLHK #  d3inntGC=-FGHH'*Nwi(XYY   j!gvV W+ '. s3x * MM/ ' &s CD D)r)rLr r<r)NN) r]rrEr r"r!rArr<r)i,N) rurrBz list[int]r"r rArr<r>)r __future__rrprnpathlibrtypingrpydanticrrYrrr>rMrhrzrrrrs # ) y8 69 6( 11 1 1  1  1n !N !N !N !N  !N  !Nr