From ff22e769349bcb0aecc51aa93d7002122d8323ab Mon Sep 17 00:00:00 2001 From: Dean Poulos Date: Fri, 11 Oct 2024 23:03:08 +1100 Subject: [PATCH] Start README.g --- README.md | 1 + qualang_tools/wirer/.img/overview_octave.png | Bin 0 -> 51776 bytes qualang_tools/wirer/.img/overview_opx1000.png | Bin 0 -> 88953 bytes .../wirer/.img/overview_opx_plus.png | Bin 0 -> 44519 bytes qualang_tools/wirer/README.md | 93 ++++++++++++++++++ 5 files changed, 94 insertions(+) create mode 100644 qualang_tools/wirer/.img/overview_octave.png create mode 100644 qualang_tools/wirer/.img/overview_opx1000.png create mode 100644 qualang_tools/wirer/.img/overview_opx_plus.png create mode 100644 qualang_tools/wirer/README.md diff --git a/README.md b/README.md index 456d5696..17051636 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,7 @@ storing them in the usual configuration file. It allows defining waveforms in a * [Digital filters](qualang_tools/digital_filters/README.md) - Library of functions allowing the derivation of the digital filter taps to correct distortions. * [Voltage Gates](qualang_tools/voltage_gates/README.md) - The `VoltageGateSequence` class facilitates the creation and management of complex pulse sequences for quantum operations, allowing for dynamic voltage control, ramping, and bias compensation across multiple gate elements. +* [Wirer](qualang_tools/wirer/README.md) - The `wirer` tool allows for automatic allocation of arbitrary channels to an arbitrary combination of instruments. ## Installation diff --git a/qualang_tools/wirer/.img/overview_octave.png b/qualang_tools/wirer/.img/overview_octave.png new file mode 100644 index 0000000000000000000000000000000000000000..1067e2a7566495afc71b123d737497c378a54659 GIT binary patch literal 51776 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%0AE|;lWT+mo;6#FRYg$vUl^K$^@u^g+2 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 literal 0 HcmV?d00001 diff --git a/qualang_tools/wirer/.img/overview_opx1000.png b/qualang_tools/wirer/.img/overview_opx1000.png new file mode 100644 index 0000000000000000000000000000000000000000..33ab81802bb570b083487c757021509409a3b2f5 GIT binary patch literal 88953 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

P9oe+ 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 D["allocate_wiring()"] + C(Connectivity) --> D["allocate_wiring()"] + subgraph Wirer + D["allocate_wiring()"] + end +``` +Resulting in something like this: +![octave example](.img/overview_octave.png "Octave Example") +![opx plus example](.img/overview_opx_plus.png "OPX+ Example") +![opx1000 example](.img/overview_opx1000.png "OPX+ Example") +# Features +The wirer tool supports the following features: + - Assignment of channels to any combination of MW-FEM, LF-FEM, Octave or OPX+. + - Any mapping of N resonator lines to M qubits. + - Any mapping of N FEMs to OPX1000 chassis slots. + - Constrained-scope allocation according to user preferences. + - Natural overflowing during assignment to multiple slots, chassis, modules, octaves, etc. + - Any combination of resonator, flux line, coupler line for each qubit. + - Total visualization of the final connectivity. + +# Usage +## Instruments +Start with an empty instruments container: +```python +from qualang_tools.wirer import Instruments + +instruments = Instruments() +``` +Using the "builder" pattern, you are able to define and add instruments to the container, line-by-line. + +### Common Scenarios +Below are examples of some instrument setups: +```python +# Single OPX+ +instruments.add_opx_plus(con=1) +``` +```python +# Single OPX+ and Octave +instruments.add_opx_plus(controllers=1) +instruments.add_octave(indices=1) +``` +```python +# Multiple OPXs and Octaves +instruments.add_opx_plus(controllers=[1, 2]) +instruments.add_octave(indices=[1, 2]) +``` +```python +# Single LF-FEM and Octave +instruments.add_lf_fem(controller=1, slots=[1]) +instruments.add_octave(indices=1) +``` +```python +# Single LF-FEM and MW-FEM +instruments.add_lf_fem(controller=1, slots=[1]) +instruments.add_mw_fem(controller=1, slots=[2]) +``` +```python +# Multiple LF-FEMs and MW-FEMs +instruments.add_lf_fem(controller=1, slots=[1,2,3,4,5]) +instruments.add_mw_fem(controller=1, slots=[6,7,8]) +``` + +### Disjoint Setups +The instruments container allows you to construct a "disjoint" setup, that is one where the indices are not logically ordered or belong only partially to a full cluster: +```python +# Disjoint OPX+ and Octave addressing +instruments.add_opx_plus(controllers=[2, 5]) +instruments.add_octave(indices=[1, 3, 8]) +``` +```python +# Disjoint OPX+ and Octave addressing +instruments.add_opx_plus(controllers=[2, 5]) +instruments.add_octave(indices=[1, 3, 8]) +``` + +## Connectivity

