From fcd33a77962a04ab4f43045ae3f94cd58cd09a97 Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Mon, 16 Sep 2024 03:48:27 +0000 Subject: [PATCH 1/7] Add documentation through Readme.md files to the repository Fixes #5034 --- MyIssues.png | Bin 0 -> 19118 bytes README.md | 58 +++++++++++++++++++++++++++++++++++++++++ changel.png | Bin 0 -> 11302 bytes page2image24204576.png | Bin 0 -> 31011 bytes page3image24275520.png | Bin 0 -> 32388 bytes 5 files changed, 58 insertions(+) create mode 100644 MyIssues.png create mode 100644 changel.png create mode 100644 page2image24204576.png create mode 100644 page3image24275520.png diff --git a/MyIssues.png b/MyIssues.png new file mode 100644 index 0000000000000000000000000000000000000000..5c1994d45899e9f3a14ff8e8098a298417b61b35 GIT binary patch literal 19118 zcmX_o19T)^)NO2AlZi1gC$^nTY}>Xcwr$(C(QziWH4{6NdG-D8{jb-m)Lqrp>077j z9_+nOM=B{uA|ntWfPsM_OG}BVfPsOt0^=+=2;gsN&W}>yfT@+JsFJj(D2bA@gSnNh z85kH|s#$`(EQB&vn1MW8v7@q5^iYs?=tE&~>7sRxR4`5vjCHjW5%pyJv}f@Kbqky| zVM_##M7R1Q>;^6r#@}EZ2C@pfTwW^c++m-&VIS0IVwAnmG0pX3*l%j~l!q*|$urU+ z^^U_KPM$2K=Wb;b7=#69%bzdSgQOQrJ)YCq-Tt!ezPmFgGUQHIysx{vxPO9`S1bFH zJ7(!oxDZB`d~)Cg$cURQX%1Wl&9fb#PB(oWo=cLy-Ll=<_Jz+7*QIzo?gosG3`@AN ziF1f%i4k$gV4C4+iXrgQ2$Lg-j$*772uTFe1dNob7IaY*^Lu)jA_tv-MFUeoxRzg+- zw0(;~i-C(mx=Vqq(;ZJ@s(vXj%eIwoz@e?Bz$}Kt9X4f-MN1O@kC$finPs%1L|1nO zl20^@SYuADQaQUJ^T-TSp7D}|Z^i64FdS$m#aVn_&O@Q_mFL6ZsP9jYaS;(Dx!f)% zs+B6aJZ|4$7%J4N&3nBcW1v^-cN@GPt;zYvQr5D}rc!8^N~G_fcLSn1qrEAl5=eZW zuAZ-VQIU{hoMwo~D8@WAp#MPE&uY+oGH8lYzt>eY4p#kMq$)wMM)o-&74@FQR&RmqZ}L54%dV$_Z3>oT9wHkZm(;Iv&EIB2k3DB|fF zmGxacUn;+q93NxBv6@|L6aQSp%++bV<8r@x=J$CzGgYfr=TOY!W3!lDTsSscsacmo z{lfEbdpMr@P3@anmFdND<^AzH*ui?UMY%%m#nshT>m@2)HoY-})BTCOZa`*q3m#nJ zsMTvpaarywy`PI;H z%GCmmfOT_!-|Kq5xKg_bd;pbDL`;1Q3BRZ3Edd1?IhWb!z#!l+HYBO?jyOvXCV^p) z3A@Olx$XPY?_%9)zlR0M>Gb-Bl?z~UW}u8g?LU_V9v90Cle9Yz=Sx3t81?w1b z*_PY3kwL?`-sMKfurSN+zvUA0{%u-9EVNlSDc$Lt(Z(G-3Q8uQS5$+Z@9oe}M8*6+ zHk(wmKM(tSp6vqy0@O49zCTYVQOW`jE(#IX*~JBq_XEun@Z@!QT&p*UIn}Uoab=L5 zFP38J2rx!suzZyf*X{S$yBskGWh@k-P1a+`Kt5USJ^kk8-riQs7qCm@_IVvq2?v)}2-OfAH71KtgPpE6FJ$pb8N3_4dBghl=8B;flZwbSFZuDjD>h1vZJ9+Psh zj(e$0ezQuA&M6(6E=>p1xRD^Lg56La(pI8L$K?cs|C@*;b8@5ACcP(y)ks&rY3cIP zrl}>BPDA2cS(4UZ`sM;UQghYnzNS>1T+8d}YM~ccLcz!ukIR)y7PC1F%0*C^R?}$= zg|N`j@|mnZq38|)@03ojrP33N37k_tPl9UUFa^fZtn;J6WSLc#|W1|I2|3`COOVC8zzCX~}qA5s3APM-?Ll zhNuQS+)wLz&zsgs2J*TQCPk}n9Myn>zs_1H(@fWowMrj2sNYNC6`xv=RmXnw#F4-G6xIrXXsIqkFqp7oMNej->!;w))3nTE0Hbv@v?U@Keg_1A*ym|GzmBgU>xV7!sV zg+*Lk{Hm6Hyqys+K$@0KRU%L#Xea~Dkrr|R)I zBD7pHgooNrms4@Acfa>1NGa*S(!Gy|r8%L4A@xo^=OZ|mN_N%YJYmiTss^9uKcVu^ zzc4k3>mrEAJ)~y2-0ma z8IMyGtfi7b7>HXemzBM>S}H>)czawm(CO|jqC@WSLSAE)4eC>Cv&FZ{bT4vzx*ramM6K9nI;lv8sFc)fF$Y9}C|MA_)4|99V+8#nzM*ZLSfs9c%}b|N z^EHd1*x<=Y+R0e#WiGGJ)1U2eO&KMDmp#bPkZ|YMJ2Nmi@arOY)1YuPCVyXv*kZ|e z4u>7%g`%&u(n_wSLEr0xX!;^!@!!&HVJ7%@eeaR0Wo84h!SraG8$=zh`+&ezuh)%| zyw7pj?~kY(6&?;-N99y48Ba`E;rn>Ov1j_-a=yT5I1H?PE{o%GPLQEk&@gSwX>S1h zpigcA;tG+}@9hEnI)42fa2$YLAOoaU3Fw5X#QONR^%Cll_(SfT2tb2zbbieg%6bVemDb1;!|1(+%d@)4MSqt(FUIIohTSv z?#3n&2tULDJ|DDOQ(BB0$lZ^1i+m$CiIhgbl|$OZ`b-rm>&Rrg%jbCR=ms=+hXm(+ z;c<djK9LrDztyXKd zUsY8Zo|d$hh6up%F@HZ<>=q$LXEs2D`!}aE{er!j&-4Y|Q0BTbr;WMS!APXb>Fhz`*cZKuEFcF)NA8iQ=8UTlQUm70Xeo3#veAl3i2JSf zqJaJ8(^4q&`2D^{O?DR_S7nfAr z{1n*>KzICJ^HrJGN&k6NSw-1jkNgXOZ+t!yt~T$JCGcD_2W*V(;o(sm7KO{Ca8r_I z%)qdB69K)zax{~To56R`^J0(VnFz%50k8pF7Be0Nw@UUK15E$fTGS^ni zg)IdT3V8VG`MP-dx`3ZIWOBHc2(AT2sNeBKqTaaGI|g4$<&W~U6Xi}BNCzQE78coB z*6|Xrehyo?h8)wl&{xde90}Eta{Fo66}|0T;Kq zC?qGK28({Z*0}q8wO(A!9^n~EFqgwEE4iw-)9He%O1Cu|OZfewDML208p`wt$Q%ps ziFn=R#s?^sQ(_7H*!;TcC*IyJ-;^RePcTBBpYz$A4k(Q4&4gJH_Rd5)9rq#j)1fTb zD&2p-K~l*N0?RudpREk=_^sBzjxZ*AkO?_4df|Qb=kj_N%M~S&p3j#o#^S!nYHFR% z=7Mh=+Gnzwk$pQp%@4pa*bJ#(txk{3gqs7B+u3|U19c%_y%$vnWq{He#YP}a_YOv* zcl|dtdC!%vy&o@v;2|Oa=ZzULcd=4S7iMHTx6}JBlSWUQqXt2xRSD5Zy)M)(n?h6A zLji7#7V@+IpYErWr&s1pN6ea63_2_-@yJjRIe0Lf3Gx2n;YAkS!1VF71{VE`@?0K2 z?ZlVNx_bTIs9Vh5?HVn%2xgs;RdQKi^|8zg$$?nYB0QHdVpeWW=O}BcD?CP{umg9% zL*qK_2LgjMrG6q{$I5H>dSe5{m5f=F&^kme*cl{wc1d7OyUBRHp`+8)cDF{LJ$~bT z;98fW{Fy&5z(QtkL=i7qhSA@(!SNUwt+{~@r-LD}d%eDKL zlROoni$X2zXqeP#gd-T}s40PyKgyo2)*(IVwDbh}pfSaC4=jLG0?9z*WNKuoT(L1{ zPVgVmb)(4ZozJsYAbBF_C9Op8J!ZX;0Dk|nshE(`omheCaHv+N{bxlqE>n;L1TjQ9 zNeKMGFq~uhU%U*Tk;Jon{h9Lu`c> zOQc)C(vlR6&lk;XPl0kK5Z(^3j%}y4ORE*ypAOv)$AvToofg+ci7P&a;p6G_2BV!0 zIMq#8k>L9JuhVR=GLUFIL<;_GP&b-4 z=LLiwsbYior*kI5dq0d(xpJBW#-Q3lZQf?SBM-)#)AG8Wp$%LcHb>-oJpbXBYt-#@ z22;!9am#7~N{>(?*wUS`!JhBGRTiBqZO(LeY0B`K%0=@cT=6a>=-(RUG@> zz8M@wzU4G)#C@hs^vL>fOq9Nzy}=L~x|>I+Y#yL4)quR++ICrI6m{@PjyRM{Dp+05 zgS69FGiGGc^X#p}v_a>Muf*8XwDJ);X&g797OE5X<&S<;7ApnMg=r}uWiimX2<5rJ z@R`St7o}heaXJ&z8kt?%|DhcUTAEBuUocK9RTZ%kDi3Pk8@aG9U`&NcfpH~JGOzp* z(WOe@`3?+UpYnsM0H{F$NDkc)l+ytRWdJz~ucvFf8f>82Hj&IK9yJaQ-ZovOTMAwZ z&dZT7@cOHL%gLU4WtNkMvovV61ia7XWOe+ITFNj^rpX&~M_V#9JpAX+_18O46^ShV z6g`8L_`;3`GKI7Bh>_wY%Ldde{L7(E`#c)#KY=Q3osD}qtT~@T@DpiXJC$mbC?zG? zNWYDRgGFjNZ2_$!TX@V8XOwPS9C!YQ^}+JFYrc3t@l+__n`^;+S2MPQgK_lMYqXlx z>r`ny7(E11eQs_@m0x&0{<`0v%+OpX4KUd8Y|2II>Bj7iD~Tz_pQc2WJlvsfrC`S-`FZQ%{+;i3H7KM=52c9$AR+Cpu$D(obI}G&fBQZvG zIR6QJcyZkVc@+|aa*gLAg>(dSkHNi^ z&-fF{=2)oGu{dJ4>(Aco?+#j~bZS*48rS+j&E3q^Viny2WnH7+YvA!`8RH+}dAz^} z8XCM^25}+})F2ErEC-Z615fP}z5r-!De}%~ZKXUqx>n6B=;M{GWRB!LTODf*1o1<* za4C)9hxt}$B!&C+x~!$WrKTp}uErHJH2ZfnNJ$GNrkAryO>#6(<>2)M6?`40wsD2u z4C8Km=B^dHv)e@9_LhV>d)DPL*&grjAPO&U63P4g*({BIYqt_`zGMm0@R1eyt~XV$ z*6FocbGXt^vBPD49~5|R*~q6>RLJ0h=NaIOCG;Z~WC_2!tjk?lIpDBSRm`K;O0U~C z#2jyrCB&xFcAZ{ffPc{x=!3_fm?iiBfa2sj4iGsV#f_?Vn-&$C=@Lq^}hq?V8K zlSja2R6T5-6ADj2KPpJzwA%8_n2R`T~fM!59+^R5wqzdW0KY4t-Bg0q=`+kYnET>Jip1hlfXQ#4E{Fbbz zn3N)e(?I1+u-y91B8~_W_95Wq41ESoOH(4G{?Y*Or4}W$IaQMF_W7%o04}C}z}9bd z^9U3_Z#<1|W9w2eJ|K_%jv$RBOuDFQ;~m*e01=AaZ>X=9D>Wuw1uj~SF`=r${L*bp|V z|Bx_yO$CbF5H}U6r^eB1eavsg%iaN7cO_K!cL0 z70^0w4@d9uIaLi!RqIrpCKY8{OIxhQGfHLuh|yD(Zh1!L=nBYS+-b~5&reLU9T`h4 zCP`C-Feb99Rr$T6zRcxb^4e8R4E;7r()w7!aN_nD42CxuPodLrzg)3<>C&jz$83y4 z8pxmw;W5volD9@501t8hE04zZCtLx#|L@c0vwZeSt&RpBr0^ox7iLnI?getmPq&Nu zpV9tT^L=`4HClz`ZZ3qp{vWAy0Y1-+#FLU_;w?m^ClrlFYn=Ll+M^C>uaG2DQ(3rze4Fvo96>>3ZF;7=& zwL7~{uT}%Vp3SNQ@o`2lwI8Ode(}!aF@#7x*KIGB%0^2L_;vEmlr;AGJRX%*L2(2BHkIo^=GBez;F2ZpO7ePw}w$GZB}42vS@(eHV_n9+FH zB16bt5HNd1m9ovvLXu-F$_HCaNCe8WEAChA-%i<;g z_T%&M68ROEX+_{maascX*YWaSRUDQ#9M`;#9h~+%P0qi*Y31WllQA^Q+qB6ld|0_< zCVzLx0}p{&qOMl2Oei#zuh=^jwHyL|jL^JI7alcf;@WRf_nY}uqLJBRKZsFd`;J4WBBr}i zrxiU&I1kB)F0w`eKO`WWEB4|l*bm^2NLRZ|CSgb!)&F{4v8U46gs(DB-Cc%SsEmXa z(>EHdmU^HOmpVE*IEJy%kE9Jq+kuRRQZ_}i-T!Zj)sm)#x3_y(1;5Z=5eTe5(YFS@ z?sgXs=X1fqeeZ27VxdU*d|c8P8vU8g>b3gALQ5;l+&MkHJj6<4}>)-+xz$#{X)LbEa?$(m%%;$wFZXl zN+SM?q&&TP9&giG0f8-e3Z2eL0G&pYsqtZ>Yo!X1s-_f)8Be$UjRqgZjf{AXu zTuG$V`JJ_vijIan_mto5v?S4@(POz_2h;|6Jh3V%*k~gg;$!_2NFNW8 zE5r=K0Wom#6>7~e>mZSwe_l7JA%6QqKe_Ia2HLPFy*$?j;${7fy|ycihEHa)And^w z!{;WHL1S~nL!WMt)a4wPtB=38vyI-Tb^}i5{tengUNL;ERcY!PVecW;zPtwTdi)M1 z#zUL$)zQcmVw^MR02`x^)cwOvr(RKDX1E$2@<)n4bG%BeHu%<3l8k{3)gcVu{yPm# z2WqlWovxTI+YRa$PTd&cf>H|UEG&3{I5EtD*oZ%f{|Y;R1Oa)-o-X+BZu+{vxrlpq z%J;JEcYk&~Ppfs~1}U&G_&~1!p+V7mJrLw2!L#!!G#0J8U`>VxEy4dhtl8Khn+DS<97r@8zYkg0R#ks2tgYaupcZ0$#MOO$RKFvFC(*!kiBDJRTO3PGNIebL%zA@T$%00lau&w8f+Kue|VZHfw+F){E9^ zjYg2W-9`?NU)C3fH}+!BY;|I!(+7AyX&7n=T8bvJ(f2CNLO%0ID27{5=_!syM-2OVc(yvj{Z?mqv%2YbFheR&H_1F!zGRILH9A?#v* zpE5w+PwXl_-|cn7C+M?yJs3CWY%!wN+y-io8GDd1p~VkEd|#Q7X#RcN2eOrN1tMbc z3FRq;2J5o2??ok}sfo91&;7WGZf>1&*zD`I&)ujgF6$Lr8bfB;pb)_moy+Al=yI(D zax+#(`e-qqg`JTU98PJn$m+{&9}jU(1=jl*DVsS7hDqI=;vI9`+%hMdvxSYZkbHC{ znI+1bignb@HoI=d7q~^ zuf>&N(HYIA*Xy>?2+Lvx21ciUgz8zHuPm+r(Z^ER7NfZ^JC1;VOxsELw9@Ds07jI} zZhB;tsT0CR8#VSDS{t_6dLnRU#A^K#e8=)IJh@sIaxRz3GhUpQ$0aZ4m_nqU4x#$v z`rc;OX1hr>CJ;U9arN;S^6@nWk2{Js@z-FPe70gfcZj5VvjlP(rtVgspEqLrw6Rk} zoR&_Q9-?2@wN@66{jKgl4)F~81a|+bvC8}}2;TnFLxC2x+H=EsY{)2QyYb>8eW-Vh zn9+*U#FGFvzQTDDr9>MhTY3bR(P8%Ku& z$6Gz%FQJ5>G2G?PGkc|_Xj zawc0$A3a>N`Lue6QX%?q`1g-4a8XQ{r(dV}&1TRTNVCwJggDf6wKR)ZJuc6Tyks5j zF@GW7pYvI*isGpEZcTil0GP_$FFMu2{r7y`??%DTn_QM;+AMxTikk+{)(E*=c1D0M zLjI;w8imcM+f%Wv&+06q)n*J06VKh)IP!^!x=ohNQB=X~A)U%IgR0jh#kr1;cjlD> z+H8rlANx!=YD{F_G~JxhY1?R!j%vmnobGwD+g$9{H1>Tw#zm?$Sgr53{|j?Mct-d6 z91Vuw=FT*pLAeOoE`ahz&Sh7QR5!{jWM~c+ zdu3!f3ZS$w`)SFohy4&(P;!LXIb}8Jw*gA{-wBxNJUx$i71o5t#AcKjOctezw@OCi;C(Y8;$;D#f<)z`b~MBP$ui5B%X{l8g-Xbmk-J82&cBv`#$@mb z!Pzv~gri}Vn8z$jwrVV`dq=6TcY$?#C4TcW!2&jK?Imj9sTSYF*>p}pwR~Z?1h#|9 z$!t}aI!L>-RDSv}WeydFQ+otLbeyPGb_cCt+4L|^MZV7t^v8bHe!G~^X$onMH=gDc zfe_n7G^rM48wDo>#RkuYPLyyFuSZW0L&paC?G#pT%>WzYs-{P@1-b4!6}!`&sQ?`K z{?2Cg+(CYt{bt*Ygief>D@FuQ>%;{?eoR5yED4k0^*HU=#gsCc zW-ZH)QJG9o(Y_z>ihqtK`!f;@%qo^`=D}QWqhDL>t!526JP$^kI)yxu+oP~1Ewk5t zJ+QGY@CS!niDR^pYGsxpA6L{oYeRZI5-q5J-*>hu))!Ms+N8yK31if5(wPHHT{SpT z%$$a60qNC`2GGi{%=Jwuf+3##=j1qn6fGX@VwoM@I`B5s5tN~9hwzqw(}s$)g%5!m zablZ?@4I+zk^omz32wx<7`r@Oc7Kjr^1WHA?E=LVgm`kl%iQ=A;*-!gS_8B^f%_KfyC z+#vcNzoe6CvZrgER>||kH+JvG(SavCR2M~Imx`PNY0W+=)OC6PIcogMs#rF!~8&x%5Wtd1rU z4TA?Ff6D`rMIPJ=p3`(Div!?P!M`A8nxdGA_}u{XzzP8brQq7<@AgX09-{`KzyJ+ z{+O?_oAP1cOMG&=^y^-_l$^$wkWpEzQ1}Ja+^m67>#YuSLmViah+uKBg>OoRuXosh zG54n{0si0Z3XV9Jx)Xp_4t~VU=JK=13ZZqo|1Gp#X9b|L>tEH>*Ls^CXA!5&?pJGo z5(UWOs3myy%t(T3z!}3zLVU&Pp_QMMyq~Tp&y}eHOOF{j*UYnmL~NNSYAm-k(!BlP zA#fuToI5^RthSZh=tno^Q)j6<6GsKmrV&O8I!r)|l=XC%(q8YLjJL^Ha&K32v zUp5L5g(s&dl98S$z_Ly22w4u)zzS)^U2FRPZ2`O~3o-)24*kXmRp&?;a1%va=!DcV zin_bs0YX3y!XSm@JC*)zsbGN>A*U@`q9-B_$U?z9q0jv{&;HX_zXu><3R>GlK;saz zS2*qu8B5guC`W1E1jr-4!|`}Que&(_4)^%8l}SSk15Fkv8AtT9)#SpJ76KaetAI+E z>SP*m?F+`nZouqFWHO*Axja1$H?f5na&Z@cjoBWNhH`GRS!MM2qYKzo*cl*&z_JbV zEVKcXo}htcs+rG2cNr^7TY!e*Dfe4zC(~sM(OvW}`#BD4)en+7n$xmiBY9$!r== zC7Z)$EV;CluNau}P~@r$fI1n{Mf?L(g+^|%+e|A+4h#$of`o14OY9;L@Wt!G7_y>W zLt!pR&g1t9OoJND8aJ)kyewP0tGw#>2rju@KTP~sE74hUt@}!qni4VKc>1vL0)a=} z?EZU$#I?aWSwzej5SamNP<2|wMW#0V0G60sB9sLWCTi+EpeZ`Zh+BVvxx$$aV(ii7 z0_eSIEl}^S?@|LGqUnlHoy+eJWLd4mjFbW+LH?rm!f8&@c7&yvNXEU5vUfxKqin0o z4YQo!phP+uKu>l0e7PZvI*$fG5r$BN`B3IyaVt}))eYcd=+5ZDmSkkFYDArpof+R=obE62lRtgEf$8rqq_hkk=NZ(p(qb2TGNx@p!X=Sq4I-JN8zQ&+LYy+w!)Rcp@ z#SW)KK!C7A+%a!Um4G!8T+j-r&R*|vnK_Mqvu6gyuxt+(mu7;~h%T`ep+p=w+#XQ+ zKFXAE481>`%ctTn>W-WRE-WUtxFuM{q|HD_qtqTb84j^Do4v3t_0jq86`7ZLIR{}z zOKT~gw#;gl^{`Wgp?q3sar3@j%Bx$=HgndOD%8&^s zSFY3LPC-%CZ8nz&B#H0^kf<0umnu$7NU7tHQCR7s;V5Qs;bcumnL(X^^p39?5FwGc zr&7)<%W2Tpt@#dJz#tQVLMV`Oor3VCqmm*G{I#Up50m^sBOS)0bF4P;uR?G*fI?Ck z6r!`lMiIg}7#i~`3@Fj=o}S8*l|{=CnV9M?R~>} zw8%vrGWRo^gtCB;b9prR1J58s3Sf3q`F&8Tf?5`e$LEQL)^FqkSw(&|p?r7PK|=5z zqg)cO0E&&XkK6Il-GJRIKxK!C+~ans&Xvxn*B0;(+=kS7q>oKbsu7t0Ea}d8EGAP4 zPhGQ0wL-~hGKo?bB9_`0s%sGNDGe48`2qSGd_NWs3Y01EUNkov-2Wb@8+3^21)?@9 z2y+!66jX>g+kAp=w%c#>z}SRIN!a;IhRV6);9U!8EHY~=1Sk5OFH*i0a{8QrGO=*K zKuUr|P!TcW;obgw?*GRd`l!cHF=fd^j zOql?TqNcvS9x88%<&yE75x6NfOJ&IY7K1TCU0$JlJ}mbMXkXBIjW$YTS+dATMZ;o{ zx+pTxGWdc*sb>DxLGenK}G|k1U`jfdroG{IW{O%?j=UJi=U8vSaXab zra10DX>CmQa5Pw$DwV}{$kHyz7kLN6hA~&`AlImRh~7!gv9l7}0h#3Pg~%i=C>(;V zWp1Jy4L~C}WE1Fxt2QeCyliutOHTn;Fc4$JzfvBraj8zs$G~ZBTK5}Dfi~d+(D|U- z%4hk?mYe<#eTF{1?yt9wJ``eAo+pjMru#;s*1(PjMN*aaBisC9K+%L8H$lx%yG3h^ zUG#d@V09c3JDC)oJl+mLRIaH+TI=;D0a!Dmvn6)^dW@xKc7PD6Tr}aQuuKM@Ke1>{ z0Tj+tscic3Y^Fj)kLd`-3?qT8t8`0ZgSyv4jQrv`AUS6C?TAN)$7#mXzx}e&Vr9d! zsz7GXym7Wt+wCa%(?5;=HS)U!lYRp?UZefCb}o%kH4P?@4hEn|8^+fHl$&hahz?It z`1QAWVg?7NRT+)SpFn70Hc>ayZAutC3PZwQtTzx`phiz+G7vb?!B`GjK%1&Yv>=%=RV`$Hf-U~l|c{V{rlY!_>--l*RphwV4A7&@UJ%lv!HjB!IBMN__~ zBE3`t{GQcrAOAZKk|18Zr;P}z;oGss00Q>6(8H-ebi=++!%s7-hjh_zQ+|O9GJHgZfwet=`q2L(nvx!~ese>=9#vt`ub=Y4 z1H;GO^`)DaKJ8_cLUp4;nOuU*TCHE7KaXGSVyBm|G5ASNy(1#UY>vuig&yh1-@orF z;r!2pR61uZ;hXRxk83{e(?n?nL%B7>B~u@T+{xjdO5d6Sxk(6ri_L0U zCPF))y7uC*R$WyaexjsOt6MaD3PF(n)UtHlm*x4GZ0A{iJg4GYDR zhdQi9M)@trK1--;rj|QB+?iJ|ggrGY(Y;>>B*>_nM1o>39odEY#&CCBJBQ_&@o315WX<{VOkGHA3i zQ!>3R;5!N4EDu9ypbr9?h)zK&3F_-77PiSq4-7eS?&@p5_8awjy@4EMNjn-c0KT@d zCZF2{W^8h70Ej*X?{9BL;WaE0F*jbHd^zt~>$w7-FDBl^)o@Og{LMth7-Jmb1ttBy z=yq>HPz;DX@MGfY1`i8>@F|)jhF%21{9bGE;pXB>KVf_^&fpOsLt%}?o<66)Jw4vt;?FklJI<3t6tOZL_g7`qP!tbGpp(z&h!x{m zc9`ltBnjU2zp!vvBN9}NP8C~Y9bNL~iX;532Y517ruy^h7?2#6wiT0(QBh+FDw6Mz zKX!N1m3Z^Cc9|Uhhvt(Ho}(6KRB#jgNoWh*4;`+O0YG~nEL+0T)DSCZeuc-V^|=Ra zsQdsWrx3-O%Knv4Oya|#|1VB-DTK*b%;3Inrq$bAL+~J^!Q2YZRH9z`0u*FfN19ey zBGrdx%OF|uci%N?Li1(tnGqL{IZ7=CDoRNypC3Rz}r@l)cHlTbR}V2M5L_%^Tl=arkrvkSwdS(tYftG`=}LdHb~{w zU44hxj!i8rENs$Zyo@Cbov?LcOom*Hn&_pPtC44t1_9xdtyIb|&Gs{uQ7>ym!@zG8 zGzNBi7%ylXsv6_e?{>M8p|#t$SMekPpE8tcwiNNJvZr2(h|3Xd{1K3|BON@5_K1^A zXPS7iU1zkG_86Q!?!m4GJ@_KReiIeOaR6bB8-a`slTETgv8D24;iSp(=sWDpWA_c` z^|pPouTRwUabZum;mOZF68^=71YYzi^fJjg8L=(W5&tuLn^Ce%x4s@LTZ~02^da)Y z!bHQ2`Ao`9z8;djZpIoE8a z7!h_iiG$*vLIJ1k^0z1*5e`5gv+7|_Jt{xD@cK^FW|T`+I7 z)^JRTlaAtUe9WLGVny=DM#v<&>?aLpr~h9b&d?YR3k0*z@u(Je$`9*C?~&C}bPk*p zEDFnMnXb_hy3N*%+6X`?9Sb9uX0;WGJu_YuQ&00#7y*Vz+3E;~!@OT!W$TVJQM?n- zt>1iI3S<{){%&KPv!&_X&7fxf>i$^&=hK~?#GI46KM{?pDi>^5VFu&@yn~ZkZ~u3N zo#a$n8FKqrr+Q_Yu)6hFR=(ojbtcRR5-lJ}iFa~tfHOVBa!8{`Sov-2P$0R^Y zqph~i>maL@!XQUh&>v?frGF~T)k!G&i#6zEUYT%BU!k3N&;`?y_PPi$vy_o>SkuoM zsWp7$YE3_@HyT?h0TI1RX*qq9v~28~8<$sQPmoR&dHuGH(24ay#x)d~4~-fL*NuL6 zWvX<+w0%Gsqqvr?Uc(Ygu0QjE`E=LKAW;5t5X}U1^-Q*7-6hlYW$wu$_VuE{enp7p z5{1$}`o05)ux9OxL1`wkpBz1vO1InLpR1VGY&toWK8}NU5s^YB5n8|Fu*E!zj2F*p zCIfU6IRJVt-z_uHFO`T^>I76>T83M@(pT*aCP9M>t~_20Uk zTVDlyO)Ua5a=(*_gse_E|_u>%~-Y4UertT5pYh(d8!Hi2mJo_9c_7;G<) zy|tVUkGyVccaRkUM^gMkq-{>Vr7MGlWopNhgq|C1&1}VM-WJ1u_r-}Z6y=uXVK5{d ziY6#{$uKcfDVKCB`a?$X(Bn3HgG;lz2 zBSDJ-)hv2^htr0c0bZOGG1xrw3gf)Jy*>DTC{Z*$;fE-aS?uE>!6;(%0+G$MnnXd1 zg0XnD-W>35_uV<-Vgo2dH(D=?=zdIJ10+}lBE#sXE70#0=~o;pr*t5vWt(cq$Z2lL z;lt*eD>?#dH0jSCohrxAOemF#cvtzl9S+MX`-6q{6dRcnMHzEE!;C)h`V1;C%+QdJ zPg#CB$Q@3enAMa9OJIyT$91V}hHnF?kn^~1sdumYtrK1mO>922IWu=UoPJcR6N`;Z z-6R%?M}0i5(&mLC7qDyTQdKnDG4lp@{*FIQGv4)vu-JdU&i;WclBSdrE=lKY0kVcB z1CReTUCl&;%q4a>7JH27ZO)k^Z1-+z>m4W9EHhL9-o^I5@wRXS-ow4_{Ldu%sHO7mrSp;yf6P zTsfcZfDu~w!vDmZAyi=gXS+S0OU2WYsW6G_g3t3HWN--EV4&S{Az1TA(PTsz_)*YY zu2CEYDoWnTO#i7qmKe$~(Th`879JCzN)x4r-ZfpyhHrz3qyrGeil0(&RQxz%0K7xG z_^&)aZK~--c!0GKjfRhD@973rdM^7?F`C&&sZG1x9ZvN_<=Kc)q(3$9Ed1Pg~E)-3{{e(kj0Kc6B{?=htCDx-0k~{!O{n+155*;F`TkL zROc?R{9T5yWNNZP|K@OidfJE9iIzmqze=Gg#Yfh)p_s$QbDgoopvS;rQY(BM zzBn10H<{0f;3x=0^C@jsfVq*A;Tr=et!5j`6ws46NHn{tcGdg?f78>E9e>L@;cB3{ zI2lkh)89RD{xeE`;2R?+A%H`HYCuhh7X0KAt{df(YF(NFD@!;*b4Ti8;tcZ< zab!ahAeXqqg0sij{_@aFpUF0x!4k5M^qVDgP?Qb)YGMDa@X3G2PnmZP+OC-dw><OZ~dJbZEuQsA?)FjF_Vt*w@Ls~ou!in z8RLt+lX7@%90&Q&d!z>GgbmFp@*oD9HvAHr%z=hc8Cn3)vn7${fsgid+(?v~mdl!* zas+x$;U&J7VR>V#iFasjH$D!j!`fogsTX`kg9h3R;bw9#QHi&JcA3ehSlDrOSe)Qz zaB6o27fqS@e;qAOV4?DiKhVs8M$mL>MFHyaM?iRF=4%Q*83^%-25@gs`@?L)ENG4e zi|0#zPK*r*S#x3xZHZLbPVJr@P(+wS(cp-rpl}{tK~9o}d;h<%8BT;KOF#rt5fUPa z`;If302Kqql|CXDS=*hT#)#=%EXm@?jO}96RMFX1wZVQu$|&tf?l>k@z#jY!(Duj> zjE5S*l{Ts!CUM;k2#4Il0WSC3B{_wm$;3igsb*$^LXGKvPKfwbK~>oY#- zD_m0Ml46#e+;iX|+6?ndo#(ba91L0mL;aJPx#|i8TI*)0Wz6d@ZjpJWd8%@CwDz2i zGA|A|$b{2J@hYH?0*4#T+Y2{Q4C3xUJ)9(Q*iv;qa%IuR-MDXfcN5q%)RzaNvP1MN zR!sE*pl}))INW4nzM)LApc&?^X&n<2AdI5j9cQXAM_5OMPXtbs!62QSf8R-=O~&^Q zbxa9kLT2NnrO*YW18+)7GHCG5KiQqqI+IYu%f6VTHA?nj$|qTzh!TmAM2d^?nP7Y_ z{zN<-j0d`g1{DSWK3ru^GLPuMma*D=s1%Gs!D#jAYMrRyu-Wct9-)g-!4hM~(R^~I zRH;?38MbAZA*0TcH78E+;t^+e`zWw{u$k-~v*PV{ST88u4%~Ldj>cl)r~`Nsh3;mC zS!^(6NYd2K`4BWB&^~$!%4FaUqBY?jhk>v6s?&=m>Jej{{b;q(xMe+?+HAizl(5_C zVA0c}(Pb=dkfwRbmrE6@n^;%b5uvKnea+5`{Rs!3)GQHuG4dXwJz`>(NiF}z!&M}}N3O2M1Am}$7af{d zQOad*caC<%YuAe(=%l1I+i19F6p}bf;&FFmuqS!M@mF7osbyfWBf3?neJoz?WH^Y4 zMWMBwq}Te_w=GhrCfUMiR{h|aVVa0)PTv>ioiYM^+aI3J%*=7j4+o#?=A0*sa$_bd zvM=Tj7&k#(?!OTT^)dYtYf;L6JXPZl-KPC#s)D+kTfnkYzSCt300K?_q--a=0HsgV z5M_u>-9D2k;&kNwa5c&{M4sT1LNi?v8UyE>4-nOkc!F_#6HnQ(34KE$=R2m>OPzg@!G7E0Mae#zi_?wy

