From 74c5764a44b2b286c5d81bad2765fdc6e6c44de2 Mon Sep 17 00:00:00 2001 From: Aaron <aaronquinlan@gmail.com> Date: Sat, 26 Jan 2013 14:33:11 -0500 Subject: [PATCH] [DOCS] updated slop docs --- .../content/images/tool-glyphs/slop-glyph.png | Bin 0 -> 21452 bytes docs/content/tools/slop.rst | 111 +++++++++++++----- 2 files changed, 84 insertions(+), 27 deletions(-) create mode 100644 docs/content/images/tool-glyphs/slop-glyph.png diff --git a/docs/content/images/tool-glyphs/slop-glyph.png b/docs/content/images/tool-glyphs/slop-glyph.png new file mode 100644 index 0000000000000000000000000000000000000000..d010fd131ab36e9f9d50dda63ad9d5851eb6e6ca GIT binary patch literal 21452 zcmd42_g_=Z7d0A`CL)Lmh%^xeq!$q>Ql$t;ZvvqgrG*|ks1)f%swhQz?*tNxfJzA% zdJ7PcCImt!K!Ci*=YH?K|H3;zBsu5gGqcZ>J!`GKCt62K^#;{FDi8>C<E7dQJrL*$ z4g?~xpd<(G%*uU!0DLidE1P)hLma%J)}Hnt1v`k1{r#7&){gdi_SSa(9{u(*AdtS> z%NGg;ezRNi!7kaV@7GU95&Q%7cHG{h9<zmrPdH5tM@g~vs-eLy&!Ef=unXdA>%0nc zAO&BnRq*$(m@rU7AGOrLw$EiI^6PnhthDX>=JyCmi8BUgZn0P_tIO>EZ!N)gF-AT< zSCqG?>%hw|Kh#;;O~whx=gNlBMS9PJ*z^h?reJ7y!-D#vg4h_?Q#yGk^%HLb_W$2h z^6U(CNI^;MpGtoJYL8V}=8|OJD_;3|{W-*LPi9|);5ip}4FZl9FcQ?=v4Qz`RfrRh zjnHnO`z=@HqffeM;i1B!Qpe2J>Fw<Pi`(1%s3EIahMRV<6op*$PQX}gd0r-cdg<r- z<ilb{${morJ4IL<+<QY00rfceK)cf>E*nD3!FcK)y|O_c`c0xj<@WP3E2@!a9%zSO zUZxnXaH1J+r3NeSc}+O9CMa9`%QKOI9C8pT6l4N%-#HYl?iABKFk1bJ#~Gqfl~mXs z>COkZtxItc9NBI#`-Ne>r-y9H<IMGY;|DC|6b63jRSU2M;=+PKt*rm1OEzlx&vN|8 ziOI5?h(2?&z>ZBv`BPE48TyMh|C$+3H&~wrA5nPR&mIpYzf7CXIoBKvwBOyBqBRT- zeEWAN5X!pW9mpQY3_7VOrUc#BA)cR~vyU%aGBe3@`kF}0&mJ%*^IvVGL5QBOjc)%a z{BRNuH-DYTI7q=p=yyfP1sg<c8trt9pKBZAwP_L0S*;~>j7%<V(Q@Y3b~=x{ET6=x zveQ`xiSWWcEYg6OhX2rjIKIgE9A`p3Ts+MVb~}kj)z(<Ic_Nx-Sh3J7d)1YWJ{($s z-D6SopYy|+@qWz4N|+5cfK@rN>_zV*PFc>8>^|cY6T!AqztdIaI-xs>ml?*FyY$CT z{tfE)07V4#_nPwi=LANf!#+2zKXtitlN>TmnyumcHtE8=kKpVGx4p!>`Sa<UdI#AO z#1_NmHsW@MG<o|*6dXwdvJ!v~faGg?CMFDr4i2t+g?cP@p8mF#lRPkIBJ=93Ws|tl zqEU(y6K&Lhb$ZKRih2CVuC7Ipgqf`}pmQ=Md;;{nm^!)lk1X-UY=&&bzCN8urlS_5 zlO)K$Ui!>xY^w8k8pfF%Sxi+oUiW)gP-!Pm<OcIpgosewX%&}HTKZR8_9AB$2odrJ zO<bB25to$(eYfUoYQcUlKMELo4dI1xbO*$REv&v0*gSTF1n7b@>^&{!i?0SJ8m6D0 zkofBv8)s9Y#Kpxqmy;<%Q>=BFT87+2bvgaA3#z7<TU4vCy19gy=$VrFEtP_($T(x6 zK`!j(X2-#_@p9B{CH6TrE^awGoSQf(On_l-+sKB=6nGhD`@@hYW~;-MTukG5GZ^w_ zsMfqhVR0s0uDF=P*Td?fxY+R$SzNsR?c28pr)E3n>^;P#e&W*yM(l4ksg_sOp#{+= zsr>`4V?OA1(~;)!9UVhM!+5IgUV|P|(D(W@_(02*0L$da9WkeYW+Y12dEvZw$p_mJ zvfQED<Wd}SGmK^E_wNu53oR|J=i|@(cN(EblJvr~75Cu_!-7|_d1|nyNR7bM&o*>t zn2s6@oTHr4VJQ1sxh4sS#;ojTa39@lY+d%C59bqheDT%SGRJv_Z0n+_C~QIus#N#& z8^+Zm2$_!X*q9h`ozXH52R6yfMO-{uSCz7kz#=w1VYaX5^&m8iZ(&+khG4IbmGhyF z58uvWE&X1Gst*nhYL#V6KBEW4+;7Q<$@FLk+fCUQ%~SoENlE)!kf06<^U2K0dV6~E zNjvm$jrNnRpw|(HMw|xNPxm%1H>^z;ksZ$QGX4`3^oc{T;LFJ<_!aLxMcOV_P>_Kh zss9wjT&_ehaN3P;%~QhD1douVrvypr*|yYpV@k7Mbu5C<b@-ua$zycMIKkURKNMe| zLjNq8K|*~A9}>^n2Sy4dnDGMy%AZ$3KN;twSr6)&)nV><*2HUgofOrH<wM&dL7(<9 z$NBw^N058ENUEc@uS{&qqm`3^`ju=V+&qnFdJv;=Yyf)~YhO()V}LjDAeE3z@i_I! zY~$>};}DyCx+x_#-1%w`B)>-nMaS|!K_V*>+`kB4ftU4C&XpK`?5NC9P0YZVW`y9D zRi>v<au3eUMuuXPGUyIJD0YIE?hfR~sa(yuE$_w^vK`&qIX~VQJT-M&f+t?)%%(Rd z4ZHI*MC1Gr_Is<q0F-y~0rA+uywi>Bk8g5oO$%!a>e-bhrZC7ew@>e;*+`1@4XI`u zC?`YE;;FW+hZJo_Aj#?02K(ar`g#>Mc}c^m7w=X^jOF~y8bek`diGb03efB+0(;(R zBw@F%<7&!~Zn^GGk((lX?nrk&ZKrYPxe%Ei_*qc5cMaWn#*fVryTRUH6W;Q6xXaNm zQHwNrpnIG*uI|^v;pJx;b(nj_FZK%@LR4hh{5s3vaJV)6TYyV_$LWooHMwtgpzp2~ z@w{TZ-O!yR<k#a?h-zf-SH=yoL|-Na;_KX-+f(YYc5@InnE!<eo6-png0EK6!NJk^ zS6HR#mvzwi(TI}cFCq?MoPy?a%(lzGtF4Y+{Tg~&?&1mw#1Ijzpn+K<XOA6}%}fq8 zhnzlRvU7ruc<jV-u4BWicAHjZFga1_bw{LP+Kn(7N&n5Qy6ET?Om<FAhlE_Ga3^7* zMsHr)&RN9sL8p+u?UaOOyvhWV{?G32?l17%7&_3Mm+rLAHEOW*#PaVfzmj$#t!@&E zLCq?LVLRv*&m}8^`<?miLx^YTnpz3O?V8Ai6eR}S#fbxN3q(6ag`{fCjN-EH<Yz{x zm$!$9hn7*y4^NHr>#5YB7JBTpOn4l2y@7I2$?Qb@h9ocDjOS4uMH0fS-&G(wYgWy? zxfWX+;)t)Qx_5)DHJRJ0+>f}{Erjd9>$A=ZS^RyeBMMqHqT;raf+=7(=DsiHI3xWB zTeNchtiG<?#f4sCdo6dn3E5JO+LJqKG&09%DRZs}4^a*~$MtE|Kgo#B;fD2V+aR6U zu67Az*lbReJO2^=VpE*M^rZQF>EJ)_Wc-MMfuHtJp?ljkA&-s?e0&UF^&Doh)C*VR z5-6AL6#ITNN*_Ng-pq)aI!|;Z?nd;6coNzqd;rUIK6hOl@n=AuUa7N$rEug5w@E|| zC_LR4Atyku;p8u$pAX}5$ET)t$}1|+$1qDS<2Bu&>ii-uHsZbnRDg^5MZk$UNIsej z%2Zpky4zAf!Z9V((kseuYfR&5@7CMJ&(7S?eTmpwkPqSK=Px#$SXC&`ZTfMyH~7L1 z|4l)1VtY1NXmogYI8?;DAYiBWqNan`-fqmp26C?u{Nvi0ZtEvo^&Xnxfp(r04Sq0R za)EF<)mpw({Cd!ap~M_d?<-h%w~>Re-uvS-edCAT<yq~#_3hTp&F_||<_}M{Mg^A7 z@+`hzU%i@mvC_=nIe*q1SzgpBB;@GeP@K~;k#Pb|<pkYPcF(Yuc9>_leOZOhg7-I8 z<jt=)<RE{wu?>ubxUr6-K2A8=3~}Ar8LFpVXliaSd!<;pEoGZ-SYk-G!T2SZzE9%~ zUeLnA#N;EA<GQl4a{YF@T!l$_sph3Uc4t6Yy)_iU_Ypf)0m&fBX3{hH6J^CWPHoS$ zgc@sJ_XkRMz_HQM!1hoMcL)ht$~0c90wBZiCJo3;rlpsq3rxP|rSkpv50@(3ZJg}F zg%hho?D^|nFXVmVw>tAdxR47^y7gHT|ND;ixmXqV9q&|QM8K;8Nh5xc9T#eaiJiSO zbcb;nznT<5Fa6W6j@*~^hgp>ln@BZ=Ud6cuuAM7fc7KgAU60$Myt=wPC+lUEsu3wA z4pjT|1A;maRa#qqwS_4O@^L}{<7@Ifk4++#V+H$3e1id>5spB{Tj1dI`vk*bS}Ke~ zpBw6d8onY%J>#<+WDct3iu9nLRgIsTscFVHE_;AH@xN3Nog*S(*z<+dbIlh!7rZ{p zm@P9e%7NO?nlOXi3591){9{hx8;WdkSvuHw6YQRuBbGd^!mW&5Yh3Qh2}G`vCG?@> z<CDuPVS~IeE`bOG_cV?U=@nbJGMos_r3_6s%zy8h0Z*lWzi=}#y6os@{hSuaEOk@V z%OYY31}sbeQvi#lFTr#p7C*uvcyfxxZ!lK}^YgVKIfjV?G0$VFdB81N*0Fw>WfqlL zk98UOeN3t?x+sUNCQD5KJSb7>Y_VFYCwE@s+<t4g16WdPH`E`=tz64Ac#}c?m=47A zb+N;u9<AQ6SosZ9KRn)e(ZeeJ`8YlvLp;n!VG={m7pH<Vs`eC1Ws&91m$9sYMgl_G z@=pw>8bxY)&@`M6Yh1E1Pv;V4c-G3XRPa}LsI2KhQEPti@-jY<JEgy`U*E9+m?gq1 zT%gpq?h?`ko7F<=epr(5Ch4>9DIJ1@R^r!pp-r2Y0EnZvYxnKTSZlxk97pEFIJ0es zK5W@JSJ^|mHH_vVtE#K39oCJP69e-v*!?6fz;!`+TO!9&ARg4>?~i<-{eLiuNwhS( zpjj>8*-rzxlbO%1$<dMEva2t)jdq3UuLLK#(3n$<(8NioBn}!+sB~A$sXa}ssHm8C zaK#7!c$f#XC`iaget2Q;99Ux&<OPy^3fg)zdpR&YeZrkUfPmYEKMk%^O_0<PSfDeU zKQdFwNAq6!q0=bq;C#%r^B&G<z18DYRrb?jsQ*0T{NgsZ)?r-*2?%5b76ik`wI1Io zG?#9F8@*2kaKdI^cS!ou*OdR!!!S>ejnN{pdY??-j!U|F3_yjI0!yGHoardCcipK% zpfG?DOn2vljUuaWFOdAZI{iMAemx4O`j2OUbRJ&;y_W{1#{X+IkTL3+!awpER__B; zE2s__@n0E;U^xo+m?HsYN6X?sHy<<xGER{#w=k9mJvRPF2mmzJh_PdV{>S)a56v?A z*yk@kT66r@9+sg&k!#=b@x5<6|5<~5WcI=GRwEVTl{5|zWf{QM!v?hg#<l|X*1tt| za7+1rjRId*wg&%*XO`67=tqg4hA<`&=qXF^9LfDm*)UPAyB7~JX%Ai(UxP?38phmp zyA2YxGGGExvd=LY7Vp|q|3_8eN{^Q6-AnI~fB=j)x&9;icJP974g5vO&;Q-qXIjWD zx<jRS?7VY(L#*`5|JS-aiAaJph*U?3Vd1b?iTX7qXqrE6nFiEl=f1w!-)$Hp7&!Kt zR~eMVL{V}@-Y*>AZ4e{%*bGF;F#RWF&+>9-AK5tXgXt$;c4E;~Lfz<JTDgeGHdmHE zuD{DP(N*kv?d;|U1C5>XJJ}W`EGWrwspbLMmgpS~1!VVn!^BRNv-ek&b7)Q6nsX;_ z(#V5pTB#wFRtG+c8q<({494OK25y+^ueZ2GlG#EUB+&T5K-q&m>q-LRTR0}$=i;(1 zF$!76d_hQA5=(*Y^u>hTXxRj_&?A+6W<==?EF;-Fp<p4kLTygB&cCda0p{3k{HgWP z4N2x7LEwmomPC_CQIBmkimL+yP1{Nj=0&+M%Tr=)kZK=q@;1nRt6SjMLXsTK%;m?A z{P-ys#d!or29|dEGEejXU9yFWIQ{HqH(l(4;cVCJ{One`U5C#V&P8{yEFdp$P>%$J z-btgkff(8=Po4kK+Zi3*clDp!*%F0r6RnRwgc$x7sc7@b+L#h6#GwvD>>GAYgQwu> zmItr*27DXg<=-5wb-#d3%r~Kxcq;~i?l5G`0jG^Ul@-C5jfGUqedy>t@<QSf$P;S9 zcHr^4sCR*S`i@fFIU8no20!a{B2%@FuSv2u`$+YUufXoimHJF;kc-0MEO-OCgqQg% zwvJ~?uG#pUoIM$2)NX}A;1(^yJ||i(&5(I;>Mt>9yb{yLzF}(}KwpmT5;*P-6+JDr zFfKV$aQ$t=YF2&p=*6q&akV=K7QKm93&_EMR|+*kB}ZkG-+XP^-P_aKLfx*K1|JAm z()Z-4f4V4GJNtt=ZLm$vTF|EboR*>(Y!Tc+oJ=iaoWlopwR?qFmxX%tzh<jw=F7zp zncL)6;h2pbuPMhtnu3|2M2U*soX6fSN1@&I{xwqs|K?7OA<WGC(442WU-mDuC=ZyO ziBHKxxU2Dj_j@3r!yzeSj#^dPPs7>qrx!cRmUsT&N&ocLGN9RnX=DiYcS;^5MJT0G zf~>@Z|E+^h!5sF)9|tzJG|z-!>LalWhbhL7ZAfo{`ojM64B*F7oXwMz5C4;I9*8@E zul)O^lMa8;!Z4LNJ=frJYYwJTRBCd}2soG&j;j-|Af|d_BVo108O(L*X{fQPbOpLr zK=vt-5b)QRCR_)BzE4iLhVw~&-FuBIZTdoEJCv|4sh=0-ufnPpeV*a!RkkezSYEUS zr>~X@P9LkPoHFELu2VEF*<-1@LaH&(JJ)aa>+%XHI|6W9PscbQn>S2~!G#1d<kH<5 zrbJ1cNk}OOE&0RD@UDeDPr9;kmd%XiKPQ#<u${p@w8W!b8@wQ__?fjE{sLY!LG1;f zFqFj@_KIfx7=J`jvX(1|Ub{7G3Cg?wjO2D$m0KrWy*X!6rnP47k^x1_)rIjIwu%o+ zhRXp654mZ}X-kmH+s2lw)0;LbH@)6AS0k+^D%LE$NhSQ-6$Q96P{s6VAM_7|Ft#g@ zq6;z*fKt@eLvwO>+CGPC_l<%DEQ~V<UX)pVxoiA<%0C-BL4Z$_f7$<t+L6kCs?vSx z?L5YDsQ0~*@1GynPBUAeGbnV^2B9k*^Z&e)`3=b{`iSMrBT|I0P26%$Xt|y@Ph#4) zs`~%c<VCiOR=GKbXMdtNrSoz9X2MMvCvwpjJUnaKw`<`9jL6M7lGG<tCJPRwSObNM zF^}BVxPBTZj9~^`?jSxd{?8AMEuon$A&?FaHN`b6zKEI&Sq06=vP=`UqaK;)-`Ipz zZDy3@3Z;!`DVTm^^1%7E3m@2?N<Js-B|kJ{gRky?uRZW~8II8jbTsr6Ma8_OS!Qf_ z4=#b@q+V-x*5zc7+Im8K-#{EgNr1g8?9Y9r^sS5_ofFz4ZZpYTdZa+9h^@sZ>vC;= zyj(hJs>ls{^x6^umvg~xl-9AW7<*mA3H>)WQ|$aUY3j^tv}<qih95B<D4?K%y{_?e z3&13>YH)Yw4fC{W-t=`KScw}f<@>~iycY!q``;eg8p|{VUD+oMKkn99<wX=6W{d*U zEJ8;CfJe926k=ZMQs^w)K{{%)e&hL9nb>eIt9+}8HpsbIunYJnbM+izz?%wxO$Kyd zKTMSk4EK)qBn!Ja&|0AhGhySc)LFfG8yQ-qv98>rdo!%w3m^d>p>?R1$K_mJA+V!b z1b~mez;a54Op7P7BPSXK6LF`bkge&F!-BfHz0mz7Rd!+;#<NM9oAZX{y;#D$oYcv# zRpdn9)RQfJuCt@em4JKgZ@aT^O$LY55Yk}@D-74S;mo%vh*v;e&xKo%ol3NKcv`UR zV;o1E*HZ)4LVqKk>A9f6#>P{-MMB$`zoOU|Hga<<Gx@q;Dj~+LS1!VWm3-`s2DzQL zsrtf=In=`ah(7kVMf-b;A83QTpoj0|TBOfUiH9?exx@!nfs+QF-F~Z8AF5-Ls?T2p zxk0G?OfO6tQXcZ@8s~&=s=U{h4pYoa3_Sb6d-`<6i<QSQ*__SbHR8Tgc1hdtGfu8s zh%d<TX3gk<&t$eCdgPjQ&$1J1TBG~5Q}CDd0gi5#pBrqCqJL&>=B2wyznEP*NoR7v z7TjL&wj9)+c){pc;cGm}uTswJpnrq3p#c4*CNQ8yWDE}8GP*R#It%yoGK!k<8xE9} z4e87;hM%=3CnsZe9q^92*Qm`^(sg-PiTpi@c`)t%0W~i1$&RLg&g{4VeAT&9qp%?- zrr;oGoaD|G0UVNh>6t;E4}Td_vHB_xuiVK9-lBzg`GGZrL?@Dm32v{G@vf}dUyq`q zkgAA|N!|X<yrTE@JuqkEzy|I>d)~d7TH5p-r%_llf^r7@ao-`pkMJ4IuwMRSuCI9l zCSbr-BD;{B$y@<rq-}ED4}PLl&-Vm*^gH2+T{UG9FPEX2zl2=qo+2tcXqIHfOtP^B zRuLvh8<J9WKTGSiK*k2$MgwOD*QnzZ)&Rw6_II_c0ac1^|K?tGEZ@(x5o-6Sa<bg2 zgJrnneYaovs*#{$-*{BJA=zf1)D?(cA);-A0fKOTQP89%*2i{m1#T&f5jAM72?i&| zZC)Pe23sO8rK{DIJzZ<7X(m3i)+;^?8jyZ4I&V1WsXd6Pi3J9OykkeKC;lDtQu%b@ zj+bmmrnXd=BF_;6l<7MpW`a|JMbEm;tkTt^Q*bip(GC;+G0<o|yvnjrwV<^)-NWHd zlbaW-{EQSJuvqW>X{5Fd%sJJLE{FSDN7RRFyN~5VrzxEs{9J~ty~yL`Yd%bZkG@D1 zmYhi$zml!3S~BjO7iS{Qm|c(06})qbPI{sU8Kqo1bsK^y;lbjasDRF)4>1&#r{);+ z4Nktt(9q+SQ`)d<(1m*iD<yT_Nm@WG;Vu0aR9W79S+Q(y{kF;*xx8w8sk>0mX;R%* zDHYbZeWO$jHjF+aD?yTL_KvSIcS8RT@$JWq*#B@zo?P1g*jHy6MCoup&J<Qf6&u@h zTYMi;Xp^rJk~_z@kH2pNh8$hPUsEj_ka^?vy<BGIpgTYtjNRZVPQr;E={C%}ayx0V z6jFsP=8(<v$~w&X4m-{iY}RX&;W+5$&_8GEvVAg`=l2%`pMmK6)S8-0u6P2&!fIi) zb5mJ#R?l$1tM~z*oAEA#%HJFv<kr)*DCIQ{o)3z?&XTw(bZ7IqWBgXO+$AziPGEsr zY=8#X2#m+9&srqD(r<*|1f_;CIvE8CRAIv1?X8-KzBwpcSblwotmV6T7XL?rqrt;I zu_ZLMRVsOD^-e!6%X4P_a@^luWQDC6pM7Dj;eI;=t1of=-eKO5M75K9et7MmJuoeW zMBW{hL%jj#(@3P+Ii;LtiKDWE*lX^d{k`BLL2m9=DV4fho8)ZH49?qjcVhqOL^1sZ zG0#7lIA>PLoI6mjXYEVR)Y$AlOu0&DYaz!~sw_Pq*d#tjv>#{T((eeZkDa1dCkNb} zbUk0J49{UX)z1F@BRU*^aa|Z8aymGyl4Uag{C936&CbQ8v@T~@q-39WfmxC<FYWc@ zrM(qfB8okB0vvd#@RiPXq4F6i83g`0^`mQ`ivBvIa5v$8(UrWLyc#D>{ca+jeJV5Y z%4{y>X0wTol&7OKK5u;!HyYBn4N#a3FS)R$*|@xr+3S+~@)Nea!!U;XEwf7dkFKt5 zuWmDJx7f<s42@A)M6M)d)F&dwPts7IEQ(Uq?}FY3rrX%G1`gW$T!?cHBibqi6U*(r zze9bh{B>WA@^rCM+OLK`*^f(S`h`y?3D9{ZrO7=WG)g&NozE#owxjl4CZAa{8Ek*p zCn_#o>|@LX>I+p;xYqe}=DlFlI~mT=<(h1TpeVZCB8xhiphB0o>>}x*{d;q8am-Fg zl|Hz+p@L+?s%<-YMB>Nh?e)xyN$>??IboQU)`SbfyM}eXcPpwx^60PGMeLF7r?xcV zR|~J-(yC9&3GX#SPrcO1fZh)bc$g(9jwx{yyNZ~(B82)lTW|%RWZI0`Yl|B9tf?4y zm+NR?Z)H#w^}$s4_u*Zf&051R&OgpSy*yt^ve>P9BdZ6pid{*enJR8Lx&}_P5pQbl z`OK94R87LClAJalK;L)NAp<5;3iWaTWnT!N0n`+>@!|D{a4_z(Ri>K!C$PO9MX6h$ zUEHYr%S^TfEe_DMaGL$T6d?k!+NQlSNyTP6MN;29dd6e+I5wKCH~981uU-ZiVFTZ` z5v+@@cPbptc<V|b?~XD5`s=9R4n=K(P|oLwKU6qFv4gcoRybt;53L5opubQfEg()( z<$r!a`3i5(ehW!af2Hp?b6V5&-j%=1(x!5c%Wq^{%<jN0EJM4^C>bRq5evQT!<Sr- zuH;$8lig8xQ?Kz#BA>NyhVHrDg5uc=arqJFIE)7PDJ;ZuB@IT?vGfW+UjGp6v#&Bf zMr^5Y(egN%*F)2bJ$&3%Br#dC-0wWr479$JhApzm)4-+$jPS}r;evE-=Es?8xz-co zWzAy0a8aV3vtO8q_6BhQUErLS;=6qwbJ(4r1Lw3c>3e>B`F}r!-}s#{fkYZ)WG#gf z>1PbrWPV=FyMKf1(V^)INx@lMF-3Ub9j1Imn0d3d9rTwz)At(Yd@v2SzkpK96nAh6 z*d<3iy`6W|(ILL!`ZpGX2~<0H?8z91+4PY@kmsF*ZDrAP1WRxGT5K;{F68{s>z9Yn z<6|bj9V**HPWr*7QXfprEbCa+7?jb}-nh0b5lSsf9FKpfd>vSG>VKQe4c`T+kwH7H z+3Zhn22)~WL1wV>J8$+^G}nW8ZyHyjRSebGn{rB&-SxOqqcOw`;z?`tk7@%s{J<>P zULTY^*1<cg+^(@~X)@Hu{ZDl0#aPki+sN=a)5t3MU=6Z;P3z}2Wc%}zqOYMotryGO z#)jmAfc*9jMlRoxrWcE#Szf=|y?Y~BR?I1s0Tnv@86Q|lvl{GVW`{(`23Am?wf_>` zet<9v&3hA16oqSBYDeH7+`Hw;Au1y%#J7fZqQv=Ulubx~E7m+9RIa19t}3lQ-GlG~ zYo1&r8K=Q^tXZV=x_UW@Y6;Ag{+4m0`pNo4bKmz+6@F;Eq@%&zSwph-iwT~4kvald zHv(g@iN%|Bs?fdT2%3f4lR+|89YX;fJwH#*%#Jb9iERY6A19X-K;@B(Ij;9JkVmDx z9S^&kIyxC{&Pm5(rIIi@UG4LxurHV{!H=T#qtEjNrF0FLWjmL90zVNh=i_f}W7zJr zaoYGy-43)M-&5iH2sOb{eiqui2=J&b_t~mpA3cCrv<)9TWru=D@r&QTyqaR1VFbfQ zkvG4VSq7O9;;pK4kwL$Go8ouMk6{011rWqGifo5e1?`nC9mGWA1RIoZm>yhZdf!~3 zXzwdAV{Fp}UtIaCcE&>1y$&)01fQC;SG(!??Z$-&nD;e&SMkh8rmlI&S9!_E;|ygu z1~PhGiq8M@2^a$h8wAf^=lKgl=Iy#dB_vgn-Kb94fTaQ0#xGtWEcl^u%XXp6&ABf9 z6WGohiH9nY;zN9y?mH8HY<@U;FxG>7&ga`0@&JINF@KcDLynyje>csYJ?ZHx3#nQV z^+qOZ4C1(thu{0|t_^1Y<PbS}sc+}KYaOik-q_v`&s#A9g!kU~15ShX<?&;QC^wc{ z$f~^|BT9DBZa>G5>qA9+@fB%bJGObaVfXO!8U_-BzgC~&mNyGE_MhyT2{$6$U7KBy z={v!OpJ-hw2#pug8fgb8)OJ9P7C(Mtvg*&V`}+U`x<EArc<vo`ufJ;TkjBqxjZ4gy z;;09{rmyyMi`Ri{3rd`uR1j8nxqj9BSRxe6&;C#<wd5w-iyCf+xk+4$CC2vy_-4`X z>q4SiUqS%9J|azAV-~8&%bvcRb~HBlE>18}jT8P-GgiL&LCCBMv^I6i?NT}^U{G(> zd^4^r_NV}}C-`fKpfftSw=lKEm?FddZlp8#5h`{NoDIsW{D7cY8gfcGK#|Hgv|kK? z6FUJ{-p)!9@7nm`;wIw$z|U=VxtZb~zp>lU0)Wp*Y?6x8@!6qmT`0(RV<O<=&?1)J zuh3gu{txO<m*;$nP+~bcjU}g*QL>7+65x5zzhc$U7<b!NnAwsv`sO^&Bylc*F@F2+ z?G3?a!M~Qh-Ahn11JN!Ksa5E`ep=H90)!n>Su0=fY?Cil7UG?Djc!`B5X+|Xp!%oc z{kqPFec}_zS>grL2IGRy5E}pmagZ_bEeqh9=mh(oX0g6CX$AjA#k-g_RXX<}^VTsB zKNuBpag5FfdmGbU>_i1mj?{Bu@Y129@X<dD{E0KuX{qy$JS-qGU0ubR)nc{W=tG^z zRd~F6uvWwy|1hT-iRa7@DlrCA_HUp~o804Go3e+h6WgeAA9F)kKf?)wuR`i=@$NX8 zFrf$9-FA`t-a0k2QUc5>WO=@4OJG1%-=TK`r^%*8A2ts@iyEmEZT67VG~!}#EdSYU z=en62aoRsS-o_}pj7<Cb%aCHkXmUt(ll{v_G`2ZcVk$;eXVtlY-*|I#vQB8QbiK?> zU)S4E?_aDTL0bm&9wB#733&TZ=VpuFvL;7Kl(Mm9!D|M_r>urcbK^D5FYnQ9<n!d( zGrnMog!=DVOgGrh_B>o@TH7XYw|!6DolL%0WKUSm{aJ$B`Z$i$Y%c0CnxCH$(yLlU zuws$L7`WG+th1<J%M<7|DRT~8XbBH}lYqYS`=Cf+GeNuMApwZo%2pXLk(r(_ziX4| z@$~$`Bzd@eBN;a^%J`rW>(kfEZeV?0iSqQ6wyOxy<cAH)@r_>W+HPJtzpoYrLIG?d z?*qHx1f0>mXeDD%s#(Mqj6dq;VVUNeGkFWMY}EeM5c>Gpub+~Od!urzOHI`$9<Ke` z{8=gSQVjn9#=zzL$!42L*9V{FGUMpb#Am5!?AN9q*5J_a%vfCH;;p{TSLH9>TacNL z(#JCf%E{W||1@_OjtoI?3V1d0pZKl*w$kAHu_W%nAi%#_K~Du5p#h9j?Hfsqa|9kb z(07N@Ldt(4-9N4V3cMHePaFaY@R>xb1W0jK4|)Dw|NkXS(H79-Dcv_lANfzN&_QBy zpLy7PyhQ?XA*azI3$q&96jjmvuY%g657Nu6SO3+eLkhJ0PgAM)8PC48;4OatK9T^) z+&+-ag+<}#E3c-;9|2A1_)4|E?azdZg&${6)*Dytb{6u2w(sx(kCH5>s)R$v9b1u` zmvnsJq2&Zb92(AJ1U$OmnNTk5M&Y5~P^Sr_KM|?`!kv;J5YNkrJ0xMRykCJWhH5oS z)bNf|$j)lFj4tA9)!~eJ`?E?ke0){1PNvefp((BgkS2c`*e_-Mi&q>pll-%KKzI0N ztV8Zm2)6!prL0<$CE1p*&qWv<OuobB6I`PPElKXW(COPwMTz`Cll@cid9PYkNWTf+ z%Co{$7wh`WxRM3uD-txEvb2^kH470y;NoBIm^~kcTRa79?Tyb`P9Ovt=5?-7UWV9A z0$uR$DK{qgm*wq^$<s_u7l8i2CRV$W(qcQVxB&f-KLY4IB2K7p5AJ^;B#FqSZV!x; zltuCQ0wekDC+l~k60<((c=R#z6rnyy_N?r`-mlfFPCw-6y^#8Wj|!q0Q{X!v1LQEB zJAVOl`8=8;@k~<yy0=Ln4BD#%vkCb`uZHXfJjr5KU<RT!k6N|->q{K}OMOF=0t&0= z!(QVl$LFkjuh;79;v_dfn77YW6~PkPTPp$QL&D5|$?#f`Kb4iBuvf|e?$3VJ>_^dL zlS}W6Xzb%)kBVEYK8iUcDHA%CnJNwFaBP^-@gX+^;xA-idyvah$((>(6I{0JN<$p= ztfxUn0dJ~h!}}mu01ay&%E2VJt@BZ@>*{x4+yRO5_1JPDg}_+$(q%^ycHmJE?H<Fw z$WjEi*?~{zam5`9;G$MsyyAO^At^26HQ?&MLbWzpq%jW+7HC?N-u`@cmDWAOM0Ro8 z{M}?eF=c%)PCf^~xKDB5C-)?pOk-cPz0H-lVcs_E^{D6IMSJZ0uUER_FJD5`W#H=? zoprXVV~M|h{UY{9u?L?UFSy=b@Z$0Vq-aun{K)nzA%<EOyEjwZ(2d(jr5O@Z+-e?w zWvvT^!*ht>ZDVU0#t%%Bw@b_35~_vd&ieGD^J(24e)_ab5=&e0Hva5ycxh$!?N98@ z)Zr!z)gPzn>BqpGJ`N4RvZaMU4+JAg@rn^n{=#2muNS&_$bH9=D-vcH+hP+GYf75! z)eR>33#+whB^=C~>wOi*pK3E59Pk|+^qWG;HNZ9H<>jwUOfo-BIjX{<f6nkO=twZ_ ze`3P1yBkcCw-0n>-(dyW{d$Ir5ZnBxl6|ny!I?n*RwWFUzvc3IZ9jwswLa4qaOiFR zX-si+YN+u1x|cPBDa}zur)m4PTGL7BG2<RduhO~cDC9MXU(3=6oi4&QU={Pe+|^6B zMh1$~9{-iWz{}a{X2})nWoYATXZCdU4sA>4gojzS1l`=fAfHu5i(meFeCTl}8{`$u z_Ew*gFfDabn$N*E*?`VrAq|+Yb|1D}FNtasCFf&ns1phR2{@+RA<DHOa9B2336^t3 zqkKv_Ul4O>v0UyZ!L9w(6@7W)xK}=V`mx~F&AsC0&Bz&pmJH$>&4<3%c7oLd>~G_9 zVg)5ZNeYtQX&d{+Y;|)!%534~+7Sx^lfG%m7o)4sP$G3f#XqLTJ<t3FV-L%w0>_Us z!iila8k?i$6gtgqI@~>T6{58RIDXNO$UL)rcttq%ny)eSyy$%KntkcGz;u<<sTvK* z^wxD*t2qYUvAjAO{cLfJDJf*AR#*0e$|J?jkol;E5Z8K^Kdsf?0e*-ULPM`!FcB(u zk<+#zi2zcO)%cDW@LHTM$c;FOcD{4%Y`4f`hh$m5CbL2Wq7PjYd-!&2bwA`{Dr)=! zl+LPa4LMoDoH`p%QO<vJj_N5?WB=mRY}%_tx~$pdIZRpEld#C{%lcDrQ-9>6+ly5t zUrZ~|=FcsYi=AAVqm}D`GW_tg6eNF2hF{*?Z<Am(PzdQn)vFrzu^B3~>64u<8@Xpx zN3W&_`tQC)d_KE|3zM6e4S6wS;eT1i4C&aP?0U*~cK}IK=K+3U8r;pdkE%>9GTmid z=UokC&FGaW{qS*lGdK@P4NA3kpUU@-qHDW&f2iOyQ<C29zz>mI6K~SYr8)@#R{pGY z{+ajA*%}4PKmX#8i@c8#(i_QiXG2ijf$Y^28PW86Bz@0L49Sn50vlV4VfqPn%o?r{ z;X2cM@hI2+s6S<4NQdO6N(;&xkVuTWP3$j%s=NG6$P}JGs`U5DDinc`cU3XWezG}g z*{nXbi#)BWHazh*z85OwlxV`45vawsIM7Q5n&kZ_CXPxgpXKQ@%|-d4-@Ova|KQle zSs+B<xAjeqzDqK};`*qRIUf5$E8;27XjQ+IU$4?{)yjczXA7657}eh^ALaJH8}#3W zSQ^#4?Rk)d?O(?QklytVE8pr7q}58JNRws$Q@1^N@Wc#%#0(SBlD@fB+p#}_b=BTE zb#uyNVErXQSkw+&$x^60)2yoY_sTY_vSLNqbhz{<hp)U5<&?nxT@>UKUw;N<H_oX8 zfdBxg)FZ8#bLln&MOA~-JM#tcrd`1XmD`=ww00B7!#X~acZX`i$q{9rdk*?%dw6%( zI2*CmqAxi=(wcV3SPx~->;AFX?&D1k^Iv(#a?A5PL$^V1OrZ=EW+q8Z@!0IAB_mLE zNY%1vP-m%PtGNaHGw4uVWt%qppwz>2T1{66#;Zo=d&TSneDQmM0d2m4n!X$9R3q^! znHr|~{=+ROadTT4q`wPmWAjycCUPiK>1tAZ#zbLzvEX+4ku3eFy?duq_<4gYYQC)6 zantv91Mf}mG6l&%Q_HeSu%A+4uY-hk`okA3lP;!h8sS^(3$>00njzy~?pdz^YXD2) z@y?SZ%=0=<uLi!Qn^BL@guz41z@MvDMZ=N0_B7@0mnquQ=@)CL(!AWachw}>f-=-{ zK~y}Be8F>$s`nCfSdxG^fnGj1=EqL|b^pbE5kT-85Ng5hE?`^Q(Ug0$rOQt<YLPc0 z%xQQiY68Z*_6M4ukK5L{Z2nF-q#gCdmq|RP2U4~QDHX*C6;M4E`AMU*w8XZCs8JqB zSwrc7$DEHd;tO#Lg}<?Ix%VmcpENopuy*?oN%+CRz-+`g{c~T50i(@4n~EzXw4%k# z^q`Z{VoJqN+>n%unJ7|jk1L)Y&K}K9l1<we4<4)keWBPlR1KMDxDH@)CWE7nB}wgm zP#CiSZf1kC@v5ZR+n3<Xa*jq$asI#KCFt7@Z#w<*qk!<{VnNIUkj@*xbEd7!o&*Mj zcvPEehScf<{3NFQ%%7@Mvp@Yf+Vc6Z;v0%EclElT;DnwK@JTL*VQlp3-fT_m#KqJ_ zdYWxl?zOs0!8(}~%@UtLXy5h~^$}|?2f*oX-ofuzX7N}$-N{OA$Aog94VY0#I`e|; z&KCH)ro7D~93%}%!#!BPWnWE4ycO{J?Kp$vZPD20uUu={>z(lGzby;4ol=sVIWDS` z!1`*j<+P1`q1sN_;u<+T5suLRwbGwK9kAsKz*7)=(d-{VgEusMV=q$!Du;0rARidr zYy{nc?d0*3*hPkryu$M(Il{>4NLLgJJ1nT0F>_RfzNTK>Hk9zBa*MVfEp0D=GX(U- z0qz#)y{W*1!!J9g2THO?R*6Zp4L{Trm_%FKTLC;ueDn6>T^~JS3Lo}^WJ`--?He&7 z7aci32<lfdLN0Ktae-Zy7;1ZU!4;wt1X`>ahY$RfpA*`bIMaZcxY_SqD;54Rel#_{ zzpvNaf(!-yE=Qk@*L!CuNS+k{<9{GpDE{0dW9fb@XIOS{7C8&Psr*#IhY7Y|?B70= zIW@Ih)8;db*kScp*X~UIl3V%-x&80ZLGQog75axD9k#CE8u%dobewP%xAUYL&y?X{ z%w%oAbzG0lr*7J?CYCo3(alOEY^9`nlkR@}92tLFNDs#|9k6}_5mQQs1q~jB-4-U1 zXCi~n{|T}EFolr2zX&bAA8Iz#JAI_1rIjPa*Ymo(B5n)i!kYTgoje{3HC#+rfRALm zl?@A+HF6u6FxvPyLthl4wBR!-0nAwTd%2mHjV}|qdfbyhIx1byHEV%<FD3sFi{RZ& z9>kqmu13|L`!mA&0u`|hhCP6wA6-hlOH2H1S#$4JE%n2A9RY(rw<py|0+e}4#%50F z1)ML2wPX9VO1ARPfV0V$vJqIn=hC79h-Y~*#2~_F=D|YQm1Y-uxun$tAU6smi3ViL zz=U#;5W{-RF^juY7}m&Tp7qf;3(IcG(g6R9*`8)USo&E4hxYeE)q5%V7k?sh9<nq3 zOV$c8FN})XGA0Rf`7p`qHD^>Rd-6SfHKOhvyZNOm1OQ*GIjm>~CVxlm&EvI6?Qm!| z(|cEkTx^SYCtdK$C#RV5({Q@MZKEB()(BjXiQ44n2I#-6xEdf0tQi_GrXWtNgjd17 zTekx7so0TYGkmu7CD`|Q>L=pf43RJa9HJRm0--7vrCSP)KJlsC&wy>DpK4ObyR9fx z(K!cGTV|;qSiH$q+Zt^!ZlhvzT)q+}dL36_B%gk;zTcLRx%@PExJ<TnG)XP-iI|;> zF@k>Oou{V>nfJ(Hll9DliylR??o+$@fwrv#u?$>7-8WuQL~&@aE3&Y(^7Z0Z)1e*q z<Vltsr4FKK9&OORqvZ~ubBw0tKdrIJkgA=$zAL1^@^9MByUa|INMX#o+EFbFWozgv zLPE@;LM17XRw^kAlX+8b*xcC6a?;nDL_K>J_qlq}71PNw?tHy@WdFYDL{V>xYsipm z2wE0f`lK?5M4Fe@v^W{c%YwdB>w28IRi^s};LV%>e<lD_nqvG|#i4hzU@Z4((fc!8 z35NZ!xxlcHNY~$VJ!z(iM@kxA<>OH-HKh&$rB=n<3VNlnS#Jzv;_q=@Jw8fW9bSEv z5kI^w)p7(6_^m6x5f-WzfzRe0L=KRKwidYjlfn~NZdJKvsW-U+Kzl8azMA0=Nv|iL z(jy~CZnP03JC?!9teNV0s+~b0VT)q_ePBlv&YVgAGM2cbE8_3iD^Rnal-et;Hr9it zAg;@u6p+Y10`i|@C`yjYK*3M$x4_IeI)r-aMRI$yewXhq@Q(^$+Y{DT<H~rTo|QP; zEYoj4H${-(E_9ovZ;jeYEvvDj(GzdyhR6CKi>B@UMRTu9K))a8E&A1%L6n&bC3gMT zV!UzuhF2l@0*p?5i#BZ#z!r1k*vee9;z$iX9-izuzi;gzo|d=?>rsPNUMfd-2r~V! zN1nWqcMsJS@G>H0Z<~E9v(rS4@;4>BnEE+;d1T#uoyWgi?m)f8_U`xh=}rFR<K}z- z3ID&OSXF63;J8=D*IN?AoSceV0G1dw=N&kfA`yS5)~42A(FZUzPZKz)@vT!Hg@%z} z{~7*Iv-rodY@1?NtNE;djMt0w27ldb{dad|#y%P69HL)HduQ7S29`+Q7EPbP&me`E zko_H4Rk6yz{yG}qfA^gy9$lWn$H!}~_#r;at(zDvU<#@MdY=yUM>p8CqRwJBFWHX1 zY?s@(4>?{0Fs&@Elr^}XodIt8s=r@H3v}eo+{1OwUqR#9zGk%9yTvc^Eo?88miGoe zN2qiX9C6BS0-BRtVlqE#Kc8ECy7*k+L?wFHCQEoHx;@w#d0&ddSMFj#-Cqs}V!Y_U zvqvEoWW@(ds6jfKyz1vi{rPP6u_qb}-a2G^7W6+5hBq_bohMNpiiXpc)pA~ix#Y7S z6*DBW$?BD^e@bN6eMd|(2^KE*1wYrSDVTc?)zNAGVCWoK5;&0!WHSak$$rbxwxe9I zR^n}LE-cu8vN#>Ob-`ze-LLu~E+dsP8wtc#zWvJ9JoqFIOJ6HrIcPsc5jPT}Bo@U~ z>`6iD=4G%JtearqPfsk=G18v4T!ZyHA%4BqY^a6_>0M4B4ES*GclUTL{7hDS9%{e+ z9`G?K?^bFhp2Kq1%Up9r*Vc`Pj7{(*-NyAs{C;C9pK~i;@&7gi&P2If8~f%OHHA=Y za-YI|iJN@#O4aF}qn>qx6WY8{N|d=Q^o>k%**8F2d*q;cPqf-VP)wp;;H1gVULv>h zdY$Gk(S&EbK2`55-I8a<S45@ZuW<U-Q}&y}j%|1~uvEqb%4?7i*MfsyFndh32-p}H zD7CxUK3|jLf*C|SG-LyyE+2GUnVX!r_&1j({QOH)8BZ3r=)pTrf`E6h!z$FHa7n|~ zW6HLTD%5QFz{o)81s`w5gV=_N=mEIDE_=HWz@g6dCCGVv-UpWXgUPUhb#v;Mnvr3w z`WY}W15h~q<^@hjqCZIHr7JQOaLQ`Ij|~k3xb(Uj{CRZ^C4@S^q%>GQ`OzD)m&DkT z4mCSkU1e_Dw(3x(mb&t}V>=zM+@_Zfzy{&J?4$%tc&T<RmNL^4+@-stkf*A0P=|SF z07}h(D+f*_V$Lt%f6onE$E%+hyzXj~5?y8<SGsGI_OaAbSt;`35p>#^{#}!0$$`Fj zk0&8`a^p<3R6INWDIfP(Pkab!%*iN4g@XO~I>A@@n@>BW7HmC&mX<ck1@`Etof71V zMlO1}w`&xW4rSSYCl$u~*XValZYPE^)Rccs)TD*LkbSQ`cn$1(&<mO*0ub<zry9cq zYoikYls~9fu-ji|y|xqheB<Et8+6_)RIi*5lYfnf`0BgUtn;OQeeI5|?Hb5!d!&Xk zQ`;{9Ok%%ZRKm9yDi8yI-2~vwagBw7J`x#Nqt;e7Ti)zy(f^Wb)D{+IM3{%E5WHV1 z^4foYr@xajBq)BZt~u~kM|a813WVNYo#Apf4XF;lZFaaCNpnpqU##zNYlR!eao)i= zBt>>d_4hl==R0|I?0w;WNE6g&+Z%1Q>`gr#V98S5+>FC@N6(42*o(yeI69;4Q2EOH z%<z=Oa-JC!>z~}zwqeX;WKAI2VGH`L-c45TpO(^)UG~ShvjkpwC>J=EtGbYL+4%Tz zH<Z9Uc;Kul&U?Zdsz3jXxu()IE|Y$p$yu(Rub%00iC1zz^Q)q$oUuibx8M3F_JPIA zNaMX_OqHlEn7l@p{0M5O1~JY+Jxg!MrUhbjN;XHkNm6mWaRlV78j+K*#eO0a?j^QM zMIR0zmO&i`k@N|YmWh%2l<ffSxbNatq_rff_djLyo|yKZ1^f8WGS#jP-JDy~pLu)Z zO+Ih<n@Asfa~Kwrr$h86ttE<FBYg3lrqX}emyXT7*6C(k?PgT%p7Xd8%`w1#eX2Q} zGV^z}L9EzB1+T)4!ABOUdUII}!Ef`lZ9r-1eU#xf?+fY8^2Iw2W>k~z2Eu2U!tz=F z(+jT`!L;pz+Sj|<r~8vaz-0SZH}#r32sbb%)o@7Xo*(PLHh|fl=XO-pe1U!g&=Z@H zB}@Nv)H(M|)6b^N3*(j<&mv+uOJhj*Y$f}rN`j>HL*+Aw?z{k}Q+WTI$S@52-8=V+ zdIaM%g-i469iKTk26xGcB)WeT9_7{1A=@%)-bZEB(Hu0CAiy_b`DwXeM6ikK&)x}F zhoP>%dc+XWnb#URJ$;rn+rBwHP8+wkTq*iFP>R`O59v(|mt6R@)70-eP(J8TKGisk zyjoVlymq{y-rMcnB(n$?cX>2ey|UWMY*rQoQK`ao_=J|cT6oKl+-^y249Pu}#8{Ey z^@Q!hv4Y9CsD+(|pc)gm_>84?)k4Hn+nPx;vJ`Z9jmQ9H-O^~MZF92^S;o_}`zu@2 zok?$6xh*um=IoeOdIYb|(BGY`nm=n7G3#93RCRc!^fz5jmX(A9p_Dg0o%W^yo59ra zY0}jf|D;nr1ACBugn!4#Kv5+hI7RoJg7uyGz!S~#OYW+npc|fGTH-N=6f%95NW7Wg z>H9R?4?XTMUo3~bZM3XbJcZb212&27h1^ixUc7_ORsHUx5afmb=2$VrKSOn;^A+@R zNMfN4Py}Dav;?IFutVoJ-N+qhUa2Hdc}-Aa;4E<EfJ$H1ecDp&*9Y^x?Zy#MrfFJx zN}Pl;e6>Tlayvo)(7>6nF@Ak6lzZgx$Gj(1m)Rq~>zq31i#DI6ejgcVYOib)6X88; zDIi+<40THHgS2`Ta;#}w_)kbaa#-YoUp~E>RedMh8tr2dJ><vALruu6=n5lGq6a8R zzjWyAJ>7ZuicbGk3qNh0!qxn7LJPjas;cM2KN&Z<|C#DgB5oBiaq*Qm4u2-I)3CXB zL1KL#7EnE+N4>3rlvf9osE(_MiZn=rqKYh1BeZKXlw;8S7F}1tq1|S^660+<K6nCZ zO}&(%!i;j8p{LXYeamepJ2~(BcEoW!l|g?PsxWxC0sPL_khh!dLzkSvDn||$di2NK z@W(TTWyz*c&mj7)_QGxi)@t0jJNVa_EL}A!z_RZMpXPVEc~xcAvf21bdK0nRwV~t3 zt;xi%6^~r`!jBa=b^eBZLr`SCE1LK`Ra4?~y@M;2u~SgrVK>19$sIv_i5hf!lzjwA z@OOtZb#wkY{yVjO*0zaq$t0)b?V}{jjMAf3urOiVv|JAvY<!Ux$Y&jHY`#6WbQ6f9 zUL#JPcovvNMedxxboSiAW1{aWw2Aa2nyP+e?@_$`j?RDRbTN$%1<q`Fs@8v@*nj=* z3BI9_{!XMaTqDveE@-(fN+VCk9IR$eAJ3DkO&XMA8bN3y|B!IOx6~rAC7X88Ildoe zML)N?ei_vkObV?mLcpo75wDsfC0mf}J?kqs-IRp`<bUkh=4>ES*?nD%l7ta4)TT=f z;=L%|T8m@3c*PcC+RK=3d_U9`nYRaKquan~2QZ1H_6GC1TWcpZFLly-KFQj%tah2L z*blecN&#AVgqSeUp{|(N$_(*xtF(x35vIE{JH)|QU~`luHpFpH;w+YZI_7V}J4I6S zPZigrEGDUIe2Yee{?2v>LDBQdgURmUCV`coawJswuAfzsUL5EdJpJ>-;eJcO3;+D! z)mVQtX947{<@m80mq%}g<HH|}{Q2!q9<eNazf^d7m6Sj-aN+fBzFwBG`gZ!MPyE2q z)?gJ0I<w3<A2^~N*V{lnWB>d?x(uVdXq|HrKND5`xr^`hdX@=gnv7{!7d8!>3bu@l zIln+x?wff4>B4+x*G-yRc0$gc%NiDO5B9&EtwhgO<|QZYh7FRl!e$Cu8%>eFss?<+ z)koncO-|gRLB(6?cG3@l*j$4x`||B4xr+w~f80e-O{N+JUSeD}<M7J=Ddyh)neP8T zfL~n|l0z;Rl4em+jv>iu4v~^lPIJg9XXbpE<5nu?)0H%bT%t&0bBbY$q{2pXK5a8{ z7&gbuFyphXAHM&>_x&flZ?D_!^}Icv_s45r>ZMRe!uf7dK(R<w*Bxl;2ft58Y)c+q zu2>+(3^|mz!AI<A4t1LB#_Y;<70gDzH{^2xl?}Y7YBBOo2twk9G-YbAY|D{Rfl0LJ zP(H!SpE-J@W}r}hdR~5f37<)+_Xma`oh+I4=%aU+?&W@ZV;4wG8{j(F)4#Fsb~L?+ zGf{_?-~nW0%gS)2;jSn(dneo_8d&j?Z&hmJx#UR^a-^Z4qe`wya4VzP8I~&KP)Y&$ z4aJTYSr+>{F}GdBmo#ue__!GEPdfi7=B&d5E-IGhP@uau^WP(*x=d2~p<^e7J4Xxr zBfB-6zA-{NPUP3aE%y}+VT4H(#pp>E>jDdJdB18KNlcG9S_1f6bmFH9mS6$<xcrO( z#`VLV4_+27n&{G(8&syM9#_)6Fi3F<a|UO(f{>$Q9%LULmV~V@0@HKUidY#*cudBo z&X*q+pSCqn*xba4ki9C`Nbi6HFS)Wg@tLkkb&Ko2M+W(Yjb;o>URQJqNk~Ol6{3_Z zz|swM=Okr&pT`*V*2+_*9I+Z&gL7mgU~6uQ?FCMBM6s&-?CsWFO6>y=Cu=395N~rK zN&&I)(d#9LLqO5V6RT2X6u!Z+KVOYJ;oQukFaNb9zSSV9@W<v*$Z(~_7P70S3l4^4 z){*)G*T7;K`Qx~@)!;Z+>G$&vWUhU&QYe*O9HuK85kvPP!N6fVcfoHoee~<6Po1aG zb`T%LiyRphYl#=lfVqrmv$2xi`I7Les1#N&rtBR^F=E7cf-CP<4;Z1P#6kt^`)hjY zI)*)`$XYthK10xlNp_Uw*8wT7jK&}dTAe}MG6u0yDMIoI$jQfMvAtB`lG(_$Egk%< z>Dw?hPl|yzq+t~w-p#k#SF{C^9(9#HS)^f-M=_@99QFJn1kZXi%};J~mc%#b>5{A| z$^0al8yMG=xAa7KN>rnNjUVU7f<AtIY6;&Tw6+JL|9V+7aQAV21w6Q%y=Ji9Btc#p zyB9*e!p=Mg7!5tYPN<zMHnkr^pOIl*ED2OMd#whP5}n94X>hgWoAa=gqQ64WGU(pz zu`P@vRmL06RbSpBu%)Zi^$Xl{=MZy$xh_xjWs8E^wVjaV8k`cgPhjtupwAu5+dQXa zNc%x2V1e^2h}yq`<fClj^@e-&_l+^kwLeRB&zYoe^~2ioWM&qF@{*@lmV+Mo|Ejt# zqqxU`L^4i3sM{_%CM5SQ%q_h)?RQM8iOgWoLGboAkEjTz<o&z9+JsMwznFFj(RnxZ z<EL7yZi)c1KC)HIGiTMdw1r|HTq5%NxmX(K;CT1NX6iL*#WAglCeFt?7^SAo@?CPY z9&(|^$=w-!$jzUkhgwqCX8gjxU(YRa#Yk$r6WDpyl2Bj_D8;&!l7s?VO+SuY3fFDU z3ttpkcA1Ym7g~DF_heR(RTkUi>z;)`TH~RLNxXtS?9lMk<ei#9Z#Z$8ZJZ!IzZl3} zhg3%t$815VpG*h-B5PS=Z(+_6WXxML**9%{KcQb~FY{4hbF=6(Mi}S2yJr{FydhYD zX`(%=-SZeT-|=Q!g-Rrw{wR{Lr^(EpUA{)?^S%XnqPAGIOq)Xc6)xo{uW+rX6=tN# zqTG?3kZ)i?4@5Os_BP}ZYtL|#b+OGqZ$MKHn5e8P;MFIjn%<SPoV8Fvsna-T`G4Ib za!~{^+%CB6;~9&Gc@gdAMcS{c9Q?M~WF8J|X{~w~YRg&O=$=bfHuD@SAQ`~a3)nJ` z&o$Flk@lo)J@4btgi}=$`WGM}*{LI_q1L!G=~6F!PlIjgu9fYa7u=UD@Hur4+wDp7 z^M!@2rmGyr$)9B4K{^5+vJ2GL+AaaUx?x<A6@rj=bEGY*FHpbS)-(mMOzZat31-t# zjbSwoa@G<_0`Axme$TFIxCB2%$1y{mT1S{#eN?{;Oo`u`m5V-VD%H%(y}z8O1L#sC zR-o0l-u?F#vmI266w8BZ6>YZZ)77$DuF%A|4#5wEPs^K;V%2fBSJp%Wgqv~2GN*Z4 zAkSysE^nBb?img|==xRYPF0;|rEV==k0q_lYh-$QB(Z(IZC=TCKRj{WS1+nFlT2>d zyeJoN5Oeyk!JxX79WtU%qA6hbMgJ4h`;kfMa?f%&Mx<G*Owriton^jfTT^pmhI5N# z)H8hFL1?2>{b+>Q2@+GD@Hr4Fvk|w(H}&~DT-9?#`ARx}L=ne9wF#Y{H<HesjQxUR zi=30EU3@X9=}E=WtdHu2?;|5qBMdgekuO4qMP5^FF+~Y@mQ%;1>D1I;wSsl0NZLpR z!D8ei(FG<gtlALNv*7{1RCAT#z#?hp&!kUk+hG(T?6VjAlIxlQ-!oKKGJQ=4YPui; zx9zzyDWwnexG(tXS!}tS_3_KD2DMSgFRxMV#!or5i<m#;RU3*ta!E<ohPN@I2AQL) zFc@lf^oN>mK4NFX5>5TyF;TZiv)L7>Cy9`?5`{X79rPC5y4`Ao*BREoTB*$fone*V zs=n9X0CnK3t3f*r!NoONa)Yy|le5|+)co9@i%kua+u7>%vhRy`Jn=YkAhp(rxW9Qj zW!in_CrC!AtZhy!E#TOxu_n2*GCJ-D-F(mhlwt^mM=6&G9LHgzolve}`JXAEn&P&d zZ%-fGGaqZcCnph>PdOju)tbQrs3j1C|JLMqOfIraMB8J})nB(p5nhRKhjytm<nsRj z@jWp+=6mv*Z-$1f{&H`F-DfTKAj^rqBD!R^HsqhsYRYEn;TEK4chQohH)EGwi$JHC zji-oXUV-c+Zh516-|Ao#|KslhLD5a7Fsw`Nc_7yI`XfpWJbFvQzyB6M1tk-#I7i3F z=rJug>zP1%FhR>Gj?S~<PS-a-&4vymA94p8=PFk(K)EOmpiDs%!;_g50QfL5PwE#N z`o%wA<U39Ir!ONkv+Naft&<%6scmnY8{yrK;%q*s>!EXlv&dVXLAP<2N1H6@!k=?y zqX0kVQ<NwQr>K7i2#f1q7;Tz_rf;R@e0=Z^+o*bP_a=%7yrQ70kF1x;xPNGov@%!| zce!&@N@UV?bgfA5N@G(D9{bv|xKCL)fzrSc8GJISxnBrq)52m+?%#oqmg;tfWXayp zeuheM3t-4YN80L$dlpx{D^oTPUKy=N*)%y*?nFs6tCi+=VlK3MkgCIi8_wKp>dirx z?33iTe1p`R+k4I4$3wO&)$27MHbHnZJv{%t;#b4}llJ^DCxz<^niq}Vb%78^TC9~= z;qV^$6lhgsgk&iv#~u!klN|I?+zV|C`UOlzn8cp$1=*^gy8>db7W&xierh_gMnP(v z#~-zRpNwcHa^Lk(|C+q--s*Ks1Wb)`kB_;QHsb7kZ8KTEx7N)en^HVuQCfA+aZVYk zbnc}GJxLY7&**mpR=G)=;D{nZizTkH9VE2xbM2?UMBG0<Lu|AtGw>+q)JEDGkBtk1 z2=0>GA020RJq~a!*sq-rRQ=dq9mLiKVmGafM0V0rw{B;R-mp97VnYn~EhaWja3;Xr z;;iopEEjZ8ekLK5%<MtTrOJ4wv&GrQtdo<lCwf&+F9BwBgO01;W4i1g>79bw9p`zA zeX<Lq1LGPRbH&$x@;^nJkG)|Y2<_o8u)MGx_>VH#aPZBU%Hh8|X*~?2_nO9Sx+ZU1 z#RjYF(Oj{9>^7czWWeKje5>6+06E!Qtv1G}d^XpBz2~R>3gWf0zkdF3+8_>blFpIU zZ0}tWufk>ap<3CDU)Xk#&Oc`mQ#-Pn2x|WUnIPZdZ(o4$>2+G?_WD2$K7FcG)ogt} zor5<`Uh1xtqCbxVzUpb<_M)qoW>!Yy-_}vA1Ddd)Sc6#|2_Gb{B7K1wws6pZq+%Y{ zv?y~6ZvoqgZiJZ^tG1bS_soWq)-_GOJ;96P{(ZcW%B5cb=-#(kZwjw|!2o)-RpfX* zo(iWw2)3HvOOzmszU1!!?7k&#Dim-g?<7jVgwy9&b;??pxi(q_0ufi#h2K4tTu>NF zO}Dw|ZX2TBhTDf7OA8|h0_tg*ZdqSm<Xvs3&t0Qk>zOrVpgqNwPyaK*?#Kv!PC)mL z=K-+wKOJe}V%u-%b|o<~zDqww-fRFq5NyHrTkJ9#?}vWRPpWit&xah9=gL|whg7TV zy8_f5|A^&WIc<S=zWaDu@G2LQ1Rvu>aalW~dsTVUZ~|0!;(R;AFa(kC!`h<<pTmXw zUxeiYFtUW*miecF@oOcTt3+OKI?Ar{9Oehmj&0_4kwFMDcQN($D)>DeF*^&-PVPo{ zQTE%?kQb@u>54mjmZNgwG=*ZgwIyu)1>FE3c{qRn&*bu#Z!blQwa{=Y<33H%Bz8`K zfum4crhC%W-tkx`)@Ktl)AG>QW=FP(#>fa8@mB_-t8iEUc#z`vc7e9ixb5_$#rXOl z7TKPI<aqxVe74PT7hPjS4<1I-qpApYyj`F-i;prG3@yKOjBPQjlRxyccsE?t>ufp< zvOZJEqF|A6<^J7+VnvY7)=xlGyb5T4jBVZZ^0u-i>_VZmC2ITXO!2gkr_{6;5PNHA zEXmqnmD_B@sUk+YK&n(b+gjCeZY!?tinYF5^2Bg!*K)FikAITwn1ppj?sb580Ji&B zXmPnFBRduu{0S*=cb!E`TEXs>6jT$)wCdKI$KC()O^l+>ERT{8dC_;hZW6Utv12m{ zJhM?_NWto73(C*Dmlx*8lt18UY6S-!e0+h5Ub-B=T)he(E-m|~L`rO+(mrAPXOk=n zlJ9lDy374tmcu3pipm?|iihIdqq1Kez`=(*JqcNO+pmR0|ErQQ#$R~hbh|0nH)@5w z(?47f??d1WjfpoQZKr(lcsc;(0N6dQM@QB2CYDEc_&*-x+1xB>?7UUM|I~F}69PT~ zK4*6%zAQ4fIaK3@|Ch=Ln%+bIgd`8GL<K=uSHd&>?XRHk-<ZVQDm7DByUGvn6tgK9 z8aWHW)%&YeeGY<7;J?YWv0`ejbSrX6+dtgZ$i}VxDf7+;DQVCSqK;squ3PdS4bLZ; z-*WdhHxjj6L553UK9g~{YJ8H(-QVR9j`XV!U#7t_JzabkI%PSk<fI{IHvjsX*JU+D z5BKcAZk<~`d&&*pM@rsEo%~IE=ia{<@O_5sKXSKt%fjw@S^YQNg7L<%l9=k-DdsmS z(9sh%*AnkB7W^$7){L-EW1^*kLKiH5SCb7t*j}AXRQSJ2|L-l>|NEzM*#5`SKLGUc U9yNp8|1IWjo8B`)8@na`4-{Vh5C8xG literal 0 HcmV?d00001 diff --git a/docs/content/tools/slop.rst b/docs/content/tools/slop.rst index 75d40ca9..c6f265ee 100755 --- a/docs/content/tools/slop.rst +++ b/docs/content/tools/slop.rst @@ -1,19 +1,39 @@ ############### *slop* ############### -**slopBed** will increase the size of each feature in a feature file be a user-defined number of bases. While -something like this could be done with an "**awk '{OFS="\t" print $1,$2-<slop>,$3+<slop>}'**", -**slopBed** will restrict the resizing to the size of the chromosome (i.e. no start < 0 and no end > -chromosome size). + +| + +.. image:: ../images/tool-glyphs/intersect-glyph.png + :width: 600pt + +| + +``bedtools slop`` will increase the size of each feature in a feature file be a +user-defined number of bases. While something like this could be done with an +``awk '{OFS="\t" print $1,$2-<slop>,$3+<slop>}'``, +``bedtools slop`` will restrict the resizing to the size of the chromosome +(i.e. no start < 0 and no end > chromosome size). + +.. note:: + + In order to prevent the extension of intervals beyond chromosome boundaries, + ``bedtools slop`` requires a *genome* file defining the length of each + chromosome or contig. ========================================================================== Usage and option summary ========================================================================== -Usage: +**Usage**: :: - slopBed [OPTIONS] -i <BED/GFF/VCF> -g <GENOME> [-b or (-l and -r)] - + + bedtools slop [OPTIONS] -i <BED/GFF/VCF> -g <GENOME> [-b or (-l and -r)] + +**(or):** + + bedtools slop [OPTIONS] -i <BED/GFF/VCF> -g <GENOME> [-b or (-l and -r)] + =========================== =============================================================================================================================================================================================================== Option Description =========================== =============================================================================================================================================================================================================== @@ -21,6 +41,8 @@ Usage: **-l** The number of base pairs to subtract from the start coordinate. *Integer*. **-r** The number of base pairs to add to the end coordinate. *Integer*. **-s** Define -l and -r based on strand. For example. if used, -l 500 for a negative-stranded feature, it will add 500 bp to the *end* coordinate. +**-pct** +**-header** =========================== =============================================================================================================================================================================================================== @@ -28,57 +50,92 @@ Usage: ========================================================================== Default behavior ========================================================================== -By default, **slopBed** will either add a fixed number of bases in each direction (**-b**) or an asymmetric -number of bases in each direction (**-l** and **-r**). +By default, ``bedtools slop`` will either add a fixed number of bases in each +direction (``-b``) or an asymmetric number of bases in each direction +with ``-l`` and ``-r``. -For example: -:: - cat A.bed + +.. code-block:: bash + + $ cat A.bed chr1 5 100 chr1 800 980 - cat my.genome + $ cat my.genome chr1 1000 - slopBed -i A.bed -g my.genome -b 5 + $ bedtools slop -i A.bed -g my.genome -b 5 chr1 0 105 chr1 795 985 - slopBed -i A.bed -g my.genome -l 2 -r 3 + $ bedtools slop -i A.bed -g my.genome -l 2 -r 3 chr1 3 103 chr1 798 983 -However, if the requested number of bases exceeds the boundaries of the chromosome, **slopBed** will -"clip" the feature accordingly. -:: - cat A.bed +However, if the requested number of bases exceeds the boundaries of the +chromosome, ``bedtools slop`` will "clip" the feature accordingly. + +.. code-block:: bash + + $ cat A.bed chr1 5 100 chr1 800 980 - cat my.genome + $ cat my.genome chr1 1000 - slopBed -i A.bed -g my.genome -b 5000 + $ bedtools slop -i A.bed -g my.genome -b 5000 chr1 0 1000 chr1 0 1000 ========================================================================== -Resizing features according to strand +``-s`` Resizing features according to strand ========================================================================== -**slopBed** will optionally increase the size of a feature based on strand. +**bedtools slop** will optionally increase the size of a feature based on strand. For example: -:: - cat A.bed + +.. code-block:: bash + + $ cat A.bed chr1 100 200 a1 1 + chr1 100 200 a2 2 - - cat my.genome + $ cat my.genome chr1 1000 - slopBed -i A.bed -g my.genome -l 50 -r 80 -s + $ bedtools slop -i A.bed -g my.genome -l 50 -r 80 -s chr1 50 280 a1 1 + chr1 20 250 a2 2 - + + +========================================================================== +``-pct`` Resizing features by a given fraction +========================================================================== +**bedtools slop** will optionally increase the size of a feature by a +user-specific fraction. + +For example: + +.. code-block:: bash + + $ cat A.bed + chr1 100 200 a1 1 + + + $ bedtools slop -i A.bed -g my.genome -b 0.5 -pct + chr1 50 250 a1 1 + + + $ bedtools slop -i a.bed -l 0.5 -r 0.0 -pct -g my.genome + chr1 50 200 a1 1 + + + +========================================================================== +``-header`` Print the header for the A file before reporting results. +========================================================================== +By default, if your A file has a header, it is ignored when reporting results. +This option will instead tell bedtools to first print the header for the +A file prior to reporting results. + -- GitLab