From 28293ef132d5bd8baba01fa621b177ad89f6f50a Mon Sep 17 00:00:00 2001
From: Savio Cardoso <savio.cardoso1211@gmail.com>
Date: Sat, 15 Aug 2026 13:17:55 +0200
Subject: [PATCH] feat: add automated engineering reporting

---
 pyproject.toml                            |   5 +-
 reports/BodySimPy_Engineering_Summary.pdf | Bin 0 -> 2744 bytes
 reports/BodySimPy_Management_Summary.pptx | Bin 0 -> 34097 bytes
 scripts/generate_reports.py               |  25 ++++
 src/bodysimpy/reporting/pdf_report.py     | 124 ++++++++++++++++++++
 src/bodysimpy/reporting/pptx_report.py    | 133 ++++++++++++++++++++++
 src/bodysimpy/reporting/summary_data.py   |  58 ++++++++++
 7 files changed, 344 insertions(+), 1 deletion(-)
 create mode 100644 reports/BodySimPy_Engineering_Summary.pdf
 create mode 100644 reports/BodySimPy_Management_Summary.pptx
 create mode 100644 scripts/generate_reports.py
 create mode 100644 src/bodysimpy/reporting/pdf_report.py
 create mode 100644 src/bodysimpy/reporting/pptx_report.py
 create mode 100644 src/bodysimpy/reporting/summary_data.py

diff --git a/pyproject.toml b/pyproject.toml
index fed3283..d6e42e1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,9 @@ dependencies = [
     "PyYAML>=6.0",
     "pydantic>=2.7",
     "typer>=0.12",
-    "rich>=13.7"
+    "reportlab>=4.2",
+    "python-pptx>=1.0",
+    "rich>=13.7",
 ]
 
 [project.optional-dependencies]