0~O%8zgq&-HY zQG}BXfZrmp{qMH`a6C?J-6`cXmc^uSv}z~=Jx}ff=jWNf=A&nHRs5d-UkIT0s>l^* zNuj8gP8vM8fdl$u)$p)QB6cISJn~*rh|CpPg9i_0QH1S5$F*Z(Apulrh79R3lJCDa z%~$M5$qy2w9CIRar9`uY*!lD4(={;|_F9mS4{rn6M2KR>reETS^2h30xR*>0Orb2) zu{5@Gc^n92=Ui5v^_#bMf8Mh22a$CFn>`|T^X5&gImeG5*R0w1EdMa?sZ*!$=y@ot z58>gy8nuW*FPNx#)}Ea^0pvk0K0KyE9;-*T;_#(O<4%j>qUQ3M;%o4`35;U=Vg)t9 z6Snw^Msx}G9gsj9FJ8LDuOtY}C!sVN=;2}Vlcmz8Oqpt|4_+9`VcY=`kM9%0!=KNc z>%?v)s|+S{`X2Hv9$0le_c)Av$GFSPfJVgNs%-p1OVsUx#!I8Qpdm7zEV@h7#*Eh*Dlf{~ud zB)a#a+N?xa%ZW9!6wagJ5F;j)K|e4^Qqlyd)j33d_L;ujW$VK8s-yFLHCW~vswEe&YR z(qT^Q+iJ`kyDvWu^ZW0=7b#N2**U?Vf1Zrl*P(B$w(3Ujv<8$}M&t3}Gwa;uXcShg zN&|Llz%e_qcHd4hDh((NM6Cg3mQm|SaVQPEVGTrWmb$GoSwCxZ$)FNS14;ui(?HZ_ z88f-6l+u9GK#Vn@%reHRQw5aWh z5>;AhAWmr@YP004XadPSJv-ZuM$xs3Z*wsTqFu_CDFdJz@fICBcF^%e_mbcsWZGYf zSRuY1mNLAW+{1>6I%XZBRFd-rab1n4RI z_aA`2RjXE2s#GRERRBQQBf-d%Hmw`s4o147C=L7vG(gy(Y=vEB2{*7p#J&OI=IiTc zPh1iKW>}!GNs1E>l_N)XLQ5e6%0@sPVLk-=5NHQRPOo0QfF>kFc+Z}_gtWm=XtEAr zjgaL0bn))xC!rcz<>c@LlE7=Xo4sk2NBZs z>(wJJme9Ke3l#ihY72F@F36BBTiRcX3HXU@ItWfVdI84v!IG4NS3v2M=Owgdh{iid7Twjm-dI zcJ11ApbUVkpddC$C?+;Gd-j~ll`3j0piAT2Hfq%9z`=vq*riLCTDNXRodK!=z!JzQ zqOQSM!gZ$<2npamiQ-h)6d;%&fwh`<@7|pd;l6$Q5^+Mf@LO3_>sqQV-#HD~J6no| zVHKEAl#LXTV-k?c$WQRNFi`+n!JZHZE}%1kus~PduwjD{VQt;I^#su(O2ABk=tE^@ z%rN1~0t9GAk*&CN=~CuNBIUPj+XkKBT47hl3P2INK8z78o+YGB^5n_L0vP+)v7@36 z7Ry2e*urAX*&E{koo~g8pZT*^T+x*VY-k`FW(mL)kQtNBz=1X-l6Cg132-%6uH4LH z7C9e0Fu}TU2-FsdwS(&@z~LG-iu358o&6+jfxH6Mt^8lX$LIr{gK&G;YHes#ipqzl(GGxeLLeas?nL2fv zE__}qM5UDmENZ}Bv&1G@%VCp7L>!}Bpd46PRjpcO*REYMchI1LAeRDkEh!|xIOW{2 zV<(_AB;5wWn&cr08OO3so3@fd0^gD|6Q+QN6Og-F23?vNn*%lvkCvc3@7uQzJR6*3 z44&m>+qP}Gck9~HqZMu8wTdX4B1KA(uvl}l4jnqoAKP90Is-m=-MV$LcHMo|rP6?H z4cN7|#3sQP1H@VYK-!ilasibCMat9D6Ffh*NdzJ|5Oun;7%GzqxuAyeg3-^t)-i2bmc^mYAuyf5YMEI4(y(_R9pE|8Jg zyg7I7JXsXyE$i&rvoKUD2G$D@wa}UK*#YJ*ATJ60GOA&*=KM4j82;_sx969h09K-G zNJtdFQ>LwwN-GTr4MaU#vid4ow8-R1lL3RYUu%Hj)0IIMFICC}$VZR&_n#|)hFKO0 zQP?@_I^YA@-h{$r#jhSP*|K4)Ls%o1y;k;P*$rlM2pl?)vjJ!X;g2i;#kX!XttZ*4 z0nnNErKFD>Iaa)QQF$*Y953%|0vBY;6^LvM4Qtn~BUFuQgOmqkAe;cnO_^#!-DcOf zc=2Mw$k`lna!QX(i!}$7ZPVs0b?ep(Z=}t27W}4JfmWvFcPorGeL_f&T-&+VXl9bKK%_^x``Hdu2UwaQwCKV4QMwc~1s#D%L>*tqY_ySXGoN$@4=HV^0 zZHS?ETzpzcnl5rk_}rX*L9HpJB-R-R7*Eo{h9lywPs#-f=wQ3rbbMHK^#W@*>h zPaM|tRm-Q7)2>K$&RgDsu{2LVbiAVl(p3)E!Fv&wRiz)Syz@@2?^@lz`UntVKA)T* zyL5s`HN_RW*6Lsk;r|YbcG6MeCeHETorPPL_40qYA`ll6Js?iIP4iJYF)xc{*)rO= zF%dk=)mt9;IGRkKBo+T#ikN;oxfereA}U`E0<>a8qE^6@A#!u4O~3=}#+hLwE2VMC z-Kc*gQru5Kt)||Lw2wboq;oLf46n1Snl63E-z^oa7KV`f{bkvzzsv|0!jXGYv$40+ z@r2EJJ#+S$4m`nXaBv@;Asd!G>ypQVdg;h~m*L zqNA6wnv3VKu+)=Q7SYg7pSvj%``6Jhx~b4W7iZ`Xpz7-dhZmbMA&1IV8;)VvHwd~J zFL~PhLt9)IC-Omiu*;Rt?nMvs;=<2j23MF^#pz)%)DlRSXmDQx0|Q0>aMdayVZnt- zh)V!P<^x?*N@AhkCp?gnl8*!rORS`TSi6X?4~YDkO$yMQqLDDf^FO+O=+gs`f&+oT zp3ctB4rjT$p777;)m1ehdq!R`3IrSOwU%-0-7p4WR!j50zWEw#z-mr$?<5R zwpbPMRZegKXjhhLT*9`7(`qxtcDuS>8Q*Mj0<_uFyK@g$T7?-Ik+ws%I&aDQ+@9{Q z%FD~+kS++x$y;4k+tOHcy3V<1_N9FGxjYdVM%gM@RQ^ zHy)&x^C^ z6Zz+dR}DZ%BHABh-bzrbZ>d|0P>PIfF}&pC;J{p=EYmVHZ1FnKPBoM1 zizBwMvqKKTLR2aJ{+*o6U=9h3_~LwPxU95PHAn1e-caELd(mGk5*e- z>v~4S03vm~$>g?iMR7o?Pneu%IK(4cxN^z zjGCN$`t^&x1+J>P+6w=g|DJuZ4fHqk)^9Q@A& zxB<}ks+_8g3wiJOr-&+8d@{miVaI4q3V;2INHcR%2a1L_-|rSAE-ZRz*dMONv$C=> z62Wy}cBFPh_S&hdV_SqGTfi$wz|vzP7ObW4A25FQ^Xnq&)Q6P0K7oxw#q3%D-{Dla z8NuZuX5rfwS~5{L1) z`t#>cjGn(Za$6ZFpYOKPsd2mQ`{L@>vgsKZX!%eq?jJA4Eu7yoBGz&;%R9pAKzs;t zT#2p}akcTjQiq|BU|UK&!v4`9nnWcIv)T>~eZQ-QN__f*NXU~hkWbZDlOZfq|j&v_uBBmd~59$Y%A+YA$G|?-&y1DO7?) zPdnall4Z32)^XVAiw7@9y)~~x@z5~EB|qY#vHraVF;_z)y@bN^`G|@C8GPSZ#%R!1 znvSV-XJ3{@t?A`EseT!eiUdk=ioC_upcitq`=5{|p&Z?A7-}CI)8CZU#!+QmZr10% z;p)I%d0EC#D%OZc3E<$m?;O*`$MyFGw7C-efR9k^yo2J&t%|a;MK*trJY!~>FQ&dv zv|_=l#x~p`5!K|d&bTa-zLXYObo{ERtcpn>Ev9=EATlK5-|WYth=^vp*as4?F!~$U zWuv0z$;A;tY$s{NmZEb37|%7WWHnv>DxVZJNwm2-Xq`<65AxS6LXI~#!)!yxa3I%@ zxgE&inYdd$A(0F}eBc}~eJoHazq*ZO3*uJ$pR_%&SGTKF1>Z)MO3J*7qaFY)X0Wb? zuX5?7tuUN!W{{+!VnW5!P}%lDXsxG8BMyX!P6D9NrBgvie$V`M{_k#XlPXL8Z__bw zOMNTWwsi88cd)9w$K-a@tA%dGg$)&% zUnvkG80nHSlZh+56%-US(j2Mzji!lE)`_*!D^+u??Xys0$N40+;gG9hP75{V#<9Rm z;(6m(S|+(ye*nk`hw$D%dgd(+RCb}y9q8Cpw4bG;qJpugpk{Ofo7491u+N#FeN&^| zjR-4S>)DCt)d1D2q+`KZ17UottX)$SWT8XnGyx0@WSz9qj=tJwG_2irxtTt;4yNoy zgEDW5VCRI%wgpjJzoLkr_|U>cAwau0*7Kn?!W&GnTdF`Gdxf&r;C^0v!_yuczfk&o zp%Ef7F^*2h4!k2cY-o)zNExPoQJZBfHt-##qD+#{#j_b)o1;2nraT>3{WeP_d`vgcLfob2(5%zZ0(QLf)Vk;@VXf;R2O85v((FP`t^oQseYGQ=GY z6A@KcDGAGy^eRQOA={_5Mgd+^xf-u>rVUV8V_EmUas0FEtW_f%rffMB5%V~Lj{37s z6*fAt0GXx4kfy%AX45ozz!8LRc&w0FUY%x`nO3E+zHj37t~^hmU-;R00zcu$_47M; z#M#ZG`-OLoKQ(;Fq6Ctd2n?oAoBg=WA3pF4e=9|p{)MXtd8RNqR`F09kPE*HDF>H2 zum2MF7%pugt31*{-EL6J8D*&YdLroN5M}~y#uZ4(52crZ|Mk;~eL0QbcpSSWvrGvbY669I?u$PjrDA20t#Wg#1H!mmPEYqmY0cv0AJf9M-(cmT1QD@3bf-Kjv& z5-+X0+sf)1`GQTP@Sl}If(sZLpy7$@b|u4Rm#~Bh)+C(;ex=7pW3O(+X=Fp;a}I7P z)<$KYTXI+XQ1;Lxj&4kvCM!YL4Uv_@duqw@QMt@#Po6iYu9aKf-LULu zgss5f{L@udyDzuSlm^wi*R_#UA@H*Zaz5-CA_UJnBzpEm$pzqU4;&hanipxC{B{3L zB@>$g+)1({a~p^wMM-VG6#(?j-N`VwcCm~VaRth-B?au9^*2(v)Kl0I#)^* z;+<=(Y@|9mu?e=p=e>C}3sElnG(25CwC-EgUiM_CJuACXjbwu~_SMEVo)r*ElZCr( zFS;J&gyN}b-nJjojMFVzOBz|}XRYlOdVl6p=Zan*Jw4<2hmr2+aRBS&k46t>MxHwkgl(jnMq zEU{~F`)J&Tl3&07i=rB=R-iqttL#v7`ydG~m77jIu^R8F<1DYfz!5LH)A32xqf{9R zy!_~}TvdJ2M*jX~XK5w$uWkn>K&84VH^@}B^(_>)rE>ouT{6)g?07HRKdOdG;zM6S zA)5D9YO+YkzR15~y@U=F>ld{EC1U^3oSe#(gf`a65>f`zWIoEJt8RF!KIey)+4pIk z3pHF(@fCKqpeXDG`>>q=#l3!aNn>nRvkX-HMc2%fB6`>L^NN1m2 zD6{ZeH|Xpp==P!R z_$B2H5iKA8jCDoO%@ltS+xQ$I*OOKWTYYfs$jY*yx##*MdSiRQF-}_XB^vBI(?{Hy zfe$HF5?ViOHn3T>+_NhtquVSfSVd~+Ev`tv&Qx_ok8?q&{}`9Dhy=Oc73h%?@JwrQ z(ugfDEhQOr_V$JsslD3o5jg;|@Ri4dz zigXhoIbqOC%l${c;G?YE!SQ!W#|c|Ad>9Fx-AU+Zc!dV0THoGlrtjcW7$Yi4{N6~A z>;`+)TTD!Jbvq=}cDZz15~UnLqkImF)3Q0d&z_p>`RI`$Ls*eEOj+l zNPn8ZGWfTqfwf&>FT?q<_t6`RWCisiqj&m&k`%gE7=NnPM`8S{cmz-OZv*v5i%>4}LyEI-OQ#?<`)tLGCt zBP|Ez;rX=6J)nl4z3}s43vIVeE5689;iXHC zIojmpq?wsnhU&=Zw6(!Ri9!(+6-?QYGN|ZdC(PX4xjyanT@s$tg7J`B+h4$;rGXcgV*X!v+lgE#S}S(ac5D<_gC`(DNA*|%!`+ysX*VAv1a}{`Q4LrKpPmUbkJ6CnfT+_}jdm5nFDPFoLUrOE07rjnIZBS`r3IljYOp32-joA$(0&pkuoeuD4_V)4 zV`Z+j&mtMB3_`4_D|Jv3PL(Ho6_XYySUUWD&y*g8e{W*5ND~jMgJPTPUjW| zoTrwMo9U@XBgW@AdY8A%hK$Uf0O9E`XsIS_Kq8KLMJSQ)+9y)EFJvY7dmW z9=dlBYzXxYAh1$KM&$Kt?FN_|zXqDL=x|h_2pxbEe9T(~2J`XNMZ7^Y7`b%``Oa&| z^7kLYch~}&_zhtwXOKqY%B*ChHN*cw>9Je~j~s!x9JsdDDTi3nBo(GLi-$>%IW78A zWvG7sV{7m(**g?chJ9NarKxqZqB*L`0JW-JI+|BV)1!qt&j-iHV&2C~^H3ftlY1vY z_}CRHmVjj8lk5^rbIejPcYvx7Nqg4xUL2!(WaRgSI~jP@K;uiCS1@_U0Vv67JCWPd)03N< zt5MY8&lYfqH5vzei-bek40VJ_%3|Mg(H&GVs`GHeU07C^$AKeE^btPzA=70yDU@||NL~tKT1cf`!Ir}&BcxkcRrdc?^x-KClj3; zYc1!BMD$y?e3|@L1(md|B@;K?i)bDkwdpZZ#>fC1(qT}{2vS>Hn^GZ;o4!Y6#Hiy09w2W>gO zVW5J?_{egO^FQi3wS;gI)TQMC;Sq@TuOVztS5|TZi}i5CSP0@*qJ|4I+w>8@|E$VE z>4+GS$d#4m6xB`nS~@XWhZsVEo;br#5o%K&xL<>DRLKfhG-_qj@$rUr_|FsbFX2T6 zoHk>v2eU=RnhX9FUCNBUQNbE; z3r7Fm{l17zi0*aooB%{NuOh$1G9V;zBhnd;iYP|;=Q=INOWcs?Ibt}-ApUP%T!#zL zuW~XIo~tn^`ulzn`fv1F7t}-hhP7)Hg!$ZB?JBE;p%(Sf2X6FRoBq;aL^sR+f z$h%YE&g=(!=%XlliG!7$pq*OON9T!~c~?jT5Bd*PQB;JXLwY_9lKHT(Fhoj!D1F=T z&GYEVyr?&#+|T-}VQIW)ck0^Iytad_<;<6&KFl-sD()uQ_Li}c?#gWyv_)#&KSJRD`_m}F*+iwrBsCNe69-Sb2 zv1dL`?biLA`6BDh&^Yf<-`tXC&W#W`u1v&eiF)%X;NsdK9FKMgIs_!-VlG~KPgVa^ zYOg|^GWq_#Cej&)?%sVKQTY3~CfUfSKhTjJm94784AQrO-6Rzh21Yeo3F~UbSzhuc zLlN$pDH}VU%-O_x>Q$FD)r*z~^VAD`t+o=nO7#nP#eW#wo)3{DXa{*LQ`9(9c@WNf zE-d(q;0Ceev~{~eTvZ|vd;`FDz;!J@%%Yy(Ts_@`+U#t+hv{@IAODn>S6sL(9i~pU zIU5}&j~VUe*BE~!cM-#sPp;P~`Vs!)C>BbJAap4zD)uLklZyHKj9(Yo7(|MeJFE4F z-*VBCZk)JX=3n2KR;rTX?`^?dt?0FLwC88-MVoCr>RAMdxZXcE*oKez9j(XlMvh~g z-}v~RD`ZoQGWCSs+|+(XVQ#STp6}M6)7EB=-=06InGfL9{f0$8HBlUW`Du{3^wwuF z?_7T@_X8!Fn1d|UJ>bt%_lYH&@2&%0Z|tz~edDqwx}(#HcJ$5x91% zMm57hk0xP8lN`RG*JbvLwS>HN zloBsv-_elxk_O(kF$~mWlKPX!tfHkQi^Ak38rD~b*M7_qOuQnBS#%0GKtVy70na#nvrguA~E5InqH z9B)38h0`9V$D}0KjJ6?g4R}20+@8^Ph@LLf*sy>T(R@Fubya%bm#{LrbmO5!HX-KQ zcw6d-+TDA<#y&#vu-RVEXP33!-Y&-b3~}L;#<&db7xFdbbS7>?erZ0#BsAEH#f{vM z?9hrp6G7XqstF=cdpi3`y+QMY-81lyISRa#S|#6^ZW9bYFfNkg7j&iKzZU#_4VuKc zSLvl~lzkUy*f6>x=j=ke_^nfvO`z?=dz146Nwv-24%f0VqLh|1U@&Q-O+d|-sjO&y zN;fL5eCpIxd;6V4?zcDDw3#xW6A7H}Jsj@gb($U2RS`*LlfGHVen;_ASD+|HpL$Go zBObwt#y`|I*jSP;Z#wH{LtIy)92k=yf&D=nq*w%$KW=UA>%{0X9bE-~__H)Zl-m;Q zw1;F_gqfHC(HJ0b5mozWREay#?U5!xwN@0maDtiJY_kb8+F=i9q(!HoDN87_T{nuJ zuwUnRn57gAdMUP@5%xx0H1J>M`(+iF<7cl6o;}5KIZaGJYT#hsPp<)aYdiy={Ak=b zqZnbFmcC>1QEEEyT;L!C&z00I9XkG%3gF8b2qACb?ZW&@jw81G$!C50iP682`{)S$ zvks*|XjNMQxD=zFz8*9*Jo)vEhmXI#H4t-!*oQw?=y|PR{fjMBJhVdX|3rgygD`n^ za+BgwHuBl?z5VybEL=}aL;7)okJ**7)98dO^>tnKSph{(KWA<~LL#s_a|GY|d-oN- z=+{~dM>~FQd|XQVm>W!JrmjUUjlcoZxAd&15QCA0g`e@|Yon)*ena|2ilTHUlVAVU zRoTNX)cZ{q$8L6YT5hU+s5#Udq?Jz~6TNRzsev9(nFL&=6>C3?Z6#1*!8mY<%#kLJ z?ui^NQmDgOOE1obv^O4Y!plV-bTiT_8mnTLS~xIQ28hHy)`m{0G&p+#UoU0&REk?h9|P;+Fd~{HnY-Ghxumx^w;XlMNb%hh6M#?1~#B0{Q7o z^tqb>_-tGszux!HfSSvawk|(viL9jTQH^AtucjP)RdYu+fKp!4wAp$;y0RQzSmWYPIm+!!T^e-76S196 z^!q>_{lsV1fms~`T`*>`&Y3FP8{MN~w9-C`ipV1qqla?!b>YkI1^E@

L&N9$3FO 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 Nswk@}Qz2y<@?Xw|Jsto6 literal 0 HcmV?d00001 diff --git a/page2image24204576.png b/page2image24204576.png new file mode 100644 index 0000000000000000000000000000000000000000..d78ac830857a8682b86f4fc2a43449c97dcfd3d9 GIT binary patch literal 31011 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

