From c4a35c2d38174637d7387315daaebd9a70267531 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 19 Mar 2024 16:21:13 +0100
Subject: [PATCH 01/91] addition preliminary ublad corpus

---
 backend/corpora/ublad/description/ublad.md |   0
 backend/corpora/ublad/images/ublad.jpg     | Bin 0 -> 208713 bytes
 backend/corpora/ublad/ublad.py             | 207 +++++++++++++++++++++
 3 files changed, 207 insertions(+)
 create mode 100644 backend/corpora/ublad/description/ublad.md
 create mode 100644 backend/corpora/ublad/images/ublad.jpg
 create mode 100644 backend/corpora/ublad/ublad.py

diff --git a/backend/corpora/ublad/description/ublad.md b/backend/corpora/ublad/description/ublad.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/backend/corpora/ublad/images/ublad.jpg b/backend/corpora/ublad/images/ublad.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..0f9d3a87e99061301d194eabff1ae4ad98add8d2
GIT binary patch
literal 208713
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%0AE2h+nE(CVw1CHw`X@o+pU$@YFABg%9luaMB69
zWL&>D@W=P<p~smj8NhB@kd|LDx5G73==BH=NY+fq{BGC?YvLJix_>U7GDtVc|3k?>
z$|cvm<oEtpwSm8EqF5R?CaOB>(u=S<PqNRRuF=dRoRUu}O_KZ-_y-tRtnt<f^7i=%
z=YITn?{iwDAzyP6Pu_H13T_r9p<2qBBrMrhVz9j7>{|DE8_<feu`GLc<()hx{IX7d
zDR#<Nra@O$x;RW$RVS4?R+olj?-w&=4&9#(OALWzX!_+HTBm}(bMCtHNN<=7#Y}zk
zQJ(vm?79^=4qD|t#uPA$i#jnK71QQx&!MaIn3UIIN1DGPf6YH{5nyHl$NWfR{nvu7
z+x+P1xfW@!%0Om9<<kD23;N`<pCytCV183AB@X~{k(-6BQdDjD>8g=_Tx~1@<n_Ml
zcC8(5;Acw|x-tarfi&yWw$`ZPep}0Vx<F2@%ob32q=L%$SSO^lH0Q-YMd!<v`eNN3
z&E4YhR8CU@p4*Zy+0GSzMRn(^h$+FGNmc=`JOQZeV(SBMDDj@Wm*3jZE8*HNK$Qy|
zZrl%rU%RtnvQ}JJ(gt0d_2YnKMgn_YR6*$?t05na2odhS<7C#xR}(*v964Hp*YWZn
z03Ndor**6Rig}m{!rnxyLg|uwv-zCJKI3oSO&uNZ1QWW>u1}G%0VS2{<-{$Ml<`ja
zP6&qnm-=*2NSC`Q{~K}{zYu@V_!CI%1?M)!1HiV;PfyN#<idXsN+G!ptp8$P$YA%B
z%ld+&CHAVX=sp)Tdubb~xMl7g*@R9DWZM*WO(rV%F}(hA`s{#+J>t2Kkh52rAAAGN
z_iHgkc5ZF4LH!~%qUW~I0_P^Kt9If%@uTddd2`n5Y3-Q9x4766qb{ZAk~@&fPab94
z<2%8C4_rzeBBqGvifOXS-|IfRd<Y>nwPW1rs#XjF+#X1t0oYc|M`SBM{s<AUiCcMb
zm^8q`aIwis&~Z+?O$T~h8!DJqm6t=3r0Ar&Ky-o0B%6N9E~MhCqkSDbJ$=#aRlaER
zH>vZ>!hQ&Ybg?oRZ-GRzwNy|~yfU5;ln_c@UgiD(pz_Wi2ewGX=q)j7T7wZm3LxSm
zZ%Jm>P8OEBx}4XPy|Eld;^QpE#if!du|JyOe0HP9N0hvF)b3gcoC9)@<z*GYYAbtT
z@&iC|&rW_9Q=6NE)D2w><%Aca5DW?ebBat?#rkby6~KsFk&1PGN6sSvB*w~2KbgVE
z<7--^2tU-`q6RuLjCE6r$#HH)(#R&#=rtm4WJb35p>ehXKmVDL@&8s9ncWhRSXmLp
z1t>t^NO_Vq5)eg5g17hJ30HjoKEc9BxFLOqv%SCVIPzP#{orxmH=M#z#Qn*?fjf2w
zc^hdq?^}Tfz_zx{a<2!U<Or_N(EFowDXX;k;SGf071MO;)#F~XB}Nq0(jvZStrty;
zc^Ux$=X4>jhh~Ayj-gZpBN&#}dzG<zn6YLaHvbZ@Zo(xXc_lyBZ_m;a8dobq_as65
z_vWSuk+2kPcaCiGk?pI(t6bw_@|w_s>c@0H|AI-sE+(2P)F4WJtTNcltGV&1&F!m~
zg!7}wigbUe_;;KQ9_z0_`<rCGO`gf2n0u*b7fOF`(1HxYrW<!K?LBuA5szG2JzNk&
zOascSiCXJu&X8htlu%mRyDuGXjhexsT@-)jahgV0)4Yg=FFuQ>a(eV-C-!tuj;xU}
zjBg(`*4zKM+I;V5lcD#o`%dz>uRl6}P+@DcshK_A<%%ZY&ZB8$s;Su9#nE*+!*F&j
zCCfk~U!lgxz+cYDPfO-Vd2cF;sS!whpo{-z;dWFEoHOY-hv|~Yh2S#zOBW*Jp35Oo
z`SO8zcmo9pU?eb(wFT$OA&I1q;EAjJWqvUP;KLd#LQ`<hM}#QEp<zNP_pudnGQ|PB
zLx<!Pb|f@hu{80M0{4{n`k2N6L&CnY<B=v`fPgl)f*ZIYTqRdaNmx(1C_}L}>$DG;
zGEFP!_=&pf`_~+Zp;7-wG0iw5>7pc6cMW?3K*2^%Z3|=+>#j8Dc0vQVB5|IF<HbfV
zQ%o60D4mDP(FA2lyejloMl9JOZIq12z$}WaC~a%xKS+f8Hx#=<BBQfd^-A*I1aL`)
zEuhdb<}-NjtoZvO*UCz8<!P1$s+z)3nd?%T+1*IWuLY;NB>PKFC;);fh1(rtmmL4V
z4G!ixtt@8pvqnTIW5O)Gg_NY1sKknZyJ=iBcYwM*0%C1AL|;mu>53DhJtPDG#vcm|
zEAmBgR*&d3oK<Pc``P-TG}Z(F8k?ChmPS`&5?A_CgbW%CfK#~c3ZV4_Dr;2nCJ(95
zCwk&rtoW670i4K2MWomSeEXIO0x=-|0TmnMfIneaud2XN_|uh-=3{<Vb<>J2`noQ+
zmmt^kYr*pGm{w(@^WIr$EAz<P+KHIIc9WB~&#E&Gj@$m4ZQD$~pOa0JohG<zoo*Vt
z(8<)bJx8+)mdYP`S0kW)rw%{2P{I`yZ#}EbHseq9R<qU*<A&=|I8`xDqvPFRX|fEQ
zr~)MS_coaE3bV{}4GZhRB;|@!DoAC4)X<ZA?Y{JMspj5kt@M+Fxi|>6^uT2~1XF_-
zcFI&qr=)*u@GiVW9+~yJ7^PJct}v0xC-h4gfIOTAmG<%JlSU=R*6SSmD!OyJRJ6o2
z%W5kG8`h#G;Wp>}dqIMaDC4ok`I#U0UQR<`<q-;9Ub160-Clbsv9ynSZDchhNpy`C
znEy(N0nTX^->+V8UWI|_ajk7%8^|(|$DEC<8@rw?H=eh}58NrQDZFxNjWMjPg-M(!
zos^|t05ApU)^=c9)3Ht8nm8iDho7^W=~3AFX{E7#;`919u63CneJu&?h7A1?)gES6
z8s=TW4N@1z^IX5w%C`nPA}I_z%l#5Ao=Vx&p+r8aMo+uwPEoQONMoymc%{z<OAauT
zekxZkQ4aGETa0mi%OHk6@S6K0)X*dCWc9Swke=%Kf-`t<tx-E|baUeE#V>2+h}^4-
zS8eJF@KmGVQLoy-NWN)d(3;-K?2FI33?j_EFZulyAZBXC_cfSW(}LU-YyCzjAY!rg
zU}V+wJS9Z%PF4h`w*4gtWYcmrvKlvw5*puG0@b!>+YP=@<03`HjKj^wLSrWX{gce4
z7W!A2>Fo9?n(8YOW9oxjD>cX_u)mGonU_|5m{$AO`jvTjjO)cCa*4?Z0UXoG{Ha!*
z9+T$A7(ITLrv{O$2I?#rTdl5*hgwX$aDfZG$YoExLu|?bn;r|7=h+#%s86#{RxVmu
zTJ;IlI>!ix2nGkAm!4HU_PEJc6^&KRqR1RH1z^eMv@fN-|K@lr(Hk$<3rV~v|9(7_
zngOLae-Z+n(sCj>^h2vsX<F0v>eE~$nuofK?LXd6&Z&sc{d<06uCnSwN%6>1!&Z#;
zFD{V*i_EtAhR0BCrY^UuvyHkz&Tz=bYg&n9wB$@UsJ2eC%G(pZ^PP>|EeW6(W<NO@
zZ{+wXSXP9}-Pny$u%SBk^idQ}fc&&rQAo?nw!oIpW5&9%`nmj7xY0R8cd}+jFzAL!
z^G((14-Wx1AH~O92G}D%haZ=}8Z3#kZiwhV^2bA&e-v3wNB8LKSNH21epcE$gc1jp
zuE|xnbo)qFH2elLkB;1Q_#IfcXS)?>J9A~gYcEdOW!?&d&$b$bDpucj!CUJqBvgf$
zoOPQxCkU2m{o=N@ywU<Rcvu)Gt#`(L;13%JW7>v?BaiHM=4#~?D*N)TWM#BMQ?w;M
zOh}L5R9H@6v62dli`|xnuo_zz4%H5=hLNP1oqT>t`*Q|0mB2L@fv86qp@mU+?^A+H
z-9DrnC1EkEL0LeI6H~3a!3AxFzq^>41G@<RGA!gxGlRYIpT1SC8{9e-yG>?UD}b#_
zHdNWEx~zsNFp5rCYki9P^Ug3U2G(ELXX7f@!g#U7+cbH8>Ri;rlwPJ7It--(rKy*O
zl-=kWp54=pT5Gc|IZnXpQdZ`>3f#?Q74{tjK3Y6NOfySdp)3Ypm#+!TTkTy||M^Mf
zSS53wpJpw*A0(^(>1hjm_xH_=au~J*9+E6N%giYf`0pq$X?7=UNg|z>1OP%*xa<U_
ztD7aw?HVs?BsaZ2ss16A1BU-Q1{gX<678{d-tkHIaqkl~d@En|p~{9Zm|66K`x3e!
zlzTQ5tJbVh0QC4|hyv)s{m3f$rHQ7tibl(~;;d601)1VtU^hr>FdYcv7wd^jN`k->
z3*MwgvW3xoRJ4sK-|})xyyKFMi5cJ3>o{V(u}-dzhpC4DsYqko`Y!zdNc;*q<FuLa
zn*C$v1UdXv;>MydnqSxUfuUkRT&0Dc&0h3k&tTV%q&BS4V&<#RYn+%C|CB?rP?oRd
z);qFqgX{fi(j{h&dm0u09VybHo_2f$ZsxG2o6@Iqgc_r1cGXPIVcjvtV}~K$rA5|m
zjPdEu3~}MqG20P@H~+-$7h8j>RIl26Xdtj`*%GS3C*`aL1&-J7(<puGsk6-?n!iO&
zHXq4FMMV{OKj83FPWu+oaRuIt^O5i~p_0us&$$4hy!esZl`0ljZUwuS8IKc%dd;bu
zf}B00^y`8!Jz1zDhV{e5O?{ye{MLcNzU`n|_~i9;UprOXaogxiXqXrK{lbbptAiXP
z(zJiEk=58v`R+xnb_bq2=?dM)7a#N;D6U?&2P1K$k#j92L&LIJb)3J?Xd3>8ZN;PF
z&(3KXo`Q4SdYQb>D>M`mS7tC0U{;_xa)iJnGbW;$)+IL|0Qmg}tOlHz6AjiI!YX~k
z=<I*UsjJy({Z%!QxNteIHC;L@J|(J%?E(ZZy6&{%Jgq;YMAr?>GWgx$M}hg|dxeDX
zTa*CkICBX+3%M7t24-Jt{79<=Q>LHFSo`BeC>O2Y3XjB~3qeU$8Tl(QIrj=4JNF`J
z<)F7&k(<(Yc=GznhP&4EXTU=_z5<55WIYC)3jfUa$EVg!nT7@|y0817A&S;G2pQWp
zNTgcxyB%wz`Yik3uI5H`ft!g-AW<VdNFZy1iE_reY>5SzY+atFXb;3OgezdA&bra+
zNL=LS!dz!fiCmEP!d=QpBq+^g`IAeGF3gMDDq&u26me-gJK|_57QZX{qQ2L%hjEap
zNbSkXUsBO$tQBGm(`024X*TB`ruP?}I`(8eNg%DXcUAJ*KuC6V?0mQ$P559J!yUgs
z)7drAuS|`W&*BFH*hEj>`9tpA;Hl|kzRjLDroGix2QY4<uqwx#FKbaE1Cr7Quaayn
zW8+2U7!U-N>$$hc^OEO#1}j5>E}O~kgrcz4qY+cTj_CTwLj#h(|EzI&$=sVT?P7e_
zd^2^JUFi19P5RxUk-(P>$Oe+xFQ;us0T4HFYpcoOmNRrPU#h1~$`o`yuS0ipGMF&s
z`K=2V8NJM8I&;RXNRsTwWRWT%>V<gILvU8Yc083$+HLZZgw!$M?K%NR+UOAd>V2=n
z3a55-2TuHDUKbI)SSgP50F%igzH|Xs00BJtLtL3u$($U3Zx?$jGsjKchzt<A-1~6@
zcGLCUzu1v9=Eyn>SmB=3^n}wf3XzrLQGWGx=>E+KjoSXQPTbm0245X-94e`to(9QT
z&9D#MP->b3+-Pom1<0iKo2yqXqov<9rLsGOrx<{rq+zPh%S^3;^)zp8%nIP}grQct
zq`5BaH-ldx$iP?mWUYzeH)fR;^1&IgYqReVzX?iq;KQ!*{(PO@?->Sej9?$0HjTMa
zTIv@536x{c)|=^lPb@Z~<z7@#ruH);%^^O!Z{ri-7A9*hpFs45e?dG-Z>0=h0+v(f
zack-NRPgN&UQwJD=f(?3VUfJaWJilJ%crkl8s1KumoGFt9g|^Me%6EC_4weW+C#~b
z-aVmTf?>xD)E!eLi=C=tJxFN<0gXi=olTdYI43g)cV*8$Ibs(Be`qDi6c?>E9+)Uw
z{N%(nAIo`S9TKMh0H`FnD@VRmGVSaqi(pvoN~ExG0qs&Jb~lNIaTZgwNRo&78PtcC
zT1=|TXPw#xz-rZx4CR;{ilqBgd8#0Na1L$COxXAO?zp~cj0T0JHO&_Wj$ToYn6Ht&
zNoAwK#v10+Tx*aZCAKEkafI8>=HYVU$DbNnFQ|Iqru^;VR2BRihGm`ozSoQR0brs{
z<7P0h%9%V(+<T1a&7ILLY?`v3vs&ymS|i-lKWu&@APyqkPS)JwPIG@EGm<XgQ3pg$
zCH420GvcWd=h*{9@#OY2wG$yqs)Br?e1fj1<ln!Lk}x#I@!99=#C*#d>S<?8$>epm
zu2emCT}4_&>hmX7A*+eEKTELl+sF3<pBjd_(X3MZ=CWR^1jC6GQ=|G=XhwaN$AzFr
z(Pn~Y%mR9i)Ru0?D!laMpJL+1t`lf%V&g;Q1@cBXHMvvV4|_jr1#)AOC~rYMWg%k+
zn1IB;0eqx6l`BC)7Du=i&7MH(ph{dq03a8$zJCBjW9lh76Z(ZcZ7^-N`P|>lV*Px2
zGT)@?ah_-%_a}d=QOtIvA@6YuWJ*3S7y0g%Vt3zc#mlnyB)nfIE1<m9C0R{kqD~-s
zXz7ZeC-{`Xd4j`SK?f=f<<HeVj(nf5y*0ao63ox9UQkC`X2272G9PD#f|-a$8J^JG
zTFqN+<6hJhjOD~9B<me^|Keu(Qb^;%otU1~b4&y7;|@w98j_0xh^y0oPvOW|ilPad
z&?ks9P%hbm({qaJ^7qG-i*?eFLOmT|bu^Dft&46$$4z&d=qZg@A-KYt2WsNHL(I+N
zSYbv12kPtU>q<n^c?CAhQu~3|emi;!vg0gIQj~fTo`w^WS~fnq?@(SWH+YQ>w2s2!
zn%iRLHPdiLEVI<J0v3#F1n_vLrjh;IY)j>~DqVjk_Afh%=8urph@o1T+!v&Yv_nD`
zqtGOYyg?|i?PoGvh9>H{uNx*(u3**$u=R_(Jt-6hX=wqpo)c)<VtQar|2zWh>Z;IZ
zs#nkm2%Ho=f>5ezzWBQK#bWDC4^33uWVAn6k7p@0GS!~Z{#n*Uth_y=4y?A9oo75n
zhROINL9wOER1~9TrPUhN10YUo{eJW4$i_^)&_DOl$eocyOur2z!mVfRc^J#HC<9Wa
zb?)K@Ks9M+l@5{?JE;?kTU{^Ac=TNgJ$>amcIY%N?I14L(7W4T=B!Vk$&}Mo1__j6
zz!ys%nTk^Q)M=kcICq;NeRiD?aJ^%_93A%n=;m{a4+JObf0<SztYo;;*@kr^vkc)_
z8)L~vViMZ9?&N%GWB_iDVMTt&-_^)0Or)zWO^alu6*bofoTj7G3PlpA6%u81NaJ&|
zlIOmM$KN1FCvG-al+FqnFs(n7Oi0=}aMBwFLeAuY0uzUx`KcV5L)^qn1+no0D$nqB
znRObhL)%C6$2pmZyPvF6^{76_5M$QkxSfvkE)UPZt=4Pr;liJU^>3+`Ozd-tUAJOL
zt)5@I#h)Q)CE01&)W-68jpEF!Ipb7FEdc#l0oM?dHa=N6z)|gUysQA$u7sW`u~Z3w
z9Dto2Jr%taC7@e8JHqx^+rsAlC6*+o3Z+s4BMmc6NuQSNSX4+KK+KR9o1a%-NxBR=
zbK{ydbiphC7a7!LNsqA9F~Fs=oFA$k#Pw<T=1f2{dmwa(c~y_;%TAMW-^&6v1M#<W
zYT5oY`YxoIYX25uqIdLc1oSoOUevyob#x=dqA!1?q_EQ!!P^-3spus~b47u&6TR=F
z@MTLlNr+ee$?8W(9VD?Rzd_SQeqJ8wpIi#JXW*~MiIvYP|Kd*E&mO6I5%=MGFnNrb
z*b`^OiK)&ExHQD=Qq!P*B<Ga%u#MrhN>zV&mEf2F;g82MLTM|}pN6=oH8o27DeiXS
z;aab-m69qN*?&if9*GYPS!dO%#>!{-zONeivljMuwy>E5+!aqQb5W3}^9wdqK{fTX
zfh&dHR_3ByH8hV{MQr7`{*#9<Ph3AcN7frPr5n@y{GFq)i~iaV3pmN_Oj}iJNu<QV
z_6AL3XL~K*zzRS7^%}9C%h2!Wbd1(6>ZVmzI3{OAEs`tN6;>O0aqejC6PrO4b6=74
zczH0nu9HRop#baEPI&Iq_Eog{5rCw|rYf=e`4mdLqV*<pe*Fv%vvOT?x$QG&C|57!
z!-l)R)No?}j=Sl}PKc}62bb`w^{*PTw(}iK7mCJf@WNIu1Zld%rvF;*5ZGW6?_2-%
znobOB#;;sdrJv{7*-nOlP^UcTw;nBIEiwZ8aZ!$+#m*|rS2rg|Lx#IJ)BZhmsLanN
zWg+t~iz3Z(k(>-6L90iIpqq0sWk?+~og>9Z=HPyS;=e*{&>Q`&x-Cb*%GpRE#HC;7
zzDkpm)&IY1GW0m0SXI_&TJtrBB!!Th2^9)OcJvGlf-7(h{{9jbCXGN^CPmmix*x~d
z#*>co<O$Hw&ntd58Fw<go`veds09g=^+b#;iP=4S$E<KwRS@pofl_tvIPd)Lnq(5>
z6u#dRE{LpXW||RHmIkhnkK>7+KyxK|S0luhnsq2%UCCo_!{3);deCN7A+P=01pc;D
zINs7d0MPBw3q#v41b<TCr)77Z`^CrKeAV5r_tsQW*2DH=`j<EDo@cGkwTE1NzzJD4
zcmRYz`6tLw)K;r9GrzPxW9<x971u71iBESN8ebD%L!NS|dS0$XN}khwX_^qiv__Wd
zZ}9(AAj+R?YKUJ;VTl@FiH@^ffNwsdxu4toHhP4czy-<jknVg+^AmtGol`8cvty%;
zt**7UUq?ov(bC-7P@l%tB3HnMGw@{K;&uj6U6yb|l=%$qUF^p$y8Dj)cgY+FCS?|R
zhMYK;z-#q$53}TY#YunKn)ANO{S`|1>*kSp^1GE{LU+^YfOU_jzX$qxH^ju|$KG2i
ztgyY;`M2Ke#`W(~t=Bm`c_tnmg$}qaC$kLQbUl}ZQK|J(l9r6fUzQZ0UZ*Av@xXi4
zKrNSzJc+;4T1^WD1=zpDS8f@}7-l)4ftEHgN?~MP>8j{|@$YQ0q9Ck$aV{6O^|WJw
z&U2mXlo1p2EdO4Q^fE@A|DNxX048LYnOEXN(|GQ<;O?TDPn}Zaw0<$gjIe&oU&0dc
zJlAX=e$`@8UoM!>uoTjDv2!!7?@>Bf-2KTPuNxUwPP>R;CaAEeoBC1pw|^FH8jI6{
z)wze5jxnW(1OAO}_O=iX3hsAv$M1Dtvb>J+Mo25{1g*rsE?L-vJO4<enRbQchHA+B
zQk=79Th=$fIRQy6+3aLF8PzZ&l8Ex+8KEp^QQ)a07Dtqrlb4k~<;f5=ui>B!N2A+9
z%OH{tX7K#Oph5&xYrma8YquV!h{G|rzcD@ZnV<-pCwXuVi1D!Sn3Jd@G_DMXaQ02i
zos!FODQ)DaDP>v_7k?$8O!<vo9K2vQ89hR|;^g%6qH^NJ@eu55kPoLDcPc4g3jIy=
zi!$CgG0!#OGhH)WZe2wqz`}4;62YqWH>)RY1}Z?$-IBj1!JTVu3O*{@n^~Ap5C2G$
z_nm)bC2k4Pb3Mf-<~<S5gVzZP@TS<J5P!t}@gIfuKX2o!2$D31BlBtf?u7DzBu`$x
zo4<29i7YB}hcGovi!ILEjQ9vkHK}*fZ~JLO{eHN~da`I2F7znAdKF*go^AUVA{<NR
z(Id;nXq_UcsPdx8jG&_}^uG7g)7~nUpc-fJB=O?(dA7Dm{fUUs3k{hkSR0rSGb?bN
z88y}H)>l|AmZ`ffSq;56>6ON1LB`Cb&EPUcnzGF}4sP7bn!R%p7yp$UopNJ72BE|R
zzs!lOCw<Vg@I_(lEb{ZS$e6UzAIkLi-BA9GzI|A{;{K?;?8K8~BLLwD#1STD3zi+D
z-03WVk!dI^)-lizIdZ<xc7l!zxCZQ5x473g2OiX#ld3FgaD2eZO2NE%Q<>>YG88z5
z@wScEoZ6bl=3#Zib|K3>H(t}T#U1*<K*DE^yQ=ynAq_9aM<s{OUVU-m$R4^T-rkIe
zuS^)#6Vp(4->|<*UTyjK7V4HRpXL2ooB(NKB7u<C7S#Kt*2DkXpYU5>MHlcw0JBew
z$16Qw#{EF04jjNwDmYiYE67`LmUIC%?+iA_23-J1fMfi0H64CU(R9H7V(L5N;d<V;
zR}di*5k$8Vq69(ox<vFKO7xZ>I$6E1-ok1@h#I{Uy%SxcEz$exELL5t{XQqZ|C{HX
zkDW7T&YYPuce$?XF7ur|*z5>%G6^pC{i)0jdavN3oX;sQWl;K%kbh{8iwX8*M|bA2
z(OAhseoc*@mbwo7FEP3(f(+Zw(|J^CTvdG-yO_wKi)`0yoEE(KPSg>7C{k~H_?79d
z_}{1NM`Sffy?=z3;KDzi!nG(RGq_zvVMWm%_it-&(t|u!h1FG^8Hyf9@)YkxjsaZ{
z5DA^Ra!V>~x|%G;Pn`8+w90{AwEt+|NO<O*N$>N<bTJDlS{iaWH7DvfH&KinLpkOo
zaNG4T&)+Ye!4JAfWRzq^m}&D3SZsQuhu_7769r4TYW8{BOC*PH(bD>aepbSk%-+YZ
zXJ(h4azZBcY5Qxd#a>9=mUiZ*$>QAbTv;cQG`+{KUYiM#TIb!R!S2ZhzY>2(^vzFa
zyk70~7UFPz+P=(Et31BsW0BNnu`(b(cjm95f;eKr5%VC{<@x0}o`&Q7e&l1#a#AHb
z;DE3|RLx79YI#$O@U=}lRyG$c+ck<?wfEor{*abO5@4E%4w<Qck5-Iy^b^S+au>ko
zCy;yM?SaDRWnwv-eLE@kJSl{C3j$j+&YySV>Nrea%4~j0*uVAFVhB+kw-&TyI!}`!
zlj3w;p;9+d=;tJnLbX8LZFRugx{q~I_|PpaSz+q7K^#>gm{yBY<K1ajg8{*Yn&#6)
zK6SE>GAPq{4(YTaT9?+SvN9&U;|Pr@)bjO~S7G?@8<Jodg-fDhqJ_?OpRCW~T2LLK
z_K!2K5nG+DpG)YDn>WYIrFMtaU7F-M%I@ro`=!_J+PZ|FQ~Sz|%HZC6f$h+7;ny+q
zoxNPYZ^Hj1^&buGj>(=e=+%+>oXRV?w358q(gVq&RHQib<88}c2#{}aewbylyU)rl
zW&az;V&B18o8skwDriJZafm=GJvT^Cv62~jMcd2O*pInw;4=JR=|BI0hAST;X4AOx
zy4u9Jey=Y*-|+Y(GQp6P7yva>4V2p7GJC+u#DS36<9#}Cd%?9^zUm@V0hP!Tr{^Dr
zB5EYxyO%H68r5-WLOt|JA4zNO4^h>TK@4@zD%}no{3h4AGF{Zv)@Mw&QTK=7P9c-{
zg<Ob^he@|_#g>*=NB|R5>AODv15>%MIl3<dfDwYE+#p0h1s!EPsPX^(S_(g_bd@zM
zh*L#YFlcF6XZ;;?gO4$g$oAX1s*MSPw4m^_!o(!}EVOm>hvW88*Y>*9$0{oQQC)-Q
zQe}NYNA&iF*nG9m9~#GglbUgWk!EjN!fBWvDZb{~G9&L}V0u24Cv)fdpXk!OoJIR0
z(jN<x+H^Cju1i?5HjLa`mzyv0Nm;J)Oa%Xd5(HF5yH4b(h9FVj2Q1x~??AOUX!75$
zXAs(iN(75*l}4*I?`q)N^zq-*u@)qx$!A8GU*v#-()lE`%(vo6KqP_oUoil@^I3j7
zWSZA-pJavw{Rq~_#S1x^cmd=HRV@aH@$@a3IH}{I{a)P#3<+`D>YxqFq?PDHv96MP
z#0=NklZOnCJlzL(-#V5nvP;)<+cdFH$B$VZKf_z2mvp}ZvN8U2I}Op>ek73fgjyOL
zU_yo3=W!vLtkD8q2OJEp%5Yaz_`Uq@5)R{c;w0)e-8qC@3Da#W>+v9c>)Xy<)3{Nt
z(E!fXSW$|xv4!1#i9(9m(|QfTP>r@Obhe!xp#n<<x4HYyQqxhiUGY0F(E-}Z$vbMH
z_)QiG<LAZEr|}xAoPEZzv!jz&ldrl!vSxOm%Q%wLHAfL#6Yohydf#y&WbMf$z`>9P
za4hzczIxd_b5jk}(V)VM^`Hy{o?&8K1-l{0LqJ)Hc!cvB0m5?R-;Lj<-F^EK(r74-
zR!&kfx)aElkY)RTHh)Zz@K?;muFO_Qx-3)?0soP%Tp&F~*aZhrzyj%V8RPhodF`}A
zyUJNMG);#b+YDNk>w(@mgnc02aW$eKnY#+M@*?}H%ke}G6Ut3)d$tciqG$OiMTbe(
zXgNysTlRX1dcO1gexW$gKEY_{zM6DB>5o^^&UQ{v=AvwspbTP4OHIb^17lVPh{_er
zfaS*HpV?~p58~=CJa$t%DO&Z-J*m~W6R?I;|G(h7E?39^TZ<VUFb|<fl`&f~T(Eu0
zgOFhFv&x9B6N~;9ga1H<MMXD-E!M}i_pnN+fLEeM?HtDe%8>M#<TTgib_wJ&emY|;
zis>W8Zf4On-AQfCod@z{Yd-)>`Ez{ID6BusPo-k^k<B|1zeV_LftzVw`qZE6M)fB6
zkw#-vREQ$C-JW7Dm2GVX+LU(HIf^T1zVdrXS^JOwK&1)Z98&iVxyJJ`$!nG&Be)4t
zXl8V5>y=*i3#~8p@IJu_NUv&g!?8kMd*CZ(d8T{-urX7W5rLmH;=v@2UceMuHa03o
z|6&_1+1s9)VbI6xhaQ=@nIjq1eG;{Nh-gvi#_{(CD1R*mT_KJLP7w_PQm(68c{HlG
zVi{bA2JsZXNzHNk;7p%U-{>nnjj77BFSAt+Tl{0-7m9maQ*K8w2|xljw@B<OS=t&j
z1Vgt`p`dO&A<j9aY>-v0j7+~;StkaZlNGJ*Z7<yG_NpG~=Z$EEZ!^>5Lyx(`rK)C_
z@o(*WCH=?X?vf1T%(&Mnj6%ZS_F8+lCpvwKiqz}RnNl<^OmdO8DzKer9fn$-cO=rU
zzo>{I93lJBz`x2Ueo`?NhQsLaq^G*$er3j!`D}<Vxx$HrMg>iu;WO!eb)m`N`t0jj
z8QDk`R$w&d>|H$OTJq)F^Hl!AwVTRW_8B~wp$#pG;<{iIRW4#StmpF_>qD|4vw~;c
zRkCe;cfa2(l~1e&bwUIJSXK}%gv^zzvP8KfctIA6mls8USm>0_HL91qQyPA}Bl>F2
zkgyVdG(+{;z)yaI3uZZc=!Q?T@z{qviw`npxBKM*W>lj<l03#$9vj$KOV_f(+*Dhu
z&*!O1dlkVDP|udic&aQq_4GA9KE0zEOygIbW!AkV&CNHTb_xR7^6}&B^k^n1q1$%P
z4)=p%CLh#^;t$1~W;jwYGuPnPKm7p5YT+dsc60vjrl*)nCTf5rOR?yu+A+VAz>CHY
z8S^ojLydr5KI9|BXQ_WGRiapRnoksuHTbnJ{8mF+8Hui>WV=Vpnl#YvL)6C>v!8P3
zjqaPs8rp8jvk^;-%k;G4$EUBN*gR-VC#sBn(@{lS+HbeNItvs{2!h#uEgN-Jc17`t
zho2Wq%2gTLN?;@ZW)}|u5ro;l_1_(Z^-;3|O4v{{S>u=O?ho@yq8M2XC@r}}Kpy3*
z8JTnCnaK%uEB!~}sJ{*kkEL}Z63LM7X6-#^S{79uNm_GxxehnA8G@x^T`xIMu8*sh
z9fHzZ^VGOK)d;^DbiRSIu;T^pJ+#-mSMWnX%Tqj4q7OX(L^};R$LcU>pg62FDg|tQ
zu_Ap;CH+klYnEWcqsm3ez(dHIF$>SiT$MYQt26D(=Em5#Zy^w`09b{^kf;0Syznsz
zxcGR9eAJW;YJIw(b;hX@HS5iC`2iX)Gh&d%BcN~acx%bgO7modW-lNUARasRwRs=<
zOvlWGOU2w9_Ul=o6y496oYcOrRg<dT=4-38*hH%xFR#56K2IN4VAT3;Y1q<Zh`r*y
z8-MU;GMa1M-xkyzp^k}7$mnax8|~XzOR@hzTAjlk4his;?}gCxYa^v?#h+tXw8o~f
z*GK{YHB7lJDcTY%O8+2A)8~D#|HiSqID4{Q#fQo6Nx7vBT(1{)0zO_A_zwimyVmWD
z<@S^Jb)rztd_1M_wis+*b0NBmnbwHx+%P}hz72qd`4Hs3<(AT!ai_L}26U$V)--id
z9C=IgJNVwmS;@;P(+O!hTkywdf91`#EFIDnF?nNn2*XU03jNLNchqr0f!O^Wlmt$;
zp`$|!_SEF>20~ZNrcYuKT@}eh-EjPO6G-~pNDY1@AN5G?myynh-osJY2`t*`dAKxN
z1<P0r?cCdaFU=SH0ignyQvpWprvo7xI<0>iuP~LrB1B(P@xp*kT51ZbO_0iIO&V_t
z<zQQXn&J?Yk+DIFHg(QftXt+rG$#IW{`fm-=&H}RGim^<Egs3jGU(K)a?DHm@`%b-
ztgCOs1fbwj?zDDCmtH39WkHVLCvT;?m(Cf5w#U8d=)qNc4xU%h)ajez2%8qGX(^Q(
zD;H1Aw1?=1=vg?dJ_M6N&4e)nD*pF-J#|?>;2%Z)2m0wv`7Zg0d^)xrxl(>+@^V2D
zH`dq?qu+8$v%x1dR^bJU^b@o3gR#Zt73+ADQ@Lh_2DKhD%oJb*deI}Rx=qdT-syf;
ztOO@AVBT#+b7#1rWlL40JA`~OCVta`y|s}Wh8H(l8@BdmPOGjwVRmkpjyJGQ^~;9b
zH{|U>xeJ1P+{eX!h*!v8V?dfYnz)D~Y48b0ZD<VGdEaEE|Nbt|nGx4}2W~_nata70
z&s0eqH-s-gn@0XrjjP?HZR;N8lX#CX-T%Ir9=EKiSYV8Od3>|0Mk=7v_`xgVcSd8&
z*#M%gM+VJSv=*y960Cdjw?>fEr4nx&eOdJyLR`cQ>%DLwv%m@6_oL@lrfbyBviKno
zo1WCPNo<PN6~DFbTbaXAH%@bxTeaROF&Xm853=*Xd#Ki005|p=_Gr|yv&laPTf_W|
zcU*70gK1(xZX8v&ojuA|xrFIgu<!CSbBg!s)QP%NdbJTK+V5Q;mx9vgG95~v=0);S
z+caFzxj8v-uj^OGu;_Ii_MZ5cnmzO~>hmytUd#2t(@D$f)!VMnd9sl)xqkb<SRxYH
z)e26FcR9akkj;`wCQpedGe1=((iLWYw~oTTLD!>3Youc>xO(iJmW{*IN#Ww#vrG_@
z1w;qM?xnZ`#U5SQRMKEj+*h3!8`e!?l_Kkqh|0RS$0jD<<|<z13n(%(Six12_8!_X
zlC3{%&wG=CHes!1za!TFSt{0cc#)cgC5=<s71j$NT>S4&6xMX6pQ?ie`jsDmJMg-h
z{sR?wGEt+&A%QbmO^=lvkeqxPX;G#SQ?9H@9Iw&v6Dd87`AWVK;zbCH$yN|FZ`t;T
zBlX~oKt^@cYwR*|`e(_Ay)vC#%H<cy>|QhSdVd{B;pXZFmc!gzB$?~N4p%-#)>WuK
zyHxO}M79)Yxi_Kjqn~kO@QT6DM9~S$M3zo`+V1s+jt4Qjbl<NRd2u0nT)tfSZ=6xw
zb0KK<o|);F>6z2TGubw2iK4?)Co{#MjsHL@-Ny=1#r8f0y>tPE7mpPmZYAJJgs<{<
zgE#d2(Gi)CyWFL{aqlCJy_IHohn!Mok+*B=uL6eGp{9rd?=`cBdp`I}$|d%^#jMe-
zavKi)F5YZy3;kw~s@!Ac&u%%F>8W7cg4PfCN5!vw^$NYNacUynhA|V;bF>6@uw`cO
zc>1x_tC4dlt$75|$ySO?>2mDs6vB8WBf1!6lQ-ocP0<4_DBGip9bO(xlQtF3m4Yj1
zY;lEu(VF=OLj9t|OPfyo8C~<7)pXG}8U<N1!*l`Lg^J4>*V3+;y{6FVDxn4~UKru>
z-*!=k7(&x$(iXM8+`JeluvuoS|Jx?mg4ldUo|5eImFqIhyE78UV`BUyL?Nu=<Ibme
ztA!nL-hGqKAU|IBwM@G8{u8Cb$8Rm)g~U*S-~q|~ShL9kRJM9LjYYH~X+_QJ4KiaL
z?al2PSC@@u*EQh+?_!g^I9E?Wq}`+EF3?1Kk@fJ9vcg-#BW;6&KfgpB`xR3&aEzs}
z;KAij<-O=g;M^N1b6rQXbfaCTQINAIrA~kA*nNDmOjbuAx_^aI8YY}O`dnC8|LDUd
z;Di8PFT5_B+(z4YY5y9rY*@}3wme|VkTiI9x9w)_PBuox%EA0L1Bfe|P8846qh4)|
zHxQr&y{}`ms@O+9AWTtXRDat{$}y8>ac`?z>?LeBPS#_MXqn0tPb!lG$kiwVECX1Z
zscA-!cw+!o|NG5G-PC2KX%eNMvYt*?1nvZGEc3070_zu5PNk{S@rxWFXCezagl3}Z
z+<`SM*UhG*p)(am&g5sRPJ2^xW7t3{vy0|T(=~FsUAvE(e{3~V!E1CQaUxA=N0vcP
z#1Ywf->dR@_1{&#vg%)pWT}v&hsmAm-*Os`pX5C#ejhCHx~4QEun9>O^WD+JAiaOu
z!v_qRSA`ND2pDb{vqn#tTa(@!AgU7DL3T;MoPK)q9#>g2ihRcT{G(#c0RDL;_?ML>
z+9|PB+(ZEeu&$M3(x=-N4QnzvN_aFtxGA(q@OgHv)Z!4UHJgYdy6KuJ=X&NR#;CX2
zD_c=@aPoJu`rHrPJ}m4rjHW`9ZSv){(jGedGau~2;ysRRDfzE6D(H&o5oYYO-KVd+
zr{^zt`u*BTvZ*7bIU2gVpP0MiPW2RzJ&E3QLe3UpJ3=FVW^uR|tsaA2wZ?H63O)Jb
z&)W)9e0-8<K>lEYca_<!&)T(W|Iv=P;C1M*fd%+Q+`7fM-WS#NF)FWGJ^1kOmQvQI
zUvhY}rBY)#j3d6f_4!8jEymN-=2u!|Ym&j@<i?fB1zvhx0?LxtF`st(mrnU!66I(j
zYKu7X&stwX9glK{?R}`fU|EVDD7#-hkKub*!s3^I>l3}(hL7|<pQBfs`sH6w;iJ+<
zOzA#&ULMEb^&d#?FIEc3^l<+id1@^Dhxcx?M)=B!wC$|u@b7HcQoZf)rdl(P(pDYf
z%lM_E+`9(E!SlA(uZpA=-2H8FdYH6|y_rs{@wF3{PYX1}9g6>f$bOaknNC~Xm=q?_
zC(sprXFgC~)q&g-oUIfxx_vFbcrjR<#(1A%5K9e?efyNACo^|gZ7hMBr52OsNHjma
z?~Tv)B*CEOj0Ifb?SEFgWJgW0Sjm>C;LXQ}52ym3^W!_$`;AnV#=^8{L~nGy{RirZ
zHD&S}S)wo$R@GjXq->Q07nDFwx}fsBAv$FDY`yn49@<nAW8dz<2X}OslApyuU+ZK%
zwEsweQv0+O{41%mp6?Mq^F-1@g~W0Gs3Jgz&AQ5epw1SbbrvX_j>NGxNWSc0v@+a3
zMHzec0?B_$M2vg#KX9|E#h|7-dX!Ld4Pb>LQWIr}ChJ*aLz)AnXDgAQShBS08U{<9
z0RlqpA*p^CN%>eXh_OX`+L)P!_Ut@|%<fobZcT!Z2rMGq$zK_nNTkwrtTYgEAi7ts
zaeHQ;gM8M+juvpQww@2lnrb6?C7{KhpKda>)MX(x%DKb=VvjzBMf05Q4*Pr<JE>A!
zZ$qw!@TL`&;2(BCR1m5CQCS0-sq+dGW3nd*2s6X!80~s|%K*0n$Vow-BgyZ(M<8g2
ztF9}df21{tHHN{Q<in0q_m%H|pcjCZ#(}$V9Yemgy?d1Anveva!aH21de=ccdDj&O
zZ<kK4nVnV)i<G9GytjMdhI?N%{l9c@_4lScPwBr@BY$*L#v~6Pv(kQ&3WKI!Mp?Hv
zhSky6@gH(=-F@%wyapB)6%|B2>0N>&KcAI~82-)7KmK)Mwe|H)u6GaEOr>Bg(`N5l
z(p9~c%{cF|;;5pQR9VWj8w@37s@g7ulKdV<lFk3;XGqGxr4r~=P0@(YS#G>1oL1|e
zRNqUxtnU~4<%#s4UMD;V<vN`A4Yp66!W#Gq*`UsLzV`nVRId!J6>p${P6j_v`Qj|o
z4*!#Jsy;Lzr0IlW|2|~&&CqLfE0&c$Vk$t$UivKjsS^iL^lJeX{(U8U!RAp8kXs%;
zWtYGRC5S_c6O=Y!CxA%36Z7uQHp_C7<U2wlMBu|Z&jS2tb@5Mu)GYPP_>`GDOm(0(
z%`8sQf`J0i)4rE?AJB|Z=K7BFw`r!|TZh*Lf<P{|e4Nle5oaGc{3L+IJ=v=5wUtCi
zK?Dg?kS#htddrFw;?50)8qnqIy)rep_ld8x+4`x76L^We-rjumbh$=S9_nguSKA}`
zh(OGn{U+CUf-H)}j5vSssbm({mYPB2bQL-wZ3Q?)>g-pr5KnhsD|hY_Wsb)Q^mS}}
zzXN68`Ra|$SE|<nE5KwW35Tx4ir3m~RQ%*T{4ktdQepOBrLO=J-GA+}{6@>_SRg1E
zQt>I7HCuf>i-o8Pqo=B;%cnljipf@s=)*nss7YXx@Y`YZ9%Ae)@G^Sy@spxfWf1}S
zpb!G1*you=(*~m8$pbIT44gBCx4<Ych6}w7+r6fAT*BxyR8pnys?Uus`RzjO?7Zo9
z%i<~9+hQrHl0d4l)3R4jW7Ea(^t6L%%;PHfzkWp~k~y7^Tk3t3-9;osF*CTMv<`;0
zE4UviLtn{~)DCWw6cc~+2j#pm_se4dzt#Twq-$ZOx=Qg&SL_cASZnH><J9jsh{4}4
zM+wl|II#fxW^ZcJmN@AAKsNQ?PrM7GdwZJB823$}-)EA@ojv2MjMWPw%#WkoG|yP|
ze<A&CyJ}Z!)p18`UxsP(I3^n-w<+DI4wJ7ELT_!N`|~j`{JQi`sCLbWDFI*yokqoP
z<Uc`}&TzGnM0*c3?gFpjvqX^vMvv7p+1mAo%Gtz*a`3P?L-cioDpIA67QFW_hZ_t|
zn}p+mW~S&oAhnLI0lTpHqNp88pHvC$)GD@gG6(J21N-<zPiMQ$)p5bHsyg|Hxsq{A
zERKnl+Vn~cWHVLl>3dw#zm=*di<+~hmp&$LHmdYs;vh&h34DQwFciTT=9V_na{4HL
z{sHw2En_c3TG^ATL!`?iC*CY-aLE8$V~L_v@zzH^qhIky%PnCi)y%=q8R5`L(INv3
z)X}feQQ<_HywUp4uMF$hcK#8kEZ<M@fj$p8wmw)eUA|Ub$P-L;&5=A%Yxh8ku{1ir
zcHNEot_c2c^TKQ?=hUx<Ica-8<Bku>#OgzN4#vSB2c%Dqho3A8ac#QDJ$}CT8imto
zWMWEGTujfLm3p|%j=!+7+~|9@p46%GvTLw<B5PQG0X3;o69|gm4s7Z=8#5cOKZT!t
z8|ouKHVS6t&@j6LP}Uj2HuoHJ{AfAJ)^$xU_wPoT`}H4QP)HXg8A~UXW=d#B?<#Ru
zCAB_<o-^RGlK=V{0tii;khsN-n^RM#krVK@t=3(IV?D7_6@--Zw$UU4zr<Mi`y4fS
znS$c&37Os6vzC;@b^DSH?h|28x}n4^+u5thTHlnRKB1+F*JY0+-uI_Ry()3ddBvKS
zB4!%uA$Y@RIE^r%8)X;iRx)_!e{eqXVcwYkj|>0MuAw+*^zV1k%1M7Bt-S``$qUyJ
z^2j<Ien>?Lyebo4OZK&%IVt&C=Cmji>yvF}SKtZtN?Ltu*_beTSHil0GhSu?ahAk{
zd2<oHgB&ljI}4SL@VRyO?*K^HtKC_{(4H5qj!Pl%j8okoncVA<N`Z%>mwiva9ny&{
zxZrfQ#Q;>_(iAe>lG<aO!oG7eQDGtDp<?q`!N)ymy_7hD0R4}$S5bwTLw5asc^Sxd
ze}RH{!S6DV?dY>>lB<HiPrpvnug%_eP4aj%yy+a&dnsV)9I<C0N%z`cTssbtCrRdW
znl>G|0J5lm-E*hV$tOBmp=(2zdxD`V>YfR#$3Y!33C$jEe=z!tHC}Y662DKHsTB?S
zX(X0N9rQcJ#cMalVpq3b4cymAXHuVBSVG(@&z^8nzAfD(Rn`)lDOz?ZW@n<d<4t)K
ztKh=dGveg0pyp3o(BRf8Jf=_akD86FI_~V1$*lSWeDx~CAQ+Tq2So!~;k)hgtYYRw
z(cHe)yF-iOcl^03>+)F3M}3t0TJy-(_XGA-z$n#zfjK*HD1moNw&a>X!g(nZ^YKco
zpS)YG>4L%=Z}J~XxjNv1`5)tc5=gTL%R(cu@e=)vq>*xDqa`jk(nfnc-dE*5sZlFT
zv{TBWy${CLO!3yz@Vy$94&*n?fP}=9q#k>$kddw6zR6SFzetT&ZxUSQ-s!veGDNRZ
zbW3yAH%EK9m4&5<Jd7!CCUB9MP#J!C^tr_IxuyR@GTN$FnD!t3MXDkCVGwVJW#fF<
z=QC{FX=Tr^nd^?+!diP>ux0aW>bZV#WWCv6H%z_B%f0>&-?n3NF9!GZ<xf<$5XKWV
zr|-jVm)a}(@?ViN4&HwO^CgPDruZc;I^ic^ZKFdh?3@HI_ZHferaoq>?BHsozIauU
z@hZiZ!LOpRP`dsw(1Ia)x-DsfR_lvl?Wi=bt+V&qg74r|cCA{<KrYS5XBg?>^h|%l
z7m?wgWeP=$A#u~~7l(-Z`^t_^kCaJE-%kND9@@Q3_|uY7eolgz{N{SS70URS79Y!p
zUgt$B%H7?e>r>4Ms9CB%UMqcH)=YS;qAYxyjmZ12nBg0%GvtnFkzVC{_2M5jT<(f^
zJ2qwKl$>?mv(Mt1)_ac@#;j^5hxOkllW7loT{L{e6YbiOAVn`T#rC(3OLhM{lpu-O
zl|~F-Xf;bRhBx+HGXz%)#0CSSF905)J%yLE65L)&+^DumA>nmCYW3tZ8G~MkUBW(H
zLlM;9y=XD&lgl512SF%AWjHEH&z=djY7SW=L5OcG@SaqLqGu|+BYMW3tjIk`3G&Tf
z3@rK$M}7c3T=>Z~6=1QeKO)4U-<p?Ei)M>j=Xrf8&mWO^=lyz99H8F?I`6aEGb3pe
z^4n7Sm_9OwJr01d5uNoxJ0I2AqXhb^_YB{<M!oEEv!P66Wgs7@B0^UfnMGZv#5OGS
zrc3^Q5qBQwz`jBhg3-;W9O_Q^(~!v527pqJ<Z2Ufh+U_Ob^44~j_yqDr`mqc+Oxpq
ziw1X{pV@nOm@a&c0Z;u!d9G{Dls`wD`3t)~@0wM8Fu)W@GI8t_xcm^|EOcuqOz|!7
z#9}kymFRU++;GLviICKwrtxJ|9QrFoscjcib>k^j)v>eZ1zQ2?GZD*e`nu$Yb-8u_
z4^9NU1ez}g|F+!PtFB$fm>*Bo&MnKc$htE>dqewTNj$(TS%mtaSyl-3(j7vhutcrl
z@Q_^$TSm0H241*aC58Ri&b|!u1V5_d#LBLXG=%saL%tP@S056!d$Wg0%8G=XH)dAM
z{S4>K^((VrzGQGKiD*~rduXU8?91MJ|L&9|MTx?fW~7FY0;I(S_I4)N>*Il;SGHR6
z!lqH^p8x)mA16}D&qQj9e^!|k%FJ!jcz0Am+*dCRGqZNS90hxRm`RYNFW`JvXmR`!
z(9>(D%;s5RF0Qg=S-yLZC`6~;Uxg8@+|-#77@zAv5j#+gRr6;1f)3y6@8hXwlw2Ho
zjC#!aUHLkglh+;m*iSW+8&$4WnNfKkA|aiBDg7&NPVg4><szy=M2hQ|GzZg*N!GR}
z&W=AdxWmo6GVr^x_Td-==!>eP|28gpht54YF4Rx(sqt+V;@JrwLxY&bc@;hS@(arE
zy)O{7b8l=Uz-K3nI)YE_a*ghP(D4Y%+Lk-ksfF1miZTJnvhgze^{au<XWIlzfNsU#
z9xMcH)fp~yKk{&*<F^YXwQORj8$?~rM=$Oy%};T4#)#Q6L1j@P$7L12>$1BvE7|FS
zO?>jF<o4?BSahYpJU|@bH(hddeUMq+D9|wYQR{G^no-SfdrgBJ66z;+QNrv^iBDOB
zw6{PXnf9##@|?TNg6aF}!P8cnc($ZX-9$0a^8!=e@85HFl?|6voo&~u7;S%T^f69(
zzxWwbmV13pHM|EVa@hEI9Z(=>U91}R5W*j~X>1aE*tqIUWon>bo)ozl(MY1Nlo$V5
zs&yu3&d+4x`IlSa`(?H@r_5?S$AT`S5d3joT0h0_Ua7yt<HD^q8n_)PBZvhZRI=^%
z{Upl9e2>eF8=5TG=cp2e+1YJr@sGDkF`a##$LY$B1vU*yD)@(+0iUGAJ($ir*&~d4
zASCtlw$b0y-VO1aeuv*B8n-wv{rWvxYk8wz*m1yO#P6AAn^pb+Aj|u;D(`fmsNHX^
zaQ8YZld&<f{J_eKXX7F3`^8u7vIEXOXQBbGcDH6;*-n0m@gMJT3aBfS9a(0{pL(BW
zhGamCT<Fl=u3y0w{TT4Dv9iZ5LmhvM&0aAEJz@4gP2Xa}En%Y8DWDHpg_Yh0zWH30
zE42TPk!x)`Y+bcPUx93l**Mkp%?dY_bS{<m>6zp<lIZt(*+(*L3n%d5^DoQC2+vKp
zlZN2hfUw6lP83ZLz&`T;dry}@KALAqiB=4fRso3!5N<f`YObGR@o3EKiDIFB0flEJ
zyM$Z_@2MnSq>5)pb-Zewe5t1}$;LOR?RHYN3_5$~3)Pptb1Z4f9<8RWo1)wB@V&)@
z5Y9tY_W?v2T2(32eGF9)yNoy#d?q8RMM(-)2MO^8;+PFEu(#q)d6XURT+l-_1Tp6X
zI{CM$%}oop+ih;klE*l}%4b?D7u@$^Gyu8BIPKpa*8jrtzK1ay)>=Phg<#ge)Aeo6
z$XP(Rso{J6ys;!G>UnZf#zUWnA<NCqg!UfGOlYZ&To0Nqs)UP}goK#MP^*J^-)Jr4
z-3oZf`k%WHDn&MF1D+Y89W^H`qZ_&1MDQz8H8`e6x9E$Ym!IcalaL8x+gu*u4^|7W
z!?u|WFFmvDUv#Ix1$pYWxFTsB9Rj4fskl}Oh8yJqQ0h(*;~Ds7LiVeSp4uO#mX!aA
zC!e==Mt6Xt{|u33bN52Y)!J^-(Gq2;Z5>Tb4k281p&lDsF@n#ZEXY-`B9yM#f4!jo
z<ztS#eLZ2^7>I>hdq2s}{qFr_*J7@d#kOmNs!xkYd2uI1&Bh1XMN{}>MCAFH;hl_A
z!$gqlhy)SMkC^P7oYyA;GW!ZPqeN1+fs;ddPIqnfCo(Q`?lK^wk<zSSOi>a$&Jb>2
z%eWtlfy*9W<1cGQ7yBtaui2<d==YLR<9Hg+COV2Icp`i{wl1JHXk{D{CNyuZ$cA4U
z+TAt87P{&-3VD&PRarKCh|d5JzLOR3wt|=@Rx4JHBX_Srei21C{VjM$^VMw(xsvQf
zmG`d508ocV({r>yt^)zXHd~U|`q!jg1@WmEwbpM8NXl}k4AzG28*!rduIUG~X575n
zLBb{Yctfw4DS2~+GD<uw8i_Li4xR#VOd6IwGwvI9sYNTsJY>p+OeG;cGbdgmMvHP7
zzFmZ9CA}Lo#2hbiI-MNC(JlEgoJh0_nO&SOu_1Y83YB5HS&O@RA~<$^p|NQ=0C(-P
z^0JS6U>iaM{uKAmsx01ooe?jvZ|b|0scI2{7H%XxsjqHt^u7B!k=rp1f4fqOP~QII
zWuwRgx9P`A{xPh4C}wq0tB+*b{V$e_01fQKit`%s`erj>2|vc+ff$_R45VUZVT979
z9V<fSv`}&Q;d3HhmgY>=IQ-V$rfetDYR&VR{q%J~8*3a3_!B-ov^SclSn@AxtG+wE
zh0W@M!P1ZmZ2$YWE->Z_8%qu-K{Lv!wMN`N8{KkqZ<ZZ&iula<P*l3UkvBYIK~m*I
zgOxIBTrQ}GpAf#%OY$;heQ_wksj9+5-j!8&#rFLN@@{Wdzodj6E+-CdeUs&bX!1M$
z>GLPA-zM@AJQ)k{BC4?5)Aej<NPm)PVb7wrnVQJoPXkw$ies-*3GQ}cpQba}ci|pL
zeZ1}1#x0)cPqd{WXt-lx5pnaxNOkBStZc4KfIsz>$)ExVzmjYGtZcH_Hr}L8jX2qp
zW}!4&WwWElqQY3N)&#Dm`&c=Jr)X0u@Qi9kaD3s)mUXavn}jit+rQn8?PyO>zh9nh
zUZywB&NQGtO)ePSM*x)><=6<c!Q-=qDv#O>o#z99G6m86p(5+J0uWIZEdXIU&6xBa
z0ZH7Ahl}O0Q&PwfM;mhN%7DfyXom7Uhy+PM5;vME!~-hC>wy$^L*m7?wmU1H3I>wh
zNlcaem?Rj^SQ5IutHHXS$0Ed?FL(|J-0`cps#yf9sd88_(Dk5cvJW0QvM4)6C(xJ^
zOXpZuF_t+tS338->vp|RqIui+a>GcK#(@P{vVc<0?hWG&bq?j;4*zw$Xuy-FEW8@Y
zSG0-GYz<DOT5T!!ny!ktm4pDBW7m<b+iir6{vGP6{8c6}-OAYgEtD~S#Y!-2bNwIA
z-h**j4N&xw*U>RoW`Nr&UEkXAGn)qD1Vg+DnB?6vkRj$s4||Iq-1GM1&C7Xi<F6kH
zYDAWxM@L8c!x`B=sWzG!<h#*oY~}sm)pstM+yD(?Ke?Yb)(Jm%pe#=pUVveSgDn^l
zrh|FA!$<#tNCAAzJNr?=Ow&ub4){sGR$`UrTtqI_VFx)nGdr3ar=Zg&d$U8l;TxxE
zTpP2C<(2#KQeee3u@)l$GItiTwjxRn=M%tWA6G8CIrfNJJ4)}LB97d$m9~b&Isa;u
z+pr`N$l@Z_`P%p?n%wAFN=adN*>2LTG4-QAt@^p${jLL>#?IIm;0GB2fX$A>RRM-O
z5Z`oG5hIc+;T)FWgKD^r0Xlpd7zglq<I3eZ>|ZG*Z5%yO6mRFz&VQhF`%YGoWt58a
z*W2=&2v%PPJdE60UZ5$U<gE!vJ5P45y~Ef;_IaBD+)@vaQLO}|g#bm03+&EC(jh~_
zfu)T&VQM&_-(9U=SIE-`VD;z3Ab}OcC}bA#(`326XUSGhp-lC>Qvo`zNkLi*PDrII
zmmO~LuhohfteXlN=FsSCXAKCNw*iO*r2>(l@FUNQvn$$>-@x4abYxZ2)Pw+(+Z1~&
zP)q11f8Ny3Jp2mD#}Wv0q-X){A=lSMK$9am&I$$-+-10kt?5@qI`zP1!Ko0#zn@k3
zAHd0^lSd4?8J1m*_I^gp$GwPK`-Ox=c4G+zNhh18UgjpstI{&+tSLc!i>|PoJ(^7n
z_h|#Jj4$?QcJ)8=W$6$ZB>YC5B-wJ)l<Ywm{(cYISQNy6-vrm8SCS0&sA9>Q8^e;6
z{t_nK>@lDPGL9xUZ>*a8q1pTI!%IGELu-;X7?_&aa;SC7K8P!qRNFqn9%U!Re1?Fh
zOO5yVdK^8SZ%ZYAZIs7inR5K^<uVH;>9{(b(2E6W#<y9)0kFb!DZ;*=iM2KZM9faR
z8@HW4Jh9E|c2VW_Y1r8mTK8GBBF`yCL6yPnH(d(CgHyg9T4eb7-jl>Kyr9<RQ9`Ab
zVH9CS;Wo?J2uBcf^k_75qvRaB>&m=oRb2U4UrRQbJGa^=8kQcBNAiQmf>4QQlZN4<
zKzMLiFN3K`uree$^=+iaG9}U5M|7q4^v1XMRX3_8(La!z)=Aj+Rxom-pbT&DbQ@+t
zVDNL#Oj3;A_<TgTV5Y8n*2RQXf}Ra)R<aU?tfw7Ps}0sR;p<i4SL)X>&K$!_e@c?8
zMa-UVck;?bX}$dlOSIO&B5rAo79;~<tZ_jJxKCC4ng@!1H~g@}auEzZx|yv43P~}q
zQo6Lf2lp|0jbM<MZObmuE-Q=hc*6n!3xKs1r!8jfLQ}PS3SXMcRf~;IAWC};7-|`A
z34M2uArXLqJ}3_Pg8<`ud7*E!veOFAzg>`hc)1-)KbLK(J{zmwQp|8DN_3@L4jplI
zqRolL=IEDMi(>cZn2!}BDpuTl93<M6hRRgeVma?q)y7zwBN0ix13&0;u50^x8$GYz
zSL8p5W&he2edri1Fhz=<F0=FTog26_!oXp~6S=?~P>=e(=J?z~e|q9Q(NmptIE=`~
z6Xe~XwB}=(#mTMG(c?yMlr2T|;RV6a^T0bDDU*vlVNH@?9@i_~*BJVqn&F=>GnqEU
zh}c7nzBtl=@Vd&&{=Vn=xU2oSedujeV=$q>ACQY|{)xrv$M|k0pMd&5>rUZyB}0S7
z22+<?MZy!-hXHl;`o2Z`1}$n|^R0(UXKjD7n3^b(bdne&g?u2CJ27{cw5GOk=_J8N
zuMtPTDwgtHUt|<RGv2cun?(RwslgYE{!dysi~EH?X=^#{EULMxCVidaf%`@g>Z_@D
z-7XB0-PVDT#@)xdfr@kvq8Is0_l_~!2P9;*bco|qmJ~((#)~4H=|?PscGzYOu)im=
zF^?)$agUZr8E(ITkA(rx$P@bvIF;-aZ|j`VdFgmVEaf+Er3k)UA-+V$p{urybB?p(
z;xLyV{sTE0VQrWw5&XDZK(_?=dn?jqaK8<6?L>1u`3B7t0}<bZtx+Lh+h2g}@HEi1
z21ecu_;hod;c$(ZiIGQ}3De#aAn6Ypr+K*JN+mBd75v+`*_Y>?{i!%|e=efSSFrzG
zC-#FOQM^i=&u4s60T$g1baPhi75x^#z3BdLz$`vC_?Ir%u!?^pemXds_b1X5oXlit
zfhhwduR=XF7@ugyUE8eyF1AEb(y%H}^S}se>)PuVv-fraS;6<4T1F9RTys2~uI{0l
zeZ9AW1nlE`%b8h^fsZlply?64a*2xiKL<wd6`X3{{QdplP9M>o|NG4rsZh^I+Jl=1
zo(T0!TET5ysp%@{dP;l1-Yr}Vsr=|%@0~1`D;qZ)q;ypX5D+Rfa3f!e6Ja;kHWvwG
zpGF299V&h@2h#-YZ{`@|-t!)!r>hC0EtnjTxcPMH{y?-KP#fnA=$rS`2)5T>K&=;Y
zFb$s5!~G*;!ya(d(*UUzY1n>l-uxS>?;@T9`|n1atv|1Hgmd28-j;!7TKXqtT%Bg$
z*x1|%LpJMHE{`Wrk9>t4f5<%!qR}yvr=je8y7xEg!Zq%E61LK#b|Xe~>-N7^&mf;h
zKK-ommK<UZTDcjaVJpX{i@5{3C<n9t2O2ZzJX*_n4aK!s0F(59*Y?qc!!i%K@nb$;
zy2^`bp4jo%8Z9J4<m5mB!%vW70ritx)>Pb$ps!Ly?Wb=w)$GsaS0LwqU}5_7)SyS8
z^%@dB+Ebw4j#!Qdap#G!6@@r^pv!jG0$Y)>j>BK0p18AWF7TAj^mK|a@lV7uy}Ohy
z<vp@ZgEx-^wtyGrPxor}=ICky_0Ct=0TrrbX6G#FGyuueYz5r4Vn~{M;oQj6y(5wo
z2>iu2>#-H*(G2!vAEjTZ4N3t+=^j2N@QhZ63LX^jA{3}0$r?gHh;ZU<6suzoOH9c5
z-KPC-ZLUI7aUWns&r2Y!2C_VHu#}u9+2nA6;$6tU>P72ZZdDb3j2coTY#cu{gvt>>
z`yTB?=E`6R-+k{fWIgpp>^|XrD#ks%qkPMiek0QBXN|g6fGk0<Y7&5xPVU;bl{`5P
zh`D!gY@Xh~V$5u>)18RSiDilTOisxG4lFday+{u=RoiS6A>Wn&lJR5XGqf96<pF9s
zb;bSvKyU;K1E(iEEBA+8Pq|!0h$M_>6YnrWYU;4QM(h|ZFfqm}2KLc*C9D({=DLYv
zv0QVj{SR~pAO`7J;aIA45Mwz@z{yu+z4)?~v39QedFR|RtBo+~WKP!D=VLYNF<JQY
zuY>cF^iewnUjt;;e-f_rLc4!XY9M6aQp3nk`@%DUB}s%C|1teXt*AxfzS@fcjlhMu
zxo!eh^L%I^+069MPe3Q^O|~lvjjt$@>XO0nqUCa)Xb#ug>_Q~2g$!MEACQ^4JsS}P
zKz*_}!LNq<82En8{JcSrg<Z;Y^#B2X3^%lxga}b=mqm}L55J4+CtiHW5W@%X9Uj`J
z<0dfCqT&jfz%GXL$M0p6D`LCdPJsmqzzC>RlaFA%o+h#OW_Vt9(;v8f-f(wqU&f3=
z*jTl5k9ot_(zevt?s|Ugl{WCX(E1E{F^Kz%iI}{(3m|V6fDc}u=4}<4P+cRU+`lsb
zf@z`4J`H$w>C5Qe@ZHur$kCR71(&8keWj`I!&J21nkl1LZWC`fpUgf2x3b7uyep{t
zI5w@+Q&Fc>UXsMv2LVlAqK&i-$mC!VBr$&~y{PqsW>=2nt<U&V*QELQdJePUU_M(A
z>BIUytkS}51i4eNrb!yZ3@w_OB8LqR5V{g4Y5M0IZ>ryCQXtAbQl^n@;u|Gm5xn?x
z^2PnK?@=i2avFj8&CG|uKMo|rV*R$=G;2}#lUZNg{2WKcEvK@30lj}2rjgY{NzS5;
zjRQ%bvP!HI#Xh3ij~R5_kR3ia3uG|r?A?542pX+l&w5L0nQIYlrBVjIBV=d#T9od@
zFLS@o+qn;*mr$tk(c=uVw@rU|Qvp>vTd1Yk6ZtTYo(;qWbWYd*XkY(yCZ_HYJCHC~
zxS1UHJ17f}@{-7<l6X{%y+Wz^qg)8QiKxJXhTL&DQJFm`TGymC7=3Gth_S>!Ll#~2
z@g4tux-BI`Ly339L_c&qot6=DVT1V>G|ydcf9|gDm~f=U2v_Mv1#$VnvJJ<NPo0i0
zGL-fm!Qf+ZeI~&g-_`{@ny~cuUfLrTCpG;vjzfd{S;0*f=uBP<3FS$BuK=&r`al7d
zq0b1lx<l=5ZB!O6S=YpJfv<k*Y+p^D2IUf2!9K&aTu~TB;PGtuV%Yb4K|+VW_-h#=
zqHS(P$;(26hI-Qe75Pw=gc`DoIPOsCur6?}P{AatQ~tAYw|j?Y-@gnxvS%6%vfIio
zlEy^OPOLS~IE3|8)|Wsp$A?8Yv86?^(_3cudYuWReFh6PSe{d#ZZ(<Q*KZm>r)+5u
zi#u$2{J95_VKG8q(YyJ{hi4??BE7x-t53liHNVn*m9?75cs{B9)b>=F>ed^otdyC@
z><@T)ewKlY<V<u7ld~EtY#STKZklouHXd}x6&a2JaN)EC_xievw~%RroKFMT`|M{W
z@CyqI!B$!)_V5j(Uu;AX(dJ(sC&avfxBLEu)b=)B3=u9JmUuh9h%nbkr4|)>8J2G|
zsm2g%TOt@UyKJ_pdpYZcmFGbne)sgFF;cT-84G$|GkX4@(JcgCROI6?bH=<#;(0ec
z=L2+C3$M>yKk!uHKx<VqC}#YQ(^h;VBd1c%di*^y%H}?125tDm2cV~dX_N<_lAOeH
z@Si0yGiV_*#%(}@IqCeew3MW85gXdjk(W{eN`&i4fi`_0e3|=MVtFi-<R_ERe&QU$
zv3hnNLYlLDkUD4VsG0;*;rE3CRZh}D(L(a9`lpnC9`S1p%h8xyw7;S7%bU-)2vXBH
z|0bxoPE=#r`^GvUM(_7^3-ff9%bc`d+P~w;|IJ9`^+i=`z4O%rGuTXTX6L-n3Lt5n
z+#pX8^YJSm!|L=#7UfimQDh$fqB6n6FHM?_+L8}3@Nai(vX<8#PLgIk=C7O4vi)X|
z+hLu<tZn$3s9wX$777#Zc541Kis%8Y0(C+u9K{-Ku~Cva-S?B3@1Ffw`zQ>BuU?Lb
zkG*S|<h5w~nVH)ZvuU7lwVr1_>k!Njq=R0532^+=q4f<n`qH%tRyHayGX;R&=l4jq
z>%G|58H*x+7^(hDxsHx&&SJeZJFc7^I(4z%r1vV)vyU|T?Zvmy80OUG2xyz_egwj~
zgCFsPM6CLyy}oAuiQdd&Iz)@aItocgkpZD8mn;rUP#(sE-Av5Mng67l!kTFDqKdo&
z4U0VIn0x82nnZguTx5d{vs|2AGODH3X<B|aSmaXc&dj%ZUc?}-v24EYp=kfZPxCKN
zo8oiSP1?b>^Rf)tB4fiXAX`fRKxILvHu?l%l|p>?eM*O}@K07^F|PV3(4G5tq!cyv
z>YC5J*&{S+nww$^{S>}DeW#3tzSoMeDjol(W3S+^+(zPY0IxsQE%Z~)7c{e*V&~#`
zPREtaua6%xoHQN{1+2nMZo=J;rW4WtKqgOl+sR{_cFgei9?t5<jAi#xm$0jfu{)#v
z=JbqvNYHJOmy`>tkKa$W!WpzD(sXpwUvzH0XgcRXz7o(fAms#Ti(SKK?#xSj-Ge0i
z6<Kbc-@}u<DjP$Z=`L)%4vA|KpX@y&ky6%RIns&&i3xh3WB}gXrpOb81$sXENCMP(
zrPKYg@d}=fxI0fkj7<cAv)x!orkeoOBc(r^l$^gG_AuHf#k$4j)8C8+ybWc>Ph!9H
zjr;Td4XqQo&vRvJr7%2}O_IBllVU$$jmGh2s$XD)a2JgwB;;*emyXPCDR8RVF0H8_
zePiMa$P_D{nk7o1fO(K)7HTFW64Q)n2mgKjQXxtFt2nC)4UzyI++~Slz)_|8esxeS
zEPvh-FD3>|F$T+}_Oz~Pa(Pcm0Xeu5ydo_2f*+2I31Iu_zKg1|KApZ$x~RP4$g&{4
z1XFpkZe{jRxwY4oVrGctoN5k#MQG#QD0<KF!Z%I-fH?yR*`_LC+{C<7>%AJd+{u&}
z-VOlY+tbo&k9(_oS#*bMq!0JwRlo$~7ArVWx+k-0G6Gl^8kFq`Ra2}ugcNTGO6A^w
z%BlO`bNPKw5sh`&Db9cIL%AJb-}5F?ENroA9(?nE?LV>Ob(Z6UHuZ3CS9(N<gtsf_
z>>K8oVXzJfD_9^mQouA6G4;YzG52)-tMzo-nY~Yrx%6~Tx*2K&a4`VQ){t>n_9;s7
z=f~?X^_{b)3KQw4J(YIZrx&*+u!i$jN=688RQ4&(J8zEfe=Vf)az|(w!@TEag#5G7
zm?a6|^7A6V2C=h->{d;=CgEUX75{E(y~Gp}lqF9?Fp~{)uzSnrY{m}hg^gXE7iQ|c
zWBEQ8G+;~rZ-j<Y@%{?_V{%78IS;)I7*L4@w5%TB0IPs(V|_gf=)(42sx97%-tOkj
zk?p-Y^x+iiW3TYuUT_v0nc6-)`<At`eRY=0>wJ%BtZ5InS=D%j3z+idyN>Dnb|#gF
zE?DU28hh|}d9l8)|MjIS4mRpLnZC6T{c{S3F2YP9MIByJ-~3g~{`lOT$g(BT!`og=
zzA8$M_t}6M+NSt1{JAC4^6wnmolFOs0fspL&U4v*ANbd%bD{0wlhhuifXkBqK#*<3
zH&t`Lu49d5Nx;UH#7TaP`vlg4{qbQMhkc2D)wygo+IDbE+$F_-n!SGuW18BO&9Gp|
zMh=|f+ThrUgPuLJWh`Vh^U8hTWp*Ze8XfR*-eCJaOPk^ij{UyH0+q`kzpI3p<5=(H
zlLpNIa}(zS3`pZ<z|H9?qg5R4nsO5A2)B-eb@f5-(;arx5`ba<fy~Z#`vtVPp;^M)
zMGnAZ?_)F%#yg5zGgB9M6u~zCT8p5jz1I)HHyExYrAe__;(fr_-p93jb(Ij<W;mF(
zcaB}{&qNzXN>@-#?Wx_yZ!F1WU-pUIsP_P9Qpn|arOmJAo4kK-^2COpjqEpEiU<hZ
zonO1Ai#_V7V%k=6mjJvZUMOtkJx}`-wQMK_3##8EV@99`Z^LsH1pr`AcbDtk<e7XE
zW}J&U8^POf4(J>87z_GB+c9q4>a@bo36-y)`|n}(<*q@Tz#&DCec`C4GjGi<ZRz*#
zamA0~oa-uFw)(kLb>VFDv>}$qWRf?NVbYFpF_nePxQhz7_gBD6Zva^2&KLD@W`Oy<
z@&HG*{U7MKR_Kv;O&#QN27>^gX1_aeT=zA4JTa4A-X7HTCZkxphPPhdf#O@v$N9La
zn*TsqNZgh4apgTfm3G#+gBxv3y;A3+dQQqZpSRq3!7?8Ow9magu!<->*JkmG2yZ}T
z5Qq(s$d%4s0=+N-SJLC2F#Tu~PIkJtvHiL4O#s^xJl(%>Ys%l$BxJsF+egTr+wzas
zf1nSYzfx}u2Xg-J=9NUaCnjis7kb|e>x;F`TYnF%haKTgv+r1&>$=u}r@#%zA@vS%
z*apZYs`FR6yXs3<e!wAj#8GvTMWsh=9|(UN6&JxEV82GDeD&vWYB)iEK<NXxWlpTt
zfb%slOrS9(%-+D_7Vvpj0B@e;v<EGr4I;O)f!zf{5xSV{66hCI2;dC%$Cas8`&uoY
z@uGZzyYPT<w;~v=Si|28k|DS`5r9;m9X0<A7_I~#Y{?m2m>tzpWpDJd-J=n3R22Uf
z%$m-5N<Ffh4t-2IuuB086S*;6C<OXFn$*i|>|N4#;Q<!wQ3~L7mcZ7m_6|fFYR7J3
z0Ut#hcvzx(lQB6*-NoZ)O~9BHl5TXtSC`EYrC9GdOj^0)e;`fUng467(K}*+^P0!|
zS4W0Uy5eOwFiR5;OGDB29xzlg??q`+U*^&6HL%`izGp}IbQ4_)=Ug8^kgxrerz1B3
ziL;RZO;Q9ZZ}BV}1w5#<ND*!hcD{o{jA5IW0TRh1FRtCY29r=>eQ1ch?ZF9xqr^u=
zRh@5;K&4>Sy`Kk6^Xz$<s<_<C&P!llRcX|9s5T}OX!TCS(^?ucDcFwz0gy<;_R&0N
z=VwNai84jRAw$<QIR@3Zi79EbE4%FLJJatuMV*X471Ve#Xp#RvmcBa>j_-SW)fG__
z5uzqK(U<5;M2lWRqPM8gJ7I|+WUUq?!meJTM;C%%m*~BhXsbr=Yd`Pg`+NVhWA4l?
zGjq>#&U4O_)Ge#fmMV$}F(xgZs5Y>^=g}wi?FxnqiNrjwH*H?2RTG%E(Gf-RauC~Q
zA%hKk3qfKsr+JLoK9dO1Q9%Ewu)zgZLBgcM&H&o@OiHj(u%*+^Q9w^f`;OGf=9ns#
zgB>y~y=K5LO0cg^YP9BMKtstvB}G?8>{$1(7qW6oj@%*-YWkJJ2}CeGqJ!qm7eTB@
zcZfDxGn8;tGt=raXRKPOOg>BhbxTV_;0N^*8%j7S0>{IM+c8uft1SOZuQ{{snZ%!a
z*#+c;B5<@8f`We?-e~#|tKfR`v?G1ottAr-wXXe&MH6bfzmV#Au!)?q)_wfue0Sb_
zae&zQi-CNb2+0?nprO;U_Xj_7S;cnCUa78bfbMR1n=t$ba<WEz&f%I@bG_GPa_i?U
z1C^o0r({LPFYzp6?vTD$#(yG$*d8h|=#k12m`P&`c-BPQajks$qSAXhy>wBHgM6St
zAM^Ash{M55SRemJGY-p4jy`;Wnro2`qG5E4`V@k2$=&1ZI+N4z{vAvc#E>7Yot)>h
zEtPM32NZ56*tlAGxsi8=&MsLegw~>vxVW2(Jt7nTf|sk;+7r}!Ry?aWdWY^^5RU{u
zq=tipA~2iU`oPEIAS;5{{^1t>uzWETNd6D;=RP=}8Cq;etmLT%cA_0|b8+L8CuZaU
z<kAI0bq^)DZYRUYm6vw3my$-~7i-C)&&~vHGge@&tDi;1RuZ=S2$}1xu!s$^7lPfj
znCjA{3Bp`+FZ@*Rah_%^s;ZQEES~lA#<c?exZ?Gb0NWn^zqgkCcpzfme|H!qk};B&
zhCdMyX0t>W2q`BA`|X=CCiF@5f+!C6wQb;0YyK;Ve6N%SWoWmQnW?}7aiDV)HQ>N)
zEljxbPxu$j)$9&7&p>3|RZb9F)PLBw`};o-&B9#Vk8D^^TM=xk7IsBe4p#By@8s_!
z4vstCcQ)VN^wi`^bl!ysq}L(cqSg~rn39{&x^G$QUae$7N;u34Ma(KDuVwGSC4-43
zrc+Kzg$sUu^b346X1c<lp5@Tg^b2$!1OnTj`KH*HW=)5D9ve#<pRIT~zkvnzhsw*7
zxQ2C6kIV{6l0iO<TW;Uyl<!IWYh<~MvO)6?EXM!o>wVoygRb5h{I$+u4*rE@V8fQ{
zz1PUo75|(j`{S$P!}y@-{^{GNEJGEp(l5$tfAkqSER?7+G8}2#*@b3QK}`Q{QoTDj
ztQzTZzCk_MJWnFI`&4?(o9Up8MY4mv8M)wIfvtxJC0*VX;pQ0m6o7fk|E$@}gX$wt
ziLXkF3ts&n=oP~ou^Y7l(~r*qfu)dAXX5+DJiZY}97t}wumc9Xm@z`SJ||T;mft*n
zvXwtBh$MJFXx0w~u?^<dHjbPM)2b0aa9+Gjv#ZThW5*wqdIUWlF09EJxD`WTIWp#v
zmC)i1{YZomFnn4S_2N|7jq`~~-rJ8H`}{Hydnd*2bE$UL6jXd&wh_|?lXf%_lksh-
zg5V6rC+@u6yo1ttbBx)xAg7K;2?avIdW6<jqe&|4I~gG90m5_$AmmP~G{BdCo=wc2
zVg5ioPF#^xX4H<M$RRONbZR!7g3XkY?#o6Z87Uu?mu6;$vN|z~jKSSOQJo>W{%fP}
ziSSSvqqiGK-G09E$%0R+d#8mtvY5Bya015STLO<Fx@j*Wb}c+k9TifKCaZvLRpuuL
zK8$k}PwcwQbs5cYTA{G>$0OREC(S=@Sq^UT;qxhv#FT1oWPtQHl|H+Hx$ZO31;KHB
za}R*i9g9|+rX~Lq>eHOAdl;Hp)5*m6-pg#4s?(oA<A>CcS9idjw>$?kc6IxPTY&3r
z#f20IU{2b6EC;IeZliE2u6ukbed2Mff@2-EUmUV1Twat<iqJ{g%VOI4WsK~){dL#D
zjamNYDtrs9%hOuS@T+5sd=wZWlzXg?v)9Ex%7ubYbU>}+@?lr7LrBPT+x0I!7J*+i
zfZXe7ZlA}fu0w2?o{;#i5;~~xmFtzcq)0F4;A?vQS;!-(2GL!V7Wr;M#{!)wAsz>7
zPXR)xg=~?tx+>$sZFf+A)M^WvYown56%5M8_#G5yEJh-du=JRlV*^0CDyN&Ii{_yb
z18rIix5`mmB5e5?GSs!mD$-P$)lXol)A7PEp~H=>@+|8dFO8=Qd9J+v1*5&9Ewp;A
z!T1})OGxq(<W58N^UKh2$=abp>f>FCBMjl<5X7naux^;-%9|Q%@$y12_iTJ0Sfn95
zcfy6im6~CRmEV6LI~?!Xr_MA-j)0XccICjy$TvqS{AewXeQ|E;HA>0zu4c`hW{Y{Y
z$MnZR@Z86A7T-WO)c2-gztTs=pewK6s^N%md`!#eB;XSx`?qZu7R5T6=-t1;ei)Xx
z!jpMv_y$ccoa7~m2REOd7Q4xr6&6RhYc_L=q7D029~pGnZN=>*bi^|@%EbR~aO)QW
zxmf6|2_6UFm%D1U`M|W%A1WY5EIEE2^FKl_DqfOD_hK`%=3u5-Ef%@Aj~`JlTqY%5
zNBj!<!hv!ZC<b(A1#=za)${<X^xrZR!G5I;&n4_pD&wzo@!aYEE-4qs_~`2^H7yd?
zaD7D#Nn>S+Ejfq&5Mj#|b!4+dZFNuj`K20_SnnWoSz_~p<g$@*3FB<H;YY+uxb&lR
z_$oIX<znfx_42_j$v?L*t?$qJM-FFTapjg0Hfyg|{gtex`<SWQy)15LCrcU+^^>i9
zSBu#rWzdka2K9KHH3SD|ILF7nb`5+j5adDdabt~F8k;a$szI{TC-(6+w_d-Zyaury
zG)Cf$lW`>2H$NQwSeAllG;x#uJ;BBx2-r|zHGBA;BHu?ZpJ8=TB4)LjpI7yds`pUn
zYN3@zS7+^oTK2u3hpHMoR}VJJb`5$&G%O;Svo7TDF95>gUo+&p_ot*m!M9+w317&0
zeg|2VTV9u@00n;Ore#uK&B5c#Z#xORFiIH<e?wlfEen6nMkon%ERWJi+OKj*uVi$<
zzg(it<VBwsjPuGSfFXm`zt_US93bBkMSq?KIWPT6EkYjva{(Os#8OZ7p@Exi;>FxD
zcf-u2AtlvGovus@Ly&a~R*I)0WbEuOPm#w;p+G{%V`^x~=+|R*V$w}rT>x8`EGGwH
zIFFkXi46ka#g-xfQa#HTKnxn44yw7tT2VG^^m3jQ*=TUuRi2l83x|VH-GjTZtKtWC
zRsH$#GjsEXA3A9?{aAji0#N8`D>ll2u(+MATL&yh5xN_?O}KKz!AP0O>IJ~#R<$OC
zTE7%g0TlFbP`oyw4LHUUls^-R_DWj1f}wPS2}E9i-rbV6!$Byl2@-zHhm1z`_8N|-
z9K%rfHXTuAqS~X?2;8dydXTkj(zyRwo)>%QJV^I6rv}xs_7^Z{Q9Fonnl4A|bx}Pq
z5QXuVCifc6UkB<Bsuz`9RzX{D_MbbbZ<}SWB>>QVr(5n|HEBv-Cd_Khe<StXvUmi>
zZlstvT-7Xl>jJoCov6%_(P0vxZXI)ZvTxw&{k)Qs>OT+`cZhbXl9aQr*Wh$N`?mt4
z@IPMB*F_Cez#N>GNDb;N=HKiCliQe&rh^L+B4U=H*yF8kdd`4;BF93dEuBSzHG<yd
z%I68hPvm@Ns^KtHXQezZLM%_p{pK*?0FS)P{l(oQJ+F8fDv!AYN@EnTlWtQ3r66Dc
z+9VFw5Dr&B;VUcMGqI3@rtO6wycPE7Jhy9JkH99Jnx#$n7_Y7MF?Ca1uktY!weolf
zV3wC(`EHaEBw>!&u(&IOYQY4oeDLwkKfi#1yHxMaKCl>*iFcHGu{(I^)Zv~E)<YQ|
z)`p$RG+=+i){3bFp!bdQEy0M6EntvCCmWw4YmWEuFw7Lvxep!0=`{{R6>W8FBu0j-
z5mnlmW;`Tygzh><Zo`I7%6{fMf>D355=FVp3!+lcA3F&K(7}+^dTFh}%Ju;kO}yNH
zpuK$9)q|<Tz#iI_g=Z(1|Ek4Looa;wg&U?`{!iXY;;{as_tojZxG~lhw|*X(NJoW=
za#m9f@{>@bS(2sR(&<H0I+<@Cnbk|`JOLTi+S{K#`bNfla6jkvDR;9w{BaLjRUrSM
zqKF=GG!*oZrbpx(sfP4U+%K~r9WN%DBI1xMBjFAAz7nhF264$%WA#PZ7tuiG>$tBo
zS)(%Fx+KD9-_l?Gx+n!nmV*es8|Nf7#5lmKob-ygpdShfC=|c*Lw#$sOo?zn&Z}m3
zv7P?py!2}EL$hXAiElcgQdZyWx9zigwM|LyzTFy<=Y@NC$~YGA{~(!eiJZQgs2i=+
zZu-<dM=GMegL=+Hm;{RKmZ;y;Lgq>2H?tOY2EWuXWYKcSd7!;2{-*xZrQKul%n@Ju
z*LO6en1`u-E{(b^!GXW`++#SB_6%Q6>wdEkEU&+v=!GP?zx@cQ>Mac!ws)or7&83<
zvlIH_>sG|iY57A(<pr_5Z+l@K(J<h>xb0k0q~-(rZemZ8Sx;xev_gAl`>3E<HIbX}
z4O?LF1fvkQ=w+BM^5y1_#=_e7;T1j+N7y<?2FTxqzE3H}>hUJ)QbX$+(SvGRI<j6z
z$<k;(pQvRYQyLEc?ZA%w7oBkHu`V$>F%m8{Lj(zvy_Tft9E89_?Wx39A?W(|Qy}wt
zIvPJeK^oZa$aX+rDP6GUYFwH)=V)otCb65QhUdBZd<Hxbt99LRH&k)lK>nXLM_dZr
z4uZy*he=>-N*>fR(C`lOFNSUxASiAd$AAm`%994qnWgC72MjPSXBs%h+0yy$bPE$E
zhVsf~fT(2jGXpkKr1sPdM-$0CgCOrCRKccN*Lnn*8Rl%J${I--%2c6F^IlUKRI;PA
z>Y$CUkxI6$!3Kyg`GnSSe6mQV65i;JS#8OQ`85C7+jr+z%1$<_r@ET$p4n^kf)Iqv
znb>R`^}3;M`OCSv4!LBO6vCdT$?8NrClw#X#h)RaRrxdTpPegsMfyeykr9=kJ^8Nu
zrrW9!Sepdc!QD)s=k2Bp8=oj56!mqwK|GTwbC8u515Xmr6U0fck<2{~b~sJQSP$!`
z_YTqE*uamPGO7(eE-&5|_MtT}zX4Coj){U#3o`|4q{Qw|$iebt?FfYL>km&;IqDYK
z^1!uk)oF`A7+4B)U3Ll-?Cm5R)JH+fM8jdPcAgKtr)2Vjihv7LHV9H8keMm!7;9NI
zVxNrRl%fOo#%7^1;=lB>%Wgh5W78RD_g?!Ms}j>Ds(D$-K+4u?2qK4c>LvqyFeaul
zTy>)o-Py~qAaFzRS((eI_r(2MbE+X!YURWZP1nK<n*lv#4ZTdPrNX~eUN#;Ye|!_u
zKW=^ct6rnR{guB&vqT`seo7Qbfmg~kgV4yd?!ZZg=FcUDE+SXNT69Sh-`~X`SBr*C
zh#*JivMt}mdocc*ehPJUGV=D%il#L<gI*`C+5Vm3Oj*pa7f7bs*zYzU+ZFON>#C{M
z6;tEj7@MD5`dF*(d)Lk-{-^PWmJ0A9;ECbi+%Tz5&8qNT-C%e@gfdN<`Dl;yB;kIN
z>@|0fyPdg|C>;F9=wbfNu%a}>N_?X^mSJCqzYFxagGGd2(hHfH0Xi2ZTL>-v)$AJ{
z`QaUGNe=dWjv{2G1@mX=Lr#P7Xa%Q{iQ8~;2(t9bq!7+*LZW`uv-Po=&!ySk^k)`V
zet%CT?zyLm&jUn?S4i3Hj9_I7WlNZyC2fC!DxJMAw$49$d3jVl_K}zfMVW{aGp&Y3
zc6B?(dqlHjyWy#9L+#DD4?N-X;SnO!ICAr7$m37b`^Rl|p`(8>w;Oomt|CnDTi*Nr
zRo6_wnX@iji<>vblV=QE=brlweZPW~KXXd48aukUWl(0^Ffu5JJ8z2mm4Mp#<0-F;
zH8wGBiIW$9+3dqrKDo&mVHh4DIfghL-d<#BnD~{S(nqK0=CndiM1dVcxNKw<%sLxu
zIKC-gf5@d=zaoB`m-W)vf&Sy4Cfo5vJob%xg(Xv<#`G<Q$39E5%`Kx828S8Z`%M}z
zt$w{*9M24ZwAdzs<n%M72or}v+UyW7WUW^Q$N&w$wnfMed&PmoRRi<jet8XaAcy#w
z0YIxw2}1{Hk^v0cPmS5u(i`C_M5A!qL{g`rU=m`AF#?T!4b>0>|9rxGj6;yS%08+j
z>Rpf+B%cq4E=ye9j*2g@q_;qBbTvbn!#2c(;84JF+*dZ_{#b=vda^2oB3RBOTav_X
z=K<B1iVu0?<<GVlxs)8t+1lfLXAQOEoEv|zLQr?*^l3U;;Wu{o_;E&uQkISl9E-G;
z8DR_;21@^d*f-cTmT)fg7cc&(?zoC2T<uQG?K#8v26_#fu;7)3STNUK@A-QJwvUz^
z7+f>k^=r#_OSf=BGq>*zD~vsG#PJK?CZrM;-+KbE1`?b#tGtc=dUCAnfAG&NFNE!6
zu^rUEecEL!Yju5YF>|5v#|J44-9HD;jW|f?<dCyG-ub_VYE|Cje?6BD>iteZpZ8$<
zaaI>*rhlwX>GPJHEBbL<2U~9lLV(^ue*r#O@|4a<Jgja10QggS^Nh+gYf$8^*_7I&
z+vc!lC+Pjt6_H1^04mV-|9J4VbC>Xoa20e5z^yCJFn~Dg1Y<eB!L#ACSw|DB*GuMC
zV1GO=B5UcJ{sVcA>7uD=9B;HMpz{@LZvlZ2(Vy2qbw=ugJp4Uy^b@-q*&QtKV^)8c
zxlT3{iW8!yIXQ9zx~p^u>*9RJQ9D$WZZUnK^ao|Ol=B%DrQSv+CyJooSNIw5zxnyU
zVe+h;$AWR+fiAZBwjDIeJtJU!QFL=?fyMDHQTQBN0UqE#cskTU5l$>v;sAO&{Xd*4
zADLF<6K(Yo{}6igdl+?vH4p~qximxx+`|C7g3`b3ph!+4>5CurHLeY(4PM@l#<2S5
z0D-M^0378Z|2NiEHMD#{PF*d}&6q(ETF`U#hJ5S@x@uvC;~S!)NK*KBx(RT4J{wq0
zj!I=R2idms@Av<2zK%h&crZ#z!lGg5Pj6pOq*nRvJPq-l7<<yON6l=x6oCiK-$M!7
z3+cT3EBI?<n-~Dnm`_5$f;t<IaE=qukD7JBx?~jT!UIa`ibk_%L-M2R%$65F;pz*5
zy>@^ZdG7j_X-sn2B_Q)!ka;|W<XZqA6fG(8H$j7>XP<}gn=m@$NKr<+suzE4+;kyc
zWY4zeS_MK&mh<5FvY_?l0Mvaect3AiP!EXdMPWjIQ08|`6(>%}4#gcW<PjC1#oN20
z8?2TWkUlrn-qbhVY=E+78@XVaooz-fP&xVoEFQ8M^^GAzvT=5>h`*LlzB;92$jgE-
zVk0Syh@-&TIpfZj47^N;)jWq8PTN!d{pnf&Wt>6Xi9)1s+r$K}msP*97+kWJVV%Cl
znW#?J$*rS0?}LMUZSxJ{jF|R%DjTGc7Z%LBWys+UM3{=|jADCu(y^=)HjJ@`(elo*
zIsLb(e^N7h=_+cyr)RF(<mWlQzfaG>?9F!=?W`JbPjG&Wd-kp<Lk|asd`YerA19$Y
z(cdu^-4}xJyP4y0k*@Td2$_G#0}@N4as3NiSycBZVjK{nqgw&L5FGyxbRV$g<;HE^
z9X;`E{ffJRnUcyizF3Zg`<Xs_+t#nRc37Xu^m7po{Rnt;6<UkUNx>T|u#ZFu#}|4K
zl0XjcRUlGyi8m6NonPG#Hk_F;gdY$vp8yc##^os^;-zE&z>_)d27MSK34AS0jAcEk
zY$*DzL5PH_qpfnzPuZ|XThIFg5<3z&inF!1pIA$GnD5IG0!9K9-)wt=Wfnef1&n(@
z52jEs<!Eg^R@(d@rdq0lEI*uw#$2~yPw|1-pm!Q`QwSp9PW$S&-!@T>p8(k4WFu2D
zdhmYnZYXr<6aZ89cWB^j`g6Dhd@Etq$6*rcb2a&pu~c(x%ylQ5P$+Du&HYn*HXncN
zaKMhCkj6HtnKW1$Ku`F_y*Nd5_NCI?&LDK?awD}$EO1jc40;2bn$7w_E}GJ@y#NDx
zXqirO9KQfQ{J;N1Pz*`WgQ3r9Xj+mIf2Oh<_L4*p14=ZPI1D5y6{A(f{5BhQ)kclY
zAn{fjK9Iry0ns6rEky$j5NjJ205tprePSn!Y@K6A_$=9g937FIMr?fBAAG3Pz#~O>
zj)QG#VC57h9*Iy!TqOZ*3n13^%)Tr?Q9v-Q+@P4LcTgu7m?~hMG+A43f-@72uYg!+
zJ}1GTELIM<Gk~&$q}JeJDD2XuZTz&tXX)jC0Fy(Kp#z#G13)Ji*jPnq=pn$=yOG~2
z0@)GUAxK4ah&Y)EBDcoiVXUa4R>C)g6!3RCy1`>3F;|9;Jm-#=0E|^}SoK2F9WKDA
zk1vgpap2i$AYH=h_;eo~OrG}IWcl@t9xNMmwZ(>yu8Sx(RSxnB-n)~o8rZ>!{TpdP
zReCi2#Of#Nil&TKPUG9Qm-;5C(U?){PoC+cpt9eZ9w$r!;rlHuW{A~cT+!vEdrrPt
z`OQ|4g|UE<9}ifn2YYz0`raB}F0WYO<}{7?=H<8M_<7wGO{a4KmB)c^Vc&gBOXp*3
zKglr7O+(<DqaV8Vk|LK7vR<!d3*WQ9TQP=<^Vy{GaL6G9>X26p<#X@m^4S0QbUQA&
z)b}yx=SX8HvH~Ue4H|dLJnuM*WJwAXbIMj<cPEBZ8y;Pq0I5LU3yLW*qWMuDE;ZU&
zw&$O?+7&d$8@23oMqQ?GMG(zpYzcBbGZP3bUr4&|`Z^d+y<_@Yn<n>5xB1q6`g1}W
zqiXFN|HF%w9QyRTLN8dVuVAO8HB*kj_ppJmyF;(bonZl^L;bu|tghlCGkVI#d-d%b
z@o2+{gy(b%5#0|aAIMkHJ}bG~M`(kkg?p2NP8Ci^lpQI|b6>|8yK7WD#95FaQ7jc-
zX~c;8dT^ix9r>UNf2`?*a6$i63QNC&-kix1v$5rGgZT>I1e;l1EyvL>T;Kb;K2S3Z
z!3JCE2U$dIc=X1F9-^TB5<E`3J};(>CwzNvn_2eTE<|x582m4_g>7aMW?3dnb6ySc
zCU0{(eOhb!6H|@Rw+#9=y||gt@_{-{X+D};YBt#9Rbk-VkUo70`JP95zh%re-}hGF
zozHrM)<_fOp4532j=sfFj43yg&c6Bcd~|vx?;Q|X%%n^n+{<LXi$Z^lm)xES=p)Jv
zZYb~z7N4%eDcC*Nf5gs#0Kzd6FW(d(HfElCG4kqwc~BdaPTP<@+aMtXt04bM$SZe(
zc>VkSjO~KxK$abs&R>1P>6|r$`Gn6)*u8)XX1SZ43h9I$kIP~k292d}C6{){VdqAF
zytIzxm?0yOOw6`Jd^D7<jbX@3Oz%vbk#k>pCD%O@!FKE6)>NJ8_hCWfjcv_FZln5m
zZvwW3UWxH-TKbw)!~MSoMO%?K{Hghei?5c<c?7(86~W8Ua>pU=xOI(BW-2vNZf?o_
z2@)N$sOVp78>QMg1>N1_qNZkDTkdq$$xlQFUGq~YOWS2tZZ~Ww0wGmIZ>PnQCT2iH
zG4zv>Pi=(>zZ^zO&B9^ALS4Y~+v2puZoSo!h|61_@4{=YeSgw!)m^7`kW}8w1EKbh
zyMv>Uus@H+t6=My(4LXlfa|s%qttli(Ts(rq6}BhTld-r^IfLH-NrY{-rbU$(7dDF
zxKakk7Tp`KSCgGLp!P37lQ5j-@kl-T93#X>$-Wh#s!$7R?4@hnlFH{84Zpt_=b>{F
zS>eQhTgd>}oy^!BjT5<1YuQ#I=RD*IT#YW=+>w~vd9{E~YSa0NV@ZCyVrcM)8h9}-
z84(P-t#}qoS;{a2((Bh~C%&THc2#upA98b}SV!$1*19O6m4(Kxj6Vzon;)Ake3_w{
zeWm=GNsWwM++A843xYilEy(xx?<0Oi)+**>a2)3e)Z!sQ^UWv4DLOM&BY6pe$sKvh
zNfJo^Rn5}RJXW6>RFPtia}RX}%4wx`1Wt7bz8xrbE~Z$pfA0l&0H*?(GR)Tu;h7f0
z5M<2Y9E-ivngNRrIg;#ZSc4PbrQ7>eI!v{273~D2CMpNOZzXz%{j9?Vqayv{ML&P^
zP+$)XjD|hmj(XYC+mZLx2pUM}v-d2H@MH~fDnM#1`kax0tyziKkkeYxK%HgBfHai@
z)t{l|Mv|cLD-9Ch_MvPI5htE8S#?m+P@H=7*!~6nI6gegS2Arm#X(e#HRMP@?b*T2
zS(C3#-G@|SkJOqvFrZ$(<kUu4p4~ND_A})4C?yJ~8@vxlhSo)}H^e@Qmoicc7q~U0
z`3GWj{Ta`CuuvJZC)XH#IUROnEA4@=^K8329q%#_1Z|QFli2QBX&GCgPbhXV9cW2Q
z^X~shbxUb@qozPOY_~)>KzWFPHBNmsr;ug4J*}4`(bb|wqJrb$12+uo$I%Qt>m>6#
z$W|Y$X|%a1Zyw#>Cq(C|etI<)ARf9%DxkIbplQAK8VQ|-4DGU*1Uzu-8L~<o+pzf6
zKNM#Y9}9;ANoZ#kohla}OPq%vKhZBAcao`BCOEAKbP6ukf;pNq16%;{B<%;1g<+>r
zJ(wFY39+@bRr5Z(k-IAeUx@n03JsU;5Z&;5T)et+P?t2Zilz+89+kLfb#d6-&UW0}
z_6s@tVp~WhYS0Vw*EDZtOdvxozq0E_;GLV0+RZT@vUFi8W1{=rB1{u6u~DScB9KsJ
zPMxofr;E{PnfnjKYIu#`Y984wiIGdtVY_=0IXS!Qc#{geqyf0c3rzUHg#@=qoNHfL
zXW)D4YV+lP-Nn=0)@(U;mcBv*A(rYw<|BE%w^}2*+yd>vuu`^FU8`7AM)uTZ03z5W
zOtxgdS|FTh_&WYJ2FI5>`A3K14uBDOGUVYzNVRg<ufE|}X*0lfe}nlSlcslA4ZNp}
zp8>LJxaez$@Hv?JG0ihTPsm`OrT)SHH3GO2^h=k3xzMJJbEfW!zkS^h3dJS@eLk|G
z_^S5T3Zbx7@N!M+ra#l~QkxY`giYGUuBd*XzWUL2eF8-%T)dK@VVny9W}9u*QfKn$
z-L3eWpQcJ4l1I<n!PkWeb|7rhj@^o6G$x@Awp5LWlpfw!w2MDyJO`rGm6mGN=U%j|
z(~!?^yqJiPfqB#I=120e3hYiop4?wiFXQ<xBC>fqke1M`6qBSJLLoY$xj1WEv8J6V
zfO`d38yvE+Vs)Y%-B#MQ^*AVEW7>Qe5L#ZnvkvfI5SMv{qpH%3B`gz%iKO5y&FL=b
znVme0CEK=#I_u$+3&R+MoB{^wCI#4-y7+sm{X}%rc?zG_-F`$X7^+o&2vH3I<G8N~
z*Z@oDKTskH$A>{@knt-l04$lpe+?oIy7pEZ?m1`39cXNgrdNINshNWQ5gv{)16qVF
z;dlWSXy;Q7&++>QssKhkl4fvcK&x*g+7nbI=<%M3vdPN(2L5;|?+2KNKh1D_eJka(
zb3}Rx(7z2ACdtoA!sn_n3MT~-VAjt=<-&F}SjRH9drpzWONG=>KY(DgC^Vev?MDJM
zX2J>le$haH4h3!Vb&mu@4=zhdZ3Ch(t^b>%F^Lcs3ya;t<9k#LdmJcqMT5L6{K5x-
z{X3mMpsfH8bM~(JaeV%$#K&gF_BAB$p5|0JhfhX-PI+7@=ZEBM2d2+|l;mAHAM{L=
zyZ<e$qyHWhqUj;caiPv4zlrz`uC8zMH9&@#Jd%^GxU^BN4Cmn0IUn?<f<1*kn9!EI
zd9(lUI>h}`0#`35TA_8vRcOPZ1k$sHQ1w+awwHQsm|V2jG_))4CceJS;gvL<yw~&i
zz1Qx&7#w+)bGFOyf`)(#vwDESsFDK_qnz(qUTVO-!4zU&x>0H`^A#tVMg6aaecw_k
zo4$*EpvKEpgf<vQA<~P@Toin#${`Fk)t^&(%>6M8&@6fjjE_nT(LLr-PMR;TlkDJr
z4pKyiWsbvswhsEG(6oWi?VMs2E9yhT5h$0}nCMg4kFRoNlDr;zq^WV*c?!%`Q9vI&
z{t-18asMFyIGg%WZS~&|q>1#5iazf`!Qi7Zk6mq#b9<Nf->V%S>rf9MKW`yKRZFs6
zOdiBfEEJ4B<Bo%Dd;7;qacpnH$nRME+E|g(DHxgf<j1~7{x*c`MG~W_BqK!;dxD-T
z{jWZQ6g9ua;onmvKfT@=j?JQSwq&B<3NI#Rd|w(!O^CiHpbPe!XTU=sKO*X?{ByEw
z4MxRsud3V2Zuu^}RV<}1eCPIgu`lVz##%x*jQ?FI&#NZHYvl1;KvX~u?&t}9!hDz^
zZQ|K93aNg?_~02C)f0M<qg0W*9)T1~l()}j^8gy<<0klPH?buCE|3EE6%n|$O1D1t
zR`DKgE<zw()u3A)M87H8(P0@{yl(LeYmAvH7wLJYVr<QD!niiYCw)j+Tc6l+q=4nh
zB196RMFR0akm^?~WS>TESm#*nabl^P_0uCo#x33Sej&diaCSaUAUXUZ>F*@zm(*mb
zNwr^lf_0iAH!!vWml>c=#Mn)tec<ngPwLE)frEVB)09aUdSH10R6}IfEs5%kKdd5j
z{R;Yns()~R`BisV-0#K{vs(tYqmnkB6``(Qh7qZ>V0=6?3B4{y1?=sar(~)wlBU1d
ze_&@827Atnqux4XkL}4RI~HQz6w)2N<By0;y?nxab@Lx+6k#PQ>Gv!{OpUcJp2OAl
z_b@u~@)`z9L3=~B9KJc5WGpPkbM;{uzl>--j8=G)HN&PAR_lFwJBvHCqfFZ=Y`uEx
z#fd<u!>kwO@7&pn)uG24JZ<h1>17%f&2DK@BkFE|8~O<gYymqzrl~LKZ6es9XB)Uu
z6d%1Ck@6#{{yWEg&0w^r(SgV<=wP#eHu=#Jf!v+0&Jw2fxzqBjq&@2bhCgE|^<{bI
zFKOGF@*hjyj7se^mvg81NOYQ&n*I0|+25IY6+B-4XHQRKoh(lfzAVL^H8Qow-td}^
z-27(b*jEt1lh3nWsSy_`193v!S*hrzDQfX00q7Y1AZS#AELE=0p9%kBtGCEk*cCi+
z@70S>@jbe1|AVdGr^}T*br$%p2@qF#rnl&59&+$#oJj5tyEN9L?mm|e^|Kzk4lQ@X
z)LlNdY=U$~28JEO*;$K)XJJDgoH?pg!!m$dVnznJqR{<h@ho>4OLzL3grl-2h^GMZ
z9r;yhZp;G+9!>#ago)TaAvcD{2Q6=mGDVrk(`H{U%)4>5)_ez%?jqU%QecW!g;T*m
zDET-4HFw?CDd#=)e2@Z`ao1&R+7hi1Xs`I4gmc+v4nW(cpPXhh!d3DYWWz-V1c|X!
z>rVp5>A6%vo78Nn()oj+nRpBUZDHhfR9{0CHsWSg$(QedfM_GY4dpNttTI*DwU5s$
zAU^JF(qOWKQQsO=Xaj)wgswH?k@~hwJrs3`<6j<;P-KiRU3FrP_y^dP{2YB8HiaJY
zwczqt02j^5$81A568`><h>k3hjcw=(FJHW<C_OlwcM<b1tX^PYL4T8DJpJvJ&bVDP
zR1r4x=Y^0UcYQpo(XAiZ(qKfbxr>*3FM^$D<QVDm&j-_24q>i5Ty@?<dEgtirZOTl
z78=$ES7fdX<B~Irc|7!%V*Ue}ot$Tv-gO^3uL&1z0KBNsR4E!A?^{bZ^S}V6u2$>$
zNrc;&)Ym8+fq6pmzmOJ4)?FL|JR|Z@R-6G>j<@JU*uI=$Bt_EEY61qZ&w#$7<P2X{
z8^UjvJdW{UpKKbQEbhz$-kGUPJ#IOLK!*L{YZwa1C*?23N-=u^o@Z#$@xasDfT#!S
z5*Bwo9`ThyYVY5&pn~mZQr<A38T{C~@oZ~n`%1E&8bjvRz)}S6>%U_H(S&*E9^-?3
z)JQ@DPasjY+G{t%7%3t!6#o;Ipx<5+?US^FY)h~@-We^8Kr$fIiT+*njZtsrJ2K$O
z1_s2-l}5MMj=2O#p;K2rV{v*wwLMbtUX1SXg^>~>Q~?Ea)avxCsML*-IC2W`f&rc_
zRX1vDWo8Py@m01zH}b~@d~+9ff=@7)7=WB^jg}>pCxzY^m0nmoGOS+0bURxqKB=1_
zV~VsAjsceSWVs+q&(AlN2j~B;1?#+*k_rZUD9QuAr9D$q4MLpnrka(<@qeK05(mF9
zdKZ_<|3G)PbaM;=?-BW`UmzIAnchFD`eCG-XQ5Zlt}RU9`$V*FDe7F@e6YMIzxnzy
zS&}PKilu&U^>Qp?qb4hj<6eGM*LqtJ`{2k{q6_Y9BujPl&ux~7bf(s@R5zQN2#-5Y
zK~JB4VL}>YySdCLpby{98E%k?;uKB`D{VDP-DuUT8LgF=@pQcp>u4qIv}}T)$}jIL
z@Hw>`%@&A(WfP#f1wQ983v0_!$%>5_HeuZYVTWm-d`;q!4(B`S#VTFPrRU^j|0qd@
zKpEEYXuC|RdH;LZ$zh4^(MQ!JnL@g@+J2Lk_iJN6_3sI!^yqhd%SbS=T~dBxameK2
z4d}DpBbe2-bVc1AVt?7vOHO~CjaoO8IhoukrmKz8Q~mjhosjzSwCrn8#;k85uPlQC
z*>aMp3TG`>t4=hgGl@-PeqJ@X#HMci6wHR*(Mf+sqgZ2Z&d$H|SP@vp>y@&X+g`n{
zTyvigx}rmA!IX=svBlfm&Sdj19}M_N8pqxdN){H9{J8V>_m3LREE4^+c`eDub6<28
zW|k34QBUE|-j~cAB_;B0k#`V_-v@`-gl`LIimAmvT6cS}mESNeCRu}9N)<{ipWpJX
zX(v#%DA0XWzneSuw|sqpSB&oAiylxWGfZZ%_28t$d&}wV#52{mw28X<`-c6<WESLR
zU7qW(S}~(g-u4e~Fvw9}Ah$6^dtAANlBu3Fg!QI0a}1)szpr(NgCtJ8je(f?Q2Xb>
zz+R%5sdR?uRwwnZ+~-1O)6Tt*81`0O&7L7t?I7R27q9WndkxuHSe-fa(|tJ#g)LT)
zGL?R{&CwzDz9os;rv~0o-!lavjy|)`K4XuIpas%s3qnD^Czhj!Uf(S`vZ9~RPT#mb
z`Xz8}Aw;&S)~VahAkCh#v}NWWJQ2U8SR?eOH4aI3g7*W6Op*`HprSS?0GB*K?>UVW
zR93?!m`;CYs4Az%)BXLBNvN@R@xoQxUo*ttZjHI-x2if6o3XjdrjW<G$qbm#;n_gT
zo*(Zk!e{hgBL`x#)xZWYoDux;@t^}5yE{Aaf%c)$hcb<!Md_g_Vv{m6{&-uwQf3kZ
zH2fc{Jkw%U>3-}R!(PxMVX|x=WMM1!yqz)NX7Y!wxymUw>-PAb2s;wZCY}uPc|~Yj
ztM6Qz+?CNUvFo}$G+FVEY^7v6oZWn)B6FoVuX^zOz9*Wm30n@PY-h-CXVx!{p@@W!
zB3pThW|JBr?dD#iDU~i-hu!RQ0of$b=gRF{>S6n)&T@8;aD&id%ODJde(1RlABB&-
zf8i+|AXfl4AfV>SDMS^hD{X0W$n%ND6CcL$sj)bfFn)r_wl_XlKVP|v<AYW2|4M9L
zpVD1Xk-8CZWi}|O`1<8@Ux7>ZvTF^&oJbD-Q<3&W$Et;U>t1p_!3G@IKJ9K|UV&E4
z*bJT8R<$G_EGbn`qeonw4)~~bcpDj(X0B%Bc0OL13SW%rd@aY~mGk}s5!}bQx+kpU
zF5AXGF(bk&XQM)ly209$u}pQt;OshmGkXI^!W3(`c)<?Hs{)0dpyaKdJWSXt9%`Gp
z4;`%kF{X}<GhsxeJs5<oi85Zz0vC@*eAmTA0WwwX`at%8aYHNb8o3ZD@fGF5VAx2I
z^TShDF6d+lU===$eZpC<k)R2bORlJFg<Kf|C3x=$l3!7un!;}*P@5Xv&)@h}Nbb;5
zm;ZYtX7YOmn16{5AR6Xgz7KT+18EIf^rlzX2dzz<=e7TVc1t}*(=SK*#VKYkVwhdh
zfHqUWqw~Of#&y--&rH|j1o*CY8}}Aq=*(3`YNy&Zxg0{{fsU+{P_}*W1~rcX4~aKG
z@GyJkrN*%FF#>LVc%N<Sfdc`scjy954L-b8`tjvt$YTKt+}ljPgiJbj*?#vB<k41W
zS8t$un9sMu%<5Znp)TOaxUYofGj|XH5MfM?h4^s_j#qz$FwA~TzUl}T^~M2ytg~zn
z>pJH-mvM*g04s3_cpH$B_&jZnhJAC`Ze8_cdbqPWh1={OAf>}i9C|wQALt@Z>84@u
z%}EO|GDo1_0(Q)!=ec-Ad+NQENsJcs4A|3g?r@hMH9+$Ff1qU`Z|$&oih<5+khhUh
zY8=BhGwTICJy^oIBS~}SbjE<4$BGijEZI>f&}`3Lc8F@j`ezlvgUz4(2VyGR{RyZ7
z_(g~QW%>^kKUptbm?)#~DR#C58<y+@lKlT29a&#Y8ARD!=m3|jlS1>h)0tCL3T>h;
z!LMLTfa!+b+PQ~e9NVn{zAwNG(wcID#N(tO<`n;dxD^#;LUUM${sT?x*+|*lpxl!1
zQ&u?tT2EdnIRhfWZ2dmxswZQpo3uQqy<f-qkwZ!h(9ybf3>}U5z9K`Rtez4c&B+R#
zAXjFIRUF7|(0NCjF~>0pCl4SZD?rQx**tyllOqzf23^5~UB=^`GaJ0b@M%6UPM>wi
zu#WGoUY71E>}m1PnG-wgm#k0Ze;}Pwyu>I8;{db1r*!<R12xXjBoJIQqjoV2`<@QQ
z(|&EU76e|HBFN{0ep%*X8KB;g<|6gAuhn5r+jp=Pg#}U^^<DU4%2*MykWE1@{SIyX
z!Hwb$leU;E$--|<8hG_-J9i!RXeOA&nff^(L+O_2TqJ*G^kqQwo2qK4mr-GweQVvb
z1Yh@;vUYzDlddKv0YYc73(a&dbygdelQK`fM0tg|o>!r%tUHL)YI^@M|N4v6m+p-0
zA^zaQQd7&4;)Qvj@OpW3&_gs4Yp9qat|aLqPsfR(pn#mNnnap`DFH7#G+I{QT2y-J
zCPk$K;wafA@s&Lj6*V)Pp#1nO?Jij4_3PJMk#7XIhB(;b&9&|H-z&SZW*jM;!duF`
zPC1E;p?`SB-mb;I4tTu%#Yl=N-LrRVw35Z3|K;sfnVYO;s9q3;4yq_J)^(NSaK~vk
zo9LJlQ{#`h<^U4rx)15U0sad&F$2Bis@$r_a`kd4+wIi9>&?0{Yy}!-ZyjCzp}vOV
z4Di0kD=d#iNZ0H$2_kzt{sR$R8eW3?(`GLV>H{+5Yg7y3vbofIXO%b_*<yCgfoz`A
z&=i{|8gd5ago^0(qc3@KA$x5479vx%ok?e1JyO_hwe>_8e^iTp!5y{PaK(a;sSiEL
zEE`WBB{y$URKBiQ>U*sJGo2USyM9@K_PSY-Sq8vD#<@jveNzVSNz?0>-!+Ng5jDuH
z^GvF1>OYmt;n^Kh@_c3O-YNnWouY`g(6dT*=dWs+kLHi9eFp=HR~K_8Pk)rMs1ip{
zI;tbK2vMimd70EX`a`Ymm7JrgYj;(qti_6^c%pw#!m32mmX~vT$P(t0#zO_fme69)
z6L0x$P;;uUq1VD+5u9w^;y9=%P^;rZtLI2eQ$ckPRi;H%1Z$_nr1Z#MzW`GOaZ-6^
z`<-l=Wgvf0MyEB5@XXSFb=j2<#%8i9n}$;ufap9$<Uu*Li|t-|foWHQDlOCNjj`|#
zNx0I4B@zR(s##YrIi==~zYl)d^YOw<IN;|zh4N@u*T^IUpVV9&lWsN#*#$x|3jIYg
zK=qy`38xhC-K2=|$RQFJCkZUF<FDy&^_a|u`Ylg5SG_Qbx5|S>$hz-aL|Z%ke3*RH
zq1|2f)84qc_i>RE)%v{;x2G=Jl=ZY%A>r!#w%2s_l+zxksya%{z8pIiytCrr()qOL
z;BPmgDpNKtK7A{2mw3i#$Ec|{PT#~EMTt|kx`hFL$QKa3&mI*~3WAhVnyBq657Suj
zz6*6c5E^Xw_H#|YdeG1UorOQCT~VB%<+c=OLt{)J_-(|~;tpxKD<WfIi60>X)h@PQ
zmaG$lT*#ysBBpLqOj)0CT6Z!spe5sAX<s9zn=HXBB=;3<`c~%DRaag8d#jnhXSdHQ
z0(A`~l2%yU_B_%UbNr(AI#)s8MWs4A@UJRbm)}{klFc>rXCJ<t-PISXfv69_?TaBR
z6KAABK8xk(?C0oZ>nDSv9XvRJ;)6cX>TxvqD%T5TXMQ@$zr^y5V5_|%=GR`cpptlR
zI1*(#8Nyo6b~A*%%EXDi$#}#-gkcW>(9M6K7k&v|Ydf>0_t`JO?rLxSE0lcB3eZ9P
z0-9a?<rTWgN<G_wTiT^H^<{J$=_$C8%Iuo97zqcVuA?C7-C$U}aoiu&FZX2W#|^g=
zP&`TaV53DQ*%L~0uXFL8n{8}>kksuTMD@-ErQ-1t{3%DSN3xXeuh=?g&HhTW+wbpS
zb__23W>+<S#%)HrlqSBaK{V~?FIveLMME&p;+|r_{fdjVb4}~xEkf?u3c8=>UdKuN
zYWNA|x1e%;qMKfDe)&lbDj-z%hRFI3L8sqJnN??i&k9r5JH=cvd(LVG5Dc|5`_1W4
zm%he!l!G@Z!muHlL83{a{4CVrX!1ququ18VykJ?M-hJ)A&M)eW4^75S#VWWT44~85
zGRisBzCWer*uWhpn5K74#j_k#y?-CQU_=6DPD1VAb@(fi-b@B$_^rVuf3GWIbmsBC
zfNl!9uTuA64|Nqn){W@OaNEcz^n2V4&-r}TDM!E`M-6-9H0kiQ;|4J93NPU<`-Q24
zYSD&MVgB!45*pTdIVI2XQKLXRq_H^u%uV25&Tz&iWGBUKd5en-@vH@`g;*#NbNMBz
znSL3Er%zTYBO%^<Eq!_X4+3Y7O>V32ouU?5=6cwm(2(O22#cjzxuukr<YpNYx71T4
zxZK8t;X(W)*^1g8ek8BBiFvz@%kBP#dn~61$=#-!jf9n6ImFE-V(aw-aq~MJ_OIV$
z;=}6huwCS?Z*_GxG?s<%lI*SN{nfKL%pepoF!0EOB~`C5xlW&I2#Jb*fag`Jup*}c
zGy2-VWvVa0#&*$h-y~MNqvx-hN9C4IjA;u%8?0^W?$XbC59Blec-&yeSaQJGqj;wH
zSyKCJFasotsfa{k^ZIj~>M}#3cW{L$9;W+tr0Ho^muKq~OZ(nsSeBUc#~=J^Ihz1s
z1bBk^h}S4_1WPzPDu(f!Eciat!Sl5zMgJ%d<IC+N*DaAf0D8u@F%-UeI7Fqo4|o9p
zz+42<S!8%y^bUa1XW0<8q{wq!A~s1V>J%4Z*zquyAnb5+X$6K_oz2j|EXadhp4cCV
z9y8<Gu(;Db^&~N`kwCUZ3=DQW2jq8m$VJXwv<+RZR!Yz=!>GLGeK#_j<^h@O2A~si
zA;Xk+O9{}_hD!=dHy&Y`tWJ;BSG`upq_KeagQHGyE<q~*{}Sk8daJAl%YCWrv{=u<
zY1z;8fV2Y^HN{fhe;7{2lQbng_>VebRnJdDx|=AXi^apN-WbIxEnkm5Oas`)4A4p#
zzOBu&#qbkVUIGT-=jadJBQt~(UETnE5la_yuik%Te1I!MF~bASwiyDFw&yN45Q>Ak
zM7R@t=2bu;qMZP6Qw?F&NkQma7`vqgT_DRliF1af&k^B;XTw+Oh?~@=d|m5>cF(aS
zT;8bN`&x_i*&3d>;atHB1xoMl{_CM>QkHJSSD9?+jEPz{ZN~9F!*+wH>j1OQC)!8F
zv~ZF6>?7A<Kh?pcAPlbB?#d+fVh#nEeclGp8_<hUQ>4*iG$aEa&;3{P05GOS2WSfh
zW@wZ5;FNi&(GTTc2478bVhqP8KHAaos-gHR4XY8l>!S@PVqBq|rrEB^RVnRM?G5X5
zr^Uu(e_yQBzjNM@1HX{MiQ~4?O<W&6dl+H&!fh_$aads)i<LnKg7Bfv4g*mEkJqN-
zR{bcY&OKuA9eZ$SBgPy#G2+7dC`78IG@!vb=vc1ps|Swk6jz$2KI<BDtRdL<z^`8v
zO$Mi-4%XpoRgx7X@82D0M7G6qE3O@HI{yZ1WvJ>kV&lH6Olt-8wo5%qwX@iMX^(st
zMKCg@u#)+qBUROBHe9%%g}jNKUS7SJyZ&jT($)AkYFnS@JuN;di}?<kLSvno)T4!Q
z_@jaTDy?lD1?%7yl;4}u-$>aBo5Vo0yzGPWF00xpVVg8Hlm28Hjb66jb*qQ^Aqgi*
za?T0qeVr(bd}$`3n5u&6o*_IhIyG?lj*L-b_sN5lM@@dntuKn?FOiM=#w(*-pYN;u
zwlAJlT1e1Zg+{&jaLbY3gr5M*mcA2Ln^c*sW$>LD>mCSMN_<2b(fMI!!kpRWs1dil
z`y`{_gX$}k%RA5;nblSm?*?%hHAq2A>jh6E>nZVv&1s|<HCUbuoMHBtiAfUApT-ol
z+8D`g>>$jD;hCPSo_Ztv#;yTj)07|kym8i(Y{*hJc<NqO9@8AhR2`q&CKI{FS&47%
zZ$n4rZ{}<lnyb?y1$kCe^#Y^iM-r~p_%7IFi>nUjc3Kg0P$_0bU?!LC@JZ8oocL9p
z_sYFw)!K!>eNB)lpe8TO#nt4tjQ+iXtofsPv2B~XJY-+E#AJ^#<*v@1zPI@;CA!?Q
ziW(N72`n;aWiKm8nzHWeB6T4&yD|F|#)uS7>mi2NKU{r}9p%XkbT`n=lNi}~i#JvE
zPlfNy1ib#3>5h?uMHyJtR}G!DHucVhPfK$YO-YxU?iN=)Wu3ut9e@T&Rc}e1ao0S?
zclwAXJ^pLsbbpYbxtbUWpu|AD@8qw?Ev6qnWluh$pjya3&SZ8>uyh$LJeDb|T6k8K
zRQviu@bZOO(Bo6*wO8f#8WG33dQ^+x<8L)qGs?DA^6|gW-RcG*sYI8yA1Qvgco_Vl
zJtbpN>+fOWaY<?PJ$a2Q8Py2j-1l;Yx!3=F!e0|&hg3*?$~5O{kwE`dhSx9?IfR5B
z4y|jc`_A<W3ED=#%(9&yNDMh)OQomvWKsOVzb)C03_czv8eB4MV4E|T4czz<GX&l4
z!P6pep&`a39d*7RFwT-|4uUNajfv)Gr_iC%ifz}z*h4Q5NIL6FE;~l%@K$Gt*e^<@
zB1MnAS@qA1_obE*Sqg18E)9WG+)vNWlQ`{p$-T}Sd<LoYuO@9fiXesy4BS?NA8e8a
zflsCRIJHoQgJS~_*69yVlmf{dfyc2d2ToN?lCH3gTRbh%>R!o)@GJkVgy3fn-YwRA
z{VW$9_Vv5}yFemlPZhoT<j&nTJDNd`ukIQc`Iw{PI;KzsaEPDA`#gc9$cXoAj&nrE
zx$Vx{H~Ai4mXWly?Joq83ZHk3lC_^M>c2Uk#JloxSz3Kgfv+OIEF}CYZTBtC^2d08
zS4;Rz(1Fo&ab0*mxZy0<vthvgP)BjTpa~bI|GeGVIX3La&j~Mz&mNz-%^K|Hj&e)3
z0%YC<I8%^XN%V4rguyI78Hr}GZ=@4uNNuD`-TTIAZs5tMQJ7&%RjViaK#$sml*9)q
zRRA&=wTmMLG{L0uN^%o_B_f<41_Yqh0*2Eq6(JQOCXC#e`kLY402kqX!W8C>OfPK+
zh5itoZNwttgv=C_H~Q(Mkf57eObXJN?de1yUlPa-C)9D;Pvixi<+nqc1~|T>;eR_`
zsA{r?>k-<~<%C`tNuK+khu5_n_Gd4Do|c62e~MHmftqSL(zTGRtwdlTAiLv2I5s1|
zQk$J&Ye%sYltGBEjTlcOh!7Yj8vW!0Xop4RV<0V~fL>S?-Dj-y0H2&baL^9rVjz_V
z(PPIj?5WO^Te(oXfSg%RY(K?0afj1UIg_!k8HV@f<BdR{dFbxp_@?)j6iz7IrSdy=
zG<TjupM%^$wwZvsDj(?c#yjbabhap-a&A!(AC1Tie=ju`#fQv(g(-W_gAIN5HQ*kM
zy@g2Ufzyr8x)NNJ3XR_aycGMIH@H&u?!Id({Tl63u+Y3Pr{TU=t6rc<)dGl%5!bU(
z7G@d+`PZ-VDiM%+s<BTH2*vuymek$sx`<Iwki+*FR>zGp9AZen22b7c+#QU1o@u>?
zl@Q;mt}hT==~v5$LwsIcmu4vc3y<z7aypmndt~|z-Oo%|5cZl$sbe3(|7*+CJFh4?
z;$;bkJVyDnSi<eGOZ}lT7V?lS%%qLj4)9hF-JZWmHCQ}*W#*0T_m*PJaUECfy5dgM
zpVfTb(I<HeTNn&$ZcEIss~#z;)7aZvaYDU`>w@{Nu?AaDSm>%X{cNd!@u`#C?7Mi*
z=3F8?3^eI_p^E+OG-YIOct1@f-#YkoN87EG=*{M=VGXStEmtfj>sqqf7-we47_7>7
zFYetui3&gI@o;9+)c6Yv=(FU}6Wuek&4%p%W9h5IntI>=haiX&f}kL&lv2_S1C*BT
zlupUfH9{IjgLId)(jmP8(%m2fMhHkVV(;Ja^Zot9b-~Wgo;~N`oacVsuSlWnbHc9O
zR)FLy@cj_eokIMSb!im>6&M9Nw(mcr<IYNuqG>Q>7}S8o?xc?4quXxg2qdUejQZH;
z&pt*mpT??=4l#i9_Ecuw@tu#ia-3;72EUOjbkoc8&d&mcdr-8F?h4_I6W;46X8CmY
zSaLU9)ruM?VnQV<_;I<)w$TqO81+f~FLHO=u{P?L{$2#Nl+tIU3U1uV^FQBwKYE#|
z`y$b>Ly0~3Ba8&Ef?q;b)}R%7Eo04qr=Gw?+=w1dlWwKP@UwZF+cBldcBQ1z(GT@n
zHB&<X)uVCmpFQ5-xuR$AQ;OLhD^LRQ$MYInZ-aaFr}ovstn!fdoD%PYb-TO0iEEQh
zp`y4(N*vp#jvA7Vtyjm1XmzU<PIqN594~yQ(>EDtZE@94f5EAYf@($`6$HVV%nO*&
zJvH&@q4H&8A)QkOAUz-lL5<PBJCInHZfTy)Jv;ouFgDeoC?rhLQ<6WrWImk48|E=g
z&2`Qn@gf4HG`N#?qyJ#!lqb!sg>*p9WI5vgl$EWEcy-lyWpL?BA*GjNlmeC;Xxzk?
zZY(F=)o8cfl6nGvaC}=Y!L~VJ?@BG8vsvjSqYd7bm8{V5s9K)Xtoe`R;hEwjwYYj*
zDPdiZjYLfu<^eE|FGTvLqwPiN%qgg;sXh5amQ)H{3zwGf%a>PPnI9&3*$5pU5y~(J
zR}AfhR@CW`I%*I0ac|_A2m#g}lv5`Mid>>|GGjSDT%m&<T;HV!7q*@=gkHZKO_!X_
zk;hCWvof$g$#x=AvZ1Myq*G*X51z_+t^dXGbri+($Eu7(7g1H?_zh<|T5tNcKmWCF
zzU2II8RHQClbF#jlpC|>&Pe?6TjKSs=pnOShoFO*#GJPaO$w5p)>WBl<>Tftm$M!&
zIzosxd-{A;){%41i2;o<BD1)PDA8??tf^ox!xDH%eVcbu>@I|7%RsGz=u96_BD85-
zY;ZnT7hDR@d6$>aE0BKW19UCtv`44c))ZX1m8ZC!Qz6k`P9^b#o%*WjAJ$2j%~ddb
z=PRO7pS2Sii!WPH!u{36`{s<Nat{W+xrk?37`=S$m-mCT2vWX^hGx$`RQq*sdd>or
zZ+Z49j)P+>&#`eX3j1ZFW3!WebF9XSij4Nu^w9H?AKYqxFy7nKywLp7)X+YC{Nz4Y
z{j_BZAW=htD$IIOc*&!}PoMfy2gBafr_UA*BfTst4DY%2Jx?==^&H9A{Vj*~fepQy
zy>rpN;HamwO>CFw2Yoo04qhioYeR7`6KyA*PnRAB?z^5e)pO68wjQhXvz!y~yd-3~
z5gywSRSB>knQsehNfh5YcJO#HJfQWxg>LZdW?p0k89ZaNT>^TGv_;2L$;02&VQQ+X
zR_8xyYG6(m-LL<!kHkMtW=v{b(mUVq#0FUB#|DY(wkLMPrR>d2dfVA$!pP<_iUGHc
zyW)f*{1pr8>5z)_G)X}(98UyLQN-ZX?Nu7@)s8GraW<@qT+~=PL|Ab$Q1Nh2v#d92
z&usn3+#Ppj8e3E`;(_t_L33xb)#d5D3Q$02`v7`T;kp<dBuQgiH%nGB?gc4}QJ=Dy
zvaEZ3IJwL;OxS-Czpc+@B;!~i!)~n;M(46p<VyKXl5jPW<Nl~C4}Ebc_t!=k?St;T
z->oMpqA1&OURmEW$R6b%&mrg_+zkphDPjORa`7fO2C!-e@s8(dk$X5FRg8Vi@l3#Z
zpHv*E?1l#Et$e$H@=M&O$c}+Q3>EvohVr={`J>Xtg=9B!xZL|YAwUQ{ojvs%5~OyD
z7YKc~ckNZKC}iXaZC?hY&i5YlI;%l+J1!DO(D94IwNP0$Qq{k13INCmc)>{{?I>yR
zpul9+-kfhHV$=FC;N^7MA#vO{g73s3<LBdDpX{Z{xbYUA3b_Ck_07Fd$@>YnV$1tK
z7I)xM$e3LRF4*hX;~okqacUc}K_Jh+Ww5WuK%?M3pqw#fTQ{z+Oc*$Q<-zhg{~H~4
zA83cv;dK0|s5`1!_mN@}nVE}150XwL@7~uf>5&)+A6fe58T;EME`<%+^$7G`8$?A^
zRU8uk8xL6NiPM>t+1ruu7x7L|pg2F!Dya`c0P=!64B6xU;FR*M(4pJb|6>hcX)v5`
z-JSqtsmUy9#Ak9HG1|OzfQbOCA=T}`zYKuzWE_PF@KbyLVZ#iNZ**PU<hm;2wI0Nu
z<pFj6gYwfy!iWDF_L#1Cbq#jM?F<2dZWlv5(7hitaV{~puMaZ&PjVixD<r&?%RP(|
z26&md_qarMG2;j8KtJRlF!#dLz^KX9`JMP>9s*cVL?Tm6izJ5+<41_a{{b{N+JK{e
zd9M`p(Uyyf&%yf51(Jeq>8*w7cRBjcs9b=bZZs7W@RL+2AOLcFe1pt(l_HnGb+Y%j
zdy%8?v<nmBFyimn>aWW7s%McB5A%R+hW{NJ#{|HV)BvXtWgi5rP;0&*U6?(ZGBD&@
z^317qgK$Y0D(6-5He~keG>(4QGQCKh240!(WGj{jg(c{FDvSLEIko4&@0k~_pV*HV
ziZ`2Eb0TeEOol=2_-G1h<S8<<$?>`H*1I!0E;rwVAq<}h1*7LDeqE3JK+(D_;%b|f
z^&uB88+%7d@1r8JX4(Pnw+ebefqN8J1N>jxom^aVWvJRu<`NPhX~O5<7&Um--*y*U
z5fx>AMA1`kXi93dpufMtnq+vOw^748SMnt>?GBHhDXg_EgI>*$CEHis<I(qyG=e0O
z;WMS`p!AXMjd)*zZ<WjZnxiI%qnsF_!oF6(ua*~PA6r?6Y}8wq-?yY>!ObMmhrqc4
zMn9(GVx9i}E|NHvG3?(l^{{8>>+{1T9$HoKuU86yZ`~lBB3XyO%OID$iR(0@->hIa
zxp?Qa<f2KZh)3~+Q5~~Om3EeMT2B<ZzP0^EyYA1LJu@P>ScX-KF-Vm9-hoFS=ewxm
z>6OJR-#~442R@RjyK)@z&(z#NJ1{Lg!+Kw6%Mgu(iMRKLLC(r1tSf0m)ZOZ2VU};(
z?I;+|N^C4B<B<KO8YA+3#P+lGZ7^k-(hhwm2KnBIPaU~;8ji){l!>MznI+#7mcM)>
zQf;ZVibd*W`}R-*iR!r>o+EsjUw9pdqf*kwD{3uc2rCs;pfhqnM3T7MX4}gt4q^nE
zAkLWzf?AV~hAk{dzN+~do+<x_C_#`WH4F%$D%Sb=)dmZhxi1<{AsT8KpW-^<nw<x)
zJ32fxO=L`)(@*<g-ovB7khf<jq9w3f^LP0diD^l50t7B3eo*_TDCbC_VtA7Mp)=`<
zPoBgE(RL3bLFlNBfsx7biuAh+CD}DDGK-x9%-}JQdUwEUXc*(eqVUA|6@lCi4h*U?
z3$vNr@{TbumeoUl!xdhE92_V=n*1K45vuO$6@dLg%DnZL*ChpYV0a<-{&&~=g3o^j
zI_k(3=!rx<#=&uNOk)`pqhjCjF-mUzrUY+Rh$YHgzd@a*92Zs$IR-OSw4*4*d4z8!
zcooqX?;+0rI4d}kqg{5QFxR_wEz%MoN>>4js|DCG@{o}rC;&Cl3}oF-<V%-*nrP@L
zvtp3YFRWb1oorD{sC;uv+Pu}&U^MOqmKrhHqgm_L7!9VfFvnu{{Tes<g?x(z0ae<D
zG{Qh;4$(fQ)*(CIB;x#Y8rHbEqB0YNlL6(TTI&0jchuPHd#brR@VS|VG0W59#W$u>
zEbLrhsY7{u24igty^+Lpij7nh$c81!XZ1#d*M9P2^hY^Y)Rr2kdx!=6X}ElVGu7EW
z`2$mLyZ=Dz*za7Ct7;+oAG1tJ$ek4<D<wDXQ_KgOi-KM5nEP*u;Xe5*`LqvWb2l)2
zQyy`@m|s~l>}W_~hm8UEFTXQ#kzIjZkUm`y9*gh*o^*`e{hwAi*6MT+xP&eLN&1ZJ
zPQ&x5H)<dTIziX@xgv}5Q9CZ~-sH+qN+W_ApK+EOk4iVY?uE_<H^-IV%_O;BpkZ1f
zI82~tBV{<x35WJD<bsk+No&f1KaAuYZ#yd9;OYj$py09SR=cv20w&|-9hT$+8Kswe
zP1zoN!SY8Ac>S53ml+<WO{28S86PY~&aX!01RDLyu5*7Ww{k0yZzfUd+DU_RoQDV7
z_|r9_8g-^4zB23eB{#<g*slv87~L5(_FgwRia=f@CHS=WZXnn4Bl?p}7EC_%h>=vO
ze0VBMRg68KeYQ-7)~oRVD&(7a4#=ixLjbM!2lFTB2RuBdxgE2Wo#sb?t5l|`?Z^v~
zAEzC$Hg|8f&D`B7BpRsa#T~0ZNpyLY7@@fv?0&L54s<=3`?hDo*g6AlFwYx;IXJhF
ztBw$_It6&&?E>%e0Fg{&68T~qEjyfYHWDRF4N%9t$Z=&Ou$Yt-N0U3q&zW4Qb$(A_
z<8P(1R&Cq&ySMi-j&T2ccA!UGV?18n85j0_I6<W92=Ndy6JO%g%A_JBwAnIF7*OD^
zU!An;`udp3_hdQuP4r})jV(T4@b^G+r?ox6?N~cTy{(?Rq_gNNa;5c5F*f^#C{^cn
zAPMoiJ-}qv!i+IQAg;9!k_$PMV_5K#GjR)eiwl|0?9IG2h+OMv`YYp1CSmDj<EiQ)
zhG|S#W0=+Ktvkp9_zrs5GC#s`kkyX~!^RfEFN>+-OCT?9Rxue8Sz@&WP4nMzxWkq-
z#ku@0Dz@jG@=sEm5<WWO{B3AmJ|pf#U_|BEo)q~?y^8x{_1+>xR@Q;IFY^#y?^-?}
zBHLw|BKsKo%mbBIB4<%$qOf^T&8ibu02AMr{@q#yeged9=RI3f&f{c@L(rg|SX121
zTi3U4)d%;CvN3E)^NLNgbbn6e7zi&<n#ZF3F80}6Jt$#yX)!jhnr!{Y8=<%X5{+V2
z*69){)Dsj~GwO-cuM@BaDF?8|MAY<sE!7@fkbx|3w8ahHI`Iu{L_Oh)sSBg0Dc(Rz
zELL{-sl!F0L8v1R{<jZX!j9CX09xE?cC2LuwS`0@M76mydatA<N%|!?Lut!t#g}LS
zfH(}y!hPe%Li(^1Rc^3C`D;o~+wt5OEmGd4V!I&dr1IeT&GGt?=%j|@G~+>He*xDd
z@3FP76g4S{3-M#g40ABk`Z30rm*=?FkK_rwEQ9(OF%;c5v#VzO_z&9_2Y2&xw(%H|
zFl6)`veXtim)eWqWvZ#YY_#1@;`b5cWxWul&XuE}y<lD5@4L!%-_a;vR-k%MeMBQd
z^w6D>wlIb3f(#vk5F|60UtD*;5?(rzP$SyF#S`90QvGd^X{0GVuPmI<{tGxsH+7(P
zL5od!$?%5TTY(4anVyoz@{g}xC-mdSt$LRXUKBCZl0CvgcH&IoQXVK$s+PW?2#YA8
zxt-eboqCQP8;wI*yz*!#<$UmU!c)m1G6J;~HTgT+K{8A0AV2~&b@WMHdGI3t;fhd^
z5TEP*o8g<C1T2QRtOPs*PhD{tmS6jCxu{y6$wCmdojA4SMQn%i=9;Rnvw>^2KAb3R
zu~tYQE|K~Q?VD-FFjo*qAXK$#K!q+;FB^NEE-sJ9&}A@Xj_bgt*OfNRH7V1@+Mlq%
zu%|*tivL+H6VY!i&&(_5@>j)DrnmHkMJ?XU5smk#G+&$@&1HW$xUsRf!fH^wQe)kO
zL9VSMldH=np>%a6R}$w0VNm{)FDg>+P{EnQC}hKeL1=HOE#L?)@`Sv!9Re}GI?31L
z#EEd=bj`pMy5v5;s^)lqYsSg!CtXXNR`P5c&(lRtVrACvn3N;6Gj6EaCVHE4knoK2
zX%k)rlAN}(R>8*3%=4M~5Q9(skq(n|{YGr;iIVOF-kz85*$SMW0;v~GxS*b}X7FtN
z_7*Wso_k!oxN1~V^=Lv#l*>l*^uekuv6yGYtCP>*j*({yjoE1+!f#Zz2lILG42R9)
z=Vw{vB}wx7%_$%dZ;<$?s6<bJ=bWRNdnG)BYz?1oSfhvvavBWl(3XO3GBbD-qUGpA
zzR-GIjeigHD0^N>xRxb8+8&ljGM?7&q)}WWe?FYq8`D3JkDDjH75aI1lwAsU8w;=^
zn~5gB#R_DLCn>42qviq?awp-_lcU>{T;vWu=A!zYo%S6!1J+!YNK%4$p5ck1LYJ~^
zHW!j+=e(_x^cF+O)MI_Z$UNZQ)z51BnDYWe<k%hU5)NKN5?3H065(-vSV^26iggrm
z^$ATFMGI`ZB_1MQWM-oyWRq*Mvgh%@&L7dlD6L0CkmT$px!(pP4s%m>XGVWgd>GmA
zjI*MUu@~Q#JUcHZ16;R%7!FXo!Se~Xc$^R>4Gs&q`&~=*4zz(ek377S1Z;51(O;8;
zXU@yAYM-(%8>~IZwKMKfKyxSf-Xix2b!IvYaeR%A?Y~ze5~e;FV^KcRv&r31!?1_Y
zsOW92U%Gr@ewNddVfYuV{M>VaGmeH8rJYL^fB5J*3y9*ff^zs&<Ywlj%+a?>0^PYl
z10L3p;-qSr*K<bXSve5T_HKGa=?x4u{OYS<dXRK%5|2IOi6wZ62X2uj51WmAZ58zk
z``W*u>h|G4=PZ9$(`t{IGj%0Sk06=YgZk_X)Un{Un#sy_SgfV~?~Ro24W_^UR`*cu
zs;rMMHNN9N5ErmZvn^Rkh#LBU=e7kC-U<PM)z#?84J~)(_DHB1WA{OyQkp-a3a51e
zQqPRP;xezrgJ%rk%2h77e<0bAFx1NI*LRJj9gPZAND_J7Q7d2xQi<hBzc~9wdfh4W
zD;4%3s=B$KR*c&}JCK61+GE~vGkip~eJqzT`7sYqKh{mQ+VmeB!53{ypT-gvdmU$c
z;RsLpZYG$h4a47x^Y&F0ADb6Vz4Vn|2Q`OQ`lxRog5z`m4qUD3>6{E~J5&Z`Wj^*|
zeL7bne<m~cXOj+z@=LB<%QI5p7llVMjAxjIyFL9wvs8|Y_@}(VuEnOb#SgfrbM2BG
zmZpSR<QPGZs8NN<H%Z{f^TvT=$`TG6%uheK==IAUxu#x_>v`uXf!Y;M%ISGU96=k@
z&nBq3kf%jkbUa;`bLBskXt?73U=t!(1+m6yzvT5+)<*FQ@ol%XPQy+}JK_dGsf_nr
zlAkInBL<#Fs72FLFOSk%q`+62T)@}|%Fd*FKNcSPknDJC$C^=8n1AbbKR5Ncxa2b&
z{KOs6pT0ZxNx|hCRd#mvTZSMJ>cGah3UAnrH<shu1fJM!m=sF9v&&$2^F$zXu7VMe
z{RVyi#_K4mMAH3-45OU|tp>6$Ioif4(_OXHv+Euc`OqC|ngorDCHb)U7#E$wT(GvT
z?kcPPhTR=a8!Ei=E{b^*E2Md7G%zy6cZRmiDZ`6}3|6n>QSU=y-OPni{Kc2zu_CGu
zj%;#(Htg+(F)JPauNd2TDoC~kd1bW&si8dyf~K)_oWrQHzl<?<{@v?}RscfC#avWx
z5<u-_#-NiHNXkQ%VU&Bt`&<!s8>Q;KIj<%6Jo6BWn(A3g(@0z?%0rCzx0hD4?Y6p_
z3T65obGO=h16Mx~{G$7GrYG#A^8I~G4fe?Lp2D+_nDNFr9WgWyP7)6>#j5ne@3<K)
zrn%98{oUmEer&f-k|i>*yq|e$(Pf?8Xo=9w<w47{9C8H6Nbh^`;jY=V0Tn;Vu>bf*
z2Z3j3dGicVhuaQ*<va1VR*CZHPGHvzuC@1Enbq7$m9IqGI~@o<pKGfR7nk7IGdf8=
zJ6X?c{AR4DFZH>ixYs(3grS1vvAD?1PEO4t$5Bz4aX;>_{CwnGed9r*YvoE}xYh%H
zR2^V_2jB<O(#5GNs>&XL;fH&5&6AF`g;SgBY#{Y0A#jdPQ|8o_N+;douZR8Ilnhpk
zu6fh72Ra!XjDK?y+Pz?}nB77p8s&^Fh>9yLA!KRxxa*rA{UA$8yk*CJZEMHIzC1?>
z>`o0a73-=oV@>fc2jSg=$J(Dc|2Ws`Oa%xCeTi$dj7-o%!Y<y0b&CX+!#v^UedNMI
zOAw3<bG%I%oA_bXp%?#8qxV<D^Lvt8Ggf@Z+pX#4`u7nUNwe8^t$mK;cmURdp<%Pp
zOrpUaYzUuP(@>*i%H$Y0n`=EdXmzf&YWL8#q3jO)XX<a=Ce-LaqcZ8pAI3HE^@#xV
z(-|T#h1cMlg3QpT&d3_l-T<uQ>WvQxBiIBscE|A+z>}(KQQ3wi0`)UprQz%q#U>Ya
z07RQ#`87&;I;yFKSFhdKnx<s~FqZgC9{=S6<n`duzU!VmT#@sI%Kia{BI)RKZmAb8
zWo9|8n&vi1U`p)*hL_GbIi4RX&T*G5Qdmlkf0aE7Aht(YwWnz}M@tVk{m~9IvdGT9
z=e_pZY4q2)1*Aa&;K|?{NPOR2H2bIT4agUBI{;__R4C?`o~3*QgZ>4H<Ekar?<-cG
zB<+kX{#FpECwT|TCUONXaD~61%ay^Oq~Y6Q?;+=ON&pfP-!t)JnP_}-n3^Q@I(-e&
zg@Vh~mZ3*+{X2fR+TR8;#&b2Fi1sIZm>BM3)v`zsrp=pcU}_~f5OjIs?f>=F$_rC8
z3~Q&=k1>-&XL-EaTs{2HDgI^yKYA<FxRtxD!b8j1h#Xk6^NnmoTFII5>FAdNFQ!$C
zKN<1J?ex2Sd3~}zRVj8@zS{)%2N*GwsgjHq;w{JbzSDdbIZre|p{L2~01)>HUY}(5
z@%5_V7NfxG0=g4AjtNug3u8pF+1cDsEsd`3r2EixR&Xu9F%DLHy4ETV7_1mro$ue!
zG>(u&u8g+Ub>Je@_m)fK`BO-8z<SM0$=fTB*u}wg(ju2T1vBRh8`D!e!>G|8EU&z_
z9t4O7aLY#)XKSVA1;(~rT{-^tKGKn9=EO4Pk{>#V-&0>uT&hl;G9h^t<yD!0^$Bqo
z-<v~_7>^&yC#!WPv7ekg{@LU1ZId%mfgMLqCY7DAzl{sj9GYH@qtC>~*?#$~PnR^N
zw3+95jK$N=;BoZbJ-3!KU`){ZF^QBs67&~u8W<WPy7l+p$^Br%kf$NU)Bp)bqSIHK
zE&It(#7FtX@n0~=`q{nhzHQRwD4I|k4Vm5*353p{jFV67O_W{wG_!n8uB7uP644PK
zt!rw1`j)V}2QL^7{fMFQoBKK2{4;o9;5#E*NZ4QR0|XKSdCyzT#8`DV!naOEKvVTI
z6o&*rQ4N9UbH|KgOph*4(|;hY2LmubQJo7W_AUE1u(jSwALiQfvWe&rt3^y9e*W$@
zknC$26BDIRL7QcqH)CVY-GG&-7d7(iK+SH~VwOQOHZ(K@nui__49Np%^N7FZ_}$Jb
z0JCW`?Ja2T8V^@h6?%5>J@6nkImtM#^P`Podp8iZ_zs|FXPyFZC)<A@r{pBLv~0f(
z-SU0vz4T8PfJ0Pbt;k7(!X+weM0q4Jt`${QV$3lv;738quJc`AsVkkn)yey!xV7W7
z=G|RfY%<+Dw~au0U#$n`7V$n<7Sb_r1>DM3_1?Jr%r&^~E7Pq6Xe!rR21@={lq{L?
z2`WT(k?(2!qLuRro+Yd3j45nPd9qMXVEbpg^F4x72?KS-1}a(6XTJf<OU}BvE5t0D
zE%u&O*_Xa;yXUiMllK+53jW+{{Bfh8x15|W_kZssoFZ8G1?G@H)99^$GDQ??14CAf
zs<oGVLfjrCOfLOGh{jb}Eb-t_UXz6{IFcSIh9m<aTTC~zR4ARGISj8T>34#tu7YUZ
zdR~-hh9M}$fxC<lV<yNpP(p>+O>{cR8We{}4BfShc<idw%)k=76vQ}&+J_uy^zqe4
zNr!mV;M06-Huck*7-i&fifc*$gY7@sW_E}AedbX;PC=g3TB`8dK@Yw_Z=TJ^Es-vz
zylddJ(nNqDCJ0LK(y8Ba8Tc=AjhOCxdzmE%kJss9uJQp60J>-S{HBlh>rs)s0uwH-
z95oS;CN^DtyuoO+Qk57S2C~GkoRuvJJ-w*tuY@&Dl@yF!;jcZ)W#E<^s0-_KUH&`D
z)?r7IxQb(HSudue(zJi_A$-m-_>7CBo&qiZM<fA3o_)n5COfk?O=Z0G2P=4p5hang
z`F8cuUTmG*laFIR4Pw*&;B_)|{`^~#3?UM(@l$FI*;TT5o+r{Hu$3h1CbxQV&nld>
z_EtWC2gS5tr5_J1Q%O0e1bE_qYSdHyi0Z)*Q`rQcy_Xyw=s)LRWrB@q;v8W<JLK%k
zvxHty(5Y)D+4lc5-<vlKCJsSOi&=nIA0)tXmUuAgOP?s04-Y=RrIlMn#=7buwQ$cy
z1>B-sEO53Sv<Dr5$5<PIwdx?2-{;a@V9mOfod^RT7hOl|P)>w}MXah$g`Ezr2y9)E
z2Qf6osMwA0{#>M_R7d}=&y@(m@RMZnJ)SiD7^e5MX3PCyTOeI|VYmBeL#A00|7r$+
z%ncnHt;|<IM0k7Nte*ayXG0Uib2WzOqdh~c9a34fEywVL$ETT7gLY4j<vqV`{S<X`
zz!nIf6CM#{RA3%$AIHf)+Z8I;)okYCuSz?6^oYk}TLFENS3p*Ur^r=9*0SQKt|#JP
zC{Y+s{p?5FLgM->In<#HOMd@}a_a2iPNw7GR-z+{R2Vx}%b+o5bv&k_T3S>%b8Ur=
z>u?Luc2y1H)!2FIN~cEF4`+!+`J1`AT_(rqSKsAq`<=3WBJT0XUmh<TcVtYgs`@+h
zbkIsXzMv+d4wdO7L%sUYBIAT9^>F^ucuCsQ!6BHj9x?Ca=R51SaLnm%QMUiO*UW)T
z<_QU44+UFwsAha@K`UO4dO{&`6nPU~QMP8-8i#aCe(DRC8pPzqF)m?Au*Yje9tIco
z4-2jIm7y=I|G*lYMpb!fV7>u7`{M)e^_$|y!}U5UiU4acF1cDM!$bvkm>yyq0mBa1
zv=7A7l-0T_UhVDE`wfY`)qPuNU~G6Dp`GieuR+yBMMYD;KGpW!2a~dbHB_Lu^bn?`
zFn!!0N+_rDeCi`(VlF-z0hbv})hQJ)Pv~o&`}wSKY9k8O`V8NaRfq;Mjx^qV9sACp
z#;e6Gg<l{EDU)L!u5k(<u4vA_oqx-mSn+E^s3FmMb61Fw6!iPYT>GQ~T)4Qz)E@P!
zMsIy>*>;aG`^(Z`JhS{R_w;GS1r=5O=BS_nY)QdXo<QR@()U?=^WBs4nzCrOAiFcJ
zdc>09KFRekN+WYv-I-BTt$gUtfpuKA!%sYLYI99bV)a$h3$xR|3Y7P3lSEim_X<t@
zh^5S|C)8^hm8!T|<k@M5H2wGuNfMf{jk$@|gjY=Aa`wpFE2koQ$mt(@&myFs!`ocG
zA4!|sJxPKzf#I#+&d!#Y&nsGG_lyoSE_KDj3;>g7FI{{a<UM&LX~_y6Ci8vXcII*n
zyba6fzJs_*1zaM1xhjh!pV&QP=KdLEiCC{X6#O*JZ?{Cn){v%cJm4Y)5bCsuM5cE#
zR{-OjyxViDTkxK0H#Xz>u^x|iU*C!R@J+T<%En(+a4P=jAGQxmOo)?A<teED9LY&p
z1n^w5d-Wfv3COge@<#Q=<XwLSgfgG=?pV9LCA8eBipSTB-?1qF2P(1I^S#Wf_6h0T
zQrf=%-B1JOR^J!ddg-{d)Y!Rl#usQ!9~1b3(f3xP<JioAxpYq??f&h1VX!wwJ48$=
zSNFr5>eM{YyHt)DFxO3dJ?UX%3!7I54d=Zd1+U??xr2o<3~0^XpMmJR%G~4u(!OVk
zH@M~X`RpT;K_D7cgZXp~lD)T3n#TV9-I{votUMf>655*=Z3at#Wy<{<R^TUp_|La=
z0|f_?w@dLD)^rSMOAktR4)4AVpakqKnH^>MeY)L=tGx%j%m8UY8uHlAxBO-qh@Jro
z*tS8U&mJVegBEpX=lA<4%g_>ozAIl?U+0elvWmlVV2-tj`}R!mZ?37ccut^miM15(
zFFtL_0QeGOv>XH5N6qOd_dpx><pGX>u?TS-A0$3=3%U#_qrzyf{Yn>!S4UaK7b~f~
zyJYsKRk{rAz`gO;AJ3_Q{lG}qH6aV&malXbdZnB#4~?A!Zka!!tZ-mli1$OIGhNrj
z|6Z5(x5<Y!YXHJ8vAjEFx(;IZr9R-}r~FaZfT7sGqkp{zy3JA0zqEi+eikt9+^8kH
z@%wfK3|Zh`@o8sLPv@y*;(NgQ0H}R_^Gy+hR`N>zjgZ0nm*Sshn?1mn_P5+I_NrhY
z6iCPXH?eF_Fwew!sow)?grHGi8GQMr$`WHNdCw8|@AKDw0i?*ubj-aeF{R#F49AD~
zn@c`uubHLlUFZcbFq?=wJA-^bK&v*sxVyAPms=Mfa|ryM{_rCZkXjFP>pop89pXaD
z_AL%RL*X$W#it<-!B?ZqaA5W;39jMOI2_@ns%4Au*Hd)QyNgiM7eI^8Y5m@pgL{qn
zI1O<<DmVxXx{5#C-`HmMGym)Li$C`7HxJ~y&)6@>g^q!f!t}#79lq)jUjRJ95gdR3
zf?WD;2p6C`JAeY;37!E=QyM^1mjD*$HG#dO`e(5F%F=bW1zPR3S#k$PJKW#OZ2r&x
zUY+Uso3XckcKq*+qpDYh4TPgr;F$B0H}Yth>!BX_Z-yNz*dZ`5ZB*`#SpX-<u@)ZS
zn3;YoJt0USOrL~*qbV`+6^?g*%0}Vci%8(81;Vl@fb=LUt7J?BfG=%u7hM(DQc2J1
z(mw=Upyl}1>!izG3!Py$sw|MA1o7vNlK-Zy1h@=ih_Z!?XXj0P|ABm;2iIRxxW;pe
zL0jGk43nfhTtYB;#?n<=#J^a)crKET!3Kh~KeD62rZd1|pgSqKowy=Qw55DZZX7r3
z8T-;*AnLh)<A)WHs2V}=G=CH@BVlEC*Y*~e)%fd4;J3K12UZo(|3A7o2Py)dq6h6h
zlHTVxn##o=Q06xGJ$eyv9b<`s{~d*SMg`nbI1SQ~pKUwU8VHjeo;~}D6dn?mTCaZ9
z5Sg@Q<TD1T^Qd}{q~e55c)YvA1=fs(t*_lp9tNB4r0A-zfp8~M=+)ouxGt`7+LZD7
zzR=s2o1@#%+G-2A&1IWJi<h2dY4n!Mf58T;9MKsn#a^aG&!rt-EypvHa>rj-l$D4M
z8^IMzHNT+cex09}^Ak!F3XCbWr!5j#uuG0w+W|2n{J-FhjlB5M$Nf>wuak0gYMNfg
zD*qs0m+*e=8X{qd7q3`XIJU(IDJIel(*+^BK=)w9AQZXbE$-A^eY$U}`SQfZx!L?K
zyrD=~Q74(XSi|7u3(q!>fs{1Z1manCokkIhFvi2Am*ce(nJwu%Hc__?%f!>OYl48c
zN!L1Xh1jYoUcP7)BlU&_H7q<|_0dvcAyrmH6eAC-FwO%hyyl+)^%pfc9IY{Y&>!cE
zk4YZ3li#*r17VtPrui;Dz56o}ws8mtb$1KhfFy#n9l*qL=H?C#8L3Dr1xB-QH#hFs
zJOjhd2UN=yr9L|kq^`8<u$G(SQ5Quu8+tEIvM13JAN=q{<y55T1{3vPmS$Pm)BFx5
z`FSZ<1HwpZon4zyT65YYhKlgw4h<Sv`JM|^#gpxxnV9$#N+v{x#6C;#xx$2JI|lS*
zTOK?yHvaZ-?GXn;L%wnew}3XQl5xsZc2Ngm>cF)akh!y$I<)eQJN63uWKRyOXGjcH
zX0TYf>zCoL^>^%DrS;a$Bfmb5&WnmhYmSzmk3;|X>}g+suQLxMjI*3RL|N!~K7M3!
zH>Z^QTZMbx3k}FNCgX~ZS)7QJ`Cx;+3ajmxBG6}x3Oj}?mGBeBw^StbLS`5llja$C
z(Z;Wa)Wotdf$URx91<hzQ@2tnz#oH{pY_MX;fNlSRY1j>#~H3l>@CajXY5z6jv)8)
zYDeOxaKSPa$yH@WdqYb@3%3!&t1%ZKNih%8$*1}{=tJ#<3*A2n%fS?Hdkd$6u(**c
zKml@RD*ufy>z3u06CUA1{gcX$iK*oK%1|<FMfY{jc1mPlx+gZ4@7eSnMr<=pIOjEY
z#Vh^5&k|VqTS8_D06zr|Fn@^d%N2Xel#(<YD&|$oOcZ{<F@4&VUE5_XjNr$OD&2qL
z%6^qNSV3M9<rV7+10m3N4%vno^&{UQd1!}NAXMQ%eqQha*Gpac;PI?H=TB$T)z5jf
zScZ`vwHGV<9c(s2KRT^rzl~(6)xo{_vkCxbp}<Eqn#1fAPx~mxRe@(CSDM-BakA4<
zi0U2&GF>e_a+=dWsDgjH40vx~WS+AvD73EbF_h1`fBnPZT%018VI}3{hZGj`C_Bis
z`<aPfwIp1urOs#?*9RkX+eW27kj?0(Cq#Jt<33@?>C?0mzKgXEp}TH?w2QeIeD%y9
zJG0Pk5qX>?-LRwlj($f@9f~N_$}JFS8^AdxGvQPi5P7x%FO}p)>={+XGk(+G^6YhO
zvHAIbT&Q=M1HI|pgBZI1rEai2V<ojasPtlthU@-(zW<F{7{diZbfE{Fy^|(JX*woG
zpFJvA=&_;+h?wRd4QZvc8Y6P+`h5>3f+(sBWT)<O31jl6{~mvw(^}3<y*w46dm?S#
z?$Bzj6-n4)LpiptT6RsuO37ETw6A*J(yzg5iS7>J&ITAzG;GvZ*&%s;rN?I&+H6hF
zXWiIGd7A(Rgvx7I>~C{Jxv4@KN?OC1=INiVAhxB*e9XHEh`LH-Hs$-)v&u{3CL=Y-
zLZq-0<9{vBH=4b%0{1QF{0lzGKCi$PBnl;f#?X!5!R}?)p1tJcQMqL(nk<CTaPA8q
znQDsAv^wQ|>W}yBvke^eCdr|)c*EWSsJB%4jm)4}|KdUd3v*Q{e(RaSfUN>>e{2S}
z6{19ZE0(KQA~YIL#5MMcn_40ji58!~5Aw4FEMxhGa-S&UyPvSTDYH2-sc6f(j&CoM
ze~~&k1Fj=6U_o=Nh_xh3g+l~D7t`lgCFbI=s81i<hiK|2GW*vIk8SXTg@(ki0gsdc
zsWK`KmVjR?a(wM71M%Vq&mg3@Mj@-**+2k&fap1rY)yVE+cY-_h<E{(NYk5oi9Xq^
z$t(lDgaPmQ<P{lOw{~I^pS!NSW<~e3xp?=}fS>fS%Pn~H9>7!kB2w{?`U3G8)rHKq
zS*H}D$L2}!!HZW1;#DE@(GOYQWo7Ud+I(-Bjq5WiOUrU07VaL^YK2iczkKgSslyaw
zx@A!Y;62lg*0DBt;0WMfT0HQI{B`iM5CXgfRS6ItWnfZDw|258w(`I+HGY>x0srH&
zo+|S8v!=42YC~+U8;>a9fJLlo-@Ckkd$<5q-9wc5YOgFDz@ZV~UpIl&)*%6~wALb;
zfzDW`33;oGV63)>fG;pwONTK>nskwIP!t7xZHy0+TuqP~RpyG3J3kVt^wbml7n-5h
z;mET7?;q!UGq^>cx2#im`bg;D8I<*OoeJ=TB*Im$g3fiS06e$?6|C{2Wi%kynz7Mo
z6aq{I<N;h*n`4~Sk9v`wNFMj=h@BqxC?{ycbY3cQGKn`k;B71wP$zLoUzNs&9~_5D
zl04PDRv~1K^+he^$`2ta3$$QRMUd@5g6Ktl2%%UQaS%S8fh{sbWCBMy94sJInh5uK
zUD7?SXz^@@Kn)}(6+78OBT<;u&d%M<S0IlAIA%NnC{U03OwSHfhn`IH1%LOoSqpmV
zE`0Z9ISc{L0bhGlUX>ES<SDQ6K|!L4iVH}xcYLv2>jJKl1Y(IxIn7UUA3h0%3ti<W
zkil$06y4YqWrwfagw9I~x7;N<G>1Ol`f5;$#}9eos!Evu2NJn_bn4-xin|gB=B}k}
zU^q;$@&$JPB9|2ZfwtIr<FBviM&@Z*3K|(Cv7+rj>UR}{E<Y-s(~tFHRixCL5~|r9
zZAKA1FEt(=qTH~wIUm*kp1bLzr)+xyYQ?!ZGK1v?(ZQS5r*?>4+d|t|(U4*}VWxO>
zeT@}kwy*HQpdc)ETplbShl0PTve252XH21ok*2Gc2x}arHx9Au)Nc3{&sTF_oqd*k
zuZq-4h<n6QTl2!*An6CQk4XlqmQFEOFpXkIp%KT&HH<Mn;cWS|bZNNBlhkOye(Sg=
z4wA$hyICPNC-@>Gtye24pdbS#GHFU}-M$ihp{KCsLU!K0>v|5}(r%BkZcmgzK<JL(
z`tLo2gvQt;^gbURv4ktVa3_%dPRjELXDiRk6#SCosJhxoaKJ)jTfZ4QG5FxUq)A6h
zrVxGPD!Z;2H=|2m0mi(L^izW=)K*d+C5&B<X@Jj|cI7_(Tx^ZEwc<Ks3f$qQ3Oiy{
zrb|5qAS4vTt%mfc;`d#O><=T?HIgJ_e6Tkxk-5AoN-^a}kAHdLKOU}X0mUNk?BhBy
zd1Vc`${qViwltUbrillbp$g;AoQKw(xh$(4Z0|B=wk40J!-^lq{8|q6Ph4J+tWVua
z!$Iw-rWvMxsq#u-&$wNrji8$<H!RH%|1x!-t9?4b`vAeRJ%;touwl!N>G>5WB9&l4
zs^MAB0c<_8u-j3#EhDyVRql1J6ooKqZ!Z%@S))(JwB`5Jc?^<Z*yQU$t?mGIb|@a3
zyF7jPC7Xe^E6%F;M(IK6((ZRBymyJ+pbN2+_~F!W$0Y@q`SS0^45>p_1mJ`N8Li3D
z7-LGujT|G=;8yy0$b`B&2gT%!4Y{sbmm!-4=jzx<J%IlDd=0|eambvw(_}9Bwy)DH
z`>3cXrT8<^6N1E*Tb-KLGC~VQKW^dRl}fqS7dm+KnAAxJQC`tiTaK-z)RL5RHb&AE
zjRAoT;)3c2<4ko{0X4r8T(e(pSk8!<{k~wvEb>3$qvMO_ab4Mhpreo2ok(w0!}sYw
zxWQ?p{yZvUvc%86jH%l99l42B;^XeDD&?0jc^}|Y8Avg|HHU1E_U`u*NJ6_k-1R*L
zGZ>-52Tsc(nWnd*jGd@AKQQKY5_yBw918ww*o_wP18rjt-egflw;dHUV*cV=rs7tq
zyB?6Sb|Akc8+&-AMd~2r(B=b*G9v2QU%q4Gi{V$6W387a2@$l2o%5MLKN-&io<}tR
z_~1nKr7g@la+}(clv|-RsOK-H)~|BkAeOYjfhIc`cV@eX1MObz*XNf0v`X`f0?`WD
zxU<3b-Q&gC4#~CVCwZd>-`dBQ4sk_(&`s6YPfaM9FV$i*r^LRL8Mo(>FQ@p+#r5WO
z!n5(}H$(X#0y<aKLuH1}cYGj{Wc|$Y`#zln>Wiv-!$>_pO~c@wws4&0R-lshLd-|+
z9BoBazgEi^LAhSkB&*?#bka5*-?Jqre?^blXd)#-nLo89pHYH-osZey<X_@ebY}oU
zFB3WlLy5w{FHNtWZ0|O90_(+_0Ed|{A83f|@$-QY@1{WT%L{(Z>q-9l)0Qse_)G}&
z`YHul2Tk?<@P69`#4_?ZN&H}~Cis@G1Hc+E+P_J#>i_Zx3Z9kGh2{9Do~)OlAM4Sj
z$4)&J0(lffyl=*hB@Mu&j2AUq)LgqintcZsI!#B<>qyb^<ISsJG@us;8Q1QRiuG9N
zFD8t~?16~m^vbfmh+pl}Vd%Rw)Du?PZ>rArv?#=8?P1yes41_}WiW)wJN{FU&<cwV
zws_M9rZBZJ$J&ESs!)tKS8S++*1!+d$!<c{Xeb}mo+f%>?b#l6`Gc1_`zGFAQ9uPH
zK1xgi(Dr{HTqPjg31W`=pW+?pG?bgru#T}%xCfI*w5aPRc)LA=(7+2SR0Aie;mKT&
z%I0m4jX~Iyc(21#s~))DOlBHqXFfo7vVnrXi>N26EROq1i@((~=O(8#x9hjguE&}e
zF6`!3OB@vgiE3WjWGZKSY{oo<XG($&Ri9iGbBC@>ngR*5#n>93Y0sxZ88US!dLL5z
zYDSwU1S@t6?kO#$lYPA`>=p<TE(^nJ<eU&yH*FcgT8j09s4mKm*P>*CZ03ST#o(0k
z!ae7FGm)|aHJjo?;ISBx#%8+XL)$w1sq|U{ZrRCbP+Uc6?(o}osj9{I@|&>mygIcP
zd_c%AnGN54XzrT@ZpFTrs$@aa!|{p&ernjnj2eIO6d#B5raSY2R-%PU7;;mB-(a<p
zH5_(a7TNC0fOtD!Aq<jjS7j&VE#;g<rs&L67qh3-Uh^XChfat}mn5Pf0n}z|^jyU!
zLj#VE0Moy<A^hk?_$E^l3x%a?LSO?MbIr?K@Hg*xwfQ2wqmn3kJP9r1@y|E2$JpGo
zoY?hE&O2;2@HLvL^Fu->_Nsyq?Nr$<BUinjPbf~ln1tijG|l9%_>W8T#Pll23j8qf
z64xx>(`An^%Dqs#iEcLM&Fqcn_qh;wN6LLy5jt0lpm^|A1+UYCg1ZG3JGGfY;FTW>
z$;4rPBo^2hRekm>fbDZ;|J?YI;hwS+!I@u;Rm*=McVI_pt4&Ri<hpXd-{~4JaNr4A
z5{U&eP`)uWzoCzXOga?MUh3WvfBo9;BN}+D(qNgqPDxXN&sdL&C9nW?$ho#_3S-1;
zm<#>g1=nAK8a(}H8iYShh<Ib&d}pW$Krad|FpXR&1_n`CkP+$(Q1Cw?NNDLnbaj3V
za*ZoW^3{@GG<896>;gTxQF$&d$<L;_MgMl*x0<h_ThwIbRxyWE-+hTY<69NE@I>1{
z!gQ#+otze;g5VXun}14>iB|<M+&=`^cYN7qZA77|JF$dc(ZNsVJ@Ei}OfDHN7#f17
zj)C@-@e!M4wPJ5?<*qFhJm@lRWvIIv5PKjg^f?ZZ|F2e{Jui5)*O5)s_wVEVrpOVd
zc>68vcqXmI8dyNLB0Ie78<$wx?cyzP^uO)$Z)H#l9oKEgHWcWlzF}13DoawCoa_Yr
zE#W0SK$HmKV%IqOs=OO3>j={PKfi-qS5<=6AvVB15BP{Y1Id0$A^34yfcQUefSSDR
zBvp=FJZ$i<JHT+@FVTAPL-Bv<6yUY83YkE~``;`7<SYo`d<xbUbKJlytAENDBaH;b
zSd<Xv7&uU3MI+)p43&HZKz``GiK!Rezww8IuYMd~pWpeOQ{+q6`X|m1AWwi({#JYj
zB7mV1_b||EmW(qS!mBP+KDY)v{>dJjd$|v3hk1v%!vvhjOR7CYIzLGHg0qDcj&O|y
zD(&i5);;L27BnXqXc<zaXMBxe2i%LNx;_8*Y8*t^8zgZA60-p|#eg{E92puM<V)1)
z2fgT0_5GNt{-<l@-}c*`kCMoBK5<sA42>}s&j09x4ceep@d3uAi1*Q=`~n!gGJ&uA
z?RwuKCa{zEmm<|;AMAM56HM1HGSZKDIFO_OU(^AxMW>y)YsSe{1?CTZRa&9#R5_n_
z3a!0+()h96XICNv(}g-2z;%S_BJrsIrJ5XTJm5Y>0vrSYA+yVJDQE{oG3brEmFbY2
zE)(wfGe8OhBpoJZF>2tM9fo4)fLc^V2QNwF98g+<%YLtAy10(-01zsmnPF(;BSfQv
z2Qf#!z-tGGFm=YPmJLrD;Np+lH(HIZywAI+T$lI{1mv5Pk$<2@ri#S_jb`7=N}V!6
zwbSgDUEX8h@%yP0q4+4hckKJNLc>?0-Sy#)X1FQTZi!aqGZNFd|DEt}TZpg*8#4`^
z@(epWs=YDV&i{+rNUIRs_DhnNSO!}W{2sW1fu)@p9lV7k@GM;DDuDR*au>p&KY;Dw
zPlr$Tv1no{VQjKsNy=Jl35rSRE{!vQTx$}CyF2AAPC(cBax8--Pks`E#}Yg?JCiXa
zITRKcCZP8otx+4{?!;SafSevCr_(cz__K(7KP@%|G>R_Of3H#`$MMW#?jL*IF)Rte
z-IqVzo;L)Tc@kTXKWEGZ-Px58`<u=;#uM*hMPfz(RJ}_HLq_vNVGK9J9uLR}`Ykv2
z!u0a<390lY^^}KLE?$XW#3fOJEci#YD<ES}%k&2qTVSM`fQ0&Y*XkFk3*s4@>=H&;
z18-Q#Og#@wrvC#yx{O~}Y5>kGosJ<{rJzGUT!OBb6dkbD`3ZQ}o3$UEC=Uv4c2;6Y
zI-j21r#k>f;sbPl<7~eG;oh9fnEPmn@9lU$Y+^ic=!O%lA_vFVmH-f*Y7z@@C^v5Y
zP4Vr@mpRl5`{RvqD|TU(1!JZ}-M{1G04sxPdSgT~qQtk)&|95?ZDBb=c<}T`2zRdB
zj3!fPAGZ-7ap{N07iLcpwWno=ccF{uT%Dge!F!6rP8+)4N@~L_{W)Us7$IBKkm+oV
zEL9@>$3HVjLCf!bOhX{B(8TMh8$`l=UdGPz>`zi-xEC0YKk|5&-%y<`2$a67p|`bC
z<P;SZlsoe6Z3wum(Y}7UN|t+WwM&)`X>{=o(i!)P>P1&XbnKbZ3Pes=OqW4~g#1@W
z6lsrd+O`6bl0`FJs)IgbDSN}FIxJs@c(E|e+)%m2O2?W#shpJB9qxBt6Y^_F#@bNx
z39T?(&u`wm5lCBP-4Aiyrl?869z-uwwL$aX<z+c!Ve1-k@d0Jx2>Y3tqLAMV3T8b1
z3)s04p+I(E32nOd6yJ_;LJOXS1n57IP(GfKl6Yh8Voj>0ovsBfk03$(*@1dT(rC#L
znU`zlaL~ufI~L(X&3&%r)ep6ds$5b*4CcgY0do1^Fs78}o@sC;?^SiUXFbrq0F4+{
zW~{*5QXWXY*gj4o0;>bzIcfWBU!skr|2Z~sJwpDJ=*lq(RS2#b=red-$9~&id`iU@
zoDE5`ZEtAKrizIZ*^AOBW<$mL;v#(6U!|{Uk9J5?wIt4jGkydiP}+e*5D!}&ssYx?
zx`z}VaIEopz5_>|Vg1K(BJT1G!`t^~&6Eh}S#<8w+#G)F#G-LH+eEq01$N#POnZWJ
z7}qebq2VnAS39!L#fA9Vqk?0j-G?jv%{54fFdM7=VhqfhcBWis=#^%Of7LPKG9IET
z?MAGs*kwVOEimjjJI9i6kBsYd^Et%uWg0&<&QM=6{{9Ui!fl+N%<Sck0~ML*)K`G9
zu|*bUJmQRpX`$$b3k7@wQuY|tSA{gY-15@rZ)TeR16i3f-x6GLp1@u(%z&WBMKY<q
z+iJ~cV)Z3k1jE9QL1TUx0IkS*o*9F)>ojlQH3Hr+hQ16^V(Q4MKA($Q-d@4_400Xp
zKGddkV&tS!W|n)kxZv7;dcjiL`TTvmfct^p%+9{;0(Calcq7^9s~X(xH2g$WP(8@?
zu;>0wRf$6ijHNG-AjI*L+O0=P?|Xu--R&r&AQj>+`=g5|qET}*2H%VN-uTxIcH>x_
zjIk-m5|jPqaqv+dTFod<j1%4W(m6E@ND_*v(0rBb7JJc+;4@g<f6mMPl#jWW%`_1%
zOXYo}TH?4FtL~cJ72z&A`r2<@aLD_pl!qH<8<P9BO&}Cn@IJuNj!~I<%raVTObZDj
zLF;Ng<P<I&88DAa@dBI1y;~CI6xft5+Gg2P5qRE$SOo5%UFOxB>C`i^rR<Kr0cmu%
zm#o@h3~Gtx+B6Shu{0A0=qdQPgq4hGuVm&qk3Va(G<Ap;M>fsrjH~%w@Hf6RQWjAa
zVK<Y)rx2~rEzaz!yCiE@gvk&#x9EjQjf#cf*$0C7isKa}<ucV&0xI0zy1l`|zuP@n
zN{2NNf1G&mz;7<F9D*Id_91xG+P-U_>VKQJfDg49ek~gTIY4h1a#P))bM=tk+Ph_G
zggaNbdR2p$!DM5jiU^u&`pM|Nzyd_`Ejpjh$jw0{kMekH?^K{Y(Xiq;d$zILBozl6
zn_p14r$XGbW-PS355u}Gj<;w?m*bnqzrBX7;csBryl7ZE*QrFVvFqQ&d%qc2Ecof<
z@a=yfU~X9d+K#Uwqz~^7)|?PG)QjM5poS6?g9i*ToRy|USgYT8?Q*JOmzRvmgWL}!
zsc$sOe-XGIOPxp9{N2DVx5sfmok!10RV*-<ZMJaOWO_vE|2T}6&M>_`yr`lJ?-RU<
z_kVq6tWxQg=~PdC-saI?PS2ec8R!_4ouGTVlc$N~h9dGR8EA>7@wbo0=YCfpdv5dq
zyh#D9ztm90??9*kad3h8)ymST>jsUo{m6R{@&+qXZ@T$Hcy(4g+YEZBxos@%$=x8`
z6+t`cd`{S&Cz&5LE51bQP<+|&Ds`JV?o`z#tHM_29%KEefh6nj)2t&z*ejO>D|%lP
z#(<`Ti=qSHhNlLZ@kPw#OeLj;3pTRY2fh_A$0~LSu;b439<!4y>~U>DC<;su78iCi
zzqu^o1KH`}(1=XE^n6p;E$GbGa#7}4bRZLCN86i>n}d*2kO{JQTe^{~`gteoqAGKy
zm<1{O)=ym~oSt@}n1MNGl!lNEw4&js*>*E^PKHG%TCuR1-icQN;sU%*T8hQai@6Tu
zz01s#X?E)fX;jJPaAs0~A)4YQM7s(VBYbhW0FA-WPOeWeL#CwLr>DU{Pt$DNj1?-f
z<xdH0ZQN-~nQNvIbwl8=GQA=j)7=I2<f|~(pHD(OPd<{ONxv~Vwr2c4p58jFssH^S
zA03hk(xISq=cs|wH9|r_N$Kto2BIiPr*w`E5owfWG%`{eHo(!{?EO8j&+oc^|FLW5
zTxZY2iTiOs;wEO1-z{S6g^5+>Y?SK?>@3J@$G29c)9S>Tf8Pmf%%zOZ@skv)$BRk8
ztKnmH5|vg+o3;^J*WpOIt55{gYY2I69MF;)+b0_rE8=Wq)40+=kVJHK!m>yiOWy>z
zg&}>H;Wo1Dwx_|<>(AMF4S2xr7p4!m=ukaBXcAP$`2bvEbVszKuFgP&?~a##W2nRo
zq*}a`q*SCh@a+6Ai|mD6(uXDV4C|Nm9J@zx!1TCr=rDqQ$C)}}_fpLeDAdI7?z-N?
z18no0KkCxs;&h?&f9aaM>Fn_?<2o-_a+@FAfj+=Owr6v6Y1W!`KmL~rxIO#9Rhu;B
zP8#3v>vL7f_@Coi-j;_zad~wPe;fJvA0RcvhB}dUk+KrMja;PVI+#gV#`71$MCjLU
zPK@^A`}gCjv8_Tx0JsC7lko5NgTLl*G<E_j7~j2(5bL^K1%lg+EG63RP@9<MJII84
z>R#?@;JM`*!sGO=P2Z~CN|PZ2WXpL3Y<Rwr3SR8OvK^k6li=g!crNV&rRa7Y%`Zq>
zAPWFJF8cB3e~@rh0rT1c79#kfF!MXn*niU2{B6D32R`4aw&(7!umoq?0pS;(WrZBq
zfA}azVo&Zt04kVZaaPo@Qt<dS<qn%D!^{>6f;dRUnjw-v#mo{^#^->?LW1SL04T6u
z81f=T4efJT=+W&TQz{eogD$imu(--BErRWU<vpcC04pUeinq@<;A}CsFsyCg!2qU#
z_7j=B-pPM8f3CC;Uh3^H2s6Nr0Q3Jk3~{_kmafsjUirIFvQ^<{*ncS2HQ>`k%@b2S
z(Iwk*G{857V!F231S#e4rT`5n3kGlV7SLAc{x`O-ZZ^D&yNiJo3eby`m@5DR%WZ~(
zs6Z@C!1*i-)@Q{*pR@G?X>MgSQ_llI0Al=aJK&p);P{adR>TcVS6+Gy*Ty=PEDFsQ
zwz_?EQRe3EO(84;usWgT8cJ_zH4ufs56?K+$ooM)4|0hA%(i`(m!qcz`YcZmz*iO#
zEVPVag65n+W4k$6*^~GmFswa3fBR_1o0#T2Nv(_pjJO75VTA4+-R!hy6K|J0b@Nth
zG|M<VI9NKF{|_zM0AUc!6!QqS&z3;CKv@OI78J(z8K6tfE=yj%oUWG(zQMBHdrYn5
zQQ~`Ru)Xa>-Jlv@w%|>AhS)Ct-xv95@6Z&v*Sm9d*YcFONdgb8@<6sJb1Y6r4*MdW
z>Hu;E&gopvD+|0ys6r=d?il-_tO<glPA0OnxV+rGI^PMxO?qg?60!JwPN>3sS!10k
zXkQQ><;ZS=Lm@>*LGJfXiT0&#oZX}wZL1;f2MDRg{0XCUcGX66uy}O&a(2+9+-c_l
z8U@L9F&%6Yb6$Y=Z}z1pYTCpxGz<;|-W)5lQaS$oWiYe+x(w0+z76*-Ud(C*%KEF6
zo?^{({cU0X6AEuMI%Rjv5&h-+)t$z}OoGk!g&*D9<@V&Q5DM%J?p0zd@vO335`(qA
zXzrR%Wc+7Zd<9x3+cd%TAK~<jRBpwa(TGtE)@AO-qx~h)YC2twr?EwHdTXs547PJ8
z<rxA|wOa7NZ#yRb#}7!5;F*|VT}8fWn5Jv<!k1%b^J-q}6AhzNk))(_xv(^t($s<Y
zFR+^+D-Y?T`eJ+_(_rjnrK8WPv&iyG->3I~V-!s|3&E&AvjGVr#{Rq`8{be__NFMw
zqp?jf21S4Q;W|$-?d-nhAwM5{8Hc>tThl!o@0uxQzY54Yonu+1Ro1hnET~AcN}DoQ
zx$zm+$Q_~4{&VI)=<OC)ydS6__5%nr?sOYbVbr1GpKjtKU!r-@K#YEaj%D4*52=Ha
z&x{%$^@WYO3NjC>FNx%ky$blvn6=|F$y#LH+-|j(XUZwe`aA7&h2tf(dUQ_ep|!1w
z20=lp0+E$ZjF-MmfXp)M&8}X<t;*Q<2y=2)CfU^3t)E}$v1z$Q_szG@DVt%40g5oa
zG6od8@5WEDvub#&x-c<DBfRxc6D-e-_@&-Oc2>-S38MMDt4PvSno1G&jwmPgqHGcw
z&Ms-ZpX|25nUkys(1+}XaUE*Uid4C3U-=lMmjE{J#KEvJLc%ACG#@|~-ZBPEjwF!Q
z*!10#cxM9`wYt|8()NjPUkUX?yMP7hN_WVH7YX9-I}C6s0F_AL6JVrn2hl78B<odd
zD}rWfBKWO{x*9|E-y(Lu4@|FZ@{W|>B}#+AcpM1``a9>)C$^(evX`y0bg~gF6OiaJ
zo@leb=n%Wit}f#PF|3ZPhFIK?M5?E-%19;3i-RknLSl~X<90~wOh?B;raN}L8*ALX
z%}Ey4n9ZS_^jM~<K^64GC*_at9YoA5Yq-7lA^e90Sv~Kh2i~Ui;Z>M~4wXDITKv_U
zy@20ht98(Utj13jI(8p<R;#5A^E8u^nw#&>^K1Ex_j+zb`7ceshQH$tVT1Nmt}e>F
z?P&`3rKDEme9kgI!p(ubo?x9$+3``cH_)N_c05dd5}9*`K<UoS6K1<G(-%#z2(NO#
z4Q96TIfGnI)-W9G*9c${^7C<{A+O583~RP41+D7IvwUCQ@PbRFnO>}w<6&|<3G_N|
zjrP{JCcldA>viSa9{@QPU4ICMq950HEY!z?!`6vN!}MdrUf=1cIBx{Wwd+`CjzjC1
zgKuDFnQnF|nrc~-?+52Z78BM{^cV!Qv0pNjWtsp$=K>=HPPmC6_WyxCAh#Yo(tM!%
z`aI77`b|WdXbRI^MJE&2*r#7<$uDauD6gg+2EJD@o)MofPNbQN8#sC$4<))wF<5d+
zG<%KU{VSd<CWtnXW9=M;@tWWgHGNz7IaW~-t-9P>K##|4wD_Rqi9y}_hR0lv6U%tb
zJG}5L{&xOVopdIDF02`=$P@;d9b)a_78XYyTRR!I_SuyMFx!NJi!LWW#heV9omgd6
z#MaAE1r4&pM6Qi<N9$KG%4)ti364RkfgFSlVH$$^i>mCBcp^6H&+9Z?vs{H-+{)zs
z$Yi*-a>x^JmwC*lgpfa#mxNwrab=c^9~6dLFjGgUK;cSsS$2#bDN(%43SM33ML$vk
zcsSsTnjoN=G}SY?IeWpb9r8y-cI0`gT8s^S@MLV3m-a=m0}W_NKSGz(Niy#zC>5Zy
z%ks@Yh}no39(ubFBp_(g<^X0M_;1sEQiLyfsVj|v#5}~UsCBz(aw|a87)AQ6+!zmO
z8c+*;^_XecW)+k+vvPaL11?T>`q$>s+Z9#lYO~i(%x0Z{4!pNJcXip-k9Jmwu^L?^
zb&wr#PWyF(I9Gy;JdtS&bg|J;arbg@XlrJ}p|@u(G9Runpd^p^Lg)>peeS*Fd%3TE
zN%6U>21xIB!Bx8pVFgGQeyranmVn{dHLqy;f1rOxm@9BqC}rwE=SB2QBJg%bq+WB}
zo5KJYA-1^<@(#LlSrH<-VZJ+y>r4wYYEe)hI>-77#E%wsy51AK{S_#_K_usUPE$#Y
zTFB8=1($?A8y{J3zJocl9n=I%*U4PD7Vo!3BaX^3Z@(IGphPSIZ~(TXb&@Q3JwY0p
zx1m*z5>q*8qVO@KIVMc@!H=#~gnWReTZFJiCD6THTwM5@`A%;r;8EIyG*L>7^_&EY
zB1(N~sRAQEIG>+k2sLNktP*;RnG?Iu+RPi+?U2&?j>SK6@$nC$9g+H2GV@HMad*3&
z*Zcc`q-y8%oR*slZ8ZtL$j4~H8T~(`I)dREITt01S*b#evNYAQN%-;=>z?2W$;tl5
zRO7(I>X-DCdV#ITc^O42o-SBC+(Gxu${<AtTtJwl5o2LM73ySat;V9mO+(!eqH$PA
zj!aR+;gT~jD2HE`;Nqw`%iMD>D-yzZHF>ykLi?XPDog_^05(k?c}(#6M&bbT6qLp3
zs)R#=oXkVKxJGaZ$&CC?GMk=3V?aN-@<B&Po`;f6(-@}}Z5Z#>&#;vM2XTq#Uc<L%
z<3pXuG_|L`l*l{cv`49P8i+7-KW)v`>Xnk3%Xq|}`23QrI4_W63zd?R-%~a%&eZ-(
z)4Z`wg`6#ws^Yfg{AR`*$POPHtyMMk>)MKXr=L8M;9~(F|H|+FE_r8?bI@K8GV|_)
z6dizBEGTzB;}U5b3UF(CO0C9)mrO!0cREFLP3N_=d)LRsG^dbRdT5|dK{DV;?&F~I
zdEDV=`XAks>Z(r*#3vVt>a1v_lbNfe$%bu!`>~vCnBmBo#o6HY3cNo6|1Z*xdfHHf
z0Yy8gRS;S#PG$MxF%wK+XaW+#qNWSe{8j8^KcT<k@M*Y*>Pz>~0m(*cK}|?%w$vig
zY|VTf{)`$+B`_^Z_jBJ+MSVye$Y9N_u)YDA86GmH|E1+7%(vyN^kPVyG8>3)%xmQ|
ze%?4LV6Iv(QOoYie5@-QofpKL?)H*JnE{i(VTRCC=X^9EYhqH+%YyjwJjTu>uINcx
zloHy+=)cZpa-fV~r$V$@>q$Fn9uWg0O{>{XkgkSx?mRG(n%e?r+V{X^I=knFFW&cG
z!=5@;H51q?>WgmJfYL=$=Rn0PHHQnhU<J@(78|AK;bID=h?Ee$koFGnr>|3m5&Rp4
zO%ID<cuHYC<Rwy1YF};t%-`T`{qsN2&vJ$BeDXz~#?M3*{X!NW<fR1wII#XUT#lra
z;;~k|G`a$t8rhW&%59dy+o1u}&)`Iu<DbJTW(GD0PN2tsVCYa&VcTfk=Mn%Rm$ipj
zDszRol!Pt=;8-rPp+7uy^$fR^?h9YG_ITyE>lVlT2YRNa)7EHrbj5&U>7FmadPrQ&
zpWayc<hSv_*72Jd{s+>@{zpR!P7H-nF0Ci%0--(aKsmpw3vx$+m+#jB$WlhTM2Txg
zyLDg-u(mYoYcA|!7r;q*226{z7-UuW4C`9|@=W#Rw$lL^DBkbGQd^%)kjVf!*{6AF
zO9{A6Exk}r*kQiK4WRPwp)5V%9P`Q9KBPP<&U|!!!vYLRh#DbcprAl4mH|;;XS*wr
ziDid%EORWo?X1L8G?80N+xN#<n!~FXzFmJGzM+V`2f!*RI0>>q^B#-(XdOAOxJ1Mg
zYXyT&!Fj(M2%AWArC}BUozM+13s;V=^vPiIHWo|S+bD~rS{9>U^;SgTLa~j^gOH!x
z*EtlM?Dt4dqUAft&1#vh6X2F55Viad%jE_32SoNTnqv7P{|9n|O}O)@ee^9H0^XZJ
z5E+X>sBrO?r&83!Iz&hh@gJmmJKf5RVz^cVludvPdz|mLB?*QjLGXqA(y1=c2Y_lE
z;sxjDOpXfelfHGpCmCe-0%$_IYk*xk`zC#$V0jple|qCL77RKnjfZUh?L0)m;-mvj
zREGWsQsK1421{Kbx9BcD2~ONx=MZYFxo?K==JzI8&K1CyOwk$Rz)NESpo(@E3u~{g
zOjLpOvjzbch&rq|8<}G-JP~NPC1Ay`6Xkj`9PZzb6X&N|+krv8K!Z}@_tk__3`{=E
zYY@Q_a()l9bUx?=n)MUrG~jc4pdSqI5N*-}{D!+JSn<{*AvUcB>~9A`CNdoP1pH7a
za3cWY$LjTb5-DVW8DoIf%%u%jZ-_eLE>IapIgleRz~l9mz9C-|{PB4DRxH|pNS7Ej
zMUOR|SkDtni8lHUMzO#$fE`Kq38UeHBGyD~d!&&1vyND&i+Q%QL4#IG28vNsGf4IZ
z2E{f5F=GCK@*#czGCaQys_ngH(ww-9tbrXOk-1D-1CRzc$l)*`|EJ^H1#(dprN9$m
zYk(v8%BCbnk<%h6-zy#q&{1V!MQxpXabiumP5^mfa>t{ZQN}YkwXd}Q1^8eArKRZa
zQvE}uI}`o5q>1ruR`#pUUmkBKf*2&4MB=|y6X#vXL!gpw3`&n#EF$vM0C@c|Xs_vJ
zv(2;y8D+;sR(wc7g1IuXyi%uH7JspzOVs28FtZ8_epK}B=GAde4+uU#XwILbWg4ku
zGR@I&eNGnezSoIKt@E<M$WDWIck%~%VQfM-cR(%df1vTK8??=|E_-NuOxoceR)~zR
zN7$3ZA#qmgg~_{K`U#HfQ$6vv3PA%GgYY%U^<6BjsAjLqzzpsZvGIcHkRB5|SrQNl
zw;idSZ7edz53|ecXo!vfd@N@qrci{8wJ=X3D)(cGIy~xs_`7&>B)gnOCbvX-P#V>#
zIgv)|z4^OR@Hw&Dim=bA2(wkhpMastlU+LMHyr{lsm2`M+gtP~w%KoE<@d?TF6H>}
z0g5Bx0-vj`oMyV+t)L9!u01~b70S_I`>*VrDaL6}U#n!Jf{b;waAJ=YXY7S_*ncF7
z5-gPEpiy$ce#N7|ZpBMhUv?yIiY&%jIh>EFn(I+WS$0(=<>kb(=Epr&d{ASt7niM-
z(_qDn*Nw2Sg{%5ycTxBbjXX+}lwt`!-oKe{uj7oup(vz=aeK%;9P5UZI<aSM_Eq}P
zXD+%ZE3#GtQQ&NaMT10IRbw=gdv5e{<F9ze)#hS?ccfO{UQFfW;DtlI)yiBQjw^qt
z1jso*GWt>_EX|1<W~HW-mt*j^JJiD$IR>M)aO1YHTUQ)ByN)Ote4xL&(wwz#v-4PB
zmtn{B(Lkt|PKr@mybs%jZ_Nk7H42$f-e2X@_9~8t>sIs+#Ztm`)u3=FT|U1^NpKc}
z9yOn50J8%}d@lD7oGE814ZcbY@;gDeYYsEehS|E=-NUf|@a_|_o8XH@H3!!`Tq&7k
zI5*9dBJWmYieie-D?Sq+2|Rds@|w-?OEGvD9mWPY{=(m9r5C`7zk6nOlRj|RB$Ag#
zqfSd%%=H%3r#J^OiA&fts;1w~QBJT%+r{uvH4gb9R3SD^>_L*<tDXAm!b>qU6%B<d
z_YYjHIMwrKis^#GdSX;0-SR4me)3T88=!#GU9!!S#rpQgpQ8*Uq`PczQ})0WLa$S_
zsfI!rhhr7|ICJ7vVax_U=yyYIFY|5ZsWQRtIsUr_8m*1rAnj<4>jTY+sL8%l`g2a5
zJ%qC)cnNWa4x=rI849&$g^F}U<5;hzZWU=*zDV-*EfGJBHDpQ}vl`P+@snsxnrwWP
z;NvP1nOyP#yj><ySKQd%Krb|l>1ZT-b@OOqH=(DV%lB3}MqDz7hzMqzS9V6*P&9~S
zP@FOw^DpDPNBxBHqmF7jfB5_wI_F&alhAaZdVtCCK*Mf283)z8U%@>1&=iXF?(#ln
zGSeyC;r*n;CO!nb8cRg<XA_z=@7}oui1E*A=NW_-)GsL75TR+pe7Oo}dV_=qOkTgI
zwV@{BAVzRH$Tt9pq-ri%O<;F~u%4McqLpS_Hc<Y4r`CFCJb`_*Nb))XjQ{8iLF=}^
zpP{XlRGN(59>%{b16NWLbUa*oF{M_W+auv1y=ekyKIB3V@BB+5(q+Fq&wm}IoWS|S
z9m-}oQ0;g~lW6hdHNE1s`jG6A$n|V!V!Rgo(^*eagO#LtyzDkcn;?~He04E#fYWAM
zAnvabUMHLHOjYK4Olp5sKXag-p7aheSI!MgrY495-gr77-pa`)Xh(*C)ZMBUuevqo
zvc9*4@UcRP=H}Sa*!cw-mprpGCBDs=f{<qhs-Z_R*wow1mz-LU>&dJ+xX~@ozQt4c
zC<o{d5r3C)`Rd&*9Cok*(RJc#Zfs~(PSA1SE~xt8De4cjEyS)~#a8~%+|A#gH!=a`
zpg8?F^3ueQSIl1|2-f1ZlE$lzTtY1oS=Ah$%rDzyo1}1u$5J9AR{t2M(6%A%g7|aP
zNZgXr!O|$mcohCa&9EV6*rHxZr7lJaFE8v@g}}1g!Mo%)W<(~&_#Vuxh&t<6??+@E
zG(LSi4)1<(@I*;q?v$a5@l$TiPvD*V@FMMvu94|J5l1qF4OylW-cT}Nu->$z;aU7F
zNjHeA&Wxu`JE?KOtv(r7X=xPtmJ-@GsV^|BW<f`oe~0;0A!VZU?Ji4fsMG_#nq|Yv
zQ(}em7~{6$261q}#Zz>bmDrJh)!rbW;8wq#Ba4vZJF`Ppg4bCYv#mHXa3hhDh)-SD
zN1eh;$rXuHf&~2P;wzuC2nBV6{{-u2(Vr@Uo;OGs-bU4kdc6*=zwZs@HjmDcFO%u-
zVmm$fA86FrB>GZfBbtzy=%mJ6=$dQ^HrEbJws>_1eL$z7iS{M|gnn0_E7CN0W45KK
zVy*nnE2QNdSSntvt7;&e193jfh0$>Q1MaUteB1s2w(~96naJDh!>m&_+|Bo|1t$^n
z<DtK;-)2!ZnyU@lTHY$(t9u0110_wZ+g(+!n~CrfuGOqdt#N*?^AkY99c|8A^W)Kk
znG8#&a?R@-@{?O^QEqrafa~;My@KrzP7IzQj|@VIz_WMKh=oRuy~fTBzA2Vz<B1xT
zvKN@v@2yF#dm*ITzgZzS{w31P0=_1W2`E`>e#e~)-2!Q%#I@P<>1#5>`?LGkF9u-5
z^Uc{8Kl8#)wHfBIY31)<7sM0Xgb}Z<o7s%d+dlr2P-2rKAb`*c{0v#5`DsrlruOv=
zr0Ow;z4AD!83|f%YmN^zmGkDdvtD9^2NAT*kH7!c5|^;Vnnv_lN+{~*dc5+3yNY>1
z*I0vN{V4f<K~$EK7b3<<dLyy5Gy@XHM}TmknN=uFtOu@yhW^J75|}UHgXIB?7Acy&
zt<P1&vz)k)nH*Gc37R0=x8~)X69BgsK^nW`&o_Gj3PsZ*9J3^|LmYg3f+P84KlC4g
z#+=BRde(d{42Y@$=}WMNq~CPei=3QyTz=@z(Pf#Ye8i1k=lwlRvGLS#eiKmrt#+H*
zY96()e`=Vx2efFrllPhHIiZWXFbqIjzs=|4xX*9D&A85XFq!&nzUy&&!$VPDijz`q
z29Q>7)UIZwk#`dJBhdev|8qcHZg=H_4Kf4tBRa5~vuXr(Vj0V}1(Z&17}yzgBT!t9
zV8vMiH1W6${*#T2U?sBeQ`RRDDS%T`95_0XoU6Csf1q;U%in;;>+JQXqvg#jM#$oV
z#+tKn8Fr!WYVy9d#35I64st%@9FFXefo#U*-(Nrm67~)$;@?+^BwQe_Chh5ZudxLG
z1MQD-VLupmUY;4i+%b4q8_CtnBcn%USAnn*SrGtHu%R@?4=M4mwIkSDHk8UYOUmsl
zI#{!K4(e8O4vUS^uf=dW0Dtao3ti1{lwEnA$N%4!I@s}})l2@?|A9&)?;IN*tOGy*
z_j*n||Axd2IH#LHH4NP!<CDfB|Gza$C}P5x5I61YkX>MTjL^M&a%Sw#C}3!WVt+k;
zu-@L;g=8E^SG)Tt(0RB63?G!ewbUWPLiT}Av--#m3BdHV_dn3#A@Dy*x#jD%T>9_y
zb>0W(>911$cZ!{x>PsWW3tb`mfR&Qb<6<`Be;_3$%iEhy)N9MXc??9Uz<Z?=@Qx~U
zuP1dsW)B&K3}kRy0{aqX&Yt~Vh^vL|Rw7|;PJw{*2Cxa=n~g~-(4q6c1FKobisxG&
zAw2&3dlD$^)!st_t{98Wkb}UspMY&Gk4tksG`F$OB|BhK`dEp~3n4OA$RF6@5%62|
z->oNTvEAPM|HsQQtIhS|RiWK`sJ={Vho9BnRjV1I^#DfYL|KNQ*I<ZtTx8#98=D6T
zeI3%D)~qJvSvw5-IxFoxk4|l+3z9>S+gaK4ONQz?Dn5`TH_r9|SA#{sl5ebbu~c2T
zYH#r_^8H-}p1i`hvf+7)Md|9<S%D9Iuhdr@pDDi8rQmIuBOEMoRF5%U_$X<9QaxYR
z{N=vDtTVlwQ+w$0<)bb(GiR3GZ||#IDlF^++U-)y7aJTE1Kfb@*f04b;)#ox@%P&u
zc?RZ}pCbBV%b3G#;mYp(wJ~nZiS*O5JnwOuiSlG(V;V0)=woeG77sdH!zBqdbJ&pC
ze@uA0JsdBvc2XwPUDd_UhzxM?^0jfY?9y+PIiByld!@G{tU=0b=dgr)DJOX`u)J?M
zoJ;fLa2)R;5qn5L5#+}*zdL_IX82me{`D&gQO5ut(IwpRSt&2MhLW!ro{!~@ssJ<A
zN`7f*+95h5h|{g2`I#b7*@kmQrppCPaA84@W=KTu)@vMz!%-$*Is5I&SN$x`=wkOU
zgRaQ<U!64$&x&oKhORe8UpY>x<ei&BTjAdu^Y>52w%^D7#OKSw$pQQ%-0!t{U0tXV
zX6`yKD^xmlbKkG>@q}LwtPa=LaK$eySlv_(oqW{QSkMjH&Kqb$ipYRSc9HRlXRI@^
z84TZrn`#)c*`w)x0QYx;-j;Eueq-R0*!nB410vRGQ;JCN9v`K-^rwikGRvBYi-^E;
z=_h)^_3gf#UP<R$^?pe(8kOhMZkGhxa%?ryg<=mh+io9M1o<@wq`4k8&(W5Z!d#u3
zZ1ujH8GS>4^~_Y-bHP*2U7z;jd4tLyY4mBX$8^_(SduSTE+9fnEQj1U$kL1l4VQvv
z<A-)0*jlR1ZZgXE&(=LvJ=XrGM32V;I<H}&)5ju_8*PaN4&#dZV?Hu+6BU@On!IA>
z0K(DaA8yRaO!;*z&M=BaC)nS|S^{mE2fa@?Ad+BkVZSq->@z<OFk7xP^?ZW!x^K&@
zC4ps>10jjsyC+|G6=?;=&i@>3MZ3^UFukQ!OJ(~;77yJ13Q9gq4ZC#dZTpR}O-a{u
z6vkj<?L2u^K2NMf|BBP<-`|{*%06TK0#BIiL;Ioi6+#mJ?Z@O}CCFujhpTXva~c0i
zNldNz9$#)avq3)G>&3whO1V=&e#y;VBg)tyO679GEdJk)ahpW?4?mvR+Mzbc+Cqp;
zyk6_<(vF_ls@XzYiogi1g@4z$^M$ThzZc^`ZhL>Q-B%xJmz><LQ#K+vv~p*{&F>xj
z+0uY0Nmk$hhJu71)k)*MB<OeT8mxa_tJ)KiovZ04Bm4D#pn45fbe1yjzuqSG>Rp0q
zj}9@fa;=J`>h!%H3F85;-Q8K>&`3)clgEskX<z?VL}4yCSAb%8Kz`RQK6E!~#=fO9
zviIRN+#$1m3ulnaaSZBjf3(%=hF+SG6C3D9WsZ0g`an|!{n>L)b-C!ryn;i2E;L0-
z*2(YpEI-`K=6qu4Bu#(E8@D;LydR$s!ZLkqVWIuRyY@w%SB@`yq}<|+y|++qCS*u3
zd1fq2^%Qvg3@$3&xnxKEJxh4JVBYWN#VJKC;+Ov7FUPN!WiN%k2sJW&{o4MeBU4+i
z#DJD0{_0RGH9+zXQms{uIrQP@d%$1Ap!XM(a9k66#z4EhpmKL(8F5(lF;aA?EsCQR
zAwHXa!SukTUAhr382(n{na6U=VNQ-sc6?FmzmVVVMH&9VHZ4wj=<NRE1%a7SPbg0M
ztB3i0l$xFExwBcb^<~#cIpH7ly-ohxU~FouFU!cncuf#|<!@y#e)`<QYL%}nT`3r3
zQ?El|t@%KE)*_U6(R7)c{C;ZJNJ7?jeOXJlwIR#?^jmfLfjR6KsgzQv?qseS!&ZZz
z+lzxC0qls~oXRHYdf>wE#tF=<1`y^F9Jkyz;2&@@JZLhE&?X&84?6t$hEFf(-K~17
z>6_j}7NrB3fYRb}NnhaAMmHIlCm<LSh%Y*T<S2fq$S@FkRnuq{61ks+mU}6cw6O?X
z((q~<n;J=|7+;@jR4G*=X#OnNSZ<$mkY-M7kwiT%5@XS3A?V*e01VzLb&)wW(Q-2$
z?xJ;ar$1oWq#@gC-JY`f+M`uff&^srK`v7H9q5!rjNX{FTTqQ-ikzLq0$o0tH-hM-
zwCKaOe$_5X=>xBmj)vj-%14WGSySVxf&HEf7x|^?H?B>UeG+qt=yp~*_IPM{73-7s
zHwptR5FJs1kOba0)d3VA!=bfK-g|Vi1njXNATs`n7U)nP3vY7`m&(_TwYl;oqHKci
zlJy(A?|>k)`=?BGRL-*=oSk-GolHM|W&jtb5sZ(S`t57w<fV;W$xr+h639~ZYi_mE
zL2!axN|?P2W^$vLw+UMtSX!riFIroL^ZCMC!Dwb|<Y{e2`HhJLXMIh4_V2%?p&z;N
z<G*cuiR8!=P}q3QX^x>Sag8hY%1Q7jxN{aG|G4m8UFc{s^7LtLNrOZFa2@(SIjFNC
zJdr>T%!y9e?7rire{N9T`Ip_DuM^#cxrfxe8G2~0BX1wI;1d1ugY;zJ?x~&sL16js
zu~JUteDoInAd@ux63Lp^q2bcfX!AqyCSL#62T$G>NR8Z8xF2xF>==L6TI$NtBr=R|
z6rFc0xd}^h;pn<F;QxkL9<p%5Af`@BncmR%`M?w;tu{5*LTu_LJRj4Sq(I}~>Bfd>
z`@2_2JYiDRB(^aISC9+}?%=O)z89?VkU`KMJhA#hGQE2Os`+_u0o=DQR~~S%K-ZQW
zLh0ObV&T)Ssd^p0n<p}Nj@X8B!uzZ+UO!z6>ZxNZ5D+uLJ_nR~7O_D3Yk#$##GK?8
zw;?fFUqb~+%w)f2_Nppv`uuSK${OdNWg11lGlqV|ZM-u07E9I)-aev{%OGTmel|7v
zMseOBUC$XCW_tIpg=U{H#X$!D^ebXYgn1hj>;Ql1ykKFXIXNT@LM7!cnw$;n8U3Vt
zYwe5F13ajKIU%+;fV6XCi68!SsxVD5HitrE2cmR6>6QAFQ6`C7E5D<~<`;!G_>R|Q
z&^NzHW;lbO@0(5Q0Q6AgX8X8`3gMgBb{|E%P-&}IJeR+#pXv9S!S0q!IZ>YYU+2bZ
z8ZHBV`eT`-rVrqm2vFN;%L(y~mj(&4x)%O<B<T&)5Rtz(X{_JHM$WUDM1b%s2oi>l
z5;cMEc4lv966Knb=r1MrC=@5y;7?L%FciY|Z-Q|mCsx>Q!KK2J5hLB+6eL8`zULP;
z4k7t+UuxDx9)s-2Pz+eVSHDY{MVb;yC7EqI|C@pmf$xKfRY|4N?(ydE?yIE<xOYlY
zDWTs|P>!_M@(vnW1g^T(+=?RH*`XG(ck#kR^pFW4ljJ7H%kCxh(mWb3*=O#!A7rAH
zE2G|Lzk;$({P|7;JX`?`;_Q$vv4&fyBlZHcPncQ%a<P`ya_kaI28rb9k{~WSd#??|
zv+9@d^*#`x3}Jwu@;ca6COX<pkkQDyy#c{qzZ1kJQZ-KFELkKH&Yprt-!<%C4o`XI
zSR`D{bP;yS1yOKXhu?-~rs8lVJ>T;kH)u#w?@&1W^#qbDE63<`zEN*qKA32~;~`{e
z?%h}M#rxI1!kzELy7`UfkFJu{`wDewcaaYoMDoE_e)|?@zo85E9BRoLQe;EpOo^2L
zbljatNEa!e_V0(ijcqvyoG=8SQf<4!E1z?=DvowVgLAhJc}i~W1FAqypI;isiV7p!
z{uj$qR13vC)(>Xvr`B}pmgQ|p`sz`08v53O=&15>(ac`l<dmJp6Xl-7phHBMsG|uE
zZaR<fbaA5kZsMrV2>YJAs!TwQo8-E66rWR_b<2BDd`<GQ3oe5jX*82+{wV07>fUj(
z$W_F3%%3Cy*Qbqnt2)^}Wc#XM3!liVtWvzP82k1N`(|d%YM4I->FJ--e~RU=?akB3
ztNWPCM;vM)N-HHPdsBZKQBDV=Q*L%Pe>psd5NnicJSi%+w7I{!kemMR^MyFm6o4Tk
zxZ*&<C*&@ycZ(O_DH6BvyX>rUXr*ju{mw-JPPo>Yv^4rQ?XFU?U8NyQXfG&hMNx{K
z3(NpTf4!d4o=yMjk9=qO#7sM#9n=EJ$2);rwbq3MdH6VRdak}?`tT~<)pvJd0}TJ*
zQ?`f~;<FW$@Fk|g{cl&-#q)Z+`Gc;>16_(SgghY;(G<w|(_Z3B+N@_C4d&>!R4(tF
zPi!{~C38wiIxOdd>5k{pWKSXs$-|48?XXX?hI~h3{Tvm^5r?8sF7_}c*igCg7X7|m
z)SOn@<2UUQ_+*stLkw2C%NA==$J{s=M&2joAKHQea^oKeS2e|DC+VFj^JDf$v3~vF
zjdnW+H-ksGv<3sZaS@5o>3n4Iqu0$sa0_l%@4omBwr#^P8W~rpUAo}}{zpx9S0G!U
z>kfk>nCam!Xz;QE-ltA%XV|?F6P9)X6NwFW>GJk^vVFe8U2T6Zz(NHsbJ#480>Ozm
zvM{17?McujUXj`ORM7qWR!V@v+0<0c6B^=FR_^7jxUiq7!2;U|+{DwB%yB250Y{wW
zUzj*#ypzJuaHFTGu~VRHr{3=c)-j~<XZyb}#0B{5R;*5ea+A#*G&bRnXfvvCHl>h_
zp1LaUb~<;=vZ#Ci!UmmTH<z$2KEA$y2hR&Pi_w*_Ye(eHX3Q@CUG7BKw9#GB$jT*V
z^7bm=^ibzD89f;K-KWeu5Z56hZ-PwYJWQI+v}HC4aG^=zB$;m5J}DKqk^TI2l)Ui^
z8IgzCL-}7qBhx$Y$*zwrDv2Tg8~_~cYEl}XiEZ4(;>2b2KWqX3a$(Z{KnXGDRDpNA
ze^2QrP$Sb(w~)V6z%P&lY@|nQXTGc-esvmnX1y8l?b87oP)~#|94F+tLs&9j+@GHD
zyW>>!Ujbnwbh??{hc88p$286!%L;v#TXi-a@N7f|My+fxxSogj3SMXj3>2rwMKQ5%
zv`$1_yVR(!*`n)|>E*19_9hbh0Nfi^U1J;M0dviGjI2&-ejyve_>=CJwZ)Z(>x2({
zSw42$yPHryp>2vHdxM9D^JbKf?Zu>0)ZM8{(m13~s#IM!$^NC~8|)s=MEd7LkvlPS
z<Jny|7aHpO!PKYspnm-+@oYB%Ew$DySf}`B{#8RW#bcE&!vUS=LGZo6(mJlJm$*JT
z1~~CLg270ea0;G}K3Rc8u~X{1F(7T<F|rb?6ipw5xCq*S{@a*}5OpUqPe<*^sM}cq
zbvKs+;Vf8A698ybb&wu6l)u-Y#A;+iSJouruF>P3*aT;b&@iQ0UYO5WmeIB|f!zw1
zr+erU-UJny{;i2CD(@_rn3&sIAz*Rskg!n`|I%AW0kLPG$>D~zpFC~W4t2?;P;!S7
z%{HU`8AGU73@A4(R!kf0j<deSE3bGh2%E2F)f21zNH?}&QAdnACvr{2r@@`~#H-3L
z3K@v<iZQSHzPNck8#KnRknXlM@gskDFgATa&K&8T1`KBa5`mZOKBG-E6gru2To!d)
zMT;-rL0=jihLURdfit4)Jn4n;&n4{4(%%d{KLFF#(|-J<o#(5}J^nynGFv>|W?f%j
zGTD@s7(S|CND>|$ZqpUtcWg|mOz$zlmxHIjs>10?JH$E)rnQJ1<U~`Bm*>WX%8biq
z7JVHt<RH82TRSy$S$OZCq&mXb10VkULKiD9)~~ak_*uV6kaC2Y7dl%Pxc!yy1>`p@
z%>fqNf1mO-k+*<P5Vey1#BqF<OL~H^(23a-#BfG~u<^>89rzDbl-0tkRPehyib&+n
z0g(@l<AtPu;x~aL65AXjD2Y233H0kc0U_Ss<HYB)tNAF2kJ;O*6(MD~HbNqJc+6?y
z^cJ}zkA%lXWsLJaQaAS07Ivw!v%&qO{PoD6{e8;tpalf^$~xnnn;Wg)CU^ZtiM>vI
zL-#@Gs&l7D;alxbB}$+jvNHEW=QnEVAxyTM&B7UEpg41ZF%!{W(G4<ygx9Wry~hWT
zn<Zf7-+pSA*#6Ce=MdF)|2F}v;PU4bV<DmNJYX8j0)fs%$LO?{g@-yKXdjC_4V;-S
z4j)z}=BTk>3C)MbKQnz|`t3XTEzSaTN0GL?4<}Op=b-fS#PPRG*N?56bv}TXqvqy4
z!`|tI{yx5|gzn>>^b{fK*As0i={c!m<4t`z<L~+2kAFmp*XQ_FdJL*>z5DH5HeTN}
z{_<Vne&k{RB!FQ&v~py57=lb*nRbm$8|CuEX^O~+pK0Azi&rcWD<mqc@IGPq(kwcL
zTdC&q;i>T`7@y9H5YK-g_;UXhXNRe65<y%ccVGBZRP6sijr)6{aelatbK!s?GSBrT
z*Mk(T>_L0}tW=nlNz8&&{;2PX5hXD_I_Zp|%qfG!D{QY`DHBh`PFr;CxIHBYh|jT{
zh_ySOcyDNIM^sR~h_OlH^WBc|&kquA57eom!M9QD{T;kLg;yFpP44}np=LXxu|weO
z>+}6BDrt5Q7!q-}^G_(~lTLizjUs=E0yGzK(`mMu{K73FrPsl8K{&iz?xCj$AdU<%
z9;gUq#AMKicDBpic+LKJ(iw|+*fPUu)quBEj`qFw!UoTo&G)C*l6i4H@wN9$5?vFy
z_9RB&O<l*-Z5M>@u3r-(fB0DixN&jB7Z+aM?G!mDNh1BWdc$9!avoB8xbx234<@U$
zFt$c5I1cp5Q+C#sZ66w0Q?|7}8hw|ooSHGP2OgqFD9WsV=VP<@6?GEy`mBPi5+u}e
zla!bLrG~Tp)|H30wnVX+{Ws3_(cj%0W5U9aEnexF-oarKx3WK2KntSj_2M0r_@$d)
z?Xsd<CP#>OEPbA;V!z*Mpt*M9mP9&*@cT^C$n#nb<*Wm8<A1&WdCrOx=@w{;`Px<W
z*`gMtTWMQMw0)8W`*(|z5QBV)gP6D)dq-1@zyIUXg%zrLsTCHjP-t*f*_HQ*cI#=O
zQ#Qj1Qgs-S*Fx*%VP!|g0z4iAS$Q%tk_C!2oH>F(gFrY$8t43SZ1FlL;Rbgj)5nI~
zuZ=AOqM`S^hU@+rYFZ2)e-|E;dvM3{BrHabnI!Z->ij(S%G`9mN;pXh1!A@{K2I-Z
zS<aE72dNj<=cU2X%^WXTJt&+r3>V)(tE%3ZH`ywvFF-)SGZnt(|LOp#5Wiqi{EqSi
znIVS1T))Noo$rgp#+`b$#8&df9xy!m7jS}^qq=XBY-xjZCjD8X=vI_73aO*q$uJXW
z%5vZLf1x&3|3h(L1+aT!Y5#=6WwsI;g=*+*M1_88-Ttg^(JJTYZ2Z?vF~C-%ilt9u
zZ_HZR6D-CP%ghXW{otWG$5htRtwF*D{8lq*h~`a1Hbs7ACTDxz!Tj>x$;PXfn*|eG
z3_}u{bG>cw+OG;(%@?=NY+eQ_C*}Rxh3)gq&szLuk6AT|>0V0>DkI_HaPfNKD$WDz
z;qw!Kr#{+wDX9`GL}RYL<~AX>7CTcFO1SYx#lz1W-j*!E!&n{i3U7Mj=hknL7Y9k1
zroM`b0<X?;gCw9o!!YZPY_@z<K}CDwJPG6$-DI==!PzgZd7c#sN4=ZSV-nB!P3ts^
zlnpucASfh%81&?OZ!37Kxqp}<D$@J&FFGq53rD&P#uCPenM}I~&v3;SMA-d~<k9r;
z&Z8w$XKynVPakm`VegQ&i`vM2l2|)~2OqiQx!V~cY}X}zHn#joKHjR&=IpY?!@pdf
z6aRi?^Da(6P(ow-`wJ0wJzPaO+-3DDnX)gOQ-aopPQOVk*i#`s`)0d7tYCLXw}_7`
zOf7DX&bEe0c9v<clv_yd7gC@{XH7CCz$1P^ba;wwrAoB`QZ{u|Q|w1CKINPH1@2G4
zVypW3bqse|fKgoY`y6J}Y^Bor5F_?M%}f2{v&Dp^VpSTUR)nEBoAb++iXEA{dH#}C
zbyn~ElQEgBM<F<>P_p6Dz`aJWTa5$f5OJ*3+jb3%hTpnrEqin0hZA#`koPokdTiN{
z5Uz?E7dH)urWn9R;D=xAM=P}WX!dLUKidSdB^Cpg7jMj*xIVfW*y^8LGKcC&_V)A)
zyL_1Yp+zwM{+}kO7J72W=eWXtz@spozk(ZY&qt5yDc;){Yh;R=>K<(FIv<zv>wi5X
zPV9jlorFHCZdy{|g!Rbt0!vT1?Me8_RYPZGzZ7Uc8~S{u-#%Ro?>br->~@z7t@U<d
z>h(`?s&Vi<8QsHL=f<<aYMk!j@{YHf!IS=Ck}MP|Y0uiH1qE05ug$w~C`587%69e5
z0{zWp7r*|T5hQE)z{y`V)D1e@&zbF9Fr3ZU=ZQt@`x6=`6iOzEk2g1H|41H>FD6KM
zA2Y`fx-7>ci?2SZ&JmlZXa$r<UwWD9X*@yhE1PJzD|>{ay_IfQWoGO0@;c_Ek@Ina
z(<{*m#wqR-mk9t~uH@GFv9+vWWPYoOv-PNXYe!vr|DZEXy?*CmP_`faaZ6hFKPlFZ
zPy)Ng@ic;ILtfo}Q>y;&(yaMMjP)K0@kotL{@X1ICQb@z+q<3Wr<Xw3<(o2tkK4?)
zb!^ipOpHm)8iG^_#`xtGXL$YQC%xY?I+04hc}Q&7c!NO@OSr<h`1eldK(vC7x0EgD
zNJl$8QhCK_S6FS@8U^lU^TE<eOb6KPi3jY|KgN$m;nu%vLG~4X^a(Q8vZ6kvg6I<H
z1o*&58C9d~7b2k2Og_yq<Nb7hO?Q$<CD_a9aSKp*ED*7**Bh<Ln9<<$uBD>9uA~Gs
zOlH(c+!1Y4uZd1BBTvGHnKk<fWaPSeJykbC85Ba7x(BhorX<#MHao%+5{bAP{DH1{
zghb73pLCDKob62yC#6JF7@I9@IoK3oGUKV3Hb3m@a}(}@QZOFyKzs`i#~?YICl$LE
zlb3{tq_-0WqS_*an@1Zg5LE<}r_{-k@m_f$c3uX``TtJ3{M=3k71fr9QMKU9>gjB#
za+2||Pf`^AaX9Q|CfKps6&?4f!3vKzZH??ZXP7lihMr6kCEMBTspc89JC&k)Qq*)3
z;5^o4KqGRUx}D=tICxhX?~7?3nEk;g7EbRVEzOQ?<XAS-wQ&-^wy5MqZ*zhGUQ6N3
z^ua0pJ5h`0<p$5J%qe@&!CO_Sk)za2wVHeERS%Wetxoe=!TmB9eCjpYPlw<9D7UB1
zv1K9PgC{meLH7`egYdzFvWkh{PB><=%3}RwGEHlJIUl?WaJ}ZHu8pE%mR>UJRN;1~
z&1#<nvfdvXzLsd$-4oybgnG07MeaB@OtmVz%6A?E*L<zmMXD;2?{S(XL0>NLn8ZLw
zTm5;o?X$MXp$V?vJ5kUdL!v|Xl?7HJM$A;g8oT?tqCH)zZRU}k5Yc+Pt;M@2r_<`k
z@sn!s$42)H-|^4yWPH?#*CjKkq6zLIZ1w2DV0!l}`Kx<gx(|OeT6Ww$p-dWQsB^sI
zvVQR6KJq6srb6FZAd(sr^zi7e#K;oi5%My85KvAksoRl|$1L;c=$}|n5rvi2q0AC~
zIvam;>m5oV&+C924QJ!G=m=NG?8p^SD0Xe%gwejU81k{@7_bpw+N3<XU*QAOe7z?S
zX*;VRS{Cn-oh6%Lh&W`@_qwlQ`PG(s9Uus`h_&sctuOkT*7S7aMz)`WkM|rCIn|^D
ziL+h&D?fIA)HbzYeYp>pzMiL$osEiW_VS3|hQ`dRG4hI1r{i%Dov`KlV}^bF_?=7F
z<eolgjEHFgW@AXNoyqe(-8|P@f21FQ;#a-jDG`znd)o=soSIF3Z8rbxd+y7}o@(0O
z5X;Ti$tsW)MrJUiC**zcD$8J@0D+fvw!V4QE9{>SrlVC`Zb?cAX3C5_po{W)HZR1y
zUbvlF<!QwC?PN-K>B>0#D!F&!zKYcpFB0?uw|*AA_R~g`n?CI;5GLZvgQW??Fl~{X
zg#`BRsCmjY*$YJOVwUh0GVSI>EclzVQbh-7n+dE41Gnk1jrxTxlw5ZjlQ$ps2NY%1
zU<dVOPLmJXN41JMMesh1QqqIj-a6t=y@YW#(>-2@Wqs{RDEA3ZnjYaAe}`&R7|<$~
z4Xx5^&LX3IN56*pC(l^q6XZT8S&yk7az;unc@ncf%CC5y>E#@$73JuQcG9?B@5V%7
z%g%vJg0Ubz*}pr+8<JMGuZ4w02IU;e@16TQPICoNF1tRy-5sr>!eW<!U09<GPPaD2
zHqIbpF0M}bPIhPY4Z_g6qS{%{_O>I>5`dw8*2$Y;#XrJYPx9<=f10JloudHAF)=ET
z$?f~C91L$CB;2}I;w2jPI!V}=*fjC;OIyS$9WV1D(uTId7%h17gr{o$g+Hlqu={m>
z!bJWRE!`i2=&f7)@4xOSeMKK@e;}HRSe37Qz*EO=pRd;uw{Q9>E(2fWiKi-&_QCF)
zd}ZUOpFS%ztw>{04Vaia(bQ^1S^E-qh{P0rdXglqR~P6w;Vt;iv00IS;pcAUkL)Y-
zr?0eMn490;`41LVVzlG}>Z>rjq@O%;C~`$qYz@6P{CIghgAG3*Kb=ebu@m=F*MYdv
z?`sn}$ms=Qv|{y#3h<3lE2)oE7xc406d^J0UQo<{Q&b|cMWm`m@l}PYYz!g0+(r(C
zE>AIYIFBk1=xAk0KUwGb`fTj>!Z*Ob=oGsY&lAF^eG<w|mEAULU%A@i0e3p?w|6cG
z5;!XjUwa_xETvsWCa@HFZ6d-fP;R;Jt(5fjAt6i?V`_i1ADrUeg|mb<2=sFs#obbG
zf<B^g>n*I_dGB_^T59>mpiFRc^-9&%?QB#RZ;;N*8X+-kVHTR_-9<&o3-x+4>}=dD
z`m0T|hMhUmBE8P@)UwU%(|YKR)k?Fhr(xyR^skpHGpe6!yJ5WU&3?jTJ2=~r+~ApC
z`;AL{;txxbk`j#?-ij*mOyK>wdF4bEO|QmzoS=^86*DWXsYn+RO4B%<3dxH^Sw8Ib
zC><&@8?FnGUU-qS_ZB^u`{|X6o?;gQH-fQNeK}=1CE01XEGhD3DD_N4Pv{#dt|~?_
zis(rEm#WA$^3(W>iz3y(kH9<9tlQr!WZ??0&^IiHy<h6BLwpj>Q}*%y2l^rMrpq=D
zRP8~EanL$Chd0D(G>7~T)Dcwky*R7sz3b)}m*9p&tbsdMOxU=SKdEvo3r~RU_hM%I
z|Dv!Wq9=CMIFK1EPGTy5h`|52$7Ny^mkjA+&x_Wio0&m8?G>UtWkkRD!fT!f;wHA1
zkaBm8(a|G=FzV=3_gtPu9J!0qwzx8k=2}uWn4@c9f;l?7?slUC{SeAg6U_OSm2|ch
zH30!SJ94TxZT4;4ch69;1a|8v%Nnx=oyiLJ*p`hVU`(m(OgjxeJJ4e@uKDL(GnQF|
zry&O$@yB5Iy>Aulcff~lLI=4tIaxEv@2b+mbTuSI-f4f9UYq%+Cz%Nu3?O8a3^97z
z%a!bmrubUAL^!SiVl35s8Zp=w1~fAshD;lL$j;`f)1GvHT}!x>KEe4a1*HF@w>GG_
z{E<^;TU!(zEGe5vp3mYaZ1DL?r&mX_^z-_CYEpO5DaORAS=H~ve8k45r5ReI#rxc?
zzkh5Ly#%(`dsM(oX>G7nK^BRR8@`cb>DQZqvpg<#@A6Ww!SQ*VX=ExMJ6hk1)Ah=j
zf2B(k&E%7RyHj?&fal;c4MK;dPEbny-THZI&b0B)(x)wB;8fYB@lzz>(0f#Z=E#0l
zXv&9oBRGR_$J9I;?DJ}A3o_rT$$tSEBAiWwKlr@DQ5?HtZXpbu9#_Wl&64}g*w<N|
zDB4vQ_n`GSpNzTYEa4BcV(1BG+aTuieWQHKj%h2?gB%$|G8^-(Mci*&-FGe&e>NQE
zUT1`V2?#TqaxrcuFC*DMDET^~{R3CgI>CAK%yVit!lvaUfaiJ;1^2xvA!khkztLf$
zPBx5pf^NKwNAS^(x)&aBdU~~!^`WPwbjZ?c|0#H@S!~m2Icz$m&)IKCo{})p+>M;m
znh$<6@2G}mbPfG;F%S&+%`}m*-i__+ykV$&!QwJ;CtiYBM+OIZ1Ku(FU-+aO`F-OH
z`S|h>W4suWf~_oPvKW&&1p`*ESH80AA(bOIy*8rrcPdh^Z8%(w)jqIf_tSySZe?L2
zW<5MRI_I)Jj67^lu|{rB;!<hjpff6}J5rv!j)9hNM^PSunWU(GB6?<HMWnl3lU+`M
zRe4q8g!ImG+nnM&U(Tt%6lkkfaPi@I=+D<#A&B^QB%(CRknWRmqOx*G{+uLg>Y0X(
zf6R&^4K6*(p3<l%;)WC%=e;aq5E~CMdp}_%Ts-NHAD9jk4<h>}=VqgXZ$&wm)!<Ru
zA$2^|NcNN^_Q9jm;E3zl+Q4l%H&<-DLMm925P!i9{b^(AD}BH_KcAMUfAaOpW)j^w
z44i68Ph{Ifp#0@Tt6oG$V;-~@r6}gfQ6Ru$s9nerIhaCgFXm4^?*$BF{%J-&Evbd$
zi1v`yO75d<|3Hl3kh|E;o0%d*)$mae$vfSuJ{I2iv+=s7B$?Z^zcYZv+q*N(r14LQ
zxv6z4)$cw(d0@mfYh+7pcnk=HdLHjj_~>68<3Q60zMc6`_uh6Y&tSiy-Ta>7ACp`^
zsiR_$dX*^3MNaBFY57|UzGCWFy+;buKJBLbK0NE!8zlKZ#+6rGhz!~zj0vE?WAjet
z{{dD(slE!kE{LzC#{!6!;yzYFnFF4j^&I!Df}`8>r}K_FQ0CZJ=Z=LSx<^Nc$VmL9
zfT6)$a>xCw^V6{Btyt3ZnJgb<vLvwxl@t}{J@f1Jt%d-%CyF-n*NRSUs{w-shx?U^
zSZ&rnv>91Yk^=Tok?b@0`qhh_HsVb}3GL*HC}6-4?cu@u+59?n<W|1kO)24Xoc<JZ
zyW9?c`zrXvh|)#-qzC|Z9&QNbjxsU_zgiBPs0dw0*};-C8QRP|ypx6;a&UdRR`^^D
z(T`J4orR1B(rzSMgkqpH%JH4&AZL-DIQFR|)2`Z9jdqAcjUZtm1cHS^^y38Q@U6nE
zTO4$zf!I;b!p2Hi+>IPtor33&oD==*_4-v?%^L1m?<9)uL|GMlv<^lajQs~4y-jbB
zM>*z|Pp?mLLYrEkF*N-?^50aFTZz2ea~i6KY~+k{iqvSKEUaLRvh+Ja#aLho=qffI
zl`?$J;EbE=Ypa`^m~C?kyiuT#@DSyT75BylN4KR!mKu`X+s*rhSl4W*pbs>jt@Y@C
z8r}os2Z{>d=AS*4tQI+_G|f&eJVPTi>?ID^n1*F3jiIxVhQaI4=~kA<Rr^d5lM=>}
zgm`jJ;zuo#Paxv9g8bb6bv`(u)L@a!CYh?o5RK;ZRbo+{`(3#Ofj+p%4gUb^tEp>o
z{f8`V0T%=iin0>Jo<3sP&*NJiv7Y{vyFeULbsHUw3oSPD`$v7|*&<lil0gLR1Md3g
zCphn0W;n6;7eDUPuye_!03K>&+@7OGHl=5EJ;DoVJgD}Jvg3oFL)VImEi&>|w`;O|
z#kg}Pl_^kT!()JbcGl@$I#PA!nwv_(vC17YSTK;Jtb%5J%_rVoc7gLB<OirVY3%i5
zG>n)rNhu)-0HE8(52kxpM0;^YII8xqvI`vbrk8Towm)eSiBbOmfBWVc7(ISto^e-h
zZLXw(0S3tB5(4C)z+U`k`qrTon@DbPwx!LtaIuGPrChbeo7}TuV{tKA3WC{PyaVaF
zqW;LdA}H2*BK`B1W{|(jpO>ls06oQYL!}1;tv_iXv69x;GR{|MRRI)`0RAFa{y+is
zHC7!rQx}RQnN7KJ8yL>f(1Yr8&(q$z07f%PdUHulps~-}Y1*&a7wr?TlEj9_G6L|V
zd$%P0K<!IwXR4*rHOnJIl2|T3hlL-H1pAMA-8s+mq&$KEr|lnLv4?kOsvDPUS5=3C
zs@TuX!w<t59_FIBwAMG?c|m-qg`<ZAZdU{4Zk^71`d35spdQpJkFpCK=(X07EmR1}
zg~^n*KYF>~4m}U)NiC+Zv9M4aFqM>zp^)>nefto9I_W$5(0Wr<Ut|_JsV%h~@p)@7
zht2537u$~b?V6V2&iVBuk_f`ud3#E2A9(KP{{TTXzxtX$q@Sm1UeWdo9P&ebx+z}S
zibhmOn^$vutO*~9U&@uOFWTDIY-pDuw@6tOf)0LD`VK3g+k>27(wv?#nmwnGSm$8-
zcq}e0Np`jc2EanemdGS~ZL4=MUPo%n95Ft?yIc@muts>sGDd4x2fZ&^PIq^(Smq{8
zP~2NQFp&#N<&ea=+qpJ_#~g3;r_6OWvW+cmb8@mVkjWTOR1!cOcNi7X{u!X-zZCta
zk_#9q9oy<`Jh=ouX!#l?2qW0J=NZoI_pN~hL;hK({qs{`cBZ-MQ73VtKPD{m8vg*_
zG}9Dlt+F%+9feFVd8W7+AR3XJ!ChRaWH9v{5IS+5e>#c?b+nb5MnbMebB4!WgFFtE
zvlc{SH2v8=)N>JIEdKy%izLUF_Kp7lHv<^Q_|r43kVe>ZjAxH;{=I7v=xGiIIXR`w
z26e<bl$LPqkO{<uz7Elh9ysgTqG)xk!Nk$;D}%ra53v5VtDN+wby_)wXHOoc#v>G}
z2#jvY<9-k3IUki9HAG8>GAo_Gx&Q!k$NvCcv_Qv7GEWq_fW??=s}>eW*qjfP430TH
zF;0%(Sx^Vsq9Y@Q^v}|^FnFZF&-A6tI~o4~XTC`8BZ}cbJA8uNmG#LW=Bt}sV2m5+
z`u_lQ4D-`Ct$nmG`D%HGV=8M)@qY6|a;Xy)%ARrn`c#u|`)!^`Cl8a14uY=`)kf%l
z#KO=120u!h+-1CtwHp!#N_bP67!HQAW~ilhw%698Q+(F{0AZ9fykO)WIQ)ODP2uRR
zg~aV|sY`h45=SSPNjx*1*(bh8{3`vWv<4{@#F&uf`1{A+twC#VZtl>+k-Pok1~dM0
zYpp+a$2(fw%+}+ESuG=y=)mQe#&CITW3d=K@mYXH<?MeDmVK*|OL8`j+p*7I#<lf=
z1eV#cH!KMuz(2bq2Rsb_0Q##Fa8*sd9$>{mBWqzuIL2}41zdI|fw#2?(5AWqINP;B
z##wMX`)3uYGAOo+!SzE7(XevCh%5;>2PZ$RWvhUs4-d9MB=Fpwr`zzUCApGvC7(u_
z<_<t`jnET=(xvLgwk^DHTUcD_w_2v@B?IPiNl-u>Wap?SuX;-;lYiQmS8IsjZOyoy
zs-zw|{W{YklkN9$HP(}`J_h#<l_58Jb|jC^oo1hAyqe84_WLx_VV?(XF~_w4K`4&q
zc`hN=n%qu9d1E7PRY33813!&daTt|$>hm<9FcR%!!3*DZJwFrcR;NX`ySPQtJk(bk
z9Z|UfRC;sNkHV&oB%4pUm2|-j(V_CtgYytFF~_JBt}?Zqy3Vb04y3{*MRLX1xX4}(
zPoVYh?Nym^X2#!K^21|?EVu_4@4?{yb!}&Bc%+6c6_Pg?I99^|NC&5<KD5`<?e27Y
ziH4oB<{Xtk7#1oH-+uI#;1gT@lJjJ`%!xFMxRag$_2;D%+cl_+KD9D5sO%iGZDI0(
z)wsrcV>`X6w-d>Ca2{<H$<D@Nr0yQvbflK*Ylvb=^g`tj09YIh;~)%nAbwQ!0?mcQ
z5K884U2Xwgp<g2hJ$lwg6cj|)9ynscu{)3e7XuvN@-ykl>sq&vLb_Mlq0^My4WvY4
zVsnv^{{Yvlw2RL~S#(zfxyew<6mDf1<DLNg=_k|++FGI1V|3Ogn2p2AeBp<$U-OD8
zT`46?$ct&~7YrIrq#ne7S}PixmmQ9@9QUImG~dRZ!LE}ba%l<gNLH5=0B0hTwJ02u
znr#3n=}DS8QHlUEK%_0sD8MW4M}B=N3_(e_7b~>=dsB$%M&2_(0LMx@Qeu>jDFC>o
z1Y;C~(vZ^u{qgHaang|UNk9SXiq6$f?i(JJqglGB{lk4ITZrK;P(Hp?jOBm!VNCIU
zk#nZYHT{-Fox^6~RDIU<`c#&TSHuK?pOpUqF<tzT$23hGh#44Rl=2NkovJ^PtvR?_
zOQGXdQy4B|od|8D9=&O0m(RI*am%qd71V2f1DYus>q8)n<*i)cANNmhp{_PZmeNxd
z<T6^yI;5&c>(Z;2vGf>xZ5q1ENfQ&1yBO_B_engO1d7R(U_tASMJli$^MT%x-kPw@
z<gxil6aoOi1RT*L2*zE)f!y&#QY6xdpo&Y08=}OeiKde#b!ov~O(Ekr&OjB>_&dYx
ztm-L!aG0>RZORD$09xax;3~$4;4AC*S@m)DYkcHD8!q4P9@Xhq){xoTq!322#DfZ|
zI2B1)@UhtSReL&neq+GErP>c_R_W4(I24a4UAUwm4yKT?G}34R#IIUuIrbFNX{7tm
z1G^lWVIr8!J!z%s0POR@q|Gq4X$y|j0Q1c^I5geVnV<*m=dA^~reTjg1vn`^X$)U8
zClriwjr26&obV}KFo)?tBhMyJ_@Q-t9=8Xt`@+2aQv<07+Px-J2f+HiNaAz<0HKQW
z*$^h|Fe9fGy&r_UZ}FrGpsJBqH1VCBo@5-FsFHo&<I=6zbF`oD)~x1Ro3}2jqdz?T
zp}G7kj>|SjIIgbfr}jqBa(w4MrE)Qo&U?~;<|$FTr!{^RL#9of?(-C23Zt-wCvo<z
ziwyq&VP2JC!=^zQ?@f~ujjTZ3vW$SNK>X>Ux6QPlmpp@0S}<)!Mq)r|Imd2lX!P$o
z)$U_(@_B_sU~|@nJ9Z<}*UX<|9jHm~R^!y6OOp|Vn6{P69Gv5=R*O$)nn$}?VG2G`
zjBYgzm7?BW2uqd8z$2|EW;JrWN<`{Q;XxS{u{=;qa$Y;X-F6JUDoFe_bt9B4sxm+=
z-m|ZCTkSj(JWLb&%5uM*E2j4gG;C@2(T!5c31(PHUCKCY)z25Ttdm<CiHIN`6lCC<
z=AaTl72}bWx`q^&GEI2H&zYodft#qM%dN-FpkBplj}f-GGNgkTVS>L}fKN4%P>%7j
z8T81dxrHLz803ZI*GuBvJ~=e2E7SlLRa1{bIH!9wg>Bi-+gnYnT)dM`5sCZn&S`G6
z*=;Y30#%a>leF<mrsN|g-QL2TI!$dMX-5R*U)G;c=tAhW@g$-5F>Ew==svY2<Jz<-
z<t(0QA2G<qNVdy0w5=qpoz#RZ82WM2vl1Cj<_g<WmikbH$mN*4iluO?&|<A$PFN&p
z8Dk1E2SRF_D>S>ZI#sEz0kUZEl1RY<s7amghMNiDq5l9(<voAfHRyS-JMhY%_@;vc
zpC(iP0FRpVTyfI4C-F1TtMF6w{aBr7#~o>LK^dtqFg2n3rmSxQ4EV0&{=M7(074bF
ztgr5xvAhj|;=7Of_iz0OR`m8I?s^1^^JIF{p*v5pr${o@7;l@N)oBf~!+H*t1M}3=
zx8j&zaLzfWVO(@$0-kvtF;T=w2XG7N%}7`d4lz!`9gmla0XX8AvSW;KNLjPMqQFa@
z-Tf&E2kTh+uZc9R5+c|4XpPwiF5f^ot}6TD)GFjy>8#^CG|#v6ALCm?4^n>$CCx3*
zO&DI3gy)=MyqSJ1>KP>I*2R4THfvJD;=P2eviizcGyG`V!2CG=wQmJkYhimxo`z2Y
zibCL?m7S;S78<ldTN|k6Ui(iY>N<+LGrJ&HJBv=tyOS#oy*;TJfWR60Q$r4NDUHeD
zxuswoydFE!<lu5~NT^u#H84;(9q0jygq)t$Fi-&LPR7;7KN^huz<0$Vif~UIX#icg
zq`(CBq|eF@4r$m!m?#(-{OIE~9}WH#r-Oq<fL!DnT#dX_Fn1C-rxTu(tO8(UWc8&3
z2LPOXX#wXXQJ<KPS_Uo@jmI<qI#K{J@997t!Jq{=1PVey9Pvm;sp64GUJ1njI1y73
zf%T|5bKa!M$UTQzOc1-ajGw}lSQCTBX^b~6K<Pr`t_>C#a0_J8sT+T#AW})qAY6=$
zd(a`_hU|1S(nB%EIHXniiNz|9nX)Lb#UvG^QH9B%WG)RiAg&bhDOd+%CnVrgnSNd>
zH30hO-kfvX^`W32v~A>!({Md=N8`mI!8kn71ArXRF`i8@5OR6PYIZr~^FRSy9OPnx
z1`kds$ID5KQUJ#p<C;}cI^vqS$2?M##xsflcHePGM{X$GKD6GawJ;ZH9RQ`l+uD;S
z8644;>DrJ12d5dMX~uY@{vnE7Pyzvy&NE6>;NujT=lm!qKS}^hFrb5;d8cIh(=u^_
zXaNrg6k|Q8Il%8g$UfADAp{(N4K<EI9@Olg!kHo9<I<BEnHD^;PR}(IZalHlpS#+i
zk!eC_lTF=@wBX0F{3ro7Z9Gz`BZ@a?>-D7|cjAByia5_+X%7P=Q$zP1DGYuApwo9}
zlloDf^ng-0rkt8-bt*|C9=YO|I2g|+rHoE<#ZkQC_Q>|$!~XyrKjBwS1yH;v?RG!)
z)xY!xq%!Ev4o+#U#%V#|8bW<VX3bHRBEt7SHl)hR`Be%|!@%|T6|thqk7*K%#+|&R
zBphLQ?Z$hKwVx`5DI|JXnYR+{u#!L->^(rOEf|s|-C_1nHtk)w$l5=V82klxEn<#$
zxgNNi#lCNn*+YYt?s71H&#hH?;x=%?b$m>xEg)~aGgdX|;gH)Itf#q9#Nse`9CZL3
zipo`iZeHayYnE(uV%?8nk8jqR*hGsIgsE+FE0rVyLB`?0`t+-pcK2F^&!4AiC;|<G
zjN{j}L%j)5G+9#xFnPe|c6c3*e;kT-m41tBclLV%j{sbt&RvM<jAVLJ7`Kun(<xn3
zVyXafzy(-mKV8Z{53M8`b<CFQDAde>bD1|0-=C*Ss**+LFl{Wc3^xT0xpK^Mc>e%l
zPi~^E&3iqB&1(jkEViH=?N%j;<lultJ*e_PK@1XHUMPcCSCf(c(Oix{@zeR5msAET
z*;zFqYFaQ@A8*6Z8iw6Gh#vmeO=#ywL=iUQ@{y899e#GtzG;^?Chl`A+8pJu6qx}d
z9=HSC(&_@KxHl~i_Qo530FPEYboR&QYAdTd>kqT1+r((>z_2H%PN$B8X*7B8`HKGl
z*wZ5`6S;!`Fms-r_aD}@H7VA4R@~|DI2gkh+P^Tt?VMnqaqC6w1$$BDTU<i=l1L<t
zmM{+so}bRDtkP`WHIfl>0^{Z&VB@D@-ld(a?e8AW9Wmr7w33I{AN^`|oObsYDHNJR
zz#RzO#Gb@p@#w#(^`+(nY<$oHYi<i<V4NSl{v1_!;Z<$$>cSxBoDvBInecev{NwVe
z0aXs?M3JQhvcQlJ&Bi$P29#Vw9{7%jE+ZghWal3!$IH(d{3rs}mkO==IMfp33cx5l
z^Mn3=v{LCS7`*-7l5K*9{p0Q(@y16vz@oY8ZfPBkppt38o+>{zK*?nT*EHcOmd4;u
zrfaDfkIAL$P)l<hETP*Q+iLrhPgY%pw*m)TRS1(96x<xtD|rJXZX6YnwyE_$<Wr@%
ziYS^_bqJu6b3n-sb4yXI(a3?7#s~y`DP^8Gp=n)$qKuR6NC#sXq&YQS+Wy|@S)*nf
zP6%}>N8oAy0BMV4tY3(}{{XicrC=rJ6x^P;q>g2pC6NwMfFRRac+-OGp19B9NMrNO
zJ15ejS>tnsbz_6j`{JFvWDJbZ1O3G(Cp3Y-ItyV>Gyv@2(&s1MszIpQ+{$8#P|iDg
z{XJ^On;)Cy?jB~{+k4}tX@H~<I#zb7PmteA(hh`?k&)DTR&K1oz}WPrw-LfxuuXZH
zvw(!0eMNS|SF-OTgYOgn0EKXxecTfGgzb?|)g=A|SEENPQ=w?xU3--|tmphk@+o{J
zbk%H6{JkLm0C?m1(oHUrc)KnovYCIoBdPv%Ys-xFML&f&Tf)PbqyGTDMN+ViZf^*9
zO5~OhTPZ!_n;+Jq9t7~VbBvEqKDvLfS`*E*Cq4EGaMNsi+Qa_<d<wL}?HG364)C-r
zHrZP-^=S)#THm#{)2!2Ntah-E`eqe>l{9JA0Ds4<KA&__{{Uxc=aXj#{qQIi%X{M=
z^3gvrN?kzv!2UHww9P#K0Lz>w{s1Y5O4Hk|lt1^tqy^IX?ms#=0o+vsr0KZ-0FNkt
z?}1D@Mw^`diVyqXQ_x0{dTTiDYdN%yH~xHJ{{X%PC-y#=f91vx``}Un@sJLrR82Ce
z$#6d!sr`+nj+QVF_yD9jKArynK34w#_rRnwb8`vnDi8P&sM_+`dfY-jt|@~{(}I#M
zV8HA03UX<dBxP-2$Fd4T8gFd#lX-9d0DlMg(*FQxSpNXe<-h&?U-7F8r`oSeXot}S
zN%lwvK#4!^kw$_l4MM}U?YI5?U-734`v8CA`rH2gulUu)w1+?HQ~voBt!)7R0G3hz
z0N)~jDUC+J{{YMNvHt+JtNt|MsOjUMw%h*z-@#TqyLC7*#6F->n|MjjmY?^?qd*}3
z)YFIjzT4;ix(b|09I<ak46HH=oP$g-MW6La{{Vc_`D88>06S1Kf}Qc;t#EbQIsX9A
z#d*WYxML%ZxvxZ-S$r9<=O6L#fAle4aM6q%pyM^YAB4Pj@tGpIB|xiI60iuX$la1^
zqM`XlIICK6$`wMUL2eFuR<C1~Zfs2C+44>cw;zRbQLxDXXPW9}PxzKDPs}8L<y@)-
zRz31*K&h4jbI(fCv>P;AtSH)LPJJsd5Jo{2rD2BCrUf?-IzOjc7@}9U`L!8Wfx1Kd
z>sL)ni+j;;989duxlDrtip{nty0oqa0F;nF8g=E)r6b2AlT2MnW!~AqG@7{9hTgw(
zA&Mw(6%#qbA>Eqh!$oMmWHT8gCjjFZs<YkCGY>XaX8!<a(INm84B+!kM#xTAHZ8UL
zs6gCzkM5IJX4Pla;5O2*UCf~roC@bi8*&akYQzK$u3ICv4<eI_+!UGATj<8(#yI1W
zDJ6}FWd|I3Rz|U>wwZFO#9~Fy9OK%$Z7`c_K<#kA9(iBuilL|!lG<J9k~;>*Ic5I<
zJXUH>=8ifUH+Fw&(QR+wUBz;e<F}=6-6h@Mg%&9-7z9z4C!Ravm%`T2!wgxK)ykH5
z$jD*pYp0GU5WI6pjI2l;e+?;0&cKo9cM?M$#)37BB8=m`MQ^M~3r6<QO&L51260zB
zPiYR9Fc6*TAS4WZ-g;IYoSUB{R*5FALw0sFB-OQR1=wClqHuO8UNP-iaa^)YSw?a>
z&2+kzrOnc%)T4YtAWjF|1B_y-S+<uOZ@8H-Ix4PnLTbZnUCgV5d+ChsRa}9P1~34q
zzRXRWujULO3>O`8aY=DE?;ImwF(#{wh}dq%dezvAo{`~}+&nZ-{PL84<L12$-6KNo
z!Bu%BjsUMY@X6XdG&7vVH~xle(HVD)5s+(!e-k_E{1p8^R#*PgvCcl(2mSmM9Ztvo
ze=YO>09{x7YF{EQ(Wm|LDSpilUnx3&bX4eIbGpW(Xwfz<;3wKaSzZE`Ieb}g5=C$H
zcKfG2#cXR(L?dtAsQ&<fipcOHh4Ed+03Yb>+x?+i)7Y1}=?=Yl=}-a56=la6s{Q>w
zwP<Vr<AY7wd(@+VMKkz;{OW`Xd8Ipu$Ta0#pIUer9^!y279*{2UNG_7Si9-^V*_wF
zl2OP{VeeZ0JMj<pE{;+n7V_gM7zaB?bNN?`Gc&O)PERL1lU|Mw45#nQV=9uih$os^
z<#}e2q>+!z%yLaJK_@+{Q%>;ysjI}#Wopu@oG}<2)EC-y)|GN?uOcx`jO{12dTLR>
zDrPo&l*rn6#UTSciV5`TOB`=J$sAuZxdBJ1rXqVg`<*`JZY^hcWK+W_#d`k$gZyV6
zxe&Iy3mx)~ounS4{432ayc@1r+DmnDXd{X-xrvo{ADv~{+)rn99mEn8c*tcUx$4rV
zUOH}ETZ=x4EL;34cwr|QtiKIvaqF5qH;aJeZIOK#b*;cKyw`~+xVtl=;s}m=(}>xQ
z4F*gubNJRar{Y~VNSPzQx>%XUR1i)_;Ymfw*&*E5<mWu*kT3%r@$X#E{3l)>B>w=!
z#RvQZ{{V$Nc;CaNbN#0m;t%*$`x>9h#mtU}sm3Y87#RfnS2&(F@bNf0q+gN$01DQz
z)U35AjJ8)%&Vb;QY~rQUlvb!NnQv%3W4$TB<EAM+@@YBr%|OK?9@K{&2Wp1u>N{8@
zxVUwWBpG&YfL3LviFAwmw70asib>z@qV+XO5^CuM&2!U=QciJ92QAm@PU<i!KsuZn
zUcX8@oKe%D{HOskc^Kw^)DeTpq{lpQMSxH_=Yvyo>s2mpVY7v<E+kl@PFdXG0ab1M
zOQT)PutBNYODmizEQ2PWB$~QIxv7tOPy&K~I%vV*=9f7gDh4TGjwzhuB=JIwWagYs
z2dSV2<+l3LsXWzN%}UcwiDkUFiU`TTGB8n}#;7-nbWHyM$X?4I_1IM?N$QZUjf~-m
z$24TtAn{I$I6AeKJ$%tqLE;@IcH0)GYVGJG2A{H@VCF`zIN;}+Uw_u2SKb3Fg1)1@
zIF}?0ew8)>$E7X~X_;^idegTy-Urf^g5!c<b>@=*aZDSD?~zJLLIoB9*v|r&IO)Yl
zle=)wG!4N0O%@A*B!P^5Dcs|cO#!=O>qg=aBif4&<M#|wV+?%_H11{@9VuCubmofy
zxFg@%j=Y*+B=*PCy(nIUXPPVnwx3!+c;=8R5;q>cl$dX)Y5-sJ#V=EgPzE?Oay!xh
z13C2drjS0A@(wy;o44Pk05`uBW1Q#krN9G>{b&Otu4xQ!QOWvLa&V2#I6TzH0P|7E
z0YVQTDa|3AX@YOEi3X#9zcB#kg2Np@DkFkP3L@&orFC7SJ^5q#kL6CcZ9G}DqSD|8
zCNjH;Jbd1~RYjXkfVA;jU8<?UV*dblYA_pl^aOr1%*(S!DqE$e+tsF7L1I{gk4*h)
zv4PjjbE>(GBOAzLp5yTBe+qjW0eF`Z#WR`qNCy0XcVHgAz|__arcBa8mX8`Z0omV!
z(*v)#qhX9#1IiXHS&7LdcN4(=TvH55xt!}HCt_Ii=cnaX4Aypp?bD?jJkE#Pp8e{R
zTv<UhsC3s|qhK4dbAyn1=|C1`h9sBDeOf@x8@MHo26p55{<R`RlUXL81^W4s{nn2;
zz!>N8ssiTHSplC+bCgvDN$Z??^!Z0MEv3W@G@f09MX_0%W^!<H0Q{*npbs#D*c!nE
zWeCas_J2OqsWrRWJ-X^`=Cf||a(z2gS+g+R7SrVOP<eriWRln?k?F-U5onrgPWo(&
z(SWCOoVOpJwG0bZ_Hn8;zuO)}yba~xe5=VP=~gZDcY@|QTJ~8sHgLy`V2pmXMmwnd
z=)!4dY&-Ul#F6u3Baf-8Z>?Ma=leDOP)QzO&j%ir4*d#5a_F-;Vs#m|mL~%}`*o>J
zzuB8jh{)1yl#R{Q{Eb!r0Jd)%a*aKS1mU>@0H1Gam`^3o_H?quVskrX4tV|B)IM&d
zD;j`tP5RP?<DS&gL97|7D9b9f+1si$w$vcRdJ~Qatt}bLw5)Xnx)>ZU@aL!LSho`>
zx$;hmXK6_uU}6aa@UDwVf;)SBC6ilxtB}MU+<kM$PH|m{d#LAokm~|K@HAJ^+OXaC
z&I5G+06&dqLT{#?QT?kB0{~!-duON8uIolWwAq=hT4XFnRFF{RNIZLi`BqSt+7we3
zlPap=hFrJPkHft?Xa&oeBx?kPwKQ3yawTqsv6KBO9k<CO>YA)xa)2B+9N^>iBCB0o
z+D~xG+H~H0pE27mI+D2b=t(}=HK}WDX{t*s)7ZRnD+BYn=LG)%g&P5$k>0d0HO{RV
zSvg!c4UBik*Ym3$bhg@5@yV-3(|n>gAHq1MOz}qy5WbT+SPN_dLU2d(9DZ1-^y?cd
z!7H|&&~g{%kd|x?{?rJflibC0ttPV+k%tUXeF+C0KfC<tXK9-DQwFUX2W+B~>yiBN
z`BF$B9$GGyI8e&Ki4UeQc<dAd_<d+&ZchII?1DsnHps&RJaLLmTw@o_Qmy^2j6(oO
zY~-AE_Ny7VVgu_CkVs$yV>l>(ECc@leN%L+3t1S!C6wF-JLGaOHxLFh=m+ObmMeHJ
zrndgfX%{;cm52dI2fqXEfIY`*Knrhp?1%emCU7tck>B~#o;%}nBtun<OrdknyqF)T
z{{X&fyawDPa(`q@B*13Ggbl;k)`g@HYB#e;_J%#BWKv1VY`8h?@BaV-q38uQiseg2
z+On%g`$*0R2OM<d_5A8Lnskv_wRqceHq0F1epAjr-9Mc=_`>%r?_yblk_P6>k(0;d
zD(#M)r_TY9+7yv~S3>Q^20tD;eQI0k1GLt<TasqJis?w&Ks>1(O%%;0TVJ&p;<1)5
zymz-gozK>a!gsl%E!=35%jXE^U99;;VZwrP!|^=SmYOr$%@nNa(j$Uf2PH&haryIB
zt)#k>Nl71X+Dd1IAQRhz>sj(@T9A?wu&iq*Az2Q7_Aq_%&*SY~ismJY%`RE>Av&~s
zK2wvO$$)x&bNW;Cy*5iIXGd^L;~eLp>-g1KFSQutx6TNW+aY4-8?XoE%`t9ou4IoA
zY;=<>rXz&;U*$af-32{BSaeH>*NG!W7yvFvCk!_qet$}5_6^at*j^)+W3`DPa-d{;
z<P-SQ{@;0oWKbl0kf$UL7q)tGYD05>y(0y8?kHr~asIOz#&Ob%up?atVLKBx<YKw`
zk0WxDKP5k%Xr-I3mnF7Qn3vick%Gj5`4B3ETAkn8t>Kl?OS-9FEd0QOlbrF=uixC<
z+sP1yAmUTAI6o=uPq$i5;ASq7b+hipw|+&tIb{QB8P8t4)%#l+V6vVEaPK1EG4Jw$
z&*CbC8jhoI;Z#I{oB-w{@{Bn-8SC<o&a@=EnRH=v5DAQG#1$k0ag&c~9l)e?yVYMQ
zT{Z)|JIFcmwqx_=qK8MhjE6fn;0*6SC=L!i_{~PQmtiAipCHKPq}XsroTH&VFi+uH
zdY$C<cIfb^C7)?#84LQ4=SHAVZ6fJl5yVwMXUGmlL45xJDw5Aix{Cferk8MBWch^S
z<;F4k)MHn_674V`!Uo%e&QKin>5@lI)L&|MvAx77P&&p~GR9612Pc{}8EW#z?p;Vv
z6u6II0B*(z&Up9Z@~QOeDQ!f8MkFv&GUd6)J$>rEj-hdJsLKSApp9|?93C;wGtkrS
zuWn(yDH<V-c8)>GBp>C0OI?7g{grqFEO>|je(Z-0lh}U^HT1nl%gSJ9ATOFpRo)IW
z^rsza=2*+yq+|u$NmlH+BlF^h)$i3vSYa%!h9octFSKL%)6_(;X;+ObUucl*TowV(
zI2?Uyj8+#`R`Y$PLgkT0OXnnKC-KOuCtSS}h5I~ZRZi~NBX=X8Z+^8lqVqPF=CDsV
zrtA)%N;Lz`4XayEa?Hfy)=+uQGDk}9JR4<iY2nLffk0`Od$9f^lg)5a-L$javqywB
z&UTT>85P*sYOAC8Gf$ZWZtN8mN$ZxyOz+J8K(;JuelLp4Qj)^j%4^A@P4f9??t#{z
z);wJr_*?r%#yMZk%wdNfQ+w7%igV*VecWNZnLjLw$+Zvv01DRhk@B0NwzN@1w$DKD
zma8VGqQGU2b&@#LJd&;igpR6vip}xAiDuHi&u3^Rj(Hte%B#lS;Ch<Y@T{@7hcx)r
zhnSY=S#!w9<2B9vN9N~A9Dl9<016_PI6aPzUldtd>9AeR9m=%KQaD;NBw{_Ox=)L2
zwQKn-LQQXX7|Dud+DNQ#8jUjM3jsHqHQ11dQU?PkjDm1++OagBwa4)xA5rq-lty<2
zKPrv94AW6fTuq%-$B%S-OX;mHKG7VomIrir$sU~d?N_vK6KVS0q_;NC!D9aaSR7!l
ze46AM1(V{;o76B04iEc+v-Awbq<FBVa$`9E0LQ8Fs|DT3JYC|;eNxqA(<Z%z;(d!C
zB~izIo$3BEy12B1!}n3%Tt;S#65>Ju3$*70zszek^$~s=*<o-^(;Cz9q+6`~FpQw(
z4oCg_s#Z-Bb$U;XbnRbKdk7X)kOEblU^pI?7NO%?D;w$UW45@u`!N3iNRlPW#r3RK
zjZ@;ZYJe&TKmc$D%UF61maV8Zy#=Mkv}qy#07>(KB!XL}2iB*SJC$~N75@N<wCfEb
z9Z0#BIq)GwA2XjygHG`UzPfI->8+=;x>Wh$km0aLP(^v>qZH8TejiA#5yHyb9D}!Z
z;p#K#T|S?uU)p%>C)Dq4rMsHliC9&JKp6DJCj^jP+|KagJl-7fG;>WeENV&<A;>BT
z9R32XcyGkN*q#)(l52VHeA|am%5p*Dj%v4t0}Tho9e(5g0O&1P8cp5ZfYUE7BHyON
za=-)AamG*7RW*Bx_B|(1@r-(8HcxY>T&LQGMsPNq;|JcR9xH@+ku+DenI?0EbI^=u
zHP8G;k!7^e-40QvBp+-Fj{N81mY6~R0G4b20HC!(im_KU<njHTz3ldrS=}trWNpSv
z9^6*0k>YDDUrL)$P0>dHK4^ZcftuuCP<|<2?*QQ(jz8&`to;&4UkP}VZ}<NIsG-GJ
zE<41U>{{R1uAqYI*@T-GMq(C49-jHG>r(Ly8ccR}%LKPqbD${<eMrYz;I(a|z*-J*
zpEbIDTCM7Betdsmwl5Og{hfTHFv^eJoagnX(qg&Z=(^puw{0WDjTEsq$s&KehP0V;
z#c^H_wYakJ2CE&^@X2t%Jc|%G1f2IC_1hD)R#Hha(dW{~{{R$^hylU>07!5B2v?rX
z5Cwu`9f+?(l0bYf;w<zNxBi7*e>9JVz&P*4Ye!>TZ}FJKQSyv)inC;|_DsYwcXSmB
zI6FRH(yr+yLkgJCAKr7C)$DSu%jV3*q!|ff&g^!R(Cw~3XFWUDd2;UBYb=Np4*vbC
zicD@G_B5dP9K;#hoMyGO(glO2@C#f=^7@R{amLYu&T8G1M8qZC%Fcrw`qO(7w;gJ#
zb!ilg11ZLSrlHjyFSd;53O2S+rAun#`(8pp$C`8b)E7u^E+uuwNhcI7#`ZHE_ef7-
zYRO?FXhG;OYI*dj<3xXvm4-trWK=>45lS}-MOD)knCp9HxX6tfM(hBq-`MvSaIDt>
zQ40VUJeuhID{Qv$02CLO=E>`U+NyZgXF~)^xWOdjr)&z#ow->T%96VXH5+t|mPb;h
zcn6xzx|Df=?HW)|Lflquvd9MW-1M%mOwyk7Og9d3CQp_D;)iJJG}|Y$w!3{T<V~Jw
zO`wC@JpMIOM!(jtb{QVoB1{ktImJh(>VIIB?aWRjW(o&T8>LwB6@<3d!tUNiRWF$n
zJO(^u8jYCx7&n`Iwnvqjz`+bNpL(ZkyI24YPfS$TJHtrC4ti8DGbmh)gZb9WV>h|b
zYI>wEVFYkbBy7qSMk~R`7^+c4q<L;$;xix|0*9?h7nP`elFmipq&)W-{{Zz>YyB=u
zJxb=&XgR|p<EZwiNo-p&CIigr#YW5u=WR`K4AIV2#v89S46#U&hHPM*Vzn|oBf~%s
z_(r+s%9sBDLp9g<k5iLJ&@Qi#10pC04@{B({&mNAX8`zPJv^zu^fO&Yjcuj6@SW^%
zA$I{>DD(^o{Q<5g@$205D}N53r|Qg&H^dr-pR0Y7RGaNFNoFpCB7DonNXL5Eu<@3a
zsa->D15B+lv5d(c)ogVD`qw9EBI>&6ytY#C+vz4b9|r;U9xFdYb<{uM8??4oY3-ij
z=D_=)oQ{7Aw*<~)&W};?MxS*%TgT>{vnt86<aQlEJ?f{!jYbRq02W;ccjQ3X+_=Zg
zE0(vm5q+8o<+*FSdzUS5(PJIkrEGj6BmNS7LxYlz!y~puX&9uPg?8EO%qkXNo25+o
zCp{`I{{UJ@ra^Sg9jvlOGa{iXG1TI@Ed$4Px`T^NL<>v6cAfkyALwhaVtXIPxz7;z
zQ%lz3X{1%Rx&tENMn6AMT@;-^hHK_SzeA)(%H??nrYYgFr#a1eUxj=_sOg>|O%1N2
zy|ZaNu)vZR-B0wdQ)fF*6spp6<z^9;(c)e{)SCOnHwm1_Z-|%M9e-TcE_#gdS9O<Z
zb-U>sIceOS{{XydqTsN|uXdbNV3E%!c6$%Q+f}ykv~rwgXJ^m1Pw8HB<7>fn;;YsN
z?l3`*VT$#=CKc1XFKDH4<y!_}?~I!8Yw2F*`gw~IWRSN%TI0g|)n_v2q*5Sv^fkHQ
z>oa@es|d)*5^q02&-AQShbOr;=pPF#Jl%HU;Eo}OgXl@e^38Qumn}BT;I7WA$FduL
z3(FYmE2?ALuk^1ZSaFPx#=T48jLQ|Zjk=Cmi?_dO^7fM;gZWlCHELJxX+6(H_*<xL
zxV*3=;gm|F+;D%TdQ(1qtHr(@%vZ&+C_FT75A*(&?40M;xN)l0eM_gXx$Ryz@fzpt
z9w=yoWJ4OS(Dgsky^N3nB!DaD{{RtQ{j<b+gu{?#U=OYi2lA`HM)e!)Dvv|7(Ec1+
zYFaI=<oA=LlP2=21_pY5m3#gbU4Z`pn2o?5>b1>T{6W{PEn>EY*4N94LM~!_;D5lX
z$NVgh5qGn*{{X*F{{Y2S(uOIwW+dP@#hwYb@cxzd$Zuqkyuh0sK+b(JSAG>FruR^A
zNQ@%ncFs+6+Q*6YKN1*iZ`ueVSI!kk0Q#P$y+6Tv3_2c+40EN!++o^O`=`(kYAZ@m
zq03R-u!>GsM@h-zg#-!#qa&{z*OY8>zYuRe&*4je4h+nx*WS2~hPLK^6g2qAf);H1
zoDb@2cjB$dTN^8F-+Dsl9)MI|3T<(1sNIkb`4%vKfRq0Kp$hb2?qM75Wc8Wp7$1!o
z_c^4%J*mKAyyH;^2N~v*anD0e#t7$wNW^2-fCH0^o+&Z|W}Ve*gz^6Xid##xI&GYo
zx|n?IzrerZYUxvTB%*}fmCO$vc$u|}@uXNWdwARiDbJe!0N^W@xPtS;`pPVWWzD-Q
z{yZA(ejNB&i;Z&mK_Bw$jokkLeE$GSXT?o0E#0o9gZ*OpZ^v=cy-Iaq3W|hw{Y+YI
zb2HMk>&Wl)>ub3Aj%dS=Y>Kmz54CVV3$>55>2qmv9KEsMANz##{15Z4{{V65E6S};
z+0=12i@La(C$%U544w@k&pGCd?#CQfLp<B!wcp97+5^T~L;S0o@aKXqyh~vv+*eV+
zi6M^+r00Nh`qiI_w?=;y2!R`6iB}%yn(w>=YAt*nXZ`7SNPiQ@>5BE7<wFe@9odbP
zrtWd);YHv8e`!Jg0DKyusr)z9^!rA*iQ>9c8D&g{$FT2S$^&uJ9`q0h>x|bb$5u~P
zU$cqfz8Ud#_Jw^Ma!T@97Q~T1J4bRoE8EsU$QTeo91&kXYr-|x@5DF}`R$B-Yu$9X
z-aRJCA3KBy8$P>5ZI6U)8Kq{)rrxN!2_rb>loRbp6rSAYia;E7uQ=3mKHg0rIp-Wx
zWCx5K)0Zka>quY#&q`e2U<z&<9dc<3w>dwB0wfr~1Gj2SXQea-#|E48XBql)(tsr-
z0iV{9h#a1Vn4p475@<QkwE%F|zYspftK4bY-Md4!R#@iSfww$leLL4{6!Fh)vqd7w
z8w{%{$Rq1iHIENz`sKSve*(4#%P2Tx`Wo`sH4DE8_=#*Z%|u^Xw16~YC3!gHc0Wq(
zRH0panl<+k%;UN2z@FpYl#{!Pj22)raB<Ruyl^`A=D4g`M_tt;(R5p_MoxT{$XxYe
za0li^c~zaiio9PP#-|PJim{Wl2?_#w;Xtmp;+(9W7m7a8+^9a_20zagf8p$FAA_xS
zkGxrrzc~Jt-AVf@9?>mZGnc(986OY4Q+cSo`c9!ClHwKJ8@Eyc!3W;9JXhlQJUeb<
zTuFNC@<;vObM0I{giWu-c_WX6`$Wh`whej?t>Ha4Sk<j{3z+ioj52nRb_eNBv}s1N
zl$MQLBHN9T=YA6L4y~wozS%DCrF4<WC|l*|dsnb46ZH149nk`>#YvPX0dA%M0l?(f
zu?`1XjCHxym9!l#fRYb1$KyXtQ}QvzM=1t22c{1-z-(sQ?J<yyrw0cejY+XtO0ua_
z!31@#UMO_=ZQeyUj3ZUa1ZOAZ^y~7{PTF`vrc1)X++!n?g$K7o$L48rk#ng?qm2BB
zs(NrSLb^yYrCoAI9E^j5`qwip#+`F$la#ttfmL=R4oBYPcj-|=x@4D&947T$oz6Z`
zI_@Wt?}|A>=UQ9a6vEu#V>QSx_H>0}*?h+%YXUcnWMd$7;;vcEX{XN*mmS7tjx(Q>
z@N#f?_4K2VE^kM31fOzMIrsYi0D=6e@=B4$(ldonGD$rJa<k2*$gKk{?iNQMF5b8x
z_UZGQg`UaG{#~WmBoYP&2LvA6bmQwsAYAK&h{{+x6&#bEl!9o0KfGLe<X1Gt!qY`<
zhUt>+z-3aq(Snx8PeD|l>?TEx7WA_aNGzaW5Ire!Tz5MkJ}s(z!~upzSabBIwZu!-
zSjV|xT=WfRsI{CgZE~*?ZH&3V#?aj3=mlHT^qWVCWMssEg33B@aypFmsBuejk*M><
z8|`^fThOqo*UUcEVcYlT{{Th3HseLKxwvVce)c&yZZpUD3QM@ebLr|b7tcLTf90Fh
zXfo(Djn5gN1Mf!_lQl$fX}W}^+AT$+jkB}?oxEbSbo)uHjNW|hF_D7;dtpF7%DFp_
z40xXE?rH42Qzfmlwqt}Qb`MH~ct^&g{%0b7vDb1*#cFc4@3Grn$9FM|+RU-w{QHJ-
zKgj)SHLZ2VF*{sGxp9>p4_yA3u6TG`#(O{HZf)MaSN{N7n4T8#y5~MG=l;3p`cp}F
zLgsyrgY5e1k|THy(4ZDMJq~%tt|)t5Z_SOx)PE}A=ijY!{{Zlec<XjYi&Gx)5Add+
z40!K9@;1l+0Diyw8hop|4rkcvuVU3CxF2SjRxN-W{{VaD&;HB#8g0Fnq?f5J#NtTQ
z5ELAKBv&xL74gC3__;Ix09?5KRPXpkymUHvwm<v!KlqwltGW(n*y$(J@6FVbL39+C
zETr-_?Eo%5yylrbo~<c(&C;rKw66s8$Mvpn{t=%Z1{m>VUipZB@ieXB&mS`5{t~Nk
z>-&-a0L0SeUC?tr$3WKF<Dmw4aCqQ$+x|77r^j_2qOIXmGVobX2Dstj?;ol8d{b;k
zyd(briKQMN_<@2y;VHJyuaZCbicTr@L*{*s>5kFGAi(91HNv)q@e8+!?EaoW{{Z4C
zKd`<agOTEEK0RO`{6#~iznOkN<UVKE?+H_mpN(f;M|^Ls+SSlN0~t{DW5zlB>yrM%
z_=p=P#MU_f0Imc70Enae7vcyYpAy+0`(i)%id>8Nm*f6H%=<H;(=4?}HCx$lWsXaE
zn=u7r@&VfvRZRxR#J0DRzO}1Cc>!D^M;Kf;u6Bwm3ZD_Ib~W2wLvE5qZz(Rj*Kk~I
z$QkSJQw?qgS78L_1ww$M=gGjwKEAYu<4TYyDFgX9D!y3xGme~b)Kj3m(%)>62vw&$
zhslD(9Ax|EyFNxG%W2l;1(rO3!#F)fXAND{;z+<St2M|U!HxhQUZdC=wP$l@G}6az
zs<J2r@VMige_ABDvW{6}o67~;V}@V9!0YS59cTif)hyOyDYukPGO}<ofE;trziPIZ
zqHAgAiZ%-t@C%FvE0A&Rkx4bSp9BcgTidL09HwI!Q|(eiHKc>ciJ~Ewe#IORdCooP
zU}ndvTECTXEu_C`3AliukT&Fz&rBb$HGbCkT*Wkv6GkF-T(?32>q#<c{%XN2cID0p
zMp4*cew0Ubr^byUOA3h_=3#-kr~)tTh>8ucPRzvZK%*pMIqTCD*4AJ}cJihwhXjPc
z>7M7%)9zu@?QH>))(;`1T#bVpn1u)Rrb#ZFC^5>An8*@tAZ;h7=fy1mn%4a;;hIE^
zm1APLZjFxOnQy8=aV&8F+nGTGsoT>y%?4{LX~a>8_uMuLsq4mae*sHy)>?c^E2L?&
z?tnSzjwuXf=Bk$00uYSEGKX!yDue2Mcr{|m{tNUk0Vip}$i-Kkw6>T{D21g3W88Tl
z=Yjc}u#nnVMp;%kP@kBSjM2~vgIlz~lVpI9rE;9OIl&&>Qpv5^#~}_}5Sz!#*N%hV
znx}1PrbTf)1O~|&W&jQVBax5qb*u5(X|hWqq%bq>*y;d05ssgQJp@L&#9wMyo*5BY
zc`S$JImQoaBGzmkK^sT}g#(d;fyV4-*BsRU0A|zU0x*!K-ZqR3cmDwE(hFTUNxTTR
zMz|w?0An1EojA=J46HTFFz3uyQJf}YAdp5$!R=M`T~^)Wkr1|5Ba|Q<9j6Bz;MK_O
zbe4Z1V?sa-4&%;v>z;m<Us$!XOLM&=QS)Ob9I@PgGtD(&96g!0)U}yyj_r<x9CSD&
zS4aN<2qu~uJWq9q*fOb;Abu6h+sy`@t50zf1La0tl}{%G99Lhc_@*s8Ot8IsSsY!3
zAy@cvGtES~x!s1X%c#vu!Z6?8J>9+3wvx)8T)tmN9qQEH6|{d19U3NR)2NfF-Rf&*
zIRufTfq=jeDox-p8-`D8(4@l1!|>OKUqVUD*I#LpRYU|X(5irdKU!~zd^+0tTeMS%
zrGd98E0Aki9YWsjY2b!X(m=sv1NcepP->d3u8(XkE{m*Xv6WKTt4-eIyBz%f29jG#
zV!DA#=%sl~!8j$3PalO3-~%oCT}i3SBQX8>WyybB9@W%o_wedgQQg}TVUT4>81Igs
zg;l)q9gdx<TWRyi-hIIV09=kv27elNkgSY@;Q7C|<ki2loJ!>5<md>%AArRgCxb?m
z_hMVdo*SsjN`-I^d;b7G&bBW#`x_ln3klhT)8lRj1JgCC>_kk#OAs@G)X?PY7DojC
z01jG9U$Zu=F}GJQ9D8_N{{ULIsCXh>MJ$$GR#Wyw*qK0i&tK4fRoP(e8Kmh?nT3(c
zFN35WAdgpVPGd5Wk+gCE<bE{E?**APD~qcQMq4zx{{UYa4jVmjU4A&Cmop0-=Aq#0
z3;hlaFc*wl^Av-qKmB@cpW#QfY3?p{DXuSMi^^HstYg})>V7EGw5#~+u6)&!Ol=_v
z2R`+%S$Y~*b{>ZvY2agLX?t%Tt2kS=+WZe*PvSB^8jt=J`hR7AXMbtVVDo&yHjWM}
zwIE`f--<bySscaJgA((@_WEqMva{PcXr^E?2c|tLtX={TYF5|ls$3h0NF|tLwm+sg
zuFF2O9Ab`U7Dpi;g62(TZBS~mndRIG*g6r6RGK$~S4@ib32z#Ed$cPgWpT;x^{%HR
zQSVEcg^mfn9LpuLTeh(=jwdE1E5d{QYg<zAe3z?ZaTcJ^>NbcJTy4(aJw<dfUfSE;
zLvJj>W|)y0pW?+@Yyrg%QVSy&K+sN+_KBvtYpctK%(F1YeE=1(+#YGefk}+@sc!6}
z&sc-uj}m}-PT$VF`J`eBk&k-x1_%BT&lCZH`}5Q5UT}rM!x!3mk~>z^eiKZ0@t@1`
zEvYzOJ64W}=j`JH1U*u8NaaxsqE*I20ao--#?+GAP(LTuw0j)Oa^|CQ;f!Z!jP5!2
zBC_GqQe84zsHQI@C-;%;#y`fS)lq)ezAfbd=hGwJvmv>ZFlgJ$Vcj?<>q1&+4eO}(
zMDq9ffDmv{gPPOREt+dbX!a12t1~lWXdUY&Sq!1KE?l3zj1yMvBbBV=xQV>Ig<~LR
z=FhD+u$JS(EO)F{K;fi6>hs6qY4&o#1ceAjLULV?IP~I^&SZ`u^9BseN$zux=~-Y%
zWMGE@j!2@{3)sDVH1T|v_dD&0$Urf-@Tb|M&ZEpK7a;qeVO1cJZJ8yRJjKo$CL{ts
z3hJY`uuE6eEhZys5+gkAIO*$3PRMar8EvoHX=uh(c9di+c)=f9=JhRRT}ttuNWend
zg8FfasXfG(6Ew0N%*UFGAdbJ7rlOXja%|RU7HC#PZKoXbT@9v^@+F%?e9DF}WL18L
zzAK%vxF$V-fWTt96}~!UiZcjC)hrcy=kPTWzR0-Satq0{yI&Kpn(XMf1;4t(y>%Bh
ziF>6=H<<&bN1^U9UQsO1Jk2DBEbWqOq|rP<b8qF^Jj>*hfLv!~DM8s-QI@84!mL}y
zPt4qcdK!)*KvD)sBLMU@(0GSL7SR2sHx81X-I()L{5hm1pr%`b!4&lMs!~?CtnXp4
zPh=V?X8BzK+^RU;l0gSOI#gF$oYMTiX=jKYGNX@b>m<`O*ijZM7~~uc&D4%_PkjeW
zxQ8oivmFW^wVyh<e5~O$JH*swNfsrK$xx&Hu~A%HIMU>VMH4HKOOf+0(zbP7Cf>r~
zR(W<>up}^Coceuhnz@lO$q^<z^&^~Cv9s8Rq3Avt#ym0q09<AR{`)oP`+i<}SDg5C
z5&r-Pumoqyo1gd@uE)f&&o_r};<l4y%@GQ7kHbFwKN{nfvS)Q);nVc}Sz>EgZY*cE
zfszp_l`RMv9<@tA(XI3=BWD%CpKBkT_U>Hsw~u~*8sdC5EpGKiHc<^e@(W2LninKx
z@qpt$tyR%tw|!Ggv6>&U>X!FA<dKQR%5r-5Juz0{y1C7BwAM@*k->;RLPj%L9tLGk
z6wb@H1_l`)?+W5|v1<j!zX^cv^GB3Ik{6zN?Ok8Pc-3`8RR9mM=O0oHYZ&sPZ+3dA
zm(bKq$GuS0wK#OdMwwWLBn%4A9xAXWq=V|Uo2^bR(q_tx<gSsib2x(DSxV$arMT~k
z^OR2#c;Z~0)>>&ib_9Ry)!8?RwAMl!c?4jBovG{MJuoOx%m5q!JiT>P8*lf$9h_1M
z#a#*%ik3idhY}o$yA&vHf#UAckl?fwEAH-YB{&o>?(XiNH_!LC*8BfGnVGD6)|@$K
z?`wydH{?U}F>-a^uOEm*okG`RMWmqEjQBu0(D*RjS$T&y?M#BGT>kZ?>B}96j^KY1
zUA@)Y!QvEVLQhw^s-lizQPaM-`pRf`ay<*8YNH3D_y+=Q(4(7ok)dG`MS`}}UAnIJ
zIo^=aiTP|f&xEpQv#PM*epb<o_Q3u^a8+kRs}}CWK#kdL_ozPxW#(i;k}tK!cWBx8
zw{vQ^{rYf!IC)iANeMJd@f>6FRPU)l7x`wHV@6KruJ$@uY-&CgXf=UPT6r};_QCPD
zh>%}Xt1X+qk8KK?xr~~>PG7#CJWX=5aKV3ebv~<9zWZu<lR`E%Oa#7AEJAwWaFCx7
zwc7FL?7h9E%E&c*2A3NFvBb)=`=aA8GOLw9%97f09ntilB+d4*zzz4iR8!cSu6rQ<
z$fXgZ5L5beT17E`Y0<bpH`TVon#WDaz@`n!vLbbyI&WgDNLGYLzv<idex9lxRsUD?
z_=hG9V_KVY?JnY2O3wH;IR|G+nP(?x6z{MU_s63_o88IC{G?D5QUL;$S=&Jy_sLuV
zsyyRqu8!ftr6mdZO)H6@Q7_NPHL?|^8ki(`TlX)C3}3EV+=sdFlPMLHttPm+vxpZ9
zR%L_zC{}MELDBfX_3`W<x+XZ^rr&!T>}V6Um-#Gtr2O~~po#T-!RB0}zxn(LDZ{R$
zMM_b;H@M{=nM`l5H0UB<-lNfdH42<lS30=*53sv?eH+Ppq;k$+uXD~IV^@vO_Lk|Q
z>+v587VSK;H`X=GWP)F_n)QPe@IYk5_48~>J9GQZqntDLcGcn!xPxxVq5;Czk))2%
z0aBz*8>AjxjG+qJI5ms$Y-Q<Q%w%n&p75l7(!_HMPFn+s{@Ms%OEisGqJ0+z*;A<K
zTwhXfTxa*-_+8);w|f};fMQe_ElRiX#?-X6HD<<u#Sg3;dJ-HnEP>w!?!4GSZc#to
zk{O}DvEr6cK8<#`0}rbx_dxzK94S5Z3O-|r>guW%Maq&`bGtg2n9$67GgZ&^{57(k
zo=oRPIy~oZ3FgvNvG@#n<_&CTXCKv0HnkbW&UId`CFHGHqqRf$ihsv%82jMk+v2-3
zvMa7~sPCRO-r-$uXcXj^8;yEy85zqTr&>a*u+A!a`+Vr4{p8B-$IbtC;SD5J^>F!Q
z?V5z<*i_jVSbDg)N)C4jd7RjH5Jgau84Uge?L5KXM{1uZVaFq$^QyCZih_|c5A_4x
zfDhBhVFLSs9Fix!J@e$JlkMHaDTAY`!%b#TxKCC^-swQ((bG7_SwIB{PPi~K8ntxq
z>NY>u&Ti>WJr`pifHC`fmg}Y4{9@rgJjVshpDFny96)l=K_%e2N1FRNJg4Oo&cU*)
z$Y0o2nl?jE#w>J}Md&7fU~yF73u7^zV$4>Z&Lq!vI%^lrU8NX%TITBw-`c>9SZVED
zUSiYiwLrF8PReQhy&I2Bx|VR=3zChRJGs7!<9AbBuYpUdtgC0ScTL}FI<fwZ-_2E<
zq_gz{H5K~_9QluYa}}Vd_Q~gJ&?As91w&&q%y&nFRB)cZ_h5eC#BPNMDfUHg&~@OQ
z1aIEYX8t@w=(fhI9Lm{~X^!n6CaYkSVRWEf*XFG&dBj;qB4p#^+dmXKUNZNMZ(hb+
z1I3e1ErJnte<r`FNc2+L#;k5hT`I7<TO8O8%+`&d-3%ZDqqhHS<ZAf-<BYY{NUqZb
zp|FIg&BitGum#Uvt(5xG2Cn1@pQMqac#^95&9T%)ezQH={g+1XIq--1^jE$0e*pXa
zpDf2NTaU<ivi;EQM<bc@+y$8yd~5NMi9s<8`oROXs9Dew#G6!X^yAG~#)OHq1f^J>
zNMvo6l`&^MuVP+$W=K(>1Jaaoc}pr@*SYZE5x99FF_wiq*GJ^9w3rrmJ=yU1H8YaP
zJ!-1;i~pmOI97iyEadKPjeL1Po~+4N=thwJ@RZQ2Q$4f4k4i<Dl~N#y5TzTz(mA24
zwtkAW--3--?LFtUV=MI3&aTh*hW}kX*E{VibQIN>>8b;+oU6x~wsTuV0w<GVF6YA6
z2|FOOTl$Q8@%%34!N;x%zSp?a#<Js&+L59n$w#~M+v2QX)1C=M%uk+dYE^8#Pi&{X
z|9bDFr%}Z<h5{vC+HDVJ8v+<7xxW4RNj~rsx9ymIi*B4`hjhYgyyp;7u&_8}5tsE-
z)9a!5*d(0RU|KBAZvV%qpyDx+m*4l*n1r$PqNX(EM`ZJ8w$hj>L2#o99{EC;C9hvk
z^U3_geWA!FXO~5M7e3SqMSb=zJ9mQ?+8iZ^q}kee?L@u0D|L~VIKLIR<U4vD(oDl^
zVx4E>lP5v2-JUY^wLyT0I}V-{qWZ?iQ}B<dLt>KSKfJWR(7|!R0{H+i!iZYymqNcS
z4Yr0qoUhNuwMFfwazWq8aYM<2=?rTP1N^<Tzp`b9DNx|ukIJQ8c%^DUvV(mJfmGAT
z{}3xvD+R4H<>du2LVB^A9&%?;!dFOTo7%Q!`3-?0V;R}P>=_#&k4GqC3UnA%k6G6U
zLATnoY{tP{&DVcfs`|Xz!Gw}{k;z(hsN)tSAlz);s(68I-Z=^Pt+LUrewh*(siHRy
zE0DzUbe`kGPp+WKkHeleW5q(pGfel{bhI5TS&-uGx`=1kWQTbRlAve4t1|v!Wrm;%
zIm0Tayg`kNG*a-S4?^YE3WjfN;hVOqy*)fg;JW(-VFC)$6D-C|)lG9&GFe8CX`#xn
z(zv}4&)3^4oRAW`8eiycGYaN=&U0wRENT);wXc7uOnEOQ*!AoKA1Vb2&-B#>ZzFD#
zUjwkoH_^5G&oLs@PN{=X9wR#-PqCb1l{Cdsb*g_ADB=VW%K#$8Cb&IRI=+5xdGXtX
z<HB&S#S~T{GHG%`wp`8^bxb>(<u;t0cID;T<}RfBm5wdSn2=2ORZ&)73c;@D4=f|%
zEvQxgr3b5Cc=jw5{*p{CjR3f#vCy;wHR{~@zg=ajT)a-XZwDjtURLYAz9-cY|K+>M
zCtAa?sg|LJ`K9YP=?i@J_ocfmJDH>)GRY#3TB{338P(@fulAF1_0E#pWH~OuAJ>*L
z(iB>{X=bvE{ZmNL9L`7|vO|eIj()XCGDgRuGSepb?NI5^nScLF+J>uClLnqAs`t3T
zahMa#R&nI2rrYZevz+Nz+pS58{l~Y<YNfV~w+(8IM^g&}^Fb)%IAA>ADV8Q)8y~UJ
z;MQ4C)9d^`n?LU@7G1_v#aJ(hMm%p#Aay?sYF^#YadfK8Z%V{U<$XUdlzJ}u%XhN6
z@}uL#zw~=mTUEy--(B6|vh=Je%jlzMeu_MQ<yp$$f(wQeYa3kZ?0P!I(;y<fA@}%g
z&lb=XlYH%RC5uIJ=fH>QQq~zaQL)=1R*9E32q&cfhU$^rnPC8?z0`adv-UK~u6b4&
zMc>fWj$*<4%P``rSJe+RrmafUU#^pTCODH8Qw8Zpb}G2CnI0mpm>#<#ZpTXht`4Y|
z)#TQ$^2pID>|^UDuUq|fCJhbMs=G59h1z+diD6C78#Hd(qGI_SB@fd+5xId9iC%vT
zAEcCBxC4v=BkR=|>QBTi8rs`J)oRmDJQk_#^rqvLnZw_sp-gjQt+b8p4VU=QhU{Ey
zcz=aU@L#4N^`a|nIuW&;D;b#KIr|q&gU{KEc^_S5lC{x`+-}{}{$1fY75X>P7Ni-9
z;?B{1Ej)Cwv%m4RuC7kt*OxKAUo@=!VD4S!&)n}Q(><4p#G>TBANeTWPlkb-Y!Mnf
zcRnf;aw6```1jTW6iJf2{{3gAC|}{y*yDBr2?wHByuM5TZPaom<EQPCJ<7f;MNU=9
zc20U4wX2DW`%V?F1smWPepZBt+~koy1v-C3OQu0{q8rP$chq;H1*K>Nqed<Xt+`!~
z+3T!`L>)1MIVLe76f6lsi=#ed{v((Ri?Rg+TT3nnWN(5eG6M}lE<Y)?h5~<1{}edG
zqGPM1yB$B&N*H_bA{y5<FYmt`<LO+pTltX|<~fIXJm2TmD8`!!ywhC#%w?y;T4WGq
zl-!FP%Wi4;1Z0q=8(N&0$24`3qe*P)^Q!sXBKHJGfoZx0qYWJw@Dw`v!(9e-0PX&l
zNA(M5>mXuVHmKb<SIWKUburV|CH~}V5&6xjP<5&GyX>%!X~@0R2-CGGId&{oV50R*
z-{$T`ccf!S%kqm?{W`tgz~i0pCYMT;yMz(>B(3V_nylF^{rmnMy#bH7Sem@TTLXLZ
ztc1q~EI(kFP8i^v7@DB4De7JVR46fG<10(3GaS(IBbs(cI9Sz}$!-`4HhEf_A$HJk
zJkwF&c7`apltK|ZLZaJjuo~Aa;5&Zzab-7+0|V#9fiG;80~R8Qo)iaSZ=@j4g)QzX
zkBmZKqp!ULh$nRGs{#YAA``NVJREZNcWCHt34w|Rr!LeWo|?LXbp;-03Z#*P_J}qR
zr?q&V>W)!1(Sq?5eU}D%7u{z@#XzJvUvGnuT=APEw;|)HuX$E}hUC)7NAe^Z9+9o9
zoBj`Tka#-$0!@c4Z?8oJ1x~j0+{sHlUqli|B~uemDi<~yR`Yndl*mDX0uv<qE#{ZD
z4|{qRbP+bd1NBzHr5*03H}I7=BY6I2QcoXd7o$=?|7GlG;k_RTD<Y@iosx)WD3yp*
z0^PN+Rkk`CL8}~SeIW3Be);RXG+F(hK}M`y-T&KNHW~HuC-0#Y`S9U)s#q*GyRiFF
z%3BJMFp-QKMpqNnri3SY@z!qfZIPe4+3f_qf;K9lD%kChT&s>k7^Lo(=v2aR`cp5w
zfQ^;0nT+sfnq&lTxP+(3;&ngkp>Nc>$;`1+<@O~Sk<<LW{~t%Ms3ocOXS|))(L})h
z2tJ9A%UBWyLrp~W&sSa?9WstxhY5nEFYj6vo<wpMbCh<#C3?i7j#O#~A0EF<%+I+S
zB13YGS>)?7%3mf+ERzFnMIrZ;gHvBRXX;z$e`&;XIarEVvp3a1p|rMsa)Ib+nW;c;
z&M+6On0-wM=e)&)n?V3UqM~lgqu8dAsak4$hDYKR@oYTNQtle@G}p)a*P;FwWnClT
z0u*YZyY=5PdFZ_~9vSbD!!Bu(VXu$sD&hwlOT|1(D;&OV1M4;R#pjuF;m$5X3!M*d
zO9Cm_EfTAyul<Q+C!I!nsL0&j27MG<a#eUblrzfIdos?e{lNs&e~V~&*No!eUZ(V`
zuJvr?dtSeiN#2$MDV}cP++{f(kx?&x%+)7bUD6#1?%k91)){v)>DhWWPv=cT^yKVh
zCNm4>cg@6^KPwI_SnHEy=oJ*-!obq$E)XNS7*#*}+~h54x5H6S$Ct8aw)Zuxv~G?Y
z_(ZF=3()hGzMQ`8Uqckmb~Byl#!s0<Q<cYYWvQGs`UGxOFg&d03TuTK$D=FLw~I>5
z|EwfhvF@7roHiamPx?{hEXp!2mQTq~Dq^v<)<}TI*L7y|mKG=ZN*_&$3liOYoEg%%
zyP8nq;?wDTkkI{>>(uCqZ;SR>KpYB2ZKx%#HQH*uxtwpozRAaklfg`1z1*=2RZGW0
zmMov?=4sB(b!%A>#gbrc^2A$1C*buc>6}@!rg2+qXQ*UTCp5p?`3KKhe3M(u%1nLf
z;W$wS<<PZ5Zn%H~D<A=q?tV*>agKSwG;=kxlAkLCdHx%(eJx@vdUw4wBgsz&jAnF|
z*SrYAlbcN0vkLJ_)NDS>SRT=3r&$hbwe$~))-7D0yDDq;)8CK>J<=%ZuXD?9qkjRL
z(u^vJEXb^jc`bg5TNvbqEk^`;hlr`oR`b37Vc6Xw%FcFQ%$s7erm5gTWUXIl|FGN%
zWtego`kf;3<2D@X@)I2zpiP^*K_jO=`|<e5d2)=3{9l9?5j)<}GaK~wX7n6irHSZw
z)TbCjQOjbaj!1j6YV!EWw79q8gWfNmPkM3q0n=rTG@~M&BzB2j{Hr<*8DD-f0hM#O
zWiq+JKAMc@bWx6cV((82!pkcg;H<hiNGXl*ZP~H3UhZ9B-KV%$C&M!2<0IKH?_B+k
z23tSSFdG3O7}<jVhDprSiZPtlJ)L(K>FCt>Xm~2QqQ^k*)-Q5ZDHk~+A8+Y@0>GW`
zSF2zjb6*Ury9>7U+VWPyX>tlW^PTf8G=A<>Yiz~-tU~Tz*kH#}!%F74+s=G~4;r~4
z&VH)@DTnUzjgAPH)=FZm?fkaWwZHu>^<Kw&^uS@AN>NLzZ4|oMhTQ4`fxF7>d%{KM
zn9t}P>K4#V!6%V9nf(1+Tiz1EONrnP)8WQVz1aohrK+~yWOl4f)qB9S$*Kuwon>bo
ztEie&oj11~^{)2KqeOCgjj%Vu<bNf#k)X)zIl3DKjO^x57PKy-Fyc8qrwXS!_a+GS
zq9<Cr_&y@QJ~2Tlx^0g96O+@Y^*}ay!uJg|wp+5c8gEzK^O$fJ8>Y&Sk9O+(!9<J$
z<>Ask9%aM{x{G8h>Q8ca_QlCzE$+?s?qDW1L6PYHLGl&XsmMLcWW43bqopBN=r4J*
zS{Ask258u=R+fy7MnO{uN(Dx0q5+D6{{Uvg9Q`7;8_9C#PJcj?n7>&2t9p6;i^*d<
zKZt%#7^5jzAr-(tVSHDjbg1;pL#qV}#ZRv8rZc%ZtYNIK4XSVre+kPv%LXe@>C#|>
zCKRY~Qfy+BdtIEKwBAFeX3OFa6w{Gz1z$xyvt2raFf%-SvHL={R6nzI@9fv4Hw7D?
zvtjmMzCFr+y%3FNP7XN#7!>fMgwn4-B<wSa(~@UJ!mLeRM+lgFNs)3)B~A9-q0=pC
z&&;|zbZrf|1e~HML=+h7?fCL@UaS>x2b!>FLz#(Fu&^!*hCOk{2>Cy|YCYT2TG?8p
z{WAP&qm`2oxy$hfGH;dMK~H+q)`K<LrQkNVSpL;3<-KjkKk|3f_pTq!W?~)D6P2SX
z>-9qtGm~>->~@?~M5q=Tsxfo(L7b%j&?1y+#SVWY0~Xq5{%w+8cuV^K9TXefDIEwa
zI64!vm(Oc>f8hD>YTl0vAN|iqx-&-O$S4l$8IZ^?B@OgR3>>{ROKyqDW=>+Ztk+2I
zmo^JhnH<bijQ$Y>C3#C~?t^k@<a$@(sr`SUPwCb-n5F*3zgkOueZ3j$y*v@j%12-{
zT0s(GajIG7MEQsds;|aEp;UQ^90$V8z_dNbC*8c|vQgsE$E1~i(yvTEi^PO^jY~73
z_~f$bS<*rl4^=OZ-1Z=pjgi+uE!8&ks27r5_w4`)#pydY>UiX&Fi4+px)`wgn<T&F
zaKUduuN`J~*6L`4r*MTRxAsE4psFM`LO#*-X0E`{<Z|;xgT(x?tUvz&K%`sNr*!*9
zuoV>#6ArqjMkD|N*_-gJWF&dg@f9>(XAtknY{xgvC%-C0`Qw&BMzxraHXRdyB)VyU
zS!1@Uv7I=rs#_`Qo5;mWe7PTVGwlsHSE2)EFQK6$uK2ACHw>-MO~p%wCJWDSjmYuF
z7osQiEN#BS?VqVLt4uFsceDY#ua5oiPP{c5R?Ask)D#cuKcX!6mqYS}SGuR!&Kckk
zB*L_OwD#Vun@Jh}-86jHR9CfLxa7=J)K*&E!zMPJXt3b^2jDXUCo~SjW`2({BJZFf
zC1E)8AU(jJ9XvUcXf-ktv1ea;mKAC6B2{EktRhZ2$cYT_!hRtzG_VdTFT>6<NVbFw
z)JN?~oKh}kf|E)4WMi=V8KW^tWWAc67Kn4!6;|XtsIXXDhd=4GHv0}IGJe1j{6s_I
zi(_L13Dt-SCO-X0qvDtJE3s9qFF{AnF+0VW7C^>AQl#|OYp2L291I5_oMybUf)`iX
z4@`UEzc;k+R*RP6pH*=G(Zn*Jc_Y&cM}P)zsUFT1g~WK}A*ZJbnSvWZw0#!nn!Jgs
z*h_S?c}ShLB0!P^BCnVk2?7ot{^5lpnLuCLi{;gkv4;q$`w7**iK76%C^WRRPlA|9
zYtRWKs~7~BF<026GjNTQ;*fnETL_w_u|YZT8sFCR4jo>G&N$$@br(7^5Fy%e-xhL&
zS9cfYuzoKldFu|`Opo!C^!8WC>vChI5q|cWcIqm?-W8pONgB@psFE7nu^oPNOjEn>
zD=!Vl_A)M{Xj2hasItC7N1~ig7PSbF`l!({-uOREzrySQ50ju6&CmoJ)P_1Vn>o3x
zYpb^P;635FT)SRM&M}{RtG4STYRU^<{Ed$?vt1I9hqz;*-F6W=ZW>#~r!K3c;5PS)
z*EDlP&Y+$`&kGVkO}O0`Ix!~xek8nW6l)@o&6@%gj_Gr$+SBxhMNrIUaJe6-SbXWL
z8SjDs>2ZN`AA8eG?h3>2FK5G*fnr5fMt0jU?0qGe3kKKHVEVb*f-ML%0FxJ_$flLZ
z;Og?-q)pm3O`56}?cWVkqER%@g@5=TY%r~3n-6jKsbp0NDe>WeUy{smDORJA9Gj({
zs4<fN2k;?K#B}xfmMc=QrqM^19-Kz??1E4{6axGvbfSwDDazwi<iT>XqmT#2kMe^T
zVwct?#zXgb)dv%h`i;0TL)948F4#u5wgGY~#i570b#73z-%xveNgo?!oXeQK3!i>*
zPc7J=Yj9<!isvwj4NC{8dKEBdltc|adX9L$<?$Lq*5^Bs_9s#mEsp8FQH@cA+%BEr
zYz7A4;Rf=F&?Ym_F}H_VkdMmQeaDjeLlv(4zJ^k+lJF;{miLo%9D^{u-EtPEO@5}j
z#-v)1{0R6J``pu-R^XR9LCh6VR7mo^rd%7#DLJ8VyrSz8ESZcZDrI(=iI7Q=+7%lK
zj?`4Tu_5S<O5)y=+}8le`AGL|X*3;4&!#+u;(GN9Yw)#w`T+dBz|A9!uNYt3@1x-c
zYtv{VsC!#||65vNobAISNaFGj@5^2>mI*%bnb#lres5r<{B!_niAhd&{d_il9jhR1
zb7^>u&qj$I`6~wniSx6pv4o|ZRYvBt(O~(}ePzyL{hE02WpARrf!~B$u_EzEt>Fgn
zF-0@}`pGu6gRrCX@qORJRk^n<cM3CiQLH@j-5MC{$hlu1!MiOIF)(z4xCb>D46P_L
zJc?E)X6k*TkB2{fdr4lT5Mj(zF#fp<o-uE0LPCm3(ECVZ^aKhdyBXuaYVBH)J#PPa
zlq^cx1jHQ@l~+EqvWxR3?_r_EAeAd&p>*s9ibjNZ-3Z#9ct6Qk_s7f>qL9V8>)*{d
z17nFjw*r&K%f@y9<0ZrA)RBm{zmcRfv&2DUP5VMN&0$_+sN(dAKb}0*PcqVkn;bGl
zXRur|jdAWD*TQD8<8)6^aNrYE6>B<V`<mJee+*{pKngYrAR{9>ATvmw%Yyhi-{{yR
z4r{?P0fW0N#e9IXP?g_-ma7M95L_fN@H@F&Sfxz-^lZ%G-Zs`hYm5j8yz)-7lCSC5
z$p8%<Ivk=16Ut4Kvebmj%~*LM**Lm{e_r8|eh_Ux5_S?2qU|N2O<i9c<*X-F`OLc_
zl*&wSA#@^vH^buv6GGh>TO)MA6q^q`D!eKsGw7}lSuw4Z_nTSKrC{rf)I3(anD+o{
zcZPlnAWrSQG;NDRzTDAK5}C3PiE2$}^`j?QcBwu;{H2Ga-j^@AgkPLtVYm$l?$kTE
ze`{=jnZBPNO#g6G;_3x^N4ga}?1Uo&K@4X-zrM;JrQiN!n}2XAU$bf#&)bKO9H3}>
z26{&z`>i^No;e*_y7tLLO*}4&m;o~im4C~tnf0D8g!X17Ds8>=>6??uPqNMgI7p%|
zH@OoKSssP64|sf9z)NM0&+Yy4etbbRzTSv=MeOiXaArNsPtGC8ilWBFW3#|VGjN@`
zo)gY&)`SJ2Ey2GgNl(hmXXkw5wzLy7)G(WHs!p2uDaL@8P3SRS3b8v%5?1lkW-kaK
zluLV!%n^_uz!%=GhPuraDw-aPNbQ_tNJa%c(ek*6x1Af$a&wvCNMo`=4a#^DgX9D$
zPRG~`mF6op@bXZ#fTkzA1vXWrqV;c@P!gv%Qf(+oOcy@$=JahyPkLL^z+Sy1)!6Z$
z8!6x>ICxEnSQosa4`c&0cyGkT_EK9+mJWLp^XKd}aVO-uh`LH5vpN=!(ZJ~YKLhs0
z4fs%dicA0ie^$siiPEDE!al2BE{vYmH#2KsCQDfK-AYqni`(43VlN%cO^SSL#$(#i
zGl`7gWU=+s<M63S;HH2FN!@`Kp{FeG&wfX-z^cyeuq&Q+B$ij{Gn4Dxx+=n~w|vuW
ztF1$_qPl*`#TzgCgOdDE2_|+>JY7zdn#qU0uEc%cgase@ypWt$7vp4sA@rrSQ1Inj
z8Agt<25s9_k?eD>Fnu$$6<QKO0h()XR7!NZC>bc;d8^9Z+#jgO(NzuIsC73nGZ$l9
zYK-f(bMnN3;^DYuLi88PM;NFnEHI)!zs6I`2i2p&k-_Qlky$5nJM0sFMMD>*cQKdC
zT=J`ZY7sgMk@R#BlW^jwwV)w27kq}=taG{n`*opqx86BVpEA#zp2>9`u`H_=(>Pz~
zH$J@N_0k{LQT0?&4&~^I(!DnLBWkWH?haiOc@`u&iPfAWQ_5AaqviK`>@MCs=v1A;
z)gYh|*dm4Ro0xWlR3Su>HL8MxlXUl3df}ZoaOZz3LU!eAT6siMs_M$HSN?`bU6<qT
z{E8EHFTlbm^wKr(HyKh<lssDykw~{(G8J6I%Z9AZwzeWIBvz?|+O{4v!7W5EUJVc8
z!h8YdzW6>b=blC#Pu_}hYiqu?@*Pywi}GXR*gvuP+f5-GE3D=;1k-QXB&CRt!Vhd5
z+rcrVdA6&qnqRR_0%u;1{5looCPBA9^X)(2hMjO$S!NluV2e)ZX&qp&$MW|dsN9mq
z4Ll17quOMt*0#i2G}T3DskKxD1?#|g6YM_h#5jOdvDv5?C$4hVzzhDr4D;SN5`?R2
z^W&mj6)h@E$!kBp=~(F<rq&+qB_G8?qsUp)d>NX$jd-M{N+lP;1Pg0c)GboY>9o{G
zSedq1N<uWtsyjTY1esiXW7NbM>ET|>(2bN_#+05hr0l3Z`mgw&B|3gS_*<+{Lqv6>
zh!+Lag{?aU7~EuC&aOrbsjV%-dBq|Il<lhY%%3+oBIA!!sSR5RI)2bD+QbglmM%F1
z9I@gexlTiXO`!t5C3@<CCiQU%_@?};LG3j+WhWnqx_=H$pLcQmv=g;vXenT*J9tlO
zBRHKW1e8UzD{)BKY-0|Soi~EI^|Kdi{s$neB)0w?U&^LLg+5h_3#}D)(xq+M*H!sP
zwSly^yqLzP`hxi5u^R<1QI@oJ1!*LN7pL5R*<8`5>JpR^I|l9U!?%q%5{5Z)M_fn5
z?6#&xJ%+>wpz`yrm?(^$vkj1m%^l8)LYn+U844@j&|NSXb?qrHfJEmNV<ur)=LeA*
z;Ve7Y=}{#UmvSD5oKN!@xh2X~N!;=f2_vpFmkU<AhP1;z)W9h1i%t1S$|q^%D8Vsd
zI=j(CjjUUby~WSsF1hGg<vI=1702dYn@oNG0lf8GWR0dQlopG(Q{KMC#lQ+5RVi;e
z^^c~XlE-6m!8bY?q&fIg5$+2i@G|1iA5TY+qm^_0bj(oTWD++o#YJ0YZ^x+)lgy@H
z!--bONzw$Cef#cPE@qzMZ4FOPHL_l^)RidOcM)%>$`y!5sx1_{$Twq7x?U$BvxP^s
zk~!QhQ<i5eUqRC?R_Ui%K_{AW2}@jq%W{%PzvAWRa4Rw3{-_UL{@PZY)!zuf-hY5i
zqq!T5J`K!fjfS<gfhLAV=oF8O6>aYTOSwLbC*HdG`l_6&oMR#Okin5LNR0`}9A@}D
z&xGSQM^dJVyEmZaiU(%962P02!PUZCzACA~6}&o*Nf7*np4xLYiY6!ZrN}5bHQ+cV
zhR5GCFu1s_X;nA*mRkWeoMNl`h@D*Z3qj$J)3@DbA~zM^dsE(cd$fd=e6sDaZvOL?
zlMkf2!{7O4ZXvv;Z$;1HOyuFEK7*#YF`etkaXZ$>q#}F&Vx-ziemV{~SSdWU=_sRZ
zymrKy`rxBZVT_}svGQyEd;6Es>9Q}4ZgG8<@ki`xx@XUsS?jIw<eUs|S1jB`gN+?N
z*1X37NCiW`kz{P-k4HLlON0gPN#|xXGc;?+icuid=V69f_g|5p!p6GM>)vg^qCEW-
zGY6E1m*ioa$A&vSRA7y2AmtSvc3Ivrdxmykq}tTA^$-0vo`ct-cm?Dj*MzFQ@<wv;
z`?6)e@|iYnn%sLz3ob~%DRi!kGd53tpQetjBH*hQKwvfvbO;RLq$l5xLXZSZ>}-qr
zXHtMLg7blmi+Xt_fis!e@q6}e>!v?m7}{6Vf2v<HTm{JS&Dh=O?7wD{B7{o@>F5Sq
z=sl?m=Y*qTcB#WRNXou`8*C_4*{C1kww|7&@0$C%5vT0pwuJP1ZT<8)HvzNUm0h2$
z_I#4^Dh!e<XJ%biahqS+jC!~Pi`nX;yL#uJN*YNPq9#GlvnDfO>61rdDgc67aCiJa
z`8_!j7rRu!zI<jH39sOiOuSP&7uwYfEjvZJ*VQ~>U(Xr3+GFvys%v$w-$MU#6}mGx
z5+0izgxWl_bxf!NRdL!6@=eN;^O+U%Rm2ErZ&;WT70GvlAGC&ut(lW}c7xLfro+%?
z<KR-`?efR_!RjZ2)RSn6tA=g0jq;zt+CG+6d9+L&2zmGuW=-@pXt{TxLA&I=<wypl
z<8rRy3!w<oa~=7F^&g;8@|@&MNZj=KQlGkc4WhaLj1jNaz5n5h6F7u4p7$vE@b-Bj
zu}H|3@}dd>LhNME7xwfh3mId==I}D@7c1JHtczcaeRGKH?=SZfoAN8n9gI|8{x_$-
zn-wrg*EAF>diZ0yga1XXy81uBE56fPhRx^17f|O}qRG}%9CB>K@?=j&SN?JOD)*2i
z@P}A9SAX}p*onkUFH(V%bzYD~WMcMmf{)Z!#9Cx}jiTcT{r~HF?lP|++cN*RE+4ra
zb8hJl*8bnAfoNj3{99&!uVXq#XnRsE>|Y3ftpvK`KVJm)!|xPNQ4q<1C;Yovt}$Dj
zFV+8d&!O`gM^1q~njVJY%2+R`f&F>NpDejd??w6FLcB3q!8LpXH3HrHh$4+6N902H
ztZPzaW$+(>QteLB83ieaa=xcKFLT1T;}+h4m(9F<dBib}{k>6I!)+EyC-VYA9`mgf
zUfT`-jXb6wfE3C@GOs#nb??KkeT-vsH%iOga0O`*Pd2oy%~;5bIFs1a%Z<ZF*Hr!R
zFpB&SODA76UG55wvaa6-$UWH>{vk6iUweWh?*h1(hO<k4DmQEQAAtL%QmMKWvhn&?
zsXo2e2F_s!*z4Jz%7z*_Z;FGuW5$ME#*F1{3wZO&OLObQFklx7ZA6&3vgx1zu*yMD
z+GLC+$&R{kOfM4VURY9?nN`B;_+!TGTr;6D)&rq&JEJE=y$HrYPY_Vb#1*0uPM(Kw
zoBWQ^?}%1aKoG$~0+a}+r)f#!AY=Hf&<|8&S6U2Kg2HU7jNoPmvgp*C^@1qrKAJym
zUjND@k$V395$)OZnq<x_evxG0&hYzw<TLL}PD_`X&kc8Ak6hySmk-%yX8__^<K^Z;
zr(70l$^#+!E{j1%h7g6TTtNqo5br<lV!t5m;VuCYnIn*K_0RH?j*iiZq4HlpbYFCj
z3U0yXE38(vJK`3>jr=19TYZ1H{~1}*;?wLqxf?z@=Ge}>;~k`0!meR_ed{VV?(>VX
zOtjKIgQ0l5ULFOlsKS6oPT#$eQ&hfIo>7M&;!PZaG3$$ltbgebXXQCo>M9wc@QX;?
zUM9K%R@c;PTdvZFiTx@-zin{vCV7RGiq13N$J(}o1n<8k;PW*l3P#AA!?~ELSuQ6|
zPKy*w^~V{VfiWq;+@#UJ3AUbmu0WMFH=~Z+a^ru-OF;8d;=egE+y4Q|z+IeKh^rF&
z4UylSx4#STQ{-a+j3QOo5`Si4U|VXAtqRx(GH(LKllr=>oX0!%c{^#6!Y`PrG(JQI
z4YBjaJ~Z_6->}@FqyBi<^b)PlbR<iRG+1mO8@f?!rxJyHVk^#(Pq~eDzxa%ddRGM9
z!ztNI1e;INcZ&qDEsqG2WvVEXc&cCfNpj*KLB7+fEm&Jso1z`A4)fJs<~<IPv;S4Z
z{N09469B^!#mfj(9I9&$d1HY(q{*I;X~iQ9M@HB$o!KsM$;bgO&DlJlPua+*V|odL
zV?)NDCmg+6`dmyZ;HjfcX0a|*@j{y7_n~@BM8243deArkmf)tds6}P_*QCEaCGYF|
zdy~xcP>GAt;g36ICMLGGuo@*taY|8<Zw_Yhch|K4N(kx;IrqE+W<ahVsXQz~6Zeqe
zFf%&WlkcoWUDme0Z)T0q`Bdh-7Q6gzvn|tqyj#hVwfp%l+40v=maQ!*_sD8%Hw!FT
zOm2dcaYlTGIMp*{l(KOwK8}amzj>E7V?Uv{xGrJi0_C;%wzxIDC2i9KT-6SVxr+XJ
z<NZFy#Y%dwM2`G3p4>!CkZcYEeLR;EVfA(wAOS3RyYYj}(%9XE>C$l#GR%WPP8WqF
zfliefY6yI=Y>F|IbiHuW5ZS^L6hhQ%2uJ(`#atp>YVwrGf$1T?qz(@+33Qo-9V?Pj
z#u^C?RU=fnJ&L-8p4q?(5;xyPzKfLFVqTCKQhyYs72YDa(}I1JjVbmDnA!2`3m&?;
z8CUD&i%GO)7io)i`?16WzywPL9@sRcDz;9Og6+e&x*Am<Q_r?0ZC*Rum$VIXC#;UD
zLr<t6{a#N<ZvV6+b1_qp{LODqe9oW5CxR@DSyC_FsIi4Ng3_;=zmb1UWXy7~%1eAC
zA(4KaVy<N&xFDo<@xkUzWWs?8jR~unQbM=(s;!*F?!C4fUe%*i%CZc~P|11xz<Bk*
z{uJ%CqQ8u?Bg@fa1rERj*pnHyDIsk)v$=mmdUI17E&skix@nDckWTFv$s0YZh%B0o
z9RH#oc_YGhw`*$inA|+0e+oh|f2{<i7njm$y*EL+d}>jXB9uIPX+C+Mf6}11YP%wH
zUIxSf0E=uAkO4`XTU&^}UbBwS;u9CS$KaM{{<Nc2QwoKdgs4>YrA2~ZiH20E5{Jf{
z!AKV8pI!UV7rD!d>jQJ6L`BSXrto0n$Mjm?-C(#Wk^$7es1!Uaz)l3fHV3vA1QfzA
z)3O^D(oFjv7l&~B!oNVBEJE*Nrdq-)uI?Gw>oWu?_H4{Q816TuOi~0)j|_icVZ#4`
z*8TKG#j`-xp9wYw-qvOh0&688{qhoz%x8oM+mBRAEMm;vXlFZhR|sn|JXiI+9ztLo
zf!rl#1gf09^9}j2j-<M=AtQCN<FW)!=p!vwa>zKdfYqnXtRGdhxu>+r3OQ}z2`fCL
zR!oHyh@qz}hj@91Yx=T@`@s%L)mx0}M(Ql(zn7?bR|<3t8<MCb1XoU&>*Hvmz;f1a
zcLh_E<8BPuD8??>2*~G!MPr2fjuInJm48=*<d$RCgH_56`>Eh_20ZC=qtV+gYJ9|l
zhA%Yy>a|tIl92Y7TMroCax>DB{7bgBrR8#%-?fbkh;T-<YXA@FtYy`ipGTyYc%KBv
z#l){oroOZ^Cdj4-oF@F(6StUKf&X|TOf9vd?($;m*c}rZilk9i7EVS^Y$UuQDDWFh
z7_GBTVtsZ~UoI$`n*yP<rN7PQ?!Fgq_tazz)g)m3_<?l*BSK+GQ1rnH{)1?=pigwr
zIvq2y)DeIx4U;&{nk{JvXS%3!?HG2)8t#8Jc5UVpSi6d>dUUTv<XTBLcvhKyM`Mw1
z)K+Nfr@Xb$CkaJqbQ!!?6Z5eOd+KV(jCCf^QBYXWy_0juTs3eiE|BwPY+dq}mY)^1
zNRJpw-||GttvD!)G8rk}y-rw^zozlthfY-<ot{`m#Z!fUP#wb}WIgf6pz%cYs_T0h
zuz$y|J;*GTWptjPcBn6$8O0dHu!PU4m5ssUVNGu>CZ~K`%1T>`F8)bfuqUC6KTcc|
zVQQq~l+EW>7;^Apqf7ORqJJ9^&@>(}&3=oP_1EELyiyrG>;xL*FaE_iZGK?tXKuST
z=k!OK$U9xSoVHLs2ERzXW+wOhl$J)=z=;JABd)ohTm1B}YjdSG_1rXju17y)VMnA0
zn%Y{O@VWUuQfTv>xY)w$qv*P8E3)5(U~+@4JhL&?)x~dq@e*(v3h9;bR+W&Hp!C)I
zV{VbDRE%yj#O?E~tNay9)6|v#ui9%Sr@uwu6LM0ftO`3`+hRu~xw~ui1H~KYOGKHH
zw=INv;^&OqhrV>P^Q;{<`26}MilZbv9fPWR0CA@&P2%WG`Bc>={ST!p@JA67Z2sl_
z!&F7tPRxV-pEMG%(FeEKLMPsI_fbC34`W1Xz$i0s(wEE_q*xyoC~R97yque`Ba41?
zAAzY`@rIj;R5<=!_!&91-!5H>Q0ZG4kkg@9mz7P2HkVp}n$!UsnuT3S%tAbx4f%@D
zf!v;LY2iPGx{5sNk3-__LSur@Si6$w1|9|RvJ@@GMZpTXUow+HHv*d7j&utVd*@9j
zqE&2erxVxL<sb5cvo8s47Py66y5M6ql>MV58Sc25didP#$m;c|vp8qnLbacjp<XM+
z6o}ASMsCgn{+m=XNM4PwqArdW%p2*Q%g~#0*s86OH@=Nu$?0s8XGUKDjeT#{3lNj|
zIGg&JZ9(OWne`$l#*=2R%N?x&L)P8Cus14WNAfZKSmGOXR`2gWVkf^Jg|Z$c2t|0-
zcEyCRPF2acmwCM#L_%`k>`stw{s*9WwxPgEE|j(Q7zX95&crtjT~0$LbAh(%Lr|yu
zA$~cuP*{c->&_X2e4&y@>;qe|P}jim(qy#7$L$OTN!}oj1mVr8iO=XnfmWC)Qlclu
zw>%Ys!@*0CF^MtPMI{>kjrHH)A1xmQ9rFm_%G!fWqu&QwEI9JkxOxI3J$!u5uXBV{
zT2J5#i2+^?)R%W2c^LM-Dm?NlUMF1GvN{f#p#a#*kD|;~`B)kq@92e97W7PRNc_WW
zO?AZ8VtJI_e2}qJKet%t7#kzd>fN_Czup~7vDX+Zg#~Ksl5bULGiX{2RXAd(qpO3{
zGt+~SrjU{vncR|E&>Vp6t*S7tqgeaFd~*IzuJ=>q9W&D0OOVVTw}13HaJhhQisF^+
zx|Q{DJzZZRXzNfiHRbRIcZUp_2%wvdg*5g~BW1JP13@J<s3-^QBFqX2YDf7xx0(}~
zUI>H5SjkvPH4clD2Mse9TdKgXUg>MkH-9YHqa7LI=rt!wu1F@p5*vmafwzl=lg-0A
z>ds7d-60K9GzY~`EZ~p-(>+jcC63y2oPkMP5j!}%_t(Yfmk66*6ksa)%^hkBimSo{
zAiNQX?l;dzBwv7<87Wvk#!y#%BKtm?rII*@k+AekUJOAZEW<a_Z4P#Wx0I+Dq^h**
zsUGTg(TrGS^!$+&SWFPf#Bj1bH|)(<VCT6HztBb6)bxse>-)eBnrYe+>9J+}mRL_U
zt|<jTgA8F6+2gd+=7lUp;>mNZjEm7zxBy(BiU0O<B2w?BK%vmchJRAUP`RIWX=uQt
zkzPXAS8n}bRm;HIf-QQ@QiqOvGi_IA>|s&eJ=9C>Ly<M|vNBm89FJQLLclHB4Q%?v
z>1Gc)<ugmJgUwtdBoP9zK$95}lBPYbQ_(tw<6C)1LON~$-{4)%pQF>s4Q?IwAVZo)
zyv~W4ANAIedapUBMCpSl9&kE0v5&{#yU{4`=bZ4QoSl0?vrsiH2z_Zygjh4v?M*Su
zXR>YdM=fBNWkZ7IlOTfceQ5;FB>!hx|37wCQmoSE=!9}cngu^+8cKqIQ1iOVZ?Vxg
zzdS4`gqZMxZb?YW<Lsk`6TJ6qG^DI}#wJ?ICR4RpNcLJxlN=cI+^WGCU+oNh_@F%R
z^m>rN$_Aep)#_F`$|Id(pZK8pZlB7W9PsiD$r&-5|B3R^gdIa{^l}9`=`?cZXZPa4
zufE(->NtdWQfsl8M{PnK7xiA)!iIkvsWK-yNQzbkXn5kOID);XpV=Av`eIR^UA;f|
z!f(O}mR}udPe#%bGr`pV17vtS1pjnkc@#et1pncOX3TFi`GeBElq*##6Yu6cJ*h^m
zIn)y<rh}xq>0*@|tyTV?(M|f5JAnt|H%^BU#n#GExD5PIxus*;yjgFv5pE$Q%aM1(
z<hd(Irx@#4AGL|X4EOMDM7zpUGX5NC*`!jQqCw~JYRuRF!$jBM%*iz`6={R)VSHV>
z`{}(le&mJf3VYL~rVamYqpI%1PQ}6OLr(wWE*AZN05U(wLdhMvd?s_cyz7e0W#(dp
zgyI6#+gssNVmF!&F}14-<DlIR`;v3+=V@{zU8&i%`P4+`e;u5v)m~ZGwsQrT?TJvq
zk%)KMn{aBpy7P1`3l^m4TYKC9;0jX_q1bK50Zyi?B4g{2FzVUFa>0<c7)j<HH4w?6
zDtd5&&y=U7n<VCn@T9dfVA5&eSmij)9Mb_A@)InDD_@9x<}-nAsKCOUS)3L}KgO$i
z54g?73=>akqTi&;e`o%NYeUXQhKPCx=KBqq4}|2c1MtyeoKAc+w&JHixD%*E<BGPs
z#7DS)k7EGV^tXs|kw%a}BQe1gs7n<~UEUCePh3b<jildP<@Atw2v1tVRA_WDVVIC~
z^)E1I_0f0esPa!mV(@%IemUYYGHUEUj19sla39xa5luRl^7qXudsHznFiO5C?!zSM
z0Kx~me+4KT4&jm0CNCrej0qjfpEh%|Vv9%~#&D3KZlwj%?AQ4JeP%rXV<Ly*!0ODp
z{GS0yFxTY|@kvE!<svw1Bbb6%hw`H#g2dd9Imy$O8Z|V1OfST<Oss_s+%De40<TV`
zQGRzwU1g&x2>xz@LT2L<h|T^toc|B7j+!<K3uVs48di1@z}3prG}8+XorR{G;n~uO
z;$UxSlKi0<Qw2&fQEL#Q94d}xVi|CdQ3|@L6|lwiXZB)7VE;Sol5kE69)Lg0>1+oB
z@Kjto$k7i7Egq9+cyN(qpQA4lVQ_YmCon_xk`|O`oEUa*M(oN87zxD^%p<=H%>S0&
z9rAU|PU?QzGB6LaKbc35!8B>{$zhcr<HI02J4*M~6n6J@J`085k)5ItIfw-|Bib59
z_S)46&D)eqz8{#G6|4Lp+rMY2)JOC#K5v;+LuJd-LKFpVP*1WvOpn_A;OS06-`w^e
zAPePgNTR1u<GF3fHb>OML+8vm$3M+fFy*@lTul5+@L;i1U9(kNrrwE;;0b|-CGdpB
z$wg}y)^TmA=36WAMfv9W7HNCWB@^hnG|#$y{0~sBr2goA`s~T7_FDl2d$YzrE<9oZ
z{F)SkM^cMWQ*12J7tgn=VtP@f28sw+V~N+D)|m#5Ct18K{s*`L6?5Ki>G#4PPLYX0
ze~Y>57S*aX9C4SBX>rCPGK`Faq$_1j{dis!fDL4yD(nj-afE&BSx;Ft29zE5mNOG_
zMN+zRfQ0qI1?8R_kp+uwhx<$5<`5n7!v2>*G@Wmf^B0&x%KUdHMc;3KXR-O_cpVHt
zyL>vhqjp6p32=Ym=2-s^(D@(WIrd%J6D=pQ`Ot|#qECve)AP1YhQE%J7w}TYA8Ly(
zOTzDNLSJ68&I(eeeeOx`kX?$%CpLrEDJ7XX`2TWGAMZM^_zIn;@t<lMk*Y2AL6YYI
zWUzI~EA>Suw{Wx7$(&hMp7n7%+o7rfKHw%JBd9k-Xs6cZFJ|U#fFJZicH1m$%YB^U
z^fRbsvOgAd(=C1|u63cedESo!Ztx(}Fd{PyIjh+H;I%~yc+gVt{mK>f?rk;vR+U&{
zMCo#zrnEtXG2_JGb;<ocS;p&-ZWx89g=+#<1JeBOKRt)|9M9=g-WJyhscsU0Ozq##
zyrJCbt|$MbbJ_Q(7a3n8)P>lSpiJ4>=zm@OB~u99o|hXX_+7`n;89+dfg|?RU#q69
z5&Q2^U%S*FvjxQ-H0!;&atP{6yYdoVC0Vmn9Uf}?iQXhoB|6lgmJu{Ic+mjwr|Pe2
z;~9_^1T2r$kMovDF`qG57Ny<WbJah&q4;8qjIECgIPPkAK|&<n7KLI6b`qk;g<M~c
zevJl26=2=269*x2C+L}3TE%&Zs+pHOR9$){MUVgJUy}L^F8SOOq)q<mI*~u+VJ^8q
zvQCnpY$wI54zyQR_;fUzAql@D+{V#}mn9UYPLKWe^3s1Zkp$qmNEEPzG$fcq*p0yR
zF3VI<0r6+II}J2DvJNHhm%o&tZGi${9Zl}`;bGcu>XzwY(sic<_jyUGh^chw)sjwj
zbMq7zS3{!f+E-83<x3|(kOW=6LG@&rJGOz|*Cw1-<f7bTQ;4<P%i={yG|CL)B2M?$
zx8(12X~ZN)h31S?SWq0blF_z4tGc>{wl>oEA0#63^F}D`6F#S}xi2OJ#%~nV&T!Pt
z8^<kyC{Wt|pxM646uAK8btN3^+*@Ci>-_5pD$AGQ7TgtuU0XfZV|)Wfk<x!paqvI7
zKn4%%^Dgb{@+hzmerp|cBBJs_fA+yyY&P_llZWY8>v7kF0LHNRJ}TiF5_v2w$)du%
zWyZIsu5)VZ*uPsPA@CO{x>(%Oizr^c>2k{2Qp$Zv>3G-N7Cclj$3c~{hwqeJ?ilDM
znx4a93ArQ;Om<20Xh>Y;kmjLOA3}<8kv(W*!bAR+Z)d$OBecqnT?1DYyA+ofdDgVL
zRJ8%7jiP%NUbB2c^oc2(g^DtK2gMRCgZ-GQSo=Bxe%VlqL!<ukO@B1y)`Z!EtGx4c
zVQ*E)U2u%j&m;bvMuEJJWVxXdd9317#YO=x@LyWqF@^nmU5Pxe2!yeM$za}B=<)lB
zih!S`lnu?8p;oB^+~aJ6^szc5xP4g;F`Vr4Vv9y|O};xJvQd37DV%$Wk2F5+IYK9G
z1^T#O21OJfJVq^T#XnTd7W#UnY`iY&-)U_6Zm~H>Ql3Cg4UyR~KvlQ=EB4np9nnZ5
zCB(8H^ZwC-9SKTC#hXJCtqa(HIY-e_H#VodLfZRcW2(5D0r2b!*syx2dKK*C@6*70
zqugUg#yzl&osx@Dnb8V{!~qOz$dfjpO%u%&)73A8n;)8q?{}^#I!x?vAzbod(4vcE
zSm~Uox7gME(Sm0eQ#(2)!0R`wSnx&pSRUw3{bC2Y?1UuqdLgh_Dz}vzT4D~+(^zHt
z4k&26aq*?u*fR_!`yYnJtOJFwf13AfeFdxfv-<YdDdDDyD=hqtmfuW-PUP(M3y|M#
zHb7LSuc?e#R8t=I(`5)xTuT$-`T8MxI}t(_Or=F%nLI%CbR6>h%g4^w`s2fc&t8Q|
zO>8cjf}1SRS+2^>3?i8hd!>CVg*ept@TlEY5__3*lf(^VlJ6_y5lP;Y=v2Vf0qe!k
zTvhw<d;@*k<LCGSDbf)Kx|QpFb(4QfOMQ}FhyphQUNwxikDy65aE$)XCIH?}^RWcN
zgl78mPjdYkFR;fsHc9A)$!sDiv&bV_dalQF!mje$oJ-wTm$zt{*+}fF!Ep{Fs-E9&
zG2ZHKRk?rH832@5;S-bUaUVHMrH4?VU|ejBEo8(hM3!@WB<8+ynfPonNvEf}!-Z4(
zT4nBrZ@@}P^}j~!y>T_3@*KY`#y=Icg%1<{_{)eE@lI-hV*l2^^B*x+G<Me@Vs4Rc
zsPYYX;2>1xvUBn&OJaB-U<Z=ENn<yRVdAEiCN+qfQD68k8d%L#q?u)|R@hvWH#uwm
z@`W>n3q_QjcB9O8AtR;OGS$PiEUp7AwI}yk&O-L3^lKp%#GM<uq*&F*pV&Mu)%Eht
z#Iwq^ucAc}tskuFB_{Ys;E|GEZe;0gz^#j`M6%sgHw*2I2B*fDzoMfUGv)z_Zi-l*
zqt2ciRAVRZo`IiAqIQw5<&p~bt(rPC@SS#lvO}m{zhpN$rs(c$h3Nt5f@5BzuB*4l
zIkeT01#OSV_I#B1jOnj%ozw5+-~)UgzsV&b1}5Jem8h6pp{|YWCV{c8Zl({}t`rJP
zlX`Y3!oQZ@r*D881G$V?sSKy$$Jdo-+}kB&>dAz|yCN96J^w!dctMB0Z7q}Z0MU7D
zE?90lCDaVrl2}Z5IaN{*=TQrNOlK0?gzmczG4%ZEo}J@O16IC{&dU5rJek^_Q?76`
z)Qnd{mB1PL(A?JGqX)5^@ZU*hViTfBayK9&0|yxWDbdHMEWxF?gvZay7n;pJIPllo
z8qDgEq{`bEIx>KN-XkBabO6T64(yLw8=Bk{VD>X4gHx3qR_Zm#;DAO6{{SYXVSLdl
zq{yxZ%-GNQ?^54i*=criUS3YHz@K^8^sN0K#ab@CB#~+Nf=Li$p;C>HToFa*Ylkce
z#Cn$8wbVfSC;9iFL#gfN<~;kaw`#sHy~S0r)hu-(F|?b_@?<f{c9Di1M<SOrhshDI
z9qU?oet7dp0Js?K&M6W*^|lE21I*l~a9+TSkHly5q}BE9FG9CTwHtu~J8e_3n<wxF
zvn@Px;k*0DZEf`tB=WFCQ4E75_Q_mTE_SbBS{oV)x~?#8qR8*Fty_tvNR=Ky>;TJp
z)Vq)`TIQd}-WZLU8&MeqgNP*S{{Vc_T<>6Ug4~<?27e<~kI#=6xg)O}Rz<&pZr}_J
z+$BiHFl(^3x`y)BJD4AIQYd6>5s~=RcRHPwrR}Yp((Rt;krM4EaUFYLel#gfXp5bu
z`J{1IUk|SC9bIo>Tn=&%_*HZ8-t50O(BtTT!o4Bc6ddE;xqtXreiZ0+PJKLyKlqxZ
zI*(&F3TtwehlDTeT$H?pN1}p1rEI~aUPb_GgkkvBj-RMnYL<z2XE2rr`>%pOL(N61
z>soe$Yxa#o<zkJF2LzIR034d0X}4mzV3AGqM39p#HqY+Kll-cs--N9$quNm-Imj_&
zVErpsM)3xfufp=_*Gn)$1Fj0PpKy7t7j#5sV}Jo9(aki&mJH!8d<%6x(e~tJP7}<@
z$Kg>!;5(R(O~ePbKq9(-_)2tB{{SzT=e%wH6{{5R&j6MeSB-{Ml<;cg>cxA?!cc+2
z#o#&BWDj*2C+-jr2j7Zm@E!Vti|9b<j2iDAMUFO-M#3m0pK7gTsaa}D=GI-}GB+F%
zkIt7pMy?*t2RWqpMoS4yuQYN=*|Kx_Q?=g<-s<tg63-NI#>KJEKd08Z-;^G`X_82Y
ztn9&2MoH`{Ip=$i*~Zp582kltv6OqLvF*DbjYvETD#lb?M6I0g2^H2^YdUtJA&%O8
z>;_2MM<0l*o55@hVyaWA7iKSK1Dw*lKXGAgCA`wZEKSg0@t&foN#QwCOr+=lIRNK@
zT^^yS+t@}VxPL86Z67H-{uM?q5oxy)1WUEt#{d;8pUhCbt6a$ip|GP(nA?cm(XoOK
z2^7n_WQN93J`8y06{aL-907sSsp<!1qd5S8Msr!IO5<^jj&2Q0eB%hts-Qj(LC~7$
zZDNiHLdE{9@}Qj80T!$Mo2pJyAn~&v3GG`k_?}-Vd3Ndu90EzMi9z%*Ou4OiowSSf
zwHBUcP%vWH&VLHd)^)R}=&~zYgxtNGJ;$|Tc!KhK+o*0NRmf7K10M9|xD#lv8OHQo
z-(PB_6p~`Ttm$;p0(eQW*~UK_?(Z;crv2%NY&nn|75B|>wmA`aPaq$?{Oh>9SpLB{
zl#w5ncN~reJ?jU#*H`#-{XbS^3kh(WH8P;(kIZ>F@69RGB#zvV?E)hOKq~A2_Tc{j
zoYQ5svWZQ}o<{}qfsRgnDrlpy{>(6~#$hf7?)$hPe<}`h3suwEA#?V^Q#|2_=Q%y<
zufy~y;;Dz5yo*x3eF)~RYM)?DIqk%xp~>VBcr`=e>cE~VxDd8Lwj-{8h*r?pm$};b
zlLj~sxvpisF<mc-G37z^Khn9=)1T73tWWV->tX)@hKjDFlj&8VytlcQNTHco<KfhH
ztIWI;Tn)ad{h6rhgeGNoA~BBpt869_;$uEt)vfo6wPi`G?9RjOmg_%|W<fXibIn@~
zk9xt-w1$A2>(8F<Uz?xc&-JS}x}DXn$%fxgmg55@m#6ZnsfJFkv!d^9-iZ!1T8}i<
zjcm3>I1|`@b(f`U38^fg#?eg?!^Yi3Q~v;jsxoDc8!4rk7>$X}K=0FvO9frY!ADiN
z-Fj&!ea?s<YE9V1bIanmCAAVmX*`pE6e>RG_0Bq0mY1r<s@gR1t0u#SR_*xGse-Rc
zE>n$?2-l}4XtM79I-jLAowoMJ(y-+5Lho~LVLb3gaMLeO<yt3Hw>m>=F{yafcWvl+
z?L_c(;b$oCr}fw)UYxIHTFVhf&QDWWR(>Oj_UhgUE!g>k=4|ku)X98J9Cvftt(>nk
zZM9W7E`KVosA4&}d3E3P7uG4-_cqslI#ZQMtgR<pT}D|TXc`IAl8w(4numztvby^$
zFiUfAI;4H7ey3mBdoEo^?Wywf-$P(0Jo8TShplDldh8mTJZh~J=sswias@@G_>K!3
zkF&=dmlO9$$4{*<s#bM9pDv;8q07yE4U7OOtPeQAti3Z`x78V=Rd}afS~&&};ZWcB
zk_$V(vd0vc6A!#2?LxuVbv>GnqjjmM^It<i-&+gMvU$t)jAv$f>6)>h!npf8xbM7Z
zw-IM!M~pDR1TGDB0ONuB)nf49S8<P4lYXSptL+nhVa){R6_0=7D{C3eu#QWMj_DB2
z->plgYnHmE^pAQ>pL!=4BB9|cs(#hQ@|3GV%aZz<M?Tba9`%hsiLBtdn%Sb5%Mr#E
zbGZ9dnr6Fgsz~u9az{E0lyS}}%LiUC=W%utuT9I9Jxxqxb4EGhv+Q+vH3{c}C6OeA
z;lqF_V%8v=Q<qPTBr-%Y?}4;_IjDGgskGy=yYwkkgGt|V{xU}tb#9f5KZ-3Oo#T!f
zrwDNG8ssfrk5#spO*gTU(FH7V)O%v8SW3`JQj4<^tqC@h*tgz{9M&{GC9<C4-YAw<
zd5$rG^8IOL@hyx~O$k|yksK9N&g1RPSJbf=<>Yt%kiES-UgpnCahi7CJ7%yK#d>={
zWW>9}W69g|{{Z@`{+X*ms>IK39ZGP@<B?HQ2VR_9rxubb6{*SDGTc`YOh}4Ea-1*+
zIH!@heZ^vEhQVgOYc-p2e9Pu~^V9XDZx!k4j7OZz8yf<Q@!zjX(s(M4qlGB9Yjo}<
zUOcJIq-|xo?H^ijB#uT!Qq#3aHA{0Xxj0jXR^WqFrtwXLHzpj);Z7OVa-y=161=A1
zpzgOR)~2GQ-i+3Y<_VeBCr4yBV7*02l6!ZqSHlvlx`v|Yato3O?lNma<HZ&h*AEZx
zq$qIB8sr1@t*c-s8qSp@<z$TM;v(RuH)CvqNXP_Ik&cy0Jxbnd6L}n);R;xgIpf-@
z$KpE)Ww(kl?DL<LZTr0ApH7v}95rcP(Ryxb>cLv?b62>?%|w&H^0aFrnHQ>q$gIo1
z5?I<?8+S50uin_X3;Nbpi#&7quJ&YbV|B`(UX{^L0a4SHNv4ulUS@K{MM*|3?YkXY
z<n$dV!Ew_RyN7?$vab9~r&?T?8Qq*8n4;t_*12g>sa5jRS2djD4P@+U><6w7Y6#;P
z&(^3}YgTvnGC^+TnFiu<#yzSTyh*1(B`+)HHrP}zB>Pn?C3h}G7k~2?wx*TttZHB$
zF~FrLwL<e*vay0WXOxdHWfTmP_*8Zp?T(`%ju}`>{l^$5=|aO+<o2Ad-N)@|^K#!)
zOlPlANu2hoclxcKn-aCun@Q-PWS_#Iu-EK$89bOIB2&>Fa7`tKtl{kxUoUWVV5Q35
zrk>pO88jcIb6VGkn%43=dv`0f@itSpwQkwoLw{~3g_y=k86y>SaCK=?jae-jFs%vA
z!97tv&^g5eZ%`?7k)CM-V01OiYAylkkZ2ebfx6M3YCvyzWPy1$2RlElbq5X9ewE93
zWslnC_fP9xM(@JCj34lk<>J4H#0WE=N>Q~r#%T#Xsf>QL(sK?c2R^>E-!OxYfYK6u
zXyEgKkw6V+=NLTH(4cL_hHyJnLkxTI>M8#KGC?U*w+c>A(xhf=KzU$dl&_~hTH_k(
z-&MTQ_TEW}6J+~jDj0<a`qfGGPqXMPY_~4xnu&`ZW(!6+#^QMVX!dMZJMoe`Qx4JJ
z70Y;b81A(R?;^V*G=JS&t-yV%NAUnoIjHrhty{&`sdqC)1kf>%849Zr(w8o_4u@6%
zKQa5h^*9(Fp4I1Y&3Nr$49tg5Ehveu9E5BWjFIiqrk9&dKh3=PzS_~Oi6H~Z^aS+)
z@tS_m%vU?p)7FqKP7Z3Wm8Xq1)WDNGs$8;{Ilw)ITV`U|0<&zShOx&%OaS-INJ|d9
zQgV10skrP%^c1~7r(wGsQWZO@SnM%}y&?Ow?T$?$LJu`8q(*lhdQuVZig^bnn9ARW
ztwSjlifW%}GFr@nAj1meV2pF`)~=S+MU=ux5oRttwip>)41xauk9DkeT|4b^EX{E9
z61$ZbaO;tQ_!`;SZ>`%#$YhOTZiHa+oPLZAb}f<4_bXhTPh!U%(x3z|Z<M)Q9OtpY
z#aO$SP>LIEh7lu2i8tey<AKxOvSo`-iKK=}E`!9y7l7Tk{PzC<k6PKew1)1+7A8=U
zruFRKcfNbmU^`Bh{!594(kjLP*i;N2x##kw)ZX!YrL!>aVsa!I{J9kli#@E6`EYsJ
zja5mI=kWB+Cb%t|$rleaV1@w1xjnt9bpn&muA@eV(%6?_kOn{;<n{Mo%+kDC#sfTQ
zxwecVslnqv)}y$!vxW<6hPk?Er6dPlpkP0yar?3P)#+~Z``KW%^CjMnHvFtIKs*zV
zV?Y&R8uUw%6a|WaRNw$|*&_$jZ~p*Vr?g#5?Z93vLfnQNZTX4DKdn@RS?PL_Nhi83
z4ipv{4UkSaAMKCQnRhmweLRzWrs@~l!7(sZ`AF_Qv@w=t8oNrtEp0XiILHK%o;&(g
ztAnY<Bx2GSJhG#HdmeM&w-tp1T6kgRUfi)HFq3J+XK5H8@FDuv)~$1Dl3T3rAaFw<
zLDUnspKd|?DLuetn(9UyueHS*$VOt@j=28-8f~l-Op?QWZ2$#wm;;lNIs7*Mb(T|4
zg%L&l(~PcM^<Lw*e2Qx(orEiSb^>G;*^V#{PDlMRJv~iJLnm7;SvG)G6aWIMr@yzb
zAB|mesYRthv5~HW;e+GmT%W*kim9mH*xvn}R^~<W+oGw<XC3=hGyRpgt6p6nlm%>O
zyL13``Atg$UcvPtJ}#k!5U>2R?0EP3(N(mVtdec^*Hb&}+Ez^G9D9G9(Oi`uylowh
z2Tg)F{6!812TW$Q^^yMo6N@G3@`3*Vj~eD<OS^4A%@P-A0Bnqq25V<elJ{NKt)*y6
zsxZ#c!l*el?m|BQ06#>IWc}M7se!Zbt~25cF^>+rd1@W5Asd48_tv_S%umdC#d5wo
z4JLxCpZR%<{{TW2%@wLDPeyb}8h|=xxvw8f9k!XL%)pdO)Mg4Ya5LJs;tp#Q#un1g
zZ>A!~(gA#hg065m>qHm45_%A6w?FWc__p6#v$m2e3u|_Z&5&Tq#Pr9tc12Wo;MXIj
z$2W$&M<$#R&Y65nmhFs)pSt@4T}jS*eiY>pjE_I??zv~B%c{e1r`_CdzLB@Z0dP8T
z#d<xA(Op<YJTbgUBIQxnX#?DLuRZX$iFC~rYF5|RUPP^W?i8aQIPL{^_II)B7Lnas
zN+gO=m2t*t&N_-RIj<M*)iq5c!^<I#8_6C^f({8p0PXyLrF5|A)==4tMYe=nfw#)o
zHj(tMf5p~Uu}i1xwh*+}8hf#lCF>+iFu;4$2gDr&+4<jUkV%jD_wvt~pG;EaZ7T;d
zP2B2jt!?dKOL!w#;f+F~4#0M<N5=PSr+9<IS4(ds{#?@^E+Lk0kPZcOx_#5$SVMBr
zJSJGx{I~ndk(?iT!q@k=i~KOyI1*3Kr|#&Cb<}c}hChouTDpgZZ>@i^bqGw6<II*U
zD*bD|(xXr8yFLa)DbwgH1IH3bd>g3^xh6i`=bG8mC4cPeT<|=k{z8Vm-2pvJkBE`4
z{2^M7F_NSCis&q2L1S-@35|34S2^(o*!VjC03R^I@IIoqEaY#pKtbq$ay_YX`=QP6
z5O}Lfn^y46{gta?X=B23)PfE_99KJ{>Ut)iEVPYJPFp=j&<`%&WZE|lGKalxc!yTK
z(sY--w6_-x8v`O|otgQF_pU?4`re!3Xmsc_wih~!+(z-TAq@}*oyWHoQH!;N<gatm
z1R<~kVwcKLqzaBFlW6Wo8O2Y$j-(pN#L+S_4pa=+AK+L+UigTfgHUn&>#{C*91eO{
z2c&Aycw1i9Y;|b`qTO7Zm?e;59Z$bwRT${eE$W%3BMtFb4vI8?{jFU~#xa3hcZcr}
zh&*q7tlA?R2rR{#N=DHmZ`?@r1N<wt2ML@CQ(F!!@xKX6f8otFHO1dHm2o?z<U^k*
zhQM+CYpU^#klla6H9fq7NTt-^Wngj$$f^DwMHR<_gcC-u9Ft6}r=c5;Yn#?Ii~R#$
z(X68;Z5ZltOKwjl6S!qQo|UHaBWRwgA^~|nO5`-P{{V}buHbaFgZWo!yCb!7T3$!Q
zt$B*|wYMLktfIFxeGY>9!aM5;?PO85Xv!WvMR5Kf*FUp-2YxR90OR9HX)TJLxgT(T
zpnetTn~pQaYs@@Hquj~k$h61?EH#&o;@|<^ESCO<@uvlS7^SAD>3kKXHlN|Ue>5Mo
zT;}3Zd$V&{UlM{tquEI!v#7m{kOoN{@rv&;uqrCyK)?dHuZZ%jT2`MVhiawtY{ZU$
zW}J1M$1Njb#*wb*`i`QO*1C1n6EGx6C7Fy24_sGKv37tBV%YezMAYum*3SMpXMehj
z)Z>#|2ZQ&y`qaugiAeH$OYH_78^jiO!YQw&x|Bf=m$}I!3ywW&(L6C@J+Fpz_-{*j
z=?aJ3c^=<@;=Jn5PMs|8JVB>M8vg)J)MR#2Ki0+kOZ|U3^xZd9gI3d^y|#VPO1p=s
z_CEEcMWGO8505m<o9!;rYe+uSEiRIIE&l-LqKxEzwCxj7(6!6qb!~33YB0y;vPiom
zjCy0zt$2gPQfL!c%Oo4DCXl7f<0s1F<v8@~`By*o%N=XS`fU0;B!&cbySR()l_LR3
z?sG{+xQ)qN?$#y2B-bV2Bn+C#-H-T~Nz%Hr&ji;i;5@7vz6V?RJ5;Fqtfwte)=g;y
ztBGStG0q)xTz|vcJ9g8rWH86MZ>8GBMn^T+mLwj2xvodRY*R|T1B~9w{OC*FVBV<g
z8Z{&T0IyzK;VpYi)AYGuyVLHjBo{KB@!FXe8R?u?r;^1F&C<O4!CocN^qmq*YwPHt
zm|RNRSRCN7_NN%=$&|H6pxXIY7I4cNlt(~SO6?$hJ69{>RUhz~_+StD>n?vGT|^Vd
zb843s?jAQ?%EP#>PsAjj8hB`qq2>NUlvbrmS{;#%Pw>|jtyo)s!hfJfw($jM<}9H`
z4^Fk%nIEQWlhz485Oe}F{;GfJL>8eYb&=Xd5`{$yqo7^|asDu~p4VB@wV`D9*0!63
zu%OE>e~1qFuDg3@o&c_YRq;5{wYV*Bqgb^0qa|*eI1l~P*iwpj&?ME19v`{Tby+9W
zw4{sAlm)mTZE=o)hiccljXuXWvN!UsD?pmpQ1RxWsOc&`z_zOt(jdZ1F6`ub@H+nh
zjdnMAHdCKi+xb&*w1G<K^BZQdTRXJ6g`Q`}lEbn8064Di!f>kSF@nLe#E=i&_O3Hb
z)NSmcx{Bt@&uIV%NXTBb(D*JZh~T-E)T~kwv0J~bdKjqQ44BC2FVQ~1agINB-9DAf
z_#IHecbt9U*Xdmjqo1){5Bg?!&$V#6F17uPlE!UXUF;4+V-?Rvo0Ta=c@*WX&qfic
z$E9KTuI@V>9hH9k$IBm1{{W?GK{uTQQia+b17p)7xX%*FE~l+Ur^GT)1pxHidY{V`
zmL8qzEA$(dg&j2{(si2&WWuEC3Hmj9I7t1oUURGH+P%HBbKXjlELc_A#O)uIc3MUA
zUg<XTkT<g7zN3R$;-aLK)AAH$Z4AE}#=qIIV;}23p{)C#4_P;dqP~kOI>a5h$Ue1q
z#zg-BX2bI2nLnjtNv+)7>2Yb+_QV~53uh&<>BkjRl>MA}dxMg`r$^zNgLS21LzaoQ
zXFWw&)>r-|&+{tefOmALG&>j5^u>-(^{jV4)b^@=E;0=QUoUxJ%hR6q$2&T&mur{J
z?wlRwmwOe%v52x~hEtG5Nofn1^6abia4NJqrOmI*9lBtKtJ*#0mof--2ur&Ymt)5@
z(C=fFTH@T<J>{|T9ywVXq-~NbEufy&StV9bM^ZShrpH2SJEJX)(zUdMxgm$;T3X~`
zbQ`}gMhK6OUZSI)TMw716`8_#Oagz3yL;A*Slk&#=)`TfdW>^iJ*GUL3E&>}-CQt^
z(pM;C3WV$f?{U(wd$Y2y@ag(~tjt+7>20MxQ3(v3gOSNN&tFkRh0UeKlOjMiBCLfo
zk)F62^x~q2RBmBw6Z0Ru0SbO&jPdDG+1}3}3f7@Nbi}X+k^+(2{iFF%bDZw4ai>gx
z`3<>;9QyO?RQ?>Y9}`>{K@9fnNGE~Ftqn^0SG7&rdk19&vZP?}JwF<);3j7AWXEQ}
zZAr#D9F8k!Y)jnjJW5ZO2h{%nO6Li#hs4}RZ;w-4_6I#{%Ef;bp0*qKXk%v;!rEzx
zsb1>H*b)aN8_@1G-Via9nyi+#@W}5JD31RCd6aT%OfD_ZjJbDqx5<TSKGCb}j2{nb
zQZQ{c?Be1c7eB-*FSgy^>en{H_*umX<AIj^>vilc9^hOw2xT1~9R76;&W&MtIGSh!
zN!)@)ez>lMio^RyQ<m3Vle6+n$<nFHqkX?455ufZzo>4T&iN1TF^$}gYHtdvi@in1
zUHJV?ZQJR#mb0|*LJ~$@q=Uvd?f6rzG}~Jim7qeVQ<uvVnyT39bBxq)?<lXhROm`B
zH|XEuVR%__CZyOI-;d{2^dRk~YYQHCoxlO>gIz72nQdd{{g@T=PG2leO%{4xww@#w
z=vT};n=DRG<4&$VoSjCm?{eGZ5W~rGr_%obiOlF$_w(tSEwu}Hqsa{$uOsVMg^TIl
z6uybBBbYH}44nr~KQL<Sz8uqLxM_U0Ms8bUkPqQkS538DJlLw@+=2?^{{T9w*!psp
zG+ymCth#yi6fp8i&$YKI_+~VVLx7BB^2d((sv0_}@n)ph1gLBu_z<n@TUc!EmIy`>
zKIkVk3_5kKt>o8nDHBci&f-DmHP7|9^H!F={@;10v37#&W7=c>6N{_>KXP;WR5}Ai
z9>1vxm<h`^3xB;^i>KPhsJ-%r6T0mrlZ;ds+8u_WFP$P4mmhr&3HsLGT%{!8E2QF;
z{MYD5v6}am>9%AsS-f={TVU;9-WBQhPH8j-RPi39E(jAAJ92&h0K&IyG^;%^TkPrc
zH&-Vl{xuc$iDRhE=E@l*{`xivrt!30>1)f%qkg(;u$2j~f35Fh8e+0|<`Zst3;V*q
zL!Z)_;r0vST|`V&Nt3sC*Z%<3T@Ih5S!tz>x_s^TosL-47ycixzqs?{-yEIVHpYIm
zeRhjZlfN%2jr!@X!R#t4Pp$7`7TCt#J&?jdTpZ)3c60jITmi;wGSfoS?5@`41$A{@
zxh;@*#cAXU<i^*hR#EnMvWi;y8&HIxpEp-?lkoFx*R>U!9)9M*KVET3_xyH^Z-N4!
zG_Oy(fBMz4f1uf4%jY<F<?ivE6ZNTVG@DH=Slg*C-+9>Nn(Ll6i{`4Y%_#EQr)|t*
zLTb?Ho$g`jXdA{C%)k<$<MgDrAb9d{q;i=*_sFg2G}~)?`EMgv^JV+lJW!fds%njX
z19|K)dE*$xOtG}wr2E5{<~2e|FY#Q!ypU+#DEmus4a8)(*Zhi?LV?bed#E@1>ypHM
zIsUn=ol8fx)lnAUH^_1doEo!lZ5_3|a7Hm4YqSIDQ#@=Q9YuV4C+N2Q2O1Jp8+&VS
zR&m}PT~Vy$7IIq!-gk)xTR!!A(@vjH(DfMPc-wF#b{v7nKhm^rJTqfF?J7Lb7C$hF
z@C{juNw<SflFc{yPo2cJNhiK*YWVtde9?Qf+P1oR+=_U4M@P{<zoD7oJ5@~?WihVz
za!JQL993NrH+Z8`bBwNW`PV^bXBMAow$PUH)RXfZo@%wOmv3i#J={$GWZ!r(<M6B{
zjEkLVU*g;E{{SOJL8#MRw=wh>(D<iPZKEn!FSpH7_;=;kHDSg#a0k@ZrJj`qo%O}k
zO#WoYEtAJw)RtOZy^YPq#7yPqIc>*}!m745oYd0m7^U*CsnC>pe4BrHh2et6U0mZI
zIR60Is!s>T3|F%h8_c_Nj@7SWq`_cr3=ZedIeo-?^!(}ic9{;D9Ff4z!baS8p7dfd
zwC1X)zl)aNEyA4%N0R+7_?-8L_b2wkMlrOo0Dd)R!b=lrR~v$tE_}@TW4&uwXz*A`
zJdrz-J7t3qf6rQ_Cxz_I%gB<?8aer+M#7rXt}=yZQZ2Nl%dNW#6e>fNrF&oTGQ2o8
z{{U(jdH{BQxTa_+slAMX&23C<<UaoZy`OsM^xYN>G3GEC2$1p^f(O#8%i)W8Cuwcw
zp4hqhgl&Lo<&U8{l^01`&8zIXqGN}t7{|)}dz9?-+l@Oz)KYdr8Ca-B&N!!dTGl1e
zy#D|#Ow8<e5t1>$#cM;PLk67oO7awNLoqo#)S7;s9-U^E@jEgCPG7Gz%Uc?!PHOtf
zN%p!())X3)U9?E&{3?kh#rrr0ZTLCsijP7_lf?Jy5E};UW9wR%J{f{*wz!JoXc^DW
zBRI`Zr|4FiZPVO9@@3ZrSmajqag-#gNlD&mD_d(B!i7ZQn%VANe2CbNxHzt7!U+p4
z<H%K~EzWx5y>%>e#yGA@>f1p3e9}GS*77S6BxrC6_Tss)El!n6I_qsxzQ(wO<0#Kf
zFTR3!a73OY)WjrtU>&&Wjoqob4Wt)3-lHVZteYH#3^E2ur}$3TNq>EJ9Az!f%N~34
zn%=O|Ah5W&nm1=@n{x)n1$JXG5v5YBFRM{scIGrGImQyUiMC+vS^RQixC6_L0EtgQ
z@`5Pw60BP0oc7=>#fEl{yz!da)bu-jMV3PE6v_8wL(k(;Y5pCyw7M5lPc6*j?zD%2
zS;HGea@B3#G3Dj9{{TI#RH#(e32yImGGrG%I90h&Q4o1yx*jw9>3l}9!K>-gTc{TW
z#zOI)MnA1=>Ut%<q{|~aMLK=i6RlRV@a#61V(NQ|E~a0)(sWuW<0!65j!yB7xoyAb
z5}{GvHr?Lk4-_i@0BC8%s07K+9eEYgAPT$yqtFVWt7%Z`(4xDtIvlI7YMW29Ydb*;
z&eOJXUAosDYP9NMsmA{FZ>Os_ge4lXcF~r>$2g=UVvYdDXa^&ua2*1IG0C9wj?|do
z?i_Zbu6Upg-wc%(a-9DF2lcL;xKoPdyfOa(A5$EE2>x}{V;t@4UcM9fNb<2?#9&_s
zf@uNcnlpidK9slzkU6fSoK67E0E60sReMqf?~W>1!*L{l2&n^Yje}ztsJHXetrDM*
zoc1)B%$RhoH4#X$wghy<Oa2v)tJ>((?TR_Atz?3A%K1R6IR^oUe)XSguWGZZ-J(j-
zdHz|1Tl||djPLcT&#2v9OLKh<yJ0Rs^8U=GG8c@q_1(=i7MTs3+Ag1I1@+YFJThDi
zM<9kUikRmZ9qPsIm2WPjx|H`UsS<4{$_j1n4r>?fch<0L0^UVyg`EPn#a1~3&|sRO
zd3$rHX!?RZ?c7G+V|i0Xs{Z@1IT@y+?|X>v3PCI)KP?(8aHT;Xl`-vY<W=7UO|)Qc
zKyW>(rj;mbAsM=Bi6g*vWdj^%997N2vU(JUa-adwbj2p@8b;^6CON6N#}*{e8x+EE
z-jFcIGywkqFys7bH}}mnu%yW5rLm4@IL>;~Wa5}}jEXXG=}^i-`r?{;^`nqKohC^Y
zEVN0b+k-6fPaIh+0yfc-DkE{LMdw8onr+_OWEdQ7J9z&9cW*UDGpD8VO7}M&ax&!v
zdz2BMLFt;es>!Fz3>R+mm6Zyhi;St~KZSLrv4h+}d8&{%Y0-I%xxqZ2l;`!p{A%sA
z*QV0o&k&AmpDHo_=;Pm<)lD_D*VGZMuI7?VJ{7^n4l+7>3WoRlE?d`@TiMc0_`p+z
zBjw|d^O|-Msi!>b99-Lo<ly8E2>$>Yi&$x6Se_VRmy#RI#~%FCw3oJZb+(pyiiO<L
zZpTj9<3CD|Sa{-+29Q2LbA?bw+<e&tj?}u0OF1Nz`5J^4=m5+s#t$qw2iqT=SD0VL
zJf;mY6Nft+Xyjvq`O|Im>pS3++TF-j7hn$Fgq1kw(`c)Wu31GH4Kq8aIl>-D>+RZr
z9+5oOPbAjy3$L511ClZn{v#iqLtzAyM&E6+ffx`J1RU}I0PCkdw_=Bx7#xv<8+JH7
zy=kqk*{Q*2z-%!nM$?hkKU!Lbg&`gJlo4TW7w(Uce4upxpOq*&t0)p$#OHun)Di)1
ze<96X{@>H`K4;mtJN6uR{{RXbUem@wk(cG%GaC$y<BmDx(C^p=G;G>x$rX$u=Z(rx
zb?;QXy-AA`V+jn4@)QIH`SblhI@Gk(?eAJ&BP_9j^AW+$dVW;{>$YhlM#a^GZTp7=
z<cw$P59LvIGcm2T5?NN-F|?k1rNeqvy+YPsE*G`7gu1ZYr3Nw2ADvpY)vfPlSm6%a
zl(1sBAFVd)Qnj?3%9yxt0l-3f=O4<Ux7egs)6)4TK73ImMNSqm(C7RyMOd@cZSMCh
zXAP6V>yKJ1l6&fCwmkR4&m-!0i69>;b;k#hUACG5PyqtCzYfkO)o#M6+vT1}^lVpc
zrlvr^85QYE_>96o391xr{{U*L+(MEcnL`ZpBClWoI%nFUln&fhhzjW#1A$gzQVuFO
z*qninsjEDIGsQay2=yH*2T&x){DoX2Jt`(pBoyogL1AkvW$mGIdX|h6S};KrQG|^Z
z6m(S>0-{iPAoEk90P=d#U<W_}&w8i*pJFES#hgBFbLM$tc7C;`fI%B_DiWM>IHh1A
z`FerPJ8I+>13kFuPhc^S1vF<o(O??UhgMPn9)wX6VB-R&U57k&r9d{0Kt7ZK6p+O6
zm5~D>?86|`JHm~)<F*A|2&KE!QmPYyfj||CZtGA-r&`*%cx_^d&)#H=0)Hye2!%N7
z>M72@DB5{Gw1UJisoHs|lmpKOmIY7<W0RUvcG7E7)6h|jbmpsE+S=VFE^VQmSCAw?
z-_ERWU`XTgrtTyXRC-ddTp*4pVMwBlBaKH0fB-)Vk%$Kr)#NEPE=GD$V7Ux1MFMPw
zB#kqjsGtwhiC{^9StC~gg8;)kgOGnQQsjgzF~@36<*)$v=|zI#sKDe?Rv6M&m103F
z;4_8!i0zX~Sn<FFpGsZFB~K&Tiw@zpK7ylrSe|5=kxY?-5%J3BuksZ>dX7G{hl*Ah
z&@wPhSGu)^=07fYqLnk9vM6Dn#;lG%{Z!Xbyx<c>fX{<TvVujD8#{R1bYzV|ABYub
zp{IkMam^_Np7h8n$7>WpgmEH<Ibf;=PpvFAu-m7X3~|JO{nStg<yN!u<E1d?JT86c
z3lK|cvc^(HSB-`Wu*g4!M+Jqgl9aZ$h7~-K8U@egR(g(UcK#Fvh(dafDY09{4&fAO
z9^;d-ag*w5#~co6K~dNrr2%3vnf?))jyq_f+_6NFp*x601D{&4*OCA<qZuO~S^#F;
zuR)5S+CH96O@*P)Q{=DsR-P1bNwkAN710q9Q58{FfS_Ox!jY}wl2wvOqi0XL#0;;}
ztd$wh6xIM7iU5c&ZYhlfO)ALIBS@ch%JRQMQ-uWeIi=f!?MP&Max!?uM>VCr%wAOR
z#VQ`FB8CU>HDd}o<kE%wFenjPD@bkP5y1>mBJ@;Hpnd|Kv=BjT`&8IoI?=Qf-xR>A
zmUiX;0MteQ0DKCxV*?5l00*TaDD!GwpmUFEOr%%x2?sboT8P*|(8CG;0Dua*6beiX
z=kld?7DNIJs2Bha1xB`UEQP`*{=2sGR<qBgAsEg@Ek|Tlk^tzz(OG>MW|+3(G{kDE
zJpjd7EtTezfGJ&tkyWjhL5UGt*@kL0w2d3&jTGbfR0_9|?M+~D#tlnsq>)jfBZ|oJ
z4Aa_ahDZ@!QtGN3rzW=;VzRZR5?Y`+z>!T%ek2lFGnbV$w}{C0T6~xp!Q}q{D&ns-
zSG<&F(g;XAn9~H;tU{rXf_jSc4M$6k8=3aq#x}crrG{&&n@@9=X_quTYI}Kv2Mnx6
zHy)MJYFD0bhp&~@R!y9KV!3wFC-QvjKwVHNWe1RP&*4nHy`6OC2RkMKGmbJjrqXWc
z6KQI7R>b*!63<?1xx5maDa0A`e74z-Tyb1Qx622Fvz*s;bQ|n*Y;haxIC6MXj<wGB
zXJudEQ}q2=iqh*PvE+<)Y!6fK^r?K!V_+sY#z@Z`jF0gjueCGmI)iUvdZic<m2wY!
zbB=nC%B<d7UC9Is1;WP4F(z2^)4$>R&~u#TuKJ^^7gYl%7^;5{-e&P_%FHpg-0}xg
zm8tbxEkY&o*5fOTvk4Ce9+d~f)M4VQg3|elZO9zw1P~2v4T*c5r-?_&Z}mUYx$)As
z{7b^y@!Z!s4h4BQui~@U!+#A5#OI!rhiK|)3FvdhLmJ9A8DDqJmB8pftzedh%#$id
z(wYdTGXOap)M2y506ZFy5PH>FnbzI>zF!|M26?LXmltKiO%KR&e8MsLiqTVYi;`ry
zB<yLC(-aah?OD>@-bX8hwJxCW-1-mxy$yMI27bg&K_d)%1MThl(^Mwa^!w1AM2!Y2
z1~E~bjPqI1-rgOm_J=v;xdX4#p9R(Ak|N7$Kx4~tF~I)-6Zunkd8_Ka@KqBp1IJD%
z-VQ3I<6WkH&VcmBN53^*7t~GKEU~YYS+YRvI)7S9i*e?<`@zj8YZ_z&j+C25dE%mH
zm1MxTV!z%DKgOZBp5{4%M`~mQXLfPTOlh|4zcINaT-q^7g+A4uFK<McHZQY*j(F>n
z)9F?oOO>(ngc+EO`CyZe(yCNst$S<cgr=E4L+edqcX3f#OK~i6dA8;^PMQ8HulD=U
za`r6QT;ODL`BPLR+e+GbgPKa^;hyG!>re)`dp46`S+dwtI|6a~Vyi9P>LM(b+oT{C
zWds4p<MKbH3XG+DG!AJRKQ>1v6oisUIi}i9_YiNACW*6+rn!A;^8Gb?m~HOfF&tsl
z0sF^}KU&idgq3QJo$YN*>ef`_%+9ZNImHFf9+k%1jbi3BbEwG~W6C#CTDH1Qt#>2E
z4zlJ*z%naFM%?uJ*Jt)q{{Wwh@&5oLpX<^7R&NIxr7Q`qe$PnPZto_x8m`uf_7cmS
z`}D1`;9nDCjdl$Cq5l91mzA~u052Eg{zLlof0h0Om?ZV1Z#`+B@PzoB1C4Ur{{X;0
z`qdfme~L54wQPUjAN^`y*>e8?pOO53$bVgj^1s9U$@VDfXc1(eN~Lk(ZxdT6ch;?l
z{{VL%(w}ePUlUIb`1QL|I&#1LjUU-^{{Wwn{C~(ky$|JohxwL*bHV&+-c~zS4EleF
zt?ruL^+-&JdIbLf>}n$yhy>nKYLKBmtN#Gl(DJGO06c#m@&%5E^1timbYe0I=9Dfw
zb6F8-J|TAl`)<*5(3Io<070p4yg%Zrb>4MbS5H-6{>GQ~T>k*)<bNOXAJ?J$ulo6#
zSofm?y<x+q_?l@JHPo$%C#g~Y0L0bT@Xv~)jKB7^lVE27dH(>=X#UHe^T+Z303iDG
zJ3s5@Xk}>gGTdNR3fTCI1pfeO+TeBhfBPD)vFrIK`%cpxGqiv4G=F7J`Q!Ni0FZrp
z9iR2{I#bE})Sp9KTzZFyZZFNPyy+{eZ6#wE{P9xicYY$#*?!kFYKNnQ1Rrjce`M7D
zc>VAEgX{GBGp+#Vlf?uKU{@hysB0RGd4p25+&ZHu2l-XA{{RUP{{WZUPy6J5g&)~f
zKb}8({{SKVdY@<ge9nk=$*QvHb~h3kB({m4xhq(J_>7!=w%7joAK_9ec$l#Q=Gz{-
zNBC7oEw2Z7)Jx|70LYh&r7hzA<9#4VqX`%YgP>7?QU%B$S2*Lu>ToVC&-?^`g#dV*
zj&3c1_fh^84=bwmbC2Ht0LZVeQ`*evf_3JMW4&_sGkB8L29c(>V7%cMB>t4wyw~Co
ziLNbUX$Dj>^Zcm(%B%eG`~Lvo2iK|gXH$X)T4vMFHOpLT8r`xMH#UvOMF5(L!&uiZ
z<9CWkaJ*%ZQ~t@T{L%aW0N@AL>Go$|wt%Gi<X0dyeSPmf$fg#T8NfkWepiZoq-@&{
zFlQWOeQAGXRsLxG{{Zj<>(u)*bgcxO9AsB1aev|)X+%!e<;czggHpwJ;wfV#Ue$0n
z5W^Uw`zo*VNALdtfFE9`*_|;N0)j9xT=lDXlJYMy2`w3OjGAT3_@3CE=Ft5p{>rQT
z(fj`Z;0M>K_GeLVaW%0m6S|Yf9qMzb-XHmSlm7ay1N(Pf7b$Lj&K=k&`Fo$npLMHi
z_O}fStQ(Nv;c`EnQp+o?roQrCGK<|mxbA<nuK~cglk=rIrSCuKGJbXE!^B$Q=@d=w
z6aN6OK=Bs1PY|d5`~Lvz)BerGe>(fc^|~Fu1HL+y?my$^PtKkFsd#_o=0W(^3U$43
zK=U+k1yPfg{{ZXO_LqFudTcYwM)w&w7!}Wm!d9UUc}X?4jM|NARbMPu;B6gF?{<FB
z{{Wq9=y!J)9)Fu7J^;o~*15px#&KKT8<7dQ`G-aRwT2#2bye9_;}uQW5<{Zchw}o+
z6u+2a4t8$!#Xa;(2e^4QI){Dl7;+Jt)QT=I-q&iyYSVnBxIg`BysjNph}*_-UY+E5
zW_xIM1?4P~H=1(Ukn(#PbXql%#c>;>NGAbgX&kX2bQz|-)%TjgVjByL7U~8^r?pFU
zb8?J+&l*U(bJv{ub*FiE6_G8SmA;=3lWwI`Imv93_|)ZvXG1;omh+jTNae@ww&Sio
zzO@2eYKXj~Z^`9|9fzmBX<FcI<a%UNNfnDM`n$$Lq$u2NDt-OWrCPh1bW|}I$M?5&
z&$TNIx><3>3PC*9Wu*5~G@f(BM$xn{X2&$!7rjXv?Q+Ir<bjczEC#ON3GGRcN4;Q7
z_ws`x-A0I5s^R$O82odZdH&GzbN0x*!o30DWcp*%G&qIL&BGYQAR~&&ww~rod!@LV
zJ^ZRNumO7Gk@!@0hVI>!X1<A|&HyKIIU|h!0G_=oHxkn}nSsqmyB)cvd4L`bDRt~>
z8EBSR=37OU($*Pe&&(VSMh|*pwy0CfHa5(w(?55i&OcAivcAxbbtr98<`0`{t`5*Z
z?St>1!nL(|5Q|ke&u#%Fu%w9xOde~kEfIs<g4}9QDwWfq-am*a1n_-70ax`X<yDET
ztzwaj<%1~n#%rDuWmpYnZI6XdEH(gO6dq4(gZR_M#Cy;DPHw!fya?Tl5^>J#^cbel
zj+;+eRvgQ190Y(!Omb?rvox`oJewuCV#IvQowXK`DhXx_sL6GOQHBQ#`qJw&TWycd
zxtbDpW6I7*$2}=^834J}(l=Q2_~Q+d3gd&vKdJnx#iUI%5;fhGye>2RBcF3wdu)q<
z+N|skJ3e9jV~)HG@%WmM*~R^xCE&f8qA{0mmjr-5qKgXT!0IfSlT5ZGlhEh4_+Wk&
zHH>pL#H)8@5}^T=f{wnQpr|e{^!te63wG-ySxg}N#~lyTgZ}{Qs<v0ww$dZXe=A^Y
zD&X^+W4Ru`ohPssB{zP2o?e}3@Gtte0CGRc{&dGT>^agc`Vcq=91=fTuWM~%c_EH1
zLSLVAg~3shbCJmO{Ho5f=^W52%_vbGNlutnT%2e9p^?r-C)i{V-0D$C<{LONK;0Z<
ze7FbG-xZ?*%|4Q6dq{=R+(I$|-2VWd#<OA5Z05ClxUViG!XKNaa5|q_Wrfz8ry-H<
zrjd$agCXNB>Gi2-Wzuyt`PSOp9GnmadQ`U}XR;Ysn(3DqAbm&~>yPPJ&iY%j6u7(V
zfQ5KDaqZLkRFmH6*A^D>OD)RzO1L3@W0dvBTrlZS(9w3lUL)dV3Y&TWKK6a6rP0Nn
z+*?aCu<PbI_4MgQam_a)SiKHA!|<e9rQt=vDgA4;(=Zec^~QL9As(T0yP2?^SmgDt
z&rHS#>t2+<h+!Xu*kS_YsjBi2-(O5sg4kRR)lr5|4bQD?gem|t{uMs(KsY(7>5x5Y
zbRQr%!K$!{x2ZxpA9{;8>r9$;jW^25gWj=kJVEm9w@!b&Y1mgcjFH0`c^y%GSkxBU
zg5F+;t>ell%SeBva&J7>Qtp-6$>0j?w5vg9WPpGqZeRQ;aj;yz#}vTBq3KmM9Zt_r
zi*)k@Ki$tK=qrlU{9QfSXstIvA5H%N#DBuHr$$rQE_Y3NYG*d9AToiHtIpBy=}rI>
zjGmQ=;mtGb8hXtk0(r*y3F-%7Q{C%U_NNj4_D+~ypPfXald>Jnakem6w;jppS$8_r
zF&0P=%K6}ryZP5YcYkqz{<X+V@PmO`8Wo9}f3!IHBI)jFa@%mZ(b{>7Zl-hl!ZN^g
z9@OGgWMes~u5MwqLi0$Gr>h#|wNDy|!$+sZxx2{YkHA$zjHdKLayq#$Eo@^lPb$Q}
z?RWZ9#DZm6Kp+(u1Yp;n=y6<Y+QQslGfI(s%v-0huKj>3jxj}AY7X5&JCnjP8^6|_
zBJc`~)NuT$M;(1?Wg!nDv1?M+!$&RBo3QiL9Mq)aoM8QEKD?Sk7$a??f=KnJl_c^2
z;+Ob9%_vTOW13-Mhj1H6?b@4$Rt0}5k=QS8I#3kz&T~iz$Y$;D)|3OkBw%|}$OQA6
zM>t?IMtaZz*CQNK5O(BJ<0q;5(h-5d{OMSr=)Tl9-8rKK<D5~n^OnlvfsSYb6gV9z
z`N;S0O;N{Qp49B%VD$9GI}$O*KM_%6s{a7>>GA*wIpgb5o^lD``if~1#0PgfPAW{`
z00A_CNy3B2(w-s4Fx*hV4GqsA`%{SP*i(#TZ7OIB&I!#c6i2%Q`qRPVlfb4pEW~yC
z(|{wdG+3L9yb>|moJ~dZ1vsasN@VpkSZGFL+o!cO7CpGBT;Xylo7nnMU;xKGF-i}p
zsMv%}#GDRE%|0@+MzSv|!ywUMOm`!kel*{F@k0zQTcsx4j!zh%1>NnB!j$pGX{rwc
zJW@LypDD&E1;tU82BjTvdeb8$5uehe;~t+{Or$4s=}2*m(Y!Gr6U9X<m0y(enpPP6
z{J;Z45_qaN+NGA42c3O)6btI@jMpi3@lV6BIY^#)$UKyfkJg%tdjpbNow*%_HL@3|
z{40#K_@Cj+sRBIGz{iZrm>->WHrKYduq@WM5z86mG7xHI7Pkc?_9n)7G{ys-bNJG+
zz}z|?T4R<AS+rQj`A1V(`l^Pt$^P)G;1ax_%Cj|jwp#OyZUUt(M*a~kfFl5QuQ%}y
zk2G4X<iP=pe(dh`uSK+x8F~ufd_#A0KBqKMM<|H4)&Wi%n&_u{oYUCX(xgc(W<q#=
zIO~j7cZqFbx6p0kg#58d-`s!ot11maphk>=_m5H9jYCmejWOff&OsG?tw>F)9eut<
zmxUakYVI$J8wu6U)iJhP9R@3ffD@*8P@bx5ypa}2T_5hUkbafU_h(&S;ZyW~nasVU
zb0hg0fM&)A?=Tn=P65yP#at<AdJ{KhH}VG|xZ^&($IbcFkZJl`v63k_9N?YZNT*xq
z+G~xGyEesSz>}i4QS>y<a}QCrvw{g!UxzX%T$dl`wNUtb9BJa4rj5&f<;Om|fvtUF
z#>NoqyA9N<KVAsW>sh`7NTcyZz>Tszmg;ld59wONVqWK2;&Mp02h{%nO6Pg5i^T1P
zx6i$Eg}ARL75r9v7;oVrtaHX|IBGWv?dDp(#m)-zoEp$~0Avi+aeD(Cd7vEQ2kVNO
zR<pcrT>WfUlT%b7S|<d8Ks|6j{ZuZc8xR#7GaN4AjGR=jb8L4_lw%s?uo)mx_P7Iq
z=BX#%wX|*UGBy5UR=JKg3j2d&pi)QYieg_x^2rJN$_YO~Lfk_nYQjXp864C90CZ0~
za!2P`S}SzR*P|mEt*!yya6rJ?d;b9X>7!S*EWoh<Wanw*V>zjD26$NdcEtf84f7;@
zeFu8K-2VV8`~Lvo6Yuvz$$tb)0~QU8<7uWgrvPv{J$oLYf&FRE_H>ubeVfSJlh&MC
z*cE12fo3@1a(mKBo|lUU&D{)5R@jX0Klj0@S5UNf3bJIAfrU7v0uD$>hpz&aMY#Eb
z#gcm9Qhv+%U-j}IzugG;_R+g5NrJh^+Iw}Te`;GPWpY%n7%FN<@}KXlXP)3xZkF<b
zBuLmExy3c?x~31GqeH*6tqBX}^&k(F({6P*tmX*eiD8gOPPD2mnC@8NIpaG=YFF|A
z8<rrW0AvrskKHMJEIs>ffpuFq8S_9r2*K+~9;IhAp<<jfHvj-=FxwN840!|}x;plt
zrML>-RAUDqg#!kq`!0!vr`-tJouE9-y~jh_tsmM}V6Za%-nmo9`OPrLW=JL|PVbl<
zqw}XU7LAhd#B<b@9Mk>RRKwryiwP`pF6iA@XQ(yG-A1!`vg9x<1WIr};5F0+P`FS4
z=rLLP607**P*zY!*#7{kS8i8tYde1{{L#ye{u=c;om*0CeQqa<Az~Xb>x#2)ta+Ev
z+&%2>8L;uG!N*};Mz7&LK5WP%kx6aamP~Sc@+%E|HDLsynoGvP=!mEFuTtrrW~R4?
z_1J&mDwIq6v2w~3zvL^_0+n2zeL1f_(xI}pmN{Xt3nC6Cox{ins2v4#>owificFg#
z!1+}3_?pg2<svT;c$(isF(j@MM;Y7KisNtoAc+%f8F8GG_iL}!JTawefXO^;WydU7
zl538e;k;LO4%Roz6d>}Bxgh;%$Cs#``W0vKg}v>#M)OinbCF$-gW|k4tu*Mu7r{;4
zPrf}X63gMmhMzQdS68NS8Qf#Q3fT4bt=I9Ufnxqd+Jsxj1TP?dR6TS+yva4q7UFB@
z@2z%WMkGVjk80yJOUT>Jj#M$opLKx6dIh$>reCW4lK$Re$Dnba%DGP&S$&e_FJjn{
zPy4w^T!2qQic5Pkj#p2<)ZLjwnPMNrPipPFFL2tJnkJd{$AOPb*CFAX!vuPUp5a-c
zlXAW}ApZcL*1GQm$Y#5}AKlyiYNSeMQyznCjlEfw$8ZHqbcAlR$bTxojwwk46^)r!
zF&o0x3`roI@_6f2-@=+uLOijI`c~|cW1*^&%bxUEh0JI?Jz-$Z*0HQ*xg;-Ij`K#d
zzlg(k5ScUgO=+<t^Fpp_tSgw7z7o-GU(ANZ5wX-0T5F_OvTbW*Bi^qpS?DUnapTg5
za405)ri>r4$N5ylMX>(>pJlBOy$AxAX(tr58J+!!r=R(DT2JgfKmL7EwDCqcqfr@y
zMzK%3Zll)}$#e}m;3<*-#2k$Ft&O=n;*T$$oKn;dYEJ{`Ge}+Rfo9~L#-9&@G+Su=
zxNX@JIl{TFjHVAt04AN-Xmi8Cnn0LLvB)G|0|z;&M}+kJlfK{+-_13;0p|lWpd9nf
z7hrQO;C&#-Uu?yQ!EZFu9|P%3gns`3YjqxB=DLEkoj9WG4ss6#>9(n|7r2cFKqaR)
zgRCU`^4z!9O6WkKjCP{zG&wf-eWJX}DOpT`w+1iBH6!>BN14mZ=QAFpy>$c=Nsf7<
z>@1FDd<CPS`4&<1dPeXrl*DfHzX$1EKpyk}eQ3K2BbILg=?sk-^NO&+8@h@k@FtZE
zA~>FOMd$<cuAt-^TpqdnsXbMg)3&JQf8hwzNdEv`b^ic=Dp-6WYj3;By1Px?aVJ{n
ze-5;u5!$6eEm9kkd$R-n5qO6J{`3#}=|}t{5&r<tM)&^yR{sD!aY@BdCq8^7Zb?6F
zygB6l_pLR2A7%jp>hNUqiI4g1T^He+HjcFQ4Gw(xPS9ihF8BWb02*lUb%{-e;_$99
zk382x%bqb#!4$O(4s-qx`w+PMP3{Lz-<o0YWrF}d(Rx7Xnay<NbII>b>)M{6bCGy9
z$|ho$7m8b{08T-%z7ut*+rc_<#%?b7?dKZmam648jX>r<;R>+wjAG{RVQs{Dz3GeK
zYX#|bcsU3CXQxW)cKQw|=qS`Ij#YdOV38PB>gYz@SASYX@GXKevRqwmUP0f}oYz~7
zdQt##Xw(jHcup?*h420R{{ZV!f5Imh{Qm%6<NmsT^{b@DDGyPKRvFC?2ivJ6UR{Dt
zavWrz%AWofj!XyCZ(AKRApZag=&{Wv0S6TI5zT+X8)|Wz%f1Ld>pedYVMqKSmb_;2
z?BHO0{Xa_SaqB_A9ZeTwvCYHb2rZe~8|&0(`@~7smR}0PF&<{2df4fiI)0VWV|T3^
zanA(O)DC0*5Zgd^3(L%tpY@;pYM6LgJijaZM*GXg-M(iS^yys&)7P~qQH)V`7DqIE
z8*7Yxw)3uk)_?V>Kj96v1O7j5@D6_X{{RZ<M_d{>Jt(^k4rzQN0<dMiyajp?<B!sn
z{3?<#X4J1)m!T{UKT7EK;*gAXpe%D^!ut>^>X*QJ2N?cT$M9XW$+AoPvc8*#*V4LT
zGuo3RjGk!)k<O0?KmZ?ayucVAIR5|&WS$DOnLvB%wor01<NPb8=NY6NjADSX&yNfU
z#uHS&QRpNe;YD;9;{ef0%dlATUkwRgRK4>Vju7CL$40K>Pea3F6~*{Y>N~AQ@W-5a
zVDdX=yS*`gb~}+%FX9y+guG)o>%~=(PfEVSYW2-xYI?L5L56q9{nhRDt&uFWm_#h>
z0%IhTilcL_ft9rZ`)@rz3g_n3WxaA-oxPNF6tU-M!RuNiNi@$i?qr$EHhPoNs};@<
zZ>>5>)&$GA^{mPDDHxT7Lg&3}3R0fJH?-!rf@5`d>l`t3+<x<R0C)AI)VyOXp`+8#
zqK-V*>VAT`P0b^I^p-ucY2k3Bcdp8KXsu<a1oBIDBTY1qB%Z8uQ|S@L*QnD*%@ltz
z1G(%fy5#==4oU4>R*?OkAP)rcYOBwZHbO|#yVS0()FyTz{spRGWB`1om7mMn#PB`p
zocfqhL`l0H&2Yk-mWZPBF^x%L6-QFXin%X}qOr6PY4Pu1Fw(aJKA=}EG|w;$>`C<P
zO#92U5CHeCxM7mkT8NVR?(+I?HsV)v)MWAa3aoP9E)GfPD#mg>TDQC<q#ONATu8Zs
z-voj>w_*KjX|)L7uq1Ul4wiJ?CMex;EQ5T99qU731BE2jw*=sUk?BnNf%~=ON={Df
zyAebfDI%vNhF%9Wm~Dgwpa%Iv1Cdi<h*<9{+)|cqn924OrARp(^`@3?4hDTGXc~{)
z!Bmk;xs|yX9<-QdQISq;o;Kur&;k}Aa%nzo<I;i~X3#UuD=ElqWP4HoEOJM2-xQh7
zG6Bsf1QCVc(lBD#1A#?`MnkiZI@3u%GUpujsfxBvG7c#gHP}HUliq<0W!eEB{<;V)
zAsHhBijc#c0@(w#CdO7Q4tr7=6j>Y--ib)uqZuB?oT^tpHAYnVnH0oCaAeQ%1Jad;
z&N%!kLZ3M~9QCIpSYTM^(tr^`A3!_Ovo1$HY0?w3f%wx^2M5xS3UjqVrxxP?b4)Ru
z4twT}yl1@tF-BO7b4T6d*N!Pi%bfM4^2r&^05hC6dsK_}M^Y*x2ppabNQ8lme6#`*
zKmhC3nsTG3ZnXAI{EjHt&Bk%-KoEn*^Pi?FXow?_d8H}9TvLMJVu9F>KuddiQ#X<}
znw6BELE@TI0CvS7BO?clfl-cCw`Vmg42<`tc_c0}aC*}bJUAHSQaYXNNf;uCmu>|$
z(5Wmt@kq6?5CeN)@;&R8@t2FB@Yb9Jc#{5a^-&&xe|Y;>OEay!5>Fw(3R#b!74wgX
zby;<-V&?Wo$Yvo2qK<;Jrw(RiQe3EmRMoF_i`KcmxOrr5c{~qbI|`x+?M5@u)$KP)
zn^aj^7gh4{oyXTd;aw?oM?S5TFivw?nkK)fXjdY8DcMGTXwNF%#8o@HR<pQ!b~$7?
zBy^|(;BawCu8bAaK85hti0!;dq>14>CPD<U6Uv|Pt+zP`*1QM7n#*XuBesx|Af1F$
z4Dqy{zlU1)mQ$Wv>BVqWhbucN&zS)GqXRXC;%QpjOKE{0eMdi9-2-lU&MOPWFvW4B
zx=k;Y9`z;h?^ws;MzZ)>TSdGRM8_kFEv}Ms(->}Fk_I9>O;pn^bX`6_++C?-!D$@k
zw_&=9;R8o1I-crsD_5a{Jlg)k?A*#y!s0l~9iYZ|AC+cZTTczVzGAdv1Mevv#d`x?
zK^ghwj2v_<1#<o@)$OLxFCmBbnE)0Y2h1x-&9;?^aa)qw;OQO}$mehw^{(;25wYi|
zYT)g@T@S)%r_4W*uJzjpPTcWWOLleC{uMt*`JC8>$7DWi*C-hSsVEL}&tQ4xrnCOb
z)1~v_xt3NakuV5P1b_*^_WpGxl(zR4vO8(6h7cGj9Gv=oT`IJfa4NV>A=UW`+jt~k
zj-9f2{Arx!9}tZ`^*+-q_{b`xE&<0UgIWFoiWTuy!$jqSLgWMf@Xc7(E~0B)tEV!e
z?#Sn+2tUf8_<t;Nc(UPE7ED0k5<l8g{cC7!OWf-`PILBuPHUY#xUP%EB!8ohook&Z
zjw{H;e-)m_7x+kP42)G()9t~@h%wH0AFgWG@bikKY@MG!YLpC;M&s*Q(v`l|jb^;A
zPxeTL;pHw0?LSXSg{&>haR>)Fq&6%Wh`E$xl0IWi7IJ`~T*yf8n$<M6sriv^@e}(p
z)MNK#U}LRH_Ap3MnH%I79G;YYo?o;1erYTlJI^PrE5SLm@`T^KJzv_7X(s+Z%sChG
zjZHS*Hc|m3W51;~Z9X}r4qe7uEI$H2txX&^2@I;!g5;fzkGoK`H{pgZ6pnMB)3s8Z
z+?)1-aaQ<6Z8|AuX_=obgN)Jk2ux`n8wg1m_ouWIJ&A<B?{R>^jY78f=m1-R)13Yv
z{eRAdIW=!-usE;f9NKIwPIu$$O1fk#^JU5F$?uF*X$AVOKGHgO89n>{RO1ey56f~k
z^V^=M`eK`u_V$bV`3seQD2=BHCwXL%uufC~(vftyRxqsY&43GM(uYk$fG!umRrdb?
z8di$<I|aA}dt`f2&pTV%FYDwSvEP(GvSG&$COPlxOZ}S<%a(kG4fVxE99n})z{pis
z02ADIs}{!d5{deb5R7A`Im)6}_KAXwf0QKCqmoklq#13;p7h7l5!NXD#|VU+XOq+X
zDj^P{B_F-#ZzP^G^7i}<Pj<I%z}v_a1;Nj*derkxG`Z028#l^Cbcpelk-;2}bBd8P
z^o|oA_CGLupHWOP-;m$GUikTbnEtfG9--%M^H*;Gk7}-IwXH?{e1&MI@Ru!MTWCaR
z%)ozptyl2&2aoQ7`>k!X{{Z8)V&BbJK%Ien^%aW+<5>8{dD0e@gkuP=f_Mbu*MNAg
zoVxC`?(d`g(a(+2lzmT2c$CMqs3X2>GHnhSq%9ssdjpD}OV_ORXoQeR9AlB)PoWig
z@Bm~Sj`iGm#S3jFI~bio25CX$_V%oKyiT?Y8VDWdW3+%e9+lIfW|Jgz6_2c2`4P!^
z1Z(RiM}C>6fS%s#Sd#c9#1JjM+=*3>KZRNQD2nXPlHfK2j@8K7UTQaYj2cNKx5g2q
z!i4oab*+@tq+i^_EN?n5-ajxj+5?{Wk**kRE$l4kf8S)xKqG<BSDac4d^_AR9AQA`
zCc4ibTuXOxZf1lev5rde2sM?WLv48i!1nvyTRa}WTD77f>da04RJ)>fTpkEGHQZVF
zj$KQ^7uNTVWSZ2eR%6K-;<=v?t*O;qTA@S=0bRJ}ny|}jpqKfA-AS|`P_#Wnv?kJT
zL@zDDn`^k*!#!)!z8OpB+-gi4KXaeXyo_6v9$`O9^v{E5Evo15e4o~omV->`yiMaP
z%@b8NmhnRCur^#A<o-2>{{RacRbm0Rw&&RY0F71g_xy}*c+Zx#%Z!&?de=-TMa4Fc
zc7`65sYSJ|k8(-O*73;Oa>@w<+*h7>kH$KdpRC+kTX{k_$O9{r&{unHgJ%!>i~Os}
zyjU0h5^K|rcaP*N8Zk~z=MD-HokpatPY;asx$YxRJ}?=8AVxiFsquEHd!~JeTFlXT
zfwyBE;~(Q*ePqAskbl=j>-DbZ;sX5oa39=%{g$<yBBqi;%^@0bT#CjT_?KBdZ>0Py
z(>yUOw|WJv^SOCg9n9R5^BVE>TyfUDgTfs6TFbY}fAk|!S}8|E%A+RUrqZwZ#Q=VE
z@q^le2Vdn});dmq#kco5Zj5d%Uu2$QjN>)Jj~MG?Kj}dK0Kf%yUOWT-5zhYr>z2H{
zj(Xy{XvH|{j%u=MS~Jvq8LHjt_E!?#NF-#CC?P<=#dQQ6Vz|GDM1N*oWBz*o07~t1
zn!=*AnYA}~p$I*5kxHXIXvY}MJEcX7xR}K#9DC9ArzptlMSyPJaf&gMPRFGt27A$9
z5CM+$!uW^AH~LPqJ)AK>(WWq19P%?=-YdwwZZYC}ucDv)bXK%toV7BmCZnNwJ|Sv_
zztme}Kixm$UY8l)8Zqk14R|^n$hq|u?(ks28UFxee=4fbQMHMqH!IwJJ5Wb%l)Vip
z999-L6KEqeoB_={1P`qRO%?&T>5Nf~(}?+LxT3%Z1Fa@9Y03cWK@?a9>^;pcIHzO2
zXzD1i3AAE@ze;u~ae>Vi7|o>dKulBf=|Q5vFoDw)1r*>Zq;o}tFy}thq;fOHY5Y<X
zMSyNG+Khfw0l^ukZS|tSFk?OFAXD%uxX;py0GPm}10Cu7QISQ4G=ffPI-hEBZfP^m
zN-O{XBhrivQIn1-HWGcQSObjlKpwPU4rzMPU>lC&kSO)1@tjf$ECLnd0-8X_J!(Vx
zdQ*7x;)?+p<WgZkr|lW((t<K6SOmxAOe@dcsW|*-2R&&FU<QhF4|*vK@=prK6dI-K
zAjV?p?V9Z^Z>{XmG_s8U0CaLs;apCEZe`W4Fzmm&!P;<7BD*awOtf4%k8^sl%}e;l
zAB2wgRldIkEaGHC=rYIg?OCbe>7_faWHI+D4oR-fq1hkGst2Yx6@jU0O$dLp#AS6H
zx#1V_u81b|M6(-EhSJAuQQ>jRF();dCF^pqf&lJ%{!}%qUCh&5$X%G^fxs1`6fwpW
zM4Ns4*F<?EzO0iR+FefB5x4uyas2AE_RRwT%%#UrE23#u1ZQmEb6n(%Ws#)F%N&~O
zqd8B|Od=U<w+5f`x8dtijO3HYYI=}39Fy0I=>lsuPqZPBjCvnhzjdia7D52cj=ifi
z;0%r_jmqO0=CYj?IbDpBTZfsqIXLVoftw^#RYIv_oF0Oo7!H2+Mmau}qDd<u4Qzr4
z&#<QjAP#ZrF-k$e1e{U;NhCIS;;3MV@=A#iCD`C7@0#^p9>H|2E<13)J~umhw|eA!
zC#R#{HT}aXMGxKHahCS3x=m)-H<uY{ob(7f*Pn~2cgTuHko&zk^rQ@|Mg}S<T6aRy
zBBpvSa(^0l-gv+j#bMlYNJ%TSk?l$wJ$N+Ie6U^JKpjaqq=w=vg)I|@P;t3>QD8&d
ze7qByV9q%isR-a;{&f*7JMl<te&V2Gx4k$Vs3W~F6O4`t>rHptjmPruMTK%)fzLkF
zs(a`2r~)}$mc}Ut_d%BYDOfH{81$&w-5hNh&#gwJv1Rn6Qd!kUO!cC{a>tl<f`36m
zu+QB!8!Io&NaC5eyW=M!m4fAxLmqMkF930jRd9EsDb7LSl@PLEWFGv{VccxZuw*WN
zl?R##A%-eor*TZ=;-P4jU3c@_6bj-af^fY1lU4=`k8fImKvKkZrxwD34gsbjbs?XT
z(wuTL#X*u9p7|(C92!GFta4QJ6lV?B6xiE2+unjceCB`?cILnb0-Sdf$4{+B#|kmr
z(AiF%DTr~#ah&}sMZg&AQ6MEtQm-R%G=_-^<$uDXINV1{bbGdvNv1gG9dkejwnl!m
z^~gS%sPLqd$i*SzJm(Y$oQz|diL!h2_oYb=4i6svsx>*z57v;|9&yk&6wT~#cV?T8
zyqwf~O0gvHC<4l!IX|r-V~kWxrIUBHAV*|V+L1|^UNDiZ{3)r(jCTkQE9Zlr2lKC^
zd_!#a-W<QQ8Oy}LSI#b_Sc9Gp4t;B)j>Z+9paxs7*0p>)G_mT@qOl0z?f~#`4l5%V
zInV1_dJKVeh#8mw19d;_n%X;=Md~KE{{SItjP=j-tn%4V21Q=hqz|i3RDucYeXBel
zmja1y!R|dt>JKBOeI;c(Txs^wu^EyjWB7n;=KEMAy1I(qA(xTDDEB87^n5WaOB^em
zu^>_S3|Af}q0xuxPQifSS2g2RFX5@OcKplR-nt}m30`n3pYg+m@YLBq#J|qDVezA)
zUkg03Y}MEkaLP|o7ykgSTGpC6GkI&QxNhJ^arEn1D>wx4#Y~rBNNnu`oQm&vIMt4s
zyeD>$`H^a9<c<}gBR`I7nARHl!2O2g{H`}L<KO=Pty{JpC6{_5rdJq6?^!-Fx;HoQ
zNT7eJ=boI@Lz|k+san@Zb!wr!J>g@Ve8U;~8t(R;hX*Z=GhTge$Nmwo3Y;JHi=W8X
zeo5GJamQNam&DG={{RXfKg`7v>+L(Ls$oFtqqye>Jdl4%acz0Cv_@3BV1m6k$MyXB
z)ky8Fwt|}J89bf+c>4QO;nLw~B{6FZV^5gvYy`@me|*z0Gc|<P82OGk$0`^BoQ~Q0
z)gJ)8$?;{vPM{HN$0OHpskKNU3$-<U{{S#5H~aMKM}in170jiSxVLPN#8$A_m$}mT
zpp*7sN3C<Dlj&VYi0tkzOddom;d7i;5z?>EA7qpAuPYM?I<2I7_-VybS7kRO4l17g
zK;(po4sZ`sTPH@;Pa@V&(wsCcO}Q4#KBQJ~jN|ri@->v8{@3DT19)I!LV1LY40Ij)
z(-E(P4Vci#I&;^Lt#1tnQX~CG>L~_^sRD6sNcJMH-~La)j%a^3;$aEzkdSS|E_mmY
z&-hTcSDWzGxETXGt7Pc<kmTCFDl?{EgZ}^?vi|_zG@I{Dej`@tKgi6M`gr7J7H+^C
z1{vq{q&K%f^JL^;^Sl25t?m51Ygg<SgRQLHKe%bXWV<JuS-%7{xub7`^B?`a`5E^2
zb4spS-I0LE2RxdFJKLcmq>z@}csoktrg;2%*00$vx&Ht~n?Lo;(hD2Tzh;~M{hAb`
zuete!w)c#)dvvT++B<y51bTMuQXAWqU=5QVdD?U9?d|&3lGxr1{{W*+{{Va%KF4-5
z{*5;swi-F3{GXUx``?j~{i8XY#w`h9w{{yi&*4sv?&u<Kv~q9(#~;$QMWxB-?2_~U
z08Gs&w7SnW^8Wze299|D0MEb7EdKzT@-oHU*hPP{o?L>U9+=~`M3?u3;M?*rSP)00
zY#Upz`S+Lp_%z?M+<(usy#D~OX{wQ5^6dkQe`wE^_ITxW`zuJiZ7P1B;(sb@UCgMg
zZJQ*pAZLtp?OJBibN>J=CI0}vO-9z&1fSf?{{Va%g(&Ineq}WO0GP@*_dB??J9iGp
zrU$pFH7s|svw-%JDwBdwZob~td|O-|1QP!M-v*cL)ATS&{{Va%r#M>NpP4B?<|8Ea
z{Ogg_9i#Ca(?&>^FtRQ^Mk}&5(*gdfPy6K8J8NX~c*<e0vqquJWMHts$oAmZZdIj8
z{{V;eM=n0jn)Nj8G@EPtfq$n=*0(HkEGkG>J%0-5Qu<vq!q;Cka*&vAs(-?{omW!T
z^l6G%>9)4<75Qhuf0ycdS3L%+cYCM_F0NW;-JFxa$6@VWovwM8vFxH))&`ui2!ie|
zdSbkz#oj8PP<FS4jCO&zP;gt^{{V$aeXiWTfoozJ#BaIFXRkdzg1I}Zd3LmqmKp0r
zV_`|11khYVY=GQ9l2kek+z>@ir(a4PFhGq?033cbA(dtDJaZ44NPvf)+}Ae?H<=tU
zF==Et13U_?!0aabHNwdZrCIa9kc`(qdt#b=>m|MrG07RNvEc{8%Qf2>G0xG98fKy4
zolz{z&`b7(QId`KvF%AT4C1b2lJ4_xP`i!>(ZR1z(sT_wUGUTv_dC=;PR5O}ea&)u
zUWWRLN=8v_!QA8?8?Aaik!~#XsA51f<$_4=X-$qO^Y0LN7Hc@mS>1`FUVOJ)H|O8<
zt^WXo5g4CU+@(m^Fn=1;)tSmRew6<Jhu9YynFITu){ET=+L)d`JG@5!0QJp(t#b%I
zbvYetrt#b7#By=ZmbJ|w1=F>6Q}_||7<c=q`X1SA2iai*pOJr+c}I#+pA%l>5578m
zE7k2(h$H_1aDOWD&l9G6O?%D`{-1?mL*i$jfc`7=Gpypx<RqSszs|dVhzaxQ#E;>B
z{g$}<CC$_)Kl0Ikopyf^NAEQ3kKup)mb9P7iOs$gaVj|j73<y+<HGhi&)skR2-lJX
z0Aj91sNX{x#}(Z1#=Q|-fGC_fm5&yj`CZR#;~W|Qz~;PMYZ{P0@&5pE{{VjtU(>u(
zso7m5k8<-xpP3{%$gEul+}Tz~W8=&p4YyzQsa{`>qbHAQ^$!_M9oK{s;ymq<k;l;2
zn2eLfX-DBRt??d*@aO(Px0x9I=>ApNoE~e9_;vu(uJU@yKb2DPH;b<$zmm^Slgdbr
z){qR6Ybim>Z6jF8MhUaN&MCp`$UosK*1_XYm+=GqDeL0hYz!ObC;id>6nh3QZxh#n
z=QyR@E6B%;b){eU{bGI8S5e_l7)hwy{f77_oWu8WD8}z&N>pT(%8gjJW3>m;loRMH
zl<`N3&Wgg?*#lg#+)H#(T!`_`v`PK+V1KzvG^HhQl~~2t^>T9Dbgv`vu+NIFdSHd?
z^c5)a&a>WVkNvZ(Z9@KiPVMe)c9~llDlj+|wK{Gt?8>D@C1g}UcY)X%_j_<Y%NP5D
zuhP6IaU$RjweFVx0P*b?`-AyZ*Vzt-QdRe+Nw}i~ZLUGuNX`vPM|y4vBbw(rPC)BA
z#1U$8O*~R1llf#v2PBX_Zd;(wO1{1=wMdl99N&D#!~w<^aX8ORR-<UPZynraTW#BJ
zlxL}^f8ig~e%Nk2oVy`H3F8D{@#~H=TJu5fi@Z#GzZWyw7qx<0d6XofXFzwx#{i5P
zzo+W+URvr?IzH=XWfANEj3_wk&*@S};Y~6q<cuthyeK84B!CV;9)hmHrd!%2%EYaU
zmoFwyQbs6l7P3IxZJ~*2;>e%u5J?oTJ<0~&6;Vb>9oyTW%}?SF5FIUKg5DV=x>!uP
z3JRj<8E$=jD#G|<PFJ-gOjg_vEewZf!N@qNbsrDd>USP>%D(d-mUcN%%bei)(RzH>
z7rSzWw~Fngy@t)8nWb&2?x1Z9S3NVFd*Yd>_=;-}5H+j9R?Zka=^P+tV0h!626+0`
zj9wkEx4uir#EB~7g>!>}jz`j@z0oYMW|nEundOJbW4j+NbNuMNJM25e&bRSpwD$=M
z+1$d-D#iQFyb>}qgHf-IEZ!8AZ0?L@JjWqN?$>cpPd=lyTVD!kV%|tL%0!H=%w#2l
zFG3A0z8BKvF=i)KiZK{fasw#j0z1+Bp!ZDs?-u^<Q)_8(s}$=KTo~1m5=U*o^O|(t
zF}L$BVz;%pl1PJq*c(ePUikvG8^iVwX*Isq^5&RK;5YFMew<Q4;rk1FneHP=0hlm&
z_nn7#UMRggY!``;zBPh7dsA~|a3_`_D=KZkQgM-!&V4%8rmL;Tr$ZLlrIvZrn4?AK
zft;L?#XvkMrGps)aM6q@5|DQ1JAQ($>RL6PrXe>W^A>iLa;FEVq5C_l3*EVo7mQ<z
zPPcoDX{Mc^6HDYM!UAv!$*Ujmm0LCNwidTIGpq((qhMwk9Oj(f6w>5a(4?VKArRXk
z8BlUF>sFV;_6wHU`TIiLeedH@fkSlr4)HUS#x`$naWJ*H+Y1H3+qjZ((>WiFM<<FN
zYnww1O$<imptz1?`N0djBL~u_y6}ypmeVXU$g;}Ix>+2tz&XWRPYu{d94Zmp%8<*J
zY?fj$N%g0CNIlacUm8U{l(O1GA~btjbgBxKEsXGZ{A*SXejAM%eNAAO?C}O5kO7bm
zqzwN6I%GZ+)1kJO1rqsE5K5T|0|z`+yImsI($;HOl=%{pOl0H?^~a#3-9Cs-$Dy9y
zE3*x;V7QV)up%OYT(HguH4pqIHoinM3oEztQbyXUq^LuKo@&zgPfSZ?g;r1&PcSf$
zhR!k9=}wEoT67VjDoM2?c*b9|oSJ{S3&eHqy=!BoL#Q-T$sD_Os)3$;a&Rj*{u1IZ
zq*Gxx*^<;;78^?e`Qsg{Ugt%%xznPtXO&@$00KS<1CD)azx*Q_X;{@`bP>hnVO)*N
z=zV#mA7^brIFZTXn>f7U(NCDtHrf<ri~Z0!>r^B0n!^l@d2KJ5=d@`O1q>8=<l{AY
zJSC<qQpbsilV;{J5`JEU9@MgUOG{`(WK1yTK;lEYC$BWuvK`_<H;gRdC;bxf)JGhQ
z%7Y3Yrg`_MQ^pG)+dkE0G;0*%B-#NiPe5{bJ?m0m4_Hbi4kbQvMvhDM3DTQ$;e9sg
zrg;)TW?<|U$Qy@3J?SS)uwEr5@r9^{83mQ&d8qHTRY?I(4tcGUbZ65=)v-~%H?H;1
z7|&x>m&5iVIMj(-%ZZ`|pC@Y^n!6RWP}!}lWA{qC2R!4YOu0VDn_UX+s4QaKxgRus
zWS+wV`kJ~3BRJx#zMpF}VI+kZDuo4<5&-wBML@<ndsI7g7K48pOmW3HkCu}dsR5+%
zM(#Z*KA5B<<@GdxLVEK>H<Lw3&m{1Hm-|-x%`9^mJgz+}ztak~6xRjedw}}2=qgo&
ze1r8L<6Z8Rf<fTmR6pVsAB5JIAv)J1;ya;~wT$w9XTbcw&(gZ9$%Hn|BM+5EYtL^b
zY3`m@&RCQF6}(X_Aq9EsR^tSK*~ikU#QbNk6+E{>+7jdpfz#f$if=?opQ~J!VG5DA
zsjQ=&+2~CxOwB3Y0nbxWtg6Hk4mww-P8^Z2u2|0Q52Yy1F^m#FT8ny)oC=kTZCrJ&
z08jwn=RGLF<nhHYmB}ZqTDP>8br?brkGyF~q^`z7t`8)AFllmBHZnVLTE11ig|U;%
z-2FE<Jl0D|mL<FO%}gezu!StR>JQeVkAg-;BM+NBLF-YSrNAKPr>$vVJB=GgH+B%W
zo8{Y)l5@$e-?V7DEJPcqm9frFSl5`xJkcPGO5r<z#0rgoa8*|<$Aw;VTyG0@+he)i
z-T30hAXeHLZX2;bDE|N-(z8F|C)f3P#kGWM9`E_&nIq~?N?jAd@?DjiQ2oq(qy8iQ
z72Mg_T4~UTZJ=1t4&6`IvXrS)(kko>Jv+jz%r13{$!?__h>Mb=>+4+{QKBFTfCm5p
zfk~C;0P)tAEv=j{1GRF_a+c*G&H<?KfM9V?B$7ZJQw}kbyi^U2LbxC|G#JtFbI9qM
zRoDQ)=dB@R1mtnrkc3$HY(FM}5ysyz=i7>SG4%lAowQ`P^q?$2Bfuj(o}|+GU|=f&
zQ#Rc6&S|&<oMMpdK+*0z$Z#p%T8AgO_o+Z%bDB+xPD!9F0aa9OBX)C5L?QPU<n_R*
z6#(r@K>AW0h&;2nw(d;^Eb?15E&~p~r6K3#Jv&nqEAS2h&*4Z>ag3fSM#wxaX&4Yj
zPCp7{il}gKam5BR^5upHpr<R08Vg{K1tO5ZyIA8KpGr)ENTX|cg!adJa8geob)X1J
z9CCQ=ic${XNa@m~0B7k-oT&qYK!`$|5Dy3Rr>uEhr1MTvdK`LYgM}Xcv;g3tR{#T1
zZ6))Onvf7ib4)*Y;L;l!ahB(;Gs<EB&lKXUP7eZ{ybKf0c%~t~K_HNN(|nSrlh9QD
zXUmSbJ?TDX?V3X?FwQ-w49$_8ROUaNw>cxB=}a-?bJw*1A`Q{wb`E)`c}?ZuAEhcF
z0P=HEsq5DR)}@q|g>!B;5!SpT;wObA(DjzOg$c2_JCu*$ZtGt9)k{*-Ep=NNEbn1i
zB9LH)AE@`LjNDztI4LV1ES&Td4C9968uV`w{3+Bd9jDSsytm|t$-}Ss*9mi`U)es(
zt2yCsNh2%#>!nRSj#mb^D`2-?v;mCO%S|g$zF?NNbIix4$jKGn_-EmD%&#5Rw!$cZ
z&)L-FkJR?1DaJdFFml*~;irYAyS^IL#Cu?eK2G8H-`D6roqEw+9HRlo4;1Trc&(yH
zAc<p%1{G9b0Z!S}*9A$ryPdFtim?HVFFDO}-w+#bg(tzm-o1Xc)}971PvKmr#1IFB
z?g{?-{{T9Od}wp{8RM%n9OcDKnPLe!_8ir4k%8B(UehklpLrbNK~-*5yNdLgz>Bt)
z_nl(5mPs49L%^u@i%Zl<<hX)VL>Syqj90E&#F9depkaU`6^-L`3*l>ydNTh2I_Fhe
zlF-${$V*Y54R~7v{#p$FM!V8JLy&QfmBU%6{{Vz%!vtrE2T#Vk!bn4blh{{0z9x20
z_)z)&XCE`^aYh~;Hf`l`wWMXp+ITo8(-kPx>=M|(mUEb=+vftroE64;=lF1IM9-`;
zt2K;YHZnNK=brxn)}a#Xd0+UK+u;4~K*t~Aarhc$2Q#VM>8?)8OM-K|C5h(%p8mt~
zr+hw=IlNtV%8ae{bDiF~6?;*AL+sMLkbxr=!jL%Qp8mM+RX!iJ!SP)Fas~eYM{MKQ
zBDIFZz0XbH^WLNc<E1oUbQGbpR50C<$mvzm?g=FF)zG#xv>w$n@(y}?)+5>4UP#Fu
z%P4WVRR%HcDx(zl70u5vLBT38JDNPqoQ|Jb#-0l+m)zHCN}yZ`M`r8!@l6&MbHn?)
zw*hk-6>g_BT!=1hEP=jm2qPfV_b(Y0&#s#Q*%Im!9D}fK2Lp<`6_dwrEMIDoi@LaC
zdSH$R<wJyfh0S0<8NnXZz)r%%0a<1VZf)RLbrwd5Y<657#CrSGEn#;&FBsKHE||dQ
zzhBUbN(;DL+ul2mZYe{B{u9k$$!jufNwsjVzjAINc+aIz1)b_Jd37dq&PE5Z{{RvB
zQ*_m@aa`B)0UU!%ySM`%N{v{A8OitctjDsydzNviGQ?PrfOH;}3Mus+&0XrO0}wKJ
z%_(3GF<F<obk}JJX_s;%DQq66A29SI6dOCkW+OMG&aPNVj^32{Bit@(t0)BHr>!(d
z2+96cg!X!hZ(*rsRv18d$<A^4W~>`)`7Ld~(^@GMVqQ0Hrs=NXb66E1{{V$BfDcN@
zmruQt+0pePGB)QJ80Y*)<x*T(-n=lZcg8stHnU?pz3Fl;;d4(4I}FosGsvu#vDA#D
zjZfv<fHwaCwf-0s`7E!V)-)HGly3dt9dbb*%AX?c7c>e1(QC|a=a%2cdfbo_vi+9}
zg(tA|`d6mMy;Bb+=Jm!a%yk`6G|w7q*AA}V=$imR-0kb>TF_cc)AdBj>{`(-Wxp?J
zex6`e`PM|na&kC7TCUnolrQDe&9$@{$${4>?Vi6kLyt<&)AhLSb<2yNIxA@0DuFZY
zCjytm5lgB{#>JLbg*?Dwa6rd==ia8;g~)tIpuMJ#7`Im265)BtY}X2x6UC9Z?am6G
zmAN;FZ)Hn(r*<h5a+LjY(gJ3d0GI?2LFzr~mV~`_AcFV}0`A>O!I4}ks#;aZk65*p
zl(1LH0CH*YNB)R-AQRrITgdizvCN~G+aol@dK>CmrlqRKXC0}xiTXL}2dVU{R=NhG
zVXiI3)$2`Y2g(G5Wc!Mq+fp|+w)Ze?3e3CM44iiql4_D_7m`~Ti5Bc6RvZ93=CjnY
zo|mrM>AK#d76FD?nYLq)-7BhwK`p410HA_#UORnzzfx<+z*aIb<I^?hHX8CafFwwz
zc}nfttKNx36Cu>EUSws9Xanyz^sD~>581r^NE~P6{<Vn-jvX{J6TR7)gK$C3ZhSZ%
zea@yq<K+Id128;p!~POkeSEe4RfPb|iS-rJc-jrVC6_<kU*%YFLIjKT72gkm9`z65
zN6_}0c=H5!{^<Ty<vu2ej}qS;f6GokD)tL?9!d}PNAj;H@jBzgm-)x~&*@lE_?hS6
zKZyMd%QYhM4gnrw{{TAeJ|QR)>EG_Z{>xl#qhjs?2mG{O=Utz~G5gIs{m1_R*=t#R
zXj!kqjwc*&YTQ~){P3i)T1@e<;erwkR4tB`>%I`r{35nrH}JRqglL?(RnHcjRGp70
zxU{&maF-E0Oh!O)jEaer40W!%;ut^L_Soc@KlWo>e&dWB`%{bNS0+o9*zfh<`6sqq
z{{ReM%DnrdaC+CE>%a0(Y_a{=zm<9L&N|f7*_TsvdN;$cKeKMh9cCZOxSeR@TD-^n
z^>620x5K6fO}pctG=D1L^`W;~y!G>2`P9ebW1ql^T(jVFp49fYm~vu&`{dQF7=Og#
z&p-3jaBJ91YDXxik4kf?%EbzN%X7qWoaFQAiq-JX9wV_Mub3)@_xyw|fbA=PGgrJY
zKjNdY_45T=_(+e$jSn1={{RUa{{YuDu4EDqrxnup<YUBd{{URpxwSm0IM33QJ`_3p
zOad_<bkg#tp5C?XT79LnY1ZW1#7T*Ip!5~yJ~Bj)#J4Jls-P|cj1GdP6*--Xojz4_
z7BiPqft>o+x<QY##s292RpBwV7<1o>_iJ<eh|l{2`BYcvT@IwJM{My;CnuUimIk@b
zf}M`JW2j0}-c}?6a!`TCxvPl5&kUy>NHxgX=sJzIn|EjBjn5mR$>*K9CnF2mwRBx3
zZ94McoCsYL05*PLIW?SRC%QJAAg{{Ju_7_Rbtl-;`G`|H)PdB4T!cOwzl=u6L~^oB
zvN(|U`?XqaA5gW^u4H9cW6W8F9hgaj&T-E<6uITq73`w+k=uEw!*F4@*E~{OTtx-D
zOCx}&GI7mwnl7I;$A&KL<c*+d-OOroFb__=fmCk1KdW59=DANbrBd*R<7%$a&#zh>
z-Lyhf<93{mwXdN?hj!p)I8ly&DoZ^=+WrY8w{puHnAng;2<j`7lf#;Uxw9meg%K5p
zo5~P!aBFJIO}T?k)nQ;aTwF^eSUsB<%?eV!!6-p38L+a)pT57HDUo+=3^#gbn&OXz
zZv2Ths1g_uFYizKz<EEFSbq;{FRk3%7x^5sM<9~~WN-+ho?V04!}*S{%}tr!rw5ao
zUF+qSEHUezD~h-9)}ppD!y<s~Bw56~FbC!}wXA89%WG>5q)PC@`Dhu+hFo;bH73>U
zCkUxqnA!6b54<{OtvJY?H!eWQ8Ll~eJ*liQCiOmSepK0Ve6hc9$FCew4~KOmy1Zs!
z!O}q+i8|zP4K8_hAF_w@9f)+<yDCSnc&KK)x3^RhJ`9c{P&wq*RGK`o_+#uaAX|cp
zTjuKgXP?5eS47mNm1dqKSNmL2VPwt_51aW@a+28!FpJ%tOc$2d5i`XqIx7_=PeLkT
zEO^fK$F6v;4)aL5((PGHDdhd6z7?4Hs&jxq^r3W3QsYav3jk#>I)su!rZ+8+*!ooa
zN41OgG2fd*x-y`^ETcU+>rE0NJ42~&OxGVig{nz)8yJ#6h7z(FPEaTtfE6?vJ?(|W
zSK=+wMI_GQTP2i_lmSnj_94@az9Xz-fs??h(B9i!i3~D=Bap<$r_4Hv&(&bQ)HF!e
zGzmKtX(HW#MtNM;O_zsmzjU+0ix9k$R*huH3RD60=}pPsL@2^7U9+!dOo6#`j+v+?
zySKErl4)cDHR?w=u1+lnR9oRA#-AyhGWn#I45TQ>w-gT!U&m)8Xa?ymRUa~EG6u>0
zDRau(7wqAGi0l!S##H2EG<k{7&c2;%6H3!>Ep)5PS(pjmcG<znY>p4MD;C?snu6Ip
zaxNXDk9H;DfIOeAHz(MYPA>lO+ip_3vZQ+Em7NuNW&G<3%SW0mD^am?v1XP}C+5!7
zAY!rZG!0^VQ6m%*hCtAXIAu|aPEW8#oLheJ)LiQJRz-yKZ6P<D0(j0lQ{cU}xp!Ek
z$&3QrV}sJUkN8KglG%|L=6fcH?vp<`Y>(2TztXQPtuACEY(?QLp_uOgVTT;`rOz(K
z`#3!lI>)@Wj(FjD2KjTab<R5TRvD0O8;3nIYlqYHTdUh!c_o0PLFQnjmB1iv_s0~i
z;q6vSi%&F{MUFLMCBZ@uG`Zhk_E1`L9dvj0(nTzZC&?2Pa(KZVXpZ*YYc;z`GYbrc
z$7<y!&~+azqgd8RO!BaZ%0R*Ur~d%0T@I6JC7z1~w5y2{J){HPnv;8xC`Bu#T5G6;
zD=-eo!#PzZp02Ke)Pk%s52&gPmkDnKAsnDmBnZGCrCLlZYN2+87z^n^Eh0>09%!hy
z=86P)M~0Fpbt|=u<M(;%p7q~p%2F^#Tvwg=QWt|%yFxMqN;eVL7!~RENEQIt=M^vb
zjHU3IUL?D9NbR=)yXJ4Da=a7kk<E3Q^@Co4GzT&u!BgB<Jsz8Q@@*FG4?~fG`I_j7
z421v(AZDm)R~}^kNFOS5&#iVkeuR;b)1NVq@b(qT_^QHdO<Gqm5frQ$7z_i)BD%2F
zbJUX+gBBzJ1u(XLTy^4{ScSk|zV)f4_;XU!inMU;i#$mu$_V!LuR+O0U5L$A0kS~+
zD&@6=^PnghV?V^%1MsfzO7Lxsrr9n*xs-GB50ritvwfw<cWNTq6KC8YbgpUQlF}e~
z{5otf1!f*&=c{!5s_rrlJu3YAP25fut)y;n3a&+5wDA4Jstm)+kKgZCB&Ou<*v>Ch
zmAvs0`>Hd?t!IZg>CJUsFYxrX(xu&^F}K<TnCEF7{)V|gTa`Ue73k1u!B|2{O5>CC
z%|?#g?i|(IT{`Oeb&A?Hk<XyueNSrcG+zY4X(COi5j?oaPvKMjY1FL>Yf_F^Nbt_5
ztTMWxirjUP#~+8SciKmXEHs7P8hMlVmQGLM>01E`ph1NIU;)4s(uaUpekQ#7xQSHL
zWHHKFNg!m=yK<cMqzFO4Z`P2ePIK+WbBqq)1_d}4+3EBYo?Byv#yc8xvKXLd13Ong
zr6ve&TOPD?j!k)ezs0M|%lET~M}vB-jh2{!gjQqQ(M?=mh#HAq(pXtU41QqUGx9cu
z?5D95`53v=Js|PV1kw}8^**)c=i(lwlUrMjF4^RoK@kF10yZN*F)NOqgwxN&Jyfi$
zbc<lIGbD~@I8rf>;qQ@;T3oC-(ddkN5PS5+JFf@xuQZq9KBW$=E}8w43tYsdw)w6%
zahxvY1fS>HpZ@?03s>0ex>c(MxLb3JgZGXGe(yj|3H76uhdMnRjQ;>mX;c%D)K{9^
z{72PoE?~BwMulE!ni$WXNF-zC&N&Bg!4)OP#642h&gSsxmd^wMPWa_^50Xb1PB~IO
zY*OT7=SQP5j2zMcF<x<P@e@(HwzZkG`&3JnW<v7GkC!BZLJ^)18KiHBnuI8iHHDga
ztg8q!zGWp<us&YF*Ez>pIT&-J(n6f|;*q}Z9Gdgv<IP?LlkHkvwYwrTn<kaRFb%gO
z<nBnv)})ul`s8W|(QO=l_a$x#!A4~u@y1G=dg6{&K4f=0@sF09oy71)E6%0(k$#$u
zrHIpQ<dWu53OdT+L+;yxN{)xqH6%X}H4BSzFtD>t${Z_B`8jf(l#jeWT70aYWO@TB
zAoJ3gLBQg;Y5Z@kL-vpOl-m;tjY_Pt5=;Hx;N$Ap{c1Gv_N_Zf_DwF<=^}EH$qbHF
z2vSZ-UYvEJ%r1`gh)_TWCZvymGCw-=*?u5jM+DO)jhx<032?$WWG8D3jy8G@y$2aJ
z6{p0lM*GMyX;#2a2Hn#hGT}Mn)Y9c)%#TK6mjOWI+KrBL&2R(9db-HVCX;I!Qbro!
z;Ng`)2ONXEVD}W{@!qd0{{YA)*&ED`Hb#-jR&oFhg&=kAXyswdj`wR~m`MYZTpZp!
z)uU;nI%TObG-^PV^Yip1ZOV^xic#aeK%psRV(hTI%o0gS3ak+Ev()~C^rMxE=<d#U
zXE_w0oM+dya0}zTL75`^9haE$YzyZ;bGLW*dE?WXYxw6`7SK=qmuwPNWB|zOK^ywz
zf7owv#&McCSaT!LRP-Tf803-#dDW-HO;+aG*5P!kWRBsPRJ85#?F8h2I&g7NKg7LM
zY9huR8Y!lA4<D5&A=Hh)jDf}vdR&Zr==7t#vy9V~a5)CNvfJXOqjmO!7LyQY5HqKk
za(-aA9CgbI)PEl9ao=289U|GD-Y+z=&PuTKQ;tq@KA_X&Va$&76S$qH@f5p{U~7VJ
z9%{=KywYj*NgR<Giy2?!QMZyd^Y?(`Jk$r`4zeP+l<9Wruu8EIWMwQ*a0t#hADu2n
z9LV%At(=lYDPx>=t^!{h>yfjp+GU(^p>Wc9%tjO^%rFi?^Arqss&@YX67>o7N7Ig-
zYZS_GzGRL!A3!$e^8$`m9LV&vUzmDS$AN%4_pd0p_^EwuV{du=ooeyQ#W1qARfY)%
zkAB&to8qpiZ+e!OnoJh5GKS2u90emF@$F05$ZDif>e$D6Zb=;U&3T>A#9dO-8^(J(
z25Uk$qRiX2oO9FMaCz%ai{d7;HJz={(yc^y0z$c%<#wrVc;g{XJ#kCfvb~}`Ae;<!
zsN83$2E6TlAZqOgnsn=7ln#m=*tpxc^izxvT6%cjS(0arY1UzcjUW2fB(kV(1~Paf
z7^TR^&W`PoK*$1<aRUOp{P^=!Hu1`~c5S#R+8x0eZM@}uYPJ6W#7$35w1#;sEtw>C
zP*IqGK_dj?8RMr~pJyf>(Ie5uex{QwP7hIB6~B$Odzl?#va~x9A0gkJz>(X5!O1*Q
zPvd=F+2KhnEdiMsl<#m36gM1m!Rk1ubmUjGM|SFQoYyborO$>Y1n1{mj>nqD@ZZEc
zoqu10PL{?vl2G3=u{gq${VQX~WBw^wz{xw8r`DxG#-dDaN>FVcH04ra5E0K#pj3%2
zK+5CZn>;QQHVzMe^Y~KRL|$0XgO*@8>t2ULg!Y{-Y-u)NoUny5f8Zjrylmw7UgMAA
zQ~K7dDzQR?fT2MBE1U7It8Tg^)_!7{-)Rax0Tss$W{!z$X;`>#2>5V}f#$FCHQ!?@
zaB;_4;4A|l2zYY<{{XC0`kL<vI~yS56`Z~%bW8Y9`JCtWed@<1HB?>v<V(hJf`2|~
z?WbQLky}<O56q*?BLKcn>Bee^O$nh_X=nZ750nCWU~z%?RMXvPcamha!@9<+g;x8j
z#|P<=gH@@4PsA3lbQV><KqFA3gPb=RKc!Rf7FWb_qf6#6fr)JAKQO5^CetI+gF_s?
zT*SBy>ZiR__;_v4iRTcjj9U?gJ+cq=tzoe*bJbD)wBqCd04JJ>F`NpQfH6#C8yg93
zn5-K`(=8ci-0_{K%PpU}d)EA$RzF}ltUtDCF~^UyuvQ(@9{uZDce6reXrj?0grw4W
zxF<Z3+#Z1aIjhsAlN4WNn`)yr{jSH7YOH#OlISEhqj^p2pf4YZKGh>?dS$^PSP3cp
z<sH52R;1ri4QnkY?6LV^`EJCkC>)SE?f%U{4xghDgLcG)=PUrhIrOV%P|{>U6GYop
zvImw($r<hV)P81%C<;(>jk!i0NcQ8LP@I=>8U$P3+cZgZ0?42M2*~&P)kV>*W0Na>
z%EM@Eu;dQM^QpA!Z7zJ=+9+ZedhkH1^Zx*4eW|3lf#PhE?Ccb0?{YJf_jABBmD94g
z%QqT*q5C{9cvP%=2Tzy`8ijOwUp3-;={(Ga#_Vy=9^myqK}gG^YBQh`tc(Cf+E1qy
zJ<92Z^EV6xtAxvB0sKH`r==XtX{Z{i!ZZjw05WR;X|T^c^GkZUX{6eq`{M)?)MFL4
zyKpd97~`JRi6{0GTsfLS9J`+(i3f%xpQd}%Q*B<r%QjZ_b~i2s*k>t{9k~N1xjyw1
z>GsjevPpdWyA}EP&tK1qujObSU>;~<z>M!CVDnSjT4{GyW)!$L3K^uxI6U?Kb#F~|
z`+%PM%G*$qIR)U1pvVf|$KTNN>rTJ7g67S4-L!GQ4qYGH9P?SxMWasZ6GtR+NN}pn
z%Y3*U3G8ag8Ys7WR+Uu=+Q7Nb8UFz5(Q8|M09dq`$ny>KuDKkR<EcN_^rp6%5DEsR
zE_o%4nLLlJOC7eBinbu|<V>nq<oo?Ns!`kMleo7>!B!}MzbruK9=uSb-&gkqi*}Z<
zTHKkNQIb=Qr5;b0I2_~gKcCWxwAGSxH}-_VcY;tzc8_6$#Zi{eMq9ZY-YzzP(C+6W
z_4MP~q_#~mJ9*<bV8=6wcCo=+VB<dAQ+M4r_W`#E9#8^9Ane5FHRK*B`!VrmxU-`-
z?v$?4--`9CD`;(P5(o|>L52CV-`2ds_BdtuopWt)f#I7d!~OtI^rDa3^!-VfLx#F&
z<lE&bRO}5FbBHEVLtyZHvxfR+uWMGZ!>U|G4&Np>A$Ih|P=*FnYlZ*?I2rDHQV_Rs
z`EJ0bG0&}8vXgpjCp*_|MH;okM;xqnyMR~>kPo+d==84(PyMd(TTczt5p8cdPs@Yr
z=zXa+2^n`5ZEIr?f4`DQthr=UY`~A0V+Ok46<bAQs}PX8bIBcRihPwTwuB6|rfWBv
zT$zRPnaM`v8oj9at5CfRs#e_@cCe55g<<VE&097E#kd@tdehKal~A#5qdeDdp=&dy
zlmf5I3t`*X*BNfCjlcV+^RAyrk{F?DW?&NGNOPWtwI(>4z9YCdT2?LGDN&!4brrer
zf>Ag2k>?;FIUic#XO8Dh)K=PE#wQ;pO?Q6?*fqwnj)0*4be_d^BJs%o0E&`cKjoU&
zHj9G4UTdfE&eP&K0XQC7^{#10?-v|r-n!}hDEH`p3O<LmzzW;Of7u_(yqm>D9}?c4
zpFi}kU5EZX;{O0}e=70+02XuNThrV>1MsY<{7m!kAH;r!U8(;7Oos&Lc>Z<Ud_pHW
zaP77K0QOqpt<U;gKR5BOU#)iE5V?IgbQ@p)0A;PG@u6nl3jVtsX5s+FdhdhS9}C%J
z_HX?N*N>k;>t40s_x}KjTFWCGH~xfbD|{!9L*hBlh<xhS#Bw~3{g~GpFbMwu_19hT
z1+%ML0CD?|{g~Gx2?LhmuAjn)sqr(=HN1bqxwGe;u~(n}01imzy$4wT0FrlR5BDOk
zJ}cMLy-huzsOoNyL-=xYVR^^=v>(c=_>R-VRyS_f5!_34A>7f&Cr|LJKMuZKKJ$<H
zXurz1?S595T)lR3PntlfO7$6S+L|sysCahTc;}A7^g1wM`^D-jqCXI9NFdr={%ig<
z=jAdpnr_^C)w*$ekg7>+OLH>KcQnhuc^R;M&T99Dj(kUBlm7rMMP>|j?^@m(P<%yV
zMmUsJJ&2FQi~c)5@lm(^a$FkbM_lx-o5x@BG9I7mmbst_I5?#bg${ocJ-<yO`!d%b
z^T~ged4G*qf5K03ll&|Eg?fgXr~5YBo;;=F9@XYPH(Yq0<2^R7@~kO*Y~HWHbBp)K
z)K|P)5%xH9{l)%O;V3Zc_*c4Hf5)Ul{ek?dtMn#^Qd5l3DY?hef=LGlsIGIMlN8~P
zO5#^sy0?2|l1C=h++35~Zoti0x72TKyt$=f`|aeM24m~MBDvLgvU$<hXC{{&YadJ0
zu5Raet|N&^iDX@b^lx0&ZlA8t7`RzR;S$R!G9Fw4a2M%T>cv=m$m&HWPW8>Fi6_}6
z<+Wx3HWXvD7XI<}rH@>^oWzl(v6e~RAlW-`pd63Rm$rirbaa1OP<tMg$w#VRvntCh
zM;BokQHWqZo|P@Xi0<b}q+574s+Le+1RUd>no7JwogGF%6wLB{D;;%-rSSZh@uEDj
z=PCgMgU{(zCGiaYW2`FxP3#g`7=<7VpT?=xiVkFSdCeIW%eRTA3Fa(Ns94e29f)V#
ze}=Vm+smujZVZVM!yJVd8Qe(qqBUbDWC}@|WQua0)yLc4%@MVkZ)BEdxMY$7+4%uH
z<F`RtnkKVzsYw20F{%aJ3Z6$j4Jg)(oq<Z`(+@+<9E@hUN4mI<_T?tJcXtvPo*98q
z0O(h>N&f%|1;w?Z03v3NBxf?W%;mi)dua6zbafaEDL~_`bBDwLhe3G07YTgPc~G(}
z%^uLlc>rfPs*~&2m%4q+s)$5tuB{tjgSZSD9cYI-I^qR4k6P!(zd5@RZGb13V#6`t
zkTbZCO0M1|x?6K6mu$hN5yr|+JLHkqw-o)f1Dzd6_cU-T4*vG)Uk&}KF$B%G1zV>$
ztowa-?m4cSWc}h8<Jj$lR_IQBJJ9PzJ1}xc>o}yy92(|_h;E$`Q7wGNcN>|=PnX}`
zkZPCE>Q_JN-Y+sV+FS0HUetSNhdMe=2Q*eri+OQ#9naccHZjOX7pVHxh~FsEmXJWo
zHiF+XA5rO4rkYI+JDM33gaOY=uWTd{A2T^DNCf18>6)<Js)i=)^rbxUNs-*rXSp0u
z06zCx7~pY0$27RjAQ(DPjEa6oLIopZwIPu=2b0A#kVgabsaOUAlLMz(Ok@Rk^%PXZ
z0oycGjPZ{MOEj8|!%LD3Dn}mm>h?ejRp9jWuM)TM3+a<fa}~Ns85DVJ`$;751$NqR
z#5I@fHqz<M6~xzHWR*;#5gtBZameS|jz;9zDJxj)WndiS)L1RYL0o31<HH7>sN6+n
zhD%GovxI3gyl3xlIIO#$h_}|)Ht~yFP@*`bn{j-xd>kMg@#<?>#ggQYQi33Osb;o{
zXpB<EvZ3m%G7WIv74d!kvEs|kK4pn5p#-9Z!}jaX^r>X=_t>tyM-Ah^B(ZR|kq#P8
z4t~7iuFNiurX2@Nw{a|XP^)^C&MNXnw1JW<&La4qa6BY$WP;S{LgYds$q0DPdis0R
zmmd^micK|O)8drg+a!bcn?ku_q!Z`}HBXuDPcl6mpvmX0DNKwO{A-xfyjg#H;;HmI
zjTvF`6MU1cz+eF%DaJefY5LcUn@4N&K9?&+Y-32AHxsjT10#>tknVJV4ZnDPH1Gz{
zH)IO)dA=z{9+<aZ*<Zf<L54_v)VNME4&XhHP%3HuCP!}rOf-o|`!ZZ%r`mpFjD6Gj
z(PkG%pfoYMl{hMTgWj?v@Q#adKbqE{A4OsT{3||B7{r>L{g>F!`W=Y7^E~groP4;)
z9eUO*zZEU**4@)dk;BH1H}BO%Te<*9`H$sQ7bUY5(cfFyTG_%Pf+URxK!X)23aq#_
znWk$msa{<|ES@+aSlT(uWK0=z#~r?=u@}eI{{Yz9#-}Bo#nWami2Tf%TYxdg86<kt
zYRbAh0fxv1p=3?}05K%j4JXA*8+#o-?oBnoy51xLPGM#2c;~mLTB#?+c*l_EMVHEw
zA3jD|fibS~y)ZM|^P<dL$n<cLfsn+~{D1{4Ptv^i{uYc|^#zYfEghVGX74-#<0Bkn
zkG=0&vUuhc)MK<3Cnm$~+x*eTUzex1T2^DaI^w7fGJdqlR7n${KX?(E;2YwSJ<Xl0
zdON+%;zZD=o&Y8L6SudmYk0TDiQz@Hcd=`Oa7e<*w{8cxqReVY=OOq=Ew8@aZLUic
z!HWar1J|hJ@-T5y%kb8DnVMe_OiN@OTc{W#7{_6N1zH~y;eANjN2N$qTN|D2Fc<<d
z_{Kf4#U<~=c<rFlBuy~L+LCSy=Yi$(j2=0s?-OW@9}cghNYy+^IvCW2WVc0bS8hoh
zlY@+&MKVu@R}-wFUlLrmno!A@7w0SYN$0IB{{R%01X7wTlCxaPZ?sM``>>>*pY3$^
zuE$5#t+mZ6+fcWSk~x=f3@}HvOXfh7S;Wimwno%Or~d#61gm%mVIo_qociE#Qo-=z
z^4=jFeki$E`h+m4Qg?37Gs(yYHQ(=6-IX7W3}bDhy)I@xRC(+CE|80C_>SSe%FOWQ
z1^Ed%IOo=#aq!aS?itd55lZpTjp}Vv9A_B*?^DwqYtTqcV+Wc~lpVc*qnU>)Jnlb*
z^22WoG5CU1iY)C5YJ;dC=huRI)QRxg<6|Ruic+U;0k%Vppa4dC8~`#p;=A+rI2rzw
z<iJyf$)lNvDm?UjEtI1u@f6!wFgdqgg@Ydcpc<3@70vrJum1oEJ;r24jrPE!aAqz?
zU+)rs8uTP#w2h!<nhGfU$Bx*g%*V=)H@o;{adkWs%i;-q$PVbrTPkgA=XV|R-kmSQ
zi@9fMo5V7PAx0M26aX7=;BYzSy#<P}%Vc|Im=p!b=so(==3?bX0Vl(&xe`Q|#Bz}-
zQsmnva=&zg)De@&r^)c%;ztgALoV=lWo=P;!5QPe39j=hROj%;0|UQWF2j`^1b+-=
zRe$)O$P2_FC+w(Bz%T$kM+Y2I!|=}H(%L(CJVPqS8;4KyWXK@obJrQ?9V^fd4i`TB
z)0l=`pmHg5Fy%*`H^WKIs#~8DTo{xUP+?vM;MfN~pc;C7IlB_cFZ?7^G?GZNvo*3Y
z-nhZZ=y>g2@BsJYG;UsbAblw2VakpPJ{#PE<amZ%&J;8Kl{XN*2JW=c@XB=DSHu$?
z(X>Q0vM?&mxQ>6?=DYMGoM+mBkPd0{Fy%*{kA~Cvq0YT4GPrTN)fi+Axxw}oXZ{ua
z_E-KYIoP9@$+kjsl6gJGS-3oNS7q^C;@sRt6_iYoNK-826OY1}zAV%*f8t*Tdw%f$
z0EJ&9#b}iiz&d~-Q^c16QyXLZI&2+!FG1Ays#E+c`$fxKO|4F5Zmc2$*kcEQir8Nk
zYB|W$?eXs+{{RYB@ou2mKiTkPf73($6mrkFS|(Me!za`7Ej77g+{(m@bSEluIX>VY
z!l(ZLgbz_(o+!P@A9%(K5uD(h<c?1Ut$)H@sU8NOZ~p*)5BN|#S*eker(6Ae!~PVx
zW!(jlN<W8}d(u<l8OtU>4Qzy9fC$0hjt3nn&+zv9Yk$Q{cZVdhc}ujDj-xp2K9y|v
zvr+_Yu(!^8$bZ6v;>}YW*<1er-)H<N<(G6jM53P$E~4`B;yZ$|mt{wRS$=$O;PHcj
z#Y1oK%4jd;zK>p*TuKOcYjkXb*Mr4q{{X^MsRRE29#-f627kh?>7FIKyT6XodsvV-
zCn)5eDCM7UvM_Fb7PaN9R?};fv@vpv_H`YwGlS0@b5O_djUc&><u#f7*vMsOfm;N0
z>TA)`W<3(IF1%3%ozAE((8Ug(sLdfc-?(Q0diJdOrO<q_>T|b04dl3n;wd%hU2Y$I
zqwJB5&FjS~d_KI1B1Q2f-pIC?(8Q%zXdqx`9SI)!=CzNA^+@d?znem3vYnKF$G|e6
zW5Y6S!2IicoDdIsT+%^gaR=e;&+qf%3I70n_rKB8jxqB80C$c!#VdS1xx@tcf@Uy+
z6E?_kkOohwz#N`<uF~RT6i(`!*e*in1o2tE9oAc2(PO`O1O?r|LffzviuL>{b4zjZ
zqnd}|)bKLOo*=mM0+sopQ^7g!@6A=4;fvhcCA`|q?GmwIzDkUrQ|fs=YtVydJoKpH
zyjz=fni&#E+aNNY4h}lhImoU^oErQwK4WKExeU>HM2LX-Jv!3|!xE-4y3N4yP@;b6
zcvIAM_pZ@33%1rJvwH~^6^uIElk&Mg!Ub9~xz7U~DqTsgr6@$=G!KW6XnM>#ieAYp
zL%Rsb069`Uee12evbMg2+uXz?h>?_ThNsIhJ?LNci<-&GQkB_iDMh4bp9Xk!mz^#j
zrce0Ld==s0f;6~+9D)mR`qw}Y$|*N>tGv6I*%(K{S}FekmoxtWe_#A+DLfP5=|&$<
z4fT=#0LHo;p5mAK(!9Hck<Dus7WOuJU9Gx#a78+WUQP$&T`n@G1Gjp^@i7~8{Qm&Y
z%KjC)bF|?0sX8b8D16Q}=C}uqGTSSVF>X5KbM*fJ3bv9;kuG$2oy^R;mM}J`EsxW`
zy;$<Kwvi+kmgNZqfs7HxdE51=e5=E)GcD92*bvPQery%M&mN%n?N-@=&1%=T%>YHy
zL}&)>xZ|NX{#9SVPVM5E_rM|^Lw_+^SN3<Y-AO#RDA762)nm_JZ>Qy1{sxX!@lDqG
zH>rj3&rh5G0M%N<VjkzEf)wVb&PFPtpO|}9l{r6!Sj2O+NybJi4K;)$Bzk;{jDHRQ
z&2C7{sM|+4;;>Tx09Y&k03h`wpg%Dqp8cyzYX1Q6;$!92F4qD(7UP!sZO{JzTl1^d
zmp^G%-wBO}W9d|-yw&4n{{Tab?_vNQfEo4g{VHoowJH8t?Sx9p_tzN**OUD!npWxe
zh===AZxZS6xOWT3N@D7kGc#jP%PXn^P#^P(w|3W%%L2k?kOd|1gKM8d#{|<%^TQfE
zT5v5OEhtlh4nCac6!h)*fhoARw6lutJ7qyG+=Nk)yXjQUr>5Ny^Vyb=1_YS*5rNO>
zO-eOepcQ|zX7%rn{RXAC)TNqlDYUmik(b9DkT~Pt@&<&O)vv?{!qx)GuVc4Rih6_q
z<W+CA>C@aK&1yqA$dRMxjDPj2>^DzyJl4-($r2OuKSuftRd_WCrjRRX(t-&i3UCJO
zW1MsT6q4Wk#%Pe6G6xu}DK7N%yqO-ze7lKp7$o5Q)zSHCeY4osP0pb4O7VYYNaJx*
z*gr7!>Cn{E+!<C!(-Ouz#j-|?+i%<%00MLRRFThR7MR!3+ig??1p@@|Kl;@aI<P=s
zi%Vjt8!Cr|AZNIzjZQ@#TIo^*CnVtDjl^^yAAX(dM;F`i5bICux3PP;?SiZaart=%
z8RDrMy%AK(Em_zxZN)j{^Ze^hZA@BN$1Ij?#p5zMpx|S*GV<zVw}MM+9m^-*Vg?X;
zk<`$?tw3vP`dFD=qH`kT2J-WO2mb(MYO&O`c!9Wz1Gx(o!V#9oH1^c)W5D|W1&}s;
zvPMf_=f7fq5%}A_x-hH;D=#r$nJ~H7KmC8!i(5;6AVMe7-qh*|04f-QcHoj*B;&s%
zny7U>4c`xKxg=Hjwsp^M(ym$G8Ioj@(4)o+5CFq-*neNGMm302<!w4`+jni)Is-yZ
z?OFZcYg#;WTdc7z5a$4lVB~|x*1UhkA1{n`NrvswV2pc=e_Hl5aLMwiQRr6{<eIWG
z_~%s^+<>TY?0Eik=<PpG)KchjuOFQ%#)?}ffCU<}EK<c|A0h$s`?>4+bo?uB(pYrM
z3(ZbN%!wmK06)a%{5sbj^0UZUnC>Se=A{zN4>@dECHY=e<y7<s)Ynbmolbb*yCWFg
zxykNN`8C5gCpoUG!U|q1)dy(-PCZ97J%K$*b>{nZ%Rc^djGxxIspB3}5s-TfR_>`8
zjf|*x543|-FD8yVcC(s2uBRx&(u6i-7@Nuu+ch*dY^o84MQB9|KAj?j$;LtYRx<#t
zyC>)=i(<;IcYu25im-@V%EorE+TU7+H_Iah+N5J0&1`A2+eW4-#|P$82YNt=CA@pB
zJ~fo)TSvfS*KbPiJ`vzt>e%n)pXXj_Ex=pp!26EJk81R<gp5AZst)^O{<NOMLU{49
z;zl3z$$zbLirlX~#dO|0O!$j%!2Qzo{A-t9B?CD*71>YWN6_K_0EHhz+^vW<(R%D3
z%DjigfPcbGeg6Ldf2DfmsRq&${=)wND)Mg^0sjCAHSd3%91o>qN8)Fnfc_)&F)hdX
zY&iq{V*da-?LHu!Hk@(B*Z%<7Ym9+NyNe&+9DX&~{6hyicl)pXD`|XaoZI1F*JFmy
zr>{!&zX%X~GiCnkf9OWMnEM*_j|dU}00_OFeH;G(LNztM6UL$O9Jj<Hw^z3R0Ina@
z*Cwr=2*4H9{6Qo8THF4(e^XqNwgCRMRQ?o2PmP|3t^WYYJhJ})b}p5`usd^~%DdfV
zkNhi}OrPM3rEn#<>^`QIJ(*QEN22^W{{WDE?<f6g{{SlEHO#KJdI=xvTDvcY4gUZV
z`_KC5zsk7Hbmv^X2ehq9KN}pshKRKI7VlGn2hPbHDaWOH5%_<ls5p|~f53<MR|TUV
z_?+2*a6Hxib?q&Yo=-}evT3UoN-3vv!!IHbUe6LY%N&fOJ#Y<P@XtOYus`(FRb5M+
zPV8i7&VT&~)vpYaJV#^S_rO-K;WA$lqvNyx02Lc&{&}r)1B?pk{CENJ8xzOwmxEls
z2T@9&!h)y7&vDa6G}~Ms`C`AyyvN4b{{V!d<d5#J@~=(PG5worbN>J=m-$zh_}e4I
z_c$l+ukx&Ed}j520}3)ruRPbdK*U<bo}~x!uM0*S*RFW4bhXFXVaexU{#5JqCWlf?
z=Z^H?4;0e8(yl<~>s;qR*0r``*@7Zp@129@`uftfye-2;8Toedqo=3Rxtkvt{h{q%
z=S`N{*6K!zD~~Z*O9Dm+>N*<KkHtD9klaYO@szh2kn_MN8TT2gbY!{<nKM#2;*E(|
z(O7^o7aR_PlkB$nAGnK*<K!G?ujg66@Rev~qF?P8ftT)so_WXN$gJk^)|O-67;>w2
zw$57$7diR<oEmDBpFrkELM*LBWks|hNWmKh2&7v(bYM~ll&K|ffMA}cv)jcQEOyb{
z$*4o+N=Qb@<c_>`sb=vGlMT#v&wmh_O}kJW=RG=l)cYs=p>$6!nQJx7cMh0zZQm~&
zk8JwXhR)QN#jHO+-}wj4^{O|T?X{MymNS)5VQHR5kN|*tRIqEBZPuSH{1+(Jv1B}e
z91L=QoiAn9!J%~_ia5NbjTSzeLV!Oii|lr-5Qy8vVqQWN7zfx@R@d~f!9Lj@OQHeK
z-fmQWH41p6M3On3H7E+gGUs<}<MI3{`#0EkMvvJo-Id-5nUjSj23P4)M;vLmA}ZwM
z;A1D&vcKUd(Y%<X{?LnT#HtaVNa{L!)c3mPo2E>WUS35EkM~uN>+C4@Zu<q%ZaX`8
zT)c2ZjC!)51k<Cof)ZLNV@7YhRX`@FFNn00c=ms9htE)VCVd7^<BDuvDA6QIWKBxk
zq$(NPcR+ek?4Mw|FAF<mXJodCOMT)H0)DiuWoXJbTS9O!GJ~Z+n$3ghhf-UVHeeEE
z=NudwhCdN#(pyV%nv4b*h*xdg0(uHw&&V!|R{C|Vw6e_{V96tvXCM>LV0|g#!q9IE
zZ4eLl@Pp?1)dS*f7+EdZ)FBWv6jvvy9Y7T%ULn$@xPsn0*xG5-G-xxH2ci8a_EuX8
z=(yH)=0hR3h`AUouw;*|Ml|~%jDpetq=HA5FmY5hZxdMQR}k8?izU>uDtRj3GKM`(
zS+>_S+xy3~w!Mm3(>X;v@z)--dnaqyE{ld3Od>BSJh9O>j1R)2ds}%6?}8`ajrl-#
zW2Sv;Hs8dSQeNEJOhghxKajhR`ooOyDaqn(4oK#aH5f`mgCPf|PBZz__HVFV8V175
z#jx8#Q#sqPV>IJyZIXP5`5>Q^az{g0@OZaOp7wYIfntnDvSN6UzHk8Ro+|#Mtm*nn
zp}x9~4f)y_@_!0m$){@$=(4cG8#^Rw8UFDL%YAAwX>Js#f-tA33OTBc;w>IKi0#_`
z5j21mT=H|%=}3G>q<JDww?(w4m=F6o#(z3~&GrkUMkr&6HlnJppcoYLzNWJy@fMLK
z#FpbwfXNz`VY?Uulh3tB{{RV2hHaYT`$`WfTWLGH`eUselI#~osle||Ju(etTKJnx
zzSYi~1cjyY)<tZ5t_aQteB+wA75dG1_VKJ^VIY=#F(c7?kIIJ`Ezl;5Do8%m;gZ~R
zrN?>)dV+*Kcr=7}r*eHoA>+Lu8gbT|KD6u}rxeq`=cP*+huVrm$m@zKMtH7^WvA*l
z_i;-S$c+}#gku9Z{42Nr0E8DoeKH$kWwt2T$h%yESb>sHeuBKRX|8QG+bDF)zq7r>
z!ZvUN@Ok7Owd)$_)$P1EX0g=OE^T0Ec6)VUF#|vF9+d3Vw*=L;Djx;-eO^*@=-kM1
z+nAjGwWAM*w2*Dz`##*57i?Kfl>??LBSqD&A@I6t+STxrdU>qgTA)GL40W!O%I+(h
zXzmdFj)B2rj00L~EeWl(`#W2Pxq{9Fnf~;P7z}?JbLhHF%&jciWvr6FEbR)CPr1cf
zx44C{q13S%05IfK-fSLb!y@^ffb&#@X3OEN7D<+7(ydv+-JdLV`gE#q;Li^_1v*q9
z0kjN}ft>Nrt#k%oEi!o?y(@tDg{tbhefE#`EAs`k_X`||i-tV^0DIHgnnGu3X`*TN
zck<ss4%?|?Sl#y%m0p6S)U>-jXHR=O=tQtTBp+VK>sAnqXC|w@r)3rNHd0Qa=3rSP
z?m+5kjK)s@cy!puYxW$(l9_T?lFid3_ob7-niP<<M%qSG7>k!A?FS%NPJ|E$rD6a)
zfk<{oBt9Kz0ppYGuelRq{_ynY{Au%iKk)s>*@U)75FkYX$lRl#Z(8Y@mu`0oYfF)Z
z{&dA;H*b)u8U+eCPzOO=%lta<?9)#ymhv%~_sBfMhB?nl>CWYiwlLj;g52}(Tql8b
z-D6Yn7QY6mawYpKq9R7PMdkC4$aSO-%+*haz8#M$EgNQ7gf2>r-Eb<rpAWn|Wrua6
zGQyz|Oos#lP7mU1SH*XC)_xqlyVB%|E}~7~%DaXKTzl46g0)$1yccPyYIj@Q`Hdv6
z#{rM@qg}<O#K*w88_Rb7OoQ!9wp9`kq+}kSfT)MV-2=-Ji+Og4{Gt2Pox6*FGhIEM
z)wR{UcNX#oibdRw>MBM9j5kh{uE%6^Q+NkKn5!FRRzyUMtB_Y`OnMr-t$1fn*I|Kg
zqmj%R*j37&di1Sh%VRuKvPxk|C*G4|NaYj2x*3_LOIc%oE6KvhLY3NA82TEoAH&@O
zKPzk#g9~K{nDJd{G6n#iC_M13pI#`t6G-Nz_<P~|h*e~^k(5mH03;*keWAbf5nT<n
zoxO#mHkQx`p@;=VUVv2SUAv45a~D&bfGIXKkQGoq<u#PA&$MEk#0(W-&$S~Fu&IBT
z(ik1vcVJQ+=OuGVh9e-;nTU;f$sI)k6<I=%V>GFfK2eMsXUuW|!1tvY3$>dE){x0?
z$CKKj?}9nSOqdIhbM>aN9QHp-23F+c^vA6oMif(&WaMIy<&HR}NQ^){j8X?sKq^S5
z<0?RJ&X9D+6ae7LSY<Z#>qycLM#6rS-MGm)^`@7@aZ1CuHag>vN?d@vFK+Z@@J>0P
z6VT#;4Fnd(KT3HVb;zcs;BY|4tv!bn0p{6e)GzQ(KGOdH&Ww=j%_4_4`i9&A_Lm>6
zMRRuzqanDNBHx{*o31%EyuKk8QzZTBr+cZ{>Cy=9X9&d$4l|G{Gp}i}F6X|80s{lP
zv8>HT9V1`55*<wuqlJ{HBd1b%rEcPHO$}(ZJ2_&WXy*+a3z-;y2*zr<_=ig{EUS3C
zcWvl%oO)Jmlv*8znSB&mlKr0VF_Kt(ykm-rJs(E5mK^G)Ns;4hvkpewDCyG_Src}2
z78;eVr5j0WDRoxbPBG0~a8D=l6@#bhIyRMU_EpqlA!K8d>P~T5DX!_#%8^BT6TF8C
z0qSZR>{4a6LI+RItmtv>@fEP|<-dA`*yp!Ov7)g)Belo(9DgdP{{WcI<~XqU?_6)h
ztrey4z1_{61*Y?3mTkP3RT%v^uGTp)`Nc?Ia3GB5s5Q@fJDOVR$DVkH#ZsL&Ouf=C
zEn3?0M2X^&0~F7%Jx8Tt>K8W>*?5-r=IU7W3pvqkLb+XwmD_>ec1?OjdJd5d!MKY~
zv`LA{b%jCCu4(dV+I07eb2XeYTqoU?qXmbjHC)MTON%`7Otza>@kQCZzPed0;f8M|
zWx(CHk&jH)PMaISqi9#!eZ->p-#k*rvJwn?n6_8200a2fs-=a5H%)aFtSLKnkz*T<
zdh<+&Pt$F#9&3A8Vv+vyBw!Qu#T?<tdA**Xw|eBs73A_mbzw1L^5DqIcsq0Q{VJWX
z3E>Sb?C!kD6g1Zsrr?e0xyT&+q-QwqUY{P7rNcVS4VAJ=xgpjd2+v-9>LH@&;@`>s
z&b0}<cF_pNeSWnrXlf^$YC4tuyqbjieAi?hIu;w)vqr2&Nc7^hFD+%0R+~)Hu4OjU
zY2INeD;zlct(^5gt#x{KieuLAbt{t@Y0+Vh6yz*x_3BM%Tj}<eD$8qa6al)3&@O)}
ziA^nvQEcVB6XsuA9YRqmu!(KLyRihX-Z&@MkHWgu2h3WIC?kb-L=_X!Mlfm0N18H4
zVBO_&OIkKG!tgny*_s2c(d$O_>s50h3LeISq<0jB!S700M^n;(F#JXUTO5&(v@bQb
z#B3wlu{=a~$7i$?{*b&1*ettGG>xbHIQ-64VAI0L4xum+u*Y672Ty8}O)}El!v1{I
z7mU71>Z{IA(744+3<>5I(VLu=2_GeJ4iCThRIMs9nA=E{#TfZAqy4PleH4CTuI45N
zrkYT*h9Pk5Ata%}{{RoIR`3E_uZk`VE?fN=_4LaB0EKK{TUx!VGgu@flZ9m&`qo!~
zf}a#zZMX7(w{F0H5UpVJA?|u8A2;JxW8iXms>dPt=~fYm1JbNxoHoObxZ<$E*JNT_
z$We|s=QXzBiXE+jd)7eH^&(f!)QRWj+M9U%D&W%WCMC2Qy14UaO`E~TQ;y=aZbXt=
zOpviz83<G8am8gWl{cR6{i`m*<gx;N2L$KZw55gQv+`0_SHK=;IXL<p^G;1&Fe&WT
z0)k|Oobm|hFhBbB1dpw(fS`<$004CNCZ8smdeH0|o3UYr-JBkC>&F-sZ%?<ow=edq
zfhO;{j@5TbUqKe_8sXs0(uI&Q0542-s4nKzW1W`P-6T+;f=_&m{+X!EI-mBCbhuBl
z?iq}Mow(<>uf18lj`m2vv7RJsFgwP1#~-dg0&6`Kx(v%YrmiNHKEuRk1b}*ak6Mu4
zYbBM1nyT$N=e`C%T+^Q0Szn!RA>LDN2;d$$10PyOw$@~VQ6=OV-STW07|(tWY}TId
zkd2jMRAh6GYc5;8Stn(V&Nf0{YiHB$=j&P#D<o<&k^ltN2_n^5<SBI?H++f!A1-_F
zdsa}fMY-jkD`k=kb!phH^#k+#stq#c`rw0iY$IKyXTIQZRlL1)V;44qj($RU^{Ejx
zkqhpgBPm~$?cg3gzO`0Xwt^wK)h~s`#BpiDSfeZp9P`H<cgd$6Ls^Uw{hSz)kV)u$
zDSW+jhQ!wR9SI$I9ld(~luFvfcI-|hc4YuYpx|WZ^u=Ghval1{Uth~|Qs&Rgj~G^7
za(|^Z`s)4}*=?-^s#hVH<C=yzHQ2D`SQ(gd2si{DIQnPt#W}yV%o5?CHyIl@50@SD
zj`cQIzJNlvy0_X{4S?9v5E!@JPzFC-)vNo9xT25ju?ZNuhxQp6{WDcWI^!dTmfRh@
z6&?BgI)1c}L#)KgC6X6Fc^Kr3anG$gE%XtiXDsvDBhMF=D-5!A#d#NqZkpT28i`U=
zGlXn?E7-#k(;~c&R(p9oQ{qc$^XAJQVK~pum~4JHtD^Lur|KzmIjwqp7%Wka$QN__
zyK;Y^{3{Q=YHLbO`IiS0s<_Y7pVu{*M?;g=k|BwK>090uy7IL-A}zPgjITbUn!yUq
zoq(JS)vYYLYH%|D0DNa7G%!Z?sW2vFJsYRilf*EQcN%S6I8X^5)Xi0b-FbNh$-n?~
z=Cu4xZX>mZa7iK8nnkj<nQkrRXk`0^NFQ8RD>{{yL?iC88LsEcStU=GC4fBFAF9G3
z)-Gf09Q2_Hki_4*2R#ldWs!ua%h>1es)*rHkb(|!2&Y8u@&!&Y)|n#QH<x%x9rIq9
z@R9SVYTlTSAFX+oryIv~cY+(ZBL=+};PGagQgi5o`O<q0ZfW@Szv7_joWj4>xkYcC
za5>F&K0R^&00{sce{#Rf*C(B=k;Qe>_)+v&f8j^a_e&=R${b^aT;u2~$^2U1@l)St
zrt$oRSN{Nnqgn_NZ>0(b1_&Hhb<M=ra<sF^WR<@2vB@<w>A1VI3^p26rsUY`at*{d
z{`mfN+I&L;8gc&sW&Z%BaTdJX#n17Mzgq47As_h%bB-VX0A;5?jU1V`!j2ccddGx$
z@Wq(NK;QZiuPEu99%|$o#-(c#Lj~;d#-oK-APRGjGO^-QpDVf0{6qf$kgc)D{IUL~
zxd7ev^{MYKu5aC5?s+9(Hmf<#1y}FX=Bg^n#Lich&qLN5{w>X?`;k`!GmM(<^@4xl
zTv?CyBI{fZTNwkbMLn5SH(rOM{5a3pufOY}{{SOgcD<kN%isFyYp(cm*s;AiAL|$S
zS0Amub=%zk0MAyXAB~kS;h@o2e{9-&O25v%to*{fA_?Bwc;<|N@vvp%Jc{Utj<viW
z-$nlbeuWhv<*-wzqO~zKFn_ggd;b0Z0Q4hPd^FhcE}#DZU4>AdXP$W_kPXr?W<KYd
zzu~-p!bxG%{c_d6gw1?LmyeJ9REHn)$!nG;rvkd49*_8_&jUVE*D=?v6#f)CpA$X5
zODFp>*QffW{#E7vHwXR_i;VTc{{SkI9~<j1K#?JUDgdJ~_7#h$-`r}Kt#@^_%D@6t
zU~yT(n~bi@sZmNcMO08+cjmp))BZi7<M;>iuMJEI1_0_S-0gGrSa|*g{#2{%ilNkb
z9Px^989iylZ#^jhE5>V_={Z|p1eJ~pd#m@B(g$fGgdiAZB;=pO)Ggp9YgyovP%XOL
zTg8aL+JS>}>UgfTZ!N>J3FF?QEW3t9N|Ge19UL;Ag-%6j?Wf$HL~|OKgU$Y-B=Oz(
zFw7(KqX-UmbiwUSJ`5sbw)6cP?WuSoWX~fx8T2*P=iZEa^GCIw*A7&1SAGHWz-aGw
zx0@?+rv+T+92%NW1i#ywSZ_i?(#0{0%j!^L8T78e@+mrc(e0<)IT3-aczgR+`7Q*?
zg<yDgvTg@=tuspS$g$Aww8`$8bhs_oq5?62?Oh4<6xDT+GK?5{gOOA1C2I#Nz0Nk<
zz=bZ7OPxXHK*60hV{<4WPvM%1FNdm@Q(Ham;@f<=Hl4~8<ahp6+;`@K$0n=WPq=bK
z=5+4~3oETUb2__Pw5<3~zFcEGp44le5M5(bOXa!p{y`jw%1B@ieQT%B6oB)|%`a&?
z-r>r&IVgM%km{4%t<Y#>F6xY@<YruP&Ob_Pco++D8r;NjY_J{C<QyF4yA09KN`BUT
z!<8KTJ{n~3qv*0;G_2u=n!`BB&OVh&=fOrtc_O=5-_43t9$r8wG05*-Z)#~}4ik9a
zjD^oQq^ijWDmc;LNtP(KY9q}?n6sFH$dei4vEsEfUkwc=^)4D^mu;$Bfw!jK_0SW6
zMtIM99a*(z3Mm|&_k<+7)#kfP?U7A9bF_Y5PFIX)(xlKlBmIe~z1P}A$+eas%6BH?
zlg@EnI3yf*p!-qnXKM#4+~p+jZgs1TN;|!>Tsv<YbMi9akFUK{w(t>x%6oUbN8S-p
z${dAO-Gk5auFyDq?O@nAI6Wy;;Bs?Ewx4k2M=^Qe^FF*acy5GKMq@Doxlj}kK_2<4
z-Z0Sb^%>!pPgXLRnil1DfPTNyyCTD;4Fu=43apb)uyU=ADh~pf^$UBqxmH#3+DMs6
z1(bH@`P6IR21%1TgMFPyPb+8qvJJQ{e!c6s$Q`OTkw80`403X4_S5bhh~s1M0wmXa
zuJ=PK$gzT_bbH4*=M>-gK&2XKxBFZsQsKPQ8OQ)&VCOlm&^AUv1Y?3J49JWXq)^A8
zCmEyL&$x0#!Lab$x^}4r;$CmXvcWKP$$g`Pp4FhbYc1fAGHeqWzVFSrf-#>?YWQI4
z8CVrP2szC=>S`S1_Z^Z90zD}>pzt`PE-}sqY6=%4y(a|bn$7?lh#Be4H_T1p1cQHF
zx#o}(9(q)4c%}N%9{nm<#$*~PF`6n^&z@zs^1NTAxg!mBFaX8{drq#o&~HWuHts+1
z(_S#vI-a9&F0E9_b!O{2#zqVC$ge_ecUJKQgK6;ScXo2jo?NrffRTg2Be_0;t?J2+
zhdJV_P5%H4^!GBlh@pt=Q-Dbw>U~c^gHQN%E$yw<;!4m)?U~63rx^6+x4cuKOQ`r#
zO)|kjk~Bq)Nyc{7Pwbx*YF-O%9^%f<H)KeG^Nv6m<nfN)wW4|ntx7s(jM`6!;qh?1
znn~fYJ7GU`G2ng!(wU{`ULe*qT`yC!7OQjS8QS%yZ!%6!Rk+4GW7@k-7e&4Q0E9^B
zTD81Lo=Jo}PrGnE@s0?r4-aTQHPB1w&`)XomRyv%f0?5PuF;;p#A7u{io~!7@y55U
z*xlXF1XfD1La;edt=*5WKDCwOZ6<vqLGaatx36<7cc6Lg*OSLzO1r7}d&FKD@muRY
z9gFR--7Y7IyPo+UUUN<HWtWOIcr>9tmFCX`;^skb_YihW=aa`@dT2~1{?qWs#C;+U
z?OU6>ZA4+xR^yzG2TnLOPWwl?e~W_IHH)~Un%v5>s9neoeo#7Niqi2aYPa4p&~-R8
zOV_uu+R~l8@^V1uwI_&T)hs?GS!<TMMb+iATL{X;ypFjaUTKM=(QGZ{wXli_Zl2-M
zaAuGUx%D`&H4<x@uf%;%M4MZl7*+yMz@TkjI0M(-y)w?>?kwY)OL-t?P{t?5<vxcU
z>&|rebvV8!-)k~x_rlItnl*nbxC5WZ6)3mR%kb*!n%0@F>5}W0F}{}}2<wf`er^ft
zkC*kURvtOMvG`WnjLc=fNsY8}H$OKxC+GpGyeS5)rd)WUYpoXfKHlb7K#wHy{{S!7
z<`tW!cuQ8)z8>Fbw;Fu*w~<_Zsvk9QvL1d=eR(wQiL*8|*nClK;vG6zt#uZ%kwV`a
zsgZ*>cTf)>N`t~zk?DRR@x|<*l(%6i_XByY4-0EvE}GU2Hupnl4YGxn@?8ANqo7{w
zN4;nGdq~u7bx#!A-syLC&}%5m6w*iXuMOAJ?@}36tu-GJ_zwHTGU}Hpb0~LM5%Cy|
z9Bs$vR3x{WUxGH%MR6oc3o&#~l7lH2KEpL@Nj@mjJTs_xVr>R#fJp>*3UHtw=j~SQ
zbbVr9gjZTDx=irhL^mL8W?aZv;AcDvVzJQp6HB|c(yZ?0)h=!!lHGROxLv9A$2E7v
zwwKpec78?l_BJuBl3dFX0N??E&*M<|4*vE{657J^N4m5&(FOBm04w9uoc@&u#Gmbn
z^i<QddpYMfOhocTGqDFz`2PTnPg43A9tFJA^-WVz)u+^Mn@6?Wu`I2f`0jp!sK=>z
zqr{qYy2hIpq4tAte$FD11SuFlbb@kCZ)rBSOqx%J?etsQJu)R`y112gd52*b<J6q~
z6_4S+_)9z)J<f$5i1+r-DQIR4RYz^v^y$SiLsr*rW$|^sovvP7X?D+MtcE7qJmLo|
zM__V2E6_AFxlJC`FQ*e-i16|$$ZtdWVz{pm+uvTpscG8Qk1g}GLF_Iq;^8GLf}oB-
z-OoPt*LX`$xzju?r`g^XHxWmN$<8?^AAmTd_8Q#V34@Snk|yDgGaUNU+~Dmw$F(%5
zJZ&bRp`}XWa{-TfV&T~3xb0J}#&5YwJhVC6Kn(d$0k|IYxk4}-CWgb3+jyp_0N?^x
z8URwb$3LApcHxdQ^fZL7GC?Mujg=)=0+7(4hE5LBeJT^RPcn1vYQ|0u00Y=m1!G~+
zvq)@31mtex+L}u3IB&-^^~XR6rZEKL2h*BljUeEB#}tdkdXjx9*cin)AnF&4Py<NI
z6VIh4#REC#y-1-5+Cv&m$$|p+?kE8dJOU}Zer%p;>QMUTm4bH!ia;(`kUIKPBw)$%
zj-HgOgZFqe(u^{FXamhNjY9l#5852#@v1tuk~Luhw7y@ITefqNioL^X7v~)PrT+k(
zJpR75yuKn1RQOif)+r!+)Kf4}f$_%PPBTH!blGnwpZiV>Ojv9TK3&~0?^?RnhT6Z`
z@i>G+SmX|JM;QETE<XoOJiqkF_JF0v)10nxidPl9hK~-~&g!YFLesPHfVewGF^_6L
z;U3br!bYl|NQ^TLz?KW1bLmZo!S_&3C64g~m_3dL;6cadQODq!<H$?pB&V0oZ~+|t
zxuWa1toswkqv_^5dvUAUx{HODA@c4Z6Y~4ypVFp_!U7w}rWd?MSmSOFHB@*m<zCs^
z>K5`aHsP??Z1Y_fn`<SFr;{|EW9}z#B=tV#lYN-d?uo7K*4Eu24)OqVz1u8v&sx2r
z;CPbLx5)KXun0VwwW8qoj@0e`2c-?)%(K2s2jPcGlmU*psFSV=oY$Cms^0$7UexR@
zro3mpw-*+LZX5`TWWF$a;~4i9k1g4y?2k>zKX-xBkgA2ob6#vOl1&ONQd_&oQ&1@s
za3rns?Mx5}KQ34veZA`|`%3O_4(XRNUQ0YyvB)kVNy^9+u~m>9{Ka_d{b}+O&U)F~
zoa6PX_w)Uh#(S8p-gzQI%Mx{S=qnS(FaH1(HO<5_&W{`_=^{HLcI4pKCw-_BscYUw
zr7%zIl$J8L1mXB6Z#;e#DmT=o?0Ox&>=G@y%Dzp^(Fr`3KQJBt04&vj6CF9PH-ZQs
z#QJQ{G{!@utcm`T>%G7j83**Lb~g`op<HT@uR7l~yvsGZ7FXSpMo#WA+W>LJ4gt)1
zmLtyXzcA=(Cb)&C@;t@!O7Gd8aqC`bJ*?Jx4UOzq)83g>++15ta6pk2Fm{p9jOP`1
zOoGyX89^+U7e79i1gK=VWoJ3>&pZxCOxA84Zc>@vHU}JlY6tmnSFUPyVgVs)BE|4F
z;AXJuX!a*b9N<%fxjg<<p%e->bBxxOFc7nW_p$9wEX3n9@QORoP#(O}u*`jSSB-4B
z88d-`D_>#ToZ}UX;uzJW(}pwtkUy1evBDm>$2g+K)BYTOXFnq9rCLZX)z@HU#yRQh
z`O}0tocWLK=p<j6)OApP@A5ybQ3<68!cMaVXu(mP<S$%w;MDe)`dyPsVS9s|?p9vF
zoc8r5siP8>t!b!rlIdIf*vQX0sQe08_?ms#2kh;TKBA=6wTos_0!lj^uS#ct$bS<|
z;~+J$JpDy$3)q*r=m+m)in5%6RmKAzYQ$Ld6<{oi3}s2c$5B{+*-=JR&8bX6=R4mS
z6}c!w8*lr#IjjqNJqcPSj!?vaR5RrAef{f5HYQ0HlVjzZqjv2R0hTX;fI+QAy|UT@
z-N1P2Bo#_8?8OpUM#Yon4IW7Y9e$l^nO_gPe9Cg+cntiGgN)T%n|p@AHk)pMN_95^
zU{*ig3=&Rwq>n;#2=jFr0~`=lxZ~6Ft9PeIytjkxEH*NqFC>hNjQ*fgE}+q_;EAQ3
zRy53N!Ld}QD|P#YVpP&3S(X0)v?gWA$SwL+-8$8+qiEh?Aud}z{{R}u`woWqM7ayJ
zbyfp8ImzOdEh|kj?Oj4rR|=pq`s8ztxgDuJR<G~_X7bt_h*(P7ara+1+It$!IyJzP
z${Le}I6hhK0KxrEe;S?*Hq2Yg8W}vdDy*yk`@e^Jjx7S(8-$f+xFty-m*<>ko}-}Y
zQyD1ff52wKLV-et=rC$1E-h!8NTHP-<Ke=eyU85>ApTV*?W?qNT*K))RI=Qv-^&-B
zD@!VdU%njk$m5)kps0jYuW_@fDha?e2*(FC%s+>;pO!zg$c9zi2w*pigXzyt)YZ#9
zFHN<%j^aD4x)vmt2X=jGoFi=?;3H*}lh+*5?f2)}p=--U0GZ>#>GKb7@e~`oV1L)f
zKj1>Mvl(C<3>7rZ;4#Ri8{25mlW`t1{ozrI$X_L9j~z3*i!dfGGthl0rH`Pf{OFYn
ziBO>GLCz_%+`|G1WR+D9LQh&Oz?_g*it!&1%@wbY?xdI!g5h#h^N#-jrF&Ys$eYoX
zf#^p$72#enmv4-99m99;g>+EbexIom=vCJ(nj@0igmN-2f4WXZV7bM0{vgxDnym36
zx<@1{Ew})&e1Lz(xiN1ek~SW_=^|MGa;JhueJWTbXr>PtA-fS)WYeUM0{c!t&pwr0
z6eV{OJ;gB_)~qh2wJfB{@~Aob*G1yUaiFevA+kr~TyBo++Vzqv92t~#_pbBBmgV#(
zz{yfGQui%vQn8RpYils%lmfV&MpF8{!{<M|IL&oF9aNu7P5%ITBEWlB9_M|;>~Xts
zKdm$;u#T*8A?ST6QbLX9DZx|Ltl5t?(Svq52Nh0aD9oeRnq-dD43akKT)U7C<KDd!
z;MpOyJpTZ({cFyok~u6xGaog6P%+lM1K`muKC7SlXZ>kChPOI@9cdRb-6o?FZiGe=
z&PU2Y{{ZXP5XqjS1lPMD1#oahC)wdc#7I7hD@a!5R<Y>O$2xH3YW6%eEhmw46nXj@
zwHAY^%mGVAKky;`HSEST2kwu`jtRiUSGRqNd4#$|^F0s2+Kk$SPkRA|-55C~f!%}C
zgI!OHbP08fIGWd);3TS(jllIErF4Ld;*{X@sC656II$IFU*bH7_)lH`0G|i??_cq#
z&xN(6JlM8>-(T^sUn@=HBvba%IX#3=9c=?tjQrMYKj2ILH2Yr+>bH{xOL7K4ELdTE
z`q!@zGm<(|{GjHawqfida^5GiYi|ZeX&5c#d263sSDgKw$5lU_dx#?##}uJZ_5h!1
zQLD;1(&l$K&xeXdo!|rhS}*df4;5(Fb~>c@MKf<R<sT!zYV|;hxxg9vP{^*kSOO1X
zGf7lxT*GwJk163jPXeAXf;-o@{esl>w}Afu+c81Y?D78q9*`gVW<SEO+xZ#$4>QBa
zImL9|4AJgyHF$3};@$_`&QEdBV!bE(Hp9J@zJKeI{{V$fijgQpMOEkmj8c_rt0Xwl
zv%6;j<J}(M-mapHx)On1v-eGL1OeW?;Du${$`~G?imm;br}K*&Zhz^L{{V#%t7T?6
zQM<Z4MMgS|`ce=GuW%Y&hIp~IANI+A!koHZpVRDC!~WSX_*Hv<B7KLM<GMDHbF1DY
z7U&4b-r4)3J!{%g0!FAh0f9tNK>*tfNgDbhflpzdrDall#<bzcAjqaj7{uXD7=i)x
zH6{i)ppXS-XnF0vgLC$6JqDX3cahBPb#TnMbvf^xoa9woo84E#T4Yf$mMGrU)fHG_
zB;CRMtI|On)HfP^mE)t_+CwuZ-7-cPuhTU=y^B-sax*80<#(DZnb8N?!YC_-%8lpn
z=AgK^*6ruAvzqec8Ez*)$+WwuP*>ZnceouoR8MaVvd1&Rk0eC-Zd4M4@Nj!k$}VGx
zk-S#0LAkC3=>nBhDTkAB$bNk>Q^5WpI;HTsmh0^88*F%re(d(ZC#`mQ01Wl_qYFnU
za~N97YGT60EShi~fSyF#<^{*O#!0SH+TX<1x_y<ku$max%q&ALOPLt+&!#KVX+B)^
z6x?nKRyfjpNN(>O$v>Ki!WckLExuk4T!WgdgT&1PMw49>W{dZ-6yBu$@GyE;c1Q=2
zN(jvyq0DpozxJh?Y3*k7TqI%Ea0m?fL$sXx))d3VN@7Nm<T50GaHbrS^KLoq(!1Z{
z=rKw{pGrAFNaJmn!~<21StppnZ<!24uF(!SH736%zBMTgi%hYqDYsbm?UA$d2FcG#
z>qr@<o;u==Q06%kcj5%RF>ILs0K~zYIbFU^-WRW}W(a&qCG3~#lQrqHbWr60MlLv9
zA58VHK^P|{myg5gOO!c|7TtVHCAGRW+~7%c13p)Brrv(M)`o`K$ng!rUCT7~fmkCF
zp;Y8!Bd%+z7$c=Lfyv-gusIxQe-ggAb(fMjN15fID}uN?Nc1_Yo*z2gdW37JPb9HR
zWU@B>za*QnfsbnGOo$IGDMNxf3P}es#9G?xHkzx;6q1N$y?yb5yGoJ4sM71irqVPb
zb(%X_gRy1#q}+D*^u>316u&7QDCG`gozOqElKSN@=8|Z<nB5ui!x8fVipTT3RrYd=
z=J}TB>mwFloR;8^qStgW&l#j3XNoKw#{o3{DEltRq_}H;IR5>L2iuN64AggecCymT
zCCt|nG`2y0QlVM@0J=thTJ$_|(u@Pt3S6V+I2%*qJ8LNtC!L@o6jyDVldk=vJ-F*k
zHd?LJ_7hzslF1a)ubClT+X@}I!LIz{7^T3*DCG`g&$RKc+UT;tOt48DNVdv_af075
zKJ{+s_>$iIBy-$Lv7_>V*|t^wBGuY(2=7Wqd<@ab9LEfoJ|;IZlJbTkP3XZ&Mn8bB
zIW=8v_3N0dZZ4+0#5X6*b#*^31{e>o7_UJ%^ckdVFx!e&4q}d>2%E@dP0W%h1ojm`
z+emejCKvs1eV7}z?F+a!r?qY82OJYh4i6@a3gCKiOgJ6sP7f3n!Tc#O8QY2}8`_GN
zGs?UvDqL$b6$b_-ago@X^l1oHKDg;#RpI?c+ey@>m0-A$S$2^cmMQ`C^cCJWiZqAO
zq}5jOe#aR3+Z?I%Bi5b0;7wS%xDSwPN&>1k5s}l1^QrzMX^_EhbhdYIZ!=)Z6AHZJ
zy>&W|iS4wjYcUj0b8~pXE#OYBf1nu^qKg+YC7;HcbY3WfKv?E`xlRe&g-!|Tdi3pG
z5M(F4c{RqRJ@3Vx5pL`n&f*Zt>R2#rs}MmQtF_fUVQr_~+}lBCJ?xf|i7tGQF%Uka
z^*+^hB{QTB3yyfF?q8*G_n#1S3r#l8@63_@*fSJry!F8c(-bGfUk^%d$dYoltf)%H
zPU21m-(G3hE{?|tdgJh*73?dOhsU}sx}+L*F5|kLfQ=pkr01vMR<$1$Y1(c0u_jsW
z$lhVMLhPf|<D~#}fkrsut9_z3x_e=}%~cF?gbaOgilL+Ui%-_<9_r5EGDddD7;Q11
zaC%mBemT+Ry@uF4p>7<cGc;sJBM!l-70}Rw#2QuBwI-EsdmPtsA$bx$LX3feM;Z35
zWnXcRYVvCt?KE$To*}qs%3CF{k(M>iGN{Dk>PfEOPw}Rcf2YrV8(c?a0`Ga|h@z3~
zPg<slOz2n=ax;&5ZV4ZHu{6IIX_~#-+CXPXUOzP!Xo_!7QR*t5q2vDm59wEn1k=h`
zzm{Z3i9p@P?wnH8cSfvw{+9aB_C$Bl$$hl3i8(3<T%LgYR*4K-?*cxx<uhJs+Aqc{
ztI0784QO4qE=w^TfbMI$(7aQnc#1is(`9Dz7zq{EYYh8(P|%Y%Iv>5wQPlN|4HDSh
zYFBaF#5xx|pI|zZ^sH;29O$<5+%D<mOLMkqVT7_F_ad=AC&^{1{6G7A4IJnmH-=T`
z8EhOHR@80icks@aki~HfnT|yay|N8Uh6B{sJ8P?0=^hr-t}kUO8W_<PMp@W_fCqC<
zwDFFOb8C4w+L{4qaXQYW8Z+(<CWe`~#qxe!4^c><vthUu$T!4~4#jO8?{_OlBNbh-
z6O0^l>0K;S$8!qJ41uDNLn990^fat1mWnp;J9^TB!0qR4W@_5yj)!O_y_~M&g;ib5
z*z15QEi+ux^_?^OLdxfLxX$KbjkxQa^rFMLuf4eg`BEr$IVv&hT>hWq4HHz=n@zR2
zZ?u8AL!nUP)k*72pT_zXrS#TvUv8QeEaEjSjCT6bW-Ftl-r2wdpHWBw5_5r`)sLWf
zk4*6-5?pE1v#f2k)t752_Z6<VZQGASoYHE;T8?Jgzz%(?L_3Egr(h}^ZO<b(r$>^6
zmf(6)87Tw;N#Jy--PjHkW9do`<vi0>T}aD}3PU1hZQKK&N((VRcj?7F&gRZVFcZ1H
zVZ|~;84b$wP6s(SB>GYXJBi&)CAR_B=|B<(Y#c2kISHI#=cPI@M+La0Bm!{2Py;eS
z`-AYKc0u`h^fcl(4jAT|Lmu>i0}Nn+LtvceiZDh&J-MSGiU9Lb{{SEQf!aUg<^KSk
zJwe<!7^W^iv~>}?kF>w@r-b={40)~R@e*b0Hd>Y8h}d6!mu`2D?^aLtH;7j`*3Y*F
zx{{?-{Mp4KgV@rzteMO%i{eB705QY)8ei-`5d;4KA?|*Lx?QYWJt<W>Wb;YMhblRC
z(R@qD{@!oM*4CM4eQRVRytw;J;N-}CD)9%NdLLRC{MpF*Qf}i)!%DIcymMBxKu3u!
z0siCjRoM<kPhRytj0o{9pg2DxfleF!<2(4sFSn9N;Nqir5=((I#HK`2s^xhA^&h26
z9s#WQFWP-#>cGP?3v^Z!F!>)nfvgP?9J)<}wvgJ%XA9fIgB)deQavgt{5_>9MgGmU
zRYF(|ozFF;B7@PfMgais=}O`tp511J;g%J6oMDlMK_5!Z8U~oC$eLZY)=;Db9D&-k
z%K|>|%^_7!n{`Q6GmeX6zTQJ)4(J9VJ2_9KH0XM9`$UGu-*o=~>pnsA{cAz8;~}yu
z7gW}Nvo#Gi%tX)j*?hg=@TQimG)0p{{dHVa&-?$6FCrizAOaFgNq2Xvw6Jt{cS<)%
zFWpE=$I=}FA}pZPk}l2C-3|Ws`F?$F-`}5{ot-mt%^c3`757K+-nleIlkQKm4~ms4
z#04DLcI=zp1p1$*e+dk2$!hv*Wn;!-(h0j(sm$&NBJ-lwd#8)KZA;pCI07n#tnTNW
zw}=hg+vbv9kMp2xS1jzStr{BlRg5}WooBVlt|5^Zb$!KS08M?EjLEXqWOxD#>1N~{
zE!(g63EOqi=Ph!Y(;3(E7NZvM{+oma$mexySjM2g(TBNXomd75dz?m|q&~m3>9U^I
zwvNaZonI*h$!>EM@K4SynKS6?PB_N8$?X@f_U+UEI0-<?SDJ$BzG30r$SKMx7QJKj
z4H95DL-Ml}r{B#5?-{TaFhdQsgE~Wu?XvfFke3%y#AK1AEfYm;-pWUzfPVnqECo+`
zI*H7;UxX30=>GTHd4cqQ+=U|tv6$|3sp(S6@7IF9B<=kJaQp)t$#8ePZVOtvzd4zU
zZtnP5;<{g@io;S}V3_}$F3aFta$`N5*$_jw8YZ+J=r?N;btHVI+?T<xcCGzT4n8LA
z%!|8Ie>XFyysy>quw;>wxV|JSNn{xG5AcV|+L;%s^$#E!Z}&RJKR*GAD+79SC#N6U
z&^>cTfPtD*l$cf#6SHZNZ1_m_BP)-FX*6W5V)!Kd60%2b&uvAAlERAVsmnm0shAwC
z{MWV*0c#2C^dtD4Vn3I0DkJ)#-+CNI=rQEG^Mj>+zNR1R8VtNd(IFYf5H8DeHv73S
zT!;fs=tfYb>&9txrQuzoYb_O~A`9@C&lf#!BZf1L>rDmqM`k~Sgq#lu9bA>|3ySzJ
z)A9UT`#Cs1$>oarg~CrOUU4l7f26$SmyLrn1#iA&I>GXLxU>g-II%aXsY$jEQhv@J
z&ew}i%GN254}G7!!?CIQH8<!*9v6(*%(*{93l6{<0D?Who~Ze&@lyAHP#q+`@$xWR
zz2|b}O~6~%Hr^hV;;dzx<P|3Gt~X%8eEDoLnwN9@erlGQc#Ma(b?DV^Fp)4csC!me
zOwI`yDbSWBsj}?-CgI1g8P4jx!xW50^ITy{9d+M{gAayw-~+O~{jMk<IcmY%SVc_d
zC=Yi*oT|Q4Sy>s2C558l<EF>j6pB@5DuE4uTwjbk?LJ8kq?E%y0KEBjhvstA`hukC
z5N9!5(C{818L!OW&hs<^BM>rcw+1lKk{bw#S(F?5c~(^-i;Q-i8b(Pv4^in-kcDxz
zaq%{w3=n?}T!EIFU}P9@eeYQ=U9rb-ER-?BR@z#AeE%PtyK%N+grmqE1ushAhyb6^
zBW0NfL#0QmYRsl^3FHaP<iJS*a)Lf1C}iyIT`bD^T<Fu3$<cA7Nc(mGT545xT#{KC
zx-<nIFE`&zTvo+785w?xcPRupG6ep{x4>$ZUsCZ%G%hR3SRFW&JBcC>24C+z{sZU-
zFJ8tayEtu)P;vyx$n<eO183tu+s$bdE8BmSP+9BYPDEnxx>Vrc1dlRZyU{`5;&Q<{
zLL3xep6yMX0uOBb14<_Mb$fg~m%7>;6EHH6<)-g$Xo%4ZtEQp006YVyRf@jfvA&hv
zQn3O+7m<(Q6O*D*R(zni)7%iZ?MLbGme3o?xo(p|F3d-p%40{g)E0k7Z2VTOkT)b$
zoOk@|&#c-K?6c!;t!l753g0J5HBjM^yH&wJr{)<brf?ZG!sT0nbOm2HdGux`x%?0a
zV$MauI~UQN0bfRdPgOkjG|Zj9+#J4fr{u+jp=wJ{+JuqEeLL{|9>&@E;7Tseo!=t+
zXC%-yDTAF>0Km{$_ojbqk9)ECoTmtduw&EPT%y@g{7N{G<x{wRTb|060?MZ6b`P&!
zl0xxlF^0P();gauJ*WQXp+TuWY6N=cnEH!*zoBvWj^UCUpqFs)Yh^k&qsI=dmj$C8
zUS4c{IGghd-%;^r#<^Z9KUQb|M$IYh;IsfK(NXlo?Ao_Hc66mudmgDTC=zS5BeRub
zXQ1rAF&=(xhwMt7r6q0)U5K!M2|_)ys{4BEBJmfe5%U`Hdq|e|;HpNcJt}GbttTVa
zkMtBvT#wbFs#xW}$pRa-i9T@~NS#8dyTTt-*JHuARdlxl>yH5$^G8?la?fMNBpAQ*
zXWHqs^G6vZ;Brk$XNjLNZv33419h>=8HfDc3OMDGo@}Vrjb){sd1KYyrXh2j2_OGp
zph`6R3q`eL?}N_r&4ay5$`Q<xu&f|n<7=4dqv3pZG@Zb<Q~Z|mVi(Y6nx9s8sWfMW
z#N_aB@nzOpTd9P69Q^ZT_*wo#`L!n1&EHZgQs<@%J1!geM`MH4G8XN&Y^S-c?`GKC
zGVVfjo`mjl_5KPs;?hApN>i6#B^842XIUPt6R8Bit6%>Cp5lEaym7;_r1{)GiPt>j
z|Li4&$gNCmQ(Z3vM=17^ULHp&w*Le4B0V~aXZb#)g_dOExgX)f*R!|3OM%YQ$5E3I
z#a@zT<qikdsY|S2h)*1?T-d0rtgM`x!i=k(zfdB4_=fu|QR>950`I}P_fbnI!2ERY
zz@@_CxdR#8ATlOFfqqt-@htxPOS~rW3l&MX;6H#EKeDdTF%yXlE60m_20ACLB1r{E
zZ}UcV{~Zz&rZ)0l>*ho+$#>l%Lgy#FCorTwpl0=%|3K6&XYa}6e=UFV1e2*v7^fj^
z-I{zti(JackgfmsVFeY581J%6@5%80^{IQ!hkAY?*A(q<M~UnoJA6Rg%Ov>!Zir0a
zju==+;_Uvv0f>O7!kDhzsF0m9BB&xm{{gguk$GGH4Yu&n;&kdCAVVbT>CWVtrJHaw
z2R+dC+6~W%c6nlm>NPSO3|U6`aEY`6({2BH&D*Vgs+&FJ&N@v<Te8VPT6R(Xrta2I
zf(&}!b@FhIY$y2q4llCP=?8KRXpwiQ!yKWgY(I(pU(<%O-~l8qD|i+8pKuU)ghUSf
z<L&=9E8k)}vF$_~{A-x_!80*(`tA}2$WA41t0dQ5d~6=tR&O?g&$QM;w!>V-|2N9j
z|NBJJ3mGL|e1q&$HHg#4LX7?7>7MFQ%ZJKw>VG!6{qJ%DXVg;z^0H8X@oD>!Khgwp
zxAP&J1&ZqO|682^$#;)Dc<*nX9}}Nhl7Dde*!}~&K6$#MLKwf4W`r>Bo&2x2E9Ahv
z2R;@e6EXg8jwMKw_pTQua0dUkJY=Wlfy~{A|7V<u|BN#Z=z%`DQ6ZFF;(m}?Of0(X
zZ6==8p;3F4AoIZfZ(|@2EfH<&&Rs4ZN3W1wfNl+bkWIX}pt|}M9Ph))s+0l}`u~rS
z3ms!ol0@zn7W{MNbZVCq134{(F~(}FI-Vi!|Ln2?9bA2l+>)FHNTOam({1m1f(obP
z|At4KtDdO;zx8NBt_RXxlDUes@=*Ah$G|7g?*AtB=+GaR;ID!1!`GAc-xBxU8sw8A
z&@YgdIV*l9K8Y0i2S}Xw?@QhIp{WWhiB|tD+G&8{=@3Y;;0Adpt5Xc(@G-slf4%ix
z!`_6-HU76<Z;;0G7@($f`QK>p23K(qknP}u#D4(e?zfc9c@@`c$nCe1IM|DmJa<TC
z8+?Bm{B!AaNLVoZc>(z>9rTM_@}WTa{7ItPl25`nP9nMIE+ns@$a^CF@klGCh^*K=
zcLXCFVhRs2?Las!0N3Z@JI}<>$lxAt<gz1s)Cnh$|DIVN^3*+Ha2oKMxWR23--8q(
z3>||vI?-ZsCO|f}2hEZ~<WM3H&1-$UhLlYVx~S}PW{cF-Hr5i{#{K3Ep9!XmrjRsM
z-V%@2y*v{<=9APt!^*!+Rr7NBOHPs)PNAqY(C4oXIyzlOyo1JXW}H>nWE$(TAE__e
zpJg1%n@){mGnmcjn^P8Pk2O=YX(jWVN7nP+BV-ema)tz(KBj?Fyr?X4W2dw7wcX%X
zTj|h2N!+oQXYyU-9<*U1KpUcO-v>&R5W#QuR;WpG3?hB>N|{LAeGZoJWxU;P$p_57
zkEh}tXTHJ|y3hA5cc8?ayjo1lzy9M}QRouint~w}XrGELK90J9Ru*r!?oaMS<??r<
z+lt=63lj*QFWe_ni71CFRgO6(v&q<aNuh6qZ%sfx2CoIaQ*Ui+$yxc-)@IZ&NEo5%
zkC<P9toj&Ft4+?!cjTNaSqYD1as<Xe-)HHrceDHh*!`I4_O7lb8cBe03GXCkN~#v`
z+uscA5Zs>pI&zgnmI$LCcL@S5P6u5E*4QP8nn2B~;yopCbgq2G)|#7^7CBwP>(~Z8
zy7qJ48g}=g<i@t#7m2Pud;*x1W<m2_`7~#vc8g!BY^;+wrMzo{KU_7fFJs8fJ+hnm
zdQ=$tdKJ6Lw*UMzP)AWc$yb152iMA*c_VA%->CejF}JzoYUB~LV|bJ~z)lOAeLZ8n
zUbNh8!26heRA4d`7sdS3r%LJe(R%~EUJ82Hko}HynR56hD18y+Tk2D{4l^ieSQwPd
ze1+95$FUwk?KN=$ArF43FSCI$hjd`g^B~E;D{E1P7Iq|i2`nh52*vn1Vp5Kcw$1@Q
zOa>xdU?k;NGH-&<TbD;ln$ymVlb-&BA}#4(!$!9y&W@gBF)-?osLg9-PQ6n);(0fN
z@l*LB&9oO<7kS8h52w8!Bue56SFGP+PU^rx@)-dEmAinN;9G4n`C0fG<+hNeXi2LA
zSNz1sgq4}vus`Dw#orLxM-{tsq{cjW6b^z)7Z5Q6#McJpTI%HFcTF~lJ4PizXw6YZ
zM)sn=n>$U?Kh$GY{*{7$c9YFp>vH1N|E3dpey$WVa?#fQUP{GPmZ@DYOA<E)9vtPZ
z@SYjh`fVE$LlM`Uvh|F&Z@c!C$C>sCH0v&r{oJxQw#Mp{zpHCv^jCj5#hJaxtmR^!
zbnjMkeg%8_q?w6N>*DB;M)<tQ(OG!hU_Rfr-MtIQ7+njP?Iz32BrsU`=E<PDXeUcc
z-n0nRQTARBWL0XOt&Nyzd*|(y*lwr@Y)2J_2AF#2&p)G1Uvc6Mlq`?%Rl7WwS)27>
zl)1sG^#Ua8r!Qk5XtRrABMs#|0S}U$|3xtc)a71V;P5=+cG$!#v2tSo!{~`tZzZIj
z@nI@UNCorIxvGIR)>oI9U$i=Z5UUGWgSZ0SrptUESuH+IX?&QT8(q;Wjg;)z&P}Hb
zOEp&<qKf9YZ0}ZctaPBC>tOGq<I2VwN?zOgCWaf;Ag05(_P2Sso3ys9^*DpoJL*l-
zi@-?X+7ta#r`m>U`2LCbV9Ouu`eyd9gT4EL@g~z-htdIuV5jT2*09sfq9DQ@>L=UI
zdcG5njEtR$+wgV&ikcrIPHb4z>JNF}N8kp)7jlj{Q`1iCCg7YDUx#Km@sQBOZ~f}i
zxnY4kT6@85C7Q3P!J_^syJ)s>AIdoj&z6YZ9}gC;<A!FLlV`BFLWSI&5F*pFx>yLp
zsG(-FDgkgeaXVkitcsQ7>X)<g1%#%*3;zSpedp~Ywwc`xeJKwTJ3BC<q7^c};+d(~
zjeN}Bx0j(t1=knV<BejhtAHuKhThGjv6!W;SsbVxfh~z8<CXB&jt2#|NJWK9c<^K0
zy@Bdz(y1vP2P)**oq%4I%P5j9-z%gKiwXOM0xBVqGPI83HOdc@t}$kF12iTSA|1LH
zp!yOkRkz5A7F61F#9SsREo#Mq)GG<C{t-fsNxzM-O`y|oS-uZkcq0V(Y7=aoNqY>Y
zyem-^?kjf!Ufil;WFyG(3qhdfUcWq5ATVECSyoykztHO+;P(Jhg{s&e0=Jt_*8i-l
zc$SR<B_Txuec(FVwB`>L(BC=kzqm(+Fd)_o``4Ls4({~wFj<;UCCq$CH7Bc?t?A-a
z!8f(KUb`Yep6uL9odTOUIZ`NQsnaV>I=U^-(>eW#8K)K2Hhm`JwQ`;=v=Is0#MVLp
zA-b7n%oMQY6<y8;bdUMi80VuL^=fZyt`VfBWrzqY?zhd-Z%-60QggbOcpfrgo4=0x
z=wcg+O?@(^DFk|h?Mtz1`o!F8qWuURV>`aPAhSjDrxRZMa8n`g%^H7_8kg~{?e+G+
zE#8=keO?dv##9pRo3)@I{Gx|nBp0`P?$Zho=IqRnkN6z1l@)ZB6^PVLG0)3(GNN>0
z;|VO=N2y#nbb2q^CwB3x7pcu6C{bOdKj2+uH~@q*!g-pUu&K=^_VOJ%koR>_SOHyI
zqPqK9B5ngE(jzz{nh@Cjsiji)h624dTAViqUPp_8B4DkH_r9Mg-k)FSrHn7?wCB(n
z@%{PA{oyD@kV+kZaaJ{_BdGuDo=`viYE(`f(&yBewxpT|fx2^F4f<I<r<(;dKnBy)
zeFGRt;Nn6@hAVaJcXa`vGL_CR1a@<-%~nWdVn++qMIsiv@HjdCvK6Cmke9|rDzsT+
zZ!Bok-s40_n)t;Iohq5Fw`FYQO>3m<Ew|yLI0mKf3F<4yA96w6tZ+s!M_C!Mkw3ZD
zAv9XtWd<BWOYPtnua$CGlXHy=Dzm#~MEWZXo8M_81Nf`XJK95AhL7#r6?)lM@?yM>
z_jxl)o-SNzCAldi7sy~8(l{P+I&6Ghrc00g;(oBYsOGF3UgB(L2<a$(f%l&3KFvAz
zePBdSm{62I=_?*yU<Nfx!LZh%7rN_<WLX0tfJQM@kGfP1XJy?-L#j-O%>nn4vTcLZ
zx4%p1q<zqi%j!{CVZOH`C;HhR3?aN&ODn5Off*Z<aQINEE>6gjMQnMc9Y?12&$*Qi
z-3?Q{Hm^$)#eGfG0((^{^z?W{v|IYd4_Wjkd^y-K`}rTh1Y@Z)&x^0z2%^lo^Ni0J
zN)ZriT03!{!tAb}l9GQm)0<`78>6HOSloZ5!-e;tMAkxI;`vQ`)Oav)2N{L-5~Qyu
z4%9%Nwo{mk3M|p?0u?Bo{#uDgrLl{7LU*h;L7>cxzN0-&a}Ri<?S8^&W28p+6{4<p
zt~x*x`BUID-N+Y9hfBcc2B<wB&7ix%*2*&cyVt$eFLv}472`~Nn&gwsuo>7t7AA^a
zx%&H8)=lMiG0%!p)L`0j#S{*=3BsWfIu2U%LT=R11KsQSd+-HIPiO=WDgmC`gqZ;c
zkY+JV3L()FNA8fXhEpF&{rKx<hp2?0?SmeRQss~D9}Q3(>EM{q<(+Nd6ASZkOSP_1
z%AD|r&G6fs{(G-V3nNX;uZ=S8MdxQvhc{I*c96T2PaIq|g73t_K&s*_vz-f=h^~1`
zuAxyj0$-AGq5gieMKO(tl_s)~YsH0qME;X2-k#jwmYzcF3fXt0P?L*^Z5DYQUA+t5
zpGZYolo1ldRWXQ~T%ah>$p+Y{d*ZI!xpNH8#YH)a<=|&+X=qIm=Pu!SJw`IJn6NBT
z5TMCDSo@O@^ZhrhaE_p^s@ZOMLp}|AGwT~kQRl6og3JS%lzCA13;%=Y;`r3hzSx63
znGfaDr2_1-yWOAmR0Ma@$EB#W06}zK<%>)9kry|U6(L<X_qel!f}P!CBoAa?t^2*i
z(J_P`cN<%OpP=e)h7Ouj$exkTUbb1|KImyC^?eZ+NjB)qYiDR+$kY{NCy?!uHz)Bz
zX-68cq#rB-8OB;&XiU+Hxev|#astbNFD3b=D3mmQ_h^41nmki+Eg5gvS)iG)2I=YM
zr1bf1nvc|a7|k4?F&?*08E0_qrL(#1IJwoT_A>Fo>7FqbI<hvv6Q_&MstWjnM*=_~
z)fJ!94foG$ub+oS)p!%0co%?I8xZ~F{Y0LUR%Sw)*c9?Y=*u8}{2y~^XwMU}qR~qR
zV4FnP*Niz6A0iX2w$AR@<>u8q3PWd6w^VQfj}N1yVnf9~I)#eRc)qpji<A53tc@Cd
z<zVpzL9zffK%sBP$X*HtLQTP=+P5^QpK{X2=}C^yF0dE>{R{_nYmXkea*DO?4O?`F
zT7Kb-a`lGtfQq%$i!j+&<9=s-gSzdR+V2wBkCJ|(qrRO-D)LA$QzEn;#CX^XFR&ZC
zeaA5@a_m@HpUwFRq|VR>IQ+T#>qzFn?mk^cq0f);=l;p#tP74?DH~&yR`AUvS?<Z4
z)75vwW@nM*EP<Q3_<<}Htju+sGa9?*T~0!SA8F{x+lXNM`UKx}Td+N%ZKN4sLC1cv
zI~+-Uz1;iEjPCl3r(0W)vX<9_d++&15c&SrohF3#T*k}1AAab?Yf0^MC+e>khbcud
z<2W7)i^@sst3%!F2wBc}SUKem3Qmh4&X~JjR;Xs!oi=q*AI}jI*_V(b70{)gz|)#A
z(e~6Bf5#s~;b-m{t*hA+vlg1)0_W}~l_hh<>Kwo79KP?XpFIpBWkWhXGCF>#O+lzB
zLEaS0z_;oL;2qv*hGDPDzW!EQT5oD&glE`pwd5Iwl|1&%a@`8=8A+7lEjF_{w4Z)<
z7=}t*E+mgHP0+3KffX*REHW!g#5A#Q_KQ05Kwl3Z>A&y6e{pa`;}H%UW($PA8Ar_T
z>8ts;AQct0{k|LulKavpiyc#RFd<bANNS0s7iB>Z+v#KTl9YwxBfdbiZiPUcWI826
zmZ^TeV!PmtAw!#8{Zz$oQZX&R9g2Yhb-sA1<nknLy{RLkVY03cUujoze32MSD#_#(
zTan0b4&`G+S3|i)F5pCRxowQk9$O)=b_)0O6e{c{*3WEcoiH@t`U;83G{<feP7iT|
z(hQOLI(Z)lZdk1dlwH^q{K%xyI>0qRw_#GDG3_(!>hk41E`2?t#j&mB;r)6k3r%on
zvpYJd$DNVTLL3cPxczt5)?5F*odW$$3I{ux^?4qqAWAA03e@_lTHj+Adwmx7J~)34
zMoO&3;36o=fk}c&c{O+uuF!YzF`8NT5Mm-NBHm0eXt5*yb&T!T<A$nA|6#EH&(j%V
z9sN;gfcg1X=h4QI28zBr%{EhIt6<DB2=P1a-8MDb`>2@91?QZJ5oPvwmOR@u)XNde
z?Lj4h4(Vq=0k8X+23_dZPr%*BNK&W}O_s$OKiGDJklw7raG#Wxo4f|P`Hdb-F(7&d
zwwNo5g@PQ|kn&WHaHnS*^3c85of~|>Am5Jo0hRe2Ou%z`h4BOXk&TgvAjt)_EBZeG
zVuuPM@|t6$g}BYF<9nO>Fx>;pd*|%P@L0HHkaEa~4y)Pk*U|&~S2<M=LU4WhEAXw@
z^j3XK;-|1J^Y<S#JG}da#iKs3zO=k5rC@$w4(95q2~OK5#+I9L`7Ut4n<X8iw06Bl
zR>jxFU4;FeVv9+)vu)WCL9(Z-ho0z|t69bF#4#vx<`3=N_%e42r%(dvz1LA-7t#(w
zHASY-4K+Y!&F0JrsN=QG(k$|d#b2v4_VNKetKwNrjHY<1{q34W$lEi<N2T4!5_v8~
zz~DyH%|v_8vApbA=jEf;#S#f~v{aOPch+yil8T1;Abys(XY;%-&m)rtc5^(t5FfSd
zMPC|&tg}grNBf?^h-Q604Jfw!VJP^gbcFCjmjlV$%R*Be&nnH5yt~en{lRMYOA#Yu
zY+>zfD{xHFdE>{^zR={@(v4SzN?AE8X!7~|H0h1xvBMKVWeMNYnA-Vk2P*ZHCB5CZ
zwJuYz3R%`(VCXk_q1ufG&!S;*N!|U(J79XCWX2p9u8m7QYHl)OGiXcTb#nKmW7?U{
z$uS_&9?L>!!{-WIA_%Ms$&raE)}|pj7q`nrP(L>t63JJ<=O-ug=l)VB6*}!!xPuH~
zAoJwK?n0oWdbzj9T!phWFgFJm5xPk79pP#EJW|S^rl!~Q(&={_Ue}3D9pU=xZtnwv
zqVYc&?D=kbQPX^uJ7Ko%Pt7i#1O}Gg-7??`$5Vq++vMkha1tC^QEz~tU@a>xJ&2-W
zNnwPKfk{hMyG_He@<GE%=Hf9#aV_xpGLF#6U*tHRq(T*w0%WMIqT-QnyX2AM&3V9j
zr$EWcvGtwqKi#q(gU*&V`H^TYR;CY1Hnc<^^SfcrLVUGWq=O8Q4(s!mdL{CNM~No{
zf5+&<U-p1`s?n(_281ev#~8&u#@@Y?>>W=InrbyskzJ1Kh^F>Pm?bKV4E(^^oYx>$
z9JIoPxm}g0uQqwFN>Blpzr?OXx4YKnHByn1*Ir+Ii`s`e@;Fka=OYN}orWB*n``UR
zm}N`-K7MZ)2pDsf$+}@YD|Vw8CIZ&AcVt?0Og*v}+n*1g$$!FM{!IvmA?zKWrXEdR
z)L-Sjc5)$@n<6cZoU-ad3tf1Uf8=3(MZg;-12_+|$no-CQc-{;jEJ#X!v(KHaLvi2
zJ65-G$U~5v?kM{X?_#^@TXp!kzjr)hdVsz!35~~j-3yW85VpMN1}$X(kuol*Z(UIF
z9C{P%WgyS0g#%ndPIU4I#6%@loaZ}bDu6PD^+55*k3`=G`D`7PM_S*ad%5y%MM5<$
zYgs*j?mi_WOFZ)8@xUKuf4V4i;+j_lwOS&FCS~7GoBPu0U^t_UgFH?^ZKs2|aLL7C
z^KhjM_Z3sB9~yno=@xfAp-q@o*ISvq@NDC2k%a(mJBB#QqA=Bk?wS?k1FBCBu-Mb<
zB#vw&>nRb5<yiz_|LHP(F-jD@)AqgrJy3<&-$SOr&B#ksTwr`?UcWJ8PCRK@SN;T8
zONC)~l4xeAR7;ZUU0!Hvr%TBT`&#pQ8GkK*fl#x=RPD1|{Vj`Ss(vpP-kU4hry`@C
zkzo=s9ip}NbpGn)ZYoa6+bge3RBB4r@qIs5Gp9Z)B%Z6g^5F+nfqk)KmLuwXkF6}a
zSNNFiS15}Bk715`#gdY##ax(_7;5O9dI)LziFOQOtuUMLO?idT+SzCGnk77EyM9fa
z<Bcp_>Z6C5Sb$-Z$5n|d=7|zn1;qqkUs6Z|kjz4H5j5<k?oOCa!JKXWHGS6(C((EO
zLoVztqW9~?N~ZUjlh`B`VDpVsMABm+xWL{eO9?P4bydOx42ZV#zFANP@O7=7$`zH7
z>KVQ+2_I8L(onnoXPo<zye^~&n3uc2=HJ>Qpmg`ss1!>ayekECU#YtC?Et$Y!V^Rs
z=+g<H_KKO5@-6D=P^=y|g|x2=g9^h`5i$w#3~5IeNtdn~Nj@i1=p>apdt*%6a2~sG
z^90>oSS?H>7we^{1p$g#EY_PFUGoTPWcbE7F)5fBrG!hgsedDhn?nA5K2`+O@TTH=
z?IHoBFD0utV~I$(dM|HO?{m2UW{^Hnkt)&+hlPB~5)D$vEF;Ra+r-k%Gi<CR&ph$h
z&<ha<8DGX)I*x_3(>>YY9-i6_#=JaB)VJN`ar>OSD$(D^xHL_ab+esTRnMld5rXfL
zDvt*6NO?_{JtP<OGZTv>Kl@185m!(ZP#7X*h_aHlBV_pIs!XtJBPqR)CXo<@X;`>q
zGey1(T~bj0!=O$oJVb1Z{F#9)L4omzGjY70e*(9)rE0)+f+`hAkCh_LK8}Z4CJ!m4
z@nn}1OLf0uVf>ge<lrmm6IJ=EEvyc{vK%z+l7^<I+bS$BM^smG>$3;n%uE=0f5#Fx
zvfKrDJ5h@lboIlPs3E_3xm}p<$=>(t_vAnO`6Qh)oF_Z6wr`x@Xnjmg4ih;$(md)W
z^>*=V#I7I`Y#>*%WS*d4Z5+oi87juu?i>3LZtsSyrSft$9Ap2*_8mi&THPp7ZAiE(
zM=q-N>Xpm8IJXvocOR-Y{XJ_R7#U%q8O}Q`z(d36@zd)>fp{A__dh9OjV|!;En`vZ
zwo7f=U)Lcwa#gw(q3z+?eCl#BHT~jR(7jKdF5Bvpm$nPQiZ#D!T|v^|KhqX2-@u!G
zI=qm*`)<cfGNT#TpXn%WQ9!7avqUzlu7QTZ?w5YxrVCY`;7iWck?UI8XI5HYLI}|R
zL&!jUcXBHD3OEB(Mxd#+in<RH7NiA~d*KQnGPzw4jkg~o3ZQ&LvWzFVfd~0*1;2t9
zZXj-i=9fYb5`Y1YpdabE^k=zeXg-C}2>KB6m|?`-%=ulyj-_-Td4x<${X6OchzA_z
z6FtGAtAO`cp8&%KFM%tl`BT7$d;Z^4??ulzk3&g~@{z|CjZx7&V%*oVYiUEEAFn<1
z9S$svqV3WC$TG0k2OR>Lo_(v#Zw3>;O!{&I(3K8JHk13W`hc23zUhBFp~45Tx(N(w
zIYThZx%io%_d)>?9u2+GwL*I*`n!muH{nUp#l-QZmJ*%60<y~;P(By}7MfR_gR!ok
zg^SbW%l86L(d^}ASp{_ty7leXjk(oHmE33kT3nq(#lbUDMiuZ*$;jh@k&0>{Gr7{O
z+ud^{4$Phzn=J+tER5BVUo2*6oxC}x&EUdJA*)1#<<EhE@pJ+!&Qy&5mDL-nnMol%
z<QJO`DZ(dtt0o1LH`sCpp~yeU?R*}dn6vCj{Twsv^~cwf8dn&Z0j2F7+J;29D+wUO
zQ`a8(qMKUr>Qm!;Xs7A;$MAA7?cjln-a+qAiUv2F{ZvO-FwwU&m%^YEiJmI?dUOx9
zVTpj5Xd%)nQr4|v8Uq|z6sY2mfw*aRkkh>o279y9L@W0d#0K1L_0fX%Wh~T)UtRa2
z>hpNX4x2FT%fyQV9drf--!j7q-<{gR$yzy7aiQUTaTc8x-#;{-3~B^llT{0{!2YMf
zBBlOiCDRjb><8u=t@NLBffghbel{279C;-}pCfN_BdJHxUqM9JgHec2oXED|J}rWw
zQh$-fN%+3Ia(rVv?+Ci<ssbzJP^76j_wD^j4ynQV18%@<x(E);t19)q*3W~K*Ycz2
z((OmX{cC;*Iv7ZfY7&L->4WeOBPBNqX^C=1u=f+o*jCHo^l@9>8z1w*XzB=L*~I50
zd-5X==2~r+HU(^+il0DB4$xI88EXpUsfd+n#1v$haAo)#>Gwo=Eug=Xw%=Bni9wg#
z-v<n6F_!oI&9!0#6Ji4xMmoBpqo7XSoM^{KJdG`#KeZ1!?{E_eBZ%mK<TeQB8x)E1
z6vh-Jy}CpK{pc5uvB`YQ!-X+`+l^MOa{=cTz0ov55wagHpejAAh9Q1A&{X-nTBWCk
zum-y1nSj5jSI~7m=@J3`?#Od_r@`*qWFT*s=?gB8#Yai3QXAaXe3NWXQq@f%$1fAp
z?KhXz@BADy-^LK!+YU*ylqawVHCH0)eQ1A}(YS7FjO?OIDwe>EB-ZF=ie{~{zL8fT
zz(a)Sz~d!M$)rjIS(x30Z*84h*XDw#+dsg3%~|P^*j}F6pQO$P)F+sT|8~jqNG~m|
zR=NSn-k_iZz2^-If8pGp>g#gwCtMX+N%91R=wolDeMdz<`!B}fbeJ^Q$sOeigYxfA
zi}jDx3Nia~EmL=4+S{h2;H1j(#_oI}FMG7l7LF0VOYSU2bzde&zf-t*9r>gaa%(Q9
zu9DKFfI#-PQAY89!O_3_;UxKYdw0)i6rAeGU*oD$`W27WpeqxXgYsXFq;E((wJ$eq
zh{}16e{3kf7T(DOMbw6~{UTUTdx7gP)U9CidLmj(j<(~%ELjh*>)T)F7$%s2pGf15
zd6#Ht6MMG&Vaf1zz$AJno6Bt#BEqTA%ZX%SJIWLp;Nk2|tt=f{MGKqX0w|H>{DRwP
zy}Zw*U-K=Q3f~=q0(7LSZyoe=X(t4SrOpxNQmFNpV-{36`^>3y2Aa4X6~^BKWA(j?
zIljGy4aF+|bVO=a<>3}o?z_iei6MjK<XnA^b`w@x6*#!qrv6AMaMsi(9IzUm)^coh
z46T4bTU&1Fu;|Q@s4r1H-0DZU<2<%I{t#C~GQ5#&<&SYkit8IB9C>a{!L9M{NTMBw
z{6^B`E~HqC_C>V=al=!xl@@v0TJoMYxa*tW8ltXLr!#XRWM~1EaNuK(6)90e$-c*8
zW$Q~mIs&bZ8ebH>SC@PZU9t)qVY19AUz5X+9WC<Hjd?F-JDmQwMmm?bXeFYJX$taI
zo@Qzshabo<`w%iA#3o-mdc;e5W#<a6t9y;JaFp`_3U3ZT8VQ$uKIJHb0E#gtq3zHD
zMQJE31osjcs7xa^l^hHBI324tUCMMr2vmKcwphvzyq`o#u-y^&P#MA_%u@z1*7Y!N
zB%YOfiA{1B!VtAgP|C1O3XnbEvtO)0@_Y{m7q6U~6lQ`*tja>E#gTHM^sPq2kUz|G
zhp?E=Z7zh+FURhtoHEa@#3R2MM^$Je4NrQE4~#M<THjyzvTuU$D=hgyd6x;lgD|bo
zIu$(0B?QFc@fhUbmdEP>2<IdT_+hDBegUe|@Qz%TA}DrAi|<sCF9HnG36j!#Rdf}f
zLR4>ik()wrK2skpLujPC?eiDB@mz^Cz>?d{g;EkaQwg=|ix8CU@NgK|Qr*;|2S7vZ
zd7wfvWY>P8s0=_&Rm2NQn^K`I1uz13_~Hv7oFp5mNHe^+hy@KHW0ZNfg=k|OK73IS
z1}6OV)XAy*w0<S<xeQGl7}vJsdx&^J|DbG}Z#&gh@LU&mw%RK;DGFbqIuY0rKY5S(
zI^RQGQ&N=gv7F0Xr|2@-@wvE=_)jE+H`e^GXd4ISee6Zb%%vZNOb7M_N=|d;D;N<0
z$JWpq9<4;n;Ky~=#)#mSQjKkAGzFk#uIIt<V<n>R;x6B9HrGnaB>W<&FU<G)$wAB9
zQ}nwl2&L(BiW>gXphkXqsNr_v`r?z|5&4y!4bR|Kk>fV+1Z{!eSm&u%od*`}fz_1M
zC{GIJOW@W0v!~+EnWNdENw@jj*kp3|v-|mcfhYvFFHLLPtg-y{o9!s9%JVfVzx>%L
zBV7j<8_NuM9Nn3$wt4VY5ftO%M3c4<2O8gAUgnRZ!(6oY%+&S+ugU}}Myc?j=;GqB
zU0nRzMHT+81W#Kl*Fg0zd>6Q2iu432-Iwblsqxzs{3KqryKx^(L$j$z3*r+_?L<2T
zyg!?dn;pi>5|;k}KkSz?3hG)@D+Yu8w+%tqa>R3@s!6gQp-V7|@uGa`W~ZX%9$|^A
zL79@<p;zY7`%_L@*de~u!pCw(UA~o$UzE+~kpkkDU90?mEI$ls(*VO$r)Q?$%-_Yg
zd9D6T9b=@TCK|bucpvp~W}_qXNQa>9UMRj%lOPaTT31yTw-N5|!ajBh0y>v)W_h#)
zILZPpWgqv@#uvw(mcWUMw&{%$pDpKEtL=>G+vmxyhn|@rkwo|nFFD=7ZwmarX}6xy
z4;~+2Zzin%mgyG~UcR7=YV!l^g=e5{?Tzt`dKAFgJ1z@|^TNc9cyN(SwXQ}H+^j*9
zoatYT1J|x{0pV(T*dUH)tj$xQo%%h+evfiJ-NcST(JJ7X;Z4+$=dMk9i_%O!FIfa&
z$HAkk{u%=NMMFpMGnM(ZwW^esc%a=6FQFlaBoi_t=(Ze34r~}3%~ELm6$SThFi>3%
z!P<<r4J$ytfe(=}hvSDFHrfW<(s~(Y4|1LgA^tJD6{e0EN`!U#`x@1|EXS>HSY8Pt
z@e7a4jkle)t1j346JuZ-+PcqYGYM%Z(^36ESGo6Tjk%A7Ih%E2YL$a_<sh`!a1V0%
zGkm=?D_0R*R}keaFrQ=Qbxn|L&QIkXUk`8y2~zw*R9519dZd^1)bnW{YOKq*_9GIg
z{uUm1TTe6C>d#x+T9uC+YbqENO&Yy%x_aWnu(Hu{ngvwLu#P1OeKrhvQmNk@whBB3
zHk98x4DjBK`P0QcrSqAY^Wf|-0&-15=cyo|^;P_3`}w!hZl<Sq{@=#>u?D;daT0t^
z4((8;i(UWrK@ByfXX;5x#x-*{?{yd@V>l1<!vFGhF(i``DW;R3MhS`Q<j6bj!KE<K
z6bQ?-=v-yo8*a-^`x4+X1L&rLIG4ixdq;`C=L%B?=l|fBB@4KcRM0nK9Y3EKuj*I7
z^=Q0!ab4!JJfp*3b{lz&Onys1pWcjor>-OsWccN1rIlZpgT480S%~$gepFHftymzh
z;@pefq*SomB45c)i~Gce|Dv8=aFb;RxYB1C#jt{N5qMgBQBf;q;um3=sFdnF_nO>!
zISGYoV4CmnoyZz0_wb%Hz?5j5nL2%|E&i`phAI;F+3`D(cm(Y+qxWwkmmHi9*VPx5
zacj+cqOjCd#0tBgb&T~qFsjs}Q!cu;MRY6Xvhv7mL4o(hE2R7y$%)asQCTG%?-xlE
z{FYiXEmZe+ey`A6B}HUSJ&{6JiOoG?IEmdDEl!fr$-=5Cc3&y}3Xdr&u!cAg-wcX)
z75H7J+?8okQ#9<P@IKkIEeIr6pc3HX!Q!*Vg?AuApQ~-1O;}>{&0e~r^TL|gAEnJa
z%-sA*lLk=kMvQ||6bCx_w1O;V%uCh{%GdS$tb47hmzs%()YqKpQvrD6Ex#Cpbl1!y
zYcN;M3YcjV>;r*#w+c1myh;B6qdA&5_|oNea?dROG>6E)tH^t0F^WFD$iEskH1Wxw
z*XoQVr_Y(K#mJ-!7gfC)dUajfq5#PCFf>~J2Z%Xpp-@!v7j}M+i`L2WSn4x!@a$Wo
zy>-dQ2Lb7IHl*`oqlMkd>b){qP7Mv67x!3gu@)#r@XOEaWjI2EHVBj2F<j1UYFW0M
z{5O~uRs3IzXX|}Rjp*-xUf*<kCZdnuiD8`Pw8<Y5I-Vthteb_5H4}79)DilIEPpup
z#gwsX-VhomMW))9*XWicjC8~%t@<?TS?IB`n|*BacVtgYOMNsh#B)T_u655W9b>=v
zWXGl~sz?d<kxrBv%(hVBFRpxTm?riSD>dKhjZSU%Jc3eOXlxbY@3pPaWx!8Y7NnYL
z^g;ldycR{9H&uB42vSU~hBoOCX|2t3-q{{reLtD`=+fricdbE2Ker$Q=QZ*V9T;Uk
zRRktJjk;6hAbGtJwkZL{^+*ikjZEWkB92GR-}wFppH?&lhZUq$@W?y*wktv28#_Lh
z#P~%<zrN>_SM=``*iX&YwH!%2?;SZt3|1J88eaaiMC4wL*%%xcGvr80i1S;;$_xup
z<Jc6^Y2NKhcF)5&`8zna64e`JqMr4-kxt@+k?Y3;D@>k5#h+6y{Fz<tQEDx2nC??b
zAzVB@Vo#DHD^c`)N4mYyEvGqvGnEMnyAO{o1)f!<r6W;?^91#PZMr4ak3#(;f5`}o
zDR|Xt3V+gjGM{fo?z8fM@b!P~LtYQbV{9b~VRQ^KK*`)QhFxON9nJfpC#iRHKhNVP
z?EB_w&AX<G+QEVu(=;!^mNpO<XgJyBp8T9$l^dw*3D<y(i6@4G-q%~myh`qjlKaqr
zaQPmmYhg?jT{O#MIWr-@qBotswaDT1uc?+C%h6Q<L7N@g`9%FL-wJ(w6Kt0T+85<?
zOu#L-`L;j4S47qrl7Sv&9~$Yq#xadb*1*?~`{e^e(YIx5vIfk~qbTC&TM(n5<CPWP
zLV;1&qEKw`c2fWfi}J?rlw?Oq8>CJL-k!dkxnF+l&W@M{Vo2)bGqvT;T-j$zTN$oA
z3tI}KX!TcgI+9O$#Y55m0QO0h79>u6YY1e(81j%;VC{Ohpt(cgrW@n?J^Ce6M5?Q3
zK+{d)`dn+dzn!}tk3jl0!ONYIh>L9u>Pm^P7IVem-Ao=wsc|Bb)Si04W`0lLUb4N&
zXKoStu2+BE`xue3p%U9Qddqe<Ffp#hbhaqBKH!%_`yBfdRo0IJ;m*%a?dfDZ9q@@g
zBu!Sa+j5%UTdgBIO#p_eE=o3$r~xxWCu~lNPMA~-Pr+R&xll2307c(@ADiQINe{b7
z5tmeSX5UXG8nFtOoe}uBV>v*I6zhqgQajS<cPRTtx*q9j?oKgG3$|FKOsANE2jvdy
z&!bz6Pfd$a?I<}hq|zTO4w78ZYvXo-#Ch=cWLsg^FGOF9%uTDtuXXFa(F_4gJLZ0Y
zQdH5F?9ruOL#28duyL_kK`;GgM$qG20valqS&{@o77p^;p?;heQ>HzO?gEPax%C)S
z+^7Za%A#FYs8%7Y{d5)(^M2w~r$D;zCpU4lkvN(-`5@`%`MW`<N&pHt0VxZ+@M13u
zJkovqllv}FZMu%CsAlg<KR)_iHr>fR6OR?Qrs^b}b~mU+k1vlRkBAePj&R=Eq2??X
zM>BB9W7vAZ%u!z~G+N)MF)nl{Rfaxg9$}*ek9|N{7<lP{^vE#M_x#fQrZNq2E>7n3
zYE-G+-6W9jgOZ5vBXsTB{`Lrh8iQoz0R$LrCXlza$=4AnGVE-<-6rWVjyvU)L)F;v
z1WNMe@C`<%Tb5O3Xz*y>V$;lP)^DOptGPz?Z$36L4NzMGQ*ZIk?cRQFA<iV8T0Rma
z88PanGSj4SA|FY?*0HuzOLD|u&nvD(G$z;&!1w$d*kHU;hwbWz3RIvVdry6b8=MA-
z0{hcJoXk(Y&L$@S1xB%FPc=UI<jkOwO?Rnb(s9|~7d|&-%VR}`@;3RO8wQ-oL!7!@
z{ir|#@Qlqp9{7iCVNyc;LW(Y_%@p0x&;sMjc^;#nb@Hjo1b(B#+v8<rU$ohSzdqB(
z9WuY6Oe_MM1iW)SUew9Is!8quh#p^}rMb9`i8nI7z!RLtS~47$516#1-xCM^lXO}p
zv^>-9sjS+o<f+eYjd<0;cmSS-xE}|StHh2UA2H<pxUae-BD5yAQ?k2u{{VXIUgENW
zK2W=|koOSU>#+OMEk;xGbcf2#?`ag;d$ft<rgmGux*ntwriC~d+PgwJ6}s3)F-ImO
zR?<HjB#`UAbnw9Y4MWC-XXeE_w)Ry-wDdPuhQ7kVE?$kzD5pygGcbD)8#_^suUp&7
zaZtJ}E2Bm83uVLDA=_u$&}F2AliHjTpM`&<)}grlOfp{;sb+{=DRXzb{9~~dt)kD%
z1XjhNIr+n+&v!||m`Cy@39|R7grOlq{F(%kSVzv6b<IDIe%>br>u+*EtXk8GNH48+
z?aGw2Il_T+>mB0JHQz%SO+~yQOoz2cPGWmSwj05nx)%IWt#_|A1>cwdlrK+cMkuRu
z50~4-E^MRjVwQcW6q)&SA%zJd9LRCKpG0jhn^Y+LQi!?|Dph=1h`I`S=_Vg&w_Jh3
zJtSY`ccCZ(P-Y@Ik-~ng_?evVAurDutIET}jKd8}-S<!th61PE3hYgpDD2Qt4wQyV
zppGz<B}9UqT*sIoLj)4*jwU`vLLsPDpfBR5`r=JnDTmNTj(+ZI014lmMi<|yoX2NI
zWGtZDPd%}e!4-qBsC`cg<p8YyMtY1&AMgS1qbwZoSczE%kOj4HpwPYmtMcZ{@d5BL
z6hDIV(@KDsCA&-Eu~HO~cF6a4Nk5-ytSO50W{yb^w>)nSCT-|AGvJVON1-jDc`Dbt
zbf*Qt1l#~yAaBJCA_Q~@m7GlQ;oPfJwhsb?>dcg(6wKc0&O(C#Mq^~EIWs`r(mE5u
z^_GemS$BF_EJh}3i6sTNEbT)jbfN_UpO{zznE+6d5;J&N0;8)Uc$yAeF+wX`>Sp99
z*P3c~Re7|=`$G^-Z8p(9!{Hq`yycfuUhP4fmpD`BTieP6UMV8U)X=^OSekTK(RP9*
zf29fO_cE^fH8Q47iV0;H%}m*hvuw6dq-kM_R6pqrQIU9597Fe;*0KsLZXTBSj(z|x
z@2-QWe4=KmYL|#+HSni|H%j<KJB0bm1o5&WnZe?h1tkV@GzA@s%;jK~^_X3<IT6Zg
zpkO6K9S!dgF#{WPRLot(|Jn1^>3F@`j8B-gsfEzW0J&D^$x>4A8s8K8gi*rzx#&Y=
zia<0S&)r{?hItp0p%PdCvJTE(4J1%&tvWCUd_I#7K%IDy3L^S$xeyDLKEtWl-qFdy
z*ksa+^JvHS^K*;MzLX>wicLP~AJ#<6N^-{=TbRl01VtODrx+-!spARp4E>RPmmoq`
zjvlqKU~FiQbX4}ZZ+(rTZ>`!%lU!z`Xj-Xw&CUoqWB*Z!y=reKUaw6+jhecUz^iwi
zBNqobQP=6!e$8M_Kk!1r@CYMx^4XJZPJ$=WPGTa^_V>kIklAvAgyCaxj~qoCc+D3s
zOl?LRg_bRkVIGDD#0j6ipMK-5)^=uK&(o3)W3Np2qG7!ey&m^__WX!cO}4UgKC3O{
z@+IFS0Io}KHSGqAXyAdr=i7bv`3LYNOQEx*=6WS``ON8@9<1DYCN*bPpr%XLhLW5i
z{G#IJsoN^p|Ef?V<Al9ifz8j~VE@f0ZEB90Lh2uKtk90f2x}!f1ar+Xt;40Z?R8<I
zeF{h;*ENvENJ;68WWJ8$a?k67FIX(3l2Vrh?(^_?u^VVV7xONfX4d(g>X%f|Z={la
z10%_}NDxq!2lCaJBX(oP&`9>Q1o`?%+v4G#&=^8etB$D%zd;{}j(Rh<1tz#Lu#rN$
z2lrYArDrK3aeC~fh9en2Q4?ZjJdcCgE3Yiih@eprv$ln{!6-NuPvzQ9_;j04A(oE1
z&(Pew@3*nE&I(;Myx$#-APTp(tFjRX1Zxa?>4Q0XjNux7v6~L6>#i?rViAPv`8_fh
z(obrG^GJh3TDj=Mrr)Xm!&Gs>8_0g1#)yM<Oz4}4;lKe3k+T9tz@M(np(JCXNRYsC
z$xogtf?^l#M>l<a^V@Gn<DTRd@P);sSJ>&P*x}Ge?8};p+D8+2=WLWXi*}g|I@JMh
zl6^lLhz$KiJi+yf0P&80tDY*!tn8ArxLoj1l3_2MF^{lr9Yn9YUXX~&|GZkAF*-7_
zfx|)&;;zK4^>eU&4R3%VaG!z<L;$VCJJJq;lXU!T6a5Fkb<^GcJqVswz$wHST06&a
z#(fe;K?}wL99+uGtc5=_2)<GLWf{Wt(Pj~>4bFVEo(A-)5hs7J>>H~V@8V*_CVO1@
zOPdI5AtQo&BO&wldh(ka5^SLXB^j7Ryv+@0-xhM8W$X6b9g>xMweqPO875<;?ru-+
z=0$^X6WZu4W}R~hf;6{K=+1J%rl|Avm9>2F>`rMT5Q@gUDPmHnao)po+6enc-;H2q
zb^-_Oymv48LSqh6=bt9#;RS3f902s3S>S1b_qNdelLK?})0-_0u@9(dONwXEmB)G(
zhd{i~J(dZp#>q>^mRbix?y~-mOOqHffeZ~E<sa#@b)9FQeU`#ry-Xaws@Vzuby29`
z%)TP%-dGY_;<)x@hcU(N=tQgT#F0}>(9X%J0*VQyu@EJ4M9CH49T$fBMb0ZsbJlET
zdm2Q@o8UEtD9|R{O^{Id7Fs97QMOz|GtT~MsTKFTOS@!ZknRn5sJ{1UWiDBy3o>Xo
z*PB5k=i(Jg=Go}(b{Z`g_g*jZ%8>BB`o_cqcxmbV+)~Hasa^g3eOWQxhpCT>YXPHJ
zjgJFolF@}Si!m*K9goPy4T5=pQwGToJ-Rdhp!lX~&{f`>BkZ&k9|5GO0cevP4Ii!Y
ze;7x6n!bF9Q>%7<N7wpP?m7%5p=e~8_<HG2Qp?!h(vz|#umxYh9>I}EJ^hdDx!*{t
z0^imPkYQC|6BHO?Kd$Z*$NUEXNR-U0(_rSJ!rBe;L=}9GKRVPzO=QR>l3@K=O6&`h
z6iL${uzS=%`@`)-Kq`n6VTjrW&b^;G#Uu7T%kEBOBU~QdwAg-fV1n<_v<ABnB#?Gb
zN~pEbzTA20g_Sm)KIVjWW-Mwdd<RFwr;oc6;s_Q#?hgyLkO#WeJ&s9Oo(I%({R)6w
zc-$R6@`5@7jTb+)y|8*`uc=InD9~8Y7Rdg-U>q6wT5oV1b-1B^6fd*rzHSpbm+f7$
z*I-QUkY{b>sb!5*Z1Z}WvSW}HrMj#)I%3l);Pk10s=E&uc$|BW>{#n$d;asyTivC;
zR!7+p!MeTF%ZkF&<($7yoyz(qP4#jFLT~}_X<$OIv^Kx!(;KIktidlGaE7O#_!zHq
z-Fu*7lW1;?ar9sX!nvcQSA9n1wZ0Q7S&(XvntuTEKUUo27hR@(aB<Oju1@0&7!xIf
z^2trGk7(jL>CJGZN(|a~x<FwL<hQ|hZboMxjnvTm+d|wZ#R5$QuwPonp}{fAfGNs?
zrRRj--vFK~(pu4hYcIQ+4`=q(J|pB#fVz*lh;7Ep+QD=XZI2Q&r6nQ7N7Xeq_ot_Q
zOG6G>wD&{RmG&PgI0|wKOm**rJZo0FM@Z}6goZefUC0%v&adZer5+L^+-33DR>~i*
zA>}0E!WH8lgEGHnN9*kd`Q^F<oA_Lks4dPpC$+s2OPBTpa>6R(%hP{DCr}Rz=uACA
zB%1#OBEkpB5{7~z%8*RTM9~<IGIQ84o{6-6*E90a-y_re{{t97=e|8SrUfi`=}Cgn
zlg#w%Q)u#I#MVc?*Zx%sMst!X&Xm9LQrUBihsPe(P~Yzv-p1vdKGnzFY91%H)-E0!
zS!cCJe=RnQ5rxM;iyy+fC{*N**sd2?*0t+BN_ZlQTs(}n-@5z%04w7hbI4lBZd2Il
zbj!U?<4d@b@)e5cJNa?;$MDt*YhEZw(47@ax0$#p;9z{enXT<FP@d~dGTm8E1<Y%g
zjiVzco(Hc^-nGp>wc=p$?b9baUA)M|JUZ`PxNhGmZ_1JeZ`|JMQE3+U5Lx-RPqTbk
z`<d(cRvYTxD0%mdJcMXZ$VNnR4d<_Zia#2eJVCFPLH&TiNnHG{cs)-}D(1VXYIYZp
zEsmJiDCk;36^_%9#~<g4RvC8sT|zi*-pVzVnZT7#7zA~!CDr^&WAi_<RB)uGPDv%Q
z2haie(l?29;2Up;r@$?@F~1-KkMR6z{;hwh+SuAnZD?kkx9_5jNeAUWi02hHu<m9J
zPsD=ZoBKa<GOpDsKts7f{RuyXSA9dpNNxeMmB=Ka3NUc(!1gP)t=M>vQoYpv$hvZE
zSwc#~f5<(0eSa((wX9$3HrH(xo}cExW85YjklgW({Rih#`&et#c9nUl+{){DVq%OE
z70JN^>E5=W$C|Z^qUxHR+|3>CmhhlI>rcutk3-j=O52Ub@Ntf77Of*svTLq3)&``%
z>9=ha+r=uu<^)0M>svv_DxKDuZ+S71%!*ldxK_Y%=xW%g&M}qQT`nZPu(O2y`-R;h
zAKe{K<Naxx!AQ(Dunm&lIE|TjAqQX5w4%0#8B3tY$Pq_n1F)#)vW9!eZkV?CbF_A(
zTxvy1{S5yA5k`rl#~O{OvZ8=H4A#_t>X+y%8^o>u01}XLKi4Pot$6u`aDRkQ5_hE^
zSNa^}&8<qVf;i<>mvWW><Zd_z@WoxYmsL`RG=W!Ymfm`vaytD#I?t0&xP#AVHKYe~
zH<k`Dl1@7N)26mJR#ve-uNpi_^OC`fFe-DLj&Kj>RiS}XP?J(`Gwn$Vpa+%j>CS5_
z;rO5a63e4Hs0Q4SN7Qjv^+?nEHd}M6MI*BuzU<_BV>M6V;0fYuwDZKIK-~LeR*~4A
zr=qa=&MIi~IK@N8?$t6MN}+`85*J{Bu%zJktRL+tV$a$1#QBK9L;xHC?eF?mLzC@I
z*|Zb1W74WJOLQYH-%yg~<I9TJ!l7H|k$dC-KT}$xApkfnj&V%qt~sZT#ClSbPhc4o
z5x@$=8pfpLg&4`FO%hKLjzkWJoEmV*2kT3d&|qSf-s2<k(`Zu?g<rZcz^1LdD#iSm
z!{>J3qdE1dS)2H=ia>e6#wwM>S9=RNCt2FsGb)_!+A>eAOD(0W@8(McPWaookQ0pO
zADu`+&PQ5PpYG9iAY!8cEnv2#3SKdjO97Cu^ELu_B(@Gc$JaHzp5wJ;NvYlW%@XM{
z5y%e5<viol+w#R+Jpq;5SkvHE^6Z<CcWsCcqyzcprWclTB&zmDVgn``Fmui`kHVV{
zr6iZpTFs~VMoj$7dt*H@{&7y9QM-cSqfIJF21pJYgN}34q0i@<wz^yK5ZimbI_}^>
z_7RmK0ceH>0boBvQAK@edeX+ae%6OC7%PBqIM3#4#pUJQw2?eE24!f=I<E|^jE>)j
z<4=n6<mvBm{hUOqND$<LN7od*()>neN2<h*(tl;fUubR7r#&;z9;^Baxv3c8jZfKO
zc%0y~k$_n9M0%ytu~yOL;evuQf(ShH?Tk~P)TX+fA(u*)1Z5<&m>^<?wY|R(D#0$7
zJQ6gPfla!C!)9@wc=gRTO-n{_w(V`0nT~TGM&tZySv5(LX^`o1vMxYnQg`Dx?bD~{
zP(!HBtm@h{fEO*5QaHgq$6hh@s!OfE5gXAmG(n>SVdP@Ge&mn%Om*TwKff3U@vmQv
znd1y&WGDDr86TB+XNabIZx-tu%%$!!3J$o>_|;+J<ffNz)Khk`YVT1<_&s|l70K#m
z=6k);f-*QzIu6x;?Mw3=lH~W>nzGuICfusUH<{{Euh>*yWQQdBoXpTLWsDD)^NQBA
z(+IcAr{3UHa2#JX#OUMup;tAonvI~qXy!QRc2MZl>?Gsdmcqht<{Sk8WU%VOw1%FL
z0076mQIA@;j}AQZDjbiKf;}q3_=d_rT%_TM<$S)CKEki^m(3pJ*kFEKcEv1!Bl?=6
zb-PUPChOD7rITE;X55K4xhY4msr;eO9_6Ve$Qd}tZ(7sv<*l{L+$WbFMj1&NAo|xd
zbvtI0IFldlRjWS`L8jaZZN!<z7!){R=|iDY`B-yDxu@d`1)jl?7v@orN3D5qU8e`H
zdh|VS##Z;1g<!XlWnsx>;8&l@!+t>|las|bLQ#J5Gpf^$gN8AV^u6g6igtf0)a3(^
zxgVuQPyYa_o=+WVkJH|O6SX*UX`b}(c%T5DXwP~L9cTb2ia#1Q&~cgoK~C%`r>Vsz
zan^tz+LRJ$yNRa*iU3^kMnU3`AM$B<q%m?kQgB8GT0%uOfE*7zQt(eXql|Q;IPE|S
zk%|E4nr=zPdQ#^CfE01ogTbcf^`$umfd+HXP<Y1_79;6K?2bhMJ0l#^H)QmsI26wG
z0N``@Qtlp<XSEpP`cN?X(i56o`%`m322Z62lhTy7Y2q17K5oYH!N%-yngwy01GNFT
zrz(dyCupH!c91HmB=n$M$ZqcWq})Ae&ZaU|h6w9S+yTu47j+>$IHkz+qa!p7GD+!1
zeW)jzZgb8k0l?;r^U{%h`_lT*0`ck1A^K8goDUwp^Z=mxbQEsqr2zd6AtOA{0unQf
zQg`B<ap_6gfD{~37NyP&C`MukUNhE#7cFdq!e)_zgU}yJw`ZoM!!(RMxKpPYX8b9j
zBSfjVmu?Xhe>&Ka4UU*1ED_vgoRQD4telLl*_Gr%vK3i2?mUj94|-232bTz-D)(d7
zsy6(VQGiWNZ?PjUFeOJtAH;qAsWI5HUNyEW8mcKLF5kuUsw*6KGXOKRdiATN(q%5l
zJ%%_HT+XUCL;{n+YDtd7?$E&Mu%I|Oz^B{`%|=Yj2vz<j>?=>h*4EP8{_%IZuHsKc
z`qbL8iEcK>k1OvJ(0}#nd8`&WsRqxH21x!Yg~?8H^LG`icJL`aSOg9ay=6$gYk-T%
ztBbj7LB?cg@Oby{MOX5iF-8X?trb>99+{%HrZp>{?9VUF+Ba|X&1p5Ci>{@O=AIZ#
za&A(MkKu91?m1pPt1rWo+}z*Zu9GUf+W{=4P6pwgwYJgt$(XO1Y`-zVP`So9>+i?q
zT#>omqbB~w@kF2)^?;dD8z69V#xOl9%ITggg5oKLsIsa{xueDdF9&Z=sH)c5XNuyU
zUoQGBk}@+FVY@gRxZ8@kVQu0_q>--fmRUT9UCP4@$8OKz#{@ra;<Q2?sYl|gtwq|w
zmfkaNyg3_pp19*V9Muu0c*ZN%x=Wbd*;q2O{G%Xa1K8%GNc>|R!-bKW<7VyWZ<pKt
z1D>_1sL$fWmLp>nB@MFg$xrpX=da;Z1vnz{TsLyN%7$r?xIZ!sFUyX@=Kgdt_|4#C
zD*z5dk{^(8ybnQ;Y7325#ul>1vs<BAB~=9wHV1#Yf6w7kt=Eo`WB&j`wO|ky2X9_-
zGr#FfLuS75i`^xYTSf^A;iHd^A0!sfA1JNJ-^CB4+dj)xyUTg$w~S+qbL&|a@_5Qi
z$b8s#Li5D(?Pd8?6x;{R(2e=}3evi{@r-vei(6Yc;S!%LlY&zmXXfLcC}5bnRNgI?
z?53v#2?2$HDZvlUInUGcsy1!oM2ZV}Rvn4AbcY4l1{u%cn$gqe@l>B`lKR@(GLZh_
zFbD4+E!2kN059j)iqF!g@pNf)FD+ts5j#R;VUs6daNG~`ng&a#Uih&!Db~&lZ?cEP
zWz=pfj=g<<l~s!G#<CnVc52>UbGME89ChwDQ<iTU%Qha~+7ZV)Rk+!o@AciqNu<f*
z<<z16(~bdb#QBAGl0IGl!S(vk1TxR#P-5D)hiWT61_5qzKAkEErtz#TE*9Oq!@CZC
z>B{FG*xkiVG~PGz!Hx??Vi@BJHk_Ofz0VjwiKrs~0EE%?1eQplScyb+%9T;cBn{nq
zXWKZS3z9#IE$kqQ*g*1wDU`@}9$1whOk$$FJ}R3}vsg{McP$%zq>O#<;oDYqG2*DM
zpZh#p$p@IbG87${=Q;G}^QyB$;>k2v+vH6}E=vupp;|l~1I`G^98v<b$>TX@fx))@
z-s7}30rbzW6;f+&77K<_%zXA@3dzEsnEnHmt;;m=F#ANeVG9^r$&CU4A155-_Qy4u
zad+c8L{0G{?_jx(HDW$qxX(=IKZYm+dq8b{q;aYURv{XM*m6sECbxm=3H&QFL|tRa
z&a5EMBy8b_Jq|d=JJzPc7_b0=Qc>sf-e}5X5$JN6i!md4=jA6k`evrLv(q(3X;)5`
z1+hX(DB2|BIL}k{trItjOSan^RT&(FQ^xEc;~f`~>st2{YD=R-EtRY?UXZ?Id|)5q
z9e=GdPBJ^q6b-MS%8STPnYwvk{{SLIZTNXKySd)t+f6ppMlglgl0g|g=xMxNDv)&h
zc)1uM6r6m-{{S94D968A)zDK`X{VD?wpd06#Zoc(0&zebowW7_S)-doEJKt-8E>0u
zbsvt@TzzWGYWj7QHwd~F!1F+P0b(~0cs%#xsPwH_?e+MYLunfs5_t&o8ChKm<!}k?
zymqLbFBDG<(Y>rF#ZJeJC^^R*@8h5F_n-`WJyOcrYq%3icek1F1`ctM0QLhFv1Klt
zJU@9ndQ&82l^z1;=gA%a0N`BEE<9F@R9M?F;IJVwzbf?kx#x9mYBFju*vI{!1QOg6
z`^90x{G^UDKZ|JV(341K9sQ%BEOE1FQiF}a1}6l7f5Y;vj|u7)v)rsOX=`ll3o}d3
zate*S^NvM9E!T>q2+OC#nB9rk01P_<H&;QT$*M}MbsKwl&gKBe@~|1;73Vn|=RNU`
z^gV%YY!RG;>0DLq#*r26!%w2g=QM?6bp#e5^%(2HQ}jPt?HfLT8szV;JW1!=53*Y{
z5y}isp#1B*zs<+XjQtHtDVQefMoXB#;z=NZG8vWIa-WoqpdNaU%C6gZi%+pb_8m4z
z(cBq#F*zsGpQk-3_LrU_M$DRgZmlrM^7n00Mo7bU8RO~nsKw`s43_S6n3Smb)J8(K
zLH_`2JREV}tbyY4+ey;w^;=yvJo}{~u_40rBy;}g{HnFqr=nfWCEU7H@;(ETxPVAd
z-80vvYv0~$kzI(Ou(x|~2GV0KldzMFFvrXS`)4&Cp>^U2wFy$wPliiWI83Kefyp@^
zr64Mw5ZaqhvHt*Pvf6>=x=8$ED!BLS{c4M9S|Kq?np=pZAWC<fuOJKz`hodYfV}Z0
zf8-l#%1F=dSP`Ay?eoxnVxf;w@f>DZB+{cfKtS?NGme9vImfLq5=#vlO&&c)+ezHg
zNU^Fsq;b0gp{Y|}(rs*pp0;wWyQvPYNy?RCdF$I14bG+FH-JO^mYY1nKv;+jxxiDC
z#zszm3b}T51Etx0j?l$8C1s39fB;7I2fo@sKSTb>pH`AfMKMbf08yJIi)53W^WM6}
z*b|fbS0$p$tVw?d+pMC7HH!txeC%*J&VP{huA!G1IpUKVJnljcuc+~l^p>d^0qQES
zVs%|d<{$C$-D^Jg#4y`jOCOOt#|s3OWlxm}?0Ku7#4DQ3fO-B^6EGxWv8EkUPcbVS
z$N(x%caD_U@9d;>M7n{VPE|t;u<88`NL+L0Zvv2HgODnW+RQODo6*2arM4%Iq-Q@$
zb-uZ!+{CgAxX>`p*Ek@1igsaiTvQ>tW~N@>Cm%|u{jp%MnG)tHHv_N+8Da-YtUO6z
zY~Y-@4K4wVPD-&E!KGljHUReNQt4y<Dr*ss@8|NY+dWDPy{eL`&d4M&6Z0rI>MKJ`
z+<Z@BcOT>aRdC<$1JDy8@$Fol*N8P(H7l!Or8LU3go;ra04WEY_x}Lv*Hsy9$BcW|
zF8(LfAl0s{e!wIvKbI5apejK*&JJ;p)K@y()1fYdtZEvSv0M8YE$$X2JBkpjN`iXy
z=e1VRHJxVSduT4K$M0Foxs0HVR~Y(}lT@Pd-O|Mvp3F@%s5nLlbLFEEgPfeP{HtR~
z@f+%Q(%VmEC9|$J7Hz@)_n_nM{-TDh&`VOTq2f(q&gShCMv>x#;T>{(!R?Bk9cNLS
zNSgcmF~qUWv&uOImm`t*e=5zm@m`^Ae{~puPa4bRMYb}BJ=l^@1E*}7euLsoPf)yA
zFRc|)QNtpT5QPNiKBW6&9qBco@2MQ#Ce{{sk*pFwG0G%t56(e7{{R6<d`qo0vhC5D
zCvC(Q1+k1{k8poOO_Roj<&|U7-ftz@cPxP82OgY%g=p#CAeQ+ri|O*j*2%mmZN>WV
zI3Aw;YFf8Jr{+PcYnqLv^IO|#tm}ktHBg-8mm~5fp|kM@sd0M(O{BDOO}Cs9Q#-Ss
zJ79iw7yKo+-#fmKCN?vu5_Su_8OJ2_;<V$}eC-x{;S0qoBW5zCu-PDX83!M&LsnZ2
zKQb$QTTqi)dns%-z#YQP$QwZ8>QD8pc>e&_sP#32qxgbb>AuT(14BO5!)-Wr!6yS8
zV->p-DR491vue^s-`!@YUO>-kcHDQS1Jjy*ayd0@$p+Jov=M>UkYxV=6$d!>qy{gE
z#&mwa^3^|`Y{Wo?GyT#0s~g11PL6TU?-P&4wc{9pKiw3K<@_l6ztH96n@J3O`*%?L
z!mv3b40u15MKNxCJv#&uOUT0UjO3r?gZb6-bE!P6KeFNrxSY068SB%p_|&k=d~9c#
z^yq}?k1j2^-M}ZGsUoPv<+Y1_E_+z7A`+}pF<fJ=MlgLisD2$itN5<uz#E%p$v^J_
z{VP*Zn^BdPIc(Ahh6`=yw@=Qgcm<|!7F~yhV_zZhkN1UX9f|6C7xAA;nl(5a)Jjg{
zQlTTZ1yILGjOgmDRFFVn)EdBwFA_r%DVhl!?%vKiV}XyZGx*m0v9ypnEA3*W1L;{2
z*lJL?KiVOo2Xk)#6VtdII5nglmqJ+s!QuyZQF91T-zf`>ji>tJtH)`s$#Eoaa?qq$
z*yM~6-yi*Y*1om7xRf*({{Ux<rZ@!ioad<eel=P2nVraORzj!m1Cx=AWA9bQYTZ8I
zu>CSESv47w_Ggj>jYMsMw44l|T<0~i2VQG7`q8eMBMzcq2nZ^??$6>XvD2R;8qDf?
zaNYBh-l3%}Z*P#zrUQ3gdQugvL89D(js2?5>Pr?W)Q|>x`%(*CbWJL)>a0t&Be(~5
zA4A@sBIzMq-2m~&N-)QqimLJ6n`BhEK`?GzmmrM)06bM>x7G}a=3T?HBX-fwGtcn#
z#y`OIsZqaBG#`v$n#TK1v}JYsJVihx6WrwE^sU01s~PmoM<-?Cpy5FbPUXvbjt?W(
zr8rxtF^?{;SQUmWfN;z?2OS6F#WYW@xdcNJ?O+H!{c2dW?MKgnXTA>%ObGx0TLZry
zywhIOT3!DDXTOL>S;*eGBPSqd9ji;PAr2!}mN@sSrX24PFbqdH<o*;hYsNVOq(}iF
zeQ}NrKHAFq7%n3FVzjay$VneBuW#3$y(!lAnxuA33+fU1!)Qm?2m>9(E3YAy<$ZM9
z?p26B!Z_*<7YF|ULaB7ytLv#9?qLZQK3|s&nrxO@vqvIHsKgPJfItdC$6lYO>%~Jg
zrmzO+?~+fMdSj+Wdk)_8Xw|d=Ym2Q)JN1q$b!Zvz8_;7v&ow5eE&3vTg%#MGkba|&
z$C|4Rp0gRlUq(|b*xCu?laIUp6=LSwR+32?*777m2E};!2O~K@pKnT5S6cyc+2nh8
z+GX1zA21z_R=d4hSxPm#NtFZ@Oy?y30Eg>Vt)ghHk~trHfy;HxN<hv9XLWIy@#=9)
z1IpTb$`E9O7bodYTl-@ROZEwPEAshVoc{p&t5hj8n@BZW%dm`te{9f+f3xHRa8?Zu
zIL32LT}s64{{V?>zc)|xdf7gh%>ZMu9@P2QV6hrn+ZD@OL_6bPrTZ1BKk@Gm{qQPI
zgQXe4?^)f9jM&=e{ypLU0Ka0J{hw%0Hqd|Hu~P2O9Mg*sJ5hE7X{Xuei&!}S0H$Jz
zH2X4#{T2`V_CLa&u6JPKog|+r&lI_s&O5{wR;wFrwue5xSg#)OL}-^0>_uL^1}oV-
zK<8t6SC06o{{W;#_}4`i?qOTuW+ES#-k;nYaZHS2o=L8wj7<F40+`q|?t++lngD3&
zP6nHba36&LIJQn`2b|`R4_bCUlz>d0lxLa`7^FVNm<k3?dQu$ppm9l_C;%sb1v@wt
z&Zo65C;`CaQvNi6_B8LpkO1c=wFd^8LG4I$-hd<=ibKUB=QyP6KntE}Kmc=1+mo7i
zI0G~Qycz{J1a_rmAX5N8r6?Rza&e4N&#fR8x*ll<6o-mH4FezBwHY8&aA{6)iU0|x
zDl-v*ntV|2Ic$acQ86mmQg)8iudRr3*2rNBfQHU}s>5m*4QRH$VGs^NcB+Jub4WSs
z%{vD#amBEBr^h?Q!Ib_r2?rRZ0)g2w%+vj$gE#>D3Wc`+01jz~iU)ouuq9!@deUQ>
zF~)jQf$u>=5;I0Xpo&5}_4?2Pia6^=GvDx_PyxW89-fqxr}3Z#28@De#T#e<&J7^O
zdQepQaZiRel2t$nEO?*><C@a7wtJ<*1A*SJoi5tO-+aNOnT8bs@BS4UyTBE5x4r<Z
zr913q-N!|y%B0JHFg{Qzw-L%6Oz)reYf=l792m$T_dThNZZAeb3+d`>E@#vdGt5fq
z@+rvuDy+@7<OE~AYdjL##8jvN^*F543h&&(fT1$1Rc3IQT<kQ+(UtcRoO6oMkcl>k
z;u!X!;3~N%41KD(hBn(#lH3qF9;4QqHlZxC7LmI2S_P3jugr1MqkTSNcK`tOp>l$W
zU8Hi%81mfX(x%f~8Q3=i)YD~vqU3d?w}+gA!&T{Gt<bk~EJAV+0u*-sBSk*T?2&Gg
zb>35=di`jqA1Tm$J{Qnk>Ss?t(|Iew^xQLD-ko*gDK$7&^35Z*WNqYQA-TtYVfoh^
z;AyU{FEu$V?ab2spM}PIj@8}TO{w4M*Cy#job9<{*r#%O9(ebtsqq?MrOib%C3Mdg
zd4;058+^jRNhdvc%~~<|$zo-5Y{z)%jP3dJ{{XUnwGE1Rw%*)3I!iM;j5}@$58gP)
z?mt?vm%cNGB@Jh9D+WMIE=w-bSn$K0*c2nDLbbd2$^elIc;r<oH!%dT?~|IbJ^uiT
zqO`OPX&2gMm5_xQ?8IlV91isy+MkRJNaIh6IU{vDBab3MgOGl1JA2bEJWJwOr(|t1
zH0DMC#>XhTaC4t_`r@cs3w?Xyn=4;Ats{|kg4+}lq_7yqeJWV5yj}KqB~3Xc5@&*;
zN{kJpf_vwsR-0Dwh2?;FtX2cFdbCNB*;9@iIOi3A!}`X%b*ce(6p~mta3nE+6@#`p
z0CvY(VWAk+d}rmR?HWDhzGKEQ^7Hq-+w!eFH&F2;winGlny}9rD_g4(hd9X{YMuVA
z;#*xpcDA!=<4IgBK3~XVz}iC&cW1BT#}wH0{{R#{;*+B~L{(IwLO>@OY~wz>Py~|d
z{xDgcMv#o5lMD#K8(6o0P^0mr)^B`A4z^oPv)^p7;AD&vamnX79MVayc%2q7x+r!r
zE0qY}DJSmp*8{KAQKxEtAh_2c7kXia&OplGCPZur#!tA%Jc<x9U0isCYD;scFnAU;
z4+9VZY?4U*0s7W&+WchKamsBJCe>D44Zi0Y&T94i-XoJ#yGsINjtMZan3RbVYH}Ek
z4omxdxT?}e;~1sBSfmo5M=&!ge8hC)9l`w9-hmPQtHu#Xl8aT4$g93Tlqz!B@7JX@
zr}3M~11+MVLgj$lhxuF#^Xs$qt$i-<SY2epaTN1eJ1|2eYOag&;hO+=-S|{myq+bu
z*Jph)2b$RevP9^<TMdo7oNmtTnCI4jAG^etT15V8BsW52+Ogv%Jp9-`xUAc&zZ2=&
ze3D4MU{+BO@`Jey?bjZP7xS)*QPeevG|L$+bmX4uMo~HhI8of=AdkkdrPcgi=@DHZ
zBO?;ZBRG@gI0q!)XCGPyLnYsgW`Kz7RaEZ^-zv5+cAmT(;-xcqwr6OCqAL90NH*sK
z?)R&(YJMU6Tq5I7g>BkGuG<(8xE%BA&tFPy=A+^`^^92A2D1PtCOyj8E0!dBeB2L8
z0MYR8_Txz`daO#3B9APb7Gsl~kZYk4uv463u{=4bYZo%f7OQ9?NYrhRsSM{QJ+X@4
zehDWedQ_B-8cibLG>85Y7-I}c07=F<$m`RQ`3jA+4N}U`n|)#vxr~v5*x#N{Ip^0j
zUw^_eEx{&B$lYE>WJNq29o!Il0!1y|_lE8k*4p9jgm&m+N88B9s4Lf}N;MXQmRc^Y
zac*(1FPs-IvG?rA81L-gok3}1s9gzVi(d&CVyn7N8ysiXuO9WGpjzoN%YPM{T#+Op
zB*+R1?sXWz7(Xjj3yU8PY4<H@ad~&<p~=oak1N@6&T&Sep}7^E&-^2@TQ;j3PRz=;
zLAqs$1L^_A8XcwGt;EZ7sl#`b`B7gaa(V0S1!Kv3;h8kMeLUP;7-C~8ou4*Xk%RK%
z)O4iNZu~W--!0TPS3*FhHCK!P*#P!Yo&Ypz8W*&SNp$PmtE=r&+T$^im2N->C%<lL
zfYR@zl1rF;K>{q~zC&#!>;oic(0&!03|a)YFszf`$0W(SC6wXt2H(5S3=M5w_<uyw
zZ9L1FZUV6&F;rumhd;y5+|N1VBc&kF(uT%s9VX({@8U`2JJwRz!N3{k>H5?<29<dQ
z`&~__CD2&ROcyxawmyCS>HO;-SJX5OLQ6gK+^WJvBt`%V0qQ|tQI0Eb!!hXTBb`3t
zX(Z)Onn>Va91H>2bB|g~YR5!I7P#x(HuiUwKer+B+27>d#tRGrK7g%uY!!z+D}vN5
zJS!#T^GkJe42=H(zSzfTA-Tpu7~P!vlj}(hl&-C{Egs0UI<##Py6#BZ8&{n5_ae8F
z(@-8CXx~&ravyQH&jCT_>Co3UExa=K0s(n^R%{V5+nvO>%lCZ=HMlOcEe6_MB3Wh&
zw1)XIa7S_mI(I*fQ6&V>HEWA_$M)26h}beZlacbUKc3-NwFvI@8;I_-?Oh?a+xJUj
zBp!G*7MZDNT2xXctg|?lLAc1cIUwKy0LkMV=Ca_2!z{jZ*B6k=SAN$D*v=dKoq5N-
z8it0xlLY=<*^^jFt|W}2WwEi)w(bvMxoWd$diBf_Ms=8`jHpIj=aHP8{{Wtp%e^bZ
zwyKvB-CY54oAI?sAh>Qu&+ly<{VL{%ccNKH);fICO7k{AE5JPW0182&P4t~%)(~~L
zU1JL8bL8#>XCB-i`|7tfTMNmfiS2bCvf(!1^k(h+&*@x+-k;&?Tf~FyH_{bz9EW;g
z4)9KLyz+la=`|~z4(CVH&Fr$Jux0X}Z&C){K?HO@p5qvyg0Sr$OuSuIIqvmHZuTPp
z19O5g{Qm%zbjIBZn&kXBWuZrYl4<u-w6QOi5!F{90yzOjPbWU&y3)WQJo0)PmQu0i
zCN%!qzv+Q;!n3b*2xq#Ph1Ai*GlrHGKPwShN)dH^OK>9>EsA~I_SVo#b2-}@43@=f
zJM$BzjG25dr^+r$mP0lOBlt1tPt)`(T{h?K5xYq1AD8n1{o>jEYC+;XA(a5Q`^~on
zPIFNo5a~W!y4<eSaGV2^o|QU_-4a~}+FSE=_K5-+M8+OAmji=I2Ziib-bjlxZiC9t
z83S=S`twecU(yw&LvR$tGTal6gZk8e@RR9L%^Z8&hgK#{rwUi7J?ZKm=#cnc(h`pq
z%&Q;;U9di2dw!Jo{4-*b#UPpU7R(F`9kmSJDX>zh4(E3bf>eN|Mt*MfX4hG<xt=?J
zIYq-LVuK_CMsb=o4|J7un3GzUQuCb1>y3i|V*qpO(zSG$v*KG4-|hbZDylXIJeskk
zN&f&9KAbr@FaH3b(~tT7MOj?*P^cHDBDooSV<Z~2#e-NpthWLvoelv69>0}!WMrOr
zu3GoSmX;Tna7m@zvs;bLAW??t(C6HKb<VXdyBSBuR!b4MO%72u(;~5maL1gJkIeek
z%>E_&KAERn$!hXRcYswm3UQuEs29c-Po>YO3mJqkx~Wowb8Z;~b6HS$@foH2PMIkK
zagWLw$OAm*y;Z!4y}Fw=z9U=R1@&00<;r!3_>WKVtmg5ckjEP7bEJ-{#6KHBaJ=#E
zPvKWDd_b{jcGuQ6qGXZOJY5+<0G^%3dRA;+I)Nbu^G}pbwV13!BLYI8bKkuyc@F+%
z?MGOPMZGa4gFI}Z%R(?oB>Q`QwLp006<Gsmvx27sp1iNO`(L5074bw5rAerp3y~7Y
zBUQjG$J?HtT86{LR+rcC+O37eW>U%>&;iHm+NRz^`IL{1g23$BWcg4@!R^ntwQ6d5
z%vSm<>K35Q)f51DY~!Dy6`uYzw2n!T>6bsdBxEZ5*dTiQ)DrmC+(RN;Y13|2WnIbw
z<QyE}<WxBM4L>qnJH)2{08oP0>@L4}JguAp6dpM5llfOhioR&aTEo!%LUmbQC$=cS
z4plM+MtMD}aXwjB6_m7*YvDB48*@vMo@o`bDM7_ikZ^nPM;r<_XSFvu>p&SEDCb3P
zPZA;hYhE0fWB&kjRyT>?Zj4D8{o;Q**NMMyp1Vi#sX8C<W9t6^LmBOLARo)s6`Oky
zi;R(ycK-lMg)Mbv2oAFt`FR{?aOD1#3Sa3ds63L(F_JgPW*ibp^c{^N+URoIT+bPw
z%R;LCN6bbBJ^B54?Nnf8Y9jJzq>?>VWo%$5<2^^|{V9GPvHt*shG5bMacXxQgU&@k
zI@l~teFT#1MGDA9NG*>40F5`{(6#>ngs$jY1D~@TgPxfftz)q-bJGDCBy^{y(t7hz
zk<Kbb#{>1IFr9qJnM0M_q-1ui2GbTxM|RYu^0tuVXC8<78s3>>cpYRojHv|Y7#-^x
z!rMs0#cwwM05}j(x1suRTS2t0ODhX4J~CEKN@h9SGEW_`{{W8<(w#IKMVy8!i<twi
z8>!};_IeGp+a%e)IL7i$MmYT{)#7PHiSDCTGp+&T?j37RZF-2O_DvEy0V%j|CK<3~
z=OMaa@$Xf(X#(fX7mQ(5*^C_Jz5O|>ZrViAC6alG6ta1MAUI~=_xg%kxO6LLF<e9t
zCnZiuYz*^Mo9l2O{?4<uotAw`*Ls40ZqD9=HLsgpLc~D@+j18UGoB8ArB$C!)34p{
zW#24lyEY!5DLnf1toh*4;hg}AUzZ`sB#^9xl0PBSrfPmJ_XDAp)#S2R7Is$v4gR<l
zRdl<RxK?dOW=!O%<G)YJps=*lB9Z5}d2<lnLFZuf>6(e`biXxaYuEX>1A2jybLr}8
zR+?Y%1Ef>(^sa6wp}Cr0Cst-5{_YqBz`-BZx&S~J?^xG%T6M&ro3fcM94n4@4oB(U
zrkl0K%QrexUC6UXe=;i$0-O#<T7k5I9Ktofl@;BJp!(#Bh-n&8VvBa<zXSK6k&(9p
ziknfg(`UMj-CR0KiZBBK>^oJb(*FQ}i<b6DZq2cQV8pX9%LP2+KbPfHB+(uu^WRW$
z<>AW_(`hF^txtER>DOp(WtoBnDZDtq1Yp%$ojXP;vF>nNDnhdINjW&jy%BzYfEK^9
z5?w#axVn-=X*|H^t}%i?5s~=SbEG5)o>ly@p&L~Ck}*Kjw3SEy08A~692QpFw;0DB
z-;cdMD-AU1j~r6S@D>hOK1lxnKJ;GQe*u8d*)o3JGYnuUCmk{W0N1T6cv&D&Uw#)G
zy=y++!ou98<WiOjPS-3k$j7I(Rb4Yn67Ty_``dsL3<3f6_oV&p-{2#7411bzjcJyz
z9JZ0POj<Ias}e~g>UpQV#k@qUv&OB{1+iGP$`p)JEPQ01wHd#(-pVc`%3~zAuS!1K
z36RI;F5uxY??s<rBv{Tlp`rkSdeV!COrkL|ZzCXPp@&hlxNqIuMt)G;dmfZofhUyR
zseHb9qwSW$Qy85$00|q1dQ)`<;H@G8RIulQ1uHNZB0V$Dr3NB9j%q_axg!$BPfTtZ
zsRHFsKbWPc%Hk4O5=JQ`iHe>&Rj|19CZd{1m5MZ~t&HHDaX=h@h+``e;=E_YgBLM=
zHSInlb@B=G7is8oUM=FX8tN<%diSo1JD67ZS%{npcWl!W?(!-A*simTKt(b7p49H#
z(^&dY13J@(J+VyP%{*fi0Oj{Ix#yZdDMwmBDL&lObL~sskor>q`Mc6%J*f8WK*8@w
z01s+V2sBcz0p!pEcl4(Md8Om8tp<P)8awo-<IrZC>%{;!ob;vqDa6uHF#*jRxELJL
z4`EUUz@S4n9&#uLJ!wuoD9_S>5b%0Za!mx2N=_&Nta5qnOP`bq4+4&O;(!jFD^E<*
z4dZ#zke2bBx$b?1RE1+cUR1Fsk(%qLv6A0SiCWmf8w}*OOH|5Q7}T3fM047d@R<m<
zjHF|LGg*vS^Hwg~=OU^WJ?Mhas!Gb@`_g?Wb4|@rsN<RkTw<C!^GXSz2L(9JDJe48
z=}FFdPy+Kt4_aJgd(bmLfRjcD`ce~<K|G2EFSQ1fCp5jN5S^)VX#nPz^q^tSS~((+
znsE1^2SpQ0AVsZRA~^ork-38R?rM#w3K_}3Jbi1i@Scv-2fmpK!lUH`aBDd}ggsq~
z)5Em1uBRQdS#DZcLpiOza^T5uP<_?tqoAxwBW|Pap7n|nEQHKkxAf^tVrN^0$lRIc
zh!iwCnXmxnqf3UhY@!wioEkSB&HKxZ@P%l@MtkF-tZ8FOT~r^NwM@FQ$;07&Ks;7-
zlcQdSjkc&hxuqDg(z&8-zRws81{<jEDz)PIjIp2u0oImF!0KB$J%_D2*@iLHo=>$F
zdzx~DF|w%#f;t~soX8pz8eqr{O<jTqo-zb^2e=h9I!Q;%BWKrbE0nY{hLC1VmOS^W
zvgyXziCXH8n&>h!&+y}lduXjRc{$HvPn@n(hPaC_xGvM_*{H6D`$>2Q%%uAfMN*O}
zBL4t_Zf-3u^*L>zGe{s9LEq*cmAxm4^|!eDI%wa%D9_~_h5!SDlY!I$@0#X(A*ftf
zYB#3Z)XyWt2YfHgIXJGG_rzM^Qn2Z73oEjNg8T4<jD9$&pT=Q;{{VN1wWHqacM{yK
z?w*jMMY<OL`(Sa_ve!}ZWJI)fPjMM!a9e^tRm%10o&Nw#d(uVXEpv3BX)?08QyCzQ
zfPs<IoEnNB6L^Bg)!y$)c~w-iNZ&3nne07iM_Vknh<s420nmdCZ~!?yan5+{P5#^Q
zN?l4uj$}srszCv9o}XS1Jvvht#QM$4MJyU$?ua1mC4=V}Amg_`l_GeLU)gT|0NC=D
zMFv1dH<E<@9D(`Oh_ODk;&9|HlHp@u!(t!a4X?*vU9^_k--%F7B$`9#ZvBNAV}#&i
zuO+=t6<Bz?SeoU88c}Z{$d)x?Pi{{fV<i3+sdKJskm&1nwxy(7&n=Nul4H*&@admw
z0JW{^+P$TU{ffn;noD^k46(EAbr}nQI+A<ir>#^TE!RXDUk}_8HiMYo=H%r4-kel2
zc-Hbff5ejEhUQ$H_S?@-_P;|{EPP`<)$Oz=N4Sk<lV<kM%kD-f0c^Zcs<ipN(e5I*
zVoN(h{{SEeoDY|ixVK+Qe!b#r-8)!aI?~A}k)sj;h9|B&4^Dpyu@8xE$B0gsCZ8il
z)0oz9qy+#BXV;pqf8yu2zM2uF+(=@S#vN4r!x_&{S`gU`z9iSxM%@NRIgnsR{{Suy
z2X1rMj=x%fc#p*2X^n=5D#zvRWH7!r5<X&aoOR=^KmHS&rC2}WNpg3BTL9&LXBg?|
zp#CD8apNseTYaJpB2`p%-Uuv8l12a>@IMM-9(-5gFfu$lDdmQIx9yA`ojUZZ1H^tH
zaVa_}O^EG+j!D4)0l>-UJa!(nN?#saTM4}VGDle1%FBYPR5JzZ><8ytSH2^;wzIXK
zEj8{EYi5|3n>$K?cK$iykP&Da&bNDGarXT^<CX}wD>O`|R>pc`AJ(&%#d`aLzr*(%
z{Ka3E88Nh%$?4l_{{Y`YtlN0T?(Y5@RMGAb$ia6xzysH(PfD8q0L0gJ+ML!fY12qi
z)fPf<rzl%LPBB0fKj9(q6~(i{bXgW%t@D_q7$HgHjC&4x)$Jo$)jzRrq@PNaWrIFk
zOpF>s^v8a@XRT(%<J+-hj@m`b%p(loDPD310*O3%cGEK^lW-P3NM%1b+UEn%<wxg8
zX7+`w>N=g}%s1L|TBJ&)9HW5w&Opc&(Cxxx9G`mSbPpAcZua8a?6N@c#u>LBa(iOB
zWp9w}q{fae>sv>fQvM!!)eHQ{r0(mJ_kY<L{{VPZ7`2$badYAGBecYE8OTyIo}7W}
z?Oo<1IsNY)`KW@Bak~T5QE)j+9}!7uJ-}TRjGMkzgfQHsvD?b>bDyqzRMrw(Yr3rO
zeWj#lVzQYK<%s952mb)Bx`Lc%%<IyCt^WW$I?x7J{3BXmyca2Ip@Ib4leZmudh=5a
z3s3U{eTEXi=ciBeiqKK>Zq9pBsAbC+<kAB@bS*g@W&0dnV&exLKh6bOxqx0l<y=Ct
zAUVSf^HK!KKRo~fd1Kd#k(66N(}~^o7)k4rJDR;|X>Dm4SYk->+pwe8txQ;BJ*h)3
z&_E*;YCQvxNzHljx`NA7zTe^bW_c%OXOWv}%#67iQ`?`!SD_3ru0m(=6Kb<0PY%HC
zwKuNiLPicV*8#fFfte>&fz#~}cyr5=GK6`G+<?GvcH^dLZnf)c>$7nuhozEO%Mq3;
zS$JIIZzG@5x(zx#ek~H>D~CgTgqRC9cZ}x*=kU!`c)U=vyT+DHC{m(Q22UJwoZy^h
zoyoC@Ca-NWTtjQ1Z<Rv@I4!l6P6-(IIQkz-Nv<tt4{tArrBq?}({R8C83Zp*0s2=_
zC9bh+X$RO+)LqJVT(Cg9n~qPfetwl6mV88EyE=ngnSy@nX#j7>Lxbx@!p0?rybLyR
z-RP1L60Bxd4f2DGoE7ABHL-s!o|Lw?)_QN+8bSgzN=DVk2Y`EfR62BiB}>Fv+B0s_
zA3Jl0U^g+wGsntDPj5<oqMjrggv(@NHib^ywh!Gt{Bw?!br}pFW4zJsHCEAr&Ka4Z
zVapunImdkGrBH7W8El2C_;N?LjF75SmEa%teKU%&<#@n+s_`A!-63_)wmHY?Q$W5Z
z^EOFwYJnX=Qo)YXk&<(q@;IPGng*=%>gExoeVJt5&n^k)Bz3^+jQ%y#H{EW$))tJO
zBYVjI0JMxgM$eyaIBt4i{VSvL_V>;zThyeqJh$g<TT;j){Up<Mn`tk!%bQ4wsgZG$
z+NCkD)%7wPKj}?SYZ{bVY)DwKmQq40jm5At`3ly55j_gFz8tf*Xr&?Km2z2`v$&Cu
z<x!ssSa~KT5(Q=l0sDG=IjHoX6I<RJOL<Fuszu8cQWQ5_Q|^3CZ*QsHT1yne$#qrQ
zGq{nHOHq5aB!3HOyQLvtY=C7$a5)E$%A}XWwh}z0k;roFetz$a{{SISCyF%rj7uM!
zOoc{vaHWm_H56LR-`Ezn^BBX-`&)yIZaoL#Mxmi$JTqdv=2j<uOGrsOmudYehr>2;
z@0JF5rP>q_*~b{q*A+gSt=j66NgOL6WKI77GUFrKvF!X;wN_0+6iB63WN400%5j1y
z)IHOti9$rEGxCfBQ|V=giL~B_=70SLv$X5zH5+3+zU{fe3@||zqoia05{*0$_WuC%
z8gbw6{E9scoRA1S*C%n~8!LTE=TEwUjEOqLp%gak^gpF_q<}?o6L_mcwA8O4zJ+6!
z8I~}@Aa@hdv-K6ui;;U>)vYubBJ*v_tjtwXH5kYl=RGSKymz9kd|J71U3P^|N~TXa
z_r_~yN7gMh^|_iD_eBJ|QJ8YyC^^S&wVfx6JU?zpc$haNf1~mU&VTe1`BS$`3+6(e
zI?~uK+bfKLxT?mdZ%==IwCC}rlM_0<l<O*%1$?F8uP2=2sj5=z{u_JIHQkY0n`UKF
z(PwW?-7{PIz22Q^q{%h(JFVoxw$#b_hC6fZNu}5meZ<nWW2#MvZQ~Y(J>iKPvyw1Z
z@at4H9}=#as?QYmW9;#tmULY1I|C8yeqs94KjAXbt>f7VmvB%KJhD4v3ewXxOFdUe
z{?Uy<iPV<_cO7b4wzerhGCea|u+`p0w?M9k42}R}>Okv?$h`3mm80s{R>I9x3^cBx
za?VKXPd|E_AB}Wxv^>6Bswx7qgvmK0Bipq)Zy0GN;IWLDz#*h5&OrcwI)@j1hs~zs
zx<0+8-|8(5jjM@dEM#>Hfwu!EpK;UHuWR~*+Fp%udv6*%kgo6_I3w_?ntzD&>-|nU
zTR7Or`+;JZ3xE&x6>DFyxzuz^t2<cLrI~i9X2AUFE$^$MzRNPS4;X5f+Vzf~e`#+N
zcebBtiK1di7(H|AgZfu(k~`NAr1)o9w(%Z~eLbWi3p*vXawY`yJmc}M`^)w<r0snS
zBYSE_2|ekfAaZ{Sn{Tx=fCti`qYK3=yGO?Ce)T_{Z9|2DGtbIDm1KCGbEJSc%&GkA
zUL`(C43D}hPKkd8KCkpKEv31WRCwjnQD9<za~?6*^YzVFxRX+j>S$uM-EZb}SVkFh
zk4~cl>N}2<`7L!OxMv!?00uiSMnK8HJbR8kssV4Q1~7kX+Y=!37-u~)3F+!r@~SX1
zFD1WADNMF2xS}1Q0`rb|1DcEB<dPp2U2nG$V%^6B{h?B7vFdSKZhclQfQ1dg2d7>>
zw9ki%(fF3=Ng#JHu_PaHTE}8u=cDyCI*vUm6zY3asybB+Wyh8+q%#5K?K{V}dcunP
zK(~}jZ<c<{h{rX#aW9huk`ynsOKlxZV;x=wMq#GNLUErgdiJegn?$kKSDIvE3%PBw
zWh}_V0D5)g`U<fP+&2J0<Nyj5Mqmno??^ADmrkBoZJ8#GGLgFVILM}2Uf*0nD0l)~
zD(+Qfz(22gcGLa{6(qY^;(@-&8>*FMc=#Na9AnpL<KCsczq5wsPddfi6N1G72LulN
zDpkDIHnN>R=ir7Xjz)3#bg8YcucWwGrm!)g>iOVRKTpI(W3FlOji%mxtT`e)gT_eX
z(>OH@dX|i0JE8L9+V~|&A$#Z3I2CeTPWCw&Uru&F#3@spjN|pFhM^7i%UQJ73o+Q+
z#{eDOfA62vP?wkD1h!Y2Oo5=bU_8-+0x-`Q^z`DQjXXZnD&+wmbTA+ckA4O~{VK(k
z#jD*s5LlSZTo)(?alq%Ps9@Bz_q__XduAL4@`gtrpF#a7w)VIijj;2I=OjKJGHzl6
zE05uBPTo6nz^;fkdsjdGtEb6u@trtjTm?Q*J%$hKii&sFak2=`gA}o}a(u|yQHCcy
zdSl+L-~Rw)A1?Coz%wfCZhl}nAI_h6_LjErPYsp32W~QeVB?P8N`eXC)hD+}td1ij
zDIo0opyM6-;<Vr1)It5Bq&1q_D;0`aieP$=oAo&S#TL=%H?qX2yQPsgC^^nQ`q-&$
z<kN2M#7SVP+~JxL@BRj;9ZCy*NU~|)y@ezL$>3pnWC223rEo8w><Hv|H-RF)2my%<
zx%40H8WQ(LwX>EOoOx`!!fha)3GO|q+Dcj7O)HB<^EjD{{KZ*|0tR}0(0>|+_Tx>p
z)LJ>T_;?uHB3$&(r=>2ux{S9A>4!~loLa+%IRpW~Z2Ry<P*m{yjj@oyxcNg6dt;}+
z>rWc?nF(l8*_5zS$gu&CK*#7sNV=AqlPMNOWXgcvNXXA4`BSu)aT?Z%6n2rUEE*7?
zAqP1hUiFoG{g?fuMa{dPpJ|l+-TMi^9doxmt716>k%wI2fFmNaF7LFo)EYVLx6DS;
z-cUIh2e0E<!u-r-cr3Iz<C;{;qzn~_V}<BJsbzf??u7pUXjPQDzTuvBo<9tnXYlJ*
z+DjW<JlrL+EHbFvs~8ysbR+3ePBhVGFHNLQga-%88Rn|@eL#<Hm1BDhxhW%tWOgSU
z^%YU$@Z_aKG->iIV+=;&&N&@(gYU&&w35eMfoAem%6zzV>5<a2W7Kpok^capg>e{d
zs}~>xkLFEMz53ilrVkFx2ImSC<S}A54_|(@Gq#0t#Z1b+LzuxWv>n7AJ&7W!t=@+u
zr)8;U8A3dta0vZCr$eY{L<jOdVs``OpYz-FrqlBR(^zP>v#2f-Wnqt)<Q(q*0NHBj
z*EI1XMsA|{amitZ&!??bk?gMY*)>URcc_fMKZu0~{7>gp{@vmD*f){47{J(jR(9sz
z>}Nw9=`sl-b#*+3Q^qSVShv$BbvM$gI2ll6+rU5KYUPBsvs$Cts90EJ0J!}tFIkgL
zivBq-eBYKL20rP@_UAPaUj3EE_BoFcTxo*S$P%l@uGk3K!RmjVc}IxS6}Uqa1If=h
z#d@}^bg9XTC;%sO091f^!N=k&%Dhe^TeMi$1QWWtA-%OQt?-#K^v-F_aA}Fir$1p^
z9D*}(Q66ec4ZQWH8USzMPf{_>Gd$o^hwDrShUS1qaYCF@^yx@odUd4lMJU0b1kY*)
zGg2z<Ju1z;n#$NaiR=KR<dE!B!StsjZ6k#WNj*5OqSM0%XqMm<L(q3MzhR{5mhrQw
z4ImvcoK|k4=p&7X!}roWV8F_){8;EKqPOr|D7&P(5@d8<2&)OMMQgloZNTFOskW;<
z!@RM$`VJ}_q{U)&@coKMCz|Ck)84t8jW=|TVPBLUGv2RBs4->}l0o;V7XJWY#C#sq
zB_tLo8%6+vgb`I)HfMuc(%wlS%O1X!68TTVes!XgLrBa629AfCyEGwkdsR{eQjqL0
zfJRSBY3oiuT0%Lh5S(_U;8I`;Q|c%IG7UL-Y<kpVJ!$9*FaQ#B&`<}Ycn`u*>UV<j
zP#WG0aq887;w-USD#s5_fDVGYts>eV5BN^rGNLv}gGdJ%VmYr5@n*LArlTMXe6=_O
zHJz`aGmk73I<udVixN*X!@#BdX$csu2Vl=MG3m`Oy)^YaP%y~)QsW1jKr$)a2Q&a2
zfGIM0rO$KLkQx91!1t$a&M64vrfH-BiU3~bkP+9l297a63rcw$QW8L;f+zr^+JVTV
z??4X79Abe@KD6u{;(#qdAjso5H~`mmYpml<OIX_gFD=t1xL7UZatIh)XD5oi8Ieu{
zbgX8K-ufE%?-W3t!QAyDwPg#E#|NP3DYDKA9Fk2_X)rjbQ3Q=>r6odxg*`<!;e>1V
zt1>C1R?a?^YAFQrjprt-mc^)$$s1>QI3D#BMTEaE&6?;05#61b-R)Iw^n(j!Gsi)S
zcSgLS6dSF{BL=NmKv97UoSv0l+_(eGQ^#uQG`N;VQs8oW9<`jAqDNEV>ot-9UOwDc
zK-zRbaEi_E+N0BvR^1c=IOm$u*uZ20E1OnyD5Ej7*pF;}6!BnyU@kzbWm}R#r2~wb
zH7dx*xYA*i63LTAYY=wh6jKgVc}Ijbf9!oi`fsvJa7;WbdE=h^a4WeUCAyzPyuOP|
zksc=z#)Oi@k^y1>$OAd=(zss<YRjYE-`unhHX<J?b?aS*tK!Rxb&0I(nniCZiWSQc
z;g26pwY^1ooEQ)Hc#mCwS-SAt*AZ#5#d{Z&6%1!G5(e%F;C1z;f5J<v#cZSd2I}OP
z!#Q|aFvYM&0O&dO>6#+fwSPI!*?jAELSd02BXeyW5!7;MeScq(?IgF;&zCYGb!f;j
zoy8m+`VypjW`uQ>+r>KQiP9|w=}8-qh*<69e7M>NuX<y6r(A1|hRRq{LZTq>GMtq|
zw~@)oarjqRqiRom9H{}i7)9qI;#i!aAxKsL^%bOJRwFT~DssGX53N<g$1kMoT9w*J
zlW7y$IJGh~trG%d1Ew*9RblZSwPO~`?HXBR!NbI*SAY(2gV#ADwhea(jkMuu!ZW+(
z6z&!{YcCq!O$2eakizAL3$yJ&b~BTM&H!J=q_+5quM{gLmobrwE9`FNK{y!o?V9bz
z2UVvgPfz7QtZ>$!5lIdw(xq&%*kf)2?+OEFq34otD*ph8JYD^ja`D^SZ^gSfb_9Vg
zG7#h2J?pK&3(EAUizz>F3{W<3_dgO9E#(%vY>g_!tQm>e3uA`h5sZ(=ibwd5<wB+O
zX~-%|W<WXudUNT}`&V(ec2IpNIpA!f;BtCriUzY4<PvF3D?uB(0zg;8umA&-&~@qb
zs?+>Hio`Tu*!K&uP=pPR3X_hVus=HOvdBT(^`|K;<gnlhR|_1bv#;v*8m+umntI$>
zPKwJSqZU$l=bUvT@Xb+wA2Lnlwvjf$xl0)WlEIaK;6Ho4cNr)6Mm_2=*X018r2uhh
z@d__7@uXY=q=HL~aKLlN1DxdWDZlWrQYof}=S`5vmn{%6w*_}N2fsL8ezn{#LB`%`
zB#+EevPKv;1QC#E0~f=Z)wZ;acW<XjZtgy5N@ZK<<E?M8%w!RYiY1OHL~*E%6ksZh
z0aESbC#dOC%10p|k2FE5O<{1iR&qxfc6)^ipmFF)@99_1i+nsFGPbF0<@)ZdC}8l{
ziTpu2-dK~UxNulG+Ct%Y=dL}gKg8N+ht1{Pyk2Fs+sdX%RF>LXuF;+|-kyZ&ZXbvm
zF^)z;T*q=D3am0zkUY=#ermb@0120e<b<>ri*(=}u|bx1AY_0(m5HGEZ^GBwRF@E2
zO34vXH<;uZ3WZ=u2OYuuO;NPE@U4~AmHn-ZpCp;y@{&-WlyFbsMuDm62=U{PKqH}~
zFB>*Gj+M>D;~QCI++dW(a6k)^0TGZ-{rnYX%f)sV+LTsN#Ue>ALhb_ujQjrpvS|$7
z+Kj&{WAUZhse`oUur)6hSm}C^vA9<b0Aj!mqd)$tqI`d+HN~nxrG%`i`;G|QtXK71
zAFUP{*X|sAy?v+zZRKkY@5Ex;!;ot$5%S~+#R=pC{b@AM6x!=rh_tneO}icZ#=y?f
zpp1XOsaR(2;k4%fSDsC#SX^osSC8Tpfu43pNBJ0ScKJ!&_;%n5^fAUodF{>jhU2@t
zj%_~R%x)y}6hBrn6(_H9x%>qP8Dmn5Oux7nP<Wo&1oHg9^?`=~WaoFFKb=je*jrsa
zt=IPYK@&g~TRchtIXT_aoc<M<>EU4nHw|ZS!f_xUJ_riD_s2|B$HZC#+9jm6GBvy(
zJY|>?0|C!oKK?&CWRA61MXsd{=DB7T=0z~dE;lex!-5GO!;e~#v}-#n=!M?Co@x|t
zDcf#O0B~ErDVG;M8Pl(gzu9MNlz8L>HwBIy9=(21^~Ne6?L8}0ntR!7iIO;?c}hq@
z-MC}&&sqSsPL!J3>f^+A%Nt4N2wB4LP>gl_dUmK6LreK?C6C0B$r#-$gybTY&m=ca
zG5OPEm%|X*TV9Jf(mSSPP#EOk6eq8vRF*ongJ&H6O_j>6;0pOU-M>Baj(MO8u<6=+
z9l!9D#ke*LZpQwtkG;qt*QfVIOu8MPm2-1%uSG0z#tg+U#BCw6PVNZ<9M#PqOYrWw
zY|~oWvarH1G9AEeU8k?6KU&&@!}b=Iw-)i+u#VzCE?luBjAM_^lVFjH;jK1XeQ(W+
zQ@6dbiX#?QQdmAtMmZhpv-3uI&JRk>)3jR)7m`?Qu`80sM&-Hd&uY-!83T?-wM*2b
zd8lL>uA~S2{Ix}>X|}qIXqQoz2*jxe1Y~o~Jiax3M+?EZZnT<})V7*k-ONY~kwnh9
z85sh#pTt309S2RdxQb|P!pMUPLFrDr(e&%bnpvRS^E$ho#2l!=Bh!k+e-m9xac-#5
zvKZkl<p4=$&R4G$UJn*ro1rz$yM3LZQp%XZlI3@QDpq2;H-F(C(qr=EOKdb)D~348
zIT`h-MwevTdfFIAksD=KJv-MwsQ9_%vXUz}9ywTmkC0B?*e4y2*VeSP4S6(`wYQoX
zB$ia%$GGW|Y1xI*e$!60v6*Co5TwWD=da7@P(`6=@kJsFB>mvQ&nN!?tx)N{AdgYJ
zSQgeu!B%8;BMr3R)erbeR@cv2ZRD7&(q)DQ)m8)g(z6}W&{|qsSX-EFqY9bMGn1OP
zqm*A1SP|cU@~GmFI)(^20Mxo?J}A@p#!LSIDkHo3{zaaK3W3Sb;arBL;tvek-^mrs
zQJGduPR$AVcw?O7pSpT_*IYmYrb(>1w2eA@hn8(N)!q4G@d8iR^EHCEQkjnzio7vy
z%@k7@i+t=B*~WMW)2;}rcb+To$hVeA)ovt2F0uIp7sxHaBhV9F1L#^)jmJ&3C*C3G
zKfqLHL(<49G}}T50FNnu!ky7Nm{*#Qg)KExHOc{Y6mA|<Fd65t!K>H4CDCo?Yg>t%
zaK=-~VmSbg-h>*vd!blfJa09eMUjJKAm<$c<B?IH4_L{lNqZ%-ys`ioKP$i(IQ8IC
zy6QVK9_Pg#9gR`^t=VPWx&pXU#(5mn{{Zlncz)ma3gr;9rUVQWk$`)8oL0N(RuV27
zPqrW~&<sj=^yy4pA5JGf+4iFZpY<!jJ$qC)5!snGH<p*y*7I8FO7TqP9~(!O0|ArA
zez^9nm$J10k#7;tI4CLB_BQs4Qr_AqRl11KE`KVVu>f(>vy<#vMQH8q<9*2lXx(xY
zRPht%sO?SMSoApdq9T0dKJ}X1xA3!Naey!>#DUtQR^U;%p4F+&WZrAh+uThUw`n4`
zDkqdM9$tCr)YRIRrv{y3mo5v3BVZrJn$OfBOY7UHAqfOSX}g=d-~tqW7|E>dcJe9V
znMycFQ4$QH!Q>Ki`Ba_oqX{^xdj22Rp{e47{{RwD<BZ6iv);BM8HF?b(OBB#>o<mk
zz#XKa8-_d9+)cXLGmfY~l?F3bq?eoh4o+n7>~l=z=0m)*;T-dmp5CDTRUO5)hYin{
zJhQ~mkC5$R7;H?Q2d3UCcer$!jGAO~uJ=~Oz6yZHA6)hPYfj-~lTBNu(_@v`DQNZr
zamTk|{HmUY2Oobvk}PGlStSE`atf2rKHWH`d^<~I@jT`NST(aS&!J)d6+W#pg>BkG
zA>?E)xgM1t!}1@*ledy1K0_!N=r;<|I}_COk@vl-LG-36=jl?Sob&io85P8j9lVbm
zeq*YVsh_-kD;(-tppldNEZ`H!ZoZhUnbt!Sn9BK>J9Fz;tsc7}kx7CzW#EoTIIUrB
zwk4LWC%<tiyS7Mn{lKlecd4on-RqYt<_koPLwapuImp2^D7V&}mHR|M4B+kS#~=NA
zTYWcINm#x3*vwdfGgi4*VHPc<)mmuH%0{t|z7rmY-|70(t{YYtFZOh|XfO!L`TJ+v
zrhh76)9*%<u#2zXi3^!O;AOv&#YGmItPFXYg0Sy}#~k~6kII+3d+0qvd3E*jSuLP;
z!xu$h06m6DtJbsLy|cZ|uvwI4QBPhzzPwgj>6*-HJiFk;DPBqEk%RhGfHl<)cUzXq
zg&68H&*@F1*FYw<zQ3AuNi@?OZPoI4{4xCLmv?tIx|k7ZjWTV+NTB+RbB>(1ztD41
zY7%N*a>r(hS7zc*9OtD+Yd*5q3N9_;ShoDc9{B!UX(YGM4UD!v?P4yYb`?YEG8uBY
zDyIYyl5>tb5B~sFZDF?c6_VFF+OmOZ2^*K3^cd&$;-&z`OR3%}@uJK?1dhI*%TUX$
z-C9E=l4(v7JmBPxhXbnjtCy{*v{3z=Fq3O;34k~8w>kbEv`H?m_C$+l4E|vo3t(;R
zYS%Ai_kcrtIj~!Z?EJ@P+qN<~6M)(D>G)*TMbvJ?Ex^$ocQ4KeJG=41{{WoS%Qm>5
zFWI3W75*;W>Pst)T4}L!YLLg==Opp|G+8UXKJX$M&Du%wX!5F(cN4gDDmyQsC)19!
z>r0b;cG69zJPu<Ae1jzWbfjyoaxybz5&Od`+29O=_>+&qi@CK$zaCAnXm+oD=c)WC
zvgnuI1qgKsX1iIW(4Ak)#`a7QGI;6fS`+FL+g|x!+44+;pji<QL)VZGPQ2o?;=1ty
z$CtBKZ!LTDIUxR=)tTQ|Km-x)9!NPq-_IhcrGB4yjl^umtW>Ey?QCRzRhxNxbp_0y
z@h>w*xGLzRmdN~iV2{OmRof{H)(}Z3D(@Pz0x^O`NA{bTZtfM}{{Tl=%Or!6Po-kC
zY-I_xiP92(vZg8y(l(!5bjRo0-j;n*NF#*}gp!wxF$lN-^T$tb)Kn1a`o+WxAkx6x
zGBQm<b**3RCJ*eP<^<n@Pd_#|?doe)4<+}C<o^KMvc%}Aq|Bj+3<8|w;{;%19P>__
zQ)_g#owVZVEG3;%GFcB89X-$GR}yR4Y-VPI%D7%sbq$Vj`1GnRcdW#Gudu5&RC%Ge
z<YbUNj}($mr{Xg8oa=YyH`tmDt-)o+?|RQoW-mC#x?IGm{^!0uKN`1reW*oqvKucp
z5CJYb@zSZqf2|q+0OS?|FkY?qPdWaSDE0kBS+Uig^6TvX0AXmN5j!?i;~=gFOm}a}
ztBqbMl%r_!o!nz+=Qthyzokqs^@4Hzn!KOAyN|t(<;_oXeSZw-u~?Z<s4PL~Pf_?$
zYdyaal4%kvSSBrvxdeiQV+NV3Uq@)UlFmtn-0xHb0iK^)w`U~sS|eP=vRn<rIjsFx
zQ@FLcTYGy?IJ9N(3C{<mLRXmj9CwKB5u;1ktXN1$LLGSn8;2i{=bG~06U-&JLa57v
zLEJjmt!lTov&80WA14S%1ozJa@fGBrCz4q%A~Hqgo_Nk{cy3`^;bux6J?Y1qVsxix
z2Ddo|kxV^l$LUS)(tr+~>Eo?8y)HS;06LU%dUHqt#W_bOnnMztr-}|weknlpp@JlZ
zPkxovczXLz(*c_5GbE&ZpbX-<GUppXz^ib~B9DQV^);NMaktRxbx#mSagCfQ?de$K
zSC%5{6P!0{#c5fazr99fAmWmM7uniYEKfb?8`VitKs|73icVLP&0B(XWgzfzRMm$Y
zJqHXjl1((l+;jA(o^TuGr$s;axfHC*O>9bGVmcgDFB_>m9CpQQS}M!}@r-&^i8S@b
z1!vD@ZR~EYj&#b{!5JR)5ml3w>*-pTHaG{5p%s+q(Ka#o)y1c=gz31EGLh>^jw$R*
zFVdp~el@Bf3CZa}Z<nPeIqOT>fDmIm*7t+#R{sFSnrsX=A)GT0VbAoe5%P}p+<Y>%
zX|?&TcH}_|9Q&FWC8^i^OYsr4v=%VG&fFXt@uvBhl1@)G(Ri-zOYLH9$D<Gjpssz8
zt8-HjSCevMM<SJCE^$ByJawzqvE&@}BZ?&}BH<oqVyU-boE+d(J9({R8Oaq{t-;-n
zpwd${ogT$7J+n)War)DmHeBbLj~S~lYQaG3NrRjUTysEx_oO(*2bxa&&;pU~Mg~1;
zJ7SjutpFV<Lig!O)|3OB8UQxn^`MGQaY_L_C;=&XEk-hEzyxzZ7T}q|^)+Ta_+})6
zeX8D-ro#GkmvcGuIz)rMDr=yy+p4kwA?F^STFOsd44c<OG1TlVdsSc#GoC7WSg^w!
z4^LWa#kmI6Ab&a$NMgy+M}GBk7$YAto_o~<w_?LRD_Y*$<QZ?kQ)a0aZC&mDecgXE
zTiRlMwYJK6Z(eI23s#izTe@AK6Jv40@<^<t(X2@|O(q+3R*06A4o9U!q}>QyG=y#)
z*mU|<w2?;KJLO5vNv=;+^IG^t0APgSed;&RtJw677gR~5!8lRd)cV(2l0_tcDHY~=
zJ%!b$mSvY>o=6?5w6wce!p0YmQ_V)q**l|FQUT+oMgpH|uW@to`Wk9WgvL!P7PcpR
zcj-k|l1>38iV8=cd^%9t)$m{l@_YXPyera7QI_B3uHd-NIme|GRaN-e!I%F4yTp1D
z0^*KxIXveyQB56eGq57A0QRXv5srG%MOq|~y8@sw6z?(1;GB$RiYcHRuGz+FWhZX#
z^ifnH;j)C_W}$XDBRCXMNez*>z!)Zkk(BUgqJSJp^KrQK%}CDPT65PqqKZH<i32(9
zNse>giYbUd>|X@;r7prpT<|EOki~>=+(|uZU%FcqQAv#)MyIb`KrV&6cJR6^`(;S}
zVYFm*$okb^?OASZ)9o-@&c;*)-8nxo<lv7=D5ka%t~GhB^h<lFp@CXy9a%yhyaw%`
z_C;3GHHkG1T-r@*Xd~FiD<3=@4)jq#8G3fRaJKDo*7nbEtu#JkA<0z19S%J|Ay2XK
zW$d=^Gh11QR(uf=9R_`U=%Ro&7g(0#L%6?^+Stt<(S&@51$g)C%}}4j6GLnyTPrQw
zOLGzG0QdKzijjysNp>w2UK?o_YPKB?IbuC)OT(Jf*Y~Lt+uKGO2_z;YAmmB6*V2k8
zV07p<@5iN8XyaqKqK%2}P*Ful#W2I=a};DRAZ-{Ff*6@jVUPa!6j4G3Ll&E4F66rw
z(fRUl&$q5W{X_Dr5J3o6A}GN;94MlSLn~Zq)|XyW&2Jl+2{Gk<?t1?KAy!ftyr8~R
zc+dAo6j4oy4M?Lyghfz#?HH>=h|jR1icDx~vEElaVx$TNd;MslkkRFi<ZBw1Kj-PH
z)W8%fc?4jCMHRJAh=f&-O0c(&5n4ikko+L~!=a{sX4s)sTS!2_U${C0kUu_XqNE7r
z(`;1C%Vz*AcQFV#Bb?N;*;`zQo_HgXlkS&LarB~!XaOy4;FdOu2+@EzD!4rIX`k8F
zO}w?FB))fL2RS^^MIbDx+DeW90~IcuN%1zF&v*X-&}gEnKjs}zM90aV^}uUBCDgRZ
zX1R)0a4sZ-MIz+_t})XGKaCVtF)l@|Tg2D47STLWz)Rb#q%xkQkA9riMBXUWQr6y8
zG45$po)05xoOS8V6jQM`Hgx@d^7-y!aT)}+5-C7)l0C_)+9tVub$@#t@`qS0BXk5~
z<|+v%^P-BIZabA9#yXGLOukjN;1uI)W0U^%R=M$}ryOWfJ7Jj+ACUAag!lgdXwgM0
zA>Egv@g?=`o}?SgjiI$^5#t09aqdl2{{V!)QN+Kywmw+n<!*Tco@k=8X%%tWKZ<Yl
z4S8&)jsX(}B%+Xb1p50|VGlA7trS*Gd&sVg)%2xOPH3X6%*wm){f*qFR}w6R%QGY6
zc6%Rcn^MxC)NNAUSCwK?K3Lls$4t>hN!1z2xav~Z;t=>{;|}kzC=BN$^WL^CPx>rh
z?hoZf6opgxYt{aT9doYVLvby-%kq;T+;T|4d|>B}f~A9Azc+TUmr}Ax5NxkFDy07a
z=tuGtQCDM|sYk_nmCe26(MI4R#z+N6P%~8i9Ze+OE4nWE{{TmBFh9OW^rDK=9|<pW
z)5qSYZXnS`G*E<+z!Oabl5^UMDugZoAc5MPfCJz2qKZQls0@CT;GpJ;C=kg8KMGES
z3Mi%n(2~RwdegIlK%$C3FH@ZNrm^kmMHIkm5<AcdBRvfiPy_OKrWPTH&l#eM0FZJI
zwK2)vMHGN&JW>Wbu|*WXcR}?u@&Q0`%@k5#Dvk%eGEe~o0h%bJhBv1|dS-w!GJ9YO
zD60^Q(EC%+<S!q1b43)GA>ad=L(V<uqNHGcUY@w7$e?rAKD1Fl9H)o?+QS{I#e80W
z(xLjAD6Wb-m{#~%gq#X@y%bkj#xc9pWb;K70O8Il>N2K^C;-ptPEJXpia<Dh?0eJL
z?O>y&6jCTf%Q+<a)18Wt1r$*C0w!V!=8n9YD5fDm%_z?9r==870{;LJ{OMP*qKZQ{
zw8<OILGOy_*k&F5`cXx5PjkMG#YvTZ?l`Pl_)sYzawwvvFH~zZoi<|;!8IN-D5AR&
z<uSj-P6H@S6jKmpy>H=k5y#=}PUI*uvD!)WqKcMWH$49UQ)4EjJGL@h)eC?&kF69|
zXwiHFVi|QEt63ve#xgNQ6*UcL4V6HAj^dzE`^KV*j)y^3Z@ha|W73K%cx-W1_=wox
z@kyMvD59*$2V7H}VfvmZqM0MGFe$WAK*4#<FK@z%DFEge0*#|IQ9un8pm9YM0oLgc
zvcMv$jonT;s<&{V)Y=?;pr5Itio>alcQeYVyC8v%c&X$A?Mol<;)*JbqBWyaI;h|i
z+N}Yzfzpa7Wur>kXA87o4Az7ax>^#gg69T`D=8WyU__4!5;;6pV#KFb4bD{Y%@kCv
zhPO1W=aO53&U3V!4%}6^uO&;DAcM3MgGCi4kvbc74B?w3u*u1#jf+Xm6jC=H-!RFd
IiYWpA*}&V`%m4rY

literal 0
HcmV?d00001

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
new file mode 100644
index 000000000..a77b6373c
--- /dev/null
+++ b/backend/corpora/ublad/ublad.py
@@ -0,0 +1,207 @@
+from datetime import datetime
+import os
+from os.path import join, splitext
+
+
+from django.conf import settings
+from addcorpus.python_corpora.corpus import HTMLCorpusDefinition, FieldDefinition
+from addcorpus.python_corpora.extract import Metadata, XML, Pass, Order, Backup, Combined, FilterAttribute
+from addcorpus.es_mappings import *
+from addcorpus.python_corpora.filters import RangeFilter, MultipleChoiceFilter, BooleanFilter, DateFilter
+from addcorpus.es_settings import es_settings
+
+
+from ianalyzer_readers.readers.html import HTMLReader
+from ianalyzer_readers.readers.core import Field
+from ianalyzer_readers.extract import html, Constant
+
+import locale
+locale.setlocale(locale.LC_ALL, 'nl_NL.UTF-8')
+
+class UBlad(HTMLCorpusDefinition):
+    title = 'U-Blad'
+    description = 'The print editions of the Utrecht University paper from 1969 until 2010.'
+    description_page = 'ublad.md'
+    min_date = datetime(year=1969, month=1, day=1)
+    max_date = datetime(year=2010, month=12, day=31)
+
+    data_directory = settings.UBLAD_DATA
+    es_index = getattr(settings, 'UBLAD_ES_INDEX', 'ublad')
+    image = 'ublad.jpg'
+    citation_page = 'citation.md'
+    scan_image_type = getattr(settings, 'UBLAD_SCAN_IMAGE_TYPE', 'image/jpeg')
+    allow_image_download = getattr(settings, 'UBLAD_ALLOW_IMAGE_DOWNLOAD', True)
+
+    languages = ['nl']
+    category = 'periodical'
+
+    @property
+    def es_settings(self):
+        return es_settings(self.languages[:1], stopword_analysis=True, stemming_analysis=True)
+
+    def sources(self, start=min_date, end=max_date):
+        for directory, _, filenames in os.walk(self.data_directory):
+            for filename in filenames:
+                if filename != '.DS_Store':
+                    full_path = join(directory, filename)
+                    yield full_path, {'filename': filename}
+
+
+    fields = [
+        FieldDefinition(
+            name = 'content',
+            display_name='Content',
+            display_type='text_content',
+            results_overview=True,
+            csv_core=True,
+            search_field_core=True,
+            visualisations=['ngram', 'wordcloud'],
+            es_mapping = main_content_mapping(True, True, True, 'nl'),
+            extractor= FilterAttribute(tag='div', recursive=True, multiple=False, flatten=True, attribute_filter={
+                'attribute': 'class',
+                'value': 'ocr_page'
+            })
+        ),
+        FieldDefinition(
+            name='pagenum',
+            display_name='Page number',
+            description='Page number',
+            es_mapping = int_mapping(),
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'pagenum'
+                }
+            )
+        ),
+
+        FieldDefinition(
+            name='journal_title',
+            display_name='Publication Title',
+            description='Title of the publication',
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'journal_title'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='volume_id',
+            display_name='Volume ID',
+            description='Unique identifier for this volume',
+            hidden=True,
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'identifier_ocn'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='page_id',
+            display_name='Page ID',
+            description='Unique identifier for this page',
+            hidden=True,
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'identifier_indexid'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='edition',
+            display_name='Edition',
+            description='The number of the edition in this volume. Every year starts at 1.',
+            sortable=True,
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'aflevering'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='volume',
+            display_name='Volume',
+            sortable=True,
+            results_overview=True,
+            description='The volume number of this publication. There is one volume per year.',
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'yearstring'
+                }
+            ),
+        ),
+        FieldDefinition(
+            name='date',
+            display_name='Date',
+            description='The publication date of this edition',
+            es_mapping={'type': 'date', 'format': 'yyyy-MM-dd'},
+            visualizations=['resultscount', 'termfrequency'],
+            sortable=True,
+            results_overview=True,
+            search_filter=DateFilter(
+                min_date,
+                max_date,
+                description=(
+                    'Accept only articles with publication date in this range.'
+                )
+            ),
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'datestring',
+                },
+                transform=lambda x: datetime.strptime(
+                    x, '%d %B %Y').strftime('%Y-%m-%d')
+            )
+        ),
+        FieldDefinition(
+            name='repo_url',
+            display_name='Repository URL',
+            description='URL to the dSPACE repository entry of this volume',
+            es_mapping=keyword_mapping(),
+            searchable=False,
+            extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'link_repository'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='reader_url',
+            display_name='Reader URL',
+            description='URL to the UB reader view of this page',
+            es_mapping=keyword_mapping(),
+            searchable=False,
+            extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'link_objects_image'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='jpg_url',
+            display_name='Image URL',
+            description='URL to the jpg file of this page',
+            es_mapping=keyword_mapping(),
+            searchable=False,
+            extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'link_objects_jpg'
+                }
+            )
+        ),
+        FieldDefinition(
+            name='worldcat_url',
+            display_name='Worldcat URL',
+            description='URL to the Worldcat entry of this volume',
+            es_mapping=keyword_mapping(),
+            searchable=False,
+            extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'link_worldcat'
+                }
+            )
+        )
+    ]
+
+    def request_media(self, document, corpus_name):
+        image_list = [document['fieldValues']['jpg_url']]
+        return {'media': image_list}

From eac13699d5fccaefea39e836bbeb1a20cf53e619 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 19 Mar 2024 17:28:45 +0100
Subject: [PATCH 02/91] add document context

---
 backend/corpora/ublad/ublad.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index a77b6373c..20dd2e2c5 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -32,6 +32,13 @@ class UBlad(HTMLCorpusDefinition):
     scan_image_type = getattr(settings, 'UBLAD_SCAN_IMAGE_TYPE', 'image/jpeg')
     allow_image_download = getattr(settings, 'UBLAD_ALLOW_IMAGE_DOWNLOAD', True)
 
+    document_context = {
+        'context_fields': ['volume_id'],
+        'sort_field': 'sequence',
+        'sort_direction': 'asc',
+        'context_display_name': 'volume'
+    }
+
     languages = ['nl']
     category = 'periodical'
 

From 9b0fc2226b930ea05e41ed2419dce837b3c02688 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 28 Mar 2024 12:54:33 +0100
Subject: [PATCH 03/91] add Elasticsearch annotated-text plugin

---
 DockerfileElastic   | 3 +++
 docker-compose.yaml | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 DockerfileElastic

diff --git a/DockerfileElastic b/DockerfileElastic
new file mode 100644
index 000000000..2b908c5fb
--- /dev/null
+++ b/DockerfileElastic
@@ -0,0 +1,3 @@
+FROM docker.elastic.co/elasticsearch/elasticsearch:8.10.2
+
+RUN bin/elasticsearch-plugin install mapper-annotated-text
diff --git a/docker-compose.yaml b/docker-compose.yaml
index 9277df751..f3f4d63b3 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -52,7 +52,9 @@ services:
         target: /frontend/build
     command: sh -c "yarn prebuild && yarn start-docker"
   elasticsearch:
-    image: docker.elastic.co/elasticsearch/elasticsearch:8.10.2
+    build:
+      context: .
+      dockerfile: DockerfileElastic
     environment:
       - node.name=ianalyzer-node
       - discovery.type=single-node

From ffdfe30f584cf2a262439c51c8ca05d25d8d70d6 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 28 Mar 2024 12:54:51 +0100
Subject: [PATCH 04/91] extend FoundDocument with entities

---
 frontend/src/_utilities.scss                  |  5 +++
 .../document-view.component.html              |  1 +
 .../document-view/document-view.component.ts  |  2 +-
 .../document-preview.component.html           |  8 ++--
 .../document-preview.component.scss           |  3 ++
 frontend/src/app/document/document.module.ts  |  2 +
 .../entity-legend.component.html              |  3 ++
 .../entity-legend.component.scss              |  7 +++
 .../entity-legend.component.spec.ts           | 25 +++++++++++
 .../entity-legend/entity-legend.component.ts  | 21 +++++++++
 .../src/app/models/found-document.spec.ts     | 44 ++++++++++++++-----
 frontend/src/app/models/found-document.ts     | 21 +++++++--
 frontend/src/app/models/search-results.ts     |  5 +++
 .../src/app/services/download.service.spec.ts |  2 -
 .../app/services/elastic-search.service.ts    | 11 +++--
 frontend/src/app/services/entity.service.ts   | 18 ++++++++
 .../src/app/services/search.service.spec.ts   |  2 -
 frontend/src/mock-data/constructor-helpers.ts |  4 +-
 frontend/src/mock-data/elastic-search.ts      |  2 +-
 frontend/src/mock-data/search.ts              |  5 ++-
 frontend/src/styles.scss                      | 13 ++++++
 21 files changed, 175 insertions(+), 29 deletions(-)
 create mode 100644 frontend/src/app/document/entity-legend/entity-legend.component.html
 create mode 100644 frontend/src/app/document/entity-legend/entity-legend.component.scss
 create mode 100644 frontend/src/app/document/entity-legend/entity-legend.component.spec.ts
 create mode 100644 frontend/src/app/document/entity-legend/entity-legend.component.ts
 create mode 100644 frontend/src/app/services/entity.service.ts

diff --git a/frontend/src/_utilities.scss b/frontend/src/_utilities.scss
index 225735d40..15315baae 100644
--- a/frontend/src/_utilities.scss
+++ b/frontend/src/_utilities.scss
@@ -30,6 +30,11 @@ $section-padding:	3rem 1.5rem;
 $boxShadow: 0 2px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1);
 $boxShadowHover: 0px 5px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px $primary;
 
+$entity-person:  #88CCEE;
+$entity-location:#44AA99;
+$entity-organization: #DDCC77;
+$entity-miscellaneous: #AA4499;
+
 @import "~bulma/sass/utilities/_all";
 
 // based on the Bulma loader
diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index e3fa71a3d..dbfef7c9b 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -42,6 +42,7 @@
                         [attr.lang]="document.language(field)"
                         [innerHtml]="formatInnerHtml(field)">
                     </div>
+                    <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
                 </ng-template>
                 <ng-template iaTabPanel id="scan" *ngIf="showScanTab" title="Image" [icon]="documentIcons.scan">
                     <ia-image-view [corpus]="corpus" [document]="document"></ia-image-view>
diff --git a/frontend/src/app/document-view/document-view.component.ts b/frontend/src/app/document-view/document-view.component.ts
index 3452d4906..b13790d2f 100644
--- a/frontend/src/app/document-view/document-view.component.ts
+++ b/frontend/src/app/document-view/document-view.component.ts
@@ -4,7 +4,6 @@ import { CorpusField, FoundDocument, Corpus, QueryModel } from '../models/index'
 import { DocumentView } from '../models/document-page';
 import * as _ from 'lodash';
 import { documentIcons } from '../shared/icons';
-import { findByName } from '../utils/utils';
 
 @Component({
     selector: 'ia-document-view',
@@ -53,6 +52,7 @@ export class DocumentViewComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void {
         if (changes.view) {
             this.activeTab = this.tabFromView(this.view);
+            this.document.fetchEntities();
         }
     }
 
diff --git a/frontend/src/app/document/document-preview/document-preview.component.html b/frontend/src/app/document/document-preview/document-preview.component.html
index 87429833f..dba6cf8ad 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.html
+++ b/frontend/src/app/document/document-preview/document-preview.component.html
@@ -1,4 +1,7 @@
 <ng-container *ngIf="page && document">
+    <div class="heading" *ngIf="document.relevance">
+        Relevance: <ia-search-relevance [value]="document.relevance"></ia-search-relevance>
+    </div>
     <table class="table is-fullwidth">
         <ng-container *ngFor="let field of page.fields">
             <tr *ngIf="document.fieldValue(field)">
@@ -24,10 +27,9 @@
 
 
     <div class="columns is-vcentered">
-        <div class="column is-narrow heading" *ngIf="document.relevance">
-            Relevance: <ia-search-relevance [value]="document.relevance"></ia-search-relevance>
+        <div class="column" role="presentation">
+            <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
         </div>
-        <div class="column" role="presentation"></div>
         <div class="column field is-grouped is-narrow">
             <div class="control">
                 <button class="button is-primary" (click)="page.focus(document)">
diff --git a/frontend/src/app/document/document-preview/document-preview.component.scss b/frontend/src/app/document/document-preview/document-preview.component.scss
index 0dd32d051..341275f9d 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.scss
+++ b/frontend/src/app/document/document-preview/document-preview.component.scss
@@ -1,3 +1,6 @@
+.heading {
+    text-align: right
+}
 .table {
     td, th {
         border: none;
diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index 8674a5677..62f5ed5f9 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -9,6 +9,7 @@ import { TagModule } from '../tag/tag.module';
 import { DocumentPopupComponent } from './document-popup/document-popup.component';
 import { DialogModule } from 'primeng/dialog';
 import { DocumentPreviewComponent } from './document-preview/document-preview.component';
+import { EntityLegendComponent } from './entity-legend/entity-legend.component';
 
 
 
@@ -19,6 +20,7 @@ import { DocumentPreviewComponent } from './document-preview/document-preview.co
         SearchRelevanceComponent,
         DocumentPopupComponent,
         DocumentPreviewComponent,
+        EntityLegendComponent,
     ],
     imports: [
         DialogModule,
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.html b/frontend/src/app/document/entity-legend/entity-legend.component.html
new file mode 100644
index 000000000..8f6f72a62
--- /dev/null
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.html
@@ -0,0 +1,3 @@
+<div *ngFor="let entity of entities">
+    <span class="dot" [ngClass]="formatClass(entity)"></span><span>{{entity}}</span>
+</div>
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.scss b/frontend/src/app/document/entity-legend/entity-legend.component.scss
new file mode 100644
index 000000000..e269d7265
--- /dev/null
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.scss
@@ -0,0 +1,7 @@
+span.dot {
+    height: .7rem;
+    width: .7rem;
+    margin-right: .4rem;
+    border-radius: 50%;
+    display: inline-block;
+}
\ No newline at end of file
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.spec.ts b/frontend/src/app/document/entity-legend/entity-legend.component.spec.ts
new file mode 100644
index 000000000..69c35776e
--- /dev/null
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.spec.ts
@@ -0,0 +1,25 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { EntityLegendComponent } from './entity-legend.component';
+
+describe('EntitiesComponent', () => {
+  let component: EntityLegendComponent;
+  let fixture: ComponentFixture<EntityLegendComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [ EntityLegendComponent ]
+    })
+    .compileComponents();
+  });
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(EntityLegendComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.ts b/frontend/src/app/document/entity-legend/entity-legend.component.ts
new file mode 100644
index 000000000..da297a25a
--- /dev/null
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.ts
@@ -0,0 +1,21 @@
+import { Component, Input, OnInit } from '@angular/core';
+
+@Component({
+  selector: 'ia-entity-legend',
+  templateUrl: './entity-legend.component.html',
+  styleUrls: ['./entity-legend.component.scss']
+})
+export class EntityLegendComponent implements OnInit {
+
+  @Input() entities: string[];
+
+  constructor() { }
+
+  ngOnInit(): void {
+  }
+
+  formatClass(entityName: string): string {
+    return `entity-${entityName.toLowerCase().slice(0,3)}`;
+  }
+
+}
diff --git a/frontend/src/app/models/found-document.spec.ts b/frontend/src/app/models/found-document.spec.ts
index fa8452f6c..5c467de18 100644
--- a/frontend/src/app/models/found-document.spec.ts
+++ b/frontend/src/app/models/found-document.spec.ts
@@ -1,13 +1,15 @@
-import { TestBed, waitForAsync } from '@angular/core/testing';
+import { TestBed, fakeAsync, waitForAsync } from '@angular/core/testing';
+import * as _ from 'lodash';
+import { reduce, take } from 'rxjs/operators';
+import { Observable } from 'rxjs';
 import { makeDocument } from '../../mock-data/constructor-helpers';
 import { mockCorpus, mockCorpus3 } from '../../mock-data/corpus';
 import { FoundDocument } from './found-document';
 import { TagService } from '../services/tag.service';
 import { TagServiceMock, mockTags } from '../../mock-data/tag';
-import * as _ from 'lodash';
-import { reduce, take } from 'rxjs/operators';
-import { Observable } from 'rxjs';
 import { Tag } from './tag';
+import { ElasticSearchService } from '../services';
+import { ElasticSearchServiceMock } from '../../mock-data/elastic-search';
 
 const maxScore = 2.9113607;
 const mockResponse = {
@@ -32,20 +34,21 @@ const mockResponse = {
     }
 };
 
-describe('FoundDocument', () => {
-    let tagService: TagService;
+fdescribe('FoundDocument', () => {
+    const mockTagService = new TagServiceMock() as any;
+    const mockElasticService = new ElasticSearchServiceMock() as any;
 
     beforeEach(() => {
         TestBed.configureTestingModule({
             providers: [
-                { provide: TagService, useValue: new TagServiceMock() }
+                { provide: TagService, useClass: TagServiceMock },
+                { provide: ElasticSearchService, useClass: ElasticSearchServiceMock }
             ]
         });
-        tagService = TestBed.inject(TagService);
     });
 
-    it('should construct from an elasticsearch response', () => {
-        const document = new FoundDocument(tagService, mockCorpus, mockResponse, maxScore);
+    fit('should construct from an elasticsearch response', () => {
+        const document = new FoundDocument(mockTagService, mockElasticService, mockCorpus, mockResponse, maxScore);
 
         expect(document.id).toBe('1994_troonrede');
         expect(document.fieldValues['monarch']).toBe('Beatrix');
@@ -90,4 +93,25 @@ describe('FoundDocument', () => {
             ]);
         });
     }));
+
+    it('should fetch and display named entities', fakeAsync(() => {
+        const searchResponse = {
+            _index: 'test_index',
+            _id: 'my_identifier',
+            _score: 2.9113607,
+            _source: {
+                date: '1994-09-20',
+                id: 'my_identifier',
+                content: 'Wally was last seen in Paris.'
+            },
+            highlight: {
+                content: [
+                    '<em>seen</em>'
+                ]
+            }
+        };
+        const document = new FoundDocument(mockTagService, mockElasticService, mockCorpus, searchResponse, maxScore);
+        expect(document.fieldValues['content']).toEqual(
+            '<mark class="entity-per">Wally</mark> was last seen in <mark class="entity-loc">Paris</mark>');
+    }));
 });
diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index dc2d47fe9..48fe1b03e 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -4,8 +4,9 @@ import { Corpus, CorpusField } from './corpus';
 import { FieldValues, HighlightResult, SearchHit } from './elasticsearch';
 import { Tag } from './tag';
 import { Observable, Subject, merge, timer } from 'rxjs';
+import { EntityService } from '../services/entity.service';
 import { TagService } from '../services/tag.service';
-import { map, mergeMap, shareReplay, take, tap } from 'rxjs/operators';
+import { map, mergeMap, shareReplay, take } from 'rxjs/operators';
 
 export class FoundDocument {
     id: string;
@@ -27,13 +28,16 @@ export class FoundDocument {
     /** tags created on the document */
     tags$: Observable<Tag[]>;
 
+    /** named entities associated with the document */
+    entities: string[];
     private tagsChanged$ = new Subject<void>();
 
     constructor(
         private tagService: TagService,
+        private entityService: EntityService,
         public corpus: Corpus,
         hit: SearchHit,
-        maxScore: number = 1
+        maxScore: number = 1,
     ) {
         this.id = hit._id;
         this.relevance = hit._score / maxScore;
@@ -42,8 +46,10 @@ export class FoundDocument {
 
         const created$ = timer(); // observable of the moment of construction (i.e. now)
 
-        // tags need to refreshed when the document is created, and
+        // tags need to be refreshed when the document is created, and
         // after each update
+        // shareReplay shares the value over all observers:
+        // add/removeTag, async pipe in document-tags.component template
         this.tags$ = merge(created$, this.tagsChanged$).pipe(
             mergeMap(() => this.fetchTags()),
             shareReplay(1),
@@ -112,6 +118,14 @@ export class FoundDocument {
         );
     }
 
+
+    fetchEntities(): Promise<void> {
+        return this.entityService.getDocumentEntities(this.corpus, this.id).then((result) => {
+            this.entities = result.entities;
+            result.annotations.map((annotation)=> _.set(this.fieldValues, _.keys(annotation)[0], _.values(annotation)[0]));
+        });
+    }
+
     private setTags(tags: Tag[]): Observable<Tag[]> {
         return this.tagService.setDocumentTags(this, tags);
     }
@@ -119,4 +133,5 @@ export class FoundDocument {
     private fetchTags(): Observable<Tag[]> {
         return this.tagService.getDocumentTags(this);
     }
+
 }
diff --git a/frontend/src/app/models/search-results.ts b/frontend/src/app/models/search-results.ts
index a2b391dc2..b7e3f76c6 100644
--- a/frontend/src/app/models/search-results.ts
+++ b/frontend/src/app/models/search-results.ts
@@ -91,6 +91,11 @@ export interface QueryFeedback {
     similarTerms?: string[];
 }
 
+export interface NamedEntitiesResult {
+    entities: string[];
+    annotations: {[fieldName: string]: string}[];
+}
+
 export interface TaskResult { task_ids: string[] };
 
 export interface TaskSuccess {
diff --git a/frontend/src/app/services/download.service.spec.ts b/frontend/src/app/services/download.service.spec.ts
index add89bc77..308c65640 100644
--- a/frontend/src/app/services/download.service.spec.ts
+++ b/frontend/src/app/services/download.service.spec.ts
@@ -3,8 +3,6 @@ import { TestBed, inject } from '@angular/core/testing';
 import { ApiService } from './api.service';
 import { ApiServiceMock } from '../../mock-data/api';
 import { DownloadService } from './download.service';
-import { ElasticSearchService } from './elastic-search.service';
-import { ElasticSearchServiceMock } from '../../mock-data/elastic-search';
 import { mockCorpus, mockField } from '../../mock-data/corpus';
 import { DownloadOptions, LimitedResultsDownloadParameters, QueryModel, SortState } from '../models';
 
diff --git a/frontend/src/app/services/elastic-search.service.ts b/frontend/src/app/services/elastic-search.service.ts
index f3d16dba6..d86d3e7b2 100644
--- a/frontend/src/app/services/elastic-search.service.ts
+++ b/frontend/src/app/services/elastic-search.service.ts
@@ -1,22 +1,23 @@
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable @typescript-eslint/member-ordering */
 import { Injectable } from '@angular/core';
-import { HttpClient, HttpParams } from '@angular/common/http';
+import { HttpClient } from '@angular/common/http';
 import {
     FoundDocument, Corpus, QueryModel, SearchResults,
-    AggregateQueryFeedback, SearchHit, EsQuery, Aggregator
+    AggregateQueryFeedback, SearchHit, Aggregator
 } from '../models/index';
 import * as _ from 'lodash';
 import { TagService } from './tag.service';
 import { APIQuery } from '../models/search-requests';
 import { PageResultsParameters } from '../models/page-results';
 import { resultsParamsToAPIQuery } from '../utils/es-query';
+import { EntityService } from './entity.service';
 
 
 @Injectable()
 export class ElasticSearchService {
 
-    constructor(private http: HttpClient, private tagService: TagService) {
+    constructor(private http: HttpClient, private entityService: EntityService, private tagService: TagService) {
     }
 
     getDocumentById(id: string, corpus: Corpus): Promise<FoundDocument> {
@@ -98,6 +99,8 @@ export class ElasticSearchService {
         return this.parseResponse(queryModel.corpus, response);
     }
 
+
+
     /**
      * Execute an ElasticSearch query and return a dictionary containing the results.
      */
@@ -145,7 +148,7 @@ export class ElasticSearchService {
      * return the id, relevance and field values of a given document
      */
     private hitToDocument(corpus: Corpus, hit: SearchHit, maxScore: number): FoundDocument {
-        return new FoundDocument(this.tagService, corpus, hit, maxScore);
+        return new FoundDocument(this.tagService, this.entityService, corpus, hit, maxScore);
     }
 
 }
diff --git a/frontend/src/app/services/entity.service.ts b/frontend/src/app/services/entity.service.ts
new file mode 100644
index 000000000..7e63d71f2
--- /dev/null
+++ b/frontend/src/app/services/entity.service.ts
@@ -0,0 +1,18 @@
+import { HttpClient } from '@angular/common/http';
+import { Corpus, NamedEntitiesResult } from '../models';
+import { Injectable } from '@angular/core';
+import { Observable } from 'rxjs';
+
+@Injectable({
+    providedIn: 'root',
+})
+export class EntityService {
+
+    constructor(private http: HttpClient) {
+    }
+
+    public async getDocumentEntities(corpus: Corpus, id: string): Promise<NamedEntitiesResult> {
+        const url = `/api/es/${corpus.name}/${id}/named_entities`;
+        return this.http.get<NamedEntitiesResult>(url).toPromise();
+    }
+}
diff --git a/frontend/src/app/services/search.service.spec.ts b/frontend/src/app/services/search.service.spec.ts
index 523c16112..1facbb5f3 100644
--- a/frontend/src/app/services/search.service.spec.ts
+++ b/frontend/src/app/services/search.service.spec.ts
@@ -9,8 +9,6 @@ import { ElasticSearchServiceMock } from '../../mock-data/elastic-search';
 import { QueryService } from './query.service';
 import { SearchService } from './search.service';
 import { SessionService } from './session.service';
-import { WordmodelsService } from './wordmodels.service';
-import { WordmodelsServiceMock } from '../../mock-data/wordmodels';
 import { HttpClientTestingModule } from '@angular/common/http/testing';
 import { QueryModel } from '../models';
 import { mockCorpus } from '../../mock-data/corpus';
diff --git a/frontend/src/mock-data/constructor-helpers.ts b/frontend/src/mock-data/constructor-helpers.ts
index 21c4a1aa1..24c17c218 100644
--- a/frontend/src/mock-data/constructor-helpers.ts
+++ b/frontend/src/mock-data/constructor-helpers.ts
@@ -3,8 +3,10 @@
 import { Corpus, FieldValues, FoundDocument, HighlightResult, SearchHit } from '../app/models';
 import { mockCorpus } from './corpus';
 import { TagServiceMock } from './tag';
+import { ElasticSearchServiceMock } from './elastic-search';
 
 const tagService = new TagServiceMock() as any;
+const elasticSearchService = new ElasticSearchServiceMock() as any;
 
 export const makeDocument = (
     fieldValues: FieldValues,
@@ -16,6 +18,6 @@ export const makeDocument = (
     const hit: SearchHit = {
         _id: id, _score: relevance, _source: fieldValues, highlight
     };
-    return new FoundDocument(tagService, corpus, hit);
+    return new FoundDocument(tagService, elasticSearchService, corpus, hit);
 };
 
diff --git a/frontend/src/mock-data/elastic-search.ts b/frontend/src/mock-data/elastic-search.ts
index c584514ad..d9a542f09 100644
--- a/frontend/src/mock-data/elastic-search.ts
+++ b/frontend/src/mock-data/elastic-search.ts
@@ -1,4 +1,4 @@
-import { FoundDocument, SearchResults } from '../app/models';
+import { FoundDocument, NamedEntitiesResult, SearchResults } from '../app/models';
 import { makeDocument } from './constructor-helpers';
 
 export class ElasticSearchServiceMock {
diff --git a/frontend/src/mock-data/search.ts b/frontend/src/mock-data/search.ts
index 86e51fd5a..80c3b7319 100644
--- a/frontend/src/mock-data/search.ts
+++ b/frontend/src/mock-data/search.ts
@@ -3,7 +3,7 @@ import { SearchFilter } from '../app/models/field-filter';
 import { AggregateQueryFeedback, Corpus, CorpusField, FoundDocument, QueryModel, SearchResults } from '../app/models/index';
 import { mockCorpus } from './corpus';
 import { TagServiceMock } from './tag';
-import { TagService } from '../app/services/tag.service';
+import { ElasticSearchServiceMock } from './elastic-search';
 
 export class SearchServiceMock {
     public async aggregateSearch(corpus: Corpus, queryModel: QueryModel, aggregator: [{name: string}]): Promise<AggregateQueryFeedback> {
@@ -42,7 +42,8 @@ export class SearchServiceMock {
 
     loadResults(queryModel: QueryModel, resultsParams: PageResultsParameters): Promise<SearchResults> {
         const doc = new FoundDocument(
-            new TagServiceMock() as unknown as TagService,
+            new TagServiceMock() as any,
+            new ElasticSearchServiceMock() as any,
             mockCorpus,
             {
                 _id: 'test_1',
diff --git a/frontend/src/styles.scss b/frontend/src/styles.scss
index 2ab42bb0a..6266c5633 100644
--- a/frontend/src/styles.scss
+++ b/frontend/src/styles.scss
@@ -71,3 +71,16 @@ a.dropdown-item[disabled] {
         color: $grey;
     }
 }
+
+.entity-per {
+    background-color: $entity-person;
+}
+.entity-loc {
+    background-color: $entity-location;
+}
+.entity-org {
+    background-color: $entity-organization;
+}
+.entity-mis {
+    background-color: $entity-miscellaneous;
+}

From feef6f4042640e5970bbc5173edf18218de3bc7d Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Fri, 5 Apr 2024 11:01:12 +0200
Subject: [PATCH 05/91] add backend view

---
 backend/addcorpus/models.py                  |  6 +-
 backend/addcorpus/validation/creation.py     |  7 ++
 backend/es/conftest.py                       | 26 ++++++
 backend/es/tests/test_named_entity_search.py | 51 +++++++++++
 backend/es/urls.py                           |  4 +-
 backend/es/views.py                          | 93 ++++++++++++++++++--
 6 files changed, 179 insertions(+), 8 deletions(-)
 create mode 100644 backend/es/tests/test_named_entity_search.py

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index f5db4341c..e4036b668 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -9,7 +9,8 @@
 from addcorpus.validation.creation import validate_language_code, \
     validate_image_filename_extension, validate_markdown_filename_extension, \
     validate_es_mapping, validate_mimetype, validate_search_filter, \
-    validate_name_is_not_a_route_parameter, validate_search_filter_with_mapping, \
+    validate_name_is_not_a_route_parameter, validate_name_has_no_ner_suffix, \
+    validate_search_filter_with_mapping, \
     validate_searchable_field_has_full_text_search, \
     validate_visualizations_with_mapping, validate_implication, \
     validate_sort_configuration, validate_field_language
@@ -268,7 +269,8 @@ def clean(self):
 class Field(models.Model):
     name = models.SlugField(
         max_length=MAX_LENGTH_NAME,
-        validators=[validate_name_is_not_a_route_parameter],
+        validators=[validate_name_is_not_a_route_parameter,
+                    validate_name_has_no_ner_suffix],
         help_text='internal name for the field',
     )
     corpus_configuration = models.ForeignKey(
diff --git a/backend/addcorpus/validation/creation.py b/backend/addcorpus/validation/creation.py
index aa1a95d74..702042a83 100644
--- a/backend/addcorpus/validation/creation.py
+++ b/backend/addcorpus/validation/creation.py
@@ -113,6 +113,13 @@ def validate_name_is_not_a_route_parameter(value):
             f'{value} cannot be used as a field name, because it is also a route parameter'
         )
 
+
+def validate_name_has_no_ner_suffix(value):
+    if value.endswith('_ner'):
+        raise ValidationError(
+            f'{value} cannot be used as a field name: the suffix `_ner` is reserved for annotated_text fields'
+        )
+
 def mapping_can_be_searched(es_mapping):
     '''
     Verify if a mapping is appropriate for searching
diff --git a/backend/es/conftest.py b/backend/es/conftest.py
index c2a3056e6..9ee8faca9 100644
--- a/backend/es/conftest.py
+++ b/backend/es/conftest.py
@@ -40,6 +40,32 @@ def es_forward_client(es_client, mock_corpus):
     es_client.indices.delete(index='times-test')
 
 
+@pytest.fixture(scope='module')
+def es_ner_search_client(es_client, mock_corpus):
+    """
+    Create and populate an index for the mock corpus in elasticsearch.
+    Returns an elastic search client for the mock corpus.
+    """
+
+    # add data from mock corpus
+    corpus = load_corpus_definition(mock_corpus)
+    es_index.create(es_client, corpus, False, True, False)
+    es_index.populate(es_client, mock_corpus, corpus)
+    es_client.indices.put_mapping(index=corpus.es_index, properties={
+                                  "content_ner": {"type": "annotated_text"}})
+
+    es_client.index(index=corpus.es_index, document={
+        'id': 'my_identifier',
+        'content': 'Guybrush Threepwood is looking for treasure on Monkey Island',
+        'content_ner': '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'})
+
+    # ES is "near real time", so give it a second before we start searching the index
+    sleep(1)
+    yield es_client
+    # delete index when done
+    es_client.indices.delete(index='times-test')
+
+
 @pytest.fixture()
 def basic_corpus_index(es_client, basic_corpus):
     corpus = load_corpus_definition(basic_corpus)
diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
new file mode 100644
index 000000000..c86b2ee85
--- /dev/null
+++ b/backend/es/tests/test_named_entity_search.py
@@ -0,0 +1,51 @@
+from es.views import NamedEntitySearchView
+
+
+def test_ner_search_view(es_ner_search_client, client, times_user):
+    client.force_login(times_user)
+    route = '/api/es/times/named_entities'
+    data = {'id': 'my_identifier'}
+    response = client.post(route, data, content_type='application/json')
+    assert response.status_code == 200
+
+
+def test_construct_ner_query():
+    viewset = NamedEntitySearchView()
+    fields = ['content_ner']
+    query = viewset.construct_named_entity_query(fields, 'my_identifier')
+    expected = {
+        "bool": {
+            "must": [
+                {
+                    "term": {
+                        "id": "my_identifier"
+                    }
+                },
+                {
+                    "terms": {
+                        "content_ner": ["LOC", "PER", "ORG", "MISC"]
+                    }
+                }
+            ]
+        }
+    }
+    assert query == expected
+
+
+def test_find_named_entity_fields(es_ner_search_client):
+    viewset = NamedEntitySearchView()
+    fields = viewset.find_named_entity_fields(
+        es_ner_search_client, 'times-test')
+    assert len(fields) == 1
+    assert fields[0] == 'content_ner'
+
+
+def test_find_entities():
+    viewset = NamedEntitySearchView()
+    text = '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'
+    entity_classes = set()
+    output = viewset.find_entities(text, entity_classes)
+    expected = '<mark class="entity-per">Guybrush Threepwood</mark> is looking for treasure on <mark class="entity-loc">Monkey Island</mark>'
+    assert output == expected
+    assert len(list(entity_classes)) == 2
+    assert all(entity in list(entity_classes) for entity in ['PER', 'LOC'])
diff --git a/backend/es/urls.py b/backend/es/urls.py
index 62c389eae..f7ab60884 100644
--- a/backend/es/urls.py
+++ b/backend/es/urls.py
@@ -1,6 +1,8 @@
 from django.urls import path
-from es.views import *
+from es.views import ForwardSearchView, NamedEntitySearchView
 
 urlpatterns = [
     path('<str:corpus>/_search', ForwardSearchView.as_view()),
+    path('<str:corpus>/<str:id>/named_entities',
+         NamedEntitySearchView.as_view())
 ]
diff --git a/backend/es/views.py b/backend/es/views.py
index ab7cadc2e..c3734629b 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -1,17 +1,19 @@
+import logging
+import re
+
 from django.utils import timezone
 from rest_framework.views import APIView
 from rest_framework.response import Response
-from ianalyzer.elasticsearch import elasticsearch
-from es.search import get_index, total_hits, hits
-import logging
-from rest_framework.permissions import IsAuthenticated
 from rest_framework.exceptions import APIException
+
 from addcorpus.permissions import CorpusAccessPermission
-from tag.permissions import CanSearchTags
 from api.save_query import should_save_query
 from addcorpus.models import Corpus
 from api.models import Query
 from api.api_query import api_query_to_es_query
+from es.search import get_index, total_hits, hits
+from ianalyzer.elasticsearch import elasticsearch
+from tag.permissions import CanSearchTags
 
 logger = logging.getLogger(__name__)
 
@@ -98,3 +100,84 @@ def _save_query_done(self, query, results):
         query.total_results = total_hits(results)
         query.transferred = len(hits(results))
         query.save()
+
+
+class NamedEntitySearchView(APIView):
+    ''' Construct a terms query for named entities, combined with a term query of the id
+        Perform search via Elasticsearch and reformat the output
+    '''
+    entity_dict = {
+        'PER': 'Person',
+        'LOC': 'Location',
+        'ORG': 'Organization',
+        'MISC': 'Miscellaneous'
+    }
+
+    permission_classes = [CorpusAccessPermission]
+
+    def get(self, request, *args, **kwargs):
+        corpus_name = kwargs.get('corpus')
+        document_id = kwargs.get('id')
+        client = elasticsearch(corpus_name)
+        index = get_index(corpus_name)
+        fields = self.find_named_entity_fields(client, index)
+        query = self.construct_named_entity_query(fields, document_id)
+        response = client.search(index=index, query=query, fields=fields)
+        results = hits(response)
+        annotations = {}
+        entity_classes = set()
+        response = {}
+        if len(results):
+            source = results[0]['_source']
+            for field in fields:
+                text_with_entities = source.get(field)
+                annotations.update({field.replace('_ner', ''): self.find_entities(
+                    text_with_entities, entity_classes)})
+            entities = [self.entity_dict.get(entity_class)
+                        for entity_class in list(entity_classes)]
+            response = {'annotations': annotations, 'entities': entities}
+        return Response(response)
+
+    def find_named_entity_fields(self, client, index: str) -> list[str]:
+        mapping = client.indices.get_mapping(index=index)
+        fields = mapping[index]['mappings']['properties']
+        field_names = fields.keys()
+        return [name for name in field_names if name.endswith('_ner') and fields[name].get('type') == 'annotated_text']
+
+    def construct_named_entity_query(self, fields: list[str], document_id: str) -> dict:
+        return {
+            "bool": {
+                "must": [
+                    {
+                        "term": {
+                            "id": document_id
+                        }
+                    }, *self.add_terms(fields)
+                ]
+            }
+        }
+
+    def add_terms(self, fields: list[str]) -> list[dict]:
+        return [
+            {
+                "terms": {
+                    field: ["LOC", "PER", "ORG", "MISC"]
+                }
+            } for field in fields
+        ]
+
+    def find_entities(self, input_text: str, entity_classes: set) -> str:
+        # regex pattern to match annotations of format "[Wally](Person)" and split it into two groups
+        pattern = re.compile('(\[[a-zA-Z ]+\])(\([a-zA-Z ]+\))')
+        annotations = list(set(pattern.findall(input_text)))
+        for annotation in annotations:
+            input_text = self.substitute_annotation_with_tag(
+                annotation, input_text, entity_classes)
+        return input_text
+
+    def substitute_annotation_with_tag(self, annotation: tuple, input_text: str, entity_classes: set) -> str:
+        entity_class = annotation[1][1:-1]
+        annotated = annotation[0][1:-1]
+        entity_classes.update({entity_class})
+        return input_text.replace(
+            ''.join(annotation), f'<mark class="entity-{entity_class.lower()}">{annotated}</mark>')

From e4d4df06c4e4411d1c8d0f93ac8712329a156c5f Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 9 Apr 2024 17:48:19 +0200
Subject: [PATCH 06/91] add year variable to ublad

---
 backend/corpora/ublad/ublad.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 20dd2e2c5..1758d3ab3 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -59,6 +59,7 @@ def sources(self, start=min_date, end=max_date):
             name = 'content',
             display_name='Content',
             display_type='text_content',
+            description='Text content of the page, generated by OCR',
             results_overview=True,
             csv_core=True,
             search_field_core=True,
@@ -159,6 +160,20 @@ def sources(self, start=min_date, end=max_date):
                     x, '%d %B %Y').strftime('%Y-%m-%d')
             )
         ),
+        FieldDefinition(
+            name='year',
+            display_name='Year',
+            description='The publication year of this volume',
+            es_mapping=keyword_mapping(),
+            visualizations=['resultscount', 'termfrequency'],
+            visualization_sort='key',
+            search_filter=MultipleChoiceFilter(),
+            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
+                'attribute': 'name',
+                'value': 'year',
+                }
+            )
+        ),
         FieldDefinition(
             name='repo_url',
             display_name='Repository URL',

From 6c5e0230a2a6413147f0e7ac3eebf3bd395d6269 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 9 Apr 2024 18:01:18 +0200
Subject: [PATCH 07/91] add ublad description

---
 backend/corpora/ublad/description/ublad.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/backend/corpora/ublad/description/ublad.md b/backend/corpora/ublad/description/ublad.md
index e69de29bb..286e1d787 100644
--- a/backend/corpora/ublad/description/ublad.md
+++ b/backend/corpora/ublad/description/ublad.md
@@ -0,0 +1,7 @@
+Op 5 september 1969 kreeg de Universiteit Utrecht voor het eerst een onafhankelijk blad: _U utrechtse universitaire reflexen_. Dit blad kwam voort uit een fusie van twee andere tijdschriften: _Sol Iustitiae_ dat voornamelijk gericht was op studenten en _Solaire Reflexen_ dat meer was bedoeld voor medewerkers. U utrechtse universitaire reflexen was bedoeld voor alle geledingen.
+
+In 1974 veranderde de naam in het _Ublad_. Dat bleef zo tot de universiteit besloot het papieren Ublad digitaal te maken. Onder luid protest verdween het papieren Ublad en ontstond in april 2010 _DUB_, het digitale universiteitsblad.
+
+Om alle informatie uit het verleden toegankelijk te maken, hebben we samen met de Universiteitsbibliotheek de oude jaargangen gescand. In I-analyzer kunt u alle jaargangen van U utrechtse universitaire reflexen en het Ublad vinden en doorzoeken.
+
+Het onafhankelijke Ublad geeft een kleurrijk verslag van wat er speelde op de universiteit, de stad en het studentenleven door middel van atikelen, foto’s en cartoons. De afbeelding die is gebruikt voor OCR is voor elke pagina bijgevoegd zodat u altijd het originele bronmateriaal kan raadplegen.

From 2b7f0cef1561bfaed5a34291de4a274615b79760 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Fri, 12 Apr 2024 14:37:50 +0200
Subject: [PATCH 08/91] fix merge problem

---
 backend/addcorpus/models.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index f1c9349de..5e8501dba 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -10,8 +10,8 @@
 from addcorpus.validation.creation import (
     validate_language_code,
     validate_es_mapping, validate_mimetype, validate_search_filter,
-    validate_name_is_not_a_route_parameter, validate_search_filter_with_mapping,
-    validate_searchable_field_has_full_text_search,
+    validate_name_is_not_a_route_parameter, validate_name_has_no_ner_suffix,
+    validate_search_filter_with_mapping, validate_searchable_field_has_full_text_search,
     validate_visualizations_with_mapping, validate_implication,
     validate_sort_configuration, validate_field_language,
 )

From b472e38dd068e2a12a5de6d717b25a313842bcf7 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 18 Apr 2024 10:12:04 +0200
Subject: [PATCH 09/91] refactor: apply and reorganize pipes for string
 formatting

---
 .../document-view.component.html              |   8 +-
 .../document-view/document-view.component.ts  |  58 ---------
 .../document-preview.component.html           |   2 +-
 frontend/src/app/document/document.module.ts  |   6 +-
 .../manual/manual-navigation.component.html   |   2 +-
 frontend/src/app/manual/manual.module.ts      |   3 +-
 .../app/pipes/elasticsearch-highlight.pipe.ts |  51 ++++++++
 frontend/src/app/pipes/geo-data.pipe.ts       |  25 ++++
 frontend/src/app/pipes/index.ts               |   4 +
 .../regex-highlight.pipe.ts}                  |  12 +-
 frontend/src/app/pipes/snippet.pipe.ts        |  20 ++++
 frontend/src/app/search/index.ts              |   1 -
 .../src/app/services/highlight.service.ts     | 111 +-----------------
 frontend/src/app/shared/shared.module.ts      |   3 -
 14 files changed, 118 insertions(+), 188 deletions(-)
 create mode 100644 frontend/src/app/pipes/elasticsearch-highlight.pipe.ts
 create mode 100644 frontend/src/app/pipes/geo-data.pipe.ts
 create mode 100644 frontend/src/app/pipes/index.ts
 rename frontend/src/app/{search/highlight.pipe.ts => pipes/regex-highlight.pipe.ts} (72%)
 create mode 100644 frontend/src/app/pipes/snippet.pipe.ts

diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index e34e776b1..2a2c6a306 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -9,7 +9,7 @@
                             <ia-search-relevance [value]="document.relevance"></ia-search-relevance>
                         </td>
                     </tr>
-                    <tr *ngIf="(document?.tags$ | async) as tags">
+                    <tr *ngIf="(document.tags$ | async) as tags">
                         <th>Your tags</th>
                         <td>
                             <ia-document-tags [document]="document" [tags]="tags"></ia-document-tags>
@@ -21,9 +21,9 @@
                             <td *ngIf="!isUrlField(field) && !isGeoPointField(field)"
                                 data-test-field-value
                                 [attr.lang]="document.language(field)"
-                                [innerHtml]="formatInnerHtml(field)">
+                                [innerHtml]="field | elasticsearchHighlight:document">
                             </td>
-                            <td *ngIf="isGeoPointField(field)">{{displayGeoPointField(field)}}</td>
+                            <td *ngIf="isGeoPointField(field)">{{field | geoData:document}}</td>
                             <td *ngIf="isUrlField(field)">
                                 <a href={{document.fieldValue(field)}} target="_blank">{{document.fieldValue(field)}}</a>
                             </td>
@@ -40,7 +40,7 @@
                 <ng-template iaTabPanel *ngFor="let field of contentFields" [id]="field.name" [title]="field.displayName" [icon]="documentIcons.text">
                     <div class="content"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="formatInnerHtml(field)">
+                        [innerHtml]="field | elasticsearchHighlight:document">
                     </div>
                     <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
                 </ng-template>
diff --git a/frontend/src/app/document-view/document-view.component.ts b/frontend/src/app/document-view/document-view.component.ts
index b13790d2f..1f5171d79 100644
--- a/frontend/src/app/document-view/document-view.component.ts
+++ b/frontend/src/app/document-view/document-view.component.ts
@@ -76,62 +76,4 @@ export class DocumentViewComponent implements OnChanges {
         return field.mappingType === 'geo_point';
     }
 
-    displayGeoPointField(field: CorpusField) {
-        let latitude = this.document.fieldValue(field)[field.name][1];
-        let longitude = this.document.fieldValue(field)[field.name][0];
-        // Round to 2 decimal places
-        latitude = Math.round(latitude * 100) / 100;
-        longitude = Math.round(longitude * 100) / 100;
-        return `Lat: ${latitude}; Lon: ${longitude}`;
-    }
-
-    /**
-     * Checks if user has selected fields in the queryModel and whether current field is among them
-     * Used to check which fields need to be highlighted
-     */
-    selectedFieldsContain(field: CorpusField) {
-        if (this.queryModel && this.queryModel.searchFields && this.queryModel.searchFields.includes(field)) {
-            return true;
-        } else if (this.queryModel && !this.queryModel.searchFields) {
-            return true;  // if there are no selected fields, return true for all fields
-        } else {
-            return false;
-        }
-    }
-
-    stripTags(htmlString: string){
-        const parseHTML= new DOMParser().parseFromString(htmlString, 'text/html');
-        return parseHTML.body.textContent || '';
-      }
-
-    formatInnerHtml(field: CorpusField) {
-        const fieldValue = this.document.fieldValues[field.name];
-
-        if (_.isEmpty(fieldValue)) {
-            return;
-        }
-
-        const highlighted = this.highlightedInnerHtml(field);
-        return this.addParagraphTags(highlighted);
-    }
-
-
-    highlightedInnerHtml(field: CorpusField) {
-        let highlighted = this.document.fieldValues[field.name];
-        if (this.document.highlight && this.document.highlight.hasOwnProperty(field.name) &&
-            this.selectedFieldsContain(field)) { // only apply highlights to selected search fields
-                for (const highlight of this.document.highlight[field.name]) {
-                    const stripped_highlight = this.stripTags(highlight);
-                    highlighted = highlighted.replace(stripped_highlight, highlight);
-                }
-                return highlighted;
-            } else {
-                return this.document.fieldValues[field.name];
-            }
-        }
-
-    addParagraphTags(content: string | string[]) {
-        const paragraphs = typeof content === 'string' ? content.split('\n') : content;
-        return paragraphs.map(p => `<p>${p}</p>`).join(' ');
-    }
 }
diff --git a/frontend/src/app/document/document-preview/document-preview.component.html b/frontend/src/app/document/document-preview/document-preview.component.html
index dba6cf8ad..ed4e8a2bc 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.html
+++ b/frontend/src/app/document/document-preview/document-preview.component.html
@@ -18,7 +18,7 @@
                 <ng-template #unhighlightedRow>
                     <td style="word-break:break-word"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="document.fieldValue(field) | highlight:query:true">
+                        [innerHtml]="document.fieldValue(field) | snippet">
                     </td>
                 </ng-template>
             </tr>
diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index 62f5ed5f9..6802c8c8a 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -10,8 +10,7 @@ import { DocumentPopupComponent } from './document-popup/document-popup.componen
 import { DialogModule } from 'primeng/dialog';
 import { DocumentPreviewComponent } from './document-preview/document-preview.component';
 import { EntityLegendComponent } from './entity-legend/entity-legend.component';
-
-
+import { ElasticsearchHighlightPipe, GeoDataPipe, SnippetPipe } from '../pipes';
 
 @NgModule({
     declarations: [
@@ -21,6 +20,9 @@ import { EntityLegendComponent } from './entity-legend/entity-legend.component';
         DocumentPopupComponent,
         DocumentPreviewComponent,
         EntityLegendComponent,
+        ElasticsearchHighlightPipe,
+        GeoDataPipe,
+        SnippetPipe
     ],
     imports: [
         DialogModule,
diff --git a/frontend/src/app/manual/manual-navigation.component.html b/frontend/src/app/manual/manual-navigation.component.html
index 85a3e1183..6f2055ef7 100644
--- a/frontend/src/app/manual/manual-navigation.component.html
+++ b/frontend/src/app/manual/manual-navigation.component.html
@@ -16,7 +16,7 @@
             <span class="panel-icon" aria-hidden="true">
                 <fa-icon [icon]="navIcons.manual"></fa-icon>
             </span>
-            <span [innerHtml]="page.title | highlight:highlightText"></span>
+            <span [innerHtml]="page.title | regexHighlight:highlightText"></span>
         </a>
     </ng-container>
 </nav>
diff --git a/frontend/src/app/manual/manual.module.ts b/frontend/src/app/manual/manual.module.ts
index ac0d5b3fe..fc13467d9 100644
--- a/frontend/src/app/manual/manual.module.ts
+++ b/frontend/src/app/manual/manual.module.ts
@@ -4,7 +4,7 @@ import { ManualNavigationComponent } from './manual-navigation.component';
 import { ManualComponent } from './manual.component';
 import { AboutComponent } from '../about/about.component';
 import { PrivacyComponent } from '../privacy/privacy.component';
-
+import { RegexHighlightPipe } from '../pipes';
 
 
 @NgModule({
@@ -13,6 +13,7 @@ import { PrivacyComponent } from '../privacy/privacy.component';
         ManualComponent,
         ManualNavigationComponent,
         PrivacyComponent,
+        RegexHighlightPipe
     ],
     imports: [
         SharedModule
diff --git a/frontend/src/app/pipes/elasticsearch-highlight.pipe.ts b/frontend/src/app/pipes/elasticsearch-highlight.pipe.ts
new file mode 100644
index 000000000..3a35ae3cb
--- /dev/null
+++ b/frontend/src/app/pipes/elasticsearch-highlight.pipe.ts
@@ -0,0 +1,51 @@
+import { Pipe, PipeTransform } from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+import { CorpusField, FoundDocument } from '../models';
+import * as _ from 'lodash';
+
+@Pipe({
+    name: 'elasticsearchHighlight'
+})
+export class ElasticsearchHighlightPipe implements PipeTransform {
+    constructor(private sanitizer: DomSanitizer) {
+    }
+
+    /**
+     * Transforms a text to display highlights fetched from Elasticsearch
+     *
+     * @param document a FoundDocument, containing the fetched highlights
+     */
+    transform(field: CorpusField, document: FoundDocument) {
+        const fieldValue = document.fieldValues[field.name];
+
+        if (_.isEmpty(fieldValue)) {
+            return;
+        }
+
+        const highlighted = this.highlightedInnerHtml(field, document);
+        const paragraphs = this.addParagraphTags(highlighted);
+        return this.sanitizer.bypassSecurityTrustHtml(paragraphs);
+    }
+
+    highlightedInnerHtml(field: CorpusField, document: FoundDocument) {
+        let highlighted = document.fieldValues[field.name];
+        if (document.highlight && document.highlight.hasOwnProperty(field.name)) {
+                for (const highlight of document.highlight[field.name]) {
+                    const strippedHighlight = this.stripTags(highlight);
+                    highlighted = highlighted.replace(strippedHighlight, highlight);
+                }
+            }
+        return highlighted;
+    }
+
+    addParagraphTags(content: string | string[]) {
+        const paragraphs = typeof content === 'string' ? content.split('\n') : content;
+        return paragraphs.map(p => `<p>${p}</p>`).join(' ');
+    }
+
+    stripTags(htmlString: string){
+        const parseHTML= new DOMParser().parseFromString(htmlString, 'text/html');
+        return parseHTML.body.textContent || '';
+    }
+
+}
diff --git a/frontend/src/app/pipes/geo-data.pipe.ts b/frontend/src/app/pipes/geo-data.pipe.ts
new file mode 100644
index 000000000..cf7b18a23
--- /dev/null
+++ b/frontend/src/app/pipes/geo-data.pipe.ts
@@ -0,0 +1,25 @@
+import { Pipe, PipeTransform } from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+import { CorpusField, FoundDocument } from '../models';
+@Pipe({
+    name: 'geoData'
+})
+export class GeoDataPipe implements PipeTransform {
+    constructor(private sanitizer: DomSanitizer) {
+    }
+
+    /**
+     * Transforms GeoJSON data
+     *
+     * @param document FoundDocument holding the actual data
+     */
+    transform(field: CorpusField, document: FoundDocument) {
+        let latitude = document.fieldValue(field)[field.name][1];
+        let longitude = document.fieldValue(field)[field.name][0];
+        // Round to 2 decimal places
+        latitude = Math.round(latitude * 100) / 100;
+        longitude = Math.round(longitude * 100) / 100;
+        return `Lat: ${latitude}; Lon: ${longitude}`;
+    }
+
+}
diff --git a/frontend/src/app/pipes/index.ts b/frontend/src/app/pipes/index.ts
new file mode 100644
index 000000000..a20091083
--- /dev/null
+++ b/frontend/src/app/pipes/index.ts
@@ -0,0 +1,4 @@
+export * from './elasticsearch-highlight.pipe';
+export * from './geo-data.pipe';
+export * from './regex-highlight.pipe';
+export * from './snippet.pipe';
diff --git a/frontend/src/app/search/highlight.pipe.ts b/frontend/src/app/pipes/regex-highlight.pipe.ts
similarity index 72%
rename from frontend/src/app/search/highlight.pipe.ts
rename to frontend/src/app/pipes/regex-highlight.pipe.ts
index 3ee84d437..323292ffa 100644
--- a/frontend/src/app/search/highlight.pipe.ts
+++ b/frontend/src/app/pipes/regex-highlight.pipe.ts
@@ -3,22 +3,20 @@ import { DomSanitizer } from '@angular/platform-browser';
 import { HighlightService } from '../services/highlight.service';
 
 @Pipe({
-    name: 'highlight'
+    name: 'regexHighlight'
 })
-export class HighlightPipe implements PipeTransform {
+export class RegexHighlightPipe implements PipeTransform {
     constructor(private sanitizer: DomSanitizer, private highlightService: HighlightService) {
     }
 
     /**
      * Transforms a text to highlight all the text matching the specified query.
-     *
-     * @param snippets Only show snippets. When this enabled, line breaks will also be replaced with --
      */
-    transform(text: string, query: string, snippets: boolean = false) {
+    transform(text: string, query: string) {
         const highlights = this.highlightService.highlight(text, query);
-        const parts = snippets ? this.highlightService.snippets(highlights) : Array.from(highlights);
+        const parts = Array.from(highlights);
         const highlightedText = parts.map(part => {
-            const sanitizedText = this.sanitizedLineBreaks(part.substring, snippets ? ' &mdash; ' : '<br />');
+            const sanitizedText = this.sanitizedLineBreaks(part.substring, '<br />');
 
             return part.isHit ? `<span class="highlight">${sanitizedText}</span>` : sanitizedText;
         }).join('');
diff --git a/frontend/src/app/pipes/snippet.pipe.ts b/frontend/src/app/pipes/snippet.pipe.ts
new file mode 100644
index 000000000..4634395cb
--- /dev/null
+++ b/frontend/src/app/pipes/snippet.pipe.ts
@@ -0,0 +1,20 @@
+import { Pipe, PipeTransform } from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+@Pipe({
+    name: 'snippet'
+})
+export class SnippetPipe implements PipeTransform {
+    constructor(private sanitizer: DomSanitizer) {
+    }
+
+    /**
+     * Transforms a text to only show its leading characters with an ellipsis
+     *
+     * @param nCharacters Specifies how many leading characters should be displayed
+     */
+    transform(text: string, nCharacters=100) {
+        const snippedText = text.slice(0, nCharacters).concat('...');
+        return this.sanitizer.bypassSecurityTrustHtml(snippedText);
+    }
+
+}
diff --git a/frontend/src/app/search/index.ts b/frontend/src/app/search/index.ts
index 11e8bc3bf..40905695a 100644
--- a/frontend/src/app/search/index.ts
+++ b/frontend/src/app/search/index.ts
@@ -1,4 +1,3 @@
-export * from './highlight.pipe';
 export * from './search.component';
 export * from './search-relevance.component';
 export * from './search-results.component';
diff --git a/frontend/src/app/services/highlight.service.ts b/frontend/src/app/services/highlight.service.ts
index 4fdc2a4ea..3ee28b96c 100644
--- a/frontend/src/app/services/highlight.service.ts
+++ b/frontend/src/app/services/highlight.service.ts
@@ -5,10 +5,7 @@ import { Injectable } from '@angular/core';
  * a more scalable approach would need to be implemented if rendering many hits is required.
  */
 const maxHits = 100;
-/**
- * The maximum number of snippets.
- */
-const maxSnippetsCount = 7;
+
 /**
  * The maximum character length of all the text snippets combined.
  */
@@ -78,39 +75,6 @@ export class HighlightService {
         }
     }
 
-    /**
-     * Gets short snippets from the text part to give the user a short overview of the text content.
-     */
-    public snippets(parts: IterableIterator<TextPart>): TextPart[] {
-        const snippets: TextPart[] = [];
-        for (
-            let i = 0, next = parts.next();
-            !next.done && i < maxSnippetsCount;
-            i++, next = parts.next()
-        ) {
-            snippets.push(next.value);
-        }
-
-        const lengths = this.getSnippetLengths(
-            snippets.map((snippet) => snippet.substring.length),
-            maxSnippetsLength
-        );
-
-        snippets.forEach((part, index) => {
-            part.substring = this.cropSnippetText(
-                part.substring,
-                lengths[index],
-                index === snippets.length - 1
-                    ? 'left'
-                    : index === 0
-                    ? 'right'
-                    : 'middle'
-            );
-        });
-
-        return snippets;
-    }
-
     /**
      * Convert the query to a regular expression matching any hit in a string.
      *
@@ -151,79 +115,6 @@ export class HighlightService {
         );
     }
 
-    private getSnippetLengths(
-        actualLengths: number[],
-        maxTotalLength: number,
-        croppedSnippets = actualLengths.length
-    ): number[] {
-        const targetLengths: number[] = [];
-        let remainingCharacters = maxTotalLength;
-        const maxLength = Math.max(
-            1,
-            Math.floor(maxTotalLength / croppedSnippets)
-        );
-
-        let remainingSnippets = 0;
-
-        let i = 0;
-        for (; i < actualLengths.length && remainingCharacters > 0; i++) {
-            const actualLength = actualLengths[i];
-            const targetLength = Math.min(actualLength, maxLength);
-
-            remainingCharacters -= targetLength;
-            targetLengths[i] = targetLength;
-
-            if (actualLength > targetLength) {
-                // only the cropped snippets could become longer
-                remainingSnippets++;
-            }
-        }
-        for (; i < actualLengths.length; i++) {
-            targetLengths[i] = 0;
-        }
-
-        if (remainingCharacters && remainingSnippets) {
-            // if a snippet is shorter than the maximum snippet length, allow the remaining snippets to become longer
-            const additionalLengths = this.getSnippetLengths(
-                actualLengths.map(
-                    (length, index) => length - targetLengths[index]
-                ),
-                remainingCharacters,
-                remainingSnippets
-            );
-            return targetLengths.map(
-                (length, index) => length + additionalLengths[index]
-            );
-        }
-
-        return targetLengths;
-    }
-
-    private cropSnippetText(
-        text: string,
-        maxLength: number,
-        location: 'left' | 'middle' | 'right'
-    ): string {
-        if (text.length <= maxLength) {
-            return text;
-        }
-
-        switch (location) {
-            case 'left':
-                return text.substr(0, maxLength) + omissionString;
-
-            case 'middle':
-                return (
-                    text.substr(0, maxLength / 2) +
-                    omissionString +
-                    text.substr(text.length - maxLength / 2)
-                );
-
-            case 'right':
-                return omissionString + text.slice(-maxLength);
-        }
-    }
-
     /**
      * Get the word patterns match in a query.
      *
diff --git a/frontend/src/app/shared/shared.module.ts b/frontend/src/app/shared/shared.module.ts
index 8f25fd406..b19f89b05 100644
--- a/frontend/src/app/shared/shared.module.ts
+++ b/frontend/src/app/shared/shared.module.ts
@@ -12,7 +12,6 @@ import { BalloonDirective } from '../balloon.directive';
 import { DatePickerComponent } from '../corpus-selection/corpus-filter/date-picker/date-picker.component';
 import { ErrorComponent } from '../error/error.component';
 import { ScrollToDirective } from '../scroll-to.directive';
-import { HighlightPipe } from '../search';
 import { DropdownModule } from './dropdown/dropdown.module';
 import { TabPanelDirective } from './tabs/tab-panel.directive';
 import { TabsComponent } from './tabs/tabs.component';
@@ -22,7 +21,6 @@ import { TabsComponent } from './tabs/tabs.component';
         DatePickerComponent,
         ErrorComponent,
         BalloonDirective,
-        HighlightPipe,
         ScrollToDirective,
         TabsComponent,
         TabPanelDirective,
@@ -43,7 +41,6 @@ import { TabsComponent } from './tabs/tabs.component';
         FormsModule,
         FontAwesomeModule,
         BalloonDirective,
-        HighlightPipe,
         HttpClientModule,
         HttpClientXsrfModule,
         RouterModule,

From cb1f833340c3ff22b4b379e129fbd93403e432f6 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 18 Apr 2024 15:23:42 +0200
Subject: [PATCH 10/91] revert show entities on document previews

---
 .../document-preview/document-preview.component.html   | 10 ++++------
 .../document-preview/document-preview.component.scss   |  3 ---
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/frontend/src/app/document/document-preview/document-preview.component.html b/frontend/src/app/document/document-preview/document-preview.component.html
index ed4e8a2bc..87429833f 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.html
+++ b/frontend/src/app/document/document-preview/document-preview.component.html
@@ -1,7 +1,4 @@
 <ng-container *ngIf="page && document">
-    <div class="heading" *ngIf="document.relevance">
-        Relevance: <ia-search-relevance [value]="document.relevance"></ia-search-relevance>
-    </div>
     <table class="table is-fullwidth">
         <ng-container *ngFor="let field of page.fields">
             <tr *ngIf="document.fieldValue(field)">
@@ -18,7 +15,7 @@
                 <ng-template #unhighlightedRow>
                     <td style="word-break:break-word"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="document.fieldValue(field) | snippet">
+                        [innerHtml]="document.fieldValue(field) | highlight:query:true">
                     </td>
                 </ng-template>
             </tr>
@@ -27,9 +24,10 @@
 
 
     <div class="columns is-vcentered">
-        <div class="column" role="presentation">
-            <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
+        <div class="column is-narrow heading" *ngIf="document.relevance">
+            Relevance: <ia-search-relevance [value]="document.relevance"></ia-search-relevance>
         </div>
+        <div class="column" role="presentation"></div>
         <div class="column field is-grouped is-narrow">
             <div class="control">
                 <button class="button is-primary" (click)="page.focus(document)">
diff --git a/frontend/src/app/document/document-preview/document-preview.component.scss b/frontend/src/app/document/document-preview/document-preview.component.scss
index 341275f9d..0dd32d051 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.scss
+++ b/frontend/src/app/document/document-preview/document-preview.component.scss
@@ -1,6 +1,3 @@
-.heading {
-    text-align: right
-}
 .table {
     td, th {
         border: none;

From b2b746d396fc6da44a5e20704a57dfaf37ba1ea0 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 18 Apr 2024 15:23:55 +0200
Subject: [PATCH 11/91] feat: introduce entity pipe

---
 backend/es/tests/test_named_entity_search.py  |  2 +-
 backend/es/views.py                           |  2 +-
 .../document-view.component.html              | 10 ++++++--
 .../document-view/document-view.component.ts  |  1 -
 frontend/src/app/document/document.module.ts  |  6 +++--
 .../entity-legend.component.html              |  2 +-
 frontend/src/app/models/found-document.ts     | 20 ++++++++++++----
 frontend/src/app/pipes/entity.pipe.ts         | 23 +++++++++++++++++++
 .../src/app/pipes/format-entity-class.pipe.ts | 20 ++++++++++++++++
 frontend/src/app/pipes/index.ts               |  2 ++
 frontend/src/app/services/entity.service.ts   | 10 +++++---
 11 files changed, 82 insertions(+), 16 deletions(-)
 create mode 100644 frontend/src/app/pipes/entity.pipe.ts
 create mode 100644 frontend/src/app/pipes/format-entity-class.pipe.ts

diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
index c86b2ee85..bb12328c6 100644
--- a/backend/es/tests/test_named_entity_search.py
+++ b/backend/es/tests/test_named_entity_search.py
@@ -45,7 +45,7 @@ def test_find_entities():
     text = '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'
     entity_classes = set()
     output = viewset.find_entities(text, entity_classes)
-    expected = '<mark class="entity-per">Guybrush Threepwood</mark> is looking for treasure on <mark class="entity-loc">Monkey Island</mark>'
+    expected = '<span class="entity-per">Guybrush Threepwood</span> is looking for treasure on <span class="entity-loc">Monkey Island</span>'
     assert output == expected
     assert len(list(entity_classes)) == 2
     assert all(entity in list(entity_classes) for entity in ['PER', 'LOC'])
diff --git a/backend/es/views.py b/backend/es/views.py
index c3734629b..ceabd6dc3 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -180,4 +180,4 @@ def substitute_annotation_with_tag(self, annotation: tuple, input_text: str, ent
         annotated = annotation[0][1:-1]
         entity_classes.update({entity_class})
         return input_text.replace(
-            ''.join(annotation), f'<mark class="entity-{entity_class.lower()}">{annotated}</mark>')
+            ''.join(annotation), f'<span class="entity-{entity_class.lower()}">{annotated}</span>')
diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index 2a2c6a306..3730d2adf 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -38,10 +38,16 @@
         <div class="box">
             <ia-tabs [activeTab]="activeTab">
                 <ng-template iaTabPanel *ngFor="let field of contentFields" [id]="field.name" [title]="field.displayName" [icon]="documentIcons.text">
-                    <div class="content"
+                    <div *ngIf="document.annotations$ | async" class="content"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="field | elasticsearchHighlight:document">
+                        [innerHtml]="field | entity:document">
                     </div>
+                    <ng-template #showHighlights>
+                        <div class="content"
+                            [attr.lang]="document.language(field)"
+                            [innerHtml]="field | elasticsearchHighlight:document">
+                        </div>
+                    </ng-template>
                     <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
                 </ng-template>
                 <ng-template iaTabPanel id="scan" *ngIf="showScanTab" title="Image" [icon]="documentIcons.scan">
diff --git a/frontend/src/app/document-view/document-view.component.ts b/frontend/src/app/document-view/document-view.component.ts
index 1f5171d79..a1fd4f8c2 100644
--- a/frontend/src/app/document-view/document-view.component.ts
+++ b/frontend/src/app/document-view/document-view.component.ts
@@ -52,7 +52,6 @@ export class DocumentViewComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void {
         if (changes.view) {
             this.activeTab = this.tabFromView(this.view);
-            this.document.fetchEntities();
         }
     }
 
diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index 6802c8c8a..1e60ee50a 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -10,7 +10,7 @@ import { DocumentPopupComponent } from './document-popup/document-popup.componen
 import { DialogModule } from 'primeng/dialog';
 import { DocumentPreviewComponent } from './document-preview/document-preview.component';
 import { EntityLegendComponent } from './entity-legend/entity-legend.component';
-import { ElasticsearchHighlightPipe, GeoDataPipe, SnippetPipe } from '../pipes';
+import { ElasticsearchHighlightPipe, EntityPipe, FormatEntityClassPipe, GeoDataPipe, SnippetPipe } from '../pipes';
 
 @NgModule({
     declarations: [
@@ -19,8 +19,10 @@ import { ElasticsearchHighlightPipe, GeoDataPipe, SnippetPipe } from '../pipes';
         SearchRelevanceComponent,
         DocumentPopupComponent,
         DocumentPreviewComponent,
-        EntityLegendComponent,
         ElasticsearchHighlightPipe,
+        EntityLegendComponent,
+        EntityPipe,
+        FormatEntityClassPipe,
         GeoDataPipe,
         SnippetPipe
     ],
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.html b/frontend/src/app/document/entity-legend/entity-legend.component.html
index 8f6f72a62..358862263 100644
--- a/frontend/src/app/document/entity-legend/entity-legend.component.html
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.html
@@ -1,3 +1,3 @@
 <div *ngFor="let entity of entities">
-    <span class="dot" [ngClass]="formatClass(entity)"></span><span>{{entity}}</span>
+    <span class="dot" [ngClass]="entity | formatEntityClass"></span><span>{{entity}}</span>
 </div>
diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index 48fe1b03e..7aa3cf8a2 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -30,6 +30,7 @@ export class FoundDocument {
 
     /** named entities associated with the document */
     entities: string[];
+    annotations$: Observable<{[fieldName: string]: string}[]>;
     private tagsChanged$ = new Subject<void>();
 
     constructor(
@@ -54,6 +55,11 @@ export class FoundDocument {
             mergeMap(() => this.fetchTags()),
             shareReplay(1),
         );
+
+        this.annotations$ = created$.pipe(
+            mergeMap(() => this.fetchAnnotatedEntities()),
+            shareReplay(1),
+        );
     }
 
     /**
@@ -118,12 +124,16 @@ export class FoundDocument {
         );
     }
 
-
-    fetchEntities(): Promise<void> {
-        return this.entityService.getDocumentEntities(this.corpus, this.id).then((result) => {
-            this.entities = result.entities;
-            result.annotations.map((annotation)=> _.set(this.fieldValues, _.keys(annotation)[0], _.values(annotation)[0]));
+    private fetchAnnotatedEntities(): Observable<{[fieldName: string]: string}[]> {
+        const response$ = this.entityService.getDocumentEntities(this.corpus, this.id);
+        response$.pipe(
+            map( response => response.entities )
+        ).toPromise().then((entities) => {
+            this.entities = entities;
         });
+        return response$.pipe(
+            map( response => response.annotations)
+        );
     }
 
     private setTags(tags: Tag[]): Observable<Tag[]> {
diff --git a/frontend/src/app/pipes/entity.pipe.ts b/frontend/src/app/pipes/entity.pipe.ts
new file mode 100644
index 000000000..92bc99e99
--- /dev/null
+++ b/frontend/src/app/pipes/entity.pipe.ts
@@ -0,0 +1,23 @@
+import { Pipe, PipeTransform } from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+import { CorpusField, FoundDocument } from '../models';
+import * as _ from 'lodash';
+@Pipe({
+    name: 'entity'
+})
+export class EntityPipe implements PipeTransform {
+    constructor(private sanitizer: DomSanitizer) {
+    }
+
+    /**
+     * Transform field with annotated entities
+     *
+     * @param document FoundDocument holding the actual data
+     */
+    transform(field: CorpusField, document: FoundDocument) {
+        const newText = document.annotations$.map(
+            (annotation)=> _.set(document.fieldValues, _.keys(annotation)[0], _.values(annotation)[0]));
+        return newText;
+    }
+
+}
diff --git a/frontend/src/app/pipes/format-entity-class.pipe.ts b/frontend/src/app/pipes/format-entity-class.pipe.ts
new file mode 100644
index 000000000..11f935005
--- /dev/null
+++ b/frontend/src/app/pipes/format-entity-class.pipe.ts
@@ -0,0 +1,20 @@
+
+import { Pipe, PipeTransform } from '@angular/core';
+import * as _ from 'lodash';
+@Pipe({
+    name: 'formatEntityClass'
+})
+export class FormatEntityClassPipe implements PipeTransform {
+    constructor() {
+    }
+
+    /**
+     * Transform field with annotated entities
+     *
+     * @param document FoundDocument holding the actual data
+     */
+    transform(entityName: string) {
+        return `entity-${entityName.toLowerCase().slice(0,3)}`;
+    }
+
+}
diff --git a/frontend/src/app/pipes/index.ts b/frontend/src/app/pipes/index.ts
index a20091083..d9e21dbdc 100644
--- a/frontend/src/app/pipes/index.ts
+++ b/frontend/src/app/pipes/index.ts
@@ -1,4 +1,6 @@
 export * from './elasticsearch-highlight.pipe';
+export * from './entity.pipe';
+export * from './format-entity-class.pipe';
 export * from './geo-data.pipe';
 export * from './regex-highlight.pipe';
 export * from './snippet.pipe';
diff --git a/frontend/src/app/services/entity.service.ts b/frontend/src/app/services/entity.service.ts
index 7e63d71f2..5d8a35f0a 100644
--- a/frontend/src/app/services/entity.service.ts
+++ b/frontend/src/app/services/entity.service.ts
@@ -1,8 +1,10 @@
 import { HttpClient } from '@angular/common/http';
-import { Corpus, NamedEntitiesResult } from '../models';
 import { Injectable } from '@angular/core';
 import { Observable } from 'rxjs';
 
+import { Corpus, NamedEntitiesResult } from '../models';
+import { map, share, shareReplay, take } from 'rxjs/operators';
+
 @Injectable({
     providedIn: 'root',
 })
@@ -11,8 +13,10 @@ export class EntityService {
     constructor(private http: HttpClient) {
     }
 
-    public async getDocumentEntities(corpus: Corpus, id: string): Promise<NamedEntitiesResult> {
+    public getDocumentEntities(corpus: Corpus, id: string): Observable<NamedEntitiesResult> {
         const url = `/api/es/${corpus.name}/${id}/named_entities`;
-        return this.http.get<NamedEntitiesResult>(url).toPromise();
+        return this.http.get<NamedEntitiesResult>(url).pipe(
+            take(1),
+        );
     }
 }

From 9e5c6ac7081a7a82189b8c6c4356a00324b63382 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 25 Apr 2024 10:56:56 +0200
Subject: [PATCH 12/91] use snippet pipe for document preview

---
 .../document/document-preview/document-preview.component.html   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/app/document/document-preview/document-preview.component.html b/frontend/src/app/document/document-preview/document-preview.component.html
index 87429833f..248e7a632 100644
--- a/frontend/src/app/document/document-preview/document-preview.component.html
+++ b/frontend/src/app/document/document-preview/document-preview.component.html
@@ -15,7 +15,7 @@
                 <ng-template #unhighlightedRow>
                     <td style="word-break:break-word"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="document.fieldValue(field) | highlight:query:true">
+                        [innerHtml]="document.fieldValue(field) | snippet">
                     </td>
                 </ng-template>
             </tr>

From 1deb9e640a790316d345ed83998c047b8deb4d68 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 25 Apr 2024 13:49:31 +0200
Subject: [PATCH 13/91] feat: working display of named entities

---
 .../app/document-view/document-view.component.html   |  2 +-
 frontend/src/app/models/found-document.ts            |  2 +-
 frontend/src/app/pipes/entity.pipe.ts                | 12 +++++++-----
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index 3730d2adf..9314fe57a 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -40,7 +40,7 @@
                 <ng-template iaTabPanel *ngFor="let field of contentFields" [id]="field.name" [title]="field.displayName" [icon]="documentIcons.text">
                     <div *ngIf="document.annotations$ | async" class="content"
                         [attr.lang]="document.language(field)"
-                        [innerHtml]="field | entity:document">
+                        [innerHtml]="document.annotations$ | async | entity:document:field.name">
                     </div>
                     <ng-template #showHighlights>
                         <div class="content"
diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index 7aa3cf8a2..744bddc01 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -132,7 +132,7 @@ export class FoundDocument {
             this.entities = entities;
         });
         return response$.pipe(
-            map( response => response.annotations)
+            map( response => response.annotations || [])
         );
     }
 
diff --git a/frontend/src/app/pipes/entity.pipe.ts b/frontend/src/app/pipes/entity.pipe.ts
index 92bc99e99..ebb556edf 100644
--- a/frontend/src/app/pipes/entity.pipe.ts
+++ b/frontend/src/app/pipes/entity.pipe.ts
@@ -1,7 +1,10 @@
 import { Pipe, PipeTransform } from '@angular/core';
 import { DomSanitizer } from '@angular/platform-browser';
-import { CorpusField, FoundDocument } from '../models';
+import { Observable } from 'rxjs';
+
+import { FoundDocument } from '../models';
 import * as _ from 'lodash';
+
 @Pipe({
     name: 'entity'
 })
@@ -14,10 +17,9 @@ export class EntityPipe implements PipeTransform {
      *
      * @param document FoundDocument holding the actual data
      */
-    transform(field: CorpusField, document: FoundDocument) {
-        const newText = document.annotations$.map(
-            (annotation)=> _.set(document.fieldValues, _.keys(annotation)[0], _.values(annotation)[0]));
-        return newText;
+    transform(annotations$: Observable<{[fieldName: string]: string}[]>, document: FoundDocument, fieldName: string) {
+        const newText = annotations$[fieldName];
+        return newText || document.fieldValues[fieldName];
     }
 
 }

From e08b20e76f1a71cd4771d76d7bc26ad2870fc2f1 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 25 Apr 2024 14:07:05 +0200
Subject: [PATCH 14/91] fix: update backend parsing of annotations

---
 backend/es/tests/test_named_entity_search.py | 5 ++---
 backend/es/views.py                          | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
index bb12328c6..81afc8460 100644
--- a/backend/es/tests/test_named_entity_search.py
+++ b/backend/es/tests/test_named_entity_search.py
@@ -3,9 +3,8 @@
 
 def test_ner_search_view(es_ner_search_client, client, times_user):
     client.force_login(times_user)
-    route = '/api/es/times/named_entities'
-    data = {'id': 'my_identifier'}
-    response = client.post(route, data, content_type='application/json')
+    route = '/api/es/times/my_identifier/named_entities'
+    response = client.get(route, content_type='application/json')
     assert response.status_code == 200
 
 
diff --git a/backend/es/views.py b/backend/es/views.py
index ceabd6dc3..645fe86e6 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -168,7 +168,7 @@ def add_terms(self, fields: list[str]) -> list[dict]:
 
     def find_entities(self, input_text: str, entity_classes: set) -> str:
         # regex pattern to match annotations of format "[Wally](Person)" and split it into two groups
-        pattern = re.compile('(\[[a-zA-Z ]+\])(\([a-zA-Z ]+\))')
+        pattern = re.compile('(\[[^]]+\])(\([A-Z]+\))')
         annotations = list(set(pattern.findall(input_text)))
         for annotation in annotations:
             input_text = self.substitute_annotation_with_tag(

From cd29f434bc229b3688494d6991e15af59d4f9260 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Thu, 25 Apr 2024 14:24:45 +0200
Subject: [PATCH 15/91] remove citation page from ublad

---
 backend/corpora/ublad/ublad.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 1758d3ab3..4b5a739ca 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -28,7 +28,6 @@ class UBlad(HTMLCorpusDefinition):
     data_directory = settings.UBLAD_DATA
     es_index = getattr(settings, 'UBLAD_ES_INDEX', 'ublad')
     image = 'ublad.jpg'
-    citation_page = 'citation.md'
     scan_image_type = getattr(settings, 'UBLAD_SCAN_IMAGE_TYPE', 'image/jpeg')
     allow_image_download = getattr(settings, 'UBLAD_ALLOW_IMAGE_DOWNLOAD', True)
 

From 0dc2659ba1f7e8e6f46a8508955866232df066d9 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 26 Apr 2024 13:06:29 +0200
Subject: [PATCH 16/91] rename id field for ublad

---
 backend/corpora/ublad/ublad.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 4b5a739ca..e52020caa 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -103,7 +103,7 @@ def sources(self, start=min_date, end=max_date):
             )
         ),
         FieldDefinition(
-            name='page_id',
+            name='id',
             display_name='Page ID',
             description='Unique identifier for this page',
             hidden=True,

From e41db24310ea37e4c562b35a148c6610261efddc Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 15 May 2024 16:47:43 +0200
Subject: [PATCH 17/91] add corpus definitions link

---
 .../corpus-selection.component.html                |  9 +++++++++
 .../corpus-selection/corpus-selection.component.ts | 14 +++++++++++++-
 frontend/src/app/shared/icons.ts                   |  4 ++--
 3 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/frontend/src/app/corpus-selection/corpus-selection.component.html b/frontend/src/app/corpus-selection/corpus-selection.component.html
index cc90ff34a..a4c4fd1c2 100644
--- a/frontend/src/app/corpus-selection/corpus-selection.component.html
+++ b/frontend/src/app/corpus-selection/corpus-selection.component.html
@@ -1,11 +1,20 @@
 <section class="section">
     <div class="container is-readable">
+        <a class="button is-pulled-right" *ngIf="showManageLink$ | async"
+            [routerLink]="['/corpus-definitions/']">
+            <span class="icon" aria-hidden="true">
+                <fa-icon [icon]="actionIcons.edit"></fa-icon>
+            </span>
+            <span>Corpus definitions</span>
+        </a>
+
         <h1 class="title">
             Welcome
         </h1>
         <h2 class="subtitle">
             Select a corpus to search through
         </h2>
+
         <hr>
 
         <div class="block">
diff --git a/frontend/src/app/corpus-selection/corpus-selection.component.ts b/frontend/src/app/corpus-selection/corpus-selection.component.ts
index 6bcdac5cb..f22a3dc87 100644
--- a/frontend/src/app/corpus-selection/corpus-selection.component.ts
+++ b/frontend/src/app/corpus-selection/corpus-selection.component.ts
@@ -1,6 +1,10 @@
 import { Component, Input, OnInit } from '@angular/core';
 import { Corpus } from '../models/corpus';
 import * as _ from 'lodash';
+import { AuthService } from '../services';
+import { map } from 'rxjs/operators';
+import { Observable } from 'rxjs';
+import { actionIcons } from '../shared/icons';
 
 
 @Component({
@@ -14,7 +18,15 @@ export class CorpusSelectionComponent implements OnInit {
 
     filteredItems: Corpus[];
 
-    constructor() { }
+    showManageLink$: Observable<boolean>;
+
+    actionIcons = actionIcons;
+
+    constructor(private authService: AuthService) {
+        this.showManageLink$ = this.authService.currentUser$.pipe(
+            map((user) => user?.isAdmin)
+        );
+     }
 
     get displayItems(): Corpus[] {
         if (_.isUndefined(this.filteredItems)) {
diff --git a/frontend/src/app/shared/icons.ts b/frontend/src/app/shared/icons.ts
index 0d5dd8676..f90ea0e55 100644
--- a/frontend/src/app/shared/icons.ts
+++ b/frontend/src/app/shared/icons.ts
@@ -7,7 +7,7 @@ import {
     faAngleDown, faAngleUp, faArrowLeft, faArrowRight, faAt, faBook, faBookOpen, faChartColumn,
     faCheck, faChevronDown, faChevronLeft, faChevronRight, faCog, faCogs, faDatabase, faDiagramProject,
     faDownload, faEdit, faEnvelope, faEye, faFilter, faHistory, faImage, faInfo, faInfoCircle, faLink, faList, faLock,
-    faMinus, faPalette, faPlus, faQuestionCircle, faSearch, faSearchMinus, faSearchPlus, faSignOut,
+    faMinus, faPalette, faPencil, faPlus, faQuestionCircle, faSearch, faSearchMinus, faSearchPlus, faSignOut,
     faSortAlphaAsc, faSortAlphaDesc, faSortNumericAsc, faSortNumericDesc, faSquare,
     faTable, faTags, faTimes, faTrashCan, faUndo, faUser
 } from '@fortawesome/free-solid-svg-icons';
@@ -52,7 +52,7 @@ export const actionIcons: Icons = {
     add: faPlus,
     remove: faTimes,
     delete: faTrashCan,
-    edit: faEdit,
+    edit: faPencil,
     view: faEye,
 };
 

From 74b1235e2b5f412e6c0b1bf9840e3014052fcf0a Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 15 May 2024 16:53:39 +0200
Subject: [PATCH 18/91] generate definitions overview component

---
 frontend/src/app/app.module.ts                |  6 +++++
 .../corpus-definitions.module.ts              | 15 +++++++++++++
 .../definitions-overview.component.html       |  1 +
 .../definitions-overview.component.scss       |  0
 .../definitions-overview.component.spec.ts    | 22 +++++++++++++++++++
 .../definitions-overview.component.ts         | 15 +++++++++++++
 6 files changed, 59 insertions(+)
 create mode 100644 frontend/src/app/corpus-definitions/corpus-definitions.module.ts
 create mode 100644 frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
 create mode 100644 frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.scss
 create mode 100644 frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
 create mode 100644 frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts

diff --git a/frontend/src/app/app.module.ts b/frontend/src/app/app.module.ts
index aeafe617b..224be1404 100644
--- a/frontend/src/app/app.module.ts
+++ b/frontend/src/app/app.module.ts
@@ -50,6 +50,7 @@ import { SharedModule } from './shared/shared.module';
 import { WordModelsComponent } from './word-models/word-models.component';
 import { WordModelsModule } from './word-models/word-models.module';
 import { TagOverviewComponent } from './tag/tag-overview/tag-overview.component';
+import { DefinitionsOverviewComponent } from './corpus-definitions/definitions-overview/definitions-overview.component';
 
 export const appRoutes: Routes = [
     {
@@ -132,6 +133,11 @@ export const appRoutes: Routes = [
         component: TagOverviewComponent,
         canActivate: [LoggedOnGuard],
     },
+    {
+        path: 'corpus-definitions',
+        component: DefinitionsOverviewComponent,
+        canActivate: [LoggedOnGuard],
+    },
     {
         path: '',
         redirectTo: 'home',
diff --git a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
new file mode 100644
index 000000000..e2194a088
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
@@ -0,0 +1,15 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { DefinitionsOverviewComponent } from './definitions-overview/definitions-overview.component';
+
+
+
+@NgModule({
+  declarations: [
+    DefinitionsOverviewComponent
+  ],
+  imports: [
+    CommonModule
+  ]
+})
+export class CorpusDefinitionsModule { }
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
new file mode 100644
index 000000000..7de1976e0
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -0,0 +1 @@
+<p>definitions-overview works!</p>
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.scss b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
new file mode 100644
index 000000000..736a0188b
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
@@ -0,0 +1,22 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { DefinitionsOverviewComponent } from './definitions-overview.component';
+import { commonTestBed } from 'src/app/common-test-bed';
+
+describe('DefinitionsOverviewComponent', () => {
+    let component: DefinitionsOverviewComponent;
+    let fixture: ComponentFixture<DefinitionsOverviewComponent>;
+
+    beforeEach(waitForAsync(() => {
+        commonTestBed().testingModule.compileComponents();
+    }));
+    beforeEach(() => {
+        fixture = TestBed.createComponent(DefinitionsOverviewComponent);
+        component = fixture.componentInstance;
+        fixture.detectChanges();
+    });
+
+    it('should create', () => {
+        expect(component).toBeTruthy();
+    });
+});
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
new file mode 100644
index 000000000..68ca5b456
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -0,0 +1,15 @@
+import { Component, OnInit } from '@angular/core';
+
+@Component({
+  selector: 'ia-definitions-overview',
+  templateUrl: './definitions-overview.component.html',
+  styleUrls: ['./definitions-overview.component.scss']
+})
+export class DefinitionsOverviewComponent implements OnInit {
+
+  constructor() { }
+
+  ngOnInit(): void {
+  }
+
+}

From 9540010da4e213613f3cb243e60873580bd03ad2 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 15 May 2024 17:08:20 +0200
Subject: [PATCH 19/91] basic interface for definitions overview

---
 frontend/src/app/app.module.ts                |  2 +
 .../corpus-definitions.module.ts              | 17 ++++---
 .../definitions-overview.component.html       | 48 ++++++++++++++++++-
 .../definitions-overview.component.ts         | 14 +++---
 4 files changed, 67 insertions(+), 14 deletions(-)

diff --git a/frontend/src/app/app.module.ts b/frontend/src/app/app.module.ts
index 224be1404..cce4bb0ea 100644
--- a/frontend/src/app/app.module.ts
+++ b/frontend/src/app/app.module.ts
@@ -51,6 +51,7 @@ import { WordModelsComponent } from './word-models/word-models.component';
 import { WordModelsModule } from './word-models/word-models.module';
 import { TagOverviewComponent } from './tag/tag-overview/tag-overview.component';
 import { DefinitionsOverviewComponent } from './corpus-definitions/definitions-overview/definitions-overview.component';
+import { CorpusDefinitionsModule } from './corpus-definitions/corpus-definitions.module';
 
 export const appRoutes: Routes = [
     {
@@ -164,6 +165,7 @@ export const imports: any[] = [
     SharedModule,
     // Feature Modules
     CorpusModule,
+    CorpusDefinitionsModule,
     CorpusSelectionModule,
     DialogModule,
     DocumentModule,
diff --git a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
index e2194a088..f4187a679 100644
--- a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
+++ b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
@@ -1,15 +1,18 @@
 import { NgModule } from '@angular/core';
-import { CommonModule } from '@angular/common';
 import { DefinitionsOverviewComponent } from './definitions-overview/definitions-overview.component';
+import { SharedModule } from '../shared/shared.module';
 
 
 
 @NgModule({
-  declarations: [
-    DefinitionsOverviewComponent
-  ],
-  imports: [
-    CommonModule
-  ]
+    declarations: [
+        DefinitionsOverviewComponent
+    ],
+    exports: [
+        DefinitionsOverviewComponent,
+    ],
+    imports: [
+        SharedModule
+    ]
 })
 export class CorpusDefinitionsModule { }
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index 7de1976e0..fdc5c5e00 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -1 +1,47 @@
-<p>definitions-overview works!</p>
+<div class="section">
+    <div class="container">
+        <h1 class="title">Corpus definitions</h1>
+
+        <div class="block">
+            <button class="button is-primary">
+                <span class="icon" aria-hidden="true">
+                    <fa-icon [icon]="actionIcons.add"></fa-icon>
+                </span>
+                <span>Create a new corpus</span>
+            </button>
+        </div>
+
+        <div class="block">
+            <table class="table is-fullwidth">
+                <thead>
+                    <tr>
+                        <th>Corpus</th>
+                        <th>Actions</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <tr>
+                        <td>Test</td>
+                        <td>
+                            <button class="button">
+                                <span class="icon" aria-label="browse">
+                                    <fa-icon [icon]="actionIcons.search"></fa-icon>
+                                </span>
+                            </button>
+                            <button class="button">
+                                <span class="icon" aria-label="edit">
+                                    <fa-icon [icon]="actionIcons.edit"></fa-icon>
+                                </span>
+                            </button>
+                            <button class="button">
+                                <span class="icon" aria-label="delete">
+                                    <fa-icon [icon]="actionIcons.delete"></fa-icon>
+                                </span>
+                            </button>
+                        </td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </div>
+</div>
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
index 68ca5b456..7ad4b1c80 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -1,15 +1,17 @@
 import { Component, OnInit } from '@angular/core';
+import { actionIcons } from '../../shared/icons';
 
 @Component({
-  selector: 'ia-definitions-overview',
-  templateUrl: './definitions-overview.component.html',
-  styleUrls: ['./definitions-overview.component.scss']
+    selector: 'ia-definitions-overview',
+    templateUrl: './definitions-overview.component.html',
+    styleUrls: ['./definitions-overview.component.scss']
 })
 export class DefinitionsOverviewComponent implements OnInit {
+    actionIcons = actionIcons;
 
-  constructor() { }
+    constructor() { }
 
-  ngOnInit(): void {
-  }
+    ngOnInit(): void {
+    }
 
 }

From cc9521bc572cd0403c3f046bb6eea9dd22a049a8 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 15 May 2024 17:42:34 +0200
Subject: [PATCH 20/91] add APICorpusDefinition interface

---
 frontend/src/app/models/corpus-definition.ts | 55 ++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 frontend/src/app/models/corpus-definition.ts

diff --git a/frontend/src/app/models/corpus-definition.ts b/frontend/src/app/models/corpus-definition.ts
new file mode 100644
index 000000000..6442ddf31
--- /dev/null
+++ b/frontend/src/app/models/corpus-definition.ts
@@ -0,0 +1,55 @@
+export interface APICorpusField {
+    name: string;
+    display_name: string;
+    description: string;
+    type: 'text-content'|'text_metadata'|'url'|'integer'|'float'|'date'|'boolean'|'geo_point';
+    options: {
+        search: boolean;
+        filter: 'show'|'hide'|'none';
+        preview: boolean;
+        visualize: boolean;
+        sort: boolean;
+        hidden: boolean;
+    };
+    language?: string;
+    extract: {
+        column: string;
+    };
+}
+
+export interface APICorpusDefinition {
+    name: string;
+    id?: number;
+    meta: {
+        title: string;
+        category: string;
+        description: string;
+        languages: string[];
+        date_range: {
+            min: string;
+            max: string;
+        };
+    };
+    source_data: {
+        type: 'csv';
+        options?: {
+            delimiter?: ','|';'|'\t';
+        };
+    };
+    fields: APICorpusField[];
+    options?: {
+        language_field?: string;
+        document_context?: {
+            context_fields: string[];
+            context_display_name: string;
+            sort?: {
+                field: string;
+                ascending: boolean;
+            };
+        };
+        default_sort?: {
+            field: string;
+            ascending: boolean;
+        };
+    };
+};

From ce9206c148c2b8210b245d397862fd5935ac5fb5 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 15 May 2024 17:53:32 +0200
Subject: [PATCH 21/91] fetch definitions in overview

---
 .../definitions-overview.component.html       |  8 +++++---
 .../definitions-overview.component.ts         | 13 ++++++++-----
 frontend/src/app/services/api.service.ts      | 19 +++++++++++++++++++
 3 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index fdc5c5e00..c932d2ae9 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -11,7 +11,7 @@ <h1 class="title">Corpus definitions</h1>
             </button>
         </div>
 
-        <div class="block">
+        <div class="block" *ngIf="definitions$ | async as definitions">
             <table class="table is-fullwidth">
                 <thead>
                     <tr>
@@ -20,19 +20,21 @@ <h1 class="title">Corpus definitions</h1>
                     </tr>
                 </thead>
                 <tbody>
-                    <tr>
-                        <td>Test</td>
+                    <tr *ngFor="let definition of definitions">
+                        <td>{{definition.meta.title}}</td>
                         <td>
                             <button class="button">
                                 <span class="icon" aria-label="browse">
                                     <fa-icon [icon]="actionIcons.search"></fa-icon>
                                 </span>
                             </button>
+                            &nbsp;
                             <button class="button">
                                 <span class="icon" aria-label="edit">
                                     <fa-icon [icon]="actionIcons.edit"></fa-icon>
                                 </span>
                             </button>
+                            &nbsp;
                             <button class="button">
                                 <span class="icon" aria-label="delete">
                                     <fa-icon [icon]="actionIcons.delete"></fa-icon>
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
index 7ad4b1c80..f5b4556ed 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -1,17 +1,20 @@
-import { Component, OnInit } from '@angular/core';
+import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
+import { ApiService } from '../../services';
+import { Observable } from 'rxjs';
+import { APICorpusDefinition } from '../../models/corpus-definition';
 
 @Component({
     selector: 'ia-definitions-overview',
     templateUrl: './definitions-overview.component.html',
     styleUrls: ['./definitions-overview.component.scss']
 })
-export class DefinitionsOverviewComponent implements OnInit {
+export class DefinitionsOverviewComponent {
     actionIcons = actionIcons;
 
-    constructor() { }
+    definitions$: Observable<APICorpusDefinition[]>;
 
-    ngOnInit(): void {
+    constructor(private apiService: ApiService) {
+        this.definitions$ = this.apiService.corpusDefinitions();
     }
-
 }
diff --git a/frontend/src/app/services/api.service.ts b/frontend/src/app/services/api.service.ts
index f2d33bea7..cd197acbf 100644
--- a/frontend/src/app/services/api.service.ts
+++ b/frontend/src/app/services/api.service.ts
@@ -31,6 +31,7 @@ import {
 } from '../models/index';
 import { environment } from '../../environments/environment';
 import * as _ from 'lodash';
+import { APICorpusDefinition } from '../models/corpus-definition';
 
 interface SolisLoginResponse {
     success: boolean;
@@ -234,6 +235,24 @@ export class ApiService {
         return this.http.get<Corpus[]>('/api/corpus/');
     }
 
+    // Corpus definitions
+
+    public corpusDefinitions() {
+        return this.http.get<APICorpusDefinition[]>('/api/corpus/definitions/');
+    }
+
+    public createCorpus(data: APICorpusDefinition) {
+        return this.http.post<APICorpusDefinition>('/api/corpus/definitions/', data);
+    }
+
+    public updateCorpus(corpusID: number, data: APICorpusDefinition) {
+        return this.http.put<APICorpusDefinition>(`/api/corpus/definitions/${corpusID}`, data);
+    }
+
+    public deleteCorpus(corpusID: number) {
+        return this.http.delete(`/api/corpus/definitions/${corpusID}`);
+    }
+
     // Tagging
 
     public userTags(): Observable<Tag[]> {

From 9ac7a0792230d8b7d0150c5b2688de8a7893174c Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 11:29:22 +0200
Subject: [PATCH 22/91] draft create-definition component

---
 frontend/src/app/app.module.ts                | 12 +++++++++-
 .../corpus-definitions.module.ts              |  5 +++-
 .../create-definition.component.html          | 18 +++++++++++++++
 .../create-definition.component.scss          |  0
 .../create-definition.component.spec.ts       | 23 +++++++++++++++++++
 .../create-definition.component.ts            | 18 +++++++++++++++
 .../definitions-overview.component.html       | 15 ++++--------
 .../definitions-overview.component.spec.ts    |  1 +
 .../definitions-overview.component.ts         |  3 ++-
 frontend/src/app/shared/icons.ts              |  3 ++-
 10 files changed, 84 insertions(+), 14 deletions(-)
 create mode 100644 frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
 create mode 100644 frontend/src/app/corpus-definitions/create-definition/create-definition.component.scss
 create mode 100644 frontend/src/app/corpus-definitions/create-definition/create-definition.component.spec.ts
 create mode 100644 frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts

diff --git a/frontend/src/app/app.module.ts b/frontend/src/app/app.module.ts
index cce4bb0ea..88106ffbe 100644
--- a/frontend/src/app/app.module.ts
+++ b/frontend/src/app/app.module.ts
@@ -52,6 +52,7 @@ import { WordModelsModule } from './word-models/word-models.module';
 import { TagOverviewComponent } from './tag/tag-overview/tag-overview.component';
 import { DefinitionsOverviewComponent } from './corpus-definitions/definitions-overview/definitions-overview.component';
 import { CorpusDefinitionsModule } from './corpus-definitions/corpus-definitions.module';
+import { CreateDefinitionComponent } from './corpus-definitions/create-definition/create-definition.component';
 
 export const appRoutes: Routes = [
     {
@@ -136,8 +137,17 @@ export const appRoutes: Routes = [
     },
     {
         path: 'corpus-definitions',
-        component: DefinitionsOverviewComponent,
         canActivate: [LoggedOnGuard],
+        children: [
+            {
+                path: 'new',
+                component: CreateDefinitionComponent,
+            },
+            {
+                path: '',
+                component: DefinitionsOverviewComponent,
+            },
+        ]
     },
     {
         path: '',
diff --git a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
index f4187a679..78a617655 100644
--- a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
+++ b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
@@ -1,14 +1,17 @@
 import { NgModule } from '@angular/core';
 import { DefinitionsOverviewComponent } from './definitions-overview/definitions-overview.component';
 import { SharedModule } from '../shared/shared.module';
+import { CreateDefinitionComponent } from './create-definition/create-definition.component';
 
 
 
 @NgModule({
     declarations: [
-        DefinitionsOverviewComponent
+        CreateDefinitionComponent,
+        DefinitionsOverviewComponent,
     ],
     exports: [
+        CreateDefinitionComponent,
         DefinitionsOverviewComponent,
     ],
     imports: [
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
new file mode 100644
index 000000000..8034cc2bd
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
@@ -0,0 +1,18 @@
+<section class="section">
+    <div class="container">
+        <h1 class="title">New corpus</h1>
+
+        <p class="block">
+            Upload a JSON definition file to add it as a corpus.
+        </p>
+
+        <div class="block">
+            <button class="button">
+                <span class="icon" aria-hidden="true">
+                    <fa-icon [icon]="actionIcons.upload"></fa-icon>
+                </span>
+                <span>Upload JSON</span>
+            </button>
+        </div>
+    </div>
+</section>
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.scss b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.spec.ts b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.spec.ts
new file mode 100644
index 000000000..77a9c51c8
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.spec.ts
@@ -0,0 +1,23 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { CreateDefinitionComponent } from './create-definition.component';
+import { commonTestBed } from '../../common-test-bed';
+
+describe('CreateDefinitionComponent', () => {
+    let component: CreateDefinitionComponent;
+    let fixture: ComponentFixture<CreateDefinitionComponent>;
+
+    beforeEach(waitForAsync(() => {
+        commonTestBed().testingModule.compileComponents();
+    }));
+
+    beforeEach(() => {
+        fixture = TestBed.createComponent(CreateDefinitionComponent);
+        component = fixture.componentInstance;
+        fixture.detectChanges();
+    });
+
+    it('should create', () => {
+        expect(component).toBeTruthy();
+    });
+});
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
new file mode 100644
index 000000000..d4ea3bac0
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
@@ -0,0 +1,18 @@
+import { Component, OnInit } from '@angular/core';
+import { actionIcons } from '../../shared/icons';
+
+@Component({
+    selector: 'ia-create-definition',
+    templateUrl: './create-definition.component.html',
+    styleUrls: ['./create-definition.component.scss']
+})
+export class CreateDefinitionComponent implements OnInit {
+
+    actionIcons = actionIcons;
+
+    constructor() { }
+
+    ngOnInit(): void {
+    }
+
+}
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index c932d2ae9..513ef27c1 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -3,12 +3,12 @@
         <h1 class="title">Corpus definitions</h1>
 
         <div class="block">
-            <button class="button is-primary">
+            <a class="button is-primary" [routerLink]="['new']">
                 <span class="icon" aria-hidden="true">
                     <fa-icon [icon]="actionIcons.add"></fa-icon>
                 </span>
                 <span>Create a new corpus</span>
-            </button>
+            </a>
         </div>
 
         <div class="block" *ngIf="definitions$ | async as definitions">
@@ -23,17 +23,12 @@ <h1 class="title">Corpus definitions</h1>
                     <tr *ngFor="let definition of definitions">
                         <td>{{definition.meta.title}}</td>
                         <td>
-                            <button class="button">
-                                <span class="icon" aria-label="browse">
-                                    <fa-icon [icon]="actionIcons.search"></fa-icon>
-                                </span>
-                            </button>
-                            &nbsp;
-                            <button class="button">
+                            <a class="button"
+                                [routerLink]="[definition.id]">
                                 <span class="icon" aria-label="edit">
                                     <fa-icon [icon]="actionIcons.edit"></fa-icon>
                                 </span>
-                            </button>
+                            </a>
                             &nbsp;
                             <button class="button">
                                 <span class="icon" aria-label="delete">
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
index 736a0188b..78ce3de84 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
@@ -10,6 +10,7 @@ describe('DefinitionsOverviewComponent', () => {
     beforeEach(waitForAsync(() => {
         commonTestBed().testingModule.compileComponents();
     }));
+
     beforeEach(() => {
         fixture = TestBed.createComponent(DefinitionsOverviewComponent);
         component = fixture.componentInstance;
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
index f5b4556ed..95db44635 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -1,8 +1,9 @@
 import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
-import { ApiService } from '../../services';
+import { ApiService} from '../../services';
 import { Observable } from 'rxjs';
 import { APICorpusDefinition } from '../../models/corpus-definition';
+import * as _ from 'lodash';
 
 @Component({
     selector: 'ia-definitions-overview',
diff --git a/frontend/src/app/shared/icons.ts b/frontend/src/app/shared/icons.ts
index f90ea0e55..daefdf6bf 100644
--- a/frontend/src/app/shared/icons.ts
+++ b/frontend/src/app/shared/icons.ts
@@ -9,7 +9,7 @@ import {
     faDownload, faEdit, faEnvelope, faEye, faFilter, faHistory, faImage, faInfo, faInfoCircle, faLink, faList, faLock,
     faMinus, faPalette, faPencil, faPlus, faQuestionCircle, faSearch, faSearchMinus, faSearchPlus, faSignOut,
     faSortAlphaAsc, faSortAlphaDesc, faSortNumericAsc, faSortNumericDesc, faSquare,
-    faTable, faTags, faTimes, faTrashCan, faUndo, faUser
+    faTable, faTags, faTimes, faTrashCan, faUndo, faUpload, faUser
 } from '@fortawesome/free-solid-svg-icons';
 
 type IconDefinition = SolidIconDefinition | RegularIconDefinition;
@@ -40,6 +40,7 @@ export const actionIcons: Icons = {
     help: faInfoCircle,
     helpAlt: faQuestionCircle,
     download: faDownload,
+    upload: faUpload,
     config: faCog,
     email: faEnvelope,
     more: faPlus,

From d2a9f3fff979a311e78b4eaa7024eded62457fd6 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 11:37:44 +0200
Subject: [PATCH 23/91] draft edit corpus component

---
 frontend/src/app/app.module.ts                |  5 ++++
 .../corpus-definitions.module.ts              |  3 +++
 .../definitions-overview.component.html       |  2 +-
 .../edit-definition.component.html            | 26 +++++++++++++++++++
 .../edit-definition.component.scss            |  0
 .../edit-definition.component.spec.ts         | 23 ++++++++++++++++
 .../edit-definition.component.ts              | 18 +++++++++++++
 7 files changed, 76 insertions(+), 1 deletion(-)
 create mode 100644 frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
 create mode 100644 frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.scss
 create mode 100644 frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.spec.ts
 create mode 100644 frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts

diff --git a/frontend/src/app/app.module.ts b/frontend/src/app/app.module.ts
index 88106ffbe..b43680e90 100644
--- a/frontend/src/app/app.module.ts
+++ b/frontend/src/app/app.module.ts
@@ -53,6 +53,7 @@ import { TagOverviewComponent } from './tag/tag-overview/tag-overview.component'
 import { DefinitionsOverviewComponent } from './corpus-definitions/definitions-overview/definitions-overview.component';
 import { CorpusDefinitionsModule } from './corpus-definitions/corpus-definitions.module';
 import { CreateDefinitionComponent } from './corpus-definitions/create-definition/create-definition.component';
+import { EditDefinitionComponent } from './corpus-definitions/edit-definition/edit-definition.component';
 
 export const appRoutes: Routes = [
     {
@@ -143,6 +144,10 @@ export const appRoutes: Routes = [
                 path: 'new',
                 component: CreateDefinitionComponent,
             },
+            {
+                path: 'edit/:corpusID',
+                component: EditDefinitionComponent,
+            },
             {
                 path: '',
                 component: DefinitionsOverviewComponent,
diff --git a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
index 78a617655..303c811e0 100644
--- a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
+++ b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
@@ -2,6 +2,7 @@ import { NgModule } from '@angular/core';
 import { DefinitionsOverviewComponent } from './definitions-overview/definitions-overview.component';
 import { SharedModule } from '../shared/shared.module';
 import { CreateDefinitionComponent } from './create-definition/create-definition.component';
+import { EditDefinitionComponent } from './edit-definition/edit-definition.component';
 
 
 
@@ -9,10 +10,12 @@ import { CreateDefinitionComponent } from './create-definition/create-definition
     declarations: [
         CreateDefinitionComponent,
         DefinitionsOverviewComponent,
+        EditDefinitionComponent,
     ],
     exports: [
         CreateDefinitionComponent,
         DefinitionsOverviewComponent,
+        EditDefinitionComponent,
     ],
     imports: [
         SharedModule
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index 513ef27c1..b593aac20 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -24,7 +24,7 @@ <h1 class="title">Corpus definitions</h1>
                         <td>{{definition.meta.title}}</td>
                         <td>
                             <a class="button"
-                                [routerLink]="[definition.id]">
+                                [routerLink]="['edit', definition.id]">
                                 <span class="icon" aria-label="edit">
                                     <fa-icon [icon]="actionIcons.edit"></fa-icon>
                                 </span>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
new file mode 100644
index 000000000..caf98db32
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -0,0 +1,26 @@
+<section class="section">
+    <div class="container">
+        <h1 class="title">Edit corpus</h1>
+
+        <p class="block">
+            You can download this corpus definition as a JSON file, or upload a JSON
+            file to update it.
+        </p>
+
+        <div class="block">
+            <button class="button">
+                <span class="icon" aria-hidden="true">
+                    <fa-icon [icon]="actionIcons.download"></fa-icon>
+                </span>
+                <span>Download JSON</span>
+            </button>
+            &nbsp;
+            <button class="button">
+                <span class="icon" aria-hidden="true">
+                    <fa-icon [icon]="actionIcons.upload"></fa-icon>
+                </span>
+                <span>Upload JSON</span>
+            </button>
+        </div>
+    </div>
+</section>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.scss b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.spec.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.spec.ts
new file mode 100644
index 000000000..42a4f7838
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.spec.ts
@@ -0,0 +1,23 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { EditDefinitionComponent } from './edit-definition.component';
+import { commonTestBed } from '../../common-test-bed';
+
+describe('EditDefinitionComponent', () => {
+    let component: EditDefinitionComponent;
+    let fixture: ComponentFixture<EditDefinitionComponent>;
+
+    beforeEach(waitForAsync(() => {
+        commonTestBed().testingModule.compileComponents();
+    }));
+
+    beforeEach(() => {
+        fixture = TestBed.createComponent(EditDefinitionComponent);
+        component = fixture.componentInstance;
+        fixture.detectChanges();
+    });
+
+    it('should create', () => {
+        expect(component).toBeTruthy();
+    });
+});
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
new file mode 100644
index 000000000..3221df79f
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -0,0 +1,18 @@
+import { Component, OnInit } from '@angular/core';
+import { actionIcons } from '../../shared/icons';
+
+@Component({
+    selector: 'ia-edit-definition',
+    templateUrl: './edit-definition.component.html',
+    styleUrls: ['./edit-definition.component.scss']
+})
+export class EditDefinitionComponent implements OnInit {
+
+    actionIcons = actionIcons;
+
+    constructor() { }
+
+    ngOnInit(): void {
+    }
+
+}

From 63ca156dab2ba717763dd5f05f69a8c50d24d648 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 11:44:45 +0200
Subject: [PATCH 24/91] add breadcrumbs

---
 .../create-definition/create-definition.component.html    | 8 ++++++++
 .../definitions-overview.component.html                   | 7 +++++++
 .../edit-definition/edit-definition.component.html        | 8 ++++++++
 3 files changed, 23 insertions(+)

diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
index 8034cc2bd..375899335 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
@@ -1,5 +1,13 @@
 <section class="section">
     <div class="container">
+        <nav aria-label="secondary navigation" class="breadcrumb">
+            <ul>
+                <li><a [routerLink]="['/']">Corpora</a></li>
+                <li><a [routerLink]="['..']">Definitions</a></li>
+                <li class="is-active" aria-current="page"><a>New corpus</a></li>
+            </ul>
+        </nav>
+
         <h1 class="title">New corpus</h1>
 
         <p class="block">
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index b593aac20..79cd9ecec 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -1,5 +1,12 @@
 <div class="section">
     <div class="container">
+        <nav aria-label="secondary navigation" class="breadcrumb">
+            <ul>
+                <li><a [routerLink]="['/']">Corpora</a></li>
+                <li class="is-active" aria-current="page"><a>Definitions</a></li>
+            </ul>
+        </nav>
+
         <h1 class="title">Corpus definitions</h1>
 
         <div class="block">
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index caf98db32..4c20561f1 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -1,5 +1,13 @@
 <section class="section">
     <div class="container">
+        <nav aria-label="secondary navigation" class="breadcrumb">
+            <ul>
+                <li><a [routerLink]="['/']">Corpora</a></li>
+                <li><a [routerLink]="['..']">Definitions</a></li>
+                <li class="is-active" aria-current="page"><a>Edit</a></li>
+            </ul>
+        </nav>
+
         <h1 class="title">Edit corpus</h1>
 
         <p class="block">

From c9a634039eeda40a196451f1a82ce0199d3954c4 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 11:53:45 +0200
Subject: [PATCH 25/91] use router state in edit definition component

---
 .../edit-definition.component.html            |  8 +++---
 .../edit-definition.component.ts              | 26 ++++++++++++++++---
 2 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 4c20561f1..51ab7189e 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -1,14 +1,14 @@
 <section class="section">
-    <div class="container">
+    <div class="container" *ngIf="definition$ | async as definition">
         <nav aria-label="secondary navigation" class="breadcrumb">
             <ul>
                 <li><a [routerLink]="['/']">Corpora</a></li>
-                <li><a [routerLink]="['..']">Definitions</a></li>
-                <li class="is-active" aria-current="page"><a>Edit</a></li>
+                <li><a [routerLink]="['../..']">Definitions</a></li>
+                <li class="is-active" aria-current="page"><a>{{definition.meta.title}}</a></li>
             </ul>
         </nav>
 
-        <h1 class="title">Edit corpus</h1>
+        <h1 class="title">Edit corpus "{{definition.meta.title}}"</h1>
 
         <p class="block">
             You can download this corpus definition as a JSON file, or upload a JSON
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 3221df79f..888696dad 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -1,18 +1,36 @@
-import { Component, OnInit } from '@angular/core';
+import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
+import { Observable, combineLatest } from 'rxjs';
+import { APICorpusDefinition } from '../../models/corpus-definition';
+import { ApiService } from '../../services';
+import { ActivatedRoute } from '@angular/router';
+import { map, tap } from 'rxjs/operators';
 
 @Component({
     selector: 'ia-edit-definition',
     templateUrl: './edit-definition.component.html',
     styleUrls: ['./edit-definition.component.scss']
 })
-export class EditDefinitionComponent implements OnInit {
+export class EditDefinitionComponent {
 
     actionIcons = actionIcons;
 
-    constructor() { }
+    definition$: Observable<APICorpusDefinition>;
 
-    ngOnInit(): void {
+    constructor(
+        private apiService: ApiService,
+        private route: ActivatedRoute
+    ) {
+        const corpusID$ = this.route.params.pipe(
+            map(params => parseInt(params['corpusID'], 10))
+        );
+        this.definition$ = combineLatest([
+            this.apiService.corpusDefinitions(),
+            corpusID$,
+        ]).pipe(
+            tap(values => console.log(values)),
+            map(([definitions, id]) => definitions.find(def => def.id === id))
+        );
     }
 
 }

From 9855b77091e6d3667ea783deccb72d11e74f10d6 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 12:01:36 +0200
Subject: [PATCH 26/91] include search link in overview

---
 .../definitions-overview.component.html               | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index 79cd9ecec..34936ea70 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -10,7 +10,7 @@
         <h1 class="title">Corpus definitions</h1>
 
         <div class="block">
-            <a class="button is-primary" [routerLink]="['new']">
+            <a class="button" [routerLink]="['new']">
                 <span class="icon" aria-hidden="true">
                     <fa-icon [icon]="actionIcons.add"></fa-icon>
                 </span>
@@ -30,6 +30,13 @@ <h1 class="title">Corpus definitions</h1>
                     <tr *ngFor="let definition of definitions">
                         <td>{{definition.meta.title}}</td>
                         <td>
+                            <a class="button"
+                                [routerLink]="['/search', definition.name]">
+                                <span class="icon" aria-label="edit">
+                                    <fa-icon [icon]="actionIcons.search"></fa-icon>
+                                </span>
+                            </a>
+                            &nbsp;
                             <a class="button"
                                 [routerLink]="['edit', definition.id]">
                                 <span class="icon" aria-label="edit">
@@ -37,7 +44,7 @@ <h1 class="title">Corpus definitions</h1>
                                 </span>
                             </a>
                             &nbsp;
-                            <button class="button">
+                            <button class="button" disabled>
                                 <span class="icon" aria-label="delete">
                                     <fa-icon [icon]="actionIcons.delete"></fa-icon>
                                 </span>

From d623079d147b62aa382dfbfdd1f5e1521b6235f4 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 13:50:54 +0200
Subject: [PATCH 27/91] update tests

---
 .../json_corpora/tests/test_export.py         |  6 ++--
 .../json_corpora/tests/test_import.py         | 35 +++++++++++++------
 backend/addcorpus/tests/test_corpus_views.py  |  2 +-
 3 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/backend/addcorpus/json_corpora/tests/test_export.py b/backend/addcorpus/json_corpora/tests/test_export.py
index b1ee9f691..03cf36558 100644
--- a/backend/addcorpus/json_corpora/tests/test_export.py
+++ b/backend/addcorpus/json_corpora/tests/test_export.py
@@ -4,8 +4,10 @@
 
 def test_corpus_export(json_mock_corpus: Corpus, json_corpus_data):
     result = export_json_corpus(json_mock_corpus)
-    result.pop('id')
-    assert result == json_corpus_data
+    assert 'id' in result
+    assert 'active' in result
+    definition = result.get('definition')
+    assert definition == json_corpus_data
 
 def test_field_export(any_field_json):
     imported = _parse_field(any_field_json)
diff --git a/backend/addcorpus/json_corpora/tests/test_import.py b/backend/addcorpus/json_corpora/tests/test_import.py
index b620ea749..570b9facd 100644
--- a/backend/addcorpus/json_corpora/tests/test_import.py
+++ b/backend/addcorpus/json_corpora/tests/test_import.py
@@ -4,10 +4,15 @@
 from addcorpus.serializers import CorpusJSONDefinitionSerializer
 from addcorpus.models import Corpus, CorpusConfiguration
 
-def test_json_corpus_import(db, json_corpus_data):
-    Corpus.objects.all().delete()
+def test_json_corpus_import(db, json_mock_corpus, json_corpus_data):
+    json_mock_corpus.delete()
 
-    serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
+    data = {
+        'definition': json_corpus_data,
+        'active': True,
+    }
+
+    serializer = CorpusJSONDefinitionSerializer(data=data)
     assert serializer.is_valid()
     corpus = serializer.create(serializer.validated_data)
 
@@ -35,21 +40,29 @@ def test_json_corpus_import(db, json_corpus_data):
     assert line_field.display_type == 'text_content'
 
 
-def test_serializer_representation(db, json_corpus_data):
-    Corpus.objects.all().delete()
+def test_serializer_representation(db, json_mock_corpus, json_corpus_data):
+    json_mock_corpus.delete()
 
-    serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
+    data = {
+        'definition': json_corpus_data,
+        'active': True,
+    }
+
+    serializer = CorpusJSONDefinitionSerializer(data=data)
     assert serializer.is_valid()
     corpus = serializer.create(serializer.validated_data)
 
     serialized = serializer.to_representation(corpus)
-    serialized.pop('id')
-    assert json_corpus_data == serialized
+    assert json_corpus_data == serialized['definition']
 
 def test_serializer_update(db, json_corpus_data, json_mock_corpus: Corpus):
     # edit description
-    json_corpus_data['meta']['description'] = 'A different description'
-    serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
+    data = {
+        'definition': json_corpus_data,
+        'active': True,
+    }
+    data['definition']['meta']['description'] = 'A different description'
+    serializer = CorpusJSONDefinitionSerializer(data=data)
     assert serializer.is_valid()
     serializer.update(json_mock_corpus, serializer.validated_data)
     corpus_config = CorpusConfiguration.objects.get(corpus=json_mock_corpus)
@@ -57,7 +70,7 @@ def test_serializer_update(db, json_corpus_data, json_mock_corpus: Corpus):
 
     # remove a field
     assert Field.objects.filter(corpus_configuration__corpus=json_mock_corpus).count() == 2
-    json_corpus_data['fields'] = json_corpus_data['fields'][:-1]
+    data['definition']['fields'] = data['definition']['fields'][:-1]
     serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
     assert serializer.is_valid()
     serializer.update(json_mock_corpus, serializer.validated_data)
diff --git a/backend/addcorpus/tests/test_corpus_views.py b/backend/addcorpus/tests/test_corpus_views.py
index 9e1c3fc99..ec28e1608 100644
--- a/backend/addcorpus/tests/test_corpus_views.py
+++ b/backend/addcorpus/tests/test_corpus_views.py
@@ -93,7 +93,7 @@ def test_corpus_edit_views(admin_client: Client, json_corpus_data: Dict, json_mo
 
     response = admin_client.post(
         '/api/corpus/definitions/',
-        json_corpus_data,
+        {'definition': json_corpus_data, 'active': True},
         content_type='application/json',
     )
     assert status.is_success(response.status_code)

From 0f967cfcbc1682ab8c515fa32324c06daf8f50dd Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 15:02:09 +0200
Subject: [PATCH 28/91] update API for corpus definitions

---
 backend/addcorpus/json_corpora/export_json.py |  2 +-
 .../json_corpora/tests/test_export.py         |  7 +---
 .../json_corpora/tests/test_import.py         | 16 ++++----
 .../json_corpora/tests/test_validate.py       |  8 ++--
 backend/addcorpus/serializers.py              | 40 ++++++++++++++-----
 backend/addcorpus/tests/test_corpus_views.py  |  5 ++-
 backend/conftest.py                           | 10 +++--
 7 files changed, 54 insertions(+), 34 deletions(-)

diff --git a/backend/addcorpus/json_corpora/export_json.py b/backend/addcorpus/json_corpora/export_json.py
index 6ba9c130a..5178590fc 100644
--- a/backend/addcorpus/json_corpora/export_json.py
+++ b/backend/addcorpus/json_corpora/export_json.py
@@ -6,7 +6,7 @@
 
 def export_json_corpus(corpus: Corpus) -> Dict:
     config = corpus.configuration
-    data = {'name': corpus.name, 'id': corpus.pk }
+    data = {'name': corpus.name}
     data['meta'] = export_corpus_meta(config)
     data['source_data'] = export_corpus_source_data(config)
     options = export_corpus_options(config)
diff --git a/backend/addcorpus/json_corpora/tests/test_export.py b/backend/addcorpus/json_corpora/tests/test_export.py
index 03cf36558..cee319467 100644
--- a/backend/addcorpus/json_corpora/tests/test_export.py
+++ b/backend/addcorpus/json_corpora/tests/test_export.py
@@ -2,12 +2,9 @@
 from addcorpus.models import Corpus, Field
 from addcorpus.json_corpora.import_json import _parse_field
 
-def test_corpus_export(json_mock_corpus: Corpus, json_corpus_data):
+def test_corpus_export(json_mock_corpus: Corpus, json_corpus_definition):
     result = export_json_corpus(json_mock_corpus)
-    assert 'id' in result
-    assert 'active' in result
-    definition = result.get('definition')
-    assert definition == json_corpus_data
+    assert result == json_corpus_definition
 
 def test_field_export(any_field_json):
     imported = _parse_field(any_field_json)
diff --git a/backend/addcorpus/json_corpora/tests/test_import.py b/backend/addcorpus/json_corpora/tests/test_import.py
index 570b9facd..6e165b19a 100644
--- a/backend/addcorpus/json_corpora/tests/test_import.py
+++ b/backend/addcorpus/json_corpora/tests/test_import.py
@@ -4,11 +4,11 @@
 from addcorpus.serializers import CorpusJSONDefinitionSerializer
 from addcorpus.models import Corpus, CorpusConfiguration
 
-def test_json_corpus_import(db, json_mock_corpus, json_corpus_data):
+def test_json_corpus_import(db, json_mock_corpus, json_corpus_definition):
     json_mock_corpus.delete()
 
     data = {
-        'definition': json_corpus_data,
+        'definition': json_corpus_definition,
         'active': True,
     }
 
@@ -40,11 +40,11 @@ def test_json_corpus_import(db, json_mock_corpus, json_corpus_data):
     assert line_field.display_type == 'text_content'
 
 
-def test_serializer_representation(db, json_mock_corpus, json_corpus_data):
+def test_serializer_representation(db, json_mock_corpus, json_corpus_definition):
     json_mock_corpus.delete()
 
     data = {
-        'definition': json_corpus_data,
+        'definition': json_corpus_definition,
         'active': True,
     }
 
@@ -53,12 +53,12 @@ def test_serializer_representation(db, json_mock_corpus, json_corpus_data):
     corpus = serializer.create(serializer.validated_data)
 
     serialized = serializer.to_representation(corpus)
-    assert json_corpus_data == serialized['definition']
+    assert json_corpus_definition == serialized['definition']
 
-def test_serializer_update(db, json_corpus_data, json_mock_corpus: Corpus):
+def test_serializer_update(db, json_corpus_definition, json_mock_corpus: Corpus):
     # edit description
     data = {
-        'definition': json_corpus_data,
+        'definition': json_corpus_definition,
         'active': True,
     }
     data['definition']['meta']['description'] = 'A different description'
@@ -71,7 +71,7 @@ def test_serializer_update(db, json_corpus_data, json_mock_corpus: Corpus):
     # remove a field
     assert Field.objects.filter(corpus_configuration__corpus=json_mock_corpus).count() == 2
     data['definition']['fields'] = data['definition']['fields'][:-1]
-    serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
+    serializer = CorpusJSONDefinitionSerializer(data=data)
     assert serializer.is_valid()
     serializer.update(json_mock_corpus, serializer.validated_data)
     assert Field.objects.filter(corpus_configuration__corpus=json_mock_corpus).count() == 1
diff --git a/backend/addcorpus/json_corpora/tests/test_validate.py b/backend/addcorpus/json_corpora/tests/test_validate.py
index 18ad89011..068c1af29 100644
--- a/backend/addcorpus/json_corpora/tests/test_validate.py
+++ b/backend/addcorpus/json_corpora/tests/test_validate.py
@@ -1,10 +1,10 @@
 from addcorpus.json_corpora.validate import validate
 
 
-def test_validate(json_corpus_data):
-    validate(json_corpus_data)
+def test_validate(json_corpus_definition):
+    validate(json_corpus_definition)
 
 
-def test_validate_subschema(json_corpus_data):
-    source_data = json_corpus_data['source_data']
+def test_validate_subschema(json_corpus_definition):
+    source_data = json_corpus_definition['source_data']
     validate(source_data, 'properties', 'source_data')
diff --git a/backend/addcorpus/serializers.py b/backend/addcorpus/serializers.py
index d6fb31db9..b124cd735 100644
--- a/backend/addcorpus/serializers.py
+++ b/backend/addcorpus/serializers.py
@@ -128,33 +128,47 @@ class Meta:
         fields = ['corpus_configuration', 'type', 'content']
 
 
-class CorpusJSONDefinitionSerializer(serializers.ModelSerializer):
-    class Meta:
-        model = Corpus
-        fields = '__all__'
+class JSONDefinitionField(serializers.Field):
+    def get_attribute(self, instance: Corpus):
+        return instance
 
-    def to_representation(self, instance) -> Dict:
-        return export_json_corpus(instance)
+    def to_representation(self, value: Corpus) -> Dict:
+        return export_json_corpus(value)
 
-    def to_internal_value(self, data) -> Dict:
+    def to_internal_value(self, data: Dict) -> Dict:
         return import_json_corpus(data)
 
+
+class CorpusJSONDefinitionSerializer(serializers.ModelSerializer):
+    definition = JSONDefinitionField()
+
+    class Meta:
+        model = Corpus
+        fields = ['id', 'active', 'definition']
+        read_only_fields = ['id']
+
     def create(self, validated_data: Dict):
-        configuration_data = validated_data.pop('configuration')
+        definition_data = validated_data.get('definition')
+        configuration_data = definition_data.pop('configuration')
         fields_data = configuration_data.pop('fields')
 
-        corpus = Corpus.objects.create(**validated_data)
+        corpus = Corpus.objects.create(**definition_data)
         configuration = CorpusConfiguration.objects.create(corpus=corpus, **configuration_data)
         for field_data in fields_data:
             Field.objects.create(corpus_configuration=configuration, **field_data)
 
+        if validated_data.get('active') == True:
+            corpus.active = True
+            corpus.save()
+
         return corpus
 
     def update(self, instance: Corpus, validated_data: Dict):
-        configuration_data = validated_data.pop('configuration')
+        definition_data = validated_data.get('definition')
+        configuration_data = definition_data.pop('configuration')
         fields_data = configuration_data.pop('fields')
 
-        corpus = Corpus(pk=instance.pk, **validated_data)
+        corpus = Corpus(pk=instance.pk, **definition_data)
         corpus.save()
 
         configuration, _ = CorpusConfiguration.objects.get_or_create(corpus=corpus)
@@ -172,4 +186,8 @@ def update(self, instance: Corpus, validated_data: Dict):
 
         configuration.fields.exclude(name__in=(f['name'] for f in fields_data)).delete()
 
+        if validated_data.get('active') == True:
+            corpus.active = True
+            corpus.save()
+
         return corpus
diff --git a/backend/addcorpus/tests/test_corpus_views.py b/backend/addcorpus/tests/test_corpus_views.py
index ec28e1608..8fd15290c 100644
--- a/backend/addcorpus/tests/test_corpus_views.py
+++ b/backend/addcorpus/tests/test_corpus_views.py
@@ -7,6 +7,7 @@
 from addcorpus.python_corpora.save_corpus import load_and_save_all_corpora
 
 def test_no_corpora(db, settings, admin_client):
+    Corpus.objects.all().delete()
     settings.CORPORA = {}
     load_and_save_all_corpora()
 
@@ -84,7 +85,7 @@ def test_corpus_not_publication_ready(admin_client, basic_mock_corpus):
     response = admin_client.get('/api/corpus/')
     corpus = not any(c['name'] == basic_mock_corpus for c in response.data)
 
-def test_corpus_edit_views(admin_client: Client, json_corpus_data: Dict, json_mock_corpus: Corpus):
+def test_corpus_edit_views(admin_client: Client, json_corpus_definition: Dict, json_mock_corpus: Corpus):
     json_mock_corpus.delete()
 
     response = admin_client.get('/api/corpus/definitions/')
@@ -93,7 +94,7 @@ def test_corpus_edit_views(admin_client: Client, json_corpus_data: Dict, json_mo
 
     response = admin_client.post(
         '/api/corpus/definitions/',
-        {'definition': json_corpus_data, 'active': True},
+        {'definition': json_corpus_definition, 'active': True},
         content_type='application/json',
     )
     assert status.is_success(response.status_code)
diff --git a/backend/conftest.py b/backend/conftest.py
index 2e76c7939..0e5914319 100644
--- a/backend/conftest.py
+++ b/backend/conftest.py
@@ -197,16 +197,20 @@ def add_mock_python_corpora_to_db(db, media_dir):
 
 
 @pytest.fixture()
-def json_corpus_data():
+def json_corpus_definition():
     path = os.path.join(settings.BASE_DIR, 'corpora_test', 'basic', 'mock_corpus.json')
     with open(path) as f:
         return json.load(f)
 
 
 @pytest.fixture(autouse=True)
-def json_mock_corpus(db, json_corpus_data) -> Corpus:
+def json_mock_corpus(db, json_corpus_definition) -> Corpus:
     # add json mock corpora to the database at the start of each test
-    serializer = CorpusJSONDefinitionSerializer(data=json_corpus_data)
+    data = {
+        'definition': json_corpus_definition,
+        'active': True,
+    }
+    serializer = CorpusJSONDefinitionSerializer(data=data)
     assert serializer.is_valid()
     corpus = serializer.create(serializer.validated_data)
 

From 55d6b6f514865d626c29c1faf56bf14352a93f31 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 15:13:37 +0200
Subject: [PATCH 29/91] update frontend to new API

---
 .../definitions-overview.component.html       | 11 +++++-----
 .../definitions-overview.component.ts         |  6 +++---
 .../edit-definition.component.html            |  6 +++---
 .../edit-definition.component.ts              | 18 ++++++-----------
 frontend/src/app/models/corpus-definition.ts  |  7 ++++++-
 frontend/src/app/services/api.service.ts      | 20 +++++++++++--------
 6 files changed, 36 insertions(+), 32 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index 34936ea70..8237c26aa 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -18,7 +18,7 @@ <h1 class="title">Corpus definitions</h1>
             </a>
         </div>
 
-        <div class="block" *ngIf="definitions$ | async as definitions">
+        <div class="block" *ngIf="corpora$ | async as corpora">
             <table class="table is-fullwidth">
                 <thead>
                     <tr>
@@ -27,18 +27,19 @@ <h1 class="title">Corpus definitions</h1>
                     </tr>
                 </thead>
                 <tbody>
-                    <tr *ngFor="let definition of definitions">
-                        <td>{{definition.meta.title}}</td>
+                    <tr *ngFor="let corpus of corpora">
+                        <td>{{corpus.definition.meta.title}}</td>
                         <td>
                             <a class="button"
-                                [routerLink]="['/search', definition.name]">
+                                [routerLink]="['/search', corpus.definition.name]"
+                                [attr.disabled]="!corpus.active">
                                 <span class="icon" aria-label="edit">
                                     <fa-icon [icon]="actionIcons.search"></fa-icon>
                                 </span>
                             </a>
                             &nbsp;
                             <a class="button"
-                                [routerLink]="['edit', definition.id]">
+                                [routerLink]="['edit', corpus.id]">
                                 <span class="icon" aria-label="edit">
                                     <fa-icon [icon]="actionIcons.edit"></fa-icon>
                                 </span>
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
index 95db44635..082e6f395 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -2,7 +2,7 @@ import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
 import { ApiService} from '../../services';
 import { Observable } from 'rxjs';
-import { APICorpusDefinition } from '../../models/corpus-definition';
+import { APIEditableCorpus } from '../../models/corpus-definition';
 import * as _ from 'lodash';
 
 @Component({
@@ -13,9 +13,9 @@ import * as _ from 'lodash';
 export class DefinitionsOverviewComponent {
     actionIcons = actionIcons;
 
-    definitions$: Observable<APICorpusDefinition[]>;
+    corpora$: Observable<APIEditableCorpus[]>;
 
     constructor(private apiService: ApiService) {
-        this.definitions$ = this.apiService.corpusDefinitions();
+        this.corpora$ = this.apiService.corpusDefinitions();
     }
 }
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 51ab7189e..fbfc6ed14 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -1,14 +1,14 @@
 <section class="section">
-    <div class="container" *ngIf="definition$ | async as definition">
+    <div class="container" *ngIf="corpus$ | async as corpus">
         <nav aria-label="secondary navigation" class="breadcrumb">
             <ul>
                 <li><a [routerLink]="['/']">Corpora</a></li>
                 <li><a [routerLink]="['../..']">Definitions</a></li>
-                <li class="is-active" aria-current="page"><a>{{definition.meta.title}}</a></li>
+                <li class="is-active" aria-current="page"><a>{{corpus.definition.meta.title}}</a></li>
             </ul>
         </nav>
 
-        <h1 class="title">Edit corpus "{{definition.meta.title}}"</h1>
+        <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
 
         <p class="block">
             You can download this corpus definition as a JSON file, or upload a JSON
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 888696dad..72d105778 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -1,10 +1,10 @@
 import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
 import { Observable, combineLatest } from 'rxjs';
-import { APICorpusDefinition } from '../../models/corpus-definition';
+import { APIEditableCorpus } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
-import { map, tap } from 'rxjs/operators';
+import { map, switchMap, tap } from 'rxjs/operators';
 
 @Component({
     selector: 'ia-edit-definition',
@@ -15,21 +15,15 @@ export class EditDefinitionComponent {
 
     actionIcons = actionIcons;
 
-    definition$: Observable<APICorpusDefinition>;
+    corpus$: Observable<APIEditableCorpus>;
 
     constructor(
         private apiService: ApiService,
         private route: ActivatedRoute
     ) {
-        const corpusID$ = this.route.params.pipe(
-            map(params => parseInt(params['corpusID'], 10))
-        );
-        this.definition$ = combineLatest([
-            this.apiService.corpusDefinitions(),
-            corpusID$,
-        ]).pipe(
-            tap(values => console.log(values)),
-            map(([definitions, id]) => definitions.find(def => def.id === id))
+        this.corpus$ = this.route.params.pipe(
+            map(params => parseInt(params['corpusID'], 10)),
+            switchMap(id => this.apiService.corpusDefinition(id))
         );
     }
 
diff --git a/frontend/src/app/models/corpus-definition.ts b/frontend/src/app/models/corpus-definition.ts
index 6442ddf31..4f21d246e 100644
--- a/frontend/src/app/models/corpus-definition.ts
+++ b/frontend/src/app/models/corpus-definition.ts
@@ -19,7 +19,6 @@ export interface APICorpusField {
 
 export interface APICorpusDefinition {
     name: string;
-    id?: number;
     meta: {
         title: string;
         category: string;
@@ -53,3 +52,9 @@ export interface APICorpusDefinition {
         };
     };
 };
+
+export interface APIEditableCorpus {
+    id?: number;
+    active: boolean;
+    definition: APICorpusDefinition;
+};
diff --git a/frontend/src/app/services/api.service.ts b/frontend/src/app/services/api.service.ts
index cd197acbf..3ed181f5f 100644
--- a/frontend/src/app/services/api.service.ts
+++ b/frontend/src/app/services/api.service.ts
@@ -31,7 +31,7 @@ import {
 } from '../models/index';
 import { environment } from '../../environments/environment';
 import * as _ from 'lodash';
-import { APICorpusDefinition } from '../models/corpus-definition';
+import { APICorpusDefinition, APIEditableCorpus } from '../models/corpus-definition';
 
 interface SolisLoginResponse {
     success: boolean;
@@ -237,19 +237,23 @@ export class ApiService {
 
     // Corpus definitions
 
-    public corpusDefinitions() {
-        return this.http.get<APICorpusDefinition[]>('/api/corpus/definitions/');
+    public corpusDefinitions(): Observable<APIEditableCorpus[]> {
+        return this.http.get<APIEditableCorpus[]>('/api/corpus/definitions/');
     }
 
-    public createCorpus(data: APICorpusDefinition) {
-        return this.http.post<APICorpusDefinition>('/api/corpus/definitions/', data);
+    public corpusDefinition(corpusID: number): Observable<APIEditableCorpus> {
+        return this.http.get<APIEditableCorpus>(`/api/corpus/definitions/${corpusID}/`);
     }
 
-    public updateCorpus(corpusID: number, data: APICorpusDefinition) {
-        return this.http.put<APICorpusDefinition>(`/api/corpus/definitions/${corpusID}`, data);
+    public createCorpus(data: APIEditableCorpus): Observable<APIEditableCorpus> {
+        return this.http.post<APIEditableCorpus>('/api/corpus/definitions/', data);
     }
 
-    public deleteCorpus(corpusID: number) {
+    public updateCorpus(corpusID: number, data: APIEditableCorpus): Observable<APIEditableCorpus> {
+        return this.http.put<APIEditableCorpus>(`/api/corpus/definitions/${corpusID}/`, data);
+    }
+
+    public deleteCorpus(corpusID: number): Observable<any> {
         return this.http.delete(`/api/corpus/definitions/${corpusID}`);
     }
 

From 7ee40ef282bb37dcb6fe91bca0c06e589f70d2ff Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 15:21:13 +0200
Subject: [PATCH 30/91] implement JSON download

---
 .../edit-definition/edit-definition.component.html |  2 +-
 .../edit-definition/edit-definition.component.ts   | 14 +++++++++++---
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index fbfc6ed14..d61e4944a 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -16,7 +16,7 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
         </p>
 
         <div class="block">
-            <button class="button">
+            <button class="button" (click)="downloadJSON(corpus.definition)">
                 <span class="icon" aria-hidden="true">
                     <fa-icon [icon]="actionIcons.download"></fa-icon>
                 </span>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 72d105778..730cb2ac8 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -1,10 +1,11 @@
 import { Component } from '@angular/core';
 import { actionIcons } from '../../shared/icons';
-import { Observable, combineLatest } from 'rxjs';
-import { APIEditableCorpus } from '../../models/corpus-definition';
+import { Observable } from 'rxjs';
+import { APICorpusDefinition, APIEditableCorpus } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
-import { map, switchMap, tap } from 'rxjs/operators';
+import { map, switchMap } from 'rxjs/operators';
+
 
 @Component({
     selector: 'ia-edit-definition',
@@ -27,4 +28,11 @@ export class EditDefinitionComponent {
         );
     }
 
+    downloadJSON(definition: APICorpusDefinition) {
+        const content = JSON.stringify(definition);
+        const blob = new Blob([content], { type: `text/csv;charset=utf-8`, endings: 'native' });
+        const filename = definition.name + '.json';
+        saveAs(blob, filename);
+    }
+
 }

From c86c717aed0c2561a7054963f41bb7ce19016d3c Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 16:00:38 +0200
Subject: [PATCH 31/91] draft json upload

---
 .../edit-definition.component.html            |  53 +++++--
 .../edit-definition.component.ts              | 136 ++++++++++++++++--
 2 files changed, 168 insertions(+), 21 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index d61e4944a..01fa79b07 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -11,8 +11,7 @@
         <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
 
         <p class="block">
-            You can download this corpus definition as a JSON file, or upload a JSON
-            file to update it.
+            You can download this corpus definition as a JSON file.
         </p>
 
         <div class="block">
@@ -22,13 +21,49 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
                 </span>
                 <span>Download JSON</span>
             </button>
-            &nbsp;
-            <button class="button">
-                <span class="icon" aria-hidden="true">
-                    <fa-icon [icon]="actionIcons.upload"></fa-icon>
-                </span>
-                <span>Upload JSON</span>
-            </button>
         </div>
+
+        <p class="block">
+            You can update this corpus by uploading a new JSON definition for it.
+        </p>
+
+        <form class="block">
+            <div class="file block">
+                <label class="file-label">
+                    <input class="file-input" type="file" name="definition-upload"
+                        accept=".json,application/json"
+                        (input)="onJSONUpload($event)" />
+                    <span class="file-cta">
+                        <span class="file-icon" aria-hidden="true">
+                            <fa-icon [icon]="actionIcons.upload"></fa-icon>
+                        </span>
+                        <span class="file-label">Upload JSON...</span>
+                    </span>
+                    <span class="file-name" *ngIf="uploadFile$ | async as file">
+                        {{file.name}}
+                    </span>
+                </label>
+            </div>
+
+            <div class="block" *ngIf="corpusToSubmit$ | async">
+                <button class="button is-primary" type="submit" (click)="submit()">
+                    <span class="icon" aria-hidden="true">
+                        <fa-icon [icon]="formIcons.confirm"></fa-icon>
+                    </span>
+                    <span>
+                        Save changes
+                    </span>
+                </button>
+                &nbsp;
+                <button class="button" type="reset" (click)="reset()">
+                    <span class="icon" aria-hidden="true">
+                        <fa-icon [icon]="formIcons.reset"></fa-icon>
+                    </span>
+                    <span>
+                        Cancel changes
+                    </span>
+                </button>
+            </div>
+        </form>
     </div>
 </section>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 730cb2ac8..43da69a64 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -1,38 +1,150 @@
-import { Component } from '@angular/core';
-import { actionIcons } from '../../shared/icons';
-import { Observable } from 'rxjs';
+import { Component, Injectable } from '@angular/core';
+import { actionIcons, formIcons } from '../../shared/icons';
+import { BehaviorSubject, Observable, Subject, combineLatest, from, merge, of } from 'rxjs';
 import { APICorpusDefinition, APIEditableCorpus } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
-import { map, switchMap } from 'rxjs/operators';
+import {
+    catchError, filter, map, shareReplay, startWith, switchAll, switchMap, switchMapTo,
+    take, withLatestFrom
+} from 'rxjs/operators';
+import * as _ from 'lodash';
+
+
+@Injectable()
+class EditDefinitionService {
+    data$: Observable<APIEditableCorpus>;
+    error$ = new Subject<any>();
+    loading$: Observable<boolean>;
+
+    id$: Observable<number>;
+
+    private initialData$: Observable<APIEditableCorpus>;
+    private updatedData$: Observable<APIEditableCorpus>;
+
+    private updates$ = new Subject<APIEditableCorpus>();
+
+    constructor(private route: ActivatedRoute, private apiService: ApiService) {
+        this.id$ = this.route.params.pipe(
+            map(params => params['corpusID'])
+        );
+
+        this.initialData$ = this.id$.pipe(
+            switchMap(id => this.apiService.corpusDefinition(id).pipe(
+                shareReplay(1)
+            )),
+            catchError(err => {
+                this.error$.next(err);
+                return of(undefined);
+            }),
+        );
+
+        this.updatedData$ = combineLatest([this.id$, this.updates$]).pipe(
+            switchMap(([id, data]) => this.apiService.updateCorpus(id, data)),
+            catchError(err => {
+                this.error$.next(err);
+                return of(undefined);
+            }),
+            filter(_.negate(_.isUndefined)),
+        );
+
+        this.data$ = merge(this.initialData$, this.updatedData$);
+
+        this.loading$ = merge(
+            this.updates$.pipe(map(_.constant(true))),
+            this.data$.pipe(map(_.constant(false))),
+            this.error$.pipe(map(_.constant(false)))
+        ).pipe(
+            startWith(true)
+        );
+    }
+
+    update(data: APIEditableCorpus) {
+        this.updates$.next(data);
+    }
+}
 
 
 @Component({
     selector: 'ia-edit-definition',
     templateUrl: './edit-definition.component.html',
-    styleUrls: ['./edit-definition.component.scss']
+    styleUrls: ['./edit-definition.component.scss'],
+    providers: [EditDefinitionService],
 })
 export class EditDefinitionComponent {
-
     actionIcons = actionIcons;
+    formIcons = formIcons;
 
     corpus$: Observable<APIEditableCorpus>;
 
+    uploadFile$: BehaviorSubject<File|undefined> = new BehaviorSubject(undefined);
+    uploadData$: Subject<Observable<any>> = new Subject();
+
+    uploadError$: Subject<any> = new Subject();
+    uploadResult$: Observable<APIEditableCorpus>;
+
+    corpusToSubmit$: Observable<APIEditableCorpus|undefined>;
+
+    private submit$: Subject<void> = new Subject();
+    private reset$: Subject<void> = new Subject();
+
     constructor(
-        private apiService: ApiService,
-        private route: ActivatedRoute
+        private editDefinitionService: EditDefinitionService,
     ) {
-        this.corpus$ = this.route.params.pipe(
-            map(params => parseInt(params['corpusID'], 10)),
-            switchMap(id => this.apiService.corpusDefinition(id))
+        this.corpus$ = this.editDefinitionService.data$;
+
+        this.uploadResult$ = this.uploadData$.pipe(
+            switchAll(),
+            catchError(e => {
+                this.uploadError$.next(e);
+                return of(undefined);
+            }),
+            filter(_.negate(_.isUndefined)),
+            withLatestFrom(this.corpus$),
+            map(([data, corpus]) => this.mergeUploadedData(corpus, data))
+        );
+
+        this.corpusToSubmit$ = merge(
+            this.corpus$.pipe(map(_.constant(undefined))),
+            this.reset$,
+            this.uploadResult$
+        ).pipe(
+            shareReplay(1)
         );
+
+        this.submit$.pipe(
+            switchMapTo(this.corpusToSubmit$),
+            take(1),
+        ).subscribe(data => this.editDefinitionService.update(data));
     }
 
     downloadJSON(definition: APICorpusDefinition) {
-        const content = JSON.stringify(definition);
+        const content = JSON.stringify(definition, undefined, 4);
         const blob = new Blob([content], { type: `text/csv;charset=utf-8`, endings: 'native' });
         const filename = definition.name + '.json';
         saveAs(blob, filename);
     }
 
+    onJSONUpload(event: InputEvent) {
+        const files: File[] = event.target['files'];
+        const file = files ? _.first(files) : undefined;
+        this.uploadFile$.next(file);
+        const data$ = from(file.text().then(text =>JSON.parse(text)));
+        this.uploadData$.next(data$);
+    }
+
+    submit() {
+        this.submit$.next();
+        this.uploadFile$.next(undefined);
+    }
+
+    reset() {
+        this.reset$.next();
+        this.uploadFile$.next(undefined);
+    }
+
+    private mergeUploadedData(corpus: APIEditableCorpus, data: any): APIEditableCorpus {
+        _.set(corpus, 'definition', data);
+        return corpus;
+    }
 }

From 23d052d193ff2eb520e2aa7d64c339b970f5a1b2 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 18:46:46 +0200
Subject: [PATCH 32/91] show current state in edit component

---
 .../edit-definition/edit-definition.component.ts    | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 43da69a64..450a96481 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -91,8 +91,6 @@ export class EditDefinitionComponent {
     constructor(
         private editDefinitionService: EditDefinitionService,
     ) {
-        this.corpus$ = this.editDefinitionService.data$;
-
         this.uploadResult$ = this.uploadData$.pipe(
             switchAll(),
             catchError(e => {
@@ -100,18 +98,23 @@ export class EditDefinitionComponent {
                 return of(undefined);
             }),
             filter(_.negate(_.isUndefined)),
-            withLatestFrom(this.corpus$),
+            withLatestFrom(this.editDefinitionService.data$),
             map(([data, corpus]) => this.mergeUploadedData(corpus, data))
         );
 
         this.corpusToSubmit$ = merge(
-            this.corpus$.pipe(map(_.constant(undefined))),
+            this.editDefinitionService.data$.pipe(map(_.constant(undefined))),
             this.reset$,
             this.uploadResult$
         ).pipe(
             shareReplay(1)
         );
 
+        this.corpus$ = merge(
+            this.editDefinitionService.data$,
+            this.corpusToSubmit$.pipe(filter(_.negate(_.isUndefined))),
+        );
+
         this.submit$.pipe(
             switchMapTo(this.corpusToSubmit$),
             take(1),
@@ -129,7 +132,7 @@ export class EditDefinitionComponent {
         const files: File[] = event.target['files'];
         const file = files ? _.first(files) : undefined;
         this.uploadFile$.next(file);
-        const data$ = from(file.text().then(text =>JSON.parse(text)));
+        const data$ = from(file.text().then(text => JSON.parse(text)));
         this.uploadData$.next(data$);
     }
 

From 3359a62b06ae84922694bcf80e989ae34944c805 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 16 May 2024 19:28:16 +0200
Subject: [PATCH 33/91] extract json upload component

---
 .../corpus-definitions.module.ts              |  2 +
 .../definition-json-upload.component.html     | 25 +++++++
 .../definition-json-upload.component.scss     |  0
 .../definition-json-upload.component.spec.ts  | 25 +++++++
 .../definition-json-upload.component.ts       | 66 +++++++++++++++++++
 .../edit-definition.component.html            | 21 ++----
 .../edit-definition.component.ts              | 26 ++------
 7 files changed, 128 insertions(+), 37 deletions(-)
 create mode 100644 frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.html
 create mode 100644 frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.scss
 create mode 100644 frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.spec.ts
 create mode 100644 frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts

diff --git a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
index 303c811e0..9bfd7a334 100644
--- a/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
+++ b/frontend/src/app/corpus-definitions/corpus-definitions.module.ts
@@ -3,6 +3,7 @@ import { DefinitionsOverviewComponent } from './definitions-overview/definitions
 import { SharedModule } from '../shared/shared.module';
 import { CreateDefinitionComponent } from './create-definition/create-definition.component';
 import { EditDefinitionComponent } from './edit-definition/edit-definition.component';
+import { DefinitionJsonUploadComponent } from './definition-json-upload/definition-json-upload.component';
 
 
 
@@ -11,6 +12,7 @@ import { EditDefinitionComponent } from './edit-definition/edit-definition.compo
         CreateDefinitionComponent,
         DefinitionsOverviewComponent,
         EditDefinitionComponent,
+        DefinitionJsonUploadComponent,
     ],
     exports: [
         CreateDefinitionComponent,
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.html b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.html
new file mode 100644
index 000000000..b41f5b177
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.html
@@ -0,0 +1,25 @@
+<div class="file block">
+    <label class="file-label">
+        <input class="file-input" type="file" name="definition-upload"
+            accept=".json,application/json"
+            (input)="onJSONUpload($event)" />
+        <span class="file-cta">
+            <span class="file-icon" aria-hidden="true">
+                <fa-icon [icon]="actionIcons.upload"></fa-icon>
+            </span>
+            <span class="file-label">Upload JSON...</span>
+        </span>
+        <span class="file-name" *ngIf="file$ | async as file">
+            {{file.name}}
+        </span>
+    </label>
+</div>
+
+<div class="message is-danger" *ngIf="error$ | async as error">
+    <div class="message-header">
+        Invalid file
+    </div>
+    <div class="message-body">
+        An error occurred when reading the file: {{error.message}}
+    </div>
+</div>
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.scss b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.spec.ts b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.spec.ts
new file mode 100644
index 000000000..c837cb18c
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.spec.ts
@@ -0,0 +1,25 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { DefinitionJsonUploadComponent } from './definition-json-upload.component';
+
+describe('DefinitionJsonUploadComponent', () => {
+  let component: DefinitionJsonUploadComponent;
+  let fixture: ComponentFixture<DefinitionJsonUploadComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [ DefinitionJsonUploadComponent ]
+    })
+    .compileComponents();
+  });
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(DefinitionJsonUploadComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
new file mode 100644
index 000000000..72f52fc42
--- /dev/null
+++ b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
@@ -0,0 +1,66 @@
+import { Component, Input, OnChanges, OnDestroy, Output } from '@angular/core';
+import * as _ from 'lodash';
+import { BehaviorSubject, Observable, Subject, from, of } from 'rxjs';
+import { catchError, filter, switchMap, takeUntil, tap } from 'rxjs/operators';
+import { actionIcons } from '../../shared/icons';
+
+@Component({
+    selector: 'ia-definition-json-upload',
+    templateUrl: './definition-json-upload.component.html',
+    styleUrls: ['./definition-json-upload.component.scss']
+})
+export class DefinitionJsonUploadComponent implements OnChanges, OnDestroy {
+    @Input() reset: Observable<void>;
+    @Output() upload = new Subject<any>();
+
+    actionIcons = actionIcons;
+
+    file$: BehaviorSubject<File|undefined> = new BehaviorSubject(undefined);
+    data$: Observable<any>;
+    error$ = new Subject<Error>();
+
+    private inputChange$ = new Subject<void>();
+    private destroy$ = new Subject<void>();
+
+    constructor() {
+        this.data$ = this.file$.pipe(
+            takeUntil(this.destroy$),
+            tap(() => this.error$.next(undefined)),
+            filter(_.negate(_.isUndefined)),
+            switchMap(file =>
+                from(
+                    file.text().then(text => JSON.parse(text))
+                ).pipe(catchError((err: Error) => {
+                    this.error$.next(err);
+                    console.log(err.message);
+                    return of(undefined);
+                }))
+            ),
+        );
+
+        this.data$.subscribe(data => {
+            console.log(data);
+            this.upload.next(data);
+        });
+    }
+
+    ngOnChanges() {
+        this.inputChange$.next();
+        this.reset.pipe(
+            takeUntil(this.inputChange$),
+            takeUntil(this.destroy$),
+        ).subscribe(() => this.file$.next(undefined));
+    }
+
+    ngOnDestroy(): void {
+        this.destroy$.next();
+        this.inputChange$.complete();
+        this.destroy$.complete();
+    }
+
+    onJSONUpload(event: InputEvent) {
+        const files: File[] = event.target['files'];
+        const file = files ? _.first(files) : undefined;
+        this.file$.next(file);
+    }
+}
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 01fa79b07..0020213c0 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -27,22 +27,11 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
             You can update this corpus by uploading a new JSON definition for it.
         </p>
 
-        <form class="block">
-            <div class="file block">
-                <label class="file-label">
-                    <input class="file-input" type="file" name="definition-upload"
-                        accept=".json,application/json"
-                        (input)="onJSONUpload($event)" />
-                    <span class="file-cta">
-                        <span class="file-icon" aria-hidden="true">
-                            <fa-icon [icon]="actionIcons.upload"></fa-icon>
-                        </span>
-                        <span class="file-label">Upload JSON...</span>
-                    </span>
-                    <span class="file-name" *ngIf="uploadFile$ | async as file">
-                        {{file.name}}
-                    </span>
-                </label>
+        <form>
+            <div class="block">
+                <ia-definition-json-upload
+                    [reset]="reset$" (upload)="onJSONUpload($event)">
+                </ia-definition-json-upload>
             </div>
 
             <div class="block" *ngIf="corpusToSubmit$ | async">
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index 450a96481..de47043d0 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -76,30 +76,20 @@ export class EditDefinitionComponent {
     formIcons = formIcons;
 
     corpus$: Observable<APIEditableCorpus>;
-
-    uploadFile$: BehaviorSubject<File|undefined> = new BehaviorSubject(undefined);
-    uploadData$: Subject<Observable<any>> = new Subject();
-
-    uploadError$: Subject<any> = new Subject();
+    uploadData$: Subject<any> = new Subject();
     uploadResult$: Observable<APIEditableCorpus>;
-
     corpusToSubmit$: Observable<APIEditableCorpus|undefined>;
+    reset$: Subject<void> = new Subject();
 
     private submit$: Subject<void> = new Subject();
-    private reset$: Subject<void> = new Subject();
 
     constructor(
         private editDefinitionService: EditDefinitionService,
     ) {
         this.uploadResult$ = this.uploadData$.pipe(
-            switchAll(),
-            catchError(e => {
-                this.uploadError$.next(e);
-                return of(undefined);
-            }),
             filter(_.negate(_.isUndefined)),
             withLatestFrom(this.editDefinitionService.data$),
-            map(([data, corpus]) => this.mergeUploadedData(corpus, data))
+            map(([data, corpus]) => this.mergeUploadedData(corpus, data)),
         );
 
         this.corpusToSubmit$ = merge(
@@ -128,22 +118,16 @@ export class EditDefinitionComponent {
         saveAs(blob, filename);
     }
 
-    onJSONUpload(event: InputEvent) {
-        const files: File[] = event.target['files'];
-        const file = files ? _.first(files) : undefined;
-        this.uploadFile$.next(file);
-        const data$ = from(file.text().then(text => JSON.parse(text)));
-        this.uploadData$.next(data$);
+    onJSONUpload(data: any) {
+        this.uploadData$.next(data);
     }
 
     submit() {
         this.submit$.next();
-        this.uploadFile$.next(undefined);
     }
 
     reset() {
         this.reset$.next();
-        this.uploadFile$.next(undefined);
     }
 
     private mergeUploadedData(corpus: APIEditableCorpus, data: any): APIEditableCorpus {

From a8a1517fbd041bacba297110f7ea1702b0ff067d Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Fri, 17 May 2024 13:35:24 +0200
Subject: [PATCH 34/91] draft CorpusDefinition model

---
 .../definitions-overview.component.spec.ts    |  2 +-
 .../src/app/models/corpus-definition.spec.ts  | 50 +++++++++++++++++
 frontend/src/app/models/corpus-definition.ts  | 50 ++++++++++++++++-
 frontend/src/mock-data/api.ts                 | 16 ++++++
 frontend/src/mock-data/corpus-definition.ts   | 54 +++++++++++++++++++
 5 files changed, 170 insertions(+), 2 deletions(-)
 create mode 100644 frontend/src/app/models/corpus-definition.spec.ts
 create mode 100644 frontend/src/mock-data/corpus-definition.ts

diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
index 78ce3de84..3893a65e7 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.spec.ts
@@ -1,7 +1,7 @@
 import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
 
 import { DefinitionsOverviewComponent } from './definitions-overview.component';
-import { commonTestBed } from 'src/app/common-test-bed';
+import { commonTestBed } from '../../common-test-bed';
 
 describe('DefinitionsOverviewComponent', () => {
     let component: DefinitionsOverviewComponent;
diff --git a/frontend/src/app/models/corpus-definition.spec.ts b/frontend/src/app/models/corpus-definition.spec.ts
new file mode 100644
index 000000000..0d41d61bb
--- /dev/null
+++ b/frontend/src/app/models/corpus-definition.spec.ts
@@ -0,0 +1,50 @@
+import { TestBed } from '@angular/core/testing';
+import { ApiService } from '../services';
+import { CorpusDefinition } from './corpus-definition';
+import { ApiServiceMock } from '../../mock-data/api';
+import { mockCorpusDefinition } from '../../mock-data/corpus-definition';
+
+
+fdescribe('CorpusDefinition', () => {
+    let apiService: ApiService;
+
+    beforeEach(() => {
+        TestBed.configureTestingModule({
+            providers: [
+                { provide: ApiService, useClass: ApiServiceMock }
+            ]
+        });
+        apiService = TestBed.inject(ApiService);
+    });
+
+    it('should create for an existing corpus', () => {
+        const corpus = new CorpusDefinition(apiService, 1);
+        expect(corpus).toBeTruthy();
+        expect(corpus.id).toBe(1);
+    });
+
+    it('should create for a new corpus', () => {
+        const corpus = new CorpusDefinition(apiService);
+        expect(corpus).toBeTruthy();
+        expect(corpus.id).toBeUndefined();
+    });
+
+    it('should save updates', () => {
+        const createSpy = spyOn(apiService, 'createCorpus').and.callThrough();
+        const updateSpy = spyOn(apiService, 'updateCorpus').and.callThrough();
+
+        const corpus = new CorpusDefinition(apiService);
+        corpus.definition = mockCorpusDefinition;
+        corpus.save();
+
+        expect(createSpy).toHaveBeenCalledTimes(1);
+        expect(updateSpy).not.toHaveBeenCalled();
+        expect(corpus.id).toBeDefined();
+
+        corpus.definition.meta.title = 'Different title';
+        corpus.save();
+
+        expect(createSpy).toHaveBeenCalledTimes(1);
+        expect(updateSpy).toHaveBeenCalledTimes(1);
+    });
+});
diff --git a/frontend/src/app/models/corpus-definition.ts b/frontend/src/app/models/corpus-definition.ts
index 4f21d246e..611a88ed5 100644
--- a/frontend/src/app/models/corpus-definition.ts
+++ b/frontend/src/app/models/corpus-definition.ts
@@ -1,8 +1,10 @@
+import { ApiService } from '../services';
+
 export interface APICorpusField {
     name: string;
     display_name: string;
     description: string;
-    type: 'text-content'|'text_metadata'|'url'|'integer'|'float'|'date'|'boolean'|'geo_point';
+    type: 'text_content'|'text_metadata'|'url'|'integer'|'float'|'date'|'boolean'|'geo_point';
     options: {
         search: boolean;
         filter: 'show'|'hide'|'none';
@@ -58,3 +60,49 @@ export interface APIEditableCorpus {
     active: boolean;
     definition: APICorpusDefinition;
 };
+
+export class CorpusDefinition {
+    active = false;
+    definition: APICorpusDefinition;
+
+    constructor(private apiService: ApiService, public id?: number) {
+        if (this.id) {
+            this.apiService.corpusDefinition(this.id).subscribe(result =>
+                this.setFromAPIData(result)
+            );
+        }
+    }
+
+    /** update the corpus state from a JSON definition */
+    setFromDefinition(definition: APICorpusDefinition) {
+        this.definition = definition;
+    }
+
+    /** return the JSON definition for the corpus state */
+    toDefinition(): APICorpusDefinition {
+        return this.definition;
+    }
+
+    /** save the corpus state in the database */
+    save(): void {
+        const data = this.toAPIData();
+        const request$ = this.id ?
+            this.apiService.updateCorpus(this.id, data) :
+            this.apiService.createCorpus(data);
+        request$.subscribe(result => this.setFromAPIData(result));
+    }
+
+    private toAPIData(): APIEditableCorpus {
+        return {
+            id: this.id,
+            active: this.active,
+            definition: this.toDefinition()
+        };
+    }
+
+    private setFromAPIData(result: APIEditableCorpus) {
+        this.id = result.id;
+        this.active = result.active;
+        this.setFromDefinition(result.definition);
+    }
+}
diff --git a/frontend/src/mock-data/api.ts b/frontend/src/mock-data/api.ts
index 37f3b7411..f16e9c7f7 100644
--- a/frontend/src/mock-data/api.ts
+++ b/frontend/src/mock-data/api.ts
@@ -4,6 +4,8 @@ import { takeUntil } from 'rxjs/operators';
 import { mockUserResponse } from './user';
 import { CorpusDocumentationPage, TaskResult, TasksOutcome } from '../app/models';
 import { LimitedResultsDownloadParameters } from '../app/models/search-results';
+import { mockCorpusDefinition } from './corpus-definition';
+import { APIEditableCorpus } from '../app/models/corpus-definition';
 
 export const fakeNgramResult = {
     words: [
@@ -93,4 +95,18 @@ export class ApiServiceMock {
     userTags() {
         return of([]);
     }
+
+    corpusDefinition(id: number): Observable<APIEditableCorpus> {
+        const data = { id, active: false, definition: mockCorpusDefinition };
+        return of(data);
+    }
+
+    createCorpus(data: APIEditableCorpus): Observable<APIEditableCorpus> {
+        const result = _.merge({ id: 1 }, data);
+        return of(result);
+    }
+
+    updateCorpus(_id: number, data: APIEditableCorpus): Observable<APIEditableCorpus> {
+        return of(data);
+    }
 }
diff --git a/frontend/src/mock-data/corpus-definition.ts b/frontend/src/mock-data/corpus-definition.ts
new file mode 100644
index 000000000..cf418c9ac
--- /dev/null
+++ b/frontend/src/mock-data/corpus-definition.ts
@@ -0,0 +1,54 @@
+import { APICorpusDefinition } from '../app/models/corpus-definition';
+
+export const mockCorpusDefinition: APICorpusDefinition = {
+    name: 'test',
+    meta: {
+        title: 'Test corpus',
+        description: 'JSON corpus definition for testing',
+        category: 'book',
+        date_range: {
+            min: '1800-01-01',
+            max: '1900-01-01'
+        },
+        languages: ['en'],
+    },
+    source_data: {
+        type: 'csv'
+    },
+    fields: [
+        {
+            name: 'content',
+            display_name: 'Content',
+            description: 'Main text content',
+            type: 'text_content',
+            options: {
+                search: true,
+                filter: 'none',
+                visualize: true,
+                preview: true,
+                sort: false,
+                hidden: false,
+            },
+            extract: {
+                column: 'content'
+            }
+        },
+        {
+            name: 'date',
+            display_name: 'Date',
+            description: 'Date on which the text was published',
+            type: 'date',
+            options: {
+                search: false,
+                filter: 'show',
+                visualize: true,
+                preview: true,
+                sort: true,
+                hidden: false,
+            },
+            extract: {
+                column: 'date'
+            }
+        }
+    ]
+};

From 41d5fac530ec3a2975282880943dde481c82b2ad Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Fri, 17 May 2024 13:49:28 +0200
Subject: [PATCH 35/91] simplify update interface

---
 .../edit-definition.component.html            |  10 +-
 .../edit-definition.component.ts              | 120 +++---------------
 .../src/app/models/corpus-definition.spec.ts  |   2 +-
 3 files changed, 22 insertions(+), 110 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 0020213c0..2cade4994 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -1,21 +1,21 @@
 <section class="section">
-    <div class="container" *ngIf="corpus$ | async as corpus">
+    <div class="container">
         <nav aria-label="secondary navigation" class="breadcrumb">
             <ul>
                 <li><a [routerLink]="['/']">Corpora</a></li>
                 <li><a [routerLink]="['../..']">Definitions</a></li>
-                <li class="is-active" aria-current="page"><a>{{corpus.definition.meta.title}}</a></li>
+                <li class="is-active" aria-current="page"><a>{{corpus.definition?.meta.title}}</a></li>
             </ul>
         </nav>
 
-        <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
+        <h1 class="title">Edit corpus "{{corpus.definition?.meta.title}}"</h1>
 
         <p class="block">
             You can download this corpus definition as a JSON file.
         </p>
 
         <div class="block">
-            <button class="button" (click)="downloadJSON(corpus.definition)">
+            <button class="button" (click)="downloadJSON()">
                 <span class="icon" aria-hidden="true">
                     <fa-icon [icon]="actionIcons.download"></fa-icon>
                 </span>
@@ -34,7 +34,7 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
                 </ia-definition-json-upload>
             </div>
 
-            <div class="block" *ngIf="corpusToSubmit$ | async">
+            <div class="block">
                 <button class="button is-primary" type="submit" (click)="submit()">
                     <span class="icon" aria-hidden="true">
                         <fa-icon [icon]="formIcons.confirm"></fa-icon>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index de47043d0..c9b3d70e8 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -1,137 +1,49 @@
-import { Component, Injectable } from '@angular/core';
+import { Component, } from '@angular/core';
 import { actionIcons, formIcons } from '../../shared/icons';
-import { BehaviorSubject, Observable, Subject, combineLatest, from, merge, of } from 'rxjs';
-import { APICorpusDefinition, APIEditableCorpus } from '../../models/corpus-definition';
+import { Subject } from 'rxjs';
+import { CorpusDefinition } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
-import {
-    catchError, filter, map, shareReplay, startWith, switchAll, switchMap, switchMapTo,
-    take, withLatestFrom
-} from 'rxjs/operators';
-import * as _ from 'lodash';
-
-
-@Injectable()
-class EditDefinitionService {
-    data$: Observable<APIEditableCorpus>;
-    error$ = new Subject<any>();
-    loading$: Observable<boolean>;
-
-    id$: Observable<number>;
-
-    private initialData$: Observable<APIEditableCorpus>;
-    private updatedData$: Observable<APIEditableCorpus>;
-
-    private updates$ = new Subject<APIEditableCorpus>();
-
-    constructor(private route: ActivatedRoute, private apiService: ApiService) {
-        this.id$ = this.route.params.pipe(
-            map(params => params['corpusID'])
-        );
-
-        this.initialData$ = this.id$.pipe(
-            switchMap(id => this.apiService.corpusDefinition(id).pipe(
-                shareReplay(1)
-            )),
-            catchError(err => {
-                this.error$.next(err);
-                return of(undefined);
-            }),
-        );
-
-        this.updatedData$ = combineLatest([this.id$, this.updates$]).pipe(
-            switchMap(([id, data]) => this.apiService.updateCorpus(id, data)),
-            catchError(err => {
-                this.error$.next(err);
-                return of(undefined);
-            }),
-            filter(_.negate(_.isUndefined)),
-        );
-
-        this.data$ = merge(this.initialData$, this.updatedData$);
-
-        this.loading$ = merge(
-            this.updates$.pipe(map(_.constant(true))),
-            this.data$.pipe(map(_.constant(false))),
-            this.error$.pipe(map(_.constant(false)))
-        ).pipe(
-            startWith(true)
-        );
-    }
-
-    update(data: APIEditableCorpus) {
-        this.updates$.next(data);
-    }
-}
-
 
 @Component({
     selector: 'ia-edit-definition',
     templateUrl: './edit-definition.component.html',
     styleUrls: ['./edit-definition.component.scss'],
-    providers: [EditDefinitionService],
 })
 export class EditDefinitionComponent {
     actionIcons = actionIcons;
     formIcons = formIcons;
 
-    corpus$: Observable<APIEditableCorpus>;
-    uploadData$: Subject<any> = new Subject();
-    uploadResult$: Observable<APIEditableCorpus>;
-    corpusToSubmit$: Observable<APIEditableCorpus|undefined>;
     reset$: Subject<void> = new Subject();
 
-    private submit$: Subject<void> = new Subject();
+    corpus: CorpusDefinition;
 
     constructor(
-        private editDefinitionService: EditDefinitionService,
-    ) {
-        this.uploadResult$ = this.uploadData$.pipe(
-            filter(_.negate(_.isUndefined)),
-            withLatestFrom(this.editDefinitionService.data$),
-            map(([data, corpus]) => this.mergeUploadedData(corpus, data)),
-        );
+        private apiService: ApiService,
+        private route: ActivatedRoute,
 
-        this.corpusToSubmit$ = merge(
-            this.editDefinitionService.data$.pipe(map(_.constant(undefined))),
-            this.reset$,
-            this.uploadResult$
-        ).pipe(
-            shareReplay(1)
-        );
-
-        this.corpus$ = merge(
-            this.editDefinitionService.data$,
-            this.corpusToSubmit$.pipe(filter(_.negate(_.isUndefined))),
-        );
-
-        this.submit$.pipe(
-            switchMapTo(this.corpusToSubmit$),
-            take(1),
-        ).subscribe(data => this.editDefinitionService.update(data));
+    ) {
+        const id = parseInt(this.route.snapshot.params['corpusID'], 10);
+        this.corpus = new CorpusDefinition(this.apiService, id);
     }
 
-    downloadJSON(definition: APICorpusDefinition) {
-        const content = JSON.stringify(definition, undefined, 4);
-        const blob = new Blob([content], { type: `text/csv;charset=utf-8`, endings: 'native' });
-        const filename = definition.name + '.json';
+    downloadJSON() {
+        const data = this.corpus.toDefinition();
+        const content = JSON.stringify(data, undefined, 4);
+        const blob = new Blob([content], { type: `application/json;charset=utf-8`, endings: 'native' });
+        const filename = data.name + '.json';
         saveAs(blob, filename);
     }
 
     onJSONUpload(data: any) {
-        this.uploadData$.next(data);
+        this.corpus.setFromDefinition(data);
     }
 
     submit() {
-        this.submit$.next();
+        this.corpus.save();
     }
 
     reset() {
         this.reset$.next();
     }
-
-    private mergeUploadedData(corpus: APIEditableCorpus, data: any): APIEditableCorpus {
-        _.set(corpus, 'definition', data);
-        return corpus;
-    }
 }
diff --git a/frontend/src/app/models/corpus-definition.spec.ts b/frontend/src/app/models/corpus-definition.spec.ts
index 0d41d61bb..57d45bc6e 100644
--- a/frontend/src/app/models/corpus-definition.spec.ts
+++ b/frontend/src/app/models/corpus-definition.spec.ts
@@ -5,7 +5,7 @@ import { ApiServiceMock } from '../../mock-data/api';
 import { mockCorpusDefinition } from '../../mock-data/corpus-definition';
 
 
-fdescribe('CorpusDefinition', () => {
+describe('CorpusDefinition', () => {
     let apiService: ApiService;
 
     beforeEach(() => {

From 1a789ccf4ee953523cb4dea1054c99993158af72 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Fri, 17 May 2024 14:07:05 +0200
Subject: [PATCH 36/91] create definition form

---
 .../create-definition.component.html          | 26 +++++++++++++------
 .../create-definition.component.ts            | 23 +++++++++++-----
 .../definition-json-upload.component.ts       |  2 +-
 .../edit-definition.component.html            |  4 +--
 .../src/app/models/corpus-definition.spec.ts  |  5 +++-
 frontend/src/app/models/corpus-definition.ts  |  7 +++++
 frontend/src/mock-data/api.ts                 |  5 ++++
 7 files changed, 54 insertions(+), 18 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
index 375899335..25ffa498e 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
@@ -14,13 +14,23 @@ <h1 class="title">New corpus</h1>
             Upload a JSON definition file to add it as a corpus.
         </p>
 
-        <div class="block">
-            <button class="button">
-                <span class="icon" aria-hidden="true">
-                    <fa-icon [icon]="actionIcons.upload"></fa-icon>
-                </span>
-                <span>Upload JSON</span>
-            </button>
-        </div>
+        <form>
+            <div class="block">
+                <ia-definition-json-upload
+                    [reset]="reset$" (upload)="onJSONUpload($event)">
+                </ia-definition-json-upload>
+            </div>
+
+            <div class="block" *ngIf="corpus.isComplete()">
+                <button class="button is-primary" type="submit" (click)="submit()">
+                    <span class="icon" aria-hidden="true">
+                        <fa-icon [icon]="formIcons.confirm"></fa-icon>
+                    </span>
+                    <span>
+                        Save corpus
+                    </span>
+                </button>
+            </div>
+        </form>
     </div>
 </section>
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
index d4ea3bac0..9b571402b 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
@@ -1,18 +1,29 @@
-import { Component, OnInit } from '@angular/core';
-import { actionIcons } from '../../shared/icons';
+import { Component } from '@angular/core';
+import { actionIcons, formIcons } from '../../shared/icons';
+import { ApiService } from '../../services';
+import { CorpusDefinition } from '../../models/corpus-definition';
 
 @Component({
     selector: 'ia-create-definition',
     templateUrl: './create-definition.component.html',
     styleUrls: ['./create-definition.component.scss']
 })
-export class CreateDefinitionComponent implements OnInit {
-
+export class CreateDefinitionComponent {
     actionIcons = actionIcons;
+    formIcons = formIcons;
+
+    corpus: CorpusDefinition;
 
-    constructor() { }
+    constructor(private apiService: ApiService) {
+        this.corpus = new CorpusDefinition(apiService);
+    }
+
+    onJSONUpload(data: any) {
+        this.corpus.setFromDefinition(data);
+    }
 
-    ngOnInit(): void {
+    submit() {
+        this.corpus.save();
     }
 
 }
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
index 72f52fc42..3fba33304 100644
--- a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
+++ b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
@@ -46,7 +46,7 @@ export class DefinitionJsonUploadComponent implements OnChanges, OnDestroy {
 
     ngOnChanges() {
         this.inputChange$.next();
-        this.reset.pipe(
+        this.reset?.pipe(
             takeUntil(this.inputChange$),
             takeUntil(this.destroy$),
         ).subscribe(() => this.file$.next(undefined));
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 2cade4994..d5fa4e376 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -4,11 +4,11 @@
             <ul>
                 <li><a [routerLink]="['/']">Corpora</a></li>
                 <li><a [routerLink]="['../..']">Definitions</a></li>
-                <li class="is-active" aria-current="page"><a>{{corpus.definition?.meta.title}}</a></li>
+                <li class="is-active" aria-current="page"><a>{{corpus.definition.meta.title}}</a></li>
             </ul>
         </nav>
 
-        <h1 class="title">Edit corpus "{{corpus.definition?.meta.title}}"</h1>
+        <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
 
         <p class="block">
             You can download this corpus definition as a JSON file.
diff --git a/frontend/src/app/models/corpus-definition.spec.ts b/frontend/src/app/models/corpus-definition.spec.ts
index 57d45bc6e..1bc11c2e1 100644
--- a/frontend/src/app/models/corpus-definition.spec.ts
+++ b/frontend/src/app/models/corpus-definition.spec.ts
@@ -3,6 +3,7 @@ import { ApiService } from '../services';
 import { CorpusDefinition } from './corpus-definition';
 import { ApiServiceMock } from '../../mock-data/api';
 import { mockCorpusDefinition } from '../../mock-data/corpus-definition';
+import * as _ from 'lodash';
 
 
 describe('CorpusDefinition', () => {
@@ -41,10 +42,12 @@ describe('CorpusDefinition', () => {
         expect(updateSpy).not.toHaveBeenCalled();
         expect(corpus.id).toBeDefined();
 
-        corpus.definition.meta.title = 'Different title';
+        const newDefinition = _.set(_.cloneDeep(mockCorpusDefinition), ['meta', 'title'], 'Different title');
+        corpus.setFromDefinition(newDefinition);
         corpus.save();
 
         expect(createSpy).toHaveBeenCalledTimes(1);
         expect(updateSpy).toHaveBeenCalledTimes(1);
+        expect(corpus.title).toBe('Different title');
     });
 });
diff --git a/frontend/src/app/models/corpus-definition.ts b/frontend/src/app/models/corpus-definition.ts
index 611a88ed5..71843bfe4 100644
--- a/frontend/src/app/models/corpus-definition.ts
+++ b/frontend/src/app/models/corpus-definition.ts
@@ -1,3 +1,4 @@
+import * as _ from 'lodash';
 import { ApiService } from '../services';
 
 export interface APICorpusField {
@@ -63,6 +64,7 @@ export interface APIEditableCorpus {
 
 export class CorpusDefinition {
     active = false;
+
     definition: APICorpusDefinition;
 
     constructor(private apiService: ApiService, public id?: number) {
@@ -83,6 +85,11 @@ export class CorpusDefinition {
         return this.definition;
     }
 
+    /** whether the corpus definition contains all data necessary for saving */
+    isComplete() {
+        return !_.isUndefined(this.definition);
+    }
+
     /** save the corpus state in the database */
     save(): void {
         const data = this.toAPIData();
diff --git a/frontend/src/mock-data/api.ts b/frontend/src/mock-data/api.ts
index f16e9c7f7..adaca1a90 100644
--- a/frontend/src/mock-data/api.ts
+++ b/frontend/src/mock-data/api.ts
@@ -96,6 +96,11 @@ export class ApiServiceMock {
         return of([]);
     }
 
+    corpusDefinitions(): Observable<APIEditableCorpus[]> {
+        const data = [{ id: 1, active: false, definition: mockCorpusDefinition }];
+        return of(data);
+    }
+
     corpusDefinition(id: number): Observable<APIEditableCorpus> {
         const data = { id, active: false, definition: mockCorpusDefinition };
         return of(data);

From ecd44d334f267393ba18cde875d0ec1924a233f5 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Fri, 17 May 2024 14:15:20 +0200
Subject: [PATCH 37/91] enable deleting corpora

---
 .../definitions-overview.component.html                    | 3 ++-
 .../definitions-overview/definitions-overview.component.ts | 7 +++++++
 frontend/src/app/services/api.service.ts                   | 2 +-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
index 8237c26aa..cd1aad704 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.html
@@ -45,7 +45,8 @@ <h1 class="title">Corpus definitions</h1>
                                 </span>
                             </a>
                             &nbsp;
-                            <button class="button" disabled>
+                            <button class="button" (click)="delete(corpus)"
+                                [disabled]="corpus.active">
                                 <span class="icon" aria-label="delete">
                                     <fa-icon [icon]="actionIcons.delete"></fa-icon>
                                 </span>
diff --git a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
index 082e6f395..399950560 100644
--- a/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
+++ b/frontend/src/app/corpus-definitions/definitions-overview/definitions-overview.component.ts
@@ -18,4 +18,11 @@ export class DefinitionsOverviewComponent {
     constructor(private apiService: ApiService) {
         this.corpora$ = this.apiService.corpusDefinitions();
     }
+
+    delete(corpus: APIEditableCorpus) {
+        this.apiService.deleteCorpus(corpus.id).subscribe(response => {
+            console.log(response);
+            this.corpora$ = this.apiService.corpusDefinitions();
+        });
+    }
 }
diff --git a/frontend/src/app/services/api.service.ts b/frontend/src/app/services/api.service.ts
index 3ed181f5f..b05bae0e7 100644
--- a/frontend/src/app/services/api.service.ts
+++ b/frontend/src/app/services/api.service.ts
@@ -254,7 +254,7 @@ export class ApiService {
     }
 
     public deleteCorpus(corpusID: number): Observable<any> {
-        return this.http.delete(`/api/corpus/definitions/${corpusID}`);
+        return this.http.delete(`/api/corpus/definitions/${corpusID}/`);
     }
 
     // Tagging

From 76669ad54419569533ccdefc0bb7243fe6d94bd2 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 22 May 2024 12:09:43 +0200
Subject: [PATCH 38/91] basic feedback for saving data

---
 .../create-definition.component.html          |  6 ++++++
 .../create-definition.component.ts            | 19 ++++++++++++++++---
 .../definition-json-upload.component.ts       |  1 -
 .../edit-definition.component.html            |  9 ++++++++-
 .../edit-definition.component.ts              | 10 +++++++++-
 frontend/src/app/models/corpus-definition.ts  | 14 ++++++++++++--
 6 files changed, 51 insertions(+), 8 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
index 25ffa498e..8894fa7c6 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.html
@@ -31,6 +31,12 @@ <h1 class="title">New corpus</h1>
                     </span>
                 </button>
             </div>
+
+            <div class="message is-danger" *ngIf="error">
+                <div class="message-body">
+                    Could not save corpus: {{error.message}}
+                </div>
+            </div>
         </form>
     </div>
 </section>
diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
index 9b571402b..deba1add0 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
@@ -1,7 +1,10 @@
 import { Component } from '@angular/core';
 import { actionIcons, formIcons } from '../../shared/icons';
 import { ApiService } from '../../services';
-import { CorpusDefinition } from '../../models/corpus-definition';
+import { APIEditableCorpus, CorpusDefinition } from '../../models/corpus-definition';
+import * as _ from 'lodash';
+import { Router } from '@angular/router';
+import { HttpErrorResponse } from '@angular/common/http';
 
 @Component({
     selector: 'ia-create-definition',
@@ -14,7 +17,9 @@ export class CreateDefinitionComponent {
 
     corpus: CorpusDefinition;
 
-    constructor(private apiService: ApiService) {
+    error: Error;
+
+    constructor(private apiService: ApiService, private router: Router) {
         this.corpus = new CorpusDefinition(apiService);
     }
 
@@ -23,7 +28,15 @@ export class CreateDefinitionComponent {
     }
 
     submit() {
-        this.corpus.save();
+        this.error = undefined;
+        this.corpus.save().subscribe(
+            (result: APIEditableCorpus) => {
+                this.router.navigate(['/corpus-definitions', 'edit', result.id]);
+            },
+            (err: HttpErrorResponse) => {
+                this.error = err;
+            }
+        );
     }
 
 }
diff --git a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
index 3fba33304..4e91bf606 100644
--- a/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
+++ b/frontend/src/app/corpus-definitions/definition-json-upload/definition-json-upload.component.ts
@@ -39,7 +39,6 @@ export class DefinitionJsonUploadComponent implements OnChanges, OnDestroy {
         );
 
         this.data$.subscribe(data => {
-            console.log(data);
             this.upload.next(data);
         });
     }
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index d5fa4e376..98f172729 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -35,7 +35,8 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
             </div>
 
             <div class="block">
-                <button class="button is-primary" type="submit" (click)="submit()">
+                <button class="button is-primary" [class.is-loading]="corpus.loading$ | async"
+                    type="submit" (click)="submit()">
                     <span class="icon" aria-hidden="true">
                         <fa-icon [icon]="formIcons.confirm"></fa-icon>
                     </span>
@@ -53,6 +54,12 @@ <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
                     </span>
                 </button>
             </div>
+
+            <div class="message is-danger" *ngIf="error">
+                <div class="message-body">
+                    Could not save corpus: {{error.message}}
+                </div>
+            </div>
         </form>
     </div>
 </section>
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index c9b3d70e8..b5c16bba0 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -4,6 +4,9 @@ import { Subject } from 'rxjs';
 import { CorpusDefinition } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
+import { filter, take } from 'rxjs/operators';
+import * as _ from 'lodash';
+import { HttpErrorResponse } from '@angular/common/http';
 
 @Component({
     selector: 'ia-edit-definition',
@@ -18,6 +21,8 @@ export class EditDefinitionComponent {
 
     corpus: CorpusDefinition;
 
+    error: Error;
+
     constructor(
         private apiService: ApiService,
         private route: ActivatedRoute,
@@ -40,7 +45,10 @@ export class EditDefinitionComponent {
     }
 
     submit() {
-        this.corpus.save();
+        this.corpus.save().subscribe(
+            () => this.reset(),
+            (err: HttpErrorResponse) => this.error = err,
+        );
     }
 
     reset() {
diff --git a/frontend/src/app/models/corpus-definition.ts b/frontend/src/app/models/corpus-definition.ts
index 71843bfe4..e5318fba9 100644
--- a/frontend/src/app/models/corpus-definition.ts
+++ b/frontend/src/app/models/corpus-definition.ts
@@ -1,5 +1,7 @@
 import * as _ from 'lodash';
 import { ApiService } from '../services';
+import { BehaviorSubject, Observable } from 'rxjs';
+import { share } from 'rxjs/operators';
 
 export interface APICorpusField {
     name: string;
@@ -64,14 +66,18 @@ export interface APIEditableCorpus {
 
 export class CorpusDefinition {
     active = false;
+    loading$ = new BehaviorSubject<boolean>(true);
 
     definition: APICorpusDefinition;
 
+
     constructor(private apiService: ApiService, public id?: number) {
         if (this.id) {
             this.apiService.corpusDefinition(this.id).subscribe(result =>
                 this.setFromAPIData(result)
             );
+        } else {
+            this.loading$.next(false);
         }
     }
 
@@ -91,12 +97,15 @@ export class CorpusDefinition {
     }
 
     /** save the corpus state in the database */
-    save(): void {
+    save(): Observable<APIEditableCorpus> {
+        this.loading$.next(true);
         const data = this.toAPIData();
         const request$ = this.id ?
             this.apiService.updateCorpus(this.id, data) :
             this.apiService.createCorpus(data);
-        request$.subscribe(result => this.setFromAPIData(result));
+        const result$ = request$.pipe(share());
+        result$.subscribe(result => this.setFromAPIData(result));
+        return result$;
     }
 
     private toAPIData(): APIEditableCorpus {
@@ -111,5 +120,6 @@ export class CorpusDefinition {
         this.id = result.id;
         this.active = result.active;
         this.setFromDefinition(result.definition);
+        this.loading$.next(false);
     }
 }

From 35fea96823d0fd041aa9cff093545ca97fe16c72 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 22 May 2024 12:55:54 +0200
Subject: [PATCH 39/91] update documentation

---
 documentation/First-time-setup.md                    | 9 +++++----
 documentation/Writing-a-corpus-definition-in-JSON.md | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/documentation/First-time-setup.md b/documentation/First-time-setup.md
index 247215e40..8d08f687a 100644
--- a/documentation/First-time-setup.md
+++ b/documentation/First-time-setup.md
@@ -89,11 +89,12 @@ The source files of a corpus are not included in this directory; ask another dev
 
 Note: database-only corpora are still in development and not yet recommended for first-time users.
 
-To add a database-only corpus, you will need a JSON definition of the corpus, and a directory with (a sample of) the pre-processed source data. To retrieve a JSON definition from a running I-analyzer server, visit `/api/corpus/edit/` and copy the JSON of the corpus you want to import.
+To add a database-only corpus, you will need a JSON definition of the corpus, and a directory with (a sample of) the pre-processed source data. To retrieve a JSON definition from a running I-analyzer server, log in as a staff user and visit `/corpus-definitions/`. Open the corpus you want to import and click "Download JSON".
 
-1. Start up your I-analyzer server. Make a POST request to `localhost:8000/api/corpus/edit/` (you can use the browsable API for this) to import the JSON definition.
-2. Visit the admin menu (`localhost:8000/admin`). Go to "corpus configurations" and select your corpus. In the "data directory" field, add the path to your source data directory.
-3. Activate your python virutal environment. Then create an ElasticSearch index from the source files by running, e.g., `yarn django index dutchannualreports`, for indexing the Dutch Annual Reports corpus in a development environment. See [Indexing](documentation/Indexing-corpora.md) for more information.
+1. Start up your I-analyzer server and log in as a staff user. Go to `localhost:4200/corpus-definitions/new`. Upload the JSON definition file and save.
+2. Visit the admin menu (`localhost:4200/admin`). Go to "corpus configurations" and select your corpus. In the "data directory" field, add the path to your source data directory.
+3. Activate your python virtual environment. Create an ElasticSearch index from the source files by running `yarn django index {corpusname}`. See [Indexing](documentation/Indexing-corpora.md) for more information.
+4. Visit the admin menu again. Go to "corpora" and select te corpus. Set "active" to true and save.
 
 
 ## Running a dev environment
diff --git a/documentation/Writing-a-corpus-definition-in-JSON.md b/documentation/Writing-a-corpus-definition-in-JSON.md
index 9f93a6a1d..31cc42312 100644
--- a/documentation/Writing-a-corpus-definition-in-JSON.md
+++ b/documentation/Writing-a-corpus-definition-in-JSON.md
@@ -6,7 +6,7 @@ The format is defined in [corpus.schema.json](/backend/addcorpus/schemas/corpus.
 
 ## Importing and exporting definitions
 
-Currently, importing and exporting JSON definitions is only supported through the backend API.
+You can import and export JSON definitions through the frontend. Visit `/corpus-definitions/` to do so.
 
 Some notes on importing and exporting JSON definitions:
 

From db611d255346f28536edfcfb78b852addb6eb5a1 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 22 May 2024 13:15:48 +0200
Subject: [PATCH 40/91] clear corpus data in tests

---
 backend/corpora/utils_test.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/backend/corpora/utils_test.py b/backend/corpora/utils_test.py
index 8dd27e233..ccc671df5 100644
--- a/backend/corpora/utils_test.py
+++ b/backend/corpora/utils_test.py
@@ -1,4 +1,5 @@
 from addcorpus.python_corpora.save_corpus import load_and_save_all_corpora
+from addcorpus.models import Corpus
 
 def corpus_from_api(client):
     '''
@@ -11,6 +12,7 @@ def corpus_from_api(client):
     useful when you have configured your settings with only one corpus.
     '''
 
+    Corpus.objects.all().delete()
     load_and_save_all_corpora()
 
     response = client.get('/api/corpus/')

From 7f9555c437361e8de3b32639189ce4ae6b48746c Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Wed, 22 May 2024 13:22:13 +0200
Subject: [PATCH 41/91] fix property reference

---
 .../edit-definition/edit-definition.component.html            | 4 ++--
 frontend/src/app/models/corpus-definition.spec.ts             | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
index 98f172729..601cff15f 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.html
@@ -4,11 +4,11 @@
             <ul>
                 <li><a [routerLink]="['/']">Corpora</a></li>
                 <li><a [routerLink]="['../..']">Definitions</a></li>
-                <li class="is-active" aria-current="page"><a>{{corpus.definition.meta.title}}</a></li>
+                <li class="is-active" aria-current="page"><a>{{corpus.definition?.meta.title || '...'}}</a></li>
             </ul>
         </nav>
 
-        <h1 class="title">Edit corpus "{{corpus.definition.meta.title}}"</h1>
+        <h1 class="title">Edit corpus "{{corpus.definition?.meta.title || '...'}}"</h1>
 
         <p class="block">
             You can download this corpus definition as a JSON file.
diff --git a/frontend/src/app/models/corpus-definition.spec.ts b/frontend/src/app/models/corpus-definition.spec.ts
index 1bc11c2e1..234ea35ef 100644
--- a/frontend/src/app/models/corpus-definition.spec.ts
+++ b/frontend/src/app/models/corpus-definition.spec.ts
@@ -48,6 +48,6 @@ describe('CorpusDefinition', () => {
 
         expect(createSpy).toHaveBeenCalledTimes(1);
         expect(updateSpy).toHaveBeenCalledTimes(1);
-        expect(corpus.title).toBe('Different title');
+        expect(corpus.definition.meta.title).toBe('Different title');
     });
 });

From 633be4de78a75d2372c36ab07edba07e6bc6c189 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 17 May 2024 18:44:06 +0200
Subject: [PATCH 42/91] ublad cleanup and tweaks

remove the Year field from ublad

add content_transform func for ublad content

add display_type for urls to Ublad

add csv_core fields for Ublad
---
 backend/corpora/ublad/ublad.py | 65 ++++++++++++++++++++++------------
 1 file changed, 43 insertions(+), 22 deletions(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index e52020caa..c2ff0d52d 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -5,9 +5,9 @@
 
 from django.conf import settings
 from addcorpus.python_corpora.corpus import HTMLCorpusDefinition, FieldDefinition
-from addcorpus.python_corpora.extract import Metadata, XML, Pass, Order, Backup, Combined, FilterAttribute
+from addcorpus.python_corpora.extract import FilterAttribute
 from addcorpus.es_mappings import *
-from addcorpus.python_corpora.filters import RangeFilter, MultipleChoiceFilter, BooleanFilter, DateFilter
+from addcorpus.python_corpora.filters import DateFilter
 from addcorpus.es_settings import es_settings
 
 
@@ -15,9 +15,34 @@
 from ianalyzer_readers.readers.core import Field
 from ianalyzer_readers.extract import html, Constant
 
+from bs4 import BeautifulSoup, Tag
+
 import locale
 locale.setlocale(locale.LC_ALL, 'nl_NL.UTF-8')
 
+def transform_content(soup):
+    """
+    Transforms the text contents of a page node (soup) into a string consisting
+    of blocks of text, foregoing the column structure of the OCR'ed material.
+    """
+    page_text = ""
+    for child in soup.children:
+        if isinstance(child, Tag) and 'ocr_carea' in child.get('class', []):
+            paragraph_text = ""
+            paragraph_list = child.get_text().split('\n')
+            for item in paragraph_list[1:]:
+                if not item:
+                    pass
+                elif item.endswith('-'):
+                    paragraph_text += item.strip('-')
+                else:
+                    paragraph_text += item + ' '
+            if paragraph_text:
+                page_text += paragraph_text + '\n\n'
+    page_node = BeautifulSoup(page_text, 'html.parser')
+    return page_node
+
+
 class UBlad(HTMLCorpusDefinition):
     title = 'U-Blad'
     description = 'The print editions of the Utrecht University paper from 1969 until 2010.'
@@ -62,17 +87,23 @@ def sources(self, start=min_date, end=max_date):
             results_overview=True,
             csv_core=True,
             search_field_core=True,
-            visualisations=['ngram', 'wordcloud'],
+            visualizations=['ngram', 'wordcloud'],
             es_mapping = main_content_mapping(True, True, True, 'nl'),
-            extractor= FilterAttribute(tag='div', recursive=True, multiple=False, flatten=True, attribute_filter={
-                'attribute': 'class',
-                'value': 'ocr_page'
-            })
+            extractor= FilterAttribute(tag='div',
+                                       recursive=True,
+                                       multiple=False,
+                                       flatten=False,
+                                       transform_soup_func=transform_content,
+                                       attribute_filter={
+                                            'attribute': 'class',
+                                            'value': 'ocr_page'
+                                        })
         ),
         FieldDefinition(
             name='pagenum',
             display_name='Page number',
             description='Page number',
+            csv_core=True,
             es_mapping = int_mapping(),
             extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
@@ -80,7 +111,6 @@ def sources(self, start=min_date, end=max_date):
                 }
             )
         ),
-
         FieldDefinition(
             name='journal_title',
             display_name='Publication Title',
@@ -129,6 +159,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Volume',
             sortable=True,
             results_overview=True,
+            csv_core=True,
             description='The volume number of this publication. There is one volume per year.',
             extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
@@ -159,25 +190,12 @@ def sources(self, start=min_date, end=max_date):
                     x, '%d %B %Y').strftime('%Y-%m-%d')
             )
         ),
-        FieldDefinition(
-            name='year',
-            display_name='Year',
-            description='The publication year of this volume',
-            es_mapping=keyword_mapping(),
-            visualizations=['resultscount', 'termfrequency'],
-            visualization_sort='key',
-            search_filter=MultipleChoiceFilter(),
-            extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
-                'attribute': 'name',
-                'value': 'year',
-                }
-            )
-        ),
         FieldDefinition(
             name='repo_url',
             display_name='Repository URL',
             description='URL to the dSPACE repository entry of this volume',
             es_mapping=keyword_mapping(),
+            display_type='url',
             searchable=False,
             extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
@@ -190,6 +208,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Reader URL',
             description='URL to the UB reader view of this page',
             es_mapping=keyword_mapping(),
+            display_type='url',
             searchable=False,
             extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
@@ -202,6 +221,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Image URL',
             description='URL to the jpg file of this page',
             es_mapping=keyword_mapping(),
+            display_type='url',
             searchable=False,
             extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
@@ -214,6 +234,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Worldcat URL',
             description='URL to the Worldcat entry of this volume',
             es_mapping=keyword_mapping(),
+            display_type='url',
             searchable=False,
             extractor=FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',

From c4e1e084e98048708c1cb331e4acefaaf90628f5 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 24 May 2024 15:34:04 +0200
Subject: [PATCH 43/91] skip snapshots for ublad corpus

---
 backend/corpora/ublad/ublad.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index c2ff0d52d..4c8c38f48 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -72,6 +72,10 @@ def es_settings(self):
 
     def sources(self, start=min_date, end=max_date):
         for directory, _, filenames in os.walk(self.data_directory):
+            _body, tail = os.path.split(directory)
+            if '.snapshot' in _:
+                _.remove('.snapshot')
+                continue
             for filename in filenames:
                 if filename != '.DS_Store':
                     full_path = join(directory, filename)

From c42aa8cabcb713affa3e0dedd8bc5ff0a817de97 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 31 May 2024 12:38:49 +0200
Subject: [PATCH 44/91] move setlocale to the index script

---
 backend/corpora/ublad/ublad.py |  3 ---
 backend/es/es_index.py         | 14 ++++++++++++++
 backend/ianalyzer/settings.py  |  2 ++
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 4c8c38f48..fad1898c7 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -17,9 +17,6 @@
 
 from bs4 import BeautifulSoup, Tag
 
-import locale
-locale.setlocale(locale.LC_ALL, 'nl_NL.UTF-8')
-
 def transform_content(soup):
     """
     Transforms the text contents of a page node (soup) into a string consisting
diff --git a/backend/es/es_index.py b/backend/es/es_index.py
index 75bbd211b..cb6fa9dd3 100644
--- a/backend/es/es_index.py
+++ b/backend/es/es_index.py
@@ -14,6 +14,8 @@
 from ianalyzer.elasticsearch import elasticsearch
 from .es_alias import alias, get_new_version_number
 
+import locale
+
 import logging
 logger = logging.getLogger('indexing')
 
@@ -93,6 +95,15 @@ def populate(client, corpus_name, corpus_definition, start=None, end=None):
 
     corpus_server = settings.SERVERS[
         settings.CORPUS_SERVER_NAMES.get(corpus_name, 'default')]
+
+    # set corpus-specific locale
+    try:
+        corpus_locale = settings.CORPORA_LOCALES[corpus_name]
+        if corpus_locale:
+            locale.setlocale(locale.LC_ALL, corpus_locale)
+    except:
+        pass
+
     # Do bulk operation
     for success, info in es_helpers.streaming_bulk(
         client,
@@ -103,6 +114,9 @@ def populate(client, corpus_name, corpus_definition, start=None, end=None):
         if not success:
             logger.error(f"FAILED INDEX: {info}")
 
+    #revert back to default locale
+    locale.setlocale(locale.LC_ALL, '')
+
 def perform_indexing(corpus_name, corpus_definition, start, end, mappings_only, add, clear, prod, rollover):
     logger.info('Started indexing `{}` from {} to {}...'.format(
         corpus_definition.es_index,
diff --git a/backend/ianalyzer/settings.py b/backend/ianalyzer/settings.py
index fae30ca3e..214ad7623 100644
--- a/backend/ianalyzer/settings.py
+++ b/backend/ianalyzer/settings.py
@@ -76,6 +76,8 @@
 
 CORPUS_SERVER_NAMES = {}
 
+CORPORA_LOCALES = {}
+
 CORPORA = {}
 
 WORDCLOUD_LIMIT = 1000

From 18500502384afb901797b32491acd8a70e82ea5d Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 31 May 2024 12:39:09 +0200
Subject: [PATCH 45/91] Update backend/corpora/ublad/description/ublad.md

Co-authored-by: Jelte van Boheemen <j.vanboheemen@uu.nl>
---
 backend/corpora/ublad/description/ublad.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/backend/corpora/ublad/description/ublad.md b/backend/corpora/ublad/description/ublad.md
index 286e1d787..90ac008da 100644
--- a/backend/corpora/ublad/description/ublad.md
+++ b/backend/corpora/ublad/description/ublad.md
@@ -2,6 +2,6 @@ Op 5 september 1969 kreeg de Universiteit Utrecht voor het eerst een onafhankeli
 
 In 1974 veranderde de naam in het _Ublad_. Dat bleef zo tot de universiteit besloot het papieren Ublad digitaal te maken. Onder luid protest verdween het papieren Ublad en ontstond in april 2010 _DUB_, het digitale universiteitsblad.
 
-Om alle informatie uit het verleden toegankelijk te maken, hebben we samen met de Universiteitsbibliotheek de oude jaargangen gescand. In I-analyzer kunt u alle jaargangen van U utrechtse universitaire reflexen en het Ublad vinden en doorzoeken.
+Om alle informatie uit het verleden toegankelijk te maken, heeft het Centre for Digital Humanities samen met de Universiteitsbibliotheek de oude jaargangen gedigitaliseerd. In I-analyzer kunt u alle jaargangen van U utrechtse universitaire reflexen en het Ublad vinden en doorzoeken.
 
 Het onafhankelijke Ublad geeft een kleurrijk verslag van wat er speelde op de universiteit, de stad en het studentenleven door middel van atikelen, foto’s en cartoons. De afbeelding die is gebruikt voor OCR is voor elke pagina bijgevoegd zodat u altijd het originele bronmateriaal kan raadplegen.

From 40a6ca7ff71bbf344cc43fc0b2fdf39cbbb73d47 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 31 May 2024 12:39:20 +0200
Subject: [PATCH 46/91] Update backend/corpora/ublad/description/ublad.md

Co-authored-by: Jelte van Boheemen <j.vanboheemen@uu.nl>
---
 backend/corpora/ublad/description/ublad.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/backend/corpora/ublad/description/ublad.md b/backend/corpora/ublad/description/ublad.md
index 90ac008da..197227486 100644
--- a/backend/corpora/ublad/description/ublad.md
+++ b/backend/corpora/ublad/description/ublad.md
@@ -4,4 +4,4 @@ In 1974 veranderde de naam in het _Ublad_. Dat bleef zo tot de universiteit besl
 
 Om alle informatie uit het verleden toegankelijk te maken, heeft het Centre for Digital Humanities samen met de Universiteitsbibliotheek de oude jaargangen gedigitaliseerd. In I-analyzer kunt u alle jaargangen van U utrechtse universitaire reflexen en het Ublad vinden en doorzoeken.
 
-Het onafhankelijke Ublad geeft een kleurrijk verslag van wat er speelde op de universiteit, de stad en het studentenleven door middel van atikelen, foto’s en cartoons. De afbeelding die is gebruikt voor OCR is voor elke pagina bijgevoegd zodat u altijd het originele bronmateriaal kan raadplegen.
+Het onafhankelijke Ublad geeft een kleurrijk verslag van wat er speelde op de universiteit, de stad en het studentenleven door middel van artikelen, foto’s en cartoons. De afbeelding die is gebruikt voor OCR is voor elke pagina bijgevoegd zodat u altijd het originele bronmateriaal kunt raadplegen.

From 4432df9417d388e720e6dab49794cdc1f8629634 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 31 May 2024 14:04:21 +0200
Subject: [PATCH 47/91] use extract instead of transform_soup_func for ublad

---
 backend/corpora/ublad/ublad.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index fad1898c7..376339386 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -36,8 +36,7 @@ def transform_content(soup):
                     paragraph_text += item + ' '
             if paragraph_text:
                 page_text += paragraph_text + '\n\n'
-    page_node = BeautifulSoup(page_text, 'html.parser')
-    return page_node
+    return page_text
 
 
 class UBlad(HTMLCorpusDefinition):
@@ -94,7 +93,7 @@ def sources(self, start=min_date, end=max_date):
                                        recursive=True,
                                        multiple=False,
                                        flatten=False,
-                                       transform_soup_func=transform_content,
+                                       extract_soup_func=transform_content,
                                        attribute_filter={
                                             'attribute': 'class',
                                             'value': 'ocr_page'

From fd1d4df509f7f606580141b1a2821f8a6becbae7 Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Fri, 31 May 2024 14:18:23 +0200
Subject: [PATCH 48/91] add es_mappings

---
 backend/corpora/ublad/ublad.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 376339386..2c1913d52 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -126,6 +126,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Volume ID',
             description='Unique identifier for this volume',
             hidden=True,
+            es_mapping=keyword_mapping(),
             extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
                 'value': 'identifier_ocn'
@@ -148,6 +149,7 @@ def sources(self, start=min_date, end=max_date):
             display_name='Edition',
             description='The number of the edition in this volume. Every year starts at 1.',
             sortable=True,
+            es_mapping = keyword_mapping(),
             extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
                 'value': 'aflevering'
@@ -161,6 +163,7 @@ def sources(self, start=min_date, end=max_date):
             results_overview=True,
             csv_core=True,
             description='The volume number of this publication. There is one volume per year.',
+            es_mapping=keyword_mapping(),
             extractor = FilterAttribute(tag='meta', attribute='content', attribute_filter={
                 'attribute': 'name',
                 'value': 'yearstring'

From 0e9e61639368717cb21578932d6de9e79c307a82 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Wed, 12 Jun 2024 17:50:09 +0200
Subject: [PATCH 49/91] Use correct options in ngram compensation dropdown

Resolves #1594
---
 frontend/src/app/visualization/ngram/ngram.component.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/app/visualization/ngram/ngram.component.html b/frontend/src/app/visualization/ngram/ngram.component.html
index cc49268ee..c7c191b4f 100644
--- a/frontend/src/app/visualization/ngram/ngram.component.html
+++ b/frontend/src/app/visualization/ngram/ngram.component.html
@@ -52,7 +52,7 @@
                         (onChange)="onParameterChange('freqCompensation', $event.value)">
                         <span iaDropdownLabel>{{currentFreqCompensationOption?.label}}</span>
                         <div iaDropdownMenu>
-                            <a *ngFor="let option of positionsOptions"
+                            <a *ngFor="let option of freqCompensationOptions"
                                 iaDropdownItem [value]="option">
                                 {{option.label}}
                             </a>

From 212ed798b125a08897846c2c30bf25f6668e123d Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 18 Jun 2024 14:44:04 +0200
Subject: [PATCH 50/91] change locales within date_transform method

remove locale switching from global environment

PR feedback
---
 backend/corpora/ublad/ublad.py | 22 +++++++++++++++++-----
 backend/es/es_index.py         | 13 -------------
 2 files changed, 17 insertions(+), 18 deletions(-)

diff --git a/backend/corpora/ublad/ublad.py b/backend/corpora/ublad/ublad.py
index 2c1913d52..ec340eb9c 100644
--- a/backend/corpora/ublad/ublad.py
+++ b/backend/corpora/ublad/ublad.py
@@ -1,7 +1,8 @@
 from datetime import datetime
 import os
 from os.path import join, splitext
-
+import locale
+import logging
 
 from django.conf import settings
 from addcorpus.python_corpora.corpus import HTMLCorpusDefinition, FieldDefinition
@@ -38,6 +39,18 @@ def transform_content(soup):
                 page_text += paragraph_text + '\n\n'
     return page_text
 
+def transform_date(date_string):
+    try:
+        locale.setlocale(locale.LC_ALL, 'nl_NL.UTF-8')
+        date = datetime.strptime(date_string, '%d %B %Y').strftime('%Y-%m-%d')
+        locale.setlocale(locale.LC_ALL, '')
+        return date
+    except ValueError:
+        logger.error("Unable to get date from {}".format(date_string))
+        return None
+
+
+logger = logging.getLogger('indexing')
 
 class UBlad(HTMLCorpusDefinition):
     title = 'U-Blad'
@@ -49,8 +62,8 @@ class UBlad(HTMLCorpusDefinition):
     data_directory = settings.UBLAD_DATA
     es_index = getattr(settings, 'UBLAD_ES_INDEX', 'ublad')
     image = 'ublad.jpg'
-    scan_image_type = getattr(settings, 'UBLAD_SCAN_IMAGE_TYPE', 'image/jpeg')
-    allow_image_download = getattr(settings, 'UBLAD_ALLOW_IMAGE_DOWNLOAD', True)
+    scan_image_type = 'image/jpeg'
+    allow_image_download = True
 
     document_context = {
         'context_fields': ['volume_id'],
@@ -189,8 +202,7 @@ def sources(self, start=min_date, end=max_date):
                 'attribute': 'name',
                 'value': 'datestring',
                 },
-                transform=lambda x: datetime.strptime(
-                    x, '%d %B %Y').strftime('%Y-%m-%d')
+                transform=transform_date
             )
         ),
         FieldDefinition(
diff --git a/backend/es/es_index.py b/backend/es/es_index.py
index cb6fa9dd3..cce3b7fc8 100644
--- a/backend/es/es_index.py
+++ b/backend/es/es_index.py
@@ -14,8 +14,6 @@
 from ianalyzer.elasticsearch import elasticsearch
 from .es_alias import alias, get_new_version_number
 
-import locale
-
 import logging
 logger = logging.getLogger('indexing')
 
@@ -96,14 +94,6 @@ def populate(client, corpus_name, corpus_definition, start=None, end=None):
     corpus_server = settings.SERVERS[
         settings.CORPUS_SERVER_NAMES.get(corpus_name, 'default')]
 
-    # set corpus-specific locale
-    try:
-        corpus_locale = settings.CORPORA_LOCALES[corpus_name]
-        if corpus_locale:
-            locale.setlocale(locale.LC_ALL, corpus_locale)
-    except:
-        pass
-
     # Do bulk operation
     for success, info in es_helpers.streaming_bulk(
         client,
@@ -114,9 +104,6 @@ def populate(client, corpus_name, corpus_definition, start=None, end=None):
         if not success:
             logger.error(f"FAILED INDEX: {info}")
 
-    #revert back to default locale
-    locale.setlocale(locale.LC_ALL, '')
-
 def perform_indexing(corpus_name, corpus_definition, start, end, mappings_only, add, clear, prod, rollover):
     logger.info('Started indexing `{}` from {} to {}...'.format(
         corpus_definition.es_index,

From 78d64bc641eb155bfc764c0d812e0670be2d96ab Mon Sep 17 00:00:00 2001
From: Meesch <31687030+Meesch@users.noreply.github.com>
Date: Tue, 18 Jun 2024 15:04:31 +0200
Subject: [PATCH 51/91] add test for transform_date

add skip logic for ublad test

install language pack in test

update test settings
---
 backend/corpora/ublad/tests/test_ublad.py | 14 ++++++++++++++
 backend/ianalyzer/settings_test.py        |  2 ++
 2 files changed, 16 insertions(+)
 create mode 100644 backend/corpora/ublad/tests/test_ublad.py

diff --git a/backend/corpora/ublad/tests/test_ublad.py b/backend/corpora/ublad/tests/test_ublad.py
new file mode 100644
index 000000000..fca9cc6c5
--- /dev/null
+++ b/backend/corpora/ublad/tests/test_ublad.py
@@ -0,0 +1,14 @@
+import locale
+import pytest
+from corpora.ublad.ublad import transform_date
+import datetime
+
+
+def test_transform_date():
+    datestring = '6 september 2007'
+    goal_date = datetime.date(2007, 9, 6)
+    try:
+        date = transform_date(datestring)
+    except locale.Error:
+        pytest.skip('Dutch Locale not installed in environment')
+    assert date == str(goal_date)
diff --git a/backend/ianalyzer/settings_test.py b/backend/ianalyzer/settings_test.py
index a3f013c2b..a9974627e 100644
--- a/backend/ianalyzer/settings_test.py
+++ b/backend/ianalyzer/settings_test.py
@@ -17,4 +17,6 @@ def test_corpus_path(*path):
 TIMES_DATA = os.path.join(BASE_DIR, 'addcorpus', 'python_corpora', 'tests')
 TIMES_ES_INDEX = 'times-test'
 
+UBLAD_DATA = '' # necessary to make ublad test not fail
+
 SERVERS['default']['index_prefix'] = 'test'

From 2195439d384ab3276f9ff03e5761107a7b323dc0 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Wed, 19 Jun 2024 11:15:53 +0200
Subject: [PATCH 52/91] Version bump 5.8.0

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 26128bab2..cde1022fb 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "i-analyzer",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "license": "MIT",
   "scripts": {
     "postinstall": "yarn install-back && yarn install-front",

From 4084a989eb6860bdc580d11e27a86e65c9bdb916 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Wed, 19 Jun 2024 11:17:31 +0200
Subject: [PATCH 53/91] Update CITATION.cff for 5.8.0

---
 CITATION.cff | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CITATION.cff b/CITATION.cff
index a02132bfe..b5cd0a0b8 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -35,5 +35,5 @@ keywords:
   - elasticsearch
   - natural language processing
 license: MIT
-version: 5.7.0
-date-released: '2024-06-5'
+version: 5.8.0
+date-released: '2024-06-19'

From 1df805054860f0132cc14eb0e668d3a2de0d5b4f Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Fri, 26 Apr 2024 16:43:51 +0200
Subject: [PATCH 54/91] add toggle component

---
 .../document-popup.component.html             |  6 +-
 .../document-popup.component.ts               |  8 ++-
 .../app/search/search-results.component.html  |  1 +
 frontend/src/app/shared/shared.module.ts      |  3 +
 .../app/shared/toggle/toggle.component.html   |  4 ++
 .../app/shared/toggle/toggle.component.scss   | 68 +++++++++++++++++++
 .../shared/toggle/toggle.component.spec.ts    | 25 +++++++
 .../src/app/shared/toggle/toggle.component.ts | 22 ++++++
 8 files changed, 134 insertions(+), 3 deletions(-)
 create mode 100644 frontend/src/app/shared/toggle/toggle.component.html
 create mode 100644 frontend/src/app/shared/toggle/toggle.component.scss
 create mode 100644 frontend/src/app/shared/toggle/toggle.component.spec.ts
 create mode 100644 frontend/src/app/shared/toggle/toggle.component.ts

diff --git a/frontend/src/app/document/document-popup/document-popup.component.html b/frontend/src/app/document/document-popup/document-popup.component.html
index 6f379e664..49976a19c 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.html
+++ b/frontend/src/app/document/document-popup/document-popup.component.html
@@ -1,7 +1,9 @@
 <ng-container *ngIf="document">
     <p-dialog [(visible)]="visible" width="100%"
-        [responsive]="true" [maximizable]="true" [dismissableMask]="true" [draggable]="true" [resizable]="false" [blockScroll]="true"
-        header="Document {{document.position}} of {{page.total}}">
+        [responsive]="true" [maximizable]="true" [dismissableMask]="true" [draggable]="true" [resizable]="false" [blockScroll]="true">
+        <ng-template pTemplate="header">
+            <span>Document {{document.position}} of {{page.total}}</span>
+        </ng-template>
 
         <ia-document-view [document]="document" [queryModel]="queryModel" [corpus]="document.corpus" [view]="view"></ia-document-view>
 
diff --git a/frontend/src/app/document/document-popup/document-popup.component.ts b/frontend/src/app/document/document-popup/document-popup.component.ts
index 98109ffa5..1a99c58d5 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.ts
+++ b/frontend/src/app/document/document-popup/document-popup.component.ts
@@ -4,7 +4,7 @@ import { takeUntil } from 'rxjs/operators';
 import * as _ from 'lodash';
 import { FoundDocument, QueryModel } from '../../models';
 import { Subject } from 'rxjs';
-import { documentIcons, actionIcons } from '../../shared/icons';
+import { documentIcons, actionIcons, corpusIcons } from '../../shared/icons';
 
 @Component({
     selector: 'ia-document-popup',
@@ -23,6 +23,8 @@ export class DocumentPopupComponent implements OnChanges, OnDestroy {
     actionIcons = actionIcons;
     documentIcons = documentIcons;
 
+    showNamedEntities = false;
+
     private refresh$ = new Subject<void>();
 
     get documentPageLink(): string[] {
@@ -63,4 +65,8 @@ export class DocumentPopupComponent implements OnChanges, OnDestroy {
             this.visible = false;
         }
     }
+
+    toggleNER(): void {
+        this.showNamedEntities = !this.showNamedEntities;
+    }
 }
diff --git a/frontend/src/app/search/search-results.component.html b/frontend/src/app/search/search-results.component.html
index 2d26d15d6..26d6abeb5 100644
--- a/frontend/src/app/search/search-results.component.html
+++ b/frontend/src/app/search/search-results.component.html
@@ -9,6 +9,7 @@ <h2 class="subtitle" *ngIf="page.total > 5">
             -
             {{(pageResults.to$ | async)}}
         </h2>
+        <h2>NER<ia-toggle></ia-toggle></h2>
         <ia-highlight-selector *ngIf="!pageResults.highlightDisabled" [pageResults]="pageResults"></ia-highlight-selector>
     </div>
 
diff --git a/frontend/src/app/shared/shared.module.ts b/frontend/src/app/shared/shared.module.ts
index b19f89b05..2f9c77425 100644
--- a/frontend/src/app/shared/shared.module.ts
+++ b/frontend/src/app/shared/shared.module.ts
@@ -15,6 +15,7 @@ import { ScrollToDirective } from '../scroll-to.directive';
 import { DropdownModule } from './dropdown/dropdown.module';
 import { TabPanelDirective } from './tabs/tab-panel.directive';
 import { TabsComponent } from './tabs/tabs.component';
+import { ToggleComponent } from './toggle/toggle.component';
 
 @NgModule({
     declarations: [
@@ -24,6 +25,7 @@ import { TabsComponent } from './tabs/tabs.component';
         ScrollToDirective,
         TabsComponent,
         TabPanelDirective,
+        ToggleComponent,
     ],
     exports: [
         // shared components
@@ -45,6 +47,7 @@ import { TabsComponent } from './tabs/tabs.component';
         HttpClientXsrfModule,
         RouterModule,
         TableModule,
+        ToggleComponent,
     ],
     imports: [
         BrowserAnimationsModule,
diff --git a/frontend/src/app/shared/toggle/toggle.component.html b/frontend/src/app/shared/toggle/toggle.component.html
new file mode 100644
index 000000000..64fafd1de
--- /dev/null
+++ b/frontend/src/app/shared/toggle/toggle.component.html
@@ -0,0 +1,4 @@
+<div class="toggle-container">
+    <input type="checkbox" (click)="toggleButton()"/>
+    <label class="slider"></label>
+</div>
\ No newline at end of file
diff --git a/frontend/src/app/shared/toggle/toggle.component.scss b/frontend/src/app/shared/toggle/toggle.component.scss
new file mode 100644
index 000000000..7ca30a115
--- /dev/null
+++ b/frontend/src/app/shared/toggle/toggle.component.scss
@@ -0,0 +1,68 @@
+@import "../../../_utilities";
+
+/* The switch - the box around the slider */
+.toggle-container {
+    position: absolute;
+    margin-left: .5rem;
+    margin-top: -.2rem;
+    display: inline-block;
+    width: 4rem;
+    height: 2rem;
+    pointer-events: none;
+
+    /* Hide default HTML checkbox */
+    input {
+        opacity: 0;
+        width: 100%;
+        height: 100%;
+        pointer-events: all;
+    }
+}
+
+
+/* The slider */
+.slider {
+    position: absolute;
+    cursor: pointer;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background-color: $highlight-color;
+    transition: .4s;
+    border-radius: 35px;
+    pointer-events: none;
+    &:before {
+        content: "";
+        z-index: 20;
+        position: absolute;
+        height: 1.6rem;
+        width: 1.6rem;
+        left: .2rem;
+        bottom: .2rem;
+        background-color: white;
+        transition: .4s;
+        border-radius: 50%;
+    }
+}
+
+
+
+input:checked {
+    + .slider {
+        background-color: $primary;
+    }
+
+    + .slider:before {
+        transform: translateX(2rem);
+        -webkit-transform: translateX(2rem);
+        -moz-transform: translateX(2rem);
+        -ms-transform: translateX(2rem);
+        -o-transform: translateX(2rem);
+    }
+    
+    + .slider:after {
+        left: calc(100% - 5px);
+        transform: translateX(-100%);
+    }
+}
\ No newline at end of file
diff --git a/frontend/src/app/shared/toggle/toggle.component.spec.ts b/frontend/src/app/shared/toggle/toggle.component.spec.ts
new file mode 100644
index 000000000..301ab008b
--- /dev/null
+++ b/frontend/src/app/shared/toggle/toggle.component.spec.ts
@@ -0,0 +1,25 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { ToggleComponent } from './toggle.component';
+
+describe('ToggleComponent', () => {
+  let component: ToggleComponent;
+  let fixture: ComponentFixture<ToggleComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [ ToggleComponent ]
+    })
+    .compileComponents();
+  });
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(ToggleComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});
diff --git a/frontend/src/app/shared/toggle/toggle.component.ts b/frontend/src/app/shared/toggle/toggle.component.ts
new file mode 100644
index 000000000..13194c3c8
--- /dev/null
+++ b/frontend/src/app/shared/toggle/toggle.component.ts
@@ -0,0 +1,22 @@
+import { Component, EventEmitter, OnInit, Output } from '@angular/core';
+
+@Component({
+  selector: 'ia-toggle',
+  templateUrl: './toggle.component.html',
+  styleUrls: ['./toggle.component.scss']
+})
+export class ToggleComponent implements OnInit {
+  @Output() toggled = new EventEmitter<boolean>();
+  active = false;
+
+  constructor() { }
+
+  ngOnInit(): void {
+  }
+
+  public toggleButton() {
+    this.active = !this.active;
+    this.toggled.emit(this.active);
+  }
+
+}

From b043b8a7f57d8afb471dc72bc37cc564fd936b7c Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 19 Jun 2024 17:59:54 +0200
Subject: [PATCH 55/91] use toggle in document-popup

---
 frontend/src/app/document-view/document-view.component.html   | 4 ++--
 frontend/src/app/document-view/document-view.component.ts     | 3 +++
 .../app/document/document-popup/document-popup.component.html | 3 ++-
 .../app/document/document-popup/document-popup.component.ts   | 4 ++--
 frontend/src/app/search/search-results.component.html         | 1 -
 5 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index 9314fe57a..ce83d7098 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -38,7 +38,7 @@
         <div class="box">
             <ia-tabs [activeTab]="activeTab">
                 <ng-template iaTabPanel *ngFor="let field of contentFields" [id]="field.name" [title]="field.displayName" [icon]="documentIcons.text">
-                    <div *ngIf="document.annotations$ | async" class="content"
+                    <div *ngIf="showEntities && document.annotations$ | async; else showHighlights" class="content"
                         [attr.lang]="document.language(field)"
                         [innerHtml]="document.annotations$ | async | entity:document:field.name">
                     </div>
@@ -48,7 +48,7 @@
                             [innerHtml]="field | elasticsearchHighlight:document">
                         </div>
                     </ng-template>
-                    <ia-entity-legend [entities]="document.entities"></ia-entity-legend>
+                    <ia-entity-legend *ngIf="showEntities" [entities]="document.entities"></ia-entity-legend>
                 </ng-template>
                 <ng-template iaTabPanel id="scan" *ngIf="showScanTab" title="Image" [icon]="documentIcons.scan">
                     <ia-image-view [corpus]="corpus" [document]="document"></ia-image-view>
diff --git a/frontend/src/app/document-view/document-view.component.ts b/frontend/src/app/document-view/document-view.component.ts
index a1fd4f8c2..438caa8f1 100644
--- a/frontend/src/app/document-view/document-view.component.ts
+++ b/frontend/src/app/document-view/document-view.component.ts
@@ -24,6 +24,9 @@ export class DocumentViewComponent implements OnChanges {
     @Input()
     public view: DocumentView;
 
+    @Input()
+    public showEntities: boolean;
+
     documentIcons = documentIcons;
 
     /** active tab on opening */
diff --git a/frontend/src/app/document/document-popup/document-popup.component.html b/frontend/src/app/document/document-popup/document-popup.component.html
index 49976a19c..501c025f5 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.html
+++ b/frontend/src/app/document/document-popup/document-popup.component.html
@@ -3,9 +3,10 @@
         [responsive]="true" [maximizable]="true" [dismissableMask]="true" [draggable]="true" [resizable]="false" [blockScroll]="true">
         <ng-template pTemplate="header">
             <span>Document {{document.position}} of {{page.total}}</span>
+            <span iaBalloon="Show named entities for this document">NER<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></span>
         </ng-template>
 
-        <ia-document-view [document]="document" [queryModel]="queryModel" [corpus]="document.corpus" [view]="view"></ia-document-view>
+        <ia-document-view [document]="document" [queryModel]="queryModel" [corpus]="document.corpus" [view]="view" [showEntities]="showNamedEntities"></ia-document-view>
 
         <ng-template pTemplate="footer">
             <div class="columns" style="text-align:left">
diff --git a/frontend/src/app/document/document-popup/document-popup.component.ts b/frontend/src/app/document/document-popup/document-popup.component.ts
index 1a99c58d5..7ff4b6351 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.ts
+++ b/frontend/src/app/document/document-popup/document-popup.component.ts
@@ -66,7 +66,7 @@ export class DocumentPopupComponent implements OnChanges, OnDestroy {
         }
     }
 
-    toggleNER(): void {
-        this.showNamedEntities = !this.showNamedEntities;
+    toggleNER(active: boolean): void {
+        this.showNamedEntities = active;
     }
 }
diff --git a/frontend/src/app/search/search-results.component.html b/frontend/src/app/search/search-results.component.html
index 26d6abeb5..2d26d15d6 100644
--- a/frontend/src/app/search/search-results.component.html
+++ b/frontend/src/app/search/search-results.component.html
@@ -9,7 +9,6 @@ <h2 class="subtitle" *ngIf="page.total > 5">
             -
             {{(pageResults.to$ | async)}}
         </h2>
-        <h2>NER<ia-toggle></ia-toggle></h2>
         <ia-highlight-selector *ngIf="!pageResults.highlightDisabled" [pageResults]="pageResults"></ia-highlight-selector>
     </div>
 

From c0133955725f92b63c12e72896164bdff9de0571 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 19 Jun 2024 18:00:18 +0200
Subject: [PATCH 56/91] simplify unpacking named_entities response

---
 frontend/src/app/models/found-document.ts   | 10 ++++------
 frontend/src/app/services/entity.service.ts |  4 +---
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index 744bddc01..ddbc45675 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -126,13 +126,11 @@ export class FoundDocument {
 
     private fetchAnnotatedEntities(): Observable<{[fieldName: string]: string}[]> {
         const response$ = this.entityService.getDocumentEntities(this.corpus, this.id);
-        response$.pipe(
-            map( response => response.entities )
-        ).toPromise().then((entities) => {
-            this.entities = entities;
-        });
         return response$.pipe(
-            map( response => response.annotations || [])
+            map( response => {
+                this.entities = response.entities;
+                return response.annotations || [];
+            })
         );
     }
 
diff --git a/frontend/src/app/services/entity.service.ts b/frontend/src/app/services/entity.service.ts
index 5d8a35f0a..d740438a7 100644
--- a/frontend/src/app/services/entity.service.ts
+++ b/frontend/src/app/services/entity.service.ts
@@ -15,8 +15,6 @@ export class EntityService {
 
     public getDocumentEntities(corpus: Corpus, id: string): Observable<NamedEntitiesResult> {
         const url = `/api/es/${corpus.name}/${id}/named_entities`;
-        return this.http.get<NamedEntitiesResult>(url).pipe(
-            take(1),
-        );
+        return this.http.get<NamedEntitiesResult>(url);
     }
 }

From 2357d11a8a7f78757d8b36132027c6cc025ecc59 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Thu, 20 Jun 2024 14:02:27 +0200
Subject: [PATCH 57/91] Remove IsAuthenticated permission from media views

Resolves #1612
---
 backend/media/views.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/backend/media/views.py b/backend/media/views.py
index 25fa5f910..2ee55d162 100644
--- a/backend/media/views.py
+++ b/backend/media/views.py
@@ -19,7 +19,7 @@ class GetMediaView(APIView):
     Return the image/pdf of a document
     '''
 
-    permission_classes = [IsAuthenticated, CorpusAccessPermission]
+    permission_classes = (CorpusAccessPermission,)
 
     def get(self, request, *args, **kwargs):
         corpus_name = corpus_name_from_request(request)
@@ -60,7 +60,7 @@ class MediaMetadataView(APIView):
     Return metadata on the media for a document
     '''
 
-    permission_classes = [IsAuthenticated, CorpusAccessPermission]
+    permission_classes = (CorpusAccessPermission,)
 
     def post(self, request, *args, **kwargs):
         corpus_name = corpus_name_from_request(request)

From 666d9d364f55423dc4d30d3fbba8092751538107 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 20 Jun 2024 17:35:23 +0200
Subject: [PATCH 58/91] adjust colour palette

---
 frontend/src/_utilities.scss | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/src/_utilities.scss b/frontend/src/_utilities.scss
index 3a77ecb6e..6de7fcc9f 100644
--- a/frontend/src/_utilities.scss
+++ b/frontend/src/_utilities.scss
@@ -30,10 +30,10 @@ $section-padding:	3rem 1.5rem;
 $boxShadow: 0 2px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1);
 $boxShadowHover: 0px 5px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px $primary;
 
-$entity-person:  #88CCEE;
-$entity-location:#44AA99;
-$entity-organization: #DDCC77;
-$entity-miscellaneous: #AA4499;
+$entity-person:  #ADDBE0;
+$entity-location: #ADF489;
+$entity-organization: #E6D5A8;
+$entity-miscellaneous: #EF9AB4;
 
 @import "bulma/sass/utilities/_all";
 

From 22fcda6f0ef4057d42532a4d46eb7ac52793ea70 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 20 Jun 2024 18:45:45 +0200
Subject: [PATCH 59/91] fix: remove snippets test for highlight service

---
 .../app/services/highlight.service.spec.ts    | 37 -------------------
 .../src/app/services/highlight.service.ts     |  1 -
 2 files changed, 38 deletions(-)

diff --git a/frontend/src/app/services/highlight.service.spec.ts b/frontend/src/app/services/highlight.service.spec.ts
index 2eb8aa049..0f50f0cfb 100644
--- a/frontend/src/app/services/highlight.service.spec.ts
+++ b/frontend/src/app/services/highlight.service.spec.ts
@@ -90,43 +90,6 @@ describe('HighlightService', () => {
             [13, 'في']]);
     });
 
-    it('Should limit the length of hits using snippets', () => {
-        const text = generateSequence(0, 10000);
-        const remainingLength = (maxSnippetsLength - 4) * 0.5;
-        const leftLength = Math.ceil(remainingLength);
-        const rightLength = Math.floor(remainingLength);
-        const sequenceSnippetsLength = Math.ceil(leftLength / 5);
-
-        const highlights = highlightService.highlight(text, '5000');
-        const snippets = highlightService.snippets(highlights);
-
-        const result = getHighlightedString(snippets);
-        const expected = getHighlightedString([
-            {
-                substring: omissionString + generateSequence(5000 - sequenceSnippetsLength, 5000).slice(-leftLength + 1) + ' ',
-                isHit: false
-            },
-            {
-                substring: '5000',
-                isHit: true
-            },
-            {
-                substring: ' ' + generateSequence(5001, 5001 + sequenceSnippetsLength).substr(0, rightLength - 1) + omissionString,
-                isHit: false
-            }]);
-
-        expect(result).toEqual(expected);
-    });
-
-    it('Should pass short snippets', () => {
-        const highlights = highlightService.highlight('hello world!', '');
-        const snippets = highlightService.snippets(highlights);
-        expect(snippets).toEqual([{
-            isHit: false,
-            substring: 'hello world!'
-        }]);
-    });
-
     it('Should highlight multiline text', () => {
         expectHighlights(
             // eslint-disable-next-line max-len
diff --git a/frontend/src/app/services/highlight.service.ts b/frontend/src/app/services/highlight.service.ts
index 3ee28b96c..e4bc31941 100644
--- a/frontend/src/app/services/highlight.service.ts
+++ b/frontend/src/app/services/highlight.service.ts
@@ -49,7 +49,6 @@ export class HighlightService {
         }
 
         let result: RegExpExecArray;
-        const parsedText: TextPart[] = [];
         let lastIndex = 0;
 
         for (

From f9c117a0cd6ca5483156db2be6a3263db6a20bc4 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 20 Jun 2024 22:34:22 +0200
Subject: [PATCH 60/91] fix backend tests

---
 backend/es/conftest.py                       | 24 ++++++--------------
 backend/es/tests/test_named_entity_search.py |  7 +++---
 2 files changed, 10 insertions(+), 21 deletions(-)

diff --git a/backend/es/conftest.py b/backend/es/conftest.py
index 46a5da917..4545a2801 100644
--- a/backend/es/conftest.py
+++ b/backend/es/conftest.py
@@ -1,4 +1,6 @@
 import pytest
+from time import sleep
+
 from django.contrib.auth.models import Group
 
 from addcorpus.python_corpora.load_corpus import load_corpus_definition
@@ -17,21 +19,18 @@ def corpus_definition(mock_corpus):
     yield corpus
 
 
-@pytest.fixture(scope='module')
-def es_ner_search_client(es_client, mock_corpus):
+@pytest.fixture()
+def es_ner_search_client(es_client, basic_mock_corpus, basic_corpus_public, index_basic_mock_corpus):
     """
     Create and populate an index for the mock corpus in elasticsearch.
     Returns an elastic search client for the mock corpus.
     """
-
     # add data from mock corpus
-    corpus = load_corpus_definition(mock_corpus)
-    es_index.create(es_client, corpus, False, True, False)
-    es_index.populate(es_client, mock_corpus, corpus)
-    es_client.indices.put_mapping(index=corpus.es_index, properties={
+    corpus = Corpus.objects.get(name=basic_mock_corpus)
+    es_client.indices.put_mapping(index=corpus.configuration.es_index, properties={
                                   "content_ner": {"type": "annotated_text"}})
 
-    es_client.index(index=corpus.es_index, document={
+    es_client.index(index=corpus.configuration.es_index, document={
         'id': 'my_identifier',
         'content': 'Guybrush Threepwood is looking for treasure on Monkey Island',
         'content_ner': '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'})
@@ -39,16 +38,7 @@ def es_ner_search_client(es_client, mock_corpus):
     # ES is "near real time", so give it a second before we start searching the index
     sleep(1)
     yield es_client
-    # delete index when done
-    es_client.indices.delete(index='times-test')
-
 
-@pytest.fixture()
-def basic_corpus_index(es_client, basic_corpus):
-    corpus = load_corpus_definition(basic_corpus)
-    es_index.create(es_client, corpus, False, True, False)
-    yield es_client
-    es_client.indices.delete(index=corpus.es_index)
 
 @pytest.fixture()
 def es_index_client(es_client, mock_corpus):
diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
index 81afc8460..a6dde20dc 100644
--- a/backend/es/tests/test_named_entity_search.py
+++ b/backend/es/tests/test_named_entity_search.py
@@ -1,9 +1,8 @@
 from es.views import NamedEntitySearchView
 
 
-def test_ner_search_view(es_ner_search_client, client, times_user):
-    client.force_login(times_user)
-    route = '/api/es/times/my_identifier/named_entities'
+def test_ner_search_view(es_ner_search_client, client):
+    route = '/api/es/mock-csv-corpus/my_identifier/named_entities'
     response = client.get(route, content_type='application/json')
     assert response.status_code == 200
 
@@ -34,7 +33,7 @@ def test_construct_ner_query():
 def test_find_named_entity_fields(es_ner_search_client):
     viewset = NamedEntitySearchView()
     fields = viewset.find_named_entity_fields(
-        es_ner_search_client, 'times-test')
+        es_ner_search_client, 'test-basic-corpus')
     assert len(fields) == 1
     assert fields[0] == 'content_ner'
 

From 9b1bf19fd16e2560ba029ad0b3c763f22e4f98a5 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Fri, 21 Jun 2024 11:52:49 +0200
Subject: [PATCH 61/91] fix frontend tests: remove circular imports

---
 frontend/src/app/common-test-bed.ts               |  9 ++++++++-
 frontend/src/app/models/found-document.spec.ts    | 15 ++++++++-------
 .../app/services/elastic-search.service.spec.ts   |  8 ++++++--
 frontend/src/app/services/entity.service.ts       |  1 -
 frontend/src/mock-data/constructor-helpers.ts     |  6 +++---
 frontend/src/mock-data/elastic-search.ts          |  2 +-
 frontend/src/mock-data/entity.ts                  | 11 +++++++++++
 7 files changed, 37 insertions(+), 15 deletions(-)
 create mode 100644 frontend/src/mock-data/entity.ts

diff --git a/frontend/src/app/common-test-bed.ts b/frontend/src/app/common-test-bed.ts
index 25de1b887..eecd514e4 100644
--- a/frontend/src/app/common-test-bed.ts
+++ b/frontend/src/app/common-test-bed.ts
@@ -10,9 +10,12 @@ import { AuthServiceMock } from '../mock-data/auth';
 import { CorpusServiceMock } from '../mock-data/corpus';
 import { DialogServiceMock } from '../mock-data/dialog';
 import { ElasticSearchServiceMock } from '../mock-data/elastic-search';
+import { EntityServiceMock } from '../mock-data/entity';
 import { MockCorpusResponse } from '../mock-data/corpus-response';
 import { SearchServiceMock } from '../mock-data/search';
-import { ApiService, AuthService, CorpusService, DialogService, ElasticSearchService, SearchService } from './services';
+import { ApiService, AuthService, CorpusService, DialogService, SearchService } from './services';
+import { ElasticSearchService } from './services/elastic-search.service';
+import { EntityService } from './services/entity.service';
 import { WordmodelsService } from './services/wordmodels.service';
 import { WordmodelsServiceMock } from '../mock-data/wordmodels';
 import { VisualizationService } from './services/visualization.service';
@@ -49,6 +52,10 @@ export const commonTestBed = () => {
             provide: ElasticSearchService,
             useValue: new ElasticSearchServiceMock(),
         },
+        {
+            provide: EntityService,
+            useValue: new EntityServiceMock(),
+        },
         {
             provide: ElementRef,
             useClass: MockElementRef,
diff --git a/frontend/src/app/models/found-document.spec.ts b/frontend/src/app/models/found-document.spec.ts
index 5c467de18..2c2a21cd6 100644
--- a/frontend/src/app/models/found-document.spec.ts
+++ b/frontend/src/app/models/found-document.spec.ts
@@ -4,12 +4,13 @@ import { reduce, take } from 'rxjs/operators';
 import { Observable } from 'rxjs';
 import { makeDocument } from '../../mock-data/constructor-helpers';
 import { mockCorpus, mockCorpus3 } from '../../mock-data/corpus';
+import { EntityServiceMock } from '../../mock-data/entity';
+import { TagServiceMock, mockTags } from '../../mock-data/tag';
 import { FoundDocument } from './found-document';
+import { EntityService } from '../services/entity.service';
 import { TagService } from '../services/tag.service';
-import { TagServiceMock, mockTags } from '../../mock-data/tag';
 import { Tag } from './tag';
-import { ElasticSearchService } from '../services';
-import { ElasticSearchServiceMock } from '../../mock-data/elastic-search';
+
 
 const maxScore = 2.9113607;
 const mockResponse = {
@@ -36,19 +37,19 @@ const mockResponse = {
 
 fdescribe('FoundDocument', () => {
     const mockTagService = new TagServiceMock() as any;
-    const mockElasticService = new ElasticSearchServiceMock() as any;
+    const mockEntityService = new EntityServiceMock() as any;
 
     beforeEach(() => {
         TestBed.configureTestingModule({
             providers: [
                 { provide: TagService, useClass: TagServiceMock },
-                { provide: ElasticSearchService, useClass: ElasticSearchServiceMock }
+                { provide: EntityService, useClass: EntityServiceMock }
             ]
         });
     });
 
     fit('should construct from an elasticsearch response', () => {
-        const document = new FoundDocument(mockTagService, mockElasticService, mockCorpus, mockResponse, maxScore);
+        const document = new FoundDocument(mockTagService, mockEntityService, mockCorpus, mockResponse, maxScore);
 
         expect(document.id).toBe('1994_troonrede');
         expect(document.fieldValues['monarch']).toBe('Beatrix');
@@ -110,7 +111,7 @@ fdescribe('FoundDocument', () => {
                 ]
             }
         };
-        const document = new FoundDocument(mockTagService, mockElasticService, mockCorpus, searchResponse, maxScore);
+        const document = new FoundDocument(mockTagService, mockEntityService, mockCorpus, searchResponse, maxScore);
         expect(document.fieldValues['content']).toEqual(
             '<mark class="entity-per">Wally</mark> was last seen in <mark class="entity-loc">Paris</mark>');
     }));
diff --git a/frontend/src/app/services/elastic-search.service.spec.ts b/frontend/src/app/services/elastic-search.service.spec.ts
index 53841cc52..e1ace87e8 100644
--- a/frontend/src/app/services/elastic-search.service.spec.ts
+++ b/frontend/src/app/services/elastic-search.service.spec.ts
@@ -3,9 +3,12 @@ import { HttpClientTestingModule, HttpTestingController } from '@angular/common/
 import { ElasticSearchService, SearchResponse } from './elastic-search.service';
 import { QueryModel } from '../models';
 import { mockCorpus, mockField, mockField2 } from '../../mock-data/corpus';
-import { TagService } from './tag.service';
+import { EntityService } from './entity.service';
+import { EntityServiceMock } from '../../mock-data/entity';
 import { TagServiceMock } from '../../mock-data/tag';
-import { Aggregator, TermsAggregator } from '../models/aggregation';
+import { TagService } from './tag.service';
+import { TermsAggregator } from '../models/aggregation';
+
 
 const mockResponse: SearchResponse = {
     took: 4,
@@ -65,6 +68,7 @@ describe('ElasticSearchService', () => {
         TestBed.configureTestingModule({
             providers: [
                 ElasticSearchService,
+                { provide: EntityService, useValue: new EntityServiceMock()},
                 { provide: TagService, useValue: new TagServiceMock() }
             ],
             imports: [ HttpClientTestingModule ]
diff --git a/frontend/src/app/services/entity.service.ts b/frontend/src/app/services/entity.service.ts
index d740438a7..056e1e543 100644
--- a/frontend/src/app/services/entity.service.ts
+++ b/frontend/src/app/services/entity.service.ts
@@ -3,7 +3,6 @@ import { Injectable } from '@angular/core';
 import { Observable } from 'rxjs';
 
 import { Corpus, NamedEntitiesResult } from '../models';
-import { map, share, shareReplay, take } from 'rxjs/operators';
 
 @Injectable({
     providedIn: 'root',
diff --git a/frontend/src/mock-data/constructor-helpers.ts b/frontend/src/mock-data/constructor-helpers.ts
index 24c17c218..b369eb305 100644
--- a/frontend/src/mock-data/constructor-helpers.ts
+++ b/frontend/src/mock-data/constructor-helpers.ts
@@ -3,10 +3,10 @@
 import { Corpus, FieldValues, FoundDocument, HighlightResult, SearchHit } from '../app/models';
 import { mockCorpus } from './corpus';
 import { TagServiceMock } from './tag';
-import { ElasticSearchServiceMock } from './elastic-search';
+import { EntityServiceMock } from './entity';
 
 const tagService = new TagServiceMock() as any;
-const elasticSearchService = new ElasticSearchServiceMock() as any;
+const entityService = new EntityServiceMock() as any;
 
 export const makeDocument = (
     fieldValues: FieldValues,
@@ -18,6 +18,6 @@ export const makeDocument = (
     const hit: SearchHit = {
         _id: id, _score: relevance, _source: fieldValues, highlight
     };
-    return new FoundDocument(tagService, elasticSearchService, corpus, hit);
+    return new FoundDocument(tagService, entityService, corpus, hit);
 };
 
diff --git a/frontend/src/mock-data/elastic-search.ts b/frontend/src/mock-data/elastic-search.ts
index d9a542f09..c584514ad 100644
--- a/frontend/src/mock-data/elastic-search.ts
+++ b/frontend/src/mock-data/elastic-search.ts
@@ -1,4 +1,4 @@
-import { FoundDocument, NamedEntitiesResult, SearchResults } from '../app/models';
+import { FoundDocument, SearchResults } from '../app/models';
 import { makeDocument } from './constructor-helpers';
 
 export class ElasticSearchServiceMock {
diff --git a/frontend/src/mock-data/entity.ts b/frontend/src/mock-data/entity.ts
new file mode 100644
index 000000000..7f6760916
--- /dev/null
+++ b/frontend/src/mock-data/entity.ts
@@ -0,0 +1,11 @@
+import { of, Observable } from 'rxjs';
+
+import { Corpus, NamedEntitiesResult } from '../app/models';
+
+export class EntityServiceMock {
+
+    public getDocumentEntities(corpus: Corpus, id: string): Observable<NamedEntitiesResult> {
+        return of({annotations: [], entities: []})
+        
+    }
+}

From 9b9785eceb41d6b25f43655974a2602aab3ff41e Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Fri, 21 Jun 2024 21:23:19 +0200
Subject: [PATCH 62/91] fix: move frontend unit test

---
 .../document-view.component.spec.ts           | 21 +++++++++++-------
 .../src/app/models/found-document.spec.ts     | 22 +------------------
 frontend/src/mock-data/entity.ts              |  3 +--
 3 files changed, 15 insertions(+), 31 deletions(-)

diff --git a/frontend/src/app/document-view/document-view.component.spec.ts b/frontend/src/app/document-view/document-view.component.spec.ts
index f59858f51..d669f30af 100644
--- a/frontend/src/app/document-view/document-view.component.spec.ts
+++ b/frontend/src/app/document-view/document-view.component.spec.ts
@@ -1,4 +1,4 @@
-import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+import { ComponentFixture, TestBed, fakeAsync, tick, waitForAsync } from '@angular/core/testing';
 import { By } from '@angular/platform-browser';
 import * as _ from 'lodash';
 import { mockCorpus, mockField } from '../../mock-data/corpus';
@@ -7,6 +7,7 @@ import { commonTestBed } from '../common-test-bed';
 
 import { DocumentViewComponent } from './document-view.component';
 import { makeDocument } from '../../mock-data/constructor-helpers';
+import { of } from 'rxjs';
 
 describe('DocumentViewComponent', () => {
     let component: DocumentViewComponent;
@@ -20,10 +21,9 @@ describe('DocumentViewComponent', () => {
         fixture = TestBed.createComponent(DocumentViewComponent);
         component = fixture.componentInstance;
         component.corpus = _.merge({
-            scanImageType: 'farout_image_type',
-            fields: [mockField]
+            scanImageType: 'farout_image_type'
         }, mockCorpus);
-        component.document = makeDocument({ great_field: 'Hello world!' });
+        component.document = makeDocument({ great_field: 'Hello world!', speech: 'Wally was last seen in Paris' });
         fixture.detectChanges();
     });
 
@@ -31,11 +31,8 @@ describe('DocumentViewComponent', () => {
         expect(component).toBeTruthy();
     });
 
-    it('should render fields', async () => {
-        await fixture.whenStable();
-
+    it('should render fields', () => {
         expect(component.propertyFields).toEqual([mockField]);
-
         const debug = fixture.debugElement.queryAll(By.css('[data-test-field-value]'));
         expect(debug.length).toEqual(1); // number of fields
         const element = debug[0].nativeElement;
@@ -48,4 +45,12 @@ describe('DocumentViewComponent', () => {
         expect(debug[0].attributes['id']).toBe('tab-speech');
         expect(debug[1].attributes['id']).toBe('tab-scan');
     });
+
+    it('shows a named entity legend if showEntities is true', () => {
+        expect(fixture.debugElement.query(By.css('ia-entity-legend'))).toBeFalsy();
+        component.showEntities = true;
+        fixture.detectChanges();
+        expect(fixture.debugElement.query(By.css('ia-entity-legend'))).toBeTruthy();
+    });
+
 });
diff --git a/frontend/src/app/models/found-document.spec.ts b/frontend/src/app/models/found-document.spec.ts
index 2c2a21cd6..b17fe8d38 100644
--- a/frontend/src/app/models/found-document.spec.ts
+++ b/frontend/src/app/models/found-document.spec.ts
@@ -48,7 +48,7 @@ fdescribe('FoundDocument', () => {
         });
     });
 
-    fit('should construct from an elasticsearch response', () => {
+    it('should construct from an elasticsearch response', () => {
         const document = new FoundDocument(mockTagService, mockEntityService, mockCorpus, mockResponse, maxScore);
 
         expect(document.id).toBe('1994_troonrede');
@@ -95,24 +95,4 @@ fdescribe('FoundDocument', () => {
         });
     }));
 
-    it('should fetch and display named entities', fakeAsync(() => {
-        const searchResponse = {
-            _index: 'test_index',
-            _id: 'my_identifier',
-            _score: 2.9113607,
-            _source: {
-                date: '1994-09-20',
-                id: 'my_identifier',
-                content: 'Wally was last seen in Paris.'
-            },
-            highlight: {
-                content: [
-                    '<em>seen</em>'
-                ]
-            }
-        };
-        const document = new FoundDocument(mockTagService, mockEntityService, mockCorpus, searchResponse, maxScore);
-        expect(document.fieldValues['content']).toEqual(
-            '<mark class="entity-per">Wally</mark> was last seen in <mark class="entity-loc">Paris</mark>');
-    }));
 });
diff --git a/frontend/src/mock-data/entity.ts b/frontend/src/mock-data/entity.ts
index 7f6760916..3fefbfc25 100644
--- a/frontend/src/mock-data/entity.ts
+++ b/frontend/src/mock-data/entity.ts
@@ -5,7 +5,6 @@ import { Corpus, NamedEntitiesResult } from '../app/models';
 export class EntityServiceMock {
 
     public getDocumentEntities(corpus: Corpus, id: string): Observable<NamedEntitiesResult> {
-        return of({annotations: [], entities: []})
-        
+        return of({annotations: [{'content': '<span class="entity-person">Wally</span> was last seen in <span class="entity-location">Paris</span>'}], entities: ['location', 'person']})   
     }
 }

From 14756c79621210c3f3454b6586641c2cf3944469 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Mon, 24 Jun 2024 13:37:49 +0200
Subject: [PATCH 63/91] add flag at start of highlight to help colorblind users

---
 .../document/entity-legend/entity-legend.component.scss   | 1 -
 frontend/src/styles.scss                                  | 8 ++++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.scss b/frontend/src/app/document/entity-legend/entity-legend.component.scss
index e269d7265..7f7c6ef4e 100644
--- a/frontend/src/app/document/entity-legend/entity-legend.component.scss
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.scss
@@ -2,6 +2,5 @@ span.dot {
     height: .7rem;
     width: .7rem;
     margin-right: .4rem;
-    border-radius: 50%;
     display: inline-block;
 }
\ No newline at end of file
diff --git a/frontend/src/styles.scss b/frontend/src/styles.scss
index a07c33961..3b13bf5f7 100644
--- a/frontend/src/styles.scss
+++ b/frontend/src/styles.scss
@@ -72,15 +72,23 @@ a.dropdown-item[disabled] {
     }
 }
 
+span[class^='entity'] {
+    padding-left: .4em;
+}
+
 .entity-per {
     background-color: $entity-person;
+    clip-path: polygon(100% 0%, 100% 100%, 0% 100%, 5px 50%, 0% 0%);
 }
 .entity-loc {
     background-color: $entity-location;
+    clip-path: polygon(5px 0%, 100% 0%, 100% 100%, 5px 100%, 0% 50%);
 }
 .entity-org {
     background-color: $entity-organization;
+    clip-path: polygon(0 0, 100% 0%, 100% 100%, 5px 100%);
 }
 .entity-mis {
     background-color: $entity-miscellaneous;
+    clip-path: polygon(5px 0, 100% 0%, 100% 100%, 0% 100%);
 }

From 16cc9b5758382dd3468c8d0836033d89812c9f7a Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Mon, 24 Jun 2024 15:19:06 +0200
Subject: [PATCH 64/91] add has_named_entity property to en/disable frontend
 NER display

---
 backend/addcorpus/models.py      | 16 ++++++++++++++++
 backend/addcorpus/serializers.py |  2 ++
 2 files changed, 18 insertions(+)

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index 7835ca348..962943b36 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -21,6 +21,8 @@
 from django.db import models
 from django.db.models.constraints import UniqueConstraint
 
+from ianalyzer.elasticsearch import elasticsearch
+
 MAX_LENGTH_NAME = 126
 MAX_LENGTH_DESCRIPTION = 254
 MAX_LENGTH_TITLE = 256
@@ -260,6 +262,20 @@ def clean(self):
                     e
                 ])
 
+    @property
+    def has_named_entities(self):
+        client = elasticsearch(self.es_index)
+        try:
+            mapping = client.indices.get_mapping(
+                index=self.es_index)
+            fields = mapping[self.es_index].get(
+                'mappings', {}).get('properties', {}).keys()
+            if any(field.endswith('_ner') for field in fields):
+                return True
+        except:
+            return False
+        return False
+
 
 FIELD_DISPLAY_TYPES = [
     ('text_content', 'text content'),
diff --git a/backend/addcorpus/serializers.py b/backend/addcorpus/serializers.py
index d6fb31db9..b1c3eb6ae 100644
--- a/backend/addcorpus/serializers.py
+++ b/backend/addcorpus/serializers.py
@@ -70,6 +70,7 @@ class CorpusConfigurationSerializer(serializers.ModelSerializer):
     languages = serializers.ListField(child=LanguageField())
     category = PrettyChoiceField(choices=CATEGORIES)
     default_sort = NonEmptyJSONField()
+    has_named_entities = serializers.ReadOnlyField()
 
     class Meta:
         model = CorpusConfiguration
@@ -89,6 +90,7 @@ class Meta:
             'default_sort',
             'language_field',
             'fields',
+            'has_named_entities',
         ]
 
 

From fd017113cd84110b1a90a03f24afe7a6edfd1870 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Mon, 24 Jun 2024 15:24:15 +0200
Subject: [PATCH 65/91] feat: deactivate showing NER option for corpora without
 entities

---
 .../app/document/document-popup/document-popup.component.html | 2 +-
 .../app/document/document-popup/document-popup.component.ts   | 4 ++++
 frontend/src/app/models/corpus.ts                             | 1 +
 frontend/src/app/services/corpus.service.ts                   | 1 +
 4 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/frontend/src/app/document/document-popup/document-popup.component.html b/frontend/src/app/document/document-popup/document-popup.component.html
index 501c025f5..8f84e345d 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.html
+++ b/frontend/src/app/document/document-popup/document-popup.component.html
@@ -3,7 +3,7 @@
         [responsive]="true" [maximizable]="true" [dismissableMask]="true" [draggable]="true" [resizable]="false" [blockScroll]="true">
         <ng-template pTemplate="header">
             <span>Document {{document.position}} of {{page.total}}</span>
-            <span iaBalloon="Show named entities for this document">NER<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></span>
+            <span *ngIf="showNEROption" iaBalloon="Show named entities for this document">NER<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></span>
         </ng-template>
 
         <ia-document-view [document]="document" [queryModel]="queryModel" [corpus]="document.corpus" [view]="view" [showEntities]="showNamedEntities"></ia-document-view>
diff --git a/frontend/src/app/document/document-popup/document-popup.component.ts b/frontend/src/app/document/document-popup/document-popup.component.ts
index 7ff4b6351..b41997c14 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.ts
+++ b/frontend/src/app/document/document-popup/document-popup.component.ts
@@ -24,6 +24,7 @@ export class DocumentPopupComponent implements OnChanges, OnDestroy {
     documentIcons = documentIcons;
 
     showNamedEntities = false;
+    showNEROption = false;
 
     private refresh$ = new Subject<void>();
 
@@ -40,6 +41,9 @@ export class DocumentPopupComponent implements OnChanges, OnDestroy {
     }
 
     ngOnChanges(changes: SimpleChanges): void {
+        if (changes.queryModel) {
+            this.showNEROption = this.queryModel.corpus.hasNamedEntities;
+        }
         if (changes.page) {
             this.refresh$.next();
             this.focusUpdate();
diff --git a/frontend/src/app/models/corpus.ts b/frontend/src/app/models/corpus.ts
index 4906e2966..4e58d42fe 100644
--- a/frontend/src/app/models/corpus.ts
+++ b/frontend/src/app/models/corpus.ts
@@ -29,6 +29,7 @@ export class Corpus {
         public wordModelsPresent: boolean,
         public languages: string[],
         public category: string,
+        public hasNamedEntities: boolean,
         public documentContext?: DocumentContext,
         public newHighlight?: boolean,
         public defaultSort?: SortState,
diff --git a/frontend/src/app/services/corpus.service.ts b/frontend/src/app/services/corpus.service.ts
index 7092bd591..6c4e7ff6d 100644
--- a/frontend/src/app/services/corpus.service.ts
+++ b/frontend/src/app/services/corpus.service.ts
@@ -89,6 +89,7 @@ export class CorpusService {
             data.word_models_present,
             data.languages,
             data.category,
+            data.has_named_entities,
             this.parseDocumentContext(data.document_context, allFields),
             data.new_highlight,
             this.parseDefaultSort(data.default_sort, allFields),

From c98e905a041eca7e430acf8fab867f91020ee81a Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Tue, 25 Jun 2024 14:04:13 +0200
Subject: [PATCH 66/91] Add SlugifyPipe

---
 .../src/app/shared/pipes/slugify.pipe.spec.ts | 24 +++++++++++++++++++
 frontend/src/app/shared/pipes/slugify.pipe.ts | 16 +++++++++++++
 frontend/src/app/shared/shared.module.ts      |  7 +++++-
 3 files changed, 46 insertions(+), 1 deletion(-)
 create mode 100644 frontend/src/app/shared/pipes/slugify.pipe.spec.ts
 create mode 100644 frontend/src/app/shared/pipes/slugify.pipe.ts

diff --git a/frontend/src/app/shared/pipes/slugify.pipe.spec.ts b/frontend/src/app/shared/pipes/slugify.pipe.spec.ts
new file mode 100644
index 000000000..b016f08b7
--- /dev/null
+++ b/frontend/src/app/shared/pipes/slugify.pipe.spec.ts
@@ -0,0 +1,24 @@
+import { SlugifyPipe } from './slugify.pipe';
+
+describe('SlugifyPipe', () => {
+    it('create an instance', () => {
+        const pipe = new SlugifyPipe();
+        expect(pipe).toBeTruthy();
+    });
+
+    it('slugifies strings', () => {
+        const pipe = new SlugifyPipe();
+        const input = 'tab-General information';
+        const output = pipe.transform(input);
+        const expected = 'tab-general-information';
+        expect(output).toEqual(expected);
+    });
+
+    it('slugifies numbers', () => {
+        const pipe = new SlugifyPipe();
+        const input = 1;
+        const output = pipe.transform(input);
+        const expected = '1';
+        expect(output).toEqual(expected);
+    });
+});
diff --git a/frontend/src/app/shared/pipes/slugify.pipe.ts b/frontend/src/app/shared/pipes/slugify.pipe.ts
new file mode 100644
index 000000000..cac63f35e
--- /dev/null
+++ b/frontend/src/app/shared/pipes/slugify.pipe.ts
@@ -0,0 +1,16 @@
+import { Pipe, PipeTransform } from '@angular/core';
+
+@Pipe({ name: 'slugify' })
+export class SlugifyPipe implements PipeTransform {
+    // via: https://gist.github.com/djabif/b8d21c4ebcef51db7a4a28ecf3d41846
+    transform(input: string | number): string {
+        return input
+            .toString()
+            .toLowerCase()
+            .replace(/\s+/g, '-') // Replace spaces with -
+            .replace(/[^\w\-]+/g, '') // Remove all non-word chars
+            .replace(/\-\-+/g, '-') // Replace multiple - with single -
+            .replace(/^-+/, '') // Trim - from start of text
+            .replace(/-+$/, ''); // Trim - from end of text
+    }
+}
diff --git a/frontend/src/app/shared/shared.module.ts b/frontend/src/app/shared/shared.module.ts
index 8f25fd406..3353638af 100644
--- a/frontend/src/app/shared/shared.module.ts
+++ b/frontend/src/app/shared/shared.module.ts
@@ -16,6 +16,7 @@ import { HighlightPipe } from '../search';
 import { DropdownModule } from './dropdown/dropdown.module';
 import { TabPanelDirective } from './tabs/tab-panel.directive';
 import { TabsComponent } from './tabs/tabs.component';
+import { SlugifyPipe } from './pipes/slugify.pipe';
 
 @NgModule({
     declarations: [
@@ -26,6 +27,7 @@ import { TabsComponent } from './tabs/tabs.component';
         ScrollToDirective,
         TabsComponent,
         TabPanelDirective,
+        SlugifyPipe,
     ],
     exports: [
         // shared components
@@ -48,6 +50,9 @@ import { TabsComponent } from './tabs/tabs.component';
         HttpClientXsrfModule,
         RouterModule,
         TableModule,
+
+        // Shared pipes
+        SlugifyPipe,
     ],
     imports: [
         BrowserAnimationsModule,
@@ -64,7 +69,7 @@ import { TabsComponent } from './tabs/tabs.component';
             headerName: 'X-CSRFToken',
         }),
         RouterModule,
-
     ],
+    providers: [SlugifyPipe],
 })
 export class SharedModule {}

From 55f5d16bf3aeb49f19d749695be31feaa47dee5b Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Tue, 25 Jun 2024 14:05:23 +0200
Subject: [PATCH 67/91] Use pipe to slugiy tab header IDs

Resolves #1606
---
 frontend/src/app/shared/tabs/tabs.component.spec.ts | 9 +++++++++
 frontend/src/app/shared/tabs/tabs.component.ts      | 6 ++++--
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/frontend/src/app/shared/tabs/tabs.component.spec.ts b/frontend/src/app/shared/tabs/tabs.component.spec.ts
index d00cdd97e..24182bc1f 100644
--- a/frontend/src/app/shared/tabs/tabs.component.spec.ts
+++ b/frontend/src/app/shared/tabs/tabs.component.spec.ts
@@ -27,4 +27,13 @@ describe('TabsComponent', () => {
     it('should create', () => {
         expect(component).toBeTruthy();
     });
+
+    it('should produce slug tab IDs', () => {
+        const tabIdNumerical = 1;
+        const tabIdString = 'General Information';
+        expect(component.tabLinkId(tabIdNumerical)).toEqual('tab-1');
+        expect(component.tabLinkId(tabIdString)).toEqual(
+            'tab-general-information'
+        );
+    });
 });
diff --git a/frontend/src/app/shared/tabs/tabs.component.ts b/frontend/src/app/shared/tabs/tabs.component.ts
index c18cf0e50..e8a25ba0d 100644
--- a/frontend/src/app/shared/tabs/tabs.component.ts
+++ b/frontend/src/app/shared/tabs/tabs.component.ts
@@ -6,6 +6,7 @@ import * as _ from 'lodash';
 import { TabPanelDirective } from './tab-panel.directive';
 import { IconDefinition } from '@fortawesome/free-solid-svg-icons';
 import { modulo } from '../../utils/utils';
+import { SlugifyPipe } from '../pipes/slugify.pipe';
 
 interface Tab {
     label: string; // display name
@@ -28,7 +29,7 @@ export class TabsComponent implements AfterContentInit {
 
     tabs: Tab[];
 
-    constructor() { }
+    constructor(private slugifyPipe: SlugifyPipe) {}
 
     ngAfterContentInit(): void {
         this.tabs = this.tabPanels.map(tabPanel => ({
@@ -74,6 +75,7 @@ export class TabsComponent implements AfterContentInit {
     }
 
     tabLinkId(tabId: string | number): string {
-        return `tab-${tabId}`;
+        const slugifiedId = this.slugifyPipe.transform(tabId);
+        return `tab-${slugifiedId}`;
     }
 }

From 51043b6c12bd198733c966c2248573cbdf5d66aa Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 26 Jun 2024 10:27:03 +0200
Subject: [PATCH 68/91] add unit test

---
 .../document-view.component.spec.ts           |  3 +--
 .../document-popup.component.spec.ts          | 26 ++++++++++++++++++-
 .../src/app/models/found-document.spec.ts     |  2 +-
 frontend/src/mock-data/corpus.ts              |  3 +++
 4 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/frontend/src/app/document-view/document-view.component.spec.ts b/frontend/src/app/document-view/document-view.component.spec.ts
index d669f30af..703550fc7 100644
--- a/frontend/src/app/document-view/document-view.component.spec.ts
+++ b/frontend/src/app/document-view/document-view.component.spec.ts
@@ -1,4 +1,4 @@
-import { ComponentFixture, TestBed, fakeAsync, tick, waitForAsync } from '@angular/core/testing';
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
 import { By } from '@angular/platform-browser';
 import * as _ from 'lodash';
 import { mockCorpus, mockField } from '../../mock-data/corpus';
@@ -7,7 +7,6 @@ import { commonTestBed } from '../common-test-bed';
 
 import { DocumentViewComponent } from './document-view.component';
 import { makeDocument } from '../../mock-data/constructor-helpers';
-import { of } from 'rxjs';
 
 describe('DocumentViewComponent', () => {
     let component: DocumentViewComponent;
diff --git a/frontend/src/app/document/document-popup/document-popup.component.spec.ts b/frontend/src/app/document/document-popup/document-popup.component.spec.ts
index 74546db68..b497ceecf 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.spec.ts
+++ b/frontend/src/app/document/document-popup/document-popup.component.spec.ts
@@ -1,7 +1,14 @@
-import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+import { ComponentFixture, TestBed, fakeAsync, tick, waitForAsync } from '@angular/core/testing';
+import { By } from '@angular/platform-browser';
 
 import { DocumentPopupComponent } from './document-popup.component';
 import { commonTestBed } from '../../common-test-bed';
+import { makeDocument } from '../../../mock-data/constructor-helpers';
+import { mockCorpus, mockCorpus2, mockField } from '../../../mock-data/corpus';
+import { DocumentPage } from '../../models/document-page';
+import { QueryModel } from '../../models';
+import { query } from '@angular/animations';
+
 
 describe('DocumentPopupComponent', () => {
     let component: DocumentPopupComponent;
@@ -14,10 +21,27 @@ describe('DocumentPopupComponent', () => {
     beforeEach(() => {
         fixture = TestBed.createComponent(DocumentPopupComponent);
         component = fixture.componentInstance;
+        const document = makeDocument({ great_field: 'Hello world!' });
+        component.document = document;
+        component.page = new DocumentPage([document], 1, [mockField]);
+        component.queryModel = new QueryModel(mockCorpus);
         fixture.detectChanges();
     });
 
     it('should create', () => {
         expect(component).toBeTruthy();
     });
+
+    it('does not show the NER toggle for corpora without named entities', () => {
+        expect(fixture.debugElement.query(By.css('ia-toggle'))).toBeFalsy();
+    });
+
+    it('shows the NER toggle for corpora with named entities', () => {
+        const setModel = component.queryModel;
+        const queryModel = new QueryModel(mockCorpus2);
+        component.queryModel = queryModel;
+        component.ngOnChanges({queryModel: {previousValue: setModel, currentValue: queryModel, firstChange: false, isFirstChange: null}});
+        fixture.detectChanges();
+        expect(fixture.debugElement.query(By.css('ia-toggle'))).toBeTruthy();
+    });
 });
diff --git a/frontend/src/app/models/found-document.spec.ts b/frontend/src/app/models/found-document.spec.ts
index b17fe8d38..b286fa8ec 100644
--- a/frontend/src/app/models/found-document.spec.ts
+++ b/frontend/src/app/models/found-document.spec.ts
@@ -35,7 +35,7 @@ const mockResponse = {
     }
 };
 
-fdescribe('FoundDocument', () => {
+describe('FoundDocument', () => {
     const mockTagService = new TagServiceMock() as any;
     const mockEntityService = new EntityServiceMock() as any;
 
diff --git a/frontend/src/mock-data/corpus.ts b/frontend/src/mock-data/corpus.ts
index f1472315d..ae6e1d1eb 100644
--- a/frontend/src/mock-data/corpus.ts
+++ b/frontend/src/mock-data/corpus.ts
@@ -145,6 +145,7 @@ export const mockCorpus: Corpus = {
     scanImageType: 'pdf',
     allowImageDownload: false,
     wordModelsPresent: false,
+    hasNamedEntities: false,
     directDownloadLimit: 500,
     fields: [mockField, mockField2],
     languages: ['English'],
@@ -163,6 +164,7 @@ export const mockCorpus2 = {
     scanImageType: 'pdf',
     allowImageDownload: false,
     wordModelsPresent: false,
+    hasNamedEntities: true,
     directDownloadLimit: 1000,
     fields: [mockField2],
     languages: ['English', 'French'],
@@ -181,6 +183,7 @@ export const mockCorpus3: Corpus = {
     scanImageType: 'pdf',
     allowImageDownload: false,
     wordModelsPresent: false,
+    hasNamedEntities: false,
     directDownloadLimit: 2000,
     fields: [mockField, mockField2, mockField3, mockFieldDate, mockFieldMultipleChoice],
     languages: ['English'],

From 3dcdd1acac787f1d52032333477d027323da2488 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 26 Jun 2024 14:26:42 +0200
Subject: [PATCH 69/91] fix merge conflicts

---
 frontend/src/app/document/document.module.ts                    | 2 +-
 frontend/src/app/manual/manual.module.ts                        | 2 +-
 .../src/app/{ => shared}/pipes/elasticsearch-highlight.pipe.ts  | 2 +-
 frontend/src/app/{ => shared}/pipes/entity.pipe.ts              | 2 +-
 frontend/src/app/{ => shared}/pipes/format-entity-class.pipe.ts | 0
 frontend/src/app/{ => shared}/pipes/geo-data.pipe.ts            | 2 +-
 frontend/src/app/{ => shared}/pipes/index.ts                    | 0
 frontend/src/app/{ => shared}/pipes/regex-highlight.pipe.ts     | 2 +-
 frontend/src/app/{ => shared}/pipes/snippet.pipe.ts             | 0
 9 files changed, 6 insertions(+), 6 deletions(-)
 rename frontend/src/app/{ => shared}/pipes/elasticsearch-highlight.pipe.ts (96%)
 rename frontend/src/app/{ => shared}/pipes/entity.pipe.ts (93%)
 rename frontend/src/app/{ => shared}/pipes/format-entity-class.pipe.ts (100%)
 rename frontend/src/app/{ => shared}/pipes/geo-data.pipe.ts (92%)
 rename frontend/src/app/{ => shared}/pipes/index.ts (100%)
 rename frontend/src/app/{ => shared}/pipes/regex-highlight.pipe.ts (94%)
 rename frontend/src/app/{ => shared}/pipes/snippet.pipe.ts (100%)

diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index 1e60ee50a..0d52a5ca0 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -10,7 +10,7 @@ import { DocumentPopupComponent } from './document-popup/document-popup.componen
 import { DialogModule } from 'primeng/dialog';
 import { DocumentPreviewComponent } from './document-preview/document-preview.component';
 import { EntityLegendComponent } from './entity-legend/entity-legend.component';
-import { ElasticsearchHighlightPipe, EntityPipe, FormatEntityClassPipe, GeoDataPipe, SnippetPipe } from '../pipes';
+import { ElasticsearchHighlightPipe, EntityPipe, FormatEntityClassPipe, GeoDataPipe, SnippetPipe } from '../shared/pipes';
 
 @NgModule({
     declarations: [
diff --git a/frontend/src/app/manual/manual.module.ts b/frontend/src/app/manual/manual.module.ts
index fc13467d9..61404fcbd 100644
--- a/frontend/src/app/manual/manual.module.ts
+++ b/frontend/src/app/manual/manual.module.ts
@@ -4,7 +4,7 @@ import { ManualNavigationComponent } from './manual-navigation.component';
 import { ManualComponent } from './manual.component';
 import { AboutComponent } from '../about/about.component';
 import { PrivacyComponent } from '../privacy/privacy.component';
-import { RegexHighlightPipe } from '../pipes';
+import { RegexHighlightPipe } from '../shared/pipes';
 
 
 @NgModule({
diff --git a/frontend/src/app/pipes/elasticsearch-highlight.pipe.ts b/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
similarity index 96%
rename from frontend/src/app/pipes/elasticsearch-highlight.pipe.ts
rename to frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
index 3a35ae3cb..d7dc31375 100644
--- a/frontend/src/app/pipes/elasticsearch-highlight.pipe.ts
+++ b/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
@@ -1,6 +1,6 @@
 import { Pipe, PipeTransform } from '@angular/core';
 import { DomSanitizer } from '@angular/platform-browser';
-import { CorpusField, FoundDocument } from '../models';
+import { CorpusField, FoundDocument } from '../../models';
 import * as _ from 'lodash';
 
 @Pipe({
diff --git a/frontend/src/app/pipes/entity.pipe.ts b/frontend/src/app/shared/pipes/entity.pipe.ts
similarity index 93%
rename from frontend/src/app/pipes/entity.pipe.ts
rename to frontend/src/app/shared/pipes/entity.pipe.ts
index ebb556edf..ec515884a 100644
--- a/frontend/src/app/pipes/entity.pipe.ts
+++ b/frontend/src/app/shared/pipes/entity.pipe.ts
@@ -2,7 +2,7 @@ import { Pipe, PipeTransform } from '@angular/core';
 import { DomSanitizer } from '@angular/platform-browser';
 import { Observable } from 'rxjs';
 
-import { FoundDocument } from '../models';
+import { FoundDocument } from '../../models';
 import * as _ from 'lodash';
 
 @Pipe({
diff --git a/frontend/src/app/pipes/format-entity-class.pipe.ts b/frontend/src/app/shared/pipes/format-entity-class.pipe.ts
similarity index 100%
rename from frontend/src/app/pipes/format-entity-class.pipe.ts
rename to frontend/src/app/shared/pipes/format-entity-class.pipe.ts
diff --git a/frontend/src/app/pipes/geo-data.pipe.ts b/frontend/src/app/shared/pipes/geo-data.pipe.ts
similarity index 92%
rename from frontend/src/app/pipes/geo-data.pipe.ts
rename to frontend/src/app/shared/pipes/geo-data.pipe.ts
index cf7b18a23..08d9df047 100644
--- a/frontend/src/app/pipes/geo-data.pipe.ts
+++ b/frontend/src/app/shared/pipes/geo-data.pipe.ts
@@ -1,6 +1,6 @@
 import { Pipe, PipeTransform } from '@angular/core';
 import { DomSanitizer } from '@angular/platform-browser';
-import { CorpusField, FoundDocument } from '../models';
+import { CorpusField, FoundDocument } from '../../models';
 @Pipe({
     name: 'geoData'
 })
diff --git a/frontend/src/app/pipes/index.ts b/frontend/src/app/shared/pipes/index.ts
similarity index 100%
rename from frontend/src/app/pipes/index.ts
rename to frontend/src/app/shared/pipes/index.ts
diff --git a/frontend/src/app/pipes/regex-highlight.pipe.ts b/frontend/src/app/shared/pipes/regex-highlight.pipe.ts
similarity index 94%
rename from frontend/src/app/pipes/regex-highlight.pipe.ts
rename to frontend/src/app/shared/pipes/regex-highlight.pipe.ts
index 323292ffa..595499503 100644
--- a/frontend/src/app/pipes/regex-highlight.pipe.ts
+++ b/frontend/src/app/shared/pipes/regex-highlight.pipe.ts
@@ -1,6 +1,6 @@
 import { Pipe, PipeTransform, SecurityContext } from '@angular/core';
 import { DomSanitizer } from '@angular/platform-browser';
-import { HighlightService } from '../services/highlight.service';
+import { HighlightService } from '../../services/highlight.service';
 
 @Pipe({
     name: 'regexHighlight'
diff --git a/frontend/src/app/pipes/snippet.pipe.ts b/frontend/src/app/shared/pipes/snippet.pipe.ts
similarity index 100%
rename from frontend/src/app/pipes/snippet.pipe.ts
rename to frontend/src/app/shared/pipes/snippet.pipe.ts

From 6416e1c3c2e316c4320436f150cf2fbad08c57eb Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 27 Jun 2024 10:38:59 +0200
Subject: [PATCH 70/91] replace ner suffix separator with colon

---
 backend/addcorpus/models.py                  | 2 +-
 backend/addcorpus/validation/creation.py     | 4 ++--
 backend/es/conftest.py                       | 4 ++--
 backend/es/tests/test_named_entity_search.py | 6 +++---
 backend/es/views.py                          | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index 962943b36..84349e205 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -270,7 +270,7 @@ def has_named_entities(self):
                 index=self.es_index)
             fields = mapping[self.es_index].get(
                 'mappings', {}).get('properties', {}).keys()
-            if any(field.endswith('_ner') for field in fields):
+            if any(field.endswith(':ner') for field in fields):
                 return True
         except:
             return False
diff --git a/backend/addcorpus/validation/creation.py b/backend/addcorpus/validation/creation.py
index fc18f7d31..445a272fa 100644
--- a/backend/addcorpus/validation/creation.py
+++ b/backend/addcorpus/validation/creation.py
@@ -124,9 +124,9 @@ def validate_name_is_not_a_route_parameter(value):
 
 
 def validate_name_has_no_ner_suffix(value):
-    if value.endswith('_ner'):
+    if value.endswith(':ner'):
         raise ValidationError(
-            f'{value} cannot be used as a field name: the suffix `_ner` is reserved for annotated_text fields'
+            f'{value} cannot be used as a field name: the suffix `:ner` is reserved for annotated_text fields'
         )
 
 def mapping_can_be_searched(es_mapping):
diff --git a/backend/es/conftest.py b/backend/es/conftest.py
index 4545a2801..40d462e05 100644
--- a/backend/es/conftest.py
+++ b/backend/es/conftest.py
@@ -28,12 +28,12 @@ def es_ner_search_client(es_client, basic_mock_corpus, basic_corpus_public, inde
     # add data from mock corpus
     corpus = Corpus.objects.get(name=basic_mock_corpus)
     es_client.indices.put_mapping(index=corpus.configuration.es_index, properties={
-                                  "content_ner": {"type": "annotated_text"}})
+                                  "content:ner": {"type": "annotated_text"}})
 
     es_client.index(index=corpus.configuration.es_index, document={
         'id': 'my_identifier',
         'content': 'Guybrush Threepwood is looking for treasure on Monkey Island',
-        'content_ner': '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'})
+        'content:ner': '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'})
 
     # ES is "near real time", so give it a second before we start searching the index
     sleep(1)
diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
index a6dde20dc..3a58d0cfc 100644
--- a/backend/es/tests/test_named_entity_search.py
+++ b/backend/es/tests/test_named_entity_search.py
@@ -9,7 +9,7 @@ def test_ner_search_view(es_ner_search_client, client):
 
 def test_construct_ner_query():
     viewset = NamedEntitySearchView()
-    fields = ['content_ner']
+    fields = ['content:ner']
     query = viewset.construct_named_entity_query(fields, 'my_identifier')
     expected = {
         "bool": {
@@ -21,7 +21,7 @@ def test_construct_ner_query():
                 },
                 {
                     "terms": {
-                        "content_ner": ["LOC", "PER", "ORG", "MISC"]
+                        "content:ner": ["LOC", "PER", "ORG", "MISC"]
                     }
                 }
             ]
@@ -35,7 +35,7 @@ def test_find_named_entity_fields(es_ner_search_client):
     fields = viewset.find_named_entity_fields(
         es_ner_search_client, 'test-basic-corpus')
     assert len(fields) == 1
-    assert fields[0] == 'content_ner'
+    assert fields[0] == 'content:ner'
 
 
 def test_find_entities():
diff --git a/backend/es/views.py b/backend/es/views.py
index 645fe86e6..1e2036da5 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -131,7 +131,7 @@ def get(self, request, *args, **kwargs):
             source = results[0]['_source']
             for field in fields:
                 text_with_entities = source.get(field)
-                annotations.update({field.replace('_ner', ''): self.find_entities(
+                annotations.update({field.replace(':ner', ''): self.find_entities(
                     text_with_entities, entity_classes)})
             entities = [self.entity_dict.get(entity_class)
                         for entity_class in list(entity_classes)]
@@ -142,7 +142,7 @@ def find_named_entity_fields(self, client, index: str) -> list[str]:
         mapping = client.indices.get_mapping(index=index)
         fields = mapping[index]['mappings']['properties']
         field_names = fields.keys()
-        return [name for name in field_names if name.endswith('_ner') and fields[name].get('type') == 'annotated_text']
+        return [name for name in field_names if name.endswith(':ner') and fields[name].get('type') == 'annotated_text']
 
     def construct_named_entity_query(self, fields: list[str], document_id: str) -> dict:
         return {

From a964d56ab01e2394ea0b6f5771c4219df91464b2 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 27 Jun 2024 10:54:37 +0200
Subject: [PATCH 71/91] fix: use mark class instead of span

---
 backend/es/views.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/backend/es/views.py b/backend/es/views.py
index 1e2036da5..7bc06cf27 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -180,4 +180,4 @@ def substitute_annotation_with_tag(self, annotation: tuple, input_text: str, ent
         annotated = annotation[0][1:-1]
         entity_classes.update({entity_class})
         return input_text.replace(
-            ''.join(annotation), f'<span class="entity-{entity_class.lower()}">{annotated}</span>')
+            ''.join(annotation), f'<mark class="entity-{entity_class.lower()}">{annotated} <fa-icon icon="fa-person" title="{entity_class.lower()}"></mark>')

From db4ba62b65bb6bb4a9a0c45137ba0aab745f4299 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 27 Jun 2024 10:55:19 +0200
Subject: [PATCH 72/91] revertme: use underscore for legacy index

---
 backend/addcorpus/models.py | 2 +-
 backend/es/views.py         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index 84349e205..962943b36 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -270,7 +270,7 @@ def has_named_entities(self):
                 index=self.es_index)
             fields = mapping[self.es_index].get(
                 'mappings', {}).get('properties', {}).keys()
-            if any(field.endswith(':ner') for field in fields):
+            if any(field.endswith('_ner') for field in fields):
                 return True
         except:
             return False
diff --git a/backend/es/views.py b/backend/es/views.py
index 7bc06cf27..b41173ece 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -131,7 +131,7 @@ def get(self, request, *args, **kwargs):
             source = results[0]['_source']
             for field in fields:
                 text_with_entities = source.get(field)
-                annotations.update({field.replace(':ner', ''): self.find_entities(
+                annotations.update({field.replace('_ner', ''): self.find_entities(
                     text_with_entities, entity_classes)})
             entities = [self.entity_dict.get(entity_class)
                         for entity_class in list(entity_classes)]
@@ -142,7 +142,7 @@ def find_named_entity_fields(self, client, index: str) -> list[str]:
         mapping = client.indices.get_mapping(index=index)
         fields = mapping[index]['mappings']['properties']
         field_names = fields.keys()
-        return [name for name in field_names if name.endswith(':ner') and fields[name].get('type') == 'annotated_text']
+        return [name for name in field_names if name.endswith('_ner') and fields[name].get('type') == 'annotated_text']
 
     def construct_named_entity_query(self, fields: list[str], document_id: str) -> dict:
         return {

From f9ba8a1090af91c4525ea939e2c7b3a922d94cac Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Mon, 1 Jul 2024 18:04:03 +0200
Subject: [PATCH 73/91] implement review suggestions

---
 backend/es/views.py                           | 41 +++++++++----------
 frontend/src/_utilities.scss                  |  8 ++--
 .../edit-definition.component.ts              |  1 -
 .../document-page.component.html              |  5 ++-
 .../document-page/document-page.component.ts  | 13 +++++-
 .../document-view.component.html              | 25 ++++++++---
 .../document-view.component.scss              |  2 -
 .../document-view/document-view.component.ts  |  3 +-
 .../document-popup.component.html             |  2 +-
 frontend/src/app/document/document.module.ts  |  5 +--
 .../entity-legend.component.html              | 16 ++++++--
 .../entity-legend.component.scss              | 14 ++++---
 .../entity-legend/entity-legend.component.ts  | 27 +++++++-----
 frontend/src/app/models/found-document.ts     | 16 ++++----
 frontend/src/app/models/search-results.ts     |  7 +++-
 frontend/src/app/shared/icons.ts              | 13 ++++--
 .../pipes/elasticsearch-highlight.pipe.ts     | 14 ++-----
 frontend/src/app/shared/pipes/entity.pipe.ts  | 25 -----------
 .../shared/pipes/format-entity-class.pipe.ts  | 20 ---------
 frontend/src/app/shared/pipes/index.ts        |  3 +-
 .../app/shared/pipes/paragraph.pipe.spec.ts   |  8 ++++
 .../src/app/shared/pipes/paragraph.pipe.ts    | 23 +++++++++++
 .../app/shared/toggle/toggle.component.html   |  2 +-
 frontend/src/styles.scss                      | 35 +++++++++-------
 24 files changed, 178 insertions(+), 150 deletions(-)
 delete mode 100644 frontend/src/app/shared/pipes/entity.pipe.ts
 delete mode 100644 frontend/src/app/shared/pipes/format-entity-class.pipe.ts
 create mode 100644 frontend/src/app/shared/pipes/paragraph.pipe.spec.ts
 create mode 100644 frontend/src/app/shared/pipes/paragraph.pipe.ts

diff --git a/backend/es/views.py b/backend/es/views.py
index b41173ece..f372be8b9 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -107,10 +107,10 @@ class NamedEntitySearchView(APIView):
         Perform search via Elasticsearch and reformat the output
     '''
     entity_dict = {
-        'PER': 'Person',
-        'LOC': 'Location',
-        'ORG': 'Organization',
-        'MISC': 'Miscellaneous'
+        'PER': 'person',
+        'LOC': 'location',
+        'ORG': 'organization',
+        'MISC': 'miscellaneous'
     }
 
     permission_classes = [CorpusAccessPermission]
@@ -125,17 +125,14 @@ def get(self, request, *args, **kwargs):
         response = client.search(index=index, query=query, fields=fields)
         results = hits(response)
         annotations = {}
-        entity_classes = set()
         response = {}
         if len(results):
             source = results[0]['_source']
             for field in fields:
                 text_with_entities = source.get(field)
                 annotations.update({field.replace('_ner', ''): self.find_entities(
-                    text_with_entities, entity_classes)})
-            entities = [self.entity_dict.get(entity_class)
-                        for entity_class in list(entity_classes)]
-            response = {'annotations': annotations, 'entities': entities}
+                    text_with_entities)})
+            response = {'annotations': annotations}
         return Response(response)
 
     def find_named_entity_fields(self, client, index: str) -> list[str]:
@@ -166,18 +163,18 @@ def add_terms(self, fields: list[str]) -> list[dict]:
             } for field in fields
         ]
 
-    def find_entities(self, input_text: str, entity_classes: set) -> str:
+    def find_entities(self, input_text: str) -> str:
         # regex pattern to match annotations of format "[Wally](Person)" and split it into two groups
         pattern = re.compile('(\[[^]]+\])(\([A-Z]+\))')
-        annotations = list(set(pattern.findall(input_text)))
-        for annotation in annotations:
-            input_text = self.substitute_annotation_with_tag(
-                annotation, input_text, entity_classes)
-        return input_text
-
-    def substitute_annotation_with_tag(self, annotation: tuple, input_text: str, entity_classes: set) -> str:
-        entity_class = annotation[1][1:-1]
-        annotated = annotation[0][1:-1]
-        entity_classes.update({entity_class})
-        return input_text.replace(
-            ''.join(annotation), f'<mark class="entity-{entity_class.lower()}">{annotated} <fa-icon icon="fa-person" title="{entity_class.lower()}"></mark>')
+        annotations = pattern.split(input_text)
+        output = []
+        for index, annotation in enumerate(annotations):
+            if annotation.startswith('('):
+                continue
+            elif annotation.startswith('['):
+               output.append(
+                   {'entity': self.entity_dict.get(annotations[index+1][1:-1]), 'text': annotation[1:-1]})
+            else:
+                if annotation:
+                    output.append({'entity': 'flat', 'text': annotation})
+        return output
diff --git a/frontend/src/_utilities.scss b/frontend/src/_utilities.scss
index 6de7fcc9f..e1f728cf0 100644
--- a/frontend/src/_utilities.scss
+++ b/frontend/src/_utilities.scss
@@ -30,10 +30,10 @@ $section-padding:	3rem 1.5rem;
 $boxShadow: 0 2px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px rgba(10, 10, 10, 0.1);
 $boxShadowHover: 0px 5px 3px rgba(10, 10, 10, 0.1), 0 0 0 1px $primary;
 
-$entity-person:  #ADDBE0;
-$entity-location: #ADF489;
-$entity-organization: #E6D5A8;
-$entity-miscellaneous: #EF9AB4;
+$entity-person:  #303F9F;
+$entity-location: #4e8f2d;
+$entity-organization: #efb71d;
+$entity-miscellaneous: #ee5986;
 
 @import "bulma/sass/utilities/_all";
 
diff --git a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
index b5c16bba0..262b26286 100644
--- a/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/edit-definition/edit-definition.component.ts
@@ -4,7 +4,6 @@ import { Subject } from 'rxjs';
 import { CorpusDefinition } from '../../models/corpus-definition';
 import { ApiService } from '../../services';
 import { ActivatedRoute } from '@angular/router';
-import { filter, take } from 'rxjs/operators';
 import * as _ from 'lodash';
 import { HttpErrorResponse } from '@angular/common/http';
 
diff --git a/frontend/src/app/document-page/document-page.component.html b/frontend/src/app/document-page/document-page.component.html
index 26ebf2ca6..8c2635901 100644
--- a/frontend/src/app/document-page/document-page.component.html
+++ b/frontend/src/app/document-page/document-page.component.html
@@ -1,7 +1,8 @@
 <ia-corpus-header [corpus]="corpus" currentPage="document"></ia-corpus-header>
 <div class="section">
     <div class="container is-readable">
-        <div *ngIf="!documentNotFound; else notFound" [ngClass]="{'is-loading': !document}">
+        <div *ngIf="documentFound; else notFound" [ngClass]="{'is-loading': !document}">
+            <em *ngIf="showNEROption" iaBalloon="Show named entities for this document">Show named entities<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></em>
             <div class="level">
                 <div class="level-left"></div>
                 <div class="level-right">
@@ -14,7 +15,7 @@
                 </div>
             </div>
             <div class="block">
-                <ia-document-view *ngIf="document" [document]="document" [corpus]="corpus"></ia-document-view>
+                <ia-document-view *ngIf="document" [document]="document" [corpus]="corpus" [showEntities]="showNamedEntities"></ia-document-view>
             </div>
         </div>
     </div>
diff --git a/frontend/src/app/document-page/document-page.component.ts b/frontend/src/app/document-page/document-page.component.ts
index 4d44a7d61..488accb81 100644
--- a/frontend/src/app/document-page/document-page.component.ts
+++ b/frontend/src/app/document-page/document-page.component.ts
@@ -19,10 +19,14 @@ export class DocumentPageComponent implements OnInit {
     documentId: string;
     document: FoundDocument;
 
-    documentNotFound: boolean;
+    documentFound: boolean;
 
     documentIcons = documentIcons;
 
+    showNEROption: boolean;
+
+    showNamedEntities = false;
+
     constructor(
         private corpusService: CorpusService,
         private elasticSearchService: ElasticSearchService,
@@ -55,6 +59,7 @@ export class DocumentPageComponent implements OnInit {
         ]).subscribe(([params, corpus]) => {
             this.corpus = corpus;
             this.documentId = params['id'];
+            this.showNEROption = this.corpus.hasNamedEntities;
             this.getDocument(this.documentId);
             this.title.setTitle(pageTitle(`Document in ${corpus.title}`));
         });
@@ -63,9 +68,13 @@ export class DocumentPageComponent implements OnInit {
     getDocument(id: string) {
         this.elasticSearchService.getDocumentById(id, this.corpus).then(document => {
             this.document = document;
-            this.documentNotFound = _.isUndefined(this.document);
+            this.documentFound = !_.isUndefined(this.document);
         });
     }
 
+    toggleNER(active: boolean): void {
+        this.showNamedEntities = active;
+    }
+
 
 }
diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index ce83d7098..e498a86e2 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -21,7 +21,7 @@
                             <td *ngIf="!isUrlField(field) && !isGeoPointField(field)"
                                 data-test-field-value
                                 [attr.lang]="document.language(field)"
-                                [innerHtml]="field | elasticsearchHighlight:document">
+                                [innerHtml]="field | elasticsearchHighlight:document | paragraph">
                             </td>
                             <td *ngIf="isGeoPointField(field)">{{field | geoData:document}}</td>
                             <td *ngIf="isUrlField(field)">
@@ -38,17 +38,30 @@
         <div class="box">
             <ia-tabs [activeTab]="activeTab">
                 <ng-template iaTabPanel *ngFor="let field of contentFields" [id]="field.name" [title]="field.displayName" [icon]="documentIcons.text">
-                    <div *ngIf="showEntities && document.annotations$ | async; else showHighlights" class="content"
-                        [attr.lang]="document.language(field)"
-                        [innerHtml]="document.annotations$ | async | entity:document:field.name">
+                    <div *ngIf="showEntities && document.entityAnnotations$ | async as annotations ; else showHighlights" class="content"
+                        [attr.lang]="document.language(field)">
+                        <div *ngIf="annotations[field.name]; else plainText">
+                            <span *ngFor="let textSegment of annotations[field.name]">
+                                <mark *ngIf="textSegment.entity !== 'flat'; else unannotatedText" [className]="'entity-'+textSegment.entity">
+                                    {{textSegment.text}}
+                                    <fa-icon class="entity-icon" [icon]="entityIcons[textSegment.entity]" [title]="textSegment.entity"></fa-icon>
+                                </mark>
+                                <ng-template #unannotatedText>
+                                    {{textSegment.text | paragraph}}
+                                </ng-template>
+                            </span>
+                        </div>
+                        <ng-template #plainText>
+                            <div [innerHtml]="document.fieldValues[field.name] | paragraph"></div>
+                        </ng-template>
+                        <ia-entity-legend *ngIf="showEntities" [entityAnnotations]="annotations[field.name]"></ia-entity-legend>
                     </div>
                     <ng-template #showHighlights>
                         <div class="content"
                             [attr.lang]="document.language(field)"
-                            [innerHtml]="field | elasticsearchHighlight:document">
+                            [innerHtml]="field | elasticsearchHighlight:document | paragraph">
                         </div>
                     </ng-template>
-                    <ia-entity-legend *ngIf="showEntities" [entities]="document.entities"></ia-entity-legend>
                 </ng-template>
                 <ng-template iaTabPanel id="scan" *ngIf="showScanTab" title="Image" [icon]="documentIcons.scan">
                     <ia-image-view [corpus]="corpus" [document]="document"></ia-image-view>
diff --git a/frontend/src/app/document-view/document-view.component.scss b/frontend/src/app/document-view/document-view.component.scss
index 9fa3f278e..af60ed17b 100644
--- a/frontend/src/app/document-view/document-view.component.scss
+++ b/frontend/src/app/document-view/document-view.component.scss
@@ -8,5 +8,3 @@ table {
         color: $primary;
     }
 }
-
-  
\ No newline at end of file
diff --git a/frontend/src/app/document-view/document-view.component.ts b/frontend/src/app/document-view/document-view.component.ts
index 930da218e..203c3d38b 100644
--- a/frontend/src/app/document-view/document-view.component.ts
+++ b/frontend/src/app/document-view/document-view.component.ts
@@ -3,7 +3,7 @@ import { Component, Input, OnChanges, SimpleChanges } from '@angular/core';
 import { CorpusField, FoundDocument, Corpus, QueryModel } from '../models/index';
 import { DocumentView } from '../models/document-page';
 import * as _ from 'lodash';
-import { documentIcons } from '../shared/icons';
+import { documentIcons, entityIcons } from '../shared/icons';
 
 @Component({
     selector: 'ia-document-view',
@@ -28,6 +28,7 @@ export class DocumentViewComponent implements OnChanges {
     public showEntities: boolean;
 
     documentIcons = documentIcons;
+    entityIcons = entityIcons;
 
     /** active tab on opening */
     activeTab: string;
diff --git a/frontend/src/app/document/document-popup/document-popup.component.html b/frontend/src/app/document/document-popup/document-popup.component.html
index 8f84e345d..705199abb 100644
--- a/frontend/src/app/document/document-popup/document-popup.component.html
+++ b/frontend/src/app/document/document-popup/document-popup.component.html
@@ -3,7 +3,7 @@
         [responsive]="true" [maximizable]="true" [dismissableMask]="true" [draggable]="true" [resizable]="false" [blockScroll]="true">
         <ng-template pTemplate="header">
             <span>Document {{document.position}} of {{page.total}}</span>
-            <span *ngIf="showNEROption" iaBalloon="Show named entities for this document">NER<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></span>
+            <em *ngIf="showNEROption" iaBalloon="Show named entities for this document">Show named entities<ia-toggle (toggled)="toggleNER($event)"></ia-toggle></em>
         </ng-template>
 
         <ia-document-view [document]="document" [queryModel]="queryModel" [corpus]="document.corpus" [view]="view" [showEntities]="showNamedEntities"></ia-document-view>
diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index 0d52a5ca0..def98c70e 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -10,7 +10,7 @@ import { DocumentPopupComponent } from './document-popup/document-popup.componen
 import { DialogModule } from 'primeng/dialog';
 import { DocumentPreviewComponent } from './document-preview/document-preview.component';
 import { EntityLegendComponent } from './entity-legend/entity-legend.component';
-import { ElasticsearchHighlightPipe, EntityPipe, FormatEntityClassPipe, GeoDataPipe, SnippetPipe } from '../shared/pipes';
+import { ElasticsearchHighlightPipe, GeoDataPipe, ParagraphPipe, SnippetPipe } from '../shared/pipes';
 
 @NgModule({
     declarations: [
@@ -21,9 +21,8 @@ import { ElasticsearchHighlightPipe, EntityPipe, FormatEntityClassPipe, GeoDataP
         DocumentPreviewComponent,
         ElasticsearchHighlightPipe,
         EntityLegendComponent,
-        EntityPipe,
-        FormatEntityClassPipe,
         GeoDataPipe,
+        ParagraphPipe,
         SnippetPipe
     ],
     imports: [
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.html b/frontend/src/app/document/entity-legend/entity-legend.component.html
index 358862263..41f9622f6 100644
--- a/frontend/src/app/document/entity-legend/entity-legend.component.html
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.html
@@ -1,3 +1,13 @@
-<div *ngFor="let entity of entities">
-    <span class="dot" [ngClass]="entity | formatEntityClass"></span><span>{{entity}}</span>
-</div>
+<footer>
+    <ul *ngIf="entities; else noEntities" title="legend">
+        <li *ngFor="let entity of entities">
+            <span>
+                <fa-icon [className]="'entity-'+entity+' entity-icon'" [icon]="entityIcons[entity]" [title]="entity"></fa-icon>
+                {{entity.slice(0,1).toUpperCase() + entity.slice(1)}}
+            </span>
+        </li>
+    </ul>
+    <ng-template #noEntities>
+        <em class="no-entities-message">No named entities were found in this text.</em>
+    </ng-template>
+</footer>
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.scss b/frontend/src/app/document/entity-legend/entity-legend.component.scss
index 7f7c6ef4e..459455661 100644
--- a/frontend/src/app/document/entity-legend/entity-legend.component.scss
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.scss
@@ -1,6 +1,8 @@
-span.dot {
-    height: .7rem;
-    width: .7rem;
-    margin-right: .4rem;
-    display: inline-block;
-}
\ No newline at end of file
+ul {
+    list-style-type: none;
+    margin-left: 0;
+}
+
+.no-entities-message {
+    opacity: 0.6;
+}
diff --git a/frontend/src/app/document/entity-legend/entity-legend.component.ts b/frontend/src/app/document/entity-legend/entity-legend.component.ts
index da297a25a..882fcd59c 100644
--- a/frontend/src/app/document/entity-legend/entity-legend.component.ts
+++ b/frontend/src/app/document/entity-legend/entity-legend.component.ts
@@ -1,21 +1,28 @@
-import { Component, Input, OnInit } from '@angular/core';
+import { Component, Input, OnChanges } from '@angular/core';
+import * as _ from 'lodash';
+
+import { entityIcons } from '../../shared/icons';
+import { FieldEntities } from '../../models';
 
 @Component({
   selector: 'ia-entity-legend',
   templateUrl: './entity-legend.component.html',
   styleUrls: ['./entity-legend.component.scss']
 })
-export class EntityLegendComponent implements OnInit {
-
-  @Input() entities: string[];
+export class EntityLegendComponent implements OnChanges {
+    @Input() entityAnnotations: FieldEntities[];
 
-  constructor() { }
+    public entityIcons = entityIcons;
+    public entities: string[];
 
-  ngOnInit(): void {
-  }
+    constructor() { }
 
-  formatClass(entityName: string): string {
-    return `entity-${entityName.toLowerCase().slice(0,3)}`;
-  }
+    ngOnChanges(): void {
+        if (!this.entityAnnotations) {
+            this.entities = null;
+        } else {
+            this.entities = _.uniq(this.entityAnnotations.map((item) => item.entity)).filter((value) => value !=='flat');
+        }
+    }
 
 }
diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index 792e7b29e..db83ba9b1 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -1,4 +1,6 @@
 import * as _ from 'lodash';
+import { map, mergeMap, shareReplay, take } from 'rxjs/operators';
+
 import { makeContextParams } from '../utils/document-context';
 import { Corpus, CorpusField } from './corpus';
 import { FieldValues, HighlightResult, SearchHit } from './elasticsearch';
@@ -6,7 +8,7 @@ import { Tag } from './tag';
 import { Observable, Subject, merge, timer } from 'rxjs';
 import { EntityService } from '../services/entity.service';
 import { TagService } from '../services/tag.service';
-import { map, mergeMap, shareReplay, take } from 'rxjs/operators';
+import { FieldEntities } from './search-results';
 
 export class FoundDocument {
     id: string;
@@ -29,8 +31,7 @@ export class FoundDocument {
     tags$: Observable<Tag[]>;
 
     /** named entities associated with the document */
-    entities: string[];
-    annotations$: Observable<{[fieldName: string]: string}[]>;
+    entityAnnotations$: Observable<{[fieldName: string]: FieldEntities[]}>;
     private tagsChanged$ = new Subject<void>();
 
     constructor(
@@ -56,7 +57,7 @@ export class FoundDocument {
             shareReplay(1),
         );
 
-        this.annotations$ = created$.pipe(
+        this.entityAnnotations$ = created$.pipe(
             mergeMap(() => this.fetchAnnotatedEntities()),
             shareReplay(1),
         );
@@ -124,13 +125,10 @@ export class FoundDocument {
         );
     }
 
-    private fetchAnnotatedEntities(): Observable<{[fieldName: string]: string}[]> {
+    private fetchAnnotatedEntities(): Observable<{[fieldName: string]: FieldEntities[]}> {
         const response$ = this.entityService.getDocumentEntities(this.corpus, this.id);
         return response$.pipe(
-            map( response => {
-                this.entities = response.entities;
-                return response.annotations || [];
-            })
+            map( response => response.annotations || {} )
         );
     }
 
diff --git a/frontend/src/app/models/search-results.ts b/frontend/src/app/models/search-results.ts
index 6feb3a036..212a001ba 100644
--- a/frontend/src/app/models/search-results.ts
+++ b/frontend/src/app/models/search-results.ts
@@ -83,9 +83,12 @@ export interface QueryFeedback {
     similarTerms?: string[];
 }
 
+export interface FieldEntities {
+    [entityType: string] : string
+}
+
 export interface NamedEntitiesResult {
-    entities: string[];
-    annotations: {[fieldName: string]: string}[];
+    annotations: {[fieldName: string]: FieldEntities[]};
 }
 
 export interface TaskResult { task_ids: string[] };
diff --git a/frontend/src/app/shared/icons.ts b/frontend/src/app/shared/icons.ts
index daefdf6bf..21b16626d 100644
--- a/frontend/src/app/shared/icons.ts
+++ b/frontend/src/app/shared/icons.ts
@@ -4,9 +4,9 @@ import {
 } from '@fortawesome/free-regular-svg-icons';
 import {
     IconDefinition as SolidIconDefinition,
-    faAngleDown, faAngleUp, faArrowLeft, faArrowRight, faAt, faBook, faBookOpen, faChartColumn,
-    faCheck, faChevronDown, faChevronLeft, faChevronRight, faCog, faCogs, faDatabase, faDiagramProject,
-    faDownload, faEdit, faEnvelope, faEye, faFilter, faHistory, faImage, faInfo, faInfoCircle, faLink, faList, faLock,
+    faAngleDown, faAngleUp, faArrowLeft, faArrowRight, faAt, faBook, faBookmark, faBookOpen, faBuilding, faChartColumn,
+    faCheck, faChevronLeft, faChevronRight, faCog, faCogs, faDatabase, faDiagramProject,
+    faDownload, faEnvelope, faEye, faFilter, faHistory, faImage, faInfo, faInfoCircle, faLink, faList, faLocationDot, faLock,
     faMinus, faPalette, faPencil, faPlus, faQuestionCircle, faSearch, faSearchMinus, faSearchPlus, faSignOut,
     faSortAlphaAsc, faSortAlphaDesc, faSortNumericAsc, faSortNumericDesc, faSquare,
     faTable, faTags, faTimes, faTrashCan, faUndo, faUpload, faUser
@@ -109,3 +109,10 @@ export const documentIcons: Icons = {
     scanAlt: faNewspaper,
     context: faBookOpen,
 };
+
+export const entityIcons: Icons = {
+    person: faUser,
+    location: faLocationDot,
+    organization: faBuilding,
+    miscellaneous: faBookmark,
+}
diff --git a/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts b/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
index d7dc31375..ae1d374da 100644
--- a/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
+++ b/frontend/src/app/shared/pipes/elasticsearch-highlight.pipe.ts
@@ -1,14 +1,12 @@
 import { Pipe, PipeTransform } from '@angular/core';
-import { DomSanitizer } from '@angular/platform-browser';
-import { CorpusField, FoundDocument } from '../../models';
 import * as _ from 'lodash';
 
+import { CorpusField, FoundDocument } from '../../models';
+
 @Pipe({
     name: 'elasticsearchHighlight'
 })
 export class ElasticsearchHighlightPipe implements PipeTransform {
-    constructor(private sanitizer: DomSanitizer) {
-    }
 
     /**
      * Transforms a text to display highlights fetched from Elasticsearch
@@ -23,8 +21,7 @@ export class ElasticsearchHighlightPipe implements PipeTransform {
         }
 
         const highlighted = this.highlightedInnerHtml(field, document);
-        const paragraphs = this.addParagraphTags(highlighted);
-        return this.sanitizer.bypassSecurityTrustHtml(paragraphs);
+        return highlighted;
     }
 
     highlightedInnerHtml(field: CorpusField, document: FoundDocument) {
@@ -38,11 +35,6 @@ export class ElasticsearchHighlightPipe implements PipeTransform {
         return highlighted;
     }
 
-    addParagraphTags(content: string | string[]) {
-        const paragraphs = typeof content === 'string' ? content.split('\n') : content;
-        return paragraphs.map(p => `<p>${p}</p>`).join(' ');
-    }
-
     stripTags(htmlString: string){
         const parseHTML= new DOMParser().parseFromString(htmlString, 'text/html');
         return parseHTML.body.textContent || '';
diff --git a/frontend/src/app/shared/pipes/entity.pipe.ts b/frontend/src/app/shared/pipes/entity.pipe.ts
deleted file mode 100644
index ec515884a..000000000
--- a/frontend/src/app/shared/pipes/entity.pipe.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import { Pipe, PipeTransform } from '@angular/core';
-import { DomSanitizer } from '@angular/platform-browser';
-import { Observable } from 'rxjs';
-
-import { FoundDocument } from '../../models';
-import * as _ from 'lodash';
-
-@Pipe({
-    name: 'entity'
-})
-export class EntityPipe implements PipeTransform {
-    constructor(private sanitizer: DomSanitizer) {
-    }
-
-    /**
-     * Transform field with annotated entities
-     *
-     * @param document FoundDocument holding the actual data
-     */
-    transform(annotations$: Observable<{[fieldName: string]: string}[]>, document: FoundDocument, fieldName: string) {
-        const newText = annotations$[fieldName];
-        return newText || document.fieldValues[fieldName];
-    }
-
-}
diff --git a/frontend/src/app/shared/pipes/format-entity-class.pipe.ts b/frontend/src/app/shared/pipes/format-entity-class.pipe.ts
deleted file mode 100644
index 11f935005..000000000
--- a/frontend/src/app/shared/pipes/format-entity-class.pipe.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-
-import { Pipe, PipeTransform } from '@angular/core';
-import * as _ from 'lodash';
-@Pipe({
-    name: 'formatEntityClass'
-})
-export class FormatEntityClassPipe implements PipeTransform {
-    constructor() {
-    }
-
-    /**
-     * Transform field with annotated entities
-     *
-     * @param document FoundDocument holding the actual data
-     */
-    transform(entityName: string) {
-        return `entity-${entityName.toLowerCase().slice(0,3)}`;
-    }
-
-}
diff --git a/frontend/src/app/shared/pipes/index.ts b/frontend/src/app/shared/pipes/index.ts
index d9e21dbdc..0bf4c0f5b 100644
--- a/frontend/src/app/shared/pipes/index.ts
+++ b/frontend/src/app/shared/pipes/index.ts
@@ -1,6 +1,5 @@
 export * from './elasticsearch-highlight.pipe';
-export * from './entity.pipe';
-export * from './format-entity-class.pipe';
 export * from './geo-data.pipe';
+export * from './paragraph.pipe';
 export * from './regex-highlight.pipe';
 export * from './snippet.pipe';
diff --git a/frontend/src/app/shared/pipes/paragraph.pipe.spec.ts b/frontend/src/app/shared/pipes/paragraph.pipe.spec.ts
new file mode 100644
index 000000000..10f3ec4c0
--- /dev/null
+++ b/frontend/src/app/shared/pipes/paragraph.pipe.spec.ts
@@ -0,0 +1,8 @@
+import { ParagraphPipe } from './paragraph.pipe';
+
+describe('ParagraphPipe', () => {
+  it('create an instance', () => {
+    const pipe = new ParagraphPipe();
+    expect(pipe).toBeTruthy();
+  });
+});
diff --git a/frontend/src/app/shared/pipes/paragraph.pipe.ts b/frontend/src/app/shared/pipes/paragraph.pipe.ts
new file mode 100644
index 000000000..877d6fac2
--- /dev/null
+++ b/frontend/src/app/shared/pipes/paragraph.pipe.ts
@@ -0,0 +1,23 @@
+import { Pipe, PipeTransform } from '@angular/core';
+
+
+@Pipe({
+    name: 'paragraph',
+})
+export class ParagraphPipe implements PipeTransform {
+
+    transform(content: string | string[]): unknown {
+        const splitText = this.addParagraphTags(content);
+        return splitText;
+    }
+
+    addParagraphTags(content: string | string[]) {
+        const paragraphs = typeof content === 'string' ? content.split('\n') : content;
+        if (paragraphs.length == 1) {
+            return content;
+        }
+        return paragraphs.map(p => `<p>${p}</p>`).join(' ');
+    }
+
+
+}
diff --git a/frontend/src/app/shared/toggle/toggle.component.html b/frontend/src/app/shared/toggle/toggle.component.html
index 64fafd1de..8b855a255 100644
--- a/frontend/src/app/shared/toggle/toggle.component.html
+++ b/frontend/src/app/shared/toggle/toggle.component.html
@@ -1,4 +1,4 @@
 <div class="toggle-container">
     <input type="checkbox" (click)="toggleButton()"/>
     <label class="slider"></label>
-</div>
\ No newline at end of file
+</div>
diff --git a/frontend/src/styles.scss b/frontend/src/styles.scss
index 3b13bf5f7..942fe4314 100644
--- a/frontend/src/styles.scss
+++ b/frontend/src/styles.scss
@@ -72,23 +72,30 @@ a.dropdown-item[disabled] {
     }
 }
 
-span[class^='entity'] {
-    padding-left: .4em;
+@mixin mark-entity($color) {
+    background-color: rgb(from $color r g b /.2);
+    border-bottom: .2em solid;
+    border-color: $color;
+
+    .entity-icon, &.entity-icon {
+        padding-left: .3em;
+        padding-right: .3em;
+        color: $color;
+    }
 }
 
-.entity-per {
-    background-color: $entity-person;
-    clip-path: polygon(100% 0%, 100% 100%, 0% 100%, 5px 50%, 0% 0%);
+.entity-person {
+    @include mark-entity($entity-person);
 }
-.entity-loc {
-    background-color: $entity-location;
-    clip-path: polygon(5px 0%, 100% 0%, 100% 100%, 5px 100%, 0% 50%);
+
+.entity-location {
+    @include mark-entity($entity-location);
 }
-.entity-org {
-    background-color: $entity-organization;
-    clip-path: polygon(0 0, 100% 0%, 100% 100%, 5px 100%);
+
+.entity-organization {
+    @include mark-entity($entity-organization);
 }
-.entity-mis {
-    background-color: $entity-miscellaneous;
-    clip-path: polygon(5px 0, 100% 0%, 100% 100%, 0% 100%);
+
+.entity-miscellaneous {
+    @include mark-entity($entity-miscellaneous);
 }

From 0ba02ebc642b8414c065a38930702f9c7bd20c51 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Mon, 1 Jul 2024 18:05:58 +0200
Subject: [PATCH 74/91] Revert "revertme: use underscore for legacy index"

This reverts commit db4ba62b65bb6bb4a9a0c45137ba0aab745f4299.
---
 backend/addcorpus/models.py | 2 +-
 backend/es/views.py         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index 962943b36..84349e205 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -270,7 +270,7 @@ def has_named_entities(self):
                 index=self.es_index)
             fields = mapping[self.es_index].get(
                 'mappings', {}).get('properties', {}).keys()
-            if any(field.endswith('_ner') for field in fields):
+            if any(field.endswith(':ner') for field in fields):
                 return True
         except:
             return False
diff --git a/backend/es/views.py b/backend/es/views.py
index f372be8b9..355b86bf2 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -130,7 +130,7 @@ def get(self, request, *args, **kwargs):
             source = results[0]['_source']
             for field in fields:
                 text_with_entities = source.get(field)
-                annotations.update({field.replace('_ner', ''): self.find_entities(
+                annotations.update({field.replace(':ner', ''): self.find_entities(
                     text_with_entities)})
             response = {'annotations': annotations}
         return Response(response)
@@ -139,7 +139,7 @@ def find_named_entity_fields(self, client, index: str) -> list[str]:
         mapping = client.indices.get_mapping(index=index)
         fields = mapping[index]['mappings']['properties']
         field_names = fields.keys()
-        return [name for name in field_names if name.endswith('_ner') and fields[name].get('type') == 'annotated_text']
+        return [name for name in field_names if name.endswith(':ner') and fields[name].get('type') == 'annotated_text']
 
     def construct_named_entity_query(self, fields: list[str], document_id: str) -> dict:
         return {

From ee87449b85646fd3eea97448441e600def75af96 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 3 Jul 2024 10:04:17 +0200
Subject: [PATCH 75/91] fix backend test

---
 backend/es/tests/test_named_entity_search.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/backend/es/tests/test_named_entity_search.py b/backend/es/tests/test_named_entity_search.py
index 3a58d0cfc..1335c63b8 100644
--- a/backend/es/tests/test_named_entity_search.py
+++ b/backend/es/tests/test_named_entity_search.py
@@ -41,9 +41,8 @@ def test_find_named_entity_fields(es_ner_search_client):
 def test_find_entities():
     viewset = NamedEntitySearchView()
     text = '[Guybrush Threepwood](PER) is looking for treasure on [Monkey Island](LOC)'
-    entity_classes = set()
-    output = viewset.find_entities(text, entity_classes)
-    expected = '<span class="entity-per">Guybrush Threepwood</span> is looking for treasure on <span class="entity-loc">Monkey Island</span>'
+    output = viewset.find_entities(text)
+    expected = [{'entity': 'person', 'text': 'Guybrush Threepwood'},
+                {'entity': 'flat', 'text': ' is looking for treasure on '},
+                {'entity': 'location', 'text': 'Monkey Island'}]
     assert output == expected
-    assert len(list(entity_classes)) == 2
-    assert all(entity in list(entity_classes) for entity in ['PER', 'LOC'])

From e4e1104c6847f466a3abf3324afbc8dc91e4da22 Mon Sep 17 00:00:00 2001
From: Arjan Mossel <arjanmossel@gmail.com>
Date: Thu, 4 Jul 2024 13:14:51 +0200
Subject: [PATCH 76/91] Docker: run apt-get upgrade

Fixes "E: Unable to locate package libxmlsec1-dev" errors
---
 backend/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/backend/Dockerfile b/backend/Dockerfile
index 3548587c4..2c58b766e 100644
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@@ -3,7 +3,7 @@ FROM docker.io/library/python:3.9
 # Setting this means stdout and stderr streams are sent to terminal in real time
 ENV PYTHONUNBUFFERED 1
 # Get required libraries for xmlsec
-RUN apt-get -y update
+RUN apt-get -y update && apt-get -y upgrade
 RUN apt-get install -y pkg-config libxml2-dev libxmlsec1-dev libxmlsec1-openssl default-libmysqlclient-dev
 
 RUN pip install --upgrade pip

From fad0db8ca7060b1bb0d2c0fa0a792d57122eeb9f Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 4 Jul 2024 14:04:20 +0200
Subject: [PATCH 77/91] remove user condition from word model component

---
 frontend/src/app/word-models/word-models.component.html | 2 +-
 frontend/src/app/word-models/word-models.component.ts   | 2 --
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/frontend/src/app/word-models/word-models.component.html b/frontend/src/app/word-models/word-models.component.html
index f0ec4c6b0..ca5255730 100644
--- a/frontend/src/app/word-models/word-models.component.html
+++ b/frontend/src/app/word-models/word-models.component.html
@@ -1,6 +1,6 @@
 <ia-corpus-header [corpus]="corpus" currentPage="word-models"></ia-corpus-header>
 
-<section class="section search-section" #searchSection [ngClass]="{'is-scrolled-down': isScrolledDown}" *ngIf="user">
+<section class="section search-section" #searchSection [ngClass]="{'is-scrolled-down': isScrolledDown}">
     <div class="container is-readable">
         <form class="block">
             <div class="field has-addons">
diff --git a/frontend/src/app/word-models/word-models.component.ts b/frontend/src/app/word-models/word-models.component.ts
index f1353b265..566d9700d 100644
--- a/frontend/src/app/word-models/word-models.component.ts
+++ b/frontend/src/app/word-models/word-models.component.ts
@@ -18,7 +18,6 @@ export class WordModelsComponent extends ParamDirective {
     public searchSection: ElementRef;
     public isScrolledDown: boolean;
 
-    user: User;
     corpus: Corpus;
 
     queryText: string;
@@ -79,7 +78,6 @@ export class WordModelsComponent extends ParamDirective {
     }
 
     async initialize(): Promise<void> {
-        this.user = await this.authService.getCurrentUserPromise();
         this.corpusService.currentCorpus.subscribe(this.setCorpus.bind(this));
     }
 

From 3739b0ffc4aa83e41d7aa208eb712f6bd3159ba2 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 4 Jul 2024 14:04:52 +0200
Subject: [PATCH 78/91] remove IsAuthenticated permission from backend
 wordmodel views

---
 backend/wordmodels/views.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/backend/wordmodels/views.py b/backend/wordmodels/views.py
index 81b2de6a1..1c4d28ac3 100644
--- a/backend/wordmodels/views.py
+++ b/backend/wordmodels/views.py
@@ -1,7 +1,5 @@
-from django.shortcuts import render
 from rest_framework.views import APIView
 from rest_framework.response import Response
-from rest_framework.permissions import IsAuthenticated
 from addcorpus.permissions import CorpusAccessPermission, corpus_name_from_request
 from wordmodels import utils, visualisations
 from rest_framework.exceptions import APIException
@@ -11,7 +9,7 @@ class RelatedWordsView(APIView):
     Get words with the highest similarity to the query term
     '''
 
-    permission_classes = [IsAuthenticated, CorpusAccessPermission]
+    permission_classes = [CorpusAccessPermission]
 
     def post(self, request, *args, **kwargs):
         corpus = corpus_name_from_request(request)
@@ -35,7 +33,7 @@ class SimilarityView(APIView):
     Get similarity between two query terms
     '''
 
-    permission_classes = [IsAuthenticated, CorpusAccessPermission]
+    permission_classes = [CorpusAccessPermission]
 
     def get(self, request, *args, **kwargs):
         corpus = corpus_name_from_request(request)
@@ -55,7 +53,7 @@ class WordInModelView(APIView):
     Check if a word has a vector in the model for a corpus
     '''
 
-    permission_classes = [IsAuthenticated, CorpusAccessPermission]
+    permission_classes = [CorpusAccessPermission]
 
     def get(self, request, *args, **kwargs):
         corpus = corpus_name_from_request(request)

From 0a2d421353cc7530c78f49b24d63686211a391f1 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Thu, 4 Jul 2024 15:01:46 +0200
Subject: [PATCH 79/91] Add celery debug configuration

---
 .vscode/launch.json | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/.vscode/launch.json b/.vscode/launch.json
index 9ae029d6b..786b5f0a5 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -59,6 +59,26 @@
                 "/*": "*",
                 "/./~/*": "${webRoot}/node_modules/*"
             }
+        },
+        {
+            "name": "celery",
+            "type": "debugpy",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/backend",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/backend"
+            },
+            "module": "celery",
+            "console": "integratedTerminal",
+            "args": [
+                "-A",
+                "ianalyzer.celery",
+                "worker",
+                "--pool=solo",
+                "--concurrency=1",
+                "--events",
+                "--loglevel=info"
+            ]
         }
     ],
     "inputs": [

From 6f650f17d86b87f0811e5a8f8bdb8ba8582814a1 Mon Sep 17 00:00:00 2001
From: Arjan Mossel <arjanmossel@gmail.com>
Date: Fri, 28 Jun 2024 13:39:09 +0200
Subject: [PATCH 80/91] Do not provide a default JMIG_DATA_URL

Otherwise data_filepath isn't used.
data_directory must be configured to pass corpus validation.
---
 backend/corpora/jewishmigration/jewishmigration.py   | 12 ++++++------
 .../corpora/jewishmigration/test_jewishmigration.py  |  1 +
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/backend/corpora/jewishmigration/jewishmigration.py b/backend/corpora/jewishmigration/jewishmigration.py
index 24fa4486e..02fd3c8a3 100644
--- a/backend/corpora/jewishmigration/jewishmigration.py
+++ b/backend/corpora/jewishmigration/jewishmigration.py
@@ -48,9 +48,9 @@ class JewishMigration(PeacePortal, JSONCorpusDefinition):
     min_date = datetime(year=1, month=1, day=1)
     max_date = datetime(year=1800, month=12, day=31)
 
-    data_directory = getattr(settings, 'JMIG_DATA')
-    data_url = getattr(settings, 'JMIG_DATA_URL',
-                       'localhost:8100/api/records/')
+    data_directory = settings.JMIG_DATA_DIR
+    data_filepath = getattr(settings, 'JMIG_DATA', None)
+    data_url = getattr(settings, 'JMIG_DATA_URL', None)
 
     es_index = getattr(settings, 'JMIG_INDEX', 'jewishmigration')
     image = 'jewish_inscriptions.jpg'
@@ -62,12 +62,12 @@ def sources(self, start, end):
         if self.data_url:
             response = requests.get(self.data_url)
             list_of_sources = response.json()
-        elif self.data_directory:
-            with open(self.data_directory, 'r') as f:
+        elif self.data_filepath:
+            with open(self.data_filepath, 'r') as f:
                 list_of_sources = json.load(f)
         else:
             logging.getLogger('indexing').warning(
-                'No data directory or URL provided.')
+                'No data filepath or URL provided.')
         for source in list_of_sources:
             yield source
 
diff --git a/backend/corpora/jewishmigration/test_jewishmigration.py b/backend/corpora/jewishmigration/test_jewishmigration.py
index cec55f18a..d1dc7acdd 100644
--- a/backend/corpora/jewishmigration/test_jewishmigration.py
+++ b/backend/corpora/jewishmigration/test_jewishmigration.py
@@ -136,6 +136,7 @@ def jm_corpus_settings(settings):
     settings.CORPORA = {
         'jewishmigration': os.path.join(here, 'jewishmigration.py')
     }
+    settings.JMIG_DATA_DIR = '/corpora'
     settings.JMIG_DATA = None
     settings.JMIG_DATA_URL = 'http://www.example.com'
     settings.JMIG_INDEX = 'test-jewishmigration'

From f9f7322a0171fe22fe0051c14fb02672b9b106d3 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 4 Jul 2024 15:14:04 +0200
Subject: [PATCH 81/91] use params.get instead of lodash get

---
 .../app/word-models/related-words/related-words.component.ts  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/src/app/word-models/related-words/related-words.component.ts b/frontend/src/app/word-models/related-words/related-words.component.ts
index 52333dafb..696b8115b 100644
--- a/frontend/src/app/word-models/related-words/related-words.component.ts
+++ b/frontend/src/app/word-models/related-words/related-words.component.ts
@@ -26,7 +26,7 @@ export class RelatedWordsComponent extends ParamDirective implements OnChanges {
 
     isLoading$ = new BehaviorSubject<boolean>(false);
 
-    neighbours = 5;
+    neighbours: number = 5;
 
     timeIntervals: string[] = [];
     totalData: WordSimilarity[]; // similarities of overall nearest neighbours per time period
@@ -61,7 +61,7 @@ export class RelatedWordsComponent extends ParamDirective implements OnChanges {
     teardown() {}
 
     setStateFromParams(params: Params) {
-        this.neighbours = _.get(params, 'neighbours', 5);
+        this.neighbours = params.get('neighbours');
     }
 
     getData(): void {

From 4f5be59cd214aae7a8114947f7c38ea83add6831 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Thu, 4 Jul 2024 16:00:22 +0200
Subject: [PATCH 82/91] Hide token columns in histogram when on documents
 measure

Resolves #1560
---
 .../barchart/histogram.component.ts           | 47 ++++++++++---------
 1 file changed, 26 insertions(+), 21 deletions(-)

diff --git a/frontend/src/app/visualization/barchart/histogram.component.ts b/frontend/src/app/visualization/barchart/histogram.component.ts
index a73f630fd..24f952f09 100644
--- a/frontend/src/app/visualization/barchart/histogram.component.ts
+++ b/frontend/src/app/visualization/barchart/histogram.component.ts
@@ -213,28 +213,33 @@ export class HistogramComponent
                     formatDownload: this.formatDownloadValue,
                     isOptional: 'relative_doc_count' !== valueKey,
                 },
-                {
-                    key: 'match_count',
-                    label: 'Token Frequency',
-                    format: this.formatValue('raw'),
-                    formatDownload: this.formatDownloadValue,
-                    isOptional: 'match_count' !== valueKey,
-                },
-                {
-                    key: 'matches_by_doc_count',
-                    label: 'Relative Frequency (documents)',
-                    format: this.formatValue('documents'),
-                    formatDownload: this.formatDownloadValue,
-                    isOptional: 'matches_by_doc_count' !== valueKey,
-                },
-                {
-                    key: 'matches_by_token_count',
-                    label: 'Relative Frequency (terms)',
-                    format: this.formatValue('terms'),
-                    formatDownload: this.formatDownloadValue,
-                    isOptional: 'matches_by_token_count' !== valueKey,
-                },
             ];
+            if (this.frequencyMeasure == 'tokens') {
+                // Headers related to tokens should not be applied to document visualizations
+                this.tableHeaders = this.tableHeaders.concat([
+                    {
+                        key: 'match_count',
+                        label: 'Token Frequency',
+                        format: this.formatValue('raw'),
+                        formatDownload: this.formatDownloadValue,
+                        isOptional: 'match_count' !== valueKey,
+                    },
+                    {
+                        key: 'matches_by_doc_count',
+                        label: 'Relative Frequency (documents)',
+                        format: this.formatValue('documents'),
+                        formatDownload: this.formatDownloadValue,
+                        isOptional: 'matches_by_doc_count' !== valueKey,
+                    },
+                    {
+                        key: 'matches_by_token_count',
+                        label: 'Relative Frequency (terms)',
+                        format: this.formatValue('terms'),
+                        formatDownload: this.formatDownloadValue,
+                        isOptional: 'matches_by_token_count' !== valueKey,
+                    },
+                ]);
+            }
         }
     }
 }

From 7c92ce247324cae06ab8404f67703aa3f7530f7c Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Wed, 3 Jul 2024 11:52:28 +0200
Subject: [PATCH 83/91] fix frontend unit tests

---
 backend/es/views.py                                          | 3 +--
 frontend/src/app/common-test-bed.ts                          | 2 ++
 frontend/src/app/document-view/document-view.component.html  | 2 +-
 .../src/app/document-view/document-view.component.spec.ts    | 4 +++-
 frontend/src/app/document/document.module.ts                 | 3 ++-
 frontend/src/app/models/found-document.ts                    | 5 +----
 frontend/src/app/models/search-results.ts                    | 2 +-
 frontend/src/app/shared/pipes/paragraph.pipe.ts              | 2 +-
 frontend/src/mock-data/entity.ts                             | 4 +++-
 9 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/backend/es/views.py b/backend/es/views.py
index 355b86bf2..55e36ed7c 100644
--- a/backend/es/views.py
+++ b/backend/es/views.py
@@ -132,8 +132,7 @@ def get(self, request, *args, **kwargs):
                 text_with_entities = source.get(field)
                 annotations.update({field.replace(':ner', ''): self.find_entities(
                     text_with_entities)})
-            response = {'annotations': annotations}
-        return Response(response)
+        return Response(annotations)
 
     def find_named_entity_fields(self, client, index: str) -> list[str]:
         mapping = client.indices.get_mapping(index=index)
diff --git a/frontend/src/app/common-test-bed.ts b/frontend/src/app/common-test-bed.ts
index eecd514e4..888762621 100644
--- a/frontend/src/app/common-test-bed.ts
+++ b/frontend/src/app/common-test-bed.ts
@@ -2,6 +2,7 @@ import { TestBed } from '@angular/core/testing';
 import { ElementRef } from '@angular/core';
 import { RouterTestingModule } from '@angular/router/testing';
 import { HttpClientModule } from '@angular/common/http';
+import {FontAwesomeTestingModule} from '@fortawesome/angular-fontawesome/testing';
 
 import { appRoutes, declarations, imports, providers } from './app.module';
 
@@ -28,6 +29,7 @@ import { SimpleStore } from './store/simple-store';
 export const commonTestBed = () => {
     const filteredImports = imports.filter(value => !(value in [HttpClientModule]));
     filteredImports.push(RouterTestingModule.withRoutes(appRoutes));
+    filteredImports.push(FontAwesomeTestingModule)
     const filteredProviders = providers.filter(provider => !(
         provider in [ApiService, CorpusService, DialogService, ElasticSearchService, SearchService]));
     filteredProviders.push(
diff --git a/frontend/src/app/document-view/document-view.component.html b/frontend/src/app/document-view/document-view.component.html
index e498a86e2..26c464270 100644
--- a/frontend/src/app/document-view/document-view.component.html
+++ b/frontend/src/app/document-view/document-view.component.html
@@ -44,7 +44,7 @@
                             <span *ngFor="let textSegment of annotations[field.name]">
                                 <mark *ngIf="textSegment.entity !== 'flat'; else unannotatedText" [className]="'entity-'+textSegment.entity">
                                     {{textSegment.text}}
-                                    <fa-icon class="entity-icon" [icon]="entityIcons[textSegment.entity]" [title]="textSegment.entity"></fa-icon>
+                                    <fa-icon [icon]="entityIcons[textSegment.entity]" [title]="textSegment.entity" class="entity-icon"></fa-icon>
                                 </mark>
                                 <ng-template #unannotatedText>
                                     {{textSegment.text | paragraph}}
diff --git a/frontend/src/app/document-view/document-view.component.spec.ts b/frontend/src/app/document-view/document-view.component.spec.ts
index 703550fc7..9f1e799ee 100644
--- a/frontend/src/app/document-view/document-view.component.spec.ts
+++ b/frontend/src/app/document-view/document-view.component.spec.ts
@@ -45,10 +45,12 @@ describe('DocumentViewComponent', () => {
         expect(debug[1].attributes['id']).toBe('tab-scan');
     });
 
-    it('shows a named entity legend if showEntities is true', () => {
+    it('shows named entities if showEntities is true', async () => {
         expect(fixture.debugElement.query(By.css('ia-entity-legend'))).toBeFalsy();
         component.showEntities = true;
         fixture.detectChanges();
+        await fixture.whenStable();
+        fixture.detectChanges();
         expect(fixture.debugElement.query(By.css('ia-entity-legend'))).toBeTruthy();
     });
 
diff --git a/frontend/src/app/document/document.module.ts b/frontend/src/app/document/document.module.ts
index def98c70e..67822bcc8 100644
--- a/frontend/src/app/document/document.module.ts
+++ b/frontend/src/app/document/document.module.ts
@@ -19,8 +19,8 @@ import { ElasticsearchHighlightPipe, GeoDataPipe, ParagraphPipe, SnippetPipe } f
         SearchRelevanceComponent,
         DocumentPopupComponent,
         DocumentPreviewComponent,
-        ElasticsearchHighlightPipe,
         EntityLegendComponent,
+        ElasticsearchHighlightPipe,
         GeoDataPipe,
         ParagraphPipe,
         SnippetPipe
@@ -36,6 +36,7 @@ import { ElasticsearchHighlightPipe, GeoDataPipe, ParagraphPipe, SnippetPipe } f
         DocumentViewComponent,
         DocumentPageComponent,
         DocumentPopupComponent,
+        EntityLegendComponent,
         SearchRelevanceComponent,
     ]
 })
diff --git a/frontend/src/app/models/found-document.ts b/frontend/src/app/models/found-document.ts
index db83ba9b1..6fcbcb134 100644
--- a/frontend/src/app/models/found-document.ts
+++ b/frontend/src/app/models/found-document.ts
@@ -126,10 +126,7 @@ export class FoundDocument {
     }
 
     private fetchAnnotatedEntities(): Observable<{[fieldName: string]: FieldEntities[]}> {
-        const response$ = this.entityService.getDocumentEntities(this.corpus, this.id);
-        return response$.pipe(
-            map( response => response.annotations || {} )
-        );
+        return this.entityService.getDocumentEntities(this.corpus, this.id);
     }
 
     private setTags(tags: Tag[]): Observable<Tag[]> {
diff --git a/frontend/src/app/models/search-results.ts b/frontend/src/app/models/search-results.ts
index 212a001ba..1eac5b1ff 100644
--- a/frontend/src/app/models/search-results.ts
+++ b/frontend/src/app/models/search-results.ts
@@ -88,7 +88,7 @@ export interface FieldEntities {
 }
 
 export interface NamedEntitiesResult {
-    annotations: {[fieldName: string]: FieldEntities[]};
+    [fieldName: string]: FieldEntities[]
 }
 
 export interface TaskResult { task_ids: string[] };
diff --git a/frontend/src/app/shared/pipes/paragraph.pipe.ts b/frontend/src/app/shared/pipes/paragraph.pipe.ts
index 877d6fac2..eebafc51a 100644
--- a/frontend/src/app/shared/pipes/paragraph.pipe.ts
+++ b/frontend/src/app/shared/pipes/paragraph.pipe.ts
@@ -13,7 +13,7 @@ export class ParagraphPipe implements PipeTransform {
 
     addParagraphTags(content: string | string[]) {
         const paragraphs = typeof content === 'string' ? content.split('\n') : content;
-        if (paragraphs.length == 1) {
+        if (!paragraphs || paragraphs.length === 1) {
             return content;
         }
         return paragraphs.map(p => `<p>${p}</p>`).join(' ');
diff --git a/frontend/src/mock-data/entity.ts b/frontend/src/mock-data/entity.ts
index 3fefbfc25..9452852ec 100644
--- a/frontend/src/mock-data/entity.ts
+++ b/frontend/src/mock-data/entity.ts
@@ -5,6 +5,8 @@ import { Corpus, NamedEntitiesResult } from '../app/models';
 export class EntityServiceMock {
 
     public getDocumentEntities(corpus: Corpus, id: string): Observable<NamedEntitiesResult> {
-        return of({annotations: [{'content': '<span class="entity-person">Wally</span> was last seen in <span class="entity-location">Paris</span>'}], entities: ['location', 'person']})   
+        return of({speech: [{entity: 'person', text: 'Wally'},
+            {entity: 'flat', text: ' was last seen in '},
+            {entity: 'location', text: 'Paris'}]})
     }
 }

From 4a9312b81ff9cc091413f53b69bb1940be0ba092 Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 4 Jul 2024 18:00:58 +0200
Subject: [PATCH 84/91] correct typing: Params => ParamMap

---
 .../visualization/barchart/barchart-options.component.ts    | 4 ++--
 .../term-comparison-editor.component.ts                     | 4 ++--
 .../word-models/related-words/related-words.component.ts    | 6 +++---
 frontend/src/app/word-models/word-models.component.ts       | 6 +++---
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/frontend/src/app/visualization/barchart/barchart-options.component.ts b/frontend/src/app/visualization/barchart/barchart-options.component.ts
index 307cdb822..5a339cdfd 100644
--- a/frontend/src/app/visualization/barchart/barchart-options.component.ts
+++ b/frontend/src/app/visualization/barchart/barchart-options.component.ts
@@ -1,5 +1,5 @@
 import { Component, EventEmitter, Input, OnChanges, Output, SimpleChanges } from '@angular/core';
-import { ActivatedRoute, Params, Router } from '@angular/router';
+import { ActivatedRoute, ParamMap, Router } from '@angular/router';
 import * as _ from 'lodash';
 import { ParamDirective } from '../../param/param-directive';
 import { Normalizer, ChartType, ChartParameters } from '../../models';
@@ -85,7 +85,7 @@ export class BarchartOptionsComponent
 
     teardown() {}
 
-    setStateFromParams(params: Params) {
+    setStateFromParams(params: ParamMap) {
         if (params.has('normalize')) {
             this.currentNormalizer = params.get('normalize') as Normalizer;
         } else {
diff --git a/frontend/src/app/visualization/barchart/term-comparison-editor/term-comparison-editor.component.ts b/frontend/src/app/visualization/barchart/term-comparison-editor/term-comparison-editor.component.ts
index 12b0ccbfe..08679fae3 100644
--- a/frontend/src/app/visualization/barchart/term-comparison-editor/term-comparison-editor.component.ts
+++ b/frontend/src/app/visualization/barchart/term-comparison-editor/term-comparison-editor.component.ts
@@ -1,5 +1,5 @@
 import { Component, EventEmitter, Input, OnChanges, Output, SimpleChanges } from '@angular/core';
-import { ActivatedRoute, Params, Router } from '@angular/router';
+import { ActivatedRoute, ParamMap, Router } from '@angular/router';
 
 import { ParamDirective } from '../../../param/param-directive';
 import { ParamService } from '../../../services';
@@ -44,7 +44,7 @@ export class TermComparisonEditorComponent
 
     teardown() {}
 
-    setStateFromParams(params: Params) {
+    setStateFromParams(params: ParamMap) {
         if (params.has('compareTerm')) {
             this.queries = params.getAll('compareTerm');
             this.queriesChanged.emit(this.queries);
diff --git a/frontend/src/app/word-models/related-words/related-words.component.ts b/frontend/src/app/word-models/related-words/related-words.component.ts
index 696b8115b..963c16ab2 100644
--- a/frontend/src/app/word-models/related-words/related-words.component.ts
+++ b/frontend/src/app/word-models/related-words/related-words.component.ts
@@ -1,5 +1,5 @@
 import { Component, EventEmitter, HostBinding, Input, OnChanges, Output, SimpleChanges } from '@angular/core';
-import { ActivatedRoute, Params, Router } from '@angular/router';
+import { ActivatedRoute, ParamMap, Params, Router } from '@angular/router';
 import { BehaviorSubject } from 'rxjs';
 import * as _ from 'lodash';
 import { showLoading } from '../../utils/utils';
@@ -60,8 +60,8 @@ export class RelatedWordsComponent extends ParamDirective implements OnChanges {
 
     teardown() {}
 
-    setStateFromParams(params: Params) {
-        this.neighbours = params.get('neighbours');
+    setStateFromParams(params: ParamMap) {
+        this.neighbours = Number(params.get('neighbours'));
     }
 
     getData(): void {
diff --git a/frontend/src/app/word-models/word-models.component.ts b/frontend/src/app/word-models/word-models.component.ts
index f1353b265..8dce26872 100644
--- a/frontend/src/app/word-models/word-models.component.ts
+++ b/frontend/src/app/word-models/word-models.component.ts
@@ -1,5 +1,5 @@
 import { Component, ElementRef, HostListener, ViewChild } from '@angular/core';
-import { ActivatedRoute, Params, Router } from '@angular/router';
+import { ActivatedRoute, ParamMap, Router } from '@angular/router';
 import * as _ from 'lodash';
 
 import { Corpus, QueryFeedback, User, WordInModelResult } from '../models';
@@ -85,7 +85,7 @@ export class WordModelsComponent extends ParamDirective {
 
     teardown() {}
 
-    setStateFromParams(params: Params) {
+    setStateFromParams(params: ParamMap) {
         const queryFromParams = params.get('query');
         if (queryFromParams !== this.activeQuery) {
             this.queryText = queryFromParams;
@@ -101,7 +101,7 @@ export class WordModelsComponent extends ParamDirective {
             this.queryFeedback = { status: 'success' };
         }
         if (params.has('show')) {
-            this.currentTab = params.get('show');
+            this.currentTab = params.get('show') as 'relatedwords' | 'wordsimilarity';
         } else {
             this.currentTab = 'relatedwords';
         }

From 4e6b4cbcf4550cc6f17895f4847eb223e40c099e Mon Sep 17 00:00:00 2001
From: BeritJanssen <berit.janssen@gmail.com>
Date: Thu, 4 Jul 2024 18:08:21 +0200
Subject: [PATCH 85/91] fix stray typing issue

---
 frontend/src/app/param/param-directive.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/src/app/param/param-directive.ts b/frontend/src/app/param/param-directive.ts
index cb15c0c81..364cb82f9 100644
--- a/frontend/src/app/param/param-directive.ts
+++ b/frontend/src/app/param/param-directive.ts
@@ -1,5 +1,5 @@
 import { Directive, OnDestroy, OnInit } from '@angular/core';
-import { ActivatedRoute, Params, Router } from '@angular/router';
+import { ActivatedRoute, ParamMap, Params, Router } from '@angular/router';
 import { Subscription } from 'rxjs';
 import * as _ from 'lodash';
 
@@ -57,5 +57,5 @@ export abstract class ParamDirective implements OnDestroy, OnInit {
 
     abstract teardown();
 
-    abstract setStateFromParams(params: Params);
+    abstract setStateFromParams(params: ParamMap);
 }

From b0cc71f4677e71cc87f47c43aaed6b0a6eb00374 Mon Sep 17 00:00:00 2001
From: Luka van der Plas <lukavdplas@mailfence.com>
Date: Thu, 4 Jul 2024 18:25:20 +0200
Subject: [PATCH 86/91] fix query text in csv

---
 backend/download/tasks.py                     | 11 ++---------
 backend/download/tests/test_download_views.py | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/backend/download/tasks.py b/backend/download/tasks.py
index 875f4d5bc..ccc559065 100644
--- a/backend/download/tasks.py
+++ b/backend/download/tasks.py
@@ -44,19 +44,12 @@ def make_download(request_json, download_id, download_size=None):
     es_query = api_query_to_es_query(request_json, corpus_name)
     results, _total = es_download.scroll(
         corpus_name, es_query, download_size)
+
     filepath = create_csv.search_results_csv(
-        results, request_json['fields'], query, download_id)
+        results, request_json['fields'], query.get_query_text(es_query), download_id)
     return filepath
 
 
-def create_query(request_json):
-    """
-    format the route of the search into a query string
-    """
-    route = request_json.get('route')
-    return re.sub(r';|%\d+', '_', re.sub(r'\$', '', route.split('/')[2]))
-
-
 def try_download(tasks_func, download):
     '''
     Try initialising a task chain for a download. Marks the download
diff --git a/backend/download/tests/test_download_views.py b/backend/download/tests/test_download_views.py
index ef1c6411a..7cbbd981c 100644
--- a/backend/download/tests/test_download_views.py
+++ b/backend/download/tests/test_download_views.py
@@ -246,3 +246,22 @@ def test_unauthenticated_download(db, client, basic_mock_corpus, basic_corpus_pu
     download_objects = Download.objects.all()
     assert download_objects.count() == 1
     assert download_objects.first().user == None
+
+def test_query_text_in_csv(db, client, basic_mock_corpus, basic_corpus_public, index_basic_mock_corpus):
+    es_query = query.set_query_text(mock_match_all_query(), 'ghost')
+    download_request_json = {
+        'corpus': basic_mock_corpus,
+        'es_query': es_query,
+        'fields': ['character', 'line'],
+        'route': f"/search/{basic_mock_corpus}",
+        'encoding': 'utf-8'
+    }
+    response = client.post('/api/download/search_results',
+                           download_request_json,
+                           content_type='application/json'
+                           )
+    assert status.is_success(response.status_code)
+    stream = read_file_response(response, 'utf-8')
+    reader = csv.DictReader(stream, delimiter=';')
+    row = next(reader)
+    assert row['query'] == 'ghost'

From 2b4230932fa3258888e1d5dfcc5a0233fec27e1c Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Fri, 5 Jul 2024 09:48:38 +0200
Subject: [PATCH 87/91] Sort documentation page in canonical order

---
 backend/addcorpus/models.py                   |  6 +++++-
 backend/addcorpus/tests/test_corpus_views.py  |  7 ++++++-
 backend/addcorpus/views.py                    | 18 +++++++++++++-----
 backend/corpora_test/basic/license/license.md |  1 +
 backend/corpora_test/basic/mock_csv_corpus.py |  2 ++
 5 files changed, 27 insertions(+), 7 deletions(-)
 create mode 100644 backend/corpora_test/basic/license/license.md

diff --git a/backend/addcorpus/models.py b/backend/addcorpus/models.py
index ca31d9912..91dae899d 100644
--- a/backend/addcorpus/models.py
+++ b/backend/addcorpus/models.py
@@ -431,11 +431,12 @@ def clean(self):
                     e
                 ])
 
+
 class CorpusDocumentationPage(models.Model):
     class PageType(models.TextChoices):
         GENERAL = ('general', 'General information')
         CITATION = ('citation', 'Citation')
-        LICENSE = ('license', 'Licence')
+        LICENSE = ('license', 'License')
         TERMS_OF_SERVICE = ('terms_of_service', 'Terms of service')
         WORDMODELS = ('wordmodels', 'Word models')
 
@@ -455,6 +456,9 @@ class PageType(models.TextChoices):
         help_text='markdown contents of the documentation'
     )
 
+    def __str__(self):
+        return f'{self.corpus_configuration.corpus.name} - {self.type}'
+
     class Meta:
         constraints = [
             UniqueConstraint(
diff --git a/backend/addcorpus/tests/test_corpus_views.py b/backend/addcorpus/tests/test_corpus_views.py
index 8fd15290c..d0080c053 100644
--- a/backend/addcorpus/tests/test_corpus_views.py
+++ b/backend/addcorpus/tests/test_corpus_views.py
@@ -19,9 +19,14 @@ def test_no_corpora(db, settings, admin_client):
 def test_corpus_documentation_view(admin_client, basic_mock_corpus, settings):
     response = admin_client.get(f'/api/corpus/documentation/{basic_mock_corpus}/')
     assert response.status_code == 200
+    pages = response.data
+
+    # check that the pages are sorted in canonical order
+    page_types = [page['type'] for page in pages]
+    assert page_types == ['General information', 'Citation', 'License']
 
     # should contain citation guidelines
-    citation_page = next(page for page in response.data if page['type'] == 'Citation')
+    citation_page = next(page for page in pages if page['type'] == 'Citation')
 
     # check that the page template is rendered with context
     content = citation_page['content']
diff --git a/backend/addcorpus/views.py b/backend/addcorpus/views.py
index f495fd162..a32064011 100644
--- a/backend/addcorpus/views.py
+++ b/backend/addcorpus/views.py
@@ -42,22 +42,30 @@ def send_corpus_file(corpus='', subdir='', filename=''):
 
     return FileResponse(open(path, 'rb'))
 
+
 class CorpusDocumentationPageViewset(viewsets.ModelViewSet):
     permission_classes = [IsAuthenticatedOrReadOnly, CorpusAccessPermission]
     serializer_class = CorpusDocumentationPageSerializer
 
-    def get_queryset(self):
-        corpus_name = corpus_name_from_request(self.request)
-        pages = CorpusDocumentationPage.objects.filter(corpus_configuration__corpus__name=corpus_name)
-
+    @staticmethod
+    def get_relevant_pages(pages, corpus_name):
         # only include wordmodels documentation if models are present
         if Corpus.objects.get(name=corpus_name).has_python_definition:
             definition = load_corpus_definition(corpus_name)
             if definition.word_models_present:
                 return pages
-
         return pages.exclude(type=CorpusDocumentationPage.PageType.WORDMODELS)
 
+    def get_queryset(self):
+        corpus_name = corpus_name_from_request(self.request)
+        pages = CorpusDocumentationPage.objects.filter(
+            corpus_configuration__corpus__name=corpus_name)
+        relevant_pages = self.get_relevant_pages(pages, corpus_name)
+        canonical_order = [e.value for e in CorpusDocumentationPage.PageType]
+
+        return sorted(
+            relevant_pages, key=lambda p: canonical_order.index(p.type))
+
 
 class CorpusImageView(APIView):
     '''
diff --git a/backend/corpora_test/basic/license/license.md b/backend/corpora_test/basic/license/license.md
new file mode 100644
index 000000000..4fcb91a18
--- /dev/null
+++ b/backend/corpora_test/basic/license/license.md
@@ -0,0 +1 @@
+Do whatever you please.
diff --git a/backend/corpora_test/basic/mock_csv_corpus.py b/backend/corpora_test/basic/mock_csv_corpus.py
index 84711f8a0..3b3d38360 100644
--- a/backend/corpora_test/basic/mock_csv_corpus.py
+++ b/backend/corpora_test/basic/mock_csv_corpus.py
@@ -25,6 +25,8 @@ class MockCSVCorpus(CSVCorpusDefinition):
     max_date = datetime.datetime(year=2022, month=12, day=31)
     data_directory = os.path.join(here, 'source_data')
     citation_page = 'citation.md'
+    license_page = 'license.md'
+    description_page = 'mock-csv-corpus.md'
 
     languages = ['en']
     category = 'book'

From a4dde03fec194ff16f402448fbbb069e20fb815e Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Fri, 5 Jul 2024 10:24:10 +0200
Subject: [PATCH 88/91] Add missing reset$ to CreateDefinitionComponent

---
 .../create-definition/create-definition.component.ts | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
index deba1add0..9d7e16469 100644
--- a/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
+++ b/frontend/src/app/corpus-definitions/create-definition/create-definition.component.ts
@@ -5,11 +5,12 @@ import { APIEditableCorpus, CorpusDefinition } from '../../models/corpus-definit
 import * as _ from 'lodash';
 import { Router } from '@angular/router';
 import { HttpErrorResponse } from '@angular/common/http';
+import { Subject } from 'rxjs';
 
 @Component({
     selector: 'ia-create-definition',
     templateUrl: './create-definition.component.html',
-    styleUrls: ['./create-definition.component.scss']
+    styleUrls: ['./create-definition.component.scss'],
 })
 export class CreateDefinitionComponent {
     actionIcons = actionIcons;
@@ -19,6 +20,8 @@ export class CreateDefinitionComponent {
 
     error: Error;
 
+    reset$ = new Subject<void>();
+
     constructor(private apiService: ApiService, private router: Router) {
         this.corpus = new CorpusDefinition(apiService);
     }
@@ -31,12 +34,15 @@ export class CreateDefinitionComponent {
         this.error = undefined;
         this.corpus.save().subscribe(
             (result: APIEditableCorpus) => {
-                this.router.navigate(['/corpus-definitions', 'edit', result.id]);
+                this.router.navigate([
+                    '/corpus-definitions',
+                    'edit',
+                    result.id,
+                ]);
             },
             (err: HttpErrorResponse) => {
                 this.error = err;
             }
         );
     }
-
 }

From d5cdf8c23f093b75db32c9f174c2dd4e03f13fd9 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Fri, 5 Jul 2024 10:46:17 +0200
Subject: [PATCH 89/91] Remove documentation from media test corpus

---
 backend/corpora_test/media/media_mock_corpus.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/backend/corpora_test/media/media_mock_corpus.py b/backend/corpora_test/media/media_mock_corpus.py
index e965ca660..6bd7be485 100644
--- a/backend/corpora_test/media/media_mock_corpus.py
+++ b/backend/corpora_test/media/media_mock_corpus.py
@@ -13,6 +13,8 @@ class MediaMockCorpus(MockCSVCorpus):
     data_directory = os.path.join(here, 'source_data')
     scan_image_type = 'image/png'
     citation_page = None
+    license_page = None
+    description_page = None
 
     def request_media(self, document, corpus_name):
         field_values = document['fieldValues']

From b2684f5bc7e8119387ea1a8067544653019253ef Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Fri, 5 Jul 2024 18:26:04 +0200
Subject: [PATCH 90/91] Version bump for 5.9.0

---
 CITATION.cff | 4 ++--
 package.json | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CITATION.cff b/CITATION.cff
index b5cd0a0b8..69b99051a 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -35,5 +35,5 @@ keywords:
   - elasticsearch
   - natural language processing
 license: MIT
-version: 5.8.0
-date-released: '2024-06-19'
+version: 5.9.0
+date-released: '2024-07-05'
diff --git a/package.json b/package.json
index cde1022fb..937dc3e55 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "i-analyzer",
-  "version": "5.8.0",
+  "version": "5.9.0",
   "license": "MIT",
   "scripts": {
     "postinstall": "yarn install-back && yarn install-front",

From 9f1014ea4bce99addd44d6ddb60c2e0317819603 Mon Sep 17 00:00:00 2001
From: Jelte van Boheemen <j.vanboheemen@uu.nl>
Date: Fri, 5 Jul 2024 18:31:20 +0200
Subject: [PATCH 91/91] Migrations for addcorpus

---
 ...documentationpage_type_alter_field_name.py | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 backend/addcorpus/migrations/0023_alter_corpusdocumentationpage_type_alter_field_name.py

diff --git a/backend/addcorpus/migrations/0023_alter_corpusdocumentationpage_type_alter_field_name.py b/backend/addcorpus/migrations/0023_alter_corpusdocumentationpage_type_alter_field_name.py
new file mode 100644
index 000000000..6d8be1bb4
--- /dev/null
+++ b/backend/addcorpus/migrations/0023_alter_corpusdocumentationpage_type_alter_field_name.py
@@ -0,0 +1,24 @@
+# Generated by Django 4.2.11 on 2024-07-05 16:30
+
+import addcorpus.validation.creation
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('addcorpus', '0022_add_url_display_type'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='corpusdocumentationpage',
+            name='type',
+            field=models.CharField(choices=[('general', 'General information'), ('citation', 'Citation'), ('license', 'License'), ('terms_of_service', 'Terms of service'), ('wordmodels', 'Word models')], default='general', help_text='the type of documentation', max_length=16),
+        ),
+        migrations.AlterField(
+            model_name='field',
+            name='name',
+            field=models.SlugField(help_text='internal name for the field', max_length=126, validators=[addcorpus.validation.creation.validate_name_is_not_a_route_parameter, addcorpus.validation.creation.validate_name_has_no_ner_suffix]),
+        ),
+    ]