Z96!<{sVh~6a>n{T~eEupgs((S%6dihC3n~P7>+qlHmG=TyF5rqXn7LsW=>)^JVmcpzoke{i~SWyZ+v_-{jr%0tW#SeVjzj7x(-Udq)PYgFZ1@M z_dtIE<2OmW3vPRSd^`kqfaHQPmaQEM(mXJ1fC=#L#Ke2>(E}>`%Qd})Y?xL`*nYo- ze15S?C1v8u(B-uAN%l(fy}^>aq{!sU7%2${J5A|$; zlU~irZ8g&Sk5c|LYJ_NMB|@nDf^A}U7AJbC@n|j!BpVRF0@MxK?AV$$kYguWc&xUC z?Uj_3(TuOsC}x(ZD4nm6A7{d7!puckEj#{QqimMj-Ckg(| z=fGY+39=|5msx@Z&habg*G9yM_9;^onZ$TkD6K`_EG~xXXnx=|>XPE4gj~M!@e#>Y zIzl(MQ*!;_o!0=#YHPy>o@`yxX6rIsi;SWd*kQl~4=M6eVfD7|aI}$pf~1L-e$L?F zfaFY)M?xmUe+aj+uMb_M#hzSxYQEF{lCr*0b8~ZB+M2+sqjxz9&0+x!2Bxx4f{A|N zt=T<%^pR!Sk_zxxpxhl&C$!w`6>{1kAn<8SJa=^D3_}?hZq&bp!aW$NMT}kfSWxbX zSjD2o5&d6H>^7c56v6a0$g!jQG5~B5uAC;PpsR%rh&>?D7c1sO?$b7x=<4eFVb&q7 zWq7n1S@UK=!x%~h>QmUKKtl%IknnkK-$n=*8n5oeidMXOz507)2V_Wn3wnS=OJrQe zhITe~1H*S2+1RcCycvj3D~YOl^bk$Qaf-x%NCxnI723o=&w%{1wNiM*M60G!Gua2c z5AIc|5~7--Ao{?p?1)ql-Hd#q@Iu{7>18VC+!ry3*ukV#tOy!E4l)WZ!oU}#Z#1cIUcsgy+g(J;ZfTsQm(~E|bKSJXD!jE<|sW3d-|F*>;&$Z2% ztrD<|oa^>C*Ze<7?M=T`82Bkc+g|u1zo4nwp(tt1T14Jt*b8X&`hXw;rQ`gDesln= zy)ugBD;9<^%-;%NZYz1Gf;K96`L6j%tpkj|kiDAqA9)K0VZ?XQciU-&ug+O^p53Tfsau{~1ySvHTPWUc942f&{!mz8~@ue?{CuMhfC?VdF z?!CBn@sC}WX;M=Cv3#Rk^`^ZGUTJ1_I%Q$c|1Qo4&+ncP`aYMx-i*1LEB1?$w~^Rv zgjfa-M-1enK5bqT*Do8zi^3l$U!xo@kvG_J09lydCNPgUuw$qFs-)4CxZzFb7j z{}*6Nlmf<-re(_lFcj?eEokZJ@{9+0XvG{!k)9H82SL6buC0_C?SZU}6i#I*csA z>>45$pHj&EivX38B*`7)M|j%Krs78~TI<7R71v?l`RA=ZVmmq6vK$yvOLqGqv7#YV z7F5_k#3IfGM#?UYUETfKXx5=qF>U*QoFfPS7Mq(}%k(7NmfrsPryC_IKn|DpOCZQC zdDu`+X2~57)@vGck8cHHU>Qr!(>~13(+1kt(@4(c|N9yS?v%qZ5Mj(CEkJHB@GBv@ z$+TVM2#5=X1LKiB8c_IgZ|#(UNGho**yOcQ$hD#|tfG&1Kp;c~i`f~o4QQE{Q*Ndd z3!fNz9qfz%L89L_ir1FtoY?tjv>*zG>p0wmjr`}L2W!>@^pw5&O}5rQ8>ES4@4xt_ zliOT)H2GXjpQ0;y@=JA^$1-;eIt zv?3)nnSZuZ*zib5LS)A0IoW{s5Xm^E0_IQ<*#8LSumKv#I4uo8_-Fqw(U*jbtPegR zC{4HTUn=sRr`BLY%nMujR)H`%bx4B7IJ6^Bxn63 z4H4xdye27jdcPFlKrT<2nb`hNXs{nybpXHxuonJLp`F$YDQQujZQFd8s;E6~Mo8|% z?e*<}t*WZ?C>$T$81olcdIe&SZ>Z{|3=CNzo0=fx&NLKMRD2%NJ79y50WKXNJuSe=K5euhJ{ovgoz@C?^D@c%BEROUUq`TQ16XB;su@iXJ$N;-9u!>}dw zQb>crc=4<;*E)R5Cc;lGM{(a!97J2_Eq41-hc6reu=1z6ZUlJMdfVAAiaPCuGrOZ+ z)$WybrC2Gv)g{3v+zF8UN9h zo1a@q06z&HISbI=17J%FqB}n74jYQ!&?W%|y@2}2bfe{voLpTpJwAyA0DL*euU_@9s3uF z(c-0!kV>D$>bLfb$!0$+n#2blbXA9^+#VWH{ZJ+7deDV$f3SR7W6|7Uf0A(ffByFM zoLn=3rCRq}cANfEFk@-L!SW|`8T#RYZw?MIPb1j#_8dD%&$dq&1hbr$3z+4B=#MBG z78b8yIx_?nr=@vWz?BK6kL06Acu*TTy)avtkp)QHME9Ck?lOP&U2|Cd;m8C9mC}{l z_J}o=kEjRoJvdC5>bz|BPPVoUNa1 zD#T?Mz#Nr}{a6nGe$Q#COYZva9K%Zw_&SIB_~<4gihqN~`ssq(w6&)u8xm5n;BdJ* zPViY%ZAnicOMgP;e!KFb$^JnCW=9HUZF3SBkuJjdv<|`nY>|LjBR}%3uWi6E00Gx=o2(YB5HPraQW!_?sZ4sGkB<-f z;lPo|R>@23I@o6JH{6e+y-URt{d&6)*N4cf=noAd(F;RElNv-D$VwXV8NII0beVe6 zPpd){L*RIx@mx}SY241kMHy7m3oJaTTvuYazV^MncInE8=RGluOen=9cUDCxgxa*!$0Ex{8Tg5NdtV@ZGHYsP89er% zz?Oj!V1cUB3-Xh*Nrdz!wef@v3$C)(t+}r*OzqOc&n&Sn&Y`woj+HLq1c$!2w>Ko+ z0X}NB8&EZSwc{0Xx=BDN7!)Tolopb93~8?t+EB%pk+)->y!GB zAU=@PZERaeD}24g^6Wd*28cRJ-V(^KYK|`ObTdk2_VLRba2C90Z5}fA`hb#=92#H` zZB4|?Q?D{1zET1BFSXttZjJSlkvTL=3-ynV>r`xZ$Eze)H5W6_{@Rvq-=6(DzpvB zPA^=G;CB~PWPo+aI}4iN2-`59VepqXmKfgi-u=Z0DO->;3fKu@QXs(qT6)k@gC)w# z(^ER&;yl1mfJn%88}T=qH9jhnhwfLLhFbOC62sWVF;Xtld53#2x4EE=qIUpAf%)9B zK71dC_)=|%1jEk{ngttqi%DYqm2)1iMq3M*7|)%n=Pb#%AEw%K!3nwh@%@kvsRtVD z+x_jKzcqW%hL0mjyG&bf5;>QfL04r(3Q&~;ux2ad4#KKyHc;@{d1$Jg1B^W$xgt^w zfSM8&?y-Fa1S<^AL^ulJNRLxdf4_xX9fGlg&D5j9Gc+;=%3r1JK~ZQ=T%0e0Bv+eX zKPULG(^S%48HO$vMX4+%vzg}*!;$2jN-iP2@$4fJ=Eyb#X%~Cft`jP1(KPc&I8%g# zGXcOp8xRqe*44KfJv`V-sharR-;tJ`;Sm%k_MjumyP->rxJ0V^LZ|=&t~+TVJp1Z$4ZqX`^}v*;v$jg#f{u!>v}e6&!J)I~(o=TIC2fEMO&0N?3pI># zAVqjW6RtpN{!7o(Nl^+}Ds?qInNNfHkK=EuZMBcTGC>El=07h#{%x6cI4wQ0)2vf! zaC%SwybK?ug1S0L#X~rU&7L8QeJG^3H{SL);2BgdqF=NY0i7F&9}Cq-XJu?6z9wrb zQDi1sa=VE8+?^ZqV~G^Is6nF-eQkV4a zDv>9ZIEJT?<21)>ahW9m*|Oy)ZWIw{;LJ z*-M|`MSgy0G~G^{GLQVv^IV(4N+j*pi!r}qog{B*XV(O*2;>Y3JRc;N0#opwzD2T1 z=EQ&>&Ld#nX_p#ZTlui!%VH?k5W;YT+xCDM7q#c@Q!~`Rvr&m9$s`G0p6nH)@-ji z#f3)9P_`+m)4Z)%SC=x=A_ZW)r>CW)(ndrL9J}KlAyxa7S1IJNQC`?y)%}hA#T7Ci z|LUzY*y=;t&Hf~AZoM{{>mFxVQCSXf@iGcC5v46bG&i==YP^4aou6Ady^-A`?Ab3j z7xt{Ov9VlD1n*f|1>AYvC~a;{fsw@R39UM4QEzxuZxV z2%L85%xolDn&fL*TxkFN;X$EhWG&;pRNM03V|{nN z;{ef<_{M*N)@np=`4(v1up9Y4NR~7-WM*Sy3v76bq=eNumPX~OJa+zn)s_J>Xo({( zSLf65wA^fO&j5UKiNhk5UEbZwnJA}mOVm9rIYJfoDBpn?W;=W5bXgn?79-74>z3&# z4nL4K#Ky*g*HG?Y5)#KyCz%=tNkSr2@XPATndxS}K$DxyFm!-PyyNk$J^O=Kt3ws6 zten;PMiGT-C-Zg*lT*184@_J*V(H@6r#D!JgC;T)Dy2^Uo=}RXO&Ja$yh3<3Yq^mp z-f6Ci@Td2*T;eQBWZ68EE3W^?fsBvuG%acokO$h#$C}Ib^ZSQ+Yb#`rM1EY_9Xn-1WH=20hUZZSyZF`5B+QyV-M2!aGAjo^ z#4r>37TL9RX_jc>2o{aSpxyW+etyI|Ai|g(DN!*>o+nVa#~h}$8;7*vF?cDPi2>|r z$~=rvNVr3iqCXNzBp*;iA~~nVZrlZ_uA}ZjwSwcE4)Ovf;2Q5jfNu(r~-O>dm%ZANln%adwOa=`aewHsq6kY z=vgIyxZNS|eEFeoQI!T$@;~Lyb>7=oX?~fx|0!H{Zf)tRDO#*-=t?*-ex8MP)$)|! zI^j(^e0UyJE>@na{*Y5YXS-js;Q7y!QY*_#p~btDuIiftFlE8g?1dZA(eyCkq*qT2 zeEj1Z7!vXYUk%gv0Ylml30sO^%R*ko+)ov>lmhg9t9UufcAr_T_hke@2UbMnxvfh7 z&PGDTe{2YwWNkflT)z)f#mK)*`~4Z6w@!bh(NKg3-o>BpGFX1~)hz-*w>pRd@5Jrf z1r4?wSy@?*uPbb?$07%zo6x@RAGK_Z03lST-#bSHdSk@nG*)X^zet%5&G5))P`s{;Y^s*)P9-@i}rT)a|HedidSV=h56dWA%W- zv46UbDE^?G69i#ev@bF9te8NUs;r#1e1Ot!%4ym-r;e6F1=Z<#`+7~42qu6~>ZqfM zlE($lN0vda96jA&r&F)9a*PjSU(TPuij@JYa(UdA>+_>%GJ$k%#2 z*=`zrgmuEGO^f(n~;?Ne$~;|in8>1J{G)l^lAbOx6R6COP>{&NYDxk0^t`9L1ShMWr)V)1Vl#ue*F}epTcEv(L5sL7+FiAG zx`k*UEi9tfOO|4#rdA>6I`MG4KC$lYz`-Fd_$J>725)RU5#87uEJBTGS2GwI7@>s4i^1~>KP`;><&6eQc21W@?VMlORGzM5q9ew5=e@P1xtJSynvjFm!1%c5&`C<(6M1y+?M248EqOS1+FWn0xB)$&js8}wZ^o?(kDJ-bV-?JfJhMI$dJs|-R3&yw?(#h6erBKLu}xTs z>Brz}!@jg3p^M9<^R=Ey8{oK-*X$Y#Y9}gdqlDeMDDA;9%877y)yC#y^wu7d( z74+_VXS3*_F{2mBSbYH}F-dI$B$kD3mncD8la}!W7~FpcJ`#26Sm+l-#aN5$ zYl^z~hWtIQ5^t+`Ch^cho@hKv4M%8aePF+jEvMK}1goaTfc7{vM90;yW{O3?KF38v zuwatGZK@puP&UPQ_#}r80tVriCwZa$3R zI&d93ziDsY?I}w)zBa~F)L!bXI_Bi9J?hw<>clWd&o~-Zb~hwXJ^K?samSaEoCz!& zJv{>b2gH+k;}z|YHDk*7fXyBY0%~)NFx?9xHR^%Y;&b){u6E2{M2G|Yp2l) zA#t3OjAY`xs+2&vS?eou&M40g!&IX#196>__ZK$l+I+J2Uh#)9YfEYx_v~g|fv4n! z<}cCV6*Qq;;A}Uf@+}=6xQBPGJahz$Nro372bR$85}@`iKr{Id0N#7D>T-xIl)(M_YSnc%8c z-v0D-p3ggp^$j0&5xP7koIfu3kN=;5_}!zcU12)mUH=vzZ2sd7v8>yoK{Y+h&~Z5= zQ<{7BdLU3&bgllpEG7T@CI;v7Zfd$r0 z2`&R?1>^PWA*wp3QOQj_k5;(Ds(<8R`vlEY;>KHv+Z|;2+OKe#onLE=NyuNVR@8Rc z=SH0zwR=X%8pb=UaLlb=Wg&Q&+4nmeE$WH0{q6^SK*N)k!6!u>>bADxcWqau28~?3 ztEw0(oNQ*|%S>e?v0jkgH|gJ}cd!@t^Xm?zcEZK|6TCiDb<&kb8gVXwy#4jyhH|HV zWUg9A?XXeN`d#E1%Q(GLulmj+A#uuMWXV7t;0=b{qGb&A6g1wx=C$@H^bM! zG$vbB`NfBKMf&CKvkNN^lDmH{L`>n|@}IOV(iXglZhUkdh;kIiqMRbZMG0=h`^P@Z zG^n-R&8mNM9C_?Be3&YUF&m*_;J@vQMFdd!N9H znU|%rnX!4urDA%H5qR)@M|C%K+&VHM{fNG%ad4duryd6 zk2DHC?`q*_Fti%a65f^Ljvp7ic`MI#JbYHpwR+!0X?AR{O7s+?bD5U*gO<(F(JW2s z`rg&k5MCooR#w*U-@XN+jrhvV{7K+Wjwpp476t|qWo6hvaS>*O>2NN8<8Tv>6y8M8 zG!em%K_iJ5J0 z@@oscKk+~7_`>bq&c0jBe_E!6yMN+)ojpn-xm%y7z<*Q(-RYv_-?9f}9c+f0y z8qKiaePv}SY0oGzt1E3PS(C?PnZ+}+jk|J}kqJG=LmgybsO=~rZucoVdcOZyUEcs% zdE*~4-}8E-{~$T^Oa62A@9L_Ne{Rg|J9v5fI*nu(3B(X8D{G9p_Y21TVm8%Wl@EMy zeMWgEs+}46J?|86FW<-gqWtKFn`98=mHZ5T%gbPZjPH4d5N%7|?W`p|rjfl}btx$V z)nMxO)zh_S@6d9zcU^so#!d*fM@C`Xk%grbW%l`u=IHVC=?Z92i;a69ejh1$L%vBN z_P)>2^-jf`3C)OXwT9G$Z2buj;pLMPFSzU7>u@cQC4~1aE)8dHX>EnDq1NQEu(26g ztVBa(-SN5`0ZV{l6}A0&zl*`9!+LBauZ-jAyYNxNj& zm;_WeDwy8xg#ufiIfLXTP5zyX1P-m4O9C-LJr1dU0g+h_miR{ zw3~+dPLs0U;M;M&b0)^m>}#y~DXTYnv^!L0CiYZb9;;cLEV_E$@B3UY#WSMlu z8IQ|KcdI5^V#9i)-rYdc#}{%86I;!&?w+7rPHT8ysPvV(^k2EE|FU9(e{NSN$95@3 zuV~m|!w+|VYIQXwFHOsIJiIrKAt{5p-H`XMnvTe=TRwvY)Z_o34`MP{`&m_ce!-IS zEoh7(XH)7@)lWi2gN)M9yD%DY&p&_8+SQdT%7y7m(R|)Nw(1uYa9vdNXalz_5v26) zU}B7N*%zocWkdDFZ0kJLujY*}geQxWqGl*K3hkS=vY6>cLQ>T!ZmI^$8> z`s9My<|vbjwbc$<;};D72Q#y? zmQYs;S;71_tM4PT8W+sU@6Y3WbYkt`SUsnx{5ctFtFK;>0K(G7MmYO9H2N4cwiO7K z(=8fKhki?j1ptb~EPd~bgIyIUlhq+q5~VX*j2RjEHsdPi&Y!=D9{X5`b$;OZ_+n8x zzKpW6_=z!vq-1<_;UF)|y8eNxyZ&QrW#zm~ALeHsLd+5b?j8-6u60{n5^mn*S=sF6 zS^^Rjuo{)e73d6C4F7jg&^I^gDZJPrZnJ=kvMb=>?aKGS?FEL=M8 zbgM|bReqs-lZz_^Iv~n2hZSHcD{mV$4K3S3O$q57^{xvb)5 zR~NN=gPw)F$H21V3pm;+N-L8sWe}AuNFPr>l#V7vcF#El2_mgh>-6F6gyAByIj~{N zMlnt)*c}$ZdTYjfl~L;F)ohiv@RqQ2VU1cpIt?wYU?md=s)vH6U(Kpq!OUM$8Y=*I zzNM`VdS*t!Co!^msj516lwl^jxUc|B)Q$$nQaysX*sWk z-BflRLP$U>W=53ETcsz$h>aFxmOD`U)D`DT?i^y@{+U_b!B6 zIXU;PZch~7m8qE(3Kk)7bjs9L`fqjV&XxQA&Y9h0SdeGBE8^_zLMiqj ze^zdx;MdBq*w$jqy)ODZ`0=~K^|1{ON&@jfda=fo!k-j#pS}F0j>B<1bj|KAFnSi*uV1L{0L=)Y_7oUlkwzl*fr!}-##N^e0hJVpjt<55xyUX! zaAryu4ht7AShZSN7QbsH1)X2pySHXgPsvsp{u`OZXQrh4jK`pvWKwTx&+;&mG=jV| zi>Pe0bEvm)`tvk5OyJM7RTw>o<#7nLIc;Ck*_J^fe!P92*IRaHBa6S@=_)gZ_Qm>Lz*Y2Kbt$dQ} zUKXIiRdth`$YUruSV*sLD%)9c-}%aV3F^!+iZ0X8JcUjtpeKdE99($~wAJKqj+~$EDF4`ZMl3x6P5pa{ODPHnyc1Upny#6J~+e%!GLzTR6{)M|5#2 zMYaE9=-_%x(y+1Zn2Q_!A#tqk!i&{*b+P-3v^wrnl_3YYn;{pG)l#z=h7F65P*kM0 zqhBDzKe;uA1?wwitNCuHuHWT9Tci~Q6MB)|LxR<_o|bN{4n_m+r5 zQl0j&rbgRImw3|Jzsot52k%O47W;K`M->771-vf+6i)#%1`>-PYXVc^Tx4!87f9;h z|H4Ok{OHkIYi0;&0eFo%Zrot^dM4=B8ePsyw=?uz^PBlBSgAXRtC60~U$ls(mu>r-F5%Ydr*uI(h93p4cQ`DO@=`Z=B*Dt;`b6;s zpFdg9b6<}I=XfND#nv3iZCGo)o%;iXIzR*)-sUH!7j0I0Cf4A0m8JZbPS{zjK{SZ1 z^?~RcX0Zf@v#{kf9xyY%PPackkc;ul(+Cl8p|djKkT6wyIyPbbsmxjzc*5A&*gxmd z#Q{-Klpx}Thxvw2E~ZDB^a9igVUvWzzJZaEe!<{S$)Diuo~+liMm#`_DXq7C+k@fm ziykO<<9)~*{O4u~{#E8D{hYlo^9A&MuA`yv=HInY+SzfDh!dBq!&^2PnR3osgPc3g zZXTRkpQ7*RCSeShYg-`xYKq(ITCOgQp^MSYWXVk~lWhFjq98ZF@_ z4h@COdNAoZIkV8BPp>Op%zFNh_eCC}ibqD2NN{rZ6Y_|ol2~DR4XLk}5il959}AIS zzEa$hwJU1Ww%P4!HFFVJ?` ze5s@)t)M^xdgNuLZ}`W2=-WlvH<+1xB*k#LuP5S)n6wqBXsWc=gyHUUPd(&=@O}A; zh(^DF*;qZ8Ii)e2ih&Hnk%^vVNthy0v~Y>hVCgYl*={VV;m|ENx58+^o$?Nlo39TM#rJtnxn5ItU{TlX;;=T8T6MG``NX$m-W5`@Yep@FxqektEHd z<0C3Q`;P|M7e$o%4Ld~>3U?z+Cc?UusKhcTT%4N1!YTc#s=97==@tyOaIsFwKDbc?hKbeb?1kbft>O(Jjs05j!f&-_qu0?9wMVZ(M|W?{~BDN?3ojevRi38iSP`5@u9j+h_nI1KshEJ62rM|9Q{6 zN$)2D`O12+KL|wOu#nV;9PU~&Z{I~7LFU2VuYv0ZX|}v?QunI@^}PP*H1_6H@NLHQ zUAkwiNvo>k!Vf_kB-~0jOle#1QE5L|rOrt~y!3{YP$lNG$WuCK1wa}}re7$WPtNiZ9oiXNm^~ble=_We^76$E zjU|07W6y|FK@_Co*LoiL#iuJYY`0`)e$HUE^1AGoQZKrgaps#TxG5=Q1k|p# z-5fWrJ%8?a$6+B3{xrDyUK8$R;S%pH2BCnux0!wc{I>s`kW8VM)0-bU!=<0M7cu7{ zlP?dlT_`xg>Ih;X$X0y$LJjx{Kuy)?<)Ow#bNOW&k@L2L!8sW`L0~pE0_BN{*N_0_ z7k~{FU%Zfk7Q{xIR(XTQ1IxDHO#rEpz6|#9gW&o%e0qG;cSo7uZKGQj)bk7|g>r@z zN&hdl-a0O-wR;=KW21maQqn*H0Ric@01;`1l9HC8yGKDqT0j9w0TE^BkOmQ9KuSP{ z?iji|-?cgC`##V2_j~`~^YM(wVc&b-d);eY>$>iP5M3LUO`H_=ktQgEBq%4X_g z^kg19I5FVv5|JT`kIBr<0CyhyohB_ae1Qn3dqu+1(i!QXsW!GeXTm^e$93U^4qR8* z`}o#=I>x`~ea&C3x>!d)cA7glxKPv_iywA-O*-Aklu#VyRwUVyuo!8-S)s^d-DE(; z86Di5)t+y5J2AWeyU%w1G0o*_iyQLg_ijkSUOaP5CtaU?7$kHd-twq6i`m^mTj?O0 zHnyF@*Z(PgM@%WCu5fS!fp?|*`pm?PeZRU_O*hr-FAKgH1-rs_MOcA!9^O5?Fwn$| zkZ(kgh^#tvfz32EfMwt8ce-}yHcS4|n~O{d_1+^=Oum)TUk5WVF5S9WU$d%pXmvBC zZtyP3iDcI~n@H*;1zdAu-UK#|{Bom4#w1x)RaM1M@==@(T0_fUJF20?IG^Mwow=fu zktz6R6;HDBU{)6Y;7MaMJGiF$u^JVxn#ua-5)M9z9Au~4AKu4IPUW7j1P=(gES^kO z;!V!V7rxJMC71^J6Q@rn>-DCBIQ z{aH)P^I?XSLu5AYM8mHZ(akSD>FHuija6?;MdNL%+~VK9{V11^T~OfT$GA8HKXTN`6Hf@djnMa8QQ?|*-*fb;VslIInV&vK)WUKH(|5m&ZU;5wl zSWbd!f`WoVNmK1-Pk4U!{5R=PvNPvlZ(cOv1J7(~7(yVLqurIK$pIDofOXaQ`?e_6 zAxFH;XqT2wbYXHbSU*0x)#G{k#EAFiitkHI8rA$Z^FsgNJ%cD&j@`iQ%U37$H#|2v++voE z{8s9)Ro7VS6So5shWnfrg_-mVY;Vae9A1NNvghhLrgu3WNeO?D!(l?1INL?b#FJogV3)7adx7uRbH~&?t8joy9CT?x6Q&agT3MrbAIho zM_GemBCU=m$c`qJob56+oWf_)!Q=vFHa6%to`Hl4sujR-0C@oQn6as8cv#q7ZSCF? zZ_d{T`*8p1t6gJ{c5nae znb6Ch6(zsh(OI|o8yU~@5;wKJLzNwGk*f(s zUA0BwH#?_=R48NT`@TiQMg>-7OWt=Uy^{Kb`0hcJo;I!(7n<{t+x^DI33@Hj_Z|Vh zEM$-HF<(_ptab(L9ahf}uNcjYQ`7}5+}AY!em#+zW=c*??acktE+@a6=0`*(G(^t( zZEy71^prT9_C4jM_}>uJ;0bWd* zl;FBn-)@cG51*Q7yNUCqwJ!Iu&)o3t%xfQI?vXuWf7F99l!VhhPQ)#sK^0=vw3=35 zSyc4Yg@qEM+rFoq?_#ZbhBdIA+^$O0r^sgR-MxD$wur%Wc0)}eUZmET>!89kzXu_l zPAQomJl90=e}VG6l?&{qkHD~{krnFRJT>IrxJC!=z(DGS5&|PE`sKG*V@jFov*k4D zA3q{9<@23p)w37>3vQY+05sNfcfKf&lQXsN3y&k6cvdYr6Uo^(Z$1tEnf|%XRG*Yx zH4eG8>3IF$dTx{<&88`zKE153e@Gz(;y3O~7UTT0ZxV_oFc8*FULwsKrUcYH=hGYIHr-30%EC)Ope;Fsq)POBio zSLvX)cINk6*Ef!$9UUaf$;VBMjdPsmwfAbS(G)J-@<}o3n=iaKHhRekXQ*I3^dsxf zBB-#(XTGZTtsS>@QBqcZA)RtXOpLy4Af(!$*m(78`b~go^LrixcLs(qF=$%hzP4&> z8qgH!IGs~|syx4;&GR=;zrebHGefTw%#(g~^3~%C?L7R4yp3i-wEykbOMQp&_YLpu zTKV)8%29+Ky5G{z>}lKy{tEu4+)gu{dSM85$Kx@{Of=_ACqQRj=&nSelo=IwLK&sh zmYgm!=e#Q=$L6`c%|5SNik#>DaVh${uYuR@z1uew9v$6no!wc8)?mc!*;Ve$u!Ea| zB4k>s5PF^+Wn>}cXj;89g3jO=S*e%*`c2kAiQ&k=yvVk)BDSLqJxcLf2g7^m(k0LJ z^)9`VI&+|X!%|y7mp?NDA^uA`u~3YB*}#IOK(i??B_$=K+GWKn8;AoX-m~KM_|&*_ z;@+3Eju{$JTMk}a6Z5rezS-B&@hoUG{&%+GUsd}d`?cXV;mv_R@Ns(vxq-#>xuKP+ur|vdeeQw3uFebI`y;Ed808U*XC@;r`2-za(SKeM!b?|F{na^}Aa zG{i*Z_RU-N7KHu2fLW+C%4@tKIg`2ug;2)dp5N??x=cxkq>^$`sU{bXFiC3rHFPY{ z&?f*AbKX9nV`F1$iWiM)mDp`U?-sU*93iWh5m+*$y}iA@we^}wou%U`Uu@&C%Whkg zFY8!x>^g36Pz7QepYei$1v4`<_z59njX^2{N^7(N(A`^6D*4-F4wfP!p|^u@^NaloW0f?vP8l>aq73#6N!of8FTfeQOC?1jUfmXwr) z97a2nDp=ZA9V?aAF#;?CK+#V5zJL$|RD2y>_t-D3y~7E<{(^O7rSvSp(lvj=RN?!= zGu)K%Dyl9#cAgk_$51;bVFhS-yjo>ZnwQdolNadwe8lDyt0i1?0m*txCNe2JDatcS z6rv*WgA*FAM~QeL{l4~1NT)u*oS>{*IPks6u^qXWZbCo9e^jwh9CdwqD$K}Uf4}1% zk~lu2;(g0r`Bfi>*Sf0zeP}Pz33+biAU!K70u;F~`}(N{FM`-MPRuF1TKsfbbGwEl|HoaTHIWMAX1YA*6$;ot#Ydl7Tk3nB z7YS{l{hm^_Evj3pc!h7}(Zy1QF^$7rG1Jx5DA3cl3|uh;{DNON1=&hVkax{9!-RV0 zzDfshi`W9?!2fQv!L*<=0n+#Pp1(j^VF^bmlvfMh=GbopDo z#jOj1LPEuvavtC_97~TzGX}A$bCN=i2~7sg9WeD z-eMjvXqy~nm=Gwq(JlKAVEpUaRv%oYO&iOEc7Zm@{*Lo??%&HpWGE+&54L*`OnnJG zWs7I7gpJ86N*)7&^GRI~1%v@Y|5#L7tzR=e-69T07^k{O>vpolO=|w|#w$4H+Mdoi zi~5l*`W?r!3fFoii{pQ6}WDZVjQIs^# zm^rQ>j@u=r?@X~n53&wsK18-pJ3b$~$*35Sn5YPXhvTIrw#fhc_r<$9#&O0ZtxL!EEYn<=%+D#|M|)u|N2j;@!bC8bMR;bJR^w>xV1X<~}qL*ad|`_5XoR ze2O)V{K^&KdERpj0);;aGA@ZaXF!`b16=c=^)R`yuYLc&IT4_#f$`aZXTr9LczOMX zvgWv(#$UTzTOZRcu-Vbd6el4c4x7!UqM}Ofm;s|idnY#ei#9=NUzGADziNRk9`kkS zQs5>`_gs5zD0om286V#o62I%Z@j-uNaZzSbPq&1SMW?JpM45vWeV@`D;Q@I5@CvkH zz9Ev_wkp1|>xmd0HPnb|v%HO*Gp*NqR6q}uELK~nJ~{Xl`zrCD1ikBlwT4!X zWEY;dw-YnEkK6Qnw62S7cDd9yiD9z-gB-bHYHxxyvdF3XvyqlZxhSs8vr7E|(2P!N zblR`Gq!**Bpu_mXqaJ!}%}A{OEFViF;%M$m*Z85?^yaU|vmw?yCm!1A-NI;chdxnt zUzX&}9vRa(Xc*B+G5TTOs_(PL?)gz9_t2oEDNFapQIfpVu?RT=oSi*#(qBb%^plFjQj zXiONJmg(sE=0UgF@2*((r(&nCv#G>`v?hz8Zrm+m+j8El1?RKp3;td2Gu#aDkUPje zHuwCCS+wjq)~sLA_NVJ>U7ke3!HR&cd&>!W7j9@JS>9iSn-*T$I$V*86|xky6^I;eN0b(T{N^G zo|pFsNCceoLalq-oLL{-O;QMD|HZU)xfN5pC#7hR-y8oy7vL_0Q`OOm2Z$$*)IAD0 z#mw2|XS;rZ7n9>%Cr)xIDruNc*tdZWUOvi5U9TbMg1;Kd1k5L1zI@5;xwUjE^eYy7 z{5uPGP6J^dS3`EeI%sl0e0MvM`mlC~EK-yyUn{eGr#pqiZARG9z2}SQjtnWoNSzOB{RA(kuR|!T6r?J9WVz=Q4(}0R<~7D>@Y3y}3dA zx&C)4NzB>@8J^d4JqOdy37AngiGvvOsnTZN(19s7HERsqQuhUqSAt^Uq<^>WWMM|bht ztEy`PH^TQaY%~uBdCRvq2-M<(r6d)8Ip!lAr$}a`7WEoDS9-QdDxz*ZX-26^U!-5wudMkj5+ zn(#{hz~|+Hc=39ezTmVlZG6jEmKaZLGt_&8Aul;CXeFRhfejIS6J0TBET1NxSXll; ztWt7IysBhTaBF*~jq@wrs%hfk$L&nAp=6uT${-rY=?cjiC%KtA!r^vY^Wi`fi;XA1 z(R-sVRkrw5Ri=!+=dZfBjQ{*rhNkk>A6KWk@`t2wQw2vXLcOjf`*T`a+aNCwtvamD zO>#+;&@Hi9CZT5N=q0I`9q=O159*foZtr_6W>2=fBC(mu>?(8lAB>IIp(x*BmUw4l zp7eQD71xmG{*CL~bYE`{w0up`7df<^&D2`Iji@Pz0CD?{e73Pq1WEl@QOV&3mIaps zkDCGaR8)d2y>B6~(nr&Ew0wDegD&LfMGIZDqs>Q|wmOn&lcUts42t@+3N0ubqqtnG z@!#CnEuhVFOGG{C8C~*wDhh+8wQSSmD_7_C{2JlQ zjK__ahERtSU7P%3Y#TdyUGa4BTnF=pL_s6c?oRWsz?p-_di<+Q;wUac(*DNoV_yOo zXkQl|S(zm*>lkuUmBpK{ZTdUhU;MI4=gz{yUw+;oP;gCxfPeBim#}+3P9na>rHoWX zN2P8~3%SFr2_N`ln_mY|p{#o9V$zAz(`!vd6FdL>ISyq0mwl7Eed;DijgstJAXPP) zMF9+{@m*j~DRvYz{&{s_ZK}=p&6`yw4x53}_kbS2lnFT~0*Oi;T)ew8S|5c1Vqbc?in4NB2ueWTAD;_5$ zC9Q0hmGY_Jr|{Wujp6R|+kOR1tP)R}3Ql&!wPLfrn*NDXE?*`H7B6n>B0smZx+ZRH zz;RmN^vpA5a;NKkMoH+TakFKvfGa8C_24VB_=w9Nw6=pQO&tW+DyLs#ABqSjU8JS` z>Ev)@d2koo(8y(akQr<*+B<6(9Zh z^9{kob@{YTi`1N)oX#SyqQXhz%x?>OF}b%rN|tyb!nehHY&bMw7LfiI&^j2exyVOhtxviDvw>bk$BA6n97 zM1%<}2L~r=PLrB#eIEhCbQL8X+qT=9g-%d=2)4&%pwtD*CG7s+;)G+k*Mm%$(igLn zkFPQ_zg=4+Z|?mq`cGrXVD&X7rBftwxOBHgxW8me@!fk=o=Ht?a6(%8uLnAD1Y@g> zCfTM0;j=`6wWFFp?(zTrBYOci?njF16pB(K+FDuF=*_h_dOk%EtKT!|8?b}Jt9?!)#ysGPDU6vM8@sP$%T2i*tiQjfdbrxoPC=N+Gw;5m z=el()tF$NA%r`VqGA!4wC3|@3%$+N@1xWWxPHldbTHW4ykNGRdX@dHXn)=GDFmH5M z_UYA~_2HziLw(*CV;WNw7y`BOrqO6y3e8;hA>n5S{=>U9`QMn`**L@ z(fHmSTJrlT6T&pI;b&tu6_nIei57sPxhv6QVEgXc=IJW4skK#?tGfIfH{lucBzR9h zd)-RkB41VPZ!d2@htl0fC472ot}tAPM3r25o*10__5T>y;ECqJsix)V)k`ho(jYQfCb=p9L(>4 z2qO~TvVB)vDDwT+A^P9Ox9tGe2c{?Xku^DR)qUE10==oI8E}2ARr7n^H5()(5}N_l z8aZa`333UCEwPK^@MF2QJaXJG-=%pl&|6?LrlhID)Y=!n%{O??cCOZ2eZc$tKw#NfD7ghdCkGoLMyGqitv^U$ZY* z_*AK`xX>jsdxVz-BY0U|a**`x%>|(Dhjzcrg7NlD`uYG60J)nETNSK{?Yu}q@c@W2 z+L`!m8#o%jW@LOyPX2+m<`Gt$ic?z6w-#ghd)NHpbAvRO8Xc;2O{=43p70HpNP5`HVcVixi zHYshzhlWf5lv}rD7pj}lBe5|p40_eQ(QW2GEd*4xH1F6t24NdZGVLWY2&4lF-IzHg&L8Cvd{|Qej_><{1V(mDY%I&?>oJLX&cI$$TmrW>;7?IsDK5 z9fi3k`axjzu5;?=<#x$i6-k>7swW=+$TuUrxS&Kqt4l72Y{dBR6n*S978XBX?jYaA zqL{#Z^X4z~PGJk*5vF=n>*f|03xTy@y>M~j@Yjx*{XONb$7X-{JNlCH60vOTsmx=1 z$64fO-gcpF0BZy=*vE&SDM+vTF*f}XO#TDp3w*wnp7brfZb@Lib&C{$O44|VpFeZ_ zNf;eEyRpRv1i*GDyoQO5A%PPPQq&W8)By);OHa z!%`?|mWH;ma_B(AtsL!R4*qe?0g{lafOcg!~5Mmy)7J5Lcb#+xz0DYJg*w;oo)%~-UO??`bGh~0V z^(8H-&bj$@Ae4Gbb@r0en;k`pOl$6&``r0#5FTKHvvhXX7y!e1*@r!ue}FI6F}<|D zUi%Mz3}CXDp;y1$G)zZ__?hwnCN4cn$q-=oYoSk8)NhDkfzAw*Y5sfhp+o?og7Y*p z=C&4Cy>`~tw=#qUe*gK%O2zkxfp%iFfy}o5L^7)YMQxBYPYP=QuFB@ z1+5$2Q!LDY?G(@7(4Dcfu$ValGZD00I+ssqd092Y|3cYgpQHBzE_3z=_?izmxB7z} zQwUI`LKnOKMd$zF)k}xa+?Cg2OLMjc=uT4giE>MB^H6)4A`?(*b#)a2VXzteiHGL= zlwu9}*!le6JW!{onJ+%n>k3vOaiW%Yuzen>J!QH@`^J(9as;-N`xW|uw>NXYES5~8# z3#qt|MD@05q20nlH1zB2q459`3D0eNV3isD*HuG7BT5TCcq31re!{G$_Hn#=?_eug zo2JO~Z1e#T36x;#O6c3H zsT=f?(cEoT@ZOzDmP;@LKHkd*AuQqpxq@=fo}JWn*K6KwtYqfgr%|>u`kJ0@$Cw!L zpfTSJrlt35&j5(C7G&yPRcbCTup z!)M$>p`!4rG4Zvbbd^bpi4s6XFDr<|6Q4O_Yt7n4yWaTIb!Q&8t|j`!Es|u&#?}pQ zAL!7NXA@{V|JUHV!iI>nxB5zTD`Z7RMP&kL7Dei%wzMHP9sEN1E~KSbg}po(7WW8R z2+xLKB!Km=-4t(TKlD8BJJP=EcAlXa>@Yt6sPsbBBd#u*=t)$bJE+BGP>DjABfz17}@!EE8OPp`kJVQS^kT_xF)GH5zY z7p25PCSGsj)yn2ujoLswLU_J6MIPljAG2xFo=F(JNm zgXre+9BbV|-+r`Gz#F#T*0uL(w|) z;f^FlZAkL>g;bHoF6+_j+ylO#0K<(mpT`52gTng7|~ zspmCDckf<}*scGK__pPC;rt^ml^;x|&Gl6zHxN`QUhM*y&=1%T;c$oD$M<+HHY9Nf z2!D*2(L=k*$D}7u)k`*xP344NMTS^8wQA`?qf|Adl}~ z_F=-IKGPMk2XN>C0mibw7?C`xm^Rf(@@44is}}Y(Y)QNydm{KZIeAUcbO!{%`JEVs zRL*Pz6;!9yMzi@jYSYZ}(zvhJK3}}pT}d|wEuRghq1Kjyco^-)?e*F?GuOcljSrB! zsp;D1di9zwaOmfqMd<|7Rwpzh!P~ugZJHOBZkH?l__GLcV2cRL-MqY2B4DaAojhqa z-FYZN#6blR1#npvCb93i>}u1 z@;6~u57Sp_;uKV@n#UFSC&m;I~xB%N7p%6CM4eD*$6O`WaO-MkerT71o{ z?MDem$zkZbD2=tLToqoX30V+oI=hS z8vOA@ps^%Ec!}|8-uJ%)%%|QpZVgTI5|csBwVBSq=3Rl+=}E1i%FbuE_QG$=H{&|kZBWqL>(ZbXP3SY#!e(SlVEH}VHf$0dz7@2v=WQ%J zX$_B1y<@+LEgoCIX%&CZ<$}@UOv`8On3*3$yuA?IM)Mk^&dd))7yF|nX0IgdHue#f zFT?vKYWq$@-~0S?Ny*jAHzGcm9qxU0xFi1GkSP~+`4c4XDem3&&SW{eZT#uuLUMz^0BD^z+fjzd7>XGwv5^p7RcZO4JyzwiKRuJ_nEJ@W)tKqeRIZzz7EUq7+ zoIkBK03Ud67EG=083qcN8;_&E!+MujSJC)w zHPpnPud0?kd9Pq1W&CW{j)(kzl(0~1>9Ah8^5O}h87X#PJg#^D5(!QKBlpl!tePkH z1n%d>i{yd&4_SYe^hKahwH8?^c^{t#?1}wab@*D}nEE;6-SFEBK=lof@Y)%kot+(Z z={f)_CP=62O!Et;ekJcb32AI>>`M~a41fFfduGw#OjB><{*&&oZ@yDY=E*h5{=|V- zZ;AyN92yWZm*7qR7R`2(Jvpb~txx-3#4S`xdMJg5wr8M_lgIbu!HKb*;RT18=fQ+^ zDYH!2JDR&HhRhAJ(pP^R=lT`XV0?u=?PW%W;qBXj!V$_3>|{>@F+#^qiqH_#Y+|pLK!oN-g_EjS_6I=zlNk>sl6IcU#LTf-F99?adOatd!5MYG8 zdk6h6L>nME-Srq0c46<|gE_z{7$%-nT)d@IbSPf4XzdskN>17ge~10e?BsO* zH8VQAQ0^HA`m2XR{!^ovRiR+%yD)00Q131HSJc;^F&qoOpu7L0h&U23*aGLK*JMmYQAJH{ynLn(YOG9k zkDkf0%IN~_%<+kd!k*Higa>(e&+x*?unhj@xepPD<-o9}D$E2h!aYBA&VXQ_$Oey5 z*NKByy=sl}dsJdoyWaJ4aJ4_=9#-K!|GAzk$o23*U47KEe%;sD+KMyhOJ*fL(gR`e z&qcD{d^5_`M0nmDR4Xehw@Mq6cq20SgN-xSVavf^(fe8iA3G@;GLd6RE&o!eu89^1 zeF3LXD6W`2STeNe&Q5p5NFQZ4mk?#h$TIX^K!d^#`y|Q7A$uKPb16 zk{^Y-uF?O-G$O-)a*3y4V`yM>%bqlu(wp%*rBtp@dNS*9M|s60LYcVo;M_kN17ARL zMqY!K4JZRgViTRmPEP#lSQ1oWN~Z-R5)WSb8S&Bb&<4ZMFz1~oZ>#OF&cHeoi4Otc zJyZ>}!DH#>Kz;?L1YAYdt&U8f^p7SxXyt1u&)?LJr}7=VkLj z%MQd#Z5D-uNVPX_Gx#5%>_{WHN>BdW#vq5>747*^@62eZ05kB38?XVk*pAqW9*CT& zAJM4;S7xL>R8mD*kMwzq!DS&4s-b$;^CIHr6m#ly>Z+V9xATQump+aORV0jmVpdU6 z0qWeW8r|>xcgd_<+uI0DOE23+&kclo{}AyNFlBaLcyFr7$|k^e1EMSdymc8i&O+BIQetvpDU*y6Nymt}sn?(3~Cw}Dhk)?Vd;dj-Dath{B59e;Id;mnbfg?Z`gU4ACmGY=IM02UAxyqlesbwgBi*T-94 zF+Ax0v7?2GA`8{w0Eu|PnxjIz*jZW<92k#`EC|Yki8CpkM!* zZ=6m^I4EUcol^s4f~W2iw9ZMTv|XU3eFWg!QNbQx#OP~OBm57e3l4ekS9LBeT!A@r z4;AG=Qx*Yz#q6JYIz5Yzl7A$hAvs@RjGt+80?lwZMj-LpB^gaNt%wZWdjR-PPd|$j zb0ZFxe!BJBdTpNf-KU=qgTkuK`GUhkW989UB*Di|zv;U4XMJA9G0Dz)Mhg#J8N7oEK zrhtcWxuu3Dv$jkYWMzdwS^&`vG93m@JDiBq48@agmetmU4(s*U>4^R``MgM)_YZ+8 zOW8>Y;DxX8Jc|e#57JB@i=tfHgA>xEi*^m7;xYG>Dcm=MQe0Yvzy?6;U}QrfjGxH& zF4-4z3Www5OawM!)^4TTq;&T+cLu6JDS;za=g(H5ox;p7>Azqm-6dgrW9;UV5=E`> zC3q2jtV}eDO8skpL66kFr$OlmHuE1q{b)Eh7;(^%Rm;NtrCA@x#r*E6U@Ob+cZm=y zZAEowfeyHfQ&Up{7*35q*dj-?&aQE?4N9qM91hpxX=-BPHsGEC1r=IH(U?Zfd-wMG_MEO>^>Lj#c!uD3 ziQZw*x2NjT8HT)=V!C*j<4qV;lN^DZ)_8)UT;QbY;zRG%< ztEsuVP8-4`*#hL%5B#R;Wskl8K$ZJ$fvw-WdH%%qspVAT`Kx+~h5Y&sqd)DaT9{h7 zs1&WD8bU!I%kAvQt)oEFZ6#K`24_Kq?z2>vF@sFl+aMVqfC!} zgf8sexP?OUPsZJbHp+}H(iUx8vAU6j|4jhTF zoxi%!__wi9xZiX(*S)`gROhA|K&s*ZYP5Jvbw{%6zPsLY%|4nCo zh2x5UcI80~fXSrUNtx4*BA|1Om#Zz96a%}3@87=*q&GRmX#r7xqq~P$%4M(4*F8Q# z%gF3+>Pxt;@WRA+Twh*fVj^x|E-OiKaSN;ta5Al23l%Yp11aLS5oK&sjDuv`@)(Wy zfxyAW-jg-i5&&r(8pI{NfoYgn-`$Wglyi zxiVqtlW|mMQrk3*=YI2+pG=PRzB}0bfThJbh{#{kduOn53`_zyw|0w$^28ZZCD6Rm z&6ls-tTu6)DiARZNsu)+V4b~=Rv3&f^jL^~oDKFH*!$TXdE*IRAIO}}udX@LwUU#Q zH-NXCD?ze#rNtxhIPu57ZpuY@Nx7~u?~s-HQy&cNcF%8|YK@4dsiDi>3wh-tF8g#u z%X@cA@+|QR!T<2dV@F5kjcswYcl7j-fkXM=v}rO=*|B7*?JW^ z>X2lZHH2S(AS09iwB}Uk%>TyXZgO!EKz?w|uAV#DeZ$#Fcc)Tt3 zPm$UVe6kkTXA*b075z{u6@gg)Ux=JaVvfFqP-x0@qVl`47expA%v}4k$MxK|eWhDn zYSvXDFaAqIe)lBYo!UH?L}_dX5i#P%R_mvqlpa#{D3bFq{A5w9^`YR=x}(^*xXik; zbP*N)i{r81f=oSD*4HOs5aYYtYDL$hz$Er!?=xj`JOu1I`Pkp5Py9xYq5!&P<8FVr znM>YXg^`58;_!i$;~(wfc}Q#ptomP8g-RNo4gt>}g}<--t*yHGZSL zT@n0~o-yC3BMRBS^I6a7x@rC^t3J$SmZG;-q8s+J;H^XmKGKFx(C_!&K%4_aU9teZ z4+su6fsn!2k?lmG$avIVL@YFV5jTd0#^%(+wH|nw(BBKYbuF8jSs=tl(Av^bi_*mm zk?eN5p&Za((r0opWW)8^)_S)zf{TfL2P^Uf3O1FJYf^exwT_oF1IP%LX^i@b_)L#} z{O8BCckIK%8@mGt(!FHN*S^xVNaP4Ia`{eM5jHmNDfm&K$ zvib!GRn}EjRE?3@hP9`$B^JNlKai0s7>GSeMxOxZwuD17hX{D#$hESmetsJl*90WY z{z`px&{1$&Jqk{DP^b+ip*xO?m5?TYRso#c%%>bW`F=J2s&8s?bQ0z?6o`eb+DVd< zo(>&UIJkhwmkSWV_k-hW52x-LswHC^x1q;g^YaQhTSSJN44!n(tbRCaZQ&AO#@<^R z+iBYvtf4YmRy=sC9|EK4^`EAW>4Bg%^6+u3q|KjK{i%Vzbvf?Cck0-Q$S2lG1qFZR|AU}G@NOdoswyiN`?Y7?XP^=G<#(~` zJwroTIYk#IHck~7m)2=vwSL2Wy*2yG7xTb85gnK$U@~EHenGgqGnMZq*kJ$=(cZy~ z9v;zRXEz%y25Nn(vTk_F!$*AK2?>)kDz|0_iW07~q&**B(6GY|gy!4c-LIs-nO(l| zx9mXnbyiRMRceXqeL3q<3{%O#cKGML8BR=D6aAn`KuI?;S5AGu}^F2LfMEN7fOTp*4zlhX5bb3II%M8)3iFRyxEu zlL2cfxvoVg@(Byij>GpZ?&C4p@kw`6{P(a+sLteMG#8I+s}l)h56Su#7KQY}uTtBOq}CvA`$= zb`A`D38Gm(Q5^!nY~^Y^P%gBs>-Npaty{t*+H6T zuJ>tw&iE+{c~117l$vC=unae#lwAGsK0Me9ID0sja9pu^a(Sj%sED`jwWm4L} z6$|00&q&2~zK@JlQHQC#Ke$rZv;v8(2CI599jqsoPcv2Ry%3UkS+RJykfKqfm*Ius ztbS3w=emNUTD)?BlIpsagKAWxHsk~i{$ZK!!7PVsA`P;+6x30LGh*@pYECa}IXw2! z1i9Cjt&d-TEO6=zp^}L2i@7oix6UCD+i4{E011*mQ*|r#*{=!<_fV!5K2%W&$8Dkq zk5qp)M+_CjhrPy+%*9)ODCcYXBV{`tUH3KXm6Cu}d$(=D!0 zt`4{b)6N2iW{tg743o3BO;Ha|*N3gqrc@ht(tvG-a9{n z`e5UX;LwI<%8^|sW-L8|w?2Wd{8M|lSb()8I4 zyK|lfi+9cg>{~2Vh1dS~IUrR}!SlpKCZL{yp+TU;yL50fFccuCc~<^2pKBx3kLj|= z6@Qn_xinT5zqEzo{bZaVX5(zEmJxjeJ(Af{YSP5upNYJU?aneopmd_=hl1v{MyG49{!ZV zN$xbI{KWmt-|v_or<}~)DhlLs_natwpP^H9(Wp3V)=a0BL2$6mAc1IuzWct4=fx_w z1;M#3@6&bM*IZi5VrM_=b`3Anxmb@+VdXMhfy;!xYP*8km@W!}V zUiUWIls7l`X|Tj55cpHjQ9>*El~;Iq6Q}br)1FNhg?U?*X>JpVp}NlB1sxyiA1wW> zXe!&c+wd%USGMRCU}y9i;rA1{Z$6rgXce%<{pca$(ES#J{Tx(ozH*#?_xS_q6K?YO z=TufXN4f2yJ@k_1)vuZ(Y%7rbXHR#P9~n~&K0w0w3mBVvunLs-P7B#bj|_qI1Q?^R z4Z4%|yu64au$TQ@(pF+MhJNB&6JIile-OYNLq~F+G?<-y3pd|8^3xluo2R2b zD)Ti}5(ecGHYG8hKA>tM+ndl%Y_cDXnC`A0Rz z+;x#ayS;Mr#4LH}?TpF&UlxArnD2WgqMYHKlY5huLl-Vm-0N-QW8Chz2A)bT{f;ue z*}8gK3Nw{z30o87dlR`;Zx4(_Hup9dFB+25@R4LLNJIL%S+eI?~}$X}PQa`?Q- z31l&ckP=f?s)GkLB8dbS6o^)Ro68M;z`h;|mGCOH9~z}|ogYdBKV<62+s3v`b)j^> zCOM;qYNo>c2>AznYSO_KzUecx8}oW2o^uPLgr$Y{&X%)pHwX2bc`>C`)vKVWRKyRb zxjfftQoa3;31Nw4)g*L*h+_eQ!J&8fZRn8WNDyK5#e9W26Ts=@j%mc61u`LksXi;j z&**sQrdahJ7Cbsf4D7Ot?$zD=h;OU;dX_lxsqV1JT!JaBB zcFevf<<1R-pXLQ3q56V@Fzq^}?TtFt%5feA)>R5=Fwp$RHN2kHBYZ*c>g)i;5fQ({ zy#2~8k(O=3LB)>fp;+;d0o71x^!r(Ldz`#Wj>Z1XgQZYOp~U>1fzGYnZE~Zak&Rh; zm+K@9-0!e;dbN{_0)j%v!k@ftjKdOiR>Yt2Yd6HuSv-@EuY9L4g>}7Aci))o!ptU7ZpofF(&tF_;>*-u%?NdM z6uIOFIe|GQVO?M5O8@sae-k9P);Bj<*x3WYaC>;quWjRofZfx!w&>Z%?jrSR>aB}(*Y1|4oh2r|di(Z8xS`bsTRq_l z>lzB^LhUueg7aB2GMTgvWgVTlfbiH)Y+Cs}t!A7zZwH7tFkDZ)-Xi<9+^1Z+6*Dr_ zk?}P@n%@a86}q`F80++;i@#*BcuMHD!)-3NAo;w>$e3_`Z05)WcGNH!Y^x}!5}Xu# zj7=ww!yqIHV&ax|Y?V`&wl^A zH>8>Be#xwQ4%d%rjux~^)#Ow0=baYoQ{K%_j@aNkM9~Y`K8NYH zIYu~AB7!!yg)EhG@{b=C^y`H2vq05v+TPme)K_s>5a=O4O|~?R zJ{bH^FYf7~Q$py`AEYlVMshf@N&Kp;_eD z!?No#$APa$bw~f)HPcjtF4*I?ql_lA9r6su*`}Nv?)IPN#n?YMm93oZ7;D+Q<#!qW z@u>FgkpCu5^sDhdg|t&@XW_?;fxz610m`o&c1mm9S+^Eb?PN4cm&!SQzx;v!*pz8- z*xhsSVONTg6?-_e5FwuaHLn=~^Qy0*{hx0M+TCjT6-&>C&JlnyAFMcJR=#Ig9|5Kv zigf4R(v`<-NA*9N?sr#;3~#?B+Xc0@=Qxhj8U;H9`!lCX&yiQHV{CVm$oa&f>GXNfFL$a>)3L~F zy+px>CAkcf^FJnt{#Tn>MJ>v&_!;)rF5h6?$>N`lqfY~lTXnx0F-3vTMlnshq=f$v zS(t74BOSM3t-MOTf6bnF(A6;oRrkt z^SVqs{Zy#as?P4IPdp%m>6 zqvX*`%e0~M`Y-r=+!VG0G8wOU!+(k#{aCT;?71^ngIgvOBqem7$^DQkD%E_OgN-Pa zkeI0G@U`zh5o%RUYa_VCuV zAON8CC7Fk!=;L*T@Fz#)0xBg=;fVhM~ zB(0}zq-kaw8~P~`%R;bCD14|7{s?vPQslZ-y{P!&Fw@NeJD zJS<&v8Z4g=I353df6C2i)pI|^-f@+p(nHs4181JNv*&jXr3|HXw1mkOQZXoaelpV6 zX4v{^SyNxw{=}8F2 zhrUpL9-v&kdw{MI!0uX+ew}8(SE}S+{dOTY8()0_aOJZ5!OWtbqNo$cch~hwdI@ z809<;_s!OEx^m#gV=75PK#96LK@K4?u8;(NXNp+@!V?zsSpuAbj;ZnC7cqXoxWl5^ zK(7QW3M+B)$|`>=#h;BQypEgOTL#eLt;TW=a@Bthda5gA`>aHlqwn$oUf%uyYHzQ- zRc~W{V%h8(CnpKpiS9x%>!!!|Pa7DVh>9A{^9>-{SY&rj{lU(@G^J%|W>Kh7O8S{@ z^>>lu&#j)(=Es~m#xcS^={gV4OtW1X_IZX|o0}(F2q$Z?)hOUCd^6 zLs=4#-GAx_#Dh=yYxAaW^)p$7ZbI1R{G*DBe{tMz!5^NzQm-AZdG-pa>0|n747^=E zw0h@p(~l7GuYKPruRv3R7RL$l>Y-arj$iOEl}NS++S&vl!`zs;2Q|^h$DBo+d|q}= zmhU-Q&VHAG)_?!L23T^c%Inhiq$#_oXx8j7`72xcRqdCqta3MB@C*Q%$zq;9og=qd zGVp|#q+$1xix&%1t-e0Aa&#f~wo~8Tk^3H`{0XQB3QOUcnT@gkf|LZD&h}<>Ku*PY z9rJQP=WU(|yu>JxO< z^70;Ax4ewrugF2~$vK6p!O;3uf09FHnwMWyzbY;D)!^z?(Saz|+l_*;QHBBhi|ygf zD-uqGP=Q(te_qHrC(dni78-eDz=}WTnizi)<^o zIUmOHL8b3@|FfrCOLb8Ev7fFJ#yFxXUK2Xl$5vWLNgGoC6BAT1DZYB|z&rz;%fUei zFV{mF?Z(NAYfc!fe0TWpZ2~}#;yf=Dm*3J70*PYim25?C-q|Z#ZV9SJmueA30&jnR zf5E62EpU9Uu6T2MviOE;VdDVL21Ug>+w0NVOh*bx7uP@#m_sCguAi8XAeVh%|DPZE z{!e!0bwT&lYaiu1I&8yi%j@NXHv6msPRY1EnP{;o{J-|3n+UJ0Zp~*pA6)?*&p(!~ z9PRE*p$m4b`_)Uc>e~aA|C+YhXHil1!v!2@6S;Hdzes@f1sI#Ynu%%uT(tLh)w-Qj zYNO=JL&BE#S8qOmJ{Y2j0Q4v*cE?{k94qWmV~9BpSJc&;&UssAPRGQyWbF!Q%1Rj5 z`sxu_AhK5_HzOh0VoK?j;6yr!+p=u+I=0fAvv|4bN91B&N%5p8}<-yDriutZDv-MV4S-|*|$|eNuwk`#Ib`JDbcNW`j=~bjAGtn7D)Yn z&jN{(hDSf0iUuaZC(yvIja5Z?B@o&alas9;S^uf(9L5HvI$jGjrSyNlXrqC$)+b0* z>z8m^khsAiA%<)y$;&^eyA=@^7gy(o!VcP~iD4Tkc0{fbk#(rOx;_%@pq838#4mLp z^p=u>FqR^5d`xKOxYy5V9oj8Hks_sAk`8+yMhij}af7darYlQodm5=v+l zzOrkToSmb1Y}&M`y0(qLpFcA}u#S?`UhKyg$FmaZlnFXTAa!s}|D{+*HyL$z%u^Trn?h<^yta>T!f-@L2S1}wC@33WvazuNP=&JE@3v;X!g!w z--2E9c0?EO?5la^k7@gvxAaDZ7Fge}mUDckUniZ-K>FE!8d3J#%g`FR0h*C^{6qS9GYAAzda2I$+E?HLR z(W4J$21NJVaom!Vw|W&k#0V2dAdDwW6yu_z_JBi--alpE=61MRKQTMO?D=f_^e%Zb zS2N*WYROhUvQ_NQ!LD3Ss;nnfB~e#vaHy3X80OGsHfx>G0`2zL3Bh=C8ZV`U<=wTz zx;U9oEQp)Fp3+k$V^!_c6(24B4l`1kct0p9PSgi#5N{a=dYUdc;gk6i^PkWhBhpKi zIk4FzYiujj`$y~lqN44vh~qi=xD=^R2qy1*(Cs6Q$6UKOJjm5~!f_KRE4xV}5#5?D z*&2`DCOZ@SEaRqhY6CgVzsWcf0;1^5110wYczTfZc01SF_&Sb0gQRe)iBiWQOcSvx zA&J+Gu6|&*PIvTfMWYq%}eW7y?RMOI9Gt0pwzKswaX_j4tUhr$cK#Xx>az$*|%+l0CV{ z>wwHnRAsg^I$PP5fGR}@grX1NZw>ua38H0cX-&&&Vvy5Sd3nsj2!ul3s!RF}s`p|o zEq69#-iw*Dd-C+DR%MLe!-o%v=?PqliiCTMt^oo8j8|z z_IS+Gbb&>9r`AO9L4O~Lw6eU?#qs&9-#Z&!nhbRy35SqGZS(8$Qh-hKO)fhPQM z$Qml(M12R1FQKrcS5Qi|w4~A~UQVX9g2M$7au-}>Z(jB|W$~o%egv}$7lo6fPl3fn zmi@CKA=qB3XH*s8HrpB!-Bl$L{G@gIMWsZ%q6!z!d+izby}jQp857e+bY!mVw06|z zFH9Ra63DP5mbk{LJ_ULjl@UBD)4w^v03j$#n zlBm|MT&6o!GTg!B^a}PVjbe*lHN1Wg^p~Y7q=@=Vm4-OkTfiIBUw#0&KqTqEi)RFsOz@e2svPZc6|tv-hJZD2Cq0+G@RJXc$=P*fQ546M;a48Jt=@a$5TO}vVarW&Tk$mS zoRJZm$_c%KV$O*4`WFJ>yq>E!F?+T`@xyAYX&V4TyZup7Zqb0vGXQWEF9@qP)}}W zF8H_geUPm~1OCRJKP|diLLj4w?t8$OagJ+wP%b4Jk7=}Rm~ix_1Fr{XfXn;k>sLHR z)q7(}#>SM=cKE)OhWA~H=VxkPxcrZCVU_nm9~&q zWVwGBTs1xJjq645)+(;B^wHeeKt2A-yG~INeiY>%@T#%%Tz|a-FZ~@r8Gh{Uen40l zQkbb?4?dkljd;X0p#7bRI0*QFR9#(Nt)eO&Fr)x#x5A#(2(K7=Igj~`CRw*YhWf}B0EzYwO#=ln9v)}WKK);j1j=MC(~yF(7&Ax?F+~0A4q5Q z7=OW}F$k_ZI*KC_+_G((mS6y@m^lC8X9vSKhF4rbUkXeWn{v$48j3)46}6xC>RfB; zMxLWbKgbINgZ&D{bjb8U2AD-m9MTskj1`c$F4PVm;^7hYrG9myJaT!o@lXzpWEouQ zzj%B=D)N_|#{VBA`cWUU9s~ytvD{8^vxmZ7t8;#AxDSF&e?`ELSJ!6mOO^*_eEwpb zcmrJb!-rq*k?_4gD=Hf(N{nv3a6uZQ>(-$3S?XMn7X9RKq zoo)n4Fk!IUe7C+I1>fZ{PU_-NFK7Z)S3eI5l0mNxbRynFL?i%rhg6Ofx4^ZM<=>b4-|@WjSC;nOMKxz)ffY!sR$1F!n|}_7SGq(9g~>G$xAwySO|G zBvN5%kO(w}PY$$7Hs1ZTZ{3b_C+~dG31Qu|dF|4bORpzh`zB%gDkiH1x~D9E{IPV0 zpv6IAjE|*OdtCjn1BQ)`xph2Jfe+DwUJ}vnCl#>s!2bQba9V`O2zs-i>&_jclIV;^ z3=9X`qeA|gCahR%&-83p%~MmY=}m0RW_2A0_Mbaut6+j(;j)_u(Z#?%_n74?j-7F& z2=u5m2miA%r2p8MweZpFc8OkqD!2HlPop7%Uf&%L>8qytM4>1wuCrn2&;txP+&eO( zKup=ejHOrn2Ag*8_Fec&u7!?Tp-H0mc>etTy=yj-IMzfaTnY7$q{RQpYa9E_F!;n~~Uq z;r|4x&?$tLJNO{|sjchcGKVkv@TeD_$EO@DAcbd2kXhMOSVKPd`sJ#M4plrycSQfS zqc6B9oq3qnH`N)w05w)`PwKfl=Knr4Yb6CYv}340Z^xtCe2DOgY+9kVhSzL<&$M(} zx(tT|&z2XB-WAr|yOS4ALW|-n+FijBYG|XXg`zZ13_3kpyAXtQfO=NNnCQ8albG8A zO7vb2(a&x|&EF%I2Cf}Li$Kf5`~JpCBhOaA!}W>kxyO z0y~CQfV35(p5cSO#M=vV6V~4tI!+@5Af8p5_>CG3P_E6jjhGy4^8xaag|&xU@dH+R z1!D3A---vLL{9C4J0uhsVKUh1JFiF2YE>|tLepVRVE51yMt{4#EJ0-B%wtvq1t05Z zVAZciSl;T%Qtyw&%FNuESl8IwUS*sjLP>?J&Mjo*O2n@_%?UK6TWUdFytBc;hFY`( zaTuC~eYN{`Qc6iQ{jDu0c4Ua#`~KtojP^z64`(YZXELC^2*9Cc{fif))a|j zCgP1_en$gJh|un&cb^=Hye7@knC*AT=dfuVLu50^m#{GKGkHskCElHHqCfZi~G4*-_AlV&dm0$+PBs2dBN9Ue{>W5KykwS7d(ySd>Rft zv|Z6Z1DX91|A@q}u=_+r$*c9X9L-QbecsdYAl<#Z7UrmI}g_QXDvpG7Nlc>opBgWq&$;yiVI{ zw%V3m^XAO@ALT!Dfe0!4?j?2NZ_ixWa?WE{ACTg=FGNSJu^Qn`|7NdC2 zO-=3Cej?LFn?8{#$diC;PCpJITJ!2(p$yJ0d`3FNar^9?x_asU{c!FwmI7$o1$i@U zIVj5Ip^}W4xY%dH&W=#G2GZCNwim`w7|31IAdyr#8IJ^pj`3U2g_}?FOVc@_puj6A zDLg-V=N(a|`0;K#W^SN;{Z;g(joi;6NR3lOhvyFYLLuU$FONC~9T&c!Ui|9bPf%>R zc8lNVDY)|2s&LX9WOlRAN4my;{(PEWm~D6b5O~N^pFKUH9E@UJ*m7_dQDX*rUPF|S z(7JGtlhcg&i=8S}mDEcw3I3yonARaq&z8j}7XAB)JG%dPILHqH8BEPw$1X07-UT!e zA;ogxqGWEm%^!T~>p^~!Q9x#M|5(e1U+hjC1H}fj5ALV6`Fb4f8-HYEW_aoHzjCSD8Eret zYAH6}T<4i?B~CkWV)T(E>$(ecxB63H@ez}r5f@Y%Q)hacGJKIvU=q+X=oH4ql}_CO zYw?qMdP)JguPO71kmJJfoN1>cRVKfgtCbY5)_zqkK%4p>?#^lG)i$y<;!It4py`!Dt);-AI~igXVCQJ=@HTTt#1XT&^!L83SEO{;yEE0wW{J6 zol^kl4sq3EG=`vm02$1v?c7-pUvHmH5>Z|3Tefzz4G){lyJ*dfZ)$kUr7WA{W69++ zgn}KRzL+|NMf*`$!LZEv;im1I>VMcM&37;ny3au^4KaeJ-Ogb~_>3oIVB03wW|}Wz za|6+)3-Sp{BvSXz<9F_3L*e?MF7C-7osAmhmwW4_~NgPYT>ED!VQ zAFJ6IV8KLI&M9WzTSnWqao6LV9FN6&qj8GpU&a^`;!>6n_Z!SXB((OEKV9H8HgDMQ z5egz*%~>MQBV=g#`1(M|2>W`8lNP5p4fNN^U6EZU*JLWf5aG`v8^Nai{Yyckgu!6} zZ|_l7o8=R;Lk6G2!( ztvcqBvvYcKx$fmHk5CFM@DDIBt3CY(i&(zVTBq|g9@F1?4wAaM;#GPJ!(sWpJTtCu zi?a7X9XO-^RmtAIWIXsn_`Vo!9Skl51@tNnEBV^ z1V6~hzH%s|f8>bZ#%*MRQHZHt-!U$_#JXZ)?30aJ@>>>$xrpI;Rgqj6RQG9W@(6oie#L0n!NR7Gstb;uzVl;Cj%3ZA z3Lk5{J+}pH>W_+5j-M)ZG~+=n2qLSrK!n$aXJL(^;*vWPbBc{=`brNvDtg)`{0ZPK z^TDF+^dW4g|L)_*x1YVj0G)3_#cVe}{}xb7Ajmj!eED0c4leG4K#(r!Yrh%M16Pm1 zevVC9Rnx9R{mlM-Kelc7n0bEJ{<#dcSB8cxVjT@~3oi;QukMlTN6v?@cPem?~3fF5)x7ABi3|4@^?X2IVsyjdqNuQY_Yt({@R z_D%PB#j`(k2-NP2vsngmipW=XFKIt9C)I`?48=EuUHJ=HhDV4D zOitIQD>*$~IH9&s&9T;hK5Of?o^n4vJ;iI+e%T)8NO@h?Ct%qXZ4wN{cfcP({@@4 z)EMGVl^QQSNRVuo5*^mOFdsyNwp=@k|n zDi2whzSlFAH{cLAAk7|GUcRnASxmlczF$Uc^kb$jd1{KHp>*NGhxvJ54uP9@oSLli zk5C1H*31f~9aCaw&s$fnEt`8&H>RKzbfx1OYAXzP$L~2TWnd7^WmtAw z9-5sXs@C_K?+y)(I&O2dTjE23&U}s5!VE{&aALlI)8wCdW1a8G?M+c-E$aKE(z{&N zNBxnI&le=gx|RNTAr&53%c!PXXCQNB6X z>?-;~Vxy}43NM~bJHdZ%LYk;?C3TYh&Jyqn#tRtrR&aPu!QNjk#V) z)-4;=CA3a^jX~@vIy2Kh28(3%;O|A!zv2Gwpf~f*oY}Svi<+vn3qPl)io8S8=Wiv} zSqwOdzPDRwEjXY#qiMozHaC@jWcG@L<4+G`nySX_UutaYTpB2k($G5lGAPK%YKJd3 z2gmtMD&(hOVLJ;;4;hb7J$!i0VW=xQF2tATlKGs?oPUmnMH6MN%QsHKNpJdi5a+e3 z&M6)C`JeY`==P1gA-OpqOZ&8J{~;-DCI$vIvF}0*46h9umoC!>4Yq<)LZw{SxLrx( z_UZX0OS-?uhu6LRD1*PiS}RIQKB#-E=7X~A@)avQse%VV#7MJ=tS-Nf@e;W%=410N z(UuE2O^vw6r(URYA}EBzC3pAJ zyqi{sZhPhaBrd4JmkNL4TJND;!h#!ydnBq&ASzkgM}Cw1Xdi{ZC#16_Ix;+hWA z`}i{&U+m>z&KnS5V7SeEqlJOtZUisG64EtXMSxM>Id+lfDeQc6!gD&UK0e%0JHSrl z6t_B)Wj8ilFkYSj;mR%Bx4)AK5X8gm_kQ{EARnK6);ChX@4|ZJl|1ArRz11e_y=61 zOm~T#X)eW=Z+et-CLI%tUcOY|G*H$vn<{4`Vqq3_fA(m-3RIp>8S_R zwW%pIm-Z#hOufgXVqM=q)+1BH3@WJrArmDdqgecXwKEedCT10oSlbHgeOD@|s+w4x z*hal!?$c{Uzh}{FXI3yU@VhNp^Z-Nqu#~rCNnVni26cU%WXFq{hc7 zbs<0b7M@~lU~EkFeA1EX3~Q6KXU@D*Ul&*Yc;j9RpagIWg}qmKE-NWT5LMY2>SicZ zRzJC4MWX6@;P}0c$t1BKo^d5ESu_iMg}yQ@8^kQU?Myq4opBM0k=MBrTGy7k-8s~O zOTwq*=9P;VUF+IjFAprMcV*_Xn4L6DEHdR~ltiW)x9a#ahE~RVo$<@F9^}JU2 zJ}&z93edOr88+Z7PNV{AOx{BU=VRNiUgJ2%r*Nn9?o|$11z_j+^hfyg29um7Ls{#V zbjxU~f#z6DH%+K@4=f_RYSu`Kt5I7+?n%zA4|);%atpD)48+CwD1?il0h}T7y?n&G zS?zlX*^|=FH(rtCY(A~liJK)xttla)k&a!?4T&B(`3UJN#>R15k7(Sotwnd|D8`$4 zQmwvuQ#0jBv!8TF5`9!-thbr$!}2pM(3ijEI+kBWTKXBPo!%Md0qf#awMZi>Dr#?x zo^E?Df9DmlRPBpQgK;A&m*nJVpeslh)dLY7g|tF6GBxekATu2!tqAl>*Js8szwB;X zn2~176^6bA!(9{l@iCt*=3z)>869ZRg!8RWH4P6O8@m{28;kjAWyzXKw@){0J#tn5 z_6OaPz(YvLLyTCnEyc+pPV;G?Hz4cWsS=wVVA=8ecjsGQjjLEuUA$C@H?@XUQMIEw zaKQaVO?O5M=B(%0cGbu+Z>heA?PuVpJ0dKgI3Gr&*4+|})y&Zlc)P!QA;@nHBhy&7 zAXDz;<~X+coc6V6&skI!_fV9tUw^HfvU((_tiGN~#=wI&*fe!iA~c#JZfqx>TzvA! z(nl^XJ+=u}inn!)=4_dneS5}LISz`(JWx(C*zPQ7+)P>TWB+zgHppUbjIRJj?j#>! zMb-LSz9hX;-NNJi5Q}`Z&h)c zt4l0w$dV+k2xdv>mIl5@eS52lP`wX0Ts^f;x_wX~s{}Yp;$M&Ic0JG}rI>5GAq-a= zchfB)`F2pUkwlmupEGjwsI#@2Fe(9p12k8;lp^B}!r0%Z&t8R1@iO@n{YsJ!S)05(`Hg$8A%42^lkIiv zq*X0cwO;FmI4A*0RW>w?g1v07sJI4N%tf42C`@8>qcFfbgTpEr-2$bg^x(O zW2;~8V`8n8w91&tp$!kq9dgi$$ex~l-rXID0m#+g<6FNG&$^QStZu}!c0<_#L#QHp zdvEm>d@B$3@I6ExyJ+b;5aAxARTFO>^I15*P$G3mV2m|T7Vax5^Yuxc<@t(^qMB`w zIG7tlA2>7ZAT|{n|7tX@oW((ejG>ygKzv7=?FNYUo{JYQ+@9M!ePrV8dkTey>-Eyh zD;(d4`M%P4qwez12gvNDYj59MODuHr%;2T5t{RoqLsu?dczpG={mavm_gS*yvYX#; zUjDYQfLqB*Hr`!l+o2;1)e?z0NfV1{zo3z<{>CfDoIa zrsk2{quPmeYLUCnpFdxOSOr`;O#IgMHHsREG~BjzYt*}U7v8>oOT0TmAuKW02!hRR zw~udOV~d3@k!cX=g@D|1fieh)al+B+Y-dWSo28$&0^+nKooB>X|LTP!zy0Gb)>Hv~ zLWak*w6xS|*Qi+4=xBLxD#iy|C@618d7@jc20gh<+mD`H=aT!|`j?3Fje`;rnmAj9 zWo6b)F%(o0(A6sst2R433&*Uesv3>Seul`%GdD%z0hw2*D0!`&I8!g@zh2dC+yFa5c#VOzW~ zy_#$9Udff~cfG9Ys(yXyfklY`4I+uBfUA}?tCb#QMB6VX;#2s^Dj#mumwtZl;g$Du za707iX?TPjvhXAX$4^B?r9QFbMb)17_I zS*p=Wv6aZIykEU~_xrcDW$*V2mw_)S-~M`)`g`UotmQH^>Hf%vlLzzi&VK8sjc)jc zCkc+bDr-#K5QCyx$-?5|tJ2a*o?a`HdWd5&xe0N@-RR{D%6~{h2O%00mC2ww5aDiI z);P(HT|xsc!FS9Sw*sIOA{6~^&vzsA@j-KMl5vx8tV-g!hGe6vmxtuHu(I|v3H{Q- zEVHY&w&|t8V$tZ$H$)|{yD4KrC&ZQwQ6?l_i8b&)rsE3z_m{!Jal}`GH_U>8$WR2V zk8`i&AP4Uz_lx*aW$H7mLximuYpL=p4Q5jv*R1cktwKq;cG$IZOW0%C-7Lr6Wk4+? z?wLax$v2y#u1D;XGToXP5!MV?ygZ5IPdo|a?9XmKAf5W_$SEVi02r8_&lL_} z8BNcQlv$2;UXk%TcJ{@K7s?u`1%K}b$<5f0Pj>Uy{e`-T8WqAug3&A1_eOkLn$dOU z)cdX30nKp<2xxy?qPweegu61-*DuHJQX%g?)>U=hy4fZYsSe3r1oDZtvqSkfP!XsR z9}*E!ZJ8>yuJ84YL2;3kWlP0<@6VdhU}6`~%ri;ewqe6-lmWY-bTT+9muJ=gCf`X^-k@jPu+BBsNSuh7vOgna z{b5Lilp7zv zNK5Ww!bzx%QjC6yBRe(Hp*b47mOB)+?&-WEj-i;DeIZ(zqJ&$H->CYfdEaic$_S&1 zd5e&WNK~4Thhq1``2DrazHM)wNuIpZacTOYoymI!#I0Nx5SU{yognAIpkBcw>!%vJG@<7HW-ZL{)`D0nc!EwH9zxH z^1eLmi9a8wtfqD+ponm!6e5siSi0e34`c3S96VGcErBJI%U_=or|dp>@Pdcv@MDPZ zQg7z1K~yuDxx%{b_iz20C`ID*x0i*O6uN~)O8bS`jI@FcYFNNCSC zN$?4u$#HU9!PMJ60;0(5*tZ9?L)qjr0Yv1r_~jo@;4mF2DlV=@ha11sygh7AfD$Bm zb9UJep2GF*e0n7Nc~uvGtj{I%f?KJ(cE)A&57%9}DC5U(;0eZDD7R{I=j2dpM2+c* z#pA4|lCf8@V6Igr8g0RH>zl1(_XscVd3r?Lq=v{12KN)r_P7g?8=%5U#7fxE@Qr)V zy;66F-L}MLL?y7d*43x>o=LA(J5A1<7p)d`tBf@wMD&VTXybzjaIcb-rNUUd)@Z(-(9Wr5IRx>uah7gKXAp|%Ho`HPwkW8TO+@5b0T$D|FY)z)$z{3d6fEmGfW zruHl2Tz5LzCApq%9@qSvR>6O8;b>Vmn!4bvkoUdl0?3L}MXrr8P!v)Vw;PXvjEMkv z*tm<0y=E*>G^v1xqvFUbSud4HXctdt_cK>1s$olsIC%W{NBoGNxY37SH$|xF{}^Ki ze&WXck$W_WOygnNdAz*3Csr^Y2~SF+*;9Ddw`fsEdIrJ&s|Y*VOM}Q(hh+RkZ4xm0 zmx?J-iI+@w|7|~mSdRbssd~ndAHN@=+Ww4eN#8JfuAaI9=X9-X;PFs+P6JTaiF6qx z_xC7~6n^`5G-HcYhyNIoE<+gnHS5<4Wdt6;%(%A^5#5mg0+IAs#!e~ilFiyBd_X3` z3O1{@l#beD*?xU@N$pHD{X`y#C-S;Su*4eAU%c4uk{b#cLx1&)i7;723KkR;>*~5D zu?PgpV8}y)$fJ;WDeWC$gxjIEIus*b03mEW;d>FcNyk2- zAA~Y*>T0P35_d$c*`dA86Ibu%Xhzc`7W%b5Sw)&yV7@0v+zl9OeM=!Fvzfk}*-Sv5J@;E*<@eZD^>& zm_c1ZLEDf`yTk#T0OA+iyg z4$1#}nacSk64x@+d*TIf?R)R%OG-*wb_7{p6sFxduy5aFI={#Mefz#4@=QunxN_x+ zM%~x(z6NiEGYJXDq$+W^3H>43NJmbi*n*A;dE1sP`>@RjSb@mc>agOu@N~Yu)YJRF z*o|9{*A>dx4!+Q%4wh(g>3qKI?W^4NyFgx9VdU+;FXwH<{&73Nl^HjDWC{|ttVHId zwg5#;RZoPL++B@rmI(726k6-hjG=OPD`ukF8nMbo$`h#(w#BOq;VI{yJ*UyqsSzFe z7FMDp`h1(0KpFNxU8&a9)%$t*th<3mvy{3>>nY1;f$x5Xo6z{m=GB{KieK)V>yTfF zT$rv|&wt4BA);F7V7~kEWtU8x-i*8Sqq8y!=f3Wi!ltHevMniBH8}z+y>bi7i?G5% zL)!4v)T1@4c7(U)vpR{ZXPhg%`9hh#)^soR<3uULlEw`?cgBEkazU7;?Kn3^^L&F4 z>7plS1QzYZI}nEZDTQZX@DlUJjX!Jb7@zGtan%#J%4^uPwZTWYxs5DdI;vv)dgQZb zjFi}rMFWB zyIMH8+qNr@V+(6f>UFVP=L1~@3#oD`%|n+QvZjn27P1$V3MWJTooI)puI6MnjRMWI zm{1qG;MuH^dYUH9_BJ*3YtI_S4_te~!n-D9afJ0(6ONevilV@0V<9;T(^zWxTSi?y z=#6=anku;Q`rTCJAX&YD+2Ya#2Rl|3@(Jy}Up)R)20JfGK?(QeX=k?SrbG|U-*Hy|Ir)KjS)>!qIT*^sg#q%Y)|c|M+9pGQVk|?iQ28)KH(RheyS$)z)NM@Y3lV zWyhbk{WBBAwE-rS+jFzE_nFf>LUNxwF>k-#;a>@Gw~4@L7$%M~ED=qDsg$Zjbf@MK zWYRo4TVGqCXqBNpHZ~Sv)Y4^vxXmxwK@LzQ(yqdzj1-fnG1Q$2R;Js^NL3*XLz~a8 zVPw2)VSxa^cy+wzo9EBXg=Cz5|5Qbm5`zGKY}BcVl0;QS-d6Q{8uo72 zxOr+r`SePoK79Bxc1_m!-agnEh1IKr0_@ezmj+cfE%R50?MIYU zRmta6c11@=j~KSv;F0?pQse{#I@~8qOG|5E|JBMGZY2v&`Az*=#g)*$E1^B@l3r|A z_{gtT5%O&6r)i=XBU7@Yuf<8)X})J=T*tu7yo~LX+`?r?$52DV(#{;GnQbyb#|ka2 zzU54(%s9n9+3eg^Mw!1jQ5^ENp=05Ec+k{93!kb9&$T$G%!#!AAc>5+33=swhGob* zkI>gt9BUeYjMoCx(&Z~xMgy643tqcsjc19jJd$9knzXVmi*AVGuVG>us}}^1jcV0L z^7i$;Buq=CsAtrU+3V}SlMNQ_qW0NI-nbE}EW!7ery5RBYVPf6v6)FJED?F%$x}6& zmEl;Ue{^Uhq&fDz{5iwH$EwUN=FU;kW%{337y4}H(^VuY3H#$Y+L2@bnk{3zr^eTb zM`}8xMKp#_&u}b2Z@!)6c(r>~-7TfD-iosiRtm+9iAE-#ioD2~IiE&kar7|dPK1&A zpPTfTBY7PAxO6=~Cba6xD=54KIBKuv-9fl|z~Lu$uA>-f;oba&Ee#XPM0T!&V|kyP ztORXNjp*?GI(m9`V|-rU{5cTx@&r*YwEf;HG&B95#TD}C^tNCp=_8^G*Ssim7E?uW z5-kf40xTCKOkVQ@W$=vB0=Ds!ns3IxQ#~DHoNjtCaV+rQK}CnGs-6&7iN#3uuHJE? z(z4D)5(F+?U(>o$p#ojOVEi)^6BBZJq1YAHXs+lYLQ$cfMIX2Bd{TnBKl|OuN?aIV z$kI(VGtYE=Pe{b@&X^OS=zmlp@SgAu-Do}|9BD#gB24P;jI1u!)ibBHwcmgd8es5U zF7Wv7$g0`!qD4et=Q@`)Pi1?GcbHSS=7Rjz_YhmNF#ofKd28)#+ol9_SLTZMUhn^n zdKU{Gd0)T6MCfR1ze4>47x5slfgllUK`JEtB9QkZdvB-~=Ai|P*`dtAykm#K-%h(D z;ebwWQC3WwNuZcY{<=8*Az^XVAy?ULu~lLtCi+%>&dw|F1BxBrzi(|32fRwoBkBk; zS`2?AeZXu`I1B^SHt>d02r?BBYk(VF%yU*sN(yl4RUAyz34l>3ARnI|?b4dAxVY$& zI})}=kFg$;iETCOZSsw*tSnR_P;3Uxf67Ohe?lLfNZ`;fRl?I22J%j1XQzJNmoKl> zUC|K{i$)M&s{sh72y_CxHkPB;@7BG&u!kJ{CplP3cGqi3m$eqNXWruxs?(Wfwy^c- zGyl7Ei}5E4hwp#<_@OknoNQ_uk9+1F7=G^-}t<&YJhvt2q7J& zaJ>?r>E&x{*Jv*BAy8Y=+HE`v_V$^!W8FGdC*1yy6UR%ZYkjF~=aaNLuE@N4UK#Z- zTu{Cpar-4?s>p9+(AH%*)?K6P+Y0P16odt3F}v|w-shVb*~Qf`ih{sh6*M(bPUB&> zAH0V!gWsTXAKXJ?k-@{iv!960&iK=@8UZ)(Q_Rc)wi8)0v4a1GVs1o5?4Y2a5*n^* z(e>yZ5`xbo@QSdrPXV+EfOx7jfq1t+sSmoN?_R$?$)yx?6xl(C@wqIU5nb@MWl^Kn z^{v`RPl0wQ*NQhs%(m{=^$mAkA^CJZ{*-Ja$%w!)?Vk{};_OezfD*tdCnDh^IkO3f z_>g=aW#rb#yaqwtT962l8Qvms`)*=pev2RM!W<47aBJyUf~_~*&@vwZ!1v&xLj~0& zo=2GI8)Ng;o2o1!Z)%!mV2R{0kNs9{zgS)DBGN&x4s{?b$SgKaA){dxxUMb00k9-G zM_3qh%U#$V-;MRq$dzxTy6X}n%gDEB_#Oe&TIO2W7cS#=9TM0nY;ggE$|&Sv0!H;o zN=|P!E#etzF(sZgy0oVhdkFF$3!z=#?kui0?Oki~ou>OQh;e%z_H`vPO9682VX4Zs zM>1an_zN-0h>Me5yY+B+cMTzm5(Yxb%&i7xOr_CBcN%d_2^O^jl*7fdp0uEPF@|Cl z*Rf+)k?IBk3AIn|<2qH_c)nKDoQEuQVHj2SjMFF5vPBX;#Kmc>ZI+^SQ+F6~(zlzw z3^>doX!EW?Y>)f$rX$2j1KT+`?dI#TODsw+*ybEj?gZ5#3J8O(r5$$(9tFynMB?Lf zL^Doee#irtbhulPY-mVahph2>a(6v7n&6&J&CJ+Y25`I4cLYhDF=E@t!3(*^Vkfl& zx_g2&n%XP09@(~AUm6=rmNYu{&tv^CqzSI$TVDSJ!}S~{GFoa-n;EUs3n5UF^q#nk zE$r+qVGWpSUxmVEl3@)e%zsIch%)W~cRG_M`k9F5L!}$z5+Yh=+lA7HzOvGBEUJ!P zDr{#B4zq%~daRV!0Tid-*J!%FJF)0=Iufj^(qbIq)icJmd*T}8nOg)B&ZdAQO<@i( zrbP+Z&HGVpj215pv4V?`8Dudda4_Ga`HPgO>lSR+e}ZY3=r#0%DIl?>bY3bS9yTLN z(_LL%K-0^SQwwN+d%ksHxRy~p-J*g!r7;Z1XiwHevpkL$(q#d|>VrsJZ89B?nS#Z2KR*WfA?5aUf#fdy|3hT*V}+pktaQW|AY5 zt6Bsg7vVD{?77#OvuC^715Ahz?d6LXp{T|j1ZYk?@6DTGz|eT2Z^T4JRbo=jXq&I5 zVMl2YDgxbAksjG2K?6w{;YNf>k_~)^7K8dt7*;HUVFJ=+8e-E+!H9s45_h-Y9M14xR{- z#gH}v*F|2WjF7C(q$qk3Q}i#cujF1R_76$7dZI9~%mtb2?|}ghG}xvKM@ErLIge1z z)TQNd9(w2h2a0kxGfB3-SA$U#{ z)@$7ynHb77;Dzc}fpx^_mQECJ2xt~ky(NwP$R>J2Jx zC`t;W@P|bJ788TG>VWUq$cQ|G$er%yv_d(QY!D~etC{xPh5$YSq4ys?T*hetbnucf zSKq7-)Ip##hrkg6nD6@JNgAhzKB6StQ=pv$J>;WuCrwlmFJiP51RCadadGr(2$%)< z81DQbl$OvHA&uGtx_Sq`n)343 zM2LWj4rpOsSnON3Vy4G>B7v3?$Mxt@Bvp=P!a)SEgkTYw0+GC<;zlF{I4s0R5j~S& zDkQe}&|c7CEc)IM)r(Pbf4Jt-yUBoluZQ7D9iV+DY(Mz{5!X5Qo$tZ=0C=R9VA@Ng zg!Gi5jTE9WPl-4ZWdc+UWQlMHpWe{VQjU%9tEXOqb5~MS^d<_n(9>6ybY@J`ZvBo~ z!fw07>Z!rF&ib%=^&f6LKpRR71~0o|vXpvour%GnNfLkJ#2l%hqzXX8WLWrgpTWIt~r(8Ah7#4v;{M5uPY2hqVrX=%bPqH;&YJOGqJyTI!42ZD|ur1o=7zyo@4g|Ne! zex^b-M;M7SWduvh9u0F3%7u48K(uM=SHkEjUA}zzX-oqWCM2TW4Jj0YG;{Xp)~ZdG-PlnvsC10ZU31DPZ4;`5VQMCd#_ zIb<|_aOYykMf?c}-TsMVi31A3<>Cl->^srDI}I@rX4K^n;amg4JyD-b0Ghx_4bXT* zEC-TY?Bq*9ntg3ejX_(XH^DUoCnSHJR(! zggfCbEBaDe;t2Q|@hyVQ!D%biivYYq!w9{9|Bt!O^AeS4hU=t8jEJH(Ni3vq&g@$p zJtDk^nf*7;_&;v;5n>mP<4TK9{oXv*TPIJHW%6m)#;TEQS`K7QfP)}ON-+*%%pL3+ z7rO%MffhUk?DF)GhZAw^LX0IiIWKxh%%=)lbiQsY@{I;7IkI75%m4niP6PywgZ&o2 zaSiGkHA~lvUazN$qC^oV(w{1czEz@daY!H)f>$zVpR8W*G$}dOS&{pa1zu?E+g=X{ zp2)E~&Bk~4^vJw#H3ORbuZjG@HA)T+#Z4Ti7h#-l=;JPdBryGRy_5d5TQO0NL9K!e zP8=r>k090O=?UCYG%vg(C_kWX^HP0KS?K!d!meavla_p|?xrF4HpyC1`h~)uM9yAL zv2iBu6bJ6qw!W4eO_-eYx$y?(O`C37o$!3KgHM+T7;uSTPjr3F@1Z-2;NGD2#Ufz% zvaaodCmg7NdAl@m(P7m7%?JMH;dCT24iGJ_vI-ejW7a3Xe)*p$c|c&>U&1MysDZ!% z2dI}WN4Z63yR&gdpCCP@G4&I+i~?ki7_YWl_SAv@)x`E~Bl4&0`DrqOQF4D{8j|OG z4<9ZA{ZR%fn=+gTD07$_)rmtukdQ#8DCUXWh0w>SRV|f zR02DI=ys|Om0XEzt5SfbwigGrxL6t$8uSuhhW~(-G(hzRGbn2CW!|WfVO$fHo~W>} z)2K4*`Vx9#9`^?$vPsltI~&R+Pb<#AdB%WzL4|>`hyC5B=|eDWBAPO%C}E}3x9Re02P!(HS|XIjAK##t4G4T z{n=lB0ndBx)TvX1%|-_r_tU&RQgJJIcJB_&OBrASmW8N?AlATbC?_wbVgJ)f-QJ~l zm%$f}pVGKG5R)ftPz^jD4w?acotqDEbYniIm!mR?9kJmTz!Fp>k)pr=A?&?plEaJ@ zdi(OJ(ts@yfg_mi^=2XY!`0(EY2tkJC=GST9dz^m$gzZv-~o-`C>bO0RYs)Fym|9p zDWKUFV#)|9fFB9g+!5Zn4#Z}_#pPT*>sPO?FiL5PKtWd@b$&1jKD;q!nzrfiP(o|C z#`{mKxNi-yxhgfzz~MuDuWll}nwLHI}1e<>h0ocAQCQh*Cm zeW11T3_kkInTIMm=}0EuAu@pc`B33>Y^_Oq40t|>Z#-Fo5>(~o!+}6iZndcH*|X>W zYwyg%s;<*Ej+JJEqh*Z?xJ{zw0=R%EgG? zdA<~D4Tn5my8kqeWDXy5(b1R}PIRx-ORZ2)UuM0q9*EN z+XUZTcz8G#l~&vj&|8-h4>vR)sc>tnYh4@0wjkoB$GgRQIbJP&FxJK9c|v!Ov`?MR zLTdEmeL#~ogiWGb5eKcw;~3(>R>n$Zt_Te5aypR6adaupZ9z;3a^_fXQpUddyNCTq zR@FQ_J8*1D;=S%K9|q?J$86sdll-mxTX5(x`=$|K2D5vES6y_})YLrSq3Ba_{>!~M z_rT?STl@+pU zX*Z{`ZY7J0%Zc&!M$Z$ond)IjN^OaT#^6`qyc5s%7fBeD5(?0oLhK_#vf*wg?8Zu< zgNA-BX1a+L8IA4>U&jhOl8W&rsN+P7kP}HsvuvtrLEw~1aOl_5 z@5ipjWRc$b{V!6ql+6Sw{x@x$Z>V#O$k6v-zary32FR#Q~j<$(S3;zDmf(7B$ zJNXe%69l(7`jQ==8+<=Kq2Ej4(k4$SVWy&N9yxMk=GNu$l!&-9Pg5G5D!Q|2mX3eH zYZtuupoH2P39Cb2kmtXYC{M<98n)%f^|@H|l|)6NjHrE_>WH~4ISLe+8Qeo z9J7Z|eJ*!N9wB~v-U@YKaqP~QmOQp22@ASVVA1xf0C51*YmJlQIM`W-EfApY{NC=n zeglRbgSsGzXOjvv%bEWuY8pn9aW&yt5yM_&?uF-%EQyjx09o+f zm@yb3-Wfjp3|GT=OwyX3Gr0l$B2o4Cv)1!hrN%nJAW3JY6#x>a;!$v|%&_|}GCGNg zA@$5H1hX2Z9vm-?0n|}-)FZ@7APH623(v{FRbdU<0ukg9#cL6Z+9NJ}I*r;Y1MQhJ zwUku^A~XXWv3;#M`{~^1w0`wM5y}IOTLK=r|4Z}EixfT>`4;ZX`BuE+q$yJjQjg5X z#2!Oy`{E zvt*UKO6?UryYF_ATPYrV`mk%-Q1O5rM&Lc8(Bj0$NK{Ju7iDoGQNOVcb%@)*Z`$ z6^6{iKYunY;V3N6O9AX(aS=J9hXlq4q3WvgHNN*@`o|?LCii;`uxRMd`lV zBHSvMzhDf16NHYb9W-8PzltBlfZg`gMCU1?xpIK_{ALh0EclN`*FTIF4UjSnX zsQFa=o_8+xsqiXu)k3PUNu)_kA%a1wSA!L{*n?qVrQ`P`b=a__I~%vDqM7F>mn#s~ z08N27qij!<8Zb=5yaZ9D3S{JDH#2jUd7QJH8 zqD8x6RAek!!;o2E}90K;>DIs?V3T8f+IZ0y6 ztPvn0B3y_RYJQXF{LbgZMqxJj-lka)pE~CFg{bC?>aG&w=|F8ba$NfNo&%ex4=`j7}&l<}2VK099;uj`nJJt^a zX@aq)Cl6L`J9Ow!$W^Vhy)l<;ZpbOlSMD#&yG@L=c-Q3#6p;Pw2*XZ8Z*8@f-vhrZ zHv)6}wTJyY#^3A!lS|N0+`Wdscxkin!_ZS?)-bz%3Ixs_>kSMH#QMe-KSTsi9ijZ3 zMHH*I+`RL*uIs(tFl_bCxP6B0fB3imeCIF>ePb!Th%wfUS2QY-u7Cabr6aGn{rYFT zIsg3^{l@&?{z7j9QXln-Rb-|RVALq@p{a3PabS1V=x~2E=5f!4gc5epB7TTvvc);w zDfOyWX*gkBU8YipQ;AKX-Y35lJ__Mtp6E6{!Y@-gN*s52TR@7>T@QAgxM1 z78H-hj22=4ie{mHXrx+(&a~EJ?H95B^6Ve=shbF|yBOl-4+95U(+Sz~kGCzIC}Y=$ zmV9<}`@`Ys9S_4hb9=ijA>1r55UdYn&uv=Wn9=2yPX5lB6M;6OXP44`_T9&uz6^X- zBd>MU0O2cMG0UFCTMKDR$PhjaKfmk#K36-&J|pVY`@~?JPk9*TqTF=%@4GS*p(vOq z*;y19a8i^wn-#CG*~&jjpLry(Y5uZnx65pNH2iubFmvYBS!L z(GO(mEd0Fj=6m0WBn1?8zJGQ9x-x5saRRA+vMnXHj$LuQ z)BB@*A5BYdy74|0^fnW(Y~2e^XLSR}>y@8)zrnJ0BN07A_7oNj*Cr-8>rho=QuGj&wgot=ZY9+-L~ z!_p-LcDLjQhu7E7iikqXsH@s*>h+)vC>(MEd{mb;Az}p)=ucc3qK3LT$~1k}a?O?c3X{N0O)fANy9iG<)Mj zkrZfW=bzU@Mc=9aNuf@(9ofk|gg zq)43%0}zW0tF{C;lfn@xYCM-G6Wh37JtuGi;c{HXaOYUcSF%rly52sT$A&B?uG*DW zR$H=i`x7THNhK{5ywz5|b#ED!<*d!ehfG;@?ES}S%Q43kV0tfl6mL}FaX>Klfr##p zE>w7hi;o{w4+n;U5#hk5seaR}=Gv%;I)G;eSyex2*^}Px++I-4C#Jm}xt?@Gq<25d zCZCenCh6)HEw?l|iS@$DJ)`54JlVaSalOy(e}3st*qou@Rv;BcW@c&Wox)B}Mwcxk zP@1};`Rhwxrw$jABcm<-aV>{OmyFz2{-a#G0LFE`4TkDxp{hc}*!OD7D_hdGH_7A( zY>Uze%B`y}i7TO}O2-@!#-|C^a}Y%{CT5CB_mj&x#rqB(JkeKkNX-P(j=zG2eq#QU zZ3tPt5V1?!EorXy%#C^eZ551U)`1yYK;O#ofg@%eJ82O*bBzs(?VQe15(!YpJ(T?O3JSye?-4UzaXDZJIG-esU%3}bErPX$HuxOm${|poLx2L z3e6KGH7!schCni}tdzWG?88q#ncmZSL1pN3BehSZs# zopj(w!1C~r-CSw%sI|#kPX0NIIXlyFjlo#8O}Q@GKnR@^t~hpj6xQiwyn{2 zUI;TKX)|_^2}67$a!KgQTrRe<<{TSfn00g!hs3!zx4Xopum5EFOtd-$G zntRIQSvVEh7B+!o8l1efT5D!_4rrSnPVIT}t*N~4d%C*mF+M$>fmKww3Hh+_RhY(t zN6GcLF_?_0jhRz-ySL7T?IAAIYSxW{HeF_8Q|;58SmrhZ2SPAA#Wr3~!z}v_1mDU! za@S#pVK#m{JuLAj(eQ7^Fwqc)VJJ3U>KXo>9w567@chB+wqotca=VZk0MVnwoPRWHhZ;Mm~GEKcoDcmr2i)xWYUtJWHgbl$lET z(;L^H4(#m-R@lfCZS$M-^5F^Cbg7Ddip?g68K-INa~3IpQt_rdS;CN4@o>@=Qi8jp zJn(Xegjx&)6Q@l(w`@EeOz)aQthp$=sg1QqI&RNs40q31jpRPm-;~s+`{0LdxA#}L zalTWNo_8Z@iwh0)Z2k8B_Q1~*))=~#&yoiA5b2wQ$gHh4?M>!FALfLQ`=P!B2I|h! zbQ5_?>Mo&+gF6$L$3CB1n4oT=B_{gp*|VB;8C84UXP!Vw%~PHzbaLMnLp3h?+rFY{ zwu`vu)Vy`os=vXHhS?@kN<~>l6ic-Qo=VShM7q#ccQ@$k=Em8FV6f5mPQwWBf{FB~ zH@P^2be6(EX*?EkY^*&yq`s_cCNp|bUMEePw(Mr|-GYRYb<;3sJmu|gM z{e!B9c;tWPc6n8hgKdnhavz{X+OC9pM2v$Xscvx%NoaKiMM#7b%0VQVNKf0W%Ddk% zecD{2I~=D0b9~79PwY+pl#_R(|JPH)0ip+5v zz;oAb-0)I&10(C$bR%Ueo0YqvGW@V4F`*KMI+Lr9|62ad?2$5G~vL~IO=NpNT7LvH-BI zDc%6Z$Z9x-x^tPM3Va`@PlzhGRTC5j?ek$|WV@bW|3^j9p*UksvfX|B4r_{uL3fSv z6MtVE#<($l>E=p9Hh4tdtjl{vErM1tazYOS7%Rizx{zf193aE?R$<>>cr)5Ww~H(#X+O!4wn7A z1G@#IPZkP}!KM*z`>@+&IucWu-KmqW_3I~~+=rGztW^ay1NNaZr&AH&jzJE% z=I^z&AEoyKZ{>chKl=V+D99LE6b%TC>N~HSE|noNR#wN6pj~L(L{fUXeQ}bXcmV`i z$d(`w(pBsbS^b!?!X*(|T47u00%abOtyoAPTBW0h`!$iB`FsnwOz$$D$97$#blMMW zuMb(p&7mABxOQl=A%IjkhdGdrc%r$8{QX6VLEASl$UOO_}?-aBfj+9`Bt=l&m^?c%|LIx^9gxaL@|C995|b?EO=l3stF*l+TM{ zDkjkas4!G!+ySV!-9SK{Oi~c=hpcE5?_4nNc>Bm{=a_Xv<~qIry1az>$4fp^eE8|t{{m2iX)6E# literal 0 HcmV?d00001 diff --git a/qualang_tools/wirer/.img/overview_opx_plus.png b/qualang_tools/wirer/.img/overview_opx_plus.png new file mode 100644 index 0000000000000000000000000000000000000000..60cd3a1d35c8e30a706152ba24263508f271d6da GIT binary patch literal 44519 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