From 8120a3b65cddfb81fc00170f32b94fc78282ff64 Mon Sep 17 00:00:00 2001 From: Awni Hannun Date: Tue, 20 Feb 2024 09:54:49 -0800 Subject: [PATCH 01/25] link to other APIs (#715) * link to other APIs * remove sec --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 118cc828e..80114d23e 100644 --- a/README.md +++ b/README.md @@ -11,10 +11,12 @@ brought to you by Apple machine learning research. Some key features of MLX include: - - **Familiar APIs**: MLX has a Python API that closely follows NumPy. - MLX also has a fully featured C++ API, which closely mirrors the Python API. - MLX has higher-level packages like `mlx.nn` and `mlx.optimizers` with APIs - that closely follow PyTorch to simplify building more complex models. + - **Familiar APIs**: MLX has a Python API that closely follows NumPy. MLX + also has fully featured C++, [C](https://github.com/ml-explore/mlx-c), and + [Swift](https://github.com/ml-explore/mlx-swift/) APIs, which closely mirror + the Python API. MLX has higher-level packages like `mlx.nn` and + `mlx.optimizers` with APIs that closely follow PyTorch to simplify building + more complex models. - **Composable function transformations**: MLX supports composable function transformations for automatic differentiation, automatic vectorization, From 7dcdd88e27ae1f3e3fe2a4f91239722e7a4fe196 Mon Sep 17 00:00:00 2001 From: Angelos Katharopoulos Date: Tue, 20 Feb 2024 10:57:02 -0800 Subject: [PATCH 02/25] Change the logo and add a dark option (#716) --- docs/src/_static/mlx_logo.png | Bin 7410 -> 78025 bytes docs/src/_static/mlx_logo_dark.png | Bin 0 -> 48758 bytes docs/src/conf.py | 6 ++++-- 3 files changed, 4 insertions(+), 2 deletions(-) create mode 100644 docs/src/_static/mlx_logo_dark.png diff --git a/docs/src/_static/mlx_logo.png b/docs/src/_static/mlx_logo.png index 49400bd8d51fa2077363be082ae6c66c8665ac2f..be122bf7cd07560f1118eef458da8e472de6a8d2 100644 GIT binary patch literal 78025 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 z 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

iXtx5~f_K>t0o<3?z3+r3)&x#m?MC*%6 zxE_I=wq0oxmUQ6D;+Y;GOVcLDub)(b189%auVIsWS8{^9e*VyFF+yL>lGoiYKhUEB zfwh`T2SQ51oF#TYQ`MQ+;w9DRCa~`D56RwLsWoUJfnW#bwVef&x|`-~fqN(8W3KR?G@S#a!7*m`S) zQ@e=PnEY3>ZDb%KIgQxcWb2}_WBvb0NtQg z6$$b`Foc0&Le&_*d%P}oCuSEU(~-@dE5>4{?N7|f6F{$UT_=8XTW1#?aL#~l?x>g8 zBgzXSKYqOtYT1~LQwtPc|Z0x`n)uqMcNz|>u+!0PC|=#8gTE4hR?lnI6j3C4gWlA zZx$$va&7>tKh#Isl0l}|JAw=20R;VPECw6q&1!H|g~KF~u4h2XAJ=HapI=MUSkG%D z`&NJ67Zqf%pH>|^2bQ-2+XiGd_F^+ zM0=(>S}(cYn}ks}jS$K-FQ)EJjZ(&POa+&NHNIwDQon49`)4)WD``^~jUf3)J&WwW z;{4!Gy^cBKO80mbeQ*wAn$y^BCR7)$CZEMWB&G|&iz+ISv1p`cL9(%lfX!#Dsd%gZ z+s9*@YN7`J z+%v^M1id$Znw|(ZnLZh`u@bMwSo{n?A|J_?JO_symP?4E@FQtvCAp>Wn&f6w-@PvN z>SKpA@8Rg(^amuX=tf0&najkrO!J|U6aM~4=n}jMN|d)f`<_oxjq&qwYwRkew|v%% zuGT}s>Fg4VuP9H0GL04yai}vWpMH zl)w9kBz4Q@^Yj8`XGsL^6nH#(@69z~PsEY|2=$6-fp> zxzeGq3Dy(uG2c)qd<06NM|;(ratE8taXV-GpJgI1K!h(Hco|s?M)UmBdmw7D&Ff-9 zo^1N_=J!H}LPEun4DjJ;^d&X%zTWqnjX=J4VC#T8<94XOe6xAi@0kHon-+}9r`Lz8 zIrp53Fn3bK?r;Bzca=|V=sBP8ILJia&^Pc(qlsPz{1c2Acw^gLm63>cQmg7J2*M#t z7NG-QJ9%sCn+(Ux*0-BI9*YZyb+9p2LCupg1=Z>z-p;(6lTIC-fo%edYl{YRXG%8K zVq|c$xqZNFdCQ>yVFwmU1vbD=3%SCqtG%g$FvrAy1;fe_+?7l%K) z2r=aTWX`Y6_o{ep+>yzxUGr3S2LDhV6!_3{Za|*qfvPQ$nSBqr8iLk3$NBBJ5#c5P z=g9u=@esWL5&n8s`ke+n=9gj?3xkF}ITnLDO0pRN(-^a2y!|DXbJl40x$!3(=hAL1 zbqSqPBSz3m%4rIb3hZI~X8#BCq{SP(qna@Z!{tW*^sBrOLz~AtRDSM=Dp70CO8Y=ji#f2ImM)EKKkg}&C2bN)eqgwE< z0?DFPn!QA(kNiTw$RZH7!SYPxcc&B;DHb(vLk~VlA7LarOstY$B*%uiBS2utlol$` z>N~c=r3(D3=pXNw>_{#FZ`6CP?s6T)7rcXXQr};fCTJgx;B*rN{;+G$DfO8q&-h)R zxE=B_W|TM5&*PJSvvMvCF?!#VQ2h1IMdQl{U}f}6OdBg)ZRC+7U_T_bUML<*K0Z$t|_REB^- zEIA+J6pQ6#c)(y=Nq{{vQ(PM45CO}Tn$uv}*W14(OF(_vKOku<%Wc^B<1Hg@X<+`3 zrxLesQgeg8K}d)CP6U{5b5jhMsgvR!H(9q@5*}O+bQ(=7==l?&aJ<79276l_HiD-E zY^kIuKZaqo{cobjCKokrB$&nzEzZl#iR4Y&(~C*>Pp9M0s!kInB5<~ zK^;~(&-%|wNh6^$F_Ta@G?-rsxkH(P%1Aw zgK)$=PvHg39cY5QAnHHcFo8x8X8C!CG!O< z1qA)6qS&B=Fg~aH34Bzd*<;(PBaKESpv8QK{ZfTB-2(MF$}|0#Pq9@xab|f3AHqsQ zt>C}dObE@`9JJ4sIJMfs()bX8k~e|tPPY?YOBd=#$crg;GGMj&Jx#1tR54mLf}@5r z(H&nkm8IUy^&*uIsXIJM3KTZB3EiVfD2e(`=9E{DArH$`$CUe+Loi-)6hK8X6`~>c zqfa)Lva*JYEpTcl(Og|!dpK@ulO2uN6QQPrpy-}iJswoB(*Xj%JwP<$JhNv${#Ej+ zvyoz$FKZABb4_-7^i4U9dBdAell8S#x&xA~SL`#x02}t34LpTZs>|7KUJRuzn!@_eMi|FUEq>~{}V zvHHb2-R5y*aQ0|5$SzYcu|ilx_E!Ka;~Y&B)*8LJ-ot)D{&-MydJNK1whnZZ zz`$RtK{ONd6nxP$wW|Y_e1*M)C``-yVnz=S@HGAz6Wq~G6~8BahygpnN8M@LdpyqNb$ulGzLhq!?I^!>Y^0~mK~R- z)m!`aYJx28YtTQJlCck6+T{31SZ`_Dt0YEioOU!I%Z#<$xXW1Bc^{1c#dB-yJQPyh z``5XnKv{#Rfp-h+gGdl7Cg_WPnu^|=5hG?oldIjB-#Jq4)DKWbcFuPfuL{%uw^d{_ zp*=zALW}$MJa4Zj{r}-3C$V-L17CS0nm`vV7(rN7fK!X-c8xnqyZgtUw`cjh<&o#( zvA|-l&*88!b(^65Vro&3(iTu~Uk|=Bd&T=E%bOV~Z!&xia>eO+Q8PQ~V>h zxTq_1CD;@V*Ph?plcxq4n}hP^+^i2<$|v{wj|}9DuqxYz#obsEbhBYb0$3vM%yJ6d z4z{5!VT5~L>hZccyH#LK4nE{g6j+_iE*boA-hA+X-gEaj!fo^CvltsHBR-xsuF z+Sawe+vUn+_^Ft*eIxTdEhlDfT!?70f*B4w8<}mn4MSzD^QuN@n}Wg=d$qj6hEGzw zm?=4ISW|HN`@vuzC~x(!)GM1Z4&SxVvB(7=uGt^Ag|{}ZgD6Oe!Z*LQW1+;|DH~W( zbmorB`qQO2`N+DHzH{0NbH9iQ+uyvO5l%21eF3fY*^H4dttt$o^RBs=QyXnSO2WG& zi6w6b)Caj02FlQ_lUGRZ2a$yV`DSh2SKy^3s7cGg{~_$HqoR7Fw{KDu5TsFJ=ng@o zrKP1imF`ADU`UZ}kP?s*>23z3LAo1B>4pJ@nfHv}=l8t1*83-Gu~_SHX6}3M{kg7d z8=tT(u$iHMgJo7i;$r&u{+6h3e7(Ip`5BTJtDp7k;tKx#E2A3wcas@|lP^UG6UTHtxzPFibo#QAKx9hHgV%GUOg|6a1o5@}%4IJzxH* zX4%%mmG}O}0d#C3RGXNH5ahfSi}ezGa{3od@G1_^CVZ>ATD-46^=&UuA3V|niaGRX zLU|P0CF;aJKbCh&j~Vdfuvzf9z7U}B+K%@@tKZWSeMwfoO<)2bW6D3sSSJ1xMxEVO zO=yNvx;m&~Ok$K-46gb{UbO}X@&wub1tY$Xam(l&j_$bJ<}NnIdm1MKw>5vb%a10^Z+;PD;*9V&v4zi3Dw^LrsnPEC8{j$e}4Yvy960_ zc-6b}a7?1z*G38ZQlcHXk;fERMBkES3`QWOFp(UA&Q2SeX0Qo zv3_k<|3@2hl!*dZ&8P&w%U7|g+S_{-_#cATbrXXGBrQL2`b_I{ouAF0hvAUD4+Z`w zJIDg}LYX%ZB~UV6FDc*>jTmi!*e^PTub^IogMI`L<7H93s3Xs*korF?*(vl5Mw4IA z16UuTNZ4U{##8Al4n^>g!?l8bI|#5$gOrTxMPL+_{}zwYM3B?|$&!c&kmwdX2h&k}sdk>lNs^3v0nPho{T>^zD#(f4EGG>Xr&RxN1|vm+F}z@`J6lK*qw=x-ZF@dijGdWnm+{8HY6 zHNvsgLX_o{!ADw_@CR0MO)luUY@bbDg$^AFmc2RQtu}%m(5^`T)E<|tUG-w4we;MB ze1%a6I1!JD-IsZ`bo>>EZ;D5r_}#P~N~CW>zQVcGiWe;|faDVY-k}us(pPjl3H7U~ zR{}pDN?#eYbFOve+e1x>kmG&c9Y~jF`=hbRT1)`+I}HrmtBhtRbB32mWYHXw)cAc5 z#``WD=tQ~(PA?r0Zs||Fo5fhF#*6`|NC!_5V8TNugQbU^(l zHDp2y>`{|$M&VbC&izHm_}Od|Rl_GyFoh;zr(XY@F_XL4&R8f>|A%CtN4Kr{K;_-& zU@@@I5~=SvbRoLxr{S^!uj*e0{b23OZ}&P>2Yt*dI0L-}4`h14|ETyjLDfp0))#k) zitW8r|bwNtMGQ-FW!Ir-veSe$_?P&zQ0q<{}RFGAbWu+yoUwGT16N?SQ)o&_P zBu3*GCzyc6W6rPUz2$W?C~h zn}mO8@x4$W`Fm6^2LY}pkkOQQ`J)e!nO^aXg4g;gU8=keA`$u~HL#zO?_=6hF3reF-?57Q#O7LLzxQ1F1|yE!b9ex5N&c#5@B#&AaGJMorUpzuUjA~LW$8) z%Pb2_=<$K@Z%og5D)`~99*z40P||mDj*n2q*b98XogY8qsIbYa#?X^m!e*njf8x?t zUPZ7V`|JH6-?^^4y}xrl+HJ`=_N2GEa{kp^URJS>9Z=B2Hrmc@2|8}tPe>rp+cCp8 z2s|oLt>)&cyGvis${&4|5P}`k8M4p5ocz66hE)RHABwCF^@$6R32wo?_(L``<-l{{N*l~w z>hciE{qI^E968tFZ=pr&Hhy_qRYu5O^8@|Kdr(r+(V6Jr$Wguubo;F`@mWc%n68vG5?CdDWMpYi#po} z;K=Y%eXQL5bt<0Lno3%5;qN;TLbe{kaFIhaImc-}rrh1BFWb<0UfWr3KNneRJ@(by zmV%KdDa@6cz$-DVZO}z-(u5=>6xHi3Nh5LV_+oTjM5o5N z^{rDQyKco$Q&yq>`3E0E3EkQAhOXd6qGa!vziEYqL@Hu^7A4tt{Huj9%ktg?W|1+l z#!KMq?nwNQ7t5#+UiZoZI^DdlMSJ2u9}c{I#?ug6!vt zV8@=qi_ss!ShBR&pgVl%DDebtvqJq?WfTHs7{c8;1yQOw5|P!`_*LVKkR5^dw@Nnd zt`25!{haDwlgjIw*bBcYk0lhf7(tOv3}M3Z2=)uoB{i1noIKDE@xS_XY&9=jt_ZIS zplC4fkKNGBxht^wsf(8R9h|e5Zae^AgI_mBAvcDH{M3>a@!euss<4A$dHT^l@Ytpa zBi1etoY{{3*V;pRl2w#;-D;L)RNUv*Xy|e45Te|^Y9rSZlROuz_|qVC;Xc^ZlclyZ zFJt#C~|rl?mn*vCi~$rZwQ7u`^MQ;$Vb-j z*)CD)p0!cx{`#W&NRxw4r>LtmEwt=MB~>rCOCe|Ib^B8yH2%+FTXHmCUY9DKZA(6# z%4vzU0cW}VS~4r;)tEd6Opy>$@WmWBpBU5+-1n?^A#+q~>bq+}4_Jvw?LReUs=c^w z$|-71r)EKpJVUV3A)D8Y!#osk5vikyu+v7bidoUe`hE=(avaE=SY|36%_YoiK6TnE zdVzQ$_(EjquUKMpQ{`!I3>z|uT7;A5O>d*#xy%t>S$!G<56KUoefkx@sn;iy3W&!{SP>XbV~pfiku>kf52+9p^^7lM3p`F9aC4zo_nLQGWGa%`Tu~#F5E}F+VnXP z_m{>$V|B{()DM>$xg%`@;Y#(0vF!_nHN@&oJ|0P-i@??2iDGsTqHrJIbBcA@-4%nG zoc(PpC=~}6DA~#fq%JbI4IdHRZoNcOMQ4xuvAISZV$ZhyZpg%uDJuNq2b5Z10Q|JN zGlg9jyKNbt{i*>LOZat6&df65K+`;NoxWo612oR{A>=t8;jv3_q>hDB^bO*4i`GZv zjCS(EBzl4l>Ixq|m#amLWC}!?Gskv&2ysXw=R3)g%<`Pi~Jvu}UI{i4cP*88yv78%%n+3wr&2*Irt289*QBNF|Jwg46tsmuDN&+BK$^;PA&|NU5VW9wyHEBxIrF4-3V`HWIE z;^oSc!EBuPR3D^p9-<68di&52YjW(>An`!j6!0MHx_@cw`OM#RTf&Toa%f33KbWRe zm2Nf9qf&!>{mXY^Fozt+6HisfUc1T2)3A%2m#ra#MdKAZ=8knC!1FjDfC`@!s-=iG zJdB)YShV>ky(gD)diNK2jsqTWG9W`h>nST!&R|+}kh=&0%M`(E3 z46K=(eXd>HstUmL>(RQGuJpAvn0*g{iqK1#>t#xhnxzQdC~BU_X?N#GV2ippLuj z!e#!ZU?xH8cPGpmq&{qL5+S1@QRlWT@|9~E!S44CQaQw`l!9{2uU0_uKh^fW3PDsfJ!G7^} zoxo2g#-SxoGsv9Y&wMfnDofT8KbDdUs--3dhoQ2&TBD9n~A zci?0>`O)}si!fiC_G#Ekw*e08#mic?4TYt{Z2%t{0)Ptl*Uv&tCJm zH>v!>^&T!<_l#!e>&_BCzz>DliqYQ~x+Z4WA?4NL;UzM#BW=-a454h~%n=aEw?YgB zoCn}?D#5{Nq2Avhmf5`ShASgWGP_kb>vZ)R8vA7AM`%5jP=a-Q2~*pKPx zy(*4*Y#ftqrf17dXFo!cL~>+EjU=lKS>A^$#Rw|IVt z0h?g!*iO~3M!8m?1(2k@F*!q}g8|Aqom)^2Lm_)kVSVAapK|WP;Fe*35%n9S3j!EM zyiM`F%8?0ZqSp_;LeA%i-QAgmzB#D;{?*|lYnEfe6ZC7a4@~&5P%k6KMK?`iwN-!B z#r0KVk^r{X^=YQI424U}NgutkYe29ak2mJ2&_)QXb;7S4?{1#^oG);tj*-jk`8MP*&K@V&c z7dFdVdQsS4S@?wYX#8+*f9T82w|Y6BO~m<6w=OS*vFlR<Il+(l$6)HJ{Ib!qq>=U9vhNOZWKAvOXIS=L)K9LMG9^i|;5hl7A5>ze< zA-J^Lgqco4%@eocfp2OR15W1?Ay!pXRPN(bt^9k?KRab%p!n#t)kAP9mw<@C;3WO> zfW7UfGptU|s~*>^1Zzi<#87GHPknldH88s)@b2sgnpd^^-wMqARaXAhnwGa}+KSh5Jh@QTzgGc0(vbew|UqG)hq@tMRyRTcZgN>JD0AGp%m|3Z}%uN0H^ zbN`4ITj~eQTthteG+h7u3Zt#1C94O%(11bmFKQTN=;Kd`j2#I!oC&!!R-(R)rh5** zkp4)e2ZLvn6Y!1{2GC0bYrS?~&$F#0)fZosREx?WYeE@4aKr%!p?kIoLU_}?0@C$l z4jR?KSv|;ve$vWMD+f$9U0W&L->ZroT#>|bc5VK`+0FcQ0cLNG!fcK+-BKtdyCZNs zK0T#%f)mH6&7-=>d@k&(|g)uk=R{TVR-hB#<2A zwzlmUB7>$%3H88!F?!zX;hWZIcApd9ngxZu!&|8ZiZ{6znsl*lyw9l@t4i$@nj5YC z2G|0h1O+nX?&8UwaL z|NcGH?zef^rfDiX9FOXSA>y3vmzoo#KszycweG6XvO#)(c2dFx^kC8XAj!jMGxctMj(y3w-tQ9 zf)iEzqGZ(8p!8i4WcpY@dodHZ9&gIt5N6I&@Qk!(5)D;qB9Kl^d~w+6mqneCqSSG7 zh&ovYA}J0$a}C%XgL&*a9;oI>+#TySbD7o3WZrOzBF?Esf4b5%t})^uQf9JLQG;5u9pg=Jfjqf zgXhK0Kp{6q1_VY&MoZ%v|5u9_IcbNXl82(B(W5f-vJ~p4yFPvzxQ&`3?dbd#o4(Pl zPq;^f_OpS_uUmab-rE4r@lSfX%b&s>eD6v-l9mwDC7Qi+5cm~i<_TcK=}qgHMoi{? z+(X>s6~&W)4)hIk_OEc#6VSu3~&+ z@DH;CYK692r{b}>MP_3Alj4Z)9sfvVRXnCktSEcVU}r|~5>{hEY5dsq{+(vO+7B0r zZTz*l=@jNtZT7^`wfBnDmQCFyIApCfWp*zW*QwuGx|EBEM?$%W!x_E3$jwpA7b9x0 z@4I*U1CIHj_AG9|iNvTlhuv)*r31A@uW}9uuFS&<`BEAo@rY(6zHZ{PGC= z&^LnSd_I;Zg6txzs<)WFd@1;6fzIbxS0ZIFl45rqeX^)Uwjp6htI z8O^KJ{qJYwrSCwADkbp>|M#aymOSKq&x1}a)_43AmF#m-1IqNiU`W}=6X2cehQYq^ zn}^#ePzig)yA_u}*c3Na9Ke3`hYQv@R0|)u+b=cF%ANf+p~DF$!No!d=r3k6BX_@W z-Ac~~=$@JYv7+=%RdQAz13qUJ_|TzWgFJzBKF3(bl+z~djrE0Mt&%A?FFk7jxIJFt z0QS1tPF3xuCaA^NLmi8Q9_`0+&z?9GN*T=UQn`x$(c2FLeOP~|wy{ha!W)pZCO?|83j2TC z8>6D6lsLweInW!!n_}xk9VdL0Z5RPpV+P^PikIox;-_PRy{o^bpC9l+LZUTSv0@K( zZRZqmP#YHMj(Wb7+eY7+pBsQ+`uuo~y1)O`QZrok1!A$>$PJ5-g;D{G_4c1rQUb9k z1ZOnl7f9nAx5MdCHGA)Pq0eo4*@8e#Z)8fCxf(0;qe)bGGF%w__7PuVSFt)Yn1)uL zQy~}6fPgN5odwh25fNR=_EfMF@jTWZ>ky2oI8{8j8l*97zWVQWAg{Hauq2SX8Pu5Mn2c)-g zx=e^f@;|N^BgGi^@+mAow`IGQ=oVSitdn*cDsUV95)feg@=88l!oXj$plY**{!|yo z>JOhH>M4k<3O8NalM$OlrMT=Gh{J-GVFf<$`p5=BX5fkwyO1uev zp=9CjlUGl=&z7x48T~YOh$f+sf%;v*6t!w6eMT(?*oOE@Lwk5GM>cdtu?_;~(hRrA z+e8X?i4i~^Sq^cO3gdA2Z}omK;Vl*(W#A7$ct7F$>gmI<9`Xw-B+J#v4A>hDly(s^ zo2C`d-R&39va3;6Wqo1fCd3vtTnWdnTSg_tN|?SYcvZi-Uw;1#AGB6gGZUpr3=iAS zLi!zl><6}>`XjU(VIzhO#D-hWn|(38t8cu9t&J`>D7A7Espi16_iL#+qwD4MLUsRI zFx~*8tw@8Ru-=NE$95d*W-R>F;mTFdmC$?!k(c^sxnj+n6##C7FZ zYu|^XLi`;8R*&;mhvG3t;tTwbHyV%6O=-JPLc}r)sOm87)uaY!l{~~GYYi5~DDt0i z{!oJheN)s*>qpGivgDk~!};oNVa0l%Ml!0dY>8_&YJ*B~VvrR=x59|)lrWES(H zVtGG4lETwNVUVU*fO_jtM4R6aXfK(m%oI9$ z)&!8$#T{N#vz`Cp+b8AVMIH^ll&zKVtu&&le-Lt~ZJ9YvtTHj_eG-~Z&dqDP-2)cn zue47RUfw8l|I91d-@4fUm=tZSVR}5U63ssfKDmT$nkJ&Uzgj?}szC|J4|jH=d++#% zOLweKt220)Iq(qz2YMF=QBOUt_%gg0*}zaJi{mv$BdxdovBvoJ!P*yIswBqsw?eNP z&Fb+7q<}qR#y%|!u4W+T^ydu7i9R(epp5?gwCz8s{iPvq}eON9QbANEz98aWo0KEfR}$TV{U)pa1)bp8%J-G z48+A8D08~QKST-~yBesImsX}6IES7&Z-nJ}#KvT&mR|7Mpi5`Yfqy=m&TNEhe9l7p zv2rnE&(sZG_c^`~DWfzN@A%BXEusy^#1{B!8h?#5+fofDKU{7*a3} z-+bd|HQ^4tza0ac5aXpjyVuSKYhNRPEi0O^dkErQqLy07j{(qI%C|1*a{EfNb2-N|p)VvJwLR9* z&C-UJdJdUZo9SdL9!d`PoHD3NiKka07So$Ts!5M|gQOKOVe z{bE>bWnL)hGTzw@SX=q%cE4%7-}HSWs3G=otRqrNrml$2??lkxrj#uxY+(W079>&Q zW`0ImQO&J9)k=hGFMuG;pYHxn_>eyIatEmUo!qbCT>jiDMR}z&crga@!Bga8L5*3e zgUeDO0@0t=c(NKN)W(*(Z2aJMt}9nsR#aaHSF0(!{2ta21Gy0aJQl+XXibK%1-vFH zC08QR`g^m#>w72UH1dxqVqhJnZRM1Ko4)DYLt}S-M+=p4phI5fs|6pYaD=p-3j20G z(Uz+dyESZZVxKM3@9yC8m}i6>8C7dgH*6kNP$|bqL`>29yZ-Y;>i>ZLkFy5Ua^o%Vrt|*gq_2SzNG33?| z@|xtKv<8t-95?iYqXCZsM8ZrAF|?nA_EYx}-$fcBU^remUE|~9)^6Gid-hYarggr` zd981*RZ*EH3a=E@dF`k)FD|k2=wMMA=0ELjZN!n0K&bVd%gaw(UpOri>V^}Ps*j1c zaDAeAxd8r?#PX`?Vi4>i;mJOHp!O%?rRmc8#Y0+wQ}L1s=hUv9CM-J^1|*V@ig*o0 z1(81a6DC!pp?ewLOR|y14;OGUVL$yeO1Wqm%Gxr}NMUB67R$7kvPK#Gvt1S?_TCaH<$R(oxP-{$ z?yrays3qKUzO<8~<3t55KmX>-ihJ|8U3t%Q5OVKyfBD3dJfL$|!{vtiT_c?pj=p#u2CZpJF}e7NFb>B_ zC{M%)i=Oomoik0(EEY#zT5pmpiu?PFdv#o7Zvb*3vX~bDeggw5jb%p?>Rz?GH&Yz| zT7}}sk1QiRr7jPwIye>-0eqO?PrG*EkN8RxIjb;m)`O>>G`B{0Dw03zSEEw&MEBH; zY)y5cv;K5rIwWrk`&Lnk?5IvMP0=8J5dcjp2Q^8+W2igL1e z-a+x3@=I61)R;MTxY3a6uUvzfRT&a;P}<$D-#tk?j)%h9oKqRD3;4~SS@divy*L)e|J4T8)RX6Fhlj@$sI#J!-03D9eI znA|jC&IEC{fewO7_!F7&48CE`BrS&|974XHb8>+c5FabR;;bwgaQ1yFxGXu2(ckR76()wd7Dj`pr!-E8J~Y{rxLb{Yj1d3MeZ^|o z^R)@?O*d=xH+hy7{Lw0`jpgq#;}S9CYPrSH@Zf5$6eB4P*wj83iOgkQh;5d7L)xQC zd-*?E0DAgy^9}NtZMM&{B5i5+>jje!ioQtvwIlfJ!6P&fHdKZqYoC{s_G4e8GyyCU z*yPou&qG~0<7}Xl4>4#IzK5I-rEEMq#=a{!(+giIlJY#)e3|0`KN5GLF;aJ&<(ODK zx(KP${7B>c7mWVIt`z*sK74*IrGB)P#0+qno6?v^gd^~K!m0G}A4;(P*E z0`CgpI48~&sLV4fxVwlI612ajiBWqL`gcK^P@~B34;1=_f=+eee6CF2_;9(J$gCfG z-0|kvSW>q`Lf*hG3a&km=!t;Y9O)(54y7P3>-C;D=v)OP^xd=4_K8mdU(-Cc!fg3K zd(q@zeXBOi)sDK%M=q*EBaTuTWvAC>H}lgBkn-8JVgvAX>c!C-=`E-O0pECC>GQ7J zs(<}B)H9WIm>jDm#*1inEwN90rkLK==~3FByILwUIa!|41kNfxoHp3`aPPL#c_LZB zK88x}QAxpb@IKoic&kmdEOpK0S9TA7AlQZaU0EtUx=FJkHd=(9?f#EMyc%NRa-G}B zt~Z}d!cM2?z&-PP1ta@`jiTNgWn|bF~`s-H}-$vO70NXko z%KnY<%}^}0S){l)X1I-yu1DH8x!KkXPc)X}#D}dOJZ+!VaxI`KRiSjGdmrp@3S9|3 zRo(9m1uG*ucGq z*gnJ`8y|BquPamm`!h;M)s{WwmL(o0AZ$l*?VZ);{X;xXPKAU><--^Kpb+Y&&x}b@ zIcZn@)!&>8VLZ?5pQWw-Urn4RCtg$MFs5S9pGw!eg}R{S7kyyjTd3&BB0uc$+R<0# zRe8IeJBnVoL`KD0R*zvFE|Or^Ra%$NNyL_8LqL9HS1uW!q!xCLMmn*++1;@=B zwlFYQ3alaAuhI2YFhBBMj?^7x&oZ? zS$Pi|_KYOyXmL2hU`EQISI|f-2!O{vu&oNbMac1)sSzC2N5oMC4RCAfWK;=Iq^S+%~q3JpoC{{a9G6+Q^bezTTflhCDh<_lEfh*gqkzC;#_ve zMUgLM;Ony!!Y?>w!S6A6KG4L`8L(KPVJ=E=8@u^pjt>6Xx=Q*-QuQiP;e&t`b=-`e z2&xVPqFV<1Ua6FUe>$06GCYahKU{OTbq3!rMR~O!7~3*aWa5olg7JC0g##ZLpXz~a z0nJ4kfJ;-E2{asK73Si=w%kPd%nB~@sd6#t6WvYFsZ#IB_bNbTKZP_LaRN){*@ixV zLQKug5JWeiwp|h=CN1OV#6Q5tQ_PLr9Jpe}`apxfQ0Q;v6a`{STps|q>U4#w*k$ht zr)GPJnnE~mACeh1I5?HTf9_l!g6{#}c8_b@Q=#ypf6h+1P6gDNX5^p08lvy~ z-_A}#^f0^5(*K;DAJ?1h4S_%EH!9ws!hubmrUz4`h93fecjJ9oRF=QcQ{p# zNB-YF&X~AW1pJ1~8Cq{T70{BMo~evzIa<@Ywbv=<`sTfH);ET8vL4;WFJ6Yj!OFV6 zf5s@&hm4l(gA98K%1x}v^5QxxzgJsogbR^e0PeMPz4e}DBiBsbw5^-3!Tr$93{t_J zrCrx;s&U*FlQ3?VS4s2F5=6N^xw0%^+@R_qenj_`eV%?RWFjNulV|0Bt_w)I)*Cam zu?7~J-E}uFb=wcB#i_SP<7RcIiSSYW8?4=8qcJh&~R&`7M1%#Cy+7<>4VYu!6Q*Cpl-x zi)^BI%FmZ#p*5T5l5?3&aMBvcHJO|tLjEJidr{e0)8FGHuq$Q*Vg4-rY=012!wTjk8&Wt3+_t!hNuFj$A z!P+#7k4x}wy^}wF{3yJ12)OW0v&r5~LPpOZt{0z|KZuvO(}E~I1nrfD%Ki{mVZKyM zr^^6M#5x9{c;E(Gb-w9tmazKuWgQ7N|G*X>o$^c*6Hby0dF63_xj9)gEqgW|JG&S7 zV2M2~496J&K_9zs?gBjY8uudf3F`%o!ieqni0hjQws@MTFGe$FYkv#vrzDaw~Q7=LuG!3>kW2j18No`?`>pCPX(#okA(?!{>-A;7>kHhFG7hZsda= zY($ves&ao&R*t0pZiy7`lOrm`G=_toOM*}L;+Z;`>l!M+PIV=IfPD>M)X<%scg?L^ zxs*F^R2D^D=~FcXBOZTVK`pT~5A{^V(!@SXPD)*2wNl5o{Ni{s#B9h=4g}<4*V#Xv zqXp|w9=!QG@>9NyYm+RzsVG%{G$5oHa>-8_!xOipLmI*Wy_8*JuZ&|Ocx4k3 z@3*Rux)xl=9{TpfN<(k2{M0)`FwVl71ii@@yEzGtyv9gzz`Z$tjj!n_3LDG(#;Ba| zdr=W*-Dwig%25sdKsR}xkJ0qGX8*}>A~p`eKSm0+h#_b?+au=72cRlz79uQ`t%snX ziz%qun!z+2R=#mru3ww+kbeCE*c;nBq&>C z;qS;cQ&taAlc>8_cj-hoG|3E%@&j&s#l$#MjoKU~>Tot!KCk2XLHLX-%IIP9C;T$$ zv*8hVNFSoEjq^66?X^(2??2-;5T<~i&sUxjP51oWo;sP2!|Vr57PKG#vDH3B9V33&Q`VqtbgSb2a%o_wC;G68KxSrIW{;WLJ;#EDZ3!n$ESfdB!s4CNaomf^YG5 zMcJ*T!Z~u+mZ#T-d;5*gj@~sJMr0Qqf~~B3iT?9;ewV058GCwK@Rw{yU6tjIj`kf8 zBU@6b(oIN^Tl&n0^}^mjD!T!;a;~#z+s^W32v2aGVh0*BQ&bLKxdt(SF81fE&Cxkh z6sGEs<+q-pG3E!9mn~irqC_@H2y90i2~D2L@#1$l+G>--qSwMhA?9V$YK*;26QPX~ zlNLbE?EB=E*y%iJ)0edXQ?{d!le(Cy1ru#IURX-SbZ&Pi1cqPrqgn~K=8L70RaMw`u7SzmaLJW zv`KBv_Lf^07e=Y#T@I12DXzqNQK)H|92!zjngFLNr3+es(Nz=saP1_5VK^i!IE{{0`F&eD*Wcgj3UUQa& zWhWjPRlP%AuA17YnqUGIs#9${)%Qu*`Y{q{(7} zw`uzn-7?NyxfWv@fxQ!D2K7JZo0X`KjG3-MmN3=9{Q4%rMCmt3zWTD&ohaD>pD}%_ zu4p4ujFFDmf&gjvH2ERA`ZbmCeM~}Nw8z`?2}r|dZc5?lr7Kco^?H(q5OU@JAp5|jA#-~IUN)& znu-i|m0QB@w?T(q8zYg9Uye`rId`P6`XNuzU+RF+n_ip2rNeADPV|_DQ))0@*r58k z6H!1#HlSVA(?`*Vp58sc3iw(cxI zyfHG*`IPL^AigshW&mj@(sQSaesbJ0IvH|O@sP%ga0%K1axq4p7g$awA#uw*iXg^+ zP?I)Lt7}Y8LE3=5mv{0|0>#o`c#0G~hlp{u0Mw3>wK<5-YmkWY1FW&C7llGb|M?7g z<$4YS8P5UjO+egp{&U0B$T;hd-Y`Rcrl^ksLBCpd!7Jxv_1ac|{jv)4^m^<7x>Mvw zlcZ{~p3HGT0jDSW!Vn^og$#j}peNd2=iriYHB!&DWRZ(xO!(p!?_*C4m@yk_0%Cal%K;* zN^}W3U%iwuF|k!Wpfj$4JqL$TEING<^f=AEe8HUmaWRLf(iNt83nf@@nzcI!ooJMU%y3{!n*-D5~NDXVBZggGPWF{Bp|_!KgX=W;7vy;c9+;@fj; zinE^zv7AapQ!!3LH=*Hc)mUAfki3t31&oVVSax=HGDI!14-J8jA8x5sE-EdQ5Eo;a z=Re!!4{g15h4atR3~F(?KS%z`#U{iav9(ew^mZ+Nl?hk^Q(XVS2RC_Nfqhe6;C-A< z?m4Ow$0B&Bu!R}JBU9KT{qL{SuMA#z0tix&&_P{g-$dQ-ehop!58=THg#iLsB zyOUj$g5o#uWR@cPgGK>cUXk~g{^dP0g@!Rj72=KHY4g*&%KObf)!^--<1h3pp|_y= z7Y+zDE}|%RV4Cxka|cLbwdZsJLd2kg-^-r3KP0w`>)?#*3J4KOvJ@#zV*mB@PAiK)U6*UExo_SXSBXCr{{vlX3uqVgyz?mS zs~X8Z(w}qGDTwSq=SQ^`Gz&tb+e}cHM9F$U%`y;RRamGiDNsv-Q#>j^anzy#f7|*< zuzLDgfEc-2iaC2W$pCyp;f%=W2k*va_lDq$%{w>DZu8ug8-eMg!DL*xPqWnE(%(_T zG`k@Lhm`}B{Tip>z>f4}&T)R6^)PmUhcNaU(PO9xZIyhL5yN=8h3rJSNsQr_EhrXVEbQsU?*i=|byD^wv>IXgE9!855*WHFyWYF}HM&C8S9n zbLn?n*FMNWr04kW=ib2M5lwz3R#*EoM>!bZC9V6#ze_Rqv9b_!R#3xA9Um~!k+I0Y z=x?pfxXmTu1llExcD>P>F2BdscPywldn3NDgl(;N(}7l4Ay|5<`*5MNn992k$AUae zKcvA&H7C#UPspX%JqOo19PNWdvK(=N#QXUEz_a%8>qW@)Sz3gL5q0@Uo-eW!_!<-R z363T9R*(_(DQDnYNfHc9B|?r8hOx)tT33tSoZcL+1Uivu2nZt7*>`$wYjodEwfLDn2uBpW_;Iv}A=~>qG3%*!S)Mljpz% z4K4-UkIjxBi(UtRr={nKE1jC@o}pE}{~mLTk|;~3Ll=WV+B`8uET0?B9zvtV0D9N> z1`wF!L6>*MSRMz%!cuEYyyWaA((h>K zv^ISHe(}g-sl@V{KiA^H9Uz>Ukt+jvhnz&w@Ge4R+a+~@wkzvLH$>}2ottToqIbIvh_b0OoxbkVY(mhC%Z(a$${gJ(nPW1qpZJhtcb5#3$$EFQxm&gZNKIlJu#y!2X6MhxJ-$;|6qu8$B*937WIx?$&A}* zVd$R;9L@c96n|HtyOF3qc`tFJAu3iTCpb^xTcay9Y|f8>N0`w_?Vpv)+yo;rI2hj> zs8}mPtQUPe7(@uWA?5omGwgv_5$AhD#Yb_+qenK84E|Aa%aF9vsF8t-SS}SGLnAdi zA-#gStN!ypPJD{Q=7S8?m}e?v-Z@RbwVcYXwo8sz>!0c6sD<&CD@{7{`$5yq0*V5tH_}kZ0M+vqBlRm8pyC80(^&Z6gRxl+W zqtkxHSkBObGuWI(*z@T8>yo1!Y?%7*`H;qM8`^$9qj>I?eblYO7f z%<;bHIkqkl!Q&>=Zdz!(WBww~v(VcSpTdo%_r)VZ9q8YQi0<{i*t#u% znMt_vfKnV8pKa_33;yhOMAcr<)|+#NQZ-~j=iBV~>XjpS}QX!NrQ zJjU8D!??r|QLv{4mpfX*H?WV;dsS%)lNx&{7;y&9&%E9#PA@ySy#irbCanzFVjnAT z%zNT{`X`Kvhf>Ku8T9XYc9#qXi?`*T;s@f3v2i2CVw-$8c%jOU*-GmclRiZ%ya ziMsk*Z1(rXYP&v(yl=?fnssQ81qL1Wd<5-GnZy+Sp( z-ek9K+#WFpMMa0E(S%K2uSLQ7x5^Q_pzT>V{_!OS?^u9JTH*6PI^9A7tZnX70m4Mm#Gr^1(caYX zenERm*|55)v>B&G*Ef?KOQAF#pHQ|#DbExp?{ zmsy0Fc&%B8-li8Qi<#Rw|8^y%?oQr~*32-yueP~b1xXD$amt_qzBR@X+=RhWpse}* zk^Lt;nyaS?Dxc}mjx?d42C8tWbFsoaKJ7%yaElNoek z@a5b{UOJvvBq{L>XDAMw`vdJ9`ScN85i^^s(O-4MV|A3_F2Y8HZ|rPKyCM!#)L_VNB{nu<~ala3jHbEBh7(UIXv263j(jqK;)k%lZ}!|c{knJYcl5o z&Kd9+moxf#mab}-D#Q^~E5I5d|NeJ8f+R)_sQ>hMebrhUxiI;1Mc+%~%d@(H_J{*5 zPaHckoUJPjC73mbsP+T1>XV{g=i4DLnO|6wzMR)7mJT;sZ>U*Dg@<49BqY+{ke<^_ zV5vE5hK4J?gWG^(DX>FIlF%GTg?+!gP1;56tUVXITif;V zRB)m5zFv@Lx%q+aDTCdX$+S1O6T`(uE7q`)RBUVzjyvH_yg@=VP>{Xvba;QhO&nc( zmw+z0G~czxChv+r8hHGkoWMAU-`2NWpD{BMCXnkD_+nF&!^fwDolFl{lW1zIN#(~#nl9FfppD171&8*oLoNu0_ zv^H4a?Ui9BmM~mtZSG0lF4Opkt8r5xR6l^2?MlB6M~RF6R{=gc7c z?3K+awNEcCzkprrYdSBU^NgG%JFsxju~{$eOj7QxT@`^R4=zoA33mS+5<27!)EKtE z1IvD{Y#9i!A$Dhli;Or|qx##&w+JSE#8hY$=4jcIopnUlAn$IOsTTq@&G^33o2`N# zeG~kUU*es>>RoQzJSJGVf9fI-_|RaxnxaG9ZM%lm*zWLaDgsdEb-wcQICMd2hw@(d zx6QwtZnTt~y{ltV_R>qYOPY7|F45qhCv2T>-dbkcBh`zCW~`#X=3jL&s#a)EtJS_e z|Kj#&%VBrKs;P^KE`_WFtd;C6`o1W@nQ@Q_!;9T-oenS&c2K@7uE_a?lfR*tWDQ&CR0|M8yIQOvy@^CkXK z(1|LKpSt*u!0WBYt|`mXuQ~$XbQ64bN%D67tMuBUy%2EAA=>qs(K)$D))kMbXzfg5 ztdw$O18~LpVMhuyPHg_W%k5N;wCwD|eD;sonlH&T2(9w5Bas5V+0s=#RX5J*eW0>& zQYq%2@7{YLO!&L(bk*SSw$CE}mwV-L&;RXSS)QZ*Z8kW~DAKdY_Nse>yo zue|-yN>jlR5yBFt?beI^-9=S#3VxRcPbUAxF>zill)hd+j|q|dv-v3^Wk{l{ne;YXMaVF zNnUO$|G`qsENl*MNb5Vw-Sf)-An=KAs0l2$k`uOtg4PUEP2r1D^p!8;vOXtz*%!wV z-$xFZeTGh;J|4OD<5G1^9qP(I#&QRM7p+0t#2fEz5&=Bqk>j^Sodeooa>zcfv4+FC zR;*u3x?!!1*)9E!aWl$-xNcmMjH&3F-K~9;e+%BUGqyr`ko~(~Ok)+I-@eR~E!p>O z)0wqH7pJ&R z((c}#>p%af#>Fbt*a1uo;Or6eKV4&%rRR~CY4UBmL;;-oiJV zD=gJ7+RQ)^F@vpCmbm~(ih1P_=KHajzsPPpMv6}*X z-m?EtV-S5|Ube{nOWIpDGg)+(vV75P#a(w9P0GRQ7JoJjE8*sM@4q^Kq41zz^Mi1X zeZ+@U*3~JPnP{=RtsmaLj0rK_arKE1u5++jyG?#r zp#$V(zCj)bIhm(07Op~mdE07*j(mS%weSt}ufz~%yvM3*LGjWG)>(+#Q}{C8X7u63 zc%XO%0EGZzQLxC1y|0xwxbFo=j4uiQjE?zzyfo;<&6?D`cH(X}=xOVt#zzd(es;V| zpzOT({EESH4C^_OegF=(c5ORm`l4_QVMBpPDJ=b{>#;m7zgw=lt?m1;U503-+gR@X z6U(sSC{w(Vn~=7vBlRf&ryas|MD`?O*8=4tnKlZQnzm#*bf}b-TWkZ^|;(2)^ll3 z>KEUNonuNZ%e83dwuINyA6@%T0gan{P}gI)ek;>=>~;V7^5uSLHMh(1R0FG{gZ|KY zy?8>+ zWY-{Dt}{HmNo`7SiJP8ubElJQTt{(jOrS!WzjZb7Lu4z)+Z-w-K~Q8v$;rLbn1~L% z*`sF7^+3vHkcqLS0qhomU6cKh>5ik-Kjh@dJ=VDqmff8DNzE~Y=JM(M07yi_*_tOQP} z^wb8e?Hj^fqdqJizFgP4hGP*uGNT}o!4a*k11@d=mq~WaZRR`Iy`Ru3FUs=;+Xd$> zZP`Sk72Vy#dHt;gYKAd=J%Y6+hk&=_RPxGh*96cQQ#>SJnhthC_01w7ZQfp@^7YqwB}7( zVi<#i(h@Zy8wG9Qa_6~nI=o9pGEj`U+#@w7a@!NIF!Fj>8kS+!e z&9ZFyhl)=C6wfpZk+XjgPagl(WT+aw&v$R5acNfyKqZF$N~u^cgx5@dDwh!QbIJ6b z)>D*(!6poc5FZ%22srxfz zWnJJyDWD~)uOdml$^Ehe!g}}-`%yTVaaxa&c+c>pEjJEx5B+{Q(V{Um??fuXmpzK8 z`>22%vl1i3nvtqnzKQQB0SKuynBk4N6yQ%j#RZyp%4dg921tj#72~iK%hO(7%eCaj zd50vDtJK1=PhPBe-Kc#ozu(CXhcLw%RdjozWHESh)F?yLap3NRwdy3L!NTaGWd`nKU3kquHR`i#nLFX#^=wP zQD}Q~P_+UxI_2nsw^!t{+r{602X8D}R=2O4Jmh5d>|ELzkXh=1+2a)9d7FGRwhd0z zvWi2Npa*jd94PU}0~zCL|P=RaAUE2g@SV%J78 zj&)zOHQeU-Ds-1|B;hTCom0)N!h7Wx+gFDMmRUsS&B5H9PLcS}Uxfyz%5c%Bk zUp$Kp-~IjCQ=^JD?)2yRjTKkLnI$SqShY21`k52%+vue(9}p2`nn03QVO8bL*)CLplnv|TXdA?Ht4;OaT|41_(NjS7GEU8e~0i(=LEXj1vD zr7z1AC3@dic{SY^;d^t%AbANCR(|TsfXs&K(?v`Xp`=a(ZR@7245uHvGb@KMRWs8(kv)}W|=~;WR+6m-X5j_;(n zVhlHxRhA3SdIC`n!0C$;-D^(>jIgJOwQmrTcn-M4G^T{c6zja9N?OO3G~@*u zR7G&a^htWFK}wy^mJ!FCF5cl^x@xVGgOEuDtT-PA_AoS}UvW32(AHPJ_I(O0bhehjQ^T9-_Nn;RYO`FMZmd+j zx4q(%7I%3mO2cLAkq%Eol0Uh&T%6>E)YIb8-l`8lun0}HeQzUqy#TLQ8H8&NSO zMuj-%1aTPJ)^B_qFehw)W(;s%%Nq#oIvlB8qzyw9DM0lal6}_-PxTXi;zm*DF?!hR zwZ_QW5E8lg*V{|0?@ADFO5l05QEk63$xOX019^z4<_=8#nL!GsaWW_whqEIiS_8Fp zO=H6BAq+HtqQr+qTa6%Xkq(frr_W5?bcVwMcg}FTyH`9uAa$0%&n_5RBF_o(S$)au zAptpZE_*rYDl9%P-g2`xzr(%0{p5j(M~&IhmaES`u(J5dvrewr?wON%_*6KVRvr3T znY2%BHkGj^5sLvd@lqYITTRDA-n?!G;UB4^hXtKm1{e^)cLg*r^RdMlsvNe2>G)UW+?4qoESX(06+A~RKAZ9xLpYjNmK!m#&5!;q2A($1TjL7IUs3uVU{ z{SKTFhfSVA<+ajYNdZyAy2uEu+>IR*p=;Gm?0%Ah4HU9sxI@q3V!U%zr&I^TC3Fl= z+Y=B7+a5hP7RN#^<9!@vU=2!pjy`b?_Z%UYP;j)v7PZFb>-_^Cuj9svpr~l`Y!$V!yeO&A;Kvo=eF?w9x1GeG zn|OW++!F*GW^lNiTmR~tfC%U#c&;l^NWIuAd*wFmn%hmmw7b5ez{)*!J#7y)`$8O( zhD-3zCQF?z=Xz3<%|%i7oak#d%d`x$YcL5pJWkVJUJ+QxLiB5yuz);;YN9j zE(nbYpos!Os|Yr_Zm+!=uW+~9Pw?kws|yG|R~sc_%zIK?veWrwH$JLGanv zQ#W;;?j55&_3JvaKx~K@tD}pN6jhbg-t#<0DnZ$MlUFNZpeanp?3fElY^S6<&!q-u zJL9wni(n3MomB{WI)m+E_5_qmX4BG;-{c8$ zBrgrJNgGBP+oW=259@B^v2~Sww9eH(hptuic!QvOA%H?-+IR>zFxlBR`-@Wz7L$h!gbcVaVA%}Kt}pSF>=gE-1oRqk$yf%(MZP_dctO=fGZh=8 zW|+`n6sBK2el&G#?d$tumxSv^wLqtA>M;A$!reuyq=C_o#>r-$BHvn=k*fi;v!o0lYAx>f@Oqp#1ht$T3{nT@?+3P zC!AiQ|fcc+4pE z<3xi^7(f|ry{y|5u|Ci#0wy~r;GG0tezulCW+B5FgI~-d0+j~UYxEKT8o)J=EI1lN z4}t=83_kraqu?|woa4MFpoww>btA-8DT3g?6-#zYo>6%3>E?<+SC7M5BllwhzyM`*0E{5;EBaUnjOq*S{{%p&L#QAmYdpr?XR8c7)#f8pb@oG6` z3k3s@6sI{d&w-~7IS>S|s2kk%faI{)=(z=f^m<2i@s0XQ54JQz^*SXELF5~gyvzlu zpA?X>7)dM}>fF+@%LXF}FA~5X)j#r3v1O&%38eR@b>#kknTj_ zeKNqAgLzJdxr7ssyNsLKg4BKcg1j*JRoVx_>iqrA@TN1GUU7H~W=l)2jg$Fmh`@)*NS^-?}c~_sR*7y6dB}P+$eB zWH#-EcIT(IMLtyULV8dcvfKP$4!dIr`US$hiVrlzw#pPvb;*_}9wUtR0}!Qc-XYpRP-Qads>sti+sov$HO_2%Dtu zzKX{HkHUYRBq+74O`Q?$Rql!g7Fj{nJang;-=}a7nlt27R*>7K zS~5-2#R#hxTF-P1OXLn}OBVTmk6`vgM>y*$_w8#YoB+ddwAj<m+;Rb+#Usm3!v{jR6u2GP%^R1szV|fkCJ?1Uatl>rcE`h_#<+bbr}QttkH z`Ew-TDxHp(;pTp-0kVVHvWhpPd&>6EtiUN>?NtpAEf=qK=vGQ1H4ox6g-{BH-WMaj zEES_YTB!EKRZS~fC|9}V)I0^6k_(F-C@mU(+aCJd(xfi(Ax0i~%}@N+cJW;g46l&- zi*0!lO1s;J-`IJv<9?^!#MkX(z6Sg7DX>Lzm7X|7pf8Hz4Ib5G9$hg1IYU+QmWsu_ zR}h-1uEEjWftgp%kEz2meAkK>D~gs6!(TkyTWhMIO05hk*SgySIqu97_B2bO;Q?feA=BxI?hAV7uRrmR?#f5J`auQ4%yJ>pXuoJdPL< zGa&DBh#CIppVLML*Dl|6Y@9!j22bcf&tW}5K`kJDIpYVAJ&ee5jCNT7h7h=3oLI!m zNb5+!L*D0bJClkDyso}St#5Pf?;Q2W2`Wsz95#1;vcVJQ+K*L$Z68E;Yu?hm6QZpu z+BVD7lf}?eDl%`3F}%mn70t!V1bw#%v)lVSru)9_hc?yQOu}1=*YpEiFt~wKfPmDS zY^6VTz+e6vf-S~6VAQ9o#^zh8;cgRsjGSZcfW55%bJdF!zf>QuF9T_xJ7SR((A%5> z1x48@px0aY$^zYC;-p;~z;A=LIJ0Fy3o%xc5_7Pw5VJE1!OvC{$dGr951;=sI4Gd| z3;2p*MNz$dKp7CC3rKxUS?g(}d!GCqe@*GmS2T4Gai(iMJj|x-tfNQg%$%VOpOWe9 z1fTdQ=rRcD{ItLChNBA0LqA&V9EOJTv?4dTQymA!W}y7lfy_18qF+8+bL8miu(NFI z3Q4BelOzl-%ne{{?z4nN1ZX~Oc&GZtXL4Hu3tOfbI99V-Rhv1%YVRy{J{jn>!%8$E zhPC@=nw$hvpo4)VRbgl?v?+pARUbbEr|5ifp&+Xm=X6n1u?u0`e9m7@+&0{nM-E;| zU~W=muD-R)xx2Gzd$6A|Vq2uV!+Z1@CpakrGD4PZL@mQ<-lv?Y-6BT4bYM8T>>c_{ z*uxH2M;_Jf9L_$fEG>mv;Gp7s-Cm}63)ve`pqYv2KZc`AAWbvpvtgbPipf(pF$zeEYr=h+Mik+*`<-1S1GC*bsZ;ZHPR=}tNI-QW*UQ<>c2bH|+G3a~ zj-=efYe9CPcPNC7JnO0DnSEe9T3IMVdr5^YR)I=7ShMk5z?uRKXL|1%OT6@EF>T|B zswL14=vEft|0G`n61sUDD}=V893 z2(9ZWFE|ey%cMZauQHee#}CHty&C>zpjJT2$`?cbJ=@O=-rb9r-1W0tX3_%Vt<8nC5dhO4pS$8R?Ilv3lc?>4D_@d!FHA|saIA+ zzDb}_82h{UmF(gq`1l+5j1ZU@kM4zvyx@F!R!V zFI}p$80pwDGbnbA%>_vAVT*efw55xR5nIp0fieMm98eeusEM0dPmKAT<-^B*O7pwe zVm~R)StxsJl&Du3X@tq{2)TF}6xf+P?zhsIb*oX<{h4^DM8~`R7iFVC_3hwtcg`ZMK z&?wej6ZOknZ5#_G5ar?%3>kekyXKnhiu?AU;!bOk`(m&`Clac+dzyxeXwGOjc%4Xhv^QJ9G-r(5(ncsZY144-dQ98@(d*Cph>G8d9k4W zbS7`!W4-O3K79R0CGJxzfN_T~pG8|!^-0%|*3=7FrPiU8vZ&L8gb5($qF@2x(~Bz` z4mpv;U^{@NcXu|VK=+z$Df^)EMDM#qf|0c-?D*jD4Rdoe*C~OQeoVadBa6$ebmQI?ZR|I_O`rS9w7W0#!Y@ zFoMpUv4o{Q8YMm~Gc-b-&aSO2p*vvU7}$YBY^fQ2^MzN=ls{yI9C~CT(Aq+4RUNxZqzVNUQ6CIDR~C^9*_Hw?-&yrc&=uWJ zq$&syZcZ|GmV6;HgX0X_Qfmu?wh~i*NSWqIEil;=3>b0B#9p=QT6{~RpfSQLZfXA2 z)%Qx)g~afjH6^w3!{$IV=iGc*`=iHw4BR}j39;NRlSu{y-$Ef(1@j|!IN{_50SU=% z^Y%_Cj62*4a{%$C3?r^|*nL0Xi z_sBzg?`diGG<k};~auPURGG^x*_45h=z3a|Vm zfQS28Izqq>V|x=x!vnLn?85^x6rev&2`*s5fLi#hul~D-L-ML!~A4KpGJ-L$FMAGf~RfQ@ZxRWh%(HS> zn&1j>2fn_oX6hPprMcLbyX)m0o2IMc-33<@g3eQ1%xvV&Rj6fHb|uHueL-^6ZM`_| z196Q{T!)$^@#>7Kv1<9kDWD+&ChX=RUqVkbQQXLMjO#c=?r!sG+H9)JoSrQy%2n)M zTqBb8&^S{)j=u;rC^?Gx#a(TVdFm> zu&aUNRQ~GUcl_tAX<#is>ucrh|GMnIUYr(t?K6w4Ix75sf8dM9yBn|U`XAr&8g}Vx zIu!4I^M8NslYgF`1*_y|7k8ijKlk$FQskyxE`lRvC;oGD|GvEt%((x(!M`I2PR74; z5L{?~7s-F(*55GmH&AbEJb!nRjqUR9Uc7-|{(=QCIR1rO8zA*BSojMT{?8%jFIe~s z7XE^TjS=_@7XCXk@fR%o1q=VlNc{y1f5F0Eu<)M|*jN*PQ^0>S3xC1F|0s6+{{ag> bfi17=3PY=-_V4`%{4uz0a;@^p{b&CR!qN$P literal 7410 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 diff --git a/docs/src/_static/mlx_logo_dark.png b/docs/src/_static/mlx_logo_dark.png new file mode 100644 index 0000000000000000000000000000000000000000..cda3c1f61326b05c26d7248e6a44816043d0c424 GIT binary patch literal 48758 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 M>YXh({g1o<0|C9e`Tzg` literal 0 HcmV?d00001 diff --git a/docs/src/conf.py b/docs/src/conf.py index 0654cf53c..603bfa847 100644 --- a/docs/src/conf.py +++ b/docs/src/conf.py @@ -49,10 +49,12 @@ html_theme_options = { "repository_url": "https://github.com/ml-explore/mlx", "use_repository_button": True, "navigation_with_keys": False, + "logo": { + "image_light": "_static/mlx_logo.png", + "image_dark": "_static/mlx_logo_dark.png", + }, } -html_logo = "_static/mlx_logo.png" - # -- Options for HTMLHelp output --------------------------------------------- From 972d9a3aeafa0a658394a1c41ae0aa7b4b3ae05b Mon Sep 17 00:00:00 2001 From: Vijay Krish Date: Wed, 21 Feb 2024 11:09:30 -0800 Subject: [PATCH 03/25] Up to 10x faster scatter. (#709) * Faster scatter. Add specialization for 1-d index tensors. * Address review comments. - Check for row contiguity of index, update tensors instead of checking strides. - Add support for 1d specialization with col contiguous update tensor, along with a test. * Nit1 Co-authored-by: Awni Hannun * Nit2 Co-authored-by: Awni Hannun --------- Co-authored-by: Awni Hannun --- benchmarks/python/scatter_bench.py | 58 ++++++-- mlx/backend/metal/indexing.cpp | 174 +++++++++++++++--------- mlx/backend/metal/kernels/scatter.metal | 83 ++++++++++- tests/ops_tests.cpp | 12 +- 4 files changed, 244 insertions(+), 83 deletions(-) diff --git a/benchmarks/python/scatter_bench.py b/benchmarks/python/scatter_bench.py index 2d63d8bf1..d2fd569ac 100644 --- a/benchmarks/python/scatter_bench.py +++ b/benchmarks/python/scatter_bench.py @@ -7,12 +7,14 @@ import torch from time_utils import measure_runtime -def benchmark_scatter_mlx(dst_shape, x_shape, idx_shape): +def benchmark_scatter_mlx(dst_shape, x_shape, idx_shapes): def scatter(dst, x, idx): - dst[idx] = x + dst[*idx] = x mx.eval(dst) - idx = mx.random.randint(0, dst_shape[0] - 1, idx_shape) + idx = [] + for idx_shape in idx_shapes: + idx.append(mx.random.randint(0, dst_shape[0] - 1, idx_shape)) x = mx.random.normal(x_shape).astype(mx.float32) dst = mx.random.normal(dst_shape).astype(mx.float32) @@ -20,13 +22,15 @@ def benchmark_scatter_mlx(dst_shape, x_shape, idx_shape): print(f"MLX: {runtime:.3f}ms") -def benchmark_scatter_torch(dst_shape, x_shape, idx_shape, device): +def benchmark_scatter_torch(dst_shape, x_shape, idx_shapes, device): def gather(dst, x, idx, device): - dst[idx] = x + dst[*idx] = x if device == torch.device("mps"): torch.mps.synchronize() - idx = torch.randint(0, dst_shape[0] - 1, idx_shape).to(device) + idx = [] + for idx_shape in idx_shapes: + idx.append(torch.randint(0, dst_shape[0] - 1, idx_shape).to(device)) x = torch.randn(x_shape, dtype=torch.float32).to(device) dst = torch.randn(dst_shape, dtype=torch.float32).to(device) @@ -45,9 +49,45 @@ if __name__ == "__main__": else: device = torch.device("mps") - dst_shapes = [(10, 64), (100_000, 64), (1_000_000, 64)] - idx_shapes = [(1_000_000,), (1_000_000,), (100_000,)] - x_shapes = [(1_000_000, 64), (1_000_000, 64), (100_000, 64)] + dst_shapes = [ + (10, 64), + (100_000, 64), + (1_000_000, 64), + (100_000,), + (2_000_00,), + (20_000_000,), + (10000, 64), + (100, 64), + (100, 10_000, 64), + (10, 100, 100, 21), + (1_000, 1_000, 10), + ] + idx_shapes = [ + [(1_000_000,)], + [(1_000_000,)], + [(100_000,)], + [(1_000_000,)], + [(20_000_000,)], + [(20_000_000,)], + [(1000000,)], + [(10000000,)], + [(1_000,)], + [(10_000,)], + [(1_000,), (1_000,)], + ] + x_shapes = [ + (1_000_000, 64), + (1_000_000, 64), + (100_000, 64), + (1_000_000,), + (20_000_000,), + (20_000_000,), + (1000000, 64), + (10000000, 64), + (1_000, 10_000, 64), + (10_000, 100, 100, 21), + (1_000, 10), + ] for dst_shape, x_shape, idx_shape in zip(dst_shapes, x_shapes, idx_shapes): print("=" * 20) diff --git a/mlx/backend/metal/indexing.cpp b/mlx/backend/metal/indexing.cpp index 4eeb8858e..56a312a5d 100644 --- a/mlx/backend/metal/indexing.cpp +++ b/mlx/backend/metal/indexing.cpp @@ -142,7 +142,28 @@ void Scatter::eval_gpu(const std::vector& inputs, array& out) { // Get kernel name std::ostringstream kname; std::string idx_type_name = nidx ? type_to_name(inputs[1]) : ""; - kname << "scatter" << type_to_name(out) << idx_type_name; + + int idx_ndim = nidx ? inputs[1].ndim() : 0; + bool index_nd1_specialization = (idx_ndim == 1); + + // Bail from fast path (1d index specialization) if scatter dims aren't + // the outermost dims and contiguous since update access won't be raster + // order. + for (auto i = 0; i < axes_.size() && index_nd1_specialization; i++) { + index_nd1_specialization &= (axes_[i] == i); + } + + // Bail from fast path (1d index specialization) if any of the dims are + // broadcasted, since we can't rely on linear indexing in that case. + for (int i = 1; i < inputs.size() && index_nd1_specialization; i++) { + index_nd1_specialization &= inputs[i].flags().row_contiguous; + } + + if (index_nd1_specialization) { + kname << "scatter_1d_index" << type_to_name(out) << idx_type_name; + } else { + kname << "scatter" << type_to_name(out) << idx_type_name; + } switch (reduce_type_) { case Scatter::None: kname << "_none"; @@ -170,85 +191,106 @@ void Scatter::eval_gpu(const std::vector& inputs, array& out) { compute_encoder->setComputePipelineState(kernel); - // Collect all idx shapes and strides into one place - int idx_ndim = nidx ? inputs[1].ndim() : 0; - std::vector idx_shapes; - std::vector idx_strides; - - for (int i = 0; i < nidx; ++i) { - idx_shapes.insert( - idx_shapes.end(), - inputs[i + 1].shape().begin(), - inputs[i + 1].shape().end()); - - idx_strides.insert( - idx_strides.end(), - inputs[i + 1].strides().begin(), - inputs[i + 1].strides().end()); - } - // Set all the buffers set_array_buffer(compute_encoder, upd, 1); set_array_buffer(compute_encoder, out, 2); // Set update info - size_t upd_ndim = upd.ndim(); + uint upd_ndim = upd.ndim(); size_t upd_size = 1; for (int i = idx_ndim; i < upd.ndim(); ++i) { upd_size *= upd.shape(i); } - if (upd_ndim == 0) { - // Need placeholders so Metal doesn't compalain - int shape_ = 0; - size_t stride_ = 0; - compute_encoder->setBytes(&shape_, sizeof(int), 3); - compute_encoder->setBytes(&stride_, sizeof(size_t), 4); - } else { - compute_encoder->setBytes(upd.shape().data(), upd_ndim * sizeof(int), 3); + + if (index_nd1_specialization) { + bool upd_col_contiguous = upd.flags().col_contiguous; compute_encoder->setBytes( - upd.strides().data(), upd_ndim * sizeof(size_t), 4); - } - compute_encoder->setBytes(&upd_ndim, sizeof(size_t), 5); - compute_encoder->setBytes(&upd_size, sizeof(size_t), 6); - - // Set output info - size_t out_ndim = out.ndim(); - if (out_ndim == 0) { - // Need placeholders so Metal doesn't compalain - int shape_ = 0; - size_t stride_ = 0; - compute_encoder->setBytes(&shape_, sizeof(int), 7); - compute_encoder->setBytes(&stride_, sizeof(size_t), 8); - } else { - compute_encoder->setBytes(out.shape().data(), out_ndim * sizeof(int), 7); + out.shape().data(), out.shape().size() * sizeof(int), 3); compute_encoder->setBytes( - out.strides().data(), out_ndim * sizeof(size_t), 8); - } - compute_encoder->setBytes(&out_ndim, sizeof(size_t), 9); - compute_encoder->setBytes(axes_.data(), axes_.size() * sizeof(int), 10); + out.strides().data(), out.strides().size() * sizeof(size_t), 4); + compute_encoder->setBytes(&upd_size, sizeof(size_t), 5); + compute_encoder->setBytes(&upd_col_contiguous, sizeof(bool), 6); - // Set index info - if (idx_ndim == 0) { - // Add a 0 in idx_shapes and strides to avoid the missing buffer binding - // error in the metal API. - idx_shapes.push_back(0); - idx_strides.push_back(0); - } - compute_encoder->setBytes( - idx_shapes.data(), idx_shapes.size() * sizeof(int), 11); - compute_encoder->setBytes( - idx_strides.data(), idx_strides.size() * sizeof(size_t), 12); - compute_encoder->setBytes(&idx_ndim, sizeof(int), 13); + // Set index buffers + for (int i = 1; i < nidx + 1; ++i) { + set_array_buffer(compute_encoder, inputs[i], 20 + i); + } - // Set index buffers - for (int i = 1; i < nidx + 1; ++i) { - set_array_buffer(compute_encoder, inputs[i], 20 + i); - } + // Launch grid + MTL::Size grid_dims = MTL::Size(upd_size, nthreads / upd_size, 1); + MTL::Size group_dims = get_block_dims(upd_size, nthreads / upd_size, 1); + compute_encoder->dispatchThreads(grid_dims, group_dims); - // Launch grid - MTL::Size grid_dims = MTL::Size(upd_size, nthreads / upd_size, 1); - MTL::Size group_dims = get_block_dims(upd_size, nthreads / upd_size, 1); - compute_encoder->dispatchThreads(grid_dims, group_dims); + } else { + // Collect all idx shapes and strides into one place + std::vector idx_shapes; + std::vector idx_strides; + + for (int i = 0; i < nidx; ++i) { + idx_shapes.insert( + idx_shapes.end(), + inputs[i + 1].shape().begin(), + inputs[i + 1].shape().end()); + + idx_strides.insert( + idx_strides.end(), + inputs[i + 1].strides().begin(), + inputs[i + 1].strides().end()); + } + + if (upd_ndim == 0) { + // Need placeholders so Metal doesn't compalain + int shape_ = 0; + size_t stride_ = 0; + compute_encoder->setBytes(&shape_, sizeof(int), 3); + compute_encoder->setBytes(&stride_, sizeof(size_t), 4); + } else { + compute_encoder->setBytes(upd.shape().data(), upd_ndim * sizeof(int), 3); + compute_encoder->setBytes( + upd.strides().data(), upd_ndim * sizeof(size_t), 4); + } + compute_encoder->setBytes(&upd_ndim, sizeof(size_t), 5); + compute_encoder->setBytes(&upd_size, sizeof(size_t), 6); + + // Set output info + size_t out_ndim = out.ndim(); + if (out_ndim == 0) { + // Need placeholders so Metal doesn't compalain + int shape_ = 0; + size_t stride_ = 0; + compute_encoder->setBytes(&shape_, sizeof(int), 7); + compute_encoder->setBytes(&stride_, sizeof(size_t), 8); + } else { + compute_encoder->setBytes(out.shape().data(), out_ndim * sizeof(int), 7); + compute_encoder->setBytes( + out.strides().data(), out_ndim * sizeof(size_t), 8); + } + compute_encoder->setBytes(&out_ndim, sizeof(size_t), 9); + compute_encoder->setBytes(axes_.data(), axes_.size() * sizeof(int), 10); + + // Set index info + if (idx_ndim == 0) { + // Add a 0 in idx_shapes and strides to avoid the missing buffer binding + // error in the metal API. + idx_shapes.push_back(0); + idx_strides.push_back(0); + } + compute_encoder->setBytes( + idx_shapes.data(), idx_shapes.size() * sizeof(int), 11); + compute_encoder->setBytes( + idx_strides.data(), idx_strides.size() * sizeof(size_t), 12); + compute_encoder->setBytes(&idx_ndim, sizeof(int), 13); + + // Set index buffers + for (int i = 1; i < nidx + 1; ++i) { + set_array_buffer(compute_encoder, inputs[i], 20 + i); + } + + // Launch grid + MTL::Size grid_dims = MTL::Size(upd_size, nthreads / upd_size, 1); + MTL::Size group_dims = get_block_dims(upd_size, nthreads / upd_size, 1); + compute_encoder->dispatchThreads(grid_dims, group_dims); + } } } // namespace mlx::core diff --git a/mlx/backend/metal/kernels/scatter.metal b/mlx/backend/metal/kernels/scatter.metal index 7a94be7da..071effeea 100644 --- a/mlx/backend/metal/kernels/scatter.metal +++ b/mlx/backend/metal/kernels/scatter.metal @@ -13,6 +13,58 @@ using namespace metal; // Scatter kernel ///////////////////////////////////////////////////////////////////// +template \ +METAL_FUNC void scatter_1d_index_impl( + const device T *updates [[buffer(1)]], + device mlx_atomic *out [[buffer(2)]], + const constant int* out_shape [[buffer(3)]], + const constant size_t* out_strides [[buffer(4)]], + const constant size_t& upd_size [[buffer(5)]], + const constant bool& upd_col_contiguous [[buffer(6)]], + const thread array& idx_buffers, + uint2 gid [[thread_position_in_grid]]) { + + Op op; + + uint out_idx = 0; + for (int i = 0; i < NIDX; i++) { + auto idx_val = offset_neg_idx( + idx_buffers[i][gid.y], out_shape[i]); + out_idx += idx_val * out_strides[i]; + } + + if (!upd_col_contiguous) { + op.atomic_update(out, updates[gid.y * upd_size + gid.x], out_idx + gid.x); + } else { + op.atomic_update(out, updates[gid.x * upd_size + gid.y], out_idx + gid.x); + } +} + +#define make_scatter_1d_index(IDX_ARG, IDX_ARR) \ +template \ +[[kernel]] void scatter_1d_index( \ + const device T *updates [[buffer(1)]], \ + device mlx_atomic *out [[buffer(2)]], \ + const constant int* out_shape [[buffer(3)]], \ + const constant size_t* out_strides [[buffer(4)]], \ + const constant size_t& upd_size [[buffer(5)]], \ + const constant bool& upd_col_contiguous [[buffer(6)]], \ + IDX_ARG(IdxT) \ + uint2 gid [[thread_position_in_grid]]) { \ + \ + const array idx_buffers = {IDX_ARR()}; \ + \ + return scatter_1d_index_impl( \ + updates, \ + out, \ + out_shape, \ + out_strides, \ + upd_size, \ + upd_col_contiguous, \ + idx_buffers, \ + gid); \ + \ +} template METAL_FUNC void scatter_impl( @@ -46,10 +98,14 @@ METAL_FUNC void scatter_impl( out_idx += idx_val * out_strides[ax]; } - auto out_offset = elem_to_loc( - ind_offset, upd_shape + indices.ndim, out_strides, out_ndim); + if (upd_size > 1) { + auto out_offset = elem_to_loc( + ind_offset, upd_shape + indices.ndim, out_strides, out_ndim); + out_idx += out_offset; + } + auto upd_idx = elem_to_loc(gid.y * upd_size + gid.x, upd_shape, upd_strides, upd_ndim); - op.atomic_update(out, updates[upd_idx], out_idx + out_offset); + op.atomic_update(out, updates[upd_idx], out_idx); } #define make_scatter_impl(IDX_ARG, IDX_ARR) \ @@ -90,9 +146,11 @@ template \ axes, \ idxs, \ gid); \ -} +} -#define make_scatter(n) make_scatter_impl(IDX_ARG_ ##n, IDX_ARR_ ##n) +#define make_scatter(n) \ +make_scatter_impl(IDX_ARG_ ##n, IDX_ARR_ ##n) \ +make_scatter_1d_index(IDX_ARG_ ##n, IDX_ARR_ ##n) make_scatter(0) make_scatter(1) @@ -129,8 +187,21 @@ template [[host_name("scatter" name "_" #nidx)]] \ IDX_ARG(idx_t) \ uint2 gid [[thread_position_in_grid]]); +#define instantiate_scatter6(name, src_t, idx_t, op_t, nidx, IDX_ARG) \ +template [[host_name("scatter_1d_index" name "_" #nidx)]] \ +[[kernel]] void scatter_1d_index( \ + const device src_t *updates [[buffer(1)]], \ + device mlx_atomic *out [[buffer(2)]], \ + const constant int* out_shape [[buffer(3)]], \ + const constant size_t* out_strides [[buffer(4)]], \ + const constant size_t& upd_size [[buffer(5)]], \ + const constant bool& upd_col_contiguous [[buffer(6)]], \ + IDX_ARG(idx_t) \ + uint2 gid [[thread_position_in_grid]]); + #define instantiate_scatter4(name, src_t, idx_t, op_t, nidx) \ - instantiate_scatter5(name, src_t, idx_t, op_t, nidx, IDX_ARG_ ##nidx) + instantiate_scatter5(name, src_t, idx_t, op_t, nidx, IDX_ARG_ ##nidx) \ + instantiate_scatter6(name, src_t, idx_t, op_t, nidx, IDX_ARG_ ##nidx) // Special case NINDEX=0 #define instantiate_scatter_nd0(name, type) \ diff --git a/tests/ops_tests.cpp b/tests/ops_tests.cpp index ba4ab552f..67ff71b12 100644 --- a/tests/ops_tests.cpp +++ b/tests/ops_tests.cpp @@ -1858,6 +1858,14 @@ TEST_CASE("test scatter") { out = scatter(in, inds, updates, 0); CHECK(array_equal(out, reshape(arange(16, float32), {4, 4})).item()); + // Array scatters with col contiguous updates + in = zeros({4, 4}, float32); + inds = array({0, 1, 2, 3}); + updates = transpose(reshape(arange(16, float32), {4, 1, 4})); + out = scatter(in, inds, updates, 0); + CHECK(array_equal(out, transpose(reshape(arange(16, float32), {4, 4}))) + .item()); + // Irregular strided index and reduce collision test in = zeros({10}, float32); inds = broadcast_to(array(3), {10}); @@ -1877,10 +1885,10 @@ TEST_CASE("test scatter") { // Irregularly strided updates test in = ones({3, 3}); - updates = broadcast_to(array({0, 0, 0}), {1, 3, 3}); + updates = broadcast_to(array({2, 2, 2}), {1, 3, 3}); inds = array({0}); out = scatter(in, inds, updates, 0); - CHECK(array_equal(out, zeros({3, 3})).item()); + CHECK(array_equal(out, ones({3, 3}) * 2).item()); // Along different axis in = zeros({2, 3}); From 884b4ed43b302fdbe9ec4352791e683a3a2d410b Mon Sep 17 00:00:00 2001 From: Jagrit Digani Date: Wed, 21 Feb 2024 19:42:16 -0800 Subject: [PATCH 04/25] Fix threadgroup memory in arg reduce (#723) --- mlx/backend/metal/kernels/arg_reduce.metal | 12 +++++------- mlx/backend/metal/primitives.cpp | 2 -- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/mlx/backend/metal/kernels/arg_reduce.metal b/mlx/backend/metal/kernels/arg_reduce.metal index f153b920d..f24a32ce8 100644 --- a/mlx/backend/metal/kernels/arg_reduce.metal +++ b/mlx/backend/metal/kernels/arg_reduce.metal @@ -11,8 +11,6 @@ template struct IndexValPair { uint32_t index; U val; - - IndexValPair(uint32_t _index, U _val) : index(_index), val(_val) {} }; template @@ -65,10 +63,10 @@ struct ArgMax { template IndexValPair simd_shuffle_down(IndexValPair data, uint16_t delta) { - return IndexValPair( + return IndexValPair{ simd_shuffle_down(data.index, delta), simd_shuffle_down(data.val, delta) - ); + }; } @@ -82,7 +80,6 @@ template const device size_t& ndim [[buffer(5)]], const device size_t& axis_stride [[buffer(6)]], const device size_t& axis_size [[buffer(7)]], - threadgroup IndexValPair *local_data [[threadgroup(0)]], uint gid [[thread_position_in_grid]], uint lid [[thread_position_in_threadgroup]], uint lsize [[threads_per_threadgroup]], @@ -111,7 +108,9 @@ template auto in_idx = elem_to_loc(gid / lsize, shape, in_strides, ndim); auto out_idx = elem_to_loc(gid / lsize, shape, out_strides, ndim); - IndexValPair best(0, Op::init); + IndexValPair best{0, Op::init}; + + threadgroup IndexValPair local_data[32]; // Loop over the reduction axis in lsize*N_READS buckets for (uint r=0; r < ceildiv(axis_size, N_READS*lsize); r++) { @@ -172,7 +171,6 @@ template const device size_t& ndim [[buffer(5)]], \ const device size_t& axis_stride [[buffer(6)]], \ const device size_t& axis_size [[buffer(7)]], \ - threadgroup IndexValPair *local_data [[threadgroup(0)]], \ uint gid [[thread_position_in_grid]], \ uint lid [[thread_position_in_threadgroup]], \ uint lsize [[threads_per_threadgroup]], \ diff --git a/mlx/backend/metal/primitives.cpp b/mlx/backend/metal/primitives.cpp index 38ec5993c..056bbbc80 100644 --- a/mlx/backend/metal/primitives.cpp +++ b/mlx/backend/metal/primitives.cpp @@ -430,8 +430,6 @@ void ArgReduce::eval_gpu(const std::vector& inputs, array& out) { compute_encoder->setBytes(&ndim, sizeof(size_t), 5); compute_encoder->setBytes(&axis_stride, sizeof(size_t), 6); compute_encoder->setBytes(&axis_size, sizeof(size_t), 7); - compute_encoder->setThreadgroupMemoryLength( - simd_size * (sizeof(uint32_t) + in.itemsize()), 0); compute_encoder->dispatchThreads(grid_dims, group_dims); } } From 04fc89601695ef6c06558aae82f152ee90d11640 Mon Sep 17 00:00:00 2001 From: Awni Hannun Date: Thu, 22 Feb 2024 11:54:17 -0800 Subject: [PATCH 05/25] version bump (#727) --- CMakeLists.txt | 2 +- setup.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 8b1a4cf52..ffccb37d4 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -18,7 +18,7 @@ option(MLX_BUILD_METAL "Build metal backend" ON) option(BUILD_SHARED_LIBS "Build mlx as a shared library" OFF) if(NOT MLX_VERSION) - set(MLX_VERSION 0.3.0) + set(MLX_VERSION 0.4.0) endif() # --------------------- Processor tests ------------------------- diff --git a/setup.py b/setup.py index 961655419..cebf88621 100644 --- a/setup.py +++ b/setup.py @@ -152,7 +152,7 @@ if __name__ == "__main__": setup( name="mlx", - version=get_version("0.3.0"), + version=get_version("0.4.0"), author="MLX Contributors", author_email="mlx@group.apple.com", description="A framework for machine learning on Apple silicon.", From ad4a45e615b70ec361feb58c8cda87ecababfece Mon Sep 17 00:00:00 2001 From: Angelos Katharopoulos Date: Thu, 22 Feb 2024 14:09:13 -0800 Subject: [PATCH 06/25] Fix the release builds in CI (#729) --- .circleci/config.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.circleci/config.yml b/.circleci/config.yml index 250f35faa..94e4e909f 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -237,6 +237,14 @@ workflows: jobs: - mac_build_and_test - linux_build_and_test + + build_pypi_release: + when: + and: + - not: << pipeline.parameters.nightly_build >> + - not: << pipeline.parameters.weekly_build >> + - not: << pipeline.parameters.test_release >> + jobs: - build_release: filters: tags: From 126c9869c8005259b8511242b569d97d4b1d2b63 Mon Sep 17 00:00:00 2001 From: Rifur13 Date: Thu, 22 Feb 2024 18:10:48 -0500 Subject: [PATCH 07/25] Implement the 'where' primitive for conditional selection (#664) --- benchmarks/cpp/single_ops.cpp | 6 + mlx/backend/accelerate/primitives.cpp | 1 + mlx/backend/common/CMakeLists.txt | 1 + mlx/backend/common/binary.h | 44 ++-- mlx/backend/common/binary_two.h | 22 +- mlx/backend/common/default_primitives.cpp | 1 + mlx/backend/common/ops.h | 7 + mlx/backend/common/select.cpp | 72 ++++++ mlx/backend/common/ternary.h | 226 ++++++++++++++++++ mlx/backend/metal/kernels/CMakeLists.txt | 1 + mlx/backend/metal/kernels/compiled_preamble.h | 1 + mlx/backend/metal/kernels/ternary.h | 10 + mlx/backend/metal/kernels/ternary.metal | 184 ++++++++++++++ mlx/backend/metal/kernels/utils.h | 48 ++++ mlx/backend/metal/primitives.cpp | 118 +++++++-- mlx/backend/no_metal/primitives.cpp | 1 + mlx/compile.cpp | 10 +- mlx/ops.cpp | 19 +- mlx/primitives.cpp | 118 +++++++++ mlx/primitives.h | 17 ++ tests/autograd_tests.cpp | 31 +++ tests/ops_tests.cpp | 45 ++++ tests/vmap_tests.cpp | 64 +++++ 23 files changed, 991 insertions(+), 56 deletions(-) create mode 100644 mlx/backend/common/select.cpp create mode 100644 mlx/backend/common/ternary.h create mode 100644 mlx/backend/metal/kernels/ternary.h create mode 100644 mlx/backend/metal/kernels/ternary.metal diff --git a/benchmarks/cpp/single_ops.cpp b/benchmarks/cpp/single_ops.cpp index 69cba09e9..4505282f1 100644 --- a/benchmarks/cpp/single_ops.cpp +++ b/benchmarks/cpp/single_ops.cpp @@ -73,6 +73,7 @@ void time_unary_ops() { void time_binary_ops() { int M = 1000, N = 100, K = 10; + auto condition = random::randint(0, 2, {M, N, K}); auto a = random::uniform({M, N, K}); auto b = random::uniform({M, N, K}); auto device = default_device(); @@ -84,7 +85,9 @@ void time_binary_ops() { TIME(divide, a, b, device); TIME(maximum, a, b, device); TIME(minimum, a, b, device); + TIME(where, condition, a, b, device); + condition = array({true}); b = random::uniform({1}); eval(b); TIMEM("scalar", add, a, b, device); @@ -93,7 +96,9 @@ void time_binary_ops() { TIMEM("scalar", multiply, a, b, device); TIMEM("vector-scalar", divide, a, b, device); TIMEM("scalar-vector", divide, b, a, device); + TIMEM("scalar-vector", where, condition, a, b, device); + condition = broadcast_to(array({true}), {1000, 100}); a = broadcast_to(random::uniform({1}), {1000, 100}); b = broadcast_to(random::uniform({1}), {1000, 100}); eval(a, b); @@ -101,6 +106,7 @@ void time_binary_ops() { TIMEM("scalar-scalar broadcast", subtract, a, b, device); TIMEM("scalar-scalar broadcast", multiply, a, b, device); TIMEM("scalar-scalar broadcast", divide, a, b, device); + TIMEM("scalar-scalar broadcast", where, condition, a, b, device); } void time_strided_ops() { diff --git a/mlx/backend/accelerate/primitives.cpp b/mlx/backend/accelerate/primitives.cpp index e147b5888..1d4258f62 100644 --- a/mlx/backend/accelerate/primitives.cpp +++ b/mlx/backend/accelerate/primitives.cpp @@ -64,6 +64,7 @@ DEFAULT(Reshape) DEFAULT(Remainder) DEFAULT(Round) DEFAULT(Scatter) +DEFAULT(Select) DEFAULT(Sigmoid) DEFAULT(Sign) DEFAULT(Slice) diff --git a/mlx/backend/common/CMakeLists.txt b/mlx/backend/common/CMakeLists.txt index 38a9819e5..569d690ef 100644 --- a/mlx/backend/common/CMakeLists.txt +++ b/mlx/backend/common/CMakeLists.txt @@ -43,6 +43,7 @@ target_sources( ${CMAKE_CURRENT_SOURCE_DIR}/reduce.cpp ${CMAKE_CURRENT_SOURCE_DIR}/rope.cpp ${CMAKE_CURRENT_SOURCE_DIR}/scan.cpp + ${CMAKE_CURRENT_SOURCE_DIR}/select.cpp ${CMAKE_CURRENT_SOURCE_DIR}/softmax.cpp ${CMAKE_CURRENT_SOURCE_DIR}/sort.cpp ${CMAKE_CURRENT_SOURCE_DIR}/threefry.cpp diff --git a/mlx/backend/common/binary.h b/mlx/backend/common/binary.h index fb397b669..673d9cd14 100644 --- a/mlx/backend/common/binary.h +++ b/mlx/backend/common/binary.h @@ -9,7 +9,7 @@ namespace mlx::core { namespace { -enum BinaryOpType { +enum class BinaryOpType { ScalarScalar, ScalarVector, VectorScalar, @@ -20,17 +20,17 @@ enum BinaryOpType { BinaryOpType get_binary_op_type(const array& a, const array& b) { BinaryOpType bopt; if (a.data_size() == 1 && b.data_size() == 1) { - bopt = ScalarScalar; + bopt = BinaryOpType::ScalarScalar; } else if (a.data_size() == 1 && b.flags().contiguous) { - bopt = ScalarVector; + bopt = BinaryOpType::ScalarVector; } else if (b.data_size() == 1 && a.flags().contiguous) { - bopt = VectorScalar; + bopt = BinaryOpType::VectorScalar; } else if ( a.flags().row_contiguous && b.flags().row_contiguous || a.flags().col_contiguous && b.flags().col_contiguous) { - bopt = VectorVector; + bopt = BinaryOpType::VectorVector; } else { - bopt = General; + bopt = BinaryOpType::General; } return bopt; } @@ -42,11 +42,11 @@ void set_binary_op_output_data( BinaryOpType bopt, bool donate_with_move = false) { switch (bopt) { - case ScalarScalar: + case BinaryOpType::ScalarScalar: out.set_data( allocator::malloc_or_wait(out.itemsize()), 1, a.strides(), a.flags()); break; - case ScalarVector: + case BinaryOpType::ScalarVector: if (b.is_donatable() && b.itemsize() == out.itemsize()) { if (donate_with_move) { out.move_shared_buffer(b); @@ -61,7 +61,7 @@ void set_binary_op_output_data( b.flags()); } break; - case VectorScalar: + case BinaryOpType::VectorScalar: if (a.is_donatable() && a.itemsize() == out.itemsize()) { if (donate_with_move) { out.move_shared_buffer(a); @@ -76,7 +76,7 @@ void set_binary_op_output_data( a.flags()); } break; - case VectorVector: + case BinaryOpType::VectorVector: if (a.is_donatable() && a.itemsize() == out.itemsize()) { if (donate_with_move) { out.move_shared_buffer(a); @@ -97,7 +97,7 @@ void set_binary_op_output_data( a.flags()); } break; - case General: + case BinaryOpType::General: if (a.is_donatable() && a.flags().row_contiguous && a.itemsize() == out.itemsize() && a.size() == out.size()) { if (donate_with_move) { @@ -424,25 +424,25 @@ void binary_op( set_binary_op_output_data(a, b, out, bopt); // The full computation is scalar scalar so call the base op once - if (bopt == ScalarScalar) { + if (bopt == BinaryOpType::ScalarScalar) { *(out.data()) = op(*a.data(), *b.data()); return; } // The full computation is scalar vector so delegate to the op - if (bopt == ScalarVector) { + if (bopt == BinaryOpType::ScalarVector) { opsv(a.data(), b.data(), out.data(), b.data_size()); return; } // The full computation is vector scalar so delegate to the op - if (bopt == VectorScalar) { + if (bopt == BinaryOpType::VectorScalar) { opvs(a.data(), b.data(), out.data(), a.data_size()); return; } // The full computation is vector vector so delegate to the op - if (bopt == VectorVector) { + if (bopt == BinaryOpType::VectorVector) { opvv(a.data(), b.data(), out.data(), out.size()); return; } @@ -475,17 +475,17 @@ void binary_op( // Case 1: LxM and FxM where L and F are broadcastable and M is row contiguous int dim = ndim; if (int d = std::max(a_rc_dim, b_rc_dim); d < ndim) { - bopt = VectorVector; + bopt = BinaryOpType::VectorVector; dim = d; // Case 2: LxM and Fx1 where L and F are broadcastable and M is row // contiguous } else if (int d = std::max(a_rc_dim, b_s_dim); d < ndim) { - bopt = VectorScalar; + bopt = BinaryOpType::VectorScalar; dim = d; // Case 3: Lx1 and FxM where L and F are broadcastable and M is row // contiguous } else if (int d = std::max(a_s_dim, b_rc_dim); d < ndim) { - bopt = ScalarVector; + bopt = BinaryOpType::ScalarVector; dim = d; } @@ -495,20 +495,20 @@ void binary_op( size_t stride; if (dim == 0 || strides[dim - 1] < 16) { stride = 1; - bopt = General; + bopt = BinaryOpType::General; dim = ndim; } else { stride = strides[dim - 1]; } switch (bopt) { - case VectorVector: + case BinaryOpType::VectorVector: binary_op_dispatch_dims(a, b, out, opvv, dim, stride); break; - case VectorScalar: + case BinaryOpType::VectorScalar: binary_op_dispatch_dims(a, b, out, opvs, dim, stride); break; - case ScalarVector: + case BinaryOpType::ScalarVector: binary_op_dispatch_dims(a, b, out, opsv, dim, stride); break; default: diff --git a/mlx/backend/common/binary_two.h b/mlx/backend/common/binary_two.h index 3468cb61e..3ce2f7110 100644 --- a/mlx/backend/common/binary_two.h +++ b/mlx/backend/common/binary_two.h @@ -260,14 +260,14 @@ void binary_op( set_binary_op_output_data(a, b, out_b, bopt); // The full computation is scalar scalar so call the base op once - if (bopt == ScalarScalar) { + if (bopt == BinaryOpType::ScalarScalar) { std::tie(*(out_a.data()), *(out_b.data())) = op(*a.data(), *b.data()); return; } // The full computation is scalar vector so delegate to the op - if (bopt == ScalarVector) { + if (bopt == BinaryOpType::ScalarVector) { opsv( a.data(), b.data(), @@ -278,7 +278,7 @@ void binary_op( } // The full computation is vector scalar so delegate to the op - if (bopt == VectorScalar) { + if (bopt == BinaryOpType::VectorScalar) { opvs( a.data(), b.data(), @@ -289,7 +289,7 @@ void binary_op( } // The full computation is vector vector so delegate to the op - if (bopt == VectorVector) { + if (bopt == BinaryOpType::VectorVector) { opvv( a.data(), b.data(), @@ -327,17 +327,17 @@ void binary_op( // Case 1: LxM and FxM where L and F are broadcastable and M is row contiguous int dim = ndim; if (int d = std::max(a_rc_dim, b_rc_dim); d < ndim) { - bopt = VectorVector; + bopt = BinaryOpType::VectorVector; dim = d; // Case 2: LxM and Fx1 where L and F are broadcastable and M is row // contiguous } else if (int d = std::max(a_rc_dim, b_s_dim); d < ndim) { - bopt = VectorScalar; + bopt = BinaryOpType::VectorScalar; dim = d; // Case 3: Lx1 and FxM where L and F are broadcastable and M is row // contiguous } else if (int d = std::max(a_s_dim, b_rc_dim); d < ndim) { - bopt = ScalarVector; + bopt = BinaryOpType::ScalarVector; dim = d; } @@ -347,20 +347,20 @@ void binary_op( size_t stride; if (dim == 0 || strides[dim - 1] < 16) { stride = 1; - bopt = General; + bopt = BinaryOpType::General; dim = ndim; } else { stride = strides[dim - 1]; } switch (bopt) { - case VectorVector: + case BinaryOpType::VectorVector: binary_op_dispatch_dims(a, b, out_a, out_b, opvv, dim, stride); break; - case VectorScalar: + case BinaryOpType::VectorScalar: binary_op_dispatch_dims(a, b, out_a, out_b, opvs, dim, stride); break; - case ScalarVector: + case BinaryOpType::ScalarVector: binary_op_dispatch_dims(a, b, out_a, out_b, opsv, dim, stride); break; default: diff --git a/mlx/backend/common/default_primitives.cpp b/mlx/backend/common/default_primitives.cpp index c65028d95..53b7a65f7 100644 --- a/mlx/backend/common/default_primitives.cpp +++ b/mlx/backend/common/default_primitives.cpp @@ -87,6 +87,7 @@ DEFAULT(Reshape) DEFAULT(Round) DEFAULT(Scan) DEFAULT(Scatter) +DEFAULT(Select) DEFAULT(Sigmoid) DEFAULT(Sign) DEFAULT(Sin) diff --git a/mlx/backend/common/ops.h b/mlx/backend/common/ops.h index 8b2d7ab58..560296622 100644 --- a/mlx/backend/common/ops.h +++ b/mlx/backend/common/ops.h @@ -588,4 +588,11 @@ struct LogicalOr { }; }; +struct Select { + template + T operator()(bool condition, T x, T y) { + return condition ? x : y; + } +}; + } // namespace mlx::core::detail diff --git a/mlx/backend/common/select.cpp b/mlx/backend/common/select.cpp new file mode 100644 index 000000000..1daa771b3 --- /dev/null +++ b/mlx/backend/common/select.cpp @@ -0,0 +1,72 @@ +// Copyright © 2023 Apple Inc. + +#include + +#include "mlx/backend/common/ternary.h" +#include "mlx/primitives.h" + +namespace mlx::core { + +namespace { + +template +void select_op( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + switch (out.dtype()) { + case bool_: + ternary_op(a, b, c, out, op); + break; + case uint8: + ternary_op(a, b, c, out, op); + break; + case uint16: + ternary_op(a, b, c, out, op); + break; + case uint32: + ternary_op(a, b, c, out, op); + break; + case uint64: + ternary_op(a, b, c, out, op); + break; + case int8: + ternary_op(a, b, c, out, op); + break; + case int16: + ternary_op(a, b, c, out, op); + break; + case int32: + ternary_op(a, b, c, out, op); + break; + case int64: + ternary_op(a, b, c, out, op); + break; + case float16: + ternary_op(a, b, c, out, op); + break; + case float32: + ternary_op(a, b, c, out, op); + break; + case bfloat16: + ternary_op(a, b, c, out, op); + break; + case complex64: + ternary_op(a, b, c, out, op); + break; + } +} + +} // namespace + +void Select::eval(const std::vector& inputs, array& out) { + assert(inputs.size() == 3); + const auto& condition = inputs[0]; + const auto& a = inputs[1]; + const auto& b = inputs[2]; + select_op(condition, a, b, out, detail::Select()); +} + +} // namespace mlx::core diff --git a/mlx/backend/common/ternary.h b/mlx/backend/common/ternary.h new file mode 100644 index 000000000..52d202df7 --- /dev/null +++ b/mlx/backend/common/ternary.h @@ -0,0 +1,226 @@ +// Copyright © 2023 Apple Inc. + +#pragma once +#include "mlx/allocator.h" +#include "mlx/array.h" +#include "mlx/backend/common/ops.h" +#include "mlx/backend/common/utils.h" +namespace mlx::core { + +namespace { + +// TODO: Add support for more combinations of input types. +enum class TernaryOpType { + ScalarScalarScalar, + General, +}; + +TernaryOpType +get_ternary_op_type(const array& a, const array& b, const array& c) { + TernaryOpType topt; + if (a.data_size() == 1 && b.data_size() == 1 && c.data_size() == 1) { + topt = TernaryOpType::ScalarScalarScalar; + } else { + topt = TernaryOpType::General; + } + return topt; +} + +void set_ternary_op_output_data( + const array& a, + const array& b, + const array& c, + array& out, + TernaryOpType topt, + bool donate_with_move = false) { + switch (topt) { + case TernaryOpType::ScalarScalarScalar: + out.set_data( + allocator::malloc_or_wait(out.itemsize()), 1, b.strides(), b.flags()); + break; + case TernaryOpType::General: + out.set_data(allocator::malloc_or_wait(out.nbytes())); + break; + } +} + +template +void ternary_op_dims1( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + const T1* a_ptr = a.data(); + const T2* b_ptr = b.data(); + const T3* c_ptr = c.data(); + + U* dst = out.data(); + size_t a_idx = 0; + size_t b_idx = 0; + size_t c_idx = 0; + for (size_t i = 0; i < out.size(); ++i) { + dst[i] = op(a_ptr[a_idx], b_ptr[b_idx], c_ptr[c_idx]); + a_idx += a.strides()[0]; + b_idx += b.strides()[0]; + c_idx += c.strides()[0]; + } +} + +template +void ternary_op_dims2( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + const T1* a_ptr = a.data(); + const T2* b_ptr = b.data(); + const T3* c_ptr = c.data(); + + U* dst = out.data(); + size_t a_idx = 0; + size_t b_idx = 0; + size_t c_idx = 0; + size_t out_idx = 0; + for (size_t i = 0; i < a.shape()[0]; ++i) { + for (size_t j = 0; j < a.shape()[1]; ++j) { + dst[out_idx++] = op(a_ptr[a_idx], b_ptr[b_idx], c_ptr[c_idx]); + a_idx += a.strides()[1]; + b_idx += b.strides()[1]; + c_idx += c.strides()[1]; + } + a_idx += a.strides()[0] - a.strides()[1] * a.shape()[1]; + b_idx += b.strides()[0] - b.strides()[1] * b.shape()[1]; + c_idx += c.strides()[0] - c.strides()[1] * c.shape()[1]; + } +} + +template +void ternary_op_dims3( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + const T1* a_ptr = a.data(); + const T2* b_ptr = b.data(); + const T3* c_ptr = c.data(); + U* dst = out.data(); + size_t a_idx = 0; + size_t b_idx = 0; + size_t c_idx = 0; + size_t out_idx = 0; + for (size_t i = 0; i < a.shape()[0]; ++i) { + for (size_t j = 0; j < a.shape()[1]; ++j) { + for (size_t k = 0; k < a.shape()[2]; ++k) { + dst[out_idx++] = op(a_ptr[a_idx], b_ptr[b_idx], c_ptr[c_idx]); + a_idx += a.strides()[2]; + b_idx += b.strides()[2]; + c_idx += c.strides()[2]; + } + a_idx += a.strides()[1] - a.strides()[2] * a.shape()[2]; + b_idx += b.strides()[1] - b.strides()[2] * b.shape()[2]; + c_idx += c.strides()[1] - c.strides()[2] * c.shape()[2]; + } + a_idx += a.strides()[0] - a.strides()[1] * a.shape()[1]; + b_idx += b.strides()[0] - b.strides()[1] * b.shape()[1]; + c_idx += c.strides()[0] - c.strides()[1] * c.shape()[1]; + } +} + +template +void ternary_op_dims4( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + const T1* a_ptr = a.data(); + const T2* b_ptr = b.data(); + const T3* c_ptr = c.data(); + + U* dst = out.data(); + size_t a_idx = 0; + size_t b_idx = 0; + size_t c_idx = 0; + size_t out_idx = 0; + for (size_t i = 0; i < a.shape()[0]; ++i) { + for (size_t j = 0; j < a.shape()[1]; ++j) { + for (size_t k = 0; k < a.shape()[2]; ++k) { + for (size_t ii = 0; ii < a.shape()[3]; ++ii) { + dst[out_idx++] = op(a_ptr[a_idx], b_ptr[b_idx], c_ptr[c_idx]); + a_idx += a.strides()[3]; + b_idx += b.strides()[3]; + c_idx += c.strides()[3]; + } + a_idx += a.strides()[2] - a.strides()[3] * a.shape()[3]; + b_idx += b.strides()[2] - b.strides()[3] * b.shape()[3]; + c_idx += c.strides()[2] - c.strides()[3] * c.shape()[3]; + } + a_idx += a.strides()[1] - a.strides()[2] * a.shape()[2]; + b_idx += b.strides()[1] - b.strides()[2] * b.shape()[2]; + c_idx += c.strides()[1] - c.strides()[2] * c.shape()[2]; + } + a_idx += a.strides()[0] - a.strides()[1] * a.shape()[1]; + b_idx += b.strides()[0] - b.strides()[1] * b.shape()[1]; + c_idx += c.strides()[0] - c.strides()[1] * c.shape()[1]; + } +} + +template +void ternary_op_dispatch_dims( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + switch (out.ndim()) { + case 1: + ternary_op_dims1(a, b, c, out, op); + return; + case 2: + ternary_op_dims2(a, b, c, out, op); + return; + case 3: + ternary_op_dims3(a, b, c, out, op); + return; + case 4: + ternary_op_dims4(a, b, c, out, op); + return; + } + + const T1* a_ptr = a.data(); + const T2* b_ptr = b.data(); + const T3* c_ptr = c.data(); + U* dst = out.data(); + for (size_t i = 0; i < out.size(); i++) { + int a_idx = elem_to_loc(i, a.shape(), a.strides()); + int b_idx = elem_to_loc(i, b.shape(), b.strides()); + int c_idx = elem_to_loc(i, c.shape(), c.strides()); + dst[i] = op(a_ptr[a_idx], b_ptr[b_idx], c_ptr[c_idx]); + } +} + +template +void ternary_op( + const array& a, + const array& b, + const array& c, + array& out, + Op op) { + TernaryOpType topt = get_ternary_op_type(a, b, c); + set_ternary_op_output_data(a, b, c, out, topt); + + // The full computation is scalar-scalar-scalar so we call the base op once. + if (topt == TernaryOpType::ScalarScalarScalar) { + *(out.data()) = op(*a.data(), *b.data(), *c.data()); + return; + } + + ternary_op_dispatch_dims(a, b, c, out, op); +} + +} // namespace + +} // namespace mlx::core diff --git a/mlx/backend/metal/kernels/CMakeLists.txt b/mlx/backend/metal/kernels/CMakeLists.txt index afd2fbc8a..2b97ff76c 100644 --- a/mlx/backend/metal/kernels/CMakeLists.txt +++ b/mlx/backend/metal/kernels/CMakeLists.txt @@ -27,6 +27,7 @@ set( "scan" "softmax" "sort" + "ternary" "unary" "gather" "scatter" diff --git a/mlx/backend/metal/kernels/compiled_preamble.h b/mlx/backend/metal/kernels/compiled_preamble.h index d5bf33696..12fdc8117 100644 --- a/mlx/backend/metal/kernels/compiled_preamble.h +++ b/mlx/backend/metal/kernels/compiled_preamble.h @@ -1,6 +1,7 @@ // Copyright © 2023-2024 Apple Inc. #include "mlx/backend/metal/kernels/binary.h" +#include "mlx/backend/metal/kernels/ternary.h" #include "mlx/backend/metal/kernels/unary.h" typedef half float16_t; diff --git a/mlx/backend/metal/kernels/ternary.h b/mlx/backend/metal/kernels/ternary.h new file mode 100644 index 000000000..e0235d9dd --- /dev/null +++ b/mlx/backend/metal/kernels/ternary.h @@ -0,0 +1,10 @@ +// Copyright © 2023-2024 Apple Inc. + +#pragma once + +struct Select { + template + T operator()(bool condition, T x, T y) { + return condition ? x : y; + } +}; diff --git a/mlx/backend/metal/kernels/ternary.metal b/mlx/backend/metal/kernels/ternary.metal new file mode 100644 index 000000000..f3021fc11 --- /dev/null +++ b/mlx/backend/metal/kernels/ternary.metal @@ -0,0 +1,184 @@ +// Copyright © 2023 Apple Inc. + +#include +#include + +#include "mlx/backend/metal/kernels/utils.h" +#include "mlx/backend/metal/kernels/bf16.h" +#include "mlx/backend/metal/kernels/ternary.h" + +template +[[kernel]] void ternary_op_g_nd1( + device const bool* a, + device const T* b, + device const T* c, + device T* d, + constant const size_t& a_strides, + constant const size_t& b_strides, + constant const size_t& c_strides, + uint index [[thread_position_in_grid]]) { + auto a_idx = elem_to_loc_1(index, a_strides); + auto b_idx = elem_to_loc_1(index, b_strides); + auto c_idx = elem_to_loc_1(index, c_strides); + d[index] = Op()(a[a_idx], b[b_idx], c[c_idx]); +} + +template +[[kernel]] void ternary_op_g_nd2( + device const bool* a, + device const T* b, + device const T* c, + device T* d, + constant const size_t a_strides[2], + constant const size_t b_strides[2], + constant const size_t c_strides[2], + uint2 index [[thread_position_in_grid]], + uint2 grid_dim [[threads_per_grid]]) { + auto a_idx = elem_to_loc_2(index, a_strides); + auto b_idx = elem_to_loc_2(index, b_strides); + auto c_idx = elem_to_loc_2(index, c_strides); + size_t out_idx = index.x + (size_t)grid_dim.x * index.y; + d[out_idx] = Op()(a[a_idx], b[b_idx], c[c_idx]); +} + +template +[[kernel]] void ternary_op_g_nd3( + device const bool* a, + device const T* b, + device const T* c, + device T* d, + constant const size_t a_strides[3], + constant const size_t b_strides[3], + constant const size_t c_strides[3], + uint3 index [[thread_position_in_grid]], + uint3 grid_dim [[threads_per_grid]]) { + auto a_idx = elem_to_loc_3(index, a_strides); + auto b_idx = elem_to_loc_3(index, b_strides); + auto c_idx = elem_to_loc_3(index, c_strides); + size_t out_idx = index.x + (size_t)grid_dim.x * (index.y + (size_t)grid_dim.y * index.z); + d[out_idx] = Op()(a[a_idx], b[b_idx], c[c_idx]); +} + +template +[[kernel]] void ternary_op_g_nd( + device const bool* a, + device const T* b, + device const T* c, + device T* d, + constant const int shape[DIM], + constant const size_t a_strides[DIM], + constant const size_t b_strides[DIM], + constant const size_t c_strides[DIM], + uint3 index [[thread_position_in_grid]], + uint3 grid_dim [[threads_per_grid]]) { + auto idx = elem_to_loc_3_nd(index, shape, a_strides, b_strides, c_strides); + size_t out_idx = index.x + (size_t)grid_dim.x * (index.y + (size_t)grid_dim.y * index.z); + d[out_idx] = Op()(a[idx.x], b[idx.y], c[idx.z]); +} + +template +[[kernel]] void ternary_op_g( + device const bool* a, + device const T* b, + device const T* c, + device T* d, + constant const int* shape, + constant const size_t* a_strides, + constant const size_t* b_strides, + constant const size_t* c_strides, + constant const int& ndim, + uint3 index [[thread_position_in_grid]], + uint3 grid_dim [[threads_per_grid]]) { + auto idx = elem_to_loc_3_nd(index, shape, a_strides, b_strides, c_strides, ndim); + size_t out_idx = index.x + grid_dim.x * (index.y + grid_dim.y * index.z); + d[out_idx] = Op()(a[idx.x], b[idx.y], c[idx.z]); +} + +#define instantiate_ternary_g(name, type, op) \ + template [[host_name(name)]] \ + [[kernel]] void ternary_op_g( \ + device const bool* a, \ + device const type* b, \ + device const type* c, \ + device type* d, \ + constant const int* shape, \ + constant const size_t* a_strides, \ + constant const size_t* b_strides, \ + constant const size_t* c_strides, \ + constant const int& ndim, \ + uint3 index [[thread_position_in_grid]], \ + uint3 grid_dim [[threads_per_grid]]); \ + +#define instantiate_ternary_g_dim(name, type, op, dims) \ + template [[host_name(name "_" #dims)]] \ + [[kernel]] void ternary_op_g_nd( \ + device const bool* a, \ + device const type* b, \ + device const type* c, \ + device type* d, \ + constant const int shape[dims], \ + constant const size_t a_strides[dims], \ + constant const size_t b_strides[dims], \ + constant const size_t c_strides[dims], \ + uint3 index [[thread_position_in_grid]], \ + uint3 grid_dim [[threads_per_grid]]); \ + +#define instantiate_ternary_g_nd(name, type, op) \ + template [[host_name(name "_1")]] \ + [[kernel]] void ternary_op_g_nd1( \ + device const bool* a, \ + device const type* b, \ + device const type* c, \ + device type* d, \ + constant const size_t& a_strides, \ + constant const size_t& b_strides, \ + constant const size_t& c_strides, \ + uint index [[thread_position_in_grid]]); \ + template [[host_name(name "_2")]] \ + [[kernel]] void ternary_op_g_nd2( \ + device const bool* a, \ + device const type* b, \ + device const type* c, \ + device type* d, \ + constant const size_t a_strides[2], \ + constant const size_t b_strides[2], \ + constant const size_t c_strides[2], \ + uint2 index [[thread_position_in_grid]], \ + uint2 grid_dim [[threads_per_grid]]); \ + template [[host_name(name "_3")]] \ + [[kernel]] void ternary_op_g_nd3( \ + device const bool* a, \ + device const type* b, \ + device const type* c, \ + device type* d, \ + constant const size_t a_strides[3], \ + constant const size_t b_strides[3], \ + constant const size_t c_strides[3], \ + uint3 index [[thread_position_in_grid]], \ + uint3 grid_dim [[threads_per_grid]]); \ + instantiate_ternary_g_dim(name, type, op, 4) \ + instantiate_ternary_g_dim(name, type, op, 5) \ + +#define instantiate_ternary_all(name, tname, type, op) \ + instantiate_ternary_g("g" #name #tname, type, op) \ + instantiate_ternary_g_nd("g" #name #tname, type, op) \ + +#define instantiate_ternary_float(name, op) \ + instantiate_ternary_all(name, float16, half, op) \ + instantiate_ternary_all(name, float32, float, op) \ + instantiate_ternary_all(name, bfloat16, bfloat16_t, op) + +#define instantiate_ternary_types(name, op) \ + instantiate_ternary_all(name, bool_, bool, op) \ + instantiate_ternary_all(name, uint8, uint8_t, op) \ + instantiate_ternary_all(name, uint16, uint16_t, op) \ + instantiate_ternary_all(name, uint32, uint32_t, op) \ + instantiate_ternary_all(name, uint64, uint64_t, op) \ + instantiate_ternary_all(name, int8, int8_t, op) \ + instantiate_ternary_all(name, int16, int16_t, op) \ + instantiate_ternary_all(name, int32, int32_t, op) \ + instantiate_ternary_all(name, int64, int64_t, op) \ + instantiate_ternary_all(name, complex64, complex64_t, op) \ + instantiate_ternary_float(name, op) + +instantiate_ternary_types(select, Select) diff --git a/mlx/backend/metal/kernels/utils.h b/mlx/backend/metal/kernels/utils.h index 8ef1127b6..9c3d20b30 100644 --- a/mlx/backend/metal/kernels/utils.h +++ b/mlx/backend/metal/kernels/utils.h @@ -91,6 +91,30 @@ inline size_t elem_to_loc( return loc; } +template +inline uint3 elem_to_loc_3_nd( + uint3 elem, + constant const int shape[NDIM], + constant const size_t a_strides[NDIM], + constant const size_t b_strides[NDIM], + constant const size_t c_strides[NDIM]) { + uint3 loc = { + static_cast( + elem.x * a_strides[NDIM - 1] + elem.y * a_strides[NDIM - 2]), + static_cast( + elem.x * b_strides[NDIM - 1] + elem.y * b_strides[NDIM - 2]), + static_cast( + elem.x * c_strides[NDIM - 1] + elem.y * c_strides[NDIM - 2])}; + for (int d = NDIM - 3; d >= 0; --d) { + uint l = elem.z % shape[d]; + loc.x += l * a_strides[d]; + loc.y += l * b_strides[d]; + loc.z += l * c_strides[d]; + elem.z /= shape[d]; + } + return loc; +} + template inline uint2 elem_to_loc_2_nd( uint3 elem, @@ -150,6 +174,30 @@ inline size_t elem_to_loc( return loc; } +inline uint3 elem_to_loc_3_nd( + uint3 elem, + constant const int* shape, + constant const size_t* a_strides, + constant const size_t* b_strides, + constant const size_t* c_strides, + int ndim) { + uint3 loc = { + static_cast( + elem.x * a_strides[ndim - 1] + elem.y * a_strides[ndim - 2]), + static_cast( + elem.x * b_strides[ndim - 1] + elem.y * b_strides[ndim - 2]), + static_cast( + elem.x * c_strides[ndim - 1] + elem.y * c_strides[ndim - 2])}; + for (int d = ndim - 3; d >= 0; --d) { + uint l = elem.z % shape[d]; + loc.x += l * a_strides[d]; + loc.y += l * b_strides[d]; + loc.z += l * c_strides[d]; + elem.z /= shape[d]; + } + return loc; +} + inline uint2 elem_to_loc_2_nd( uint3 elem, constant const int* shape, diff --git a/mlx/backend/metal/primitives.cpp b/mlx/backend/metal/primitives.cpp index 056bbbc80..301adcdea 100644 --- a/mlx/backend/metal/primitives.cpp +++ b/mlx/backend/metal/primitives.cpp @@ -6,6 +6,7 @@ #include #include "mlx/backend/common/binary.h" +#include "mlx/backend/common/ternary.h" #include "mlx/backend/metal/copy.h" #include "mlx/backend/metal/device.h" #include "mlx/backend/metal/kernels/defines.h" @@ -43,24 +44,25 @@ void binary_op( std::ostringstream kname; switch (bopt) { - case ScalarScalar: + case BinaryOpType::ScalarScalar: kname << "ss"; break; - case ScalarVector: + case BinaryOpType::ScalarVector: kname << "sv"; break; - case VectorScalar: + case BinaryOpType::VectorScalar: kname << "vs"; break; - case VectorVector: + case BinaryOpType::VectorVector: kname << "vv"; break; - case General: + case BinaryOpType::General: kname << "g"; break; } kname << op << type_to_name(a); - if (bopt == General && shape.size() <= MAX_BINARY_SPECIALIZED_DIMS) { + if (bopt == BinaryOpType::General && + shape.size() <= MAX_BINARY_SPECIALIZED_DIMS) { kname << "_" << shape.size(); } @@ -80,7 +82,7 @@ void binary_op( set_array_buffer(compute_encoder, outputs[0], 2); set_array_buffer(compute_encoder, outputs[1], 3); - if (bopt == General) { + if (bopt == BinaryOpType::General) { auto ndim = shape.size(); if (ndim > 3) { compute_encoder->setBytes(shape.data(), ndim * sizeof(int), 4); @@ -141,24 +143,25 @@ void binary_op( std::ostringstream kname; switch (bopt) { - case ScalarScalar: + case BinaryOpType::ScalarScalar: kname << "ss"; break; - case ScalarVector: + case BinaryOpType::ScalarVector: kname << "sv"; break; - case VectorScalar: + case BinaryOpType::VectorScalar: kname << "vs"; break; - case VectorVector: + case BinaryOpType::VectorVector: kname << "vv"; break; - case General: + case BinaryOpType::General: kname << "g"; break; } kname << op << type_to_name(a); - if (bopt == General && shape.size() <= MAX_BINARY_SPECIALIZED_DIMS) { + if (bopt == BinaryOpType::General && + shape.size() <= MAX_BINARY_SPECIALIZED_DIMS) { kname << "_" << shape.size(); } @@ -173,7 +176,7 @@ void binary_op( set_array_buffer(compute_encoder, donate_b ? out : b, 1); set_array_buffer(compute_encoder, out, 2); - if (bopt == General) { + if (bopt == BinaryOpType::General) { auto ndim = shape.size(); if (ndim > 3) { compute_encoder->setBytes(shape.data(), ndim * sizeof(int), 3); @@ -202,7 +205,8 @@ void binary_op( compute_encoder->dispatchThreads(grid_dims, group_dims); } else { // Launch a 1D grid of threads - size_t nthreads = bopt == General ? out.size() : out.data_size(); + size_t nthreads = + bopt == BinaryOpType::General ? out.size() : out.data_size(); MTL::Size grid_dims = MTL::Size(nthreads, 1, 1); NS::UInteger thread_group_size = kernel->maxTotalThreadsPerThreadgroup(); if (thread_group_size > nthreads) { @@ -213,6 +217,86 @@ void binary_op( } } +void ternary_op( + const std::vector& inputs, + array& out, + const std::string op) { + assert(inputs.size() == 3); + auto& a = inputs[0]; + auto& b = inputs[1]; + auto& c = inputs[2]; + TernaryOpType topt = get_ternary_op_type(a, b, c); + set_ternary_op_output_data(a, b, c, out, topt, true /* donate_with_move */); + + if (out.size() == 0) { + return; + } + + // Try to collapse contiguous dims + auto [shape, strides] = collapse_contiguous_dims(a, b, c, out); + auto& strides_a = strides[0]; + auto& strides_b = strides[1]; + auto& strides_c = strides[2]; + auto& strides_out = strides[3]; + + std::ostringstream kname; + kname << "g"; + kname << op << type_to_name(b); + if (topt == TernaryOpType::General && + shape.size() <= MAX_BINARY_SPECIALIZED_DIMS) { + kname << "_" << shape.size(); + } + + auto& s = out.primitive().stream(); + auto& d = metal::device(s.device); + auto kernel = d.get_kernel(kname.str()); + auto compute_encoder = d.get_command_encoder(s.index); + compute_encoder->setComputePipelineState(kernel); + set_array_buffer(compute_encoder, a, 0); + set_array_buffer(compute_encoder, b, 1); + set_array_buffer(compute_encoder, c, 2); + set_array_buffer(compute_encoder, out, 3); + + auto ndim = shape.size(); + if (ndim > 3) { + compute_encoder->setBytes(shape.data(), ndim * sizeof(int), 4); + compute_encoder->setBytes(strides_a.data(), ndim * sizeof(size_t), 5); + compute_encoder->setBytes(strides_b.data(), ndim * sizeof(size_t), 6); + compute_encoder->setBytes(strides_c.data(), ndim * sizeof(size_t), 7); + + if (ndim > MAX_BINARY_SPECIALIZED_DIMS) { + compute_encoder->setBytes(&ndim, sizeof(int), 8); + } + } else if (ndim > 0) { + // The shape is implicit in the grid for <= 3D + compute_encoder->setBytes(strides_a.data(), ndim * sizeof(size_t), 4); + compute_encoder->setBytes(strides_b.data(), ndim * sizeof(size_t), 5); + compute_encoder->setBytes(strides_c.data(), ndim * sizeof(size_t), 6); + } else { + // For 0-dim we still need to bind something to these buffers since the + // current ternary kernels always access the strides. + size_t dummy_stride = 0; + int dummy_shape = 0; + compute_encoder->setBytes(&dummy_shape, sizeof(int), 4); + compute_encoder->setBytes(&dummy_stride, sizeof(size_t), 5); + compute_encoder->setBytes(&dummy_stride, sizeof(size_t), 6); + compute_encoder->setBytes(&dummy_stride, sizeof(size_t), 7); + compute_encoder->setBytes(&ndim, sizeof(int), 8); + } + + // Launch up to 3D grid of threads + size_t dim0 = ndim > 0 ? shape[ndim - 1] : 1; + size_t dim1 = ndim > 1 ? shape[ndim - 2] : 1; + size_t rest = out.size() / (dim0 * dim1); + NS::UInteger thread_group_size = kernel->maxTotalThreadsPerThreadgroup(); + if (thread_group_size != 1024) { + throw std::runtime_error("[Metal::binary] Must use 1024 sized block"); + } + MTL::Size group_dims = get_block_dims(dim0, dim1, rest); + MTL::Size grid_dims = MTL::Size(dim0, dim1, rest); + compute_encoder->dispatchThreads(grid_dims, group_dims); +} + void unary_op( const std::vector& inputs, array& out, @@ -619,6 +703,10 @@ void Multiply::eval_gpu(const std::vector& inputs, array& out) { binary_op(inputs, out, "mul"); } +void Select::eval_gpu(const std::vector& inputs, array& out) { + ternary_op(inputs, out, "select"); +} + void Negative::eval_gpu(const std::vector& inputs, array& out) { unary_op(inputs, out, "neg"); } diff --git a/mlx/backend/no_metal/primitives.cpp b/mlx/backend/no_metal/primitives.cpp index 8e66f56b3..4234eeb1c 100644 --- a/mlx/backend/no_metal/primitives.cpp +++ b/mlx/backend/no_metal/primitives.cpp @@ -80,6 +80,7 @@ NO_GPU(Reshape) NO_GPU(Round) NO_GPU(Scan) NO_GPU(Scatter) +NO_GPU(Select) NO_GPU(Sigmoid) NO_GPU(Sign) NO_GPU(Sin) diff --git a/mlx/compile.cpp b/mlx/compile.cpp index 700c07ced..e54778fe1 100644 --- a/mlx/compile.cpp +++ b/mlx/compile.cpp @@ -47,6 +47,10 @@ bool is_binary(const Primitive& p) { typeid(p) == typeid(Subtract)); } +bool is_ternary(const Primitive& p) { + return typeid(p) == typeid(Select); +} + bool is_broadcast(const Primitive& p) { return typeid(p) == typeid(Broadcast); } @@ -60,14 +64,16 @@ bool is_reduction(const Primitive& p) { } bool is_fusable(const Primitive& p) { - return is_unary(p) || is_binary(p) || is_broadcast(p) || is_noop(p); + return is_unary(p) || is_binary(p) || is_ternary(p) || is_broadcast(p) || + is_noop(p); } bool allows_shapeless(const Primitive& p) { return typeid(p) == typeid(Compiled) || is_unary(p) || is_binary(p) || is_noop(p) || is_reduction(p) || typeid(p) == typeid(Softmax) || typeid(p) == typeid(Sort) || typeid(p) == typeid(ArgSort) || - typeid(p) == typeid(ArgPartition) || typeid(p) == typeid(Partition); + typeid(p) == typeid(ArgPartition) || typeid(p) == typeid(Partition) || + typeid(p) == typeid(Select); } Compiled::Compiled( diff --git a/mlx/ops.cpp b/mlx/ops.cpp index 97d4a3a2d..a1d4c5b4e 100644 --- a/mlx/ops.cpp +++ b/mlx/ops.cpp @@ -1149,13 +1149,20 @@ array isneginf(const array& a, StreamOrDevice s /* = {} */) { } array where( - const array& condition, - const array& x, - const array& y, + const array& a, + const array& b, + const array& c, StreamOrDevice s /* = {} */) { - // TODO, fix this to handle the NaN case when x has infs - auto mask = astype(condition, bool_, s); - return add(multiply(x, mask, s), multiply(y, logical_not(mask, s), s), s); + auto condition = astype(a, bool_, s); + Dtype out_dtype = promote_types(b.dtype(), c.dtype()); + auto inputs = broadcast_arrays( + {condition, astype(b, out_dtype, s), astype(c, out_dtype, s)}, s); + + return array( + inputs[0].shape(), + out_dtype, + std::make_unique