@@ -33,6 +35,7 @@ dev = [
     "types-PyYAML",
     "scipy-stubs",
     "pandas-stubs",
+    "types-reportlab",
 ]
 
 ml = [
diff --git a/reports/BodySimPy_Engineering_Summary.pdf b/reports/BodySimPy_Engineering_Summary.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..3b044a82f4ae581e6e56a9e6bf963cad52b1c167
GIT binary patch
literal 2744
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
S)eqmXlN3$G(&^S%j{O(F)D5Bl

literal 0
HcmV?d00001

diff --git a/reports/BodySimPy_Management_Summary.pptx b/reports/BodySimPy_Management_Summary.pptx
new file mode 100644
index 0000000000000000000000000000000000000000..263830266a5510b221bd80f2be35028ee1494991
GIT binary patch
literal 34097
zcmdqIQ*>oryS5wKwyl|plZx$BY}>Y3aVoCZwr$%sDz=@S_x;wt_j=b}t*yVcb@m;M
z(dHaSb3DC2*M0Z9_xVE#6buar2nY&@&H_=p3m7hH2^a`y5D^Fn_3NpokgbiAv5k|i
zlDnO;qc($^wbewjjN%$2Qpn{SObme6$pCy+VYGi|Iz|z8oZr{4nmw$T&b&S?;mvb#
za>$5k8*4f{f+x;p>v3kajx=iW!XksNJFm8I7~xhw$&cE)V7z|#L+cYS-3U64C2@X{
zKb9W2uI{?$$m19YRhCUHpP9s!1}urWnEYVTe<v~QzJZM3rNplGjkbs=I;77~UPDOF
zj6X`0i@^J5Sh}U8&-%3!Y}_VQJjIrZeUx&n<Y7Gx`E{+@?-T!#Zdr=bpwXn;R7HnF
z;OC8yrPQC{1#jp`*Mp4cF{ztezj^JHorN|SxHI<z4EbiAsU0S*4DAZ>e75~4@lq3u
z;1}I7-=I56iCPjeCygiM10w8?D};KkpKob4z=I)*11z@HP`Ig=nfOk%H4xt?*jX)V
zADx_{g>M%$*HmpEyFN|n+Yx&x0AT$pZAqg}J=q5%x(?=tL2ZG3O%!W0KHugTMT@a$
zozaNrhM-b-MTYM<1q=6}QaXi)oluD9mL5%B=wqjpo4-TNF{`e6eycF=wYwvRnk#ul
z3OXM1hU#_N;RVz8upta!#BW3t`0cYQ!ha*$hfdGh{_O81)*2rGD5&=6>?E&e(vF4&
z{|wL)YV5@YnbGMRdi?Q^d2kKSeg^b44|YI+fMCDofv$tGl_P-RuX{z@lq@JQ($7m?
z@D<o1hBb@GZ^oYAC_1ne3H5@G8Jzv0rDa|pa>INr8f6f9df%Q7aP>Nup9R_tM;RdK
zi=0WpAy6w|Gm-#hLn9ezDa2}62K@AozyIWRr1I?nX-)2L%42||)K+?!w5rmi5%BDD
zp@b-?5AFMpF*%2Kw+sBVSY&CUc{f%%2Ueu3sGOaZrL9>-&FqUlZD4*vnpia4j>Y&y
z35F{XT0}>tmHa(+pxVl?FBt_pF^S2=TYfXF=PzL2bzcR%er0Kx=Pp?j<YRFkQvIF6
z$y=Qm6;-zQZm1vOHgwT+cOHI2>t@7m2#aoYPLlu5Iv>Hu<Q4dzg^ECX+jIXa)Y?~}
zkiQCLWNY}t!Pd?ZU})=L{8zg~#ZAceF(L(Ba*NDM$(HP4NQT7`0q=sLC`9nDM|Q}-
zhgq+z6}o$-=gT}F`)jH&znXKW-Fc`c_F$C9YZw#b59tGiTM{eB22YK>nh`)Cq@a|~
z!_-y-W9l55QnN!ZVPuxG>B$Gca*MYFrCHUBvOp6@SLGPkoZ*i~&|1@m_|$`ci}bAp
z877N1%?B|GASR_}WCFFX7lYv?nix#N=eGkPSIVA7<|^Dj5~)u7-ZD+Sm7dr?*e!7?
zfVcjg64Fq6Y0qO--P=b}hma6sLy@#(wUi_BM(GNSJc++muF3rqDEhsdo^gH=v9n*!
z%)&bOlpHu((|nqc6u|Fq3`Mfc;TzS>(!5B+1mQ~k{Kr~?-0|rMu_=zoCe_QoI(R#Y
zdLe(mYTZU{dGz6e^Bk}5_l4$J{0q>>y~NgnfP2d3CjF(@Gg;vrRpHFO1GX;t9d}M$
z6Wd12J8AVQ<P+aDNy~3vQUV}tpNpN~#;D8aw`amzz(2<+b2{4n@@t%|!GM5}{_{BL
z+u8j!Oc_c&(Q}MQ9i-QYNpf~(@q)oW{+NJkS9oNzDAbL)S5rm>8;Ug^+dO+vK#vsu
zAQq6loZ#-jo?1p`mut|cyc77|b`aq{imh>+&^W}}1-LM|<b*{o2ic>me8vXt8qw)Q
zYH@{sDgMS-TdhA)hLxrq2d1tMuP<vZl`{K`Ln7}ht)*@e)+FmwH8Z#`liDeDMV+f$
zY%*as>^ZbR{ZUooP<syGMmr37W0G%%Dx79DfsN%xy&iB!uT>)BK_W~YG=q*Uj6JWv
zV`yfo#TU2EgGC?PAbnX!MjcU-+Uw^3^WA01Ir;pYPCUkJCC4G=Y{B9Fp+US7N(6x*
znjp2*(zv(3$1GU;4ihCy`wWx^NwWfN)pP?Kvu$JWs89;-2Ob&L`m|duiZp*M0jNR5
zbR{q3xrBRo8S3Z}H|z@}z3<41D%3K9^Mu?s>+-Otx*V5PDw4O#bnmd|K7RUWp&DSV
z<8HgEceCs}KCKfA)<=%8M~5&ILHyMppcj<aI2Dwtal>yJVoRV|PA!)V6m7hrIh(fV
zE_yqm)&|13s_c4GXgD*J)?LA`g?3Fy_RG7*Kk#U-ijUMIHNSq46uhU<OU%5t=aCfe
zY;{RDfjm5hFU2b4?er&4?SMn(>=I8T@#5y=j=Cw|e`(_TUxij0Uk&U44+Qj=7TVc4
z0qh)%9lwN6-^tw8=C28Io;(ws%ZL_o`A98p+q}&2gP)&NwzlruO25qb5jQ_%v}7UL
zEQadgaT9m~O^OkLUt8lR=O^bo6+B($6nKMdw}?({|Dar@HL%neo$1ehpS22#8f$0?
zHBqw>q8b3v+2NlU5!NaWD7`rGM009PiUTqMG3v6Gz0f--aAY}SaB1_`I85PEYCaBZ
z%FhH(0sJXvp&}wqA#L7IS)Z1zL+Uq%xz-<lG*J=ikA?7VCABt6FPl@^nr$V1p<11~
z0y`)(QKJOKidd+3CIri(q;V%U;E)ZANDT;0p8=3jp0cdy_xr*VO`&h>kicsQA->f<
zX;o2ylbW{Jb&7WpHc`w?4@Wyabl_n-a3@Tx*5z<BYdS)D9Hnv*oGj0G<Xoh*Ze4Dy
zA3w}VPC=*c5ZP%fGj@<sMHbmJ$0oy|kSQQ^2h?q;=oNs?6l{<<uP)?;jq1r+(74(q
zX}afBYaw+su3XvNweDb$pX`(B#Wz{cWnc@+p{ddo5_we+wuv11lZTQ>4V(?XJ}?XP
zu-rH~Gnk`-7)|(G#~eHz35~Xv#6_1Tc%ZVeN);?dF$6jE);v4|RZ8lempIGMa%=uc
zU_<q;+zEC#6;@((AJiUmm6urvS<B21-<S%JDV~otLf97onuRHGLsFR8b6em@$BjXV
zTFPq?#Cmq)A?!MwBN&U7gDu!Yz4NLj+_3|5DwqXM#ql!$M2qpO(%@%TL+-oVA4U6B
zDsl100#m`fT}OAy9|H~W5XqRf=i7cgWd{Ah5j80FB3keqhwo#+_2?@(_W4gxk=ann
zi++JB9uf$M@IU6_zts1?&d9&jxMM-aHjoGl^6Hg0_`26T_rY1JA=y|0Q7Wn76-bFN
zQQ9Bq^q`4wrBykK{5w+2oBvPUOemYiESd8RewtDBfLtPBg6hb_ghXf$9`4P`*di8v
z&JxZ*u!ihuwvLr{ewq4}JQ|t=({RSbr^Llw0>eb*X(V(z;PG)ZEjHn_9J(5!6<liI
zA^qn5TFpK=Pu33Y%qNFru})Vr@V6p108DBR=+q{zp2t2^xkYLpsyt3UwUiMw*Y$UO
zTM@M1FT4b%0}Sed3ML5afs2LbCxW=raG0V!v9*@HDVoH^rXwO#F40!jscpjPR9<jM
zzOnE%c45;d04<=czO3n&4!R7S;hK;R8_T2mT+~$}+QUb4yZFhH2Hevyq#Ag8c4Pw+
zA>ke2@D}Brk3@V`x^kGJm{O6NdYW|Jbc}%$Re#UV**n;O4uMv>7@F|c5QP1QrvD!t
z{4MN%v7jMt>@Q6hc@%#W+V8OZE^(_6Ph%bs)E@xu<(J4&QSd~(=1tV!g(?Vx#<o$N
zHgmMe>B>@eF9Emdk3E(+4y>-X{cWW*ddwOjGwVVRg!{Dk>?oUTtOvGEPkVi{+^G=0
zPMYgP^f>QYl+>I#H88`GOK7<9J4LZJ)x<u>X(IA`RK-f}<n&%MKiu#ThhTsMv`I&c
zXw^$*Q@P5yP9#tkMF>1<*oM9Jl+6oHQx+$~ukdeV-&-J04@TE;GXs|>qS<6{k{Ek?
zAVSFQ^b^_8BP~$+u~4;MuGfC12B{BOOUbwbj*?jMU0I#);KX|Q+ya_J)fd`C%KFn$
z&7F-zX?aD+-8z^25jeYn&}mtEw3!xxsqOcZ8D-;9Lj1FOYfCNFl#Od6NeBVZ9|lG|
z8;CXr<*c6o?mKUpyI0R}*MFAWl$jzb?W^Pgp#QQ_f0f+D+}QR1EqRn;kL=!;K3Dbg
zsdWa%LkWhZItbVaXyk`<;F_l5a5nz2ml|8TB(pJx<*`d+-*fk|9n9Rc_2^qf`te=!
z_Kju_uH2!bQF}r+ZD<VI6sy3xz#hY*6MX-%E`m={w}REH9ZVDqgI4|4II<H3WC6t^
zOm#A_V6`_`M>HS@)%q8q@H(!%kvg?U3H{dn&#k+*0YO?fJBx+Ds4z0W*x3F(1<&=m
z=dJ2zAaNGM#}YEqZy%(ttYUL)W6GZ<1#ChgQ^U>p;-XI|5YpT;;AUC+$k;x!Shk}i
zd%Mkx9DGR^m17QcVOiW}POy;02Zb`BIf<S2aso}PMeyWLkLUPG!mTz+1umvbOyh|x
z)l+*wCW`7iA@H;em7Juh+_=U+JUl7rJ72v11YFb`r={v1u)FuHxP(%PAI=NdH<5r&
zVRadZcCZ+%hQMZ}yNg*ww69N4;7g2*82MiM3*$`@nR8|Qaz?K9m*K`)o#E)hrZhc_
z%qpD1of4f}aUI$%4~kx7c~qE@G7V3)J^qH|zk1QvAJ;i`#`n*WjEAvyCWZh4I>i6~
zwA9JW*xDHI_x;=7TB<H%yT*pqiMZ@b<Ya5SqH+S}9KKw$Rw08+X7iK4JS=JXM=t-Y
zgct7Wo*!^ut9~+Y+c~2Z?KDW6Qx}Ei&kE2N%!iXcCgZuVITKC)MaZ=L%*WTje6Rae
z`~GQS<hYw=YtCd#43e55ZyZSL(~E515@X^LyEDT<!`Vg(VT~m=zPD|f%^$>JP#`aA
zHrtKpG>KNrjdyz3V`JRJ-?(w@k@dk9k(WEW#k$!ITsl-V>qw;yVFx%s8eK(6Pmo!}
z)iu%-4|pJSYvPUrhWa~`CFZG_%6+%<`5Z{vq_c&_S22dKpJ)8=Xkow6p>vyQHk=u*
zq^X|Ag_e-l<7o4}qB(*4`~H|Z5@w`>&hT-3A9We&%DmO>zxU{{nWBC+20C-sE2;Cd
ze$bRP9aRMV(<idIk*aB_a*gvj2;$Q*cieo6?qwKa%doB4&~TvA5nwxcb&>m#QDNg+
z5#Vb2)Bx`FIr^ee7e2*LoOj&=!WCtTor1!&dlrJc3F2m%3dEdHVXP`kSZ3UUu>+}f
z2mA{hlNN`RRbm**)9=(k^k+aJ$Q4A-YP{D-Jgig+9T|@R>Ov#0ETd9C+|9{zOjRbI
z$k)Z`{&cp#1E7o{$l!ik;dcWa@|S(Oc?EoYJSg5R&0Xs7evC#YbA3E!@xGof0Venh
zKy|&|_hU@ubi8h#v-r5#x|_fVPOgBXLWP?~kXQGRmraoPLw3E;0+AFm3}_L^qU|LO
z`5%?k1hz8uLg1SbN<6MI{TTE>bO`y1soDv{YjPpBCm2hCTschf86w#>q>Ybtu!j8A
zo3T!tc_I;IYTF#I&!bSqO)U&o;3Y&Rv>}LxfWyKBkC}b=L;cTq3(&hRe#qI4h{0?W
z6$h5gkb`n5ndIWK1T;%a!w9z1cCNJi<VsIjwvF$jK`8}cMwRNNv1yMUf)NvqvhR1=
zr!N<bk9$SkQO09H7v>_0%*&L^XPH??jt_5T&++`-*V#uQk4}xo!$@qaKk2;B#&;CL
zAsNXv$1z_+I07mzAL-J<MAK7-9ydvhz@dY4;h9i;yYQfm6LbJ3krf$SLIzc}xEB<~
z7#2aHYrcdWwe@(B==qqGJ-C~4xjbff>)kpQEVuQ+))6&y&EP-kwpFm@dhA*w1t>d=
zxSXhSu{!;E5h+uD2gaKld0qxh+GMmiO#b`uQU6<-k?<dXK4^Wl(6Vh1|GIA|THb=n
z&4jyP{TwMl{21k+VJHkcsrvMPGB%W{m(wd+=3ptZYgTuBI@hNGndE6!7~<MLNR6vY
zs|OR=Q4jXJ(F-^$)l)r7Su}4c=HYvfEx}DIG9yBSdm^7owj3ems^21r9V|2=1<z3X
zYE81{o>be9Go`{J>>aFoMji}UYnr))#H=khD%vn^>}DH9?W_Xy6M*<qTyVw%nyuYw
z*ssns((Bwd(v@W=v`y?pgh}#O2bso8YQ^T3Xs)F{Ti2xD?Y==^rH)u=uxLzv76<bX
zYB1p-%h9W+$V8ZWm4_}PzLT;T8P@z1xHQSs=1rVFKAj8mTeraoQ>9<eWjoN_LSqe7
zN7*G=)6_U~bYo+19yUq!ctF|Eol6)5Pu=ZoE6h)UJ)8^4+Q`(y#KbD#Ty1RrLHv^;
zA!z;-cKMN6JsUHiR$N(-&Ko=9L=wT&oAxl4y@g20lZ8J(ut+h7$Ve64C9`L|<aBK>
zL4L+m(%Crf6Jdl{Kd|0oN#T_qO}0&9ClrpIkY!CtyD$3_gHS8As^NMZjCHE+nYE#?
z${PICwy>85x0<5Trm^{gVZ;5PX%)-{o9aDaP$qcDWM~d}EAS}KAxrF6XtIXLb7F+h
zbV~tta_vi%tUv|%b?0zh-oe=*ifI<Z#eK#(j@NnSg@tF0u=P1X+yur)!fqcVktc2?
zyJ1q*Fqp}+o~jW9VhbO2i1YzHv1@;QL7iJnB+`9Mk$%Rl*>#m%OUmUR5QR0V-oce1
zaG%Dog#P=wFsblk{3^0Z8+!@}D+<n`LwN>Gqho4}uCOtcADd@Ph7Xk|wdf%CI1GwI
zMQ!C*3D%O_4&`7MvY&$iZw;o@ZO@4Rl$7Q7sF;E;E8O^X{S`|7We%M54Xlh6o!qUA
z9sg1k_;Cq@07fkSosKY9vkz~2A$c;iULso86JVMI;$wcZJe0i+<L8?=zyzOUZnD~$
z5ew+&HZV#n>qb5#M2u&kA^)QNhP`>cUNsD?d*fCCx4oRZV;P$2>2#r4njJ)*qoZJ`
zwOCFw&u{gk^LrEdb?X+me9b4%xkNJmL;SGac!>G1%pUgA0HWOb?xL|jq2}VCS{^Ke
z_DYKjEhX<XbUysG|3xSZ>2p~xzJzj?0SJirKi<mG%G}6UM&HrN*ufF-pT7J{H8n16
z_SjH9edLIbc=!8yXv0YEht!HfGn{Sxop4!>L8noyPX(p8!e!%m(3V|~aPR0>UtMBq
z<s5`0>y3uOP|N2kFX8CuEI4o`$8Al-WgpJjU14oDnB<K`csZ^&n<+8I;z=fMR<`$t
zPVE6)H8c{p2{$CBf$^Ry8D5Sr$xX&xyT`8eanfo;Bvmg?dQ$~-uhEL+j*Zz1X}Lz6
z<1(-{*(f>#;}YQS(87S`KrMDV43@F;1JCR9%ZOtZsb%+AI!wCc2BaR2#B3kdsnJn!
z+APuvv~rMdFQ=@DvOS&q;YBB$DGObE)g_4quApm<+K3!xx>6>j4CR`mkPk)&E0f2X
zMfx_PCwrys7?CCNKCcy2Rijcls!w*F)ch2o^%dz1%iSs<cfx%K^MuF#b=S}1aOR&j
zG#Dq)7d8AsON|!`Re5G-vKkUH(i#>_pFXg*OukLQYu{iwGDH%U8ypZP1P0Sjr5#MP
z9a5{^dlW;_ZH;qgI%ojl`-QbPAXbW%#WLFV^ABaFoK5@Q&;|u4mbl5q5=CX=4I8w-
zgZ!%5FoQX+@|-_~p$7cdme1XnT{oOh&AZSN-;&T_rQjhN^}^=;`E3C->UB666$%Sf
zWS1c#9#tHaS74L^y*-b&f?oCXAG}o%E@%31mQwGztPS)t87bux;=DA?qG1Qn!`RDV
zXd20QyRTN%5$20#N`R6=H}a}|9@Et`g?F=BpkR(*uO{`)*Xz;7(qKG$(OYG;;W^}~
zI9w?V3@K)FR`)7>zY`#m1wjQskw`6fM}ELZHF1l5>_gObm?6mVwcU;CPJZ=?DC(*h
z3pM15jD@en4|gP<Vdtz+8fm03(9hGDQcOsNl3$&F%0i!eyA?L)?3F9PlMGcfHD^6{
z;#BFVZ{~N;lCDid#Q<o&JX8I*1+RbvUWO#W$t-$;E+sFv4I1w)>L?k>EX9^ifu~pT
zW2FFRLSjs+EVh!UPO=8jtnRL;dC|<vDup$~(4WIgSu2*W!E-VuJe_|s!|_K=k<hhh
z(`rjVv|HvBKc;`7aZ3$hA8JMm+*I=7kI*Hvl9QdQv>H@yX>dlXOCaKkoY;#A;BP2q
zo)EoYVn<I-ZiL=#ikJ!j!Woa@r>@&J%|gZUn3MbWkUv(~z5&Nl)Pdug))nY&0W7I9
z<Iyq$1&40ef_|6A?{q2#{7%5a45kU#$nSm?52q%o)PFmSgHg+ofcqQ>+wp|r%fObG
z{wQMZ!)xs9Twk`8hM=IR;>R@cR%4*Rjg@#nPO(b_n^_A$?c(476@2@=tbK0?IViP?
zX}{*+;EV9A#EtTtK@#i05&$NI0Fxa<M#$T7Q*NY1cjpuyaxA+)l<RuGzb)E&{85o{
zF@fI;Ic+Pts9>ZwY=;GDhV~VLA;x$<aU*z|?)lvf_7AzSL{5r+v}GwX_w>CBGj5o=
zWu+nn|0KMl!cZp(Fa15rE>UBaiZ84F)-SAX)Vj6PA~Po}6!Z&sNMF3Yc?5NOg1ezn
zc5O(!`6)VS(deLOl7Z*y5<hYl7fZ%OeCAg!u}C1Y3`&yJwi!f70G#o_9&WfT)$)((
z93&y)5ELw!`QMyVH@J2o9?OgM+rCxMCQ3_K#VD9}oob_x=7GXL6&~@q@pgw1?ciGG
zRMD<^?+Ls*2Bp>!0INNx&TjAc?Ztf&u2(PkI<<kAu5N+&?fHGU7u)b$?K23Q)qS{^
z+fl7*&EJ17`7vt_32pz$V4zPVC}ZeHeXR$-KTegc<ZYz%C@yO)X7Y$d9EiH;Dj_h~
zZ10`NlN3&xVn}u;S@7zpBNtj&n#&u@r;aZ}X-UnX<3n@z=DbkSr@AD13<-M!M_*Yf
zZ_>+AP{JIdw(0|YwT<w-YqomeX#Lh>Hn&{HMiEyU+tJ`r<=HU*x&n#`C~o${N6S;g
zPWtnsut%9kh|x84>48t&sY#!aL66ijiWe38PXjZ>*i1SMt$&vP`}17Y1BKE(@Gfii
zC}ALtFI?%HdGQ@mgI&<J_iQkz2pQQ=upt2AHvbH8x4#C*8wSFh*u}Pg?soSaXom**
z8YzKK1mwl`%$*q`Rt){~4gnBB^FUy|8&Pu5)358NsV+oRgxOwXr)?qv1O)8pia#ev
zS5O+<y$A&MM<Qa}A7I?Q7%^tI)t>!(F+-#l*P-9tgyrqF*Pi`%k<%g!4lUFkU^z_<
zoaKW643_garvwih8cFw>f69oKt-}a<6AfPBr#N<wvd&c*HpKZ}4zFo{5qeZ9k$k~)
z?UGC<DEH_no6-i_BZi0T=-SXT^xZJZ=L8S_gdpNh5pvBhXo#f4XZDPMA>(4pFMZNi
zl<)n&#P`@^*U#`@`M}^;Dn|F;iRHf{vi~ZXe@A2k3o@2{{}GY7UC(39vB^lu01SUD
zn>!Km@5W;$6&KTwHDy^b;!xH0bw_NE-TL}aX6+q2;>^I8<JRv68FLC`<IqDc*x&fL
zt1E+X0us>jRJuptqSH@`_HZM6f8s154(1@`;th2?9`Kh~di)L=s|QB6(Xgi6>05M}
z4?Pfa;*a14lyppW-;<zbkPki3VT&fObnDhSuOYy5pB`}e-ymxIU`O~;&+;nXewa1?
zLyobFDa;r(3=O>(HI@7X^lvL%1y=a+)(WF+-&WWPtZ?HKsf~@L8>Oh%28@&?)zRb6
z6-OVwVUNZ8G`P<vxxfh@0=+H?YzxuTDQ!{momK@h4BEbf|I=AXh5b<N{)${G;DCTg
z{&QKS_1$fqo&Ljv{OilNzfDMk>P%c38=Ci}s@YLsmKrcbB+s=8oDNsUijk`Y<t5Cp
zB?XAQgv*%|Q~Z_%AEoXrEwIkoY5v2!`!}M>=t-VK80{{P4r*)-MPgW;D9?+iIidPd
zHytIpz0Edv3o#xt^b&_&H<6(Z`oxZ<rmpr<vA92vMq{clz{2EWMppERrD9lPRuWPq
zwr(=CZcW>{WH1B+sFUE&VAJG%nR`LaWFp25w*#EF&j#{FPNQ|o60{3`P@|zBFAnPS
zwL)c60%hQdK!zrS3JPnf(e%?I6R-nE`J;!puqkdeA?%gTuqZ~%NqON3j8_DL5s{2W
zyU0)>2Tpm?zsnB;6uea{d{OVqeb7uE*6#E8MJi`B&|sSYtBmW?Ozcl)FN&^GqG`cY
z_vrHiX*GY;%*uRg2tZM&EFtO+XRMy>NZ2$tGeQS9K-_HQGn9ocjJYzMHPBp>b;Pt5
zAGu$t<OhhqRS3l&GUQ6==$;y%hRy!K*v$nx#EB@E#m5hS<Q$m;3C>}^%b;+!-TwK0
z^n-Q^8sea1kth^|{VKqa+^8*RwV!+IWQA}W2F6U(Fe2`eo|(x&VPZZ>{`SWyp^zj$
zBWd*%oyN+g2}WFjBo_I?B%*U#HOXrznivZJ%|j?Z7X%wxPZcD;Fdyz4s6^RYEY!^q
zvV%|uTl@FUX2-9T`9b%k7~R8&EKh3EA$wQ5Pl0|tHm~~Q!2RZV@};Ny)xRcZ4<Rqh
z+^Ql`w=N^_bIxpH?THRCa&W@}QmPe`fin;L=M-9=<>;i}BSTOY0M?$@<5Tc1p(;ot
z6aG>cMwd=DSJyM*c>^O2MFi1B<rC*S?avG{zCL;J<=i#J$ryHYUgg)Vk_T`+U#^I*
z0FD&t465qOTnRI=Si<G&`L4S7Wx2R8RJghR&)JMp&ivBwxWa)s$?2boykt|30|T2t
zZSSUHe%<#x&|Go~llKhkt^-{mw6Nqjnjc!oz_d=2Z$pO{D5jNV;>*-bh9a^vYs$|%
z;>p`Mt^8up)073*K7un8HmM<VBhxPFP%rDtF=siDe{g^LAHtLRA`Ki@niWj8gSZ?n
zo-|eYe!iTa@~IXpw{HpbhS>p>J%6g?`U&s4VR=ZPt<{_sHS*yjoJrt7xZvD*^M&O}
z%yzxzewSY&G!960d3<cQOwj%mDbvD8*^UFu%M6Y+9uBg83V%)7IhQusHL9wx54WF{
zhwkq^)pgL#&Z>PF>>ah#$P}BuUi7WQ^H~nH3_>iPbf*`G9icW~v+Q603s(J%cS4)K
z`kw6zt@Qt0|Nkef{$~pO&DE%>4uoDJB*?3cA|g6z!Bf3R>T?5WJgrFHZtzO_8t~qn
znWp3!3WVs#``5$N3s$+aurRGFjrm#>xDM#WXMu>d`{qq(QSA0$YPb2_D6&?U1ueS(
zEgLhZSTzA|bKV2IN6A=hdx$vVTtGZ;KDGn(TsFz??{LLz$_>iLYuo3&MwDglTq~({
zr{8z^T#h_VuaL$KMYDW`sZ!Gin12i^sfmM{OccCb0Fo@!Nt!Ki8{C@Sf&NKAp!YL)
zny)=!@UPALf2_j(I|BZ-(wtD!j$UI!^0}mjy6=&LxfhbCN4C`)Da-9PaYeR8=uR}#
zgd#5`J71;-+1EI?cZgF+Fmm@@<?;i48pth9*<rt(_=VTy-9(GMtnh_E8L<moQ!ul{
z>-J)mxtXD#^Mj;B|3Y9<9#3MPt7=z!1!deHcB3hF7&Fww^j{?nDy5nHRCTQMVP1Wf
z8ppO$43fEbWokWIzou55MzRk%i0LHc)iXLdM6v+MBBF=fYYFuV703eE@;IGZm<?wY
z3q@*Q3|x(z@qv*zx8!P2%E4;zLq^r)+0js4y|wCb_z|lh$IXJG*At$eDp%`+l)#o}
z@tRhQdEdc^)3oLZ9Nu0tZLU%MIvv)dG6J{Fe6P$$7Qdm8Frf$ua#omR=<j_Co5tCy
zNMuP_r_ZLj)j^V0QKcIj@(yxkHZxd;u`cDxeJVk;9;nKrqrP=@77vEL^ucn`bb(K%
zk(FlJagm!ztzWM0O_q9j<>vkD!6=BQS9Cw?=nd)KGuJFEzfW9ryCf33SC2BJGiC$b
z5aHfwTTggDS1m{(T^hW~Y@u^<Fw~92g%x=eP-AB7tEI-DM5CXe^wX@YEC_vtGMgjY
zJ*V4~1RcG5KbZkwT??E8hh`Y3^2~$0-^V;gzr0Fxj@+A><!d@}sjgu~u*TZqh(yjF
zLoe?UyOHg{rC&+dqCfOI#=aQ#irO%z5S9=t0tDcsvwtiRnR1=fqJfbhy#Bi$P^zWc
zg^ki!Dt(|n*nOa4>oUkMn@rdWWUu|lyyv&OIU9N^BXDETag@O!j)<~SX+{{xA<#Y1
zdMCWgwjLqDmGh4dU>cZQ3MS0ZCETkQ(9N2NY2)2{$ab@CPw~Dn&`5~x9%Q{UeXkV1
zKwvu#pa*U|u4HHqJRmVKKhk|&vk4JUJ#HYIX&tkf9pI}cC_5}+Obw^KRzkuI0#l9)
zW8asLH&nuV%8zs^m<#NYqtrUBz^f_yn?p&@cM;thXw8SBuG_64zBhl(1%<6DT)+q1
zt`VE7ou2NVx|v}l$oI@V%kN?GapUQF=@dtnzM4}FWu;W+8s%&Oo7M@=G@1-|Bu6ix
zq&VHroX{S!3X^G0946oyfr$kSctT@@xFmNlJj|bt-(HbTCUIl0>;Tp{RCaCDgjoaR
z9Ai9*e^&3xa=u_Y`xk6)SC$uDRX6yCpw<lKifr*9GT8^IdhI>LHCEho%$<r3P9AN2
z-(TL>woHeW-PS8la37<THlVD8bMV9V?2pJf8VxZE*ivIiJ(EKGGaz^cB_d73eBT?)
zJ+)azz*w#CF5S2M+KxnEb^d1ULRw_9HUQD`BPBc)voOOoqY{{Xt?4pkIV=F^6<-EN
z^OMC)e=RZ%O@EiC<g$@MLb7g$!laa;R5_V65Q_WdbN7VspP>2AsQrh7{Xd}j|D*OV
z-2D5H7FhKt!urc=CVibJ`=3b5^w+C5sLVK|aUpqk>E`4h`jCLYAw0|<W8qz_r__(k
zA45_R1!(v?k*_qY9ZUO`y{G#~e4RSVC}f^Y=p-UmF?F3H$oGD>&{VAM5ky%W7yC$I
z2WcKr7f5}5KH9K8_zSZZFv9AAhk5u(d8(M7?fc9U5w!J&mf$SHq^4#UN|M*uK}=P4
zQTy0?%`;n)6c+h+Wz9c>`3YH_Wc0V)QPoIiIW~OkM}1V1$cChnsw~%wF@*KP6A*M&
zg2o7<vH}LdlW+zvco8JdIWoVWU37q!$1WeKZnaFiAJS_0K`eOeBvFO?Q$XgI%j1mT
zi2KkovelW~R&CSzke+q2r{MyN>)W-yBb@O%nN)8WQC`hFy!wQjtSQW!%p3WguV3R;
zGs~GRUa9!EYmXDE+@8EZueG;&_2N7rZ2K$5E90(L9fM6G<A3m$@#>6JseK3pgdBTG
zzgT;CMzEPO-;^5aU{e(p^>_vSoHUk8TBRso#-?=jsE;rcEzl^zA9x5(`w1^}<VHQ)
z>SDLosmaN|NK=5t>M1xcA}R3!Oa);lfaVsJ-wU#=cc+_84F7%9!HC#iah=G2lULA2
zeV^@!S8!SJ$&+M=CpIIs8(xI75{upmsV8ejGW<Mn1SrxW{wCz2<W(pn%8I_{CRBgf
z^Si?_-`pRVL+Q^vG+Ra<U|u(hH*1mp<D)&(TvIE0C1)nDCoMMx-Z0+!#y*`jsr;+h
z>LH<Y%;4D-?^#pc+=98V4P4pt0^S=LjI2B|ZMqH)2f*Gyf7BkML%gxuaiPTTLRdhm
ziTP7O7cWdkDGBT3@VmzLX+sNvY*{#BpyN>tAx$nQRwsqLZhYjoTTB8Ka=cuc0u*cY
z4_(q6p1VZsD?FT}Sc$3O@Hmh__S2UOWWWqk`_ZC=5TAt16{c|7i#nS+Lt*9NKx>Xv
z?{Wr&M&}3_On^CF=8!}qW(7+MJ6Ee>!^_@j6DD7$4<UcqRkiCZdvBuB23$G#Oc>dS
z6H31QE``tUmK_I=3x-;WeUljuxH&SN{Jk+iA>?hJIz#pO=?Cpg^faRHF|=hIEQNZ>
zq=Sm<1o{3MDMmW-n(m9v60*&&790v6j)y*?@HVF7<(C;z*tL&o$)ND1P+i+{aSP9>
z0++B;h~~NBKxl5WVt^0G{}xt%ckI6ptRnQzH4MLOq1yk2EoA<eEnKttYfF1e5$Ytk
z3QYmU8Ri5n3C|jImaKRVQjcsELlR$fwz4CKU)Rzzop(fBvKEisd}9*UfmC7M_vr)l
z`F81)JuME$ve!*sbuZQ%LJXp$mJ3ii;CA=H(9j#(177JMeHtDqrr9fI%i!a_k?xqP
zyJOvf5`rdw?a0lREXZ;QbY&$WIX-m~qI9#?ZbFW6lSt1$c_l{On&0g|4N1;GQ@3Y2
zbhUKr9vf?(Q6Z@irUFHZ1`C}9hzNO{O*PDCjkKc{b>s^oYlO#6OE>C5PEQM=FtThh
zO2eFeuo895>n+gw9V=af8~%&&J(1lt5{b2Jv8&c(ah++xsiV_aG?tbazYe+;5g*$u
z<qiz58t_8RyEU#}B6<vO$jp{wZnc0~%vy^qy2xPCXVKX19>k`p!z&2y0j?)kQd<iC
z*uW`kJE=`f_3bP}nMY?+YheY_Mya7*EM+UTDbLJW#jx&73y?rn=Nk9|^^kZw#DmNc
zZP~Ue9F$Gi16l+ouuZg#ZQ0fd3VJzhv{{0b);!r1{;Cr_tE6Q-reRWIW~{(qVjvZk
zSyi$@h0<C)NWr?GA$xGSkMgN#;4gXDf#4NV0LfU8u^L^MaVcRnFO)W%j}-pLg+;=+
zBP#_0AR-7|>7tK@2~A&%7*Y%$huP~E(Lyvn&5)3$DycLZyqF^rN7FR`*Y*9^I*CO+
zrpKuO;ZsrH<wbARx|fu_XcB8;T92J<EcEDWp;A5eurCeq*9y`<-ItV@8|s|#X(y=J
zmy1|(yz=gXrc^7F#iA6vyz-AZ48m-`ym@Yi(j18#tmJ(JSC_b8O3k2>$=2W^OK!1n
z8;Tp!1FoysmveOBuR7LWJT74-64BZ2Cf!-xVeWN?XubequSMp<sr-zz+W=<3*<Q8D
zmdE>v$wR8cvVH$>6(Wn(Dc-*6w?ufwC41C|8TR!7!qW|OpP*|a6V;Y+8y>P9=Ir|Q
zobx&abkhv6>Jl8_*d-#j=oPGkau)vT+YVYRSX2e{)`P!odcu8j`i2I3lRep1RD9dQ
z=!}>2d-Bx-u}k}^$I$p$fF9y|*W{llZT0J9Ov-p_IG$6c^d}W8lBw{bqghFV1Txek
z5%U1vdwhNd8FUeeS%VsbeG~F=!#;gbN}$H?ZrUIm?;B&MhH;Ax;g3E_)6}_4nC0+e
zgtX)NA-qgmE#dFtMzW{KU5~@k7rX{qRim$<U2a8J5obOHM`GH0Z-^3U%jPF?l(FFY
zRGv3j!7BU1cTwI`_PI#l`so*ONwj0MVHe9<?>Envs=B<NjsaTWuNzg|o|Vl<CWGPV
zv%ff^y(pm#X&dD&a?H`x;^!aB=N*wHckSYule3gCt@CapkvCF5GaqF-qB<>3$4CrW
zs}6VR%Em4}fy_=~f>@n%e36%{El=*<@t>!~a@Ov>aWwcWs<Y28oI`#*V6d}WW{?)}
z{y^=RM_b61iuDIOdq-(`!u;PN`fpDC`yg6wGyo6k3(;mM|FfTD`3uqKY8wu#9B7?e
zMbpigTAZ~}R&a{5JrtWOUw#tp1t^?8psDsxBAEY$Q(;xZD~ESnVo(%u4tS&10R-&x
zoa;x-`R&6-X||q3^RPPSS+lAv<S!;;bsb)W?^%Um_%43Gn#UQ9$+2A)g`GCFKOY)#
zpi(z>SvAG8sU*L33t2K4v-<tWcT~``AD~ev^<*A|rCZSbfMSl$LUR_#IphGQv(wSI
zclQ}}XG{A-ja}y?|4YF}oFhk#=6-;?O1MuYqgTbA1TBiQqbg2I)yQmw(&h202pldN
zun=vjO*=OSJ;5Ia+wjfXfXJjkiRB=vxG){5gC@D_)<R*!(Q&u$CNq$G4(?t8c9Goz
zYaNdX_UY`&u&zIFArkYYlp9z@Xso7N<5RFhOa&!BZK8fd=Fk<g`uObt2!{=1JNk$9
zf@n+ffm;;koR$K}dWCXSXKt(Uu_>@*;n~cA?f4oA8{4TRtL=JaN%<iB3&lD*1CHs4
za(`_D#!Ysm2`XaoFVvR8{<o6582Lb2Z)z0@>)6>3mKr}QBWY-cCWP3fZxeG<{7n3{
zS^<x0;=TUzqKSUF^P91QVj*z}D?A5Jd&~z>n6!CLdBj#)PljSHxMGVdU>DS~Bk42J
z)I0B~ngf{1@V_VN$jui5e7Dy?)kEGgX%OOhZMHc)I+E>%k3;+wDN$~Cx(J=JisFk!
z-dHS5I`VBQL`6+jJ2ZR&PN{Gkz{LfwKoKrAIuYjt-CS+UHW4C#nu|<?;(?c;YM%)B
zX#GHpweKP44a-+pY*sbzhRg6k7m$NWiUo7t5>3Xp5eo&(!)VFNWem&WYpBPW)DD6Q
zDkgq$<T;eno~E;Mhn##F9i9}Py%<`Pa)n}tvxjwoXUP|qN2cBto->^X8Cy#rXq{}0
zOM?%q%R0DgEm0G;IBQr^wMz@r<T?S&<{fUfjtq|q+={x4tKnVmR0L5O(@nO$@_Ijs
zZ_dpkZO%9Z?YSM^d{FYLCLrYtr4!u+;@<3gMm7X}Z__c*F+F&WT-HLVz!?bRv%@5M
ze^>Ty6h9@0j!NIisC{VYRg$s9a^6UK%NjA9#_H_FLQgP*@Y03<H1&aI*ufNF7V(~D
z70Vp`q%}8Wmk78nw*4;qds#n7u<f$sE(&Dp_J#N)SiV+9BZnT4=<@fX{ImV}<9rKt
zpJp8&s+h93;@3S4om(YbSgz0ZfWDC!gQOM9#p9Vg%9G2kD{^?A9h$3c=SfdM1Ozpu
ziNdwm;y8!aox!O5KDBAU#J=)qxQ7-9?Srt}fCKY4`wWl4n*NuWX;>b_9Nv=!eT7z5
z)jaz3$nVnOKRyUlU8Um5g54(vOv*;bhPcEupw_XGwLc;Mw;cT&CjUMhJ<jis+56%s
z8{YrSQP#gXs=g7I`!`3kmtm{0punIOmlf$ZY^;^#T$jH73V~xVhJeHt);PJSG+}wp
zJIOsl0hQah%HdI?d<x%hck}1X2XEvR@s@7EB<MQmpaa3p)R`qtj79e5Q0MU0OfNfn
z5PZ@weK!4$3%2(=VWp3|u9G{?)(&_EjEvxZdxYnUaA>Y&DtGEHxLenHq82Z<Lb^V|
z52GoQ@vDfSNrkyax~XxyxYGrXMH3$UnE253X|vQ=Ejj@#iJD(0w-O3hI2C4rDvZ74
z(k&i}<TX^{a+m-o7Q&9{pGAC56=){RobY$F=DsY_hV(-z=}_h>dP#Pv$#QPr41$W~
zd0(T@`*vd!VJ}Q$q@@hNf6&iQoCuJcFkmKvI$AzE^7L;!|295h=*XGyY%Q>ab!J__
zOM#`=kQJS<VsT$4#+9*g6;Hc|I9M$lEiG`Uny9gK6b%y(gHTafc)8h)7S(M|QZ$cY
z@-^R-G%&Ag#f)FQhmow>$R<cVO}kxHH`pw?7PP)0yZl3TQK$tsKtle<Eh#`U>USg`
zy>=U$wM{tYiGn1vxpufQ_7NF7FQRjlDTy@nr0NB#s(z}lE{gyw3Z>v{XbX`vt#Yym
zDKdI1)gu+L1OcBx2%j}EfR#oP)zWi(b?0^CqI|v5;N$mhsI(c56#SW^F#oe+GVTQK
zHIM&tY~1v{F>7KAgw_yv_sY1enE)(N{W#YYwAa+8ERW84HNHOl;Y^TZqucBwxaJsR
z8*Mz-h@twng&K(TC3#qi41?KQnY3;(i+Ab7x;QpxJ#P1EsY>yprBa)KGtN8^|1t)8
z_ENEIAPlb3_EWbd{Aou>FnoC%M1)n4tiLm^T9to;^}c#hw+DQA7sRPhk#oOG&kH=A
zg&w-e>#uV^5qPU=h|`u231Zj>rqoqonDXLN;Sfb*Efl;hz2+?aZ^czQxh=m`Y>`qN
zabl_YWbC*q&Bl3y2d%b+_S+!M#-X){BJ${CI^GK{mdyzP=ez0NR&@~)5B9^AT5Do(
zkj71=@7ZT6(1ZyarDK7$ngcFB9=hZO)-(f1oABa74{DO)uq8CR*Ti~bD4;E4F7U#5
zvlS^QDt2~iu14G_Us~FjU2R<<rj{~Fz&;$qQ>076_tN(`Cj%>u+aNtzx1|o+?ktjZ
z&S%TsvpiWZe^ec0ZkAaqU~`9!KHOWvCu+YmNOid!FEPBY#;v`juGv%*;r1V7<mpBP
zcfPx#sTKKbv8Z0)7ulN+=-TkLch>x}T+g+f;)iM#{e;-W(I*VqY4`&Xh~!h&Wji#h
z6l-Mki(3xc{Wna9wUVFtD}`NZs5tl}A*#}l5r0W(?|t#pVd$t@wYCh4+g{+|w^+_9
zv4B<5K9;aB7ru$i#<zgU9n8!@6ptdy&8N^CMG4%1p6<351h_FlP|$l~CJ@a++bu`y
z@BGtZ?>#i;Ew$Xqs|^zigj=5<_d}1qlfTLiURI*LNZ0M<qw1-p@`>MlwpWNxaJ_*b
zA=;t6_B^&*2D_b!;9ifooNT&Em`Q-zkV*ga%w5`h8-Z_^36;@>Vf}HU+Z16blkFN0
z=tNSP&gTXKRdF_A?Tgb6>;_@D!LJIBQ>y4p9!(u{EMpQ<ctFNPtYZ?Zy<x>nQWS~f
zQ>C5_{cQ>9qx$*3PDB3Y<iC$Z(AQJkqkKiT%~1cdM6mrO5e+IEHmi(ZR$EbR1zfcx
z9*HQsM_7<q#zKsB74ixNbOvv&4n9yO@j+v4@9yig0Mcly><M^VSjOJ%ZN??u;r_&$
z_QZ4&jW#szMG&R{q`XdO?QWU<;RV}cJi=_qRUBi_adTZ!>#fVpNfe&BicW0DG8Py^
zGeK-k6Psu><KjT-qOdNM1ZO&ZaA}yoYC~@UiEfYcgdG}~w^n?(C#2^+if4_M3V24C
zfuf=f4rMr#0Z^xoszTG|zErz}2y3(bqOTy6r^HZZ30$7z<O6|2sReBBbQ=G|KtN(>
zJPufs3M?n9XYQYh-1&>Ahm1H__q_C;pXX76%I5fZa6Dcd9K}0>!`4@*x5{ngc^e7~
zF5nE)HfP`jt80{vOs&ktW<dja^=eaDGxUqeQ)YW?K)lcvbr#+48M6EDJwk5dr2}Pu
z5~+AC`@#1O=WJ)cTd;7hDObvcJ!;^b5%a=VYSxZ3p#Rx~cm^v&jYFO@(SL|+#WW{G
z2mxu2<k$2}cy)zEJYF@5MDZc(mu6By&x%D3O-dA462>k41qzxBq^02!xi{RB-`-9f
z?&Y=HqA$-iO)t2v@MKHUMjy*;K-H?BpKaMA$&Zu~I5*2by0xu=)ObfkG|vM!IdqM3
z5je5y379CXBRYOg9;v^ilvux=Q};SHHBUF5%Vr<1d+O}aC(pMiO+8q!$UE{fY)?+2
z>7N1mxiJ(D<afJ7X7iO@>U-|g(`+~@8JjC9CIN7Bi3BxMuDlXC0i+#CvEXHr;k;HS
za&m5AQ$4WKn0D`UtTVo5t90YHA68s<fkgf($%A2hk=fpJK7jBL32yP(x8?d(lS$wW
zDbM?zp{XTAKA(&n)$3y~|Cskgwx9T`#V{xmbNYOvar1J09FKb|cH45dK2uYk8yu6f
zMybw#%ky-YJ^7qsT<^;<7qgISUBkLc81j0x)Cj@(pU)8mPm+mfiMT!bc37#Jy@Q)X
zIAAk+c2;_Ri<Jm;HYP=<NQISQ>9*Q2^B0C`oUuW=K|&GSrQ7kk(IdA1ThsY>TmAbG
z<rFi^_2BF8b*5kEx&EikAojnBqC8`h#)#&<rAqYhi_(IKEVx(#T|9-t*}A@-a63Ta
zN6&*5r4*a;iLG_k9AKrvpT+Wf3E~QDBj8bI%W-nye&xBbvK$_{*2ro7R(3s8#BA^;
zj$x={Eo~m!GfC<9L9;<Zq~~`M&%<~`Q!lczH<Zg|4fS6EqsRnnv;|L4#3>cxQGcNK
zf_l3G!f<Fg!pTR$KM+bzVV*0$3$rqmYz#&`_SfZ7F*6yiv{ERsN`RGA2i*KA-LD-R
z+=`EaB_WOq`)DI;*fX-)QvSWUmSm5L%jot1_RBParirSu2MHI^I^j(eDc9BMR^kdg
z3wF=5AqBQ<+}R4(Fz-R^G$fU%P5{uGynzwZ7+ic0gQm7tbH2JL>l@n`TTxp(_?t(w
zZs8ucbLC_g-gaKw4}oE!ICWR2@A^9jb9pFhm7S<c`Dj>mJ5P6|(+EJ_1wcOvlxmVI
z(E4b$eVSOMapGvKc>@_5TGkr^o1-<=@I9oSnX6pNg}c;x{3fIG4nf7RKTq;&cU`$3
zulWNlJ6rVH5s7jx1s5Sb!j8+Sml2EOny%R{jzc`I<a_8WncL9|F=TORxr7G8Qh-)f
zVud5L9@wfLXCt(;4dxHminwsS)*>w#?)@y1sw#7p5G$%~D6v~kjHlBGv?!u=zcZv9
z*(hJj*-I7)Y{l&U9GZ`BO4JEvM$e6dAT~z{*U?4e_Sn!|q8Q34sHYa%TOHd4zHmBv
z7=kD4CD)%qa}+wM2&Qwx_8UkPPIy7G`$DgSeg2nX`gS;j$DQT{qOv)yj}IqvdsQ)V
zF<mj!Wk+^&y^*a6r5oy&@*rOcUx*LNpzIlV3F>&RqG>7uq%7AFqyWm#xqRR2?4dHu
zNG5^t?2mL;(oI+$_~+Jfu=w&Hl-Ol!OCa_S8Bmjww|Z_i-*?%YXK&nm&_r@D8<_;G
zH!Mm;CYssl6~X|&b#0~NyN!t)zRt_&)HjM{YESpTaz2CpZz=J2tNi;=Vq!FWq4sNO
z+WUVI@p1e`iHWa>FOLnY<5H3Fu2&TdY!^^B8BLrsmtqyCZc4}xyiy1oDp|W^V`}=)
zusXCtSwhzBf;Ti62JkR6dOi~0a^=O>_kL=ogSGaj9+P0j^Mkd_-k~8^*OB=d2#5(o
zhGQ9&Ps|BWa^q0bXM1wHAN%<dhrU9u5zDy*CNjV<^CQb%M>my1%CuSdEMUGFrAr2i
z9vM^jcz&Gfg`#+@x1N5CSt>!*<9p@<wj4z~_rMZaMso8mJoEtguEDca(o(r$*=zLz
z8nZy2D4#Bh?t)u!d=Vc(a%-WU6ET;c4>^h4kVv6&F&h52l4iZ>&Ocs-1I0<wFnuRt
z;Wbvu5nE<Fm4wAO9!+l98krKMNrLQagc`qB;1u8;O`qy5bI1M!CEZXn<<kHBTAI>6
zn~(Cg?`y0&6{c-ExpYCMP1-zUPuPGsS}I^G*EJ{aENgSba003!7Ui8!jqm9tx|k|R
zNC>cfP&aXA`suRn%VqeIl{}Imp7UCGIM=eEk6r}D(R0tgC$+_+4%LD{a>$eexw%9v
zNB?eMzA_fBO~iXA%Op`yDqtpoxi8tF!y>#@_E+|l_tOvzH)oxP)qXH`yHR(l>FQUY
zYbh*ZxMJ-zx4oXf5gHH~m<9>+F5Vk`Vp?QXxoPe$*03C^+9i?evPd`M7;AZe{uW(Q
zcthb*p_g!`HIYMQpU6WL&U?woPFt#craf*_^l+N`{biEDjp|3ZY5s6O$=Rbae<nTq
zuaDjDm6wtNx{6!iKu<QB$2Qws{0V|`_qy?3V&-BhThW81=3V`(J#34cdKo-w%~8&5
zYR!<A)`mL}rv!bixaF>Jr`FXU-^#msAcm@YAaDu#LaHu^Td=|PI@C8?ij2TZ=m#>-
zsq50tR}!}SsfReol?&0`{38hN9>VTo>e3%fU1g2rhSS66ssKFPiM&~7#(Yg_J@?QQ
z1)Ggbhj>3z?vS+6ui(&8JHBze@)Y6vMZ=a04dLDi>bYOCaa0K3sdNzTD^qysuq_ln
zXSh+axIR$&LB3TLoa7!2m=azMCjr2a9uDddp3KG|@d(|#q5D8})~>-_klMp+hhj8&
z*ATc*WxT#;Zd^Z4AJdDwbuVf1N-S#ry7GH;^~yZ$l8N~odbUeNZOK5@CXLSGMCSg9
zYWx<A2z*+NoFaDKt99s1@_{!(_2H7|=41_CX^$GoO$wE5DZF$w7)pvYL^=i^kL7du
zVPQ<7l$p#iQsfwZd8l<s3(07`1vW`>Y5;u5hu<z6AB0r$*hq81sgz>3I(&18C;v^T
zXgt<+TQPytR`iX5bdO}J+JzmE<#Mx|K?*4Uf4V!%uqfMZ@6(NRr<8O_ceiwxfOK~&
zh_o~aN;lF<hcuGX-5_1kCACNH=YD_@_rBl#etP!sfnz?LzvDl1%{te0t#d^O#L?_9
zJ}2*-av75Z>W(`)?sxoWA;dnfQ6|$pN&CvT8NFX2lW(RQG4D$i6xkGBUF`K0^Lt%*
z_-nFO7GwLKOf%0`lyUZm5-Xs)JL8LpLFgGYZuYZ_1+C%+Z3<wEH&HrU*LUZ`fiNfq
zj}Ub1Xt;QQ&A&a5W|pJUH*985RII>aGJaOCuNkd9^A#k&j#q>D>=C{|cO~!G<`>a|
zLXW(W_?~CM)R8`~gpMwSFeG#FSygqMbe~P(P6&J}?9R!*2FgbKe@_y++4lbL?D(2P
zWl?T`9iQnR?D(9&cKkZPj-PN7jMQ86D-JwGA!c^sf@<gHj;8oP@e%~mFoDX8rZcRL
zJ82ydi<C{ti~<o(%+%L0wh5sP<4f8}%#ah>;osVqnL_OvEO{?m@YEqal7v3GO#RuD
zlpQRnc+-$Yk|qs}h;>7`@uilpHaqzavE*v5&#kK{h~b>Wa(>1iY~X`n7E6XrXlO(V
zebI_#Y1h8UqKS~dpiDhL7|&jRji2K;8<Hd37T0Zr8|{W;V-JWx`bHr*EbwXNU|0;~
zJvPN4mudVsAgA;FJXq$4I&{aSCi~l(s-yZ(KRv=Zqaf9JZO7?sraAd^-fYi8(W)qk
zE`ODi7~~1+iiV+$qM9u8wWH%$b2E}OTo?it2HdCeNQ#KIES@85duP^?4rk~n1I|h_
z!{v1skR{<;RhVN*c4K(OHoBie$Kn{&-#CNyCn%TXC3(oUTdz;&@Q}tk>5csC&dX=M
zYA#Dh_awWFpKVHCp-ma7f#r{rcgKS|Lp^+A!XVzf4?ZO(VdpE6Im{Cr3?B*I<6pSx
zR{ti9s?->+9=_X<0h&KBCpGx3t4^@g%a4zrw(Xqqk>=I)6iCGz<{RXh)NDz2>_@K|
zcm;ucu<r_pJ!`7BKCz`f%Lr6pVremWyphSsH@A-4?G}TgjUUy{kWL%gVEScPBFcW7
z)HqT88Kf+&)@#av>Ud$nD3a>0=w4hxMZ9_FC$UdWhc4X*2`)`>rj0o$HkqY;(T=gn
ziB(hSvnQQKb1-~NChB*tG9RTHbsFGk!W0|xw;xK;WtB<zmUU#~mRDo$!-knRe@1#r
zm?y}({Rpn6z6{sbB!e$`W`UDHS5J@w8|ip2@ez`<YwV)dte!wA5)8LMC3K+3pe(o}
zw?HvCy6F6e98h<H)H(3Ow5L2z<UlSTAv<}aTDdAFgQP!VTmyA4@-k5LQDZgJ-u4D0
zS{1d|+j6{s3DC~2Nv~|1C>cOLk7H?dYE@O(!6*)dVgAa0em#N=AC~_(mbb`XeWe2z
zHH7wYQwJR2A8}L1Pm~Z^q9(?ph_&W<TgS7nXkpr38{RF+iMFx|B$X=ZoGWtSjJ62m
zQm0P|O1`DQqqr*3H$E<s-lHSYxY+g|u(T!_s}gy76CdOVh!aC^ri}k!{V8yM?6{i(
zMcFMrTC@grwITs=EFilDtOAKP=WUIx-o;Flg+mFY^oN~Ss?$s*B}-+p-6?o7UlFW~
zXE}_o;=YC8p)`bc=)_Wp)Xpv;iQDb91-?Da!|G@7UkRN#$V?9{_}ZM%2iC$e&@Av+
zL`?7PJ|gc}1vtb@boxi4-DC$suIy#14PNJ~Gbc9JVe<K@*P;w%tHFEOSyrahfxi0l
z6DV+@{XX#Ez2I~2>3GJ}s~-6(1R6&=oT<zrsPFP*i|BA(M3%*2V0t?1MCLHjX;d$n
z*nMC>Axxzvf-US))_JLJ?4a@atB@*zFWA%`*b~!1GEa+?E-m@z+8<Fn*Tl7FEL9?x
zq!dU;RI<M2<wo{G9R6^pfA#;pao_A-|93WS_BPhjP(X;V2aw(QKUNYk{uLu^`jtpu
zcR~YmG#?!sMeAWiI@=hfCi?oBvjTVBQ`9;Np&(jGZs%Z-v%+JCeR2ZDsIl2CFy~EO
zkzm|<w*zC!-h|4j;0#2S_#pQ|_+lTzbf?Ess{FF<M3~hnhY@U<^srd0Nr%qLC$qB`
zhhkx@3_BgN1&CmQn&F+TS~#Tb*qa8TH0i~@nXH~#a4IO^#TzJb!JbfS!HbkI{#7Ie
z$CH;EF_#9_hQH#3Is=m|#KHCk-u1dnx!f#naPi8@;2~2lWjeRWl3Y{YYFP3vZ4E=I
z3hh7%F|2$MVa?UkZ$ij{ITUPo!$bok4qwCCE7R?lKHR&}!ywhW{Kmd^&V~@(AWPIj
zfoJ-aX^(Ab=d<0??eLkHkV<Kl2^3|)sUR#@Q<IeOB2ZXmmbYJr%s<z7HC3q3)a!+E
zL!UP0hUPs!dBG9sLMBxep0}94oJ7fIrVJn0?my>SS!rrek)d5q#faIpY50j~FU?^l
z$fzQh(q*($9D9ZY$H8jFxINb+@_50Na=sfDy-M8Tx@B6ph8ZU(a~9sfnz=Vvt^-Cy
z+PI%P9Z{tt^7SG}get)zi+w~HJy9S@1Fx{Pa!i<GJF*LEJ-uNA+WyDve()!dI<UH6
z@77SiYv%Hhp}!ICSFVM=s+3FUQ<%OI1@S|bp7ap)GJ~Alt?R#LB2vYOd-O5}Y1)n3
z9w&L-UKSp7HGT+j`AMU=Ni&10Oj6h^KN>HVg^}u$miE==(&e{naeT0LE~v(>{Tbl>
z4XvP*Y4b-|Rn#!gowJCvf7q1zS~QF8trGtVOX8eXb~>&-k>uG0ge5m`!jgK7U8ScM
zE}JpPdHNVV6N{Py=jC-WvfWaF85a1*Da>FH^eNGTanaf^9&kvdsLx4gq%-2nE<RJh
z@i=}sWB1BZV|LIG^-m&k=#>hdEzS?`bHvdW!dj~W`6+6aew}7o%GeiBy55201M#zw
zMfO4gVmaXvv;vFN_f4{%6VZIDCDu>e<-fMG&DEW`t9pUL?=7<M*1p_UlQ^0*P_HxB
zO|gw6H*)k7&-W}Hx8)8N8vCFxZ(@^2HVu<ubRq42=|uz=<y*L&j8|#z3e?klF{K?;
z0`s;dKclDQM)_1%upmr|*$Z!tFv7i2aOA~pvx@iDV&|%;TBp(pvONmxI1i<X>Y8!*
zpcU26Udg&|=!5igH^J+_+0Fi8S<sD1|KHip)|Mm(I04&PDH#X|<-ZD}Z0*eey>RW7
zj2s=!tW6vM9RlyYXQDSSv)<O|0~~x{_qo&9eA0^LW|CJOk5Ocz#6`8rK&9SRt`6#+
z_UEwwhV7AAH}}H<3>1ygmtd4^BTdD2i=l!480)+{D4lZWbZ+M)*g*R#v1$WJ1YG6|
zd|{p%3x*q;-6!_?elgYJ>0x>;@<rj3iWe`R7Awzv1y$-9h!bqcFgF63tluF4sZmv9
zg}zM7+Q$abo-xfkPGY)#3Q{^D6QIv9LlOPy1&EB4r^tk7<C}M9AT#=5ZA7Jk^`HTj
zT;s-tgSmS?D|CbgINx%{U(~?1e-vMX*zevf_Wl06^+kW3@N3ZKE6;KJ(;s^XQw)LY
zY@!h;xZ#|vU~M+xen0w_>;}d_x;>zU4E!mqq!v60(Ea&a@>wY*Lt4t3Bk{|o%!d(>
zbviQWP#_VQhaDEwLz;Fnn9>V_LBDsy5UY1W8I0#wv_#lYiQzLYvSGFd5M+u#<|n`z
ze+^DU)S*|hvy?#Ar1Le08f)V1vmd8d=bIFyo|>S9(yq!PejHm)jv_-;_|?I)W9}Sj
z+=B$^vvKVg#^PtC7XB}}TLsx|eMS`v4>{Y)%PI)g6HF7=rUfy<(m@Rn1`v_kJ;+(5
zZKXd+AKLm2r}x88uN|?4d=lw*pnC-;1@>h?zQ-R2lj6mDha+-)2p&S(TAT<E8y_p~
zz9H|&Pb|L(vvp@+U5hcIIE8ne+t4{fnmFw}LudE0OtfKvr!aCR+=bQI4T><V;zc9r
z?iyL4mm}{9ZTo?<o146h)0nk(PzM+HWNhM;!@x~qz~X`w36oho$KW(Jlbj2KS~@4=
zG&b95&Lub@&u9rERfD5WB6*nY{N!!Pl`46b;(*1wvT`)GlL1wTTvOG-f=eejDpj1}
zGKpn@MFMqHGlXG~0rp7MbrFRa{wy%h&+DijT!OPvcItgcuy$C~OEt`K{_j7jx1^1S
znWHtjB(te)(_qTBTni^laKw5?uOSny*16WjMSaxu=UcFRk?az<xo?8m^OmgGmNG*L
zqGUx7X~^4;s#gAy<>#(;AM8dj_ee5wYW4h4yrY!~x4K9Tx%307Lpb9u%={%u=^D+!
z_fL{Db^AK68xAl;`Krz?fjaPczk+g31=J+&0!$F&Ze8NPDw1zXkqecc$^B{xcR*91
zZ4Xu{DwLl`1?Id^Li<kfm3M*+9=w+sk7R;ZL&cChM6Du{Hc!QBkH=!p-uL5Fj7^Zb
zvh0o=wdlmxxt4T2MIFz_!sGbuS0vwSQd*>Tc<i2S?;9+v=#J2$<MCsOjv`lcuGX6i
zz<U`HypNdD9QJ8Oarq+l87Wh9Z^F>Nr96Uyd$iVJgTMz`*heVinxx4=V#}F^=F}`-
z6}sp(gdn-%oWyFWk*kJE9+%k8C=9Yowug{f4Mz51inX82s3=>{dlcMY+Qs%(l(vBM
zvW1i`7b4<W#Kz*`(nxnYNzjCP8U%S1DX*!Go~JLsT`Y|v+{F=oGS&Di?0~6=z8^37
zod156=;(4Bo8X7ljCj(sz;(rM?{cEtA=l@>M{%VYwZ<wIyC2hrj0>{Fy(=6AJBJJp
ztTNEliNZfSTWh*bsv=CHoI)gjYCNa!Z^QluM{o)77{;fh%F8;cJxa;VxV7*DYf8&=
zin`V$ojiZ2KWX_9e<%t6Gn1@cjjA~MPCvINjRB6!&FtLu*ANTqE%d;L=xl59J%5*)
z65qe1cPgK5F6`fK1g@F!rn(eHgZV?*Ba*>kQHUnVL(s6LNvJ8ZrS$Pi_6$hq_Vb^Y
z)hoNnV#m!Q^saQ~8nFJe5SyOGUoV|CcOWtlW}C5j%$Z1oglo-<IE3igS*j!oh?7}}
z?87{=IuJNOJCO(CB(Vk|s$+81P`-h?D<|Yl<{et?I_sB|j_@Q|^-NfWorV+C^y2V9
z9VGUz5}^c(ne2f%xUMt{Z7^BTFS~esR_;b^QknYrwRRgQxeWRFcJQyR!<m4P#zVj3
zo2rSzm>%mXMg;F254a|*6ijj)Mg+k`lI}^}3RZ!V8H}K?@~$X>PT7m&Xv12nQ3RMz
zI)~!>q*Rfbvq=`BngUNk>GvlL<I(!3VRFMouU=g5UMa~YnrJc_v7oy_(>G|<X-)bm
z`9Qqb#w_Td-r4q1Y^VA7Apsknt3&Dy>w*4Taq5U9urgIgzNA-~tkGO}TibNUm`$&b
zzXb>s3+`eDQb~6%yj^%kpw0{U9e>Qvbef<xY;%!notWSSYkg-;H1J~!Gy2q{R+L0E
zvWGcc15q?~K#=j{z$_)*8qrF-8g=h+u+6{$N?n{T=!ZJjH5CoUOY_rG(n$zsge;e%
z^nvs6(!#(UOM$b%uC|Euh<fKAZ67brN>Owi?O`0a4B?kAdR^cK+u9!cEvU%_Ja4SC
z)R$aj3wtk?a7r2yHgUzfiu9rvFXN>vQHe^3uu%*M*@0IrC{-`kyX%NA1Y|Ab1$Z_>
z?*!K{EURoHs7f^EqNAHu6+c9ihQg1?RU{RMBx_gaZBD1iNTO6Dome!7rOhTik$F1e
z*7*j>7nPBPwrc7_cq%9<TAJM!avuDlf;mVCiV%$`1mGU3756YpVG#K-fsOVBc@d}k
zdGFyM-{GKw_5!<c$|SnvngUXlq&Qm@Ve(G8(9o08pNRL*cnAe$-~G>Kaj&}Ou30EU
zqnJ(p(JX3S%8`2LlVE+p#Jgt}khf-0p)sO{|2Pg0SDQ=~SuP%lv;B>tAylHbVc=SK
zCcK%CcGqw|%nB%Po|VeB@=rF`QpSl1^W<LVmVaOtW$(y+^0QUnx+DNK^osOfidqMl
zMdu&P;wDqQFh;><iWs?l?u07h`Ng0gS#&m4u#!`5MV#^57{^IMszfUm1Q=UPuXBQN
z>pa$I#c~Gk>e{&(P%nn!@K6$HTU}h8rP5B8C#lsaifW>-8m{*NhT*CAFT>z#(EVi?
zYCd|Oj^R}eonV{=b5~hezR86^hE@z#`9oefVqk<_3Yr3v7q~7Z@F<+vTBoGH7lI>k
zee(88ep4k)oJ~s}pw%)3rNP_!T1x)8^kylB^NnFl)qw}nygc35>b2Hk_TsiAh)nM=
z#u+GhP13!lhdpgd6oYw~vbz!Vwz6)~;m}iL$4FklI2^}a%|Fe>|N2-2&#+zbr*b&q
z%PWqlc;8+UY7u3&SoF|CGkbnjjIfl@HG?SV#32eTN+Rbpr3gMtd_^4n^4IcspEK<U
z#N)&g=1GIX3a=U#kY2P{WPs~FnxJk=W0UeGJs2xz_`0{W50y04#GKfOl%1&u3UTIC
zT1`5=rl?vdU2JZ@qSvcr&7!0ekx142;gKR}R}=?jQyR%@*Nn+Hlrfn-)y@=!Mi`2Z
z27}nj%zGtf0cu{H)>sI|AH)YSsF<qEA3y$VG{<E^%>yPg0tai7+cyW!YZj7h*#2&c
z@%%DkFg*gi%4xFX^cuV9Y)NP+#q<cMuHl~<#JyUE|9pdJ`f^40%TJvB!60r@jtgU~
zYyd6l+vg6bWFzHu3uSAZee%{@+oD_HFzARHTgNDxKZo|w(WMYhNsb0#48zWjf8P1w
za_!)mth<8;%Uz~yp^|w<EDfrXD_Y1V`qSv>_`4|FQWdJUxu2-JfK;(bU$(K3qBoK%
z%YvvPrwK)ff`)#JSt=s6jh4lf?P{EJi|;Z&Pg$hpdn2`ig>tDHR|nZIpCvxxyXdY_
z1@c0tk8Repj@3-FC65TvcEM!jvBiAzG+I^+W{lR*Xx+_n-YL+C_X}MKul4iOM3+qV
z{*H(#*~}%p+BTVb+Vl#3j>q=#5Eq{qlE-15GwS1pzWy3}BKMqb8we>6=ZL{<K(4|;
zz=ZPrqqYof0rI*`Jwv2urQ)t_n=%exvgeoh>}MiTS~YK4s~GhInWwkF3Fn^<s&d7b
zd_ob!6GwY`$T2#0zM98yo@Y~Te}&W}w2w+d2dRmDHH9;5;N^IRw4Bg8NYH|x3#Jea
z8{D!D@QG8fhHor+{8yj!t}qbWU)3muV<Q%cohcz}&Wk>>cso~FpMaFSYtPta?|OY;
z*;b<Ti2(&tjojzB4?;Wa>3arOTAJ?U)OD!Nri&kxa4W@_Hee<kxXDXA^;}!y(Ocu$
zS!E8^eA@;jbEl8Ct)`i;>ej7W2mHRqSsVl15&tu@xR;v#pKlhN2c8GufGnY3>FE#M
zKHa2Q7XE8;!vTgWef8F;RU~p=d{HY&)hGE}(Zo<*vjQi}?&O%29USgXXVJIHu=LJb
zAKYw=c^EbWlq|+kgob-nmkrn$aMS^l8v^n!>aQKI>kU!-RGK;9RVIXKiP&sLUtxqA
zpj$3VDT}^YQ%e+|5TN<~&Fzz6zK$v6AQOHS+;^<k75)sX2QFVQCNW=pX&|444%Aa1
zCU-|9n+E&7p(%a3W;ljA3WC~b*gtMc^cGQt!bL2L_vcFxiRZ_soTo{1{+3tn(@@ze
zDztFMqVOsTy910hdygr-cKMr;inY^;@EOwL&<=GoKr3AJv9%%nUfJz)GH=3gXEDpy
zxguPcoglW%qM-w}WhpA0GmCu=BflIZ*`uJPC);O=1v0G!$58uCIpjI769~pXDiE<A
zTO`vD;_h!eZGmXdalh6*n#$b}H;L2@v<i*r=g1)bwA^qckUuoB%pbEO-aYP5)coGV
zvdpsrnRKXvjerXFeJL3+?yPG&`Y@CsZUwg(8ZORyaCunS*N&zkgyt<Nq+&EaSl?7C
zmh_@cnfQ6-S7BEquVoFeI<$_4_30M3MYtVHP+Cbe#9cupokZr}9DI++YLR%M9I<U4
zsV=dSThCM%6JsZ&AXeX!|0Pbixo>09L{JJX+4tJ{TaW^H&;rwQw{-lutF7h(e)9vo
z|IIDcy%gR5d{ddL6@P^cFqNf0n95E5V4<=?_z)w)t5r4im#GYv6aK#a<Ibo70utQs
z$4^14+blAqqbX%wXc`FFb!?tkOGM9;TN|98*N@v_vA0h)f`Xfw#GN_vbb?wf#8fOZ
zUss>=xTk=Nn!RJ`{myI?xt}nS@0Sv-(AXKfV*f#f>1Q>vva-4~E_ZnBOAjn_95+0v
zG#^jH{>i`z!+qId#i^~Bo#M_DP*|&&NIzXL*fH;_OI@tfPK;+g>bw#H(E_=H$t4(b
z1>?9Q8vC{0<1Z&#;^r$~p+%if>7xnc8?p5?cHzcpP{@WUy<dwS3^*mN^TZUYNAiT_
z#Y=VJ!u4H86DFeOblMJv2HV80jUH6u6+OI2I>KljeX6{bS|X^pir&|0CXW$Llw{5w
z<x#ON-;4Ma&`dTvbSIXKwCI(oyZ2bhF_B)O#f(cJX8M7Xg+#ubA$SRP(bWmq7Xmoj
zP0J<YrnU|+8WVJ=_m^6nWn9U^SHk2Moep^&s$;Wjbz)yL(Beth1aVU-Ak?}7ZPX1R
zh!PF3#^AWNA}cc5rNn(vbwZiS7U9Xid^=G|WBG|SG*j#UgtbhbBj3>+Vt0!<`)exv
zyr5pU0hxl*Il3)x-^@=>*nS9TW0m;=GeNCExW}q6t#VDDFw3$kIvgt?{4%BCm#Y2Z
zPIdVZ?Fjkpk~^Axxz`(rqKK32>U*rX_P^P0oN|g}rVMYe|8MN(ULxv$zTG$oI2}9&
z*bNfo!!G6~qpnbSDr}Mw8PN1DWWQP31yMPVT134(<~R#Wc^rvx&$nuGJa!x8>^v+9
zLRCjq$o#oy!iT3Oz2nLJiRO^dj=H!>;S?u}D5>-z5$-ABgq6>K@P#x&7eT6tz2Gw+
z2q(m}S#e%@2Ld<xs_mcvuBjLMK-7=*<fJW~Ld#6M2i$5V8MZwfLX(D#AbhSgUOMS$
z?>N?Vvp?ez5AuKo@efR7rPz|jzHC$T<_!V-Jctb%vzHaAUBRKKcE`?}$cs`$^<1@|
zE#kiMKeB*UT$&&Q@3Ht+8gk@68|oxz)^r6o$M3LL;Q%ljg49Z8O5aXS;ngmx!vv~i
z9#i4*NU6Aut$}60GdgiuY^soN7nIaMNAi;s@O;~!h9Y>;Tc)xBp4pz`zN-3@;~ZqT
z`kx0qa#09av0mxxn@6dViLTO4F0KulDm8;9Auc!2H`faKW(~Z?g|hexUl4-2ruWk(
zO2V$D>H?b8(q>)7?GT2^nsn0%ei|G)U=(Kn-Ci6~=an|7jZbd0q5u-YBkfLE4i4NC
zWom~n4I~SjXYM@cdex*eV7W`eq-5?e{?rt(MiV~6S?1s4X^_{Jb(O52aPI9_nrJ6|
zBnR{KlM=Loc;*N>+iXLctF-z?Io=e1PLf<0o_s*!Ex};7$QnzK%G}vUN^~)-yrAm=
z6=nt-<k~OF&Te1)?B}X4-6Sm6xrv!#*E>*iuMD)c)qnP30w16JvwO9Bxtjm^hNPML
zs4xRyM2mpQfmnd}-oFQ-Ihs0I8CdI^S<;)^8kuaXTG*ngp!3ywuv1y}AXCzzLpRql
zH)hfa(ST8yO=iciWzrSf`AbGWLyM=-cNvP6O^W;}a7l_Z=S2&NL12QfT$UPENRpZX
z9ta7C@B*d$6qhi#__gZ~Yh3~4n1(uTkDWM&dXFDxy>$-kkuM^P^<71C3(>LtU)y^U
z+iOl)m8z>w5R7D1NYQYCluae2MWnETus|9PC>XQRKL0$Jx($ulCIGc0<Ud62C*$lv
zu9u-*RiwiOhCqPSC$oJ$7Q28+h6NJs&#@M({VY%m)U|<z43J9w)Re(IQaG^Og`^ji
zNw8Hc7*APS$gVCpjwVqv0FtRkbakI=CU6R+@1tA^JDEN!be7ROSWv;kYJ@UOXQs8i
zGrvqnoA32sN0*S=NAUt|vWL}6VcL1}W@uu$)2oJ-%SMTlLtMQi*p$wdTlxL)He~{H
zz(0}l7?>q>ne12{jM57yhK_GXTa_z#Xr<QYX(n|$vqE8UrYBy~clxlt2?~^RgVf53
zM}oFaYn9scb4_H|CJgOUk?3I^RZnCq&XNjk3Cd5xaBi&*Btm-=X3lC-B)uEQIea=j
z8(|r~(ufFkq4LgLCLN7TG{YdSu6%hzn_0Z=neuAXJHqF=bX_(`XYWb_t0S!p#uc!Z
z@g0LlnOPrI6GLpIGo1}so4^)s)3(CvQ7uA%`pAdZ!Gqc2Ak2F+GcIC-q3{y!z9ymr
zbB8QDeb1eWVwLOW?3eK!B17;4uY}1WbuQ-yoJmF^apz+(#lRgNMah+D5=8{4l89+>
z%m~yn%xJg0>f_9#bxo5+yHNq`48>VRMw<@ARr1kIWVJJG=wu$3k*#?rPWaEBQ8XZ^
zs>E%H9}2vlpPy%-G5wS{xeR!EQZ9Vdv(cTh0DZ={b$%8N3+3g*A0)^Bo{_yFN&&5&
zj~t1L>Wv{{-D%f+>njkqCbC%-8h0=}do)5#SpAnHS=4LqBR}DW<9e|j<5Xf-;&^?@
z?xM<XwOVnuC$g=rnwehJn|H6${UL14Z~}FrJE%Kz>e+gtJAkJo&6{gZ=l$GdG<4+I
z;JdZ9&FnR5v^_`88c&^SYh3rXwi7zHIzu`>_17;8@^Z%%-JI5r1mC6$C{p8lmyac0
zuURsOEul@Z=2QeGFJlY87>O~J(d(BPL$}yx#XxW0ACeJ%&U8GQFPpRp1?NkqTGIQW
zD>uXBU9YvOCn`)yKlRYtQB;INjF*VI6Y_d2y{zwdmB_IzLB|SkpmOGH<h7#&(a8iY
zF{ewtUqO%1{7e@<t7n>kMrCtjYP@*9+spO-Qy~KQ7kbd8Z?fb2yR!I4BmyV+YU-9@
zvu6kgklssFwDMj?@q5->7(v>t=Tfz>^ZRWQOFKmpOZ%!JUZ|<<L^vQ5lN$#hw7N1j
zFD1a6m%!vq7Hhq6@Y=Iv2zBStOF=eY3Zx(BtxYZu%x!cymoPzrCut|n2<Jwk>7`v0
zTIUZCSK_@1I`rm4bjO~@=KbXEKlC(`myyt6Sw(28rRx*^0_$X%{yL7tI48ck|Dt;H
z9*>~eH}Ey+^i^@04t6s!dOPzcMV-{@m3GpTWCvlh3Sq*l6j-Bg30ekA9mK*rlbD?}
zXLW{5=6Fr474~>zQ7z0gstePzE3DU<r*-4Bc3E6s=96<yPY>2qY^MbfxjA0G2<QK7
zcAzB3f3W4y*U(??G$qZ@P;xmkHtV^$owW01s?Op>oM`9FaHsw<<<;@>Lh;WqeBMzn
z&-p`kllsda=S`*ji4C@UV{`PESM4cY3OdRr1zE#>qI&8=9O+p#*cE=LhrTHh#W?z!
z=}tvBoS*e{G-KTsV+rb7C@{EsL-VkZvP|TXc^Q{^-eptPvg#9DOKWJW3ys-zEbTU~
zbMn&q(x~mHM!#ev@b^#CH^s*F_rK;4`FRbPjRy*b4*utvuz=0|=H(3tSUor)78n3L
zO!TkiARykLFn~L+zfON{&U}Cu0uR@`UC0DD82q<~`FqqR@N(dpkGIPw08dH(UjDBM
zkie^fhXUTNJ_bx}_<JVU-4TJn1mIC_w*(*9zX*SQ_6G;M0mFcYlHI}}0V!91%lY@b
zEa2t91Ga9Ly8?PY|2A$5cscM?r`zR1kN#Q?JmU$N06fIwmhcYnQ+r^f2QUD5UdAoJ
z0uUSe1-R4w`}gS?z&PNJ;<vc>fJO+v;qIJK{xzTD_M{S+4BS-vmb?R)iS=*t-+do%
zRNrl`3(UKl6#gq4=kJ#{=+5H@cz2ZEr9Nn2z};_e(R(BhpzlikmBRPmDgD*s^6!^7
zsOFOgaK9`41$|H`aP!DpvKAmc=fC?-Z;sCXxlm|;?%!~~3B5g!111AEj=L2K1Gsj-
zk?(w?H%A)4xVzW>{x_P(^Z@QRp||HGz+~X|Nw-4tnI9nE5qcA32FCqa=sw#6xZi}{
zMy`R$!2L;Xg&wd!K)xgNCd3Df`?F9C-Uo2M3B8RQ0+WHO<Zp#y@;yMlBlISw0*w2!
zP!quiaK8z?4b%XWfs1c%g_;UIK)xgN=9v{3_h+G@q7UGH6MFj~3`_>D|GO0$CiVdN
zj?kO37+~C=g?dRpfcs78ZLJM38MtiaR;ahk1LQkGZ_>blaeo%dq3{6iH=(z=<-la%
zH0@iVoQe;S?+9hO$?yc`-Bo(uH$kaB!23<<U(^S;eBcz!Td6Q=f1!aAFdt0F{7o=W
zX4x$@K=Y2^yLo272;fYnTZE?eJ;a?)`{%m_;1r=-nw-u(+Re3i(3=6rn{E+y&+j4b
z2>P=J15VDkr5WqpqumI4&};o!kdMJV#2rC@_Ef-!<F|rbUfiSI2zt;v{aMflqkD)u
zg8uB0fR80_1%(;kqumI4&<p)pP^;-Z#2rC@_B_CcKevLa&F;}|1U=|&{w(Oi;vV9T
zpg(&U;Hdhopgqfbv>QPWdX+y561BO9xFhJ#o&-2Lc`Jy^_Rgc={aB^EG$i0j4+Ml6
O@COSBYoa>;diP&N->5DC

literal 0
HcmV?d00001

diff --git a/scripts/generate_reports.py b/scripts/generate_reports.py
new file mode 100644
index 0000000..82bfd38
--- /dev/null
+++ b/scripts/generate_reports.py
@@ -0,0 +1,25 @@
+from bodysimpy.reporting.pdf_report import generate_engineering_summary_pdf
+from bodysimpy.reporting.pptx_report import generate_management_summary_pptx
+from bodysimpy.reporting.summary_data import load_reporting_summary
+
+
+def main() -> None:
+    summary = load_reporting_summary()
+
+    generate_engineering_summary_pdf(
+        summary,
+        "reports/BodySimPy_Engineering_Summary.pdf",
+    )
+
+    generate_management_summary_pptx(
+        summary,
+        "reports/BodySimPy_Management_Summary.pptx",
+    )
+
+    print("Generated reports:")
+    print("reports/BodySimPy_Engineering_Summary.pdf")
+    print("reports/BodySimPy_Management_Summary.pptx")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/src/bodysimpy/reporting/pdf_report.py b/src/bodysimpy/reporting/pdf_report.py
new file mode 100644
index 0000000..adfc584
--- /dev/null
+++ b/src/bodysimpy/reporting/pdf_report.py
@@ -0,0 +1,124 @@
+from pathlib import Path
+
+from reportlab.lib.pagesizes import A4
+from reportlab.lib.styles import getSampleStyleSheet
+from reportlab.platypus import (
+    Flowable,
+    Paragraph,
+    SimpleDocTemplate,
+    Spacer,
+)
+
+from bodysimpy.reporting.summary_data import ReportingSummary
+
+
+def _value(
+    value: float | None,
+    suffix: str = "",
+) -> str:
+    if value is None:
+        return "Not available"
+
+    return f"{value:.3f}{suffix}"
+
+
+def generate_engineering_summary_pdf(
+    summary: ReportingSummary,
+    output_path: str | Path,
+) -> None:
+    path = Path(output_path)
+
+    path.parent.mkdir(
+        parents=True,
+        exist_ok=True,
+    )
+
+    styles = getSampleStyleSheet()
+
+    story: list[Flowable] = []
+
+    doc = SimpleDocTemplate(
+        str(path),
+        pagesize=A4,
+    )
+
+    story.append(
+        Paragraph(
+            "BodySimPy Engineering Summary",
+            styles["Title"],
+        )
+    )
+
+    story.append(
+        Spacer(
+            1,
+            16,
+        )
+    )
+
+    sections = {
+        "Objective": (
+            "Automate structural CAE workflows for a simplified automotive "
+            "body crossmember surrogate using Python, analytical references, "
+            "CalculiX FEA, stochastic studies, fatigue assessment and ML surrogates."
+        ),
+        "Method": (
+            "Validated configuration files generate structural models. "
+            "Analytical beam theory, CalculiX static/modal analysis and "
+            "Python post-processing are used to quantify response behavior."
+        ),
+        "Baseline Configuration": (
+            "Thin-walled rectangular hollow-section cantilever surrogate with "
+            "linear-elastic isotropic material and idealized transverse loading."
+        ),
+        "Key Results": (
+            f"Final mesh displacement error: "
+            f"{_value(summary.baseline_deflection_error_percent, ' %')}<br/>"
+            f"Final mesh stress error: "
+            f"{_value(summary.baseline_stress_error_percent, ' %')}<br/>"
+            f"Mode-1 frequency: "
+            f"{_value(summary.mode_1_frequency_hz, ' Hz')}<br/>"
+            f"Observed stochastic stress exceedance over 350 MPa: "
+            f"{_value(summary.stress_exceedance_percent, ' %')}<br/>"
+            f"Best ML frequency MAPE: "
+            f"{_value(summary.best_ml_frequency_mape_percent, ' %')}"
+        ),
+        "Sensitivity": (
+            "Wall thickness, section geometry, Young's modulus, density and "
+            "load are evaluated through automated sweeps and stochastic analysis."
+        ),
+        "Risk": (
+            "The model is a simplified surrogate, not a production body-in-white. "
+            "Results depend on idealized boundary conditions, beam assumptions, "
+            "generic material data and the sampled design domain."
+        ),
+        "Engineering Recommendation": (
+            "Use BodySimPy as a reproducible CAE automation and validation "
+            "portfolio workflow. Extend shell modelling, fatigue realism and "
+            "solver-result extraction before claiming production-level accuracy."
+        ),
+    }
+
+    for heading, text in sections.items():
+        story.append(
+            Paragraph(
+                heading,
+                styles["Heading2"],
+            )
+        )
+
+        story.append(
+            Paragraph(
+                text,
+                styles["BodyText"],
+            )
+        )
+
+        story.append(
+            Spacer(
+                1,
+                12,
+            )
+        )
+
+    doc.build(story)
diff --git a/src/bodysimpy/reporting/pptx_report.py b/src/bodysimpy/reporting/pptx_report.py
new file mode 100644
index 0000000..9744257
--- /dev/null
+++ b/src/bodysimpy/reporting/pptx_report.py
@@ -0,0 +1,133 @@
+from pathlib import Path
+
+from pptx import Presentation as create_presentation
+from pptx.presentation import Presentation
+
+from bodysimpy.reporting.summary_data import ReportingSummary
+
+
+def _value(
+    value: float | None,
+    suffix: str = "",
+) -> str:
+    if value is None:
+        return "Not available"
+
+    return f"{value:.3f}{suffix}"
+
+
+def _add_title_slide(
+    presentation: Presentation,
+) -> None:
+    slide = presentation.slides.add_slide(presentation.slide_layouts[0])
+
+    slide.shapes.title.text = "BodySimPy Management Summary"
+
+    slide.placeholders[1].text = "Python-driven CAE workflow automation"
+
+
+def _add_bullets(
+    presentation: Presentation,
+    title: str,
+    bullets: list[str],
+) -> None:
+    slide = presentation.slides.add_slide(presentation.slide_layouts[1])
+
+    slide.shapes.title.text = title
+
+    body = slide.placeholders[1].text_frame
+    body.clear()
+
+    for index, bullet in enumerate(bullets):
+        if index == 0:
+            paragraph = body.paragraphs[0]
+        else:
+            paragraph = body.add_paragraph()
+
+        paragraph.text = bullet
+        paragraph.level = 0
+
+
+def generate_management_summary_pptx(
+    summary: ReportingSummary,
+    output_path: str | Path,
+) -> None:
+    path = Path(output_path)
+
+    path.parent.mkdir(
+        parents=True,
+        exist_ok=True,
+    )
+
+    presentation = create_presentation()
+
+    _add_title_slide(presentation)
+
+    _add_bullets(
+        presentation,
+        "Objective",
+        [
+            ("Automate structural CAE workflows using Python."),
+            ("Validate FEA against analytical references."),
+            ("Generate reusable engineering evidence for portfolio discussion."),
+        ],
+    )
+
+    _add_bullets(
+        presentation,
+        "Method",
+        [
+            "Validated YAML configuration.",
+            "Analytical cantilever reference solution.",
+            "CalculiX static and modal simulations.",
+            ("Stochastic, fatigue and ML surrogate studies."),
+        ],
+    )
+
+    _add_bullets(
+        presentation,
+        "Key Results",
+        [
+            (f"Mesh displacement error: {_value(summary.baseline_deflection_error_percent, ' %')}"),
+            (f"Mesh stress error: {_value(summary.baseline_stress_error_percent, ' %')}"),
+            (f"Mode-1 frequency: {_value(summary.mode_1_frequency_hz, ' Hz')}"),
+            (f"Stress exceedance over 350 MPa: {_value(summary.stress_exceedance_percent, ' %')}"),
+            (f"Best ML frequency MAPE: {_value(summary.best_ml_frequency_mape_percent, ' %')}"),
+        ],
+    )
+
+    _add_bullets(
+        presentation,
+        "Sensitivity",
+        [
+            ("Wall-thickness influence on stress, deflection, mass and modal response."),
+            ("Material stiffness and density influence on structural dynamics."),
+            ("Stochastic uncertainty propagation for manufacturing, material and load inputs."),
+        ],
+    )
+
+    _add_bullets(
+        presentation,
+        "Risk & Limitations",
+        [
+            ("Simplified structural surrogate, not production body-in-white geometry."),
+            ("Idealized boundary conditions and generic material assumptions."),
+            ("ML surrogate is valid only inside the sampled engineering design space."),
+        ],
+    )
+
+    _add_bullets(
+        presentation,
+        "Engineering Recommendation",
+        [
+            ("Use BodySimPy as a reproducible CAE automation and validation workflow."),
+            ("Use automated parameter studies to identify influential design variables."),
+            (
+                "Extend shell modelling, joint modelling "
+                "and durability fidelity before "
+                "production-style conclusions."
+            ),
+        ],
+    )
+
+    presentation.save(str(path))
diff --git a/src/bodysimpy/reporting/summary_data.py b/src/bodysimpy/reporting/summary_data.py
new file mode 100644
index 0000000..ca56352
--- /dev/null
+++ b/src/bodysimpy/reporting/summary_data.py
@@ -0,0 +1,58 @@
+from dataclasses import dataclass
+from pathlib import Path
+
+import pandas as pd
+
+
+@dataclass(frozen=True, slots=True)
+class ReportingSummary:
+    project_name: str
+    baseline_deflection_error_percent: float | None
+    baseline_stress_error_percent: float | None
+    mode_1_frequency_hz: float | None
+    stress_exceedance_percent: float | None
+    best_ml_frequency_mape_percent: float | None
+
+
+def _read_csv_if_exists(path: Path) -> pd.DataFrame | None:
+    if not path.exists():
+        return None
+    return pd.read_csv(path)
+
+
+def load_reporting_summary() -> ReportingSummary:
+    validation_dir = Path("docs/validation")
+
+    static_mesh = _read_csv_if_exists(validation_dir / "static_mesh_convergence.csv")
+    modal = _read_csv_if_exists(validation_dir / "modal_frequencies.csv")
+    stochastic = _read_csv_if_exists(validation_dir / "stochastic_samples.csv")
+    ml = _read_csv_if_exists(validation_dir / "ml_sample_efficiency.csv")
+
+    baseline_deflection_error = None
+    baseline_stress_error = None
+
+    if static_mesh is not None and not static_mesh.empty:
+        final_row = static_mesh.iloc[-1]
+        baseline_deflection_error = float(final_row["deflection_error_percent"])
+        baseline_stress_error = float(final_row["stress_error_percent"])
+
+    mode_1_frequency = None
+    if modal is not None and not modal.empty:
+        mode_1_frequency = float(modal.iloc[0]["frequency_hz"])
+
+    stress_exceedance = None
+    if stochastic is not None and not stochastic.empty:
+        stress_exceedance = float((stochastic["max_stress_mpa"] > 350.0).mean() * 100.0)
+
+    best_ml_frequency_mape = None
+    if ml is not None and not ml.empty:
+        best_ml_frequency_mape = float(ml["frequency_mape_percent"].min())
+
+    return ReportingSummary(
+        project_name="BodySimPy",
+        baseline_deflection_error_percent=baseline_deflection_error,
+        baseline_stress_error_percent=baseline_stress_error,
+        mode_1_frequency_hz=mode_1_frequency,
+        stress_exceedance_percent=stress_exceedance,
+        best_ml_frequency_mape_percent=best_ml_frequency_mape,
+    )