C7@? 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�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 literal 0 HcmV?d00001 diff --git a/page3image24275520.png b/page3image24275520.png new file mode 100644 index 0000000000000000000000000000000000000000..262f719c73657e4f72f1a37973098540bb4cd1d5 GIT binary patch literal 32388 zcmX_o1ymbdv~_SR?(XjH?pmz4yB4Q7!QClNfda+dDemsYihGgbTI3(T_x`uCvN8$D zotbNApS|}XN>xP`8Ib@H1Og$;%Sow&KoH)*lN=rr_yoH{_5yfgX)7tIDlaKXrt0cs zW$R!G0^xnNO#G<`C5|@KEu^{=f`zE3lVfALy?ZrdP}`n^hZU1ZN2O=TlFpf7kTxE@ ziomc;2f^4&u?nxH^@O_22v6|}lSW~4=3plGopWL;!6{-r0b*?ipV7xM-@=U+KSBP_ zMEk-E3h6UmADvLUnyDQ{9b~lCdF(lEt5o1O3@4!J)0D@ThWYGjz1w`=m%uJcKmGp!*iFPKo`(XFhOC81<0#sCM~5btvR23ES4N`y z%saj4_6xpXzOhuCXg2l`tY%fP3RY0KE|Y{b8pL;yL}W5Sbvk0E3XEH%nq4a5x@@V0 zPW~S{-Y;zrs*DZ7B_@up^2N-VbIFcM9~H#;@o1nLue*Ob*zPlmJwgioN=p-l`6G%n% z!V^DI1D{dBIUIruLqbB%bf{oQA>JS3M5;FgWve;|Nq!9cWc((Aa73G(zO~6(8CI@7W1N&lYTN^fu!E%3pzs35- z#)j|xU;lr1Rih;w8m?r|&ONiUvmET6q}z4o!vU|)ZTkwpN;FDTJX~D1??zK-a|Jwb z2B;L%m_DzymZ;>a_x5@B(R9)TzCOdJX7f4`5N5KQ%UGxuNQ8AoxAwwgvlfdD=!~ z_Pn=gQstUudW|;m1aes)r-$N+@1Jh%=e~U#)ob~@yS=SKpv&p9Q}px8c`}KB`^f&d zw$)UQd{%|`wbjROLNC_q?FIee(L}c`Zig(lCrjgL%-JKRRwL}6#b_n=dUjG0<8uX?9ahW+B9m^~ z?#_PqQ^<%EA1_wT7fAl=3cSIN{@CoG+h9E%aJ45NMC3DaK3B|$5ZU{^+j(2Uh=>Zp z`DkWaItHgejn_t%v|zFO4KzLiqw;8<45gx?LMq}{fKp*{zL7bl4H2xw_SR%O|8%<2 zpx^Qt2}1{FB#9C(rsFH4_NPi6wMnd~Ci^9hsDsgzL!h79Ww*~3*%i|&4~DYi8foMb z$!zC}m@Ed&#$+6{aBvCWT%jNAm#Py8xC#6rAolk6xj(OYH9~2967)Q6^|~}GQ>PB; zdrTsagAB%iwn(OuHyetTkLl?@MhL36ncd;Eo*GCXHQu_szLzcB#@IEMR*@~3>wbI9 zmK}+)o&TYhBa%)j>lr$Dy5h!W>oS?eolT)DYD-5K3y-2xvO^w31A`$08Je`ECG_%e z3B@0|08EnMD9i|@@sTDzOTFQsl?Llc9=9?cJwx;pC;KI>R7>`sI>ro68$yIU4xn#? zscIWlhCi#tf*=>o|LG;F7#WR9%Ga1K$0U9H?QTwUqvs0@(r`jv?RS2+115#u*+Nt&tK zR-2&UP)Z$@as_U0Pk1#g;jVss%{ZUyVg1z zih%h^^8n*$Igx-;<_4IA!hWT#aCNb3L?oH0a1u_)gTF_Usgd+bp6047_z3=P2C{O& z`JHcc7Rje%_}Wd#`p07ox|}Yv@1P?IU{K1&W3=F*85rc~P6ICD`ikTH8o4=1?Tn zRKUTx!o;W0DT6WW+jw(GTgf)9D4y@ekYUNqpZSQqGL zA89S641o=_Hbvwe#0AaM#_iX{GEC}62_@YiN@+gINqk9U|M^1JTQ3D9SQAd_GI zELQ287fDt$87%J20~=ofaf1o(BbRh^YPsPw6_`b%SYfY%Ag=Y(EwLf}Z>O*3Fk00G zcquy2wQc3;Un^U36;9ZTRC3FWySw_r`|fzg#(}Lci6A4ccDH`n)G~Cezuay(J~zM9 zd7Gjlp)U+6Nd}Sax;AlEYj|kp@fvsegdEdt8n{5c7TdViZ5%?k1^~T`;WCF~(yEw{ zRO>Y%4mg{Jm8lmaRu%^Ks8=qGNU>N%S5%CTrj#^Vq7w0W-5!7PDd(9t@B!9F#~32^ z7?cUJtD9HX<+Ds2fjJKQD@;X;IbUG|Hlx-DD~=$KKXcwwIc+pw9ICeOUSIw(ekvbu zu)t__-B)lx$?(If=D?0yHz4f8F3`dV$vilkHTQqIk%4BbU0K0yfY2B_?|zFXj+h;( zY;ym@!2|Azk{Ev~HR|;FRiPb$swC)Oo>KF*`}Dz?01`X=42lNgqV`^C8p>+1a>WGg zE^D?BO1neHvB`I%ls1L-TpTK zK%!&ZZbK76A+UCT&>x44<-Qy0kgn|3#&*c34B5FX9xjq;Z(H^epj@!{`So-y5cvCVl_>-uZ;a#sdv@Ha=){&>3e zKN-gCIDQ&-c;C3iU~>$m$;S0fHZ9bNIlK@LSadGjz2HT;N-Y9bBZG6^jpH4;N#0Dc z8khSEwy0sMj*(bmL7Z&(axOLUuu_hL3Q#i@fFGDc!=~$VYG%>H7gRrP9+AL!$AGus zA=RzMQp*JJ(Jgd|K?*+eKa@w-T3s-&kgy}Lc@?d2ZVP4N7H{1QS8Cgk=Qf=!=Ix>N zXAK6td5F_JeyXjOR3k}r=mYdVz;e^%B5@>5Fu7{W;Hl% zcHy#qGj4ZZkr9UyF73z5UP&~IBVyFbS*|m$Z?yguOOe3Uh}&BbeRy3hTdGBwq=+H~ zkAnBHW?AlTrQy(FAfGuNKVC5#GiVOD3TPkQWX;ha_z8$VjEs=oLh|iAc~83at4y@6;;*b7sv#5B`A4FGrsjZ8w&68VQM%T1wEPK851 zzCiqx@P#7cllrVRwkZD&Jh#Bgz8gg5=1a;E!mTB??t}YPd*D5>qCK#==5T3Jy=lGL zJHXtIhEnh=b(T(~k^#UcnYwGwr8$@|RBnZ5h3@@C7yUsdIfQ9HRkjbC`2EaDU?>&7ni%LwG-Wa(Y9sEDXDf=iMr|G`SF%R_o=m(B_kRze zLT1GZrbSP8>WBolonxVUU_-v1iOJe}RE8;J*(~nV1)I}3S}KfD2xhob?n~^_M|?h`^7`s=ydeKg$lHc1b0%DB;lQxRI-qRlFfVWl*m-Rh zig)%-_2US*oeT7<^qOX>6|1;zFnAvKk%a3{W7;f6lSk$=Ij!w-Z?`&AHySL*aU7{W z{#zt8a{xda4X7<2r$BPR1u}pVj6y6RC0p`#8N{eIx>Thv+j6!<@4>5@kqXAnL4?>4Gd`(nS7N4iXA#%74%|| zIAQR|bbOW1{2KxQY!UyUU_X(;ekO-UbbwLd5cLi50Jz&#^lo`gdiA1wwbm1(F26Q; zaOBsr2c85j>&J;YBX|uhit9#tX_BnKWUmpP24ah69(lF*s3O^PuCH}w(-oxPfMg$Fgql#u1_$T)2!ue{{ z9YCCfc>U#cS-fw2Jcf&lNXUy#4zxN~s#XXfMM(<)iv0OC(1jF2kP@CuA6fW2F7=V^i#mzKT&@U`eqqPtL%_sJr&QRwJjSvN#1 zI?#S1klmTl*@kj2D|=n-0n#|O9(;sJ;Y z0PvbfOFE&&_(4Mp$Evjh>0iKjD!qAQmFiLqZXRVIXW%yhk7$KICqPC|Q_UF#B(WOA zg~1H1NA(}1Z_UV(5b)uVWcU~`C=&SYEYzcSmgU8F6B0fWxPhPV<0 zHm@wNLPHo5;xi?t#Mc$0ISrG*cs5htcBDA)(kzlg=TN>wR7+}~F-OT~;>)Z{T(x1J zkx7>{0z;T=5WFa8k}t@c-$Oxh&rMJ(rm-oTv4BxKM3$w+T_6fOUs8z|-x%)*JVwGi z_Dyy2@Tio&C{cc}!osu?`n5HNXL5(>1}}_F4r$xL#wQtJB3HqPR1}Px&S019 zFiB+Vz@%1?g8QyGyYy!!-wd97U9R>N?(mziuNggqCCJX_Khx4Gvv3Tv&qB z-dJcGs}Cuv5OQMJxk{7h3UDnSG|8C~k%B?t&{>e0_GKF3g)6n4s4!(vmC z;^Cmv$#U__fo3UsN~Otg-J^qda1p)7CotD2MrN+WSoUUvpx|aSS`#z4luHW5MRAK0 zyY)gTkS9y!io6>>m20AZA6{lW3LUE7BkNXmLa%YQ+U)WV_VS_6Mf7Quj$KF9MF9E3 z5`wRUH-v@e!U~HRgd*oK=bm5ie4$xBv%RAgr~x?z`b?$pHb2iF>e&zG@M9 zlqLKGdJ7#Tn>f-BC^R0gG$$;z%mlC)9a3>Z{Rg}N7((=#qQPM4Drz|pGsF;=kko6m zpWSvC1#W1in!JRIBqYJO-Uvj37XuAKmSkaUXCEZ20LBU5hM+(tND}@E(cP(c`Gt&d zHnuC=B7#41wx&yqV`;)kx~AaesAm}kuVtdA?}{O#4@}-WZZ%kKiOKry7KxHnIPV1) z3(m^iUGKC$)^h=R0Mib#A9M!xzzNCwQw)G!GISdK1srzPAaN5JE7SE1!7tU#6oy$O zg-zY{o1<)2AXRzaEIuM!6Pa6rF^6!&Wpmu~ENvW~q+1>F@2jVg3f5s#45Mu!k}#C~?7 zKm6wc8~Y@}pQOn!of$EI;#hj6(+fXRoVIQ;4`yyO%5`b!k@xZK`ZL=}G#PDBYcN6v zlQSIXs1dVbOLOSI9n0unnJNO=~^ z5~*qW1s*U0f> zt>Q1ps8OR{#*o7a&x=G$0vvYsnqdFw25RddQOoW z2aG!6qja7{7BnF)|1$Dyq`WG(f3~)m2u+|lttMlWxx}n}SD2y_y-l{#V4pLc9`go7 zGr|I#)~W>umYTYpNt=|;LXB}A7i)4DSAtIDC1O}qP<4;M2#%qpDvlNcU+oh29|E{Y|l3z=PF^8mfa zow#@hj3ghbiJ^?czsi*ce>!mLuaqaUZqYA}7ddi4%1uF$)Yll_T$>O+m|lkWJTX-M z$~tDs(n}LIiFZqq)2IngIo8J_#g-Y1ILqQ#Jj7Kqnn7=e{C&;8Qf@ejV{pgt@2Sb`BXTdcXh1#;JG3QzFnz@5Vc$6% zS>$c(@7*?>nJl3BJGKL&&!5;-XM>KMV_5`{gTb~6KiwgrSald7HJ|e(QrX7K>>#H$6Io`q^+IAQ1q(0f0q)rNhq|F zw8qw#7hgoDwJPBQb^zkd>YDOwZ4Tz3X! z?y7mhXH_krf7Jx3785~}K_!o5&OfP6a3+SQ#Uz&HK-mQM_%tJ;iGE;Pz{U@r|$^`FD(^){g0BvWm1BC1>#u*SIOCc0Xwgo1^j0Zm z*aqt>^hMyqX@2EQwOh~)lPpVPld1441h>}JX-z@ac39N)*iyTT?g=xhtFV~h@26Fz zko|HXL`WQb&vp9v;ZnI%nSGEg>slIkd&42MU~g{-Y;++_c7`yfXxOt^d8!lp`AMn0 z-!m^jQiyb1<_O&{v0;HHNX6C4&=Z%WkNrq=LSvjmCw@{FJ9bx6-Zt*3i4g)MOW-YV zXZTl2`%<)PEb?IWko@hnX#U_@7mClziM!7_k&N~AWIw#zEOes8gWpq68~z?J$6se# zh{}(Q&88;>9*H^sr1X1<%)LV?KdU-Fj3jESseIVF4^QSF~Xrl~$XZ$z;SSH5#Rkv6ijYpxetE!!u*aS7(;`+X+kZJ| z2vqz?3|a+`-^h57@YF2yC{ho&&b1etiU)xV5OmPC`SQK=klANXJsUEs1gzO3;7mhl z(HW~o4iZQF-t$`cNeF5a#mFVq5rTN6U4ay2dN%{HnTt`5>b>A+xByn=cx^C(3g6IFCl8YKcHG~f9KD+04 zIGdo7y8CU%bz^rxZ__7F<1XV4qmtAg=QqypxSFcYO-CgpoKMDgeQ z6{0bD_XZIJtC+kDYDkp^G!jQ;vSib|lL)2H{%JGS6s-@~okLH;PC{~IHp`-@~c4GRZ!REST^@yEso_A7t^cZ4~wA^&uRSCj)@=J-7CaZ zQg~_aN+9Ess;PWh<;jU_&-%Kh_|jOvHc6Myby7SAlOG%nj~otdd%~Mw1YJDyxRrkW zy?O+~+i}mSFX6A*AhE$MDag;H>J_Vb6|9E7Hk%Ao%`*pJ3j4}NXlx4u)??sC_2w=vdwO>bB6lId|hcVmAzEK|g=Cnvc- zySHSJe7@^@uG)@5UqAb0PnuHId@(}h=ge7bglP~j9q?du+g*|rIJIe6UuNk>W&CBY z9gPcglhI7=8~p&oNh7_;Cn#&U@ULX83{ybbqt)+xkTtN{?|H8&;^)cAALUnmpH8#t z)G0OM^wXbShojle*lv9Md?Y_#YZdZ}&o=}4*b24>eW$OA6|wp!_jlG0L(+*e)+#Ny zcn>33H`7i!_j(J{3-!{+Ga1B7Rs^+f%O#2{d|$jyj|;~-akGn5t@O5f9v1f(iM!hU zDqjEn5ZHG+P|Pb@Z@tACTYZq5RotiM&v(t&Y9rdTR#~-shE0Lv7ET%1zB!Ec$Nl7m zf$hseaFtGxp>_90{c$x^`1RhnVN@Su_;OjegD11H%^-(J(em1XEns)^C+h-JYL|Cr zCGxN%LG!U(wI)IZ_B5i>=@AQcgU?Hyb6`o^&w1)7;TFd>@o`k1oLc&T4=vlu3LrGr zaQ)MxYHLY4^1{hd5V_vIL}RMU-n&p96if>FNoBe zuhJOndKO83M>I#_`zd9}p6@e(7fot&%kW@0R{iU0fu#BGnZ78uM)pXC1Ut5I$E{{I z{hZE=>klP9pUJu~!i2)x1(GK6v+_QQ95>B}!%f(uZ zkut~mdZT4|9Bc4)ajD3yk~{LjHDj*tqCrqf;9~D*m}C7fM9r)gz+1+K7*M z=OA5uWo%z*#bQC=O%;bLv8uA5$Z`4Z9v7W`LeCdkup(pAZ1_rNtxEl{?dOzHvwOht z$~AAmxd<22SKZ%6H-&fHNbCL=MEuG8-a?mjhG1CtD}~ZioVxgV46^y&eQ-@p;7fsh zAVWs8L3Qe+>|6f;rojhtu=b*=>$D(rYz(w??MUOd*0L|R&$b#=IltTHo^ua%o1s^# z(JK=6R8pMHBBDoA2Co$ezUX!z!^}}{cpM)@ppw=IdCguQc0AS>%cV1H8|N}~-TDUp zjjrFT+r52Qv9JBbn)_85Q}Fu>tXdsem9UNFJi7hMOTWZSk11`JTB6S+@A5CH6kV3v zXZz_i@n71+9UR_|0rn4Uwkxj#b%no}(=JP%%YtMlZF$`e>l#|*wU0V2<`c6jd|u_A zR_r%9{L_*jM!MQ1mVNx_T`Gcl6d!~JVOyO4baP9Xmur2l>M^BxiPVyJ zkDsIz=8MAj+~oY2gP#H)ffgX={~{22xZ{8I1zxl&QY>|ED*1V@Sg`j~(R`8I*2(?f zyH4x&G=ZOdZG5u+*F)OrPQ&^4LRDnEAlN@4PoLiN^IjhCF|bsWmji!xf&nN($LLLUF*C?|0bgaiS%Zm>rV% z_#P4d^Hk^^ayKtg{b#xG0}K^+9l(b0UjSbvO01`8;Iff&d9><%4?jxCu0At1a`goWJ z=)3CrMu5Ks6i})$SqsZVhxGS2 zXvl}=(D?%(Ist`zf9xye2O6vefZTICoC3TOBJM|thVaR9?*NH{8ZOldOG)OCZE4kE zrNQxcvobt^$zr8$f88#?duN8E|JTXeDNwWDy{Q0++}pK=%T_%`bZ#$^lmMF1N4Zu@ zZ2FssVxEXFhJxP;_$>UU!P=P5+Rf9GMZHK4U~{JdAI0SkZe6HEAu>h@aCKs}d|SuI z7=V}L%RMW_9XKdy9GlZBw#8{v#QSPsi5Fhmx3_#@be7!f?_@fQ;c9o_n@X<0%gg;H zAhn*)6!f1g)zqz*Hc>>?;!xU1P3;WEM0~)C>dwWCvtwJ{McP6PcWnGI>nzQ_4gZC4Uy0-e%z#+~NPPxwA3bxS1t_x|DQ3JxMA@4tb!gY0|@4!D9qu_>FM5CbpF;a=No{eDfTfMi@pozQ@zn>5Ze~0 zg0?VDW+CPiG)!>SH$Ydip@;aU?x`zJ@1yJt6PJc%_youpudlB*aFDd$OI-KIN_h(Q zC};tTivZ+;zFPv|r6CsQ1W4=fI09aq8Rvg@#9@F!`js(VPn8CkOpI_sLP`ngKnJk@ zIlh7Yig2J%2GXLz>I}D3t8M-O{C2?}qHu+6hupSWLdRpxptR@wbD7=Sa@kjS;D|PCAC}k2+ zhMPr@3VN<(aw>%8@;K@pPG;jC5&~8z!2MEW2&@gqh1%Yv!eM}b`}ey3^X=|0CM-Sl z8foASK+)6Jdt4t(0wMzmzbn>7jvO#VzJLL!$Mf-OU-XUW>hHSX@iDLt0bv!?<#|TH zsNrr3qc@;0xpZsV)M_I-%oAt#$^YCbM}zrqZDY zTLJT-`}OGrI1iJm$#^0DyfqfRdd7qO>{SNGkEa0gN>( z8kqd_8b8+REde511OJU!pph1H@A3N3xYK76(2;d`nw>V|m9P}8adA;7WAQl;9-=S@ zV{or;lw<+`V^t}nt)Tx?tl3~R`8NXtgOT%<2Do}BKsbI*I@;(Y%&gLHQOF>B1+IS^ z@AmcidfH+PxUCz$o`7a_@4;wnK#}M>sJ~1aVb>iastxm#uBrP6^GBA%?}*KFTQV<$ zH04WtvQTvY?}+%1)9ss^=Xb|Hh%0;jo~Ci&4qp4W- z9L%2|`V?ovSM;d>2hfB99A-l6uh(eISm){K>4eEwKzzEsnW7c{0nmG5dz3{A=`7L` zI`v>{e!wch3r$@E+Crz4IgXdIJ4v=3h4{_i(>g;>59l|zc|@i)1%)`QM$c2Zf{a>p z^Hn~Xgvt!yuL#sb)dFhzx-u~1>Ho1wc;>1h5W#){j7t1p_T!UzygToi9tVU2I#N=U zMUZuA6bT2AwXjhjYYVC9*rTFR=Pzpv>Mf#xeYqUu|L--(&}yZA-!7hK7SJ<~qOpIl z4u|PrFIK-~-<9!9mQn1X2#f>v!O;?&%bV@~2&#kWH+w*4*Ym0r#d`ysf4YvpstpMX z%*7La;iTG*1|_;|o#~V2R&F~)w{s6jyaH2pgn-yp;g73?XGLW}hW4+g;4o_AjgDCL zc$DjLydS3x?%atqX-R&u>BMaR?09W(mNl4`7{9sFz>mxQZgvFp(s+fXB6&=u<`~@U zPfa?)YG^J)OL(F$nv<^B%O!ly13`+RHR zz9lj?q<9Ft1$Iy56A*qfr={0L*pmri;$+>^H$G|P1YUT)9!!tp^!S}R{;aEi0d(MK zVnLpEv)AWGx;~pcZu>jn<|nc91ix&M`um^~@?gmntO6D$Sh+a?FK9%5ydr>m{#0uM zAu9UT8}erHQ9G8P z)Fi!E#=QRBo`HWI)H1$Jz$W+sPpI}wf>9(P6Y)@1EWeHg0q^IDv0w_OE*68<9*M03 z<-r|$^)lTRdfC^#*}q*k3g(>+^am8Q2OW983&B%}D zL)7zQ^qJv~F}M;&&e#8gv|+R(-v~n!$WJ9I8{Wk|&e3q{53^olBz2V8tMl6q6PnB+ zf75*IasaEiJ8fa*EQEbUWa}S~lf_F9ov9rD+??-#PMCGhN%2{qYCq{KRAtnR7T>(n zXLjj+U4fO&66j5DxR??kkZZ@uV+|Zf$wU5*Lzh1+r#JjAK-7Kv6W`q%H$?EwmD}^;?)c5^bqclIoZeS^0CJ2b zHWm@zvZzh6G&~F>w}b}u$jJQbR?~&~b*Zcv*#+M~0WMj7Pq5(R?1E zHpE~N|Bn1xcfgbj&`TEP1rRx~o?hQ8OPCBm%l9+2VeNaA?=+1w;1fZa3Kwgt6BFJP zC}_@r+Dh^l4d>8Kns~RBz-tpZV{HCgPN!MG5fS&wZUw>J4e)2FUeTKx*HiPnw=lB{ zu0Nc#H2wwa%04U?qjc2C6Q%1)*5?B5?^HWuv7sQs4OVmp40soR?A{(jzW~&lVTa8T_NJYb#x@h zP}GRm&3s#jqlQqD?&o>CSUW@m;5W97h$WC(dPR)QA+#U7Llaz7bhC?w`zTW`(l}iV zE3b_l@HdP;mSnpA{>-|EG0oc-RH~w8UL1LtM5oF~dwKl#TDv7Lzzdh*Np>%lyEm?8 zYkOP7ax4`v65!GsjEt^i)=Wj(IiG*qNiT8U?gLyVI7!$S_!CQKtMPz@l*X)&_AhKg zA`Ee{OarcEKiBX_l7tPe)Nf(oi#ohtGJfla zsw3Ol>J9OBJ&Zrz8(69`ABx4^!Eibz%9e`h9Ys-Tc76h)u8>I6#}pcmrRw$7M%xg# z4^wiNlfugn2LUHqmY9jC-Uz~3Y^IQ1Oq&gdqEq?|SQ+hr8h^aABV;pULb7w=el$}c z?0dJ9QVrn77tJaHmNl1FPN$7$Kwi&gV7{hcf+Hd_n6<$eTHqn`+0l8e+4#Pde_(Tc zmaH|kB-O>(dWr2k*l)t3b^4E5G2I1&U_F8krxs>f2QZuCLhb;@UeQ;bOdB>m&+P=* zP4vC3rW#!WQp*ylQ9awyH}0` z^#~>3BiX)5U{tqVXi6++0=d-oVJk2Wd)Xa5U_Yz`I(X97TCrc1x^8blP$R@bq1?7} z8BUu@IO&<_sZbLiS=iUzWk7JU5#R|`TaCR_F^Vq8_>XHd^I6V7vy*^6kpOOa4-nNK{_UY)wx=y4g)pz-M{pSjv{=b!~5D-0Bz1%8EMywQFQTD3cj@UPKyNJYAR7uh_H0%jdsXS&2z_vf3KmwU12l5k~D zDzspyS@6ZDR-(ZsY4YcLaT5jpVTy0+_3;2rBSDW%W+jn zp9opPx8g^hkbm?b+)8NTPKr+>_H9xabn12Er;0^CB6|oWAqirQb<{c~jcv6bt;?V7 z7fQ+FSJ1PLWREp6BQJ;^9%c^*fAgXmNqxl7cSLHj2oJ9dXCNXbCQ`OLu)9SUAm3p` zvtyLg?&V4uocglqKYV1j*(H1d(APa=V;4g)Y~dJF3uIsLTxsy@?Uz(0N{I!YRr2Q; zJ_Qi5$eezI2jyY$ZUq6f`2h#N=Fz%Wg*JPt>!nINZ1&FQ`@W zMF#gcTh6fP*58!mm7_Z)=r@wwV5ya;c#r>K`Q zVnNU7;0J8;mQuT4<cn$cdi@z@F1hyRyc zltAZ>r)z_htso>p3gntuVD?uQqYl20-_|lpy+iT&6jDQj18!KQr~1>BL(p{7$8wQYA_&;71TZUDr7e^1!SPvs!isu_Cu?4=| zE)B(HH+nG@*^Wn`o_BVBy(mK_{CkWl{q zd&Sb-Vusc!cYE0!{LR^3tvVaMhLTm5Ma<_{*#K&VR5Xn`l^NB=EcV!TO&|i`bN*<+ zle#C5U8v6eskCU%k%GxU%kqCnkpt{#fFl3YDPV?zNYV-GN=Vl|uiF{^!l z=naWbLg7z|ZQ!_0Hx96JBAn3bBkY~w<15DmvK7U27N9;vy@DM-$TEJfXK6<)(I<|= zo+h4@u(}zqF97+r$ta;x+m&q2nM_W%FlRrdd0Xzf%Tf~1F`3~g4%@b!$3M$w?Dg=D zL+m@pH6jN#)EM&^xROoqkpYx5eubqppaXHeE1nDXU4K}}2wC~jXoyr7Rmq!?-I_bS zE_e9k;n~C4Yzr%;0M=~l#H}aE2}`1K$(bj1o>aHNYTusV7u?vAQ%VtF{sgL|TzXJ^ zHzH7oU0qxrU;mv0`zGF_pGIi6HVu6;QDh>KszW~y#w!q5fQfcdMv{lsP{ctJ+JfHA zL_$C`l1fiGoFoaw`Hk0o14*(ljm%|rLrkPq8Fx#AeWbk-Vy1rIK5Vl#d}<~{ZBez^ z{IEY0;NiA|f>;rduo*(FVS!?_-?IuI7~m4O_%1Pf2^W;~F}{5>%Gqgz32Cc;5FHZE zZ!6i;pT`k;Rmx!7fJ`PMU0D|6x`9U6`S%1H@X-c&GEIK2p89#2H>z-pgw2?B z{1Faq)}m9|{z2$g8Ac2X^q>;XHq;;xdVw@Mc@XQf!9|+${pb8b{*(*TJo+5HtjeW# zkYbuM8j;R!CY69Q+0Sx&1<{h7eKHt>dK#=85qiG#D5IHP*4gxf`EqyI{7_t`Twn-I;ahHa$D`1zqIX zhfQ>^PWfDcuWe%R6VN>sP*Ge{i~xrkjLF)iK}(tvm_Q;t>NJxtomA;{K$Qu|ElND#(KUZleRa7&()Y%I;Nkf(21te}=RF)vbA#PDsE~5u zP$&B%5=uW+;281IaX4)l7$ohO4&!+Tx9d==p>^Z4#eE6=xevlfB{hV4Tz#F&{aq-_ zD76#n4AeaVzRE*p_p?=DZ&#vm!7UBTtse1Jr<*9nZBl2ofsr?W1lp-UgOHkt4P2}- zZg$}RhIjc;=lAI9_p+sJF%Y@kT4U7eoFow!#BBF~JZr5qG+k=kO+pf18k}(JA{yFn zd!ZA5jIR3imuM1YJY*kCi~5aX9sQJj{xpgqug$@z{zAc_RFPV4DIXBHi5y!LVteSn(-EWXNlBIZ5dATJC1 z-_3E=%w*z5Y^7ycAdFL63^7R5>jy8{-68W8z^M&KGslgF9^QeOi^duWKj80s&+V|xraLzPkdnFV=CA;d(_b<-_6F?H8cm$UlNXt6 zB5ZccwcCeN#yw~FgPCT4j}-9gdO$0uv*fbVY*{KxmzpDCNHK9r=dlk>_aIPx^ZrBb z&Q>JEEG-3#|4XuJDobj4SWVS0TVGNa-sI>;3D5vny!RrzOn!OG` zqm>7!PNUi?2f8O3Ym`((Q-W+J>hhBk?sPgUDOR;{_v;w8(1CPYzzab?UO-kT1c+YL zY(NeJ9wuP04~^8ns0kNJ{)7)dM&z0kiV&|#jT)`!y1%<>9bPWLO8P!DI@cUlLXn663RJ_iiYaCDytI3~ z33=sLp0mL6We)!)ca0dq+%swHTNkj{Lc-4`OOJ^;nJXTD*e&z1tI*>5 zVcH-5o#gdW*0_-wyC9y~u1hZR0lz3SPc_X}5hzRrx&dGng*aSLqEfs!S_ytZ!6YuF ziui{E;Moxw9`1*v%~{pUDedAysXM)3mV^5z4!1t6=YI{ATg1B-*H`;J_az}88uWh- zXqzkoyf7_iM$)Nl0%SU>JF6QTP}TW^Oc-{m0)^{hKWdG34KZP62*%1amK=?#r?dwL zk{mq0zJ9jKE$tPBv^!$2oS_P9)E64%B?aYe2^mh)?Y$ev9{(Gt->riZqX053*?1Cc z&`!E|b*`G~iw>BKDdR#76R545GSfi%*#3E4pi~t8b1Q_S4DzzU9s-3okl~aDz6CgA zxJ)XfLBq!(TNFeu9RfUluCOnP^as`{a2@her7q`CZK<{(qE2Wq^z@y8`XKX8neY8) zsRfYC0-Y6sPUzF9(vS$kj*`CCFwPm}-2I13&c+?;#CH*r%5D`&HKSa?<>Q=U`BG2p#(>X!RNuwSvS1=s#ww~ffp^wuu?Bk zxP6M-sZRC4yu5~-rPoV_YiDSo;DdH!ZN^~2V(2LmfA!Aj)nA|vr%=qWn#}Ti?v(78 zi4*N*bTkcwL+?R3c=o=Yx3hj?oM*ZqoXR!fSnUOuI5^ex0)~zA`b9XKZHnpECiekX4 z1NA0&Nk0OrWb+7by>u9Fx|oq1b?IPUf_poKEw%HV^y>qLP#j* z`XN^YEKM%S3~63!v1H3FHs9z}3u>aB2gG388|hf4(ifW1X4oMew6M&w`UG<5V4bT} zhELJkjwmuQlM-am?1?kynqJ{_U*m~6+rOL}F+sy$F_I9A_=Spx5n~yGGTwmvRD7z__UYQn#JQ745iV0T#%`L4w;6%+6>Rq8Ti&a_zRm7UN4+Z zj!Q(<6w#8o;kV`J*uwXFi z;?xp9^$k*jKtkg0{|i6~XZdJZB5t8Ck_-7qN&SOtT?ua_b}Ks5^Wlt)p&ty+T;R>0 zN#8J!QXY3CJ@Vz!t2u%UuzKD!ZxFwnaE3PNiP?ZsnlpbK}Iy(#=w_qf6S}~Dr`am7!V<44w@bHo4k@~ zl<)qo`&MD~uZ>@2+Hit{OrJv$sN5ZcG#%8RO^*gKsL;$_dkmB--OZpI-YjE<#1-Gx zTM<@zdGMvZWF@i^d3X|)q@dVzP_-*{$jf``!`-*AP|JnGrDItsM8%L@x&wr3izze| zIXNK&a%-RJ3?M;M{Q_8xK&2q1`pRcQ4h#5Z>pE^Libnot}z4lylj&H2dDkA4B)zN;1bUMmNRgC6JO0J+d0aCoNCT|Vr+CF0T?!gVi}WkVUud)A z%GfsoFsx`-mc_M55%8EGl*9}$Ic=`Sv52V73hnmNLeQg+k5$a1(QSeX9mNqt%u||~ zxs*e!cR)M{XELvaC?B1jHNq^ie;`R(IzqHJFOjZdp~A1K)6T81=_VO%(95f=B85i8 z0w!oRbdO79dO5%Gqj8pbyAjM3vdrSp)G{G`x`oCUf5k0-<4Og9=`7Y_XvAgrWFe9K z?Vv|{#x@azpRVpa&t%sTZ}z0QYZLS;MI!yDOK}Ahp;8M@S%RQ%?t~hS#r}Hz1f)b) zWC`R0Yw+<7jlg{yOW*(pg(<>4r7&34PeGzjZ#`}@W5u!E@yS{a)IUym6iF)nZtl){ zR4u8aJfc2Y+<3m9a*y4tz<3LCsF0yAHtvmw5$|nfWU%Rohi;)mSN3o~yX;g*MdmQY z;^ja#EBQ++&$8kUq!F_+EI9~2i>9_=t(l@5=ED0>y(C?ERJnDq7E3;QEUMZq)q0%l zhLDV~*AFi)rj~yS2z?*!%t7p6Qqs9ZS%ce6gQ^hH>Kp&;{sUCFZ$|ghsi10iJWWck zoX_XrN>OEuMl(R~_jJ9SN?piF7+tCCw06ndMS2KKWCM<-bVW})Myc50&FrjZRnPxQ zWwDI2uJ;=+$7yCQ#)~Gx(Yr)`YSodgV>Ff^`);slvL36MN}bqN;nYZGVPTC<7{xqH zMVx_XIS!J?4H0;)Emq*tvXle5**LtQTf9k~Q3I6Y3h(fA?HbuHVbHL9jB>1XCSN$B zME^rI{J#^xZEhhoz2(_rvRI2$ZR&Y9YawwM0L%DtPE-pE8zV5Yzf5owd6EJ*L8HK4 zV;(l0onTV9(mR00L&mnUa;NGfLDK`feEWTK#e!%|8klyhwlnnmIjX&#f#%=5|1kJq zU&LehQRa}w7kPhl(~R>2NGkcu#MGLE$#%&NMu*jsj#=Yt|A-{H@_pF_r8TuiTcyp7 zI585UE4h+ zC}MMK3bd_p8*O#HoCZQUgi^fxaRn>%v!yZlHb z{2_F9n=Ma8JC(+&SZ}#(_aOwOy4<&14}UQ7dig$-$H{-hymk5aGidCv8SbeS5~k<(4qqL3Q^t?A=A-np%f2p6V8HgT7z{wP z!k8qpkbb-Bziwpwqm7K-hj97%IgLf7rzNieQIo+TzJAEH=coXSG3&ecUxsqLyV&$D z-|p8IEeGLvIoHQET*lYp(#k(~IBmZE4>+utUJ;`;3L*CJ`@;-|m4AB0sfmRHeP8Z- zzKK^b>-1H+E#gTT^B*m}G)m;ljcA7diaUBQcNg7LSDkJaG&wJ5JLi;yLt-`9EWX+M z37W)9buhTOPee!)W~{lC-(;#4b3xzrHx-KGX~G*%Vt(!K4!ey>Hi%k< zdi)lL@sv)6^e9tge=X`9c=lW8d?$5nq~lJXNhimswN5w<4P~{J&tio3KmLX-ux}tA z~yW4C* zHVt0G;r;SBZPfPtWe#^Yo3+_&g~L!N@WRznX7A63um2t{{G7v4rM3y6 zvd>#%!mYUeH%ElAxn;5G@)uOXl{AJ%yM0X#_gQ`K**sPq)=uxWzw`15>bHG#ibsN9 z9*9n>_&R;}Gv27@32A=pmn)52ly-G(2VIv;7qYjWX}mh=205&Glvzw)kIe$fwB4&x z>RJBV4^vfx(rFS*%vOBPIz@r@4;hCDuASM{kEfbdrkNS4K6+_8&quZyY}Nvux%uoC znecU)+)wv5K!=VlV5s-mS+mqm!y@E)_&EI|iljSqAqka%fQY?Q`kd(CSy^9?%_*Zg zY$LAqa5BqvqiOoiPx<-s{ou=d{zUxIfWlF&Lv>uu&C%}wQMH;sSt&OwTC@fFFB+L# zunJcJL8y=(cQd6G3|pH`zU!7Afo1luI;`xK_vZ8Wix=b>_8U9FO`=y9(7`^4q-+GL^`UdasEVWpNt^>R6SgtbZXK;RtzodVB7K9kHUiN;Pf%+$6M@p&!%tt+Klgea=UyX#3-!4T))z(#fvAoXz)4j zo(V_J#Z6-*5sfh?DlS&IA_|sw(=ki1-8m5{e{9NW)5-RAjn!*Pa|w!2Q-z3I3+Xz@ zNedEY=5tS}?TblLVUGdVSGViK35~oJ3eQ(B^PBfi_*S>GDS|`e-x3xpgI! zu8(K1rng#TdJ44bw-0|`xoMjP=!Fz^y1N}}P|~S9YsmU?zE4m%As$WqJ=)LvSp5bJ zO}0Ula;@%$eQ8X_wUUQfkTbdL@<^y{lMe6Q0T-l;Hg`?Xc-r*5Z$Wl6BP7haZTMZ4 zKRt=*a@fsMzfvAE8X7%zA*E*8Z}wi`fMtQ5YSU3&_WAtzSv!Waz-Z)04n9w~KOFD) zMF5fWFK?j9WVa^CL@KA^qHVcMgOtd|cKgHQZFXD<*@4rLZF#`kD?P{GY5Or9#&*^D zAMJW83|_yF-l`E-Qyf=YiKHwZc%Er}o3R_qDzyFQz)lXb{s zm3|E@-x)5~5Vi`dt2x@lPb4rgx&2JV-T74DVEVy5_eFqce8;&PB`8DegZ&$cf zuL|T<7V8arxpa3|J!6rU4NnvUsF^vw%{Q|cQT{`W4as$g8T)nIKI$-=sH9=CsGyK7 z9?rC38rmHNk(%%Fx?H0O@&oCOuPx=JU7!-$1)Wd7KJv>VSTVC)Fh^ob0fnDSCB zC>QprCfOLYyF@J`*Dw;bd{s?c&kauwo`*d8sH}(JzZ#*B&84rH11)*KITjg>#c}`D zyBdijVMlP^3VIeh56pDhQYJLsku9Jh0%fi!!-vPAQ(9#-*K*fcfVM0)_e=LJ&=BF3aNbg&4-cH6BN$pfP)86o2{E$k5?|M6Bk(DvUewF`ol9fQJ zDJtq`1Y(GEawtRK{wrrJwE{+Ai(vmc!|BhXU}eL0sdbF<+-~pph#O-zRRs+^H7Z5t zk1ID(tFAq_VS#!f&TKf*1gfj#nDzcm@@wYp?o8gh<8ry!GI*%V{HR$bgFgK_3t79=rHw}Y$K6pRe6et;GYoN3p0DKxGV{t}Ns;7M^=b53ZWf0V_apddjl8^kLGjn~$6G&1Vs`u<%L+eUkQbjTwj(j_{riUiE+? z2y>Rkv)I;S9bkQaWIAmVFWk5JcYLRk&9MGqG!)FeLg^}|QYx!azx|vxlS#;?AVlf5 zC*0M*ZBhtRq5SeJmQNZqJtIzeZTam@z5_tbOq&Ayok=-zOHb!$EfTnD{cfP(4-|GnXF{tv=%{ek#%Ez({4pMPC6AT zQYT0EsL9+B2%>>m)u`^iXCln!l;>j;zXN#U#S%2anh&A<@l5>VV%6WZeXIH1?nCsd z-B_HH*gx`rjr`&M95vnQCpifOV9mU`(NK!xO5KjnTJi`>9oqw(R|zfHnw=XtRleHn zczp6BG!%efiF7$AFoW)fA9zzu`d!zid^bb>!Cm&&SY8U^>q^XL&XCsyWp_`3y9K{Q z9fbjWHVit#cKb)W#f~flB)=RldznC&FT}8MJ|U|G>C?!chqbr9Jsooyv(oB$UD^nH zP2q0JxG_C0_1 zdlXLfRZA8eh^>P-$J6_oWeHs^7&%=w+L({e#BW`cxRO zR}5&5Cy$ML-&er!O|sewg?wfxrpUce+jPbG@J#OW+j&gx*{)mq^;oQTS@^;EB&aF| z+-W~qG46z>PBL_OjQxy>0v>iRiGN=y&tDJFk8sPjH4_gj`y+D$De;-h?{I9hFm3$2CfKf_uXY6Cp@Un^Y1GK8M2 zQbTfrn0LK#+VqU?XyM&BtjFRJlFSd)oEWJ?^-Iz4!%~Iohv5~trk5pC9;4Aqi_o5^ z&M~N}eP33hgvr6Fe$rR5L5RmB+HA~|LLrwgg`la8m z*xCg<4eRWG?wss>Lf#D~eY67J%MsC|ONFX3#ebtpF*lJb2O<=Fgz3kA-<6;Vk^Q3z;Ne@Qia#>8o?p9pMbow(?b)Ptf zIZ=p(>;dZ9Zk6uuo!G(kwVdOZy<%1E!%Y?D#F&K0J82)@?>N4ZrIR;)f$tXf)CCh$hyXWPR{fWlaicG}k zcS=`6N`=RG=K8~qw}i*|*`5JK#UJJ?K`a4(vz?W7-4$=BN8%3m-(OT$M7Rfh&gFXo z8ux;>w|H~VrS}r{9cHi7d0h5^bOK9`HEl?wbUe-zfTzbcXyve3xW?nKM!O3EVnRSW zcsN_w2MB`zj&z9(XskIzp`4qIB_@=3-Jj{6lbdZ2G{`|3v0tp;>;U~&+MhrW;c%ko z_4PIDX6NbUVzb5W@21b;4IwW*%8E-F(5!zwE)*xhF=l3FPE2H%E%Ij4Z?y-MonTNk zqW~8SOkA-8xPXiR@Ehi`nvDXG`|(tPWC8#j&}dYtq*5skOlTH~fa}aRnpILOW1yk~ ztqMSPsSjM)zkf=lJh-{JgM|D3?_^V1)bC>Z4M36GySl=NHvohOW(sI3e>|369E`=v zi~Fo+LT+CO69xXt93NrL&;1@(8dmsO6JJ`xH$MpUqDCCj&;boq;ar| z27^2t^f4Thn!#)YBrhx@ldWwg(`ei5*8y9oMtdv=Y3d$$cLpjG6H|}xeZMn%;Ok@1 z`xCX5lKc^=TYo6b=690$R)?Q}#;_UzGtCQ7POsm<-M4_o=klY9@n$Z2%4&2EArD-544` zkBU#0lfseqb^b12{w zAf4&d{khT90{F6kg0Iq#!(~4lpWCsafUNMm5`gAcYqa~U=SzSOtyZse?Dh8nT&!cJ zU**z?vwN2JPsjn0D?J#W{r)|m+G2x$O?A~&-ywX4s1II7c#f;Aw5rjnle_{#1Pz_P zSL;6jLFhQzC0MHCN-b}WcJSm}qW*0haABy#LSz6QIPleFH2$}AA^|`j(8)|@GArv# zEFR6|e+N2@fYvR!-cUhOWt{D_ZO0bqqGR!?mZ~(J7^{q6NaAps!=g*XW!zyb?(Gf) zg;oOn(&UY5bt{g123Cuky~OQK0#m8NK;5(D66HYn=tcgbPw>8d`&_aNfNV{f5L+ftbRVhk`r`(m zvBazEG|_3*CX@TEAb&VgR2pv6Fn)l&7o|x*It4_Q&iz~SA%Yhts)Xzv z{3G$F?Z@Tyn0PXmbj>$k7`)S?*sZOkv8mqM-b4O~A}+BSKU$_g;j#`~ed6-6TdB1H zH+(ob%Vt;D1;)3xw+fNJ+GSD(`M}QWc#UgkNPth|mTBlSPX4>mQbQ9>8J#K=EtbY? z&kc)81a%FlJJ*bWQ*s2rb$3_y=ZovffXr3>Z=s(H0Cf<+ihGQMBx|g2*ctViN&=o& z#$dx7e{$6U1W_!8h{;sigg*f^d;ghWW9INK6#V#l=0CoyDuR%btC)v)JXg@?I&E#m zxVG!v-|E6+A zPBLa&Q(8;w9)R5H>xehzlB}pOQ1VEGQQ0^7R+wrLQxV&+_r*G7Az#>b{G>`uH{FW) z%}qovxSbOxh<1pQ$=NT3V|k6uY#2TN_wUh4g#$i0QupT`U*sn}V@4bf|HsSipD%Ue z5efO+l6(I$f>k*0(Esr<@M*7cAfYrE z#su+gwjdz!IL<3cA_g6|Q7`}xt`vGDG`n=5Ok@w*#U@T)2DVL#oGv^rnOOiG9;p-1 zw++nIU~&jZGT_Di$QvI9w?MW?a9DfhT1+SZmd~RDu3vi`!NevBY}SMn&HYl4B+ELV-{;wCu6Z*AB+KQ zw-cuPj2piU8{2Rj@^>dEfWVPG_D2qcoC+9yb0GQ#zW@cp9#JXJC_D|VH#evwbFeFR zY`+BI+(2|yoDmiEQlp(A^gd`2{;LW;uOE-Y8e~+ie{mu$U3QLqdwaVONQFf)%?IJ$ z#@CvK57DW%ce+CQwN&38^?_&pk#6DTH~tRx_8Ddbdc?{kUgF^ucpLBWVLSm7d5k~a z%)E)&`|9MLnW@{(qpmjwgl(VP8C3WxV2~9TaY&ZL(eST1zqoJ$|MCRWGXw#)lL<)A z38|;Cj2VQR8bhi`9UZ@6GYhHM!GE#DTrd~=fwft%cRWX-(>@)4iovNB>rE7s#v^G! zVYn6WetN%%dXYAJbsoqI%?lYv_q0Tk7p31A$@%{!ANv^uow+%ucUxP5;G(zR;Cx^3 z82Qw6Zkz5qP!ZwvZQg!v=IVAh7{He1aF9oo~0-*rCgnVNttToreal1J;h%FRx**gQCg{@>7Lx2Sw z@o;vvLDh^1fV^;w_Q@88j;8f97<9=7@!d}@yB-_5G;1=l*({F2&XluCioOU0y{{un z0{P;=uUg1f+PAU5O;$Q{QbM&`2g6sLlcaY^A8Di-J+KZ92f)RFfG4^)-~~Vz{}?4~ zAndisdvJj$rcY>roMyYvO{DW|A~_Ki-6mKyT#LPEX&$E?71KUISt+5i!ekU_6pKOs zS*rfTZmBRRX}{TQGhZ@dP9^&#%gGUKse94w7;c;uq9W!IYgZwShSU*>S}{jqbz}q< znp&|SG|oFcGMV~+Vg+=fu}k#-n=1&9v?8&Xefi02#BTN+PbP_gO{*qh!34h_3xqPo zkFm7Dc9}B4Q|UD69C7j8R|Ne$)d{S8AJcFJeUXS;+MMcne8|4RnW1I@rO4g}Av{?I zJ5>m@YZ+$2w#&i(+1XO17c)3BQOan2dJUIax22MitlqRQmDY47*Q~mBt%I zad8CQd%F)w97-Kk5nAFzZI6k-_v1ZqI2>1XUndT#jnBi}LzcjSF}^;UaN8U735ha_ zBsc|o@0UPvba57I|L6|^=qys=Tn-zgU?y9LP#DT+I<0R8>43Ho2bNV%b&6e#Ekx$%DyS z-RN+u1o{LZD+q2&7K8GE3@E0`&!(NfHIV-$92E3Hxr~3pIhL2Lu(<8mq2FMB^c+-3chH9r${K(<^*L?{Yk#A0TmU{aQltzE zAK&_|25qzAwB2QXMyQ@Otc+JKEl6b@v{+Te;szv*yJ_bQ13m0jZzMzOJtg{QfrLHq ztj$v}KpT8|e}fg71-4nm#Ej@c@y=aV^@b4a3n1(W2*}g;EI=O3KiW)@$JEri+eHj+ z9JSNnVRr)c>0HEpSak2;fFFPYv9OcllmCUN5x&Zbl5d0;$6DK#0ox0=!xL5Xcv}IR zk~svh^Lh}+1_5IK*BjVw6EzB;^!=(ub~pp1q|vI1)cu)~D(8Wq;oef>yDyNX%y8NW zDQoeilCNl|7oUSe`nnv?;t|i?vh?=yu=WaJ39Jbmv6A3?aA0(l0&+PVFt6QyA-Gs4aUWptoFR_bZHWrH6pCxJK1{nnZR`Dso238^AI`{--_ z0dG)TE_OedT}LmcCc*k+@d7E5X6yp|-IRJH5gi3%}R0kQuq1`fwWn#4C`u7839n;hK8^Of`n zAc@5;d2gLrXM~ZDyTCcf zOGZfE|N1dIig&H6>%6znu38%TD8JL?RUa+(8wBD657GQ)z{?T(1T3gBKrB&Q5;IxF zxAhzuO18le*$>-UmR=lMQ*^}(MAFM7#JHmlE4c5YmxkVxnR(W6t8;!RT;C~V+B_brf`2M| zO=73_j*0^!xwkhYpDpm!8yxcYO$MUj3btF=+FtY6PwL0R{S*$mGANTLic8nh1m&bt< zEmD62!LKHRL9p2+v0xT4-3D*z;hWRO+IeKxqt`^Za)xY0tW}F9AwnPs$Qoe`W4o!t zy5FEMIwjrBNZ8P!f1hi(>HYe+`S}8t`H_6UfyO~hGz@Td$w{YVLZbjbRij}~Cy-di zWC{0wD^WjEgBh2(;-6TTAHO;Y*a$PzC=*G^$>Im?OgxTHynJ3c!`96*z)_^aa?fG zb2B6O(DQ-I%`^p%Fe?&>S8PrOM{aSq+BbzW-DpNU3QfKrS>k)!o>nFBWpV2p)`&X7 zsc+Tu?;ijAta0qA`s8#E+PW(1w`XKfYO)#7Hw3a7MPIUd!ux4T^-anV^3M_9$Spo)Tt{%O($9df0s6`I<_f0SW*#Jp6KKHPL&B#d_jTF zF41S=4L1-y3;N@qG{QCzJsr%LCITNuuwOLd748ruEG26Z9Boyh0uiF4^ro<&Om9Vk zrK(4iy_Uld_f;oX!dW!ZV{2y+z<;S$vD=(3iUcBs2jl=3OYf*SILs;?`U~Y)3S!Ct zV#?N9fc)EMhza01c-VUEdMJsrEH~f?JyrL0>g&K?l)2bLEY>o$Z-J9K1gw0q=@<-c z>f@i98#oI$fC6V6*k4bXt4ZzRS+qX5s>kIo7@A?D;zfBNE%>l{BJ`IBTg z0iiiEzE9rRA89E?SRd$8#x;iGlDkPIk_&jzLdZ+)k=Ivq$=2$(ic0deoJE`{3$ulIzSxF*{_5Oc*2sq4QOVRi}#bWxQx9WE?x10Bhub zuccNPB>hsep_V#}X(KxkJCU)-JK!ygI90Im<^mNzTk9qj|NHwbXK_`;_D|xu6Mn$n zma-=SU$xH#zE~IAXj0JO{ZFU1Tj(%3SGx9cS-_X!=lGXB!_cu(6s?OD{%h}FX(TxT zMS@K2RA+k))IDmu1U`ow@Y9|O4|m}6l7zs%h#Dh6k} zM-MCyKXv%NItaCK!28#cgSavh6M?tocZF+ZJ4BmM17mY(7_xcpTow6g$KTf5nTpq@ zn;Flg?U|^^aj76EFe6pV5ckYNFZ(;2I<7ZHQGu`bV{z$zizGV6ZnuW7vgsAunK~m8 zyZ~666N13eSE<>MXmkwjY@~dd_N+<%o()f`(cO$tH=loqsKqU+sHqug>drR=tXlRs zz23iR$A0ukqvax!JSGx5_3zxIGpewCw-RPFVhL+z33?X*F7O+VH!B!kbsj=2qz(RP zJS!XWB_~%E)7S0BU8!30-I~9^eucrPH}9|UJ{b1|_e#4?<>U|UfJ<;3z9q<`%g2Kx z_(cd_;qG`@xe(`xlMpfWQF+ z$ZR4`WC5bzKt!6`Yw1_jO8+_$zLG$F1RF>CFG@`6AO`;DEidA_1bMjxMFq!=()xq? z9|4HKg(iYY8htP1y8znm6*DO~tVs7lkJ5XMV?^a@m(Mph zH?mw}@7cf|q>g(QooEBepo=hd6Iy@+O5UP?2aC2Ej`l;-xh8Wz^9D~N;Y#*}|6}vF z{Kxz^a5Lm`2!wf|Y|vqnqFlP+lN0kdI_3nYwc#z+EjS z?ihS{h(QV?4f97FSH@W-1bS?I5cVe&!QrrMYE1~qdrC@5@ntY$T3#m_Bx>TnFW^3~ zoCAd1Rj79FyiVOoAH9LDD)|87dXbC;^Z?L*m!Tpz+tV>&rOiysgW4uwhjL6U^$wJ3 zu0-zl5JO7W6&+Oz%I4|M$qRh`UC`ZK9<1GazhNgMww-lc;73GY;m`GMP1huFxh^cygnFlk)>sHnrem9@*KwfmYfbJ_eoql zbE_)>Uk4?EWQ1+6lJCzy%}r&OSRT0GPEwrZnihR+YZY}5QuGPN z;ctjREQ^SFS_pOA!RRP^8_3F~0r8ORiY@8;*$cPA)l7u6nv6izy9(DimwB9@whn~YB zeLbmeQNDvYj-f;-tkz(Yp2isTaKXKM5fgxgiCeU@IbrMwQ&5qU2Jg;YeB9Q0$z9lq z)>Tec#2kk)A__W`n8`Hs#f6pT?7$SmnNLVJr)_A9JufBdL;WL_2tEnnjbzI=&*T;FoE*#%Yy+i~kyw*J8+p@xQ4#&;=q8*R8&h#vE!g-vgw5%= zk+yGn$m_JxdqX`5WsghLj?u#F!qh@3^+T^|+4I#s%ZkdL+o9S~aMJ59p)|3_yg%_n z)dx}t6s_gxc=<;6;^0_gvvX(HU_l=zrJu%g!ExJIb@yNA^mD#0Itg*x9)|Jq^3otc zDuRuRl`3sTulqGsk|i6~7O#cxzlj)_u6WgGy!_>3GfV{$YCTu+BWq{| zJl)T@y?4@=+vrWC5Yta8RrcO!fuXX9Ow3DKCkqhCNI`ru&F0}bML-eVWd9-^BB|*5 zHSu2vhOuq6&dcLiS5JOvCdK^U_m&6fOA19#*vaYFMCZP66weQ z(OVx_3W0vF~%Qdzh7j+6vlT+5?ay*$|b!EXl%5<)q~@C z+lv}fv!UWj?U>lLR=JGinc8|w3nQGLK{z10kD$_2F{evp;b>_G<05*+2n{^w!BIJP z%>W3=Zpe`8Ds*sAEF}iQGfECsa;df%rWxim1SVQ0@;wl_Uf%iaXPdHvPt)5l?F-^F zQ5qxBiem|Zwv&#(pW(E(Wr(RYilVA+O|Obkw=LKH?nfsNU(=vC@<(eC*tJ7 z4@5Aaah)6@2vA)QYXAJZiV`KrV&mK!Xu>LJf2%2Ol|U4@%Ye(^5;59>LsdApieNL( zKbA#=xk*NUIFKwo+A{%-7TkD--wU(e-}VDkvoWF9xUaj)kFEi04JHE*aqUD7pAMMh zVvdc*4j-G_RqVw`)Dd!+m5@VliW+!cQAs#JQCNQWvzs?s%GWgEw3y7G%g*44n1uqR zA>;Y@UmWa4Pzt=3k>U z1ge1P`7@JVn30k5#dH_f)%*G_r-APvD2|@)20@u(Y}6o)AV_j3{AUhTJpaLEqugkq~5vV1fFA36bkn)t?QF3=AafupA@_Q@Pw;zvzP?SavoWGbV+# zGy?oT$rb-crfUMRV zDbM6RK0X4&J9ShE4jO}9f>hYZS#@^ypKz>72zXiotf2i?g#v*XCVK5&;ABM8CPjcs zzgtO$fN>J{SNH2RLOkM^!^5c}^jGzG5?MAZ27}vCd?$2; zcEF)m#Z8>J0dtqqK*)tMY4>7?k4@a?VV7T#_E@pxje7L@SOm#%RK5O#)o%Oo$0l|G zKVZA;nQnx^1mPc1yW6*DXJlsHK*B=jYi8=`+MIVbS4VQR9jlU9{g@c67bS01wjGJh zJWubGvMb8q2=?N#RA^7J7j8nfO9}mKf=tPg$!R~w&$u^I@+s;^kd*H2;^&<1vB^PO zFgCS={&_Kw9#I7U1%dzS=OK8>EjMMZj?Ra(bzo|_d3%dRVxQCJLd<4fRhrU+`T9fu z8R)MJmryF;WGjHhl@PT>w^3enUA)uRceC-o5J`2PH5C9xN+K@%$7$}JrM{2ZtqC_a z=Urmb2Itg8a7afF3MrT}6(;H#;r=28*g1iWz**ssPM=vn#stKH?E!m(&F4NeJnA{+?@H^XU%B(igMWkfg@d zO|B-rn;7RC7O{1E)KuwJYni8peQSQ`rVBICb)-e`)9-H|Xz!fwn(8VW6+ZxzD9}J2 zj%$)>33!p_WP>jxnZO<@@UpF~cT+PM(%CuMUoa-42TyQfm^fs`1o;F|Adn_O*s2tL zENi!-`5w9+GpFEPv+l7ys%nN;nlw=J_VXX)PqAl34ya}Wr%#cUiD@Z2uF9rTRsVQQ zRTdhcJX<`*^HuAU;K^cOs8unyftgKbeCN$7jmzKF zS_~WucK7;=ZZMFyb2K(rJK`}5=f2yol9Q(9>xOf4I9#K49%kY9t$Nj1IJ%_JTRq@X zlS#u?>w}DxWOD^At||QOiDJB&&g5v0G9YwzQt~1PSSJRu6^D#fi}H?s{c3T{A5iY6 ztw`o9@;*7_94j&wibN%zNr;7&>kbPWL5qxWW=ktVqoBmqUuD2qCne*g`6vo8%mP-D zgdOX_aQL}kFmB)!Q-m|JtGtutKWuEYN%-7Kf=}zIIYMu;_rHtwGdxj|zn?+^MPQkMRAkq=%{vsJ1hL z!L%+=E7oh52EVQQ#Ltl4ma@jK1(3tuA|=qZq6q>e*toMt*jHhN>>OnhZ)WWFtEB!q z2$PwZo~b+6hRe#z(tb>d$*sHedeV~*hX`|JrCBh1uVNT>PHFdE``(r;c~_l694qM5 zJvN>_ihE^8X7y~P^`*9!VTGLU+6?7iyT(t0CUG-mW_r_EhHTgfapaG}xp{ldP67s*oO%IaDre8 Date: Mon, 16 Sep 2024 22:50:24 +0000 Subject: [PATCH 2/7] Add documentation through Readme.md files to the repository Fixes #5034 --- README.md | 84 +++++++++++++++++++++++++++++-------------------------- 1 file changed, 44 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index 4ce7a721bdf..7d44001561f 100644 --- a/README.md +++ b/README.md @@ -11,57 +11,61 @@ To install, run `pip install policyengine-us`. ## START ### When starting to work on a specific policy program -![pic1](./page2image24204576.png) -● First check the legal code of the program -○ Model based on legal code structure -● Second check newest tax form for inflation adjusted amount confirmation +- First check the legal code of the program + - Model based on legal code structure +- Second check newest tax form for inflation adjusted amount confirmation ### Create new issues - -● Go to the ‘Issues’ tab -● Click on ‘New Issue’ -● Can assign to specific person/people -● Remember to add tags for better classification +![pic1](./page2image24204576.png) +- Go to the ‘Issues’ tab +- Click on ‘New Issue’ +- Can assign to specific person/people +- Remember to add tags for better classification ### Working on issues assigned in VS Code -● Create a new working branch for the specific issue you are working on: you can do so by clicking the right arrow → (you don’t want to be working on the master branch) +- Create a new working branch for the specific issue you are working on: you can do so by clicking the right arrow → (you don’t want to be working on the master branch) + ![pic2](./MyIssues.png) -● There are four specific files you will need to work on for an issue: -○ Test (.yaml) -○ Parameter (.yaml) -○ Variable (.py) -○ Changelog (.yaml) + +- There are four specific files you will need to work on for an issue: + - Test (.yaml) + - Parameter (.yaml) + - Variable (.py) + - Changelog (.yaml) + ![pic3](./changel.png) + (Note: Test and Variable files should have the same name) -● Type make format in terminal -● Commit the changes you’ve made (under the Source Control menu) -○ Enter Message before commiting +- Type make format in terminal +- Commit the changes you’ve made (under the Source Control menu) + - Enter Message before commiting + ![pic4](./page3image24275520.png) -● Type git pull upstream master in the terminal to make sure you are using the latest version of the repository; you will need to do this before every sync or pull request (but never do this before you commit) -● Create pull request -○ Title: [Specific changes you’ve made for this pull request, e.g. ‘Add Virginia -Personal Exemption’] -○ Description: be sure to include ‘Fixes #[issue number]’ to link the pull request to -the specific issue you are tackling -○ Make sure you select the checkbox to create a draft pull request for + +- Type git pull upstream master in the terminal to make sure you are using the latest version of the repository; you will need to do this before every sync or pull request (but never do this before you commit) +- Create pull request + - Title: [Specific changes you’ve made for this pull request, e.g. ‘Add Virginia Personal Exemption’] + - Description: be sure to include ‘Fixes #[issue number]’ to link the pull request to the specific issue you are tackling + - Make sure you select the checkbox to create a draft pull request for review/merge ### Troubleshooting -● After you submit your pull request, you can go to the github.com to see if it has passed all the tests -○ Lint error: usually can be resolved by typing ‘make format’ in the terminal ● Other common issues: -○ If making a parameter broken down by filing status, make sure you include all five parameters in your parameter file: -■ SINGLE -■ SEPARATE -■ WIDOW -■ HEAD_OF_HOUSEHOLD -■ JOINT +- After you submit your pull request, you can go to the github.com to see if it has passed all the tests + - Lint error: usually can be resolved by typing ‘make format’ in the terminal +- Other common issues: + - If making a parameter broken down by filing status, make sure you include all five parameters in your parameter file: + - SINGLE + - SEPARATE + - WIDOW + - HEAD_OF_HOUSEHOLD + - JOINT (Sometimes, the tax instruction does not specify all five filing statuses. In that case, you can let the ‘WIDOW’ and the ‘HEAD_OF_HOUSEHOLD’ cases be the same as the ‘SINGLE’ case.) -○ When you are trying to define a condition, use the where statement instead of an if statement. Similarly, use max_ and min_ instead of max and min. These are needed for vectorization. -● Some useful commands: -○ condainit -○ gitconfig–globalpull.rebasefalse -■ If you have a merge issue and it asks which you want to do ○ gitpull -○ gitcommit-am'resolve' ○ gitreset–hardHEAD -○ rm-ft + - When you are trying to define a condition, use the where statement instead of an if statement. Similarly, use max_ and min_ instead of max and min. These are needed for vectorization. +- Some useful commands: + - condainit + - gitconfig–globalpull.rebasefalse + - If you have a merge issue and it asks which you want to do ○ gitpull +- gitcommit-am'resolve' ○ gitreset–hardHEAD +- rm-ft From f1fe1ab1aa20dd133c4739cb6e2f51a0591bc413 Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Thu, 19 Sep 2024 22:49:58 +0000 Subject: [PATCH 3/7] Add documentation through Readme.md files to the repository Fixes #5034 --- README.md | 6 ++- policyengine_us/parameters/README.md | 65 ++++++++++++++++++++++++++++ policyengine_us/variables/README.md | 24 ++++++++++ 3 files changed, 93 insertions(+), 2 deletions(-) create mode 100644 policyengine_us/parameters/README.md create mode 100644 policyengine_us/variables/README.md diff --git a/README.md b/README.md index 7d44001561f..337e70ad366 100644 --- a/README.md +++ b/README.md @@ -66,6 +66,8 @@ review/merge - Some useful commands: - condainit - gitconfig–globalpull.rebasefalse - - If you have a merge issue and it asks which you want to do ○ gitpull -- gitcommit-am'resolve' ○ gitreset–hardHEAD + - If you have a merge issue and it asks which you want to do + - gitpull +- gitcommit-am'resolve' +- gitreset–hardHEAD - rm-ft diff --git a/policyengine_us/parameters/README.md b/policyengine_us/parameters/README.md new file mode 100644 index 00000000000..2eea8c61bac --- /dev/null +++ b/policyengine_us/parameters/README.md @@ -0,0 +1,65 @@ +## PARAMETERS + +### Types of parameters +- Single value example + - [USD Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/dc/tax/income/credits/eitc/without_children/phase_out/start.yaml) + - [% Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/dc/tax/income/credits/eitc/with_children/match.yaml) + - [Age Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ma/tax/income/exemptions/aged/age.yaml) + +- List parameter + [List contain existing variable class names](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/dc/dhs/tanf/income/earned.yaml) +- [Marginal rate Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ny/tax/income/main/joint.yaml) +- [Single amount Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/or/tax/income/subtractions/federal_tax_liability/cap/joint.yaml) +- Breakdown parameter + - Breakdown by Enum variable + - [Filing status example:](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/filing_status.py) https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ia/tax/income/alternative_minimum_tax/threshold.yaml + +- Scale Parameter interactions: Documentation + - scale = parameters(period).some.tax.scale + - scale.thresholds: list[float] + - scale.amounts: list[float] + - scale.rates: list[float + - scale.thresholds[-1]: float - final element + - scale.thresholds[0]: float - first element +- Do not use “name:” metadata + name: mo_federal_income_tax_deduction_rates + + +### Example + +- Multiple references example: + - https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/or/tax/income/subtractions/federal_tax_liability/cap/joint.yaml + - Cite both legal code and tax form if possible +- Generally avoid using single amount parameters when scale parameters can created to summarize the value structure +- Description + - Name of State + - Name of Program + - Full sentence + - Including period +- No numeric values + - Arizona taxes the personal income for head of household filers at this rate. + - Rhode Island provides filers a standard deduction of this amount, depending on filing status. + - New Jersey TANF counts these income sources as unearned income. + - California limits the young child tax credit to filers with children below this age. +- Label + - Key Words + - No numeric values + - Not full sentence + - Name of State + - Name of Program + - Utah income tax rate + - Iowa nonrefundable tax credits +- Reference Title + - Refer to the specific part of legislative source + - Code of the District of Columbia | § 4205.05. Definitions. + +- Important: economy and household metadata + - Certain yaml file names are reserved for functions and can not be used + - children.yaml + - if.yaml + - parents.yaml + - else.yaml + - Set these to false while your program is in development + - This hides parameters and folders when both are flagged, or if just one is flagged, ensures that users see a notice about the limitations of the parameter: + - Set them to true when you complete the development and hook it up to the net income tree + - You can do this at the folder level - [see this example PR](https://github.com/PolicyEngine/policyengine-us/pull/2583) diff --git a/policyengine_us/variables/README.md b/policyengine_us/variables/README.md new file mode 100644 index 00000000000..2583caa5aa2 --- /dev/null +++ b/policyengine_us/variables/README.md @@ -0,0 +1,24 @@ +## Variables + +- Update the following files to add the state model into income tree: + - [policyengine_us/variables/gov/states/tax/income/state_income_tax.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/states/tax/income/state_income_tax.py) + - [policyengine_us/variables/household/income/household/household_tax_before_refundable_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_tax_before_refundable_credits.py) + - [policyengine_us/variables/household/income/household/household_refundable_tax_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_refundable_tax_credits.py) + - [policyengine_us/variables/gov/states/tax/income/state_income_tax_before_refundable_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/states/tax/income/state_income_tax_before_refundable_credits.py) + - [policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_state_income_tax.py ](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_state_income_tax.py) + - [policyengine-us/modelled_policies.yaml](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/modelled_policies.yaml) +- After Martin Holmer verifies that it passes taxsim tests: + - Delete parameters/gov/states/state/index.yaml +- Useful variable classes: + - [Adjusted gross income](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/adjusted_gross_income/adjusted_gross_income.py) + - [Exemptions](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/exemptions.py) + - [Dependents in tax unit](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/tax_unit_dependents.py) + - [Is a dependent (person level)](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/is_tax_unit_dependent.py) + +- Add readme.md files to state program variable folders per [this PR](https://github.com/PolicyEngine/policyengine-us/pull/2740) + - Eliminate abbreviations on the front end + +- Dividing by 0 Problem + - [PR example](https://github.com/PolicyEngine/policyengine-us/pull/2561/files) to overcome /0 + - Mask example: + - Use when a division can lead to a “dividing by 0” issue From 8e0fbe0099e9a4184e57717f7f4c7ee09bd7cb69 Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Thu, 19 Sep 2024 23:12:06 +0000 Subject: [PATCH 4/7] add readme files to parameter and variable --- policyengine_us/parameters/README.md | 55 ++++++++++++++++------------ 1 file changed, 31 insertions(+), 24 deletions(-) diff --git a/policyengine_us/parameters/README.md b/policyengine_us/parameters/README.md index 2eea8c61bac..6d9d72b6369 100644 --- a/policyengine_us/parameters/README.md +++ b/policyengine_us/parameters/README.md @@ -6,52 +6,59 @@ - [% Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/dc/tax/income/credits/eitc/with_children/match.yaml) - [Age Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ma/tax/income/exemptions/aged/age.yaml) -- List parameter - [List contain existing variable class names](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/dc/dhs/tanf/income/earned.yaml) + +- [List parameter Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/sc/tax/income/subtractions/subtractions.yaml) - [Marginal rate Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ny/tax/income/main/joint.yaml) - [Single amount Example](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/or/tax/income/subtractions/federal_tax_liability/cap/joint.yaml) - Breakdown parameter - Breakdown by Enum variable - - [Filing status example:](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/filing_status.py) https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ia/tax/income/alternative_minimum_tax/threshold.yaml + - [Filing status variable example:](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/filing_status.py) + - [Filing status parameter example:](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/ia/tax/income/alternative_minimum_tax/threshold.yaml) - Scale Parameter interactions: Documentation - scale = parameters(period).some.tax.scale - scale.thresholds: list[float] - scale.amounts: list[float] - - scale.rates: list[float + - scale.rates: list[float] - scale.thresholds[-1]: float - final element - scale.thresholds[0]: float - first element - Do not use “name:” metadata name: mo_federal_income_tax_deduction_rates +- Generally avoid using single amount parameters when scale parameters can created to summarize the value structure +### Example of a standard parameter -### Example +- Essential components: + - description + - metadata (unit, label, period, reference-title/href) + - values - Multiple references example: - https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/parameters/gov/states/or/tax/income/subtractions/federal_tax_liability/cap/joint.yaml - Cite both legal code and tax form if possible -- Generally avoid using single amount parameters when scale parameters can created to summarize the value structure + - Description - - Name of State - - Name of Program - - Full sentence - - Including period -- No numeric values - - Arizona taxes the personal income for head of household filers at this rate. - - Rhode Island provides filers a standard deduction of this amount, depending on filing status. - - New Jersey TANF counts these income sources as unearned income. - - California limits the young child tax credit to filers with children below this age. -- Label - - Key Words + - Name of State + name of Program + - Full sentence including period and active language - No numeric values + - Examples: + - Arizona taxes the personal income for head of household filers at this rate. + - Rhode Island provides filers a standard deduction of this amount, depending on filing status. + - New Jersey TANF counts these income sources as unearned income. + - California limits the young child tax credit to filers with children below this age. +- Label + - Key Words, no numeric values - Not full sentence - - Name of State - - Name of Program - - Utah income tax rate - - Iowa nonrefundable tax credits -- Reference Title - - Refer to the specific part of legislative source - - Code of the District of Columbia | § 4205.05. Definitions. + - Name of State + Name of Program + - Utah income tax rate + - Iowa nonrefundable tax credits +- Reference + - Title: Refer to the specific part of legislative source, as specific as possible + - Code of the District of Columbia § 47–1806.04 (f)(1)(C)(ii) + - 2021 DC Form D-40 Booklet, Page 24, Line 5 + - href: the link to the reference. + - when applicable, add “# page=page number” to the end of the link to skip to the designated page. + - Example: https://otr.cfo.dc.gov/sites/default/files/dc/sites/otr/publication/attachments/52926_D-40_12.21.21_Final_Rev011122.pdf#page=24 - Important: economy and household metadata - Certain yaml file names are reserved for functions and can not be used From 3cc4923c993319f0e2f18da9d85d6468f5d9a4d8 Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Mon, 30 Sep 2024 22:43:00 +0000 Subject: [PATCH 5/7] Adding contributing on codespaces and VScode Fixes #5034 --- README.md | 94 +++++++++++++++++++++++++++++ policyengine_us/variables/README.md | 9 --- 2 files changed, 94 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 337e70ad366..e8bdae46353 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,100 @@ To install, run `pip install policyengine-us`. - First check the legal code of the program - Model based on legal code structure - Second check newest tax form for inflation adjusted amount confirmation +### Contribution on codespaces +- Steps: +1. If you haven't already, fork the PolicyEngine/policyengine-us repo to your personal account + Leave the Copy the master branch only box checked +2. From GitHub Codespaces, click New codespace +3. Select yourusername/policyengine-us as the repository and all other defaults +4. Create new codespace from blank template +5. conda create -n policyengine python=3.10 -y +6. conda init +7. Restart terminal (bin and create new one) +8. Run conda activate policyengine +9. Type in terminal: make install +10. Check out the issue you want to work on + If no issue, create one at github.com/policyengine/policyengine-us, or from the GitHub extension in Codespaces +11. After making changes, test with make test + This sometimes fails with [Makefile:9: test] Killed after a while + To run a specific test or folder of tests, run policyengine-core test [path] + Optionally with -v to get verbose output (the computation tree) + +- When returning to the codespace: +1. Return to GitHub Codespaces +2. Open the codespace you previously made +3. Open terminal +4. conda activate policyengine + If this fails, that means your codespaces session has expired. Re-run steps 5-7. +5. After coding, add the changelog_entry.yaml +6. make format +7. For the problem of Check version: git pull upstream master + +### Contributing on VScode +1. Install VS Code +2. Install VS Code extensions (you'll have to sign in to GitHub for each) + a. GitHub Pull Requests & Issues extension + b. Live Share Install + c. Python extension + d. Recommended: GitHub Copilot https://github.com/features/copilot (free 30 day trial but you'll want it forever) +3. Set git username and email + a. git config --global user.name "John Doe" + b. git config --global user.email johndoe@example.com +4. Install conda + python3 get-pip.py +5. Fork and clone country package you're working on: + github.com/policyengine/policyengine-us + github.com/policyengine/policyengine-canada + Forkzsh: command not found: brew + github.com/policyengine/policyengine-ng +6. Extras for Windows + a. Install make + - Open VS Code as administrator (search and right-click) + - Open a new terminal in VS Code + - https://chocolatey.org/install + - Copy the command into the terminal + - choco install make + b. Run conda https://stackoverflow.com/a/67996662/1840471 +7. Run make install from terminal in VS Code after opening policyengine-us + a. If you have multiple versions of Python installed, you may need to run + python3 -m pip install -e . +8. Change format on save for Python to black and set line length to 79 + +Without conda: +Mac: + Install brew + brew install python + pyenv init + pyenv shell 3.10 + python -m venv venv + +### Creating a pull request +https://docs.google.com/document/d/1BiajMUJZFzG24Ju5lTybCAW8tp59B3E_DNhS8eJkuR0/edit + +https://policyengine.github.io/policyengine-core/intro.html + +1. Identify an issue. If you want to work on a task that's not yet an issue, create an issue for it. Issues should specify the program rule and link to a law and/or government site (e.g. tax form). +2. Claim the issue. In VS Code, open the GitHub extension, find the issue, and click the right arrow. This will assign you to the issue and create a new branch named for the issue numbe +3. Create a unit test. This will be a file in policyengine_{country}/tests/[path to program]/variable.yaml. We apply test driven development, where we write tests before writing the logic; this means tests will break, and the goal of the PR is to pass the tests. Unit tests specify direct inputs to the variable for a number of cases, and the expected output. See x as an example. +4. Commit your changes. Use the VS Code source control extension to enter a message, such as "Create unit test for [variable]" and commit. +5. Populate changelog_entry.yaml. This describes the changes. +6. Commit your changes again. Enter the commit message, "Populate changelog_entry.yaml". +7. Publish branch. Publish to origin (your fork). +8. Draft a pull request (PR). VS Code will ask if you want to create a pull request. Click the button to do so. Enter a title describing what the completed PR will contribute, like "Add [variable or program]". Add to the body "Fixes #[issue]" to link the PR to the issue, such that merging the PR will close the issue. Check the box for "Draft" indicating that the PR is not yet ready to merge. +9. Run make test from the terminal. The new tests will fail, but after successfully completing the remaining steps, they will pass. +10. Create the policy parameters. Parameters are features of the rules defined in the law; they can be numbers, bools, or lists, and they can also break down by categories or vary with respect to quantitative variables (scale parameters). PolicyEngine defines +parameters as yaml files, which specify the values as of certain dates, as well as metadata on the units and reference(s). +11. Create the variable logic. Variables are features of each person or household, and PolicyEngine defines them as Python files. Create a file in the variables tree corresponding to the program, such as "my_tax_credit.py" and copy an existing .py file as a template. Variables are instances of the Variable class, which defines attributes like the entity and reference, and a formula method defining the logic. +12. Run make test again. To run a specific yaml test or folder of yaml tests, run policyengine-core test [path] -c policyengine_canada. +13. Run make format. This will align the code to the black Python formatting standard, and ensure each file ends in an empty new line. + + + + + + + + ### Create new issues ![pic1](./page2image24204576.png) diff --git a/policyengine_us/variables/README.md b/policyengine_us/variables/README.md index 2583caa5aa2..39576e9b1f0 100644 --- a/policyengine_us/variables/README.md +++ b/policyengine_us/variables/README.md @@ -1,14 +1,5 @@ ## Variables -- Update the following files to add the state model into income tree: - - [policyengine_us/variables/gov/states/tax/income/state_income_tax.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/states/tax/income/state_income_tax.py) - - [policyengine_us/variables/household/income/household/household_tax_before_refundable_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_tax_before_refundable_credits.py) - - [policyengine_us/variables/household/income/household/household_refundable_tax_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_refundable_tax_credits.py) - - [policyengine_us/variables/gov/states/tax/income/state_income_tax_before_refundable_credits.py](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/states/tax/income/state_income_tax_before_refundable_credits.py) - - [policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_state_income_tax.py ](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/income/household/household_state_income_tax.py) - - [policyengine-us/modelled_policies.yaml](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/modelled_policies.yaml) -- After Martin Holmer verifies that it passes taxsim tests: - - Delete parameters/gov/states/state/index.yaml - Useful variable classes: - [Adjusted gross income](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/adjusted_gross_income/adjusted_gross_income.py) - [Exemptions](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/exemptions.py) From aa2e9f89896d7a49b366090aa4a1c2530bf99a29 Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Mon, 7 Oct 2024 22:55:46 +0000 Subject: [PATCH 6/7] modified readme files --- README.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/README.md b/README.md index e8bdae46353..b3cbaff73ba 100644 --- a/README.md +++ b/README.md @@ -82,7 +82,6 @@ Mac: python -m venv venv ### Creating a pull request -https://docs.google.com/document/d/1BiajMUJZFzG24Ju5lTybCAW8tp59B3E_DNhS8eJkuR0/edit https://policyengine.github.io/policyengine-core/intro.html @@ -101,14 +100,6 @@ parameters as yaml files, which specify the values as of certain dates, as well 12. Run make test again. To run a specific yaml test or folder of yaml tests, run policyengine-core test [path] -c policyengine_canada. 13. Run make format. This will align the code to the black Python formatting standard, and ensure each file ends in an empty new line. - - - - - - - - ### Create new issues ![pic1](./page2image24204576.png) - Go to the ‘Issues’ tab From 683ee480f870166e77be034e1ab344c051d0e21d Mon Sep 17 00:00:00 2001 From: keepjojoyoung <106553218+keepjojoyoung@users.noreply.github.com> Date: Mon, 7 Oct 2024 23:01:49 +0000 Subject: [PATCH 7/7] updated readme --- README.md | 20 ++++---- policyengine_us/variables/README.md | 46 +++++++++++++++++-- .../demographic/geographic/state_group.py | 2 +- 3 files changed, 54 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index b3cbaff73ba..2832416cafb 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,9 @@ To install, run `pip install policyengine-us`. - First check the legal code of the program - Model based on legal code structure - Second check newest tax form for inflation adjusted amount confirmation -### Contribution on codespaces +### Setting up your enviorment + +#### Contribution on codespaces - Steps: 1. If you haven't already, fork the PolicyEngine/policyengine-us repo to your personal account Leave the Copy the master branch only box checked @@ -43,7 +45,7 @@ To install, run `pip install policyengine-us`. 6. make format 7. For the problem of Check version: git pull upstream master -### Contributing on VScode +#### Contributing on VScode 1. Install VS Code 2. Install VS Code extensions (you'll have to sign in to GitHub for each) a. GitHub Pull Requests & Issues extension @@ -81,6 +83,13 @@ Mac: pyenv shell 3.10 python -m venv venv +### Creating a new issue +![pic1](./page2image24204576.png) +- Go to the ‘Issues’ tab +- Click on ‘New Issue’ +- Can assign to specific person/people +- Remember to add tags for better classification + ### Creating a pull request https://policyengine.github.io/policyengine-core/intro.html @@ -100,12 +109,7 @@ parameters as yaml files, which specify the values as of certain dates, as well 12. Run make test again. To run a specific yaml test or folder of yaml tests, run policyengine-core test [path] -c policyengine_canada. 13. Run make format. This will align the code to the black Python formatting standard, and ensure each file ends in an empty new line. -### Create new issues -![pic1](./page2image24204576.png) -- Go to the ‘Issues’ tab -- Click on ‘New Issue’ -- Can assign to specific person/people -- Remember to add tags for better classification + ### Working on issues assigned in VS Code diff --git a/policyengine_us/variables/README.md b/policyengine_us/variables/README.md index 39576e9b1f0..9a76f081c2f 100644 --- a/policyengine_us/variables/README.md +++ b/policyengine_us/variables/README.md @@ -1,10 +1,46 @@ ## Variables -- Useful variable classes: - - [Adjusted gross income](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/adjusted_gross_income/adjusted_gross_income.py) - - [Exemptions](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/gov/irs/income/taxable_income/exemptions.py) - - [Dependents in tax unit](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/tax_unit_dependents.py) - - [Is a dependent (person level)](https://github.com/PolicyEngine/policyengine-us/blob/master/policyengine_us/variables/household/demographic/tax_unit/is_tax_unit_dependent.py) +- Variable structure + - Determing value type, entity [TBD] + - Ensure the naming aligns with variable file name + - Refer to existing variables with similar structure + +See Examples below: + +``` +#Example-1 +from policyengine_us.model_api import * + +class ca_additions(Variable): + value_type = float + entity = TaxUnit + label = "CA AGI additions to federal AGI" + unit = USD + definition_period = YEAR + reference = "https://www.ftb.ca.gov/forms/2021/2021-540.pdf" + defined_for = StateCode.CA + +#Example-2 +from policyengine_us.model_api import * + +class ca_use_tax(Variable): + value_type = float + entity = TaxUnit + label = "CA Use Tax" + unit = USD + definition_period = YEAR + reference = "https://www.revenue.pa.gov/FormsandPublications/FormsforIndividuals/PIT/Documents/2021/2021_pa-40in.pdf#page=22" + defined_for = StateCode.CA + + def formula(tax_unit, period, parameters): + income = tax_unit("ca_agi", period) + p = parameters(period).gov.states.ca.tax.income.use_tax + # Compute main amount, a dollar amount based on CA AGI. + main_amount = p.main.calc(income) + # Switches to a percentage of income above the top main threshold. + additional_amount = p.additional.calc(income) * income + return main_amount + additional_amount +``` - Add readme.md files to state program variable folders per [this PR](https://github.com/PolicyEngine/policyengine-us/pull/2740) - Eliminate abbreviations on the front end diff --git a/policyengine_us/variables/household/demographic/geographic/state_group.py b/policyengine_us/variables/household/demographic/geographic/state_group.py index 9c97cd7d147..165cc7354cd 100644 --- a/policyengine_us/variables/household/demographic/geographic/state_group.py +++ b/policyengine_us/variables/household/demographic/geographic/state_group.py @@ -25,5 +25,5 @@ def formula(household, period, parameters): return where( np.isin(state_code, NON_CONTIGUOUS_STATES), StateGroup.encode(state_code).decode(), - StateGroup.CONTIGUOUS_US, + StateGroup.CONTIGUOUS_US,888 )