From d89878b950e2587fee24c943a61944bf254d509c Mon Sep 17 00:00:00 2001
From: Tobias Tschirch <ttpost@123mail.org>
Date: Mon, 11 Mar 2019 22:39:05 +0100
Subject: [PATCH 01/86] Add fill plot with example

---
 Makefile          |  10 ++++++++--
 examples/fill.cpp |  35 +++++++++++++++++++++++++++++++++++
 examples/fill.png | Bin 0 -> 62995 bytes
 matplotlibcpp.h   |  37 +++++++++++++++++++++++++++++++++++--
 4 files changed, 78 insertions(+), 4 deletions(-)
 create mode 100644 examples/fill.cpp
 create mode 100644 examples/fill.png

diff --git a/Makefile b/Makefile
index 3c4ac36..50a7af8 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-examples: minimal basic modern animation nonblock xkcd quiver bar surface
+examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill
 
 minimal: examples/minimal.cpp matplotlibcpp.h
 	cd examples && g++ -DWITHOUT_NUMPY minimal.cpp -I/usr/include/python2.7 -lpython2.7 -o minimal -std=c++11
@@ -27,5 +27,11 @@ bar: examples/bar.cpp matplotlibcpp.h
 surface: examples/surface.cpp matplotlibcpp.h
 	cd examples && g++ surface.cpp -I/usr/include/python2.7 -lpython2.7 -o surface -std=c++11
 
+fill_inbetween: examples/fill_inbetween.cpp matplotlibcpp.h
+	cd examples && g++ fill_inbetween.cpp -I/usr/include/python2.7 -lpython2.7 -o fill_inbetween -std=c++11
+
+fill: examples/fill.cpp matplotlibcpp.h
+	cd examples && g++ fill.cpp -I/usr/include/python2.7 -lpython2.7 -o fill -std=c++11
+
 clean:
-	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar}
+	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill}
diff --git a/examples/fill.cpp b/examples/fill.cpp
new file mode 100644
index 0000000..6059b47
--- /dev/null
+++ b/examples/fill.cpp
@@ -0,0 +1,35 @@
+#define _USE_MATH_DEFINES
+#include "../matplotlibcpp.h"
+#include <cmath>
+
+using namespace std;
+namespace plt = matplotlibcpp;
+
+// Example fill plot taken from:
+// https://matplotlib.org/gallery/misc/fill_spiral.html
+int main() {
+    // Prepare data.
+    vector<double> theta;
+    for (double d = 0; d < 8 * M_PI; d += 0.1)
+        theta.push_back(d);
+
+    const int a = 1;
+    const double b = 0.2;
+
+    for (double dt = 0; dt < 2 * M_PI; dt += M_PI/2.0) {
+        vector<double> x1, y1, x2, y2;
+        for (double th : theta) {
+            x1.push_back( a*cos(th + dt) * exp(b*th) );
+            y1.push_back( a*sin(th + dt) * exp(b*th) );
+
+            x2.push_back( a*cos(th + dt + M_PI/4.0) * exp(b*th) );
+            y2.push_back( a*sin(th + dt + M_PI/4.0) * exp(b*th) );
+        }
+
+        x1.insert(x1.end(), x2.rbegin(), x2.rend());
+        y1.insert(y1.end(), y2.rbegin(), y2.rend());
+
+        plt::fill(x1, y1, {});
+    }
+    plt::show();
+}
diff --git a/examples/fill.png b/examples/fill.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa1fc0db3665bb4e38800974b85b238318851341
GIT binary patch
literal 62995
zcmeFYWm{F@7B)&rNDI;-BGTR6AdPf)!=k&D7NkR3y1Tnmx;v#|(Yc5-*=M`YA2=W0
z4=>jxvF3En@jN5%dyFScQC<@DEx}tTC@55^FJekiP%!>bP|zEQ@W3bRlPiCLA8<}0
zQYwhRmp7tGDDXFu{TEFqC@6Hp*MHE3f(4eqhuqHM8qUggX3lPgj;2r`LuY#%J7*h9
zqYtj8j!u?#wjWp+m>HPqK3F(A+w(9o{(m<x*g2XrLhUM~LP33ik`fbEaZfv5b@Nu9
zg>;@P#MU3I#nso2e5{w%RE;V6@Es8x2D`FN2|j;M^Z`wWilLo~YU>W>2O>*++bv0u
z(%U?*Q;wn2C}essiY89WjN2m@eM=F?aabZQg|W6hZl3TyBVk0cKn#&al(sqO|NMsN
zA_YSQe1f=X^a&bU1o+IJITq^ee{RB)f(inzkm*Ex@_)U8!65NY==BOBE;-Wg*DHbH
zF>s2nSGxPY{NKm?pS?E@(>ze-W*n(QgM*#p<LK$~1uk5#Dr|(p2@i^meMi7<6{vTb
z;$#>LrA0<g9<Z>WQP%US<X(y|3JR2;KT8}jv5_JDe*gIR2$ctW4}n+{{d~R7Am-q}
zTvb)&vfW4<3peq0fD!Tlfyn&F9=Pz;+kO79GkPQc$D)}2|F$UQ&;Bw=45k~M-`K2X
z5Yy!cN;PZbAFd61g0rR%<awH1Pdul*ii?ZgFNP?QP*M8^210}b;2rMH4B7n%UssQj
zVm}O5Sy~!V4_an1><+AHFVOGsCF1w21>YT2bO6sX&+rINW;JK=d2mi-)R(ukq~=_)
zhy5Hkw6^)5MOh5X9YHaOzdS!3tarR{uN$)wghfQ~ZCAX1|DM@$>Qlaax^$+157gae
z2x;igpQfALK{{@$E*w#s|8bnJTstTmK^m>@%$u8=wKj{fn>`_M>FK(+)`T23zw`5h
ztt;B<!F3Wp31WWz8XQibtwU5t+@u?JG(2KtdU07`A$C;mG@9h00W?V^&kgG?@C3Qt
zOVqX{V_=A!nNiX6dvfu-KI{udC1fJ_X<}x!wYe#*s5l{&86Fz?ftB^Lbg!(qI2+g_
zu!n;~)v7PL2qJ<Zhwy{e7tKN<$p)x`Pu>~dFjg^*$`wg+Dxfkk<htLBgd$IV!0KGK
zZ7Boq_4bODH*US%+S>ZXYK|rvjKY1iM~8#VlMXKJ5O6)#kcc7yO=|>UpcU>j<<cp=
zYoDP|)N}^ls^fG&iw`^KD7MBT_UmNvNz_4e=IHj|01ux99<D4dE{=(dJJ9X}feMX?
z$Zc*;`TqTToEdaYO^uYiyugu%p6|VBhR@An^Il(HUvGc^5~Dp?Adgka2aveWR8r0I
zgA)#sO5{lg_4qXyBiY?i32zEz>^x5yk?gpS;$3HJE8o=gbl8s{Fu#olA{$#;Y7Dwy
zY}>BYpdv~5hi^`nJx<$h$2>`LCPOEw);EGIFdUT+8ISVI{8Jnu_2%W@BIJgvz=S*O
z<3gcedq*Xzq{tu)npbnGt&Io1n)ix|ifq<elQ%XDz6S*0vs+<{hM-Z<(EJEMK))EK
zt-v547?$H)g%c7If<hO#`#>%k`RUWAK;ZTaFEDp(Z0w=h8)PzqU&Ts0j<&-hruh|2
zaz~+&x;)R4+>yv2B>M88#HZg5oJ?Fhe$#-~_Tpb^O7%N3GWfmb_yv76Z`vVX<E`E>
zo8|hS)XMpa8X8|zRIvHIZvO6N`t^^GSAbbbeXcNVZEaUPkIGb3R3=*7?12Bnivk~T
z*g;Abm`=1>ypohujfhsJX0}PB3)b7wV29>|{jF*DWgmSM;_p^DH;F_>fSBI*@fw*y
z6^H}S(9qcL-*29tRshi@^upVegWfdeLc{Y$^+{gR+<#$g;)2K2mFbbCjQm}<<<K2H
z(r?vVSfniG8l*^@!j2?HV=RpkEy=vd-|iL;>9H97`lz-fT9Tgvr=!oc-wBm`L3k$u
z+b5Y|V)ycqs}hgqZEfTiFOv3&+7QR0#y*z~!h9Do5iU0Tj`S-MARZ$Zl?98^MkQEi
z!Y%UFMh>2<Bz1!Y6JXP;s~b%P0YQq(UROXA{hHwh;xe`TG&x=HXW}i1W3Z~IlKP@-
z{QcIUUo09QKkwT!22xlMr(tvp4^kM=4q{hha46~KfASn)JlQ3k;K>fA&aa6@{EP;T
zPFj|ODZ<L)`v(QclC+w<hi+?JwFI)NdoK}{W1Dru%%^$AHQ#TAZ79of-icTUy=GM&
znz!-dgw)7nJET-Y6FeX1RdwH{=F>=O&|3JR*S3kel3{iS{d@7A0SB$AX5{)GHxpP5
zSuIJ5vHp#$(vP-&jBH15Jlp0lkqkNi-`961O4l4=wLiUxh_}ySh9R342d8(?N(#}{
zwqPx-qkj8Y7b%Nqh`<7C@#Y?$OedoVerkS((kFQt`kpbbYvLelh<##{#KHx(5x*|-
z3t}pu1v8*3z%BW3qS4)esFWn)5(d1^tLoQgXUFj7dlZmu04+Glkwt_J>a~s-E6ayL
zW2ng7`6DyQ^D!&vhqneR=A1WD(kj$yX41!L5iaJ}oKWy*O;<mT5kxVgW<?xhkB76s
zuFb7=698rul9enAcqgLs>Gd{6O*n)^BAJKhZ`oIIeygj5t)iX0c&(yQPee*DDdR{L
zO<n==2>T2dF{~Z7RYIy&N)o$wUo-qJE`PujQt{n;fPy^ze9Ns)`F1SkWTfD>n*l{*
zY{3kD#GoCN%k8$*q*K&H<n~HXqQ6JzWZn3iJI0$UP~~(x#j_QzuIv!}>0IMN<5#}U
z@E9*tpJa3pEyp{z_d1s_Y;6)pUjn%(@jED>YkxR@*gPwiCbJ{`3s#QJ^w-EMl{7Fu
zix)tq3Nu>s9bDJX#NN%LlJqE_o8&H7U>J@t2p7<j{Md{CKYs`@s1kC3{|i=q*S69&
z{5AURGxP9H({3ACaXR*Gn?{0o0cFrVBw<fgTuXBAj=;qqJTBaQeVue4WDmvSD+6Qk
z{y<1Xb-=vX@s=iR@LY_M^NrPT{Oz42?U3H3fb<hbg%HTtc2L?Wz9XdcB)VO#C<IuR
zi%KN*N2KPcz_|blOl&maemg0svX8`H7E}#+h_p~c)TpBtdAU#Y*aI-PViN)@JV^5d
zQc)_Gs7KY_bzQMbEB&g%msQo0+~Mlh>Y61dbD-Ks)siIF`4zDa6cyq;(Utf$_>QjB
z6zV`giQMWj_qF?S`4GqmmOeXE<5Y9lv?|%$-+c&V@}ZA6vm#Eo`JO5qm6SC~4{VN3
z{J)1Zny@ECS5^7Co=&9HtSj$sBFi<?Cb_0w2XA~n?5D9Q`B3&8>+nD@xCD(8H}}<&
z94y`V3>#`u=JKh#Z}7hnCk$CFqXOk-0INMh&Y)NT0wIq*JlzRDfw3hy?4y}c)rFVj
zpwfrAc|r}D-&QiUyt19x!Q4N8hxb$)Dba}dPtOi&Z!9U-JCbUSR!(o<^3-cJL|yFT
z7Rje|pU0bYWpo(a5}8(*syBs9FupDKA&j-1<9W9UWAc~?H$gM?O^i7F4NF6JxnKf)
z^;pu`!4-y2UzOLrr)bWNqjD>kt}1mdo&TyIbxlA5gQ91?l-o|Vy~g*sm{54x|EgxN
zFL~77{iMq0>x+N4=$>zfe!L^P{^c4F5384hF>r@fkS+ftnAnf&7ue0uNAIs@9pwz0
z8vZ9jp+^7PQDm0c&Ms5wsRl2!c(e4UHcvNGyP0iT*B)(|FdRc($p$JP`&<3!I=Lf@
z;~qhRaxVmi4ymIrVzA`f4WIngV$lA6EdFEoB3KDgFx}nJN!t9rmF1yNu^Ha+Hln>a
zh+0QOSnJ6rz>=15t#~V+fAis%tTyO%86y8(Mj><w-S@W31eq3U<gEP1kyEEzHLxa+
zuO(-0a<ju*hvHb-1+MoT^53#AR}wd5QAj3E989AOi+rd{KmAvPna=oKsv4>mvz~8#
z2IbtBkZ#71-2t^@4lul}glZ4=*7skdm429|nJ8X+>}i@^{u+(8D77THfKi0~b31k@
zRf@`M+ywzxv@*Ex`>R`bc&en|kx3Rvp=yHiWTjuzz6#R1*Atti$%R`RPQaaoPXOu+
z{HM+|jX5+8PNe#0l-az3$85B0ULu)0Pf=${rbf$m`4}9gK+rawQwa9CO!rfppd_+=
zP-=P-2@U`7Zx>ChN(}Z$D}7^?e&34;Y+m!)v7I0ZkS+C61#10>q+<P^nlEyWS(a1v
z9j)9G-n0F){!H(ixc}xw$9HcmD>r#fD{047^`={dZRQ_x89!oPdCK)*i(r|>u@E-;
zR<rQB=P!Rq6Sl#{<3WNku8S1og8paA2xc6@!yirS?M~PI-@p*g&;JeYAmH0Ml?{!<
z&ZpH+ob%aEYl(D+@BWFkQT+{YNusoW1_Vp<N0q^{EVC5bGP0xDx1}z6S1D9ee20Ap
zTOC(fMODnfg}G0)Z+N?EzF2N{-<ijmhuHIK-(?u3RIlK%boyW-tHe+K$;*Xj$0cA)
z$e-E&!}y2q`~gTTG*Mu9x1WBu^5xkWYJSiqlp?BCbCWu)@;wPKQ`I8+X+i&F2&mNf
z;6q;u!EtmYm3i<K)nRG$vLx0Gh|$fE({dn4Hch^kT17%yD+<#aT^!yo>>OAvV8BPY
zKq=<^{*#iA6MmK=at*Ac4vwICYcRW4`5;rsFv*h=j+G3@>4%Ut`np#i{_WLI)dZUB
z(Tf|}ybmeYi4ecic<mS&;4L9P(5a&+hK)U?c;45&*9tM`G}JR>L$XkEV?(u&j`RO4
z_8?|OoMKEh9-@k6Fgib$farPGeN8IV0#qkrTzLO`z6PCQ3aTkLMk17B(`oi!wZE}?
zvA$Z_ZiROkJ9XxZ=e^?hjS!4eQvD<h5(PBlCu4{C7K0Aj@sNbf?j^f1MS-Djb#1Wl
z-iRcxnT06u-!9pk0BA3u4`DI3CWxL}dm*_YPP8wCs>~t#+p=)e!Aj_Pc##aE_M3)m
zQ89$>ww^jPIbu_f$_p$F2>okWG#Z3tiPqp<phJMepztq0aK%=qu+;C^8q3tjo`FVJ
zrN1U%mH%}%Vs2-44&4_T2#s_`JQea5YMmonRM%uEz0;sB_N{-aCJyT=q(eL4(*bg4
z|35DZOhm((9S4Jk7Dc2D-<p}1ZO#b=xd%^>Wy2D8^S=H-5=O$if-mc-Zkw{vI1h_O
z<mqY4mTKtUVElW7iTnA#-t=ikNl&?a1WYV*Q@?AIS6QrhRM{(j;c%O!tI^V&%S26w
zl#>OWKtnwgcwf;~uU{AW_c7%raM>3sr(!M!5%piD0BRczI-Bv;v5te6>c>IH8=T|5
zzsHdJAJdITt5PU(e-HOd4zT7!K10jZq78A}yudn1h&)4=k#jc`y4ug%y_Te(L`?r>
z<?ckl14;#&Q~D0VHDlWYkAK*diN2$;#+ir^aPZkDoKFhefGg{%l9!{PgD5shPN<Z*
zu$kk|z=4yYyW{{PEd26s+ciomtE2NI6RWv=m}w(Rqgm*(<xBPHd<br{6m&>qMdBv7
zj~F<(y$r`{?Cq21V$#wTxK^%d*{lixfhbsf1M~pk+BcOagU@CE;U@vRNWnC-^;~J3
z@2XK1lhq8>D<hDUgv;-FWiSv)OxafO`?tRrxGBWn9|{Hrrg1OBi;6DZt2po}54Yg*
zDe@Gb!w!$%_n@ofkG`q!5{%Syuhf*xRC22^i`$b6u8-f*p9OYf&7`KWdz^>Bx<Es}
z?v1bw;%s1fYKf@pt5A@aS)N#@;!<WZCys8lG)H)Q@Jdsu1`zFtd6=B{70t%dhBmqa
zj(mMq8Xa0M$9TPOSKVGAbHloCYMx9|wfQ*7D><>h-XR!*PPz-=cX)%|P|V(e0amY@
zW8_HDcHvND!zzu1l$Hcw`|ocjI*u8aDqOyFhrRKFpDuA=d|(5M?iG%WsYW;Rk>a$X
zrTW4V+3z#EQ-xVgjcQ3cN_?&f8a;U99DzK?gIz$m-4OTLpK|KJnUcaE@GAhMpO3JP
zpKXOR!YHb$ii?TCZTJ7&27tfWe7SC|?P|(wiTZS&3@(&fg`Ql4?dn3C7bg-DuIuSf
z=MN4Xz!PRA)h}<mIy4>Kk(%B&X@z_u_~3``2hUE}3qoq(Rv+!EO*q?oq4sj)B}!MK
ztz6#LLU5GuI~~lGDnzFzf2>98D;l~x$xZSfr(kDK7#Wc*Z@XD)o{x|qpVx6hrByG7
zGng$_g@c2eq40y!ZE>ae@ZmR@-&_e0*1_RiDg=XaxNLAIwQSw~DdGsf$^h<V`BqTs
zIdBz-<Ci_<q<C!B7(ILF=95|CzeeOMwfGqDNi@;gUSMtYv?QJ0B0oO89r4p$be-zD
zYNGodg$vGWZB{!{42*LE*eC5jBO`DhK7QQFohSeJ@r#U1iI;-=-GMeoP)NwU&$DcQ
zB=Mj9$s7<~nFZnq4l6CI+QstPx(47RTH%iabTg*H$qsrx&g?M)F)LFSIKlOJ(xFKK
zYfcE#n7bvC-8-W3i=D7&t}m;@3JEatoW5xA1Nbzkp2SaBIe6CtXlpG^WpkT|lye(q
zP*J=teQAA0+y`~6Wre)g`~{x(J4w_uG{w9CB>=*$wCCa8;r6cEp)JpJ;E!VPju#KX
zk-DH{OVUgnGEWuAIkofgFg!rE8CfcH`Lc(z0(fW92>c<DO;UW>^k%{G@1?36UXp0+
zzTGPkGh3cg7pm?s?y-3SLVy~Ai`Q%~EG%rE2Z)R#vp3}A<U_;5JSR2W+}s7DL>Yq?
zY({Jxzl)!?vXkk}5=k}3?7aMp7dK5~&yYe?jmr&f4|R6)$0*3CzG-9G?gZy^Zk&M2
zTr3Kv4}kSAFq|z1D0<$|G8fBe7M5bPL;N;Q@WL6dJc$)<ZHF#9Kv^K!4{|*woLCO$
z1UfJaxl&jk$;mY<4WLh!8xVd2EDME9B9rY37gV#$k;K=pnAY><c}{y{Pyn+QoSpqK
zHZG1mT$ii7w3^N=cf??~J(-A}x7dXXHFDCRcVHDk5M9uF)#u#hwy$U7+mKQAoK6W5
z&d#KXnjWjB?94Cg!!@VJYb_ai)qI*g+9V@MueUd6bB7Ig7Cn+ERve+r+N<DSEs?$Y
zZ=&b|UicA<Wa=XG_4+05&dnO_INa|nh*6=Qu*mO^Gky33Kv=A#GX2x5U1kbFJx;@_
zoq2hAxw*Me6YV};{ZXU};~D%&XlVHk+x-!QoRL+=11ugFCR()?UB8%(0mkjz($s*3
zh2`$Bqyj1rMOH^AE&dy(3t)MF&={4?Adz%&WeW`cXvBtVhP`+F7~8m_q3VdfU|*M^
z)gq~kija$a+e#2MR@|bPuqrg*uCG~IJ;rTn+#}(7JiJ8LjyXxMV6XY^$US=%i|xj)
z)P<{nHP!H3L*oXTOX=hKmR92vWk?gH{n||q-$joE_<&$QI{>Q=ZJ=lnaAKs5t-kPs
z#hN|KigmYjpVwfgL5BmdX`|};KH|c{(7Mgeo0sE)l+0Dnq+fh}1r+$NvHc#;5ugI#
zQH{C-k>KFr_3VkJz7gaD>DhPb2}|(wK6!)%p&5JUL+fg5*iCr3%*7!|)YGxy*#u8-
zxRP-(ko%p6owzi-qvN}=Z*akTLX*%mR<yNfleR0)wkr#d5+s%oM8E;HLY$i8gP4rr
z;`c0xrP}J<y5+FyB4MCv7Q6k&6KjqvnDtj?za7P8kG+sV58k25r$F(%JrF{b(Uij%
zJbwIE)RM2HqMGZ%l`?g7)e9Mj!%O*+=0^ln3@%ccq7`&?%r$)@F;nEZ*twM*7J}44
z)WC1iTJh3#i{EY=+P;u@qT5O}28G0ue4L?GIkJ~mbB6Qvf|^pd2Bax@Mt_Ky;&}_T
zdpc;+JA-<MzxwNPW|j@jq0@_x_#f<1?D-Hz8t4@ghn*s3WbsidOG<~tk-MG5(fEGx
z*T`oebtME=G6ng(fh?r8CI2T+*ZfFI#dWK1j)P#GQg-6~cHz2~t*f-aE`5|e`f_+p
zh@eY4$@3N<KVd29%poyGOZ{+XN9059jqD3Bq#XZ4ODj6;=a(+GI~UOaHe;j<%bobt
z-KJ0xPR+2^l^sy}M{A&Y#KmTCWuq1;E3<|4R?nC5w!VG7N)7e&8QF{<CIRj2RJ9-^
zEAE3s=v+*ty*UoLoF;l_fI9o;HKCR@QOx%LK!JSTY~Ewzkz~@B$15KGvhUh4*eNP*
zKt<{}=9$#(n#NCt!UBJ8Fcq+}cIX-bk3juR)gHr_7#=^hHWCg+q7lMrF{L}r1T2Zu
zxBYurNW#l_d(-XPhk5}oDOR#=&M*I=8pirm-w6u33C8Bc9gs|?mt<FbT$pCIN<!L`
zL+okm@c`@}#a3W}xt(uDjr#Tt_*wbrOXoiN?aP}Osg&UJQ?L#A#g-TfS`YkqeKjkF
zz_Y~R6)E};<8n8OY|VfAjWpk@BYOJ_T#IfOmAb|}tP<+9oZgYzf&M(Yj_~rit@qpw
zr}^X7+qL~0_;cuUtq>S9tjF_DHqT#ymvO!$NkbQQNC`5i(r7#gPq2|^g!^qhZQx6=
zHp~3Z72zL@{JTKlxV4vc`&-$BvOKaW1<bq}b{#&;^T{wT-Glciwu?MZvKDQxGy<L+
zy}{!bU<dQh;lX_{ejRU11m`)>{G)fzI=#;(Z4(~1_!m)9Tg$=sdv2}<LWI<)PM`l3
zfssYk^|92v1x%)U@$d<EL0&=g6yCZy%{+6X_ucvRd$xP00e-A68{RC#EWq0$wBYMZ
zoG&cii4y;YI*+~GTyFq;Et}V>Sv$1P$Z)?m!G<q)1V#eEv&!Nxd$r6U{=edtJHs?2
ziP>xv4=sr!LT)O6KLCHi8H$sw?b{q#b@ljr(CA|ErvS@K;&P@YAXbg3xm}n*DC=HC
zs&5GIjy#06$;v$R8;zUIT7u}7lY02$=H~cG7aJ%PZfvup=pz3|LpYcum@?b0a^d9C
zPw-%u;5);|5>hxRho|miF2lODff}T+#)gclD!I*Br`;6HeV4qgM(eafR4A7?Q|4RR
z#}X#htq2F}*9~^b4az4uBL7luYJto?(c>UDcsKpHwtNHS-b8qJ+e9J;?{4)jDkt{8
zpm!=`$i`?1Z0X&8?=);RT#Gh9^Ye*-wej8nsF}n9qvGu`%#)NedKkU@Hk0@}qV<yj
zUfKnojkq&BUGLK%>z9@fH)A3C;5Tv&XVYE$tXYc(+KI)6rqT><zAgFSd%2UG`~7;?
zl-{kvfB2-fj^3QmuG}|n^}eMJZ70^F$zzhUoG~C3efLKwtw~=-BNcl-!7fSKpQsjJ
z6Z19svL5L8rElYIo*Cap;jM7RmZX2V@>+PHSL$Q)Rg1)llL2+#a=YH>(#!)R0xOA3
zzNj%OmJ`CiXp#GK>(EGG@eHZs1cF-A2PBcCTsaFu_y#=Lm%Hccos`P3(Z$qzhxsTv
zS?w=n;*dW*uqkL8KW*(ccJjZ{H|J<?hL9;H=Ey;ykmh@c1udtpil01I&gGt-hfa)O
zlg}+!Jlnj7;P5+y|HH2<tsg(t+}l5e{8inxBpwz=W`Sp}Tokgk^2HhrNU<i46lGFZ
zHKd{I*3k=YY9*5K;NJc5c4TMg*Pr2pfeXix_t%2j!?Z#LqI;WJL=xy%1AaG58TT#<
z3M(R_4#-iR^lWhHS)1iQMri(Q?ePm<0wo?*A<YC^B91WqUE{#OYoe5c@_-l)8&L7&
z0#d^Y1j?fWQlIEo7+rsR(Cj>Ks5ku*f+uI>!1m9f4yEX&chYB1D?dAp-mf1Ud~79e
z6g>9@O2i)psn)BZAR6kd&*T9q<oLtJ67cMjkuy&=!_yyPIPvU}k-F&lh#Eo>SID~)
zGJDAFk<ryNB*hHuFZ`x~BE?tXKE0yeJMSQp97z4GPP4pMHl?Fa_Sm^y4L-kRa|B^I
z8S$#{y0weeu2Nt<R&HFL=nMioV*Dg-ItQqNwoL!a^&M9XtMtulcbHw=49!@yRiA$B
zyX!xD4ZI7-5-X^vZWI+wt!cxZCSlC~W&w0t3RkM)4r^;4#2Cq8outC%Hg#D<?V0)m
z6W!}&I~R)IXCTp^TdWbag@nvy>BbK)N&Bu`lgHI7WanxDagmsZMA|cya!K%;UV*xx
zKRMxM3$&tgx$iO*W*E~WslBqF;7&`s?&y#B2SzQ0E1NN=d5S`kkerzRI#+eYdr7sk
zu@tv7qwrEJb|j1Lv)oOc^}n7d55X=)RRW94!hJU<(o;z(Z_V~vaWAu*nhb5;MOB%?
z^asN6X;VjmF(W&yS_+FprItT4gKpW1WmQvpC+Ld_PhI??gvN!g3D=)+AH8ucT-NQA
zB(q*xiaA@J4Fov-nu-CKnVKO!t|w|!X^k73^iQIwixkH-%}X@D;}_8*MFwdRMVOvt
zlma^)eUKTq&4`YgTITV|!lviYnm7~Oo6XrQSOMLZt?4q_{@qBgD04H-&sYtze{bX0
znKfmL8%TGs`tC@!>lTGgPB_ozoemq2{n5Y=@3pQ}+jhJ@ml-a$uQcz?Q;J{o=@P3(
z^~C%OtBY&x-+dx<SYl_gRmw!041n4p!h-cXNfkeUz-ST=t%f;memftq46Bv?rlAmz
zZIk(nLlWsW&v55_60Fcr-YChv=39#J7X56fU*V4OiF9`PX2R>tF)693X=k*!VRXHs
zyBG-&X9Ej9svKsWNi}uVz0jXbzm)Hw?tr{`s;<Ztf@3ZBFGJRwfm4ST>WqsfYW<Ib
zj_@X9FhLU0D^!}m9%;IG@&MpisosX$)Oy~CdVZgz2!4#50qxXQ_xxZ9^^_sq0ogIl
z(<Zfs^YXkuYB9P___{u%7O$IDSFg)L@qCRd{EcrLy6bbfUMi*4ntC#lO4IJ1&x`J#
z*tTm52QA5aR>)8ZQ=^6E|LCjb!osqRlUY07QHphjue$EFCppd$_U$rMyTj7M^QBqN
zi;mJs^m(7<dM@zFr7H$XK-!N8D4iXCf-53K#yDnrhkX5|_&J^jztA>`@3O~n?;0V6
z^A>UxviNWZ1gh`%InkO0vaRA$r;+g=?|;PU5puGHE%R8aWJ?<V3kh?}`i+?};gZ!I
z79De0Y3j9hY>dvH-}HV0tl+SCk$`h(toVy!y$${jA%{WHlo_-?7i<7@X1VS;DHBwO
zHN@y_ww}t}*HplGKEiaZ%cHnH6+5N3R{#r%2_BF|lSK9q`JUi$-I%F6)Q@b-Q8m?P
zqs8U1rlp-o{?c9_=TYA+Y318LvSyG6Fxh|x^^TLXB=4W_<hPV-;{jplJaWW>%2G&u
zexrF7b96KupeY_A2WV#r^7hr1Z9xO5c7CtloW=Sqe;dUu!`;0`mjR5C@iNL0ixJ;B
zKkqA7X<lgsiuDsJ!qg}i<{!Q*F<i(j=4iUMCkyzT#)r&xlEv_e6J3=ZP4XYf>}*M6
zO^aV+hQg{0v{;5cT%r!fWYYCM&ItlIee91B%h!6NH{vyBU#s^?lMkGXJoWV-J#YK{
zHiW!mTe7B0I*MBXhjy?YV1{(s%r4oyn+UY4cuKTCwVz%3<U{W*h+#!LYkk?sn=dNj
zr<&@$4{@PeQ58gX2OS}{x8J^1HMWQQry^X&I;w;i8Hwr&gG@k0$`N)bjIO?u)M__s
z;8mH)(sk+#{?sKR)LZ`duA7*+k`ryW7+fZZo{ZPGv$~${)H&)uKey<lr?VM(8{geD
z+lAfyRLkRsavcfO4=I{obI3wETcA;_(%Ziw7hgGBylCF@B&PGpqGT2>SH)HQuk-A0
zjc_xCaH_XSd6aFJvt6^fUkFXX@<reIH`8J<DuINd`)XctU$x@~p5Y<Ng7Fc85^h+N
zo>+C;Cdt}D!B<q$?M65fH0W=~FRsNsz#3|p_mxTWOQSh~J{yRubok+ULd<Ev=j^FC
z`&m*}bNn$~(`B6WWHJI5Qq-ZEp7^h@V318H`cY-wf6?LdGR+h3bcneefXmzVB_ea%
zHc_wMll@-V4+ttsg%0Iq=cT*g$TbVGy#tS>oU#3HV;jLu)i5&R6uUouJY>?+R;j4b
z><ALTxVb$-Zplp+nE13C)anir@M%3v7is^hF1=(lDOM=9gCXqn-?bLn=%I?GH~-LP
zZT#jrA>PA6Qvku_cq03|nqfOV75q8OK=5d(Iow%uZ{{pb4<8f%w{?$GKc?}T+&=*z
z-hy~ov+tqrLTN8)pJZAWu%$txD#dC8XpeRIY{w%tfYPLHt6&6wjcF7Y+rq*B<|Ssb
z>U2AZh(bnoEtS#L+%=?A^eH&;$6Hx(@fo7g++7R!y5!^mUjgZp$($Jzb5T&)Pv4N6
zoz*7Rt{!ktgSo=2nxk2w>BUILcqO@A$m;T2HuwwEb;c$>vAo&p5VfAa&xdxn^G_c8
z*D1wv0uMd#ySC${UeC{?pvIlI10C~=YX7!=40JMC$M<wP9X}TjI0ZgFszfj)>fUoN
z<ebUff_Ti5j-4I*=^Vi$?pfyg8!P~RhX5b#$Du!KEq&jwR(2K|HNdYVb%D}OGw0hP
zgj18eltx5>KQj2+aa@na?IhQ6o<WxTu<S=09*JBE#?96A-EE6}!VQoRTbmB$RIS_|
znjq(Z?3P$_{a_Gur9C#?%a`=}NT=IiO3v>cp1l3XV|4lJ1J^bFVUy1zzFRa&)JXp-
zL}%CVDV+1}DcnL10R9f+zh-L4>N+JEm++CIyfFi9&PI~{(95%z6)Wrb3p9ceB1*5j
zCM}<~u3FL=ekzCf-fq5&1;^L8bh+7b-GQ4gYO&oZJt1{yC6Vfoo4}4UzO|F(lBqRx
zUcZf=Yf>fas?!L|N^_=Zcv)q0!!ICq?`h=f`o)eithyFLc)xP1xTu%L81CiBIsTXR
zoFV53r!-xwW2t{eGh%j}+Lc<eHe-@=kL;j)nd;v3=Z||+QAhTLjurA-s$V<_-$@G$
zX=tW+(k@x?&ZK2~d7B9JKua4Qi>8f|5<p}4P`0m61-v4@m@*q*rXjU+bCPnJbqq{Z
z1x9(}MD^dS?--6wvh#KP^=LW$FvVBNtqf7<n->l8+NpN!p6Bn(HKL|SCn3>;j|nSg
zZ{jQoJQC2;a`QU=c|veLbaLqJF_H4$hRMXiXHaVI0HNR<PXy})fY}9CpG99jAI`1v
zWTr%*Ts-q8cfUNL%LEzY_PIt`M<_T}J31eH7k+rMlnn}sFVhk~`0@T#M!<;oUZRQj
zS5}c)w_UqQyii09e(NstD0v2&Kl=m&VB%zHOm$M7Icpvc#VTG-^B#Xh{kEMi<@&qV
zOj*>!Uxn0PZ4|IjZUK?+8LvOCjB~$T)BXpM_f59vqs%WNhqOW*B*MtTTHQvydLOvQ
z<i_&5MH~g5BEIYUIxL7I1a}Ixwz%{aXmfhUR`ilf^ex$-ip@Sh0RjrY%2}aX;2B$S
zdrNt>i3zvrgzkwBSv}JFs@+9MyJi6HYI3!P-FU@_K%sK71pj+v%U2L%Dlzk=t={<-
z#bQmnZda*VW*_qPiEiWN+Hz>xM@7q{jO<@iD+s`9SH+WPO*J8C#61k8{c*$@y}GC6
zE?oZA#*$rE2Y-DZl123nuK{m*2_`%{nS>pmOR}s+78f-IjM!vT<cIG|K=o{iYMaV2
z39;PFvfbu%S*q^xz30)qcl`ltOZ~Z3l6q6y?1?J~7U+jFol6(e)ca`<h<~C<`mXxu
zc6)Ut_t>tP{08NgwR$U0uaS`8ro-!>e1#mUmyfY~_dq>XCdv)uRwm<ef}U4sN-UiY
zymrXb97PpEWKD@JYC-ipe@khw@u4+#rUhXrVb;V{na><e-0x9%))u12Q<gK0={#@}
zD0oZcX$LuZJOkPz_XbZ0uDl(><{Ou5nI)HYUei%$5aS!WJu!f)J~>q@YkK0&yCUv@
zyR5P?=uSUr%910WU7G*?A4}|;<yEwFp;mZ;U>~u}0~L&Av$%`#$gDBqwPS?bSP44m
zXRj45X&ky4o_HQlJG;k+o358&W5}qMrn!Pn^Dw^`^~1K?kC!x2klNh6paI2g|4&Oc
zSClnk-lejiq^{4MjV{~AuD$??ldmV3VD@eFcupeSvY|&0qPHX<WdXxirPg-iZ|=7?
z5+NrEwU15OTM_lCWT|~g$LA3q7!%nVCZ_6O$&|$5>n?xP)e3QZ$C*wT)!>(gfJN#Y
z>Z!JS;po`$kn(ui-lLSa^`pDS!Kr6&*aQY1t-HdFQSK)3y}3DaDz$cfM61+Go_AR~
z7F1it1_VrgoLn$Tcv5q+snFtQbevM9Q8~_pbwW6*0PFj4aC$6H#_^^bS66s+82)xV
zi0eAGa%P3)AwvKA!2;Vx?4B0}?v}d?52!C;;B=edM%>pB7e5bwh4WS*MCLi$C+EKW
z#f>liDq8fDpLmUVO~=diU!UuQ-JwivF}Tg~pSgWg6l~9jv@o`KABHkvrw*>~^qf!~
zl-ntv=k?Ez=FyMYS*<zZ1U*=aM1z&8Mg`bU!4@tE6)rxg#5ec1?zvZp3NH{gb~9eP
zaJ;#9ORI+K9P)K~t8ZN7M0^^He4aj5<as%%fb<I$%%I9Peyo20NLTaT@0cb@=0GTy
zS_-T;6gfq@$wX>|dcW)zeLcpjVzZR%LWPI*4zb-24;mK!x073hI1_G8X>nrdmUQ)x
zl0k-|Pml#;VGq>VIx{QT;jf@-MW^n|VlCFsHE$H$U<D*#+a)-?BZ*(X^Q|1}q2F@8
z!}=>H8;!e05~*I<{4haw@mV3?VwcWT!Pv{*iQME)G?4$fQTK=IOZ_e9n$C6psu>Ka
z^(|ghz0VB8Ub(U}p1{d(J&;fUrUV%N)WBs4cIsky|2m5Wd10^GzP+s?&I(jA`hMV4
zSqjGDjrx(0wp0DZLiPYvv14gM$*OVlWfwcCh2FxV5lalDPt397@ty1vPS=eTSmF#8
zeakCho6es*HKP0NjY(o9Z%tsECWQ&MTC}c`xT^z&>FnV%ckrD%2G-xaPk~*-#x~Ko
zN#gfdn-w5X?b4(7Ti?5w@0Qa{?{Sv$P*2Ns!|w0MTV_zxn(RL3sQv7=3Gs1Vy|R@h
zWm<jag^YN;Q7dWG9;iDNy1+WDLufr)#_`qk!?Qz&O?`2qC$UAn6v-<2xo-Xun1t3T
zf(4DOjfB1-FD!H^73mYzLfI75eaVqGTyQEB@ctFCmr-DJX?F76-faNDHX<bMP~&Q4
zwc*=z(lpkG@A!ABe(@($V5{?(q4p{VLGUfHu!NMHKY)y2EwG4%LMwd0>Abj3n)prY
z-lESYkQMbqlKEc?VOY!@AgfEKmy8SE7tMRpmQUXRUY8lv$p%UEqWKe`uw0~$^SPFS
zFAMy!<?7MV)3@@MR!xv)PfPU52s6&qVhSxFKQO`nUMCNhn2u+V-{~}~a#)}SE$J|(
zKI+W9WuOi%pj)$M(DMj1VrrUFTXB0$ah9l!*nX-Pvh<^@vNdHE;X<QHFiI72xsaq=
z?DB;Jmv~=X$r*}x3#KXGlnW`wx42F>E=KqUfmHD^=|sKY@aZv><b|wVT_1GmwCvRI
zdtgbRKj-Awo7(-HOM|b!9h7FVKor^`4Fs7abDN!lx&uCMIb}VtUve?1q))Z~)F}p-
zEia$=c0qH|2&rh{);Z)NTqAUb*E@NjX{c=#pXLIJ0+UDr(<JD-?~N^3-h1hR0yk8_
z{!kzzE@4YmdTV81YINtB&y|?Iyo7d_hTx66qnrpA|GVzSVh<_-3COy#M!N%+=4rdk
z&RkhNe^r;zozpm`;|tSr2CloqLHJ|BL(=H@QNG)D0kq&G%|ayWhHBoKls46PojxI@
zbSu7XMy|Z}01<<t8FXq0g!$HT*$>GcuAIp?GYS}!ve+js%&z~Au*=_h(|V#6qBJnQ
zG1Lg&-k)tu%6Et_)0OEDXSA#zFVSBYcugE64h|``ek<*z@67D@hpT<KZFqIW%1TVV
z_cjbCri-L7__czkA=UON!S_pL^x=IX=cIno{Lkd6^Oz`jJb{IrYeMEdpuewh4`|Hu
zUbrqCrwvfRQJhVq3NGF%ogIcTol-#3U&P?i-Ca5F0t=_tm@7tB`fJ%kG%ls>Mo<0f
zLV^W+^$~&SJ`v3uJ!G?$?3ZbHzS#%J4s<^{1NE>haM$E(@PO+0ulEDKN8IP4=AZKp
z8D-j7&r{)d&frqd<$=7N1ZFQ8_?iYHQw6m!GY78J`l@d$E6l;dAVSOy)6BoUI$wps
zxcbqY2OS(InR>*$?^rikSH9ac3=5Rdg)i@|$lC^;m`{;_AXHIxHQQj~y4f>LNh%(b
z4i5R5Tl&TeYL_LR-7ki3_}BGEcsVH?|GbZ^32824`+E)%VISGy?=1Y9GXeDIiDM{N
zNKLCW@PJ8dVBDem&!2D-e$Ptdkduy|JSA1u13W4h^MeJL$`1;YZ1*M7ayuI*Zqc`+
zoW+!WwwRb=KZ#`?Uwo%O-ScXxbaBd{Gg)*ymV5Xyla8#@4y}tX#p(?n)znYlrw8#d
zgUG{gO^oZ$BZ}7kgrCKbho$nox&4Kgn%-d41CO@qMOydf4F|7zpaLA}^&KL5+ld)Y
z6vS+q^LVUb`^M9jWI{9#U&tSIy=Z=pdGedy${clK9z>;ihF)df087aK4`WAKj%3sv
z@v=OX>%*GYDYNgR`)Ao-oj}v}by(hRy*)mD@HdC$@+aT5%bGdE87V~RjgTY1-<JL-
z>J)l~fO~%-_GC?<@spbH@WOiN#bQh4OzKR9FVWg)t}RY1Dw%HF`IGRe1A>0~SQlOv
zLR<nD&01W{ez`Z71GF_F|GK>xuC%V^?j<ePqMk+)Te4W=Ky$8|)Htb~EDvNsNGmOo
zQd~Dr+{=!vIe6C{>UOpCw4YOaki{C>V7pbcK$#t+N=e1jb4VmdixG829xg2bp}~2=
zl>Wdxx|oE-9I>IHp+5`c_I!Z!66nyfm<(dP!@|0MhMZC}GMX>dS`tW>m35#!_E8cF
zPVz+Xq?7Yr>UNwWUZPFY1s_KV?(WMl8dEo%eDD!~=0wY0TxkmAKW{8<aRo%a+&xZr
zCaejaHwT%ocEO}wOJKI4t)TMotzI`0)~*xpswDR%$m+CaW{}eDCLg3OSodhE22`N`
z?2jaSm{wp~*q;K;f>(3-&!F-@F8g3M7WK)k_$;ozE)>AROg^{HshJItdg$tW79E$F
z05vTPl?~InpNZF3Pkzx?L1tBX3l&Mg{^NGtFB2H20p>G+X0GALFJ?B-QamgI+C-@)
zD~IjM7s$=Yk$}_oPtJFEc!R*re!?KOS}(*o)AH@jH|WcL+Ih&%ra83trSs;1;EP?|
zO1g6WB^6)!yy}Zj2t-6eJ&)ubJ&Rf<Oh>=*J-2*Jc*9#mWOZGxhww9?Eez@6^UQnz
zhCX>#yM%~0KO*l9-l28x_%v#OUI7sgv2E~l$GY0wFRJpwtj6l#t>GnO!FeSmO;J~e
z_aPU5r2f!uEBbOb<;@nq=(+IhuhM)U@Z!kvF<xG^Q%{W(1>{hwcTScY+e`lSWqatQ
zZ^Jybn)7o_SO~7bNJ@^ijbr<^2%qRLUgz?sAHC|>od`&W$7n`p{<zbfJ<HFa^baMC
zv6`uoXJ_oADxmo_f~7kjY9hOJa>9eDJY?m3*(}pPi6*9|=QqoCacOBIk;J@%{{~FP
z#l*y-6BAwMoYYiRzq*KQ&Tbhc{P<S<A@75DIzKz3qLRhCZLf%Vx_j35?;Y;KD5>=e
zY%$f=*V@87o!D&24omM!%3p0A<#p3eBx_H`Z9R#9indx}f@Q+(1+~PeqU3tK&zu|N
zvh0AGDgzAP&1j%%45XQmi}=7Z13du#VprcQlHrTHE=8hNY8Y&m)8T-Jv$dx&NKO~i
zO0+ceL+9z~BKr0H<klM2W1lwNOVg*yR@&1=(fP%;rQ(?Gv^ts>e{-IxU1*~``!Ma)
z)u&pHmyB%htqQWzIs6(O^LSVB!NP_A_?KnoW#*s?FrO`axprfB1c&*Y(F<3U>ipJ)
zZ2`YiIUylo60j#d_suuJfvDjGbv-Ew3HYyHzq*{_3wU!K92|_Ka-K%)y~af#s0f_6
zn7_cs09`X(ztz4;7LasG8qJzu2K7^cMSX?c^=40Ql>4tkSOgVo<<ldXUf>`LSFh`>
zO}dPxDt(-KE{mxu!6F6C3CQz@kewS(AHsB=6q9aBU^K?T9`>@l>3j9+14S}`x?OZG
z^an})plaAobV*NzWA&Wa(ZMlIeKG!lOZQ<r2)9Z_qoX7Wpdi?uZwRjh1UN!b@=sFw
z0iGM=SiTL6hbHryFsy-HrHyXr14%=c_Erj-FYx!h9`H=;Jn~fUJev)jr(Fjqv}5sw
zaHXN3A8t-$E_X*gp6~Y<58j<6n?V^H8>ctJCd|e&+pIA`%73*WZt88yw)xWh^d_{N
z^6je!<qBR<<+t+9E?t3V!X!>3`}ld5z@XWbk;mE_j7++vf(ME*MSXN0Qkk1(Hq_5#
z-3qhf^fyK<+6%zqf?BHY&E0UkYHT{T!-Olg$Hso*dw^tM+RF6VwW~n9A*5ar08vyj
zz7x0dbHT1%*t}AJn@M}*6`pYHEx5|`74Y(nib|m`UZuH=nB8$<{)k%Gd!)3QA(5b~
z_v1CU&#nBvF9f>PZlI8YBE0(;jisupT4g=Yke!`vF_nuH6B9$HQTZD@Us6({S#5$e
zG&E$+A2MmtyT1OC+mk$-V(sC2UV|3*c<*t?Ty-io8ru;Yge=u^D=-@?m>z<#$=Lp7
zn|i$@_HlI8HQriKYxt<+RFVGP8Wa3SxlNnt_Mk-bMN7ZEv4s4VVqltPszdmb-|tW6
z>b(e;N-t_7FCEqzHzEpacnc{d+JRdR!4M2afCVr-JY;*VN=elUG<5~~X{lrG^nLq(
zMH{%-n9{1p@cXvT?m<r+T}4Qfm|lJyTR*+as3zbA%@)p!E-#-rft86@Vcsv<3^h61
zp}luaJHR=#u4MHe=f5QaLT4^8?qgzZehEZ{8k3=Sz_~sN9UUTI4$t^_p-MJ`FBykk
zi^*&R4~J221UM;m*3wCsn*K!COGvx^O5tjSK>JS`{4HtMpJdL?`FygckSsFSvaM2b
zYTkOxlD$qCQYDVu(ohHVsf?eO`uar=QHYQ*eXkULm<TCh(|?><CY;AiP?=*gKl++q
zA!F{;eDeILEqQ;r`!mT&+`CeBk2xXH;qT&0&Cpi#ew1K$hrVFRI4qOHrC9sIMUdQ>
z%L>*>#>Qqn`ZA#Oi<=&E;$vXNt2g92t^qut^o=Nbd?NZ%3#M@4G@r-%Aox_MHDAaH
zoo;jd%8E{RclZ8M9j#s4HBOm!1AM#^6X4LhB^B-2!0aZ2Zu8mwUS`~{U+!HXE+>Q(
zCj&G_dgZF<18zKL`2JhGilG}@fV(WMI#ptFDYgPF8C#dJE@mnZH#W5-cTCr72c$~@
ztqoh7<<MuTuWaZI>xt%LHVS4))APhebNS@h@!A~=(iH)itEtQvONouz%+nUk$y^Va
zFN#-!N9`zwZEayM9?f#?Gc&)e8n4H-rKn}A9&`roz3y1;_W2(9j<53mc06rPNJG*f
zV(Fy8N9#3yyafxcjiHdw6{d^G{HlxFOKWK!kM#+_x{JFsc@=?{p6D~4h*X_1b{oko
z2wPOU*cs~@iO!4_pRx7Jd8S|S^lv?dyFqg#kBRoW9-3mg)|Xq7{8Ao^`8E$=IIvAS
zh?R~z<L~ZVg^J62)w<8X%#hJxG20x;NW+6S$Qb7C@6Anbh~9$;iuRNCS!g)<bAvue
ziNs813<sR<#b_3OVzzVAEWVOYx^X)I7$;Ux-S+{IHp89>w))(J*^IZ|ep06~e@e+(
zdl~o99Y_W^3e$zp8x0I@+&ylV4yn8dMzdBOnI>Oy@mOI8P0uc#i|w7rT|rJa=a<_l
zh~|h#_U`o??3u=W#Y+NOSDVU|jltk0jpYlBe1e^RNHrgo;AY{VI!TE%^dBS&g-Cua
zx(#q%{Mp%C_zIyjG_?$`5FvxKi<Gx&q=Vbj;t-9d^=62?4<AZIJ9A7buinFrUE-1!
zn&2f$9x|@x`*6GQj9%~aCOPoAx7$g}>+n#?xKkQ1hvc{Z*x+LZUGirmAW;zn5f>`(
zuqC|<UhYU&c6PUh2F4gn8E?Ahhs>eV9Ukl1_nrx{aY4gl)IfY$ojgPXg3B?wpbGuH
zQ+UKD*DYLkJ=f&brNYv$W>23hzSL=B?#+FDMv;j$S8S2sDEZ?iJbdxN4gD`Tpw%Zj
zHJcBI2+pa@XXy$pD0&xT>Ud$2=;OPDOi-cqG)6NAs-dWsKqj5E;lY}Wc7nDVXsb!T
zp%MrWcI)w>9eaI@*%M7on5@2h2T}a;ix)dd*a$)g9WSwvKHNZl+b5fa9uSEc;QcBy
zTKd)SzjN~gJrMRBWd3LaMM|9eozPKN<vqf3CPbx3hU~x$(%|&t4#SRvgyt_K0l}lS
z;Bp+MnI{>#_Ir&_z=C#V67O?sfK|-{FHu^tzPDh%3u%a6!L!KKN<|0RfJ6z-_y8+)
z*spQQ4HDZ9yCcG>x9-pL^hASo<1_<*2=6Z+U68K6C>r*6k;qT|n+51H`gWXdZ{hOv
z)p_vwM33rJG4uqbN;f{|tCzi?-`4}=I_|dU+m|(<nJ<%xX+v<>bBpf$nd5HC%zQK<
zAy<$s?c(}~ksBTbe#`F}zoPdK;}g+9YXg`+A6&c2-waIFpZUBXFP|J_7pY=ZKJnXc
z!@aKZzkDC!m8&`6edjHKj0BP0i~V+9(Eu19oB0OJvac}jp#d}Tvpm>5fo>bi)*Z7Z
zNm1VqriX~~<jGV!e4i|?z#3N>^)eXpDw@VyJ@;O}YF7kmd;tQ?z1~j7)&k3PJ(gaR
z*Wh%0m;vFyI!h^)1vja81A0<jNW{;Az0-^}u%^M}>?SSU<h{OD3|LX0{Ds){4akV$
zM5(^0HbV4vU16sllyv2xSRWq#vSaS-dDQ-QCw_0jPr|R*rgk+2jrcNntVW@!XxIo3
z7lEVI?mPl!dn38*2DFVLpxGD|g+pUJSmUF8p<)M7XRgFGC+IloGd+ZAZXW0G*~J*r
z2M(k-tPWVlKE8kA4jJKGSIR4kmLw&6$T@eFd9Ej6FzGD#b7z)(64!y~M}E2zKluIS
zXsomTr%mRgCY^LP=Zni-Ex)X6uy~H)y7!*+^TxuB4y|F=ku-kvcuRLS=jI@MNxe4V
zLOo`<#LY%lNy<ik$DQEI$`p<5izj=ytM1ZUdjNh^>3c_#9Z%ujs@Sf}cSTJz++Pj^
zd4w<n<4&(G`UcqvZKP`PUViJKVui-QF35729)l(vy)0Ap*>w^62Q9Jjk)ng;CunDA
zfJ0_B-NP>HfiiGzm;?@`6tCG10se44C3918Sul-xJ+>Su_*A=UHfm<WH$typZsZpU
zV!VfUZ+cDabRO-LZZ2UxqY~l~&=mMQm2l7AIQ{zYaSz?Y3S|0iCpRiFHOPrRi0fBM
zvCBK8qMBfe^x^saerwKJvoU4$>HBwwPYLR&c+4)af~5kG=iR+692|+O5Yq4OdA<L7
zUm&q-E+#$RZ<EM+V{o>e*lNC9`V*@^52X9BLZ|XHiln>BV~{F!Otm&vCrbTMQjHQ`
zi2US_sw3rsRKegko1cfxFiTHwm*tk$OqdJ{a4Uae%%9P%PHGJ{;9_zlFu7&~ZlRJ#
zaMqG*;>`UPMO4c`F9Ha4px%!0>x~%elttHXk{$x3cPh!msVs<d3g6!iEI2KJ-zphy
z5=wVNmSLkkE&CF&K0f^t$fh0FU4GXiJ_esMf}@vOmwt}S0J>Q(a5C@C@H~taKsI2Y
zr?4))_JT;<OE6a+2mz{E`IZfPJhE(AbD5s&zzIpaRUz>9;HjIL@KeuKQX#AHACp#t
z=Cn7Si`cYCzJay9?A&dgICwL=T((f3-V-GdoHxvIi=O_U+S_@#%$3{C!4y?Nez`YR
zMu)<aBj!1ym7gm{pp4wcQ*Ua%yIHEz31>!a>1M?|$1S8&BQHMO{I}BZ&Rx!=LUK^;
zuPEXHUk+7Kk8&0n^$Y}4?&0zJR%}pl@X3pEWTl$@wNo^g%A&}zh@UkuMSf)^y!V-m
zkKYGNGMoWCeg$NdGj;;J$)~N;uPFG;X+PvrsdQWKvIUV9S?oyi{seD$UC$<6-EY5k
zRHL5!45}B*c&i1`AEl0>=Qz0MrDjr~>7>;Q(y`#&o3Q?#=&293=Dunb?d-U2&W@UD
zhB92JbYq`0W{j6BYA=be!UYcxRU#ktm&BjniN*EWE*}zVc~5&)EM6eP-4X&a`)8Z3
z+_%qZO2G=6<Ise97qbT&H}X}j-cP1UDlC5^Mm{e*u$Df+R5SRTcY1id0S@RPf`GF%
z3FNu>aJ}ExBx;fp`lJ_=SNNlA5P<WuC2=5^byW+PD|bu=((Ff5oxtzaRv8c%<ZxI0
z$Nz_?ui&bqYnsK~JrE$lCAfQVhv04@xVv+3mk`|DT@UW=?(PySxPSA!Yu)<?ILw|s
z-PKjq-GvJeAx%4r3bpueJSs|<|ET~@`@`ZOylw%ikRqpdF*|ns*`ru5ixpYUHW1S|
zeN-^`TZ1BHz!a}Y*10PSPyXP@Rk!X-lLK6!kb%Q&Q;4qwS5n7v{CB&T3+rE2F@nD3
z!ln>JC4k?4Q@e07AoRwgX|En&qyX0)n$TSV-H5^QUhEpflTJHzda>`Sm_y+?qX8G%
z{ozKgGzC}v%muM2+usz($St+go0UJ45IdD$o3Q(xLsAql%0%8+6hUDpC7-G3MwIb<
z3MvB{5`TB>&8mAJUMMjlGrd80wxd+S>s?6(dh@5SS72k~UmkUIxf#rB$0wWF_HB)2
z`iA4Xkyh<|tnf`8my9-|8qCdlh2lWv2BGE3V8XyCMW_nHSkP(ic#{lN`TgWU!ov~k
zVWbiNj!{V45sdbg!awL%#54Q;Z5if|+}a%0Ov~aZ@6gJn??aZ+pOz!qhrM(8<2n-x
zp~o*Y6N*o?bF(zMT_jz!D&vA+&iGZix>Sg9pkqbq5c8S6QM8|N7wrYPyLYfwGUC>)
zoE$>7OtoSa6#Rh}X`ArkV8|0g*bVxkU73`O-YMtc;$Xam1l<Ss&u|T%=(SY~8DA+g
z<=4a6<5ZUTwu<7a$tBahfzjd;wKd&)(Y@{9<;_Jy^y8f6&Muzj3_j<0UFM_HJ)UyG
zUT4rzRrfkH^G{mm)OF_FDT1t?Y2PU3NS6yp_Y1lxJ=huY?-!QuzC8Fl#idv0n!{Yx
zIldR&G)W4714O6<14<UnJv`58(J0flQg&Bs1J$4yK@%G03yXzzeDJPK7T7D7BVB9O
z)x7Ltgv}J#^Y_(ORk59Mfd-^9xj7ZrZzjYkp`sA)&`&$F=$}XUXP3dkzpXGLpE<p8
z>g?y3aBNopdn#ZK$#ne`@Koro`li=S-1D6O+#Qspo(zAQ;caX|YETmay&$eVN6;|W
ze~bfvdRG59=72A<2|4;>_-bi1D-0d|tDZoE^q3u!%7<zFA*edY0)v%p&Pcj#XO1r@
zEJxcr=={AZ*ZbNYeSPAQt5V&<{dP_BkK+WX7T(o<{4g~1gdlnljp20+F<z!lpct8v
zd3~<>xl(%k3bjp>1~FkCrdT<i#8*ycc^~Jl;{^56NAC}ziu?})Kj7i|hUvzBYW=Mn
z>_jcVqP4pNA(JMDyg^jU$Wd7Bh_o3Dnf1a17<l(EdNFNyq{h0gF(wk8?u|b4_z(~o
zKV>YZ1O3>orM(S-<7|uPl!>D0FWWuYMw=c4?`RDK2+`Y^7T6i<!N=SE)kg2)1h+`;
zsn==cbcR!8nllDhm^dSTi~g@yQg*K!1Cf)nbhwJ|_7O6L9+*6-p?tz0jjys(cTAlP
zkL!dN;q61G0+v#=3b`d^!=^7A{nb3~t3Bqeg3;3mKZle5rHhW}GBtwgGojaZN+4fD
zuUAs1N>sUiEEQs!He?G|Q*{vDrlmz7%^poj>KLWB<c3^*=8XEyr4Npr+N#q_ewq&1
zt+tZ|31)o`%>K0dok_dWaHr1dtLBUU2{t6lT#$o$*8O$Ryk#SxA;xRONdh_1WV9~*
zL#MJ-f-#Of8A%AK6iOqQ{+;n1rWp?7m@q6fKGcP48xz4z5c%y;^wrMZz2yfVO~^X;
zqay)|9!kei7;m9dGrG`3OJF!Xnv>oyI!4C&6fW>U?XmAoRAh%_bl!Gxb_w@a{es0G
zxcHJM{(<hdXIA$u9L^|zrAj1eP6`(#yBf@SlHFo_bKfd9WkavBMDW`MXsz8LX*jOj
zsw=c7j$W#+dOPmZJubSNxM8-1!svrFmNS}LYV86QAT!<T%6(3Eqv9IPS=12k8QNVV
zBJxgj?6d_oWk^XcWDHjr*TTCbFRgoS9>mhmiHk)iDVLv73beJ<G3H6&_~Fkb(l?$g
z5el`Xy@mOYZYJY3Q>3&l2u~<aekGV{a@?${UC03cD1(nSl29ju#rayAy&@Z*c_FJg
zpU9*1I&2%h@S(-rkwrqyo`(_t=CL9S5fQc+tY?j<CpuL%uZTxu^YA8EQu%moHrtDr
z9ka1B<hO?Y&grs)p|Jec9aC403<MNP^yksE8>@=d{E+$<vvYC?A2RDMGatfS%>L!-
z3$9QV_x(vc7<bL3^Ya`ddxUNf25Hvov?+;J(k`9b!8zYnQ>j%K0TSpbI4_#$+!M7l
zoydsPCv091jIgRLxawmySk%ZpQut~oVkY6z#0p!e)YthCG=gVIkJKK>htOMnPE#Ii
z0NjUARx}5)GZ_3TgD-+Yn{>HmVMuDQ;lbe)c#Cf$n8$=t58D^F=Cgq$Jpy63F*sco
zV_$ox1{iA0YNrvcBO<%LFY@FLG7mfd`tMqd7585aFH!#puORiYebZXyx}#d3nz-F1
zYHqLyyoAQ4ecX|pIhz0B`-p&h#I(Jd+p%)AXs@_0z=`YU+B3(mWP>Rl{S^ZB15JZw
zq2iG(JXvzN$6&^P!T~q|gkmR!dTJL%<1IKgzHxRTnV*zu($c7`d*G4uNQW5KEvY3O
z(o2OJcV$r@T^wa~h4V?j#U$L*tpau+LI;(<eA^-~5m>(qnEq-Nd?iaK_Y<`0dtZ3D
zr+QDTx*BrnUGWu6mb~=`v<Lpx17hf93&@QV{e;I8WiAxQNpLP9oW9eW((H5Tzbdw&
z>Wfv;319U3tpHcvUL*ZWQq=h{Xekn#b0Co}O9zxhN_x&<>4WOaW~NkgK^>XrCr-qr
zO$o8~1SSXmt`+4Xa*mV7(X?e_6VpkJiiapMAtkK!>!X{bio5f7<N*G2Huw$yb9;9G
zS5ZyZx@#h#fb{_P=C?jnPkDK9*pr*XTm~lanTvO^{D9S?efnkFZZ*XwIPTF&ZCLZo
z9{p@!tC75>uIpfTY6SbjgXr*YXcIXD7HEmS>Sp1oy7?pdr3G~J)=v5&I8-0QRrWYH
z)cD8B+u;J4$~v=qSe{(V!<6zV@u^5Lf!44aWOO0iGrfe97<@JH_M75Db~ET=ho3{L
z-DGlyerd&Fvprl`!6?@qt;xE<c;sS3lP}QF@bP>3WOZ(HYfAZmYl_9%7tHQ1MN~u7
zL>W~2cV}mqEwukWY(F21m#_)Wt}kngfZk%E%Wy4H9}rUV;uIbJ^|7ldyQJ>sC+Fqg
z=3nt0>zTj2Ir8Csw6#wz-Q0P+U9t~uJlA6VsbfViTTB%Xept=_ZD|TEzULqKogI4R
z`}c(ccV%!)i7{^Pa#t}$lAzK@XO5?aO+dtRnz9Dj=4}=0fLOdlvPA82Yk&8bAkQ13
z+lMz76RCTu>=W6$4YYPo)H$<tIP>Tv!6@tF4rDV;)uh|z??q>;LwZYwZk;tIr9xJw
zv?DH`R;@FuA0}oh9+RyWEW}XbR{AU<db8cAm;jjV`$la~^rfia@g<*jABW4AEf0E+
zTe%y|Ls%JtuIRfA<Y%3(rl<%kp^0w1go`z^hgKo2?-04N$z)2)i)j=r#R(r3d^Yi2
z8(EBwooO?373f~XWim!L*hy{-&y9XwTiBNC<6@=ibvzbq<x|yEjs2}*5@B8l=dY`n
z=cMvMW-#*W>C^N1wEk88!(vFYKnIEAsN*o>)S=7_?(WTAi>`fYK`({UUC2V3B`39w
zsne|KGw1nOyX{R>aVRBL^PU4jw0|~9$n3X1tA&ND8<dn+@&*#qTftw-h+`zjy&a?%
z#Ra3z`?uP@Jmu&VY;HM^tnlEJs%Ga?u>-9eSk;lq%x2fqU-upy%Z@RZE9>>^TmO91
z&*9nSV1DQ^$mPW?o5SQG^cRels}c&nv4t;5YGoa|8G=4TU2&SNCEDmR*2p8x5N4gf
zSLj(Qq2#L3jp+Yt@?j#2$9#T&p$Q1IZncpv{3F>V@by%51!uDgsWWvYesV|sks;}*
z?_qD^Usk#35&TZ)LyxpKHstrhvOlPZM4C>%s4E96czUgcin721%U%|BSR8Gk3E>Mx
z-j_xv$K&fO=r`QjNN-K+Y?R4F|8Z(L;{M|iM4l?io$NLFOXk^dP#DeR^H2Ai9sY$o
z+Ft(XM<|KgkfHmYskvyKLGy(Ggp69^G*=eSH+vy209N^XoQXM;K#x68v3BYZ_-F05
zalesdNeq6ZUZQH&IpGU`Jb+BIHAI0|MuLPclXys^y+obcJxGoMiNm;kii``}wAIGh
zlm=qBcO?6m{ILH^=maN*xqDs$``WfE1-Ugyvmld{t-rYp?&-erzqS6^%Ds`a4|*Y9
z&^Z4AR*B4cy0O1BSvx9RuuSc`VApUQtJoY<`?}Yr)lq>BqFlLJKp5-K?nRXVAsGv@
z$-Y`NYWqsR2JaAs-rU!MC$K=Q;ZdErJ|6i~M1KjpBIWbBuB~IuPViT!r~sggR2q=7
zO+a$_k9!N{Bg7~EzP4sc#54F-gpTF4ST!=~Tm#JZoIF#(+lG`l7-oKp5)ukVAf6j6
zk%o^nhidM!q9GS|4N6uo)$Ckq|ASO*)b|@6KHUZFyNe^MT6j{jofHMu>hs#5lY;6-
z5#=%;lKH-m8B>3&j9NLn_j7UP(O142q)>?VXf6D%Nh;Hl#V^UjPm16V_G1n;508DH
z=Tg1uoyC0k_j<E6@2$c%tYzF}<2yktL~rI=HsZc^hOGi-+(neo4CKRXA_COdzrj_9
z6CoY$Z)7T<^ig_vgRj*hul%cvos}L<FZF-ZY9et()tQ?XGy^s!@QIuH=SJdLDhICy
zYM7QeeDM{XJ)l7Npun?ojs<V$Q}QC~?4SIWOezTE2fPaGzR-nQSAAk7oNp$(g<fmB
zc^D5zzCPB3g{ES~l#V=Ef$-t_2I+tF+P?8thq(GSNkgwGLaer+)j+CrafC%fKvf82
z$w=h-L_ZO0#*o8$rz;nIGhS#>i}oRsGiUQZ+?*h~P2-VG&ZBJ<JU7M&4*0#K-}uzj
zWiY(EC(tC#F+sGRwnJPQ#<)+}%axzYJ@M+qr{EVynu>czU&VOXw~VfpT|*MBPJa3s
z5$gh}D>9YXY?h~{{^<d+M0TvC)%%l)Hr;52wW^j@iKEkus%lPUnTU!StTux(K0ZYi
zqtwQF+{;V8`6`TfJQYnZxxMWiVQKueG@ZY#|M&@iXezO3-T5fzqONA&0@)kpY2*?U
z>&cSzD|iT$`dL8hBSiUAloq0+8TVb~4)T$1kdVGVCMiKj7ls|a>7CW&zmB4GOPO+2
zYyQ;120k+Rs>&YY?eCHNkYh2QDGg(qEvTPs)L?2<wIY-&#f;8ag6?A=IBT}(AWT)C
zRm<7GZKV&V8}qJS`hM1o5{1|-s^IAw^xe`H-z~lRWqZ_u>NyeNbVR$_JW{oEmClKK
zl(fsh-v2vA1+e!z4^qjKKDb!+vWaSIbqXtd_7*@I{T3#+d0oJqHy%av-P-jV@;%d+
z@^L9AQHFhGo(GPuSm1GIdy9j$z#5-Gsdas!CEPA)qs`n2rKO8*(xV65lHxnFxdIm*
zUVEEhCP$&S6I1F`Y-8<cBh`5tP6}(or;`IukYXYsr5&+P<m0P5;EVm^yYn>>Nu-UR
zbQk=ovkTim<hFx~$o>!|?B{u{s#5-Lr$ENfBnaoT4WjV$^c7b*wdBfjgC-MlDPNP$
z^ZZd)d_T}7!k6wT>RI>Ks-&Q2_6pG;=(+z=(^n5%4{xXIbfCN<Ik`pXWK?&~(*Az0
zW4E$!|D6O&WE)#?*;%nsVyxYzctWQ9Q=V}N*QH|3H$pfB4$zijjod4$2XROTt@djv
zhozvv8*ROBHl_9}Dhko?;Y_;Lx?L^Jb+H;9?Mi)e)KT`4<Hx%$u|Qe|cq@1RVM|HB
z%{2WXLPlK8n_rxW^Uw9xk<{^8Y`O7J9M}?f^xNB%EL9>)?SxoU?8ao@ISHpGdGl8z
zXf{x`bX@M!s4{Jo4r~t<8BKaN`-=7UN#6EJ&u%9-#eRY#jkI@!{^@>@m)%WN0p$GC
z6L51U1gk@&s-@Dk6meBoa<xQF4^V7X*kzEG+wT@EQL~q6Zg&1xf!GX>veB3R;IP#L
z5Ce_MYMRD}34^!}SlQt;L9ZIK-4Ifl>!wvpzV>iiZL%0&r$g~~F<W_&%aFLy4(Z#e
z<Ks2t&4e)}E5RMhZ93C)!haJJ-dG~1CcUXF`Hd3XaOguT_V;>7v3E>7Lo5ecoPKq_
z^CG@oQk-88(XO_`x>ULM{KVB}NW^FQ^YRW)fkrsqn92s6pk#GzZCh`qnHT?<#)G$s
zy~yOr`W*kiA@UIMoOnL|W<35Vv0@okqa!OSJ0Hg>gxB?f@IR!nsSkqJ1l-*fcO0sN
zIwY_OQWTt4@3pcL;wENH{CwjSTprTM>m-XqMR93%2KB!1hkHPJF$Kz_8bKo;0Ds^7
zJly$pX$NkcPDqZw>3RSPkcUp6>(-%Wa9T?NzWVa7@pN4}ql0<dBpo_)_L^(VVP=)@
zvIoq*(afE46xUDJ;~N~w>qv8P#4Tcz8Iw*a3l2#mPcr}=Gb`ZL-06vmTf5tqge#xE
zyWYw%S*f!(-_G+d=R1zD@bK$f95)ZS(s11HfjJ%BOhRHVErW1sVlXQMF%Xmz9g<7<
zK_o6lxfh3os3xIkDz3-O3Q9@<krVxJtR!{n!|aB7I{F-U=J7Ut#x*p&K*cB&vjQ47
zUDznUa+sN0I47oZ)&&VoUSSKo3EX-RLZKux0hLtLIpHWiyqw$g2X1ztcD^_j>;4{#
zVNQw5U1>z@P`-h|95U+m!M-@}B3IvvBt#m)jTu8U2IM#c%Lfnbg0|pF{4n1h!-J2r
zq1S)F#`x{vZqSB;&<`kRn~R?WfSA*sn4Le`G)}L8f<;X&qVKVC_|o}2<}q46k)5cW
z%>$ixOlTzD>a$dCf1+_SMf4P>wR>rPsC0OqNj;ignX19IdGXOy5{@>|^&xywXOdR|
z+7}jX-dX{M26Wh;Eg*~k<|dT{I0{yDHw3g<zMB?a%HUaOc$y7hP#wACjQYacmkI?L
zvYTN1;g3V200T`wuc=l%5nCj#P2wv?B|)WcLLHwOT*yO`|1n+9XBBG-SU0|>b*qc!
zoQc|>^1Ug3&kyLZ>kZ<N$UfTF$IOE<bSR9ND-F&=9mMSs9)^M*kLg#}i{Y~J@!`+p
zujK6t36S9{@H@{ewFn~oE=%q~q)>F-ug4I61-1zp@IUx37GVM~nL%2I@P#vF(N{ZA
zznYgL@s(pxXue{=Zc#3SjNGR6=-w&yZ|AR$1KIK~=rfHvo;<a1Xg=2O9?%BtV}~XH
zfCTQEM#3Y}n&mg4=*N+Q$8v7BnEg-^vbR*Ts0g7{FqdFF$(P;qYKx~M{WM1XsE6UW
zyn$?jj5LluyHOl6^{Rpe|F@v_YdFSC7ji;iw5e|TJ@cn2rtg)-I&Za;v9$#sSid~;
zxQd+=Zw_a;P`CPPz}@uoSJ%ktUv8pijxceLg{Ka8XNz7K(>1b>)<s@%;t1)ObTmls
zAMpG>+7S%3{Y~=J3upet<>Ou11(QR$6FD%y<qTkBTZ{WyK?IV0yLqikXjc>x)v;-H
zno-8d&4uB=PmzE4R;Bvy84vmO?(}P7H{TxL4h8tCP5U19@to&oD$;`hPLRp-X(}0H
zI<q6rt5o?cMX3zH=x-`(@*J%SD*6idUYAPEu9-6uXvIlNkMfxz|9v8QQN=@QmZ&33
zW76Za2bTJuS}4`_6V;Wp3q>kt@@6a@)P}Dd)wYi=#G12-;@)i=Y<9){BsWF~SQQn$
zNmIi9tMg-{DeVqqfXTVl^+o14rlX1(IVWD1J9u-AleI6}>!I4^hlzpJ$IH9cQp?}@
zK3wIj^M~N42XxE_S02Os%}RsGvwKo-B@7}FH+s2U7o10(Kq8Dcm$o*JdZ-EvX)3<A
zCC7Ju)1@}BO;`YPaKYgRd~4ro+LP?&N}aRX%PHd^FF4!D;gfbT{J@y$Sm#zCvJe)A
zp&Vw8hRu+Ye>b$7ru|TTa4-TN8PeB=jF%V9Vll9dtaqt1U>=sFBHsm><=Yfyrg>o2
zWgw=kIMY^YUHpI~UOEn_%26Zf)}VJgtVd!gF`Hj}5E=PLkuF>FV5vBAz&ji1)YrjE
z#mNG^e`el{Lw~BBSPOq66`GtpG8<@kN<6ca*kC|w!|$Frp1E~b>Tr<>eq{Vx)~v(p
zl2+4QpD-T1b*>V4WtPWd>h-!k=Jkq+AQW$@)3xire8aw+V`?Ck7r2$XI%X!h?|}D!
zvy^4B#XDr>Bf^t-(}7KMAA~ZSji9Mg-8~??aNGQYkW<v#%3hirpR9JYv|UsqYB{@!
z*}WzQQD!FwDU@RF9h4gw(h~>ODL-62Zf1A7DbWF6DmMDKxCg+;;IqXQj^`sF@MgJf
z*~|$Ts~|nTml$1>C7Hh4^7A!B9}vCXG5*SAyZpQ*MetF0jGkniI;2@+=P&JKMruZ?
zj;>>){CWWNJB`kl!VP4PFD3sDwwwNWh8MVdDPv1(XWJ&V1%6=md=gH&XdUnAKf{Xz
zT8Q+C6bo<m(Tk6p-0=Zs^-o~9i`B+@t4sb<$Q|&u_^}2UdJ2FN(A^i(gI;K9#ZCE^
zVz7y@{KmbdEF)MF@3iYvDGnS#_$1xfPA`*0wqh6<nL$j<Xr7QknrByjDKmfk#s-Hm
zPr`WMvbmDX?*fTWtne=}q%-(D!%?M#Lz@-3(n}#-(afH5DMsQQO>8d=Vw37M?ba%v
z3q%klwTxIPBi<8h1*E*LP*RDX{+0eLn;Q-zmM=WvFq<T6h#J($T|33uLC}N6qR0BG
zaK?gMggj;P>v!B)n=kAOgnOi$7f5dEC|bfVe)n)o=4It0-cKeGU~7)%L8oPA5q+<P
z9K@UVAYH*Nw_xaS4>*Gl3?}?mjvGqe{&+lplAxl`cQF6Y3-Hvsdv+KEF5f*23IwQV
zSd)cccxsN6;DqM!p9%#y>lHp_>K2c8)>K_t69oWHQ$)8N*f@uY#0yuA_=q}bemIq0
zZGQ^D-$8XuW)$E38}xB|;&O3PsLzDyCJ@v7+RPhEDkn6YW#x67tlL0}+_vdQ2E<i`
z4+xgQxxXFxuPuMfJfn0+?;K}Pr4$&xVfcL^kV;Q!`iY<;4gs*5=bs^OxrBBtQB%cn
zOV}6R98|0tyc_uZP2yYA^#68O0VI%3@7C8hzS_p{l>*M9{aB$N2bx=AMhL0dq?^VU
z;FGLcTG-FHN;)PHFKt1Nk_kI4brMQyJxor)RX?1LKS;xlDJ?CO)G!s#Jt9~O9UynU
zIUVi^lM>;A$^xKfNkF|hL;3R?nN*Q@yDpa<p0PtkI9C@jvYrNR;V_<J&ny)_2yS3h
zyaoT`^Rh4VLy2g)o81hT9rLe_zFofulGr|F$Yb-rOcvr_4|7o;Z_)X2Ni-IV=fFcS
zp08rI+)FASjTip=yOQp;-~NX7&+mJ?<ht7p3xMCNA3QSQ!2%_Fsm=fX%Dh4SpbL)K
zLydf$&;Ox@G)V%NZI(>~^2NX`RcK)pJfOa5vgT|o%7aRcC3zvjTt1Dg)q}~Ioz&|_
z{RY8c15r8!{44xCCAbWMC|yFt%cMZ1i^`qumDJzcFVPW7bs>LDy4WRLo%&G;*@jHC
z!{@=OY-ToxJh5FbRQcidN1BqKV>m*|8N}$nE_;|c#|{Vg4Wr`~2*N4WQh%g>c{5)@
zdj{PyH%sX0jyG!6m$VWTKQxo^XIv>J@2$&#kz1RUN7B0nYcGOqvHg=HGo%H`-D}K(
zb^>nBr0oSTk^bbq@~S2xpi;BKHa{U6x4-HL|Io2_BwwG3UU}1DZUZ4t76PEInxZLt
zN~}Ei4bfx$WyV*ZbR|n#0G8aUC7X1jQ@aoN<+HH0aSelkLK|n|@>JLN^AsF`@XNi<
zYNts2YJ>gn&ydf-_j4T|3fQQ~-zy1cV}uiSLMl0XcF8(um*gc8tx7VVIpM8NAtK9A
z3Cz<+&ObpmoDa*WERT+B<p-m?QD0sElEkTD0T|^qzi31vq8B`ZCCiK+2le}$-B;K)
zg}2|_Kqfs9PQUn+t@aapEjcbTZ9R%2Ro)?F8rBjGiHo2O>DTW2=U4X=Nu|3IMOU9c
ze0>+}?z(!~gN-Y(1VDz^XvOS&#qNm96%F?o|2Sb^8E_FY+{pYj{&y(@I1B`fjn#xh
z1pTn&55IYGD#_vvu`<6Ry_|!M>33fQYtbQQyClW%9dA!erZ>kdw$fl#I*xD4?lDd$
z;@=22AWKyP<|m@BaI@q1O^_DCrTu<i$bEE~S#%l+V69Z*d>Chv7#sIWWYP+q?Jk|*
z`w828tzp<d1-&)9_Lo4Q+~IPGFbqVY`-JN<icxb6T8W(H(}G1H2-9+YQe8OmA#}5j
z4XuawRvVG~m2yTvKw0yp_sj)q&&urMW5PELeTDcqR4t)<6nJ_7(nX8vWb>i~6~?lE
zfL&MP+52X`#HR|%`h=->xrWwzMLK_Kc&(i$@TI^F^3<jK?D1{bsxD*m_zSh1;;$3Z
z)od+d(@*?WYNb+Muh+aMGpo(6mlFM>iBcObLJ2}!$^CqMyGl#t;)JuDVZr%)(+%&_
zPX!(J*0>a}Rq1#SF&IG!ia{86D$R&9^<~O5BUrpPPK+X}4m(Fv;2bT3;}>AAuSDn%
zJI;yoJ~I&Ib<gA&5aK(9JfriFC`si{BUI^x56|V7LrEQ7USS%z$n?~b8I`W~v|mYD
z59*K4cE^rOW-6kqbsjuv-Y|dxTJGE@Ps$iGV>J+R0!1I!M9n-S*A6N_G^^NKs~Tq8
zamvLQxw;(2A`CvKBYxMBgrG;tQC&x|9{bHMg0$?qx6ZDu*~I66fIhfvtq6a(gW(5q
zdY5_^O{lFBXrX^)gwlm3{Oeiv>Ky@^BThD9qriGKl>?t7l|CI<3#41z2?ErErH7uJ
zFlz?83U?dq_pM@ah6T&UcF!xdviZR|?XMSK+ZQew@+UZWE;}TjSl*xpIH)A5ALq;)
z+Hc2rGCwskBGDpCx*7g_@T_-LLF=2;2v#*mWu-RvK^NPi78~Lhb5<%#{7r)FptG|+
z_1p2sqs1b=#5YmG<uvLGOKIRN550+GgOw+$&DapH><{mhM9%Y_RB?Ky-jXZ0Y+ddT
zef}W|?hTT;bWmy*H)Q6KLjV-mYwA5Uxpvfa2YC7d<0bL^1&`&1XMSj*0D|4*QiU{J
z#Ha}(0bWz{GU6O2XTrwNar|2!GyW7+Z^khk1;bVoNA%j130Ah6NIJ%UA1@$?b@6~g
zZ>#l1wfTP9o#DqqLfbdh=*(cyKTw{C6^x6M`4?A~y?Md24+@RD5L{&(S8Y{lG&%0H
zS~#5z_~4&qn|TH9p0AC3JQH;c0eCuy;X_OkAS|@s+ul)#6c;m}R_E7(nMf{#+lm@_
zh3O-WhLC%$*9ot8579f0L>{z63eb(}6m&OX6^^o~a=-YG*U8D0$^NifXdc!@ut&`S
z>M>pz=Nw5XbbfMAWU6tqrJig%WHNgbQ1b%_gDnxV68g#0RFUNQAI$<CssXV~kz~Pt
z#1fR>RDU>5g`T8ZJM*)go~G2y;l!gtn)A&fc?Ws;zZkMon$pP|{!}03E(nw}+bfr%
ze&^fL&YniWanwoajEo#P?~N~h>sv^W=7EIY5wY4c8LSLh!g7ZzD$Tc#NtZdH5PH3=
zR;tFl?|*QmUz~maj0XA0MODZh9M3~dbVowgL3V;mR>d}t#~yY!7WIj9g9%&^k*!#u
z)iKpUoTjOd9`B`vL3OxIgt%cAp{<=;ww)hOnyTyOR^N8A(0}zJo*E~7I97cuK;_^<
z`8Pf`?&VZFroHwqAm-5ub9)k8?}e$&caZJ@=j%y;WE&M7KbpJrnV@;QXu3n$J=o>?
zY&oty@Kq+)X<7PIjP24CrUh<?%uTpd>5o!c&(3&XLI%C?SG8#X3Zpmrgk|ZGwi@;Q
z<Nd6IsFM}6>rBw>mo@R`Zl)`FSdBec+X3A9=SHONH8p=RDssaM-PxmwHjlPoq3UXK
z2*`_w=Ewpk7g)n}7wDh8d~zRq5DSG=eEu9{^O-!)isduM#2_=2QZV=nAwxeNX1D#6
zz3#!TC7F1<)kc(YJbMj<Y8l5b+_lXm`=Q`(jHWnCZ&*h;!vEb)mUJw_t!ESOvun<W
z5w;M(=AWSh9_-LiOuu+~o53klJ;d!eGrssv|DN-47xSad6fIC6lUHB-Y9Y8<&h@Qz
zSl1n3nI)Ef0ru@Q$2X;*ZCGS`i#7G5YrEKjtBIWi-q_&h=DPctO&E`bwCz6)@Qd=e
zLFfo~K6_n3_B&gAl@!tFKZOi6Mj0E-5$_NVY87G~%$747ZtOyJ>0Ws%PNXWOC-iAs
zdpqZStYy~wD}+oPB;)zq4`MVBx*qfp&f(HY@p-E^UUQGgqfQ71tC~MIWlj{-=#E5m
z{c(TKGKb&~MUf!EalR4I_qZk-&B)+oi{yJeo0RO-wf|J9UjEW{{1=hcj5#5xnueJU
zLd_BrYB~xdhmHw7;ZQucGW;D9M*~;KMesY35IxEgYMk*Uf?=O4L@~aqp~)XnCT#}q
z<`-7_V#07!z8d5h=`SFac|s1IKTYhX0>g!l7j_mp+59RvA5DE#FX@EDrig3SKVFvT
zhWA1)Ghh>rL^Dz^akCMQzf{#01EY~Sj+Rn%x$^r^@+Ec(L2u$GRU4kMEiRWaQ~ij%
zu?E95KX(>eEzHo(cnlOS^)+7gp0Iu0x04>N2%%&Dw$Q%&w%?K)bH*B(jVkmC^gV6)
zeboB=b<H}yBAA#u{PVI(r2B~{LN>DvV~Zo?v5H0abUm0p|8nTO?=s~F;Y5*Ay1QMs
z7X>aAi_sYjS`lf`Bzkv=VvyB^yKqVeN;@+@A$982k;{3lm1-%B17qCSb@N%3&O_yb
zvhQE_%%i1I4KQMfwu;TN)69mHPu046gofNoKy3QsaR%MmtJc9HLU-?|h)e<{UbcZ~
zgF(ZB*Rf$0ZhQ;7Jv;z+&fervuZIS#CyUpLlIHx~0shHuv?nTXUwwH+q#Gs^ig%@x
zaS%bf@DIRE19eTTaEJ}dx37To2*V~}^696l89h}+hK}8P`xYZQqIf9TazeB8P+EbY
zts_@aW4h^8vw9`fOC_aetTYai2wrC{_J(pP$LqsUJ<XYTsXoz4%<*sSle`S>um3b|
z2-#1d(Cr{&zXNZxn#4O19MdUY*!t(>ytv-tmMSC!E$=GbPMUx{?DoS8PhOnzJ$Ah4
z={eiN<uA=dOm@xyDG1|rHWFX~M?Bw9{|v?KO}0aDMy-A)+T!HzII@T_BMxPZ&plJk
zegF4>4~cN&Vr=f!Bi5Rut7T@L;dR+c`|p(AWv&Crlb!~}e=J2shK9TH*B_&-3K80p
z?BiTnAV$C4wCNxCCvl}@cKL4ZI$0SzL24>N6dpzz)thf47{1MfHi?zM%GIpBqum0;
z=!ZPw4T30LTv|r0rJ^U-`9{tXy^sr1bn2bx;TLqop2onPaGa#8HJ-D45CnN8rk|NF
zyIqGEk{&5mqiXrWzng<>`6{9f#|Gc@KST+C*QH%#A~uaTjR%iyMxRc9u;R0w6+MJB
zp#Bs&w>411t;mMuu=pN}ky1yJAut1^e#a}^CjFHNIWl91u7N0XmVna)oT|xmMKuv9
z-?<{pt7GyECjUh0IqoI~?BV_~HGheG@%)8Z7Hf$3CAq?p+KvK&CmhJwse}5FY!;s(
z=d87d&pH=d0Y}?QFkgKS6mwtLXwqJIId_(bW_I#5{(Zt>K<Itmn@u?R<nq2IeHbK1
zHkXR@(|%t+F%BW6x7l45f9DMEg1VDWJ<*~Q!Z{*}{Uw8N@@Pc@qUqkoCf>*P=Ovn9
zsYuC=&380PJ@DCk+io3Cvbxw%O$ajY>)O+jB!tl0tx6h~T})&o@<ywRF|bi9+D8_m
z;mV>%AnpN(0P8dRF>oFFshI{|v2Adx-c#pCl@Cv+IEOaw+QGDrOrjyF(IQHLJ$$P3
zvwfdJr5RXksmX+U17`;18>_21e~ToITxD0D;cF^YnhqGakQ+Oe1|?ruX}ImYKYT4#
zk8mGHx<Y^nY8|N52wLf_-nb?N&`S<0W6VB0Rqp5n<-az&xN(n&Ax>)MkK#FJggetW
zcaZCC=dj{LQ%&apC+Dr4p|ut4<z@T0WSx2t=z$m@D<m7egd$%UsDRlRq`STtRiAu}
z+t*BbdQ0wK*Y~yO*!TVYU9tky6(=&}^7x=v*G9VG^K*xD%Clz(r-0&~hq8!TErlF{
zAsnLBwb7d}hyf<2y1u%nq<mnx4VpWTYnZ_<gC%)vg)(oGezDGa$)wGouZQ7%0m>dY
zL!hrOHd)^@T%}lHrV9iLK_{JTv?@9>=7e$Lotk+Op2ldVUq8Xf(TTEElzAYnIeX9I
zRQM>;Wg=&sdxml@pY1x7_<;CX6rtbBxan->kUcFZ<|#?YukZV>K)BDW+DOzPB5c~@
zHPm=%n7)$enve)v=4Mr-g@Opp$MLLdEjolIxAVesMoo~H(wQMPf^Z;3-S~%Im%?dA
zi}`|OnoncMZ4tw#rxD0r?~TW|9Rw;W{?MVPOYXCSp$8+IN0xR55Y2qUq~=hWsTabn
z{q8w3ZczI>;fh_CJpB~jEz-#VDJ=+LDfTb@>t*!r#}`Gj0<OAx%EpO=v*OJI7toMw
zxvWc`4;F<x&)LbJZzFJ`S^-}+Lef@sCveRcurBEJA=EPj$UPY#un?>CT2tH<7_7fS
z=)A0OKf~Y0LNqn_Fx0c4Q7kjP>7;KYJ95WsFMnBbykf%lBlW(5tT&zbdH;8%!DcN9
zXhp>&A(=GGPUVpqQ(%9vo$Q#nv`MgXL%;B?r?30^!}REf%ZM+Cz3}3q`Jt{dbK>4<
zQSzezi(qC%1hQnNdnJ3EZ)kvMHOxyfk$!9?xpQj2)o3E*lYoA^O<Rw#KDp$nkN1Yd
z29wd;MOej4cQ{k7t8u^Ik=^@NtfEhpOn$H0g=ak*&(VgPl8G7izkjkN<YcLLcMfpk
z@HfxIjyOW{U%^w@?H31fN}iuYvD=SbR$`A;4SbazF)vAbK0m4daU7$GI)NrcO~hxM
zrYu3$h^RuqziY-6FT=Z#rb}FJ_~D?mj^%OM+e&I5vE4dD?bFz0lx6fR$zpnfzvw3o
z=}tN2+!8EDm+Mo)?S&?<hMQ<M6|Sul=rl(2D=SHh)Fjcwp=0*B;a5X7G2!<==PxEn
z>TYXpAD+wg@702`#7f<8dj|9nK(AsruqW?$I@g7Sl-HRC7#1|^rJ$yU3v79F@%=kt
zoJnexKx24Gg{t$R;o9AKV({SmR`HK;ZYbtvap}V)_LjVV%{{kMxNcIUHuXJl;yI$p
zmnX~Rv)bE?#og~OGeX5pc$8ib$3D8JJN}Yeod6aXr8{(V)pMAoTCTTEZcs-q?(DkT
zG7|WzS#mi}J7qM*v6Duw6V<;okbK&}9?|q3p`wbTpD$5+Xvj*LNT=Uf&0y_`GBGXQ
z9@m^CiOjpBha=_~#<a;YL3_#?R<#tsQ^6S8tNPr8vi;MPC1U!=d~h&L0n+{-B7+1=
z%WGTb15-S;b#|qgl0*r$#WCjjYQ%Z7CL3nLYzvBAy!pv1mM@$Gx8L>^j5gg{!o0dv
zGk9&9{M)RO2jxGY8g97Wc~j+uWj5+yboOvPZ#p(HO6Cb;^cxM}?S0;(rVjQw;+$HE
zH3z!XAr21?a@EU$spwTV?)LV~T5zYDN#C>rz~G08?5ivLjx%d%wrbP$rCq@`gJMBc
z1_;@Q6%7bawAQg(GBzouify^HyCzt-rn;Z~`lm`aQx-+^%_t7sbIy{k4F>Fh(hnD_
zq2C@xC))MnzWGL>BhPzDeB)xof99?#&Z)NQ(Z+`!=}BYNfQyI*j*AH8`$&~u&dfH4
zH4RpHP^B3w!J;6+L$7-Y&2~aD6JXvV=krRvk<Saeq8${<W613FMnFIvls`pr#IK8>
z3%hd7<>dgBdWLYOu;R*(XepgR+8vN+a4B4I^+v?4i<N6RNzJRf-WoobMBw!G;Ur^@
zcdE<D&@6KZqS;mKW6zLPzL{&YVaxO*X?H98E<2fku<c!uF>#Jd_4P7{X7`+X5Gx2X
z1a&yIK}4o}JRRPKLDr2o&kwZ+ILgHzTb?4-E2pUcHC9JNMA*I;6s2V~S|A@fr#aD&
zPD23h+UZ&F&NsLQI$RUDyedv%sy^dxh;-X0jdq)Fp1i@INK#F)WMK>oK0z_}H9)ZA
zzR~mjd?e9pJI3cIzMF?|u{+dw@K5l(Ouo`N+{FK9D{ip*f*kj!j61izyQT5RWnzko
zOi(r-PNBaS2C!d;dn5zUW>pGQa~RtttOu18hHQ`Wtf+jD*_yE&(F@fq(>|{R>nt(u
zzYIUI-6;YLI`XJYa}6erEe1oB^_r*p@r8@iAC{a621uQ{7j?0D9$v!Y8XeUCd}|%0
zUT6Fqh*)rvD2qP1bVxg=2CcEsFm4cArq8h(?(d~!hpqRG^?>;R&-k8)<2BKAyCq$C
z>UUNXxHW=H_n#p)A@`ftm!8gzuIJ_K-;&lced5F)m9JK?hQRtm)>Jv_)#Uj2d~Do`
zo|TnPOib0hLa4&c8r<ahw@WfB(8l@ge}xB5=FDX(xSTkGbe5`yy(=)ZJ)3_U5zWmi
zENYSzkg(Zx)Z+&^V>PlD^B<|(q+?pbBz-NzLh<rCNq>esj;@ecBE`!FHC}*TIJ=%e
zY-2%T`Eq1!PdoZ-S#o6fol+wvSP}Gz+r(%d$tSx@F<r_Zy@eX+7j2He8E{2^^c#??
zsz}#c;_}hKU&|^mGqvjGUme}Sw7=6a5xa*g_-7K}av-7kP&{_t`F>u1l>&sc2V@Zn
zr=Jg3=@#<<%r5QpJlpgcjIF+5kNNfaYjL~nFGebE2~e`-t6j(&sr<ahJ1yDs(atyO
zqSOmbL7x&?*-~y}edsVJXLf}Nlt@)$3LJ{xnknWpEsa1&ZuEevN!&#;whmdMXr%xB
zngKd|JYm&)H79UKy&=yhfIG^|!!rX2POca0T1VHJd~UPFirEsa^nLuRCo^zXqmRXf
zAiXy2O%rnj9p?|u8#gwqQ4!(@ww&Q{1ZOe3-x1~19lBo_VT~(Z@S~8wADM6LdKGGm
zR*|%Yf1mQiW{^2cwBX)2MN_v5x~-NdZ_(<bxxov{Vbx2aUe7HBPp=THqj{5E33SEH
zFi74sEkUlQKe9bfH8vNQg-_j57MCDCnCSiNEkakKrrP~?!pHBs>p{1W_>H(3=j32(
zX9}Eaq0xNP1+aJe>&|G65|QBYfMR&$c!36O2A;8`jdn$k9~c1dwCF*&)$fykvrcM$
z<F~mKJGXTP`i$tDX1<-$%~U)WO#)A_(t?PT+8i6UYXB10G0Bn-dpMpkt*oA~)2LLe
zAEjW06JO@eOsi30h5_U6bOcFM!R57Us}(2Ye&zX{GE@s!A@IueuNv16;^S!w^ayNt
z(d_W#aBy%K&lbuCR%Ec4O=b*sauE0O_Yn}AJdw&dncG8}n|%l!B{j*LS+Q&H)>p)8
za=Jf*!~J<#1qzZ=@DP;46A%>jkds$c^=3%L6KHTe+k}uuUC6Z=kt{M9wL9i5)vp~e
z^)(o@S!ILGb7Z}8r@L;ug&_t9gB%z;q{4!tb>X~{nWc9{KWg6jE1&!Y;<dj<qUGf`
zL@g%l%op)!F)5g+Wjj(`W+}w}CaL(;1b68~v|Vf=GIXABmt(&(VdKCh)VxWwg(&1E
zypLb?5<bcXZgqvu_IN&QH}YHlt7+7(%b@KJHq<Q0VmzBS{%yVeP&8qWFilLY(RaP?
zJz1Ro4#ifO{CKRp^NgCe1ob6;N5C=2<7mDY52{ATp6gZjRgQ@r-m4fywETW>yx?87
z5X}|Ut%PiD@V*fLoy2_`vdW-qvNsrcWPH2;SdVJG)tPCES48=DB0rPF1hA#XXQnP<
zoZwn`si=~hkB*&Nen4&GnCL*Jcy~nASvH;oQyp8&KXaW2Jsr7+gVUv%I2a((Te-xI
z3i35o)PkGZbuU>;+kE%Vczr#%O4LuDAj*Vx@@R1R10aOi7wpMiV1SVi?r5Jx?sa5o
z_}qV&(QBkk3;eM|qrO>xuDAAXM>oRm3PG(Wm~ns#d}cH<+oV-jKc|pS3sKG&OQO%$
zQey)ol<m|Mv#Vi#_^lXBG0me9`^%4Mnsu%AJF;?gB-+j7ORKTz``$}s6Wz}MboIIE
z<cCA)He0XM8V5Y4;Mfgb{XT5HtZBQCx)11%YElTFELLxn$5X?)nLP--ULUckqN;Z1
z@X?z?j$h3W=Yjm)b#NtsHC2k9qy9w?om24xAa9$;n!FZ^bI%P3hd-t;LaTL;juX#r
zEsdVq&EZ3yG$bJ)NkFd-!1|WbvNAGG&LqCe_WD}8kuUNBX{<#D1a12Hxo00`@$oGu
ziALxYSQ+`wLs43yZ`Z$)egd|-FDtK3?fvo}5Mn;vglF%t)9UJk{8V?-LY$Km(p<B}
zGa`j`S=&`YaP&uu`@vaX!Gt1B2DoIb5!;6Cl2H)RAr--qzhw;vL^r0*cl;A2xi7Jx
zozR6{Xl=7Mdye<4w8)ST)=FqA&L2^>z&=4>em+*J69N)?_};XgfXvCLEyHo7S^8gc
zdOisY@YQ7TGMenI0`)J*mu;t3OU?Jk`CJC*;$krJN$qM!_Zq-{zrxp6gP{LhjJa_x
zHf0b->+2@am^ER7)8qDtvJytHT?WkO22Vfi*z!O^)%YDva8|Qj93MrCUlOJ6xE3`<
zM}>3YruE%9{eQ>&FS4HVzssW_J$309Eu#+6d!=8S7fUKh4Lmt&iHOF6*w{%I)oFTr
zPYYJ8dj?R>U~^QVh{Xv1o)(S=F#ckL$w@)Tp#{lA$E7jLC;B>=4?8g)cy>tr^oeaN
z(8;Xd2x!AR{mQ=t_>65`Vc`W{K*Q}Fv_g(S86O>rzx?=wrdpu!gA;1ANq&y_Lm`EH
z3pSfXlE-Orus5W&_JL~>g0D3|%mlmfqunrd&&%&W4%Y00x#7A#sNu1zv3HIJTP3~N
z?m{eF2A+^9gt!4~8HRKmEDT2NsnfnMSUJ|K`urf$$za}tcXM*Hef9-+17Ac7Qs?Nz
zC;IpB_U6MaX<H9GA5;D;!ACFd--Gcm1^K9|QehP>>6z-T2ms>G&tXq}O)6yN&_?Z|
z{;&n|(+Sq{z&<`feJ%J+R+b1^9lPK#*@<@ST^~GXj=L``7t}040e^T?tpK?d6Vx2~
zpQl!dy!BhI&-cDhQN7U!ImERtZ=}mqP=G|+Juwnt(50+b%^#l<2UYbWwFx0E)sjYu
zNFlx)`4&H^jc@GQIY~u%%I&YRI*W~^8<gZdHZPgg=vS<FzcOX}`|o6N%#9oK>9h-!
zLrGV60tV#hC=|{o@VZ{NEdMmB;Tj``kFt!{=H8y{-Jr_Rbq~%&M^G$?#(y^j9<SPc
z+v&8GDg;~SmZ@4|)yeXB)cS2W3~{HVgv#U(Ol^c0!*iLbcO7zX5uB@E?Zy7;y1A$v
zHgM<01d1!O+l{C88~&~j5BA2vmJv!vL4qrPU;nxX2Abxw7w+%XLtpx@9tQ!(lr^^n
zZ`}(>bS<T-rCqqkZ7Y|SmFe_=&Gz&EG~GLUn!Vqf(zJ)H?GP^>X8+#{U|;@F5~vO9
zpkvc!=EM8R9Ig&~i?qXZX+Mg9$`#zTbkX(cKh@ZyV2|8dX1RckX<i#g8CKX<m~&$e
z*zn`0#JM$xN8H_+<odDr!}2gRrx$g-AHQ98`Z8FHNM$pDRfv2^rSu0rKKYz+;e1nR
zvciLbwG3o_+kAv!t2=VhB8Q;6+JL<)!)*#`cRwe#mX`&?$iPU(h(O=JxiJskLyPs7
z+ppFu%CjFgpncFADlSl6I$!_H>Y`3d^+~V4U*>26*19d#i`<0i()A2YAO_2c1S`uM
zJyoJ9nzbYdGC&h-w9r1dS_hm(-@2H1^RGm1RqRC``I>>!I&aV%w{&KrfJ~LO{#FpP
z?3=rUd}}?6O}yLGn;U!Am9@EJzZCf#`_=hNSJOej2>R{4d<Ow3wyF0F>b$u4e&uuT
zZLc=qT)qO`V%ATVP8^vDfq^bQ?@XUh8?%F`F8Cn-pL0r1k%*S)6GT<~rP_r%N7$%)
zPF4uPa=pt0*ILMcPZF>jeeJpEiLw%iA!T|qpYus?=9)3Ex0Ni5KTn5ha)GI7R+e_H
z^>D?1zH+T6i#E_xcY~`U*guR;$0mnpB+$SHUU7lGzBx*iT!lhQh?V3<m|AGjCNGrz
z(SS8xOcl6k=x?jU@XI?j`!DX6{NHr$<y$&(FE)g9l@V%3>NEZMh}hbS-A=<8X+94O
zK&Oz316dM1x#SL;5tJ`m(arp}IzLA<F5t(=kf-03vHj28rCK&WT!_W5x6gj(@Sn>B
zI2b#LQ2<z(NXEu}oO2~yY&z9fshyrkZ@+pxDrD&n8T!5?p0~RmbI>igsO(HVxMzji
z+-f%O_xBX><Xmzj^Yrys_pDsWZDcDHI7-C!xcUHvv0i3aG0Q)}kM+OD*_REaF0)&Q
z_7pb=#f}PE&bBrr)-PYG9M_V9?H{q%E;O?BV^;w_;MG+y{>-Eal{sZ>``GYR;9DdP
z9|q9jx>+=S!JQ81_od1@OcItQrRkPZ|G9YT8X+obqKA@W%W<J<<{QGR(JXH+)~4Ar
zR_D3CEr#;b{I-OKs@Wa?)B#mvK>v}R*}wrfX0Xzgf0z{z&X9Lk!|rd@q|uJxygr67
z0^8sXCH4Qlks+fq!5HrB1Oti%TlwBMT|Sq*fklRW-&+<~q1P|36?&06U|aW10hlfQ
z4g$grENQPk;%mTvA~Tg$2*5O%hrcZ+EC^p5TnB;HRH#FK_2RWgWwntP>P<77*HvDx
z5eioQzjt}Q*BZZ3wiNwNl{btb`nFnld=*H;c_;z#EU#ye1I3DToLFhMl_60}3&-1R
zIP`~*G85CQ*(Cc}#;UjLGh5_TWsly@<o@x9`lU+fJ~Vg`Vij6rOG5gClN0^cz5sL{
z{oldCw7|0D-obQ6zD$~Waozzl-%OEJVPQ)qqQ0aAt425_*r;@ys4cE_K_n4<hfdHj
zjIlKT8H778x6T}*BF0vR9e+zw&g})4l6T|YmE`Z<GE7@#hFJgHz0mrf$t5?^=sXZi
z!gtFew&CKWe;TxiO;bf@x+2}<=dm(kqTB52ui@1d5!;5|!}P7&ZdLVP*IP_4FeyOD
z_to@NeRn@dr5*vGLIZ4~<zkBRKFb?nE}Wc{+&D9^0y^zu6lv%~vja`QX_Ct4QSSb{
zzDQ@@3ZG0L54Y~N=Ql3oKRe}^A@W^qQ$ZJOx1`W?Wefc8Z_=ak%XqNv+&6~=*Th9F
zq(0V7*Y$w^$y4S1CwG=h1|WSh@Pavk52xns7%b`<^X`&aX65xu63a=3aKn$Me=L|!
zXAKZN{L#=L-HHCY1B(Xw)$tN_3CxNPjY3T#7MEz-Me=d2Dap_5;ueWEWPY2AVi4jA
zHzk3obBNv<@;dVgv|}_?jDuq%SD~#savH#;nDMH3eMIc22WRdphcuxZ`B>}aHtdPu
z(Jqad9~z8_GCvEN3$!OOMBs6bhkWAu@+0Mi5BO>C3?EHzXBN8Xh)h~Oo;a5PkBvhX
zUQ2d>ObWo~SDXeNs<=Kf7lO|7`8kuy3Mk63uu5f^`5om>Pr|K+Vwzne|7(}fT|47c
z%ADexqAnJiVex=F#+(iOPZ|ICm*|4#n*uWcN65vi7~-|X<!%R2Z7n!;U=1DDM<hjY
z)zd!-6D9{vB<2yBDU#1yT>Nr#(`UEJ{$J2EGpmSw=aJ4#S)BamH7%<TrMqdgCSXM#
zC#*PTMa8hwMjlQ2Mzq9$lRB&nEO7rXUa~+|LH^gZV#nlb75_%a3#)5#bX#3G181DD
zN&{uCh8-5~i*1r`4lE_jlUuL$4$^?3u9HufH%l_zJurK8agAolNK-X2Rd)DCVY}hH
zG=5A}N)E9=$Pfv1C0lAgv_?uYg(kk);qD|G;LD|%S;HIjOxfz5IW$~b_0@v}WIZi-
zVbx&&i)QNC1``dga|AO#VQdv_-BAeqhWsEQ%*)G5J6%!LY#C1jpc?4DlF{B>i5;E=
zs<<}`vl$ouA5-rbm}e7p3&%DaqiNDKb{acrY}>YNG;Y+`wr$(CZTq|Wob$fl`E~!i
z=bG8GXJf6kMTRddTAwLDD1hG6;?E0!L*o7T9AU$v?bGt!Lw7a08*IV78jYFJIA=S4
z0W?n?wFSMnRyu=@Ov77>LL(sQ{+_SnuwUW?9BdY_$2tjITA0%2sz=qd-;Zv~Olc&U
zQLP|A6Yb7ATmBNRPl+Vu=syn=+By2L`u-n7P8pg6?)yMPF9u>dScA)ZW}iSQtU<ie
zvN2qEG>a559NQ?MvJ!^nyPdJ~0ix699n0!%g+S<XK1CQ-TiflZH@#5q4ypTEuz~O!
zNq;iG#VMGR&banepH*-La?^ckorv5MQ71YuWiw!h`N{sf<n!?XOdAp?!4k7OI@Ltk
zR%-ZW)=UvVa@U)V74}4V1qJVcqG#8q=N5F|+1&}~8-@j{a>8tA`$~JLsRW}NbM0pm
ztD?W^FPivFl9}RiDVR!o%Tm9do@ABybB9~!VIsnWTh9g!WyXqKxroZUzOv1tJ9C7*
zUY*hRetO>zyYC_@sue`$S?q395_O<QPLi_@0O17<Pa{;a(7@P3;v&&WJ~i@08B6;F
zt~<+_>I_g!bQGt<P0=2IKM{E*SV9D%pz&*$`$Iog<bVD4vW?R0uf7kgehncY)b+6-
zimCLwEWhJ|z^a%vOjA(&R6$*tPrn<e<77yGwX^SO*Wnd+xm@sQ+iN6%pi|9aQ~JEy
zQa+2EoQ7p>e;ajc5qg@FQVV|ch3*KbkF%NQOf>FJ@z~z@<j2mw+Elt2d9%JvUNR=t
zNqhAl4@;FZj|V)%lD8A*YNfTPf1uc<nEGo2`3%(`0MvKo{4k(J;`tq*;{8tO$56tG
z)lQVQmt%y5gcT_)d}@ATsF-Ib7nWhPtdDmV2z}Y_$8%*c5*Xhlh{kI}>N=P`ZfjY-
zGi?AMyPgc?oIu%Q;xmUv<NJnn#&Y%CXgIkIEi3SP0O26n4>YUa+2g@z7e>29GuL!{
zMyWS=?GW`L2k+;NorE2{=9`_v`nE!!xJV%&Z_xBWFMXlEvi1ku5vc=7*L=-#TB5!W
zsA>LU2B9S;D0NLis;b_0<L=sM4y0~iVN>1gwd8E^&rF6#JPhBH98x%M&2Yd0a}2fw
zzFz50!lXy_0g~kzZ`)*><0nCF4X$P^5aizArzZY41A8$i@=r!l^tnz?oLjVQgM!=w
zZs$>pt~H}^mQpJt2YKUUSa9{;>UEklEhF=!;K8G$cCpR>5F&zKLl^;5lx76K9Q;Gw
zz4bijlEosczjc6Ypq!Eh*~-Hj35hqMfAT7vRmikCaR&S}(fyh?J2s?Y)ER>8d;$ZK
z)>-)b7>$fk4~hsGR@8vfwFHwEZh$!GB&*z0t<<ny%Y$h7ZqL&m%4FtjIfCw27@p?A
z`8!o$x62(rck2W6-yu=D|55T_c6`C+Q!w0Q5R^ArW%czv|3{F(1e3iWlkBEXY8%Z-
zYPd4<s~xLjA1WSVpo|9!1N7!_Uhm;_Q;J8QH#NGh%p}?^pHZR}d$%tO@GTT|I7qXN
zexlsdcHZ2c_~4?-z9-6}b)BWWvz(G9vqw^vM6KzN+}O4NG6&X~NvG~#gAZ*f=pXsc
z^UD6ieTyz}qdtCnJmeJHXaBj%1J!d5Q`*}~^{t)|DVm6Z@`LB;YlevrkAeMMYGG|!
zrSTnckB%mpnwFx_i9vKW<+PL;Ua!HGuIEMPW|@O|?bVP#yP2ay@~T_Kc`aVGMV4kG
z{F*Vd|NW?oC@${{TZx0hw1O$VYV=pICuBY2*W|L+x+r_4=Hq^MQv}eWc~eQc8nD+q
zU#nRNc}>0i7{`ae-(a^B4Dsr7jqPK}*4^vu@peOdE8xe_rWfmLTXtaregIbk$Rz4F
zc27<hDW5((-b^MJejWh4uXfn<za0ln(kpMRUl(m-M_t{7+MBzw8Lp0Wu0}PR>@7s-
z6NCW;hwdK*lW{1ww&{-UO(yILE7E%68r>-cz+j`fKZ-NrGr&N)th|;$aiwqaVHn9m
z!L2<6yehl^PA~NCH(B3$m5DBa{m#}<q3y$=221#h?KP@=2ZKVSwMzNS)mw0_C5Mqa
zT2O0Tgc7n#p_hW4^7oVzbNNhH{}ZxzWuD-e=a-qi$i;DvLe@^L_efra&$_2KK;5=M
z&zy6&GIKfJuy^CzKO0*wU@N+p0BFuMCX4_=Fxb}hlZ6^UZXtIM_J=^P@)R*CYEwt*
zfmvB9m(f&-!Y%zW#<Kt`CG`dQpdlF_n;6o(M&<M6k$Me9^Tk7FO?ivCPyL{W<oyV3
zQ12wtyC}@ucAMm84?0#yy|=*}^7qJbbMQ!;sHQ{G1h912msT2$sSBmBlIswnDsWPm
z^-}TSv$}&|B<CyM2##JbJ?=2)A@%>f)#`F85@_(@>F<K?h_sgew|J7NP!gE__k+HN
zfnqVJ6$c3nHtS|`3Or!k>1s^v&;$bgVZ7za5(5sCK&GNR_kv3X2MI`7m{tj{U_d57
zQvWn>@A@O2*S2x!w3jF}8d-gdSyW?CGB-~2GEuwv;lAYfV?9qLuRRRuI#1!R*()V<
zLvJkD2Q)+b`(0|#$pPBIbQPhm?k7yv-0%Y`pGG8kjeCw*RmEo7uQ4%D@H?v&mARI_
z9wF(&G}ac8={(quI7AuUsl=qX=b2Gc#HDa9dlUEo2Y!|F&XKfBeagxTY^4OTtVev;
zA6PAtelNS{CBK8_PLo`EU#$Y6B5v^@ZjCG`Cqte#bqC?E)Ob}_KtEiUo1OriTd%9@
z&iA$2zPu+5k2BmyuR5Lh|1fa_&0a#`yuSY^kcJ`8gf1iiSbZTkWchHuYHtY*u4F92
z`czLo^;ZMxW&JN65R=7a=gAiYcN|STX&9yAIY8DZzq`T&M)X#+7ho%V1OVq?EWS#K
zg(ztgfkFS{bp>(hE9BXsb!t)0yfQpL7EITO012FHFYz)4jh6=69u}GT-YP&7Dv*%H
z&b4?u<PzC_xi=lT^H@zF;uhatsfP;MY2D?JD^{$1Ppd#2zQnG<d0f`xNk<dB^>x?r
z=MvodkjZ}BwY?GqT1d?I+MhF)?C<SY-~t%rP2f)=aN7RbdIBr!%Ys$ga#TUq21=Om
z`)~w<-<JJ{CYryWQD9NXgeH@RDxqfBEcYk0-Hf_@G=0Co)%xoBPtC$}-1YLn`!2RS
zzMbLiaH6{8!UkY<y*bafNgH@Uv_jrGj?DrY4|F|T1GmL0_bK`es(!)hBkujv37|!F
zc~n$Vfy}Eg>rokq=6)%~@!K)~_Y6NO-ck7PoSdT&m?ga5Ffj5MprCRwwC%qtVT<!(
zHYjF0c!Pz+1;}SF$eJhBYss0`JRYE=58e*aw2%f+GWEQ17#wU};+e|o&)G=KIdVYC
zj3X?#qF9m^VoEDCuj=|&zvB4a8-URGK%5y+f`0EqBJQg1jKJ~*;qG;>xe)K?B;?e0
zzEXc(BwWH2y4Vkzj2~WmIlHy5{Pk=L8WoAVJ$K{HK$-OG+0&7V?2pf~^TP+LW6~e{
zqt9hf?bAiy>-4V|bXE9E7{Ol1?VJ9)yj{z{GbO#Iz|XO^Wa6p{9)>~MB2bGu<qE^D
z{PtQnW2)x91*LP@EZq@1=!D)XboG*pXcvQrty;NwEarX5U9+I<oiy6+<MXD?tmT+4
z!#T+rvcd2SOf_29YZxvh*|*=bXmaxT;xFuWmkW*c*uaeQ-0#_3_$JNPpsya?;`&zs
zPpOZr@9UO%a7X~O3~NVcr@8Ra-2$e8k^cS{zG4<<5G|UoAU6BOvKD|S6q^!=_Is&(
zQnaP6Cg>)q73$~&P3aX!CZ&R{=~~em?_#N9AMYpFNvaWiEgI^R&})s$2;98-fpzoH
z-^*zGpUr914wJS=ue4)rAiJ!1U>Dq$Q&#-PaIw*RosdwgyNzF*KO#_kRwutrAMScl
zzn%V;+nHPy9!B0>y_v`&9|-T<(MQwq?kBrGoGZcPCz_yZEe%7>+bg`<xxkh)qgvEy
zqIM6u&v9|JsU2(%PfG=uO-6%lN#xOj<r53_cF39UUJ06h@VwA1oQ%a1&%X>w7X;Tp
z%Yy&e!F-akN=cxATeZqU-wLPiJ^@QgKz@{OI15Kb!5(gUq#KcRMzF!~%}ZaR=$f7&
zYZ+<|cvgps*9t`4wxM``7)U8?xxQoXH1b$*!gq{7YSpetz1~qNnCXIi)Xy_VQg3Z7
z<5&7*#h$mp)M>J%beBd=zVddT3&JRAldi*0`ZlNUm0X%cpN!(e#0diFgu&2XURp#h
zgYtYxj;YsL-gM-SM@VCF(VW0iaHH;fIC0UW3<oalP3t%s(%Ogrcui|cvwpZVJ7^K{
z;LQK=t@)VP&l;Vi*ao<vypBsp9^$r^Gl5f;odPAy=PtQo3VjkD+B?eIG;tT5aVU!@
z8>crJ%e!lXnYEYFWHroiCa$g-_XBhRMH+68^Gg{1NiRab^K~EuFns4x*z)lV@S^um
zeL7iR2nptGpk>q5?atJVuAP-hV-;I4&6Cq)##psL{I|twYrtd+88C#cImV7OMA-1H
z;z1P6lsxTT;CYT-y1^?QLL>TY1`y<VUy9zUD>O;0Pi6zX8X=NPEs__x=Bu&p!Pi{v
z#?AgXTwD%i%^$0|kY;R7t{J+f%96X3OZBy1`?>7knYqRzWd)zP3PRa9`;$~uHg(Aw
zs%z;Ujgh#}$Dhiw<LM)=`*(3eaP>;k?#3$Q9W=(ldircZg{ch;8b3FEcPrNs6sbcj
zpOe<K)5M2mGR|sIecqKSY_NiPeOR^sjE>kY53sQ#X^%*WO1Kxk=riHwt@UIdz1Om}
zi~DC_v`k&S4GgxopG}&2<6;&HgOkFNA1EktAj%2@thl2k;iW^AtQAW&D56~p8=!M}
zDV@2tboR*@$P|!jkj4X7poeI+I7aR@WOL_;DpZ;I!}Fa#zJYjzJPvFQXU_HfhP+=m
zDhG`8!tdR$TNbNeYl-3J;ezHdrAMJKG?hN~Du46qEj1@qjhB^;bK6?vW23g=dst1s
zZMOQTjHtev7jxo9B-oc(p0p5BugeQkc`U}DY=_^m>k4E1rL(o4D>STWlDdce7>c;N
zK5T$WjEpnPVL}Ju4+7DI+e00)@#Fy7%9~aVTCG;JmwjxbhHIuon@P{nOa}6?ZARD1
zTMx{MR`FcgKwe`t=P{3Km=IblY1LxiUb*8puVS<?ab^95Uc{JRGz#hxc{ia9zVjF=
z`Bb~O(M&JyBvHQQ?chb#JxIi=7hj${bCT0#agnw<X2=I@_hn>pI=86u;Bq;~kM1}Q
z2$DmTAGba=!W6}a2E*+v*Pi?qG1GZv&YoaRXGShtwl0dca<^$z8H%~Hwf8Suj_;~&
z_2JNyhzj37&-Et?9PlHhMGd5>3vl*|nctj9lG)fYa(CafB;T&tH73cG#NV7MPJ0s%
zTW>aE3KGzKT6XmRY^I9tMBtEz@ivAKk)NGbj-mPZ2z|;GEBuCLs2&!2nZGcJt-jD-
zrHYYjCS6K6*mh&3c_~{wecp-=XRTEsr0L~yQ?z^~|GtBy%W_aWAX9xZ^P@%)a}l=o
z9w|$^vT^L^3HVf=>LFf5W-0h|<5)CZTYP+gNNK4nMF|&|0C5xM8kbV@tKxESM=e1i
zj@PI{WTyUlf>R!b;+u{8!2(VP=PSWvgXe?a;;-~{*!KrKeUWGphue>`4SAPJ&Fz7z
z?LhAbv*hLOZ;q9hgB2<*x3k--9V-s$W6)<a#(UVcCt~=eQGMGd#D#$Ua4g<u8xRnY
zf@?-frxhWXx&4^<X6!&qlIl}YXvaZYJN6`OaJ1YNedsZtD^-4@ah4zoT$(T@oq{8O
zv%v~N!4R~&?pHCxf=@iFu$3MS=uLs>=S<Lae~xQ;3;4$uNcQVpA0xjq;Xc8szPp;A
z1y`%ZLbsis>b{FFEEp?6xY6H1N*QS3um{+1CQS-?O0U!<JW*8Os4hSJNUF4wGIfke
z{eChdUT+;mBGeAbnK^1ojOWV9KIbd^$eYd@f#>th-Q;^MjHLa!P3EF6l8Q6NL%&*d
znv|v`P`D+Hxd5g3^orhL2+JT7DV(I`?E)z!4p(h3xXt_O)HWDF`N#p?96^aZuV>gw
zpLiCozrVc%SBrnEi0iB)ZS-i=8&$3OBfBD#D$;)~6v6gu*Lp0Uizpa3{*{AMA3sSy
zKW#hJgmn45T-J<y)<R5%ill%sNtjyD+Sm^=R_@H(u%AW)l*&-W5QJuELk`@hN+nqi
zurE9MGf6aG&sV=4g-c!ullOk^CqGGMXg+&f>h9J@j&XA>lIm~>Y6+?>d66&{2SIx5
zP%eF>0ImnS82`n~R15D>HgBQEG~}9wq+Iy%#oMvu^lKd+3nAcv90r*2dq?1@sLIN0
zPQU7gX+{C{9j|OB_?Qv}1-l}vWi;^e9vYSWPfh)XXE58v)`U(vCa8)x&`2m;uTkF>
za8(C4L=&6z@+<Xn?a@<c?ZZX>&YcoZTYq0cL$Z413S#RKjJn1V-jn&#`Mfr^=pLWX
zZ?+Toh8O#vt<9W2{@#lT7CaUW1}nf)^L`O@OtEWiz)jDfqHNau<z{<OE>A8@nUphQ
zDzyQSE^KW~MCxFTR8wXBxurONi~&v5y~hJNd@J=q=;TZ~l5p(ZnU3~fk4aS*Hyk|d
zFMh%uwj9IhPi0A%e|X>+b>Cg9_<p58&z#Z-k|rTO1BlIE%LiVl4A@~1+UF+Qs#2(N
zC<Y*<KPTW!$eGh+x19tGL8<)9H@*6B!-&g!h}LpS8PlRlpIkruo<#gB!-xt*e_;E3
zixqP%U$+p8h~ShQlh{iay!>*%-&4&GPO4lkfGTe%bCR~%h{B=^^3z9Ib9Snqf1*hm
z^~^n=bCjaNz;skslYsiRy-~IFt4x0N?<WU`_*>Uflm*H2p$;`}*KC)(Upq2!i6T3n
z#;9z1Im0`X#a4LcHcPq<PZ~~kn3qIeo1{B3BuZ6Ps{$t;I68A{-yJ!gtbQ13G;@jX
z^-lG}4K5%Pvowa<JgWW7n1+FBgki0G@eA!ofz(CRbqttx<>X;k77L};U4`KrrSK1Q
z<v`uCP9~k@q$AH|X~YoB<u6#r_CT@bX$rY)XMVJp$Z8o_T}5pT5T?MwaVoD-rZIni
zV;XUHqH0t2po;9nVG8y6aGRsV{3MbfLvv@oI-H#@XJ;rx-sG82@f#1Yb*ak~jB)>{
z;94(7vM6xgo73=mc2$(%n7?NzZmJ<?ikpk(B{_-p-m_dcuaVh6r;xXJw#WGRAdd#U
z+I=Qcvt45hipP|P3~!|?@KALLk8r_$<z<ZjRYQJ3a<zoktNa)7+3-*)mvcxJK3{U=
zlMu`0^9=I!`3}7r_ut8~CJ*hzg^#w2{GV?=CG)RCxZSISKZs6GR2hpsa%`EqW$}tx
z*xlMHe0*$V3HE~D3S&uVF>-!gPLt-A^0aP~TdZtrLh~{40lbjTcKvS<A5!JYgM-uB
z;nmv0p3~cp4dFQ;Ipn>^;87swy;5z05Dkj(mI^ppWQIwXp6t)VM-t6<Amd0!uTC~h
zT`ib|iD#rl3|KQoJ^6Jji_EcbO)|E+d}hazoNP#~A#!k%IgN?&mn({kKBlX2bD&&B
zruJ?6q|Vd+23=XR%u{EZ@%_(;+L{*wcklRZsbs~w)w?y3{7(cOsEGub4TcZ{HbzyK
zwWduK3&sM$CgFqTP@{jxucz26N8MSKc9(O<_^BB~!1p!kb*x`KUspZILrn-EigKqK
zW`Nw4Kt_i2JnK;TTqf{ttw@KSS=`Z7h^t^ZYYZ)&8_1nTpi6|yP!CKFM}IiIsJNDo
z^#%ZuB&pZ2ytUVhS`e(@3qaiNe2p5bx42GbhP|{ih~>a*91_b%O9^(JV(tqlUPrk9
z_)`Pl{3mU6K3=ne><~3muB)62v-qcQ!Uq4flN0gUY8btZNl$w^?5%x)cNQMtU#U~f
z%A}>fIqZuw`e+*@UJ3r_w;22KW<17sV6J_mXe>uw`!Km<IwMy*K-pcgLq~<=oeH+_
zfq%v_IE6V7Y=~WyT>Zcdw&*z^Ou754eIMu~utzHdsw!yvhm)cBm<%gJRrMfKW${bb
z&R^Bih}9os_F=?688Z4CG2{hF0ic3hv6Nsa2+L9RtpRIKFTqltsr0quk~|#R-fYpF
z)43)S-9MXtXdPp%l=qx|Lxb&5DBM}A`4&dk>3^WyU!B&Hh7aryB@UI!&QE&??Of4Z
z80t<MEjI`^cGSIXp=hY^Tgtfq!2&!Id0=5!G$oYgWT}RWl!}(mW>23?n>w+7&uilN
zZtE1kd!p;AT02y(UHJ903zQMi5p8RK<ulNhQ3-)Ugh_cMlpaq_JzveglNeiK3P^o6
zdUULywl7W-UdNuMYD*FxXoXjzE%ShbBTD;j!WxT=$Kk#7cab%1zo09O2t<LfB%rc%
z|Ft&!Z`2oX)qpR{x?~;FMwiS=i(j|=eLm|)Hp|_LDD2^BE|LLGwMarclLa&XIAS`#
zB*|AeBw&ca>HsUDMD!G)h)(4~v76bWgk{)@{vG$k`HGy!tjHQP0{si2l?c@FChfNS
zB@bEK73s5R)E6(CppWnSb2oO`axt9a0^Ftq7e+-Ss*_2q^=)P-M<Stx=!DX6rD42I
z@@S16Z@*8yUQj;Am~TEdj1r&X*g19{Z${@fu1babHWQ0zB35}OYIZ7DN!>$I**l4Z
z?0CuuL4TQ0^FE}*U_3tFPP2cs#aJq&8f_mQbj_}pZOVz}*@uEvL2Z9`F|?npv2evq
zUAfypz#v(`_H8+{R8*-{^VFoskAU*C#=^5%RfDHaJTSz(&@nu6(fGA-`NBg|F+j9$
zafiF{b|~e|^_e^UIOOFCqt+H$l`kO|7=m}1rYvzWk=`fucj!KZh{S1{6mC*kvuA)%
z4j@vjxNM>`y}(vHUI?xv>F`v!HpmU_yGDKCU*~Pue!Wv9v%f_OWadD;jh;A+^x4P~
zvq&bO0OXf?tl^KfM&Wj3v>+@*1lRONqrE7=`rox=#*H?Vw>iB*JekXW(qfHtU{~V<
zbq>7<Q+hC;!q?~qw3{EDPpRQ+lgME?_U#f<*;{+CfZ-QM?ZYL1IFUfsH`5HCII=lH
zF+e(jzTF$=+uYh-ZMAl6Ztt4Dbp{b~6J@^r4I0E&Hg{R5x4=HJd?v^=$?y}Oz;n{X
zKbG(zHs1SQaepE_^7gz(^z-*by#Ej@pNgW;$FxD7XOr(~G?xI-Twi;6GJyMhUz9EB
z!#8B)3P#AjAX)`1I78TZXV-q`@7toGcgI`pvO&Vu_EtBWS7)|NIS&?IErwL}_R`~k
zH}JW1+?#c7YnkG?`_Gv&3Po6~r`TJ=NZWUorrKD|p-%sNUoZbb*Pij?CD_2eYV(B>
zj#!@j9{<86q?&6F0L`$K7(LfD#xD73I}XMIKOV-=(gaIuS#oE!eX&h_+zP=ayzeZe
zqOCbx_Fg-rg14zGbF$_8IfgU0-hdfRBG?t^Y?zYz%dkxK*IFQ~rqyD`-)Whc7E{z_
zkB2NTJ~lK9`Lr0mhs1KSNsmmtUQye8EsvdnXbOX8`?+eYm-Tot0A={yso_of${$%y
z*_f>!zm9{3H{&x_uM>G!u>_XDY$Q9wgnQvmM{tms3WlN_$~zrq(M8?+%%gY_yJe!T
zBi-Zg=b#ZS1#eSKGfmO%X-^s`^2H+!DLz^|O1I8@U|JeJ7Z=yi#KgdQ=neXVKy}04
zkIwtf(n^c3mm+0EbsGmAebRr${2&eLMg%S{W%fS2lyO=gciM&2vgqjflH7U9GV~Ap
z3m1Elkp+7gW-nZ9Lkb`LW%}!%F7_2iC^MFyCG(>{d)9l@=DbiNJ#m#*3Qh(PXF5KD
z)2vp<HgQ@b*EWfa);ZYciZx!!U|>ZK_N|nS%UIcxcAD7d?CdZG2jubb{$&sSY}Q%h
z^quv(ZenR^wnS4zm({zrmb%S7!zxUbHxJ#7%`w*MGTS#ts0#teL@y}VK}H(vV2$wH
zGJdysz~yd#V)F}I?HaZZ+Ktp(%*P<FteQyL7$Hs)U%Ik1QCFqcoA{$Rf4}-C6l@Bi
z<OV|B#f<=nt2*!M!+V0h8kAA>jqDuY+5CB5wNY+Va5+SZ*VDrydJNZERBgL0=^uEt
zayL;=T{R=y2cteVR@dV5^(~;^w~<xsxb6E0d~d6J{l@$<vaBqg(6;tqlwo;im~RDE
zl#?U&dBJJl@EO*z<bGX-1`Tbvu`$%%7USlIBk;wLkxU*|EH8Lt1Z`^nAbWh6KPf$u
zl>*wzx?)+aB|%uNkrv>nY%@59%H5+z3YRO@?wz4|vwwo)Djcf*l(b?^z*cY9mA^iP
zn?BW>b!0baHaM}rE<ud@0BZy}U2O@NOCx>pa`uhzTpe`W93A7icPp03o3f6VP}1(C
z3HlB)p7le9xL$eOHxgWI<dZJOb8?7#-xyXSTtmlO7;s1G>(Wzi&#pYIb33~OCKyvz
z+l18j8gr%DyrblGOg>oz4qLMOOdb+u&lm{rBY7Gw0~dSu@0AK=rEjEjoNa8E&fbfA
z9~CKMk~M5r<QD53zYX*yadX9UWw#az*|c*ryYd6v%2!8r#>$z-xS5kq)fQ<uDssnS
z-Lwv-E1h}6qdc%ROnSnM7VtVD8g>8P6=w4kB2FLQMQAz42P}@4eb)sA!kC-Wx(Q{P
z07F_OxAz7NeFR-ZVG;%U{N?!84W@?LfNys6Ip;~=s+38^{x&jMQ7_@SKJF_{P^c3l
zl@D58(HjijZYtTHP{diEYn0M$a=#H=jEwjcUHo3{pBfij#<fy^Wo%Bu=0T^BeVjZG
zq|=G=_!Nz0=SX2zR^rc5+*!$m<|k_VcX<N6Z^HWfbtIh;D$l%vs(m8ro1WkuVGa9p
zsmdrm9MzW|ep~fr)*?r&8aiA<R~h=$X@&Bd<VVPeG}KvKQ|R+y__F*RBqjQ~wBIQd
zyo7&>A?1w%yq<u_j`FtMX@4JrmC<q(xz0sH7g(vIpJ*i2j3%wmnE##w`T7cZ79#Kc
zXR-V@eQ_}=NrMN!Wyu!{G&!{bwn~@dCBK+x-hz*9!9ee4NFYHcy{(&c%^M+gvg-zl
z#{xXhe}@D^fKnG8R|uluh0(HWZTuU?0b$ChK`N1f=o!+T>O)tNO?gKdQB%eMkFq$1
z>^`n|JHC#2`t@aBH$lb<h<C%KlLt9Zc(jXlb@O`7U#2Vu)DGp)O^j;x9n>lu#Sof3
zL=`sr$1BY)6rWrDQ*5gX!MiPzq6&4|s0uF9&!4_)i#MWcYLNYPpSsxn2Z?sgkwRcT
z<3}RzAn<cInm|Ho$@K2sNc^{npv@xH(L-Gick<jlD*U)${%f4XeuNcsq8UxWb{TzV
zNRf7F{#M_w8|O>X&nG)Yl?vr0^9jO#5;1@<)<0pwwFX3Kt5s4Z+|B0v8beH@>bo`h
z1#Pu(@zR>7Cv7C{w&`oc7hzREJqQRW2_cJFi-IUzm_s{5D;64^kb!~-;pYpA9gcAw
zNF9n7?sKhU8>E1$C7+XO=eRJ2udyrvd5lP*-qwI0*}=CNx*R})DQW%3L<-sG=4Wj4
zOx^Cl2+Ga1{@Sa`TKED+K?PU$M0nycA_9GrFnuPkp1xEk=diSIB?q5f#<78GaBm-P
zcW+(#1eg<O<%Lgz7i@uv{wwF}tz&JW8}$uCJmV-VkrqE_kjbRH?FmLu;b;EU7>?u5
zpICUCWMpW2{C?~#R>2Ob3+(mQ0S39j#@Obp!D~C3-W_*Lqjc01GFAg=ZXjMguk?kx
z_?~IhDx$YMJJH=M3^6u-Gvb&eN?k|uvY)7cLkZzZ2%ZL}t9s^iIbdBmDcu}KSSuB*
zYy9tbYmrY4Sm3$6PObVU_z$nQhXfwamRk?jtI+jyu+mg#lYX!#_1(=UmIjc=i9fyW
zU(7Z1$&EZCUY(NN4qO$REWtXmlxLM{SDN$(VS0MMILvX>4_iNRzA^!^day83ublPs
z5>LB!G&yD1&fhPJ3=9}aJo*6nMBTbkmX!bGB8rg=!YG~NyM^eMY%A-?O1+$j5V2E<
zCse~vAtT}HgB#oiA**aYgY<MVWN73K(@&`PQ`JKWRZ0^dzwt>wOlR6lLDHbX&Jg3?
za+_1a-z*$}(xfrAoezk_V12%f!KyKLs-Tlv=Q#hrW7hibn6C=D0TZ$_9V1CyT|C&g
zs}~eKCF&pE7rIzCNHEyakBrI)fB5rP$+Vi`l^IU=_^BZg=d6-#yDE8k;X_KdN4ZvA
zT}!fa$l_J!D>=mgwTdUc*WW2au&;O#bwkrt3`h6wz+sx!)=nE6y+5WUL~1KJic+7R
zn}qcd-)W}By19`&-U&IkdPa=RqKCl>m(heN7aG~TX)kDM_fGHSD%a05l~LHZxUaS-
zLEX78-TG8*jx8;Y&|jgOS{x)%p-&y(wN*VZuTG>aBTWf#P4h%NN2hLzt|TfZ-LK*c
zfto_in}Jz%bR_?TKCH5t<7p$XTCGLf8Yq&(NU!$JRQ?2%pG;<iN+a4|OsQ?GxooBx
zI&o)HK*wpOXoL%c5(J44eBE{-8iTJp0|Jh(!yr$<u<&)dY!=5VKacje`nOsF+}b{N
z=dMvw$MFP}<*+)nUlVjH-g?G8;qS7%K|Z8E#w<DG{G6cF=aEiGm+q)FtGuPA<zFTO
zXd9xFp<GRF-IVbgyk@l3gr3-M2PKfV%gWT-y-R0btbWY1!n2c-f`tj$FYewi>U5r_
zG&Qk9A>sxCEcK3#jy8Y_grQL#TE@*(HNj`zyoi?f4c}J+di8E(Y{Rr2Qr~cuUZ9=Y
z!|`$A5_^c2{(YzpqZmPi8v0T8cA(h}P8l%-Y?f1nohr?(@wS!vqGKsfp26i$@rYr6
zKPJL5bD-VoVD<3}IUGykYEU`t9@b&aH*<KpGjG3*&bxzJg-kW2x8@(3ZrStjmR_Ev
z_x(E3Xw*cyoYxczJq8jG=sr4UEyip+GUN$Y*F}j+(r;m3iW)e5QBhGPfl-*n3WbRs
zhbJe$OG~Lh03Fsu8jYR9!@-^Y@Lw`ACT~yITpv%np4UNkkdCFRY@sxA8dJF@w(H%j
zjp;s5^mgc04)JK!-UQO)<qn$F7q0k~R`lhL;%*V9=p#L-G}KJ0JHJ#Pik`3KHk`JH
zbtKJkTqw+f%sib>m{@f-EvwPKR=}wM<?q2PjsVl`MX+SWrCjCgA<79onKeRZAQ%AN
zPvd@V+;GhwCWh~^k`@ezbfS25e4LM^*#kOqiT75Z?CxDfO0un~R%h$ID+YFLAE`#X
zI%C`Cev!#@^L22b0t)L3HVQ=xV73DhIKX`6+%ewG4lhn%PAC}<PsWz6AWd7n#Ui6#
z4}`peLSzccycL+4lln)*a~!A>)Y4jmbpDQc>w~h@u9E*@ksL%j=i(0oi#iT>pSI{F
z$5E)6%9J&~idd}QnH=}%Zy#;XyX<awSiPaN#>h?=049Yfb+Vaxl-4=}DT52+24%gs
zW%gSWJWv=3kFv2L+y7=qb_~O5;9^g994aNG1B<-q{uig*1m(c`IWhcE?k}u{PQ!U@
zr3pLNb1AXY2gpZD%-G$0;nc~Q!EnY}J*y33o&389p6vhqM%jFMIZaJTRn;$FMIv+;
z%GAEwEKaz;o;NPHxiJ9*HOh7hCMI+n8yn}#4XMctZmK#t0t#8+!em7CV2nl*ux0og
z43=4oo*anm`Mryk&ynmb#=*W_CNW{^sKNq;m1hePwzPPxmGKt?Ed1ArH#<Y|FK>`_
zU#uQv-P<#y7TK<ki)DttGros5a{)5gR$wbrU+bU=0yyLcYmwxC%}4o%O@<u`jlfFh
zrEM9G{6f1$1D^3zU)Hv@1EZAJ<?patFPl}*ZbS8YU_!PQUuq}zs9ha?I)4qQ=EWDz
zua+#Ab2#3lj;S1|YmlBa#*-shyd06YLcY*(KmMlPXdRi9ggqEVU;vQv*P84C@+A;4
zx8vgCU}2g#jn+p;;q&Ex+1uME8<Z&iP%Qb3ny?S7z&3_V!<-=7BS$$gHZJ=M3rsLD
zMF%Y!9slNXxao>eBW*cjP%iM~KIxP*dqcx&tSJIYblKLE3Qm0&`8pk))zme0Gmc-^
zUv-Tm)``Tu$y{0*E=0OrJv4ZvP>Q^n@to+SvY=K6Q!P@s4b+*U$Z;68wJ<A~udM_e
zHV>F@twfkQjae^)v~X_bpMf{V?&q$3@s<RQ80J_eZMW8!Raa^)fw4_c*55l|g3+hw
zyh{Vxu!t|cRYZJdsg}1M&1q@9@tA|>B5(EO`~8DoHI&VONH9wrwyW9U@aCfRlIJRA
zcQAUk!Aiq;B2Dc@8<>E6eRHG#bhQnP1_mJ_5(J&8A+OS|q;t`q%;fD9cvT|EmmI#{
z+x3UxJ47Pzo3zrWI&DN$M)zeb4#f5lWi(jt#3FE6?*0N*4^!Y)1nF%04Xt+~T^ihE
zF@<;IBPfQ@=*w((n}IUW<gHy9*Vms7D{HIzbFZ=(SJ{yEmzG2(-6e?_0>%z8yIRHo
zNd90Q;HkVInjn@e8|fR_lZwi|_kQL4eN<*zVWLHm-(?>(Ak{B-Fx1ro?p89bFn3=k
zMPviA6OGqlYWQ~pcZzI<7yO+EqL`ku{~8A}LdQ8GjWm+@;W9re6JBDlv0qM(Y1h0I
zPw51PorWf|uC5MR8yywZ&j3f%BP=W|FgVzLZwQsc@kn<D)mDwu7Z^J~Zw>D@->>8d
zbHWFJjHJ#_Sa2(xPa<g97GDO)fXRjJ=)$2!uTP0tv&U{vv+tTR^_FZw9Nx5+?iKJC
zQE;OOMYG)lh1+X%i8zx~V1%zoJ)Ek>T*Mj)<0+#Ss$OO+YCrHGUpE8fOUU|Y0_hv+
z-_qV}m6~=69I0+e;)bS<n1NQMqdNg^`}X0V$D7}`VszqcTyV3)-$$M<o4=>8>En%k
zitk+RO&$g3;>h^~S_ul(nJ>MPyxqbcSuNGbkOqbD`bsa*$?6amHw#B-+xO*Az#eR!
zmKg5d(FVG~*P@%70ho;+<RIgErwio>xXhtTOR7D+y%KSJXlQ6KaEx<m0J(txFr3Qj
zU&P;pOoVUuJ9TdCqNA;>IiK4fhu+*Gr7WL$KDoRnc}?oC8`GtBnlot@3GxC75#Ll<
zI|$^9gQ9eSl!YFL*0OHQ6%EHR9hBQRU`#*&Q}DeDagnuZrw6We39%HG`P!@pXh`nF
zhKkCH(LDN?VN82$PqGo;`&*rlr0Xs{PMOA7op12Zm2(Zyaf%2Oc*Qf@%MYo(I*O_X
z!lDydBbJ=LXyKIPgK&91(ThgmXPZoBxVpO9zCGCiCjV=-!Rnv?yVAk=>+1`GMXM<W
zOg~2_m(&FmCRiE}Bw+#9<&F1p?N&Kywq>;%(U?P}(!^j`BxO15=~djgOP4pX@G8P-
z_H5^@)8Lu5z_fl!|2i#_h$ma>r$f<`ze&SpEGr?HO5ORAh=&e{!JSDhjTW4yvj25O
zDW`D>HvboZaN%FmgP$N|727DRa@wAjkStuT=rlB*Yhed}f^=gY^;(e@?l2~|y|E`J
z7JZt50v+_tNGrih5v9WMR0hSx`&LFp2~gLQIm!Z=%!&QcBmkE+SE3X?ohy2KQd+s=
zIjB#BjXijGJiFZP!6q#&9f89XEF6xty``(kbb7+&2P9(>i9f<+JiN^vRvB_d6kG>t
z)av%P*$kjMW;3c+o+y6`-@Us6>X)uO1oMBg%c)%h%awZR(6?@sM<Xd+{5vlBUyF^u
zg~p2lnUh9tLk$p><kVQ<6Ddbt*<a-V$=zM)dNeDjRp4+G?T~N#?RFodpk+z984DJn
z7Kk|f-6m^nCtbl+Ps%Jt$@!tg_^V**jpCrXK&zfz$?c03^}IaD%5Pw$A5rhA$sQ&*
zqggtpN9$7s4Yl5@Vl#L)OMQue1g1Nu3-N8;#&j^tNDm16P=1+DL7Y*vQ628mN69`D
z&FNj>2YmOUyIua_>_jcF#D>i!X=%Ir(WypeK-Anl=y7LyC3=RW2;9Dy@26jiK6^u7
zjF@7)mB*{JHvN%<spTu!lS|EkD!v12dSfbw56I+0(Wu3{<?FKz)ql&(0bvdRR%svZ
z;AVO*=m>v4aM*4cm#pDmQ50&i-jZ7@mrQUu90&84WweBqoQ`*bmI@ydfD7Hc!fRc*
z)Y?k*8f^AvR%$p?h?Mv`$7K(m1`98W7de@KNWCY4he1D4ToY9oY1gKdmxypry4S&5
ziXLuFI3is{$QNKNWQV8f9dgFF34VEXa_^e5>0SqWZy4W-OILZeO!69^C7}s;c2vBl
zd6Z9Iv@t-1%)(K8gk|=Ab(PM~&_D002QHhw!s_tt28F}DdFs+1b`JT+%1&7b)ykn#
zmS}&CAdi}d<0$qa8qE|Ece*knn`c%HY3*Q$*oHWM<9DsXy*I;;UvDAcu+Z!&o^wCG
z8J#5n{%Zxgp-@m3dIhqfHj^U+mIBev+b$%qnodFBvN3!1RvA``9;;k>GEM4G)qz@@
zo@gXTfq+O^(mYyTyB<EDH}s^#8!zBrJ*h<|>vF<-5WBE5%fr;A<Lo_O$_iVneI&A5
z(9(F)VNc9|qt-fd5Rn4iwI5Ej8>Ck~q{cNb=mm1~mpeuo4x*U~4R3=Dxa%G`(1Cic
z9?dp%xdMtqnqsY8L3i+E`>R#Cfta!4d4bJA(>;}t=isZeJXPHM6+IW0>p|McDxdy>
zI(%omJ<r>#Ai*?2#CT4$lp&<`iHANs{hLXFR0moBo=Efget9C1ip8i<@$r83%YO-u
z7nm0CA4gWfSUMI^Wz}vXx?|`D-?_Y2SO@m(PpsGd8A*FejLV!b5a^2~tTqS@gErEH
zmw~)h5T4dTwi5X+9U8Rf4pWLw@=&0KA3<BPb?Eu-HV>1hX`^V$mD3&l81q-23E6%7
ziNa<nj}zDF7MTm$O8x6}(bkwc`x|DS7V1J$LmZ+G2S(2ar_lj6lUcu=^dPLlVhvYM
zTe|9_BZWWrxh<jE-~VT?iPN=3qn)^i6pdzB@~AfNo(BpZYFVvFkMEaRYY#U*<pg*d
ztj~M@l>xnLGS37~<6Zww{q%1RD7V$Dob8Ef+!|6zB*FuM72-kA(hdx*P_EJAN)}EA
zsuqbn)(7j<?>{N&!bq)RmCjqgYhF3r^iD1#>rm*trN6;C!scbDaFcR>y|%llF7XPN
zjnNY$=XfF5gKrz%KZ6(S@P~R2yboAi=l13jxubc76E^*FG%)h({Mw~aI@-}Ax21A(
zfEbRCsR$PR=pMYXmc|_qr1YgSCnys$3TKqRP#)(Ge~nc<&i7bZkKRgl)`kn|Ih#T>
zSGV^2k+q0()$qq)=4$Dyhy3y?C#b#6nzyBIfpsh}-N6A67TrpyK%SC^SrA(}L7|f_
z<JXdPcj!6pQ>mnm$ry%^FBv9K!bhS+oHQaggppsF!1xUa@S(B~&!RKqh$epjShFJ8
zg~ETvm9B)!-lfU6@2$|8TvnFiVoZc*t4)5|wUc+CS=?Pgs{=wdWb~EoZN>Izugg60
zvQ12q|MN+v5_4D^PlK|5@+EAsJI-IrrOqjQu6ztX?&8MJnjO!@pJp!0tq&9KO_pqb
zber!+AEQh_3#O`zLL3zKHY5ilNL%b^VRLXp(_}&jk1r(@)g0B?8W5#vf+jUA0kNRl
z+_B!#?x{_;|FLlukapiTXy=KQqpu{i{zK+eW?BZs)fnGDmcyR92>&a2oA*G7Q%UAN
z(zQ<?BND0ea=)O{ylbqCb)397<v_1Ad{cP(joIXAYNLeLk4qp!!#z^{7ol|d%Q`Jk
z3}CC(#tCug>>>IL=#e~)(D4r^s`FVPhTtxnZB^?Nvd##uJ>7nT8mf(Z@YF^P=IMxp
zf;)!=Sq?Hc{&Y^{o%jZSKH`O7hBLN<N)t1B=1{nvG8cH?O8W2Su^54k1I<b;yH=2+
zFLSY%L=7KE%jtbw&lo`zGAm;lg1aJf+KotIJuQPI$<O@=?=QsF$B@dk3^`KY;e%Nk
zH8;0BhNXfxb?T&6X~Qtgo&2zJv#(KXZEHKEVqb?N{AxS9n(r5ek=QWvskrWHvg^Xv
znyjT44h$`!=qjF*`lw%zjy)*QIYh4}vIgcGCUk`7;_qMi|J$??2#!R@h+$6hqz>(A
z8_05S_0=)&jqZRxnGAg<4-lS7>E6%$q%!M6cXPsMAFrt&_n;E4ZB8)Z!HrcJFc9oO
zPI(ViWI5+2cmaX<DtJ3B+n6ME0=r-e$B5ACdFbu;lq=xjfQ)9!1NSn9*#_W%IMOq0
z9)z!lCrVAvifTn+nO^4(^LZ9dM-(uNC{G^)P=FU<E*>^-@zl-o)*!!KnG?cU_xP)X
z)rsI*eDU6=LGOwlBMxe*%J$sM%i#K_ri4LH^k7+w?41qP5U~B_c!zPAHtc8}FNOD(
z@j>B4%mh&5q5`%S{P3^JRE#+!=E$0>po=bk6CBB>#;7w;FEqYY&H^6t;^xw*ObhR$
z*+q`oTFuDC5E}$*fz|1xfzHCV<|8lf#Qz<p8CZF1ThwE8ht7-p^4C#QY|~ccbs!#V
zzFsoOs?`Fi{|6<pSqYsReqpIrCW_o2k31|l&jlL4|DvV8jR{PEjpDR$k!99bq}SLY
z(nEYMo*TI~saLj2)aMd|Tc3p-aYJn<VN%tJ?(d=+ACb@6M`*!*aI45aZ@w_)9b*48
zweN;#SkaclTUgx!t@_w=dH1bc|95qmMes-O5;iw;ZXk7trlZmC-gU*uY@42OXNaB4
za|MU!xv=hs1gT5zE~Aj%Twe^7@U$o3I)Gx<#C_Qsnq*~2?Wyh}*HE=~!)-t;AD=?e
z>MSvog;PW75`8P5f+hO|4XWp_PydY$M#anCN>oQT*p$esQUjlQ<w5`Rr04A|#4|f#
zC;6c#XG^@6#YglN%+_r3^3DDKyv7%FaOMBO0+^wjc2`4|wbYf|-6JD^^1TwD8jo&-
zaePZC@_wJfUSZARID5Uc^*SOcT?HB<l4@@L>&hn>^8UaCALmaI$qV(>5@!%uY#j5R
z_uH`Z9q>`X3qusY`c{5f_}<=S4b@D`U&hpAnM_=0G6H8L+oyLp5~dzU9O$@Q<|;t@
zxcd0Ht?Gc;1l>}xvhI&7JEbaXHi4BntPb>aMv>X6i`swpV+G>(aFpIu!KZjl-Gj~e
zjrXWkim>zP?c}f5l?H-ed*0r2%Qu|Bh>_CO5e2g^ALAsn6o=~T3%fu@-Z_}MT~x*Y
zUis#@^hlESG~J;;%+*6&^=!qzw07m7M8}e=BzThl*{6N;Q|zaS>9NXu(c&WU8)*y7
z`LAS4j`SfQ92r(nqYE3w2U{ah{aFl-2-Y9*>{0x`%iDoSX>h=WwjreUde_>#Ji=HT
zHhyq=e%AEKBU)izeK2=AU5uWR;jIoU-#a56@bn2hVm`f`V1~ce9bRH>IDJnhg!JH{
z$B126KFkTLt>j05Vg`-24IsXQfqay;t&YR8JP{abhW#1#$z3Qac!SgA1X=fh9bn9i
zhQsVOM*Ie5wd%8`y2AwLYI7>=tX&tk5@IB~I2p8$zN*1{(D+*(eeu%cUywJ~2V2Lh
z#|tzxD(;*lIupx09rLAJK$#XRzPep#rY=*FxNeIA)eI@Q6OHB{8S3uwRFn&wuy;TW
z{yxsiRA)7KFk9`~_D)0a`HK?fO7b609Efa>P`$^hJrfE#S&o1n91LkA-pyCeoJG9A
zw1T3y!#9o3u(mVKKJDy#xKQ}uwQ1S2*3s}_{RwBWSoKi=P3~EH*|P3**A$lx#H3r*
z#!c)?GHH43a{teo^XAQPn(T;S-98~7=#FaxCrHw*4g$1Gzqwzb{Lam>G)Ct;xsXoZ
zWXpv?s0(W!d($7F;T&idI)x_#<QK*|?%fJBv<w%@uwCg&Gy`C`Udp{p(o-V)h;1>X
zgB#3JNT*g*cvZWvD!^$5_)=lF%sYR<wbJHaT_lG08L3v<wl)J9#2Da+C{{w?&wsBg
z{O{W4VC#VV6f0d-@uj8N#zFaB$7oioYmM7O%+<MN{48N>t@!KqXyWqOWr{+c@lN#M
zPaKPVXNyKN!jtZvZ5m4=ro35P_aVX$IJBtcg@({`yDQ&<Xq-SDSLp0^H)6YE$hOvf
zu-3A)G$Y!2FRdqYNef))#kBe%eDjkRFN%LjMhb^tjneYnb3U^0O3ut<$HhAfa*#T&
z!h^K_piI_Q(RnM{Q^yk^_i9DK1OJ;vQq8W%ILIi0k#h3BZ166_Ne*WEEAuu4{s$WE
z2a<dF`FXf1bl8||RN+4QlrG43{Gf*;KaApf&vv%o-(GWM&CVX1uyu8BiFxoB@Kvsd
z7ES;EmHd}Jjs{!ciR-Z4n~h9@dp8`@>TU<Y_aPAZp#(MhV|#`U#*hGD<-CQPvy!;8
zX8TcNRy@e&T3c5K0Km00cA&MF-xCxW{9ph(7<A3w=lPcU<%Nxn2-dm*Hj_Sy0Q-*{
zVB%<u=anIs>EHL|H*lB!Rufpjo{J~sl2>ki`_En6K(zd^3)<EQ-n`#PYVXJckbS8y
zvFxWx_6?TR#Zn*`a6O%$gh^2ioE`EOPHlA$%sy!n4ari?iam7~PHxpMWa7;rt$yDO
z2i7ixU#ar6F(!~vcWob7Ff6Q}1GD?2F-gd2GMhDMs}_TG>Ll|MqnUIf&1lxJ>wZW}
zX?IHe_jumHGH*}9rb+%(duajcR|`n07PDG><K-Gc$T+`Qdmq$d<y~9=u12I_yE|)b
z@%(Y}{V0w%XSyj<D#*Xw!PFIAJy@+1OFt-2llcrTV^ek<T@+yJ!&pMyzkDIoBRDHj
z5EaJ2vUoP1bn4(lk*ZE7di2k3eDv2Fw{uX00d^$6pmGxkeQS%3(T_6wd|V$cO)lLp
zZ!<Dync51a-iOv(lLE~ql|8dDWg(!^tF3A5c~_0-PVU_gEIB4ma_v}aVTt3!|IXC2
z(mh1gW!|7&4{pCz+TP3b(q@OA+upDOJ+@Qudv}%Lj?tig^?&c|EBJKY-ja`UgFN~E
zIB4XT&7T6MDkWSjUhhzHASprYe!4H4vp-{8v+kS(FN1+L??yqZFUbGonJd)Y)piEv
z<u9<swN~&IACBz7ZW?rQ0FNpvsIv4Aw!82@%pv_R(*0N*c(w=rJD#R$qMLJ0i`o&A
zSOKxrPv>WUKx8QD<CBWtIyNOC#6ay~5^?6XRAl<h)}}YsrdAd(ShUd7Mj(k4NaM5p
z`U(|o<BcEr(OH3%`S29KQSZJwhny}hJa&azRH0Q{ypE>X>OygMS{XBBIi-A#B;9Ys
z=rvFI$Km&nj-?&|Om?u}agVb`x^&>b`CXn?;7&W>d&Eze{sp=ct@0SLZVEJkRsMEu
z*+P?q%k(rQ*|8cQ>#8?dgrCCBD`5o)05rP`=z!Q_M|;u)H+hGHO;Pv38gAw85?#;s
zXNv1AK9)?<1$guSs6M~oo1QQ2i}(_z{cTJx>hMSo0(L5!j7Fv(o;UNrw$5s#Z%raj
z*G2n$G3Mg_yfKtc9dV7zXo(<#6M^!OWYT-pbs0Yl!}C;7RszP_%oWKJ3aLWC!x+_i
zzeLrYI7LZRf0(X<BR?oDfl=El4-~y+4r?XBJmh~DMO?@p;@62trf{!Qy%X)>DY>cc
zWpyDjPy#@)KRd?H6SqD)Rj!g5`wyJ!Ik<`5-IBk(=2}^|22MD6xdOBo^(DcaP=>ui
ze&CsH)<p@VJltNGKiSOA6*_}#e37|=WChO;pUO~6%R3VQ(D26R*X*s<>&jSOxR6&D
zG30?uB{D9Ef|{Mepr%+m5HHd9Dho`PLv1sQ_gtsddRI`XmtbIhyiAd8Uaywc*dSqn
zG5z7Tmzz2$w*bqF;dHTfuQ-r%;{@mms6{j9HP~QcV5lSJX|-!$6o~R$|H<~!P~tCu
zh?W)X)Sslkf??zGSS)VPzmx`E)hG8$CxEt6=N3`c3}BiWTx`)_SdmbG?TP%K?YSdT
zPfv{15VdEyH9z)%Z>7uA5#mjK%^4mdb{|5iYn-vP#^cLTL~FS7&|GQ6?(+t!lo`**
zWQz*75Y@=RFMeNFf*JR-Ip*$52?s+l4Ed}X_cj94@;<#Mq=M5{C!dS68gsT{#Q3-M
zQEa8P8~e4sxCU?1+-ZV$5$-aUkKNC4b!<4K1B@l1+){Oke*+fn7gyTmD9}vu(+!tZ
z4EpXhfL1bzbXM!n|4B6}PUVsi1K5b;R#+Lph%dW%`*`2$h_wVj$fTtMy+3|dAUk39
zd3T8SmUd<stu~YKpCu8;b_vFMOP=BLM??L8-F;P9RnfZWBBT+Jlnw!D1PN)7MM{Gp
zDJ3D@4bmYc(hbs5(%mK9-6h>!cd*aa^WEqBc72&nn2h>!{ONHX&!{I^PWVy+&Yr?J
zL^zX;uRPz?gPC*pWsIf|Db7He9Y-MVda__0fyaApq6Pe#kXAjW*#YX(dndjwJu@AQ
zv1jEWhbwpK{bq|kbqG{Ni$I*ATEor{_VKe{@$MgtOrnyi3qA0(5(i}WJw$xPWq>b5
zCs%lhbZ-o^A1**2hart2TDCOUn_JQPkT7{<udA7(j%G<jbIyqSDpAQg{-+@6;6$0E
zw?AK;Pi&d@B$;`4cct$5LvLg<#lP9)+${Lsa-s_tD#6LmW^xiCTH+Ys%j;<Ng(_q!
zXw@3n&Sptu!GjV~AV>;jqc!UXvG$@>3_J3)_mvf`#Zw#q3S>i(O(e>Ey`;3jk3ZJ)
zF87pSo024!61*s$Zcs)xA5NtA?Jpu(;%5!*k4gLk#ILK}F(XF)s`Asb+klNnx3I9A
z0u*Yke~EPJ*UD*s;d*80mYPBz=MKWWfBA4-I&G?;?EXOW7lq~DzIl}{ZC(q#4(27N
zG|U*^ns%j*w(nY<wxu3tb|~vl_wZskz%UoPnNg|B)>9GxOE&b0ZuSCjTu)yV4n_E4
zEt9r%QV>N-`@K2u)oe;xt6IcrKTmd&OA&4U`N8`d69i5J-FMn?yfI;Z^2~NQFRX%K
zh!M%tQ9OMfs}wH7a=r9k6t*c@3giTA$8K0Fb~^#t3F3Rrbx7<?U#?s;0pWv5D}QD7
zKTiGcjrVCgh-gK;YOJ1$0-8dd$LrqHEG@R}R<Mii_(9D~<(w(99~UO14W>R2G3LR~
zh&i#BIAex$qPGtA3meCZnn~C=VAZkY{5rCO?b2ssXiN_t%83-TMdYFwlYX~SivRC$
zkB7JH`D*qg2Xayo$>*4o`rmS)R-)!k?$o?_R0Aw<+wYUB`Hzt(Pz6OYa5zB&nx;4)
zYQVr5X&&DLlwtQiyRxS_vx2$XCslBK#?b)~wk{dZH9>05x-v7(I?~=Zs0r?V&sTx7
zy*g=Gbm-qRc42+UzV8Lm?9w`eJ8a?UXZ|P~;o5~X_wgocWIQk8FsQ5T_TT-9)giaX
z^AP{IIIdA&b3}|B-`XiDfE2GR5-_uXR^7n<5@A49%O-eix6USnKUQhl^(<z7PejA}
z{c=kE81FaWKJjya{viIh<KXy{L1IpEa|H5s4qv8lb72bHqVyV0megwN)t9wS3an&O
zR;I(=B?mF&Cx@6bxG2FKj0@J$>j8R0GtMwtHOeAgJOXHDq@siV_wa$Qd>jVP#xx%@
zktVa0WjjB;uc7Skq(o`T_xa26lwVzKyNOwn$h?z9gMbjc*e)tE{4rV?7oJygUxi8V
zX>-XSPa`9JneIrTUhd`YJgIU0-hwQ)O9`x6%J0%Ei&05-oJLE-Fi3VT1HFfy%A1rE
z2MxUBp9$@Ki8(`E@HpB3iXY-wcIK0{N?N)JTp|aU01IIXYzutMG;ZdwINHuM89Dqh
z3<&7f*@7zAS|N>}u0^*lVaF44U)vfqm5(3Df+8}TF}V{Y+q?PB4bNz$?2?NjQCjj1
z&gcC17}`phemdj-;K!C?A3J$;KYRh>R5v>NHCIsNV|d!(?UR+x(6_1|5$muO=^96~
zmv3%uy^W9-dr}zkz&ZMz1gUUw>)`mtP=ov!_M_=rqST)FOS1tQgGeQ14qofH;Fq`g
z0)I&&;s`|BXis0D0H^-5wP)>>U6sg<s7MixhvY}2DNicYja4C5`(u$2(2$6mOQ6fq
z0q2w8AZ;1o0Y$3I`>52u&b-6q&7s|ps@cJ!u@lD*VT&6Jj&oVSuBUy?23{CM?;p<h
zF+ZDOY5}`D6aI^x`NTCHHD9OLyxZ$V7q&0)sECjzN%v%bRhg}C6cl?W-_m#A-6CB%
zy#n!o$a}xF{@A$yqFgJ}n#|XF7YmBE$5gR{RM}jzC8;|hu5H9>h1toh8T>sJlk#>W
zoM)*DLYiX2Tek091b}GE&AuXx7Qyit$FRP`dy@7c5Igrc2_%mL;yAKCT@LSh5TYv!
zw;|o?^>}fX8Sd+_DrmrVtL=iEny0i|1Wiyc(4RkYYMgUVUQ60;Ao>v@nY*_mV&Fw&
zf2Vn5Yuh|Ho_;#LI1eN4cXvRXy@3~vQdfQ2TIZ`RWf9rnc2UXz+++Mim+VDKOtnGw
zxA`P1*ILjgONeA{&6Vb}mlunk3iQzihKBQwGMbvigZvl7b&dy}Jv~9M^gBz8hbckx
z<;D3bOEQ+GTQ+=VO>%DTI8`0@Xp_<G=X(L%U*4_ega{rDAB8(*wh{3SA0nsE(@`6?
zh#TBqW)4}*`F+0FhiAFOjL*p#Dw-1qx7~cIQnxa$;8Rnz-hMSrlC{fPdi0FLO4d^*
zte`5g0jW1OdGIywfNiDWj!~F7iZI3UL6a0f9>l}VQTFc{anwK)M#NL{cPBw?AW%%`
zlxM{sHuHr*>O$s>->YBd1Ybz?>W%FIE*IoN+%}UP4^K~DP*8j!^SE3V098~>O{RZQ
zdw6&-YS+h|p4xSWlMSwh3l8AxxWP1s5^)*Nl+%G85bN<qDIgr)=Uu8mGRNl$R<kMA
z%v(&_2$M&oojak#A7wu7DiO4bm=+H}Y|tL;SJk01>cs>0I#g#X%=A<@Z>11CkvfoX
zXA0y!P3f@&qtVL20~?JV-$jTh9eqX2tzM`T&S&VFB60)a^@(VJRjv3nMfA*MQC;9V
z*5m;_Jw#fq(d`ZUr@m@Ahy|$i`vng185x-zC`AteRg?`|eUX1;XRqw<4}30e=sak8
z7|4>2l{!e|G$#b{E6az=ZDP~-v=Lhd1;3s*8ggSNyj$uKlSA2)rE>}O|MA8$vcV(@
zz$8>excTS9GQUOAPzqm!E%NkFKH|2RGA=qr)dx0mN|i);7Fw~zg}oE}vbN7SE7$1b
zY_(Tl@Ym)u<;u4(e8=5XxytmiDSRJX`r9xB-6q|``HqojWs`)oWW{o&vM6b3H;V!S
zO`N!$4i&1x)jV|HKnZVxsG_>p;XS#@0G9hYtXqtkD&AWPAhR_3at?a1TPOOtlvs(P
zhV||DC*BcZEmOG_@M1;sMoLqkety;+EV=jQ&{Qtv0GBRUFp^NR0>`VTrw4v+^h3+P
zz?GUwczF1<VPgqthC0;N+pCkK!^4;EzJ7imHd*A~8m}(~E1-)V^^WU+*#&NOoc+AG
zKKUe5e_Y$2Y5^X!?)frtV^z|?oU(6u^V=nxp8RS8r6eH!lqw}Z2uYHO%m`dEyxx|%
z9_>wWf<#{<N96aEl$Grk@Jn+wwviGqFx-;3ty}*b{l4y)*g11-@I2t4&RJe}f7zG9
zpSZibJ0kApRzG|n_`Ux}c2sqeb-aj7I)KJw?LJ>dZC_Cew}w_;g~fWw*0NDar)B6E
z9i2$siO`E@$ozztWp-}7=S?$FMy_KWT^#~!P0)Nnlz89!e%KEjHE^yElRjJg+sg+u
z`{zM{kZwPRG~dls&lKSQ7CcM{3`EN8L_tGa`!k&B*bo~ZAEaK$Jb#9YhQ>IL&Pc(*
zfm@>)Cie#FL_$n#WmOXH>$mN#Ou4?!$x=pZfpNEUia(Ql11=S0@v->GgH2w{f;z^I
z`;?BGvd0)Ctp}hFsLQeB3$`0(@n_rXeV^|L*)ru`0NaAzUa3=9mqB0;Iwc;++s%^Z
z*8vxZG|N?pn^wo58CK-45+ayCJ3Ar8#l_Ih?Xf)U$F?Dol9KRGp1_pocReL0CN>_;
zmf7Oa*zY-?E7eCdpRI)I8u1E@laSGp5jt@RWvNWdh#e+_uq4sK)c4OWPT7rnkufk)
zv^)gp9=K9>WfGCyF0??~YTTJD6zhmyr=Kb>!z)mz!38o5mG0J=BEC(*B)1}i5GRjs
zfmzCh^DqZ2uXg;R<AVv8bYfuOydrg(*XqhjcX#&^V4OzFt$xJZRuC_jv+d>WZFO}7
z8gg<kKUDm0k&!JR+=2i^%D5YTOmW_Lo-LdFd$}zjp3^)*4M9u@WS_9*-R<k)c6DKM
z8KP`YaRX^hl!sGHo6>B#fo4zyuBA#Qzfi|+-Rb=HHlyBH?cvdf#z7es1%L(Y&n&l>
zKq#!SQZH&efdRcDa{F0bFiJBrHcg3MNAS(UVwn*Jzso5Ejnex1bn61wyYU3c5rp#f
zCA}#t$2<k>f(FkU&zU^o)NUo!!#@KR-`62abM5{fzWx;vXb|G-&|z?_LU^tzX?SyG
zaIP&&-K557pg9^Tm1Y=6>rR9?QdKH=c02FuAo&9YTv=3<Av35e@cHq7j!zzO6(GX1
znP|k7kp`kKmJOk7uSJbj`!Xa7*MU#HGF5KnAcSrW#{~R!yBIh954#4E!N~$$h=;{F
zJ|(3h2iBzJ|CmWknO!Op63Z6JjdtFrYdMpHuJ3NC?s%y|*t^V$(>P=5Bmo&C)3$G-
zS6@BXlpTOFe2P>i`tdCA)G^bZi3LD!HC;k5>H9em9;KrF|BlKDgvr<wvdB`mnxP`)
zK#*1qW7+scx+@GgFcfS;#*%`2S1v=*!a5ABXauCclKd2@=KXE*d>^`FC8r+XI?OhQ
z?bwz70EM>S{~J^kG7`%|YrhPPsGdm)wsj7djfZ^9d$Yh$ssePnB<b!AwRZ?zmIhXo
zoKc!b-BZjF5@{f<-MqEISgV)(a{H<-xFZe<|4&7EMhB9`B%eKSp~@(J8!963vkiE9
z*>K1=U_Ofi#sqE%u;X>7cVb&q)Z*0T8XT}(h;NwM_)Y9x1BzAR@JR<&_EQ4g$^YK)
zg64ua8A1{*2PiBjnbWmi5pIT&po<(jxc4OpX}ZARNBycvNe~|^bSui)z;b7h>wC?K
z6$I}+N0PU`D&kv=+W+=3R}lK6i9xaSbx2?`<-dWyLpy(`N@!JMHmEa|Gl;E@)L=IP
zwqU#SUZjo^37qwh-Hh1`)`PH3w~^y^lD9$duye#ghxRlpl|vzi){i=Hg<F!fa$pc)
zv~cmH5;4hRUXG#hOEw*yqnC4?{|r@>>k3ZGuv|JGek)UI=~{U>%v!Ze7p*7U6=rnh
z3=VG{z9j5ap?R}zSF+Ye#tc4GIUcmgOkCYJFG?o3j+V>MU@|ulW0WYS;rmvWf7hr%
z`coV1^%QQCap#wQER=T@Y2`Qcy&Z{zQN6XYNAtBU-X|ytKc)9maz7h}C$(v?HhJVs
z<uZw!4L@WWH^W=0zTm-{oV<2lD31TiIT&>sHR#rJF~6z4Ws{km{(OFm=yhjC6W;#2
zz;I5gW&e_{GHbZiyh6W%5=?X`R9>SHi7XjTf8=9LuOj2XBAOS>G9+X6XskxQ((O$W
z*SrlYPFz`;hR@Pax=rjzR)tf&)fiXi@AbyzVc*}MA9TPh`TH{`XBOO=7Ul5Ezc_e8
z39-bOes;2|g{q4t*p(1g2!u;S9XwoA66#Kz;F*#@of?e!u1GXNAzOwiI7=CHN~1on
zv*m#FQuTFaxg%~*b_jwmT;Q!j!@B<WhFdn#w?1=Oa~!q<#;3n;^d;u>xp9yvmduQW
zvkH*M(fbdbp44l@6dP;NK%AgEgW433<(snV%9K-f^|pn6-LQ++XmM#3Tus-D42wb1
zYLxR<B_+6CU*y09e$?zps+z<q)aBcL2m$6(@?+J}aKV)k_Q8y;F}fP*8rqGYjH3Ms
zL5HRK=_6LE<XDiv7`)fSyc2|%=QwFcYm!1pz8&r4HXEyfZe|GOrLSyaCC!)qJ6J8z
zLN?9!rel<RF7ueW@2+@w*goA|q|i0}aN*BYy;@HdhB$N@zt(!gR-fZEtEeGanirP$
zCB=W~o-WgU&Wo4NYT>u{`|oM&``ON_R^P6K2w;nMD->X*B!_m#vty;OCuls$n?2^_
zNWVYStv)X&?cEeO$sDw?7lo%JbB2#B`y`SYL9P^SSM_hC=$jR&rVA%oXjgczmQ-`A
z8K<bgIRPb^D~@`i%sxnqrS$c>xpk&H94F(0AD(jRb@Bi4LbN|6G!QXI$o%zhdAcXw
zCtPqJg}A+5VrJAl$33X``F*i~k@p#)QaV%k^3QN!(iL~Bc(}h*VN4w*Ws}pkX0Bj~
z4v%x@)k+8F<mmYhqO=7wW%j$}AO(uB{|=Q)RXvz0KK(m(d8STvUy<isT!Z7z`xbGs
zRpG<2btH<R)4Pk2QnxelFwkUskzM^E^#K`-!ia5~PR1Q!bnJkg)btzz*9s#_(sMQL
z@V!`@gzW<RTw0BwwQG&sbmLtdJDbx-zMkxkWv|bRjT2gRuBb~j>cjiB{<?3mA`?*o
zN(^;$Ar?!Z5dI~Du#LiE%Xy}HU8*4x2h>F&^9o8nqt}e9wB&rBamGHC%~30G(Wt8r
z$t&9IsWrmBj`^N8KU<kQ&dPr%v=h^ayz0zY0Bd#s34(@%h-n{_U1p?EX+yn@dI8Qo
zM}F&!H7AG4?Uq{&+-245${$A?($rpX*$mx@HO|X3any=_k81mg2J8__z=F6nBg0#b
zt|#>Gft9^!x_!1@paYe5u9?fSBds9pOn<8z&q}(y+W9uMTiPVTv)+P>FgW;!{?)!+
zx_xwy?_tt#V0XWt^Qp0MYnzWUoju3jLu*;GudzBStWr2@L7ca!veK|aMxJb4;wFfS
zavtKpvWkt7a$K+?;kN41U^LChz!dm|##mFsYV=9SoE1J#ar+;ldgpERJ^x<l_WTU-
zX}6Ztkg*H2jqMX7BX(!o_ehuuSz1R)90ToG)FL0mEd8qlX=%&4#!64mxRH^MQqq2}
zIM8c-o$j%OtNxPFx3~Qd9$y%W8~kG!RM(iPbH`|~-#vfMnw8xg_YJmfsYQP0%qA8}
z@($@swo=YA{ge-&sMo~IrVl*vrW|NZ*SKFz^1#<EaS5>IXe_*<j-6MDFs$UnLND;;
zl2LIj>%Zh<2%2478_p+775LrX>$H5IBSd<06~HWK&!Oq(2as;>&N`EgP?wk!EqhEk
z&OfJx)sEoxGGAiSKIx_<LbI0@ByuicAgN`%YC&XAbrz;rb>GGyr(#y4?V}XR*Pb3$
zG{WxB7!Ja%tHP^6*kC~PuJEci9vu8G&EI1tYW-N4(EWvd(ndrCoPr<_Tw+O4VP#Xp
z+_+kzznEB*vDHPUa3uHuw~4O-6E41QQ;Qbe1Fx?*QXwCQrewqRIx^BGHcO&kwWztm
zkxbL|96VU~xU@2$S);=E_=s&06q8|#(tgY-T?Y!Ae-C%tbPk_6Z3T3nJDJ`L=GMO~
z%2NhJ&<4(`%?k$n?=ARK^TozF#i<tG+0g5i%)+kYJvyP$i$yrd>*3)c+808x5fCjs
z*wdh(A!-_t**Y#|!q7gID8+whuhJjOoW9a<Az!w>dXABnqhnk#bhZVjrK$P(<=3YB
zMJL~BvpJM?+6&+zzy*x3nyf#Tg^Dp7{}j0pMlKZ-LrVnq_4|T3!)Mm_2>;<axdoq@
z8Q!kn?8x60dkVki=+TmuP<)OybavqRmiv~P-2ZHs&e8eTF(;=;d3oB^2=!~7TKKdx
zp0L_Rcjup^_9lOkK0RZ7TSXaUM_ZXKpeg9EIKG+ppV5nSp!iH#IHX1e1d;|><mAIm
zuWdfF8_C<{qh=*7^zb&A@U|~_0dOhwh<xK*x4XGwYT+*l5NKN>zQeaI-8j>cqDcOm
z0k9jPasN;&w@Zq8dwZMMOm6z9tynLoRVp?`l&_`*xP-lD2iP!y69Jg8hrt@D*sz%9
zKV9#fhp!1O-%|0Zs2nQu4k@ZU315vZ*|g?fvgRo++>tgfZB9ygYU_a4TJ|fgV%BGZ
zC1arVzi5pE9DE$P*IkIY*Gq6t$+9)Q=|!Sh-pltlx&yyOoE+Zo>|Hu}quI0nTO+7C
zjo9_@fT=>n)w*ict@X4=bTkvOFH?+yj~8`AArr^bjLP2g@8|P=Ri#)JI_`ek;gxCk
zLlj{A0X#f})e_ypFDwj1{w)_L?~D|2{$lQaxBD_|zTk{^f}9|<cf7zR_ASYaz6GM?
z%wHb|2E5-;!4ZZ)_rC=iwEcJeW68+ji1u|&(6bn(+}Q?=(hK6JD)bGc*~@K!VVqvf
z0}djpg|KPqC4T-)AyJtSopH6ZmCb@ty+|8+mXn&Xk;!DGQ%&w@GWJx<jjwNd8fkFA
z+oT;S7agHSnlghqSOWsr+(a%Bw2eU~cGe`|ZF}Po=#Nm-tMIyF8coTi){Zf?$dU|v
zi-P=j(^4CG1wJR9O+sK%#*B24b;O49d1+*?k(NJvU^Oyq`JT|qYk@fr_upMpnvP$#
zVdUN$qb8-gBgn~w&aK-qBy>x}v9oJ9?tKasQ7hKAi50~;{wtKbV<-2-<|lPBH$n=n
zaPf{SZ7)PJzgTxiOz>J77_|Y+idJWGR1uv=*|bc77ZD|qC>*6&X+gv~TJkxpozE4t
zg4pvqrdv!hzkawan_IX4pj%qXY7`3K?XW|w{`39g&Mm_JXXk;plb3CDV|%9PKImOx
zFxtg))IDNZ<E`9$=*u6bAGgD5<uyl*MF%GP4|l_wPXzd0WZ4AW8_;?rQVmrAgk)Kw
z$p`f%q9-Tak@AV}z<z$H{XH)n?%}zw*BO*1s@9G*18Khvyq(*Tw$uc)9`3<+qLWtl
z2qMSbD=G!=DL`@)O%!ruWTbgfredCj^G~h138Un1-=3|ltu-6J&X7wLP%G7Y5*HBU
zEe#f#loB@8F}Nz&IOE@5sDX7dXUiH&0ORX7q5Jz925xAz>LK)=XhMJKUgT8c=BW$c
z)r&SVEc-X<XL~N8vwI+)j6EVU@{9e>L`B`g_1VrV=VOB{qaAd__q@rnYa1JSyHlmy
zc7HHslX?7{Pc~Z2IH?2$o0N8FGtRfLvD4(<2@O8nvp6NmR->TE*L}t(3=VtbFg3j=
z>6Plb1AWyFT8(DL`uc0kL4n;Y6we{CEILmiQzg1>=93{`zxwun`fNKLK;{wH*(qi=
zRRZJEKng4i-1gfzAoI(|2;3^^qw_O+X)@}51O-M6&?9)o{FVYLXPEzL*O1dKH=)!$
zx}~}KA&O#wF2Oh7Lj{0-MlIZSFO>;p4m||16cCYnAb*PM>-j*BGcsgk<jXxv&ybuH
z7ZlKPX_TIkQB+p;>8VRY`TY;cs1m0my(B?TQt+8gw2bH;($2I}t>7yNP_G3X_haRq
zcDV`Vl3~@=d3GI5U7*rm29x50N^*0bx>{0F*4WKLs%_S#zLE)&ie+Lgx}BgOpPVQt
zD0~6dKUm1`-@h@*$PP{tK#q#Z2Mw5#ygXzX8JUqm*_^Ty0SMN7q*Ru-z$>ilc2QA*
z<IfN;z*RzNn{EslmP=P1t9H~1{OG8mJkD<gt;jEsFcqps4Plpl8TS6rs@r=500i3N
z?oWa~S}u@?q$D&5KoP&e6E4p@9YL5M4J<dR+Rp1?9M2-_#}MG&<<S8JKw?m`E=)Qs
z^JvQY_4n_WyF3%;dkjwm{)4>zHs57MabANf1ZcIX3m{RYwYkCM;7G;KPa>Oxy}rI4
z7#ix=|LN_A5AlOMszsVGhrKb)iA>t{1cL%MKTpd>w?vyf?)GbFC{e=B9Z0zD4&hFH
z5QGQc3Is~%*1m&$4GR;qv$M--@U*smg@)i`Hy!u&D;nd6U+@-HL_En)AtmlN4pV#Q
z4nEo1#TRcrMFfhBhSr4z1%A)%g>SA?P*)Gm&!_($6Vtj13g8WALcDJF>oAs=moINm
z1{L1F_Xnd9go^FX)nK#KAHt@%Y}3&-^B=WiKN@Z~`V#}FrDK*rp2=me&b_xF=!VC)
z5D*v`SX&WMkKJAGd{Sb)+NqJUSYt~ID8vWYvviMEI=F2&(CW2Wo?&CZ^1OHByE`34
zs#|XTMNLiZbiI{heYhkn3We&nct3H(g*a1NQ&MIOwO#Rw!hKY2fe{rI#c|>G4ER&H
z1m+3+v+xS?4CJrUp}~=ZM`SDO|HG?qkCxEOIu9bloKZSkYB1AU@y^NlnX_gP0R&E7
zLjx7^XR<i8FB%gIYj{4tu+VSZG`bG$L$2?)RZB0hA&>hjBQ-|6T;+V(t4HwOU7xkd
z3EugFb%Gzv!`!S1p8poyjq;qLeJEAEM;1%<#moi6%v%Jg7xrZ?S3hBem{t(F-<+fW
zJ_rsBT*CJ!`=3vBQ*YY@uEHCR<%}*Q^EB>@ls@fJQvzEOD}oSsQ2GrsYE+uV&q0Uw
zOkNWLUWA~lJE!l-yBqZ|#qdxfcMk^W(!L6C-*)3eeq4`)ZZ&G$f1U)8An?TThl%*V
zUrR#NDok<N*x7a2;xV5;pWfi1kKT^ynyL8gK0!xECk)8_s~8oqzWLxXytk`!CAl6g
z7#UFn-UO0QWzUC)ht;aBDCR7x26=$DMND0t5DftiK-_Z6&=H%A%(M5>`TlCtec~v`
zQtI%0){=^X0tUec#>B*As>~=H2o8(sUxrm*$rAf%nD9kDf|runJyya{0`^a6vY?N=
zen-pEUe%%=SOEBie4g^<>8PB0%*`l%K--r$wj0f+6|JTfdIL#sa*K+dZge39^PZV5
z)H_#wEd?%-RQrU4gu^budn~X}*2I3NKj{Hh05d;&e6{d_DG9Nvn~!^?k8pn&AUNmH
zaJDnKdc58{qQ5^^Gs2cL8Z<YjIko3N%wvaSS$~9}?RjVa^Fvv7SuaLD@7eFwqmRJ0
zYgME9^5x6sY?;Io!(P0#%}wc@Bwoj-7y_5%zskx$V(wQ!IUj*}b?TR)bcujJ<NKd#
z%j_O8%v$tJC*Vv<oKHS6s+S`@QeALJNMv$yD4kMvT6wwh{)hpW)8WU|BPB&eN+#F6
zipi2s{e<;b8;Otd#f+24#@05=HQP~@ITp3eAH6NnvT=ID#`F5P9b4{^#6iG65%7!o
zXNreE9#6|PlCW)#HcazcPn3J-)I_0%dkhPhIMwYKnbUm6*V`L*Y<ygIrrhMvi7#2p
z<AN$z`a_dPLy3B!IWru&z|~rmgAOQbYl&JgPESZgl(h*sB(84Ntl#9$-l6*Xgm!VI
z#XS9(X+^c&*0<9+z$E0-CwHJSGNG6vftx9=vLNBGd(*z@;qCzH;^MN2$CL?@>W`|L
z?h5DE?@wir#l8|y;4!K#oy?^P`?Q}73bH6cwc4av8eaIL6HRQe6;CplaVCNeoE4{<
z`udq*VS0Nr6)p4%4qTq%H>0spv~nmAJ<vdYgvZa%57z7Q{^r0()h(ieBeg%7SC#Mf
zux+m~yS7%{xI(?uWRzyBMmm-mxk8-@oYI6zg@fuGEP>wf@i8U|Nhl(z)1zw&>@7M5
z7Y`4(eh^(6v|TJlen?(kZKhh^-#S0fj~3U}rTF&k+sCTetW6r31mEmz8XR0)$(?se
z+{2spQ8Y5Gz*0UuH%C0?;<Gibssjb-*O5s{UxC_kwYzYZV>zEZyC<fgFwCT{ztSEw
zRb`p_PQ{)Cv}^UBw-6T*f&J8<;8$ie2x~l_q5b~-#wZu4Vgc$iK|$Z<MjSl6N6cUA
zjvV3H+S&rg5xhHJq*aHBjqL*ihp^<>bVE|4SwqRhKu<4XYg;BKxaYtNR*N%TAawL>
zmcn5DcQk>Z2OpsB#;Xk?fV!C(86q>Gsz4fCUOJ^tws&?)^@7AuZ>?X9KpOuTbk|Z=
z#<Ale0WULJw49uHOiWC<xw%3I3k^Q+ElX~<<UB=8P3bc-GC=V!Vc?Y{*c?c1yE$mW
zXl`n>cf`fT1*l~nhMskr#!n?4)-HH|gn>rD3IXEL>1sVT5_oX1X=NoEObRT4e>Ng>
zj=3eZ@q2VM1r5zc%w%VK`%8;HnRvD*z>z2fJiG(RyaB-1iM0yM9|{Usr!M?pVIVsf
z6Bl>=gy;UIo@)+vDrkns_<ExYz~RoL2`CnnR8(-l#nwGI*cFV+a5&j?KW;=4Ewz49
zR_y@W-9PBaK{8)ZDNu~rx_KqPHy*m5Z8^wyf(8=ES?&JFKk7sPEjnuLcjP~Ople7K
zbXW4O?DQXTu_^;(yEH6L))7JRmK9VMa69V2hj;-utkh14rFor_&gDVTcwapGEBkHb
z7u3|cfT3L;_p(@n<W7^H72-h++enYg1^CDMdE)16k?jdyU0q~K%2U9Hj*o2sFj_yA
z%^#}{o%L^WJv^Biw=*aPOyDUo_tHsH+p-XV@L0gP3qV%?6n@uho$5Z=t=Y4(9YFd%
zk3Sf%+GpnBAtVgV?k`RMPI}pE#;M;OLBZ{Q{o3PhM+eS$KEZx<!Zzz-@A|_?)lLXd
zR-B!$n2H-*&hj%{5g`q(7h>ShWm5&v(<)Sf*6}o;&4^(snn5)pKAuiBo+1RM1RE+Y
zPQ}AhJG#(RT}^=CBV3Ck1=4OouW{I_SrBuB2$=$97<L_8g@oA&cz&rqfByVY_%Q1<
zGP-X8$1n-dW`SfF;YszpuNmB_v|J1WfO}go?jS+Zf+?{G7$l6)cBG*D&OSiHk&%%{
zZ`z~ZcI1TDVYeALZ5j0qwd9nPup4joc@2z=9;FRuB0Bh`kdzdP*TgEF<H15G@cOH4
zNUg8R>9Db}$tx-O_#k5FwFhEByg-GBwCrrLqx9@wzn%%+okpFy1Dy$>@O=mgufx(&
z7a1Z%v(fGO!~I3m(ah)Ko)4zR-}X+ikFA$mp8#IZ7{j8&3=*oL*4CvjnVIn_Dk?;f
zC<JbH*^fX@elWO`Sa0+_KU#1-0J0dV)M{B|i$A}h0BUCTGmhW2@+BP|7MbU5DG<<@
z#ZC9Mnq&n^b9t(O$|&jRB!Ql+P5j12)a~wUGQ)DQk&=Z)&Ltdh2b8Fu7muDf>*F=a
zQj2+>^l{S;aWeN8lU>`&H|KlU0G+TpIyzQ%r_1y}9e`Ggs*nIu7YX&Q)JD1%Ah>+r
z7vO??aBNz+6r2z|re~kZJ^-a&8_1vN)KnISy&38OP&MNGV37rUOv8v5G8Q{tp!z5V
z1nw{O6@Ya5G?>EVa<R{pB%9M0?N~H3qrSz9<aK(m3tIe&AU#~OflJaWKt2j;YA;bx
zQ6EX9z1(DU?OGyv!=V9aSh!bLS9-v&w*p+wdVpyFDt!yI&8{3(R6IsZpeW($fYvYE
zHfw<dToy?LoMv&xCMJ<bQGPTC&CGg0T*Edqg@aDlC=|YrL<P06`Gtgmflm`92}mvI
zQRHOQ)J$)>hmi>~1F`I<U5w9}C<An<pR-!98?p`0GB{p<8=DGHfq`!sBQiF2)7F`o
z!gs3TbF74<Bo<GyY<pK%h~t7YZFlMmC(!r3y*rW$=!Lid$<c_p<?ByJq+8c*u6}OH
zEq-4rtXg;mx<rcr(j6O9E_J=IsFD6Q4~QQMSfw90ZihOp+YPQJED&4}5#!pReKaD?
zf(%q3aIqrbcPR&m5LvpiG*x431WM}IZVupzTu#RR{w;O17A1!g(m@G;;B?$W>({m%
zu{>&5G<%lc*r*Mpj>75oxHJ%N!%d!^uN?O^f!@D;LW+)#{)jB6e}><J4ZZ^54jK~_
z54pa7K2-&g1FbS+cI87eP=iHL+8`3(@q-o3>;Kc&6HkI9KJUF4;tmM-Ckd4mEfV?Y
G{eJ)oR^-kA

literal 0
HcmV?d00001

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index db636f8..4034f4f 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -39,6 +39,7 @@ struct _interpreter {
     PyObject *s_python_function_semilogx;
     PyObject *s_python_function_semilogy;
     PyObject *s_python_function_loglog;
+    PyObject *s_python_function_fill;
     PyObject *s_python_function_fill_between;
     PyObject *s_python_function_hist;
     PyObject *s_python_function_scatter;
@@ -155,6 +156,7 @@ struct _interpreter {
         s_python_function_semilogx = PyObject_GetAttrString(pymod, "semilogx");
         s_python_function_semilogy = PyObject_GetAttrString(pymod, "semilogy");
         s_python_function_loglog = PyObject_GetAttrString(pymod, "loglog");
+        s_python_function_fill = PyObject_GetAttrString(pymod, "fill");
         s_python_function_fill_between = PyObject_GetAttrString(pymod, "fill_between");
         s_python_function_hist = PyObject_GetAttrString(pymod,"hist");
         s_python_function_scatter = PyObject_GetAttrString(pymod,"scatter");
@@ -194,6 +196,7 @@ struct _interpreter {
             || !s_python_function_semilogx
             || !s_python_function_semilogy
             || !s_python_function_loglog
+            || !s_python_function_fill
             || !s_python_function_fill_between
             || !s_python_function_subplot
             || !s_python_function_legend
@@ -231,6 +234,7 @@ struct _interpreter {
             || !PyFunction_Check(s_python_function_semilogx)
             || !PyFunction_Check(s_python_function_semilogy)
             || !PyFunction_Check(s_python_function_loglog)
+            || !PyFunction_Check(s_python_function_fill)
             || !PyFunction_Check(s_python_function_fill_between)
             || !PyFunction_Check(s_python_function_subplot)
             || !PyFunction_Check(s_python_function_legend)
@@ -523,6 +527,36 @@ bool stem(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
     return res;
 }
 
+template< typename Numeric >
+bool fill(const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::map<std::string, std::string>& keywords)
+{
+    assert(x.size() == y.size());
+
+    // using numpy arrays
+    PyObject* xarray = get_array(x);
+    PyObject* yarray = get_array(y);
+
+    // construct positional args
+    PyObject* args = PyTuple_New(2);
+    PyTuple_SetItem(args, 0, xarray);
+    PyTuple_SetItem(args, 1, yarray);
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_fill, args, kwargs);
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if (res) Py_DECREF(res);
+
+    return res;
+}
+
 template< typename Numeric >
 bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1, const std::vector<Numeric>& y2, const std::map<std::string, std::string>& keywords)
 {
@@ -542,8 +576,7 @@ bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1,
 
     // construct keyword args
     PyObject* kwargs = PyDict_New();
-    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
-    {
+    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it) {
         PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
     }
 

From d42a969cc10978a5e4490d50a51e301ce2c5e7d7 Mon Sep 17 00:00:00 2001
From: Patric Schmitz <patric.schmitz@cs.rwth-aachen.de>
Date: Thu, 24 Jan 2019 16:54:19 +0100
Subject: [PATCH 02/86] Add portability #defines PyLong_FromLong,
 PyUnicode_FromString

---
 matplotlibcpp.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 4034f4f..356f9f2 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -18,6 +18,8 @@
 
 #if PY_MAJOR_VERSION >= 3
 #  define PyString_FromString PyUnicode_FromString
+#  define PyInt_FromLong PyLong_FromLong
+#  define PyString_FromString PyUnicode_FromString
 #endif
 
 

From 05087cf86ea6100a6a723a9b65d97dc90566b497 Mon Sep 17 00:00:00 2001
From: Patric Schmitz <patric.schmitz@cs.rwth-aachen.de>
Date: Thu, 24 Jan 2019 16:55:11 +0100
Subject: [PATCH 03/86] Additional debug output if python module loading fails

---
 matplotlibcpp.h | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 356f9f2..6c145ef 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -122,12 +122,15 @@ struct _interpreter {
         PyObject* cmname  = PyString_FromString("matplotlib.cm");
         PyObject* pylabname  = PyString_FromString("pylab");
         if (!pyplotname || !pylabname || !matplotlibname || !cmname) {
-          throw std::runtime_error("couldnt create string");
+            throw std::runtime_error("couldnt create string");
         }
 
         PyObject* matplotlib = PyImport_Import(matplotlibname);
         Py_DECREF(matplotlibname);
-        if (!matplotlib) { throw std::runtime_error("Error loading module matplotlib!"); }
+        if (!matplotlib) {
+            PyErr_Print();
+            throw std::runtime_error("Error loading module matplotlib!");
+        }
 
         // matplotlib.use() must be called *before* pylab, matplotlib.pyplot,
         // or matplotlib.backends is imported for the first time

From d184e14673541ff9bae42331cd1cc8a03e2e63c9 Mon Sep 17 00:00:00 2001
From: Patric Schmitz <patric.schmitz@cs.rwth-aachen.de>
Date: Thu, 24 Jan 2019 16:55:40 +0100
Subject: [PATCH 04/86] Add cumulative parameter to hist()

---
 matplotlibcpp.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 6c145ef..826854b 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -595,7 +595,8 @@ bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1,
 }
 
 template< typename Numeric>
-bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b", double alpha=1.0)
+bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
+          double alpha=1.0, bool cumulative=false)
 {
 
     PyObject* yarray = get_array(y);
@@ -604,6 +605,7 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b", dou
     PyDict_SetItemString(kwargs, "bins", PyLong_FromLong(bins));
     PyDict_SetItemString(kwargs, "color", PyString_FromString(color.c_str()));
     PyDict_SetItemString(kwargs, "alpha", PyFloat_FromDouble(alpha));
+    PyDict_SetItemString(kwargs, "cumulative", cumulative ? Py_True : Py_False);
 
     PyObject* plot_args = PyTuple_New(1);
 

From f64f1f6583e468abf2871b3137e9012a80162357 Mon Sep 17 00:00:00 2001
From: Paul Jurczak <pauljurczak@yahoo.com>
Date: Wed, 13 Mar 2019 01:21:03 -0600
Subject: [PATCH 05/86] Added missing <array> header

VS2017 failed to compile due to missing `#include <array>`
---
 matplotlibcpp.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 826854b..ff722c2 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -2,6 +2,7 @@
 
 #include <vector>
 #include <map>
+#include <array>
 #include <numeric>
 #include <algorithm>
 #include <stdexcept>

From 8babc98e0f3d1b33008e827f8b9267a1bd65c470 Mon Sep 17 00:00:00 2001
From: William Lee <williamrob104@gmail.com>
Date: Wed, 20 Mar 2019 10:36:47 +0800
Subject: [PATCH 06/86] Add kwargs for title, xlabel, ylabel

---
 matplotlibcpp.h | 40 ++++++++++++++++++++++++++++++++--------
 1 file changed, 32 insertions(+), 8 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index ff722c2..431ba3a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1321,29 +1321,41 @@ inline void subplot(long nrows, long ncols, long plot_number)
     Py_DECREF(res);
 }
 
-inline void title(const std::string &titlestr)
+inline void title(const std::string &titlestr, const std::map<std::string, std::string> &keywords = {})
 {
     PyObject* pytitlestr = PyString_FromString(titlestr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pytitlestr);
 
-    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_title, args);
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_title, args, kwargs);
     if(!res) throw std::runtime_error("Call to title() failed.");
 
     Py_DECREF(args);
+    Py_DECREF(kwargs);
     Py_DECREF(res);
 }
 
-inline void suptitle(const std::string &suptitlestr)
+inline void suptitle(const std::string &suptitlestr, const std::map<std::string, std::string> &keywords = {})
 {
     PyObject* pysuptitlestr = PyString_FromString(suptitlestr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pysuptitlestr);
 
-    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_suptitle, args);
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_suptitle, args, kwargs);
     if(!res) throw std::runtime_error("Call to suptitle() failed.");
 
     Py_DECREF(args);
+    Py_DECREF(kwargs);
     Py_DECREF(res);
 }
 
@@ -1360,29 +1372,41 @@ inline void axis(const std::string &axisstr)
     Py_DECREF(res);
 }
 
-inline void xlabel(const std::string &str)
+inline void xlabel(const std::string &str, const std::map<std::string, std::string> &keywords = {})
 {
     PyObject* pystr = PyString_FromString(str.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pystr);
 
-    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_xlabel, args);
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_xlabel, args, kwargs);
     if(!res) throw std::runtime_error("Call to xlabel() failed.");
 
     Py_DECREF(args);
+    Py_DECREF(kwargs);
     Py_DECREF(res);
 }
 
-inline void ylabel(const std::string &str)
+inline void ylabel(const std::string &str, const std::map<std::string, std::string>& keywords = {})
 {
     PyObject* pystr = PyString_FromString(str.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pystr);
 
-    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_ylabel, args);
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_ylabel, args, kwargs);
     if(!res) throw std::runtime_error("Call to ylabel() failed.");
 
     Py_DECREF(args);
+    Py_DECREF(kwargs);
     Py_DECREF(res);
 }
 

From 07a73fad22b185de42844dd110da7eb14197b833 Mon Sep 17 00:00:00 2001
From: Olivier Kermorgant <olivier_kermorgant@yahoo.fr>
Date: Wed, 13 Mar 2019 18:21:31 +0100
Subject: [PATCH 07/86] Add dynamic plot class

---
 Makefile            |   7 ++-
 examples/update.cpp | 112 ++++++++++++++++++++++++++++++++++++++++++++
 matplotlibcpp.h     | 104 +++++++++++++++++++++++++++++++++++++++-
 3 files changed, 220 insertions(+), 3 deletions(-)
 create mode 100644 examples/update.cpp

diff --git a/Makefile b/Makefile
index 50a7af8..1df85e6 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill
+examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill update
 
 minimal: examples/minimal.cpp matplotlibcpp.h
 	cd examples && g++ -DWITHOUT_NUMPY minimal.cpp -I/usr/include/python2.7 -lpython2.7 -o minimal -std=c++11
@@ -32,6 +32,9 @@ fill_inbetween: examples/fill_inbetween.cpp matplotlibcpp.h
 
 fill: examples/fill.cpp matplotlibcpp.h
 	cd examples && g++ fill.cpp -I/usr/include/python2.7 -lpython2.7 -o fill -std=c++11
+	
+update: examples/update.cpp matplotlibcpp.h
+	cd examples && g++ update.cpp -I/usr/include/python2.7 -lpython2.7 -o update -std=c++11
 
 clean:
-	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill}
+	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill,update}
diff --git a/examples/update.cpp b/examples/update.cpp
new file mode 100644
index 0000000..7027ba4
--- /dev/null
+++ b/examples/update.cpp
@@ -0,0 +1,112 @@
+#define _USE_MATH_DEFINES
+#include <cmath>
+#include "../matplotlibcpp.h"
+#include <chrono>
+
+namespace plt = matplotlibcpp;
+
+void update_window(const double x, const double y, const double t,
+                   std::vector<double> &xt, std::vector<double> &yt)
+{
+    const double target_length = 300;
+    const double half_win = (target_length/(2.*sqrt(1.+t*t)));
+
+    xt[0] = x - half_win;
+    xt[1] = x + half_win;
+    yt[0] = y - half_win*t;
+    yt[1] = y + half_win*t;
+}
+
+
+int main()
+{
+
+    bool use_dynamic_plot = false;
+    bool timeit = true;
+
+    size_t n = 1000;
+    std::vector<double> x, y;
+
+    const double w = 0.05;
+    const double a = n/2;
+
+    for(size_t i=0; i<n; i++) {
+        x.push_back(i);
+        y.push_back(a*sin(w*i));
+    }
+
+    std::vector<double> xt(2), yt(2);
+
+    plt::title("Sample figure");
+
+    std::chrono::time_point<std::chrono::system_clock> start, end;
+    start = std::chrono::system_clock::now();
+
+    if(use_dynamic_plot)
+    {
+        plt::xlim(x.front(), x.back());
+        plt::ylim(-a,a);
+        plt::axis("equal");
+
+        // plot sin once and for all
+        plt::named_plot("sin", x, y);
+
+        // prepare plotting the tangent
+        plt::Plot plot("tangent");
+
+        plt::legend();
+
+        for(size_t i=0; i<n; i++) {
+
+            if (i % 10 == 0) {
+                {
+                    update_window(x[i], y[i], a*w*cos(w*x[i]), xt, yt);
+                    // just update data for this plot
+                    plot.update(xt, yt);
+                }
+
+                // Display plot continuously
+                if(!timeit)
+                    plt::pause(0.1);
+            }
+        }
+    }
+
+    else
+    {
+        for(size_t i=0; i<n; i++) {
+
+            if (i % 10 == 0) {
+                {
+                    plt::clf();
+
+                    plt::named_plot("sin", x, y);
+
+                    update_window(x[i], y[i], a*w*cos(w*i), xt, yt);
+                    plt::named_plot("tangent", xt, yt);
+
+                    // we have to control axis size
+                    plt::xlim(x.front(), x.back());
+                    plt::ylim(-a,a);
+                    plt::axis("equal");
+                    plt::legend();
+
+                }
+
+                // Display plot continuously
+                if(!timeit)
+                    plt::pause(0.1);
+            }
+        }
+    }
+
+    end = std::chrono::system_clock::now();
+    double elapsed_seconds = std::chrono::duration_cast<std::chrono::microseconds>
+            (end-start).count();
+    if(use_dynamic_plot)
+        std::cout << "dynamic";
+    else
+        std::cout << "static";
+
+    std::cout << " : " << elapsed_seconds/1000 << " ms\n";
+}
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 431ba3a..2797295 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1439,7 +1439,7 @@ inline void show(const bool block = true)
         PyObject *kwargs = PyDict_New();
         PyDict_SetItemString(kwargs, "block", Py_False);
         res = PyObject_Call( detail::_interpreter::get().s_python_function_show, detail::_interpreter::get().s_python_empty_tuple, kwargs);
-	Py_DECREF(kwargs);
+       Py_DECREF(kwargs);
     }
 
 
@@ -1706,4 +1706,106 @@ inline bool plot(const std::vector<double>& x, const std::vector<double>& y, con
     return plot<double>(x,y,keywords);
 }
 
+/*
+ * This class allows dynamic plots, ie changing the plotted data without clearing and re-plotting
+ */
+
+class Plot
+{
+public:
+    // default initialization with plot label, some data and format
+    template<typename Numeric>
+    Plot(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "") {
+
+        assert(x.size() == y.size());
+
+        PyObject* kwargs = PyDict_New();
+        if(name != "")
+            PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
+
+        PyObject* xarray = get_array(x);
+        PyObject* yarray = get_array(y);
+
+        PyObject* pystring = PyString_FromString(format.c_str());
+
+        PyObject* plot_args = PyTuple_New(3);
+        PyTuple_SetItem(plot_args, 0, xarray);
+        PyTuple_SetItem(plot_args, 1, yarray);
+        PyTuple_SetItem(plot_args, 2, pystring);
+
+        PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_plot, plot_args, kwargs);
+
+        Py_DECREF(kwargs);
+        Py_DECREF(plot_args);
+
+        if(res)
+        {
+            line= PyList_GetItem(res, 0);
+
+            if(line)
+                set_data_fct = PyObject_GetAttrString(line,"set_data");
+            else
+                Py_DECREF(line);
+            Py_DECREF(res);
+        }
+    }
+
+    // shorter initialization with name or format only
+    // basically calls line, = plot([], [])
+    Plot(const std::string& name = "", const std::string& format = "")
+        : Plot(name, std::vector<double>(), std::vector<double>(), format) {}
+
+    template<typename Numeric>
+    bool update(const std::vector<Numeric>& x, const std::vector<Numeric>& y) {
+        assert(x.size() == y.size());
+        if(set_data_fct)
+        {
+            PyObject* xarray = get_array(x);
+            PyObject* yarray = get_array(y);
+
+            PyObject* plot_args = PyTuple_New(2);
+            PyTuple_SetItem(plot_args, 0, xarray);
+            PyTuple_SetItem(plot_args, 1, yarray);
+
+            PyObject* res = PyObject_CallObject(set_data_fct, plot_args);
+            if (res) Py_DECREF(res);
+            return res;
+        }
+        return false;
+    }
+
+    // clears the plot but keep it available
+    bool clear() {
+        return update(std::vector<double>(), std::vector<double>());
+    }
+
+    // definitely remove this line
+    void remove() {
+        if(line)
+        {
+            auto remove_fct = PyObject_GetAttrString(line,"remove");
+            PyObject* args = PyTuple_New(0);
+            PyObject* res = PyObject_CallObject(remove_fct, args);
+            if (res) Py_DECREF(res);
+        }
+        decref();
+    }
+
+    ~Plot() {
+        decref();
+    }
+private:
+
+    void decref() {
+        if(line)
+            Py_DECREF(line);
+        if(set_data_fct)
+            Py_DECREF(set_data_fct);
+    }
+
+
+    PyObject* line = nullptr;
+    PyObject* set_data_fct = nullptr;
+};
+
 } // end namespace matplotlibcpp

From c48ed308d1065464365a9287a8dadeacb2fd2c4b Mon Sep 17 00:00:00 2001
From: Benno Evers <bevers@mesosphere.com>
Date: Sun, 7 Apr 2019 12:39:03 +0200
Subject: [PATCH 08/86] Reduced example for dynamic plot class.

Removed timing and comparison code paths from the
example for the dynamic plot class, to make it easier
to spot the essential usage to the casual reader.
---
 examples/update.cpp | 88 ++++++++++-----------------------------------
 1 file changed, 18 insertions(+), 70 deletions(-)

diff --git a/examples/update.cpp b/examples/update.cpp
index 7027ba4..4b7be46 100644
--- a/examples/update.cpp
+++ b/examples/update.cpp
@@ -20,93 +20,41 @@ void update_window(const double x, const double y, const double t,
 
 int main()
 {
-
-    bool use_dynamic_plot = false;
-    bool timeit = true;
-
     size_t n = 1000;
     std::vector<double> x, y;
 
     const double w = 0.05;
     const double a = n/2;
 
-    for(size_t i=0; i<n; i++) {
+    for (size_t i=0; i<n; i++) {
         x.push_back(i);
         y.push_back(a*sin(w*i));
     }
 
     std::vector<double> xt(2), yt(2);
 
-    plt::title("Sample figure");
-
-    std::chrono::time_point<std::chrono::system_clock> start, end;
-    start = std::chrono::system_clock::now();
-
-    if(use_dynamic_plot)
-    {
-        plt::xlim(x.front(), x.back());
-        plt::ylim(-a,a);
-        plt::axis("equal");
-
-        // plot sin once and for all
-        plt::named_plot("sin", x, y);
-
-        // prepare plotting the tangent
-        plt::Plot plot("tangent");
-
-        plt::legend();
-
-        for(size_t i=0; i<n; i++) {
+    plt::title("Tangent of a since curve");
+    plt::xlim(x.front(), x.back());
+    plt::ylim(-a, a);
+    plt::axis("equal");
 
-            if (i % 10 == 0) {
-                {
-                    update_window(x[i], y[i], a*w*cos(w*x[i]), xt, yt);
-                    // just update data for this plot
-                    plot.update(xt, yt);
-                }
+    // Plot sin once and for all.
+    plt::named_plot("sin", x, y);
 
-                // Display plot continuously
-                if(!timeit)
-                    plt::pause(0.1);
-            }
-        }
-    }
-
-    else
-    {
-        for(size_t i=0; i<n; i++) {
-
-            if (i % 10 == 0) {
-                {
-                    plt::clf();
+    // Prepare plotting the tangent.
+    plt::Plot plot("tangent");
 
-                    plt::named_plot("sin", x, y);
+    plt::legend();
 
-                    update_window(x[i], y[i], a*w*cos(w*i), xt, yt);
-                    plt::named_plot("tangent", xt, yt);
+    for (size_t i=0; i<n; i++) {
+        if (i % 10 == 0) {
+            update_window(x[i], y[i], a*w*cos(w*x[i]), xt, yt);
 
-                    // we have to control axis size
-                    plt::xlim(x.front(), x.back());
-                    plt::ylim(-a,a);
-                    plt::axis("equal");
-                    plt::legend();
+            // Just update data for this plot.
+            plot.update(xt, yt);
 
-                }
-
-                // Display plot continuously
-                if(!timeit)
-                    plt::pause(0.1);
-            }
+            // Small pause so the viewer has a chance to enjoy the animation.
+            plt::pause(0.1);
         }
-    }
-
-    end = std::chrono::system_clock::now();
-    double elapsed_seconds = std::chrono::duration_cast<std::chrono::microseconds>
-            (end-start).count();
-    if(use_dynamic_plot)
-        std::cout << "dynamic";
-    else
-        std::cout << "static";
-
-    std::cout << " : " << elapsed_seconds/1000 << " ms\n";
+   }
 }

From 94c0215d6aa87c6b394ab2990e958dfe57c0d001 Mon Sep 17 00:00:00 2001
From: Benno Evers <bevers@mesosphere.com>
Date: Mon, 8 Apr 2019 11:38:01 +0200
Subject: [PATCH 09/86] Fixed type in update example.

---
 examples/update.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/update.cpp b/examples/update.cpp
index 4b7be46..64f4906 100644
--- a/examples/update.cpp
+++ b/examples/update.cpp
@@ -33,7 +33,7 @@ int main()
 
     std::vector<double> xt(2), yt(2);
 
-    plt::title("Tangent of a since curve");
+    plt::title("Tangent of a sine curve");
     plt::xlim(x.front(), x.back());
     plt::ylim(-a, a);
     plt::axis("equal");

From 4ace1ad946e2782cac0539be96cee6ec5e9d8ba8 Mon Sep 17 00:00:00 2001
From: jul <jul@zurich.ibm.com>
Date: Thu, 30 May 2019 21:10:19 +0200
Subject: [PATCH 10/86] fix the figsize segfault bug

plt::figure_size is known to sometimes cause segfaults if called
without a preceding plt::figure
as suggested in the issues this is fixed by calling
detail::_interpreter::get() at the beginning of the function
---
 matplotlibcpp.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 2797295..30b21ee 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1116,6 +1116,9 @@ inline bool fignum_exists(long number)
 
 inline void figure_size(size_t w, size_t h)
 {
+    // Make sure interpreter is initialised
+    detail::_interpreter::get();
+
     const size_t dpi = 100;
     PyObject* size = PyTuple_New(2);
     PyTuple_SetItem(size, 0, PyFloat_FromDouble((double)w / dpi));

From 019cd237a6be26df33aa1a7efa77dfba171d4fc0 Mon Sep 17 00:00:00 2001
From: Trevor Keller <trevor.keller@gmail.com>
Date: Sun, 12 May 2019 12:35:33 -0400
Subject: [PATCH 11/86] check functions with narrower error message scope

---
 matplotlibcpp.h | 165 +++++++++++++++---------------------------------
 1 file changed, 51 insertions(+), 114 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 30b21ee..8194ec8 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -84,6 +84,18 @@ struct _interpreter {
         return ctx;
     }
 
+    PyObject* safe_import(PyObject* module, std::string fname) {
+        PyObject* fn = PyObject_GetAttrString(module, fname.c_str());
+
+        if (!fn)
+            throw std::runtime_error(std::string("Couldn't find required function: ") + fname);
+
+        if (!PyFunction_Check(fn))
+            throw std::runtime_error(fname + std::string(" is unexpectedly not a PyFunction."));
+
+        return fn;
+    }
+
 private:
 
 #ifndef WITHOUT_NUMPY
@@ -151,120 +163,45 @@ struct _interpreter {
         Py_DECREF(pylabname);
         if (!pylabmod) { throw std::runtime_error("Error loading module pylab!"); }
 
-        s_python_function_show = PyObject_GetAttrString(pymod, "show");
-        s_python_function_close = PyObject_GetAttrString(pymod, "close");
-        s_python_function_draw = PyObject_GetAttrString(pymod, "draw");
-        s_python_function_pause = PyObject_GetAttrString(pymod, "pause");
-        s_python_function_figure = PyObject_GetAttrString(pymod, "figure");
-        s_python_function_fignum_exists = PyObject_GetAttrString(pymod, "fignum_exists");
-        s_python_function_plot = PyObject_GetAttrString(pymod, "plot");
-        s_python_function_quiver = PyObject_GetAttrString(pymod, "quiver");
-        s_python_function_semilogx = PyObject_GetAttrString(pymod, "semilogx");
-        s_python_function_semilogy = PyObject_GetAttrString(pymod, "semilogy");
-        s_python_function_loglog = PyObject_GetAttrString(pymod, "loglog");
-        s_python_function_fill = PyObject_GetAttrString(pymod, "fill");
-        s_python_function_fill_between = PyObject_GetAttrString(pymod, "fill_between");
-        s_python_function_hist = PyObject_GetAttrString(pymod,"hist");
-        s_python_function_scatter = PyObject_GetAttrString(pymod,"scatter");
-        s_python_function_subplot = PyObject_GetAttrString(pymod, "subplot");
-        s_python_function_legend = PyObject_GetAttrString(pymod, "legend");
-        s_python_function_ylim = PyObject_GetAttrString(pymod, "ylim");
-        s_python_function_title = PyObject_GetAttrString(pymod, "title");
-        s_python_function_axis = PyObject_GetAttrString(pymod, "axis");
-        s_python_function_xlabel = PyObject_GetAttrString(pymod, "xlabel");
-        s_python_function_ylabel = PyObject_GetAttrString(pymod, "ylabel");
-        s_python_function_xticks = PyObject_GetAttrString(pymod, "xticks");
-        s_python_function_yticks = PyObject_GetAttrString(pymod, "yticks");
-        s_python_function_grid = PyObject_GetAttrString(pymod, "grid");
-        s_python_function_xlim = PyObject_GetAttrString(pymod, "xlim");
-        s_python_function_ion = PyObject_GetAttrString(pymod, "ion");
-        s_python_function_ginput = PyObject_GetAttrString(pymod, "ginput");
-        s_python_function_save = PyObject_GetAttrString(pylabmod, "savefig");
-        s_python_function_annotate = PyObject_GetAttrString(pymod,"annotate");
-        s_python_function_clf = PyObject_GetAttrString(pymod, "clf");
-        s_python_function_errorbar = PyObject_GetAttrString(pymod, "errorbar");
-        s_python_function_tight_layout = PyObject_GetAttrString(pymod, "tight_layout");
-        s_python_function_stem = PyObject_GetAttrString(pymod, "stem");
-        s_python_function_xkcd = PyObject_GetAttrString(pymod, "xkcd");
-        s_python_function_text = PyObject_GetAttrString(pymod, "text");
-        s_python_function_suptitle = PyObject_GetAttrString(pymod, "suptitle");
-        s_python_function_bar = PyObject_GetAttrString(pymod,"bar");
-        s_python_function_subplots_adjust = PyObject_GetAttrString(pymod,"subplots_adjust");
-
-        if(    !s_python_function_show
-            || !s_python_function_close
-            || !s_python_function_draw
-            || !s_python_function_pause
-            || !s_python_function_figure
-            || !s_python_function_fignum_exists
-            || !s_python_function_plot
-            || !s_python_function_quiver
-            || !s_python_function_semilogx
-            || !s_python_function_semilogy
-            || !s_python_function_loglog
-            || !s_python_function_fill
-            || !s_python_function_fill_between
-            || !s_python_function_subplot
-            || !s_python_function_legend
-            || !s_python_function_ylim
-            || !s_python_function_title
-            || !s_python_function_axis
-            || !s_python_function_xlabel
-            || !s_python_function_ylabel
-            || !s_python_function_grid
-            || !s_python_function_xlim
-            || !s_python_function_ion
-            || !s_python_function_ginput
-            || !s_python_function_save
-            || !s_python_function_clf
-            || !s_python_function_annotate
-            || !s_python_function_errorbar
-            || !s_python_function_errorbar
-            || !s_python_function_tight_layout
-            || !s_python_function_stem
-            || !s_python_function_xkcd
-            || !s_python_function_text
-            || !s_python_function_suptitle
-            || !s_python_function_bar
-            || !s_python_function_subplots_adjust
-        ) { throw std::runtime_error("Couldn't find required function!"); }
-
-        if (   !PyFunction_Check(s_python_function_show)
-            || !PyFunction_Check(s_python_function_close)
-            || !PyFunction_Check(s_python_function_draw)
-            || !PyFunction_Check(s_python_function_pause)
-            || !PyFunction_Check(s_python_function_figure)
-            || !PyFunction_Check(s_python_function_fignum_exists)
-            || !PyFunction_Check(s_python_function_plot)
-            || !PyFunction_Check(s_python_function_quiver)
-            || !PyFunction_Check(s_python_function_semilogx)
-            || !PyFunction_Check(s_python_function_semilogy)
-            || !PyFunction_Check(s_python_function_loglog)
-            || !PyFunction_Check(s_python_function_fill)
-            || !PyFunction_Check(s_python_function_fill_between)
-            || !PyFunction_Check(s_python_function_subplot)
-            || !PyFunction_Check(s_python_function_legend)
-            || !PyFunction_Check(s_python_function_annotate)
-            || !PyFunction_Check(s_python_function_ylim)
-            || !PyFunction_Check(s_python_function_title)
-            || !PyFunction_Check(s_python_function_axis)
-            || !PyFunction_Check(s_python_function_xlabel)
-            || !PyFunction_Check(s_python_function_ylabel)
-            || !PyFunction_Check(s_python_function_grid)
-            || !PyFunction_Check(s_python_function_xlim)
-            || !PyFunction_Check(s_python_function_ion)
-            || !PyFunction_Check(s_python_function_ginput)
-            || !PyFunction_Check(s_python_function_save)
-            || !PyFunction_Check(s_python_function_clf)
-            || !PyFunction_Check(s_python_function_tight_layout)
-            || !PyFunction_Check(s_python_function_errorbar)
-            || !PyFunction_Check(s_python_function_stem)
-            || !PyFunction_Check(s_python_function_xkcd)
-            || !PyFunction_Check(s_python_function_text)
-            || !PyFunction_Check(s_python_function_suptitle)
-            || !PyFunction_Check(s_python_function_bar)
-            || !PyFunction_Check(s_python_function_subplots_adjust)
-        ) { throw std::runtime_error("Python object is unexpectedly not a PyFunction."); }
+        s_python_function_show = safe_import(pymod, "show");
+        s_python_function_close = safe_import(pymod, "close");
+        s_python_function_draw = safe_import(pymod, "draw");
+        s_python_function_pause = safe_import(pymod, "pause");
+        s_python_function_figure = safe_import(pymod, "figure");
+        s_python_function_fignum_exists = safe_import(pymod, "fignum_exists");
+        s_python_function_plot = safe_import(pymod, "plot");
+        s_python_function_quiver = safe_import(pymod, "quiver");
+        s_python_function_semilogx = safe_import(pymod, "semilogx");
+        s_python_function_semilogy = safe_import(pymod, "semilogy");
+        s_python_function_loglog = safe_import(pymod, "loglog");
+        s_python_function_fill = safe_import(pymod, "fill");
+        s_python_function_fill_between = safe_import(pymod, "fill_between");
+        s_python_function_hist = safe_import(pymod,"hist");
+        s_python_function_scatter = safe_import(pymod,"scatter");
+        s_python_function_subplot = safe_import(pymod, "subplot");
+        s_python_function_legend = safe_import(pymod, "legend");
+        s_python_function_ylim = safe_import(pymod, "ylim");
+        s_python_function_title = safe_import(pymod, "title");
+        s_python_function_axis = safe_import(pymod, "axis");
+        s_python_function_xlabel = safe_import(pymod, "xlabel");
+        s_python_function_ylabel = safe_import(pymod, "ylabel");
+        s_python_function_xticks = safe_import(pymod, "xticks");
+        s_python_function_yticks = safe_import(pymod, "yticks");
+        s_python_function_grid = safe_import(pymod, "grid");
+        s_python_function_xlim = safe_import(pymod, "xlim");
+        s_python_function_ion = safe_import(pymod, "ion");
+        s_python_function_ginput = safe_import(pymod, "ginput");
+        s_python_function_save = safe_import(pylabmod, "savefig");
+        s_python_function_annotate = safe_import(pymod,"annotate");
+        s_python_function_clf = safe_import(pymod, "clf");
+        s_python_function_errorbar = safe_import(pymod, "errorbar");
+        s_python_function_tight_layout = safe_import(pymod, "tight_layout");
+        s_python_function_stem = safe_import(pymod, "stem");
+        s_python_function_xkcd = safe_import(pymod, "xkcd");
+        s_python_function_text = safe_import(pymod, "text");
+        s_python_function_suptitle = safe_import(pymod, "suptitle");
+        s_python_function_bar = safe_import(pymod,"bar");
+        s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
 
         s_python_empty_tuple = PyTuple_New(0);
     }

From 20e090ef9e1cab8bd28ca629e34538b297a43ffd Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Tue, 6 Nov 2018 12:04:28 +0000
Subject: [PATCH 12/86] Add support for imshow()

This PR adds support for the imshow() function to matplotlibcpp. imshow() displays an image in the current figure and allows for setting extra parameters such as the colormap used.

I've also added a version of the function which takes an OpenCV matrix as an input (in a separate commit), which provides a nicer interface. This requires OpenCV, but I've made this functionality optional: you have to explicitly define WITH_OPENCV if you want it.
---
 matplotlibcpp.h | 80 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 8194ec8..132cc34 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -15,6 +15,10 @@
 #ifndef WITHOUT_NUMPY
 #  define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
 #  include <numpy/arrayobject.h>
+
+#  ifdef WITH_OPENCV
+#  include <opencv2/opencv.hpp>
+#  endif // WITH_OPENCV
 #endif // WITHOUT_NUMPY
 
 #if PY_MAJOR_VERSION >= 3
@@ -45,6 +49,7 @@ struct _interpreter {
     PyObject *s_python_function_fill;
     PyObject *s_python_function_fill_between;
     PyObject *s_python_function_hist;
+    PyObject *s_python_function_imshow;
     PyObject *s_python_function_scatter;
     PyObject *s_python_function_subplot;
     PyObject *s_python_function_legend;
@@ -202,6 +207,9 @@ struct _interpreter {
         s_python_function_suptitle = safe_import(pymod, "suptitle");
         s_python_function_bar = safe_import(pymod,"bar");
         s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
+#ifndef WITHOUT_NUMPY
+        s_python_function_imshow = safe_import(pymod, "imshow");
+#endif
 
         s_python_empty_tuple = PyTuple_New(0);
     }
@@ -560,6 +568,78 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
     return res;
 }
 
+#ifndef WITHOUT_NUMPY
+    namespace internal {
+        void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords)
+        {
+            assert(type == NPY_UINT8 || type == NPY_FLOAT);
+            assert(colors == 1 || colors == 3 || colors == 4);
+
+            detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
+
+            // construct args
+            npy_intp dims[3] = { rows, columns, colors };
+            PyObject *args = PyTuple_New(1);
+            PyTuple_SetItem(args, 0, PyArray_SimpleNewFromData(colors == 1 ? 2 : 3, dims, type, ptr));
+
+            // construct keyword args
+            PyObject* kwargs = PyDict_New();
+            for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+            {
+                PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+            }
+
+            PyObject *res = PyObject_Call(detail::_interpreter::get().s_python_function_imshow, args, kwargs);
+            Py_DECREF(args);
+            Py_DECREF(kwargs);
+            if (!res)
+                throw std::runtime_error("Call to imshow() failed");
+            Py_DECREF(res);
+        }
+    }
+
+    void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    {
+        internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords);
+    }
+
+    void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    {
+        internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords);
+    }
+
+#ifdef WITH_OPENCV
+    void imshow(const cv::Mat &image, const std::map<std::string, std::string> &keywords = {})
+    {
+        // Convert underlying type of matrix, if needed
+        cv::Mat image2;
+        NPY_TYPES npy_type = NPY_UINT8;
+        switch (image.type() & CV_MAT_DEPTH_MASK) {
+        case CV_8U:
+            image2 = image;
+            break;
+        case CV_32F:
+            image2 = image;
+            npy_type = NPY_FLOAT;
+            break;
+        default:
+            image.convertTo(image2, CV_MAKETYPE(CV_8U, image.channels()));
+        }
+
+        // If color image, convert from BGR to RGB
+        switch (image2.channels()) {
+        case 3:
+            cv::cvtColor(image2, image2, CV_BGR2RGB);
+            break;
+        case 4:
+            cv::cvtColor(image2, image2, CV_BGRA2RGBA);
+        }
+
+        internal::imshow(image2.data, npy_type, image2.rows, image2.cols, image2.channels(), keywords);
+    }
+#endif // WITH_OPENCV
+#endif // WITHOUT_NUMPY
+
 template<typename NumericX, typename NumericY>
 bool scatter(const std::vector<NumericX>& x,
              const std::vector<NumericY>& y,

From bc7e4576b2123bf9851e4e779228e2374ef9862c Mon Sep 17 00:00:00 2001
From: Trevor Keller <trevor.keller@gmail.com>
Date: Wed, 8 May 2019 00:45:29 -0400
Subject: [PATCH 13/86] Added basic example for imshow.

This addresses comments on #79.
---
 Makefile            |  9 ++++++---
 examples/imshow.cpp | 29 +++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+), 3 deletions(-)
 create mode 100644 examples/imshow.cpp

diff --git a/Makefile b/Makefile
index 1df85e6..f9e5366 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill update
+examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill update imshow
 
 minimal: examples/minimal.cpp matplotlibcpp.h
 	cd examples && g++ -DWITHOUT_NUMPY minimal.cpp -I/usr/include/python2.7 -lpython2.7 -o minimal -std=c++11
@@ -32,9 +32,12 @@ fill_inbetween: examples/fill_inbetween.cpp matplotlibcpp.h
 
 fill: examples/fill.cpp matplotlibcpp.h
 	cd examples && g++ fill.cpp -I/usr/include/python2.7 -lpython2.7 -o fill -std=c++11
-	
+
 update: examples/update.cpp matplotlibcpp.h
 	cd examples && g++ update.cpp -I/usr/include/python2.7 -lpython2.7 -o update -std=c++11
 
+imshow: examples/imshow.cpp matplotlibcpp.h
+	cd examples && g++ imshow.cpp -I/usr/include/python2.7 -lpython2.7 -o imshow -std=c++11
+
 clean:
-	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill,update}
+	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill,update,imshow}
diff --git a/examples/imshow.cpp b/examples/imshow.cpp
new file mode 100644
index 0000000..b11661e
--- /dev/null
+++ b/examples/imshow.cpp
@@ -0,0 +1,29 @@
+#define _USE_MATH_DEFINES
+#include <cmath>
+#include <iostream>
+#include "../matplotlibcpp.h"
+
+using namespace std;
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    // Prepare data
+    int ncols = 500, nrows = 300;
+    std::vector<float> z(ncols * nrows);
+    for (int j=0; j<nrows; ++j) {
+        for (int i=0; i<ncols; ++i) {
+            z.at(ncols * j + i) = std::sin(std::hypot(i - ncols/2, j - nrows/2));
+        }
+    }
+
+    const float* zptr = &(z[0]);
+    const int colors = 1;
+
+    plt::title("My matrix");
+    plt::imshow(zptr, nrows, ncols, colors);
+
+    // Show plots
+    plt::save("imshow.png");
+    std::cout << "Result saved to 'imshow.png'.\n";
+}

From 5dd719498b7c22c2c1f1aef839436bc5e6a8dfa4 Mon Sep 17 00:00:00 2001
From: Olivier Croquette <ocroquette@free.fr>
Date: Fri, 19 Apr 2019 16:12:57 +0200
Subject: [PATCH 14/86] Add support for plot(y,keywords)

There is a convenient function plot(y,format) already, which however
doesn't allow to set additional parameters like labels, so add a similar
function that supports keywords.
---
 matplotlibcpp.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 132cc34..e626c4c 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1061,6 +1061,14 @@ bool plot(const std::vector<Numeric>& y, const std::string& format = "")
     return plot(x,y,format);
 }
 
+template<typename Numeric>
+bool plot(const std::vector<Numeric>& y, const std::map<std::string, std::string>& keywords)
+{
+    std::vector<Numeric> x(y.size());
+    for(size_t i=0; i<x.size(); ++i) x.at(i) = i;
+    return plot(x,y,keywords);
+}
+
 template<typename Numeric>
 bool stem(const std::vector<Numeric>& y, const std::string& format = "")
 {

From 2772217011029f9dee286a77f0d29f6508004bf0 Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Sun, 28 Jul 2019 13:21:58 +0100
Subject: [PATCH 15/86] Fix for OpenCV 4 In the latest version of OpenCV,
 several constants were removed in favour of enum classes. Fix by #define'ing
 the ones we need.

---
 matplotlibcpp.h | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index e626c4c..ae78c98 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -17,8 +17,17 @@
 #  include <numpy/arrayobject.h>
 
 #  ifdef WITH_OPENCV
-#  include <opencv2/opencv.hpp>
+#    include <opencv2/opencv.hpp>
 #  endif // WITH_OPENCV
+
+/*
+ * A bunch of constants were removed in OpenCV 4 in favour of enum classes, so
+ * define the ones we need here.
+ */
+#  if CV_MAJOR_VERSION > 3
+#    define CV_BGR2RGB cv::COLOR_BGR2RGB
+#    define CV_BGRA2RGBA cv::COLOR_BGRA2RGBA
+#  endif
 #endif // WITHOUT_NUMPY
 
 #if PY_MAJOR_VERSION >= 3

From 7fa134ea1514a4181ddcd3f0e897490c8fabdbeb Mon Sep 17 00:00:00 2001
From: Florian Eich <florian.eich@gmail.com>
Date: Mon, 22 Jul 2019 11:29:59 +0200
Subject: [PATCH 16/86] Fixes compiler warnings

---
 matplotlibcpp.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index ae78c98..16e94f0 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -677,12 +677,12 @@ bool scatter(const std::vector<NumericX>& x,
 
 template< typename Numeric>
 bool bar(const std::vector<Numeric>& y, std::string ec = "black", std::string ls = "-", double lw = 1.0,
-         const std::map<std::string, std::string>& keywords = {})
+         __attribute__((unused)) const std::map<std::string, std::string>& keywords = {})
 {
     PyObject* yarray = get_array(y);
 
     std::vector<int> x;
-    for (int i = 0; i < y.size(); i++)
+    for (std::size_t i = 0; i < y.size(); i++)
         x.push_back(i);
 
     PyObject* xarray = get_array(x);

From f4ad842e70cc56a38f3e4cd852968c7c1cecc9a7 Mon Sep 17 00:00:00 2001
From: Florian Eich <florian.eich@gmail.com>
Date: Tue, 23 Jul 2019 00:02:17 +0200
Subject: [PATCH 17/86] Implements bar slightly more closely to matplotlib

---
 matplotlibcpp.h | 65 ++++++++++++++++++++++++++++++++-----------------
 1 file changed, 43 insertions(+), 22 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 16e94f0..6a428d4 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -675,35 +675,56 @@ bool scatter(const std::vector<NumericX>& x,
     return res;
 }
 
-template< typename Numeric>
-bool bar(const std::vector<Numeric>& y, std::string ec = "black", std::string ls = "-", double lw = 1.0,
-         __attribute__((unused)) const std::map<std::string, std::string>& keywords = {})
-{
-    PyObject* yarray = get_array(y);
-
-    std::vector<int> x;
-    for (std::size_t i = 0; i < y.size(); i++)
-        x.push_back(i);
+template <typename Numeric>
+bool bar(const std::vector<Numeric> &               x,
+         const std::vector<Numeric> &               y,
+         std::string                                ec       = "black",
+         std::string                                ls       = "-",
+         double                                     lw       = 1.0,
+         const std::map<std::string, std::string> & keywords = {}) {
+  PyObject * xarray = get_array(x);
+  PyObject * yarray = get_array(y);
+
+  PyObject * kwargs = PyDict_New();
+
+  PyDict_SetItemString(kwargs, "ec", PyString_FromString(ec.c_str()));
+  PyDict_SetItemString(kwargs, "ls", PyString_FromString(ls.c_str()));
+  PyDict_SetItemString(kwargs, "lw", PyFloat_FromDouble(lw));
+
+  for (std::map<std::string, std::string>::const_iterator it =
+         keywords.begin();
+       it != keywords.end();
+       ++it) {
+    PyDict_SetItemString(
+      kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+  }
 
-    PyObject* xarray = get_array(x);
+  PyObject * plot_args = PyTuple_New(2);
+  PyTuple_SetItem(plot_args, 0, xarray);
+  PyTuple_SetItem(plot_args, 1, yarray);
 
-    PyObject* kwargs = PyDict_New();
+  PyObject * res = PyObject_Call(
+    detail::_interpreter::get().s_python_function_bar, plot_args, kwargs);
 
-    PyDict_SetItemString(kwargs, "ec", PyString_FromString(ec.c_str()));
-    PyDict_SetItemString(kwargs, "ls", PyString_FromString(ls.c_str()));
-    PyDict_SetItemString(kwargs, "lw", PyFloat_FromDouble(lw));
+  Py_DECREF(plot_args);
+  Py_DECREF(kwargs);
+  if (res) Py_DECREF(res);
 
-    PyObject* plot_args = PyTuple_New(2);
-    PyTuple_SetItem(plot_args, 0, xarray);
-    PyTuple_SetItem(plot_args, 1, yarray);
+  return res;
+}
 
-    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_bar, plot_args, kwargs);
+template <typename Numeric>
+bool bar(const std::vector<Numeric> &               y,
+         std::string                                ec       = "black",
+         std::string                                ls       = "-",
+         double                                     lw       = 1.0,
+         const std::map<std::string, std::string> & keywords = {}) {
+  using T = typename std::remove_reference<decltype(y)>::type::value_type;
 
-    Py_DECREF(plot_args);
-    Py_DECREF(kwargs);
-    if(res) Py_DECREF(res);
+  std::vector<T> x;
+  for (std::size_t i = 0; i < y.size(); i++) { x.push_back(i); }
 
-    return res;
+  return bar(x, y, ec, ls, lw, keywords);
 }
 
 inline bool subplots_adjust(const std::map<std::string, double>& keywords = {})

From d3137c53b16419b80a2aa35fe2f20d36b77d75f3 Mon Sep 17 00:00:00 2001
From: pm-twice <47174886+pm-twice@users.noreply.github.com>
Date: Wed, 25 Sep 2019 22:59:14 +0900
Subject: [PATCH 18/86] Fix for imshow multiple definition error #48

When multiple files include matplotlibcpp.h
and another file load these files in the same time,
compile error of multiple definition in imshow occurs.
This fix add inline modifier to imshow().
---
 matplotlibcpp.h | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 6a428d4..93f19c8 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -579,7 +579,7 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
 
 #ifndef WITHOUT_NUMPY
     namespace internal {
-        void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords)
+        inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords)
         {
             assert(type == NPY_UINT8 || type == NPY_FLOAT);
             assert(colors == 1 || colors == 3 || colors == 4);
@@ -607,12 +607,12 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
         }
     }
 
-    void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
     {
         internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords);
     }
 
-    void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
     {
         internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords);
     }

From dbe8e4c63b2b82d3103d9d4854001334047717af Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Sun, 28 Jul 2019 12:58:29 +0100
Subject: [PATCH 19/86] Makefile: Better numpy handling and make building more
 generic Changes: * Use system version of python by default (overridable with
 PYTHON_BIN) * Find where numpy headers live on system * Remove boilerplate
 from Makefile and just build all examples/*.cpp files with appropriate flags

---
 Makefile       | 52 +++++++++++++++++---------------------------------
 numpy_flags.py | 12 ++++++++++++
 2 files changed, 29 insertions(+), 35 deletions(-)
 create mode 100644 numpy_flags.py

diff --git a/Makefile b/Makefile
index f9e5366..a251d64 100644
--- a/Makefile
+++ b/Makefile
@@ -1,43 +1,25 @@
-examples: minimal basic modern animation nonblock xkcd quiver bar surface fill_inbetween fill update imshow
 
-minimal: examples/minimal.cpp matplotlibcpp.h
-	cd examples && g++ -DWITHOUT_NUMPY minimal.cpp -I/usr/include/python2.7 -lpython2.7 -o minimal -std=c++11
+# Use C++11
+CXXFLAGS += -std=c++11
 
-basic: examples/basic.cpp matplotlibcpp.h
-	cd examples && g++ basic.cpp -I/usr/include/python2.7 -lpython2.7 -o basic -std=c++11
+# Default to using system's default version of python
+PYTHON_BIN     ?= python
+PYTHON_CONFIG  := $(PYTHON_BIN)-config
+PYTHON_INCLUDE ?= $(shell $(PYTHON_CONFIG) --includes)
+CXXFLAGS       += $(PYTHON_INCLUDE)
+LDFLAGS        += $(shell $(PYTHON_CONFIG) --libs)
 
-modern: examples/modern.cpp matplotlibcpp.h
-	cd examples && g++ modern.cpp -I/usr/include/python2.7 -lpython2.7 -o modern -std=c++11
+# Either finds numpy or set -DWITHOUT_NUMPY
+CURRENT_DIR := $(abspath $(dir $(lastword $(MAKEFILE_LIST))))
+CXXFLAGS    += $(shell $(PYTHON_BIN) $(CURRENT_DIR)/numpy_flags.py)
 
-animation: examples/animation.cpp matplotlibcpp.h
-	cd examples && g++ animation.cpp -I/usr/include/python2.7 -lpython2.7 -o animation -std=c++11
+# Assume every *.cpp file is a separate example
+SOURCES     ?= $(wildcard examples/*.cpp)
+EXECUTABLES := $(foreach exec,$(basename $(SOURCES)),$(exec))
 
-nonblock: examples/nonblock.cpp matplotlibcpp.h
-	cd examples && g++ nonblock.cpp -I/usr/include/python2.7 -lpython2.7 -o nonblock -std=c++11
+.PHONY: examples
 
-quiver: examples/quiver.cpp matplotlibcpp.h
-	cd examples && g++ quiver.cpp -I/usr/include/python2.7 -lpython2.7 -o quiver -std=c++11
-
-xkcd: examples/xkcd.cpp matplotlibcpp.h
-	cd examples && g++ xkcd.cpp -I/usr/include/python2.7 -lpython2.7 -o xkcd -std=c++11
-
-bar: examples/bar.cpp matplotlibcpp.h
-	cd examples && g++ bar.cpp -I/usr/include/python2.7 -lpython2.7 -o bar -std=c++11
-
-surface: examples/surface.cpp matplotlibcpp.h
-	cd examples && g++ surface.cpp -I/usr/include/python2.7 -lpython2.7 -o surface -std=c++11
-
-fill_inbetween: examples/fill_inbetween.cpp matplotlibcpp.h
-	cd examples && g++ fill_inbetween.cpp -I/usr/include/python2.7 -lpython2.7 -o fill_inbetween -std=c++11
-
-fill: examples/fill.cpp matplotlibcpp.h
-	cd examples && g++ fill.cpp -I/usr/include/python2.7 -lpython2.7 -o fill -std=c++11
-
-update: examples/update.cpp matplotlibcpp.h
-	cd examples && g++ update.cpp -I/usr/include/python2.7 -lpython2.7 -o update -std=c++11
-
-imshow: examples/imshow.cpp matplotlibcpp.h
-	cd examples && g++ imshow.cpp -I/usr/include/python2.7 -lpython2.7 -o imshow -std=c++11
+examples: $(EXECUTABLES)
 
 clean:
-	rm -f examples/{minimal,basic,modern,animation,nonblock,xkcd,quiver,bar,surface,fill_inbetween,fill,update,imshow}
+	rm -f ${EXECUTABLES}
diff --git a/numpy_flags.py b/numpy_flags.py
new file mode 100644
index 0000000..56fd95c
--- /dev/null
+++ b/numpy_flags.py
@@ -0,0 +1,12 @@
+from os import path
+
+try:
+    from numpy import __file__ as numpyloc
+
+    # Get numpy directory
+    numpy_dir = path.dirname(numpyloc)
+
+    # Print the result of joining this to core and include
+    print("-I" + path.join(numpy_dir, "core", "include"))
+except:
+    print("-DWITHOUT_NUMPY")

From 1c2a51f50b72e8b400f2353cd8cc512efae0df74 Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Sun, 28 Jul 2019 13:01:58 +0100
Subject: [PATCH 20/86] Add .gitignore file for example binaries

---
 examples/.gitignore | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 examples/.gitignore

diff --git a/examples/.gitignore b/examples/.gitignore
new file mode 100644
index 0000000..3da8ad6
--- /dev/null
+++ b/examples/.gitignore
@@ -0,0 +1,14 @@
+animation
+bar
+basic
+fill
+fill_inbetween
+imshow
+minimal
+modern
+nonblock
+quiver
+subplot
+surface
+update
+xkcd

From 6ec72daa6b5ba4e396bee3fdc562f89b9fda2744 Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Sun, 28 Jul 2019 13:30:09 +0100
Subject: [PATCH 21/86] Fix: Allow for building examples individually You don't
 necessarily want to build all of them. Now you can do, e.g.:     make
 examples/minimal

---
 Makefile | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Makefile b/Makefile
index a251d64..15c9f69 100644
--- a/Makefile
+++ b/Makefile
@@ -21,5 +21,8 @@ EXECUTABLES := $(foreach exec,$(basename $(SOURCES)),$(exec))
 
 examples: $(EXECUTABLES)
 
+$(EXECUTABLES): %: %.cpp
+	$(CXX) -o $@ $< $(CXXFLAGS) $(LDFLAGS)
+
 clean:
 	rm -f ${EXECUTABLES}

From 1ac91f7593630cfd76a400b8531986c9d7d6f6b4 Mon Sep 17 00:00:00 2001
From: Trevor Keller <trevor.keller@gmail.com>
Date: Sun, 12 May 2019 00:45:55 -0400
Subject: [PATCH 22/86] subplot2grid implementation and example

---
 examples/subplot2grid.cpp | 44 +++++++++++++++++++++++++++++++++++++++
 matplotlibcpp.h           | 33 ++++++++++++++++++++++++++++-
 2 files changed, 76 insertions(+), 1 deletion(-)
 create mode 100644 examples/subplot2grid.cpp

diff --git a/examples/subplot2grid.cpp b/examples/subplot2grid.cpp
new file mode 100644
index 0000000..f590e51
--- /dev/null
+++ b/examples/subplot2grid.cpp
@@ -0,0 +1,44 @@
+#define _USE_MATH_DEFINES
+#include <cmath>
+#include "../matplotlibcpp.h"
+
+using namespace std;
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    // Prepare data
+	int n = 500;
+	std::vector<double> x(n), u(n), v(n), w(n);
+	for(int i=0; i<n; ++i) {
+		x.at(i) = i;
+		u.at(i) = sin(2*M_PI*i/500.0);
+		v.at(i) = 100.0 / i;
+		w.at(i) = sin(2*M_PI*i/1000.0);
+	}
+
+    // Set the "super title"
+    plt::suptitle("My plot");
+
+    const long nrows=3, ncols=3;
+    long row = 2, col = 2;
+
+    plt::subplot2grid(nrows, ncols, row, col);
+	plt::plot(x, w, "g-");
+
+    long spanr = 1, spanc = 2;
+    col = 0;
+    plt::subplot2grid(nrows, ncols, row, col, spanr, spanc);
+	plt::plot(x, v, "r-");
+
+    spanr = 2, spanc = 3;
+    row = 0, col = 0;
+    plt::subplot2grid(nrows, ncols, row, col, spanr, spanc);
+    plt::plot(x, u, "b-");
+    // Add some text to the plot
+    plt::text(100., -0.5, "Hello!");
+
+
+    // Show plots
+	plt::show();
+}
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 93f19c8..82dbc6b 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -61,6 +61,7 @@ struct _interpreter {
     PyObject *s_python_function_imshow;
     PyObject *s_python_function_scatter;
     PyObject *s_python_function_subplot;
+    PyObject *s_python_function_subplot2grid;
     PyObject *s_python_function_legend;
     PyObject *s_python_function_xlim;
     PyObject *s_python_function_ion;
@@ -193,6 +194,7 @@ struct _interpreter {
         s_python_function_hist = safe_import(pymod,"hist");
         s_python_function_scatter = safe_import(pymod,"scatter");
         s_python_function_subplot = safe_import(pymod, "subplot");
+        s_python_function_subplot2grid = safe_import(pymod, "subplot2grid");
         s_python_function_legend = safe_import(pymod, "legend");
         s_python_function_ylim = safe_import(pymod, "ylim");
         s_python_function_title = safe_import(pymod, "title");
@@ -362,6 +364,9 @@ bool plot(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
     return res;
 }
 
+// TODO - it should be possible to make this work by implementing
+// a non-numpy alternative for `get_2darray()`.
+#ifndef WITHOUT_NUMPY
 template <typename Numeric>
 void plot_surface(const std::vector<::std::vector<Numeric>> &x,
                   const std::vector<::std::vector<Numeric>> &y,
@@ -453,6 +458,8 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
   Py_DECREF(kwargs);
   if (res) Py_DECREF(res);
 }
+#endif // WITHOUT_NUMPY
+
 
 template<typename Numeric>
 bool stem(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const std::map<std::string, std::string>& keywords)
@@ -1073,7 +1080,6 @@ bool named_loglog(const std::string& name, const std::vector<Numeric>& x, const
     PyTuple_SetItem(plot_args, 0, xarray);
     PyTuple_SetItem(plot_args, 1, yarray);
     PyTuple_SetItem(plot_args, 2, pystring);
-
     PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_loglog, plot_args, kwargs);
 
     Py_DECREF(kwargs);
@@ -1379,6 +1385,31 @@ inline void subplot(long nrows, long ncols, long plot_number)
     Py_DECREF(res);
 }
 
+void subplot2grid(long nrows, long ncols, long rowid=0, long colid=0, long rowspan=1, long colspan=1)
+{
+    PyObject* shape = PyTuple_New(2);
+    PyTuple_SetItem(shape, 0, PyLong_FromLong(nrows));
+    PyTuple_SetItem(shape, 1, PyLong_FromLong(ncols));
+
+    PyObject* loc = PyTuple_New(2);
+    PyTuple_SetItem(loc, 0, PyLong_FromLong(rowid));
+    PyTuple_SetItem(loc, 1, PyLong_FromLong(colid));
+
+    PyObject* args = PyTuple_New(4);
+    PyTuple_SetItem(args, 0, shape);
+    PyTuple_SetItem(args, 1, loc);
+    PyTuple_SetItem(args, 2, PyLong_FromLong(rowspan));
+    PyTuple_SetItem(args, 3, PyLong_FromLong(colspan));
+
+    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_subplot2grid, args);
+    if(!res) throw std::runtime_error("Call to subplot2grid() failed.");
+
+    Py_DECREF(shape);
+    Py_DECREF(loc);
+    Py_DECREF(args);
+    Py_DECREF(res);
+}
+
 inline void title(const std::string &titlestr, const std::map<std::string, std::string> &keywords = {})
 {
     PyObject* pytitlestr = PyString_FromString(titlestr.c_str());

From 5adfbe031e9a9a50b9f4f054aceba4cfd805fa52 Mon Sep 17 00:00:00 2001
From: Benno Evers <bennoe@apache.org>
Date: Fri, 25 Oct 2019 03:25:48 +0200
Subject: [PATCH 23/86] Rearrange Makefile.

---
 Makefile | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/Makefile b/Makefile
index 15c9f69..4faeb0e 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,3 @@
-
 # Use C++11
 CXXFLAGS += -std=c++11
 
@@ -10,19 +9,25 @@ CXXFLAGS       += $(PYTHON_INCLUDE)
 LDFLAGS        += $(shell $(PYTHON_CONFIG) --libs)
 
 # Either finds numpy or set -DWITHOUT_NUMPY
-CURRENT_DIR := $(abspath $(dir $(lastword $(MAKEFILE_LIST))))
-CXXFLAGS    += $(shell $(PYTHON_BIN) $(CURRENT_DIR)/numpy_flags.py)
+CXXFLAGS        += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)
+WITHOUT_NUMPY   := $(findstring $(CXXFLAGS), WITHOUT_NUMPY)
 
-# Assume every *.cpp file is a separate example
-SOURCES     ?= $(wildcard examples/*.cpp)
-EXECUTABLES := $(foreach exec,$(basename $(SOURCES)),$(exec))
+# Examples requiring numpy support to compile
+EXAMPLES_NUMPY  := surface
+EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar fill_inbetween fill update subplot2grid \
+                   $(if WITHOUT_NUMPY,,$(EXAMPLES_NUMPY))
+
+# Prefix every example with 'examples/build/'
+EXAMPLE_TARGETS := $(patsubst %,examples/build/%,$(EXAMPLES))
 
 .PHONY: examples
 
-examples: $(EXECUTABLES)
+examples: $(EXAMPLE_TARGETS)
 
-$(EXECUTABLES): %: %.cpp
+# Assume every *.cpp file is a separate example
+$(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp
+	mkdir -p examples/build
 	$(CXX) -o $@ $< $(CXXFLAGS) $(LDFLAGS)
 
 clean:
-	rm -f ${EXECUTABLES}
+	rm -f ${EXAMPLE_TARGETS}

From 97729fd2ccf71873479a32e6577e0e58554e00dd Mon Sep 17 00:00:00 2001
From: Matthieu Zins <zins.matthieu@gmail.com>
Date: Sun, 24 Nov 2019 22:06:49 +0100
Subject: [PATCH 24/86] Add possibility to pass additional parameters to
 scatter (like color or label)

---
 matplotlibcpp.h | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 82dbc6b..ac28937 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -659,7 +659,8 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
 template<typename NumericX, typename NumericY>
 bool scatter(const std::vector<NumericX>& x,
              const std::vector<NumericY>& y,
-             const double s=1.0) // The marker size in points**2
+             const double s=1.0, // The marker size in points**2
+             const std::unordered_map<std::string, std::string> & keywords = {})
 {
     assert(x.size() == y.size());
 
@@ -668,6 +669,10 @@ bool scatter(const std::vector<NumericX>& x,
 
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "s", PyLong_FromLong(s));
+    for (const auto& it : keywords)
+    {
+        PyDict_SetItemString(kwargs, it.first.c_str(), PyString_FromString(it.second.c_str()));
+    }
 
     PyObject* plot_args = PyTuple_New(2);
     PyTuple_SetItem(plot_args, 0, xarray);

From 6fb6a91568380614b7576587a4e19680b08e3fa2 Mon Sep 17 00:00:00 2001
From: Matthieu Zins <zins.matthieu@gmail.com>
Date: Wed, 27 Nov 2019 07:09:27 +0100
Subject: [PATCH 25/86] Fix multiple definition of subplot2grid

---
 matplotlibcpp.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index ac28937..8ae5b84 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1390,7 +1390,7 @@ inline void subplot(long nrows, long ncols, long plot_number)
     Py_DECREF(res);
 }
 
-void subplot2grid(long nrows, long ncols, long rowid=0, long colid=0, long rowspan=1, long colspan=1)
+inline void subplot2grid(long nrows, long ncols, long rowid=0, long colid=0, long rowspan=1, long colspan=1)
 {
     PyObject* shape = PyTuple_New(2);
     PyTuple_SetItem(shape, 0, PyLong_FromLong(nrows));

From 8297ae81a09cd48c02bf7615596663db7a3345dc Mon Sep 17 00:00:00 2001
From: belre9 <neopossam@gmail.com>
Date: Mon, 18 Nov 2019 18:43:13 +0900
Subject: [PATCH 26/86] Implemented wrapper corresponding to tick_params in
 matplotlib

---
 matplotlibcpp.h | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 8ae5b84..c4d5d14 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -73,6 +73,7 @@ struct _interpreter {
     PyObject *s_python_function_ylabel;
     PyObject *s_python_function_xticks;
     PyObject *s_python_function_yticks;
+    PyObject *s_python_function_tick_params;
     PyObject *s_python_function_grid;
     PyObject *s_python_function_clf;
     PyObject *s_python_function_errorbar;
@@ -203,6 +204,7 @@ struct _interpreter {
         s_python_function_ylabel = safe_import(pymod, "ylabel");
         s_python_function_xticks = safe_import(pymod, "xticks");
         s_python_function_yticks = safe_import(pymod, "yticks");
+    	s_python_function_tick_params = safe_import(pymod, "tick_params");
         s_python_function_grid = safe_import(pymod, "grid");
         s_python_function_xlim = safe_import(pymod, "xlim");
         s_python_function_ion = safe_import(pymod, "ion");
@@ -1375,6 +1377,30 @@ inline void yticks(const std::vector<Numeric> &ticks, const std::map<std::string
     yticks(ticks, {}, keywords);
 }
 
+inline void tick_params(const std::map<std::string, std::string>& keywords, const std::string axis = "both")
+{
+  // construct positional args
+  PyObject* args;
+  args = PyTuple_New(1);
+  PyTuple_SetItem(args, 0, PyString_FromString(axis.c_str()));
+  
+  // construct keyword args
+  PyObject* kwargs = PyDict_New();
+  for (std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+  {
+    PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+  }
+  
+  
+  PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_tick_params, args, kwargs);
+  
+  Py_DECREF(args);
+  Py_DECREF(kwargs);
+  if (!res) throw std::runtime_error("Call to tick_params() failed");
+  
+  Py_DECREF(res);
+}
+
 inline void subplot(long nrows, long ncols, long plot_number)
 {
     // construct positional args

From d68740570c7c04bbdbdf9960aa5fb36a76ef0c94 Mon Sep 17 00:00:00 2001
From: Marcus Davi <37623906+Marcus-Davi@users.noreply.github.com>
Date: Wed, 4 Dec 2019 00:37:19 -0300
Subject: [PATCH 27/86] Added #include "unordered_map" to main header

Simply following README.md steps produced an error where "unordered_map" types were not found; Fixed by simply including it on the main header file.
---
 matplotlibcpp.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index c4d5d14..477bf75 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -9,6 +9,7 @@
 #include <iostream>
 #include <cstdint> // <cstdint> requires c++11 support
 #include <functional>
+#include <unordered_map>
 
 #include <Python.h>
 

From 61da78fbbe4644a8a50fdbfe31a578b2a116ff3e Mon Sep 17 00:00:00 2001
From: Ilya Makarov <i.o.makarov@2gis.ru>
Date: Fri, 13 Dec 2019 02:28:20 +0700
Subject: [PATCH 28/86] Updated cmake readme section.

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 338bea7..3839169 100644
--- a/README.md
+++ b/README.md
@@ -211,6 +211,21 @@ matplotlib-cpp.
 
 If you prefer to use CMake as build system, you will want to add something like this to your
 CMakeLists.txt:
+
+**Recommended way(since CMake 3.12):**
+
+It's easy to use cmake official [docs](https://cmake.org/cmake/help/git-stage/module/FindPython2.html#module:FindPython2) to find Python 2(or 3) interpreter, compiler and development environment (include directories and libraries).
+
+NumPy is optional here, delete it from cmake script, if you don't need it.
+
+```cmake
+find_package(Python2 COMPONENTS Development NumPy)
+target_include_directories(myproject PRIVATE ${Python2_INCLUDE_DIRS} ${Python2_NumPy_INCLUDE_DIRS})
+target_link_libraries(myproject Python2::Python Python2::NumPy)
+```
+
+**Legacy way(unrecommended):**
+
 ```cmake
 find_package(PythonLibs 2.7)
 target_include_directories(myproject PRIVATE ${PYTHON_INCLUDE_DIRS})

From 7219c6187ffc967219953f04addce34c955649d4 Mon Sep 17 00:00:00 2001
From: Benno Evers <bennoe@apache.org>
Date: Fri, 20 Dec 2019 14:55:57 +0100
Subject: [PATCH 29/86] Updated wording in README.

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3839169..a82b675 100644
--- a/README.md
+++ b/README.md
@@ -212,7 +212,7 @@ matplotlib-cpp.
 If you prefer to use CMake as build system, you will want to add something like this to your
 CMakeLists.txt:
 
-**Recommended way(since CMake 3.12):**
+**Recommended way (since CMake 3.12):**
 
 It's easy to use cmake official [docs](https://cmake.org/cmake/help/git-stage/module/FindPython2.html#module:FindPython2) to find Python 2(or 3) interpreter, compiler and development environment (include directories and libraries).
 
@@ -224,7 +224,7 @@ target_include_directories(myproject PRIVATE ${Python2_INCLUDE_DIRS} ${Python2_N
 target_link_libraries(myproject Python2::Python Python2::NumPy)
 ```
 
-**Legacy way(unrecommended):**
+**Alternative way (for CMake <= 3.11):**
 
 ```cmake
 find_package(PythonLibs 2.7)

From f23347fca25219d1c42cbb91608b5556814bf572 Mon Sep 17 00:00:00 2001
From: Ilya Makarov <i.o.makarov@2gis.ru>
Date: Wed, 18 Dec 2019 00:46:56 +0700
Subject: [PATCH 30/86] Added information about backend renderer issue on MacOS

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index a82b675..72bab39 100644
--- a/README.md
+++ b/README.md
@@ -288,3 +288,6 @@ Todo/Issues/Wishlist
 
 * If you use Anaconda on Windows, you might need to set PYTHONHOME to Anaconda home directory and QT_QPA_PLATFORM_PLUGIN_PATH to %PYTHONHOME%Library/plugins/platforms. The latter is for especially when you get the error which says 'This application failed to start because it could not find or load the Qt platform plugin "windows"
 in "".'
+
+* MacOS: `Unable to import matplotlib.pyplot`. Cause: In mac os image rendering back end of matplotlib (what-is-a-backend to render using the API of Cocoa by default). There is Qt4Agg and GTKAgg and as a back-end is not the default. Set the back end of macosx that is differ compare with other windows or linux os.
+Solution is discribed [here](https://stackoverflow.com/questions/21784641/installation-issue-with-matplotlib-python?noredirect=1&lq=1), additional information can be found there too(see links in answers).

From f1af639c4271616d0ae35ae234f4511577c53f30 Mon Sep 17 00:00:00 2001
From: Trevor Keller <trevor.keller@gmail.com>
Date: Sun, 12 May 2019 02:08:12 -0400
Subject: [PATCH 31/86] implement colorbar; requires returned PyObject of
 mappable object

catch call without mappable object

stray {

add keywords (shrink is particularly useful)
---
 Makefile              |  3 ++-
 examples/colorbar.cpp | 32 ++++++++++++++++++++++++++++++++
 matplotlibcpp.h       | 41 +++++++++++++++++++++++++++++++++--------
 3 files changed, 67 insertions(+), 9 deletions(-)
 create mode 100644 examples/colorbar.cpp

diff --git a/Makefile b/Makefile
index 4faeb0e..418554c 100644
--- a/Makefile
+++ b/Makefile
@@ -14,7 +14,8 @@ WITHOUT_NUMPY   := $(findstring $(CXXFLAGS), WITHOUT_NUMPY)
 
 # Examples requiring numpy support to compile
 EXAMPLES_NUMPY  := surface
-EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar fill_inbetween fill update subplot2grid \
+EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar \
+	           fill_inbetween fill update subplot2grid colorbar \
                    $(if WITHOUT_NUMPY,,$(EXAMPLES_NUMPY))
 
 # Prefix every example with 'examples/build/'
diff --git a/examples/colorbar.cpp b/examples/colorbar.cpp
new file mode 100644
index 0000000..f53e01d
--- /dev/null
+++ b/examples/colorbar.cpp
@@ -0,0 +1,32 @@
+#define _USE_MATH_DEFINES
+#include <cmath>
+#include <iostream>
+#include "../matplotlibcpp.h"
+
+using namespace std;
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    // Prepare data
+    int ncols = 500, nrows = 300;
+    std::vector<float> z(ncols * nrows);
+    for (int j=0; j<nrows; ++j) {
+        for (int i=0; i<ncols; ++i) {
+            z.at(ncols * j + i) = std::sin(std::hypot(i - ncols/2, j - nrows/2));
+        }
+    }
+
+    const float* zptr = &(z[0]);
+    const int colors = 1;
+
+    plt::title("My matrix");
+    PyObject* mat;
+    plt::imshow(zptr, nrows, ncols, colors, {}, &mat);
+    plt::colorbar(mat);
+
+    // Show plots
+    plt::show();
+    plt::close();
+    Py_DECREF(mat);
+}
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 477bf75..595fc89 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -87,6 +87,7 @@ struct _interpreter {
     PyObject *s_python_function_text;
     PyObject *s_python_function_suptitle;
     PyObject *s_python_function_bar;
+    PyObject *s_python_function_colorbar;
     PyObject *s_python_function_subplots_adjust;
 
 
@@ -205,7 +206,7 @@ struct _interpreter {
         s_python_function_ylabel = safe_import(pymod, "ylabel");
         s_python_function_xticks = safe_import(pymod, "xticks");
         s_python_function_yticks = safe_import(pymod, "yticks");
-    	s_python_function_tick_params = safe_import(pymod, "tick_params");
+        s_python_function_tick_params = safe_import(pymod, "tick_params");
         s_python_function_grid = safe_import(pymod, "grid");
         s_python_function_xlim = safe_import(pymod, "xlim");
         s_python_function_ion = safe_import(pymod, "ion");
@@ -220,11 +221,11 @@ struct _interpreter {
         s_python_function_text = safe_import(pymod, "text");
         s_python_function_suptitle = safe_import(pymod, "suptitle");
         s_python_function_bar = safe_import(pymod,"bar");
+        s_python_function_colorbar = PyObject_GetAttrString(pymod, "colorbar");
         s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
 #ifndef WITHOUT_NUMPY
         s_python_function_imshow = safe_import(pymod, "imshow");
 #endif
-
         s_python_empty_tuple = PyTuple_New(0);
     }
 
@@ -589,7 +590,7 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
 
 #ifndef WITHOUT_NUMPY
     namespace internal {
-        inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords)
+        inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords, PyObject** out)
         {
             assert(type == NPY_UINT8 || type == NPY_FLOAT);
             assert(colors == 1 || colors == 3 || colors == 4);
@@ -613,18 +614,21 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
             Py_DECREF(kwargs);
             if (!res)
                 throw std::runtime_error("Call to imshow() failed");
-            Py_DECREF(res);
+            if (out)
+                *out = res;
+            else
+                Py_DECREF(res);
         }
     }
 
-    inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
     {
-        internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords);
+        internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords, out);
     }
 
-    inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {})
+    inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
     {
-        internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords);
+        internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords, out);
     }
 
 #ifdef WITH_OPENCV
@@ -1136,6 +1140,27 @@ void text(Numeric x, Numeric y, const std::string& s = "")
     Py_DECREF(res);
 }
 
+void colorbar(PyObject* mappable = NULL, const std::map<std::string, float>& keywords = {})
+{
+    if (mappable == NULL)
+        throw std::runtime_error("Must call colorbar with PyObject* returned from an image, contour, surface, etc.");
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, mappable);
+
+    PyObject* kwargs = PyDict_New();
+    for(std::map<std::string, float>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+    {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyFloat_FromDouble(it->second));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_colorbar, args, kwargs);
+    if(!res) throw std::runtime_error("Call to colorbar() failed.");
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+    Py_DECREF(res);
+}
+
 
 inline long figure(long number = -1)
 {

From de33a574574ac9d630f50f43f3a1bb02e8e14cfe Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 28 Mar 2020 01:07:53 +0100
Subject: [PATCH 32/86] Rename make variable CXXFLAGS -> EXTRA_FLAGS

Since CXXFLAGS is supposed to hold user-provided flags, the build
should not break when a user manually overrides these.
---
 Makefile | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/Makefile b/Makefile
index 418554c..7b791a5 100644
--- a/Makefile
+++ b/Makefile
@@ -1,15 +1,15 @@
-# Use C++11
-CXXFLAGS += -std=c++11
+# Use C++11, dont warn on long-to-float conversion
+CXXFLAGS += -std=c++11 -Wno-conversion
 
 # Default to using system's default version of python
 PYTHON_BIN     ?= python
 PYTHON_CONFIG  := $(PYTHON_BIN)-config
 PYTHON_INCLUDE ?= $(shell $(PYTHON_CONFIG) --includes)
-CXXFLAGS       += $(PYTHON_INCLUDE)
+EXTRA_FLAGS    := $(PYTHON_INCLUDE)
 LDFLAGS        += $(shell $(PYTHON_CONFIG) --libs)
 
 # Either finds numpy or set -DWITHOUT_NUMPY
-CXXFLAGS        += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)
+EXTRA_FLAGS     += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)
 WITHOUT_NUMPY   := $(findstring $(CXXFLAGS), WITHOUT_NUMPY)
 
 # Examples requiring numpy support to compile
@@ -28,7 +28,7 @@ examples: $(EXAMPLE_TARGETS)
 # Assume every *.cpp file is a separate example
 $(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp
 	mkdir -p examples/build
-	$(CXX) -o $@ $< $(CXXFLAGS) $(LDFLAGS)
+	$(CXX) -o $@ $< $(EXTRA_FLAGS) $(CXXFLAGS) $(LDFLAGS)
 
 clean:
 	rm -f ${EXAMPLE_TARGETS}

From d283d47d089a74b095dc314275013b17d860fc3d Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 28 Mar 2020 01:10:08 +0100
Subject: [PATCH 33/86] Remove indentation around 'imshow()' functions

The code had 1-2 extra levels of indentation.
---
 matplotlibcpp.h | 128 ++++++++++++++++++++++++------------------------
 1 file changed, 65 insertions(+), 63 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 595fc89..1c3adc3 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -589,77 +589,79 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
 }
 
 #ifndef WITHOUT_NUMPY
-    namespace internal {
-        inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords, PyObject** out)
-        {
-            assert(type == NPY_UINT8 || type == NPY_FLOAT);
-            assert(colors == 1 || colors == 3 || colors == 4);
-
-            detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
-
-            // construct args
-            npy_intp dims[3] = { rows, columns, colors };
-            PyObject *args = PyTuple_New(1);
-            PyTuple_SetItem(args, 0, PyArray_SimpleNewFromData(colors == 1 ? 2 : 3, dims, type, ptr));
-
-            // construct keyword args
-            PyObject* kwargs = PyDict_New();
-            for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
-            {
-                PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
-            }
-
-            PyObject *res = PyObject_Call(detail::_interpreter::get().s_python_function_imshow, args, kwargs);
-            Py_DECREF(args);
-            Py_DECREF(kwargs);
-            if (!res)
-                throw std::runtime_error("Call to imshow() failed");
-            if (out)
-                *out = res;
-            else
-                Py_DECREF(res);
-        }
-    }
+namespace internal {
 
-    inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
-    {
-        internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords, out);
-    }
+inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords, PyObject** out)
+{
+    assert(type == NPY_UINT8 || type == NPY_FLOAT);
+    assert(colors == 1 || colors == 3 || colors == 4);
+
+    detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
 
-    inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
+    // construct args
+    npy_intp dims[3] = { rows, columns, colors };
+    PyObject *args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, PyArray_SimpleNewFromData(colors == 1 ? 2 : 3, dims, type, ptr));
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
     {
-        internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords, out);
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
     }
 
-#ifdef WITH_OPENCV
-    void imshow(const cv::Mat &image, const std::map<std::string, std::string> &keywords = {})
-    {
-        // Convert underlying type of matrix, if needed
-        cv::Mat image2;
-        NPY_TYPES npy_type = NPY_UINT8;
-        switch (image.type() & CV_MAT_DEPTH_MASK) {
-        case CV_8U:
-            image2 = image;
-            break;
-        case CV_32F:
-            image2 = image;
-            npy_type = NPY_FLOAT;
-            break;
-        default:
-            image.convertTo(image2, CV_MAKETYPE(CV_8U, image.channels()));
-        }
+    PyObject *res = PyObject_Call(detail::_interpreter::get().s_python_function_imshow, args, kwargs);
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+    if (!res)
+        throw std::runtime_error("Call to imshow() failed");
+    if (out)
+        *out = res;
+    else
+        Py_DECREF(res);
+}
 
-        // If color image, convert from BGR to RGB
-        switch (image2.channels()) {
-        case 3:
-            cv::cvtColor(image2, image2, CV_BGR2RGB);
-            break;
-        case 4:
-            cv::cvtColor(image2, image2, CV_BGRA2RGBA);
-        }
+} // namespace internal
+
+inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
+{
+    internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords, out);
+}
 
-        internal::imshow(image2.data, npy_type, image2.rows, image2.cols, image2.channels(), keywords);
+inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
+{
+    internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords, out);
+}
+
+#ifdef WITH_OPENCV
+void imshow(const cv::Mat &image, const std::map<std::string, std::string> &keywords = {})
+{
+    // Convert underlying type of matrix, if needed
+    cv::Mat image2;
+    NPY_TYPES npy_type = NPY_UINT8;
+    switch (image.type() & CV_MAT_DEPTH_MASK) {
+    case CV_8U:
+        image2 = image;
+        break;
+    case CV_32F:
+        image2 = image;
+        npy_type = NPY_FLOAT;
+        break;
+    default:
+        image.convertTo(image2, CV_MAKETYPE(CV_8U, image.channels()));
     }
+
+    // If color image, convert from BGR to RGB
+    switch (image2.channels()) {
+    case 3:
+        cv::cvtColor(image2, image2, CV_BGR2RGB);
+        break;
+    case 4:
+        cv::cvtColor(image2, image2, CV_BGRA2RGBA);
+    }
+
+    internal::imshow(image2.data, npy_type, image2.rows, image2.cols, image2.channels(), keywords);
+}
 #endif // WITH_OPENCV
 #endif // WITHOUT_NUMPY
 

From 1809d7a261d086cc7ab52383f772fe04c437d1b0 Mon Sep 17 00:00:00 2001
From: Florian Eich <florian.eich@gmail.com>
Date: Sun, 5 Jan 2020 19:14:16 +0100
Subject: [PATCH 34/86] Adds axvline to function scope

---
 matplotlibcpp.h | 35 ++++++++++++++++++++++++++++++-----
 1 file changed, 30 insertions(+), 5 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 1c3adc3..fa9e58a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -70,6 +70,7 @@ struct _interpreter {
     PyObject *s_python_function_ylim;
     PyObject *s_python_function_title;
     PyObject *s_python_function_axis;
+    PyObject *s_python_function_axvline;
     PyObject *s_python_function_xlabel;
     PyObject *s_python_function_ylabel;
     PyObject *s_python_function_xticks;
@@ -202,6 +203,7 @@ struct _interpreter {
         s_python_function_ylim = safe_import(pymod, "ylim");
         s_python_function_title = safe_import(pymod, "title");
         s_python_function_axis = safe_import(pymod, "axis");
+        s_python_function_axvline = safe_import(pymod, "axvline");
         s_python_function_xlabel = safe_import(pymod, "xlabel");
         s_python_function_ylabel = safe_import(pymod, "ylabel");
         s_python_function_xticks = safe_import(pymod, "xticks");
@@ -1411,21 +1413,21 @@ inline void tick_params(const std::map<std::string, std::string>& keywords, cons
   PyObject* args;
   args = PyTuple_New(1);
   PyTuple_SetItem(args, 0, PyString_FromString(axis.c_str()));
-  
+
   // construct keyword args
   PyObject* kwargs = PyDict_New();
   for (std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
   {
     PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
   }
-  
-  
+
+
   PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_tick_params, args, kwargs);
-  
+
   Py_DECREF(args);
   Py_DECREF(kwargs);
   if (!res) throw std::runtime_error("Call to tick_params() failed");
-  
+
   Py_DECREF(res);
 }
 
@@ -1520,6 +1522,29 @@ inline void axis(const std::string &axisstr)
     Py_DECREF(res);
 }
 
+void axvline(double x, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
+{
+    // construct positional args
+    PyObject* args = PyTuple_New(3);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(x));
+    PyTuple_SetItem(args, 1, PyFloat_FromDouble(ymin));
+    PyTuple_SetItem(args, 2, PyFloat_FromDouble(ymax));
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+    {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axvline, args, kwargs);
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if(res) Py_DECREF(res);
+}
+
 inline void xlabel(const std::string &str, const std::map<std::string, std::string> &keywords = {})
 {
     PyObject* pystr = PyString_FromString(str.c_str());

From 52816e2f8b7cf237ecf88d22d26b16f223e74318 Mon Sep 17 00:00:00 2001
From: Florian Eich <florian.eich@gmail.com>
Date: Mon, 6 Jan 2020 23:40:56 +0100
Subject: [PATCH 35/86] Adds boxplot, get_strarray and get_listlist

---
 matplotlibcpp.h | 79 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index fa9e58a..1836c4b 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -61,6 +61,7 @@ struct _interpreter {
     PyObject *s_python_function_hist;
     PyObject *s_python_function_imshow;
     PyObject *s_python_function_scatter;
+    PyObject *s_python_function_boxplot;
     PyObject *s_python_function_subplot;
     PyObject *s_python_function_subplot2grid;
     PyObject *s_python_function_legend;
@@ -197,6 +198,7 @@ struct _interpreter {
         s_python_function_fill_between = safe_import(pymod, "fill_between");
         s_python_function_hist = safe_import(pymod,"hist");
         s_python_function_scatter = safe_import(pymod,"scatter");
+        s_python_function_boxplot = safe_import(pymod,"boxplot");
         s_python_function_subplot = safe_import(pymod, "subplot");
         s_python_function_subplot2grid = safe_import(pymod, "subplot2grid");
         s_python_function_legend = safe_import(pymod, "legend");
@@ -326,6 +328,27 @@ PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
     return reinterpret_cast<PyObject *>(varray);
 }
 
+// sometimes, for labels and such, we need string arrays
+PyObject * get_array(const std::vector<std::string>& strings)
+{
+  PyObject* list = PyList_New(strings.size());
+  for (std::size_t i = 0; i < strings.size(); ++i) {
+    PyList_SetItem(list, i, PyString_FromString(strings[i].c_str()));
+  }
+  return list;
+}
+
+// not all matplotlib need 2d arrays, some prefer lists of lists
+template<typename Numeric>
+PyObject* get_listlist(const std::vector<std::vector<Numeric>>& ll)
+{
+  PyObject* listlist = PyList_New(ll.size());
+  for (std::size_t i = 0; i < ll.size(); ++i) {
+    PyList_SetItem(listlist, i, get_array(ll[i]));
+  }
+  return listlist;
+}
+
 #else // fallback if we don't have numpy: copy every element of the given vector
 
 template<typename Numeric>
@@ -698,6 +721,62 @@ bool scatter(const std::vector<NumericX>& x,
     return res;
 }
 
+template<typename Numeric>
+bool boxplot(const std::vector<std::vector<Numeric>>& data,
+             const std::vector<std::string>& labels = {},
+             const std::unordered_map<std::string, std::string> & keywords = {})
+{
+    PyObject* listlist = get_listlist(data);
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, listlist);
+
+    PyObject* kwargs = PyDict_New();
+
+    // kwargs needs the labels, if there are (the correct number of) labels
+    if (!labels.empty() && labels.size() == data.size()) {
+        PyDict_SetItemString(kwargs, "labels", get_array(labels));
+    }
+
+    // take care of the remaining keywords
+    for (const auto& it : keywords)
+    {
+        PyDict_SetItemString(kwargs, it.first.c_str(), PyString_FromString(it.second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_boxplot, args, kwargs);
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if(res) Py_DECREF(res);
+
+    return res;
+}
+
+template<typename Numeric>
+bool boxplot(const std::vector<Numeric>& data,
+             const std::unordered_map<std::string, std::string> & keywords = {})
+{
+    PyObject* vector = get_array(data);
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, vector);
+
+    PyObject* kwargs = PyDict_New();
+    for (const auto& it : keywords)
+    {
+        PyDict_SetItemString(kwargs, it.first.c_str(), PyString_FromString(it.second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_boxplot, args, kwargs);
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if(res) Py_DECREF(res);
+
+    return res;
+}
+
 template <typename Numeric>
 bool bar(const std::vector<Numeric> &               x,
          const std::vector<Numeric> &               y,

From 9b23ca06b463a0d5b8c4dfdd3afd94cae5e8a4f3 Mon Sep 17 00:00:00 2001
From: Florian Eich <florian.eich@gmail.com>
Date: Mon, 6 Jan 2020 23:45:40 +0100
Subject: [PATCH 36/86] Adds vim tempfiles to gitignore

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index 7622be7..1c4a1b0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,3 +33,6 @@
 
 # Build
 /examples/build/*
+
+# vim temp files
+*.sw*

From 811ebfb2c9d96536480b38392e215ba4506c2f95 Mon Sep 17 00:00:00 2001
From: Brian Phung <brian.phung@utah.edu>
Date: Wed, 1 Jan 2020 12:12:21 -0700
Subject: [PATCH 37/86] Add 3D line plot and zlabel function.

---
 Makefile             |   2 +-
 examples/lines3d.cpp |  30 ++++++++++
 examples/lines3d.png | Bin 0 -> 76500 bytes
 matplotlibcpp.h      | 135 +++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 166 insertions(+), 1 deletion(-)
 create mode 100644 examples/lines3d.cpp
 create mode 100644 examples/lines3d.png

diff --git a/Makefile b/Makefile
index 7b791a5..a4a8a28 100644
--- a/Makefile
+++ b/Makefile
@@ -15,7 +15,7 @@ WITHOUT_NUMPY   := $(findstring $(CXXFLAGS), WITHOUT_NUMPY)
 # Examples requiring numpy support to compile
 EXAMPLES_NUMPY  := surface
 EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar \
-	           fill_inbetween fill update subplot2grid colorbar \
+	           fill_inbetween fill update subplot2grid colorbar lines3d \
                    $(if WITHOUT_NUMPY,,$(EXAMPLES_NUMPY))
 
 # Prefix every example with 'examples/build/'
diff --git a/examples/lines3d.cpp b/examples/lines3d.cpp
new file mode 100644
index 0000000..f3c201c
--- /dev/null
+++ b/examples/lines3d.cpp
@@ -0,0 +1,30 @@
+#include "../matplotlibcpp.h"
+
+#include <cmath>
+
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    std::vector<double> x, y, z;
+    double theta, r;
+    double z_inc = 4.0/99.0; double theta_inc = (8.0 * M_PI)/99.0;
+    
+    for (double i = 0; i < 100; i += 1) {
+        theta = -4.0 * M_PI + theta_inc*i;
+        z.push_back(-2.0 + z_inc*i);
+        r = z[i]*z[i] + 1;
+        x.push_back(r * sin(theta));
+        y.push_back(r * cos(theta));
+    }
+
+    std::map<std::string, std::string> keywords;
+    keywords.insert(std::pair<std::string, std::string>("label", "parametric curve") );
+
+    plt::plot3(x, y, z, keywords);
+    plt::xlabel("x label");
+    plt::ylabel("y label");
+    plt::set_zlabel("z label"); // set_zlabel rather than just zlabel, in accordance with the Axes3D method
+    plt::legend();
+    plt::show();
+}
diff --git a/examples/lines3d.png b/examples/lines3d.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a0c478a0a598d36abb24b2f1d458d65316a60e6
GIT binary patch
literal 76500
zcmeFZ1zVME*EPC8Bn6R{?vQSzK}u4(J4K|+0wkoQ1f`LXk_JIix}>DLm5`Pe!9ADH
z_q^}1kG+4wcOTpaEU$H4=XuUK#~fqK75+e75f_^r8-YOJ-dB>-LLg8B5D1hdOmz5;
z;PBjc_zlfN_P!1#{P!HwCJg?L<*H=pfk51}ME;LbAeH|RzA54<Z{VrzV&~~&>28a7
zZ0YIh<l^b{(2CaE*4^Wwi!(nLFBcC7t%Ikht0*`3|NflI#oeB}dMA_=fuKd)my^-)
zP1|mI;%RdH<nP~%7vs)5Z<vhVL_Kcgwy>tiKfg};D;Ga=fcquE;f2s+En1w%_aEL%
zjs317l7&J3CO+@JUu`hcLw{*nI?jYNa%-n+3+2}LbB4d{kq>;Ct2;dn{ZseFhvcDx
z$GYQ(CuZv#O5_9m>-;_n9*c+KLl;j30%<X6G2xd$+F$59S}p<q`O5=Rf&erbeE52T
zjwSu?$6?|@Xte*nC6^(C8vE~c^h2~LO2}8C#o5Oq82??ThhGUn@bBM#zs-oi`p>0r
z{NKy{-?jVy9F!xKCKNayR!`_LQAMKf36PuqEWr=Hk*<!>WOg%3p=!*y*YH1w=^-Ir
zC@&u$YV%_Am@!>gutABQj=p}og8<jDo;yJlEoPgR3-Y8HNbZZ@%pb){R}cO5%bhGr
zA>tGM-5^>_%+U6vq$Ftpa(NXMoKHp{eIrBYkq2DPD7f8nUp(gb@23VO6S)g`G98u`
z1{OSI-zFzRT}5tGO*f7if4!?jKnO3649vbG$91o4=sYXu-v8@i!o*j4;uvZ#Pi7OJ
zQgjg9`%iehyBif1<@<XxU%P%+>hGb{>c()+^gMptVJucKGJN=?@zLaRG&hdxUMNQ?
z<a~1wV7+t4=x0ff#YJ|CgjZIM8obGO+)zBKwre-V12Cw45uKf#tnBRVlg(FNN@Cd(
zfBzg#RX-xd#>Rf2s~a-pcTz=0Lqq!4Z+nW@L4dsRd@U9EV^wCtg%_u$o?c$dHM7q5
zY;Bpgy~Vuu7NR~c`We^wSz9xFx!iGCU3j(^GViQ-@7^`DXFGzbs;W!y>Y#b&?zMqb
zx3&J;(>v-J;^9FUH`}Z#GQWJGHvc`6xO8~l(LDxhRpxhG1P@@Pl98hrlU-X&)_gwT
zQtq~@kfh3dbbQ>I8}KBfn@~gi<=UDZe5=^3iG1;V(B}<x`+4b5bX4CDf-?W*w(D@$
zM<*xD^OG8WzX+2C?51}RODg8S37i`bx)P$V#ZmvuC}FQ}p`l#yd}cJ?tf{*E?0+G=
zas0IL@72ZG)oF7~e#TR5smo1`&gRf|%ja9hi*1TDFM`c4f9h{+ZnnlTD6Z_TFNe}}
zt;R@2*VG6(O;=twD<l0p=Z>@Bckwt)%AY#)CQVn#=Y@!?E5GTTjHf@@=3LuxMf|VC
zCC_^`Ry6(|X}Ik*ovvg&+ik7$SpPOR_xjmhlm2s)L@v{|<@QjwZYrOpmCnesAKd=o
zge>YyFEOYQh{j)E*$aw_+O1<GUd6@Tdj0x!*rW4HKk=)x)w4|v|A@Xs?wssw`dv5i
zUp)-IE8#5r8#yuA)z!q@U(V?7u(QWgH+z=751V>1?=d97%Ei^y$KA|f#zG#oviSFM
z(d~5JC*PAY>?l*=+rM*-79?|YbYwA*B536==%3Wy<?rip|77&{l%+vbVXpa2D$(GB
z12>Z|&kbKET<$DhahmyGdVQ*?VQw4<rSS`scy`jVdeGwhd3CD7`fRFO@)dFcYj<j9
z*GyeT^VH5(NSj$B61ut+C`DWmQh(2fP!KseIR&MqT{$t55#7|!ZXjHLA3fZjZy;r0
zU?}+bv90NJ0VlFEkmm1M_sV64h#RW#f-l2!Nt%8;esT(mgSTbRubZEL)$iD%lz2)6
zk3+*{QX5cW{5c|#=B_&$S0YaH@A0yw1K$T`X3;c%mN3q$q%Nwi$1KWD+IQR8*`Y&h
zAlB#uW<R?qYG~YqOUCbR^_gGs`Tf0ET=i+bph7IcrnVtBc6eAbAtB*|C*=pmr|AUx
zS(wP=9H(#Me|cQl%k=DYH)M2^$e#Q?oQ2Qx-W25I<PRP^2)GxDhazpl=rUPqTDkZ_
zl7`yv%+hJD_7=Qx`RtB^i%U$y{5wwLj`xP&oetLq+!8B39Zpx-yB%$4PVIOfZ0#?%
zFFm1_kdQc()XN!WHRgT?$1hlx?)jfpn)j!EB+o8APrTs4kxNcSO^uFd+;79F{qfHD
zftD63ZPluDNBk^t5$tY9WsB9ftmBGym6{r@v*(g?o}+5Dn|Z1Ge-4Lo8XGAuFE2%&
zpYgOUmv7e#rK+7=EdCi-TpAEw?1<Np42K9b;2@dvnlyF$%ujY>Wk@xQx&HO~lY<NM
zKb_{taMPOe(=RiV*jueI;5dxltb$(`B<HvI8A1i>$in5cW+pQvo_!k|3pW3=LW(>I
zVfyATh=(LEiqB3}qp#h%`42MCTMLk@eSJ8UyLPlW>el@E(<kZt(X6H>s`&W$vt6I&
zNJzSfFn$}x)p?)APKe9>LX8*Lh^6DF@~iilx2GzuC32f9czAe>Y(XOD4NS)4<m4<j
z;5eJ#^Gnpi_RZQ#Oia9nP*70l=$Q|}A=O$KvX{CrL@pY{S&&{)CyUhi{R5XmN(_20
z*6XUsWJ-MP+BM&etk5M_k^K=B?&W0rjMl{FKeh;uIL4geF#C)r==1aQzL&?72PG~q
z*mEx)J3Du=mo*0Bka8`-!EQso18+nkmifiZr0dTywmJX5m$k0TsA=jf$N&;QTMAn7
zg0tuL=gjQ}F0Q4!JKv8Bq11u1naMA&Ah5`WBu**o>+6xR@n_p!%6RNJH8oY!+&sqR
z`6|W6#zqT;OXExb-}(N^Po#VnUkDGTi-qnzUl*(0Ds8Z-e)jKS{!<g5bV5W$O49~F
ztS(($>~#m-lng`G84MoMR?(+NtXHd2SJx<nojc(0n~I-*k7t|T)7Fp(dGm%~d-n6q
z&kIl4@n|GpQ;B)oG%j))*DR&`EW8}u?09(%qx{8%xA^Z3WIU6U9Zp%tWPScjs-~u9
zMZ~2`{o+XT&$#&|@zpZT6$*urQ%k<o<wL{SRL@cu9x~*zA~)IivvVgh-@Eu<%(Cs}
z=H^~+@Y(C?j3kvmbrJ1;sYK<DLWq`yU2N#gLl&%%^U|y=RIiA*d96sB-aYcicB#1M
z27b-s*>}IjZdjdHrkUqEmWyKxL4~j3S?+eD^vzIYBzOshJwz5k8zGgh&JrP;uCAC3
zxRgE;2}SAIF#{19>+;JO(v+tidBjj}{p9IyLAlpFx}Os)ny$`_eV+_~s?9%uOT?7C
zKk6U=@tO4ilR5r=BZpppXN0VG@=-l`6uMnivR04W45gU2Q{iW6{JSW~15Ol#)$AaE
zErV~<*8ju3b=lPdl8{jeiFX6l_3PJHd{PI{)72Aoh${CWF_Mv!x548e9$+T};Nksu
zht>pGQWN+S>xZqIo>o>?sJOVeQ=c9Zwk`8CnsLKdS9kaD{Ct!WBWlt39l{W}u0jqk
z7iaOX0|1mYH98gTZdH7(e;33<;%g3a05r?phmFNu+(g(}MMXG4K|uwDg{`om7JSM0
zc%ha&WEP)iZBGfYLm<qS4}6!r8+Zi-f-QJ3At4clWIbTzs-|pUDP*<DBlI>c(Zgvn
z<0cFt;xwTglMC#z-8jB0g{;6zsRs6CI%jT_p<lj8diwa}eELLmak4|$X;vw0qc>_V
zlv?39e&@hFdR0!dC+`lVD9pfsD*K_X+}L>evkz=GH7@84Q949g*iZbXrudo{-=DDZ
z20p-PUc4zSX%|zAeT)J-Xq(g;BtMR*YqfT8z)Vk1=SdwfX!es(R#91X9$L%h(lY^k
zmDSKd0l)FNL5?8Ii(P+qn5cj=ov4r_LyIrXLnbFLFK>dKoLh644n?=tgiA+9r^T`Q
zjRCVex(xo(=>@N(Wc134l_OC)S_Jeh6|{$UpIw(}IXe@f#KS<7X?cZ9@xah9Sx}}0
zE%`{z6dw%=t0sQE3D=DqH)x5lTb+d3oj>=<WlcL}OonV9KSeI*n>TN2iQJt`E%{cz
zD(8Rvh>ciFCzHWfx$ovyaVE;NLI+J#N8^W;?c?+34vvnpFJ3g=xm7vU5dv}0X$4<#
zQLPbj^p&j39UW+Y{G>cZP1A6u9jm`;^>A=<n8u8YSDpw+U**LLlH-0XD$>-{q!Xh?
zi^Czifxh8cpSz%-jzpkg!5rVWcOavD|IP>*slsDjU6aF>g2YSpdQfWsBmpRaVTtlN
zny@{?A>!iVH_9e)GS)4trlHu;VoSj0P4XHW-*L??Ty+)UP{4lqo$LGCcd~XdF|=Vn
zu8+fN(J@R+_o1oK+q*!THsTjb=GVWIFk<`kDLEAtRqfU9EmE%wn+t3-RI5*}j*iL#
zsZe+fvFkE3r6*FDhhN-pp0Z7lWyYjW%tTgTM5(9^1_p*ERJ)wvq;J#4dV0(rCtTxZ
zZ{>1^Vbj_itFyDSQ6UZ>i%(VBMskFR3kjh&FLKvZ#O1|ulBg(i*}RjDmZRU;-R**n
zvtj!_l@S63b2<Q8*Y9^L1{WqK^tNZJaqOyYiw{}5x<2qc*`2H7ADk`{+WZi}-{~Nb
z{ppj=Nm9;mL6YRj(<U-X%HYYZ>j>Tuj>l^893lN~ln|8_ZmV65>U4x?6#@{*Vd6~5
zRr*Eaf$L9n)0_H`y$9epB4Xn3#EKe14kMAfcf&I>sNL%CXA|+^n``&%KKi0CfqZUR
zEXd??8Lb`ieD>UtsIO${-~xr&c4$1h0_3<(LKN@?$PdM2=Sj~<H-J<?QkZC{JmgX3
zMkV-YDAv~2R@hIzObE2-TH|@lcZt4Z3sJ?F`}pss=!xxJL@2vH>K3`qdrcOuZL47j
z%0&@80*DO&JV`Y#cvLMfKY!W1?%U$x&G$nr5j|5xe3APoVIH$x^|86gOci$C)8yj=
zsZMcb0xecC+A6(?B=Y+B`1oD6E3!Hg6jf-{Vjy}T_Kr?ZtxtF7m!6otlclDiQPkH@
z6q%QE6sefqsU-R(TNOJyGh<P0q^YfakIg2KR?hvDDuXuc^?iY=#21i978c9^uJ)ug
zv8bo@Jban^?t$hZnFG9juA=vPAT2~%c($vzHwk1kO!Oe0WK}n=?>3`qBGJ&?ecSZ>
zx0=DQ$;Hwi+G4P7d&|ano$St3t4y#aCrej0HFritniQj$+`y4Qk5af+H4U8|hYDTQ
zCbL$1_|Q6`yp0p~-3e)ehEPwfo)J$08T>v9NU0Tp1`c+6Q&VK3qM~bFCtMgW-)>#>
zF^2=x66aPIKJXPMqoP7$MT#dFK{Bwiyk8x7$PgbONZMjedeAB=k^BfdViQYD?+oQv
za?`-T0ALdpNAz!w)pt3|_1=7Y@UsFQv!YYg%S$kzZc>hitRq(?5fVHPKYtK3Ab<~(
z2G(jFvU+WdKH(UO-ZU(m)P}8jhXRS%DmlJqx=+0^GI_dhq@zxi3ujEH_rw|+F~CXL
zICV8OBnU|Rwrt-4>z`fvL3R+)gtxOT%eP^($yj$=>A-TDt-%#a#cdfUs?_;cP24e%
zPp)ct3t8Q0>#9D(RWR@<m7dsf%Omvl65^8m$$Ilrm9%@>+uQe_Ho-v@O6433>6esK
z$_WXi4O1XcrX!TwMdqM)w?~)<3q_xe(xu*#j$Y*v5y33ci)?F?<!wvgs^fStN~bRu
zqn>}y(vl7v2dA?SO-7m)AD_ZdLro2dIF?<>NFtfIjCy|JYOB$8M|Z1?Rq^OY-;^nq
zgUIRNqtjGL)JbpJjE%y~q{W098#uZdJnRsxSA^UY230LO%g?i`T2Wf>g6=aV8WgV@
z{Wp<BjH)4e@=|%)!x#535YYEz7ZfPHlYNIRyLtFE;~s2aoD+I(EEatOGMFes(`lzw
z4VE1L^LCk@Xs+(=1bCs>D7%+a9+k>Kfnc>T4DMY$u&}a{O?%I-CdQ}9>Q(wtrba%`
zh+ZiEome<TEwt|U;HAEXj0CL>dtV|eEBT<B+`z+Y+d4)KaKhueFue19#ETBj(!p^{
zb_ks6up?x#xcl`vr)j`ZTGM8x4%)ZXgUp<qYyABDP&?Xwju&N(Zrb3DOkrv}9a<;$
zg}i);GF<nSoVsc&SvBwVX<b4AolycwK)6L&!_174X2GF2w+dZMOiT_`&NwAT=lc6H
zGOdB5Y5{ddou`ZbG=S4ybz0pj(||ZtqJgsz7sR@=trn`v5CGT+>M*P`lq?A$mj#ZD
zIc-BR!$WHlwzTy0>xjnFg=g@bZkyJTot2C%SFGH$Wa0Gq%gZ+vZ-w>0IB#z}^N{{k
z)ko3N5*F~;1P_h=U@~0pNfNH8!3|M^*E4l{uh<u(Jfw`7q>OLWvrkT%)j931Psawh
zt0TBEzu9fp^1Ni0*aeUUZH?#ks;&FlJ<gvg;2c6)Jd{k__DlXIKptf!dRHi<AB`LK
z&&m&(V)0so7khdznVFegcd92NSejH}Da)rYEr1YmapA6SXh7l>WS3tV@6QZnbhwTj
zJA?-k_caW>mc7%+wsJU)lJ8v>yqUxILqu-W2a+Y@wo<Gu-BjegyV})*7JAw!p)Y5s
zL-bI;lgj_cue$g5=IG@Q_YKe$nRP`Go-M_bU(r_69LBoB`irEDt<iog2zHhyuV_$=
zU>-mJPfo57#0^>%F?^H)pvt$&Y&xtlFc6jZC(EUD!hMEE5L4$j0C)DFKo%Z$Ao6QA
z=e2hc{Xl_2goXkuklkv%KA2uf!Vtb|j^!yz6%i5fKu3qstc%&I9CLJkpJ$Gm+b$5b
zk(^(=5sOPbw2+qP=MSFm*p@Ri_rEAjO3z%3Al&1K8ET95JKo}H*5<R6`#rXv^Wsq8
zydk<{BFEd`P7_X?{ydEbS1ucqx$)0WkK5mU(e6_7Ka~1-*Y6^+fe^bz?pBNEx2<EK
zClmnd_}(5m%x*b_GD<~7yoEiKE=J1oOFP|JmdhqE3CSjN(DkM@iKgSh<3P{4@$+Y3
zr&VvybSmCvty6wp9&~Aty(*mNMS<+&_8sZ}^o3{mvLT4_m5I!adQ`GBEURzC9hvOG
zt;wvf?5mf2QKZkl>WhakbAH58W33^#6x_`E!4QV_+`!b>i)r9ac-Vag+cz6Y#}Q%t
zo7#kUaCAty)h++x7V(Qx<GB4idN?Ln98z5_!iD=nmq%GHPr#On@W&?>e1GXRRGwQS
z8#D~iFMsciH>k411?IwpixeFL<JJvyOTOe4tsc9oC#{>zBSyxXGm`Ibl0?eCriM&y
z@DQ0nm@Me*%Vu|8O>V(~E2AG=@PrEB#(CH3;AxYq2xU@6hJv;>ArK8~kLTa8#j(a{
z`d|i?(*9;{5}D8MbTNC}9{XsQ&nGtZ^yFy?x>u*&7)h$8zLkP$#cg6CD&-^1DM32S
z<vJy8*6%N;onH0Y$kNhUw7;@SmXWzX=8p16klY|jG+{cy|Hh4nQeU0gq79!sxqIi%
zosK?+xUhdvCn+s0;q5gg`K$pul_c4B6GYg7h|u<z_4T5>x@v4TR=G&hU&n^dey_j(
z24G`oP>!BToa`-@g;fbtt*M{@+ve%*ZRP5U@8#ts;=7+ouWllP&qJ|PD!2PVv$3vh
zc$zkwuj#|}SNS%lnvVRLrBly;^wDEC{U+f5y2HHj3Fm!gvW%sZld8ZhBOfb|uzMcM
zi)xb=$KtFm>o}p*cUC-Pz=S}1$8rY)>dw*=$$z;^X3mokU@NpXJY-tRbX9Du97alP
zHuRIo%y}m+y6SUbAy!FA$;U`3+6pX2@~G^xvYXK5v$C=E*5VCQE$t7NW7uQZx%st3
z4PwzWW}W9mGdGb`!x|HjXB}%;4|P==nA#CCJkzsYyQMU-s*aE5D^6|VGw+ox^D<d2
zFE4MUpLsh{P;!uI4BvkHIPLL>p<>Z^#8BkX$xCTzfizVOjhyCY^9j2!iG0fL@JG3C
zWbx30Dyt1Y0Z5Q5m4$_^RHa{L@j9t|$5vfkZ6!DG!`=2V<*cj{LqH&{g^djw;Au##
zQ(s;*6r;F)d_9QnmbVzf|AH%RGySDUTjKsxV(%OdHTJ0QC6yFeO;!<i{r-sHZGR-e
z`CE0LFDP)Vntb-m;0~jcka645nfqh3CY?u!1COXt`I%>0DYAH>?EuoC=aJ3A=Q6Di
zh5|k9@zoKPRGE&&gN|PYmeZ;bxtxZwKeugJdgS<@>6aK0lWLASR;w^04AEQx@<Tan
zwZPw+D7gnjfier54E{HX&F<tcx6?K~mYte$?v+~19h0kYPHCD4Qx)M<6xJi)94F!8
zC?2>k%k|pb?j9U`Ta$bHA9y6q9(HI;U?_Jdmnlj|)gy=YwC1)|<Kdu~!Dr`m){|U%
zDQ~T)0lP>QI+bwZ5UnI74o=QoBEGCU0E=WT3GP12^^%7+VPktcc-&F#=eDUb3Q$)_
zP!%4IRczWo0!`x~xj4Nh^<xHV&F%CZA4}%E>Il7SP6b>orQ@AbX8K{Af<g(THWTeU
zlWQoC1js86+;nw`1L`EugJgK?1tcV*AW;LM0B~B4{uc1o5wi3Yc7!#bo!&gO;Y#-!
zyAui6C?q7rEvop^ubJ#JJuQu>o79Nood_vkQA|2_h&WUjDAxeN)czP}6IBWrDd8(i
z!*L*zz4M18WxC<vC^Iyyj4${#I>U<u01la&nr`gvh4$JgJMQm?=A1dWlGtCEh>Y&F
zg`gxBPg3&emwm1-#cUvtsPOROtr;f`=adtPj<23mA{A5*P%g;=@&E*m3IkwKxy-2l
zsVekB;?%cq$0e(M;E&}OOfCL^nVC}kD!e04=X=#b2*PF+$8bm%TJxM?vUOQIuk3B#
z1M!<c47}rKRHjoI9RQe;5D3}aM(N|A8T9hM`pr&!1nH^8hjJj&;Es`O^-T36Xf@;x
zgm-XO=ic@#BukPSDT?d={%M-qlieLX?qTJke~(v4m$a=wqtPW-UFTnW0h}D1MPT<$
zp6yg4)`EEn@u_1l2nh-IFD?Q0^T{NYPRntUmXo)smMAfZ*%j6ZS&gcFIIf`V?ltLw
znzDbs=4hT9_-*gBFWU4Yo6SQ*th(6nPUISsgn!~hi=4Q>*a*)8{2en3ONHG4xqy&R
zo_JMax^E>L0*HW(4ORgEnUh-;k7tDv-o9N<%OPb!mpwaHq8L1C`1ZD?TvOMfo?xE6
zwe*#hK;mqsTGl`WLGg$9l%tA`<KMM<%)<^k%=84Xx?T?9X6%k~>v~4mNtaUgmG8{T
zG(-wt<;EJO!!hOX&FJ17&0p2(DQ2{wBjxK8=Sez?kC27BUxBP3@;v4$i8fF;Vigco
zt&oFfW@n-F43CVUey+j)`>Pdm!P%v~$7$nh^{b98;kUEpkGy!jh5F^s93wezmz2rr
z+?kClF{$-WS0}X>3Mak=tQ5TMYyMQ8TNQ7#S{$*YPyF+bj7Bz@i`72?dGt~mp{uLA
z?<?-wFpq?MJY=u8q#k~r1%b>aFjgLMd&I#~gz}w)Fhu>+CTi~n3Fq%rSnYq1h5Z9c
z<XMHr?4}4He`8cweR#8Lux+eGhEV{<_Ws&omN4wBczGISW=TihOZ{11l|?4@Gg9;8
z5)oFeLM!Jw5sx)5%e)+YV6s}$HA6=slz_oObzm$y<liO84$O!P&JGkDC%sl+&?_-w
zQl~=s&V=H0Cl*?{_kXAK?%^DB04jR%;stO<4h{~PM108Vr6q#}h)HSB7>hm*6G+%^
zvy(Ayk8evRnS@y9qu;9IGi%QrUAj4uxT-z-v7)QXvbGuH;-o~|X2(gIh54>lRrsf7
zQ&yt3-gp*EXrkhBr|Rl}>Vs}HQnHkt^LlaKtO$7&bFrYR4nYev7n-b5S4JfhwGMRr
z?>f|lhqsO)RFI9!b4CKcib1o`b`%7T=rb!NnUVi`0Y>G+^>`p~nwx1@xV={9USs8V
zt0wIahWRfVm<EW|=&t%dE|d-T;<_UsDfz{Q(_zH2P7yIaCB-g*B)!KSue%CXc4Vvc
zJGE&AjU2gsw2Ob6gsP{F$Rm$a6PlNsaqRiwZfRj5o#ssMMF%C@@I&ki4Z)E9;3Y`^
zgYTtc#CB_g(3bgL!7eh=##QP6-t^&xQ`akpzzz(^cxl<_S$T~`(buycVNqIBHs#n-
zl3L`tenJj;Gpylpwx+9c+u`$(0>zI!C>fk%qJ^CD3>zW+%+xW8p2dy=DNjbDdMA2F
z98;vn2m-{1?Ef^!7K}e&B#6t6WnpISSoeMYTzpVBLm4}{E_NvGZV-|duZ6Tv+T>!j
zi7Y_`AKLata#ae-$`my<<B&+o@HOK56O_LmPY~Q`Kf6L1DBJX%OUDry#(K-qJL6|l
z^}jxF8X;Iyp1uQ}`BiA>@bK`<2ds>F#UIQIsZ}CGKcEx#;!u^H_cM<yc&q0ViVwBh
zRrO{FSEG$86Q)T2B67_myYZ@alR01Gy@Hw=F2Ejf>YH$(<>RNeLxno~EUC^b@JCH0
zt0%}>UW&i94Q-M<2(8eJAn)+LA_A`=@a**F#s1fGy4UBW3w8r{*mvj5f@W*<a<XZw
zFYOpmMW8kz1)+A!PoF-8T@G1k>p7(a9<fh1nk%E^tLNDfz5>1*xU_mVXg-^onn2Ws
z99aAOypkiT_^8-UP`hOs-!}Y#*o*-Xc#&6KlKEQK;($%ejUBM#FV<rhryk12b=IQx
z|Ko;KBSEnW?X+tB^5SB@gHXfb^7rxK!tRem^M49nX(^Y0py0CD;yIq=aiNB7<NN0j
z*m0+fj+<?crVu}nF`qtr#_xTS*C#tF9T>;D;QYSDKaHy6LV}Cut|kA^{oVoHTI*+m
zHRHs&FMjFsp|W~WRaLmR%rV{oKHEd$Rl6ncbv8i`pf^M`YqjVD96#A>x>Er?Q#6hZ
zui#GwX4(4bQ_;d{IV1g~!f6|(3B*S>A?r!yleEgeioi2bP_$PKNk)Q@c<uQ3I7}hO
z_n?y$nW&3Fe$Y&g^;vj=0WGZ*h~2o+tNW+^e@~G**|(XQI~1)fKgJ5R&yMn?qFi2V
z8J~^iONJn2EdO6D{((r<wtlNr<=IVS&qePNC*&3_=nF;xCB{J5Barjtp@V$GO2C4N
z%7t5Z@ax>N(e2@ljBmQ@3#GqN{~YX&i!^4TlB}+1uqw+T?ndA9@ezjQ(lj-VLbjAn
z8L5}4s$=9)3Q$sd^VrHonNK<u@=&A|6+@?Hf(M3mwH|PuVlredSi=@0iSH`AC?s!i
zD@VC_w;v<}3!aX<v4$=UArFe?``tgHsD?TSq*OjoIr>`*pyBx%|NB<Zi9;hvxmS=P
z7YHwOn5erAdy;?lL#0$7N&P)G|I2i7Ic@(Q81n0b84{78?1T6_sv#An@qC5Q_j{Zo
z0udwr3v=PgI+gh4(WvicZsLfM)FK4ocPij??q%Tv`CRdEG><7<<i2)`rddnh`m2Mv
zi%ZvN^YngAJM=3DkL$Y&ldpek713|m5g;4Yd-v|Silzg7S-V@mWfPA-b(yc6Ey@g=
z1NMWg%uIw|GY!z1D|5QJ>l=22)e4_be#((sUypCKP;wB88|>c!^fS5j_PEA+$dtY+
z+{o(w4rZp2=74I9xr_`79?05%{|x=@V39n)0*zP-EFVZJNGi#;4N5Gc=W5aVuGdeZ
zFCZm<<q`vtG{f)r=IhBJVMxnQuJQW<kUQuQd0*uNAtsdixEBpg1;w1&dzHq2G+O1J
zGa^6+$I1NqTwN93-$y<;N7(Q2Nhwg$Qc`4}Jrfg&ZU@r2<9Dx|jl1gcQ;APToWS17
zkD_+FRXS)_PB3rErRovX@nNgyk1|okbY+MY^2!+b>pggYh+eHUd)9aIDdFL?Q^~at
zl8e5QkYavrZFOEWtff5S`=TL(zyIytP0PPmmn+Y=<z7ceXIEBgc^g8GQBYLmU%2-L
z3Y@_KL??k*)n_QS+S=ND_GNuPj7I!?TMN*K8ifNVjb>YL0_4kDX(r?kHs^~f&QsQk
z>taTu5Wg?|K<-dgSI>r431lcksjSYLmr$?%r;&g3c*VP+bAlO2Xwh^ob)vkPJuZqE
zhSY-FC??zFT2=SGysCZuq1$;)qz;$K&&P;ULPHNi0hZ#Of>|k`;t6-60Of`N8s8-p
zlSbcL!1EgH*N4xHeV+{#WdfSC*g-3O+E`zobbWh#)AKNer!s^V^K7Wk`fQE&rb$*E
z;n|=r>Xnto?GvXubP^Ri4`0&2^fQvD+EM@beg$)L8b?P*9XADjttcTT$H(+LKEgmZ
zmQAv6`RGGFJQ43>cFYSHH&DFa$|%TO?hpf)2a5$LV-`ZGfK7p%WaY=c|Gr(-QFh$v
zQH~wjgZxo8`h-TavhBZjw5gx(%QS+dAp)J%&!0cnnw$Y0nS64Adc}1|i38GvmHeCj
zX`KFCoM%s;%GvMX3eUxUbE}EP5vDj&KR+lDo^i{5M2>jiOyaso!oEA>|Ja1nv?g|N
zM$NMlbVp#ek<AMDZH_0+%Qkvxbx9bU3DmTd5(1BW#o-0^gK2T{*o5P`Klu9SP?PR(
zIGV#_5n_$J>W1Q4jAd&__|Vky<EFphd>2B8zlN1bK!Q4k{_kNR?NTcSO-E7Lmk8_b
z=w4O1-l+y3?yHODzs7nPXA{OQmWy9r+}>kZMD7ABiTerP@|&;yW}suZiWGnSaxae6
z&prF5lppZ1tT&rTL`+zg_-Fen9$o0^j#6yfBy2DuC61F5?|t#IvyBGN2krz)*+k!u
zjs%R1jWzZ4F=DzI9tBdSO4dv}MM_qbCJ^mwrSKEn4*6h57}FgDP1LXx0R>xvdTWwP
zx>Kf&kvE-4bl+VR-@liqtDU6g9goVIULmQlN`2^s>_m5)PR+(9CRPr*X)qAa&-=`~
zT7xhSpoAd}OYO)PgRx00cZ`=V6pglm-k@h%OjI-?IvNi$WI{-!dcJlp`hHU>+w()=
zosHBCkKxCxDAZTJ*Rb(T2uRtDHGWTlxdYHOFF!xS#5rfal0kj>qz1HpA3uIX^lXh7
z7{^0(1Wl^8m(082MQi+yvIolgNN}``9pSqxpu4iC<?zv_5A8qC-ilJtWwW<Hb-gPO
z%|t-=swN}DK@QC&Cc<^&8{PB|@Jw(-Q{F{IKvS1U_5Q`h$uep4+4V11$7QR-iZt@T
z3HiYTYTay+hnB@);=|8vTr^Y%XJ>`Sj~{<^shKWCq4WsdpBEO}pIwYWL15#eekr#n
zzB>BG44Mqk+FapS@<!L7^ZhnGjchgDP?bLhZB^Z`u}5Js=GQbe;vplF&l)R^RU)$M
ztF8L>r7Fq@l_%b)U2gNQT=tiS24jI#G*p!7!$jPwa4oMVI9Z<923UkjcmB3_M^i;M
zY?n6dwwe0OzdiVUjt3!NSZM$d+olMe=PQoyauAC6Wdqk)o2CQp(#=$kvj*eOnc3eR
zjcj?V0^SBtwZjd8IV`KZ93MP41BKJ?>sHP{g$MBhzE+5?%i!Z<hsbHtQI#;I`%{L?
zReovy;fQ));p2{-7L#rj7KJWrx^nwSPqG~LxRXe_I^o7SxIEklG5-m3?}+=;ll!MB
zph+4Ze>(=W;&d3oj54KD>Z+cqgn=5-GDFXKbr8ShcKLgzcFVEaNLNml1KcTyfUGP!
zr-jDbKYskU%TW8_`_B(}|5c4%gRk(wy^z(j&Ljyi9x(aP4Xi56vk}|sLi4P`wxp_L
zCxiurN_`vHj0~^2BZD%RLPY}InHMA&F#L_HK9oCwSmU5ba6QQjdLtOHD~+acS&GB`
zLIe{fK=<ZzOLN?-)2v6ClT4CXg;Xd<Pn!U%bwdFIS<riXDo$Hdip^0({cV>GU#ksY
z_+gBqq9QL3Pe5KCbM3q{aK~<ArrS5>I~7vKR0m3lP<kf9iB-Tnu&hHa#6Ai7!9O-z
zW8%@97aDd#nktApwx|cbYm$vxXs+j=+w?p!=!jWeTU)5q*nmDIbs%q}-z-<Fh305*
ziM_cojP0+9z}~9b^|P)WV@*v5J=@C=0Hct;I+m7bp=wpw_K_gD8bfnoZFfP`Bs^rz
z(CHZbrY7_=I=n3;Sif{~?Z=8}A@+bAZjbddHRS>3ig-2pxUi3G7P)Ad(@uloMi%r)
zC-GfSm$@$@yiUNBSRIjn=dBWoIeAi>`JX?if6@YGP$j;cD^j>xm^$LBkcz$G)CFUR
zzrU2Im>9^&fe=rv&Yz1az4HnzQ4K#{Xb9XB9xf1jKSVmY#U*rEOTZA|c$+yvD7D-y
z-mFaDGuDF=1N12ni48yTP}pTT2z(3+@7(du$;_l>>5~mRf?fMg$+1F;7uqRonF|mw
z_C9vfsz}<SosL95euPwh>q$N8pV>H5p4(b~(K1SqvJ}#I3g`gPK#lYKog&?9BQzNK
zLg(JU?hE}?zk{8-smLr1J8U4FI$&M%#t~6f5e+_o0chNE!8HNd5v-UkPD0k;E&)OV
z3@;EHZkNpbQMI7mCk-6hQ)#ts9Y@d*h5x_>tZE-C`V0ddorjMvaK6EZ{U<0lopMMf
z<J&iUu4=EP!pIg?rJyc8c0bS4lTRHqvFYT}kcA<A!_k4xBNKAlayZu{LqN+{B@}!5
z6oTV=>%*Ab#}5JD9ISS)(uXJyN|}WV1~?|E!9#J7;7pX7vLm@9+junt(}GWE0pabQ
zzk}T=^Ls9s9-+j$(6s5%Ga|y7LgiUui&=f4fyy3cg|i&kN((#1D=wZ^0UYv3REwIr
zdfT!qEoJyp;x)aax+c~N^8GR&mwVxYml}J@*wUMGtK&ub*0VK_5A%XpQIlR&(pgxq
z(+mv`u0T&XRqyp^?vFJBOMclZIEK9X$@UAYLRH#nTFsBspzIeH->|i{U9qiTLO_ta
z*~NzhH)#n5IDbyPLCcOt5YX}FP0w`Eumg}it!|WQ>iOBwx&i#Q(sBP1AKkqwqo{}h
zM#FON9iu;ug2CD^?(zJrJ{z|GoSoHQzj4e@Z27;87bmCMIoaAXG*>1})g?zp_P6KV
zS~-CNUu{0mk`kFZehA2oT7Xo0d9Fol+uP5qg;A*kCd*KewKNHpO1&{?N1)rPU@Q-#
zi7f9FeTEc64$paja)dqYTR0mFY%*jf3>Yae`i~Iznsn&(Qs>Q31Y)tlny_Y)+ix-X
z-=;%T50xwn=qqq^8OmAGRT87zKo3Gn4oOL|@?4<00-vKra!Z95i;;rk?Kf3{zakR_
zJVHY6eieubYPF2K+MBjxn;rNNp;z=){u#=-2bowYe$v*?ZR`-f6xEzDN{fGed4V#J
ze=_))qnqXSLm5nB_bY|hrtp4)vICte_%YteGcP()b^9#3qav=>2nWvE)e7rg#8()g
zY<M>ePfVbL17YGk_t}lN(THE-G2jOPzp~}{N8Q?!nMa+s968)uQ}(#@h`5BuQm&^(
z7pU9lC<*+GUKN?vA>5S9aBAH(FVU$oVzXe{O3EF|@_gk5N;(+sFhS@~Rkf}#SV=M9
zwh_w0T>APFjW!EAJox?Cw3vhhE@&JUJYisp1afH!9CgMc@lwXAFP@V8Q`MkZ0eWYu
z&Le-Sc_*jU@Xv8yb0{t1?`f&gpFIk4J~Js(6f*3PZ$K%4zeqqpzyd_LNXa@@VoU2d
zB_MbJMWu`RARW<hN^&Q2T_@@)jIii9nt<IR+TP-$^a~{`tZ7ksk={UeJO5=1E{KkC
z;yX;PW6CH+Oadrg%rDE=AK;^b$vP6x%udMimia?M_d?oFvpalM;oYlQZ2!)#oE|tS
z^zZ!nFt||tXfiu13k4`Suyf`9Zg2uBy+gFIu(0rMkfO+IudRu!`ug8L`{y1?ec4~R
z9xOtQVf=M}gL8}cR%s!2%T(C+tIG?^YOd1V*ep5hsjcJek`gsf%1O9^(?0dJZ4ss-
z?f8f`@FqZ^IXLDQ5@KH9qKK0fM9U-h@=z{|a~PY4nm9Z+ccVm)JsOgShhf6~-_=Qe
zo+Gbigfz7gA8my!X<Bk0G4ZD=QT6-}n|rq7;?IulS2dkh;VS_s`^#z5-tzWz71{0E
ztw``X>(VT-c^pF}_A2JZwzXU0=jv*t`fhk6`Rg`8fSjHZ<DU;M3phaiZ%*bC1hmZE
zU;6c<4+zX`>9=1t>;Bw&eied~bRu7#^))*G%GYCL*g4YhndGf5tu@dt6mm34;&iNb
zI<YgM$p^9#3|?S!_mk;9c>YX@8JpYu3x`l8c!IJi-pFHBF=4-zE5Xb&ipq>qV2Fr}
z?9}uL5dZr9fBbat6eoYI1yiN3v9q9Jnh;mxl;lost)|3QO~``yB;vhIhE!UF7oQU%
zK_HZdh@IKbtI(l$0U<Lo6F;=xK2c)qw)o<7c~ERm_1qgT^qyW2*=&1)5*0x}@Cu{H
z2`V^B0HWMCE!>WZSQU}4pUlUhh#?7=10~FLf2p;WP$y~iV2N8wcIX3*ZV2<Av)#w#
zsR<W}DH@2u!9mzpTp)SDRa;O}qI>kcHtC;>f{ZL+bW_gKGRvtlOp8aeCtCv~sccry
zhWSdRtWR{m+;4>_=e+AtoycI)Okg7j56gZqv(7dA#~L&mNpnYX{;@Ct)Sp<=%#Nh-
z(e@=FfNujC6r-2k89TQwUd}Hfdsw8I9_ehIo}T`+ce<A9(gp71w38iBB;R!q)e->5
zz^XvM+`Ui^V*@QM2q0@Ms-{UiPb!a!$g5m)0YxE!BRCkqSqk+K*gy@k^fRfy<1cSM
zH7!r}JUf`5eNflpwCHJx`XHqX2R#VstpzfFqS!D<@X>@#?rrb-TP>TL4?k5`(}86G
z4BHVgKO*IyE*{EblM;Yx6Y@}SR5#^E66&BQRZuIw@ZY3d>h)CrVsOaL3^{2CYTipg
z`DrU660NN|_Eel2(uV~Y<B<-|-MV$^>)uJCNGm#Ip{^*3gX1!P2}`3SC0sbDUFE}%
zhaCh4mw=J!>gpm9tkPFQVZ}rRCo|*`6r|LpcK69In>Hnb1k(K(MFvE`-n<)UX`$8v
zaku&nj`W4m(I9Y?fikqz^70xyeneTXk{~J>CR#@g7l>~TPEIEK!Fk`0!fhA{Lq_cC
z!{z8y=*o!R^}SxODO7}(IO1%2+7P&oG!ZxY(({Tpai)S>(c`ZXd?@KKvDLDE$l3c>
z2^>jRz!DLQ`RvL8>pkRu<$<)ScUM?<!|9S4KdmA_qSzEqaNrDX+YV$_;m+E#63N1d
z4Rqoi-La~{-WtEbB4H``)74@AV{J1#ikKcSKuDp#*QTx1w84g@*Qw$G8c3Vju$NFN
z3W|%7{$rwK{**hBcjK6TrjoE@U;O?pmxDEQ2mlkBm65nMlSkL$A8mC+*QbJR4%n)+
z>BOiakEaG*CtTCVae}JouA5w;*SoLR8~rYy7MnMl{duvs&_qT?)&d6j`>3vQAgGMI
zlK%i`q*$<B7Rr3DH`=%L!z>_902&xHcyoeda&>_*J}Rg|<U2aT#8?}VE+occ5Yv4P
zfyBALkGE_GSDoTHP+0{tz)UAEys5Y1#!8p@CR~=J8fih?*&*(B2B)!dn5<xiMm1U{
z`Hta-oL$F9k2?F}tMQc?v9*&O!Rz;c6B?^r`noa9-@muYx(|n>n#X1hYTypFm`&~X
zqJ$S}Gpk%Ak#!p&_RpVf5DsvW^>ofO)nGpX5&fgaI=yp^Hi%>piDCW+1F^l(WbDS@
zDa#mvs6-zHMh!&SczNY<=2T>pGvy=%7BHu&a+DTb7RE?%TWz8{;YOMYg7i_na&{kc
zcBe2t8ff-pJlcFb?l@36M;}1h-MV+W{u&|ff7K|``wD3al2c|~-c}>cWe6Clt7T$h
zVyn}MA6RYjWJ0aY)vFVh-E^~gIKJ8)!yTRkdR6-}4~S?yfb-mf9x`cG-SW(av>#He
z5EU-lWJa@Yr^bk_uZ%5HlW$$4lt1X2rRf7QA81BUe!)@5jBTBoV2>ln675QvKSgPQ
zh`^LCn~a1UeQ*kKU{dRf0%^dY>8T*~lkc~{cE4P=o^cI<BrPEnI`Y&~!A5cb!x5`U
zb{pnq(hkgiz0LI}WpO8Gg2S5)3}HAzS+Rff_$gA0ohWk3lIV!|X2FQvJvI03m=jwL
zF&!KS3<CI9r``H(s9l-My`DXLHVjSm$cR>Fa1+7zHb#7~O@Fw9Ebh95_U!i&c5k@U
zgqS(;F?;ORA>D#M^!a`(#^IpUV8V|n7qD@K6&|bJ^;mn|-+BSu9tuM8v~Fk_hQy%Y
z$@u#>pPjmjyl%eQYVHE)4lrBj@k}t1>V{Dzm9A&K`p_NS50|6Q-j7V5?sNR`$>^~W
z60mL^-&RD}+u40vSctaZsV(q(67GmFRum8Wg{n6lRlud3CaP}l5BveNY_&ix!sr<B
z<cbX&8dQxAAZ=8cwT%J|Io+8$$yLC`CYZvbS?~`OLl@1I7puk`zoI~hJkNpw%4JAB
zx!MTSFipd|!VS+XED%u6L5YeVkb)p6pLTM~cC8q8J^50Zrqu#86))ZMjc-{`q&lc1
zp6Z-jwBM9^4IoWq)hoORPW&7Ck{!*j(5NSW2)Oi<LY^63-j|TBGb<`Ic^R<z1Dr}Z
zO^$kX>zi%RiKJhkY#g2=AG5HK4g9v2;6GIn4Y!r7yp5uxCD2)K__B`B-QJ$X&ffkO
zUMP6!altDbNpyz^4jbA7+#D?9ZVR5w>};!r^KQ@zVLgDD22J^Aff%#HxT8pk-1Mv2
z9W%|xZ+=0^mDBPRO+Q=P1>?M{2te`lxGLfK<54vfMfzKSRkJ{{6BHD@{h4KW(-SUL
z*~f)Da9g^Di~h3D4LS0G94Q3i@cL=~J4C{65x6QrvrrKYeM09>cRdXYY*64z29Rhc
zU>PU-c{XZy*BPAIU`9*sWu($9=;D1t-d5QZZ6twfE%lly#s7vhGq%0GJ+FvJ5<vCp
zrwG)q69^I#uB#yKIAd7MHTj1?#ejAmESr^3+PBtL={d8|^o;oYgQz*0tBUE*kZ<5E
z0lN-JUSI&7H1#o6Zu(To`G0yv(04#GDs8@cN<>1^w&_VvcEj$mDZQjbDu)&;aR_Yl
z!*E&99o~ByRsF|MTzlR<lHgwn8CYK6WnK4&jte0b6hiiE$fbii=ej$0R~~8BL<Tyw
zTi-j*2t16K5|p%q&|xVm1mxKG6vY2h=}<K_!7TYMl@|o$AMRNIR=|D;<0i2??DLwg
zj#YCE0fl_;S#1;unXz-NM-8wIqY4b2l9g&6c#ya<!^}`ut)>sGCo}eRfmoD6P>ken
z2hHJm&j*$0v05$c;BuAI0^mmMbCTCC`vPIgMGCH_KYsobKW|yjwv?Z6N7?ET8LpKb
z9-Ke7ngRTbWX2!vaZ{ki4iJL$M7WN{qWr{`|5s9BfOe6ZBG;Q}*0D`w!-#Bm#*s<2
z(6E}`ZhB+Do`-BjVLl2-dmzRkRaLI{Tkw1sQ(&b^APT4(xfa_)iM*SByDCS)JK;(s
zC<)}OP=Kmt61lu@#xK-8m5!u44`<b+TCvio?`4kTc;z4vfozdr^aAF+E>8C}L^VX9
zWtZN?{^a>US%ir&1a=j2DCk6%A0A+7)|#y0=2xlTVa8*EVheDI)L&zbEOD^NtpATS
zyf^(ns-+l<ksv&?p+U^{S_nZ0b~%NyUTfxP=HszQ&_0|>-^Soud-*Ak)7`m+)N)o=
zSCJB;Sy?wgIor)bIU6xlU>*6DDN2LskDPD}V30Sy7cFBQ{PGG24?9F*3zVnO#l0aV
zBChqGIjz!or35B|UloTRFD@=Rg=8zTd8YqZN3Rl{$Eva|y}b@>2Aj%@H?}VjhV7e>
z?TLtp!W6CxhD9OXO-Dfk`S$F%Q?v1G89`k(kA?sPn;c*Puu;IkD)CliQXv9}bL1V)
z?sV0AZ9M=>`p6fkqp#)Yp{@WLz&Fm|Y1K3^NYZ0;to!uRP}wTS1KK8-=c}y51B$O<
zo=-EW$D#5Y`Lt|FPnyx;6K&#@-ZfnoWbjSA$phX}uSj<o(*iJ8*Xh0Q=s<F$$rp{&
z6NE2ygcE`dI|92%=e_{;?yiK_zk3CZ@O1G(P{oyVe}8{wUES>>{W86y@6ZMJ1WzEj
zGb{?!q5paTfJb{gTk}ahLs=1#JX;Ic1k467(3@E7td^3IfZZmy!#{P!dcBdSFsw>P
zj*g#`ks!noG*Tu3j~AldvWGEXYynWY<SE+eR|@(9m}as?O!}=q5bb{j!%kd$|9_eQ
z@TA2R<!;<hEI@ZLHoYaJGczo-*2&*|j{m-)6fafSWl;H9n&)-kvS87W%>hiDC?7`0
zmlP$mqyP!}=n*>@$Ap~c!XhHDT`4hS@K@w8A|1*NOF$6XE@URAW~Y<Qe-~idU!e@K
zI&_mT1f(IL24EI)<uD=YZ^(}oRCVIq3xx7I4gXX@1JZ^J8vzFl0FNw;5sHl4WL-kL
zNf5w}iHwwYD~uGFXz*aXLPD>=)r@=)=+%1F&nnm~-bF8HZphD)?JvK+9%EjGV)WSi
zB#{+0`No7ZGkKI9C8sVuDjC!R=-HQ-EsG7S&>u~fz7-^mkuRI<zRLuLNU{+3|9W16
zVKA-LA^;4PmX?+Z40U>Z$_fJn5>k}imcG7ZP&JT?%9?P}n9BVo70(e{x*8a~OJ9R)
zk7V$XOcA6;VDT(?Sh1e~_lcw{;^lI7Sy5{%GksL8%*K?fVfq15J=n*xVNwV}8QxAB
zC`{-p2Huk55L$>2MWW&$b}xbk&W@!iUfJFA{p^7)T-rBSJf}k+0I+XoX9s!qk^WH%
z3Vz878v+y?`sqzi7-b<sUT@qns=@5eN(V^B$2vHn?Lhtji|ATs0-}SW2qg&vxvHy;
zXq8UXWRsCvN>vCv@wj6MkOp~b9>?Xq^dZR+vVsH5j`E1N&b{$YR7*emErAY?>_m<1
zeDkZI0XYQ<)^=?U$0soL_<Zl#Vmpkz!nl4QQcnjh=A!ZQll62Tq=2~$9XWC&4O#fP
zpD*Lw-eY<X%^n9^|J~W?>D$6|LFtXz!y9j~r4b^}PB`YAg;V~GN8SWlR;*@dWuwrq
zalchs@47{$5D#T{7UWYnM98sY(13`=vN-h4G{9{M#R85Om;iJ?u?fS+1i;983rwej
z#R0LV;9f!PI}-K^7}jy38K;`G+b;R9T67)}C>0MgYJP|f$N4<VnRlAZnvi!IA1+(%
zh&wLuvH+-<e)c&Maxc)Jf=BZ;+Lv9IkOSbtUk-4Qv#Mg=+bt5Ob3rpRGoMbrAD)+c
zZRyRy0OvpNN~0f4Bs<srAbEau_#O%IW56hX)BiltKm6CPUkT0{j9|B^fX~ke0COTJ
zvG51ARH3ZwY}pg^GQeKrj-weE#Y7w-SO}QEfya8Ao+eq<fTyT&yz0A7gr0X<z#SFi
zZi~&|rUaw$NZ>3&3A`0s%v+UEPwf_PXaU0k;S?cHM>_MKD84rsDPw$RQuE-oe*_2#
zO(tO8IWZhBb)d$E3EeTQ$|>@-P82gvxa?-nCxe{uVF!~qHVZ-RfygH%6`DSaf7XPd
zc?G-jKJ@Og_-JWjK6s!{w$fY<)8uj@T)v#!%{@OHU^D+~e)Yq={OPeH5{x4Pa4CeA
z`jh#6fAz8eK1P6GWL6mm6J7JjG~K-#CqG8eYSdbQ?De*`?m@!#ZF6*Xj*e6ncxPDA
zTz7*-G=G03^xoObGD+ttK`LqnWFN@+Fe3+CNoYz+N^w}2j&=+1u%K{&^RS?x;6bi1
zL;3y|pJ56+K4w^48-zT#cM)Na6srg*yIz|RC-*u^<`SxX$cDmb<?gPPmJnBx{Jn1+
zjc-v@d8`|3(9mnZpgVX<@ZggH^elV|-H?;NFmzqnha8}Nf4OZRCP%OGj?QQoaF-64
z!~ri^fom5z(Ftr$;NRN9{%d;J6Fk$)uF^&0R={5yR67zcJl!h!@T~Tk29>&}`tsYu
z_Oo9!#Uay~+Z3XN$XN?0;b81HeD8<)fdnNDWCUYl3PAbF1G#URP2=+Z2YT!3GA&?i
z<*$K4@8<~Ps&Mqdf0WJB?@6hjcQG_Bn4mhqOrG5JTDt%K!tgMiN2tmc_FH^ZcFvI=
zw>0`K5cr_6@~xpG1}_1CF1Ci^%1Q#raA1OfVXu#S51BxHOd@4km@+Ief`JL3Y2Kuu
z65JBQWi*Dx1PY}UM5WwZ`3Y}3$y-mY`|f}}o%cKT$`6nB+Kc+%!IQ=ua9>~^*!yy^
z+xQAQH<=rC<Md(}usf21`ShuuqIG~o84F}KhMGYOmRlL?yr3z=XClBvgd03XR8eAJ
zZUKr8xgFZb)-lq54`ZP6nmsU79SSZ;+w52gjm<Dw8GM~06dez$+!X0+29@_|E6R9J
zu09bM$#N1yZ7yz2iGjgiXn>I&@`OGIab-H{JB10oGP87^J9ppTx|ct`lp%5KyTZxx
z<<Oj}oXo4%x`8kK7dX?t!6Yu!bKvN#$3Je9sS(7nBEb$c6;T-(8L#ar*=1_7jg3n5
z1R_m51_Tk``He_NYejGOnWj|;jzuI@bie7LDh+0}DJ%TJ*gs~}4WF)H!&j)aa!UpJ
zFIacm#Hg5<du5Y3#l@<}m&HT?$P8cJ7N4RV`TF&%e0o^rThw<Gr6oqy*urzJ*TBd<
zBGI3S*L3>(sYrK|?~gW2>T_LolPk=t_Y~wLO~UVoLP63&q6`3tP=<96Fna!($(@{T
zK*2zg+Ew-%GqPsN%=`hlr&)ICX4$t(oQ%+m^dldeG{r6%6ml&AH{<9{rwI)Gs$ABX
z6BzJ2{vN&+@-PT@zx8<*w_*MZ<E_t4&rVn114*j4D`BD>r@?zC`*-sVAcp!?>i=$!
zOjiLox*el13KCUbKys3s2qko=@CgUqf$wQa39_E1ll)yjiGpd3gTEQu?Sw9Oc~@hW
zvi=sam8`;?_y6gepu|&(`{IMC1$Y&;bIF82c|?<0SrWPVXJ;y4Lk^jLyiv-;3Pk7!
z1POPvQbe>-pf=J`G&W+H-NUkDpzE(iO}c%<YC;NC!xiy`C#F18CTtRw9G3%KqL^6%
zAGf_=JoBi{HVM}#>DVagh7pV-B^}MMCvI8@IcPfZT6h&+FH-4`m`t{dNXc0mdBL5m
zLDVHg3X<IlQ4~;VosQV?6~L5$h*)t{216e9_W5VeAn7AN!vYur<ma6ry;QGWz1pAi
zfX~YKvLC_?_M|fu>ZcoY|EfZvcK&|V`^y{LO-FC&FaCA+5%?foPfxSuX^o~!q~2g+
z2<VsDIy@gC;6Ka_xD5eiE;bjam5QQq<->AyEXQs4$MX5%1nxIZ9ws?amPxy+Wnh#@
z8+L|-?=qy8uT8ROWSER`EIY-6Wr~|fz8T|eV6Xd|FtPNW=h9anDbzSmmJj9Y@8`L&
zX+4jJR<$3_8{59Tg_}zvkYF_Yz_InG77n>GX92rVdqE=32a|`_a?q5M`PT?TMn^{x
zFf2kB(Khu?K>3oUK=)cf0#?V4H@ncQ1IYKt4-jF#y88boIiS5?`rLfUiS%Txgi8IP
z1M+bHa?k(0QHu>Gv;YhSanE5TzxMSJ3$w9WqQ=$7kgjH`DF*xb`7=atqW@_xo86~b
zf5l4?w$v+D7Q%La4Eb>&{~<WAw14zReI)reL?M^vOHZ6r7fisCrIgT}$<B)1U>5!@
z^(X|z;bmlW@aJl>Ppmwfmi(I?d*1QXCr`f2sy=l<fe9ySf6Vz8*Y-p2?tinKppj;6
zyY}>2CO@j^HQy3yO_@kq7K^W>3X7hIUD{Ay4KnKt9?6Z=w>$TXP+$y6A1#a6*b(Oe
zNi_ZJP(}(WkMS0drUPFxxQ)U<o~EP3>l^9j&~iYUs$F@rW7nTx29_7o2Pj9s6!YBp
z)=0AyO)Ww0GYvdon8*4cTcso~2C{6vX<Du<cnjl>(@tGTBDI7ffu4|1>3;^=_zChi
z`&X|ANG%vf(nq4)y!21p*PBJV`V)e4wrpS1=3M`KkNNTcL)Ux9bJ@QC<1eB_WGj@t
zWh67B?7g$H$=)O)WR$)4%ue>+d++R7Hc57ch~M$*et#a{zkYw{zU!g9uIoCl^E{5{
zI#QcJ@eUO*{Yr`pbM|s<2XNgGIRix{I8`ldZR4=xHSy^b*S94RZ>Vt0Z!DgcjRu@}
z=sAR+w;lHHXSY!r>b>LyQ-=j>3c<6m7tT>Uer(5m3Tbx4usnfTa11Nl^6!1*mQF&Z
zNkXVD%Av)HhxW%@^jiwf2XA_glQ#kg1HRzQIb5h~`KH!7*hfaX@AJmqI1I9WOO`VD
zS=a8Fu6V&1j|48-v#g}?20?HHfNfGc2$V|X<m7-$BLP>=)P1o$@GQtGs2;fq%55U(
zE3U!Hu?0y#U^Q)y<U9a(TKGvZe{&H4G$f#u@u>h4l!a!jiX<`bS}aY_y_`l}FE->T
zR$NAJ3BUSD4!`FiOnRBc_~L;hEAe2HwfS=d2v+}Ra6+Ez5Ud1R18ZyRX~n&yJbN|w
zW^@`A-8(L8e)=Tv{JZzxe+leiwdS<wcKM##S81q_L_|c4QcRK7nJM<1Yko_#tT#$_
z?K`lB(APl0H}8vT^YMXrJ2xF8qZT#<<yeX^1h?-oi72{`elS^lKOKatbCpkWbs^IH
zk?G-zq4QlFo&;kh6HfU*LmAJjL+PLV{!)+C{FQ_TGndH}K#%hv9Xk`c)J9r_Cd4KM
z#e!QIszNCHk&y#{!cQ-?jfWu`bgx7_w(il(=xtqT=5KHJ^KaEz@>E9AG4=bqz5Ym^
zh#(St`dMvHoe<~O2*I?!$iXCfmrMSu*Rl@iu8t(GMkK_p`5v#G=5Gp>JMaDZ%c(xb
zHNiEJ*}yPcx|L+^YMyugTyIM6SBa9Fcb=uSb?3Ir01p#QDruYYkK)0#@`%0V&5YKb
zdMd0LA*X01`vbM;yDf}i=4ilqUcY`FSR2a6k3BRPsuEod3J5qwrx36IqKx2Z^UpmV
z9&Day^7`ugDtxuDPv(W@OPoe4r&*0837L4}7l9}5J68gCe!uTj?U~Xjd>QZf(#(v0
zPFwp2`{3%QP1U`oqWCSv^vsEpjj%%mgGc_|hmB`b+f-gJUt^?6_U|R@mdq>nO_5=V
z?Y(!9_D2wkTsstA5?4#8O=PUnVg*YV7Y7H29AU68E8dtIkk@h~WvNWdv@Cu(2>A*|
z%mCEd1qG<Aw?;GaD=MOgQ+RuAZ%ycSgtgS`vH>N3_ujqSygX#@I!FJaYdmmVHN87R
zq%K|Qa+US(gx!5Nz2VFVJ9=K;rb(+Nv=3Sy0OVO(T7p)}L4TL3NEZczYr*X0nOntF
zm-8+`6OUo~%m<a&sE)mPa<-2nMsPDW_=8S3o(Ed|-WBbca&6QLCj9;D7c$+Ua4HAU
zcudq}@66BCAfQj?bRfD#DD{|uLtBV^J8@aM7cC-<e0`5)XHEz2EcU&4t{K&3OOVse
zid^xP$w@*4d(#0be3WA=%#GBeN_=ZXOwp}qRF3{Eh}Y0}TM3|RK3eToRiMnw3uTR0
z4Ra;S!ZR|qdg<m6>D`zWYTsm$>9N@UOXTrzMCsDNCI?%M6V?;JJI5?cU0huH=fx<E
ze!Y*P#6W!=6LKZAvmBSNw0zWD9ae9doP=TUk_R60$B_w%2c-B^UK_ZNWOG&Vaj1dh
zX#ApRZCz-({D4%`KrOvrq==<sU1nv2inrDCCEDM>FtYn^(q7pzuR148sm9)IX@5nH
zzU-9mV?w1xxVf?62<RkR-7>07-3=+s4Z;8?%r<Dv5;GY32dJ13F|5Ig`6i?3LW3IT
z<;s{^KQy>W!*cTSB)MPE>QWbr-9kehM~nUO!{+zyf|R7>^;WI@mH3Q|m9S%C;iGSb
zi@$zfzx0wi6Wj?m6c^jnny`8M#0Lm;5Wn<~jvA;k_Hv;D0SLlpKzyB?oWL7u)Lg^#
zK0ze)-o`6)$#3_)StOntMD}>p5>}S7MZD{%`lyy<eKSs$F6<Kv7~i1NZ(R~8)W9wb
zQs6uN9!{7}F27>Y`d%cR>#)c%^*LM7YL6aKNDHq7zL5oM%M}40ioB`0ovbV-KuVRN
zUqL8Zl;uG82SKlWmloYHnofJ<_M4ACci?fuISRrc=)##EJP6wfpo%7KgC_OX^=ohm
z@$tk3A1Ek!9|VX|%#Da#{=p7^rQoy_BkA>9RixHHqqmVK?!&DWk~`!<A-`$a>|!V}
zY`!#b|0tl&>}l@~9yWt|*Q9bzT1EzN$`2Za{R0EhExx@4=xA>fJo3+Wlkn2H!{xZ&
z=v4da(J|Y(FG$wJnitDDe-~FmRVh$kUtb?;P&qpDgg8K+No_ZeD?$-|lgwWH<;KyI
zqr!yqvtFS9-AUc5kF(P1*vmR8qm7>hGQ~3&cH_Iwf$0D_m78F?b`}Q<O9<q#x%bM9
z$WY3l)YV91w$aK(e=C39j;4g_2v}j5B$B9AFc?taV=@HA2&`34&s3=9(8)~4tF7+0
zc(Gjl{f;XlI6k}_8^eB46L%#z-J51_zr5OWp-nQOg=TngsbiBuOzlRlTZE>>kGCUj
zBq<oUHVM2AwCm9GH_1LImCti<X&VgOEynlxMR&K!+xq6h(cjs;p6pNB&t+I^9iA0V
zt#58dr=-XMH@n}WynJH*?sP9oSaMf*&)qJzRI9h|*>GUka((aJyLY2i+^JP73;S(e
zGf{^PSXS#m>nNV3ET{oRY7K_r0b|!x-<y*!y<DS$;Ml~5zXA6%GA@oT%$?9)6ryEP
zcx-ikmA+y^zT3f)MJP7*_W8B736LCvL(UiZ`R#fL_uD}3K)_#O<KvyiBuFx+*z`qm
zRhZ5`qZ8>?=Ei1ZkS|A>G~bc3^*jpV`tfmKWu%t3tnxLzEP=uU{jw_~M@PrWbGdN%
zFyuyQioL*2^bZYnZ5_)HVEUT>_=Aet>gMkA{&GIz%NiQxGxW!psJa@(xw)cJW@d<p
zUb2}#UE*Opa$TfRO~kpP?bQnd^~PeHwO6(2G0hW#kE1&MW_V-^*82Npz<L2FeolVA
zT(4>>5!r2&I7XwI<Y{er!r<P5($a`0lx+Z6nM=%y0r@Z1r1E?huMMsfdQ5oww{G7y
zfkY!MR<L~lAO)`Rr?_yEUO<M~TJ!#!eJ6V-T^ZzxsnErHQm(;@ivh_2{d->;6E?zG
z)iL?%uB+rvNL1TeGBMlnD|asKGj8?vzIMM@N93R9*I(x6*HsnxJpQVo<a{V!>rlsJ
z5z|kb`^@B*NGLa|MePE}@L_$!3uvx=<d096e?IKFmZUhZ;EI?g%6I;YzM)&*f*ZFS
zljRQp51dN`7-)PizsC~p_6-bBKTz<>UYnAy+MaVMPG&clYO9V&-7M9MN&QjlsIvCl
zQU)%i@e9zJ&}c!3T`Ipb<mo6$O7;{<8|moi3>lkq->h^9oFQMX&jK5tGi2F8c@FS-
zG$VlPa6?B6nRIPZphWr<5%>ilA0+I9b@_G0LD~eR^Ff^UFmgK~>W2&>*hrAT3+PwN
zZ7MCcBoSar0vH%H_Hx+9iplTTb;tU`Jebc`#_nI9Pf?}YQ*251^6lF(8KszQD;mP~
z4)6zb8eq^=)z-dSi5tv=#1OW>f6szd32_H>TNn}AUjz?yZ+i=xqf$Q4->giSJb3k7
z&To^kkdc)&2k?3yfPbK@09*(Hg&smy)0jo<#euIiW~c2#Z5(`~59GU~+-H^-oh42<
zX?NC_uEvMIHt1TS28(7=a&yN`PO1Z--Zwm)3qeHi$t6C(Z=ptcg6r?D_K=$Bdyq7j
z*lNlX{BoQpj*f>#e;I;bIbJ&QWqmfQEWS&2=g@h@MZglYygR=tK$<W<F#-PnLj7;=
z<WynnRY98>pPHFb)7I_>TT^3^E3Gm1hlSm|>})>}B*T42601|Cg?ub=9!t&X5xd2!
z9;2_0*Xva-4|*`XRT()?8|(ibnPEOO%TE9eJLrr6R#w&59|1{)>9IxVBRFMz3ExhF
zYg<yH`4Z9U^&;@S{<qG(!)(N*-SeBZ2C8z3^Q*=N1?pL<1z?bml8=@U5mfPkf5sS;
zi*Sz=@rj;ANSJyZbueG<|6qI*qv&-wfJ-r_#<_1V?nrE-tEa2W`ga7Lzp+V)<4cDe
z4sPz3?Y0W)*oIljPw?p;y%9F(+p{dzc)asY7S~_<ORsVA(zc5e<Q`7U&PppP;(&?)
z#BRNU`+qav-(Ou=y5s>6400Buz@X%`-1auo+XJ-o!oSNShR^FKwnG~Tr8AY`r*tDX
zGsx=e0FkQu_k#R7u(+Mgje5P)Dc<a)xO5Pe3yc3(oY4mH9bV_X3C^qGPq}K0gr}Y@
zbk;ko0iv008%~D+Wjw1;4*G>wcc&VCTk!NPvE97E@U>A_$0BFnrBu#CslRA&x!nxE
zHDfZL$*k?Es;R9--;bb0{RXt~om=n*PAo3UyStxd?We#gb~=+kzfGP}?mVZS+~2A@
z)s|OrU==DFM~8O45*HVT!bS3PnLY;Efb9-ERt&M1^(CeRKOBOp#dyUEH-%C{&gSI&
zQtwtBMB#c@Ci20@g_kZSJzaRTPKWS2oM3=v^*7LK-3cCB5YO`=h_aM6tu2?$)j1OS
zpv)*5ELu1<0J(nspvWtqv++EN$uM<tiUu6E%%m5`>%fmfT#)?&u9^GQqT`L*LO*eV
zF+j$nZhkK;m4v7v0H=;PwY9Z@PSq9(d6xR-IAv)ak}Q$IhftDkr|PSyv?K34_l#}~
zp^r>-7r|3p+R>)a&|ANM%yF>~<8Jfu@!y3s&LNjqP-6|wiF~zT9b9GLwOL!aau3gc
zuQnDTa5{!1bg{aD@>QkKSgGZGJob+1-B%>R4%9wb{SE-=&*JrovHv<A&R;<38!M>)
zJFfG!wwl)Xs>K0qevzKw$*04l$9XJ5LT};^w6MCEjnSVjpZ&gx_&pU+!Vp$BW{Q$|
zUvQXqwoZVHOYKwVFE>HQu&?wL*Ev)~x#p#_;oXJ`V5hV-9lUu+V+MGyAZjaB_)YSR
zfw$17cEoML14PDY7X#8gh=6Ph%2C1NTOxnPB2G7XTkDr=0;9a@-F}Wqok2EbFUTiR
zXsH&)$H5eKUJ*x57maKQY(U2Sd3yTY(!TjxPZ-D*0-7ROxv^>Q!vnP3a|9z7kV!X*
zyxVOUKOeMUk@0h{LVlx->F3q8gzFTe=9cwzENxT#`bXm%t&D6_7c_Yu+@uO{V<;$g
zHbih<p&oo4mRS5%^M`Jt8O!#06=cdl0oyk?7~@4hEgqym59$KS5(UVw84Y<EruNtD
zHA8An?nk%Yo{qXA6#KiHH<m8Y$uuLv!&jZ^k@7^HVpshf<&uz>Sx`k3PeV;A`^yJb
zth$DV<P_D;p&Q?uKaY?hz-E6hf>}zI!KtHr;K-8__WipR0P?_6YyjAc)N13EQiOJ{
zL}rac<?-F&x0~SX?(aaFl)@<FeW7(S$bmd!$?PaNr@=dr@H1b|6b&%K@u?{Z;K7K9
zhyWj!)?gom7u3+xlYDoU<HR8G>8lSuQu+d;Wpl&LN~HBy+pfQ-HynTUP_r2rh}S5l
zhpdR2d;>xsP91p#1&K+AqwH)Ua?cVhpXcnKHaD9$IH!~clCsiLE}aC@ntqPU6}I%#
zYB>HjD8;#UFcKz_V@<;28!k1;I$Nhxp#G4Drw3$2Ip2!ibRqRcAk8kGGSt;&-fABe
zr#d{9{&RWDXm4-t;rU<Hu#eJ?j-0T3s3<BSxdt4G;vk444hh)zI%)i|)S3ZHDh;a1
zk2RfJ$By8sgje#yAIXI=5@JGb56*kPUJCD22)?CXe^a)IJU;#LSWCKGjQ9#_x;;<V
zfo=hxwi3`D$Rf|+-jFUK+EeM-ZmK(#bD<CgWnlrm4zH@N?$G@J-_`}~;ZmiHtyiVk
zMt91QTbM~2f#+_7?T^C2weJeuO~v(*MR&TE7cmUWS`DGAo5g1Er99}Q5%Ro}=0zZD
z_y^~Okha2U`&<w&!<(BoDNwwzbVR9<Z;=P5?Y#Cus+XL&-@DT}ES?f#ILxrZ6|r9E
zHs4_}!VgRh)K4il2B&;j;P9JPR@dwb^U?dTE71J)1`VjqQcK#t_tiO)FbuJJQ>`<+
zC359%*SO1rOk&U}MkXTzvv3HI;9G;sqXZS9eJdJh#k$g#=jvcbs_c5kho*Eb=mwy|
zppt<+8W4wksH=0E?w1yPORtImQ6{p{CMBh&qYHpqU7MRjCoGukMBQ;Mo%waouHYA|
z)&6Ofc_~}+-Na>!UNq7;Uo5ht`qyircZQ_HeyrVJM1u!Ue}*Ob@Rc?$8jkQx_mxK`
ziBIF#uWb)*Sef#t2ic8BHuj@w<Y9+WVq6qVb@8TecaY#(Fb$fDZFgkMi04+2{P|%C
zuj28sd7Q-%w>S<@2~IfS2zQBo2;LKZwYKv6TVQQdXP#=Z$mlmsCLz+r$W`q}C((T(
zHEAaYLkIqw5g;Wczkn>U4=Jt=DLl^?mhy6Q1K>a$pPlWq_c|u~dilGy_vd0^z`s|j
z-1A#+PY>`}<2H*O9UXxg?D}|5AQ}ufUDJo)$ddw0zAq;Cl&gN6DFhD#4QTxjm6b7z
zi@I!02cqEGBY7il`&1yKr7m8{Kv!-iF)d$5%KiHyW15L;I&b)KlVd7jb#w?R+$%NC
z1Rf&R#1SmX0(G#6x<kGeI150p6$Ng&!0@GO-rK9t10X!N2PB1SN=XCtPK#n=t#cIU
z+qc)mwa6rxqw~r2_dGs{1z*@Q53etMZM5s>)|h9ktAE#*<yh^e3-RT^<Q<0=HtX*v
zSG<jqL+C(?q#!~~RTXH28$iiz&Rdtpd3l{47?sp-CYPl{IQvK{znGky+|YvaMx3S-
zeDz!i7RJHN!6&idNimgQ{QUU|_%|mRH0o2H_^Ks=30f{(mOyA^HSJw`YASH$kPSN5
z<X)*BQKS4opYc1^#MuztOV7<{0RefQbOGLhnBwf8p^s1H7Vdakl8F^+ILWA?Xxg%F
zM(3f9t8N-lqP|72C4_)xkm(DVrTLG-zZ21?=Lv-=b&g6FA@41;M$RVX%GG1~Azcva
zwDHqN34=tnGW1d6Tj5no2h|J<No5`?EJU8)pAcotY6j@kpRN%kp@zpBu6;L5iK*|I
zf{g-<N>I$2C20=6(Zx@)ieJlnHp1xuu6G6`M+CZEQ;@wP^TZ*Y@few|>;vh-Q9%6`
z(46iVTnTvm{*hT;ju+D1anf=k1oy1-w)bggVom4%$#Dl3yTk7v+7LkrrWxSNQZ_d?
zTZ8_HAbVpY-2R}^wL|a}_Je2zc4#om@o&CntWSQ@RbM5U4Yo&uv5!^CYs>4@eE8Z1
z29W1BTtuKui^`GMlXZ)feQ=qAy||OlDu&t*D#-M)6gNqG(R>xShg6#O%&S@NP+gdq
zA+8OM0RSIhB|-4(8}-tisMg=82Q9X_$6XoZBolFba<8aF-HV#RmJ7#Stn7=$WciLc
zuat$}*1z>3S8q%Recp9E+Vg&OoMpKrJrfw`mSZM%SCc}-D;09B4C!~>FE7sAdnE|p
zfkEy2Of#uko09@cJy_FW4KITu{e_!bA~5lX>oH2IdO|VxKrxZ=vM4`4zaC<_L8eLd
z_;CtobPnNWm4S%lV=dUtj=|p<c!R=Ixq%<#P7Jsh4j`>_gxu$@3jxh*GAN1S#IQD?
zas$y|R9f0F5X7b|r13Q9Hq|<ucWyyB06cd5BW9dxY^VGm@U2i60Pd`+rB!E0`%njk
zF-w_IOEbE^AzFT~t|+|*k4!0@Y@=XW<$7K!S4Y`PLVz!S8)K7keF4<^p6j5?q~u3i
z8V%^DqzZhL?tct>y+A^(qCk1*=@lm{VP=+R>P1#c9}}QIm^d}e_0I9Ww|gX2B^mm`
zm=MvTt0T6~%Tr_PdTYdnJ_8^?KYsks?wM+zkoOHM^y_|I=J-pM)(JmQF+b$Yy^Hio
zeci9==k@R<cDV;55h^dQmi=xY!Ph`Vi5tz~kIK=bwrjT?AR+$%nWI0xPXYW_%VC&3
zWX`tP)_$QMOlC<!zNQ4el+rJ~+KMJ~bw8>z>#}L8M_`9bYdm{~)I@z0>|8GqBd4H1
z>Nk}cksN#0eLp8j3L;GO9XT#-gXI1+`_lZEvjZ6;;Rn4l?>Xk)kW;uglb;rpzaNkX
zaai+@6nP_O2_Ec#?WdLQBvPT5di9x!$rqp1)QpL+S-8>3Z?>OP-dCV^K8c#!-f&pp
zQ>spO%N-3pT?kH9zx?%O_{Ya!&t&;5D@4LzhEjogbW{}Q&O07l4Dcz?mLnDVFiRnO
zY)JN=`HL3;ggb?tsEoCE$4(GnFRh@k0i+n{2^8_Y0Zk~@7=%#z0U!XuTkZyppbRRO
z!AJ1UK<xsZIjAf^6(2enK$%SF;J_sT{`w(2nR>Jj-!ggm`R}^gnik=;1t>ET##%N1
zP~t7OFU36i?&kQpd!m^B-4NUBA>r3U8tFE?h{*UXV=+tml)*|1rqR4y!I0q8v*YLI
z^yGq50x^mg>u*WtYM(FuuBJpJP{-5903wzoz-#YAvnA>N>18NMWBvj9*LnNrEERQD
zVpKDBOgFW$NO6Kd0@`Kz&OvP$fY|v_u%ooul-t2dPLk&%4~M0)I%8#x3dcF5iS(CA
z42C3*&9-`rz>W_78c0@Vn&R~U^Mq`!i~NiLyd1Q~P<%rR2y+<H2L@!p7ehJ|<D9c<
z4FTDH?N2CiBOg%TwI&?dKLIE}40u5hpW|^q>k>m;pSj2L=#jM9;tie-5xud#!0urR
z0|BX0x;7uNZr~SOYctf|Or(BKiBD(XRXEP095Oym$vOZn4jwMRbe_}iwWWxeSaPxW
zh_i^wRvsnYdECg)ySMeT&Uc!?`~a=_WlG3+{c96EO<TqsL5APj`GwWj9oWiWzj=qh
zBb=d>Y-U`p1-bn_+b*aOEZN`RAJkv>nrR*12V8x>wbz0+xAQYL;mA^d_G|^re57HE
zFew6=!yo<Rs{OWC8z7QMDOG}pGl3|qf}2?7ST%r6fgckJdAMob>Xno<bh;Ez{sSP5
zjj4-n(nR6fVk1qa^7NoQ0w6W0PfSU?Kz(2u{lT=AD{LFe%D5GK%9+Z_$!P;EviC>|
zrXKO~5@2Bbl;?9>Yf9q1{vh>U#b+Ml7XvGCo;S8uNtWZjGV#Qky{k%#GEuZ`lJT#L
zx>ik(UPzthn$ULmlw$PmJ*_YHe_Qwz+G{QlkFhe#wVrCklZEyAPB29#3y1`h-L%fV
zu6*G+Sg**qX4Uv*1bR;-u4ltD`miLOtUc^m)0wBRwtwy-x6dF1zi*wiUNsZG{q?$8
z5C)nczf8@|xj;UqS|FaQdbo1io9{alO<~Z#(#H7224EoB+-TSa=v>(LRPml<j7mYe
z3YbTrqnCK0jlaX=-(gk>fq>wQfoqjobfc!$M1uh8U^p+)o*IH1B3f$Rcqf=zu0UPc
zAW`v+k-&^yT7lB>DQZ=i7Qe^W4zewCaif#EdnyS*6Ed-w7L4)<<2~5*R*QM}$$55~
z!e<=1`>b$Ztl$psl+}4wrP$n&+O3M1=S;S73Fmh>H*1v&=2DwYTv^Sww>GkVcHft>
z@2e>_Mn~{Zlu%dfNKM2$(W<yl1qD(1F`#-<?FG{b_?cE<Z%|Uo;2oxo-hCdV*EZPw
zUic>!TjP(1&`*JY3o5voo$hUyRhVAjCI|;3h+i!2?DY4B6)=#m4lDe=ptu;YDe4uH
zr2tP*avOq35hzn2FF+jcD5oY)jR0T>-ahzopyI@H4i=oo0aNOK?8~E^;UQ7hXXXi6
z8Wr`_DZ@l_x>uW{MQjw0TiwxoDt@S=`nCmjD>U{iHujI$8<3$sDe&oVd2nXw<)ljA
zuN)Rtau8Xnrkb9h`0Oe1RCoRQhADg9zJ>?(vg!f_@OgQ<cchjGJ?w*9j6xo-FYP>%
zB@G!z;vz&lSaUj2{bMvzv&zwLMKdFd<X6W`D~MIwR?S(zR=a22Fgy^JlaYah7{jM)
z-yzKyGF$1O5|T>>!zB7i7&)pku0J;w0&2e8kv&?je<X$qBO%y19#F+#iQ;{_3G2@U
zd~pJ4uqM=WbVz4Hl=--Q+I=4ZO}!fRDx~<H?VtMA)(j}wpjxkoF%mQt{((Ig0$k4&
zBuc{DnHX++8WJopJ9B7%xu~wrX#IYEw~S@G(sydtd~)-}B(dOat){>^l*gFw`o}TW
z0fBvC!8oj#E6AJn$ydHY4UJwGRo@#CChKJs8JI#2@=*7STk`yzkKZJw>0i&+yR#Jf
z{bk}0zUIsb56k%Y%~hA=;D;7$iuv_?egli@u}>H7jd)0g(-UZsArsZ)METSGClD2p
zj@5%3(bNIZaRPk?laPum>DzmzoFaUm?*_h1XO5HoM5I}u4$OB&MMdAp2tAk-sB#rp
z-XdS8)tljnhA(!|Cgld2!f~_MTN$)aHj6%GT#ob*@{w0yja#5C!_EY9+>Fs)7;lng
z<$qHVMaq|tzk?z%sfy!s2}7^&@K&ise8Z095ZiSI+t9hDP_4yKoiCvyfA-o*a5+4P
z5}Q$*iErO>M__TV7XOM%h=@wa%L7+*H0y(IZJl7QYC`ke$b@)b$=t*<Rc4h!!jEy7
zlgt}KuX0hVW#4WNUs->>c=M>zIqfR~pv`UGfYj43KYnuV{xo(y<9KY=qV%{~>+6O4
zlQP5`Ea6wdvQNc~8fcG_gU2nIWf`8=x`^}ZI1=yC5^$2Db5-g>SpAEPM5^eIkB(*2
zuN5gXA~pLi0{wM5xM<`!?`dcKu)AUZfvhcn4rC(2HfKSTL7)6&`N7pNuy#nH3P_;<
zWGB=qj(<W4hY~pE#^&cqt5GhksG&vm?{=Ej4Z>>!T`#QDTnh~y9SiSzw=!i+zFG6K
zhK6LAxzWcaO@rqHmKgj#$V-Jh6UjF!Av{MPRfd~1|J-<=Xhjh%*^fRGM`Ui<ukehu
z&KBjV;rQN*$?xfSf%d^2Dj^|8l_4vZ3?{DZ!cW_CI(u_E-+6TrPwk|J$f8)qp`sBr
za4{&4;zw{Tam&(ued1&J{&wYH$PC3B0iAr6=(tbxQu&!2TpPt7^;HC>&Mf7^jh_d*
zDLe$i1FqWW5h<VxnU$5!V1fe`Sz?O3;mgnzEE4|SHYP$$0Ip?}loCAuh_8JI^9_vf
z0gM)w-_XMn;@0;jx(}uYiqTORd04-|WF!!Wh9e`k7Twmu7C{IMyy;QezUO-+;5M&w
zHoT)r4ZD|VHy1ZII;0dRcaSNIZ@R8x`nExH0a~>RCE=UZzg0zHg3JFD0ld5kf6q^P
zStGN5%@2Ma(p6S;33oj4=%A=2302MfKuHte8%oIYt}GhT=OO8gspiN0VA-5ZM!)D)
zUBIy#jwCBv&#o}J7ad9fJ_;Rp8PE>U{gc>RDgSz~d7)egqbM)CzFT@ztisecX4yAg
z&_8Vnuw%dCRAd^@vC!6VMo6p3l5I|2Rpk8lfxr_bzAi2ymT(od0(D>tYwVYBa1&(c
zBkM@prq+jRaiNRVDMo_$U<8*{X$lBeDC0<7cw%0ygQD>U+mOQ>OqDP#%d1m@L{FR&
zYLO83O<ydw4^Z^M<SO;)x#NE&afLAexB!S4@uZ+Y74e?cBrNM`uIh^GDB)7b_OsF%
z*!!@MX``hgy7GwRVKeCCb9b3Qs`)}MKom~}85|CE$y~hA1~;Lg2%3RnSOjDGQ%YV1
zF}vh<*twPLidk35i8Y{ZP`&rO?2e3_9E}fZDI>;T6i*bC{K3wk1OuaU^hPuPY=bs3
z+yivfXg75hbNF{acB_sp5cV+Z<gJNxkOqMWRU~5yIi(%+_&c;&*B$8ceX_NsY<OTl
z#=EN-Lahh5G7NE&%no|ZYRZ8GotFT<xO@M;86cye^NR!+mi6?c6{eEGK&Tc`2!#Tx
z6cTYp#(=7nvU>@G_%Buxy2?25J%C&54|~W6R5hybPZ!+cWQ^%Ss|>dT{u*>y;FA43
zKHdTIh2pDs)Zl*odd&~Ya@a0a{~A#%u4CP7GZfnc9R_%_OuwW%SR?$hGwbW?JvW=r
z-B<EUC-}{_$_cJ{ZjKAg)yS9@oR~0PRWA$h#Po}Uyu+7rs5VPRuDkG=@<+c0Prb!(
z$EKyxAdAnqYF1dqc-ApNjD7e-DDwUYdD9$6PO8dS$6qirtnPfT5w2G<f8r1-zerdZ
z6)>Iys4+Z8+0*}jG+yqw%+DPlLu7bb9Y|@B*$8JDS7#KLm-|=g5bjhCIXZ#UIFh(%
zU>59xI8i7Mz<ihnWo7G!f`TBJ6m}IiKzvDz?BZFjt4PB;8ws6DVTi__c2g8C1{x$$
zn*p^AC4}~PVH8L0H2}T<Ze&-$57ZPg<--H{vMl&L*b=NYeje7yeLr3FPTTk#<Yl+0
zCZlmj0V@i>zz6eL@1_GEt;+1uQUq}P#Ts(k7Xa>pumS(!J9#^NDnxd{a7a$Scqq>6
zW_{@GbQSV7O|X}Zfr$wWFgplCvJU%hy^l}VD6aZQS`N^m4H$qb@(gN0X%H<ye}E@+
z0z>iIkU4L54cqhxocn@(z+`tuc>SblfwyVo{2a*_ooysI1GRL`0e(S}m&k8p_dXkh
zn?#R`ad0;3eZTZo&s$`2)EWf-twC0v(d*aA$Zt^*Ir)b-`b#v?`20VNk=HKg<423>
z<Q2thQDkGxZ9Bi9^=pUOKKL!z?RZZ@x<%pkK&A-52Ez+VPNj{JeV|Z)27Y{LNeO6s
z(2iBI@jwr;nwjMyAn$r#XlztOUx$6CrvEV659^zRHwWhf9-y;8djTqLNHyxG7ad{3
zUghaZ5f?|8yvU>{;1t?EIY)}AEFSgb0{rMja^O@Flaexs9RDPDRXay*T?axqB!R*H
zW?Qb(%d4A6^8oghcb-FX?9E+U;55}1X#|3d-|fIq+<H_3>TIC1pZ~eaP0$}el4v39
zEz&R<5HO_B?K4dR<OZz`M?+O@t;xeA;32aiYiM1DWeg97dVxK_)W#<C-Mj0ms;Yn`
zO3(gj4@6Zio#Eo+gJu^SUS7x6K>uJwu$mDFM*wBU;%Q}!!?bJ634iS691qlv^Ts>l
z<lv3M8=*B%Uodr5X+ePouo%p0feBZX68QiLZ}0AQgEZi)b^9;>D2yoaT%WaONx>BP
z@$qqBDvbd4hEr8Kugi%y>B%aRvY4Zdz3GyJZ4b0K1TPirDdyDGB}PR>MMl8U7W8eO
z1Yj;muaK0L4X#oGPLy!2w4@{tfT7hby<KDh`2uXu|LZaVAEYuLzh3$I5pMlWG*l=$
zK@hG08TVCs^f8v&s$iu=T2*`3003gJxqLVjfe;|afs2K|4~>2})Ls(omzpK)#?N2y
zlwv2=AAYvH|MweC@(aSZk%|0Oq+#zaE<6j)1!p5)m7M65;o{ly#E0a5KVH|NiF)Y_
z@D!T@{i<_uHO2>BXP*rxzQl8V-S5X_+e_@=P}+)?W6R9Ud<*pSwh$iq*yzB3X#RxC
z^XG$cn)-JSN&hh|_{2_n;=Ws$`8hdd&gO1BRGE2i`@;H7kueZ)vfTEK9Z6`^yfB0d
zX1V}&k*Qn;dQ*R%wLrW!LlyFY345woS@f&@&gW;RYo+4?rW-Wx6`jA)ENE-upNqfU
z_?dg_MIV^5Kt&LZyA1<)>}s>8thOZbec1;NiOmn`@lZX>-8-SL1~5|2`6Y?f!?#^|
zKG{Lal9eN}N!N5?!k%nyGD$O6lKgR&Ct&t;cz^#IgZcCbNL=F9rP0&Vy7j18aM5-f
zw}ZAB68n<mbzSFPAX}fHMbJpV?FRY@7A9zgJ6qhkxRCM*cugQgG#LyW5XQJ=t66mH
zMgw_C<A7a)lOF61NNO3jPCC<F!&q55{n7-mt!Jw<cM|Wkujg2v&V?<Uotl(7+Vyov
z-G37&B~p==mo=M}xOyn#kGOdwSCvVENIWI1UgHrs>?(^afF4rJ=d$ad!8@l{xju~B
zq7|OkFD`gL$c>$j8J%2#K$>wK*N2IT33L#Co$qgtRyguQ4&{ulvqE1lj7v;F{@JH%
z7snY_Lx5{h>$m3Q_<QWtGaO+XtRYur9f6Ie>a%CvAT^^=ROrgS4#5RrLr?%;2B0q?
zk~R1$es=`r_=JS?K9v&uy+Oc)RINaJ3|k4fWTcR=H#Ob!{1tOvyS255)}FazF6x7P
zUYlGh5$?^Is_30>@fBG><v@!#HZ#M!6fBw7^G;lRYxN#CLBvzm9o8vRq;jI$7{!d<
zpeq~VE~~lU_E8~F_L`0r?dn#pyY4OagO<k~B18c&-BQc=Lx=$5It_e0RjGsB+NBYw
zbh=vqF0?uhbI%-{FI}a#UTm<dEZqv(+ON;BJe&>Qz-L)`_fQ3Sy=8%$V*ih$NKH*m
z{64cTk8&eFvs&i?3@gzepJ4vVWXSnt$AJ&R;qSr185dT{AxY*_$!TuZYdD>nob0-2
z(iXrLX*MFuaJ%6C%4fe~64BD5Sz@<*^b%dAxmIIGMnEeNsC%eO6hS>M&5~RXyNu2l
zEwfO{M~n}t`+w^d=n;TygF435l}DqH+Z2xWNfVhB`if~~oO5WF>0kEub^w~w3q!lW
z-o=hoEzDO1F=TkETD2g7<7xwVWW6vcm8Au)_810U2K@Q++UxI*fz&QaBF0$r{6B1+
zKxS(LVw<2F!|-hbD{JoKeTyg-bn?`9cF^lrL{Yi@g)Q+Moqbj@_tPilb=DO_lsih|
zA$KEsJE1>QE>KSu^3bT+8XdPh-G;^6wN`rc=R?5gl@eLPqs>EhO>Wg_BE8Bkr)0n0
z;8T5_zF;#u6R{kPM?tf^ES%`%g8~p0q>4$gZu{`2*NC_TVuRyReC5q`2#VZ*FYL2M
zNOKuFpM%Hd_4VrVWU#`OBk0qK?lwFud~NV|K#dCK9T|`q%NKMS!p0hl8TM|up#cf!
z*)9-|eJOYAh%fY#!bJn|jD@u|&4UNF@!P+2S05m;2{_vU85~Mxe8|mBcb=S7V0HiM
z8_s=!`A+Zq`)ks@w531OR)5P`*V{=k4REj@9THy~ylbTUv7AbkCApdqMPA&BEtWB|
zvY*y1ZE6zTrd(@!h}`h-Z!)1b5*5JL#wf{WVPRQ=<dg~>LviHzl&2NjiI4SY$A3Ld
zZ+w+9{I1;)#6cB6-h%!sp-ME+h0UH1&EpUH40*8sV@x*HDpDdOF}jfATz^ua2&-v>
zY}Dl_-<iJU_lP7ZW+yv=)-c|az@mR2NqmS)A+}FfhGss?_8}hnAK7#?e9V+#;=|e6
zxWH5WH^5DSCVTwW>hcL}o%$L(dE!VNMF+h)rWT<Vv_Cn(^gUA|!5*7L7WI&w2E_&F
zH<WdC$$xdr3L5pQ-hdbcFv`MQi-`Y0rmloeneJ_402Bd(qQx4IF7a{E`g*o9qXnz{
z))-mML5k-4v%M&NeG&VWYgcE?z%cboov24<>Ye_q(t#2<NTTVTi3FE`0P{;nb~6bA
zENfdy`>GxP2~%p!pP-h5c{2K?yl^H_J1rIk_biMpJ}Q0G75EKiQ1(H_N<XqT>lL|l
z+)iYSlNAP`#L?}mgWFBVY5ThWhgMnnqE9dOpw|cGU_m4y#5jyV%msiGlT%aOp6vt^
z*T*p0mh)oZOasc8z)@C$jguGy4ZQU*wd_530BT@z?+1*qnJVn3xZoBvF*Nk~`O}4s
zb;Nk<ee&toL%eWT#lwSgFR#lZcTkJ?@31rG3z~b~Q*%h>>c8b&Yytlc|EoQ6V2!mt
z2TNYaDk(+CUK9}(-i@r~r%{L3`?FG-K)}*|#PgV-z*N09YbsR6@v*U|&dyxO*~L&P
zZ#rk3r@AaEr3?0hm#6*3*N(0zcy`o1yRH*(Juq?zc|Ft9Jwjgy6+ty@2;=wy>v!BT
zZ3ET)=XPD;z=HW!#`~Ry>)%Avfi?y21@PcV_E%AHB+Hv3qRQDJ8?tq|;h969%^ENK
zRr8yPNpiTz&(phAf7~xNjs*_~+`mriwuLng&Z(voIX!H%qQ_GcAg;^;2p-B#Y79|z
zc(=hhEd;J-08T-fgZ30j&`wTH);&rJ?0a_2qH=Cp98K9XBRn+p0H%GyJR9UNYsY$B
z&pqc1vHS^eQBeOD(EBImE5l<D{g038gVqbWM7h3sxm+KJsDrfzg%-#LVUBh58#3x3
zQ3w`h8rM)!DYwXZKyDoL4{MsAhjSZ5eDA&_(o7=;9HVaUxe{krthNx+gaKoUZN`<r
zljL6Dk<8GjSEaxLI)jmw8pmmp?K;O-=$dw{lEw1!m~PxyLjmE>Kf2_C%6}l3UPai4
zrQkZpH1~3GbhI1ts#LBqVop|nMx*v325Ep-YX%HZ1$$v9a#$&dZjqyg;k`rF4l;}|
zMgWRL5G3d^ODYj!1+ga#B5kE0%!S1WWfWO$h(w(VAJ}Hw4Jqm9Bx;iTEYJXThe~Dw
z76i=Ciaw6tqSoXs0H1j2OiXezGxrLHFNd|k^_i-;*x0g?yTbSw2d_(mGFl&Y9e?4u
zMbGf+%HYP;<rWTG@t8_!S`g#r))u>mW(Fk&Uo#iaQ=Kqo*0;$R1UnAl&sjAddCd^u
zhyR}zpjG59N+{w`s5OxTnkdsuHiyGwqC!NKPBFro8Qtb#QcmFJ`PUO+KrzqSZV0!*
zc?7ErU@6+0$Us>bd@|@%4pQPu)i%&@L%<{xsryO*38dhxHekb(yoYn+y5C#yWdaWg
zLdnS8)jO7d=4^N-=I4V)w@d&&had*=raZUQY$9fu%k0;V{1IRn!rQ+M+J%}1{F<pa
z4x^KQo6J-J75zPZFLM`ED=*{8O8(ow)xXcG#EID{*4V^6LPP1Xy)U_o1Muf9#riv`
zuAIh>Ca=!RJv?WHynfh;;6!9BH|J<DfBqC_!7V$krmnvE{bT=xN?Lw)31ygV92d!C
zoRv922~ik$?us>F;;@*`SYNvpjQX>|4qTiRh^7bhO1>avY3EnZPi@GfL0D6xv+f<I
z*fj*f;c2+(rt5jwP0sJ+f6}xigpiBxDWU_tv&<}H1=kI)>0ttGhk*)VC!jDP#FP-t
zj>3|lf@m5LJwp$mtfSNLO}gIVX6^k^C@IIr+LxD?S(REXX8ilm4IS3Y%gU6A<vv{e
zBou!0Avt2dczyI8=jAxhh{5CDBo`LGhqt8O>6xbAec{}Ghpa--hFMuHGDV0*ph8P1
zc4DWO!+7mSWL)J|u}k>ec82<jkfXq--CyWvp7%vuBQj(f6W%hBu)8YBw2sO@s}wR=
zrl`;p&m8U)-TTv|tnmn%M_><u6qjZpJ!FYrYmKM&F;3>6UaQcG2}%^Wj>IovTE%yI
zf-$t$4;03biSIeyh3d>ekwB0+M1vt?@cYbOH<Kdkl0wu&zds<f=(l@#ub*d#$OqgC
zAOM7L2CXon@}lNM#4Vn9*zzKCQRqppeP5=Ju%L+u$$ZA*{z{G$RJ@x>t%6D)J_eb*
z;R$z@H+22OC%nFO8X2t4ZNu!O7Gs$u|5&<UTFl6`!38h%$a*{R2ukjrIV!As^p7vy
z1vKBPqI4(ez_%9k$>a($#EloJSEx?qSU&?1Ti@qTGD=BjwW26?_J{;_p9PY(jbA1&
z&%b53j6Yt<G4BZS>I&}vzVgkT@3PU(>oUrQC%&J;DCkwNcBV4;4qy|@1|3AAy~G6g
zd7=3!oRYMai0LD3gN}PmJBykp6m<8-50m&DmfMQf@GN73x{ax5XiOAl*&g_x&SPR?
zy3I6xtsZ(FqxEm~u+GT9*tm(AnHxhGRP_pZopg2Akx8N)cM_A6vtaK9PjB5`Mz<AW
z*Yz<#>rg!w-czE*YpYkdkL;EsNG+x?UAfnter-B=qP*2S9~PVu9&zru`R;+8A~rui
z-QQ|bhifMGUc>p6dYzj`tU3b^0qQoX`-}bcZ_VGFT*=@16PBB;duh+?zuZClXQ!w?
zBQZZjUvA&>I33;Lm8z2DV|_0%sLMi{=x!gVfIX%)M*9%;&i;uFb#GgNI`gE}OLYZ$
zC<RSTO}nP9A?dSGuiupy0Kp)Zh4$TVFG1}`(j3&X9xccB`scTz42Xe#dGTGdHF%Jx
z<mErp0J!!*y#tl3>WPtw$yx<}b%@3zAfF(&2Gl$F2`=`GqBq;>(|V%r$i4S-GcsUC
z<%5RY+IpvmK0=%-Sgl&My(F33b!z>fdvM2+tom4V3r*y8CcC()J&z8Nu5wY1&Q{i=
zVI|w(2+V4V44l|LG6}L;cej=|zUE<T<D*u`Ycn#f_>%1fQ{NMdEbzJQ`S7B8#KYe{
zw@7nHmIwF#P;JYv2S`bK;}^l-vnEKu0kS~nevg6d%;@@!8}5I$^HGpP*y~o_k)5_)
zowrI*ygDA{b>442k-ds|wR@sN4_j-IGzewjLKBD03Nlw=szTTt7CZ9bfxZjyZb0`&
z{9QwaiG1Lkfwu;3?qXhPAk8=8U~u5E0d)&fk%&+IG#c64%GO|iArMl#IGV)mZO9`g
z^tQ@HH89*vuoEFC!*sYsgo_xmh&4N^Vm`uVU>x`ynU+V#ASR`6M(Uo_kW^KwAt4!z
z8K?TTm!fTrz~LO#{_?TUAemv`4`ajm?zY&Nb|#V-oc*HRx(5FD?D{Gczl60y;{>tz
z@L6CSg&$}vfmqHV3L_t?HV+~RBE3dpnd7*32=jKakaNh-ww1gGGOjMnkx^^Hf47yg
zH45uN73;SA_J;AiFq{Q2L1H+FfMK@TgBKxkc^EMVVe_Ew1o;p;1)1(iA}!CqSA>=t
zom`NuI4jE+ym4}PHPRq$6#rocGqPye*&*c9m9~jMhtQ`zOYY}SIhXI+j~4Ch?GuXo
zX-Iw1bB1@<PV7UE3f07ZDhlMb77WigTB@NW@NA5!#s_>?@QC-J{0uMt7t@rfmB)O$
z#$7);$b3}teO2;N|5i~rG@Wtd9lP3t+{||8h{+*+t8MzI&YhILqf@!$<D9Vu%=Quj
zOAgRt$m3)zCsG<E@gs&IEB$AvpOE58KvtkLI|Es{&*&D?F<ZNE@A!8!$Vh>@mRr4T
z2v#xpzhi*h*q9L+ZmT!FAo)WLG?`PH2E&jOQc2$so8X6};HYuYkTEn+f&eZ?)tei@
zg)OcKsvlT5AP`akHN8Y#eCKt*W587cq)UXU2SHH20qf3ntRUEAVQ#xLp5I26c}M?#
z1opAFxdNXc7w?U2Cgzek-JvCW_S_Z@7aAlh0taS;@7cCysYu)Bsu+fd7J0iD*VIN3
zt`QU|3-5<_JAXKsIKD2cH?uMH^g;=fefmi<KqFf;AxkoU>ccY@rv7o&sO;>Aym14I
zN&BmzYXl7MR)ufU;uTD|-6S0gmiz%wh1VN6Y%)e`KTzn?mR?(BM-V`2K_?oiS%Xja
zF@&p`LFyN$2*Z&48pexh19kPTzP>)+h(^$FA$e;6I^aEV1gQ2HjO)&z=hLp)u@6Ju
zr5^zAK<fjVH+VatEfY&`N=Uv=%>XAeyiSCe=#alc3F`*PTkSnBnr`5FA0{DI$F&>p
zWc`JB8y*#f`ypc@+v`R`O^2F(KP%@w?@`Qak9g<=OV3DpTTOh7h0?-e1h39P?l77=
zJ&TbuWjLA-1ikjtm6rVj<B@4;oTCx8xp$tH{^a&ec_OMk26jiwR@l&txn%3$S1X>c
zrF3Hol;!xA1bs6tzqyeq{_KBvOPh``aRsugCeODaEG7Q38RoM<P|sYwGec?1A7%&%
zz3uThW+)Qb^hxf;n3S38LBS8#qxHx(Dv+=&(fA%2Sqd-DgE1xxU^SpFh0c1sn>A|n
zwiz`wC<l<HonnoY1Nw-1K0#P#ZX)j$aaMo%siKhZZXRc*z4%ekuN|-WOF64++eOyb
z0Ydux+BvMNbU+>=s#;~OfEb~3^OXlM^XCZ?^7u62mOG7LgSmNO7Db!p!pC=oPup*^
z{o#dXrU{r97(Oy`{$+MH(S^Lz2*$pH^bV5x;HAbyzS!bjI(4_XNW$9NpTheCjy_|U
zE@6~pKavKIt35^nj5?y>3RtfQb&CSG4`7&%<rQds?nm?zoK*Wk#{q6=utfrI5#Bg8
zYzz>H+8@rAV;f%jogpu+3@ih$UICt&K9LiCVqb;VTho;=7uwBDt6{FMzduSf4NE&y
zTr7*)Cnyn}JSZ`!Cs@*kHK-O>_W`#LH3V3L3b^d51=8G$QYIm{!k8z;9T<W+@Ny#{
z903#pmG(<5Wi!^cw%t3wWHTyhqmca^{s0i*U{wNu1w`P`++dzl6P02tf~g74?x(oK
zX{`9$d^HwOUczDoG5dc)WUWt+Lr><Z+ZFC(2KdIu$G_NZu;!fusXC7Sy)uMydhrHU
z!c6u(>uiBn?yPUA=_W0z0eV!^&;XA>#*2W5uYx73s?&o4Ip_zn=%%>=luJrX1g06O
zHuSH`irV2WK_g3)Musdp-T{H6kfz>CA_x@bx-D|S!C`Xkxa3u{oE3r}vUcq~78Yo+
zl0iz84tvqp!|+$2w}Z5bEg0W`Orrr^y1{STi|3TcE&&ak%dpCTA%oTxwmP!Io3eZK
zxc?^-i3OY=2LF&WpGTMjpFL3u_GXAh8Ex=W@;~)YdVC4*u#CceI1C4Mc1{v%9QQ8Y
zkg*x~s8>fT{U}_|_F$Ht`p75T(vVL8iua1jN;(x##uQDy000w4?&yDi2=GjiNd+-T
z4ryoq&@wQ*hqoHKN>QD$p)Xfsup<*CJ;wygb%=<*VAu!b?kapfH|hi&2ZBrTGc@A2
zbCx`s^<hf|(Tq=QEMfYa-`XwbU-peF=Riug4&*b#3B+(DlRit3{<mhulTmR1)rWR&
zZcfI_OBhTrAa)d3dk%_L-`WCLFs2Q>gopS(t9<nk^c(qQ6!(&K*#fo)B(XCyBlRD#
z14>0$^J}CsI?_*I<z^E237+cSMlEY)OYrzQCT;oqd9O^klfOd^dpcUHYk=reunGeg
z0lFoWO0@*D$|M+w(WJj$#6$|g$W)E`GZ2-iLNgEQa9@o_&Qb*u))JM|DNm@WV5fsK
zcnj;YB`?oxdJ7(b(^tYs+H&M-UG0Hx3|8w?T+?m+X9en<GwmSvh6s50w0QP0i<Vkr
z1`fu?zA(2`!urQ*5-Kse#YZT&0*mV1{-W%8H^eNZCzbo1eja&vxqb8}67oa8^6=j@
zU)aiHLw_2niu{~#U@<+TV8!T837m>d*9+btOv+R}L5dkRU<WD6BP^rD(1OW#IX?e+
z!)3(%ohxqd<zO>Zld_eIFZ-%}{-5ZfNx?}1(T!mW+4_*XXLOgTmj?X@q-fu{6&ex2
z&iG{Qo_lJ@)W%xL(zbhnIVt)<H_P|>OWz~#k`rH_l=?#odp{JZP-Dq{Niv=(oHYbw
zKd5u%NwG$@Y5|Z@k;5GBY=fNkeEQb@9>Pe4+<dSZw<JRB1#NT@Haz_x8^}L;{rWW^
zOZsIoJj7WtC^vW?t#55PLsKlNM@I7=k(!>KS6v<VgtE+{vtM^T6mfk&#@E+ZLLoO!
z_JwYi4Smc_NNvV01m1<3hAYJT!k#Ao2J5#+vX_6Gcj|L2SN;-=ep|P~PiWUGrOxV(
zp0Y|K$;Cf;rJ+F#%ue1+L$Wnus|2suFt{sNG81gQ=MdI#Tx78>UZNwGG8|9nW1R@6
zAT<{BT+oQBGsl^xvhqgpyamKM8y@VLXN7!mVE6T&|8TT}0|#|HX;6qxS;h762UIGp
zCjBmfd3l-2kkz`qv$N(Milca&QRZ2DEgQR;b(B@VbdQb_ic|=cX?8A<l|kuFaDCwe
zJitUU@@ZM@4~y2UrV__TgX}Tj_#OwWEV>g@I$VYln*WI27<rUZqknJFQ1ikoK63bg
zfUH^C*yI3-Y{#(UK;zSH%rYOorW|NFE1d;eIBBL#kP&}OF*GJJ#^QEo4bWBL89Rqa
zY}xD|T{B33(N1JseumIB4A0k^!syHlz+iX6eq8;`cwIIWv=oeAL}{%Eb<21&Ew;I8
z+n@fVmzR@EnOQFTZ2r1<5<%bbK|8cBE<RqCJFQ*gQM<;Ia@aJYP-_4o>F00!cQ5gY
z+H2@Q*-p;qVAvm}U0$J%$unyxz`($e7rquSO@c;cg95M^WT14fI1C;A40#70ZifWN
zoEX9Nk0^vEeiPfVS>eXw%(xiKzi)aTo?M4MZE%L@pj>W7u0yS;_+iTMah8TLrx)^+
zE#lUo329y;wsOElM=JiI2dYGqIk3?`yz{qs3enS`SjK@>ll3;qIT7%zxnM~)l#d#P
zFUn(NDjv$DbH|ALQ(}M~7wI2^KL#n^O*uSP9;BoV`S{%g!67C7sD)9ti{QKJ7%FfS
zpnZS>5|pM7_*dD;v+#UY9=ZEh+EwATfnEvJlEAIPeXalxAX6~2{v_z8ZwoJpE#-t{
zg%a+0d0->;tb+ozHOy{V?<_*bfnIw3x`9@axI#kPvZzbD4fw0dJbpAR{K`3b*tcC9
zVQwEy5HwMsPF7qLKb0*-3H8q%xrZ5GEW<*|srq;(m>#@$0!nD8ZxbVc!HY`g>Yt~D
z<3_v-QrTZOr~gOW5xkDVCPE?H+DHfe?|-6<Raa^fC4aA0@AgLfe+V2%5ZJzLlkCo~
zV75so3&vB=V=Mz%4kMo7JlUpyii@_ripKTQN~1Pnsacqd;HSaT7je7Sn4r}V7|Bv5
zZ0-6u1wRw28PgXphDpn(A%#q}Ak{nsU&c1&wB_=7DW|S<Bov$=YeEV$;Z%U+<EaYt
zi0YWNi%3S4JNt|kr<V~u2yZHYR_>tjo&}n4f3f3*o1#MD=l1&lQWOG#mj;KxV=IOW
zEetzUJhZpRTce|&ishh+-}z&#&Kye#=Cl9NC4kI<k)k4a%>n(x>^iWUrq-T8;?fWZ
zArlF+7eIhO^HMmN<cXsQYU;P74)!OuUZf;EBQ}Mn0^PlV2JNK=o}QGraBo!A)gKKK
zON1suFABM0K-#N<cWZM`QVzuG8=$C-iir^epDoapKz-t+DKZ2dfc>;T1%@L#Ys?&~
zx=LX+hl@`ldK&#DJShep{Td>P!scwutgJA7AkmRKhe)BW_X!~Y%F*exum8RIjD*22
z@Vq%<P>Ioyz#;UrfUV+<5`@RqtMtK&gW+rdM@8ow2(r=2y`;R6pH^5{2*&#ax-2{y
zH04knuv9?lB@DW<T#NL?BWz-CL~kQK%B;ba#!Q`C`R$f(A;Y}JXpSIfZTtdHD|V>8
zdkcq0qU7U8#Me)@Tq(n<<w6{CAE4>#)k8yz3H)Z9CD|T;zmjRAT&1(i`ZO^qsXm8N
zCrqy`6IZ15P>Z2Xmzs+!21YcoHGHGqz5`PzwR;WizVl7iQ^QQVb0qT^s5R2~^w9SV
zHa@uhV(`*-gk1Tde@NU!TQz$_LoK-~D)F-8E*;5ELkN{lBh1emUtAO%{4Kh;S>JKn
zEPSgR7u6wi*C(k8M*a3~yMR(bR9`=x7Dr6tro>o*M&Z^}4SEX0tCueUUk9N?8n+Bh
z6#cAIOkm%fC~UcY)R-M`H~;+kv#IbIq?_qm3W*=-Bi&{Y!CPVCMbLRC2wn$gAyf@8
z+LIO8zr%x7)K&Pf-+JYB38O6?H;3+mCIhGn{Uc8B^}!f|G^zXU{=g-`Ow3_$`-nko
z>z#!Em3~ETzQyW>k~RU>A6R*1bMb2zhC!?Zn)dkd)Wep~!6aeJSaFb^L0=-iuwG6W
zB7yKL*6Y&ggpx=*szF&rBr5&pjZQOOCT2Pk^)1$hd#gWVK?4b37mViF5j><Ir@KY$
z-@X9<CEUsF3W3cljx7{=xVE9;o<$rj{^8-ZG}Lh3sGOuJD{gmp_wlgt#hawYGQEp`
zhQ%ee@QGf8)+Xu=U31vuM3{vUli$0y5yX(bT;6*>W`Gxx(l0~w8eLT&4{@OeTm`}h
zZ*P|YLF@$<OaEVq-d88yTW@dNU;dma25yAI(yKqEx?X1+U~M+dc_{mDA=3(=LO4D|
zE=0!-fL99d*}W+8K;KnJ--7N^$u%XZ8<$;iRl>C7AX+VUNRKx*Qmb!XqG*ADqH*^8
zMc0q(9{`%HiVeu7UiE-d9XX4%U+lqTO~((65Jp625dJ6iPuee^fg6Y%a&>_xlDk(1
z_5j(;AYYEuM`nx~#v~3oUHECwEqr?x|0wv(=zAzw`D+cNaLmtu=%pUNw{5sO3yf)8
zNM|y#)J4XmF8!IV&2j#!+4|=h_$O-;YY&m`F2sABdzd@>;Dugp_q!Nuy}$ye<v9ZB
zQ)Xgg+e8kU%eYu)F!`F-DghVY9}LMG5H}~|?JWYbi0HUrMl}2|Mp5u%z*Y&OX$F@!
zhpVR5I>`Kj4X1MV<ITF+FKAr6sCBW`a<nSpM~ipI1WaA=aM5C&@2^2J!}fO6P+>Ob
zPYvcctZDq~QW&uAQNZE~4_5U?(dbr81N&AUr=Rsr8t%QY8$q}}PNjI{e+wa-;lHE_
z<Rr0$U8n;Al~tg`P2`<si+|IikrlcsP>!JhL>chu{ey#Rp9)J>;SxdLAmh)D%!7ra
z(gC^wX%U!DkHq(zPFF)@Q0~wn*&gFne!pk9Xdsp6Bn?yLdTU{g7#qG8jt(vY$Qz{<
zMSGf9Efge5$e6E~28q1E&@%c@ihzt7z&wt|O~;uMJ!I~TT%~06D)Xp}M6vqvZ*-7^
z$C@@1brbfUGR4Wd?#|Oa4`x_o%uGc6edY-rEt4#?2K~dsaaob=UlNQJ;@S-px!3q0
z*{WUid}<b*{NmzJU(C~BV{1!JrK5W&+7I1GLqlUWBdT=+V_6i=qV4Ny`4i>PohD{*
z=>Ttz$T{&r8jZmmHdroW?TZ9SjLYUOMLZ1d(`)PLzp*laNRQV``6vG$Q&$00<=U+`
zr8G!NNSBCoN{Vy|N-5nbEg^_>Z&CyVK|&CamhJ{A5s{MIASw+?NO;%w+&gn;nDd{1
z4g>7(dt<GqR&A3VqirG03yjd1OG3v)i32R$I&rkx@_9<ve2{-s@{+^2h}8v|XjMsx
z-gYnz^AC6Mm^f8TIzfTH<v&^0w8%KJ<5Akw)cnFokN@j|)cG*K*Ho*?M&tU^F^NE^
z_Mm(QsR$Se-A5vaY#%WhgZrY>URWLwD<WD*g}u&=fdj^IO88bp2Pgo(wBS*Zv32#D
z^P5{(1pg4=_+VaF!boSCOR7mLVf%`CSX|y-dx&N&t!Drz-Zx8(!_KMvRI#0a>G=84
zKv|>Bok~{{wkg2TY&o)iAYe5d9*(2Hk|dJq-OHa&Vbx!mm~gkr%K5qGzyjxRp<Vq|
zjzr4{O;30C^fH2DaHS2~`$&T}juyltqbFIPXa?2F-nYN%B$s1&5bA`JSXNzIS7!+|
z=SEv_RSkjwyj9rw<G5)<y$ufsGYM&YsIZ(<l)-ugF7B8*PZdy2g6Zq^xV>P!_u!>R
zdicY)?o^70e&<f$ys~Ziw;YNi5RP!CqQjl<mUOWEWRlF}pXX&hVUh5|-c*ycw9j*(
zg%$#YIW&|0HnEnQS24rcGgf65Hm`0v%VT<vm5<n}$6Q!sYFG<C(CMq`rNwZy#vHsf
z(-b5NvzeC*GhJqP{h{;pyhZKdUi<!iPhz0Ch;Ms3bq_V2FXlkL^=k)Oi1_D7xvpw6
zhZ|0h!AXV(+z?z?z(oi=Dl`+IQ1LEu2i2w3K150L(4Mf3^TMAEe=}G_F%S{QWz<{A
zH!snB*ek;0jBgW;roBu5v{hQsAwAcDw$q+|fgdML7W;f!_(c|jy(1lSOsU(SI3i(0
zu?lX6?{9VPz=Iu2X8peuh<iy0GG-=90%l4)CUSz@=P}6xRmQxL#=Lhw3`)YxC(vj?
zoNLAtzBl(Wgl~-&Y35&LHGjQ}%|EsNpeftLn|A@An3P!R*j{+#=?f@%uE(zZSKLG;
zpKYeIm!l)S0i8IzIBJLKl#+;dx1tjmW#iG#dmM>xk{D7Lt2$&rQG-ew>MHc2g^Ms>
z>_q;0kXBI&P0co_mhKceFyk@JnPkp7WT`W{)u|x8f52SUsf`iwS@t=r*5*4Qk!BdS
zQtpPSuNwX!m%bU3#`g-K2rV4hqiB>#N6iT@aB*DILu55N>HJV*{5a3T<XOt(Y)4Lx
zou3aW*nb%qH)g&Qs}%7KU*aM6n*BJ}M?>aN-4-=cI$GMRZ-i)(g3V#hz1+2*cqb}<
zT3+dpFL`Kei>S_j26QZ<#o;GfvjF%ooTK13yH^ji@3#V@rgYY&fK=<3h08~$1XLA*
zl9EH8ar;p2=wN09NEJsm4UdkFQ0O!jNF=}p-nV(Xi2!|XeEe^iP{4-KA{efE%+4px
zC|Bth@s{wI65b_^(J?ny<-K`>12E;-&yg4>9Pq7m!A^8=z=IwF)H`##SY_I*=7;Ci
zF!ZtS_pnkf9#dujS)_n_W1ppftwDS&iFF=7=zIfyB|kYk4kJ4H>p=XhtqhMc=64Q>
zux9smg5?wTD2IMJGuN}H<JXkx?%Yi>PkmRMdhhL;<y&jZZ+DYOqqOl9-eTvu1_=BG
zn(SP5|Hv@lH(@}MxJDg9qpstn6+VvK(?$wz#CiGk_fs$O>&prKXN6T`D4R9ALG=#a
zL5RS{4`+!cb)ksf_clNfT(iAN6-y&D0UAKqRQGrpXr@xMZA7mR*NGIS<1<lLX@?Vr
zK<YqyTqMJjs1w(`pVDAVLublhARtMDAtCZ48@vtF5YvplL^GJa+vPlcF@_k%LN79k
zkHW~cH5*uG18e(PbT=AkJFENOL3jobh;pAsr<D3R%MHurG#JRDt-DX(Xk)wO+f#qq
z`vZJ|e3|~8{BeFi=f=;4NvBWYPltmTJpwICJ8Tho%I`oj_36R)|I-4jaQ5Fk?(%;^
zn!A$j9+nIt!2V247pRICvEvW&75r<-YD>gaUInCnP95se9#n`ro;Q5?O3BlNGUD>7
z#7L^fM`8IY@psv{-%OZ?8|BkI!wvp!6I(1$Dut<a{6u1sT7F%^uAGfvA;ahY`nIc$
znCQ^Qp8s=!>BOpBSBW&k-Fs|mj&ELRaNKx#r~WGIl03^~XSR#+m<#fOsj2A%?VWul
zv0GD?WOC&iOyMj+$_Whf!dU!|BlW=M00*(S$EwQh(I2mHvl07T;xG*o1Tj#_(%x6B
zTe8I7JUD?-j4-)nD(-=h1Wc$N-8jaEvC{DP;V^@HAd_Q@+VZT$^gV%qBy_VYAY4}9
zzZy2T6#+V2=(6Dl0{u<KtXr&0m;H>1G^o?uT##_)5pPaoHTkpCFye%^TM5c$uObnK
z1|#J7K`+#BZj~BDGcX6d5>eCTX5Yxh(z(`c%6IsPk!N7PL7Pb~LpN^wp+J+<Q1XQt
z4^=1(v07che_mUL8~uTQ9pB;$O;@8I-?w>-ETi4!uOTFV4?od=C}7!K$m?4;#E<jR
z&1-##7p;&?p|8oJgDYXNQ+ox|(A1PTRjpUzgsI-l9@8+6-^u)3N3{7KGH9L_1p^LX
z<|BmES@Y|ZPO8>=yK<7_;;r&hV65(aLEJ_7StB(T6H$BO0Op~mLjpO14%p+Ij3TNs
zj8kDto){~PP=^M?=INW^aD3$n;rsq@&4dr}HuK~s5vAcXDe7FMqZ<;R4d2wNZK=vv
zKAePl55Q`e0C_1`u2PBpxeA*K8yU1uozP<g3X9GSVq@wlcAz%(L#fw)S8q!|JRj=$
z{#KR4cWYA3xmZ_@d-N>yxh`Hj5}6BAZs67%JM~MyIZcc@GOm){LP@XVFRwl);4Gx~
zwV5SyP4C*nqmIAZfH3^{`o+rb;gheG`54@dVa#SQ&Z2ed+wUjfc!5j7eYp!qn<BOD
z6ECBO-n+siOYWcymTOl?!sS)3HM3<VCPIcFWW!c#x=1{8%N70;P+HM{4@dTZix_<c
zGBKe{i*;iF^!GSaN*=-$r>+-B>$kIFP3gB?ib3%5@pYT?%N6UEM|%&x@6+T?Eu1%C
z<<6aSROF%vk<Uda>b%B?a+KW7GYQ*y^<}yC0SSxl{?0uE-rj1y4`)YW<s1DuM4!L?
zZcbKVY+p=(ysmEnvEhb15pcnB7`U<4+;@6|S=LO^U|~SMf=AoO&Zwo)=;rYudTL$D
za9?RJpL%_Fz~P2VYXM$l{ge>p6DSOFwWC0zGO*?Wd03!NNMh!MV+T*`g$kQ$n0A@I
zog#fq?kMGx%cOG2Ro4x`t_E5=uG9|&QYzkMuliBJkPh6vtRi^$E=@E2Mgv<=3#PAo
zC})tAxFYP5aeLS(N`T$KI~6}qB#rHTfDD>hpIBVXshabZUR6WPIDUV^k)RR(iUd7+
z3`ASt2OQ?g&N6Bn=iL-|05%7%n6AAkP2Vrh-Co+5DMImbJQ7vyYS;TN;?*{HO8VO3
z)r9p1t{^$xcAnAgz8jBkepcK)^|ysFvQDhr^Yic9-b4_Zqhn^40C=*N(4ip4%obZ?
z$PCZ7*f2~&kz#?*1$}0W_IJ3b`fDypUToc^8Wz8EoQA6LJ)TtjT33%Fw(T4wzhC%7
zU2Y%W;iZ<kmdcxJI`8hyR{)Zt$~vrTtbuRN9M4P^eU-fhNLp%MV{=nhn2H0X4FEeD
zzX&s<hODczc8qwv5g_V;!$QZK%I`Tb9N|eKpIQZy7QR3e^H}ItgIu9xP_zOjsQE#_
zvGOaxW2W2lUy?aIH^1WCM(&{Eao)?s^g+7ZYf`h}g$`M-4wj~iX<DS#!Xz;f@`%!-
zG&PQ{cw5T%B9>moT+cbrq7>d~hX=UvH3W71{C<2oMY1w5VRgLYsUNWSOmjE<`q!ok
z5!3;bWD#63K+&kritt>TE-|}HBGwpzAC1d6{Uzv#Xll8>$>wY$wp3v^$E<QG_ddb#
znSaxs%%f{$(by|{;=sBu{eD6tNX%9mR%|gTtjS6i%^&7wVS&Ms63r~&{3bCm7F}a7
z=BHn470lqd&d2vSassAh>>S<UPAwNmw^sYvpbc5;e4wd6d4Y_jM?V{}fxr|)p1y2p
z|Kv}{jY=H&S>4O#Pprj0{2KawoRM5<FN~iu_`GV+N@!IcF`?LOExA2U*v23Jx3w~?
z-^{2ZOnTs~S%Ix%^b7vx*4rLfF7}xpn6*w`vr9L@>p3_$fFLz^vJGvDNCgEXC(<-v
zeFm@P7OHQ3aX!>`<PSHk<^+u2?ga)8s-j8=($4$EUUPdO5P|`rDNIYMk)n$Vmp87j
z#h4;yC+{4SbqG^p?kwlPNwKL1r&XaxyyoFl>3h~~1Iu_-HZs*zZ?<<YKbIyEl*p5H
z*4JRBZ;KcA@XQn2Nio=Y<H5%Vd0t8h_Drq!kCO2Q{$Oh(tbWuM9^6|4w5yt&6!-$H
zy$cJbFmavgEXF;bUaqdR4lpey>FNy9kH(q|nap&UDij|f6hLI0_vF_R*+*fb`8<+#
z-=|mFCuc}w%CggRaa-&vsiqz|b&cMnOjH-WU{X`Qg}dBv`#WYA=2-=M@cQr#Uk6JZ
zv7NV_*U}!#m#GndgJJL>x{OlFpKg092{9=ie_B0o1SWZI-psA9uU~q^;mmTpRy6Fp
ze@3<)C?DAzxiURD5e75!BCsn55vO~LZ$HJixJ<KZAXI7mfGmScBO2H8Mz}F@F18lS
z@SX1qjX>%ol`ueX3J47Du>-w1m0mu58uo+Xz*r8KsRCj8^<SZQ+XDp_o$-$!gWzh3
zo8YNMCc0p2ObEmJgPSA*BEd#+4Q@G$V%pwt0s1;i32Ci{0LT=o*q~qIysLE{ex4)>
zTvBC5eW;3?9Sy5?7p*#Y#_eUqVvOH!hqD~%G;71CuM}Vvr|Xb?W+Re&$iJB#I8LM_
z*$+Bhe|dlX%!*z|ZzmnY<e7PRdGlbuLxHNeXv7jzbFbKVg4x&}Rz$#s$s_*J84K^e
zy`?b1oz@c1`O~0u1>EVMOs97bo#M*Ksy8NK^cl#O03k@B)rdObgi4&6#Yf<J&`F%_
z)DQ<-fg2dvI?WUP7=ciLAx{$hf1$-+K<pF$cO%2<htPu)UlH;GZa46g=mbL3tM8V!
z{)E-MZZMR~#W;acj5TORso5F}l?-d((UrT%S<(R3s0S=$=E@>Sr_;|3F70(p1x8Gy
z=5K3h`(^aQi<BN6FYItu(MPSA@qY9jq3o$eYQ0sUfaV+A9T1hHt)qj1RJvaoi@>b=
zIW;lS-MH)^1gorc5+8EG{FNQuR&8Xz8CyvG`ar+k)^sC(j;V)JkKNjg|6LIonc@u-
zB?jg&=lna4Z%jC-k-Z-<cqVbh4JvnhEWhP(#XRVDZ=Q!8hoh*YnvWWZlg18z7mV8b
zf`P6<h{ENA;bMKUI&E2X6;4T*KLW>VdS>PwppgNEh{-!Epu_OA*`Fq)D^4(0Xf9x(
zh(-DQu{m3*RWvr-75uxPf4%<=vV&L?+rQ4SCZ>9j5;~lzM~^yETPKgl4<^LDZ87-9
z!rg6kf;Q^vmOi=>{j{O@>f-Z>MS76!v%PSpsE9RI-k&7HT+5Qcj-Om#VB`;KkAF`z
zjW=U&I-~d9#_qi&HGI4i)-iSu0m$HFroe}gqLg8FD8P~9!6ptMZU~oSLNpp@E8tE@
z%k(nY^$G`5>`SZhP~CZR?=}w=I>_#|!^@c}O_9TbzP|<Wn<v*gd@ez4!ODq?9U`J9
z-HY(UdJ1v^9boVQP%o5fG3@8W$8+#zl8l6Pi=%fVOn&(#?JarihB$9LCDiee?1SCu
z48>!X(tNop?I54uQ%mNh*lK?<K^_8a+5KPklnQqm)KGFqrq?h0l|po!5O=doy2$O)
zD)SYQbUtFJ`DTA+%n{P~&xMzub@6^2oW})lS+`^D3x(fUh|G~oko^G1LV@;1u^6Fv
zF%es1*9xwD{&TqlB{3mpRk&GT?BKH7Rp0`kJsR%4grS2sNR3B!m#EZMRt8=rcPh7o
zS3ngqDE7APpnriJQ;>Wve3`F2Q|Z3U91h}dRaXDzd1ClU3H|pIuk4DopJ<|I{fI-C
zT5#|BSC^wg*#mThN3qyd#NqaQtbwUt_`!jHQ7{xD3!+SW3<wx{tK-&{O1w%G;Nn6I
z0=WmjaXsCg^ZF>bXV;FW@!Kw%-FcqqZ)`sl_Ml&w33Gb#xpE|q6{hvLDeq}gvDw<g
zxCbywOgGnKi9z_SG^(#kh~PNi0mp8=Ra|nX*C*#y$L~2h_wI5IFRypmoRTixTi#Yc
zXFzJWN2646qcv+Ps53#ieFrE~kgEW|)Z0RkPCyJvD`5ElcIO&`V-w@*3;k|?Nv8&h
z3fJ>RaV@RJN+)%k@}H%hoePdpT`oYkK%E9ovTMUH@7zk|pZ}gN#n@{p0M9>t{ffgU
zrXFkfJ7Khfd@kv|VhSN4p<z^aZHzu4Ic}pY{?n`xU7&sk-UebrB<&1)z~PMD9^@vm
zz-U~!Q~-<zYi}<Y!uGWUnEG#lW9)EeF#$b#i01EC|AhmFv$J(syNl*&O&RJN*k0GI
z=^0%874paPt_Ssa2|{ZC{Mzu?80wQc-_4SJWhe^VS9<UUtOW^)sS59UO9PV(o$_m#
zrv)nl-X^RFr#ur6o%0t@uLNxT?b~}dPK>aBm$-bev)!30t(RV9XkKOb5h%L%I+Ao?
zPl*0K?pW)feBav)yZx3^FQ2JdPqI%fw>Dx)&WG~C(g^F&M_)jV3PVwckeN+K7zURX
zk80(Q%W+XyLXR688w>n9Z_J!DC7W&&jI4p*uliw4D8eRS`I!c8?}~ke{?cHAS+bs<
z>8&1eVV6HMP9Kd@Zv1&U6jb`haqr@q(d$Rtk#3=<%p!piQerdabQ<@feWVy7VVasS
zZMXtUFet=f7kke}-Af<Tnp1*s7^s*b)ly=y&-OJJK40503vc_`euxtJO+G#=Z*Qu9
z@SrFZQ8FNUy~9S9+t$Vapm0|>0rf6~SS=mSxvsBDB``?G0G4vY3g_dNH)@bGXLWU2
zY5}_fDg!(K>S~TQRQg_z*bbG(-=wb8WI$BHd(7JzfZrVvRQLXU0n!`HZ4a)z_YLW@
zvZHca^t_L&fFi}iZg^xyAmgWa*^*gStNjmm(BxwMbnELq->jJfAkP(yjOLnt8b4|z
z%xP%3#wb~d)8Bv1_iUKO^rhFzUGh>hOvD|{HSv#n;p)vLm9;h^AH{3OL?D^E0Hhz7
z0RQN`1CkE%mmWMvSYuiWGe1b)<e=kD>S&h|L*`_s;~+L4O)Xt!{QOPxB50B$nR9y@
zDPe$nw^b(8?y<gxZ*VwbcVNR?YQO2)<F$MAn`NDPPerEZOdG#7WNwj_+wn6OXtR;s
zW=VpUDzCIOcE*7<A9Zr#2e4bAYg+5X3!*{pFWJnACW~&oODtIMy)X#{1@iJ<wB8I+
zYW1xA$$)1k0bffH7;-^jX6)Wei4I$R@O&N>dku=vy%!2>WWj^hma`Po8G$E<d$zH<
zDg7`f{-GDn0Br9kPiQF=1r)^1QX)Hlb{ph~T6wwat<B87>q|QNom-?I3@P@oA;9B-
z1!sriOp;~yn#XPMESr4FC}{;S+Tdt%<!9T&Ve!!8$qoG${%t5*gT@sZm8hQ{PsxtR
zv6EYvDYGlxDs_8ZihnaTrof~Yutzw4St;-V3{RRdc$x8_tOiu#d1O?U)Pj#!A!#JN
zF16^fsFamq1Z!mz`IFNN{jX0SufKe~6+oKMzid|h+RVJyjD9;ZFYnSbc#{$b_!q*<
zJ=J_MP&R{+?`EC`cUSN>H~N87N>9Gke%C5H;AvlTmG;m{k}4LSHxokw=hpixYp;H7
zRU?U$RID}Myn^!Qs8)vuGu?I3t+0PtKKJM(K((ULGBa!17ahI{j#Ko+JZNr?Kc%&W
zm6kW*SHMK=@s)mF{ax(Dek1%%jdrNB-)977eCb>x@J_j$8TReo<+K~q<GjEP!SJ(T
zkAU)V-e9h9#&+{g)}n8TuY)}@uKJkGM|VqRE_qA1@2^V0VY4|`Phw;9^(wv~6cWP?
zwWXyuDq8dFxY=b+%XtG1O-u~;Bit=Ngr{-75*Jtt<5XBCDWp8>e2<BkzW1i%kV>S<
z@x#a01-B)>ebi;{2K!Np_qqK`TU;3N3G@8!KwEpSSc8_X$jM=VV$YWzm_<WFLvy83
z)DXtmw;r~@BD1~_$>9Lk)O#U(ZS|LTCOw*CAd&6$#1E!awG`t~bjk79hz`&+agnV)
zPpccg3oV$<vN3jq-cnYTci2eHedc~HEWuj0|MKoG!<X3HTrPazhM_aIx3^bu;%6T7
zm+!%wPW1*KHHdXon_a`Ml6^9Lcdf%RT+>q#AtVwEW)p0)^PdJ{XW1}Ea9!#}8)zys
z+DV9r&;yJCQSAl=H4?&6WQu@f#YeXoc;VU|0LuV6W?3~Ikr7B&8|;SRouYgzMOpN*
z+X<7%EI8u@TvR>IoCg;VzEK98`&bQUfAz0@d>rZ2l$%6gAxL|*+6dq0Mzns?&{|d|
z5AA0U<M!4oQ?9NGQn$O!e=o18a++p)temw_*Nl?dzRE4gNs1-^E>)rI^N0rUu8(^6
zBet6ag`IS{`1q6|Xe4No07o7-?Zpdo(M%|&QYgB-bm)qKXPD5xZ0b9YZDbe}^`0St
z!N=0khIpur>)@$cG48W3X0c9@KPxNp$;htwl#n?jLaIJE7ava9vy;cV`P~)a-6`%%
ztJn&68IMG_JAuwP@anRv8{9vv^wsBN$eBH*5#s(L>axI#rU{r1pzM?{*5%kDOFl5J
z_@u>=k_#Hg>%ueO?9aC%(=XHI&ebo4Z_T||j9-FHbqh1%X;y#_p~K6FvGpO}H5A&L
z4EYg-MD0bbt<n{qmS`Uc6l);IU*8m6EJims$*fed7LbWSBjN2`zG#i0(8u_7dJY{b
zoZ%ayeiTozHS<h>t^2sRIHu4HCmht|5$TS?FXQIj)ED^Mem_IStxV=6q12}iSE{!i
zA>lF0cOE7%?k8K%CiS-)27h45MRboi5{i}XMGws_CusYc$|jIU&`ir?igR7(8RhTN
z#k^F?c&SwO$9k_k1~&znE?1BCkU=~A+gnP@w`-HyH#V5ad#cD{m?~F7=IVpw#PNd_
zE+y#_!#{HkBO2tQa8u>@Y5U&^g+<%Qp6MKh_X-|}MXLl2HJ9$SEk7}yx!>y0Ys!nh
z5`TCB;MV}Q4#5R?N_^~TI5NN3iflKPki*i*W;E*b{6^U#x)Cu$6*NQD(SGi5>Gzr-
z{bp&OUaLq0n~iIt_#D7GG~HJ+6W8uLD1Vj}b+GII2+svR`17<hPGo$eM<!JYg31WP
z+D?WF3;Iq-WP(ZUJhK9P=mST2P;NpPFi3O3jMw*y-5~J9R@j3l3{xem5B3^bk_7{Y
zr&^N%2Gu}%GgJCoPgOu3KM=nVixzjAIb}S*_e#%AWwS_D(ojRLj>x0>mC>O&W({p|
z(87X29~2cIA!x{JGC`Oc#FwdI0YH`T7;@x#jiAWW9t*MB!A;n5BM#3WL4JtfSUmOw
za>p<$f|WF!m300LL8yS>LR^ToeY%5q{pMcqDD4`Zna%eSoxGxQLYwNY7L%0PSh!w5
zm9@I{YXMHKN2d?n=i2leLIqmHm(33^J!->ckgSR7A8lzA^VKsWI;<}i5OYAU$+tri
zDQe9~U0Bs0NYl*uacdu<1GR0vG)g8{J^cQG*%HNJz4)1hTrnwAiHkdYD#S~hn>^68
zqUW3^^rI))AkZ4G8c%cpi|ez~IdQM=q!1w&PcIQd0-5jdsKLG8i4Il)4=7p=k(IM3
zNrXmr$oJXtp+p7wDAdNlEyK4CAB#3}m|OqiB8wJu+~?{cX3{Z(5*8iFqR^~O(aS{-
zP!nXRWyUk8rnx98;)EnFvnFK0v%lkNLUZxsBh!<gA1WIf1~wmny_7=Q;Kn~Lx7($@
z!o8k~00J;UL=A1&NL#)k7n-sF6uG7J?}#2Yyo72#eAlQDG5Sz3jZX5IPV&4ZqKb=5
zPK8dohv&}_OleWTA~L7pGLy#wyNJi6qK*4U`gPas&s<?|Q+vlB+>e<3DW=?iqLk$v
z;U+%JwU9wt;hd|ZmV9{0EW;ZG*Q@DO^#!`;xWP`h)*6nUHtXmmoqvDUYSN{lD=$A9
zg%QQI4VcJaKY)G1e-zP*6kZFC)KFJW9DcHBCbDRXFht<VkeL?#;|0hfMl7AI=k!D7
z1|EVxa|9M6LZ5LAx*Msp-EPpv!Ncr<F|~WgsDuMecKV<(^aEen^VPC4B>OH24JfSn
ztXZ}w*7}MHz713jbf^G*XN<GXIka5S%8@}rh($!y8dkNZ2n@#rDJG0%kY^(+!}H=W
z%bb5PwjK%w@-0jg@8!#O<c7oqAB}nY5=b8BmCFz6x)Tu+QnW})Tziq02H{?CDhlxP
zYwwOO=vJa^L}xv3utCQS4h!huLGb`!Lg#1iBx7ia2&xRT3U*5-9Y>>jK7AqsQ8mn4
zgj@)N&-!WDny9WUy7pTl@o9FLh7WHF+|JMqn>(r~i8Q{E{X<v2+I1SVbx>#$dE%+2
zi_=^KRW{JC1J>2R)fXp>udJ|uZR(CMemH2xfh%~yT-DeCxgn*c1b~}xKA@KH#Yt4w
z8d$?h37h#gmyx-Hn_lPu=uVfl;O+cz>-p8rRLmdV%^5aF>b#9?JNDFdd#|h8@RUs@
zV%OXdzqtk4Jp9<5Yf{pY3h=VDO-x3tOV)0E`9Rg9H{w$5d!sn87vcYP_UqR;kSRs*
z0MrhAT|pGN{C8;v64*`|OxB{;pAW4)m`~VLO0ta1Ajdun#9l`pABYOb{B3I$uOaPv
zI(E17{c3+gg3+#75%uoW<ykk>Hpf8ES5nhDHI+D1C<E+WT$D^quBAMBsm0D_2C7pS
zmuz)7#uXC+e%h$h;bB6qn1}Zr`W0o&IF{rwew_r6Mk^?~HZAJ}?BX*eWF@MwefjmN
zJkm{^5EPIgrBHGhS`U2&l|0az5VSw?$1ZxG48ohJkj`UkUmHDP#@F}F&EY@Cavty1
zA*KrL&yWf5i1xN%y^2J|D~~O2wop&n+&i0FHa#x85A6@^b<i=ysi`R44AZdwX*hBT
zs9Df)SPSODELh0VQXJb+(>oW`^KXQqdm+$OL9wM@I`ZVJT1eu|2)j%U30X87@T<CM
zN`g1_xG7=U&^Y7emxTgCLZJ};1i?X2YKQvKlL;g32#1c-){6uVB3PSm-|SvA9uFpQ
zE?wtAp;aE{{2freLz)jB=H*WYvq=XW=E@%n?&C!#t3Q`-UnGIv6m}#KU4@^@Ns&xw
z3k~>14g_t`R5v6oU(3?68|VAzOF{kbJQHLN64pd_bAT%hr$@)SFM@yokRyH6b6vEE
z<L;<y2mE0Wp9}rx=pVb8ao&ezRPc(NSa=0#j>;psQad;qn}f*j^8y_maBeOVW_kmn
z2a>;-XnJf-hw%gS%T3Nq)wrE^MY(2ftFNO&PW3ZKLO)ikDG893W%@?H@Nd5?w5WXu
zdl|CVBf)SzDsu*$9SDjJrW@y7&}Zn~)x8uIHjO&-V#~m;WqyD~;h(S(K~?f8(2OU$
zBV|3!?XNq5bK7J?-Y6}*%u}1o<uq?cHd;)0so}ft1PRSNoqzX<SC3u8z`^bxVaA*?
z2yOnAXoWAjvyUkBUtQPA5)THgAW)^>0_f2FE;_IU!u@u!cUdmWVtz{^7xlMdVr-&N
zMB93@`mn7fF*%U<^11vK<3hK2S(kq2ne5|vY2l=*EbUy(p`QsCoBY{GC1TB;?>(Ku
z6Q~~Gg3pKc9mKeZ#P_kHVq*Pq8hFfX+!IRpw3)x2f3TPTc?ug#tStEk#Q<u1&zE0V
zxaVZ_jS8DQjKDYuzB>WJA<{dz0G>lgZu+fe$ZUN(`7`g!3`Wq1Z78fe*hmnu*T#(T
zA}UP0r3UYrjBx^V&by3!BbIPY1IH9uS4Hn*G8vsT`r+MZ&MVjHiHQ`woCDibZ|4w|
z#PUyC;0=KJ(1>L2Eh=hi8Y~0AJnPh?s9DW{x!d0#IiU4xIY-NZvO=tzZu0QFh92=6
zL=x|`S-->@5cLE5s;3g7nmNdN3VND1P=atI1Pq#m6z&1me%v}pTt#|p&lf&)Y1V`G
zap9aID|gDoj~-ZefF*$QGg(aqm%;tTp8y&A+Sz0;?_>f}`9HB`e=tf5`t61PcM3co
zJ_e*+01yRV&{}lB838vqWI;pTb$XNV{&AIFmwa3(SM);Q|7iiP$H0Kw>Upu}>Iw}{
z|5Bl$vYec(?mHF3w_SfP$N!Z|P@ffUIQ^;R>@;&`$xDH6;pIg^p=gup+Q1-M`kwWf
zUAwYEzK+V9dxd22Eq(X8OJ;~T031|%Bj}LkRue%}?v3y}=$Aw*96Ir$R;&ceF5xG@
zmG0abD1^gr223h|h%{TW$xrW8SE%Hf;O^x++;UyH{O+P{(a#q1Znjy7HsWl=Tf#-A
zA+_dI_SFXpDB`R3fU3VA$&sY8bZ`Pkw2APiZY7qaj@4CbRXy3d!H{&57@`#yWUu8k
zOe{|RITCmVy%4YsAa%*r=1QJb-xs-jC58Nl;OOJ?JM84B2?Ot?JN_^CI@E>GxN*g3
z!(JLmTYM-~ryC{2zdpa=Jns1c0{}Y2Hwl7&>&nOE@k>e)fUFoc2i!}WCh~cIt|X>&
z!rcd9Fi^)KTq7QmTdJ5^g#~<THciyT6;7xZ`v?41suDCyL-NS$rR`B9g?QcIozls?
zwzlj8&lwGLZHhMe-Dm8N_g)S;!+^PYlv00wN+FiAhkm-xQDWh={+)4A5&Xa*5*Vfe
zep9gATOu0^617z7e)fldN+AF%8T5Rg9Yp}^Gb2mEaj%D9xZI*5yOF2a+k31TK2SV?
zSqdauAb(R~3Cj?*s_ZWV+QToi4Y%Y&!EvO|(bAWvWetBDaPDT;ubfm(YIGivOrh=@
zc)zao_${B1$Hie+O~L(Mn+wnsi)v|~odqN`CL*k;&qqn0D}MsM2a3KV6()d=@~tc*
zVE&NC8DZixr5lWY_eas_|0-c#9e{_fv)P^OJ(hbfukg>U-c~Wl9kpS_9C-YGNQr5C
zHb>eH8$mz&Fp|VfBK>H~)}NT|O93=mATA3w<T1@uJyr@+MHg4o=>+#l{Wk4vZ2=Sx
zK0G|kD-G<Kc~mo_M&*1hS|NS>6sVNsuVtBlbi9Tf)f1YRh3IUkR5$3)9I{pQ@MhXM
zbr>3H>kIGP52s&jC}(7(ap-NAl117fy`@APyLWyKp$`qlSskK{=Xk()@~sIl!n23`
zS8z*M0LZVpqj;h_oAh*EcLk28%IfNe2fiyk(XcXRjH7n(mn1L$yI7#;h4VDY-TzXW
z3cI;;%4KGgUMZPf4vh4i98i){lW%ps84N|jl?@oYP1@ykdQ61y#bWtcXmJgOgD2ph
zP7m3pGs2+RRK3ChFA`dt-P7~Lp*7WS$-44YG;lpYJ%){Wdr(()|BN+%)N*PD!?kH>
zu+5@PKn627$f1uZcpdIS=CGlmA!t}HBfhy8a^VvY5J0`5RVw9y9DOPH)yEh2k0Rr?
zzY7`P-A1>~Va#kP$pqK-W<1vBKQUTegNl1!ztTfPB-%<k4QwE3Cz5+>x<?vpEnrpd
z1&TL)d=HK;s1B_KXI`o`|7Kvc#9VgYLkkH!LbSPhAX7|zg^CrMhb$UBo(Ei(_y0Qy
zR9y#FyA41E`m`@x_Z$dR0Z7P$1%)j<k9!|w4@z@?b@%ewnFlV=J*ZmrZQKU`LasJ^
zv4wvpt9R$lH7^bO@!YuXXWC0n1D+m~JIBK}&CQZG?5-Oy<&Q#|SV*LkI$Lr<64V_Y
z;`C_3Nu2&trCO9G$3(>WXJh#}-FQYuh7R)nvE?f!q@IBoZTl_Pj2=GxxTr04Kq8O{
zKhoG^kX?c%VZZo&Y_BCy&cnX##l?6XKRv^AXJJw+$Gcl5Z(afIF}4n5mVcm+5<Y~-
zpq;&_#`WxOD2M?UbAvnpR4in-M>yfYl@HcJ5>OvTXmf=D97%h$_)M1briK*yz#xHG
zkpi(i%itD?HZY6h2>4lh1jx&&zE=l_#6e+CV9hA!1Rte>J3(YO$nKROJTdTiz%k>`
z<vNe{jdWs&v57tcyQ+byV<~JLA#ZCtGG1O@7J6b%8!|^>+8#>*plA_X89&$mL$#7r
zKmfmxCl-TnwVefNG8jGEzvpWK01U(IVQ@L{rI0yCjkubc*n_B=TtccmEr%E?AeE=T
z7$T3%nuv0IH4+F2K)pBaDgI;wj!(*qDrNz(aQ;l^0<!8!`LrP%ScB-#MHbU*342HY
zUpg9}B_9Pp9cq1gNpC_}kx<V<Fd5VbS<)4n9OSThE+C5Z8XQ#sH#DH)C87945B+{N
zpVJIMJ-eUp-(3b({~hpELRRJ2GW;i5QwV>}6D~F0Tnc^dw;E^2qwj^OqQRh5ME<a>
zjxD$jR2@*s0e11WxVRI_uzT+b{8Zf)FW{F!q#Jrd+~-Kh?cnk2Zurxd@)|?x;K$Qp
z%m8Mnu7Sz``BbaRTQBC0Q8usUd6;;F=-{FUY#`H?%mc4(e;Qnca2_QiY3%ImYDV9q
z_UVCi<(HLB0NNkK@kP>?$y~dLOE?O$HE})hZpZhdU`zHxhx6z3l%{uxE`B*5n&O3@
zcOGX@kSx|=T@wi}7Kw%LqN9UlbZ^k{H&h2eJ41h#LHhl7SILCpbmE-2-#**Lalh;e
z%npc{bc8gje%NoI1D6RntjQU<ejLb(o}bj+4(10-M@R0hzem1OZ_CPhSreo}&<2JM
z$083<>IA~bpcNQSCRVh5poJzUe2thUA8dHt0<(nPFOoJ`;UH9k+kf+GV~zPZFScm~
zHGlxo3YN%~!%Q7Idqi`cF2(aR2=0dk#zuw*6JeU)o@TT0X%_2tt$F0Wdq-$g=L|e)
z=+IghoEK!#Jxv*5#vxxp;+dx52Y}htYuA8b<$BO&@lyhp&YM^<I0FfpjSUThK#Qcp
zrp6NHSo`EoYGPI>oGQR{B|mYR^uW77eS6e!zFfmUhuLtR1k#_nSJU@;x17SVLRHwf
zXSVGieH$1VXz!ABm%O-{H78WRHNwpW8Nx6u5DVrJQ@i~=KSF_tryn9@_dp~_v5Gl_
z+H*FHJO;vnnJRYqrBk`ZMH%dSkS2(`uVCLrNT8|w)i}$f3NH?l(#e;P>6B%du)TmY
ztgWrZjqHX;eADnfL31z5d_0}z1X^H$SmLXr<gnW=tF-IaXPBFvh4DCz-vZ5>^;9`5
zfM@~aKt{v}x+=(4N53fv3ari6p?lfgaQ^o7_g8^@76KpEyod!e2q6O|?qQ#I9GF;!
zM@B%v#IL3AeT^Bx@eO>akLNu<a<LuHjLf;ub=wIzkhI;#^m+XtMOKwnBHy;guiKML
z_?`ZZI3=rDPea$VMCmswM5P?u-~hH6mW6RieaqdE60%3ol%0K7mhD0#LXX?+K+t=y
z*h{m_<mppsz#+tCi+ot%$U@zWg_EMHs_H#R!RF)|5R$XuJy|foEhJqkXmXx6v=dQf
z*i!x>zy1$@Em@cbPmc)JSG%lMO2OaLF>`Qzd{Vk!;907auM?q>DCbt!^<0yK`GG`K
zuce}aEFP5laL08myDj*qHL}3RJb4L;v%{rMqLiE0Zey-o<&<=U&JsWgxPJi9hw9MY
z!C@xRS1(m{Z|NpHfID^;?qP1H-Rrv_A4z^ROgb%RQ`7;CG9dEcIl56qnU)daMZgD)
zp0BSs>Pe>t_m*kEo+3!!yBuq6y)u>K={vzUGfC9G{_DpCI<(|q5y(j2G5-a0Iw#7C
z@zhYM-y(lnB!XH9eT3Ul{8Supp)3ZM3S{NJ6kfro-oYBhfu0F2Kfp0n$9X{;GIL)1
z?p>Ht{<8I|N<1Wek55k4S_EzXH8yO;Y-_5xwC1sG+6QD_bQPCgN}p}XqHUtu8;I3a
zFPUK>*xA&O_ojTQl&|_h&1#)4xpl~r?^Vs|^No!Sv8|6cDWV4Rnwn^#MH`Z|<RAyo
zLReUs|0YQ1Z^ZpjD$_?Vuz-L7q?$_BJM3C+n!vyz;;(-`J^+F5@c`@k?(QQ=ZKLd`
za`iAw0(K5G6l!GqL~IE#xmDbH2MeIkv)xG99+=AU6wOuCfAvsTs^3G8j}n{rnuu8J
z_NL(D<wZMg(34ykAo+#pS$S?Q2FN~m({B6-LAx{{Jb>mEV*;`>Q_goa&R1%*5nnm0
z956*JEG)pxv!wjUprgVmov~DI2E)}`-I4+m+02o?tK?Be@msojToezkSc9$rYA1;L
zBP1qvX}asxeRoW*{(HCVHQJuj$i@d!KF#xRQK2vG9b;#>YoLaMlL?xt5H6P<oIz2J
z#7pFYymfP1Ku}$!rJZ%VTdWOQDfH@Sp1(>@KWw<ROs3#a4Y3V7J9aDnF?ffx@}P*c
z`eV7SR?T>)ShvYG4UhrLaq_-0<uUjlB|9XUvg>>>t)4CQqyKOP;F#EjE)cHq0jj^q
z45)44Euil+ei@ngeg=QSG-D4u&ic$4u&6+?Icc-^R#$$4Ow$h>N`YXhKi~7wu|kM<
z3zwk;YQYO*MWf%NOUa08pG}p-O(nH%$nYMA8E<|JpPzv0vLXDlJ0Fci^{W!N)M$~H
z;C_OHHp8i6u>NH%Ogq!EZ9kEZgi`nG0q|+o*6OD1Lhko@p@juV4Ju7`_f)bXPnlDj
zMi#1Afm1tx-aASJ<)ajsSJc0BfB1k8yOEoln_pbq@Ry8@x!x8n9NN0vy#SW05)v2a
zu`wjTKJuL)NcNQ?hBypTc>p?M@~*xS<I-KJY0n5Bp;o+WLKDBxbS?D*a%T>tPymBK
zSG~NvoE*0}!)gY@j(+rZz^o&;xkvRDAeMmaD6XRXr=rk_1I24#4hb>7$IFo^1B{JP
zW`>3xP=z8R83WUqbJ26n0%82<()aQFw<RTA5Tk<?+1=US;f5WEJ<Mw7)_9;aOAld@
zDdU-&wohATLcHEWVy3Qv0jhe4*DB9sTJ`LQ_xU~Lc-VM9^d3XSn3aXCIpO5}5gIKa
zB?cOrLC1p6Mg|e^05ztu{LUAkwty(S;t_7e>}!Kmas4Rvxf*p)LuY1&!fERGd3ukX
zEhSNRCaE9j-E@+HhryGMBX1S+NX_X?)yljxG&msW(Do}g9Bp4#=W#-BM^Hq(Iyg2o
zAe9x35@@6EC?m=4JC8gaH#W*RL=({HmfW$n$v%Haw^F$cqylSkQDD{qhk<M-I#VWK
z?S@$=eDM1p3Ch86Kn1H0MwJ<Qj%x|OHRQPjN-uN%fwOkTi`_`Hei9Z}I@9-j<%Ip!
z1lE60Vv-6Q{0EN<zx|N0H-o6NlLM&BfP(vQa*S;~E_;>G(#<UqaKg*C)~)uLwDh37
ztDhr+$ulYd5X%Jt6#>>soB7z&%PH4#PQr;pk=$qd@zM`+$cxLNvgUpet61{W;GJ`)
zE{G7(=pmd`fF5oHek_Woe=5URaL<8^c~~SR5nDa&o;yLfJk)=%Ct-VX<6SA@!UrD|
z?4V(%q>VXQ*+<<)&!jPY0JTzEN(puC!%eE%>*~Vfp;908pbG9n1^`Nn#<0+4E?7$4
zYiVYqgIoK)r@;mYKZ<M4DUlD$w46Y8W}Gf}uYVM-7Id94`y0hF8!oP=s+a{)Z*bi~
znhAO!le9Duj5yhRom7G3e&6I|klLi`Pr8Rql*E5<VD#VtdgwbXo7!zr5aAYQl~oxM
zf~yN`Lo;IYxW#?gf*w#d!gLwX2g^e<?$`>-Kss*aRSEklLp9OB%L}?+(SAnI2PLO#
z0)PS5><q0ndErdB3O9c`^xbvULH#}Nr%9jh*o~i$3O@t-04hjj{;Sr!qbedV)!uN=
zs$u#c3DTvxa-exEm$nmIi0@zeJ!QtH>L!v<kJh=f+O6*2rUX>w)k{D#vYOQokiizp
z&FJ}ks$+I`*6uW0D@Ug=8;KODR0XnGkv`1o&~M(&Rqx+p*UV&5n80Z5L7w+ma-dfC
zs3NuC4hGf7)?_C6_y45qJbZllfIrM1M#zV}vQyq4Qp^1VL8f5s1CTE3+N&Q*@f$W|
z)q3*Ds#l>e?^Z9)^M>2ICKLz+34^bKx3Bk&h9cMA@}+fti#7kEY~^Dl1Tryn(HjTo
zZUUHQU`}pO;SaXdN^J{NF|Qe~avOR=1bV^&L(b{f_1!moPm9^ua{7%3&V+)LbvpFt
z{#OFr;_axwqN9ac2bl66)~iMq_Dz)(ByNHN%WdeRQf~AS_p^_)Tj##wQa2G%`<`}o
z)#%Vw4UzVb5YYj@O7emslf?ZB-4aHcr*qDt|Ct(-gsQ7_IGBHka%6--Wd`IJ_;KLA
z;ENs)^}<Vo6PV`<8$I!ziYd^2P(J<Z`L>u|)DwGsU0PfDg@CMVj_!5k&jO!xG`;cg
zstmYORWC88s-;eOLfRJ|oGk}Qu28^2bY3_*Pw#lLA~4*kyfI>I9EB0I2>j4x`<F_>
zwDZ4CqXw}c;`1h_Rt;FfVURkcl}e*>X1Hd<H!e)g9~ap0Uqv85HRboTAt~IuZtl2<
zx=Y-KdL^P$FyQRdm-mHXa2VIj3^%-NWRsf7IyJien-wVt*k1nISMp4-@8RSDHUTVu
zP`(VZS(k=|vsrE0r{3FcNSd;O2MB#kY`Kc`?k7S36Y%|M6&gHCDInyUCi8XPxP3Az
z-AlIy&jNz-m8csxWh~0|41udKa%seYNAz!=u#u5O^CJe=XaCNjs+q`3bE{Amg&!Vz
zkCr>u&|p+hZ*}RPH_#tdcR!cBbxZuD6$cXol*ihjrv$to5fq)>SG>-Xe$Xc%CU&{i
zG{;(v>8BMhuT}Z3zV<nEPtcH6LgJ=iH$i2|E_kmXz6fpOg#J!7BkVtf1^y*Wd$pAJ
zN(*J*sB_o-l7QO?`xg~$&xZf#(*;&HawS0-R#s+nct8d|9W^LTuHc6!bK~9M=Kiwz
z`x0hwftFP{ubTbKKJvR#!D9j6gwU7$E+h&SvGLk6xIRK(;HFHu@0{H%;M~bbmjj6m
zv{>N#LI8cMG|t-y)ous4V?kYSgzBTbL~B6V`{tvg37r5tz);}IgeHt*?O9-8_8<)O
z`qM`|#?D%H?`>d@$&LS-`Q)Cjl}DQpO_)Np0}lu?>)}i2iS<q>m{_c!2*nIGM>ai2
zS}K{M^J3VYL^1SzER^B6F(fZvq!z>wc+g>kg_y>4_hoh0<@Ris1;sRAjPR9Tt;ljE
zf;4$gwzze|UKm<wko?+s+-+<U2Px!n<g??;QhPn*=qnpsggprXeg!ztC%MG{PYsPg
z#Z+b*X#SmFV5vMWf{qeg9UQaa^ZtYEd#slLOVt-nEiMX79R^9&)tZy>`v$<t#(^jd
zZs>eqJRL4S0$&2C9|x<|4TAe{R5IbJU2YK*y<gd%^=7!{Kf?uFS2Q~_Z{{wuXN0Y~
z4|AlT4T(S+f!voSviB1B0&;Ttr>70Ieg_)E{00=r^<V)s{Opi<pD||DM-u|llA)%?
zR<nO_mVD0GWw_knkAR1OC@sYUTZA7^v?>=hV45h1JIAS{eX$7s$q~M8R33Ia)&MIX
zyr2l}2mje;p=Sgm8qPI|ckkYHnDf6ItW*QP=++iEe@p=ZTr1B3(gH$({rn_gc2P`|
zk@tEPfw;`JoPR2&+3XEP;qToY9UV>n3Y+e%&6r3p+8UFRnU%7SIRpskdq9c_eGi};
z)>c}A-rGNZSa1(FV8Z5<jki9#8>Ik0)#?}AGZ1sc6+IJ13L`g+svV{4Fx3P(!{wPT
zw%dt(AKG;nRcv;=N~@<nlLAK^uW<tcE^?SJEzd;CCXxoy^{Czz5yu_d3f7l}d%q^`
zqG0NZxJ%2P(pR6wr|bex_I&-(V%>dtkWcCo2T20D2lX>LcL1iTr2ldS`d(O5XkBN(
zJ`IY5ltFBGplxk!A;qugI+qic_%606=sU&Bzp`}8KC{28-;*ir;?-yj2n&Ehs`$*3
zfwt0#zBwvvA)TF_$pHg3p>NcS1^rr0p`3@posfu#(q>abhhjqJ&H%RG!qn%_uiw0}
znb7Ex?*Pqi(S$&)_nYZEtbPfQMg;x4D*pHGis5C+F|8$YSCK%Ei7z49muD~@IXXV{
zS<O^o14=AK1sL#fwKoq9wt!VQh7m&{Ft3#q4b;i}$|c!jHDjO&X2ducAb@HFbh=rY
zQleOM*vSs>2@F;f{t?iY&d!7ok^sKU>(SL@_~GUPbZ$m`$kS0QzG0<Zqfjic=Opeu
zDxedqjs~s8Z4jbD`k}6TU2{^|ACSxmSj_fbqB*%wp;vuN!aMt#!M7X@Kq4|UU_nNL
zVgOO9!vRbuL~RMMSL$^I^dae(lT`SX-YzUGBwK4?x<;tq05lI=xg)rN4G)MAS51Be
z7ybyzvJ&Mr`y^X7ZVy>OmjE0mj--)?oB;wD>LFw|x^%pULXW5%;%koscru0au6*gF
zN8p7Nuj#*o>uq_t5@@=|(;B1k!me!z3JNBR&W5W`@?9nDvKM9{#We?FcH;Sk#_hvm
zz%0;ykGX|r%JCS#v*QLFv(qw~?vb_c?*=s=TRuZ1SyiFz0MUXbKgDPL;6zSGch+sg
za;Z$voA^>Fy6)?>WM_Zf<C~&|!CnZdb4b{RP)WdYWUH-jX_4AFO;DI8Eplf@YHtKz
zlYXz$t@bPwpCuS^<ATe%4VU)w*Lckt)<t9EHrOTj;h13XEe<XOy1J&O=HKWb<ASHF
ztc;zI!wyNWaiGc9dPc%P&55p)_#oMP&1CQe!GHjtaf9}Ad+Pn=TcD}{i3Q9IEMrss
zWBr+yI5LImk8I!rNv*Me3N*WC#r;-{^Ei!c&sd)G26E67TY(h>q<&E1P$+_UG#}zj
zb?_QvZqDF>c@OUjFFOW%vyJt81AI(1%+%1%rKY}2-TM%!aTlMi-jK(ss}C-gYC*g!
z^-kA!0BFH~r4<P&V-CNx*<J+c^2l*1buTBlt05kV(h*+jj)2d)H!L)^l-7R64yX;|
z5}*@T0o!!jUsXl7)Q|-O8&weV-!Y|4p{I+fBI5>dEBN%_8GLs9{nDPASCauw7QprZ
zv2b&%WGmMfMQ;vyAD<&yOvfWdw{xtbW!xS&5X;m1nK7=fcXF5jBMx_%##!9Znk5B?
zw=*6ynQ;=vAujClY=J)%bO3t84}>3!24c4#GD&DR!g;<f-TYZY9$u>)Q=*Qt$Uj&{
z<Bjq4=kDf@*WIApfb{A7SKT`@Lh+GWBl#7k;b!N*U2r9Q$D;m$r;(G6Yf{rQF7+sw
zsLTbhJHxXxcXU8+&D^)WQ7kk-7Y^1~15Q^_bLD2h2v$J(fWBxUsQb3A><U+%Ay1rV
zrS6PFfwHeq%1E>-=l1c~!E21OrO;5{iWiyHK8MqdKtq9WY$Lh+^EBk$AkjcJkAv{b
ztV0gGANx;QK_EW7ZCM437NjG<5w2$GVm>vSG{9coDT;UHKBnXlh}eS)9iZHR^eH&3
zQrX<HuAM^kbK3ama?6b{r)M7cx*>hf0_^E{w?3HN)_Q#6k%5bTV_&`J9s#9E!Vs|A
znQR=j-_XzjoU>o<RcyCb`!rb)oliqBWxk4A@gGnLz{bE0mxoUY260c1=9!=^$B{z$
zt+w^TT_8HSQet*X+ZRG_>YY4=Z)1k<#tyv=-)&pwm89ssBFyn28Kki+VVN{!|0(N$
zX+>UKTqGy)LemIkH^f|}^_&p3IJf`>1)o|mmO+jE2mk_5QKM}34XK1epv<*`*9M&r
zy6o$}NW@J~8dW>{^=<eDJ6I=_+Q2X(3$q?}k*)z)W~Z}L=&4(2J@ccemH*zBJb4Gy
z<^Wx2WlKea9xLEGXc25F9#mi9im}|E10BaW(EZ6`MsO>`fu+EL0lB8B#X)LpyUUTI
z%fBT^F45^7SIqg`<{rK9G2f{d5f*m4<p_tkDt;~)UJZG)KCnWI5(#uBobZFzA;7z%
znSc}}f!nvrRMWh!dwhY~4e)7*s8gqPyG9(DJMjbVp^tNOv4B!Zy?{jwq+s;dQr(h}
zmiQ<#BO{|&cuaAWPtNm5BA-3Ego(KOwTdnj*=VQ8L53HHL{eI>Zg@BEMc)m;v>VIr
zg$@rw!ZAi&GB1;$wYvoHP=Fvgn6puChOo%Inwpg2SF9-0f5c@v2?Jb~@QdS$RDM4w
zECAg}IE@WRwVoG<#z}jRat@9D#6$hLtkq4P=Vo(Pr0pa)P?uYXvGH5!9~%PiGr}2m
z03|>ofO{#F%MpVDS^y@5s={qucn12VH)pH_;Yb4_2D0j(zf%{dz`tEI!3@S3U*86{
z65&LRCLsR4w6uM)A>$y67Lm+7;c5u;y2;CHX>QI`Dq{ilK$7z4^7CG#EMs}U4++t?
z0ETe-6F_yT&^e<|{QdX7=O?^yu1N0hCHVJY!<mA-o26A9R3R_K<*Pc2`at^lng<%d
zPJN(YqBbuL8H2!hpoe3F_C{4`2>9)wNx7{6*`<U8$=x6Q%D36=KbI67ADR)G7kHwi
zi*zR|Knr5M+zMp|tVUq{04{(f?&P?MU)Ghh{Sb;7n0=M3_%d-%Ovh5aDpu{5SIxXc
zfdg$|yR1VRzetKU*i3S@t$#HUz(mi{Wgt*$;$J^;{~COkz8L`;*u{$x8DS?6e_~3H
z)l=}?tibFgsqNMy(=(Lpg_SCUD+9IczdOTC6~UT>3lca``z8aPRAN@gk>DntrGSeS
zEcfX$iJ}g=`v(am`k)Z}0_+a_|1J<`u48mvDkV9(m<=jUWkM`<gB)~9@0Ejc7u@lH
zA^<K5og2H5Aw(Dfy#h9F*tvow_;@|+2}L05Gv+lDa$M!!^v~C5wG4g_-!_`u<fPj0
z9!$6p_PC%%EtvxD6Uaye=z*;`?8g_0e*^&Q%gjtq7Lz?}B#De0t<@05*S2=bXGeB3
zK5Ny=ZSX6z%Gm%nJ=<EmxS8$0ErA9k(LwgT^-p%WuKxST5M%*I;?W}>9-a<oQK51*
zaL6V7OuLyk&IP_hcn*-mBBw(ExGSJ2G~xUv!-~0b-t^#m%J=p_YV*YJoCjhiyn29L
zNgH_DdMEUIiOIF1YAZdMwurxgYGF_b=v!H_R61{@P%LwQiw{OR5$~B2PPU)u%N2w#
z-Smy}A*9Oy0;9z;4Nj^b4`DbGWZgj4iw-GE)=Smz-pwh3c#szcAi@DhSG$Z|FZJIk
z>{{bEJDFAz%9zdU_06Om7+6z;aSXRq{lb$QkoUf8_V>5hFb+QnLpbKYn<M~_38)Po
z?UV)6>h=CN&1s1vFlHE9NU*QmDE`s4<<0qc89uL|EjBNxY|&gclq<m4SO8*)W00OL
zRI#LfH)9FE4<xC3M^j!Xtl5(Ku%F6Nl?p6_ep3ls+U(pGJXAyCff0ockmv-7bIIQb
zs(pxoR~BRM3YUiy%d{dA7(PH-b*z*JZbib8Ht!NS?{Zml0<8;B%5~=b(p4p1em;1e
z$B(sP-NfX0VBp2O(df7UIy$=Xxw)a4jnqO1bdY@mu&8e9uY6WA7td@}c{_Yt4*uOP
z;QzKh7lJd1Di#M!n!r|sYoFsn{RFET3N=``pORnc3WdyVK`Z4H$9}T83X2l16O}ig
z^62O`+i=@<WtG6zj)@@D!|>Uv=*%vA6Rl^lUjImU24cPlM78Sum6Xb$-9|5Iy4vJ(
zQ4j%2Nf{@<x`O~#2I@YV%iPqMZ2lflLxc4O^xWb7C=1<1uZ*ybR#9?c<j&tfGG()j
zJ67R@?dO@TiP1v-MAROubok+Jkh;Huo{x!+Q~x)xQMpYj<`Vkop_?I-12FoPRvJ{S
zZv%}l-%6n(`b3>sTzx02Z&O;{`>lWutKdlx+o)~nWX$&Vc5<U?XfEl+N&UL}Fe#=Y
z7RVt3Hn7ec-ZeL9QvJW?OB8ih7a*sP7~lm44Pa19`hE~gLXI%cpEgEG`(_Bo0UDcq
zMnZ#)EKYEKZq7*XjxO+^o#sIhLjvz|_GLTVWI1DL?=J!B22O-z+%`#kw6D$A=E?88
z^&DcNmGkb5B=Jv98WUbx5h+MWdXF}8ZAF)r39=XBa4({f6Dh%edK=h}F&f!Q84AsA
z*S-&rPS637;hz&5MhoZ*fQ2$%xXc<NDS#!wOGB3=#KazdZYPg4rd+Xm^ynsb>doV`
zzws7b3<$*6>Ux}<)+Qk<8#aSVta5dSN~UsscsMU#(z3yI5W}aFiZ6lBk*^Pl?z}VC
zFHLXHqH%nMZA9q?0xg;>)`dcWMy#(As~_)rfctEMnMN#W0V2aNsJX(vH}bI7u3!mX
z+$oyPAC=tcF}qkZTR{(2P(76N+eLdTT9WWEhDB!C4Ju#NhI7zB25dAb2;&N6Yg<~f
z1YSM&$l3T?@3Zc%^JR{)L$<q(HHw8Lb3jmthnqV@{mD?~i#N89%jjGTYDzt7t9fqR
zG#Y;YOaFt&?-Cnc*`eV#8l^X48>lgbcvwm|ak~YFWyW?$o@Co%r`kkZUTZPqGy91U
zBH5rHJ<0Y25Cy_Rz!qSxyQ1spb$pz*as0>fI)dqKJFBP+v%L1RgXau0LOD?4c4L)m
zMvutPO;0oN@WgF6wu+!`qzt~+<wh#uHG(SXol#3+;Uy?@U|?HI*>kIB0ubJ~?d4Ne
zT%KQ9NqTZ}a#he8H{j`0$@A7vZ$Gb`r!<Pc1kE_^Pp8oJ?ng_nomMadL<ia*bL2{>
zw>j3*mKs!`!xj<~6NBus{UX%b!o(;L$-Ds30RQ!<ZJ0jaWV^7uoEU7Sa6&;jGk@=)
zaKWS_C_vHR8H9-N6Jj|zIW;sky3@$p*{!>rbUt(X!pFu|Fv7&TH>=s=Crlu=Mmufz
z(0s-Wliw*!Y_m)=g-Cdl!$v(TU|3X${{8%dP^7c|pxghn_od-juW!2#%9OE`dCJm6
zAw_0UWN0q)EJK-9$Sgvu3?))hissCjLS_<@21AcA6qzeirhVT1-*+GHaqMG%-yin+
zuvW*a@ce%FeO>2uUgvdQA6N7DdOzZ&kskM9V`aT`^Cq|3!&Y1d)KgQhOpPBN6P1-+
zhhhvT#r#iAuje(EOu>2$<I=SoXsud|)Jmkgg<BIgbn0tVN#4gSaa`OwGjsDk?8VB-
zNpPKi^X5RD{STC&G7j$q(AFfw2@n--Dt6OQ45d~7VCS+rxJ%*7B|D$m=&=`r&;547
z9(;{25InkMkr)+pZCG6;oo>*6OHt(5(-UZ_B8LPY*-|p{@3SP&-Q9DlYjiH;Q7DFf
z63V;%MeYg?N73v^Zua4gJ_(_0Nx~kK`?%(u8#c5KTe7rIfy|0^(Q=&7)u_7VYi(^^
zBEUddmdyL9U{61n+gIJx#Jcg?laGU5d52=QJ1}SUJInA;LjSZ|FR^fj&vz;$!g?sS
z{uG&+f|7+&URxX9z}D@$$=XkbCDbx-el-kX>(CGU7i%0QTRSx)MVTo&H@o;KZwEc0
z!*qQa3GCD2$bI(I64L9n`1sY}@c@3h@18)H<XUnvD>wH|DqDhmE=RbXZIsr>XCDi5
z2i2>ZIE93S7@3%c-zz+G3zDjv$=$!@>2X?$<Z4=F$sZAgLwh3yJ}o!0C|OEx-ds0O
z9Hw-!N%h;{p!NHdy^Jg@yG~~{$%%Ekh6^s#p(zMXw=i(&m9fK*uBblMzKjHu;){Z0
zgUiL(SPm9}Jy{>yu33uJJ@3&G-R?$9Y2;C)JQrfSm^#)~){TbZ%_uu<(XLl-4?X_q
zaqsZV!b_E&<ESWw1Ls6lmwq3|l0>F88zhIWiT9izX|?|R?4(h?Gq0RmcjN3}tg8l%
z$nef|gEh&Ayz5$aIQKFn%8fWAx~ySi8~+e@z!0{IuzXF$*%uWR<&m~hFU|}VG_>L2
z;LA|4ZKxfqf1f2j3y|w&x8$n**unjq3F~XcAUf_Vr#i>3b?-=2@#PR=9%FE7pfX4~
z&p_sIt!@4yhOOZ+n<U#I*rDweo@}k&-r3o>IvLgO<jhQXa<X|rQ2NY`fJ&TlxVIyr
zne%y9NwdsY?x?B#*mnQZkG?Z*m-3El%ILI1sfRxW6B+N(pQY2kj4dtMi_F*<7#LE6
zCtGbPsHzjyf>d>Nb=@a>_p%79mK>i*Ei!*~j_I)4(k?SIGii^n`<N+yoa9)X&NBfV
z@fvaDmTQQQi=&g5mk$dM|Czrvq?FCu+dC{QEO9`Qr8ybA6nyP2`&C-gX;gJREwIqW
z9VpHX^o~2(5}CQ9v;1<SuH(7wYCGr)+rM^P>-O=SQ~zCLmqeQs076MhLv#L?)Ef(J
z1A|t<W>v2UtP}(hT!`wlzMcu&i}A&J-(C%O8g0CV7QG3s9_QM%mDE7v<L27u<Cxuq
znzVijYj3D!@v2(*7&bJ~`Ff%Z5eQ$y=fVZiEnA*wwqg3jG(9IbE2|tXrcr@Qe=4X{
z{v<gU4a|U%<)Ku$Tg9i(oT;4btI9r)*;}mB<WW4gWp!{V<LcnFh79xK@X=A{)RrBT
z!WSt|wTrWqoPd8g`S{L!*ijlSJ^Etz?0L)#rv}G%CBJpuhTS5AivCUK1$Q4jv)B`V
zY_!ZQJn3h`n3R{nhQtjDl;$YDRl<f&<RD?xUgLgjK{Lvfy<T3JGc2heIgc&?EI(5)
z$p0DpY(M6i*gE_O=?{;=O9;i&$qfv6`CZZT?AfD7kG4D<vErdub7<=wTc_~E$@R2}
ziOg1x=IGzy`;`J~J57G>uBi)Ep(l|X<eR611sEe~`$nGX+FF~pH@2#bkM>}lNALJ}
zH1<bZSB5chQD%0MSRYq^3I{D+t2j|?q>in@&hY%yZn@B|WNN0R+A0QyBuQ$kg)_yY
zzm^peJR0@q>%Ghs3IjKvNf%PneU|lIgDFSib|H1YYq_oHp*iZDdt8*x@D{msP48m+
zpJ(sg6o;rC$M1KpASS}v`&nPP#|#f;;c@B&JJsC=x`AEekBaLDJ<}dPu0sEnlan*~
zRdkN8c(g@&`L*B7Ty5JZFGuq%)Xc+DmdBEe+wWd?bHFLIZh5f(z~RGnnA7bW8;imw
z$2+JT;nq(yR`hHFjyZKB&xlTIX||{Cq25g^2M28$E2(|t$|oOUh|;p<TD+w=QYV*y
zYmTV*dyHCYDq)0s3fi5#rg-Z!dAIp{Dl8(b#WXM%a8A+u`PJ)NlcagVD=u9$S^VB6
zV7Bde$kN`O?Nu~*%VBk5^yL+g{N7$2bsdE0Zq@45Q*v(EvbOfF-&=QkVNHToze8td
zC$_k~|F$H{5{lAfU~q7%+r9D~&+n<Jy;fFM5gDn*=~c}gpZ9p?(Q-5YD9n^$;MY@D
z`oOOz%orSXa$!7X`+N?o&LhbX%OcO!9v&XZUvod6XZk4p`eK3Qv^+94s}5nYBvKtE
zg_6bnfD(JoI3S?3h5h((`aow}oxOW$GJo~^>dtUFDrlm4R>R8fDzWfJ$V}c@^61kO
z>3n*xt{1&XPba1Zp`mnUrF2tcpU?RJ@>3W%BS<N)dB=R1T{!ab1NzFkCjVQHF_aGD
ziAqRSN&a%lBEv}b_M6a4tgNa!s2X%EwdLhDet!Fa4i9liN&s6tiv*CpOOlCwE|3dR
zp;lH_ei7tC(vql|CLetB!;_B7{Uc122TKc9wMV3sxxQp}m6`D*_=9|+XW@DOboRT~
zY$?3r$i^6-rRlaQtn~Tim7gO<rVx2$?Rm_fA9@^$E)kS5Sa6{-6&RawACICV%ev|a
zEWyyixhkl%0sZnzWo1D(W!a#KLprBWt{teRwnm~Mhy)3Iixxq5P7Kb0l5O2xh0y~k
z0VB*xh_Tw*bp}!5-nM(H=USaj<8-e~eAt#XYr`b3MNjeX8sk)IXUz`nl6hOkZZ`T#
zNSWU?dT6V0MhG2)SK<AX+~2;XErn}Auu%5w*<&@?TQP*lC{^|ZkVHg9MG#6*#x-l4
z42NHxcvL=XC@~q}d#R-@Iwnc*k+yH&R3y#h_{Z$j)!!uN<>cfxs;Ua<=;*W;xCw7M
zbf;ZRyX56Vu#TitT7cbG>|ig9iaf>fh<#q|{E)nb@(*^3*T>$ubG5p9Us_sP@7s8Z
z$=|=L6J=~ksK8Un*DT(3UQtk9SW-l!{GW<b4m|H-Y?W5eC)zUbI4tRZo_b;MJW96~
zn;x_B@^){N=~n!ru_+Fkd3T4muCrm!KFS^_@ml96)m{EjgZCW0nmuqq7&gAxXDQh*
z6pL0;2cyO8zEs*%ckz)o@3Szd4hm&kJif@(E1ghtO9K;=x4U=qxE4t_uD$(BAf>PN
zW^gcN)v8sUGF#3VjJPX4=hMze=-24G*B>t6EGe_UQ~2XXdXcwndB;QIfoTC$i3PT@
zib{6S%CgY;{LI`Zt2!5sP!8z-tI`;V3D$o$ZQ7`yz{@RV5e7LP8g7ys3g+pG5TEgP
z@lXMBOU^fCD><R?&!kGQ<OT{ROSK<WOn$c|>7Tgz!nGJ8lo;?-AZn&lZ(`Y!U7U`c
z_Q*aG{%O(VPD7?<MU#E%O{FhJHaCKVtJ%D?N3Fc)X7kF%0&@B75z32qQ(HIW_f>av
z@Y-Y-Qu#xSa4C@NDZ$`dQrGS&9;|ea5>yHdZ~B9-!L0!&UD$SFCIRmiSI7PAS*Ksq
zzj0gk@AUW1qkWw7tY~c}Mg3eb|08X-p(B?IJ})I@4>SNXj8P+QTKF>QB}i7lPPC3H
zb?K27jn#xEjfjjyxHW1DVte?HxVWf{3@7~Sg7H4NIih)G>Cp)Cf!UA@EHoSMD6CUe
zRV@+xDz$B!2G-YPI<SQ#uxJ?=Yyh^#bbfJZYW#K?lm-u8zT{F&&iMQ`_ubWPTb~<#
zH4EH+?AM6<jxx5LmuiOw>CBv080ot>WZPL?*|vwo_nlFCo$G?hj6#oo`b^f%;YkMV
znV*a8-nt2@iN)1pDx}a}RIYtu==)1RFgzc34-c@guDPTB5SdSWl$c!l%-k8vo8U7h
zBj!mF8rgSw)?hUFbg4zpHlFcq@Qs2U&}yQ=M0q29{>LZ3M+15XOmPLe4m~{9_j9n}
zfUfRW-8yi8AYqAfxy*&1r}pjNUr}58$TX-N2LX+AGy(Vivv$hMr`x?)$I<bLF|dwJ
zdvO261ba}>iUGeKTH6I1uQY8rKhSvVu63+=3mm;^D<x`ny0-6ne|`O0Uj@+*AK8}9
z?dIv5h<+o@>BhPTx!_G><Er<H)YfF&g0|H{q$D`|)VH+Taq+7Drhe7O85tSgE*o~5
zNpN#<RWE&g^ilRr=IQX4C7jrhlGfu`{`mv__?W=TmZ?KA0>Rd*$r4lD&!C37b?cV>
z)_H(!(H%S3upESRENE$I^}Tw+CNI&dS0?@YFLQNWT|b~vP1*9a)E-5}jpE{~v0MU?
zyY|V^)I!NV{QIh$W#aX|AvQ}(OBS?YXJ6dAa%IiFjht?0M{(?TqKtv5#fB?XW!pM?
zZ&tcW1k6-f2UMhjx0#;2A98<qp!K?-<dgk}9(E250tiL^Jiouu%KIwQIc@i#I#;G>
z*5>?q0B2}aw<4GGHYx718@{!4C+A)>ww9-E-!&=>7)$WCy}d@pk;>D(99+A1Zl|%l
zAO@(B^65v^xGBYooOpJZty5o2lfL;iN{dOXy{vEXb7^^DBHL%mrWzZ6`fH;~0uHaW
zIm1O++fDSQ@C&Vbd@u0Kt|&_wGQrVAM&??>+U}AI>wvG!>V19>wYYnEjsJ`b($u5_
z???$$is~3!kESXLo)A)x+U@rWG;`4HJ(Krki-<G+nH_y)iq9ZAU7&B~mQ%@^F1v&4
zbLuM{m*0x6Y^{vH-GePH8Rm+pRVy)N0iC1P4i6|W{qnFq`O4{@yD3Z1QJKd4TS<Kz
zZr}c*c<QEn$_eYs59n3iawTkur#oXl@|e@lNsp0X&tB#CyboyJ@eKDc(3u}p66th*
z?7nYbn2u}?YIwKT^P67(`5^&2dTt*qm3%s&H!cBWClsUdsp+n$zK%`>HVbk<gLs~|
zuC}(asVTinEoItQ1#5hdVpHA-BWKFPbK>#3eP6%Q!YGQm0k&%u=~*_j3f}Ps&t38=
z-$5(0MWp0BLk6}@Opml-ci>e~&G7QJHg52HEL9?zujXTZh2|BW_$O2&)$NzZYKpSC
zb5U^CU<}>jf?_$fiA`>7R1wEI9LNHLHjqTPJ#@f#Ij@prTWe){!bH$hVldWV*YdRv
zCk@w=aYrxTwR5O1@A=Fux-`bA`h;DJZKk?+`CZmaY0L8J1plUND(VKFv)>v+H13z*
z*Nos;yVfRWVN=@U6iRI8+4gxi=bIj$o;xvd#<5|8{U@UjWkD-)bd@+@C>LPeqAt0?
zyCLqhDQ=*rrze@;_G^t9dtujn_}25>Yc7)3xkQu2Qsqu_KRH<tqfdZ1A<zIRd4)XB
z^Bp)LcmIh&$b&ETT-_&93iEmQ=P~cvl2;I*w1%d)tBx&joNaQ1x|S!0=4-iXepXJF
z^cT~H?+W@UgHQGu7$g|e3ML#&)jVXkE^Y8&?4pOORHiOl`s?YBp`q(V_=YYrx*0|?
zC~6K3uktok;bXb22fARCS7YX^6LYw@C76Av&f_|z-v2Ch|M6+7q)`^-<D-LBP;J&y
z6%K1OM$xK!Hrp19c3k(+)n$eV4jZKkjl*ysLUEG~GR!VNd9p=$t~Ye@*RTHFBT$;H
z#^{MfZXn82j1v$OhXeoon0aU7<$MIh9$x<YPoHv3+p}oyr$&jhRH;9DpE7B$XJvHm
zcu1uhZPkM$<}JHkQD3LWU!rtp$hqg8sA{NZt_t@Na}1VP{G*t1FYaK(_w`<v44&^l
zbchYr4rVH@M(cF4RY@N?Gab9z=}6}L2Nw53^rya;nJ%w<FB^$Bd2@UBlX$1A_PcY;
z#?nP*Jj3r@SuJowo^yAha4j2a>4+2~HfD~<*~idgfQC0&Y_xHX_iTcHp2_y^pp^i4
z6|X02FrY#u*TD(bVFBL_Dg-&cL&*sV^!UJ#8(ZP>C(60-N!eLey|8q5mqzXI#<Vp?
zaK~6*UkDghi-x4|hYo1frJfCAzVzTTbMZT&Y6l*A)O%dri((=r;(qO|#&Vhov^1kH
zwlB}wGMP%OX*V^^U+j4{m~U#?`m<oQbNY7co^K73)=o=xBSv{8(Ym7ACcgB$X!(8S
zS3fXzn9_dlRgiLMO<u-W&Rkcal9A@XAWQbmvwHS!!LrK9FJhCDuAmr%rs4NQPucO=
z^v`EZ)3etxu1arh@7h{ipU{uM=Jr$H5$&OG&G%x^(GXBP7fFrLd$V*EN5Rqw1+P<P
zX*f2RShv0~9{Tv0{oP%a1{Vn#N!|$5_Pa%1JbfB+V%sH9W+cuVt5x-V(72yveoOqU
zmEn`YfdTi0c<Nh8?Cwns&O(I*kP09oYhv9NuWoYxh=`c%y1{APJ-&ZZwd_JRhKgjT
z9cr;xc=<Rdhok&+H($n#!H}(6(-IZG4p^R}P7Vqkk{kMdO4$n)8xtrDj6!Olai}97
z$rF9gTCIRDDx807^)g5k8NYgYq$rp;)Bq^Jj@7H1uYz&dmAua{SQ&H)>s+lM&}C$1
zrhPx{A};u_#gRNO&;mHm<@Z=OBj^xB=aLEMf;Vs9Uew=&=^l-;z@;xs`QheIooz1@
z;KPy=B|f&q!+$rs*qr0p=MhoE;gnB9_dhL96@)JZHI$t+QQ^9+RHpxMzTYifh&f7V
z+xY8cpCnVQ$5|m}!VD6HUyOU!ep=#vGhH;;!zP!Iyv!%7yzXuE{+-^B?pX7nnn=A6
z2B3#02V%SPf;niFxPS==k(|3rcnM*J-eCkP)t_GfgmI_>u8upgR0UfnDlJ=;oj29N
zPUCm?)S6u+td*iL0ik5JX>2QAlgN$c@O3GJwvYwuZwTvlExu&^IQz;Kz2}+eZ#P7B
zgLzEe;dc9?b%95DtksYelamCEzzZeeH|N8j((5M?@ffISD>pZG5TiTZ%QteMBjCNw
z@j2$ael@GH!`B*Bv=tJgy$?I%a0lR18Y_gHh8bpkw3R5k@d5T}Yo8VG=M>ZG^fG1Q
zcRy)huyM~G9)QS_)n@W;-C;Oas3kE!=(cwY)!5X+A{yLYuAK%F5ZoxEa>5joqfNbQ
zqYH+&3dcd4b0Z;P<E~vd+R97diU;7=Sr?WWQdb}`|Kpq@iX@)Ze^{zsn%H_5(8ufD
z++ht>J|jDO9Z;SRtEXF@YnP&csy`359A*_1XoK}>&9pph>lkT_M|waBd`sHHhaNQ6
zh>O57T2Xv8c8nb^;=qY}PoLfjzd%GLeP6F<VsJhnWDxF>g?B6M_KN)|Y?1GgOj^^0
z*M(cZhqDJrVQ|y;!N`Mj%+Jq9DOED^O7<)WCJpRgL}QafNC=c%glmBRhAL^S_pC(n
zl<}Fgnp;@-HFN&KiEY>J-tErVVHs{Ma<d^yiy3p28P-FsQ?h`i7#Obl@%i}_R=e5^
zzKvJO7*GO2ZM?mEjhJ>c3^Hmkgcox4DhrBLK5b3?Xj*j*#R_**CZ#J`z=DB+fv^Ip
zQd^ln{K6=k7NeXc%D3L0+DQub*47O+*@*?cmF|A4dn#5JcOQbpc*~YZB|RfULx#T<
zu6AlpcG1NXRkB_L{%6D=fBqR-M@M|HeVwtT|E&eU;FH@zCe6ol^EpnV?P^6uMMlM5
z+c$39NS+Rudoq`TP46X}wMvK*69w4;ef?@E#pYiNc-})z&asZ{ipRoZ25xR{7C}WW
zh-&-u<9WRJyib|xIPkc(fHQ{IfMpD0At@L63!C0uZmh2lDJbwx8X5a^Chur{Au1z0
zd@Up=+qPLYr(Jw_B5+UWZf^hF+DcY&DP5^=;}My0%1=wH9x#86;<X){quB)Z1cQaa
zkt(mKph2wRQ43Tycwy9%N>_nn2nGjx*y)h={Vmywn#u9uwsUZ>{q*Fh5jLW3*lw~4
z)2FVcOr|^S3*r%+UH444XWP0Jr>Dubm)6pT^k$guYP@XC(^=?2ht)n+DSJaXcz7HW
z#@3Hnx4U#+3)Xx5k=O3}shzx-XNaP$jFuD0qPdxyD@(45V0*Z6M{lo{MGQT9_E?mT
z^=r5Nvt+BJ3E`7vQ^PE2n$I#(@{0|G6n1jGOOIO|h&!x5<MXIingzRL!*MvV;Ph93
z!hkAhFVRg$OikB7iA8;Vr%8jCK5R69ZB>hG@`atPBhy<XCHH|En(&K?*A)j`z|D})
z50%2@-SyV}ym+q-zh3)U0*6qdY!N|Y+C}#L?oOqy<Fpy$om>5toa+lL%K{l$S$7Xh
zF*P+ck?N6nfcoRVi979dW8VGFv#Y-@PRKdz43l<zFY;O{qB8=~B#eQjD&^6mTA)kc
z>1}9S6^-_SjTq-^%(gQCQ<rVjIKn|CMDfF8zen2G!Nr%vbFnHpHGK{VaH1pB91cN?
zh%G2<T<#rJ=hYa@1g(vJf=;f%kmf<(6`aaM6+by_^zwjuW^R7|*6-zFO@Du7LKmf_
z{R3`cl02pTcuFc1U<B;51afS%^B;V>9vQdCaf4`a`o6~>`>1YZ`{ChQq(%Gs?)%+*
ztk^K?@$1_`3;8RQ+T=W(l&)5V`ghlNu`nhjCDBl#qoV<^H1Rhs@XBK$na9|d-3V^C
z7q6OY^CtL1>2%OnKg62HA6h1(oKsBS-X&jQ<(Hc@u%D0&x8}gw_KDXEY*=&D7v8qc
zh7DEB2fA$DN63YJjkjd6Z?vN33U}Y==vDB2___~JCzmb%k;vp_n=wm5D$mUA=Lz4d
zqr-$iMz5w;=GtN5p)?vij7b|GKfh3Go{a43ckkXg+FnLK-B>T~fAA0%+Lz(qB_b>P
zQIhvSyzV9WZXY^K1y+Gnn8GpZJ}YiXF)HzqAtVD%U$^7TJ&+=9{b_HOt{@JL(~LfQ
z@%g!7KXOP!S(zFTANFlTy}F9MVPCdCG_2Yw(IZO_D<2eDIBdAtg?pR*ts=Hksnh~K
z>AwIcD;KeM8?O>L5J`7C`P2B3NsKB8ZtoQD!T!(2yDI!36|s43B?1>Et~<#4RoCo$
zd{$}i@y_v59?zasN^GoOHDuaT{V{4puTRFm&>`@c|2e4SDslPWe=ovKMkh4)e-oKG
zrVTG#o<4ha5lJf|f+6!eo06=)G1Qm$?^ig+%KYvBo!@o*(Z}IJmNX;D@%MM_j>|eL
zUXF~EzED3qP#<Sh=q_si?#^X2S#IQ<DgcxonC{&AH*pf)K~zzZ&oI-X2G1-SMa$0s
zo!PLLFL&WkcF9#e{Cvh^`o~GvJ?D{~FnJ<<=F=9!-XnnUD0rTF+z>tLn6$X)-(4I9
zijGt*n5aoV(tqXH(=e1(8u!(KXdm-?;H4iw9@nCv0h;^ej~9pUsd}?`qKk3u+BF)q
zYQrKTe&v5<lXj~&Ol|4y^6sgD^TlL`!#(SFcNAt%)wkV&AwQ^{DLBqrEicZa5v=0+
zi>Z$r4H7E4i7X_TK|FAPCWUu++7}lSeT8tU!Lj4VLs3^`IKv#14xQj))eA7`5kt=w
zuZa-EUi`m`48{$d9n$e=H8eFRUPa`Kwda&st3NrirSPP~sIdlsw(E?ItLu)5ilQRD
z*I2fYsN}r^$H#r>y(oV0q~FUE+^A9{3^S^c@!f|%h$Bwp4l&<gia--LJ#cYKy9E9R
zbFk2b>Uk?=R12vTG!xh!4I7({2tP;AU5t!m%xKsnC$|A=jn23*i%f0QCHUAfSfYb3
zIMwRXD9ysm%#2;u<qIYXUd^8P5(V}mC%45PRd4_FX%&<;Xndy|TmhCr^JzL#A@tjp
zd05BTj&~L%?(x`&XG)Kp7T2}1^aKE*S@{<W#%Rg=WnPXXO}7G!@$Nfuf(ucImYtm)
zQRoQejo3^lpXts+V5aip@#>LDX)S}6cEk1&J}vlD?A;kBfw%EYQTG!jU3Drq)xKRe
z)_=^Hepxct#Mrpv%NIUE&tm`ik6m7#o<9;c2cj;*iBUy);*270q%E`VYt5CXcP{W3
z*w2H{A<UQl?OjY5A^ke__P}9Kgu@$Hs(P<!3soQ(PXd8F$jXYPEf)&6=79~97#Kqs
ztW-#qEz*J{YNt|d2i{yW|6=fAJw$Zi^}`=O-mIaa;nSp^V`uPMyNTy+oxp!|38EZ~
zutWt5@Ak6tkO;@iGm<ic=W~+|{d?s~)3Kizl&`>by#@du%D`@eRJ*BkW#KY7h+jOF
z*Tl3Z5qrJ@(y(ukG*bUg!$c`R$6#<E^EY00f3kOXQU8b;8k{I9&`B(Z&uRBTLoG#J
z5snnNI?Z8(&wY9E0tVLj<2D`Cz#Ut=ZXIa?Dr5apXa3rJXXlJx_ThAopfLMG3aUCs
zsXP-_KwyLi7Jj*_ZR@>9+mpa{UFDIf98!Mt@S%8TS69)9tzmn1h1JocoWP82MwJ;^
zBcmPrtFBLgO4ENG^aqcc<ezXh!GCdVC;xa%4D*DCz-kSdpLD6wPP{6l!k4NQRf#$A
zDHsP>BUke5KEs9AKcp;jpG9OC(SQ#DxpV6L;?k0gQ>!G*FB*p!qS5ETPqB=xWVX$B
zRW=pftrHFs!2B16ST80e@eBD5iN3Hb>mD$^ys*AX+GixaAj`33<J{cbOJ6jGRJb{E
zsJefqM;vxtfmzne1{!PRQyd70Cf<w$pYCn8ZUb;M@7~&Zax{>nSjJ10Y%!(QJoL!&
zTHhHF!SA4%@V0jBf^f(6OkC?Qjr%&XxwvvnOiVrtV+Gm1(`QPs+UiF3nF!=sGUG!&
z84yoVA1PZS;C68L!Z%(-5$qK5bJb&(Q6ZOO%Z?pdAmL_LkOYXw;T+B&hoGQKj@@_C
z&DGauDJdyAVq)^|dI<vx1)=Al=gPq0aH=kV3Sst<{y=7<%Y(o(#>Upp_5n~2H@l*)
zE}}s4lC``<PgMqM!;44VZvOw>)ghP{yJU~r#-fjao)AfJJ1j~fG0bSaI5&0U>6r+4
z%qTC6=JLqevvm88Y^RiedU~AD=mILfT+r>ksjsg<s$qjF7Zd)!{A<G8khLw&wegl?
zQr70r?_mg=N?4i3x3>orf^+Y^t&6IT)Ly9pwFOjz%8c!{JhcOUHcHQmictFSBKDS8
zUeUPUJM;batK9tU;2j-pb!=_LP>S?^`$iAV2AZ-&db@Myhk>^1ckf1jzw5^aMtcrT
zu?t-i0hwDRC9BhP;$m;yAVG_~0K&MVY6?wE<jEND8*P`-Pm*K3xx-uo(WvL<L7#mN
zl=^_@=!cNdV`FQ(b#8<nG#^UWL}_c<P5OzH6!FAD&q3y!qDW0*X!kuxO)Uy`Z_l!B
z&#_wr%54&s7`AU>MN1ME+Si})k13@wkxRz=b#;LkNcP^9<)tFon;1a?q=YW{O>^`2
zcefEa{-Yq;5%3O}7SVkYNcSt85Gqjx9aKC%6^LQLFN+t@A!0@vBc^;)Q&W-A(Y0{C
zY(cXcPol5-^14LD^V=RBO8)o3g9irM$_FMidDT68jL`;DU0FN}KNVY4vwN@*@DE%L
zX6-l^i_*i)EpOuSJUqsP{L`2y6RK492}PlKX+E?7xOS7THJaSt!OfsLn1;>=+bZ>5
z)6ui2+uEic?J&x0<Bz`z_Xw)s3rK6oKF~Qhs!Sr<*!&!*SIHSDMu;I{7atJw(d}5U
zijkYP?J)sB$iVh!v3wko3%8a=S%{7!r5w_PYY7SA$gn)bNpJR*Wx(|MXe=9KSDm9^
z^p;|B(Y1GGA)<aM1{tqEui&FkbtEUngza$~B&AQDFp{bO-5HO?IgdYk+o~2}3YsYI
zCWL4*`CgN~ub?MT6ZjUY9~u8S_Z^y;xpM@UnmGN-5Y15(l!)hIP@lCuT32Ki{rmSh
zu%#l(%6HlnLczEtmH8C^l=a*2Nm}H@^Ur9?$S^Zg-<p6U5<$}e(SkG`fa8n%yMAOL
zh;PLIg^y$n@<<j|){eGk(;a*IX|&Dk=+ThE!aZ;a!nmm*=Ce>JFlU$*(W0nAU*apt
zJs>p0VPtJvdzF`z6jP(Q%^<H?djc1>8)RBU#Y-4^Iy_*aK^ZX{JmbYzkT?4qk9HE>
zbhx0PmVf2H{nDjNK7iL#NCr3$v>-F8&o-+>0MCZL`k|PDTUHg$T7}<reOVXpQiAey
zAE=h=ad8u`($geZz7IoiUD@0m(`Ly98Z<UJIcjex{gefB*@a)5FvFx+@-13r%^4mJ
zAf2j~7ET;!dDqVJP<GWw{FJOXpGH|$G^z+-LQ6~Q1O=mDkRm238d7`^-VX=|Mg^|P
z9l|ScAt>K`&;KI6wl%I4Ih`=U{TC&i*=v7ZNSMme!HWRhwI0eYaS*snnC8Ls0T&ln
zFCcbZ++kIwl<5@54}LA8Yd-W}@bNk4yJq#mLKKE@>+_&K!3;6kGD5_G2=CeMeH!rg
zaPBN@`6s4@AAM-`jn`f>ZzF^S7gtzHiU=s>l+XFs355TW=Y-@aw*^A~(aAWzq^@Jz
z;?utkpO>%td3N8vRhg!SJmGzc*_s*}(wI(Q3vlkpO+lzIi^wubC)T8abA1f|{PRyQ
zE<`wT72YKs2AD2hq=mL*_6?lx>;53+@pdgkeEWIy<LY*+F}(Y|78XLUSC;(<J9b!k
zY89e=@8BRju)>gkCCy)P5yE@4BUi?znh`hDJ$IvuvU0gJ3s3lc55=&*SH93^Y9k5X
z7@Huc2HHrYQs3PK+g>}+XwXW{vZh<Rc5Upvdu|B}n}ci$;(5kpu>cLvD6+-<M{!il
zf9in!pb9x4LvpIxi-d%CZsp{31&shX*^aLLK=fi_{n6q*8Kj0bGZVlg%tHHV;QMzm
z^q9Xl->XCHbw`YiQ@y(thR{TggjtULAf~(*Fd7)F;x{7#p`2t)1AWkFE8D|kmofja
z4u(e+Xi;W^%^K(K#78FZ458CydE?u6X5!Txb_mf`-Q7aObm#VNC$L9-gM*jgLe!6<
z*Iwo0NlVMa{LHT|tBaK5e-Ok#h$CP+a4lw<IvN_ZgunoJOYQqK`XwJLJP2z>xE^^!
zX_nCI*VmdAd$H2c&@eJG_U@*uWxF*FnF27(nGY$6);u`S>^{r$-^oy??XPc5;M%@h
zWE^{X<m5@aoI2SEQ#JW-+aBi7+=B`OTSRsH(TyY}F8U~h7*JlG>+kg8MifWQK5pwf
zl6Q1c`-=vzy2h(sz!4r*|2+h(;uHo?Gz?F(6vSsa5Sk8%7eWnC&sDJbfHid^^*pS}
z(9j{`31wvgqKY-wGt_(So!a6!30*LuhUXT4HFI)vw~6VM7GSY?UvF=)W(1ox4r1pR
z1ooOHCVT*b2WO1Jm3(Kh`2@NUH~?GW_emy!QjYXkfTDzu0~xS~4Gaxh|C5;Ju<6LL
zi;Rhp@0gBV;9ngameQYGtFCu?2%EsM#X~t5+;rl?TAj^!pm@M9O!Am<2Z;q$o>N;d
zAXc)dfV`_&M1K6a^~K-bb#&aC{p{&nZ-_&+abxAcUJtOdgcCp?<0}!XUa0{Z9*4V4
z6v`|#IO2;B!ddal%hTqrw5Ojd7oQtGMjY1~Zc1sRf<m={;TTfa(NN%O8ok@8RUJ#8
zko*Wh#}9#X_VJ;UXz7~xV5Yqd?48EB_FaGRWl<11Le?-QjJ$lgg4@#H`rC7{WN{8g
z!bl+gtX5lDBq@vmXY~rV)W)q_nI0d$S6e*s+UaHbDWp#xIp@UshzN+BaLW;*CSQMJ
zo68*-fe~`T^@&@u4$^Mj%H%++El$#9^0sC8!iSxMn>zv=vU|_3nwlD7t)&=n4+!D-
z<3lx(oMMyX#S@+dZfNQN-0eejN1KA+3_NBLkaRe=KGUBKW$<;eFy0E4{^ay@&9jrw
z3)6+pb;rEqwxci&r$Cmae`gOTdcC0kGK~Y<5nvVwC-vdO2P<1!x?B48KkJ6J1585i
z=Sw|%+xg~Zzi7C-tp~jec>eVrM>LNNEx5*Hw)PX-){{>7ku4mYoHUTiW|ZieS4y+|
zr=@x-;d<tw$5q<G0bz$#=U4H|yH-Ege`Wm2yN?)-{t8ttA>P4yWS#!F>8h~WYrWZ`
zz$M?3r5P%*Ga#s)qK;#UVl@jdRbY=hW#vy>nKa5Y^t$@K-wUdRO}z{RoRE+aryCr?
zh=Kxn3iI-TIzm)3WZB_rTN3_FOU?OU$B``iCO#Aw3?w<>uadGD4;O`knR?>&>lbl4
zuL>xvB^>B~4kQVwP3s|qYm2r$d(;2<^XJ)C6|{(IB)ou(NYlY21s6AW-TA!Slk^y<
z1BpQhnJXK%Yk*k`{4>0n+;KEs_F$h7Gzf(YDII}nvZQ}N=LIKFta#6x-+9(wVhrUN
zPV8e!tTw6!bRYMe{l<d)8<iiQMPqGB)djpHg*b|KwBtyrop?P{fwl$mW?S$Tk^lZ%
z3ChRE#kuGv3~@GY+C&fLo4C>!%n#y0R{|Rn+xqtQ_Fk~F$hU%{V`Ids%?jv@vSm&z
z*?Z#qAk(lGXthE5XWf4yI`1KfL*I~ns(vkb^bpp8`X+gt4EGRZ3n?>?l9wcDqypA|
zMa9aa;=7AX9u5sT#@#elx;Xappq`#4M&0m|_4yV-llY@C?=zZRm*w2C6QMToVi_B>
z2DMlV?eVRV7vbgZg7MehUJ6Y4Z`|O58rKFiOQQ0Hox~1dbr5Cjr+Bh90;I3>Tgr?-
z*xUS5i&gAuuqx$)Xp%%sf+~lBTH&mDVp}|fAYl6!F>h84oRk%`5_pwg{$1K^keZCZ
z)Q1E(f|QW}?lCuMP2N<Ydmn9UhWQn=bO`)I0|)zvE=EPMa{qH|Qv21#SHVofo055V
zYx=5&s8fQ1f_!{^H{xbMf{aQJYwI)so8+9^gNx37w*m6+bpJ8qEHV5H1rx~Y@~$pH
zuuq$$=20{gaSDK8ty|erIP{x@(vjb=VFTK8WaPlr?-pdsuo4J{ffy|431f!ufH#2B
zDN!{*F}RrFdf0z%^d=}X;K+!wAN>@56@^4ay2AehY}>i${{vkeB7N0(S8?C>?{!^)
zBl*|i0gO&imzSxIVYc~ez(gYPz-B`ox`Q~*UB%x0d2JR|C@&{r)o}FtX(co;Z2KxN
z`TThLcoGI?rA=)|w{VeyNI*cq9Z}VQ*Yw9v@kfMfS4rGTSN?y)zFZJ{Zz?qTaF=c#
z)Hlq{AiwEU?Z+KR1&Q7%SqZ#?{@2SYn)_hDAQm!u?XM8HJnukaJBW)1J5MQXg*dUs
z=I_gu$Sm=sTJ4aKSc8!s4DHvcEl;rvW!(6^;V)mjo|~H}kFg%PCY+TY%0Ctg0fDI6
z70=(ppc^?jKtY96C^8-$zSlkILZ9{v^n}@ty7^z<uO%i%qG~rQ@!>pl=n&FDpKh(U
zQ@6C_{O!~Rd3;Z3P>FmIG%$m(uy9=W%F;mV&UCHR5cE`4{|t%26jT^+XYf@36)no~
zj`Xbq-FwLsdXItXZ2XQv!OBF?N>v!sIz|7WuA=4}=UA(xJO92O==8p#eV>I@7ql8x
zF5(En_<Y(&j&OiGJZSOLj)$IsU8ou`X$l$Mw(HgTO+D8=)!w28N9`0j*l_b~fuQ0!
zM&W?poP?)NNl7X0W{CH{tZ)<|QVQcM^lol$L^q7M*EuHaKS@KX;yZT)gfgQ$qfFBO
zo=^xS(MA!&Q3vCOT0s+n2oN_g=nVl*j-w9(8%dnvi46d`R76b>?@z_VzAcU%nKvNx
z1}VD}70zzL)Fe(|1XSnj2$c_b1H%kI>Fzrq<v9|^szTGnkFs7G<=6|eqP2A~!ep|8
z;2^V7-}Pv^0)K#GAaxSCsVL6Zdlr@G{o0D9rc)^FM7M7zRXib)hMgWJ6EKg2P0A1g
zzFs<Vl9~zJzog}B0kx&y>$sR#2PiXTl90?jIXM{&a1LB^)io2`5oSYlge8#KV^n5%
z<QM0#QF~Kq5G^@^Ql-EDUUa9njQddF+?2AcePNt?#K<Ue|CJ2{-UeZ71)&VTf(}P7
z#m!LtjWi2!t%Zb~+-972H1$TqXP^B79Gr>?TBHNcB;8uXOUM)G@=TgW&a<K!Na{xL
zsO~6a(ePmC30gs9TMw2kvrUV!i3UG+7T5%^7T93na*loypB#_>wvMpgj+<gTcdi96
zt-@bC=-ZQ4gA?XHGipqFjOu#!hS<Fb&ylIGHHbNwKv9(UwXgYiJvy`+sA<~l1o-){
zz$cW??mh&5_?bc>oj~h}rdf4iROQ;kw?I%(Lg8nF0+a(SRU1SG%u%+34#{k@x3vug
z${}6w`uchwsIu<2IJzUs>nAJ5w>gQG@+aeGziCxhj>UQ_d%<PBp8L9nl)<nzb#zVM
z%Cw4>^n^M&Oe@*Lt&f<QH71Md>*`hlHljTZB@b8tpTT%TB4!4ZB?`rW4)YxADtZ)J
zA~1%U(381-<3<?%ybY)U2z}TcpUC#H5)>r9JX28Chbn+{YEcYf9w{91g9_&g;b8^v
z%!`YQ(tb0}B$*>T!E}OODHmUue8vxHI_TD(c&yDj{SW9dcW>|S3p@9WUZ76(*WqdQ
z<4SWaa#|dvkL9qDyFpVT4~G2mzKf!o;V+9Gjar;t`g0z0C<4Mki!$JE%V!7O+p~9o
zN8XESgd|VZfIpJ~#%VVnSgJ7&+p|=id#V)2aU41q2%<+kDtgd<V+~PvuT#UBlk-gi
zGpK)8nfI{D^obbeWlA|@=pgAy0|v&CG|bD4nOo=%Fv{@1rCiS#8d@GDe;)7;K@VP>
z-Z9&=1M!TtnvB9GL*Aja7KJzcdhw^8^7N<U?r3q&Qq56&LqR=T(;<1>7{GyCaS%cz
zKcaI07G3+m0mh!2TKd&hRdkq&8uRV?9}p8($}z0Vlp~YczF~J41U23SKzzhTf|2U{
zz`AicC{(c^f%-ZM%?Ew`t1WCjccH>z0wz14r$<KtZWh6X1{mHHa0fw1(l}=oDJS9D
zh}Gd!D3)>iJJVt`eP5FgmMBdF5KPV=cpWk=a%Nmybl~s_+D&OmOA9?KwF%ozi7uwH
zQiI3=u#IpHn8zObnIEXPP+1%}bf^}WoaXl^s}MSl72wfKyHqhL2fCc<9Aio>9hMdd
z@!ww;BTwy*z3YILVwP_<OHwFIwZs<y6q7{~EZp{Je9<C>TnDay%j3hsC6kqF{tG-I
z{rFQq40hx?kgg@pg?mAE#XXBmx3j6lXxFD95T7H&>72}>?YmxfN8SaR6z!;GkuK6x
zaS3cfjreAa#BTWyj=PYq_o6bNtl_q_8hU@9(49ESUetnlux}je*ViQTN=itO;tmQw
z#6l}P*x!F(u}caCPGMoU*4c-fL1dF~RvRtoR~I8L8W#IEX+~iJBHO8L2T~+6g#d80
z9($%-P!|x$J$_^Xn34<;l72K$%^sgg5i*N51|Bm4BL@(btfs&?0g=VtKXa}CUjWlB
zwje$IEty5bI@ghin*>Er$#ko!QLa6!LAuE$j4fE9!Rqaw1fCke+7?7vrwhV8DF^~r
zmb}TaBv&@WqV#S2rA&)bW;CCm7^ehdYAj|va`f5UoDZR)SMav~tHaKrG0rqQkxMJ8
zasX;Ap};w77_rKeL(+ZWyCB+W{dh-^BNYS`1NVUg<Vj{{f!+c#J#}?TxBst$g+)cA
z-1wH`4?zvakBAKg2#voc+Q`jXvray8y3ar7D{3RgqxPXHTecrZxeFoFSMZo~a1i9=
z;IK-l(>ZWJ9g!8)bnn-%7r{IeR?_~0qz2>g4gyqIon2g}zFv{~ic4ODEp@CEGQEbb
z&{UIr4@Eu6?hA-O64P<d;G5e1^7K05*|IpD8AJv}@dnqR9PR9c=d%%!%A@H|7;12K
zStwk<GC=oCX8FqR306Dzp0>05{6oMR9gx}>;TX*AH{20U*kKHUg6xq6-(P`ZoS*D~
z(Eqb1l%BN`1YIN$T0g+XT!ZEE#nT@jVdf$6w+EwWn$q7R37ArSl~<O;XDaB=Y_wTW
zL_xKYZ~RCFo{EGvrx4F=Orc$tv90aJ4I^%6U}cY-I1z>pHl<gqf$X<!$7YAWK^m>u
z{TPq|D52|ZF3m*qXy2(*{|H?e;1p2ydB0_y@yU~ypl2oR5&Oj_=MEx_!Us~ux^flD
zB#$6iXgPkUyMUTw@{L%G2(l4aRv#Ev_YDku+V)(RQFM0gmsJ{!G2I{+sjpw8rL98w
zMOqud2@2lOPmrqe-aTPTFYK#`!L`h}p(7M^2%CUX3O_@h1`Vy|7Ot-!9_mqo5f=I}
zY!wj`!%p%gA{LpxgdvR2&-%?p3rC-S22(FbUFbgPe{~M?W~4+z>z}Z+OH)ju)h7_F
z53mnnS{L6<7!iyTT(&qUg*Ij_4q!A<dJ#N@8-N|9h0#4FCCWhLXWgKyz*OzgBS&Bs
z%|ao@%n*8Hdrw#p$TbI`PApz|P=UiTIRv2=Z9hO=d=1A0J`-A-&6_v3fBEwD61PP;
zEXf>hG>M1B`u$Cm_tD!UlSOA&*cloB@~_Zl{B^m4Oo$8?_w~^j8XAH}MG=nOfNbCe
zC?>kikTbq%YN`PR{3hKFV@?<yrC=I`*qL0k<{@0Vk`n*MYmAuN@tLe(nD=e-yMrb&
ziV@7p5s66++Uc>0i3j$Ihz{J{|Gby6NE-_CK4e$3+&YBGEU>rWyR5!7-XhdCX(^LP
zf|j3#udgBqN+`WA<MBY6N5Cz(nQygk0H!qnif{->DS#_H7bx$S79r%z2rSW_?~>FZ
zL=d!5-kJ5t6yX>iN*crAE?o!AP^699)CW?wZ&?bmfC>g-tX}<!Yykuifle=xZ>aBw
zSv$aA*~+pK(LVqiHzq4_tLybgK<*79Bjxj%;j2_ZK!SK(yZnW+bHi&1>e;t%U*eby
zz7gTiIyWOeU{>P<r5ud*WsvlAD9lK0jmbHXyBo#CWbEE@Eh55cA(%kb3<Sg;r4@?Q
z1ctjGd@v(3^F{Rj<aa)jH^papq<@PRg$bB}uOKc6wE&=TI-!mzVtZDWy#czGq7Q0>
zaeP?+X%$kmE@*iSOM+pfqhO@~SOY6e4FesQV|Gj$?GlpBNRtb5wNSKNyM0^t`w9!J
zhDe(O0Fk^=(hr1X)(7XoDRI4o-WF})8clYUQy`hcID&Tuhy7MWdydc|2u_ovFOiZ$
zVOO4{l$4ep1&YpfXtn_qrMw@>4WeX$m2mZYK_(f|w&~ZJ;n0XIA`FkzZYUL$u@6G4
zKtV}~09hhBIBfXYFCGLKcuAtG!zrJ8Er5>|jq+VIjbV@H0Hb|lqV>y!!<cJ<IVdJB
zx5YpE{8klVSdy7S{tOf=`;H#H*5U&2tm){ug^(OsS<-hiu5x&)Jy<I(8upt4(NOwD
zW%M2~HhJ@+nnq;(QEvPOhsFUZO>rv?MkG>;aC}k@{IZk<FZTcc;{W-F(6~Z(EOr~l
Tj&^ZS@Q=>^L;Er`tS<g9?wJd@

literal 0
HcmV?d00001

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 1836c4b..da86704 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -74,6 +74,7 @@ struct _interpreter {
     PyObject *s_python_function_axvline;
     PyObject *s_python_function_xlabel;
     PyObject *s_python_function_ylabel;
+    PyObject *s_python_function_gca;
     PyObject *s_python_function_xticks;
     PyObject *s_python_function_yticks;
     PyObject *s_python_function_tick_params;
@@ -208,6 +209,7 @@ struct _interpreter {
         s_python_function_axvline = safe_import(pymod, "axvline");
         s_python_function_xlabel = safe_import(pymod, "xlabel");
         s_python_function_ylabel = safe_import(pymod, "ylabel");
+        s_python_function_gca = safe_import(pymod, "gca");
         s_python_function_xticks = safe_import(pymod, "xticks");
         s_python_function_yticks = safe_import(pymod, "yticks");
         s_python_function_tick_params = safe_import(pymod, "tick_params");
@@ -489,6 +491,88 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
 }
 #endif // WITHOUT_NUMPY
 
+template <typename Numeric>
+void plot3(const std::vector<Numeric> &x,
+                  const std::vector<Numeric> &y,
+                  const std::vector<Numeric> &z,
+                  const std::map<std::string, std::string> &keywords =
+                      std::map<std::string, std::string>())
+{
+  // Same as with plot_surface: We lazily load the modules here the first time 
+  // this function is called because I'm not sure that we can assume "matplotlib 
+  // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
+  // want to require it for people who don't need 3d plots.
+  static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
+  if (!mpl_toolkitsmod) {
+    detail::_interpreter::get();
+
+    PyObject* mpl_toolkits = PyString_FromString("mpl_toolkits");
+    PyObject* axis3d = PyString_FromString("mpl_toolkits.mplot3d");
+    if (!mpl_toolkits || !axis3d) { throw std::runtime_error("couldnt create string"); }
+
+    mpl_toolkitsmod = PyImport_Import(mpl_toolkits);
+    Py_DECREF(mpl_toolkits);
+    if (!mpl_toolkitsmod) { throw std::runtime_error("Error loading module mpl_toolkits!"); }
+
+    axis3dmod = PyImport_Import(axis3d);
+    Py_DECREF(axis3d);
+    if (!axis3dmod) { throw std::runtime_error("Error loading module mpl_toolkits.mplot3d!"); }
+  }
+
+  assert(x.size() == y.size());
+  assert(y.size() == z.size());
+
+  PyObject *xarray = get_array(x);
+  PyObject *yarray = get_array(y);
+  PyObject *zarray = get_array(z);
+
+  // construct positional args
+  PyObject *args = PyTuple_New(3);
+  PyTuple_SetItem(args, 0, xarray);
+  PyTuple_SetItem(args, 1, yarray);
+  PyTuple_SetItem(args, 2, zarray);
+
+  // Build up the kw args.
+  PyObject *kwargs = PyDict_New();
+
+  for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
+       it != keywords.end(); ++it) {
+    PyDict_SetItemString(kwargs, it->first.c_str(),
+                         PyString_FromString(it->second.c_str()));
+  }
+
+  PyObject *fig =
+      PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+                          detail::_interpreter::get().s_python_empty_tuple);
+  if (!fig) throw std::runtime_error("Call to figure() failed.");
+
+  PyObject *gca_kwargs = PyDict_New();
+  PyDict_SetItemString(gca_kwargs, "projection", PyString_FromString("3d"));
+
+  PyObject *gca = PyObject_GetAttrString(fig, "gca");
+  if (!gca) throw std::runtime_error("No gca");
+  Py_INCREF(gca);
+  PyObject *axis = PyObject_Call(
+      gca, detail::_interpreter::get().s_python_empty_tuple, gca_kwargs);
+
+  if (!axis) throw std::runtime_error("No axis");
+  Py_INCREF(axis);
+
+  Py_DECREF(gca);
+  Py_DECREF(gca_kwargs);
+
+  PyObject *plot3 = PyObject_GetAttrString(axis, "plot");
+  if (!plot3) throw std::runtime_error("No 3D line plot");
+  Py_INCREF(plot3);
+  PyObject *res = PyObject_Call(plot3, args, kwargs);
+  if (!res) throw std::runtime_error("Failed 3D line plot");
+  Py_DECREF(plot3);
+
+  Py_DECREF(axis);
+  Py_DECREF(args);
+  Py_DECREF(kwargs);
+  if (res) Py_DECREF(res);
+}
 
 template<typename Numeric>
 bool stem(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const std::map<std::string, std::string>& keywords)
@@ -1662,6 +1746,57 @@ inline void ylabel(const std::string &str, const std::map<std::string, std::stri
     Py_DECREF(res);
 }
 
+inline void set_zlabel(const std::string &str, const std::map<std::string, std::string>& keywords = {}) {
+    // Same as with plot_surface: We lazily load the modules here the first time 
+    // this function is called because I'm not sure that we can assume "matplotlib 
+    // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
+    // want to require it for people who don't need 3d plots.
+    static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
+    if (!mpl_toolkitsmod) {
+        detail::_interpreter::get();
+
+        PyObject* mpl_toolkits = PyString_FromString("mpl_toolkits");
+        PyObject* axis3d = PyString_FromString("mpl_toolkits.mplot3d");
+        if (!mpl_toolkits || !axis3d) { throw std::runtime_error("couldnt create string"); }
+
+        mpl_toolkitsmod = PyImport_Import(mpl_toolkits);
+        Py_DECREF(mpl_toolkits);
+        if (!mpl_toolkitsmod) { throw std::runtime_error("Error loading module mpl_toolkits!"); }
+
+        axis3dmod = PyImport_Import(axis3d);
+        Py_DECREF(axis3d);
+        if (!axis3dmod) { throw std::runtime_error("Error loading module mpl_toolkits.mplot3d!"); }
+    }
+
+    PyObject* pystr = PyString_FromString(str.c_str());
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, pystr);
+
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject *ax =
+    PyObject_CallObject(detail::_interpreter::get().s_python_function_gca,
+      detail::_interpreter::get().s_python_empty_tuple);
+    if (!ax) throw std::runtime_error("Call to gca() failed.");
+    Py_INCREF(ax);
+
+    PyObject *zlabel = PyObject_GetAttrString(ax, "set_zlabel");
+    if (!zlabel) throw std::runtime_error("Attribute set_zlabel not found.");
+    Py_INCREF(zlabel);
+
+    PyObject *res = PyObject_Call(zlabel, args, kwargs);
+    if (!res) throw std::runtime_error("Call to set_zlabel() failed.");
+    Py_DECREF(zlabel);
+
+    Py_DECREF(ax);
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+    if (res) Py_DECREF(res);
+}
+
 inline void grid(bool flag)
 {
     PyObject* pyflag = flag ? Py_True : Py_False;

From 41477fcdb6fc3ba2c4967dfada01609bfd620a1d Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sun, 29 Mar 2020 20:46:52 +0200
Subject: [PATCH 38/86] Add experimental documentation target

Add experimental `docs` target to create automated
API documentation.

Also moved all internal things into one unified
namespace `detail`.
---
 Makefile        |   6 +-
 matplotlibcpp.h | 142 ++++++++++++++++++++++++++----------------------
 2 files changed, 83 insertions(+), 65 deletions(-)

diff --git a/Makefile b/Makefile
index a4a8a28..8df417f 100644
--- a/Makefile
+++ b/Makefile
@@ -25,8 +25,12 @@ EXAMPLE_TARGETS := $(patsubst %,examples/build/%,$(EXAMPLES))
 
 examples: $(EXAMPLE_TARGETS)
 
+docs:
+	doxygen
+	moxygen doc/xml --noindex -o doc/api.md
+
 # Assume every *.cpp file is a separate example
-$(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp
+$(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp matplotlibcpp.h
 	mkdir -p examples/build
 	$(CXX) -o $@ $< $(EXTRA_FLAGS) $(CXXFLAGS) $(LDFLAGS)
 
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index da86704..ed4e347 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -242,7 +242,15 @@ struct _interpreter {
 
 } // end namespace detail
 
-// must be called before the first regular call to matplotlib to have any effect
+/// Select the backend
+///
+/// **NOTE:** This must be called before the first plot command to have
+/// any effect.
+///
+/// Mainly useful to select the non-interactive 'Agg' backend when running
+/// matplotlibcpp in headless mode, for example on a machine with no display.
+///
+/// See also: https://matplotlib.org/2.0.2/api/matplotlib_configuration_api.html#matplotlib.use
 inline void backend(const std::string& name)
 {
     detail::s_backend = name;
@@ -272,6 +280,8 @@ inline bool annotate(std::string annotation, double x, double y)
     return res;
 }
 
+namespace detail {
+
 #ifndef WITHOUT_NUMPY
 // Type selector for numpy array conversion
 template <typename T> struct select_npy_type { const static NPY_TYPES type = NPY_NOTYPE; }; //Default
@@ -365,14 +375,19 @@ PyObject* get_array(const std::vector<Numeric>& v)
 
 #endif // WITHOUT_NUMPY
 
+} // namespace detail
+
+/// Plot a line through the given x and y data points..
+/// 
+/// See: https://matplotlib.org/3.2.1/api/_as_gen/matplotlib.pyplot.plot.html
 template<typename Numeric>
 bool plot(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const std::map<std::string, std::string>& keywords)
 {
     assert(x.size() == y.size());
 
     // using numpy arrays
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     // construct positional args
     PyObject* args = PyTuple_New(2);
@@ -396,7 +411,7 @@ bool plot(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
 }
 
 // TODO - it should be possible to make this work by implementing
-// a non-numpy alternative for `get_2darray()`.
+// a non-numpy alternative for `detail::get_2darray()`.
 #ifndef WITHOUT_NUMPY
 template <typename Numeric>
 void plot_surface(const std::vector<::std::vector<Numeric>> &x,
@@ -430,9 +445,9 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
   assert(y.size() == z.size());
 
   // using numpy arrays
-  PyObject *xarray = get_2darray(x);
-  PyObject *yarray = get_2darray(y);
-  PyObject *zarray = get_2darray(z);
+  PyObject *xarray = detail::get_2darray(x);
+  PyObject *yarray = detail::get_2darray(y);
+  PyObject *zarray = detail::get_2darray(z);
 
   // construct positional args
   PyObject *args = PyTuple_New(3);
@@ -522,9 +537,9 @@ void plot3(const std::vector<Numeric> &x,
   assert(x.size() == y.size());
   assert(y.size() == z.size());
 
-  PyObject *xarray = get_array(x);
-  PyObject *yarray = get_array(y);
-  PyObject *zarray = get_array(z);
+  PyObject *xarray = detail::get_array(x);
+  PyObject *yarray = detail::get_array(y);
+  PyObject *zarray = detail::get_array(z);
 
   // construct positional args
   PyObject *args = PyTuple_New(3);
@@ -580,8 +595,8 @@ bool stem(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
     assert(x.size() == y.size());
 
     // using numpy arrays
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     // construct positional args
     PyObject* args = PyTuple_New(2);
@@ -613,8 +628,8 @@ bool fill(const std::vector<Numeric>& x, const std::vector<Numeric>& y, const st
     assert(x.size() == y.size());
 
     // using numpy arrays
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     // construct positional args
     PyObject* args = PyTuple_New(2);
@@ -644,9 +659,9 @@ bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1,
     assert(x.size() == y2.size());
 
     // using numpy arrays
-    PyObject* xarray = get_array(x);
-    PyObject* y1array = get_array(y1);
-    PyObject* y2array = get_array(y2);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* y1array = detail::get_array(y1);
+    PyObject* y2array = detail::get_array(y2);
 
     // construct positional args
     PyObject* args = PyTuple_New(3);
@@ -674,7 +689,7 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
           double alpha=1.0, bool cumulative=false)
 {
 
-    PyObject* yarray = get_array(y);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "bins", PyLong_FromLong(bins));
@@ -698,7 +713,7 @@ bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
 }
 
 #ifndef WITHOUT_NUMPY
-namespace internal {
+namespace detail {
 
 inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords, PyObject** out)
 {
@@ -730,16 +745,16 @@ inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int co
         Py_DECREF(res);
 }
 
-} // namespace internal
+} // namespace detail
 
 inline void imshow(const unsigned char *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
 {
-    internal::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords, out);
+    detail::imshow((void *) ptr, NPY_UINT8, rows, columns, colors, keywords, out);
 }
 
 inline void imshow(const float *ptr, const int rows, const int columns, const int colors, const std::map<std::string, std::string> &keywords = {}, PyObject** out = nullptr)
 {
-    internal::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords, out);
+    detail::imshow((void *) ptr, NPY_FLOAT, rows, columns, colors, keywords, out);
 }
 
 #ifdef WITH_OPENCV
@@ -769,7 +784,7 @@ void imshow(const cv::Mat &image, const std::map<std::string, std::string> &keyw
         cv::cvtColor(image2, image2, CV_BGRA2RGBA);
     }
 
-    internal::imshow(image2.data, npy_type, image2.rows, image2.cols, image2.channels(), keywords);
+    detail::imshow(image2.data, npy_type, image2.rows, image2.cols, image2.channels(), keywords);
 }
 #endif // WITH_OPENCV
 #endif // WITHOUT_NUMPY
@@ -782,8 +797,8 @@ bool scatter(const std::vector<NumericX>& x,
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "s", PyLong_FromLong(s));
@@ -810,7 +825,7 @@ bool boxplot(const std::vector<std::vector<Numeric>>& data,
              const std::vector<std::string>& labels = {},
              const std::unordered_map<std::string, std::string> & keywords = {})
 {
-    PyObject* listlist = get_listlist(data);
+    PyObject* listlist = detail::get_listlist(data);
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, listlist);
 
@@ -818,7 +833,7 @@ bool boxplot(const std::vector<std::vector<Numeric>>& data,
 
     // kwargs needs the labels, if there are (the correct number of) labels
     if (!labels.empty() && labels.size() == data.size()) {
-        PyDict_SetItemString(kwargs, "labels", get_array(labels));
+        PyDict_SetItemString(kwargs, "labels", detail::get_array(labels));
     }
 
     // take care of the remaining keywords
@@ -841,7 +856,7 @@ template<typename Numeric>
 bool boxplot(const std::vector<Numeric>& data,
              const std::unordered_map<std::string, std::string> & keywords = {})
 {
-    PyObject* vector = get_array(data);
+    PyObject* vector = detail::get_array(data);
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, vector);
 
@@ -868,8 +883,8 @@ bool bar(const std::vector<Numeric> &               x,
          std::string                                ls       = "-",
          double                                     lw       = 1.0,
          const std::map<std::string, std::string> & keywords = {}) {
-  PyObject * xarray = get_array(x);
-  PyObject * yarray = get_array(y);
+  PyObject * xarray = detail::get_array(x);
+  PyObject * yarray = detail::get_array(y);
 
   PyObject * kwargs = PyDict_New();
 
@@ -938,7 +953,7 @@ inline bool subplots_adjust(const std::map<std::string, double>& keywords = {})
 template< typename Numeric>
 bool named_hist(std::string label,const std::vector<Numeric>& y, long bins=10, std::string color="b", double alpha=1.0)
 {
-    PyObject* yarray = get_array(y);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(label.c_str()));
@@ -964,8 +979,8 @@ bool plot(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(s.c_str());
 
@@ -987,10 +1002,10 @@ bool quiver(const std::vector<NumericX>& x, const std::vector<NumericY>& y, cons
 {
     assert(x.size() == y.size() && x.size() == u.size() && u.size() == w.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
-    PyObject* uarray = get_array(u);
-    PyObject* warray = get_array(w);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
+    PyObject* uarray = detail::get_array(u);
+    PyObject* warray = detail::get_array(w);
 
     PyObject* plot_args = PyTuple_New(4);
     PyTuple_SetItem(plot_args, 0, xarray);
@@ -1021,8 +1036,8 @@ bool stem(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(s.c_str());
 
@@ -1046,8 +1061,8 @@ bool semilogx(const std::vector<NumericX>& x, const std::vector<NumericY>& y, co
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(s.c_str());
 
@@ -1069,8 +1084,8 @@ bool semilogy(const std::vector<NumericX>& x, const std::vector<NumericY>& y, co
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(s.c_str());
 
@@ -1092,8 +1107,8 @@ bool loglog(const std::vector<NumericX>& x, const std::vector<NumericY>& y, cons
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(s.c_str());
 
@@ -1115,9 +1130,9 @@ bool errorbar(const std::vector<NumericX> &x, const std::vector<NumericY> &y, co
 {
     assert(x.size() == y.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
-    PyObject* yerrarray = get_array(yerr);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
+    PyObject* yerrarray = detail::get_array(yerr);
 
     // construct keyword args
     PyObject* kwargs = PyDict_New();
@@ -1151,7 +1166,7 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& y, const st
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-    PyObject* yarray = get_array(y);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -1175,8 +1190,8 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& x, const st
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -1200,8 +1215,8 @@ bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, cons
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -1225,8 +1240,8 @@ bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, cons
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -1250,8 +1265,8 @@ bool named_loglog(const std::string& name, const std::vector<Numeric>& x, const
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
 
     PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -1482,7 +1497,7 @@ inline void xticks(const std::vector<Numeric> &ticks, const std::vector<std::str
     assert(labels.size() == 0 || ticks.size() == labels.size());
 
     // using numpy array
-    PyObject* ticksarray = get_array(ticks);
+    PyObject* ticksarray = detail::get_array(ticks);
 
     PyObject* args;
     if(labels.size() == 0) {
@@ -1529,7 +1544,7 @@ inline void yticks(const std::vector<Numeric> &ticks, const std::vector<std::str
     assert(labels.size() == 0 || ticks.size() == labels.size());
 
     // using numpy array
-    PyObject* ticksarray = get_array(ticks);
+    PyObject* ticksarray = detail::get_array(ticks);
 
     PyObject* args;
     if(labels.size() == 0) {
@@ -2096,7 +2111,6 @@ inline bool plot(const std::vector<double>& x, const std::vector<double>& y, con
 /*
  * This class allows dynamic plots, ie changing the plotted data without clearing and re-plotting
  */
-
 class Plot
 {
 public:
@@ -2110,8 +2124,8 @@ class Plot
         if(name != "")
             PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
-        PyObject* xarray = get_array(x);
-        PyObject* yarray = get_array(y);
+        PyObject* xarray = detail::get_array(x);
+        PyObject* yarray = detail::get_array(y);
 
         PyObject* pystring = PyString_FromString(format.c_str());
 
@@ -2147,8 +2161,8 @@ class Plot
         assert(x.size() == y.size());
         if(set_data_fct)
         {
-            PyObject* xarray = get_array(x);
-            PyObject* yarray = get_array(y);
+            PyObject* xarray = detail::get_array(x);
+            PyObject* yarray = detail::get_array(y);
 
             PyObject* plot_args = PyTuple_New(2);
             PyTuple_SetItem(plot_args, 0, xarray);

From 7f7b8528b4f0d4d6cbebc00cf7b39001cbb1a801 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Tue, 31 Mar 2020 14:56:15 +0200
Subject: [PATCH 39/86] Fix numpy detection and provide some functions even
 when numpy is not available

---
 Makefile        |  8 ++++----
 matplotlibcpp.h | 28 ++++++++++++++--------------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/Makefile b/Makefile
index 8df417f..60e5f65 100644
--- a/Makefile
+++ b/Makefile
@@ -10,13 +10,13 @@ LDFLAGS        += $(shell $(PYTHON_CONFIG) --libs)
 
 # Either finds numpy or set -DWITHOUT_NUMPY
 EXTRA_FLAGS     += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)
-WITHOUT_NUMPY   := $(findstring $(CXXFLAGS), WITHOUT_NUMPY)
+WITHOUT_NUMPY   := $(findstring $(EXTRA_FLAGS), WITHOUT_NUMPY)
 
 # Examples requiring numpy support to compile
-EXAMPLES_NUMPY  := surface
+EXAMPLES_NUMPY  := surface colorbar
 EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar \
-	           fill_inbetween fill update subplot2grid colorbar lines3d \
-                   $(if WITHOUT_NUMPY,,$(EXAMPLES_NUMPY))
+	           fill_inbetween fill update subplot2grid lines3d \
+                   $(if $(WITHOUT_NUMPY),,$(EXAMPLES_NUMPY))
 
 # Prefix every example with 'examples/build/'
 EXAMPLE_TARGETS := $(patsubst %,examples/build/%,$(EXAMPLES))
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index ed4e347..55597a7 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -340,6 +340,20 @@ PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
     return reinterpret_cast<PyObject *>(varray);
 }
 
+#else // fallback if we don't have numpy: copy every element of the given vector
+
+template<typename Numeric>
+PyObject* get_array(const std::vector<Numeric>& v)
+{
+    PyObject* list = PyList_New(v.size());
+    for(size_t i = 0; i < v.size(); ++i) {
+        PyList_SetItem(list, i, PyFloat_FromDouble(v.at(i)));
+    }
+    return list;
+}
+
+#endif // WITHOUT_NUMPY
+
 // sometimes, for labels and such, we need string arrays
 PyObject * get_array(const std::vector<std::string>& strings)
 {
@@ -361,20 +375,6 @@ PyObject* get_listlist(const std::vector<std::vector<Numeric>>& ll)
   return listlist;
 }
 
-#else // fallback if we don't have numpy: copy every element of the given vector
-
-template<typename Numeric>
-PyObject* get_array(const std::vector<Numeric>& v)
-{
-    PyObject* list = PyList_New(v.size());
-    for(size_t i = 0; i < v.size(); ++i) {
-        PyList_SetItem(list, i, PyFloat_FromDouble(v.at(i)));
-    }
-    return list;
-}
-
-#endif // WITHOUT_NUMPY
-
 } // namespace detail
 
 /// Plot a line through the given x and y data points..

From ea527fdcefbc8137921ba1aaacf2ee7fbe5da109 Mon Sep 17 00:00:00 2001
From: tomotakaeru <38675462+tomotakaeru@users.noreply.github.com>
Date: Sun, 5 Apr 2020 22:51:41 +0900
Subject: [PATCH 40/86] add "inline" to get_array, color_bar, axvline

---
 matplotlibcpp.h | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 55597a7..31838a5 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -298,7 +298,7 @@ template <> struct select_npy_type<uint32_t> { const static NPY_TYPES type = NPY
 template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY_UINT64; };
 
 template<typename Numeric>
-PyObject* get_array(const std::vector<Numeric>& v)
+inline PyObject* get_array(const std::vector<Numeric>& v)
 {
     detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
     NPY_TYPES type = select_npy_type<Numeric>::type;
@@ -343,7 +343,7 @@ PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
 #else // fallback if we don't have numpy: copy every element of the given vector
 
 template<typename Numeric>
-PyObject* get_array(const std::vector<Numeric>& v)
+inline PyObject* get_array(const std::vector<Numeric>& v)
 {
     PyObject* list = PyList_New(v.size());
     for(size_t i = 0; i < v.size(); ++i) {
@@ -355,7 +355,7 @@ PyObject* get_array(const std::vector<Numeric>& v)
 #endif // WITHOUT_NUMPY
 
 // sometimes, for labels and such, we need string arrays
-PyObject * get_array(const std::vector<std::string>& strings)
+inline PyObject * get_array(const std::vector<std::string>& strings)
 {
   PyObject* list = PyList_New(strings.size());
   for (std::size_t i = 0; i < strings.size(); ++i) {
@@ -1322,7 +1322,7 @@ void text(Numeric x, Numeric y, const std::string& s = "")
     Py_DECREF(res);
 }
 
-void colorbar(PyObject* mappable = NULL, const std::map<std::string, float>& keywords = {})
+inline void colorbar(PyObject* mappable = NULL, const std::map<std::string, float>& keywords = {})
 {
     if (mappable == NULL)
         throw std::runtime_error("Must call colorbar with PyObject* returned from an image, contour, surface, etc.");
@@ -1700,7 +1700,7 @@ inline void axis(const std::string &axisstr)
     Py_DECREF(res);
 }
 
-void axvline(double x, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
+inline void axvline(double x, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
 {
     // construct positional args
     PyObject* args = PyTuple_New(3);

From 2843ebbe68f7f1d9718bc6a48bb2f6e16af95349 Mon Sep 17 00:00:00 2001
From: tomotakaeru <38675462+tomotakaeru@users.noreply.github.com>
Date: Mon, 6 Apr 2020 09:26:36 +0900
Subject: [PATCH 41/86] delete unnecessary "inline" on
 get_array(vector<string>)

---
 matplotlibcpp.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 31838a5..0112344 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -298,7 +298,7 @@ template <> struct select_npy_type<uint32_t> { const static NPY_TYPES type = NPY
 template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY_UINT64; };
 
 template<typename Numeric>
-inline PyObject* get_array(const std::vector<Numeric>& v)
+PyObject* get_array(const std::vector<Numeric>& v)
 {
     detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
     NPY_TYPES type = select_npy_type<Numeric>::type;
@@ -343,7 +343,7 @@ PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
 #else // fallback if we don't have numpy: copy every element of the given vector
 
 template<typename Numeric>
-inline PyObject* get_array(const std::vector<Numeric>& v)
+PyObject* get_array(const std::vector<Numeric>& v)
 {
     PyObject* list = PyList_New(v.size());
     for(size_t i = 0; i < v.size(); ++i) {

From e5ffc6ce8309dca4e15f14698a1bdb8a25836241 Mon Sep 17 00:00:00 2001
From: acxz <17132214+acxz@users.noreply.github.com>
Date: Sat, 11 Apr 2020 20:10:29 -0400
Subject: [PATCH 42/86] ensure interpreter is initialized for suptitle &
 subplot

---
 matplotlibcpp.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 0112344..9649010 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1611,6 +1611,9 @@ inline void tick_params(const std::map<std::string, std::string>& keywords, cons
 
 inline void subplot(long nrows, long ncols, long plot_number)
 {
+    // Make sure interpreter is initialized
+    detail::_interpreter::get();
+    
     // construct positional args
     PyObject* args = PyTuple_New(3);
     PyTuple_SetItem(args, 0, PyFloat_FromDouble(nrows));
@@ -1670,6 +1673,9 @@ inline void title(const std::string &titlestr, const std::map<std::string, std::
 
 inline void suptitle(const std::string &suptitlestr, const std::map<std::string, std::string> &keywords = {})
 {
+    // Make sure interpreter is initialized
+    detail::_interpreter::get();
+    
     PyObject* pysuptitlestr = PyString_FromString(suptitlestr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pysuptitlestr);

From d7839cc47547f70dba104848e3318aa64025f837 Mon Sep 17 00:00:00 2001
From: Guillaume Jacquenot <guillaume.jacquenot@gmail.com>
Date: Sun, 8 Mar 2020 22:34:46 +0100
Subject: [PATCH 43/86] :sparkle: Added a first version of Dockerfile

---
 Dockerfile | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 Dockerfile

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..850466f
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,27 @@
+FROM debian:10 AS builder
+RUN apt-get update \
+ && apt-get install --yes --no-install-recommends \
+    g++ \
+    libpython3-dev \
+    make \
+    python3 \
+    python3-dev \
+    python3-numpy
+
+ADD Makefile matplotlibcpp.h numpy_flags.py /opt/
+ADD examples/*.cpp /opt/examples/
+RUN cd /opt \
+ && make PYTHON_BIN=python3 \
+ && ls examples/build
+
+FROM debian:10
+RUN apt-get update \
+ && apt-get install --yes --no-install-recommends \
+    libpython3-dev \
+    python3-matplotlib \
+    python3-numpy
+
+COPY --from=builder /opt/examples/build /opt/
+RUN cd /opt \
+ && ls \
+ && ./basic

From 7ef2559239fbc1dc47f9092d650616979a85484e Mon Sep 17 00:00:00 2001
From: Guillaume Jacquenot <guillaume.jacquenot@gmail.com>
Date: Sun, 8 Mar 2020 22:35:12 +0100
Subject: [PATCH 44/86] :sparkle: Added a target to build docker image

---
 Makefile | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Makefile b/Makefile
index 60e5f65..a1e63bf 100644
--- a/Makefile
+++ b/Makefile
@@ -36,3 +36,6 @@ $(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp matplotlibcpp.h
 
 clean:
 	rm -f ${EXAMPLE_TARGETS}
+
+docker_build:
+	docker build . -t matplotlibcpp

From fa673c670602e3f6ccb34d9bc3f5b10897cef8f8 Mon Sep 17 00:00:00 2001
From: Guillaume Jacquenot <guillaume.jacquenot@gmail.com>
Date: Sun, 8 Mar 2020 22:36:08 +0100
Subject: [PATCH 45/86] :sparkle: Added a first CI file

---
 .travis.yml | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .travis.yml

diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..bacca68
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,6 @@
+language: minimal
+dist: trusty
+services:
+  - docker
+script:
+  - make docker_build

From a7c38ad725c745fd8089fd96c2d17f5410ff74ed Mon Sep 17 00:00:00 2001
From: Guillaume Jacquenot <guillaume.jacquenot@gmail.com>
Date: Sun, 8 Mar 2020 23:15:27 +0100
Subject: [PATCH 46/86] :pencil: Typo update in Readme.md

---
 README.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 72bab39..a1ad7bd 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ A more comprehensive example:
 
 namespace plt = matplotlibcpp;
 
-int main() 
+int main()
 {
     // Prepare data.
     int n = 5000;
@@ -73,26 +73,26 @@ Alternatively, matplotlib-cpp also supports some C++11-powered syntactic sugar:
 using namespace std;
 namespace plt = matplotlibcpp;
 
-int main() 
-{    
+int main()
+{
     // Prepare data.
     int n = 5000; // number of data points
-    vector<double> x(n),y(n); 
+    vector<double> x(n),y(n);
     for(int i=0; i<n; ++i) {
         double t = 2*M_PI*i/n;
         x.at(i) = 16*sin(t)*sin(t)*sin(t);
         y.at(i) = 13*cos(t) - 5*cos(2*t) - 2*cos(3*t) - cos(4*t);
     }
 
-    // plot() takes an arbitrary number of (x,y,format)-triples. 
+    // plot() takes an arbitrary number of (x,y,format)-triples.
     // x must be iterable (that is, anything providing begin(x) and end(x)),
-    // y must either be callable (providing operator() const) or iterable. 
+    // y must either be callable (providing operator() const) or iterable.
     plt::plot(x, y, "r-", x, [](double d) { return 12.5+abs(sin(d)); }, "k-");
 
 
     // show plots
     plt::show();
-} 
+}
 ```
     g++ modern.cpp -std=c++11 -I/usr/include/python2.7 -lpython
 
@@ -256,10 +256,10 @@ The same technique can be used for linking against a custom build of python
 
 Why?
 ----
-I initially started this library during my diploma thesis. The usual approach of 
+I initially started this library during my diploma thesis. The usual approach of
 writing data from the c++ algorithm to a file and afterwards parsing and plotting
 it in python using matplotlib proved insufficient: Keeping the algorithm
-and plotting code in sync requires a lot of effort when the C++ code frequently and substantially 
+and plotting code in sync requires a lot of effort when the C++ code frequently and substantially
 changes. Additionally, the python yaml parser was not able to cope with files that
 exceed a few hundred megabytes in size.
 
@@ -290,4 +290,4 @@ Todo/Issues/Wishlist
 in "".'
 
 * MacOS: `Unable to import matplotlib.pyplot`. Cause: In mac os image rendering back end of matplotlib (what-is-a-backend to render using the API of Cocoa by default). There is Qt4Agg and GTKAgg and as a back-end is not the default. Set the back end of macosx that is differ compare with other windows or linux os.
-Solution is discribed [here](https://stackoverflow.com/questions/21784641/installation-issue-with-matplotlib-python?noredirect=1&lq=1), additional information can be found there too(see links in answers).
+Solution is described [here](https://stackoverflow.com/questions/21784641/installation-issue-with-matplotlib-python?noredirect=1&lq=1), additional information can be found there too(see links in answers).

From 823de00fbae746c09c11efea59a2738da44518b8 Mon Sep 17 00:00:00 2001
From: Guillaume Jacquenot <guillaume.jacquenot@gmail.com>
Date: Sat, 28 Mar 2020 09:15:28 +0100
Subject: [PATCH 47/86] :wrench: Moved all elements related to docker build in
 contrib

As requested by maintainer
---
 .travis.yml                      | 2 +-
 Makefile                         | 3 ---
 Dockerfile => contrib/Dockerfile | 0
 contrib/Makefile                 | 6 ++++++
 4 files changed, 7 insertions(+), 4 deletions(-)
 rename Dockerfile => contrib/Dockerfile (100%)
 create mode 100644 contrib/Makefile

diff --git a/.travis.yml b/.travis.yml
index bacca68..d6175a2 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -3,4 +3,4 @@ dist: trusty
 services:
   - docker
 script:
-  - make docker_build
+  - make -C contrib docker_build
diff --git a/Makefile b/Makefile
index a1e63bf..60e5f65 100644
--- a/Makefile
+++ b/Makefile
@@ -36,6 +36,3 @@ $(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp matplotlibcpp.h
 
 clean:
 	rm -f ${EXAMPLE_TARGETS}
-
-docker_build:
-	docker build . -t matplotlibcpp
diff --git a/Dockerfile b/contrib/Dockerfile
similarity index 100%
rename from Dockerfile
rename to contrib/Dockerfile
diff --git a/contrib/Makefile b/contrib/Makefile
new file mode 100644
index 0000000..f659cd9
--- /dev/null
+++ b/contrib/Makefile
@@ -0,0 +1,6 @@
+all: docker_build
+
+docker_build:
+	cd .. && \
+	docker build . -f contrib/Dockerfile -t matplotlibcpp && \
+	cd contrib

From 9595628a80f972c7f3ee5166fe8d91ad50e667b0 Mon Sep 17 00:00:00 2001
From: Mateo Gianolio <gianoliomateo@gmail.com>
Date: Fri, 3 Apr 2020 10:33:24 +0200
Subject: [PATCH 48/86] Replace occurrences of std::unordered_map<> with
 std::map<>

---
 matplotlibcpp.h | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 9649010..55a04b1 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -9,7 +9,6 @@
 #include <iostream>
 #include <cstdint> // <cstdint> requires c++11 support
 #include <functional>
-#include <unordered_map>
 
 #include <Python.h>
 
@@ -793,7 +792,7 @@ template<typename NumericX, typename NumericY>
 bool scatter(const std::vector<NumericX>& x,
              const std::vector<NumericY>& y,
              const double s=1.0, // The marker size in points**2
-             const std::unordered_map<std::string, std::string> & keywords = {})
+             const std::map<std::string, std::string> & keywords = {})
 {
     assert(x.size() == y.size());
 
@@ -823,7 +822,7 @@ bool scatter(const std::vector<NumericX>& x,
 template<typename Numeric>
 bool boxplot(const std::vector<std::vector<Numeric>>& data,
              const std::vector<std::string>& labels = {},
-             const std::unordered_map<std::string, std::string> & keywords = {})
+             const std::map<std::string, std::string> & keywords = {})
 {
     PyObject* listlist = detail::get_listlist(data);
     PyObject* args = PyTuple_New(1);
@@ -854,7 +853,7 @@ bool boxplot(const std::vector<std::vector<Numeric>>& data,
 
 template<typename Numeric>
 bool boxplot(const std::vector<Numeric>& data,
-             const std::unordered_map<std::string, std::string> & keywords = {})
+             const std::map<std::string, std::string> & keywords = {})
 {
     PyObject* vector = detail::get_array(data);
     PyObject* args = PyTuple_New(1);

From 1243814dabc8a34fa0b6b9ffc86af5b42e85feed Mon Sep 17 00:00:00 2001
From: NancyLi1013 <lirui09@beyondsoft.com>
Date: Wed, 26 Feb 2020 05:29:35 -0800
Subject: [PATCH 49/86] Add vcpkg installation instructions

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index a1ad7bd..ce6480b 100644
--- a/README.md
+++ b/README.md
@@ -207,6 +207,17 @@ anywhere.
 Since a python interpreter is opened internally, it is necessary to link against `libpython2.7` in order to use
 matplotlib-cpp.
 
+You can download and install matplotlib-cpp using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
+
+    git clone https://github.com/Microsoft/vcpkg.git
+    cd vcpkg
+    ./bootstrap-vcpkg.sh
+    ./vcpkg integrate install
+    vcpkg install matplotlib-cpp
+  
+The matplotlib-cpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+
+
 # CMake
 
 If you prefer to use CMake as build system, you will want to add something like this to your

From edb40746123e2fdd194083f4e4a75cd985e5c593 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 18 Apr 2020 12:19:26 +0200
Subject: [PATCH 50/86] Reword libpython dependency; move vcpkg section

---
 README.md | 32 +++++++++++++++++++-------------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index ce6480b..61ffef4 100644
--- a/README.md
+++ b/README.md
@@ -199,23 +199,15 @@ On Ubuntu:
     sudo apt-get install python-matplotlib python-numpy python2.7-dev
 
 If, for some reason, you're unable to get a working installation of numpy on your system,
-you can add the define `WITHOUT_NUMPY` to erase this dependency.
+you can define the macro `WITHOUT_NUMPY` before including the header file to erase this
+dependency.
 
 The C++-part of the library consists of the single header file `matplotlibcpp.h` which can be placed
 anywhere.
 
-Since a python interpreter is opened internally, it is necessary to link against `libpython2.7` in order to use
-matplotlib-cpp.
-
-You can download and install matplotlib-cpp using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
-
-    git clone https://github.com/Microsoft/vcpkg.git
-    cd vcpkg
-    ./bootstrap-vcpkg.sh
-    ./vcpkg integrate install
-    vcpkg install matplotlib-cpp
-  
-The matplotlib-cpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+Since a python interpreter is opened internally, it is necessary to link against `libpython` in order
+to user matplotlib-cpp. Most versions should work, although `libpython2.7` and `libpython3.6` are
+probably the most regularly testedr.
 
 
 # CMake
@@ -243,6 +235,20 @@ target_include_directories(myproject PRIVATE ${PYTHON_INCLUDE_DIRS})
 target_link_libraries(myproject ${PYTHON_LIBRARIES})
 ```
 
+
+# Vcpkg
+
+You can download and install matplotlib-cpp using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
+
+    git clone https://github.com/Microsoft/vcpkg.git
+    cd vcpkg
+    ./bootstrap-vcpkg.sh
+    ./vcpkg integrate install
+    vcpkg install matplotlib-cpp
+  
+The matplotlib-cpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+
+
 # C++11
 
 Currently, c++11 is required to build matplotlib-cpp. The last working commit that did

From d74105036a82e6ccede3fa1a7d872ac1677b00ab Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Wed, 22 Apr 2020 00:28:08 +0200
Subject: [PATCH 51/86] Fix use-after-free bug when plotting unknown numeric
 types

---
 matplotlibcpp.h | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 55a04b1..c89a743 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -299,22 +299,24 @@ template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY
 template<typename Numeric>
 PyObject* get_array(const std::vector<Numeric>& v)
 {
-    detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
+    detail::_interpreter::get(); //interpreter needs to be initialized for the numpy commands to work
+    npy_intp vsize = v.size();
     NPY_TYPES type = select_npy_type<Numeric>::type;
-    if (type == NPY_NOTYPE)
-    {
-        std::vector<double> vd(v.size());
-        npy_intp vsize = v.size();
-        std::copy(v.begin(),v.end(),vd.begin());
-        PyObject* varray = PyArray_SimpleNewFromData(1, &vsize, NPY_DOUBLE, (void*)(vd.data()));
+    if (type == NPY_NOTYPE) {
+        size_t memsize = v.size()*sizeof(double);
+        double* dp = static_cast<double*>(::malloc(memsize));
+        for (size_t i=0; i<v.size(); ++i)
+            dp[i] = v[i];
+        PyObject* varray = PyArray_SimpleNewFromData(1, &vsize, NPY_DOUBLE, dp);
+        PyArray_UpdateFlags(reinterpret_cast<PyArrayObject*>(varray), NPY_ARRAY_OWNDATA);
         return varray;
     }
-
-    npy_intp vsize = v.size();
+    
     PyObject* varray = PyArray_SimpleNewFromData(1, &vsize, type, (void*)(v.data()));
     return varray;
 }
 
+
 template<typename Numeric>
 PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
 {

From ecf3a8dd0bf2766c7988de8c6fbbb0098564f44d Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Wed, 22 Apr 2020 00:31:41 +0200
Subject: [PATCH 52/86] Add native numpy handling when plotting vectors of
 (unsigned) long long

---
 matplotlibcpp.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index c89a743..b83d8f0 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -296,6 +296,14 @@ template <> struct select_npy_type<uint16_t> { const static NPY_TYPES type = NPY
 template <> struct select_npy_type<uint32_t> { const static NPY_TYPES type = NPY_ULONG; };
 template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY_UINT64; };
 
+// Sanity checks; comment them out or change the numpy type below if you're compiling on
+// a platform where they don't apply
+static_assert(sizeof(long long) == 8);
+template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
+static_assert(sizeof(unsigned long long) == 8);
+template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
+// TODO: add int, long, etc.
+
 template<typename Numeric>
 PyObject* get_array(const std::vector<Numeric>& v)
 {

From bf2be71082081ff3db96ab3ff1a00df7f99da92e Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 2 May 2020 16:55:08 +0200
Subject: [PATCH 53/86] Update python-config invocation in Makefile

Since the new Ubuntu 20.04  LTS version is shipping
python3.8 as the default python, update the Makefile
to use that as default and more importantly fix the
python-config invocation to work with all python
versions.
---
 Makefile | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index 60e5f65..1a5a339 100644
--- a/Makefile
+++ b/Makefile
@@ -2,11 +2,14 @@
 CXXFLAGS += -std=c++11 -Wno-conversion
 
 # Default to using system's default version of python
-PYTHON_BIN     ?= python
+PYTHON_BIN     ?= python3
 PYTHON_CONFIG  := $(PYTHON_BIN)-config
 PYTHON_INCLUDE ?= $(shell $(PYTHON_CONFIG) --includes)
 EXTRA_FLAGS    := $(PYTHON_INCLUDE)
-LDFLAGS        += $(shell $(PYTHON_CONFIG) --libs)
+# NOTE: Since python3.8, the correct invocation is `python3-config --libs --embed`. 
+# So of course the proper way to get python libs for embedding now is to
+# invoke that, check if it crashes, and fall back to just `--libs` if it does.
+LDFLAGS        += $(shell if $(PYTHON_CONFIG) --libs --embed >/dev/null; then $(PYTHON_CONFIG) --libs --embed; else $(PYTHON_CONFIG) --libs; fi)
 
 # Either finds numpy or set -DWITHOUT_NUMPY
 EXTRA_FLAGS     += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)

From f5f8ce3d6aa0c588e7f45346a0f89ad4f80991cf Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 2 May 2020 16:56:53 +0200
Subject: [PATCH 54/86] Move Python.h include into first position

---
 matplotlibcpp.h | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index b83d8f0..0b7484b 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1,5 +1,9 @@
 #pragma once
 
+// Python headers must be included before any system headers, since
+// they define _POSIX_C_SOURCE
+#include <Python.h>
+
 #include <vector>
 #include <map>
 #include <array>
@@ -10,8 +14,6 @@
 #include <cstdint> // <cstdint> requires c++11 support
 #include <functional>
 
-#include <Python.h>
-
 #ifndef WITHOUT_NUMPY
 #  define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
 #  include <numpy/arrayobject.h>

From d612b524e10ebdd43d3a8889a95e84c017ad65af Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Sat, 2 May 2020 16:57:26 +0200
Subject: [PATCH 55/86] Fix python3.8 segfault for the named_* family of
 functions

The fix might be more widely required, but in particular
python3.8 would segfault when PyUnicode_FromString() was
called before the interpreter was initialized.

Which is expected tbh, but a change in behaviour from
earlier versions.
---
 matplotlibcpp.h | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 0b7484b..a03f4b9 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1174,6 +1174,9 @@ bool errorbar(const std::vector<NumericX> &x, const std::vector<NumericY> &y, co
 template<typename Numeric>
 bool named_plot(const std::string& name, const std::vector<Numeric>& y, const std::string& format = "")
 {
+    // Make sure python is initialized.
+    detail::_interpreter::get();
+
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
@@ -1198,6 +1201,9 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& y, const st
 template<typename Numeric>
 bool named_plot(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
+    // Make sure python is initialized.
+    detail::_interpreter::get();
+
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
@@ -1223,6 +1229,9 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& x, const st
 template<typename Numeric>
 bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
+    // Make sure python is initialized.
+    detail::_interpreter::get();
+
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
@@ -1248,6 +1257,9 @@ bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, cons
 template<typename Numeric>
 bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
+    // Make sure python is initialized.
+    detail::_interpreter::get();
+
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 
@@ -1273,6 +1285,9 @@ bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, cons
 template<typename Numeric>
 bool named_loglog(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
+    // Make sure python is initialized.
+    detail::_interpreter::get();
+
     PyObject* kwargs = PyDict_New();
     PyDict_SetItemString(kwargs, "label", PyString_FromString(name.c_str()));
 

From 60dcd64c8fd4766e5426f57decfb765422a1d3fe Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Tue, 12 May 2020 01:20:35 +0200
Subject: [PATCH 56/86] Sprinkle calls to interpreter::get() all over the
 codebase

---
 matplotlibcpp.h | 128 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 110 insertions(+), 18 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index a03f4b9..ea2e4fb 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -259,6 +259,8 @@ inline void backend(const std::string& name)
 
 inline bool annotate(std::string annotation, double x, double y)
 {
+    detail::_interpreter::get();
+
     PyObject * xy = PyTuple_New(2);
     PyObject * str = PyString_FromString(annotation.c_str());
 
@@ -309,7 +311,6 @@ template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES
 template<typename Numeric>
 PyObject* get_array(const std::vector<Numeric>& v)
 {
-    detail::_interpreter::get(); //interpreter needs to be initialized for the numpy commands to work
     npy_intp vsize = v.size();
     NPY_TYPES type = select_npy_type<Numeric>::type;
     if (type == NPY_NOTYPE) {
@@ -330,7 +331,6 @@ PyObject* get_array(const std::vector<Numeric>& v)
 template<typename Numeric>
 PyObject* get_2darray(const std::vector<::std::vector<Numeric>>& v)
 {
-    detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
     if (v.size() < 1) throw std::runtime_error("get_2d_array v too small");
 
     npy_intp vsize[2] = {static_cast<npy_intp>(v.size()),
@@ -396,6 +396,8 @@ bool plot(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     // using numpy arrays
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
@@ -431,6 +433,8 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
                   const std::map<std::string, std::string> &keywords =
                       std::map<std::string, std::string>())
 {
+  detail::_interpreter::get();
+
   // We lazily load the modules here the first time this function is called
   // because I'm not sure that we can assume "matplotlib installed" implies
   // "mpl_toolkits installed" on all platforms, and we don't want to require
@@ -524,6 +528,8 @@ void plot3(const std::vector<Numeric> &x,
                   const std::map<std::string, std::string> &keywords =
                       std::map<std::string, std::string>())
 {
+  detail::_interpreter::get();
+
   // Same as with plot_surface: We lazily load the modules here the first time 
   // this function is called because I'm not sure that we can assume "matplotlib 
   // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
@@ -605,6 +611,8 @@ bool stem(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const st
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     // using numpy arrays
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
@@ -638,6 +646,8 @@ bool fill(const std::vector<Numeric>& x, const std::vector<Numeric>& y, const st
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     // using numpy arrays
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
@@ -669,6 +679,8 @@ bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1,
     assert(x.size() == y1.size());
     assert(x.size() == y2.size());
 
+    detail::_interpreter::get();
+
     // using numpy arrays
     PyObject* xarray = detail::get_array(x);
     PyObject* y1array = detail::get_array(y1);
@@ -699,6 +711,7 @@ template< typename Numeric>
 bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
           double alpha=1.0, bool cumulative=false)
 {
+    detail::_interpreter::get();
 
     PyObject* yarray = detail::get_array(y);
 
@@ -731,7 +744,7 @@ inline void imshow(void *ptr, const NPY_TYPES type, const int rows, const int co
     assert(type == NPY_UINT8 || type == NPY_FLOAT);
     assert(colors == 1 || colors == 3 || colors == 4);
 
-    detail::_interpreter::get();    //interpreter needs to be initialized for the numpy commands to work
+    detail::_interpreter::get();
 
     // construct args
     npy_intp dims[3] = { rows, columns, colors };
@@ -806,6 +819,8 @@ bool scatter(const std::vector<NumericX>& x,
              const double s=1.0, // The marker size in points**2
              const std::map<std::string, std::string> & keywords = {})
 {
+    detail::_interpreter::get();
+
     assert(x.size() == y.size());
 
     PyObject* xarray = detail::get_array(x);
@@ -836,6 +851,8 @@ bool boxplot(const std::vector<std::vector<Numeric>>& data,
              const std::vector<std::string>& labels = {},
              const std::map<std::string, std::string> & keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject* listlist = detail::get_listlist(data);
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, listlist);
@@ -867,6 +884,8 @@ template<typename Numeric>
 bool boxplot(const std::vector<Numeric>& data,
              const std::map<std::string, std::string> & keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject* vector = detail::get_array(data);
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, vector);
@@ -893,7 +912,10 @@ bool bar(const std::vector<Numeric> &               x,
          std::string                                ec       = "black",
          std::string                                ls       = "-",
          double                                     lw       = 1.0,
-         const std::map<std::string, std::string> & keywords = {}) {
+         const std::map<std::string, std::string> & keywords = {})
+{
+  detail::_interpreter::get();
+
   PyObject * xarray = detail::get_array(x);
   PyObject * yarray = detail::get_array(y);
 
@@ -930,9 +952,12 @@ bool bar(const std::vector<Numeric> &               y,
          std::string                                ec       = "black",
          std::string                                ls       = "-",
          double                                     lw       = 1.0,
-         const std::map<std::string, std::string> & keywords = {}) {
+         const std::map<std::string, std::string> & keywords = {})
+{
   using T = typename std::remove_reference<decltype(y)>::type::value_type;
 
+  detail::_interpreter::get();
+
   std::vector<T> x;
   for (std::size_t i = 0; i < y.size(); i++) { x.push_back(i); }
 
@@ -941,6 +966,7 @@ bool bar(const std::vector<Numeric> &               y,
 
 inline bool subplots_adjust(const std::map<std::string, double>& keywords = {})
 {
+    detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
     for (std::map<std::string, double>::const_iterator it =
@@ -964,6 +990,8 @@ inline bool subplots_adjust(const std::map<std::string, double>& keywords = {})
 template< typename Numeric>
 bool named_hist(std::string label,const std::vector<Numeric>& y, long bins=10, std::string color="b", double alpha=1.0)
 {
+    detail::_interpreter::get();
+
     PyObject* yarray = detail::get_array(y);
 
     PyObject* kwargs = PyDict_New();
@@ -990,6 +1018,8 @@ bool plot(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
 
@@ -1013,6 +1043,8 @@ bool quiver(const std::vector<NumericX>& x, const std::vector<NumericY>& y, cons
 {
     assert(x.size() == y.size() && x.size() == u.size() && u.size() == w.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
     PyObject* uarray = detail::get_array(u);
@@ -1047,6 +1079,8 @@ bool stem(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
 
@@ -1072,6 +1106,8 @@ bool semilogx(const std::vector<NumericX>& x, const std::vector<NumericY>& y, co
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
 
@@ -1095,6 +1131,8 @@ bool semilogy(const std::vector<NumericX>& x, const std::vector<NumericY>& y, co
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
 
@@ -1118,6 +1156,8 @@ bool loglog(const std::vector<NumericX>& x, const std::vector<NumericY>& y, cons
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
 
@@ -1141,6 +1181,8 @@ bool errorbar(const std::vector<NumericX> &x, const std::vector<NumericY> &y, co
 {
     assert(x.size() == y.size());
 
+    detail::_interpreter::get();
+
     PyObject* xarray = detail::get_array(x);
     PyObject* yarray = detail::get_array(y);
     PyObject* yerrarray = detail::get_array(yerr);
@@ -1174,7 +1216,6 @@ bool errorbar(const std::vector<NumericX> &x, const std::vector<NumericY> &y, co
 template<typename Numeric>
 bool named_plot(const std::string& name, const std::vector<Numeric>& y, const std::string& format = "")
 {
-    // Make sure python is initialized.
     detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
@@ -1201,7 +1242,6 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& y, const st
 template<typename Numeric>
 bool named_plot(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
-    // Make sure python is initialized.
     detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
@@ -1229,7 +1269,6 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& x, const st
 template<typename Numeric>
 bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
-    // Make sure python is initialized.
     detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
@@ -1257,7 +1296,6 @@ bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, cons
 template<typename Numeric>
 bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
-    // Make sure python is initialized.
     detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
@@ -1285,7 +1323,6 @@ bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, cons
 template<typename Numeric>
 bool named_loglog(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
 {
-    // Make sure python is initialized.
     detail::_interpreter::get();
 
     PyObject* kwargs = PyDict_New();
@@ -1336,6 +1373,8 @@ bool stem(const std::vector<Numeric>& y, const std::string& format = "")
 template<typename Numeric>
 void text(Numeric x, Numeric y, const std::string& s = "")
 {
+    detail::_interpreter::get();
+
     PyObject* args = PyTuple_New(3);
     PyTuple_SetItem(args, 0, PyFloat_FromDouble(x));
     PyTuple_SetItem(args, 1, PyFloat_FromDouble(y));
@@ -1352,6 +1391,9 @@ inline void colorbar(PyObject* mappable = NULL, const std::map<std::string, floa
 {
     if (mappable == NULL)
         throw std::runtime_error("Must call colorbar with PyObject* returned from an image, contour, surface, etc.");
+
+    detail::_interpreter::get();
+
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, mappable);
 
@@ -1372,6 +1414,8 @@ inline void colorbar(PyObject* mappable = NULL, const std::map<std::string, floa
 
 inline long figure(long number = -1)
 {
+    detail::_interpreter::get();
+
     PyObject *res;
     if (number == -1)
         res = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure, detail::_interpreter::get().s_python_empty_tuple);
@@ -1401,7 +1445,6 @@ inline long figure(long number = -1)
 
 inline bool fignum_exists(long number)
 {
-    // Make sure interpreter is initialised
     detail::_interpreter::get();
 
     PyObject *args = PyTuple_New(1);
@@ -1418,7 +1461,6 @@ inline bool fignum_exists(long number)
 
 inline void figure_size(size_t w, size_t h)
 {
-    // Make sure interpreter is initialised
     detail::_interpreter::get();
 
     const size_t dpi = 100;
@@ -1441,6 +1483,8 @@ inline void figure_size(size_t w, size_t h)
 
 inline void legend()
 {
+    detail::_interpreter::get();
+
     PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_legend, detail::_interpreter::get().s_python_empty_tuple);
     if(!res) throw std::runtime_error("Call to legend() failed.");
 
@@ -1450,6 +1494,8 @@ inline void legend()
 template<typename Numeric>
 void ylim(Numeric left, Numeric right)
 {
+    detail::_interpreter::get();
+
     PyObject* list = PyList_New(2);
     PyList_SetItem(list, 0, PyFloat_FromDouble(left));
     PyList_SetItem(list, 1, PyFloat_FromDouble(right));
@@ -1467,6 +1513,8 @@ void ylim(Numeric left, Numeric right)
 template<typename Numeric>
 void xlim(Numeric left, Numeric right)
 {
+    detail::_interpreter::get();
+
     PyObject* list = PyList_New(2);
     PyList_SetItem(list, 0, PyFloat_FromDouble(left));
     PyList_SetItem(list, 1, PyFloat_FromDouble(right));
@@ -1484,6 +1532,8 @@ void xlim(Numeric left, Numeric right)
 
 inline double* xlim()
 {
+    detail::_interpreter::get();
+
     PyObject* args = PyTuple_New(0);
     PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_xlim, args);
     PyObject* left = PyTuple_GetItem(res,0);
@@ -1502,6 +1552,8 @@ inline double* xlim()
 
 inline double* ylim()
 {
+    detail::_interpreter::get();
+
     PyObject* args = PyTuple_New(0);
     PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_ylim, args);
     PyObject* left = PyTuple_GetItem(res,0);
@@ -1522,6 +1574,8 @@ inline void xticks(const std::vector<Numeric> &ticks, const std::vector<std::str
 {
     assert(labels.size() == 0 || ticks.size() == labels.size());
 
+    detail::_interpreter::get();
+
     // using numpy array
     PyObject* ticksarray = detail::get_array(ticks);
 
@@ -1569,6 +1623,8 @@ inline void yticks(const std::vector<Numeric> &ticks, const std::vector<std::str
 {
     assert(labels.size() == 0 || ticks.size() == labels.size());
 
+    detail::_interpreter::get();
+
     // using numpy array
     PyObject* ticksarray = detail::get_array(ticks);
 
@@ -1613,6 +1669,8 @@ inline void yticks(const std::vector<Numeric> &ticks, const std::map<std::string
 
 inline void tick_params(const std::map<std::string, std::string>& keywords, const std::string axis = "both")
 {
+  detail::_interpreter::get();
+
   // construct positional args
   PyObject* args;
   args = PyTuple_New(1);
@@ -1637,7 +1695,6 @@ inline void tick_params(const std::map<std::string, std::string>& keywords, cons
 
 inline void subplot(long nrows, long ncols, long plot_number)
 {
-    // Make sure interpreter is initialized
     detail::_interpreter::get();
     
     // construct positional args
@@ -1655,6 +1712,8 @@ inline void subplot(long nrows, long ncols, long plot_number)
 
 inline void subplot2grid(long nrows, long ncols, long rowid=0, long colid=0, long rowspan=1, long colspan=1)
 {
+    detail::_interpreter::get();
+
     PyObject* shape = PyTuple_New(2);
     PyTuple_SetItem(shape, 0, PyLong_FromLong(nrows));
     PyTuple_SetItem(shape, 1, PyLong_FromLong(ncols));
@@ -1680,6 +1739,8 @@ inline void subplot2grid(long nrows, long ncols, long rowid=0, long colid=0, lon
 
 inline void title(const std::string &titlestr, const std::map<std::string, std::string> &keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject* pytitlestr = PyString_FromString(titlestr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pytitlestr);
@@ -1699,7 +1760,6 @@ inline void title(const std::string &titlestr, const std::map<std::string, std::
 
 inline void suptitle(const std::string &suptitlestr, const std::map<std::string, std::string> &keywords = {})
 {
-    // Make sure interpreter is initialized
     detail::_interpreter::get();
     
     PyObject* pysuptitlestr = PyString_FromString(suptitlestr.c_str());
@@ -1721,6 +1781,8 @@ inline void suptitle(const std::string &suptitlestr, const std::map<std::string,
 
 inline void axis(const std::string &axisstr)
 {
+    detail::_interpreter::get();
+
     PyObject* str = PyString_FromString(axisstr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, str);
@@ -1734,6 +1796,8 @@ inline void axis(const std::string &axisstr)
 
 inline void axvline(double x, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
 {
+    detail::_interpreter::get();
+
     // construct positional args
     PyObject* args = PyTuple_New(3);
     PyTuple_SetItem(args, 0, PyFloat_FromDouble(x));
@@ -1757,6 +1821,8 @@ inline void axvline(double x, double ymin = 0., double ymax = 1., const std::map
 
 inline void xlabel(const std::string &str, const std::map<std::string, std::string> &keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject* pystr = PyString_FromString(str.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pystr);
@@ -1776,6 +1842,8 @@ inline void xlabel(const std::string &str, const std::map<std::string, std::stri
 
 inline void ylabel(const std::string &str, const std::map<std::string, std::string>& keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject* pystr = PyString_FromString(str.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pystr);
@@ -1793,15 +1861,16 @@ inline void ylabel(const std::string &str, const std::map<std::string, std::stri
     Py_DECREF(res);
 }
 
-inline void set_zlabel(const std::string &str, const std::map<std::string, std::string>& keywords = {}) {
+inline void set_zlabel(const std::string &str, const std::map<std::string, std::string>& keywords = {})
+{
+    detail::_interpreter::get();
+
     // Same as with plot_surface: We lazily load the modules here the first time 
     // this function is called because I'm not sure that we can assume "matplotlib 
     // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
     // want to require it for people who don't need 3d plots.
     static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
     if (!mpl_toolkitsmod) {
-        detail::_interpreter::get();
-
         PyObject* mpl_toolkits = PyString_FromString("mpl_toolkits");
         PyObject* axis3d = PyString_FromString("mpl_toolkits.mplot3d");
         if (!mpl_toolkits || !axis3d) { throw std::runtime_error("couldnt create string"); }
@@ -1846,6 +1915,8 @@ inline void set_zlabel(const std::string &str, const std::map<std::string, std::
 
 inline void grid(bool flag)
 {
+    detail::_interpreter::get();
+
     PyObject* pyflag = flag ? Py_True : Py_False;
     Py_INCREF(pyflag);
 
@@ -1861,6 +1932,8 @@ inline void grid(bool flag)
 
 inline void show(const bool block = true)
 {
+    detail::_interpreter::get();
+
     PyObject* res;
     if(block)
     {
@@ -1884,6 +1957,8 @@ inline void show(const bool block = true)
 
 inline void close()
 {
+    detail::_interpreter::get();
+
     PyObject* res = PyObject_CallObject(
             detail::_interpreter::get().s_python_function_close,
             detail::_interpreter::get().s_python_empty_tuple);
@@ -1894,6 +1969,8 @@ inline void close()
 }
 
 inline void xkcd() {
+    detail::_interpreter::get();
+
     PyObject* res;
     PyObject *kwargs = PyDict_New();
 
@@ -1910,6 +1987,8 @@ inline void xkcd() {
 
 inline void draw()
 {
+    detail::_interpreter::get();
+
     PyObject* res = PyObject_CallObject(
         detail::_interpreter::get().s_python_function_draw,
         detail::_interpreter::get().s_python_empty_tuple);
@@ -1922,6 +2001,8 @@ inline void draw()
 template<typename Numeric>
 inline void pause(Numeric interval)
 {
+    detail::_interpreter::get();
+
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, PyFloat_FromDouble(interval));
 
@@ -1934,6 +2015,8 @@ inline void pause(Numeric interval)
 
 inline void save(const std::string& filename)
 {
+    detail::_interpreter::get();
+
     PyObject* pyfilename = PyString_FromString(filename.c_str());
 
     PyObject* args = PyTuple_New(1);
@@ -1947,6 +2030,8 @@ inline void save(const std::string& filename)
 }
 
 inline void clf() {
+    detail::_interpreter::get();
+
     PyObject *res = PyObject_CallObject(
         detail::_interpreter::get().s_python_function_clf,
         detail::_interpreter::get().s_python_empty_tuple);
@@ -1956,7 +2041,9 @@ inline void clf() {
     Py_DECREF(res);
 }
 
-    inline void ion() {
+inline void ion() {
+    detail::_interpreter::get();
+
     PyObject *res = PyObject_CallObject(
         detail::_interpreter::get().s_python_function_ion,
         detail::_interpreter::get().s_python_empty_tuple);
@@ -1968,6 +2055,8 @@ inline void clf() {
 
 inline std::vector<std::array<double, 2>> ginput(const int numClicks = 1, const std::map<std::string, std::string>& keywords = {})
 {
+    detail::_interpreter::get();
+
     PyObject *args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, PyLong_FromLong(numClicks));
 
@@ -2002,6 +2091,8 @@ inline std::vector<std::array<double, 2>> ginput(const int numClicks = 1, const
 
 // Actually, is there any reason not to call this automatically for every plot?
 inline void tight_layout() {
+    detail::_interpreter::get();
+
     PyObject *res = PyObject_CallObject(
         detail::_interpreter::get().s_python_function_tight_layout,
         detail::_interpreter::get().s_python_empty_tuple);
@@ -2149,6 +2240,7 @@ class Plot
     // default initialization with plot label, some data and format
     template<typename Numeric>
     Plot(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "") {
+        detail::_interpreter::get();
 
         assert(x.size() == y.size());
 

From 480af0f4f9d13dd62254981855e7bc1a11378dbc Mon Sep 17 00:00:00 2001
From: pf <pf@pf-ubuntu-dev>
Date: Mon, 20 Apr 2020 10:29:54 +0100
Subject: [PATCH 57/86] Added support for axvspan

---
 matplotlibcpp.h | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index ea2e4fb..6cbe74f 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -73,6 +73,7 @@ struct _interpreter {
     PyObject *s_python_function_title;
     PyObject *s_python_function_axis;
     PyObject *s_python_function_axvline;
+    PyObject *s_python_function_axvspan;
     PyObject *s_python_function_xlabel;
     PyObject *s_python_function_ylabel;
     PyObject *s_python_function_gca;
@@ -208,6 +209,7 @@ struct _interpreter {
         s_python_function_title = safe_import(pymod, "title");
         s_python_function_axis = safe_import(pymod, "axis");
         s_python_function_axvline = safe_import(pymod, "axvline");
+        s_python_function_axvspan = safe_import(pymod, "axvspan");
         s_python_function_xlabel = safe_import(pymod, "xlabel");
         s_python_function_ylabel = safe_import(pymod, "ylabel");
         s_python_function_gca = safe_import(pymod, "gca");
@@ -1819,6 +1821,29 @@ inline void axvline(double x, double ymin = 0., double ymax = 1., const std::map
     if(res) Py_DECREF(res);
 }
 
+inline void axvspan(double xmin, double xmax, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
+{
+    // construct positional args
+    PyObject* args = PyTuple_New(4);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(xmin));
+    PyTuple_SetItem(args, 1, PyFloat_FromDouble(xmax));
+    PyTuple_SetItem(args, 2, PyFloat_FromDouble(ymin));
+    PyTuple_SetItem(args, 3, PyFloat_FromDouble(ymax));
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+    {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axvspan, args, kwargs);
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if(res) Py_DECREF(res);
+}
+
 inline void xlabel(const std::string &str, const std::map<std::string, std::string> &keywords = {})
 {
     detail::_interpreter::get();

From 107912124d9d6a0a6942b2b2153c781905e83854 Mon Sep 17 00:00:00 2001
From: pf <pf@pf-ubuntu-dev>
Date: Mon, 20 Apr 2020 10:49:19 +0100
Subject: [PATCH 58/86] a few of the parameters are floats. This is a quick
 hack to get a couple of them to work. In the future matplotlibcpp should use
 map<string,any> instead of map<string,string> for kwargs. That should be a
 separate PR

---
 matplotlibcpp.h | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 6cbe74f..b4bf18a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1834,7 +1834,10 @@ inline void axvspan(double xmin, double xmax, double ymin = 0., double ymax = 1.
     PyObject* kwargs = PyDict_New();
     for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
     {
-        PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+	if (it->first == "linewidth" || it->first == "alpha")
+    	    PyDict_SetItemString(kwargs, it->first.c_str(), PyFloat_FromDouble(std::stod(it->second)));
+  	else
+    	    PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
     }
 
     PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axvspan, args, kwargs);

From 374dcd032ca8e609d25ba7ced2dd3f25a173fabb Mon Sep 17 00:00:00 2001
From: JBPennington <justinbrettpennington@gmail.com>
Date: Fri, 24 Apr 2020 08:58:15 -0400
Subject: [PATCH 59/86] Added arrow, cla, margins, contour

---
 matplotlibcpp.h | 116 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index b4bf18a..7460eb7 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -45,6 +45,7 @@ namespace detail {
 static std::string s_backend;
 
 struct _interpreter {
+    PyObject* s_python_function_arrow;
     PyObject *s_python_function_show;
     PyObject *s_python_function_close;
     PyObject *s_python_function_draw;
@@ -54,6 +55,7 @@ struct _interpreter {
     PyObject *s_python_function_fignum_exists;
     PyObject *s_python_function_plot;
     PyObject *s_python_function_quiver;
+    PyObject* s_python_function_contour;
     PyObject *s_python_function_semilogx;
     PyObject *s_python_function_semilogy;
     PyObject *s_python_function_loglog;
@@ -79,8 +81,10 @@ struct _interpreter {
     PyObject *s_python_function_gca;
     PyObject *s_python_function_xticks;
     PyObject *s_python_function_yticks;
+    PyObject* s_python_function_margins;
     PyObject *s_python_function_tick_params;
     PyObject *s_python_function_grid;
+    PyObject* s_python_function_cla;
     PyObject *s_python_function_clf;
     PyObject *s_python_function_errorbar;
     PyObject *s_python_function_annotate;
@@ -186,6 +190,7 @@ struct _interpreter {
         Py_DECREF(pylabname);
         if (!pylabmod) { throw std::runtime_error("Error loading module pylab!"); }
 
+        s_python_function_arrow = safe_import(pymod, "arrow");
         s_python_function_show = safe_import(pymod, "show");
         s_python_function_close = safe_import(pymod, "close");
         s_python_function_draw = safe_import(pymod, "draw");
@@ -194,6 +199,7 @@ struct _interpreter {
         s_python_function_fignum_exists = safe_import(pymod, "fignum_exists");
         s_python_function_plot = safe_import(pymod, "plot");
         s_python_function_quiver = safe_import(pymod, "quiver");
+        s_python_function_contour = safe_import(pymod, "contour");
         s_python_function_semilogx = safe_import(pymod, "semilogx");
         s_python_function_semilogy = safe_import(pymod, "semilogy");
         s_python_function_loglog = safe_import(pymod, "loglog");
@@ -215,6 +221,7 @@ struct _interpreter {
         s_python_function_gca = safe_import(pymod, "gca");
         s_python_function_xticks = safe_import(pymod, "xticks");
         s_python_function_yticks = safe_import(pymod, "yticks");
+        s_python_function_margins = safe_import(pymod, "margins");
         s_python_function_tick_params = safe_import(pymod, "tick_params");
         s_python_function_grid = safe_import(pymod, "grid");
         s_python_function_xlim = safe_import(pymod, "xlim");
@@ -222,6 +229,7 @@ struct _interpreter {
         s_python_function_ginput = safe_import(pymod, "ginput");
         s_python_function_save = safe_import(pylabmod, "savefig");
         s_python_function_annotate = safe_import(pymod,"annotate");
+        s_python_function_cla = safe_import(pymod, "cla");
         s_python_function_clf = safe_import(pymod, "clf");
         s_python_function_errorbar = safe_import(pymod, "errorbar");
         s_python_function_tight_layout = safe_import(pymod, "tight_layout");
@@ -709,6 +717,37 @@ bool fill_between(const std::vector<Numeric>& x, const std::vector<Numeric>& y1,
     return res;
 }
 
+template <typename Numeric>
+bool arrow(Numeric x, Numeric y, Numeric end_x, Numeric end_y, const std::string& fc = "r",
+           const std::string ec = "k", Numeric head_length = 0.25, Numeric head_width = 0.1625) {
+    PyObject* obj_x = PyFloat_FromDouble(x);
+    PyObject* obj_y = PyFloat_FromDouble(y);
+    PyObject* obj_end_x = PyFloat_FromDouble(end_x);
+    PyObject* obj_end_y = PyFloat_FromDouble(end_y);
+
+    PyObject* kwargs = PyDict_New();
+    PyDict_SetItemString(kwargs, "fc", PyString_FromString(fc.c_str()));
+    PyDict_SetItemString(kwargs, "ec", PyString_FromString(ec.c_str()));
+    PyDict_SetItemString(kwargs, "head_width", PyFloat_FromDouble(head_width));
+    PyDict_SetItemString(kwargs, "head_length", PyFloat_FromDouble(head_length));
+
+    PyObject* plot_args = PyTuple_New(4);
+    PyTuple_SetItem(plot_args, 0, obj_x);
+    PyTuple_SetItem(plot_args, 1, obj_y);
+    PyTuple_SetItem(plot_args, 2, obj_end_x);
+    PyTuple_SetItem(plot_args, 3, obj_end_y);
+
+    PyObject* res =
+            PyObject_Call(detail::_interpreter::get().s_python_function_arrow, plot_args, kwargs);
+
+    Py_DECREF(plot_args);
+    Py_DECREF(kwargs);
+    if (res)
+        Py_DECREF(res);
+
+    return res;
+}
+
 template< typename Numeric>
 bool hist(const std::vector<Numeric>& y, long bins=10,std::string color="b",
           double alpha=1.0, bool cumulative=false)
@@ -1040,6 +1079,39 @@ bool plot(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const
     return res;
 }
 
+template <typename NumericX, typename NumericY, typename NumericZ>
+bool contour(const std::vector<NumericX>& x, const std::vector<NumericY>& y,
+             const std::vector<NumericZ>& z,
+             const std::map<std::string, std::string>& keywords = {}) {
+    assert(x.size() == y.size() && x.size() == z.size());
+
+    PyObject* xarray = get_array(x);
+    PyObject* yarray = get_array(y);
+    PyObject* zarray = get_array(z);
+
+    PyObject* plot_args = PyTuple_New(3);
+    PyTuple_SetItem(plot_args, 0, xarray);
+    PyTuple_SetItem(plot_args, 1, yarray);
+    PyTuple_SetItem(plot_args, 2, zarray);
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
+         it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject* res =
+            PyObject_Call(detail::_interpreter::get().s_python_function_contour, plot_args, kwargs);
+
+    Py_DECREF(kwargs);
+    Py_DECREF(plot_args);
+    if (res)
+        Py_DECREF(res);
+
+    return res;
+}
+
 template<typename NumericX, typename NumericY, typename NumericU, typename NumericW>
 bool quiver(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::vector<NumericU>& u, const std::vector<NumericW>& w, const std::map<std::string, std::string>& keywords = {})
 {
@@ -1669,6 +1741,38 @@ inline void yticks(const std::vector<Numeric> &ticks, const std::map<std::string
     yticks(ticks, {}, keywords);
 }
 
+template <typename Numeric> inline void margins(Numeric margin)
+{
+    // construct positional args
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(margin));
+
+    PyObject* res =
+            PyObject_CallObject(detail::_interpreter::get().s_python_function_margins, args);
+    if (!res)
+        throw std::runtime_error("Call to margins() failed.");
+
+    Py_DECREF(args);
+    Py_DECREF(res);
+}
+
+template <typename Numeric> inline void margins(Numeric margin_x, Numeric margin_y)
+{
+    // construct positional args
+    PyObject* args = PyTuple_New(2);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(margin_x));
+    PyTuple_SetItem(args, 1, PyFloat_FromDouble(margin_y));
+
+    PyObject* res =
+            PyObject_CallObject(detail::_interpreter::get().s_python_function_margins, args);
+    if (!res)
+        throw std::runtime_error("Call to margins() failed.");
+
+    Py_DECREF(args);
+    Py_DECREF(res);
+}
+
+
 inline void tick_params(const std::map<std::string, std::string>& keywords, const std::string axis = "both")
 {
   detail::_interpreter::get();
@@ -2069,6 +2173,18 @@ inline void clf() {
     Py_DECREF(res);
 }
 
+inline void cla() {
+    detail::_interpreter::get();
+
+    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_cla,
+                                        detail::_interpreter::get().s_python_empty_tuple);
+
+    if (!res)
+        throw std::runtime_error("Call to cla() failed.");
+
+    Py_DECREF(res);
+}
+
 inline void ion() {
     detail::_interpreter::get();
 

From b79ca6dc655f01eac206b84d3c7ffc7cdb268107 Mon Sep 17 00:00:00 2001
From: Tako Hisada <takoloco@takotime.com>
Date: Sun, 14 Jun 2020 21:38:22 +0000
Subject: [PATCH 60/86] feat: Add keyword argument support to legend()

---
 matplotlibcpp.h | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 7460eb7..6770074 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1565,6 +1565,24 @@ inline void legend()
     Py_DECREF(res);
 }
 
+inline void legend(const std::map<std::string, std::string>& keywords)
+{
+  detail::_interpreter::get();
+
+  // construct keyword args
+  PyObject* kwargs = PyDict_New();
+  for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+  {
+    PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+  }
+
+  PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_legend, detail::_interpreter::get().s_python_empty_tuple, kwargs);
+  if(!res) throw std::runtime_error("Call to legend() failed.");
+
+  Py_DECREF(kwargs);
+  Py_DECREF(res);  
+}
+
 template<typename Numeric>
 void ylim(Numeric left, Numeric right)
 {

From 7d0e695409e7029fd52a4653907a167b4cc725b9 Mon Sep 17 00:00:00 2001
From: Cryoris <jules.gacon@googlemail.com>
Date: Sat, 23 May 2020 19:04:01 +0200
Subject: [PATCH 61/86] include ldflags instead of libs

---
 Makefile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index 1a5a339..67b5ac3 100644
--- a/Makefile
+++ b/Makefile
@@ -6,10 +6,10 @@ PYTHON_BIN     ?= python3
 PYTHON_CONFIG  := $(PYTHON_BIN)-config
 PYTHON_INCLUDE ?= $(shell $(PYTHON_CONFIG) --includes)
 EXTRA_FLAGS    := $(PYTHON_INCLUDE)
-# NOTE: Since python3.8, the correct invocation is `python3-config --libs --embed`. 
+# NOTE: Since python3.8, the correct invocation is `python3-config --libs --embed`.
 # So of course the proper way to get python libs for embedding now is to
 # invoke that, check if it crashes, and fall back to just `--libs` if it does.
-LDFLAGS        += $(shell if $(PYTHON_CONFIG) --libs --embed >/dev/null; then $(PYTHON_CONFIG) --libs --embed; else $(PYTHON_CONFIG) --libs; fi)
+LDFLAGS        += $(shell if $(PYTHON_CONFIG) --ldflags --embed >/dev/null; then $(PYTHON_CONFIG) --ldflags --embed; else $(PYTHON_CONFIG) --ldflags; fi)
 
 # Either finds numpy or set -DWITHOUT_NUMPY
 EXTRA_FLAGS     += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)

From f4b49a35d0bc59bb2fd606b1f7c9bedf9c271e8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Barnab=C3=A9=20BALP?= <contact@barnabebalp.fr>
Date: Sat, 15 Aug 2020 20:02:15 +0000
Subject: [PATCH 62/86] Fix issue lava/matplotlib-cpp#124

---
 matplotlibcpp.h | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 6770074..98f356c 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -153,6 +153,11 @@ struct _interpreter {
         Py_SetProgramName(name);
         Py_Initialize();
 
+        wchar_t const *dummy_args[] = {L"Python", NULL};  // const is needed because literals must not be modified
+        wchar_t const **argv = dummy_args;
+        int             argc = sizeof(dummy_args)/sizeof(dummy_args[0])-1;
+        PySys_SetArgv(argc, const_cast<wchar_t **>(argv));
+
 #ifndef WITHOUT_NUMPY
         import_numpy(); // initialize numpy C-API
 #endif

From f2bf7a45112d1d9e41cf97ceb645f106e80f6442 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Thu, 27 Aug 2020 20:50:30 +0200
Subject: [PATCH 63/86] Add missing call to initialize interpreter in 'modern'
 example

---
 matplotlibcpp.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 98f356c..111b904 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -2321,6 +2321,8 @@ struct plot_impl<std::false_type>
     template<typename IterableX, typename IterableY>
     bool operator()(const IterableX& x, const IterableY& y, const std::string& format)
     {
+        detail::_interpreter::get();
+
         // 2-phase lookup for distance, begin, end
         using std::distance;
         using std::begin;

From 6f841d442aebbd22f80eb70c9e0d1fbc590c7638 Mon Sep 17 00:00:00 2001
From: Andre Furlan <ensismoebius@gmail.com>
Date: Tue, 26 May 2020 15:53:17 -0300
Subject: [PATCH 64/86] Added support to barh plot method

---
 matplotlibcpp.h | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 111b904..c6762db 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -96,6 +96,7 @@ struct _interpreter {
     PyObject *s_python_function_text;
     PyObject *s_python_function_suptitle;
     PyObject *s_python_function_bar;
+    PyObject *s_python_function_barh;
     PyObject *s_python_function_colorbar;
     PyObject *s_python_function_subplots_adjust;
 
@@ -243,6 +244,7 @@ struct _interpreter {
         s_python_function_text = safe_import(pymod, "text");
         s_python_function_suptitle = safe_import(pymod, "suptitle");
         s_python_function_bar = safe_import(pymod,"bar");
+        s_python_function_barh = safe_import(pymod, "barh");
         s_python_function_colorbar = PyObject_GetAttrString(pymod, "colorbar");
         s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
 #ifndef WITHOUT_NUMPY
@@ -1010,6 +1012,36 @@ bool bar(const std::vector<Numeric> &               y,
   return bar(x, y, ec, ls, lw, keywords);
 }
 
+
+template<typename Numeric>
+bool barh(const std::vector<Numeric> &x, const std::vector<Numeric> &y, std::string ec = "black", std::string ls = "-", double lw = 1.0, const std::map<std::string, std::string> &keywords = { }) {
+    PyObject *xarray = detail::get_array(x);
+    PyObject *yarray = detail::get_array(y);
+
+    PyObject *kwargs = PyDict_New();
+
+    PyDict_SetItemString(kwargs, "ec", PyString_FromString(ec.c_str()));
+    PyDict_SetItemString(kwargs, "ls", PyString_FromString(ls.c_str()));
+    PyDict_SetItemString(kwargs, "lw", PyFloat_FromDouble(lw));
+
+    for (std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it) {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+    }
+
+    PyObject *plot_args = PyTuple_New(2);
+    PyTuple_SetItem(plot_args, 0, xarray);
+    PyTuple_SetItem(plot_args, 1, yarray);
+
+    PyObject *res = PyObject_Call(detail::_interpreter::get().s_python_function_barh, plot_args, kwargs);
+
+    Py_DECREF(plot_args);
+    Py_DECREF(kwargs);
+    if (res) Py_DECREF(res);
+
+    return res;
+}
+
+
 inline bool subplots_adjust(const std::map<std::string, double>& keywords = {})
 {
     detail::_interpreter::get();

From dfe5a69a950251887f8b8754023e7fc23d8da6fc Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Thu, 27 Aug 2020 21:18:02 +0200
Subject: [PATCH 65/86] Fix whitespace error

---
 matplotlibcpp.h | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index c6762db..9b414a1 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1993,10 +1993,10 @@ inline void axvspan(double xmin, double xmax, double ymin = 0., double ymax = 1.
     PyObject* kwargs = PyDict_New();
     for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
     {
-	if (it->first == "linewidth" || it->first == "alpha")
-    	    PyDict_SetItemString(kwargs, it->first.c_str(), PyFloat_FromDouble(std::stod(it->second)));
-  	else
-    	    PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    if (it->first == "linewidth" || it->first == "alpha")
+            PyDict_SetItemString(kwargs, it->first.c_str(), PyFloat_FromDouble(std::stod(it->second)));
+    else
+            PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
     }
 
     PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axvspan, args, kwargs);

From b6f58a5c4c0a1430c7ec92e2583b817309650d02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Le=20creepeur=20petit=C3=A8?= <nikostpt@hotmail.com>
Date: Thu, 18 Jun 2020 07:20:46 +0300
Subject: [PATCH 66/86] Suggestion: Give more multithreading flexibility
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Python interpreter can be constructed by any thread while the destructor is always the main thread. This can lead in some errors with the Python side of things, where some objects want the thread which constructed them to also destroy them. By adding this 'kill' function, a developer can use your library (btw gj! 👍 ) with `std::thread` in order to create a plot async -aka without blocking the main thread- and then close the plot and 'kill' Python interpreter afterwards, without waiting the program to end or having destructor errors.

Doing this in order to showcase this more. Small change but not that polished. Let me know about your opinion first and we can fix it 😃.
Thank you for your time and this great library ❤️
---
 matplotlibcpp.h | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 9b414a1..714bfd3 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -108,7 +108,17 @@ struct _interpreter {
        */
 
     static _interpreter& get() {
+        return interkeeper(false);
+    }
+
+    static _interpreter& kill() {
+        return interkeeper(true);
+    }
+
+    static _interpreter& interkeeper(bool should_kill) {
         static _interpreter ctx;
+        if (should_kill)
+            ctx.~_interpreter();
         return ctx;
     }
 

From 70d508fcb7febc66535ba923eac1b1a4e571e4d1 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno.martin.evers@gmail.com>
Date: Thu, 27 Aug 2020 21:29:25 +0200
Subject: [PATCH 67/86] Expand comment for new interkeeper() function

---
 matplotlibcpp.h | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 714bfd3..93a72be 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -103,8 +103,14 @@ struct _interpreter {
 
     /* For now, _interpreter is implemented as a singleton since its currently not possible to have
        multiple independent embedded python interpreters without patching the python source code
-       or starting a separate process for each.
-        http://bytes.com/topic/python/answers/793370-multiple-independent-python-interpreters-c-c-program
+       or starting a separate process for each. [1]
+       Furthermore, many python objects expect that they are destructed in the same thread as they
+       were constructed. [2] So for advanced usage, a `kill()` function is provided so that library
+       users can manually ensure that the interpreter is constructed and destroyed within the
+       same thread.
+
+         1: http://bytes.com/topic/python/answers/793370-multiple-independent-python-interpreters-c-c-program
+         2: https://github.com/lava/matplotlib-cpp/pull/202#issue-436220256
        */
 
     static _interpreter& get() {
@@ -115,6 +121,7 @@ struct _interpreter {
         return interkeeper(true);
     }
 
+    // Stores the actual singleton object referenced by `get()` and `kill()`.
     static _interpreter& interkeeper(bool should_kill) {
         static _interpreter ctx;
         if (should_kill)

From 80bc9cd84da8d40f9b52b838291eb91f00c1c73f Mon Sep 17 00:00:00 2001
From: Joshua Brinsfield <sapphous@gmail.com>
Date: Sat, 31 Oct 2020 18:51:05 -0400
Subject: [PATCH 68/86] Add 3D quiver support

---
 matplotlibcpp.h | 86 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 93a72be..52b2780 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1202,6 +1202,92 @@ bool quiver(const std::vector<NumericX>& x, const std::vector<NumericY>& y, cons
     return res;
 }
 
+template<typename NumericX, typename NumericY, typename NumericZ, typename NumericU, typename NumericW, typename NumericV>
+bool quiver(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::vector<NumericZ>& z, const std::vector<NumericU>& u, const std::vector<NumericW>& w, const std::vector<NumericV>& v, const std::map<std::string, std::string>& keywords = {})
+{
+  //set up 3d axes stuff
+  static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
+  if (!mpl_toolkitsmod) {
+    detail::_interpreter::get();
+
+    PyObject* mpl_toolkits = PyString_FromString("mpl_toolkits");
+    PyObject* axis3d = PyString_FromString("mpl_toolkits.mplot3d");
+    if (!mpl_toolkits || !axis3d) { throw std::runtime_error("couldnt create string"); }
+
+    mpl_toolkitsmod = PyImport_Import(mpl_toolkits);
+    Py_DECREF(mpl_toolkits);
+    if (!mpl_toolkitsmod) { throw std::runtime_error("Error loading module mpl_toolkits!"); }
+
+    axis3dmod = PyImport_Import(axis3d);
+    Py_DECREF(axis3d);
+    if (!axis3dmod) { throw std::runtime_error("Error loading module mpl_toolkits.mplot3d!"); }
+  }
+  
+  //assert sizes match up
+  assert(x.size() == y.size() && x.size() == u.size() && u.size() == w.size() && x.size() == z.size() && x.size() == v.size() && u.size() == v.size());
+
+  //set up parameters
+  detail::_interpreter::get();
+
+  PyObject* xarray = detail::get_array(x);
+  PyObject* yarray = detail::get_array(y);
+  PyObject* zarray = detail::get_array(z);
+  PyObject* uarray = detail::get_array(u);
+  PyObject* warray = detail::get_array(w);
+  PyObject* varray = detail::get_array(v);
+
+  PyObject* plot_args = PyTuple_New(6);
+  PyTuple_SetItem(plot_args, 0, xarray);
+  PyTuple_SetItem(plot_args, 1, yarray);
+  PyTuple_SetItem(plot_args, 2, zarray);
+  PyTuple_SetItem(plot_args, 3, uarray);
+  PyTuple_SetItem(plot_args, 4, warray);
+  PyTuple_SetItem(plot_args, 5, varray);
+
+  // construct keyword args
+  PyObject* kwargs = PyDict_New();
+  for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+  {
+      PyDict_SetItemString(kwargs, it->first.c_str(), PyUnicode_FromString(it->second.c_str()));
+  }
+    
+  //get figure gca to enable 3d projection
+  PyObject *fig =
+      PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+                          detail::_interpreter::get().s_python_empty_tuple);
+  if (!fig) throw std::runtime_error("Call to figure() failed.");
+
+  PyObject *gca_kwargs = PyDict_New();
+  PyDict_SetItemString(gca_kwargs, "projection", PyString_FromString("3d"));
+
+  PyObject *gca = PyObject_GetAttrString(fig, "gca");
+  if (!gca) throw std::runtime_error("No gca");
+  Py_INCREF(gca);
+  PyObject *axis = PyObject_Call(
+      gca, detail::_interpreter::get().s_python_empty_tuple, gca_kwargs);
+
+  if (!axis) throw std::runtime_error("No axis");
+  Py_INCREF(axis);
+  Py_DECREF(gca);
+  Py_DECREF(gca_kwargs);
+  
+  //plot our boys bravely, plot them strongly, plot them with a wink and clap
+  PyObject *plot3 = PyObject_GetAttrString(axis, "quiver");
+  if (!plot3) throw std::runtime_error("No 3D line plot");
+  Py_INCREF(plot3);
+  PyObject* res = PyObject_Call(
+          plot3, plot_args, kwargs);
+  if (!res) throw std::runtime_error("Failed 3D plot");
+  Py_DECREF(plot3);
+  Py_DECREF(axis);
+  Py_DECREF(kwargs);
+  Py_DECREF(plot_args);
+  if (res)
+      Py_DECREF(res);
+
+  return res;
+}
+
 template<typename NumericX, typename NumericY>
 bool stem(const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::string& s = "")
 {

From 9d19657a36c3950de2848113a546406cad8f8f29 Mon Sep 17 00:00:00 2001
From: Ruan Luies <omega@live.co.za>
Date: Sun, 17 Jan 2021 13:30:12 +0200
Subject: [PATCH 69/86] Add 3D scatter plots, allow more than one 3d plot on
 the same figure and make rcparams changeable.

---
 matplotlibcpp.h | 185 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 167 insertions(+), 18 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 52b2780..226a16a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -99,6 +99,7 @@ struct _interpreter {
     PyObject *s_python_function_barh;
     PyObject *s_python_function_colorbar;
     PyObject *s_python_function_subplots_adjust;
+    PyObject *s_python_function_rcparams;
 
 
     /* For now, _interpreter is implemented as a singleton since its currently not possible to have
@@ -189,6 +190,7 @@ struct _interpreter {
         }
 
         PyObject* matplotlib = PyImport_Import(matplotlibname);
+
         Py_DECREF(matplotlibname);
         if (!matplotlib) {
             PyErr_Print();
@@ -201,6 +203,8 @@ struct _interpreter {
             PyObject_CallMethod(matplotlib, const_cast<char*>("use"), const_cast<char*>("s"), s_backend.c_str());
         }
 
+
+
         PyObject* pymod = PyImport_Import(pyplotname);
         Py_DECREF(pyplotname);
         if (!pymod) { throw std::runtime_error("Error loading module matplotlib.pyplot!"); }
@@ -264,6 +268,7 @@ struct _interpreter {
         s_python_function_barh = safe_import(pymod, "barh");
         s_python_function_colorbar = PyObject_GetAttrString(pymod, "colorbar");
         s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
+        s_python_function_rcparams = PyObject_GetAttrString(pymod, "rcParams");
 #ifndef WITHOUT_NUMPY
         s_python_function_imshow = safe_import(pymod, "imshow");
 #endif
@@ -464,6 +469,7 @@ template <typename Numeric>
 void plot_surface(const std::vector<::std::vector<Numeric>> &x,
                   const std::vector<::std::vector<Numeric>> &y,
                   const std::vector<::std::vector<Numeric>> &z,
+                  const long fig_number=0,
                   const std::map<std::string, std::string> &keywords =
                       std::map<std::string, std::string>())
 {
@@ -516,14 +522,29 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
 
   for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
        it != keywords.end(); ++it) {
-    PyDict_SetItemString(kwargs, it->first.c_str(),
-                         PyString_FromString(it->second.c_str()));
+    if (it->first == "linewidth" || it->first == "alpha") {
+      PyDict_SetItemString(kwargs, it->first.c_str(),
+        PyFloat_FromDouble(std::stod(it->second)));
+    } else {
+      PyDict_SetItemString(kwargs, it->first.c_str(),
+        PyString_FromString(it->second.c_str()));
+    }
   }
 
-
-  PyObject *fig =
-      PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
-                          detail::_interpreter::get().s_python_empty_tuple);
+  PyObject *fig_args = PyTuple_New(1);
+  PyObject* fig = nullptr;
+  PyTuple_SetItem(fig_args, 0, PyLong_FromLong(fig_number));
+  PyObject *fig_exists =
+    PyObject_CallObject(
+    detail::_interpreter::get().s_python_function_fignum_exists, fig_args);
+  if (!PyObject_IsTrue(fig_exists)) {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      detail::_interpreter::get().s_python_empty_tuple);
+  } else {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      fig_args);
+  }
+  Py_DECREF(fig_exists);
   if (!fig) throw std::runtime_error("Call to figure() failed.");
 
   PyObject *gca_kwargs = PyDict_New();
@@ -559,6 +580,7 @@ template <typename Numeric>
 void plot3(const std::vector<Numeric> &x,
                   const std::vector<Numeric> &y,
                   const std::vector<Numeric> &z,
+                  const long fig_number=0,
                   const std::map<std::string, std::string> &keywords =
                       std::map<std::string, std::string>())
 {
@@ -607,9 +629,18 @@ void plot3(const std::vector<Numeric> &x,
                          PyString_FromString(it->second.c_str()));
   }
 
-  PyObject *fig =
-      PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
-                          detail::_interpreter::get().s_python_empty_tuple);
+  PyObject *fig_args = PyTuple_New(1);
+  PyObject* fig = nullptr;
+  PyTuple_SetItem(fig_args, 0, PyLong_FromLong(fig_number));
+  PyObject *fig_exists =
+    PyObject_CallObject(detail::_interpreter::get().s_python_function_fignum_exists, fig_args);
+  if (!PyObject_IsTrue(fig_exists)) {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      detail::_interpreter::get().s_python_empty_tuple);
+  } else {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      fig_args);
+  }
   if (!fig) throw std::runtime_error("Call to figure() failed.");
 
   PyObject *gca_kwargs = PyDict_New();
@@ -911,6 +942,103 @@ bool scatter(const std::vector<NumericX>& x,
     return res;
 }
 
+template<typename NumericX, typename NumericY, typename NumericZ>
+bool scatter(const std::vector<NumericX>& x,
+             const std::vector<NumericY>& y,
+             const std::vector<NumericZ>& z,
+             const double s=1.0, // The marker size in points**2
+             const long fig_number=0,
+             const std::map<std::string, std::string> & keywords = {}) {
+  detail::_interpreter::get();
+
+  // Same as with plot_surface: We lazily load the modules here the first time 
+  // this function is called because I'm not sure that we can assume "matplotlib 
+  // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
+  // want to require it for people who don't need 3d plots.
+  static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
+  if (!mpl_toolkitsmod) {
+    detail::_interpreter::get();
+
+    PyObject* mpl_toolkits = PyString_FromString("mpl_toolkits");
+    PyObject* axis3d = PyString_FromString("mpl_toolkits.mplot3d");
+    if (!mpl_toolkits || !axis3d) { throw std::runtime_error("couldnt create string"); }
+
+    mpl_toolkitsmod = PyImport_Import(mpl_toolkits);
+    Py_DECREF(mpl_toolkits);
+    if (!mpl_toolkitsmod) { throw std::runtime_error("Error loading module mpl_toolkits!"); }
+
+    axis3dmod = PyImport_Import(axis3d);
+    Py_DECREF(axis3d);
+    if (!axis3dmod) { throw std::runtime_error("Error loading module mpl_toolkits.mplot3d!"); }
+  }
+
+  assert(x.size() == y.size());
+  assert(y.size() == z.size());
+
+  PyObject *xarray = detail::get_array(x);
+  PyObject *yarray = detail::get_array(y);
+  PyObject *zarray = detail::get_array(z);
+
+  // construct positional args
+  PyObject *args = PyTuple_New(3);
+  PyTuple_SetItem(args, 0, xarray);
+  PyTuple_SetItem(args, 1, yarray);
+  PyTuple_SetItem(args, 2, zarray);
+
+  // Build up the kw args.
+  PyObject *kwargs = PyDict_New();
+
+  for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
+       it != keywords.end(); ++it) {
+    PyDict_SetItemString(kwargs, it->first.c_str(),
+                         PyString_FromString(it->second.c_str()));
+  }
+  PyObject *fig_args = PyTuple_New(1);
+  PyObject* fig = nullptr;
+  PyTuple_SetItem(fig_args, 0, PyLong_FromLong(fig_number));
+  PyObject *fig_exists =
+    PyObject_CallObject(detail::_interpreter::get().s_python_function_fignum_exists, fig_args);
+  if (!PyObject_IsTrue(fig_exists)) {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      detail::_interpreter::get().s_python_empty_tuple);
+  } else {
+    fig = PyObject_CallObject(detail::_interpreter::get().s_python_function_figure,
+      fig_args);
+  }
+  Py_DECREF(fig_exists);
+  if (!fig) throw std::runtime_error("Call to figure() failed.");
+
+  PyObject *gca_kwargs = PyDict_New();
+  PyDict_SetItemString(gca_kwargs, "projection", PyString_FromString("3d"));
+
+  PyObject *gca = PyObject_GetAttrString(fig, "gca");
+  if (!gca) throw std::runtime_error("No gca");
+  Py_INCREF(gca);
+  PyObject *axis = PyObject_Call(
+      gca, detail::_interpreter::get().s_python_empty_tuple, gca_kwargs);
+
+  if (!axis) throw std::runtime_error("No axis");
+  Py_INCREF(axis);
+
+  Py_DECREF(gca);
+  Py_DECREF(gca_kwargs);
+
+  PyObject *plot3 = PyObject_GetAttrString(axis, "scatter");
+  if (!plot3) throw std::runtime_error("No 3D line plot");
+  Py_INCREF(plot3);
+  PyObject *res = PyObject_Call(plot3, args, kwargs);
+  if (!res) throw std::runtime_error("Failed 3D line plot");
+  Py_DECREF(plot3);
+
+  Py_DECREF(axis);
+  Py_DECREF(args);
+  Py_DECREF(kwargs);
+  Py_DECREF(fig);
+  if (res) Py_DECREF(res);
+  return res;
+
+}
+
 template<typename Numeric>
 bool boxplot(const std::vector<std::vector<Numeric>>& data,
              const std::vector<std::string>& labels = {},
@@ -1139,9 +1267,9 @@ bool contour(const std::vector<NumericX>& x, const std::vector<NumericY>& y,
              const std::map<std::string, std::string>& keywords = {}) {
     assert(x.size() == y.size() && x.size() == z.size());
 
-    PyObject* xarray = get_array(x);
-    PyObject* yarray = get_array(y);
-    PyObject* zarray = get_array(z);
+    PyObject* xarray = detail::get_array(x);
+    PyObject* yarray = detail::get_array(y);
+    PyObject* zarray = detail::get_array(z);
 
     PyObject* plot_args = PyTuple_New(3);
     PyTuple_SetItem(plot_args, 0, xarray);
@@ -2094,12 +2222,14 @@ inline void axvspan(double xmin, double xmax, double ymin = 0., double ymax = 1.
 
     // construct keyword args
     PyObject* kwargs = PyDict_New();
-    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
-    {
-    if (it->first == "linewidth" || it->first == "alpha")
-            PyDict_SetItemString(kwargs, it->first.c_str(), PyFloat_FromDouble(std::stod(it->second)));
-    else
-            PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+      if (it->first == "linewidth" || it->first == "alpha") {
+        PyDict_SetItemString(kwargs, it->first.c_str(),
+          PyFloat_FromDouble(std::stod(it->second)));
+      } else {
+        PyDict_SetItemString(kwargs, it->first.c_str(),
+          PyString_FromString(it->second.c_str()));
+      }
     }
 
     PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axvspan, args, kwargs);
@@ -2319,6 +2449,25 @@ inline void save(const std::string& filename)
     Py_DECREF(res);
 }
 
+inline void rcparams(const std::map<std::string, std::string>& keywords = {}) {
+    detail::_interpreter::get();
+    PyObject* args = PyTuple_New(0);
+    PyObject* kwargs = PyDict_New();
+    for (auto it = keywords.begin(); it != keywords.end(); ++it) {
+        if ("text.usetex" == it->first)
+          PyDict_SetItemString(kwargs, it->first.c_str(), PyLong_FromLong(std::stoi(it->second.c_str())));
+        else PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    }
+    
+    PyObject * update = PyObject_GetAttrString(detail::_interpreter::get().s_python_function_rcparams, "update");
+    PyObject * res = PyObject_Call(update, args, kwargs);
+    if(!res) throw std::runtime_error("Call to rcParams.update() failed.");
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+    Py_DECREF(update);
+    Py_DECREF(res);
+}
+
 inline void clf() {
     detail::_interpreter::get();
 

From d1b7c72be8b9c3cb28bfc565a0975117414be3e5 Mon Sep 17 00:00:00 2001
From: Alex <leha-bot@users.noreply.github.com>
Date: Fri, 28 Aug 2020 19:43:50 +0300
Subject: [PATCH 70/86] Add #include <string> for std::stod

See https://en.cppreference.com/w/cpp/string/basic_string/stof for details.
---
 matplotlibcpp.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 226a16a..b3d57f7 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -13,6 +13,7 @@
 #include <iostream>
 #include <cstdint> // <cstdint> requires c++11 support
 #include <functional>
+#include <string> // std::stod
 
 #ifndef WITHOUT_NUMPY
 #  define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION

From 2bf4f26d727cc164e309122fb29f3fb733c087f2 Mon Sep 17 00:00:00 2001
From: William Leong <tsllwl@nus.edu.sg>
Date: Fri, 2 Oct 2020 15:48:08 +0800
Subject: [PATCH 71/86] Fix #221 and #225

---
 matplotlibcpp.h | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index b3d57f7..18d83b8 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -176,7 +176,12 @@ struct _interpreter {
         wchar_t const *dummy_args[] = {L"Python", NULL};  // const is needed because literals must not be modified
         wchar_t const **argv = dummy_args;
         int             argc = sizeof(dummy_args)/sizeof(dummy_args[0])-1;
+
+#if PY_MAJOR_VERSION >= 3
         PySys_SetArgv(argc, const_cast<wchar_t **>(argv));
+#else
+        PySys_SetArgv(argc, (char **)(argv));
+#endif
 
 #ifndef WITHOUT_NUMPY
         import_numpy(); // initialize numpy C-API
@@ -362,7 +367,7 @@ PyObject* get_array(const std::vector<Numeric>& v)
         PyArray_UpdateFlags(reinterpret_cast<PyArrayObject*>(varray), NPY_ARRAY_OWNDATA);
         return varray;
     }
-    
+
     PyObject* varray = PyArray_SimpleNewFromData(1, &vsize, type, (void*)(v.data()));
     return varray;
 }
@@ -429,7 +434,7 @@ PyObject* get_listlist(const std::vector<std::vector<Numeric>>& ll)
 } // namespace detail
 
 /// Plot a line through the given x and y data points..
-/// 
+///
 /// See: https://matplotlib.org/3.2.1/api/_as_gen/matplotlib.pyplot.plot.html
 template<typename Numeric>
 bool plot(const std::vector<Numeric> &x, const std::vector<Numeric> &y, const std::map<std::string, std::string>& keywords)
@@ -587,9 +592,9 @@ void plot3(const std::vector<Numeric> &x,
 {
   detail::_interpreter::get();
 
-  // Same as with plot_surface: We lazily load the modules here the first time 
-  // this function is called because I'm not sure that we can assume "matplotlib 
-  // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
+  // Same as with plot_surface: We lazily load the modules here the first time
+  // this function is called because I'm not sure that we can assume "matplotlib
+  // installed" implies "mpl_toolkits installed" on all platforms, and we don't
   // want to require it for people who don't need 3d plots.
   static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
   if (!mpl_toolkitsmod) {
@@ -1849,7 +1854,7 @@ inline void legend(const std::map<std::string, std::string>& keywords)
   if(!res) throw std::runtime_error("Call to legend() failed.");
 
   Py_DECREF(kwargs);
-  Py_DECREF(res);  
+  Py_DECREF(res);
 }
 
 template<typename Numeric>
@@ -2089,7 +2094,7 @@ inline void tick_params(const std::map<std::string, std::string>& keywords, cons
 inline void subplot(long nrows, long ncols, long plot_number)
 {
     detail::_interpreter::get();
-    
+
     // construct positional args
     PyObject* args = PyTuple_New(3);
     PyTuple_SetItem(args, 0, PyFloat_FromDouble(nrows));
@@ -2154,7 +2159,7 @@ inline void title(const std::string &titlestr, const std::map<std::string, std::
 inline void suptitle(const std::string &suptitlestr, const std::map<std::string, std::string> &keywords = {})
 {
     detail::_interpreter::get();
-    
+
     PyObject* pysuptitlestr = PyString_FromString(suptitlestr.c_str());
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pysuptitlestr);
@@ -2286,9 +2291,9 @@ inline void set_zlabel(const std::string &str, const std::map<std::string, std::
 {
     detail::_interpreter::get();
 
-    // Same as with plot_surface: We lazily load the modules here the first time 
-    // this function is called because I'm not sure that we can assume "matplotlib 
-    // installed" implies "mpl_toolkits installed" on all platforms, and we don't 
+    // Same as with plot_surface: We lazily load the modules here the first time
+    // this function is called because I'm not sure that we can assume "matplotlib
+    // installed" implies "mpl_toolkits installed" on all platforms, and we don't
     // want to require it for people who don't need 3d plots.
     static PyObject *mpl_toolkitsmod = nullptr, *axis3dmod = nullptr;
     if (!mpl_toolkitsmod) {

From 3af24b418200a5515c34a475673f559e8718dfff Mon Sep 17 00:00:00 2001
From: "raphael.viards@magellium.fr" <raphael.viards@magellium.fr>
Date: Fri, 27 Nov 2020 17:23:34 +0100
Subject: [PATCH 72/86] Adding possibility to choose dpi when saving

---
 matplotlibcpp.h | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 18d83b8..a7318f5 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -2439,7 +2439,7 @@ inline void pause(Numeric interval)
     Py_DECREF(res);
 }
 
-inline void save(const std::string& filename)
+inline void save(const std::string& filename, const int dpi=0)
 {
     detail::_interpreter::get();
 
@@ -2448,10 +2448,18 @@ inline void save(const std::string& filename)
     PyObject* args = PyTuple_New(1);
     PyTuple_SetItem(args, 0, pyfilename);
 
-    PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_save, args);
+    PyObject* kwargs = PyDict_New();
+
+    if(dpi > 0)
+    {
+        PyDict_SetItemString(kwargs, "dpi", PyLong_FromLong(dpi));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_save, args, kwargs);
     if (!res) throw std::runtime_error("Call to save() failed.");
 
     Py_DECREF(args);
+    Py_DECREF(kwargs);
     Py_DECREF(res);
 }
 

From 490fa9cda0b8ce39dbb900836c4fb1c0296ac7c0 Mon Sep 17 00:00:00 2001
From: Alex Dewar <a.dewar@sussex.ac.uk>
Date: Fri, 19 Feb 2021 14:12:14 +0000
Subject: [PATCH 73/86] Fix memory leaks in xlim() and ylim()

Memory is allocated with new and delete is never called. Use a std::array instead, so no memory will be allocated.
---
 matplotlibcpp.h | 30 ++++++++++--------------------
 1 file changed, 10 insertions(+), 20 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index a7318f5..643a120 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1896,43 +1896,33 @@ void xlim(Numeric left, Numeric right)
 }
 
 
-inline double* xlim()
+inline std::array<double, 2> xlim()
 {
-    detail::_interpreter::get();
-
     PyObject* args = PyTuple_New(0);
     PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_xlim, args);
-    PyObject* left = PyTuple_GetItem(res,0);
-    PyObject* right = PyTuple_GetItem(res,1);
-
-    double* arr = new double[2];
-    arr[0] = PyFloat_AsDouble(left);
-    arr[1] = PyFloat_AsDouble(right);
 
     if(!res) throw std::runtime_error("Call to xlim() failed.");
 
     Py_DECREF(res);
-    return arr;
+
+    PyObject* left = PyTuple_GetItem(res,0);
+    PyObject* right = PyTuple_GetItem(res,1);
+    return { PyFloat_AsDouble(left), PyFloat_AsDouble(right) };
 }
 
 
-inline double* ylim()
+inline std::array<double, 2> ylim()
 {
-    detail::_interpreter::get();
-
     PyObject* args = PyTuple_New(0);
     PyObject* res = PyObject_CallObject(detail::_interpreter::get().s_python_function_ylim, args);
-    PyObject* left = PyTuple_GetItem(res,0);
-    PyObject* right = PyTuple_GetItem(res,1);
-
-    double* arr = new double[2];
-    arr[0] = PyFloat_AsDouble(left);
-    arr[1] = PyFloat_AsDouble(right);
 
     if(!res) throw std::runtime_error("Call to ylim() failed.");
 
     Py_DECREF(res);
-    return arr;
+
+    PyObject* left = PyTuple_GetItem(res,0);
+    PyObject* right = PyTuple_GetItem(res,1);
+    return { PyFloat_AsDouble(left), PyFloat_AsDouble(right) };
 }
 
 template<typename Numeric>

From 08ff087d5ec3bfb5066335e7300e40e56b09aefb Mon Sep 17 00:00:00 2001
From: Florian Fervers <florian.fervers@gmail.com>
Date: Wed, 10 Feb 2021 17:37:13 +0100
Subject: [PATCH 74/86] Add modern cmake support

---
 CMakeLists.txt                      | 125 ++++++++++++++++++++++++++++
 cmake/matplotlib_cppConfig.cmake.in |   7 ++
 2 files changed, 132 insertions(+)
 create mode 100644 CMakeLists.txt
 create mode 100644 cmake/matplotlib_cppConfig.cmake.in

diff --git a/CMakeLists.txt b/CMakeLists.txt
new file mode 100644
index 0000000..4e1ef89
--- /dev/null
+++ b/CMakeLists.txt
@@ -0,0 +1,125 @@
+cmake_minimum_required(VERSION 3.8 FATAL_ERROR)
+project(matplotlib_cpp LANGUAGES CXX)
+
+include(GNUInstallDirs)
+set(PACKAGE_NAME matplotlib_cpp)
+set(INSTALL_CONFIGDIR ${CMAKE_INSTALL_LIBDIR}/${PACKAGE_NAME}/cmake)
+
+
+# Library target
+add_library(matplotlib_cpp INTERFACE)
+target_include_directories(matplotlib_cpp
+  INTERFACE
+    $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/examples>
+    $<INSTALL_INTERFACE:include>
+)
+target_compile_features(matplotlib_cpp INTERFACE
+  cxx_std_11
+)
+find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
+target_link_libraries(matplotlib_cpp INTERFACE
+  Python3::Python
+  Python3::Module
+)
+find_package(Python3 COMPONENTS NumPy)
+if(Python3_NumPy_FOUND)
+  target_link_libraries(matplotlib_cpp INTERFACE
+    Python3::NumPy
+  )
+else()
+  target_compile_definitions(matplotlib_cpp INTERFACE WITHOUT_NUMPY)
+endif()
+install(
+  TARGETS matplotlib_cpp
+  EXPORT install_targets
+)
+
+
+# Examples
+add_executable(minimal examples/minimal.cpp)
+target_link_libraries(minimal PRIVATE matplotlib_cpp)
+set_target_properties(minimal PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(basic examples/basic.cpp)
+target_link_libraries(basic PRIVATE matplotlib_cpp)
+set_target_properties(basic PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(modern examples/modern.cpp)
+target_link_libraries(modern PRIVATE matplotlib_cpp)
+set_target_properties(modern PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(animation examples/animation.cpp)
+target_link_libraries(animation PRIVATE matplotlib_cpp)
+set_target_properties(animation PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(nonblock examples/nonblock.cpp)
+target_link_libraries(nonblock PRIVATE matplotlib_cpp)
+set_target_properties(nonblock PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(xkcd examples/xkcd.cpp)
+target_link_libraries(xkcd PRIVATE matplotlib_cpp)
+set_target_properties(xkcd PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(bar examples/bar.cpp)
+target_link_libraries(bar PRIVATE matplotlib_cpp)
+set_target_properties(bar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(fill_inbetween examples/fill_inbetween.cpp)
+target_link_libraries(fill_inbetween PRIVATE matplotlib_cpp)
+set_target_properties(fill_inbetween PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(fill examples/fill.cpp)
+target_link_libraries(fill PRIVATE matplotlib_cpp)
+set_target_properties(fill PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(update examples/update.cpp)
+target_link_libraries(update PRIVATE matplotlib_cpp)
+set_target_properties(update PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(subplot2grid examples/subplot2grid.cpp)
+target_link_libraries(subplot2grid PRIVATE matplotlib_cpp)
+set_target_properties(subplot2grid PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(lines3d examples/lines3d.cpp)
+target_link_libraries(lines3d PRIVATE matplotlib_cpp)
+set_target_properties(lines3d PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+if(Python3_NumPy_FOUND)
+  add_executable(surface examples/surface.cpp)
+  target_link_libraries(surface PRIVATE matplotlib_cpp)
+  set_target_properties(surface PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+  add_executable(colorbar examples/colorbar.cpp)
+  target_link_libraries(colorbar PRIVATE matplotlib_cpp)
+  set_target_properties(colorbar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+endif()
+
+
+# Install headers
+install(FILES
+  "${PROJECT_SOURCE_DIR}/matplotlibcpp.h"
+  DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+
+
+# Install targets file
+install(EXPORT install_targets
+  FILE
+    ${PACKAGE_NAME}Targets.cmake
+  NAMESPACE
+    ${PACKAGE_NAME}::
+  DESTINATION
+    ${INSTALL_CONFIGDIR}
+)
+
+
+# Install matplotlib_cppConfig.cmake
+include(CMakePackageConfigHelpers)
+configure_package_config_file(
+  ${CMAKE_CURRENT_SOURCE_DIR}/cmake/${PACKAGE_NAME}Config.cmake.in
+  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
+  INSTALL_DESTINATION ${INSTALL_CONFIGDIR}
+)
+install(FILES
+  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
+  DESTINATION ${INSTALL_CONFIGDIR}
+)
diff --git a/cmake/matplotlib_cppConfig.cmake.in b/cmake/matplotlib_cppConfig.cmake.in
new file mode 100644
index 0000000..1793f29
--- /dev/null
+++ b/cmake/matplotlib_cppConfig.cmake.in
@@ -0,0 +1,7 @@
+get_filename_component(matplotlib_cpp_CMAKE_DIR "${CMAKE_CURRENT_LIST_FILE}" PATH)
+
+if(NOT TARGET matplotlib_cpp::matplotlib_cpp)
+  find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
+  find_package(Python3 COMPONENTS NumPy)
+  include("${matplotlib_cpp_CMAKE_DIR}/matplotlib_cppTargets.cmake")
+endif()

From 3d3f9da65108e17c19799805786bb81e0776ea0f Mon Sep 17 00:00:00 2001
From: Benno Evers <benno@L>
Date: Fri, 26 Mar 2021 10:30:33 +0100
Subject: [PATCH 75/86] Unbreak examples by moving 'fig_number' paramter to the
 end of the list

---
 matplotlibcpp.h | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 643a120..9363b71 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -475,9 +475,9 @@ template <typename Numeric>
 void plot_surface(const std::vector<::std::vector<Numeric>> &x,
                   const std::vector<::std::vector<Numeric>> &y,
                   const std::vector<::std::vector<Numeric>> &z,
-                  const long fig_number=0,
                   const std::map<std::string, std::string> &keywords =
-                      std::map<std::string, std::string>())
+                      std::map<std::string, std::string>(),
+                  const long fig_number=0)
 {
   detail::_interpreter::get();
 
@@ -586,9 +586,9 @@ template <typename Numeric>
 void plot3(const std::vector<Numeric> &x,
                   const std::vector<Numeric> &y,
                   const std::vector<Numeric> &z,
-                  const long fig_number=0,
                   const std::map<std::string, std::string> &keywords =
-                      std::map<std::string, std::string>())
+                      std::map<std::string, std::string>(),
+                  const long fig_number=0)
 {
   detail::_interpreter::get();
 
@@ -953,8 +953,8 @@ bool scatter(const std::vector<NumericX>& x,
              const std::vector<NumericY>& y,
              const std::vector<NumericZ>& z,
              const double s=1.0, // The marker size in points**2
-             const long fig_number=0,
-             const std::map<std::string, std::string> & keywords = {}) {
+             const std::map<std::string, std::string> & keywords = {},
+             const long fig_number=0) {
   detail::_interpreter::get();
 
   // Same as with plot_surface: We lazily load the modules here the first time 

From cab80f33cd137dca50b98fe4ccb830d7e657721d Mon Sep 17 00:00:00 2001
From: Benno Evers <benno@L>
Date: Fri, 26 Mar 2021 10:40:39 +0100
Subject: [PATCH 76/86] Remove obsoleted build systems

After the switch to cmake, we don't need the hand-written Makefile
nor the contrib/ version of the cmake file.
---
 Makefile               | 41 ---------------------------------
 README.md              | 52 +++++++++++++++---------------------------
 contrib/CMakeLists.txt | 26 ---------------------
 numpy_flags.py         | 12 ----------
 4 files changed, 18 insertions(+), 113 deletions(-)
 delete mode 100644 Makefile
 delete mode 100644 contrib/CMakeLists.txt
 delete mode 100644 numpy_flags.py

diff --git a/Makefile b/Makefile
deleted file mode 100644
index 67b5ac3..0000000
--- a/Makefile
+++ /dev/null
@@ -1,41 +0,0 @@
-# Use C++11, dont warn on long-to-float conversion
-CXXFLAGS += -std=c++11 -Wno-conversion
-
-# Default to using system's default version of python
-PYTHON_BIN     ?= python3
-PYTHON_CONFIG  := $(PYTHON_BIN)-config
-PYTHON_INCLUDE ?= $(shell $(PYTHON_CONFIG) --includes)
-EXTRA_FLAGS    := $(PYTHON_INCLUDE)
-# NOTE: Since python3.8, the correct invocation is `python3-config --libs --embed`.
-# So of course the proper way to get python libs for embedding now is to
-# invoke that, check if it crashes, and fall back to just `--libs` if it does.
-LDFLAGS        += $(shell if $(PYTHON_CONFIG) --ldflags --embed >/dev/null; then $(PYTHON_CONFIG) --ldflags --embed; else $(PYTHON_CONFIG) --ldflags; fi)
-
-# Either finds numpy or set -DWITHOUT_NUMPY
-EXTRA_FLAGS     += $(shell $(PYTHON_BIN) $(CURDIR)/numpy_flags.py)
-WITHOUT_NUMPY   := $(findstring $(EXTRA_FLAGS), WITHOUT_NUMPY)
-
-# Examples requiring numpy support to compile
-EXAMPLES_NUMPY  := surface colorbar
-EXAMPLES        := minimal basic modern animation nonblock xkcd quiver bar \
-	           fill_inbetween fill update subplot2grid lines3d \
-                   $(if $(WITHOUT_NUMPY),,$(EXAMPLES_NUMPY))
-
-# Prefix every example with 'examples/build/'
-EXAMPLE_TARGETS := $(patsubst %,examples/build/%,$(EXAMPLES))
-
-.PHONY: examples
-
-examples: $(EXAMPLE_TARGETS)
-
-docs:
-	doxygen
-	moxygen doc/xml --noindex -o doc/api.md
-
-# Assume every *.cpp file is a separate example
-$(EXAMPLE_TARGETS): examples/build/%: examples/%.cpp matplotlibcpp.h
-	mkdir -p examples/build
-	$(CXX) -o $@ $< $(EXTRA_FLAGS) $(CXXFLAGS) $(LDFLAGS)
-
-clean:
-	rm -f ${EXAMPLE_TARGETS}
diff --git a/README.md b/README.md
index 61ffef4..0f8479f 100644
--- a/README.md
+++ b/README.md
@@ -202,39 +202,34 @@ If, for some reason, you're unable to get a working installation of numpy on you
 you can define the macro `WITHOUT_NUMPY` before including the header file to erase this
 dependency.
 
-The C++-part of the library consists of the single header file `matplotlibcpp.h` which can be placed
-anywhere.
+The C++-part of the library consists of the single header file `matplotlibcpp.h` which
+can be placed anywhere.
 
-Since a python interpreter is opened internally, it is necessary to link against `libpython` in order
-to user matplotlib-cpp. Most versions should work, although `libpython2.7` and `libpython3.6` are
-probably the most regularly testedr.
+Since a python interpreter is opened internally, it is necessary to link
+against `libpython` in order to user matplotlib-cpp. Most versions should
+work, although python likes to randomly break compatibility from time to time
+so some caution is advised when using the bleeding edge.
 
 
 # CMake
 
-If you prefer to use CMake as build system, you will want to add something like this to your
-CMakeLists.txt:
+The C++ code is compatible to both python2 and python3. However, the `CMakeLists.txt`
+file is currently set up to use python3 by default, so if python2 is required this
+has to be changed manually. (a PR that adds a cmake option for this would be highly
+welcomed)
 
-**Recommended way (since CMake 3.12):**
+**NOTE**: By design (of python), only a single python interpreter can be created per
+process. When using this library, *no other* library that is spawning a python
+interpreter internally can be used.
 
-It's easy to use cmake official [docs](https://cmake.org/cmake/help/git-stage/module/FindPython2.html#module:FindPython2) to find Python 2(or 3) interpreter, compiler and development environment (include directories and libraries).
+To compile the code without using cmake, the compiler invocation should look like
+this:
 
-NumPy is optional here, delete it from cmake script, if you don't need it.
+    g++ example.cpp -I/usr/include/python2.7 -lpython2.7
 
-```cmake
-find_package(Python2 COMPONENTS Development NumPy)
-target_include_directories(myproject PRIVATE ${Python2_INCLUDE_DIRS} ${Python2_NumPy_INCLUDE_DIRS})
-target_link_libraries(myproject Python2::Python Python2::NumPy)
-```
-
-**Alternative way (for CMake <= 3.11):**
-
-```cmake
-find_package(PythonLibs 2.7)
-target_include_directories(myproject PRIVATE ${PYTHON_INCLUDE_DIRS})
-target_link_libraries(myproject ${PYTHON_LIBRARIES})
-```
+This can also be used for linking against a custom build of python
 
+    g++ example.cpp -I/usr/local/include/fancy-python4 -L/usr/local/lib -lfancy-python4
 
 # Vcpkg
 
@@ -258,17 +253,6 @@ Note that support for c++98 was dropped more or less accidentally, so if you hav
 with an ancient compiler and still want to enjoy the latest additional features, I'd
 probably merge a PR that restores support.
 
-# Python 3
-
-This library supports both python2 and python3 (although the python3 support is probably far less tested,
-so it is recommended to prefer python2.7). To switch the used python version, simply change
-the compiler flags accordingly.
-
-    g++ example.cpp -I/usr/include/python3.6 -lpython3.6
-
-The same technique can be used for linking against a custom build of python
-
-    g++ example.cpp -I/usr/local/include/fancy-python4 -L/usr/local/lib -lfancy-python4
 
 
 Why?
diff --git a/contrib/CMakeLists.txt b/contrib/CMakeLists.txt
deleted file mode 100644
index edb40b1..0000000
--- a/contrib/CMakeLists.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-cmake_minimum_required(VERSION 3.7)
-project (MatplotlibCPP_Test)
-
-set(CMAKE_CXX_STANDARD 11)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-
-include_directories(${PYTHONHOME}/include)
-include_directories(${PYTHONHOME}/Lib/site-packages/numpy/core/include)
-link_directories(${PYTHONHOME}/libs)
-
-add_definitions(-DMATPLOTLIBCPP_PYTHON_HEADER=Python.h)
-
-# message(STATUS "*** dump start cmake variables ***")
-# get_cmake_property(_variableNames VARIABLES)
-# foreach(_variableName ${_variableNames})
-#         message(STATUS "${_variableName}=${${_variableName}}")
-# endforeach()
-# message(STATUS "*** dump end ***")
-
-add_executable(minimal ${CMAKE_CURRENT_SOURCE_DIR}/../examples/minimal.cpp)
-add_executable(basic ${CMAKE_CURRENT_SOURCE_DIR}/../examples/basic.cpp)
-add_executable(modern ${CMAKE_CURRENT_SOURCE_DIR}/../examples/modern.cpp)
-add_executable(animation ${CMAKE_CURRENT_SOURCE_DIR}/../examples/animation.cpp)
-add_executable(nonblock ${CMAKE_CURRENT_SOURCE_DIR}/../examples/nonblock.cpp)
-add_executable(xkcd ${CMAKE_CURRENT_SOURCE_DIR}/../examples/xkcd.cpp)
-add_executable(bar ${CMAKE_CURRENT_SOURCE_DIR}/../examples/bar.cpp)
diff --git a/numpy_flags.py b/numpy_flags.py
deleted file mode 100644
index 56fd95c..0000000
--- a/numpy_flags.py
+++ /dev/null
@@ -1,12 +0,0 @@
-from os import path
-
-try:
-    from numpy import __file__ as numpyloc
-
-    # Get numpy directory
-    numpy_dir = path.dirname(numpyloc)
-
-    # Print the result of joining this to core and include
-    print("-I" + path.join(numpy_dir, "core", "include"))
-except:
-    print("-DWITHOUT_NUMPY")

From 1875696c55c1ae0ae93546f738fbf0047ffa6190 Mon Sep 17 00:00:00 2001
From: Pierre Narvor <pierre.narvor@ensta-bretagne.fr>
Date: Wed, 31 Mar 2021 15:16:49 +0200
Subject: [PATCH 77/86] Added 'set_aspect' and set_aspect_equal function

---
 examples/modern.cpp |  3 +++
 matplotlibcpp.h     | 56 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 59 insertions(+)

diff --git a/examples/modern.cpp b/examples/modern.cpp
index a8aa0c7..871ef2b 100644
--- a/examples/modern.cpp
+++ b/examples/modern.cpp
@@ -24,6 +24,9 @@ int main()
 	// y must either be callable (providing operator() const) or iterable. 
 	plt::plot(x, y, "r-", x, [](double d) { return 12.5+abs(sin(d)); }, "k-");
 
+	//plt::set_aspect(0.5);
+	plt::set_aspect_equal();
+
 
 	// show plots
 	plt::show();
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 9363b71..a151d6f 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1857,6 +1857,62 @@ inline void legend(const std::map<std::string, std::string>& keywords)
   Py_DECREF(res);
 }
 
+template<typename Numeric>
+inline void set_aspect(Numeric ratio)
+{
+    detail::_interpreter::get();
+
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(ratio));
+    PyObject* kwargs = PyDict_New();
+
+    PyObject *ax =
+    PyObject_CallObject(detail::_interpreter::get().s_python_function_gca,
+      detail::_interpreter::get().s_python_empty_tuple);
+    if (!ax) throw std::runtime_error("Call to gca() failed.");
+    Py_INCREF(ax);
+
+    PyObject *set_aspect = PyObject_GetAttrString(ax, "set_aspect");
+    if (!set_aspect) throw std::runtime_error("Attribute set_aspect not found.");
+    Py_INCREF(set_aspect);
+
+    PyObject *res = PyObject_Call(set_aspect, args, kwargs);
+    if (!res) throw std::runtime_error("Call to set_aspect() failed.");
+    Py_DECREF(set_aspect);
+
+    Py_DECREF(ax);
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+}
+
+inline void set_aspect_equal()
+{
+    // expect ratio == "equal". Leaving error handling to matplotlib.
+    detail::_interpreter::get();
+
+    PyObject* args = PyTuple_New(1);
+    PyTuple_SetItem(args, 0, PyString_FromString("equal"));
+    PyObject* kwargs = PyDict_New();
+
+    PyObject *ax =
+    PyObject_CallObject(detail::_interpreter::get().s_python_function_gca,
+      detail::_interpreter::get().s_python_empty_tuple);
+    if (!ax) throw std::runtime_error("Call to gca() failed.");
+    Py_INCREF(ax);
+
+    PyObject *set_aspect = PyObject_GetAttrString(ax, "set_aspect");
+    if (!set_aspect) throw std::runtime_error("Attribute set_aspect not found.");
+    Py_INCREF(set_aspect);
+
+    PyObject *res = PyObject_Call(set_aspect, args, kwargs);
+    if (!res) throw std::runtime_error("Call to set_aspect() failed.");
+    Py_DECREF(set_aspect);
+
+    Py_DECREF(ax);
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+}
+
 template<typename Numeric>
 void ylim(Numeric left, Numeric right)
 {

From ec3745302a8295e3d7b28f910fb1a39936886a40 Mon Sep 17 00:00:00 2001
From: Cryoris <jules.gacon@googlemail.com>
Date: Sat, 23 May 2020 17:10:42 +0200
Subject: [PATCH 78/86] add axhline

---
 matplotlibcpp.h | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index a151d6f..f6365cb 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -75,6 +75,7 @@ struct _interpreter {
     PyObject *s_python_function_ylim;
     PyObject *s_python_function_title;
     PyObject *s_python_function_axis;
+    PyObject *s_python_function_axhline;
     PyObject *s_python_function_axvline;
     PyObject *s_python_function_axvspan;
     PyObject *s_python_function_xlabel;
@@ -247,6 +248,7 @@ struct _interpreter {
         s_python_function_ylim = safe_import(pymod, "ylim");
         s_python_function_title = safe_import(pymod, "title");
         s_python_function_axis = safe_import(pymod, "axis");
+        s_python_function_axhline = safe_import(pymod, "axhline");
         s_python_function_axvline = safe_import(pymod, "axvline");
         s_python_function_axvspan = safe_import(pymod, "axvspan");
         s_python_function_xlabel = safe_import(pymod, "xlabel");
@@ -2238,6 +2240,31 @@ inline void axis(const std::string &axisstr)
     Py_DECREF(res);
 }
 
+inline void axhline(double y, double xmin = 0., double xmax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
+{
+    detail::_interpreter::get();
+
+    // construct positional args
+    PyObject* args = PyTuple_New(3);
+    PyTuple_SetItem(args, 0, PyFloat_FromDouble(y));
+    PyTuple_SetItem(args, 1, PyFloat_FromDouble(xmin));
+    PyTuple_SetItem(args, 2, PyFloat_FromDouble(xmax));
+
+    // construct keyword args
+    PyObject* kwargs = PyDict_New();
+    for(std::map<std::string, std::string>::const_iterator it = keywords.begin(); it != keywords.end(); ++it)
+    {
+        PyDict_SetItemString(kwargs, it->first.c_str(), PyString_FromString(it->second.c_str()));
+    }
+
+    PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_axhline, args, kwargs);
+
+    Py_DECREF(args);
+    Py_DECREF(kwargs);
+
+    if(res) Py_DECREF(res);
+}
+
 inline void axvline(double x, double ymin = 0., double ymax = 1., const std::map<std::string, std::string>& keywords = std::map<std::string, std::string>())
 {
     detail::_interpreter::get();

From bbfb240ba80e9cb890a0c4dc259552ee8b235854 Mon Sep 17 00:00:00 2001
From: Cryoris <jules.gacon@googlemail.com>
Date: Sat, 23 May 2020 17:34:06 +0200
Subject: [PATCH 79/86] add contour plot

---
 examples/contour.cpp | 24 ++++++++++++++++++++
 matplotlibcpp.h      | 54 +++++++++++++++++++++++++++++++++++++++-----
 2 files changed, 72 insertions(+), 6 deletions(-)
 create mode 100644 examples/contour.cpp

diff --git a/examples/contour.cpp b/examples/contour.cpp
new file mode 100644
index 0000000..9289d0a
--- /dev/null
+++ b/examples/contour.cpp
@@ -0,0 +1,24 @@
+#include "../matplotlibcpp.h"
+
+#include <cmath>
+
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    std::vector<std::vector<double>> x, y, z;
+    for (double i = -5; i <= 5;  i += 0.25) {
+        std::vector<double> x_row, y_row, z_row;
+        for (double j = -5; j <= 5; j += 0.25) {
+            x_row.push_back(i);
+            y_row.push_back(j);
+            z_row.push_back(::std::sin(::std::hypot(i, j)));
+        }
+        x.push_back(x_row);
+        y.push_back(y_row);
+        z.push_back(z_row);
+    }
+
+    plt::contour(x, y, z);
+    plt::show();
+}
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index f6365cb..abf0284 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -103,7 +103,6 @@ struct _interpreter {
     PyObject *s_python_function_subplots_adjust;
     PyObject *s_python_function_rcparams;
 
-
     /* For now, _interpreter is implemented as a singleton since its currently not possible to have
        multiple independent embedded python interpreters without patching the python source code
        or starting a separate process for each. [1]
@@ -245,6 +244,7 @@ struct _interpreter {
         s_python_function_subplot = safe_import(pymod, "subplot");
         s_python_function_subplot2grid = safe_import(pymod, "subplot2grid");
         s_python_function_legend = safe_import(pymod, "legend");
+        s_python_function_xlim = safe_import(pymod, "xlim");
         s_python_function_ylim = safe_import(pymod, "ylim");
         s_python_function_title = safe_import(pymod, "title");
         s_python_function_axis = safe_import(pymod, "axis");
@@ -259,7 +259,6 @@ struct _interpreter {
         s_python_function_margins = safe_import(pymod, "margins");
         s_python_function_tick_params = safe_import(pymod, "tick_params");
         s_python_function_grid = safe_import(pymod, "grid");
-        s_python_function_xlim = safe_import(pymod, "xlim");
         s_python_function_ion = safe_import(pymod, "ion");
         s_python_function_ginput = safe_import(pymod, "ginput");
         s_python_function_save = safe_import(pylabmod, "savefig");
@@ -349,10 +348,10 @@ template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY
 
 // Sanity checks; comment them out or change the numpy type below if you're compiling on
 // a platform where they don't apply
-static_assert(sizeof(long long) == 8);
-template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
-static_assert(sizeof(unsigned long long) == 8);
-template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
+// static_assert(sizeof(long long) == 8);
+// template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
+// static_assert(sizeof(unsigned long long) == 8);
+// template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
 // TODO: add int, long, etc.
 
 template<typename Numeric>
@@ -582,6 +581,49 @@ void plot_surface(const std::vector<::std::vector<Numeric>> &x,
   Py_DECREF(kwargs);
   if (res) Py_DECREF(res);
 }
+
+template <typename Numeric>
+void contour(const std::vector<::std::vector<Numeric>> &x,
+             const std::vector<::std::vector<Numeric>> &y,
+             const std::vector<::std::vector<Numeric>> &z,
+             const std::map<std::string, std::string> &keywords = {})
+{
+  detail::_interpreter::get();
+
+  // using numpy arrays
+  PyObject *xarray = detail::get_2darray(x);
+  PyObject *yarray = detail::get_2darray(y);
+  PyObject *zarray = detail::get_2darray(z);
+
+  // construct positional args
+  PyObject *args = PyTuple_New(3);
+  PyTuple_SetItem(args, 0, xarray);
+  PyTuple_SetItem(args, 1, yarray);
+  PyTuple_SetItem(args, 2, zarray);
+
+  // Build up the kw args.
+  PyObject *kwargs = PyDict_New();
+
+  PyObject *python_colormap_coolwarm = PyObject_GetAttrString(
+      detail::_interpreter::get().s_python_colormap, "coolwarm");
+
+  PyDict_SetItemString(kwargs, "cmap", python_colormap_coolwarm);
+
+  for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
+       it != keywords.end(); ++it) {
+    PyDict_SetItemString(kwargs, it->first.c_str(),
+                         PyString_FromString(it->second.c_str()));
+  }
+
+  PyObject *res = PyObject_Call(detail::_interpreter::get().s_python_function_contour, args, kwargs);
+  if (!res)
+    throw std::runtime_error("failed contour");
+
+  Py_DECREF(args);
+  Py_DECREF(kwargs);
+  if (res)
+    Py_DECREF(res);
+}
 #endif // WITHOUT_NUMPY
 
 template <typename Numeric>

From 9ff7a4b29db0ef27da0136a9e6930d385b93fe50 Mon Sep 17 00:00:00 2001
From: Cryoris <jules.gacon@googlemail.com>
Date: Sat, 23 May 2020 18:40:22 +0200
Subject: [PATCH 80/86] add spy

---
 examples/spy.cpp | 29 +++++++++++++++++++++++++++++
 matplotlibcpp.h  | 45 ++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 67 insertions(+), 7 deletions(-)
 create mode 100644 examples/spy.cpp

diff --git a/examples/spy.cpp b/examples/spy.cpp
new file mode 100644
index 0000000..80bd544
--- /dev/null
+++ b/examples/spy.cpp
@@ -0,0 +1,29 @@
+#import <iostream>
+#import <vector>
+#import "../matplotlibcpp.h"
+
+namespace plt = matplotlibcpp;
+
+int main()
+{
+    const int n = 20;
+    std::vector<std::vector<double>> matrix;
+
+    for (int i = 0; i < n; ++i) {
+        std::vector<double> row;
+        for (int j = 0; j < n; ++j) {
+            if (i == j)
+                row.push_back(-2);
+            else if (j == i - 1 || j == i + 1)
+                row.push_back(1);
+            else
+                row.push_back(0);
+        }
+        matrix.push_back(row);
+    }
+
+    plt::spy(matrix, 5, {{"marker", "o"}});
+    plt::show();
+
+    return 0;
+}
\ No newline at end of file
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index abf0284..9ad7faa 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -102,6 +102,7 @@ struct _interpreter {
     PyObject *s_python_function_colorbar;
     PyObject *s_python_function_subplots_adjust;
     PyObject *s_python_function_rcparams;
+    PyObject *s_python_function_spy;
 
     /* For now, _interpreter is implemented as a singleton since its currently not possible to have
        multiple independent embedded python interpreters without patching the python source code
@@ -276,6 +277,7 @@ struct _interpreter {
         s_python_function_colorbar = PyObject_GetAttrString(pymod, "colorbar");
         s_python_function_subplots_adjust = safe_import(pymod,"subplots_adjust");
         s_python_function_rcparams = PyObject_GetAttrString(pymod, "rcParams");
+	s_python_function_spy = PyObject_GetAttrString(pymod, "spy");
 #ifndef WITHOUT_NUMPY
         s_python_function_imshow = safe_import(pymod, "imshow");
 #endif
@@ -348,11 +350,11 @@ template <> struct select_npy_type<uint64_t> { const static NPY_TYPES type = NPY
 
 // Sanity checks; comment them out or change the numpy type below if you're compiling on
 // a platform where they don't apply
-// static_assert(sizeof(long long) == 8);
-// template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
-// static_assert(sizeof(unsigned long long) == 8);
-// template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
-// TODO: add int, long, etc.
+static_assert(sizeof(long long) == 8);
+template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
+static_assert(sizeof(unsigned long long) == 8);
+template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
+TODO: add int, long, etc.
 
 template<typename Numeric>
 PyObject* get_array(const std::vector<Numeric>& v)
@@ -621,8 +623,37 @@ void contour(const std::vector<::std::vector<Numeric>> &x,
 
   Py_DECREF(args);
   Py_DECREF(kwargs);
-  if (res)
-    Py_DECREF(res);
+  if (res) Py_DECREF(res);
+}
+
+template <typename Numeric>
+void spy(const std::vector<::std::vector<Numeric>> &x,
+         const double markersize = -1,  // -1 for default matplotlib size
+         const std::map<std::string, std::string> &keywords = {})
+{
+  detail::_interpreter::get();
+
+  PyObject *xarray = detail::get_2darray(x);
+
+  PyObject *kwargs = PyDict_New();
+  if (markersize != -1) {
+    PyDict_SetItemString(kwargs, "markersize", PyFloat_FromDouble(markersize));
+  }
+  for (std::map<std::string, std::string>::const_iterator it = keywords.begin();
+       it != keywords.end(); ++it) {
+    PyDict_SetItemString(kwargs, it->first.c_str(),
+                         PyString_FromString(it->second.c_str()));
+  }
+
+  PyObject *plot_args = PyTuple_New(1);
+  PyTuple_SetItem(plot_args, 0, xarray);
+
+  PyObject *res = PyObject_Call(
+      detail::_interpreter::get().s_python_function_spy, plot_args, kwargs);
+
+  Py_DECREF(plot_args);
+  Py_DECREF(kwargs);
+  if (res) Py_DECREF(res);
 }
 #endif // WITHOUT_NUMPY
 

From 630ba843d5c92309279d9c10798be169a20b75a5 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno@L>
Date: Fri, 2 Apr 2021 21:57:56 +0200
Subject: [PATCH 81/86] Some bugfixes and adjustments for contour/spy

---
 CMakeLists.txt   | 8 ++++++++
 examples/spy.cpp | 9 +++++----
 matplotlibcpp.h  | 1 -
 3 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 4e1ef89..9353473 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -16,6 +16,7 @@ target_include_directories(matplotlib_cpp
 target_compile_features(matplotlib_cpp INTERFACE
   cxx_std_11
 )
+# TODO: Use `Development.Embed` component when requiring cmake >= 3.18
 find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
 target_link_libraries(matplotlib_cpp INTERFACE
   Python3::Python
@@ -92,6 +93,13 @@ if(Python3_NumPy_FOUND)
   add_executable(colorbar examples/colorbar.cpp)
   target_link_libraries(colorbar PRIVATE matplotlib_cpp)
   set_target_properties(colorbar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+  add_executable(contour examples/contour.cpp)
+  target_link_libraries(contour PRIVATE matplotlib_cpp)
+  set_target_properties(contour PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+  add_executable(spy examples/spy.cpp)
+  target_link_libraries(spy PRIVATE matplotlib_cpp)
+  set_target_properties(spy PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
 endif()
 
 
diff --git a/examples/spy.cpp b/examples/spy.cpp
index 80bd544..6027a48 100644
--- a/examples/spy.cpp
+++ b/examples/spy.cpp
@@ -1,6 +1,7 @@
-#import <iostream>
-#import <vector>
-#import "../matplotlibcpp.h"
+#include "../matplotlibcpp.h"
+
+#include <iostream>
+#include <vector>
 
 namespace plt = matplotlibcpp;
 
@@ -26,4 +27,4 @@ int main()
     plt::show();
 
     return 0;
-}
\ No newline at end of file
+}
diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index 9ad7faa..e6f64e7 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -354,7 +354,6 @@ static_assert(sizeof(long long) == 8);
 template <> struct select_npy_type<long long> { const static NPY_TYPES type = NPY_INT64; };
 static_assert(sizeof(unsigned long long) == 8);
 template <> struct select_npy_type<unsigned long long> { const static NPY_TYPES type = NPY_UINT64; };
-TODO: add int, long, etc.
 
 template<typename Numeric>
 PyObject* get_array(const std::vector<Numeric>& v)

From 5b88e8b98f630f305e4ea09bb975cb9a9c0cd513 Mon Sep 17 00:00:00 2001
From: Benno Evers <benno@L>
Date: Fri, 2 Apr 2021 22:07:08 +0200
Subject: [PATCH 82/86] Change line endings in CMakeLists.txt

---
 CMakeLists.txt | 266 ++++++++++++++++++++++++-------------------------
 1 file changed, 133 insertions(+), 133 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 9353473..bb2decd 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,133 +1,133 @@
-cmake_minimum_required(VERSION 3.8 FATAL_ERROR)
-project(matplotlib_cpp LANGUAGES CXX)
-
-include(GNUInstallDirs)
-set(PACKAGE_NAME matplotlib_cpp)
-set(INSTALL_CONFIGDIR ${CMAKE_INSTALL_LIBDIR}/${PACKAGE_NAME}/cmake)
-
-
-# Library target
-add_library(matplotlib_cpp INTERFACE)
-target_include_directories(matplotlib_cpp
-  INTERFACE
-    $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/examples>
-    $<INSTALL_INTERFACE:include>
-)
-target_compile_features(matplotlib_cpp INTERFACE
-  cxx_std_11
-)
-# TODO: Use `Development.Embed` component when requiring cmake >= 3.18
-find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
-target_link_libraries(matplotlib_cpp INTERFACE
-  Python3::Python
-  Python3::Module
-)
-find_package(Python3 COMPONENTS NumPy)
-if(Python3_NumPy_FOUND)
-  target_link_libraries(matplotlib_cpp INTERFACE
-    Python3::NumPy
-  )
-else()
-  target_compile_definitions(matplotlib_cpp INTERFACE WITHOUT_NUMPY)
-endif()
-install(
-  TARGETS matplotlib_cpp
-  EXPORT install_targets
-)
-
-
-# Examples
-add_executable(minimal examples/minimal.cpp)
-target_link_libraries(minimal PRIVATE matplotlib_cpp)
-set_target_properties(minimal PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(basic examples/basic.cpp)
-target_link_libraries(basic PRIVATE matplotlib_cpp)
-set_target_properties(basic PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(modern examples/modern.cpp)
-target_link_libraries(modern PRIVATE matplotlib_cpp)
-set_target_properties(modern PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(animation examples/animation.cpp)
-target_link_libraries(animation PRIVATE matplotlib_cpp)
-set_target_properties(animation PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(nonblock examples/nonblock.cpp)
-target_link_libraries(nonblock PRIVATE matplotlib_cpp)
-set_target_properties(nonblock PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(xkcd examples/xkcd.cpp)
-target_link_libraries(xkcd PRIVATE matplotlib_cpp)
-set_target_properties(xkcd PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(bar examples/bar.cpp)
-target_link_libraries(bar PRIVATE matplotlib_cpp)
-set_target_properties(bar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(fill_inbetween examples/fill_inbetween.cpp)
-target_link_libraries(fill_inbetween PRIVATE matplotlib_cpp)
-set_target_properties(fill_inbetween PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(fill examples/fill.cpp)
-target_link_libraries(fill PRIVATE matplotlib_cpp)
-set_target_properties(fill PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(update examples/update.cpp)
-target_link_libraries(update PRIVATE matplotlib_cpp)
-set_target_properties(update PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(subplot2grid examples/subplot2grid.cpp)
-target_link_libraries(subplot2grid PRIVATE matplotlib_cpp)
-set_target_properties(subplot2grid PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-add_executable(lines3d examples/lines3d.cpp)
-target_link_libraries(lines3d PRIVATE matplotlib_cpp)
-set_target_properties(lines3d PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-if(Python3_NumPy_FOUND)
-  add_executable(surface examples/surface.cpp)
-  target_link_libraries(surface PRIVATE matplotlib_cpp)
-  set_target_properties(surface PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-  add_executable(colorbar examples/colorbar.cpp)
-  target_link_libraries(colorbar PRIVATE matplotlib_cpp)
-  set_target_properties(colorbar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-  add_executable(contour examples/contour.cpp)
-  target_link_libraries(contour PRIVATE matplotlib_cpp)
-  set_target_properties(contour PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-
-  add_executable(spy examples/spy.cpp)
-  target_link_libraries(spy PRIVATE matplotlib_cpp)
-  set_target_properties(spy PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
-endif()
-
-
-# Install headers
-install(FILES
-  "${PROJECT_SOURCE_DIR}/matplotlibcpp.h"
-  DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
-
-
-# Install targets file
-install(EXPORT install_targets
-  FILE
-    ${PACKAGE_NAME}Targets.cmake
-  NAMESPACE
-    ${PACKAGE_NAME}::
-  DESTINATION
-    ${INSTALL_CONFIGDIR}
-)
-
-
-# Install matplotlib_cppConfig.cmake
-include(CMakePackageConfigHelpers)
-configure_package_config_file(
-  ${CMAKE_CURRENT_SOURCE_DIR}/cmake/${PACKAGE_NAME}Config.cmake.in
-  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
-  INSTALL_DESTINATION ${INSTALL_CONFIGDIR}
-)
-install(FILES
-  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
-  DESTINATION ${INSTALL_CONFIGDIR}
-)
+cmake_minimum_required(VERSION 3.8 FATAL_ERROR)
+project(matplotlib_cpp LANGUAGES CXX)
+
+include(GNUInstallDirs)
+set(PACKAGE_NAME matplotlib_cpp)
+set(INSTALL_CONFIGDIR ${CMAKE_INSTALL_LIBDIR}/${PACKAGE_NAME}/cmake)
+
+
+# Library target
+add_library(matplotlib_cpp INTERFACE)
+target_include_directories(matplotlib_cpp
+  INTERFACE
+    $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/examples>
+    $<INSTALL_INTERFACE:include>
+)
+target_compile_features(matplotlib_cpp INTERFACE
+  cxx_std_11
+)
+# TODO: Use `Development.Embed` component when requiring cmake >= 3.18
+find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
+target_link_libraries(matplotlib_cpp INTERFACE
+  Python3::Python
+  Python3::Module
+)
+find_package(Python3 COMPONENTS NumPy)
+if(Python3_NumPy_FOUND)
+  target_link_libraries(matplotlib_cpp INTERFACE
+    Python3::NumPy
+  )
+else()
+  target_compile_definitions(matplotlib_cpp INTERFACE WITHOUT_NUMPY)
+endif()
+install(
+  TARGETS matplotlib_cpp
+  EXPORT install_targets
+)
+
+
+# Examples
+add_executable(minimal examples/minimal.cpp)
+target_link_libraries(minimal PRIVATE matplotlib_cpp)
+set_target_properties(minimal PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(basic examples/basic.cpp)
+target_link_libraries(basic PRIVATE matplotlib_cpp)
+set_target_properties(basic PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(modern examples/modern.cpp)
+target_link_libraries(modern PRIVATE matplotlib_cpp)
+set_target_properties(modern PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(animation examples/animation.cpp)
+target_link_libraries(animation PRIVATE matplotlib_cpp)
+set_target_properties(animation PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(nonblock examples/nonblock.cpp)
+target_link_libraries(nonblock PRIVATE matplotlib_cpp)
+set_target_properties(nonblock PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(xkcd examples/xkcd.cpp)
+target_link_libraries(xkcd PRIVATE matplotlib_cpp)
+set_target_properties(xkcd PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(bar examples/bar.cpp)
+target_link_libraries(bar PRIVATE matplotlib_cpp)
+set_target_properties(bar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(fill_inbetween examples/fill_inbetween.cpp)
+target_link_libraries(fill_inbetween PRIVATE matplotlib_cpp)
+set_target_properties(fill_inbetween PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(fill examples/fill.cpp)
+target_link_libraries(fill PRIVATE matplotlib_cpp)
+set_target_properties(fill PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(update examples/update.cpp)
+target_link_libraries(update PRIVATE matplotlib_cpp)
+set_target_properties(update PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(subplot2grid examples/subplot2grid.cpp)
+target_link_libraries(subplot2grid PRIVATE matplotlib_cpp)
+set_target_properties(subplot2grid PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+add_executable(lines3d examples/lines3d.cpp)
+target_link_libraries(lines3d PRIVATE matplotlib_cpp)
+set_target_properties(lines3d PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+if(Python3_NumPy_FOUND)
+  add_executable(surface examples/surface.cpp)
+  target_link_libraries(surface PRIVATE matplotlib_cpp)
+  set_target_properties(surface PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+  add_executable(colorbar examples/colorbar.cpp)
+  target_link_libraries(colorbar PRIVATE matplotlib_cpp)
+  set_target_properties(colorbar PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+  add_executable(contour examples/contour.cpp)
+  target_link_libraries(contour PRIVATE matplotlib_cpp)
+  set_target_properties(contour PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+  add_executable(spy examples/spy.cpp)
+  target_link_libraries(spy PRIVATE matplotlib_cpp)
+  set_target_properties(spy PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+endif()
+
+
+# Install headers
+install(FILES
+  "${PROJECT_SOURCE_DIR}/matplotlibcpp.h"
+  DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+
+
+# Install targets file
+install(EXPORT install_targets
+  FILE
+    ${PACKAGE_NAME}Targets.cmake
+  NAMESPACE
+    ${PACKAGE_NAME}::
+  DESTINATION
+    ${INSTALL_CONFIGDIR}
+)
+
+
+# Install matplotlib_cppConfig.cmake
+include(CMakePackageConfigHelpers)
+configure_package_config_file(
+  ${CMAKE_CURRENT_SOURCE_DIR}/cmake/${PACKAGE_NAME}Config.cmake.in
+  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
+  INSTALL_DESTINATION ${INSTALL_CONFIGDIR}
+)
+install(FILES
+  ${CMAKE_CURRENT_BINARY_DIR}/${PACKAGE_NAME}Config.cmake
+  DESTINATION ${INSTALL_CONFIGDIR}
+)

From 14807809928ffec468b41a2ebe720d5187e3deb7 Mon Sep 17 00:00:00 2001
From: SpiritSeeker <sanjeet029@gmail.com>
Date: Fri, 18 Sep 2020 17:22:46 +0530
Subject: [PATCH 83/86] Updated named plots to infer different datatypes in
 case of x and y inputs.

---
 matplotlibcpp.h | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index e6f64e7..fcd7c8a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1661,8 +1661,8 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& y, const st
     return res;
 }
 
-template<typename Numeric>
-bool named_plot(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
+template<typename NumericX, typename NumericY>
+bool named_plot(const std::string& name, const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::string& format = "")
 {
     detail::_interpreter::get();
 
@@ -1688,8 +1688,8 @@ bool named_plot(const std::string& name, const std::vector<Numeric>& x, const st
     return res;
 }
 
-template<typename Numeric>
-bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
+template<typename NumericX, typename NumericY>
+bool named_semilogx(const std::string& name, const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::string& format = "")
 {
     detail::_interpreter::get();
 
@@ -1715,8 +1715,8 @@ bool named_semilogx(const std::string& name, const std::vector<Numeric>& x, cons
     return res;
 }
 
-template<typename Numeric>
-bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
+template<typename NumericX, typename NumericY>
+bool named_semilogy(const std::string& name, const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::string& format = "")
 {
     detail::_interpreter::get();
 
@@ -1742,8 +1742,8 @@ bool named_semilogy(const std::string& name, const std::vector<Numeric>& x, cons
     return res;
 }
 
-template<typename Numeric>
-bool named_loglog(const std::string& name, const std::vector<Numeric>& x, const std::vector<Numeric>& y, const std::string& format = "")
+template<typename NumericX, typename NumericY>
+bool named_loglog(const std::string& name, const std::vector<NumericX>& x, const std::vector<NumericY>& y, const std::string& format = "")
 {
     detail::_interpreter::get();
 

From 61501081ea32549df1a02dca26cb4edbe0b6a890 Mon Sep 17 00:00:00 2001
From: kesha787898 <45235408+kesha787898@users.noreply.github.com>
Date: Sun, 28 Feb 2021 00:00:30 +0600
Subject: [PATCH 84/86] added scatter with colors

---
 matplotlibcpp.h | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/matplotlibcpp.h b/matplotlibcpp.h
index fcd7c8a..d95d46a 100644
--- a/matplotlibcpp.h
+++ b/matplotlibcpp.h
@@ -1022,6 +1022,44 @@ bool scatter(const std::vector<NumericX>& x,
     return res;
 }
 
+template<typename NumericX, typename NumericY, typename NumericColors>
+    bool scatter_colored(const std::vector<NumericX>& x,
+                 const std::vector<NumericY>& y,
+                 const std::vector<NumericColors>& colors,
+                 const double s=1.0, // The marker size in points**2
+                 const std::map<std::string, std::string> & keywords = {})
+    {
+        detail::_interpreter::get();
+
+        assert(x.size() == y.size());
+
+        PyObject* xarray = detail::get_array(x);
+        PyObject* yarray = detail::get_array(y);
+        PyObject* colors_array = detail::get_array(colors);
+
+        PyObject* kwargs = PyDict_New();
+        PyDict_SetItemString(kwargs, "s", PyLong_FromLong(s));
+        PyDict_SetItemString(kwargs, "c", colors_array);
+
+        for (const auto& it : keywords)
+        {
+            PyDict_SetItemString(kwargs, it.first.c_str(), PyString_FromString(it.second.c_str()));
+        }
+
+        PyObject* plot_args = PyTuple_New(2);
+        PyTuple_SetItem(plot_args, 0, xarray);
+        PyTuple_SetItem(plot_args, 1, yarray);
+
+        PyObject* res = PyObject_Call(detail::_interpreter::get().s_python_function_scatter, plot_args, kwargs);
+
+        Py_DECREF(plot_args);
+        Py_DECREF(kwargs);
+        if(res) Py_DECREF(res);
+
+        return res;
+    }
+    
+
 template<typename NumericX, typename NumericY, typename NumericZ>
 bool scatter(const std::vector<NumericX>& x,
              const std::vector<NumericY>& y,

From 3dda5267e5f76f86a7888221df6151f2f09c93c6 Mon Sep 17 00:00:00 2001
From: Kenta Yonekura <yoneken@ieee.org>
Date: Tue, 13 Apr 2021 11:20:27 +0900
Subject: [PATCH 85/86] Fix a missing M_PI in windows environment

---
 examples/lines3d.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/lines3d.cpp b/examples/lines3d.cpp
index f3c201c..fd4610d 100644
--- a/examples/lines3d.cpp
+++ b/examples/lines3d.cpp
@@ -1,5 +1,5 @@
+#define _USE_MATH_DEFINES
 #include "../matplotlibcpp.h"
-
 #include <cmath>
 
 namespace plt = matplotlibcpp;

From ef0383f1315d32e0156335e10b82e90b334f6d9f Mon Sep 17 00:00:00 2001
From: Kenta Yonekura <yoneken@ieee.org>
Date: Tue, 13 Apr 2021 14:36:10 +0900
Subject: [PATCH 86/86] Enable cmake include definition

---
 cmake/matplotlib_cppConfig.cmake.in | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/cmake/matplotlib_cppConfig.cmake.in b/cmake/matplotlib_cppConfig.cmake.in
index 1793f29..86d25d0 100644
--- a/cmake/matplotlib_cppConfig.cmake.in
+++ b/cmake/matplotlib_cppConfig.cmake.in
@@ -4,4 +4,7 @@ if(NOT TARGET matplotlib_cpp::matplotlib_cpp)
   find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
   find_package(Python3 COMPONENTS NumPy)
   include("${matplotlib_cpp_CMAKE_DIR}/matplotlib_cppTargets.cmake")
+
+  get_target_property(matplotlib_cpp_INCLUDE_DIRS matplotlib_cpp::matplotlib_cpp INTERFACE_INCLUDE_DIRECTORIES)
+
 endif()