From 1176d736ea7f46e44e2fb95906adc00e3e6a4c67 Mon Sep 17 00:00:00 2001 From: Kevin Fasusi Date: Wed, 30 Mar 2016 09:39:08 +0100 Subject: [PATCH] release 0.0.2 rc updated docs --- docs/_build/doctrees/Installation.doctree | Bin 7059 -> 7077 bytes docs/_build/doctrees/calculations.doctree | Bin 11129 -> 8924 bytes docs/_build/doctrees/changelog.doctree | Bin 9032 -> 9095 bytes docs/_build/doctrees/environment.pickle | Bin 74414 -> 60875 bytes docs/_build/doctrees/index.doctree | Bin 4924 -> 4924 bytes docs/_build/doctrees/ipythontest.doctree | Bin 151466 -> 151463 bytes docs/_build/doctrees/modules.doctree | Bin 2533 -> 2533 bytes docs/_build/doctrees/quickstart.doctree | Bin 178829 -> 170782 bytes .../doctrees/supplychainpy.demand.doctree | Bin 116784 -> 115374 bytes .../supplychainpy.distribution.doctree | Bin 2976 -> 2976 bytes docs/_build/doctrees/supplychainpy.doctree | Bin 145662 -> 143626 bytes .../doctrees/supplychainpy.production.doctree | Bin 19985 -> 19826 bytes .../supplychainpy.simulations.doctree | Bin 72989 -> 72137 bytes .../doctrees/supplychainpy.warehouse.doctree | Bin 3992 -> 3992 bytes docs/_build/doctrees/tutorial.doctree | Bin 9003 -> 9021 bytes docs/_build/html/_sources/calculations.txt | 29 +----------------- docs/_build/html/_sources/quickstart.txt | 19 ++++++------ docs/_build/html/calculations.html | 18 ----------- docs/_build/html/genindex.html | 8 ----- docs/_build/html/index.html | 3 -- docs/_build/html/objects.inv | Bin 1647 -> 1640 bytes docs/_build/html/quickstart.html | 19 ++++++++---- docs/_build/html/searchindex.js | 2 +- docs/_build/html/supplychainpy.html | 15 ++------- docs/calculations.rst | 29 +----------------- 25 files changed, 29 insertions(+), 113 deletions(-) diff --git a/docs/_build/doctrees/Installation.doctree b/docs/_build/doctrees/Installation.doctree index b5d9f290d870570a952b75734f5400138842e437..a0ce516a299b56135adc3bb6e18141405fba0d07 100644 GIT binary patch literal 7077 zcmcgx%a0sK9o}8<&d$s}ymqp{VrSDKva%8EOd`S~wy{MV8JU$PD=;}AMeUmDnyH@c zSGubAAqYwiNVX^`AUYA@5dMH5IKc^!0Eq(<7ybeshkz_`=WwFwZ zW~!^|_x+yrtFPajf9J>NX7rz2_2OP8{D8Nj*rPm`bu|#uNaR1vpM5KTBj1u|MM@&x zkJHc%Dd%K>d9UU2aefqbwjGJA_n04eDUBcq^BP!81}RBcHHDqgPv&pZLj_g#cVo`|Za^L33w&mgN7KNM z=w}=e#|~$4DjewG2v$sKHE*Vr2tOJ)zHkV4;?(mak{&q%dpcd(BN?Z7_6&D;u|q5W zZf=ayNXY?@v$RKZIg`s85Gtdw^{h)|lL(Re-Auqz%7S$-OCkc}DZ4H90>ZiZzEF*x z@;&{u-X*=g!jc)={J-hN9ClhR3NlcLa`qV1U{5LRwNlHgZ5D^Ly+`-`sJ)xULwK0C zcaH>%qc+cyBsl6Z;z!9*8!^P&HzF=b5WvE5)Ji#Q^DMMq2+F_S==GbKov_~ zBSgc!v{QowQPJd(07*{|eJ;4|vVIzeCTh6s0j!;do2+;OW z7#;n1q|PJT5tz9)aRar1qSU|=Wq~dNt@agPu&g^0u5I~-ZA&??vs;!^b!3-WSHsR( z>gRHs36b!N?e;)#*y_b$k>6c^JkeX2QKZABeDRh6;9Ne@`YX5GTxkc7d`oLsGpEM5 zda4xZ`cX5Wa#CWKqY+g*N-dZ)QL!nXJ1L-CHY+20s!|zrZv)+ioUM)k)C~MEj-k3% z9#bgfn~x^69@@r0dTFOVk+D}sm1>J!8~uQutER9!uhNvO;#!=0PB4Fshp8Z-7E;Ga04XTxXW?ut3ekfB^-Y;USOLA($BU&XQ8x5f$$He5Jb6ZY*C>wkmwzpVroHOwwnvSzf-{|nhu`Lw3R z+V1=hmLBU)_E+||s!y?GDt+(o#bwX7vGL*L*n|g5BTnJL^;h%}Mgr#nu6)1*Sa$0p zEvwtHVcS@D-B@>cLH)ePxm)bP-mUGD$Rl=ql_NlL`6E$m4zC#mA1@HRXb?=};$mr$ zt;5fomGJN}aGN0!Nf3*`w+>ioj{^4Br-1!U1N##N?A;T4^Z>znTFtYMX_4GzQ3TO#%6~f&9q=@^?-E*(^O7GXhQy^wCz zSStyOGw(j9=46>IQ@OgOZD@oi@Tn>4D2NFNfU0M` zRZ1N-uMb{kT4)U)MObyw-?vn#TIV_`H5oO}_L$v15C5VZs*j*ed0{FLIeTCA$|Vfb zF7H-1qYzi$E-p&CwI+(F0p$YX1-A>zodaAooKZLB;BaVyJkVaV&q}-de)M}+F>r6= zrP?g}p857fXr0tykK8WkJ2s1CED{1|;k|mub#uQ(b70#Q_bC;_)x+(HhZD_6aqjDT zG}_7gh*>T;4o&|QyHAcyY+CXtrx3)dM{ThcGBhQjd#1-ubmMImu zrpfh5Lb7-=BbUo9G_ll?jh-(wFip8N)TLMvQJSn{A9mP#w}($5{yW3^ocf&6pLa2G zTeo@g%oqSfwBBc_;z?A zu+3*G`WeJYByjD(4gOUUWRPFd8*<4w9#_O@4|YB6;a=b-oMv9^f)~P&VzD*Z=N>AW zI=>?uf^^*j-xDm~smoI|+Q+mN#S}(aSjZcpS8tC0A>okpOG6gJoMxhifh3Vh!mVCcMA{h-a(6yM9i z2s79^&;%Ep7723bGJn7V{6o?_h^7Gqrv09x*$n}t1lB4!XTVh-zwPyriji4~-O3FTX996PmbP0)9SAgIqfHNo5+yR-6vn9^G$aCU56(v|@j= z?zq+0)jnDZ_Hl7E}!7;O+5V z!l$CIr85x*klgUFCDaTPb~BX;OL%31q%uJV13fW;e$764om7%dSD@}2ib%a=X Jlx5x4{{Vp&Ki2>N literal 7059 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 j+Ywd^Np8kR4kc7Ppb${T%Z3p`csu> diff --git a/docs/_build/doctrees/changelog.doctree b/docs/_build/doctrees/changelog.doctree index d3fcf3be0147e1f585fd551321e7f9b973f790e6..118466f2c4489c4762caa0f34eb796df8a2ad5d4 100644 GIT binary patch literal 9095 zcmd5?Tc{mZ89uq3SeYN%l!<6ltSPnv0aAJ87F}no@?fXV%$k_LFq$>)mY+TB^Vc-!#ogh-b0^ykb zotQ-QS?5X8H3NbqezK8&FE{MQQ?ksHEcIwEM{>CXJ1O>TU)CaWf(VfYtxSNj62+LG zb=7K`(oQcVoSWaHz1D4kuY1Q@#9Oo?$=IQx@iB+(k~;-ytCe%M2XNTu6owrI+H>

M;_;-PL(0mCxfLZqqPnH&PCQ$DzZ~kS@_M zzq*AT!P9oJ+JzLhzu3HTJ!eND-=|b-7{oNc>aY`d0J|^dBx76HHg<>|?sfK1u`>WZ zB6o6tfuJkuQW_r>fe2}(nH`Xm7y7y>Gy|Dcnz8QXLI?`30;fTOh{9HYy2j1{>{m6A z^Q^%xW-aVH*~-F@3O5YEy)bQMLkiTmYIOrxVx^1iH6EZ%?SOp!g6~t`3F0LfNRqBP zBqrf154Z#0aI)B=serg0pGGA18_osYO`Rn5X^KH<5;+ZzFP(H6Vnv|YH2Hxidgchy zk8~Rd@r{jzc!>EB;FDH>cObx?>1`x+OlsOWw=m~6g#KDddR0ljx2`047DWW2T}PrX zTy$=~cITu+y(CVez%#OS?q(#0U9CFDE?iTok!qBP=?U(W)cmYr;^UV!?|#-I+d z-viKb3+SVo=B*|bA?icS**HY)GPrMMi1Yyo%b*|X0^&byhWKM3e%d1bV_n3UR3Gsk zgZRam3lfG}^JUa)b_4l8HbeezAU|P||Gg%1xpxgPWiPf0Sl^4;57^tq8(leXp>1V; zRp*^9GFD^k757#7%2{}HDLpvM-qU_t*t2q|ua%=g;r@l&5}hewp=Smc>U-q|zBqAF zr(Mpqq+N;te0l54G`#P^Gs=T+kkx=HTV6J z*>}|Ld!p99mF%q_gDTCy@O(`SR}6+Ri{V@!L(Ne1O=FW$661{Eku*&D85|Fy%=nB+ z3i^*lMw0O$ZaWuscI_lx5kvuh$jKhr7Le1co66}>=Z=xlgq6_^BcnPAoSkaJP3I*u zbK@BKsu8HoZ+qErSvV)17U4*mlNd=E&qBeSWWf=PI%PHVrC*L%k7RiWvQtBlca0z? ztsvV&2+~X)N{|PQAgvgbZ2T;wj(~x7gR)3A83=N3)gX7zkejmPzB2?lGj%9(UohmB zY0zc@rVu4KueKesL~*32D$}PP!J(`lA?nTm-S=wH{gI(NZRx%{1YI+AD7scfo3q?x zAjo}CgWN9-xfx6Dr$dl4Q$GPn4r z!OJ0O&2A9+R}CWnF+}Dpk$=`FBKNL=s+3@sUSRce%;L3aQ;SNP$=<0ZmIFt|H4@As zQL)Jqa?JnFk*#xJYrSOA!8jy~d#!Z$t4EV8)=ZeJjJdPU>22+P=>F8E2oH768g%Z zxm82%fF+jdks(A@=3LiqKJYtmP2Ra0|q;i@Tj z6I`qH>V~+lN(C-c<-Wm+qU{-xQ^gXx7S)vFsP37Fp(>H%szj!0SGq{o`4!kTt9QCh zIbey+&If8#XFt$4HF`N$0aX+;Cws+Dn&wT3DuS1!CfjW)Lo{3N#bOB8f5nTKkD9=50wmWD*+7^sF_`vDXG)+<$7j=FJQNSHg_4P!KZ55ILxKkAKxWeZ8 zxc6y=)I|wuA!wuN2{U`W#b#9@nB!H)AnTB*Iy3YZ3$o%e9En49ELK(4ByMBFbiq@F zbW>tb8}8`sGe=hfI1vm#?^dTd^~8|3Uy@LCjH!RO+FzLh9%DN~AQlD6k@l$*y$KA%I;5G9mdmHIxlj@||9xG0!{kpQDH zw4ZwF^jXMuilc%j+`AdR3E=sCcCjg^6s!L3PZYb0B*B*l0Tl~+cP63`JCCbV7-&Xa zrBSVco;@|?ER9;!hZt5v${D2swlHO^xDd)#Ia5^$3f;GEUODxZT<-J2ge1c;7_ekh659n?P7)&8r9!#0#)UZGo_@X=Nr|xA+VI(ZSlWl5tah)^yX5 zs_!W{j8(AG;3*d$T)<0;U}CJk7jCq%C7CGODR^XJLGhR|7V0hqJV1p4yUi?#tR!X&<>=ouXZbZ`LwfS+|HwvC|p4$2-?II+}B z)iGfVn(!$OPm>djgs9+~PZmby?jq)tNGh#Z&(vnB!;uyi^pr$e5db>grZKLcjN}eN zi&5n>7UO*`2S1wM&suW2c;A?hTo5>?dz(X&>LnoODv{B*tvgiM(QgSk1{1Syw9%~9 F_%CXPzlHz+ literal 9032 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 diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle index 70fed83491f272c0926d3087afd13757d5190423..e07628f710da83f95803912f5b3a4de0018c62c0 100644 GIT binary patch literal 60875 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 Lac_0IJ)iymV!*JE literal 74414 zcmdUY378zmbsi63cX1yAcz_3nSO{Ez*x4lrf|p1UBo2a$i&%mnMUc(jncl4)%uElv zd-kA6+O#Byw3{Jfj%XeJY>SqBM0PA$j-prz9es8r$F^+xvlW}MtjO{wA5`MR31dZ$ z6y;S_S9e|AGris8kE>4v1~Xmny?Xz9uU@@6`iGZ&=$#i`d=dU%u+eKFyE$LBnzOd+ zG#gga?*!}bY1{ScLGG)UJ3F82JkuEo*0`2ynN`EA&zTEe=Oz4=*KW1y3l(JA&DKKa zLa@S^Gu`HNyIJWR4+du~*R!2wXJRZ^?>iOWwJgJKR_g7l_)q8;-9=uaJl#!$Z8>{?O7cw7;FHE zI>_}{NA8vxEVr9gYaV_Y306R7n=@A3ndtSmEBtKk<;`o&xbG2W_W_*2LDPFAAU?cvc;3YZi>yaTm&F)2uIemf^TntZOtF z3}K@r7IMB5+@7ViG3`1HK(1~Xt~005k|g2mtsH+gymq5ux(gjt4hE>DbwG|Iq8!xp zBjG_{%k@DOM)<>N_Qe6>BW2P%P+c257mWuiOrN@lg=wG6M|*zZDWg(1Je{>x%mOx1ygX`4jKuT6ESg@ zuNA3r|0-jPQlJ~-o@gzEk*BPR9exGqjf-}4KudrbUswFRb8W+}s(PKwN0u5rGdTmS zuvND(mjQ@3$f;sgC595T9UX?>cZnic5VeeH$8DItS3U%;a47s-@n*4FMbq0SHfCl$ zRWZP-%KN7(55r$3{8KeBPDIHzLMkAHRWUuE`2+|;{#~B2nwD=@V0fB=(B-3s)Z>S> zLRk=aoCY+bzVu|O)LpVHBhP-s6G!lkTc9!M!RW4uB14LWV&7Sr;fNVk`k5TkykX`t3|n)K4^@9 zkU~7?2JxZP&Vlfx&8XNWB%Cx5;NTUf1b2vSyL2}+7cvL3q~s!>RXZ)K8TpWk$~#3d z!!E`aNWWl8lv29{CDPUloL6fd8r)hFOHXJ8>N&G9Vd{sCkdCS(Z5GmxlpZv2;5RBb z@|Pzqzuk&Qf^rjQ9d#H0V2EfKRenmS7`onSl6t^YD-U!qIfE?4GMhL8LL`Jw;iSUA z6BO-?V832>;$T^6(|PHv#f4LY3kqB&B!Q8DcTzy*22QJD*|WN#Q&JY^CQM;`A`ZS! z98*G(d3>0)bWJ(r+{-5kc6v||@F-|F#*s21lS`g9hbn-n0apQmS_+pZi#f-FWzw0b z*g+{E3IzB>o6L@tOj|NF4maKWX_CwY(t_MwVt2YBO5D4Qr!nLc3^#JlCv}fEUCz-V zwS|0x#d~Q0>?VXfD|Rg!b?Pv{LYgc~biKBVaj2yRkLRj%#2VH`LPyyYojt5f0vk9!n^TTgZ^IxG=c$I}y0}^(2rSX=;yj|;KpJ$; zGMd($!R14oGVpINMMdT317%^B5kByZ+0k3X{E?IF?jvP#l+p;XLjkW8v4@gOHp zT;C-!3IkrEk(;2vPQbkU^isKQj=*S335t66P1y(wYmC5vh%%HK5#f=M6Ouz+ASb3~HhpF(qr{`x<{X60%LP$L|rv$vTot31XM3o0PhzR?@h_O`meo$kGs^XDLs(NmOt*(h-T+LW<1>v=erTMK>Yk{&T5P zq+)pp=*`fQkef0q=U~;;Frj|v7_GWlvB;9M62qi9O-2LpAdaiXD`_WzX0JX1%K$11 zsXi0}kT{5g2(T(+So1BX3AI#MYc;%vdngtSG-Q?q&=tPU7HtffMb5U@M98h5=nD`p|OxDe=La=uX>Ez)l!jYGIr#jE!7rt0JpA!znn|-739|($if6S2 zSf_$rB`&N4S+jP+mWJNOxa5IC%+V8*sT3aoCCL4ja>dllHg&IxJd)6DBw{VAtPfLM zZ9@vTSz(yA=V87{vLu5I6>1QXW+7c&q|5YGGE8ylU>rG4l9$U3pIZ_m4|(8`Nw@-#w`_kx``Fm&>)e*H8jCjI3wt7woU4~%$&KEC^GE~ z>z#P0jWdixq7LJbAk1cxl1y%8U7jFF3&$A=(+z-1t|}#c8Hq+~wfdsNF;NxSbAhx~ z@7@B<2)Hp%IZ$@>qZ~ptxB|jNwvSWm$U)@41dr zD!fB9+NYN@<-tRHw<*UXVqbaROcNUKw{!6p&Gbcit}l{>^NixpNrgqS%7`~h%5hy< zq77lUoF|!GXt#86R!?UoJ*7taDhb!cl)cj7d}gOs+hlJbzeZ;?)cL!#I2-Fs7#b6E zQ*oS?5+XjQWSP3$nRum}J&~`L7gmH+NOMlLwOcE&e~Y0}a#m(ISvG`?K(9TC1I8TL)MaDi0Umk$JY6tNj z^ow>oxTHoDiIp9y-zDdki2B2CDy?F@lp|bvUnvSLK?pdFXW0e)51_@c|$>ul7=B3i{wyseCzp6v-)~v6JMml{o1it2z~6v9j(oXW$qB=7;TRYp@o6zzjXuf`|{V z1vpv@$w-L(S__yGo9dEyuEvPeXXPgQHILAJuj%`el#=fAUm2SmBy;o&yse ziw4YK5O(w8M?1AT=sy^O-M96sYc=6CTJ0SEX4!-I;1n3);1PO&tn&ddLoCz)Rvw%U zsx>ikPveK9XWCO{dkSr?HQ-x%z^~SVkI<~}Tzvk&*Pm#acgc!BIXW$zm zTJ2f-$aC;lu=9*nuYlG|z9W|LulGt=mw4%il;Eyo($>ynLeJwrh@=@P(7tTzS6^1% zOOE`Nj>4J0P_?s;FVwvu5=LUtTZzhgd2~9OM0A0*$xKy zx3w+E~MSLi=i1qIR$jAKk}0`yooXHcJX8E=HRtECIpehC7@zD>owqD;&tyUGPoPmlbexgVBN< zgbEnmnoxTXlo(tkI?e$;2gJNqPvG>tbjbADp4~AgE(XSEMX-FlJYL>|FG6ry3ohQP z3SHSVe&fE~C80sE*0*3o4U8!sNZ=z(a-|V{2c1~%;lo65Eydc_!VDg7pb+mb;91@P z)fr4Cta)-d1*QNxA$kr53{sv23hR;IfL%J|v}43%F#H03UrB!V5$tOMT9l~a`f${f zezgJrj;wl%oMtCEJv)9Wh@U8{>QQ6*5OXg!|6quG!xa<9>KqC5ZadE zsZQ-Z@I&n^{&fJrXv0Pp4B${5?yP9zYUu zPG(k3wd-}uH|ns>Cz@U5nVI|uR!BHAA=9N5n6zPoX)KODnWnrSQ^nI1ZVvQf%qdtG zIy0=mg%idNFdKpl9X7w2a5By{TPO$nmo)4@60@hOTmh3!xUmK9j8HkzX&js4(YYNi z4OHOtD4lHLd44z(34&uL|ADdx!c(G~cQEAby&&clGo$}4DduqM3LC?d6zW++f< zTL8k#aFwg`LXBb-3|34MGdss64_qCRp`|Whj4nr4pexZ9i@D+u90jUcEg0Y?E)gB@ zFCxXpcKIgm`7#`;I}@wIC~VuParl%R+DApVhY6b!rzsU#$(o-B9FdXJhS^667 zzRLPgBq})C?a37FzOE5N!Gc7)8^xujzh(_-w7U`J_jC@IE86L_QdqS6E)$tkIX8Oc ziguSQ??VcT;k+pmoU1fqC~yi9OmM7Cta*Q;Tt5NW!9?f4%^l@10DCh5Fs2bh0YHjc z0tB}*0$pPpjd0*}Q2%~=rTzD_K5$rYj+QU&pVSb~3pABePW!hfr~PL&LMSkIU4s{Z zw<40CDQYgDQ&nNnv>nN-oeSiOrq60<=fyZ!1-F4r!FDQg@3WGxq=5ZFjWi0_D<@;( z0wtfRjh1;6$9|&lDwCXZ6h8Kw|O_t``nTXaVivVip|jnE2M(%qqH%u7^U zG5Ps5#w1t-rKJG2%18vta~wwT zFuUVzHq5@sW@VvY9AdcN{{Ba*jxPoLG$ z&I@vvlsX0NAJRyppv~vY0gOLgMZ)>DgaF;F~h*|MxCv-FE zw-|N#9W<#VmIBHHgKU-&59YZ;eW@GDnV?;#5mA9QJ+Z!mkw{If<2m%Mw^?Gni^57pngEqkE>-VJPORUh5kdi3JP{-$TL+`|e^yiyt%3uv%zm>%RDWiL=v60;O^XEYKi=&q%wUrP^#Z)g_Yt_h@ zg315Wh@xPkKQb~n6sFSBg$7vli`@A@_Eze&Q&=8yB@Y z!VKaN>xbSTawVoGG_-Tu13m#E+e0Roe^?`xVh3=nA!HKSfw)X-GAj54gz_lEJ#QH9 zCpsSM0f&5UbT$ve3D2fKir&r65jMDDN7)D-`T<5K z&_B#!M6;q?wb?F#HJ2a#1nWtWNR?nZ0mpNzqi|xmiQfxJP86|AFSCO7Ga3;U(6$~R z97`udj^ua|yN45V6!7~+Ml$Hyj)StFAm$q#zrgxaB#Ntt**2l9i2asE90jpeXW;fG z1jnZpbiTrx2f{N9iChDoPE*`~mkZ+m!sO;qC~B7RHyYZxBkHE%7Ti7p`X~O0FIdWo z^xtd5QjmVfNy>%z|#EZ^i#=?sagm(>T ztzcj!TQ$f*aVeO@6|AF0nnc2e!UQxH69ul*h^-idvtc}x(8K5-YmmLpCQC3lsF7O1KV`^PxNG4*&bXwF{)wcP0{Ty|9u|rIbzMh^O4-p}OcVB#j+`RXb!YKZ5Z>rpx7y2^NRUF8*x5DLiY z_e%>Um7k92Er*-!m@6(8R#H;Y>8Y@i%CAK77GF~NyoPpOfV-4bQjq?lMj8d_#FEPI zu-1Jksq_bJ)Bq^Zf+$qE&rZph!56#WYM`2xiFdc+7%$EB%IV?T7wr>W&!&Fjfe`^(tSfQD=o0^VI+gD?Un+Fb=I9CLEN1>G_xH%;j11q z0ovAxs{nd~c8HePYQcS$kqGCHx#|oFEZi%?=sWghTkz;p9qW5ceh#6+>R8KH7e61Pa>{kA zJ;`;fwHhH5kcHQf31zFxqvr1@s%)iGOJQZJ>mzxKFI$akXy-1NtQf}cp_;X=In{Sl zV7*NvivsJ=2}WAL^d8nWh#x2_oc2@y4>GwqXU(nu-p+-jAn}++Dg_DMVGjY5X-1{5 z=R*34&OGZuk?33wgB{#rTS5CFnQGbml`1y$P-?1DIor@BSO~| zHU8-oRM`0UcE=`_V*T>CZ{llWq|-rnW42EV~;E&gL2{$oAn)~VF3RAydexS}s|zLu*_#aq;9tSr8QH{oKfZuVM&Xgrf(V* zcp)mh`BrzBH3go78Zi}k9U|lK_(1c5WE&L*7 zs93{Gh_j7Uwnj(=PU(;i&rA!Z%ZLU&v|I{MzMpmIp8!g7_B(N{BgHdc)Ck!PN}ib( z%2yas8A@Htr2yqGunrXo<%quW8S02T+NjPBQvm&pMpOmR>&1jaWvPYr*BR-c=k`kh z+}~r}DiYjxrhyw>-H{2|uWIB}kln6BHsYs+_3Mmo&|BlBfa(8WeflTElwCjoFN>GU z*(u)oU5%W*VH)w%VtUEiFgw>{sx)2-m~LWyDiYIc^?n*w%(8)bjYdEP%xgpkWsI~a z?qCFiF0GaVe7CaB6bWC_R`_`PWF~jquaQwfPhjy9d|n882`ZXRm-9kj7ubx^d)WC_bq!<>hE zTz%A;SSHp!KNV>$F2l#Q&t*dG^Y)CjPndk*xBiv+swZA$+V?hduHV(@pfKn9V-4~C zIM=>p=lXMv5Q=kM1~-*8+I7<-S0o*LvP~}Bk>1|+R}rNoQ>>tT%07 zGy?U(qVkx2;xf$S=LXB%xLiN%`2dFLRsoh-oA}14Gd-FMt=$?)6|{CthKvEMka5YG zF2xvzW+GsCGou{z+I%S>dzkgANMzRzyO!ftEf=tywd$GN?W9H^1;90@D1Cqo(-&}h zgb@g&rG*(X%@})^aUI616);rs(nW<6gA&?X_eH*~BbVq4Y#-$Hy#8aTT<{-Q>)@j(4(h2O3r3XT8r4eAa zQ*@ksBIo@;zjm4yjHytr-hmPYuWl96825U37gVnyAdaWqI0cb zbOQau97fT8&vvj{c)QCpoe@-isWTGXS1ykUrIxXHqp62KvkS<|mGCV}H{IMAoxgRT zv2X7vT!`MDADwBo%bwE-Zb&7?-6dCsf=+N_uTRtKut=LdscmAxBbhOyTYGIJ+<4W4 zj2yo?yIFPSNSl#Vc7|btpBn~#^a2{k2<%cC&@6vUI)_N8-<0$)djqI^>YcROme^{l zV$3f*MIKV&3+0H<$k8vz(|071gz>w(sf;GIj(M?@fP|Y0d?*`BS`3o37%XWajfRt$ zh#+joAnZ_{jh5HO_{W3sln29`k}V@@i{-e01~CT>2Eqm>B63Ng&hNG$k6f)hBFLvw z;5Y3g=!G&7q}FIe-C>YQE?Tfo5Ib}qi~PJ*=@l20@Dmr%4y?tU%5(f()dEx(&^I?|ESt-C%7wPN!OTa+x6;L zNW$v`>!)of@d5+Gwa9P4cm%Bl9izbu=yLq`<_lTAEc?wK#Xfi}~R z?_GT{+D1P<_3@KvJN@{X%U?h{=*L%o^7qjQ{rHL3{~OvxKQ0V>2kj1@J%0?9>BmnW zeFKftkFO4$LVM`P_wD#L8l)dzwm*qB(vQzx^^0g9{kZV`fp)NR+G#hdR8-ulZDEL|yHOd9qwQ!AZAAMn1Vf(X`_NU=t6+1b?wIEcDAd_?!>m?a%ku!r=Y!QP zt7YIfgcxnN-U&*`_gmiWV`Fo3c+l~Y(=0pg%ovob#^6bBtP^bXtcnl2*kKA+w~Tqb zLlBg>ZU)#{^FC;{0XxurAblBz6-Fh`al01RY?B zJXmjm9ajy{UjSP}mgR%c*Z3}^A=8fIHyz&s>zf8kZ&obBgDzO`z*>l0__ZI<%(cu0 zxP#Y1c5}Ym_U(GP39nQE^Ida>J~T<6dAURPx(Am6!A@`q{$q%!1=P`b8M2wPBO?b6 z-gEl!(?^aUI`QI=FM}(ecr}kDcAwnJAs_oB{$^ zkZBl#JIC8o?O<(a$}lr)&VUTysF#|pR_AyyU^gJ=hYg!mxXT;_d8soMtcD!InumoV z7rzq``_|USI%qTew+;T={#a*ZBpATEc0oS*u8=r%t7A}Ugs#r)gq(|hf*h8=nJBGs zhvd+HXQcL{kafzd-%(4B$F=D^7(ol|fF4n*@}^;K+Z;#uIxS&7{4?4n8o}D4#P^Av zjRUUsrR^NQy;^=<+A|SC<~JuY*F<}c_f6e+Ynn@}-+j!ifD>4ykqRvIcqO|jZC&7c zqM^34Q+xPgn6KcqlnDM~5R)LV%{2|YXfd+0G?Jx%WhPO>f{0b!*+DOfB2%N#6zcfz;+=3J2^UWN~Ha8 zKHY01W4)+-Rss4fjJyy`p(~44SsKG>h2dm~Oh${+Ffn}ypi^z%0{i-ysKTR@Hh$G! zQC9XxB6aD)iB@C^{43hySiGy7i^l{c&z82<$Io#AWNR1djHHEj!QiqR{wv2JQ@Z0M zp67b}y9YRKyS3aB+A-E)h`f8!^4l$P(v==`P4fB#auBGNLyQu!I7SlG@X}n>+Y?BY zWl|%?eyt|LVWsLcVmK35X?gA3BT2v-? z;o3=hxkDUrc@@N;#T(=~&bM{NC5eb6#)GlL5_Lkk62GM&ambFzCSNiSi2b~x+&P#M z;iMOGdsriMU>?%4+zMpLkUyvUSIkmWM>#=sSoHT{J&O4}dO`FADV2+<3mu~ME6@W~ zH00d+R4%=_r0gTH#EaB(C>Ch=zbhJkLeQ{b!lVUsn-)uA;hAxBI%N`aL8Z1=Vfwhp zblQeXI}2s`gu?Qy$P)I+70D3&rD!fPH%PywWI5KN&VssV^hCGrd49D>hUk~Y?mgka zE8HWu?2FMnuXOQok!kTpbBU5joE2FXZ8YBzwJLKf*l4a%G%7JH*l23^DhyNdiP#^) zyp0Q@-SY{hwG=}S$1(H_S**!ARM90Kh@ittr%r|ox;;8vxLBkJ#7E43P?$UsGBHdT z0v!Whbz89-_{G7!g_T~I9#NP+B*e_(SfM~P{1bFJr#J?+O-f%*Bd3n*mr&&MiqzWW z3a8_wl2>47epz903U5XvRhR9FgSe1xIaV!@Q)50##sRZTky+yt^^Sv<~4 zYyVkcXoQ9@VpJs0io)}uuvSE~fn;aswTH~9Yj-NF-XpLwTxYI0cIeZhGd?WvN_5Iz zd&T3{QaWa615A;)eOKXmmO6?tYr3{MW!GVse~}Drm7%;%uTX~QH%0uWC2q8vu*pR? z@#_*ZQoV48($UAK?RnU~B5p=3QnxQFEGH9Zf;qZ|-Y2T`1nE(c9r-P#Bd4j>DzJM> znV#qA$`P?EXXsGNGKAv7NbQSCmmU{+8IY^N`g3tC(c@y@&Z=X7k(eD)I(Q~LPe(U! z703(ynb@-j66QyF4C6y0i-+i8G`i4KWLMfEpOg9-OP-!QDsni>&ac8{a_ktXG(XS5 zt@Z)M3?}g;ujufKep~95nt~RI(ovDyU17va*gVxme~=U2t!U|906we4R0=+YxKW{d zKQ<^DX>yZC|4CGXwCWjlTN+?lnS@Kw^{bxg&87VO*un6K;0b&}Fg_rdj!1%N0Lb?g z#mR|6+z;)XIe~OpFDH-LqYCS41I~do;Ofp^l9NR;W@;7LAAn2P(tZs!{E3Ar%i}&d^AaRGn!>ghm4x4S*nrF@6{naqDPaKdX zLgh$+Xr{7CLH2&UF$gvi7-oIOacv(p7Ed18qTKhxfh)^&VO~!~cbbc*UHd6T^fL{( z7Z@gzj#r2Mb9}wSa$Uz=JTLV3Vn0rXjG(TD8AYSi;yKhlq4ee`VG==@vkSF(g~5Fd zXBMv~CG42c+jMM0e1LdGA%0RMj<5J7w!e54p}!MB*w40#=OFoQk>qKb;2PF^%W1;e zqz(JxyasIChmFWHi)T|irKsnDIm@0wKFqa5JtYi)Onc$&x_S`SDqJ2(;8Fk@wck^? zjcZ38x^)NE#0+*Kj*F(S9}{1^qz}SsODUk<8Ey;0$iP+uN=w=$9$K+V3!>`7BKp!k zIHe{1f|FjqZ8V{sB>TbrwEjYp18=g+_Ok?<(1-J4A7I-KY?hD8(OqYWv0g$JTCt+x z;s*-o(xs4!j;=~Un5o1|{(EA&ic#P{tVMUn1kz#E&;B8k;LrigYYOi5hdau-Pv zJu8ZL`t=hHOshA2{$a`V?`9`_ zDJfy#PI7;q9C*S`rQZi-qAqOwC&wru6sAQhkuq{c6(p1G60bzEwHFnEcZ!)s_`Lp@ z-SzORno_7uBt`Ggv51aB84L4Q5b{uN05PGiB+AVufB6kOyTN!Yyde(-s%H)J|TK^d(h&UH1 zx*T!aWU8MOvf{?b5w*4#TEZL&-Xmy`7Z&y=0{R<~$}JKVqmi1G#p2ZdtI`+P0*ud! z;290MaivFzeq59Y3X_D&Q*he`+0WY>ncB08Jo4U~_-r(Xe!||H_*uyScEb_=bj0GO u5Tj0uox4o1Mox@PIwNGPEwmA)0s9{7z{ztsECZ%jp?fOvY4Y||`TqkaxF!4m diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree index 14f21848a6fb63f0e0b570d0cdd153010b1a028b..cf00569c22284ff295907c7fe39312e0e92b36fd 100644 GIT binary patch literal 4924 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 diff --git a/docs/_build/doctrees/ipythontest.doctree b/docs/_build/doctrees/ipythontest.doctree index 5d4bd7a58a32a9ee14212feff9fa5008bb7ad299..9f37a38c1d50c07591c279dcae3ad36409591018 100644 GIT binary patch literal 151463 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 literal 151466 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 diff --git a/docs/_build/doctrees/modules.doctree b/docs/_build/doctrees/modules.doctree index 65c1159bf01921d83cbc6007b22e71423cb47c60..16fdf44155f62c79723f02c1b4fffc05617e28c9 100644 GIT binary patch literal 2533 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 literal 178829 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 diff --git a/docs/_build/doctrees/supplychainpy.demand.doctree b/docs/_build/doctrees/supplychainpy.demand.doctree index 7c2c6fd9674145eb5bcc8d1bebb23a4d5dc2140c..da15bdd3227d77f6239e24a62cf01681cba2f116 100644 GIT binary patch literal 115374 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 E0K%OFQvd(} literal 116784 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 H9i09H9i5h= diff --git a/docs/_build/doctrees/supplychainpy.doctree b/docs/_build/doctrees/supplychainpy.doctree index 4131efee3d321177aa305bd1042bfa001c11c193..0f7a91898bf34bd1aa471444aa80879db5f067bd 100644 GIT binary patch literal 143626 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

6wcLqL6Q0elH1siM{tm$E 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 literal 145662 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

s8FsR=9 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 diff --git a/docs/_build/doctrees/supplychainpy.warehouse.doctree b/docs/_build/doctrees/supplychainpy.warehouse.doctree index 0a6d5dcfd492bab012404adde1232853dd77e9f4..27370b80c0e857f08a2f940071bba83a6f998b12 100644 GIT binary patch literal 3992 zcmbVPU2hvj6wQ|tC(Spctwc+M1Sl0sOw|-hD-|9P5=2C;D7;0Z@$T3&cz0*nnN4h| z74QIRr9ntAh&TQOPvwoD#6RH7?5^W=k|t^-OY!V_?!D)pd+)hF%>41o%7p(j%b^T% zEh4p($dD;(n(iQGiMGGnn?Ks8cFU~mj3%lhvzWw8DcZ$*2iCl<260z z9sgieB%#PypoykgmuY{voYG9O+6Bu&o@KB^l+3e$*?qH4b1jGWDg0d9y-Bk%ZmE1S zVHT?^B9XWY<^!Rr7BcZR=Mx$;JxJlNi{qBc(=-|coQfnJ>>SaIahWT&BU3G60q=%K zo3RY@$lbV7{I?m%M8j8wqXm_>i&OXQ#u>M6rZngQE4!cbNj`1XYOz&VT^eG`GIw>z z0-5;;@NHUzrRRmY?K4cB5`g6sX10L;IFZeOizo!-E`1AB>rAwBU82(v3Rdj1!s>zL zHz>%Erw&7pW@Gr@To6&EiqmErVV2PpfzD_2sLZIDux7UU|JN3mF>CeMp-5T}Gx;qT zqFN6Jn#-hBi)`%MFe|N-iP}jA_rO?%P?GMZ>}=L9dTEZWnenUv!Dc~DM|prYr{ER{ zG(?TRePFlnprM5ZBdV%!$2gsN%=)fWUWHsgSzllL_N)Au-{qg=ZOY#Tv-x}QrG?Kn zJ~#2Xbzpri_-+0<|8TF#@0c$xj=saQo`Mk^GXii zVcAF;=mM-?$ICnG9E8JW4v1&MvuFz}LH+=*xqa~jZf+H2aTDmjLV@gROFd!^xe>&6 zf!HL!!#{9g@<;ruyv=e8tRN-jd498gS^uJr%~GCk@duY0%vq>2EQJ$7dF6n4MAh~1xIw^7=C zQrJC(=~sLTYVDYg16$qVy#EN^-yijVYb=13FMZcP?)Aq}oOpy#{=7&ie<75$G89`v z_;@6-XO;v%FlRNh5#qo3a^hQl4$Dn;@xD;2%+`?SEkZ;hG$9x5#jbxiC{8b|%SBo8Z`Q{0aXD5el&F z1%GQS*`^w_zEi)TzInUGeWDHB;eY#9RG{T<{+IW1^z>ab=Q?kx4)_KvU53RguzZ#O zo14`!z2wLD(y0D$C-8jIPq7{bJtlZD-k(AOW-OJNc7nwBz2OK)iz=IUt#6uj2qJ~? z2q7sGGQ4NLQgYsYQ!%a4?Gc2E!zk`!T! zzBN+<9$bSe%r#+2AVc^`SeD6*aGHb>pa2M%R)MxK>pT&VgIPi&CjnPTC=_i+jDU+B z(Z$iV;@4+gw(3-qf{Nn6I-(H2E@_FTeZobTNBF?fOeB*o3}&6ciE9Rp5&)uoGdr}i z#`-8d=wY2J60t)T*}aCDt0XmlXfAgI921FRnNJT(oTpCcEv76bZ3^9+XOT6VTGB1A%yX2jFzc^T_a@e z+*QIQtOF>jf^-1r`k4P?b;kcg6=$dj=Ope~u2&_P;G^AEC^NIbX{4(RH_Up~a7H3@ zDJjd+bJX`Dj}($5W1j_hIp1Xo!{X&(yN(pbwY|0|J)#gCv(KS-m#Rgx*m}`5mxjgx dqg&g|TCFXH<>{>JIexD*P4KH+Whe9Y&i}?%DLw!I literal 3992 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�pT`jL{_?5>rXbO+|E61=O>z_!q{qu1|}k6`pr zy(Iz&XN!D#DODQY4yHxeUD6`mLNSlj2K_=t>&juM(AD9ptG%QMlbV#Z8Tdyx08!el z8{oDNo1oy=R8@tllX4_S9KcC&LFTG0ba)#XVhHie%WTQ|DhMF+MjB^P&}QFhw&#ni ztW!xN#5YDA?u?d;iRDpL_Q^P*k}n)Ee0DLZ&DECdTy3eItL+i8Bq>WF$MgVej^1!;R;z5O znwssQS|xF+7WY@(#hY$`x85A!-D(W*hFbiOk3ymC11j_zPNC103VnV*g}&|-P>vdx zl9E%XAy`6gs7H-^v`|u)W3;flOh10VF=-u&JaQT0-8!Incbs_3rFbvb;_UKbRSU199}&E}l@Zgb8()Yv``L2p|J)Z2SbZ{IBSruWm^t4_+1Dg4sN6n>A) zCEZHqF{*pT5v`~Edq`BRVL7ve%To?$%MY?n?4W9S6g6$M5~5+}ihWVuvXta2?x0ug33AmDc+FCj zx8)o1bxTX$k?+ej%S@J^+_fUH`;WQi+@G#Mj6>C6{)DJkWFD=^MyFkvgV99~1Hu02 zozY?W0@aLETJLF>Gt|hqmu7a8ajlUT5B?5-^(#_Xxz!rUef2QsLhsk4;Om&T+OdA` zm-N+|ZHzP4uh}J4{@g+NZ?y_}eXTs(it>>z}y@hpax3lPcvRrB%uJ>m{k!WYu`_P^yAIOhIK8>>oKZG9oLhT1_ zaYmPaSaLL2u^SQE&*i6e*1_Bkt3LEkUQK7F+Pt|nr51)-8f<}2)oWq&UKnje0pxm< zcB#6?Mt*#qH_* z2zE+%Y>rk*&{6pm_J8w)V^0NMsp9;w0tZiEX_*-hjaf{st0&SlPCW^OhEN3*kJX)T z3LHzE*pUq8UtW z{h`E3N5dG)zI;CI`n3LbivT+CSbfeZERwMB#F8@8Ub$GE%%`dqsJxOthJH zJR%}agW_R6n~21t3dqaSu*jJ-CehcHm$$dK+pYy{$LYp0wsgyQQZE-UG*k&=k81rK z(Xpq1jt2*aL`G^#mfe!TbP^_ECu#fNL@kos2x;IDYm3r*fc!f}Y&P|1Ll4{S{#ej*Q8Y zAU;8Ae$+7m1}pHAhNtB%$wN~ac``p;#hiwaWR=o0Elh1VvdV&;;=VNm7@a|vLO=1a zntKvf?2r8T#Ce~mA)hE7(eknSZGih}3IgX`eK<5}L+PoJ$QYDYX;tGgbv_Mxx*0k literal 9003 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 TH2E)z13EHe-%X(PtiAeglX3?u diff --git a/docs/_build/html/_sources/calculations.txt b/docs/_build/html/_sources/calculations.txt index 2d181a1..e93585f 100644 --- a/docs/_build/html/_sources/calculations.txt +++ b/docs/_build/html/_sources/calculations.txt @@ -79,31 +79,4 @@ where: D = Demand - HC = Holding Cost - - -Purchase Order Quantity ------------------------ - -For the monte carlo siimulation, the - -In release 0.0.3 the purchase order quantity will be compared against a forecast to assess whether it requires adjustment. - - -Backlog and Shortage units --------------------------- - -To aggregate the backlog and shortage units for the `summarise_frame` - - -Normal Sum Deviation --------------------- - -The standard deviation is calculated by first summing the average variance for backlog and quantity sold. - - -.. math:: - - \sigma_{xy}^2 = \sigma_{x}^2 + \sigma_{y}^2 - - + HC = Holding Cost \ No newline at end of file diff --git a/docs/_build/html/_sources/quickstart.txt b/docs/_build/html/_sources/quickstart.txt index 3350a9a..a70b285 100644 --- a/docs/_build/html/_sources/quickstart.txt +++ b/docs/_build/html/_sources/quickstart.txt @@ -10,13 +10,13 @@ Quick Guide All profiling has been carried out on the following systems: - +------------+------------------------------------+------------------+ - | system | CPU | Ram | - +============+====================================+==================+ - | PC | Xeon 1650v3 (15M Cache, 3.50 GHz) | 32gb ddr4 2133 | - +------------+------------------------------------+------------------+ - | Macbook Air| i7-4650U | 8gb ddr3 1600 | - +------------+------------------------------------+------------------+ + +------------+------------------------------------+------------------+----------------+ + | system | CPU | Ram | OS | + +============+====================================+==================+================+ + | PC | Xeon 1650v3 (15M Cache, 3.50 GHz) | 32gb ddr4 2133 | linux (xubuntu)| + +------------+------------------------------------+------------------+----------------+ + | Macbook Air| i7-4650U | 8gb ddr3 1600 | OS X (yosemite)| + +------------+------------------------------------+------------------+----------------+ Timings are provided as simple benchmarks and will vary based on system and current load. The computation here are mainly cpu bound, io may be a factor when reading from file (csv txt). @@ -324,7 +324,7 @@ when summarised later. The simulation is limited by the assumptions inherent in :ref:`calculations`). To start we need to analyse the orders again like we did in the inventory analysis above: - +388.324289560318 .. code:: python >>> from supplychainpy.model_inventory import analyse_orders_abcxyz_from_file @@ -508,7 +508,8 @@ monte carlo simulation and the original orders analysis. The service level achie reviewed and compared with the desired service level. If below a threshold, then the saftey stock is increased and the whole monte carlo simulation is run again. The new safety stock values are returned when finished. This optimisation step will take as long, if not longer, than the initial monte carlo simulation because the optimisation -step run the simulation again to simulate transactions based on the new safety stock values. Please take this into consideration and adjust your expectation for this optimisation step. +step run the simulation again to simulate transactions based on the new safety stock values. Please take this into +consideration and adjust your expectation for this optimisation step. This feature is in development as is the whole library but this feature will change in the next release. diff --git a/docs/_build/html/calculations.html b/docs/_build/html/calculations.html index c99f89d..2cf38e7 100644 --- a/docs/_build/html/calculations.html +++ b/docs/_build/html/calculations.html @@ -90,9 +90,6 @@

  • Reorder Level
  • Safety Stock
  • Economic Order Quantity (eoq)
  • -
  • Purchase Order Quantity
  • -
  • Backlog and Shortage units
  • -
  • Normal Sum Deviation
  • @@ -205,21 +202,6 @@

    Economic Order Quantity (eoq) -

    Purchase Order Quantity

    -

    For the monte carlo siimulation, the

    -

    In release 0.0.3 the purchase order quantity will be compared against a forecast to assess whether it requires adjustment.

    - -
    -

    Backlog and Shortage units

    -

    To aggregate the backlog and shortage units for the summarise_frame

    -
    -
    -

    Normal Sum Deviation

    -

    The standard deviation is calculated by first summing the average variance for backlog and quantity sold.

    -
    -\[\sigma_{xy}^2 = \sigma_{x}^2 + \sigma_{y}^2\]
    -
    diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html index 1f454d4..6f8e7ed 100644 --- a/docs/_build/html/genindex.html +++ b/docs/_build/html/genindex.html @@ -692,20 +692,12 @@

    R

    - -
    run() (in module supplychainpy.simulate) -
    -
    run_monte_carlo() (in module supplychainpy.simulate)
    - -
    run_monte_carlo_mt() (in module supplychainpy.simulate) -
    -
    diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html index eb8c36d..0a4c11b 100644 --- a/docs/_build/html/index.html +++ b/docs/_build/html/index.html @@ -157,9 +157,6 @@

    Welcome to supplychainpy’s documentation!Reorder Level
  • Safety Stock
  • Economic Order Quantity (eoq)
  • -
  • Purchase Order Quantity
  • -
  • Backlog and Shortage units
  • -
  • Normal Sum Deviation
  • diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv index fcb27b2f5c08e5fb84dec7da3e524811aac53559..103b9777ce149abf24ec535c6126680638ab61ee 100644 GIT binary patch delta 1530 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 diff --git a/docs/_build/html/quickstart.html b/docs/_build/html/quickstart.html index fe636ed..d56dd22 100644 --- a/docs/_build/html/quickstart.html +++ b/docs/_build/html/quickstart.html @@ -147,24 +147,28 @@

    Quick Guide - - - + + + + system CPU Ram +OS PC Xeon 1650v3 (15M Cache, 3.50 GHz) 32gb ddr4 2133 +linux (xubuntu) Macbook Air i7-4650U 8gb ddr3 1600 +OS X (yosemite) @@ -481,8 +485,10 @@

    Monte Carlo simulationcalculations).

    -

    To start we need to analyse the orders again like we did in the inventory analysis above:

    -
    diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js index 0e296f3..0dd721b 100644 --- a/docs/_build/html/searchindex.js +++ b/docs/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({envversion:47,filenames:["Installation","calculations","changelog","index","ipythontest","modules","quickstart","supplychainpy","supplychainpy.demand","supplychainpy.distribution","supplychainpy.production","supplychainpy.simulations","supplychainpy.warehouse","tutorial"],objects:{"":{supplychainpy:[7,0,0,"-"]},"supplychainpy.data_cleansing":{clean_orders_data_col_csv:[7,1,1,""],clean_orders_data_col_txt:[7,1,1,""],clean_orders_data_row:[7,1,1,""],clean_orders_data_row_csv:[7,1,1,""]},"supplychainpy.demand":{abc_xyz:[8,0,0,"-"],analyse_uncertain_demand:[8,0,0,"-"],economic_order_quantity:[8,0,0,"-"],eoq:[8,0,0,"-"],forecast_demand:[8,0,0,"-"],summarise_analysis:[8,0,0,"-"],summarise_demand:[8,0,0,"-"]},"supplychainpy.demand.abc_xyz":{AbcXyz:[8,3,1,""]},"supplychainpy.demand.abc_xyz.AbcXyz":{abc_classification:[8,4,1,""],abcxyz_summary:[8,2,1,""],cumulative_percentage_revenue:[8,4,1,""],orders:[8,2,1,""],percentage_revenue:[8,4,1,""],xyz_classification:[8,4,1,""]},"supplychainpy.demand.analyse_uncertain_demand":{UncertainDemand:[8,3,1,""],order:[8,3,1,""]},"supplychainpy.demand.analyse_uncertain_demand.UncertainDemand":{abc_classification:[8,2,1,""],abcxyz_classification:[8,2,1,""],average_order:[8,4,1,""],average_order_row:[8,4,1,""],average_orders:[8,2,1,""],cumulative_percentage:[8,2,1,""],demand_variability:[8,2,1,""],economic_order_qty:[8,2,1,""],economic_order_variable_cost:[8,2,1,""],fixed_order_quantity:[8,2,1,""],lead_time:[8,2,1,""],order:[8,2,1,""],order_count:[8,2,1,""],orders_summary:[8,4,1,""],orders_summary_simple:[8,4,1,""],percentage_revenue:[8,2,1,""],reorder_level:[8,2,1,""],revenue:[8,2,1,""],safety_stock:[8,2,1,""],sku_id:[8,2,1,""],standard_deviation:[8,2,1,""],unit_cost:[8,2,1,""],xyz_classification:[8,2,1,""]},"supplychainpy.demand.analyse_uncertain_demand.order":{sku:[8,2,1,""],sku_orders:[8,2,1,""]},"supplychainpy.demand.economic_order_quantity":{EconomicOrderQuantity:[8,3,1,""]},"supplychainpy.demand.economic_order_quantity.EconomicOrderQuantity":{economic_order_quantity:[8,2,1,""],minimum_variable_cost:[8,2,1,""]},"supplychainpy.demand.forecast_demand":{Forecast:[8,3,1,""]},"supplychainpy.demand.forecast_demand.Forecast":{autoregressive:[8,4,1,""],genetic_algorithm:[8,4,1,""],linear_regression:[8,4,1,""],mean_aboslute_percentage_error:[8,4,1,""],mean_absolute_deviation:[8,4,1,""],mean_forecast_error:[8,4,1,""],moving_average:[8,2,1,""],moving_average_forecast:[8,4,1,""],optimise:[8,4,1,""],simple_exponential_smoothing:[8,4,1,""],weighted_moving_average:[8,2,1,""],weighted_moving_average_forecast:[8,4,1,""]},"supplychainpy.demand.summarise_analysis":{summary:[8,1,1,""]},"supplychainpy.demand.summarise_demand":{AnalyseOrdersSummary:[8,3,1,""]},"supplychainpy.demand.summarise_demand.AnalyseOrdersSummary":{classification_summary:[8,4,1,""]},"supplychainpy.enum_formats":{FileFormats:[7,3,1,""],PeriodFormats:[7,3,1,""]},"supplychainpy.enum_formats.FileFormats":{csv:[7,2,1,""],text:[7,2,1,""]},"supplychainpy.enum_formats.PeriodFormats":{days:[7,2,1,""],months:[7,2,1,""],quarters:[7,2,1,""],weeks:[7,2,1,""],years:[7,2,1,""]},"supplychainpy.model_demand":{analyse_demand_forecast:[7,1,1,""],analyse_demand_from_file_col:[7,1,1,""],analyse_demand_from_file_row:[7,1,1,""]},"supplychainpy.model_inventory":{analyse_orders:[7,1,1,""],analyse_orders_abcxyz_from_file:[7,1,1,""],analyse_orders_from_file_col:[7,1,1,""],analyse_orders_from_file_row:[7,1,1,""],analyse_orders_np:[7,1,1,""],summarise_analysis:[7,1,1,""]},"supplychainpy.production":{analyse_install_base:[10,0,0,"-"],create_install_base:[10,0,0,"-"],production:[10,0,0,"-"]},"supplychainpy.production.create_install_base":{Machine:[10,3,1,""],MachineBuilder:[10,3,1,""],ProductionDirector:[10,3,1,""],SimpleMachineBuilder:[10,3,1,""]},"supplychainpy.production.create_install_base.Machine":{add_down_time:[10,4,1,""]},"supplychainpy.production.create_install_base.MachineBuilder":{make_new_machine:[10,4,1,""]},"supplychainpy.production.create_install_base.ProductionDirector":{add_down_time:[10,4,1,""],construct_machine:[10,4,1,""],machine:[10,2,1,""]},"supplychainpy.simulate":{optimise_service_level:[7,1,1,""],run:[7,1,1,""],run_monte_carlo:[7,1,1,""],run_monte_carlo_mt:[7,1,1,""],summarise_frame:[7,1,1,""],summarize_window:[7,1,1,""]},"supplychainpy.simulations":{monte_carlo:[11,0,0,"-"],monte_carlo_frame:[11,0,0,"-"],sim_summary:[11,0,0,"-"],simulation_frame_summary:[11,0,0,"-"],simulation_summary:[11,0,0,"-"],simulation_window:[11,0,0,"-"]},"supplychainpy.simulations.monte_carlo":{SetupMonteCarlo:[11,3,1,""]},"supplychainpy.simulations.monte_carlo.SetupMonteCarlo":{build_window:[11,4,1,""],generate_normal_random_distribution:[11,4,1,""],normal_random_distribution:[11,2,1,""]},"supplychainpy.simulations.monte_carlo_frame":{BuildFrame:[11,3,1,""],MainFrame:[11,3,1,""]},"supplychainpy.simulations.simulation_frame_summary":{MonteCarloFrameSummary:[11,3,1,""]},"supplychainpy.simulations.simulation_frame_summary.MonteCarloFrameSummary":{closing_stockout_percentage:[11,5,1,""]},"supplychainpy.simulations.simulation_summary":{MonteCarloSummary:[11,3,1,""]},"supplychainpy.simulations.simulation_summary.MonteCarloSummary":{closing_stock_average:[11,2,1,""],closing_stock_final:[11,2,1,""],closing_stock_max:[11,2,1,""],closing_stock_min:[11,2,1,""],closing_stock_std:[11,2,1,""],opening_stock_average:[11,2,1,""],opening_stock_final:[11,2,1,""],opening_stock_max:[11,2,1,""],opening_stock_min:[11,2,1,""],opening_stock_std:[11,2,1,""]},"supplychainpy.simulations.simulation_window":{MonteCarloWindow:[11,3,1,""]},"supplychainpy.simulations.simulation_window.MonteCarloWindow":{backlog:[11,2,1,""],backlog_at_po_placement:[11,2,1,""],closing_stock:[11,2,1,""],demand:[11,2,1,""],holding_cost:[11,2,1,""],index:[11,2,1,""],lead_time:[11,2,1,""],opening_stock:[11,2,1,""],po_number_raised:[11,2,1,""],po_number_received:[11,2,1,""],po_raised_flag:[11,2,1,""],position:[11,2,1,""],purchase_order_raised_qty:[11,2,1,""],purchase_order_receipt_qty:[11,2,1,""],quantity_sold:[11,2,1,""],revenue:[11,2,1,""],shortage_cost:[11,2,1,""],shortage_units:[11,2,1,""],sku_id:[11,2,1,""],sold:[11,2,1,""]},"supplychainpy.supplychain":{main:[7,1,1,""]},"supplychainpy.warehouse":{optimise_warehouse:[12,0,0,"-"]},supplychainpy:{data_cleansing:[7,0,0,"-"],demand:[8,0,0,"-"],distribution:[9,0,0,"-"],enum_formats:[7,0,0,"-"],model_demand:[7,0,0,"-"],model_distribution:[7,0,0,"-"],model_inventory:[7,0,0,"-"],model_warehouse:[7,0,0,"-"],production:[10,0,0,"-"],simulate:[7,0,0,"-"],simulations:[11,0,0,"-"],supplychain:[7,0,0,"-"],warehouse:[12,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"],"2":["py","attribute","Python attribute"],"3":["py","class","Python class"],"4":["py","method","Python method"],"5":["py","staticmethod","Python static method"]},objtypes:{"0":"py:module","1":"py:function","2":"py:attribute","3":"py:class","4":"py:method","5":"py:staticmethod"},terms:{"15m":6,"1650v3":6,"1st":13,"32gb":6,"4650u":6,"8gb":6,"abstract":10,"case":[6,13],"class":[7,8,10,11],"default":8,"enum":7,"final":11,"float":[4,6,7,8,11],"function":[7,8],"import":[4,6],"int":[7,8,10,11],"long":[6,8],"new":[6,7],"return":[6,7,8,11],"static":11,"true":8,"while":[6,8,13],abc:[2,4,6,8],abc_classif:8,abc_xyz:[5,7],abc_xyz_classif:[4,6,7],abcxyz:[6,7,8,11],abcxyz_classif:[4,6,8],abcxyz_summari:[6,8],abil:13,abl:6,abov:6,absolut:[2,8],accur:6,accuraci:11,achiev:6,across:[6,13],actual:11,add:10,add_down_tim:10,adequ:6,adjust:[1,6,8],advantag:13,affect:6,after:[6,7],again:[6,7],against:1,aggreg:[1,6],air:6,alia:8,all:[0,6,7,11],alreadi:6,also:0,although:6,anaconda:0,analys:[2,6,7],analyse_demand_forecast:7,analyse_demand_from_file_col:7,analyse_demand_from_file_row:7,analyse_install_bas:[5,7],analyse_ord:[6,7],analyse_orders_abcxyz_from_fil:[4,6,7],analyse_orders_from_file_col:7,analyse_orders_from_file_row:7,analyse_orders_np:7,analyse_uncertain_demand:[5,7],analysed_ord:11,analyseorderssummari:8,analysi:[2,3],analyst:6,analyt:[6,7,11],ani:6,anywher:8,api:2,append:8,appli:8,apr:6,arrai:[7,8],arrang:7,assess:1,assist:6,associ:11,assum:6,assumpt:[6,11],attribut:11,aug:6,autom:13,autoregress:8,averag:[1,2,6,7,8],average_backlog:[6,7],average_closing_stock:[6,7],average_opening_stock:[6,7],average_ord:[4,6,7,8],average_order_row:8,average_period:8,average_quantity_sold:[6,7],average_shortage_unit:[6,7],backlog_at_po_plac:11,base:[2,6,7,8,10,11],base_forecast:8,becaus:6,been:6,behaviour:6,below:6,benchmark:6,benefit:13,best:6,book:13,bool:8,borg:11,both:13,bound:6,bucket:7,build:11,build_window:11,builder:10,buildfram:11,built:[7,8],busi:13,cach:6,calcul:[1,6,7,8,11,13],calculate_moving_average_forecast:8,can:[6,13],captur:6,carlo:[1,2,3],carri:6,chain:6,check:8,choic:13,classif:[6,8],classification_summari:8,clean_orders_data_col_csv:7,clean_orders_data_col_txt:7,clean_orders_data_row:7,clean_orders_data_row_csv:7,clone:0,close:11,closing_stock:[6,7,11],closing_stock_averag:11,closing_stock_fin:11,closing_stock_max:11,closing_stock_min:11,closing_stock_std:11,closing_stockout_percentag:11,code:6,collect:[7,8],column:7,come:0,compar:[1,6],complex:6,complic:6,comprehens:13,comput:6,concaten:8,concret:10,consider:6,consist:13,construct_machin:10,consum:13,contain:7,content:[3,5,6],convers:6,correct:6,correspond:7,cost:[1,6,7,8,11],could:13,cover:6,cpu:6,creat:[6,7,11],create_install_bas:[5,7],critic:13,csv:[2,4,6,7],cumul:6,cumulative_percentag:8,cumulative_percentage_revenu:8,current:[6,11],cython:2,dai:7,data:[2,4,6,7,13],data_cleans:5,data_set:[6,7],ddr3:6,ddr4:6,dec:6,decim:[6,7,8,11],decreas:8,deem:6,defin:7,deliveri:[6,7,11],demand_vari:[4,6,7,8],design:6,desir:6,desktop:[4,6],detail:[1,6],develop:6,dict:[2,6,7,8,11],dictionari:[7,11],did:6,differ:6,distribut:[5,6,7],divid:7,doe:[6,13],domain:6,dure:11,dynam:6,each:[6,7,11],easi:13,easiest:0,economic_order_qti:[4,6,8],economic_order_quant:[4,5,6,7],economic_order_variable_cost:[4,6,7,8],economicorderquant:8,edit:13,effort:6,either:8,end:8,enough:8,entri:7,enum_format:5,enumer:[6,7],equal:[8,11],etc:[6,7,11],etl:13,evalu:8,everi:6,exactli:11,exampl:[6,7,8,11],excel:[6,13],except:7,execut:6,exist:[0,6,13],expect:[6,7],experienc:7,express:1,extens:13,extract:13,factor:6,fals:8,favour:[6,13],featur:[6,10],feb:6,few:[11,13],field:8,file:[6,7],file_path:[4,6,7],file_typ:[4,6,7],fileformat:7,finish:6,first:[1,13],fit:6,fix:11,fixed_order_quant:8,folder:6,follow:6,forecast:[1,2,7,8],forecast_demand:[5,7],forecast_length:8,forecasts_typ:7,formal:1,format:[6,8,11,13],frame:[7,11],frame_summari:[6,7],from:[0,2,4,6,7,8,13],fulfil:13,full:[6,7],further:6,gener:[6,7,8,10,11],generate_normal_random_distribut:11,genetic_algorithm:8,get:[8,13],ghz:6,github:0,give:6,given:[8,11],global:11,greater:8,ground:13,guid:[2,3],have:[6,8],hello:4,help:13,here:[1,6],higher:6,histor:6,histori:6,hold:[1,11],holding_cost:[8,11],holding_cost_percentag:11,hopefulli:13,howev:6,identifi:7,implement:6,includ:[6,8,13],incorrect:[7,8],increas:[6,7,8],index:[3,6,7,11],inher:6,initi:[6,7],instanc:11,instruct:6,intellig:13,interact:6,interfac:13,inventori:[2,3],ipython:0,item:7,jan:6,jul:6,jun:6,jupyt:[0,6],kei:6,knowledg:6,kr202:[6,7],kwarg:11,languag:13,larg:6,last:6,later:6,lead_tim:[6,7,8,11],lead_time_np:7,least:13,len:[8,11],length:[7,11],librari:[1,6,13],like:6,limit:6,line:8,linear_regress:8,list:[7,8,11],load:[6,13],longer:6,lower:7,ltd:1,mac:[6,13],macbook:6,machin:10,machine_build:10,machinebuild:10,mad:8,made:6,mai:[0,6],main:7,mainfram:11,mainli:6,make:[6,8,11],make_new_machin:10,mani:[8,13],manual:[6,13],manufactur:6,mar:6,match:11,materi:6,matplotlib:[0,6],max:6,maximum_backlog:[6,7],maximum_closing_stock:[6,7],maximum_opening_stock:[6,7],maximum_quantity_sold:[6,7],maximum_shortage_unit:[6,7],maximum_throughput:10,mean:[2,8],mean_aboslute_percentage_error:8,mean_absolute_devi:8,mean_forecast_error:8,member:8,method:6,middl:13,min:6,minimum:7,minimum_backlog:[6,7],minimum_closing_stock:[6,7],minimum_opening_stock:[6,7],minimum_quantity_sold:[6,7],minimum_shortage_unit:[6,7],minimum_variable_cost:8,model:[6,7,8,11],model_demand:5,model_distribut:5,model_inventori:[4,5,6],model_warehous:5,modul:[2,3,5],mont:[1,2,3],monte_carlo:[5,7],monte_carlo_fram:[5,7],montecarloframesummari:11,montecarlosummari:11,montecarlowindow:11,month:[7,8,11],more:6,most:6,move:[2,8],movement:7,moving_averag:8,moving_average_forecast:8,multi:11,multipl:7,multipli:[6,7],must:[6,11],name:[6,10,13],need:6,neg:11,next:6,nich:13,nitro:6,normal_random_distribut:11,note:6,notebook:13,nov:[6,13],nr381:4,nr382:4,nr383:4,nr384:4,nr385:4,nr386:4,nr387:4,nr388:4,nr389:4,number:[6,7,8,11],numpi:[0,6],object:[7,8,10,11],occur:11,oct:6,often:13,onward:[6,7],open:11,opening_stock:[6,7,11],opening_stock_averag:11,opening_stock_fin:11,opening_stock_max:11,opening_stock_min:11,opening_stock_std:11,openpyxl:[0,6],oper:[6,7],optimis:[2,6,7,8],optimise_service_level:[6,7],optimise_warehous:[5,7],optimised_ord:6,order_count:8,orders_analysi:[6,7],orders_collect:8,orders_summari:[4,6,8],orders_summary_simpl:8,organis:7,origin:[6,8],other:[6,7],out:[6,11,13],output:8,over:[6,7,11],overview:3,packag:[0,5],page:3,panda:[0,6],paramet:[6,7,8,11],part:13,pass:[6,8],path:7,per:7,percentag:[7,11],percentage_revenu:8,perform:7,period:[6,7,8,11],period_length:[6,7,11],periodformat:7,pip:0,pivot:[6,13],place:[6,7],plan:6,pleas:[6,7,8,11],po_number_rais:11,po_number_receiv:11,po_quant:[6,7],po_rais:[6,7],po_raised_flag:11,po_receiv:[6,7],point:[6,7],popular:6,posit:[8,11],power:6,pr381:4,pr382:4,pr383:4,pr384:4,pr385:4,pr386:4,pr387:4,pr388:4,pr389:4,pre:6,predominantli:6,prefer:0,present:13,previou:[6,7],previous:8,print:[4,6,8],prior:7,probabl:[6,11],process:[6,13],processing_tim:10,product:[5,6,7],productiondirector:10,profil:[6,8],program:6,provid:[6,7],publish:13,purchase_order_raised_qti:11,purchase_order_receipt_qti:11,qauntity_on_hand:7,qr321:4,qr322:4,qr323:4,qr324:4,qr325:4,qr326:4,qr327:4,qr328:4,qr329:4,qr381:4,qr382:4,qr383:4,qr384:4,qr385:4,qr386:4,qr387:4,qr388:4,qr389:4,quantity_sold:[6,7,11],quarter:[7,11],quick:[2,3],rais:[7,8,11],ram:6,ran:6,random:[6,7,11],random_normal_demand:11,randomli:[6,11],rang:[4,6],read:6,readm:2,reduc:6,referenc:7,reilli:13,releas:[1,6],relev:13,reliant:6,reorder_cost:[4,6,7,8],reorder_level:[4,6,7,8],reorder_quant:[4,6,7,8],repetit:13,replic:6,report:[6,13],repres:[7,11],request:6,requir:[1,6,7,13],requisit:6,respect:13,result:[2,6,7,11],retriev:6,revenu:[4,6,7,8,11],review:6,rise:13,rol:2,roll:13,row:7,rr381:[4,7],rr382:4,rr383:4,rr384:4,rr385:4,rr386:4,rr387:4,rr388:4,rr389:4,rr481:7,run:[6,7,11,13],run_monte_carlo:[6,7],run_monte_carlo_mt:7,rx983:6,safety_stock:[4,6,7,8],saftei:[6,7],same:[6,7,11],save:13,scalabl:13,scale:13,search:3,second:[6,7],self:13,sep:6,ser:7,servic:[1,6,7,13],service_level:[6,7],set:[7,11],setupmontecarlo:11,sever:[6,11,13],share:[11,13],shortage_cost:[6,7,11],shortage_cost_percentag:11,shortage_unit:[6,7,11],should:[6,7,8],sigma_:1,siimul:1,sim:6,sim_fram:6,sim_summari:[5,7],sim_window:6,similar:6,simpl:6,simple_exponential_smooth:8,simplemachinebuild:10,simul:[2,3,5],simulation_fram:[6,7],simulation_frame_summari:[5,7],simulation_summari:[5,7],simulation_window:[5,7],singl:7,skew:6,sku:[4,6,7,8,11],sku_id:[4,6,7,8,11],sku_ord:8,small:7,snippet:6,sold:[1,11],some:[6,13],soon:6,sourc:0,specif:[6,7],specifi:[6,7,8,11],speed:6,spreadsheet:[6,13],stage:6,standard_devi:[4,6,7,8],standard_deviation_backlog:[6,7],standard_deviation_closing_stock:[6,7],standard_deviation_opening_stock:[6,7],standard_deviation_quantity_sold:[6,7],standard_deviation_revenu:[6,7],standard_deviation_shortage_cost:[6,7],start:[6,8],start_period:8,start_posit:8,statist:6,step:[6,13],still:13,stockout:7,stockout_percentag:[6,7],str:[4,6,7,8,10,11],string:8,submodul:5,subpackag:5,success:6,suit:13,summar:[6,7],summari:[2,6,7,8],summaris:6,summarise_analysi:[5,7],summarise_demand:[5,7],summarise_fram:[1,6,7],summarize_window:[6,7],suppli:[6,8,11],supplybipi:4,supplychain:5,supplychainpi:0,support:13,sure:[8,11],system:6,take:6,taken:6,test:[2,4,6],test_row:4,text:[4,7],than:[6,7,8],therefor:6,thi:[6,7,11,13],those:6,thread:11,threshold:6,through:6,too:7,tool:[6,13],toolchain:6,total:8,total_ord:8,total_quantity_sold:7,total_shortage_unit:[6,7],toward:6,transact:[6,7],transaction_summari:6,transform:13,tupl:8,tutori:2,two:[7,11],txt:[2,4,6],type:[7,8,11],typic:6,uncertain:2,uncertaindemand:8,under:[6,7],unfamiliar:13,uniqu:7,unit_cost:[6,7,8],unspecifi:7,updat:[2,7],ur381:4,ur382:4,ur383:4,ur384:4,ur385:4,ur386:4,ur387:4,ur388:4,ur389:4,user:[6,8,11],usual:7,valu:[4,6,7,11,13],valueerror:[7,8,11],vari:6,variabl:[2,6,8],varianc:1,variance_backlog:[6,7],variance_closing_stock:[6,7],variance_opening_stock:[6,7],variance_quantity_sold:[6,7],variance_shortage_unit:[6,7],variou:13,vba:[6,13],veri:13,via:0,view:6,wai:[0,6],warehous:[5,7],websit:13,week:[7,11],weight:[2,8],weighted_moving_averag:8,weighted_moving_average_forecast:8,were:6,when:[6,8,11,13],where:[1,8],whether:1,which:7,who:6,whole:6,window:[7,11],window_summari:7,work:13,workbook:[4,6],workflow:6,worksheet:6,write:13,xeon:6,xlsx:[4,6],xlwing:[0,4,6],xyz:[2,8],xyz_classif:8,year:7,yearly_demand:6,you:[6,8,13],your:[6,13],z_valu:[4,6,7,8]},titles:["Installation","Formulas and Equations","Change Log","Welcome to supplychainpy’s documentation!","Ipython","supplychainpy","Quick Guide","supplychainpy package","supplychainpy.demand package","supplychainpy.distribution package","supplychainpy.production package","supplychainpy.simulations package","supplychainpy.warehouse package","Integrated Development Environment"],titleterms:{abc_xyz:8,agent:13,analyse_install_bas:10,analyse_uncertain_demand:8,analysi:[6,13],applic:2,backlog:1,base:13,carlo:6,chang:2,content:[7,8,9,10,11,12],create_install_bas:10,data_cleans:7,demand:[1,8,13],depend:0,develop:13,deviat:1,distribut:[9,13],document:[2,3],econom:1,economic_order_quant:8,enum_format:7,environ:13,eoq:[1,8],equat:1,exampl:13,forecast:13,forecast_demand:8,formula:1,guid:6,indic:3,instal:0,integr:13,inventori:[6,13],ipython:[4,13],lead:1,level:1,log:2,model:13,model_demand:7,model_distribut:7,model_inventori:7,model_warehous:7,modul:[7,8,9,10,11,12],mont:6,monte_carlo:11,monte_carlo_fram:11,normal:1,optimis:13,optimise_warehous:12,option:0,order:1,overview:6,pack:13,packag:[7,8,9,10,11,12],pick:13,plan:13,product:10,purchas:1,python:0,quantiti:1,quick:6,reorder:1,safeti:1,shortag:1,sim_summari:11,simul:[6,7,11],simulation_frame_summari:11,simulation_summari:11,simulation_window:11,standard:1,stock:1,submodul:[7,8,10,11,12],subpackag:7,sum:1,summarise_analysi:8,summarise_demand:8,supplychain:7,supplychainpi:[3,5,7,8,9,10,11,12],tabl:3,time:1,unit:1,version:0,wareh:13,warehous:12,welcom:3}}) \ No newline at end of file +Search.setIndex({envversion:47,filenames:["Installation","calculations","changelog","index","ipythontest","modules","quickstart","supplychainpy","supplychainpy.demand","supplychainpy.distribution","supplychainpy.production","supplychainpy.simulations","supplychainpy.warehouse","tutorial"],objects:{"":{supplychainpy:[7,0,0,"-"]},"supplychainpy.data_cleansing":{clean_orders_data_col_csv:[7,4,1,""],clean_orders_data_col_txt:[7,4,1,""],clean_orders_data_row:[7,4,1,""],clean_orders_data_row_csv:[7,4,1,""]},"supplychainpy.demand":{abc_xyz:[8,0,0,"-"],analyse_uncertain_demand:[8,0,0,"-"],economic_order_quantity:[8,0,0,"-"],eoq:[8,0,0,"-"],forecast_demand:[8,0,0,"-"],summarise_analysis:[8,0,0,"-"],summarise_demand:[8,0,0,"-"]},"supplychainpy.demand.abc_xyz":{AbcXyz:[8,3,1,""]},"supplychainpy.demand.abc_xyz.AbcXyz":{abc_classification:[8,1,1,""],abcxyz_summary:[8,2,1,""],cumulative_percentage_revenue:[8,1,1,""],orders:[8,2,1,""],percentage_revenue:[8,1,1,""],xyz_classification:[8,1,1,""]},"supplychainpy.demand.analyse_uncertain_demand":{UncertainDemand:[8,3,1,""],order:[8,3,1,""]},"supplychainpy.demand.analyse_uncertain_demand.UncertainDemand":{abc_classification:[8,2,1,""],abcxyz_classification:[8,2,1,""],average_order:[8,1,1,""],average_order_row:[8,1,1,""],average_orders:[8,2,1,""],cumulative_percentage:[8,2,1,""],demand_variability:[8,2,1,""],economic_order_qty:[8,2,1,""],economic_order_variable_cost:[8,2,1,""],fixed_order_quantity:[8,2,1,""],lead_time:[8,2,1,""],order:[8,2,1,""],order_count:[8,2,1,""],orders_summary:[8,1,1,""],orders_summary_simple:[8,1,1,""],percentage_revenue:[8,2,1,""],reorder_level:[8,2,1,""],revenue:[8,2,1,""],safety_stock:[8,2,1,""],sku_id:[8,2,1,""],standard_deviation:[8,2,1,""],unit_cost:[8,2,1,""],xyz_classification:[8,2,1,""]},"supplychainpy.demand.analyse_uncertain_demand.order":{sku:[8,2,1,""],sku_orders:[8,2,1,""]},"supplychainpy.demand.economic_order_quantity":{EconomicOrderQuantity:[8,3,1,""]},"supplychainpy.demand.economic_order_quantity.EconomicOrderQuantity":{economic_order_quantity:[8,2,1,""],minimum_variable_cost:[8,2,1,""]},"supplychainpy.demand.forecast_demand":{Forecast:[8,3,1,""]},"supplychainpy.demand.forecast_demand.Forecast":{autoregressive:[8,1,1,""],genetic_algorithm:[8,1,1,""],linear_regression:[8,1,1,""],mean_aboslute_percentage_error:[8,1,1,""],mean_absolute_deviation:[8,1,1,""],mean_forecast_error:[8,1,1,""],moving_average:[8,2,1,""],moving_average_forecast:[8,1,1,""],optimise:[8,1,1,""],simple_exponential_smoothing:[8,1,1,""],weighted_moving_average:[8,2,1,""],weighted_moving_average_forecast:[8,1,1,""]},"supplychainpy.demand.summarise_analysis":{summary:[8,4,1,""]},"supplychainpy.demand.summarise_demand":{AnalyseOrdersSummary:[8,3,1,""]},"supplychainpy.demand.summarise_demand.AnalyseOrdersSummary":{classification_summary:[8,1,1,""]},"supplychainpy.enum_formats":{FileFormats:[7,3,1,""],PeriodFormats:[7,3,1,""]},"supplychainpy.enum_formats.FileFormats":{csv:[7,2,1,""],text:[7,2,1,""]},"supplychainpy.enum_formats.PeriodFormats":{days:[7,2,1,""],months:[7,2,1,""],quarters:[7,2,1,""],weeks:[7,2,1,""],years:[7,2,1,""]},"supplychainpy.model_demand":{analyse_demand_forecast:[7,4,1,""],analyse_demand_from_file_col:[7,4,1,""],analyse_demand_from_file_row:[7,4,1,""]},"supplychainpy.model_inventory":{analyse_orders:[7,4,1,""],analyse_orders_abcxyz_from_file:[7,4,1,""],analyse_orders_from_file_col:[7,4,1,""],analyse_orders_from_file_row:[7,4,1,""],analyse_orders_np:[7,4,1,""],summarise_analysis:[7,4,1,""]},"supplychainpy.production":{analyse_install_base:[10,0,0,"-"],create_install_base:[10,0,0,"-"],production:[10,0,0,"-"]},"supplychainpy.production.create_install_base":{Machine:[10,3,1,""],MachineBuilder:[10,3,1,""],ProductionDirector:[10,3,1,""],SimpleMachineBuilder:[10,3,1,""]},"supplychainpy.production.create_install_base.Machine":{add_down_time:[10,1,1,""]},"supplychainpy.production.create_install_base.MachineBuilder":{make_new_machine:[10,1,1,""]},"supplychainpy.production.create_install_base.ProductionDirector":{add_down_time:[10,1,1,""],construct_machine:[10,1,1,""],machine:[10,2,1,""]},"supplychainpy.simulate":{optimise_service_level:[7,4,1,""],run_monte_carlo:[7,4,1,""],summarise_frame:[7,4,1,""],summarize_window:[7,4,1,""]},"supplychainpy.simulations":{monte_carlo:[11,0,0,"-"],monte_carlo_frame:[11,0,0,"-"],sim_summary:[11,0,0,"-"],simulation_frame_summary:[11,0,0,"-"],simulation_summary:[11,0,0,"-"],simulation_window:[11,0,0,"-"]},"supplychainpy.simulations.monte_carlo":{SetupMonteCarlo:[11,3,1,""]},"supplychainpy.simulations.monte_carlo.SetupMonteCarlo":{build_window:[11,1,1,""],generate_normal_random_distribution:[11,1,1,""],normal_random_distribution:[11,2,1,""]},"supplychainpy.simulations.monte_carlo_frame":{BuildFrame:[11,3,1,""],MainFrame:[11,3,1,""]},"supplychainpy.simulations.simulation_frame_summary":{MonteCarloFrameSummary:[11,3,1,""]},"supplychainpy.simulations.simulation_frame_summary.MonteCarloFrameSummary":{closing_stockout_percentage:[11,5,1,""]},"supplychainpy.simulations.simulation_summary":{MonteCarloSummary:[11,3,1,""]},"supplychainpy.simulations.simulation_summary.MonteCarloSummary":{closing_stock_average:[11,2,1,""],closing_stock_final:[11,2,1,""],closing_stock_max:[11,2,1,""],closing_stock_min:[11,2,1,""],closing_stock_std:[11,2,1,""],opening_stock_average:[11,2,1,""],opening_stock_final:[11,2,1,""],opening_stock_max:[11,2,1,""],opening_stock_min:[11,2,1,""],opening_stock_std:[11,2,1,""]},"supplychainpy.simulations.simulation_window":{MonteCarloWindow:[11,3,1,""]},"supplychainpy.simulations.simulation_window.MonteCarloWindow":{backlog:[11,2,1,""],backlog_at_po_placement:[11,2,1,""],closing_stock:[11,2,1,""],demand:[11,2,1,""],holding_cost:[11,2,1,""],index:[11,2,1,""],lead_time:[11,2,1,""],opening_stock:[11,2,1,""],po_number_raised:[11,2,1,""],po_number_received:[11,2,1,""],po_raised_flag:[11,2,1,""],position:[11,2,1,""],purchase_order_raised_qty:[11,2,1,""],purchase_order_receipt_qty:[11,2,1,""],quantity_sold:[11,2,1,""],revenue:[11,2,1,""],shortage_cost:[11,2,1,""],shortage_units:[11,2,1,""],sku_id:[11,2,1,""],sold:[11,2,1,""]},"supplychainpy.supplychain":{main:[7,4,1,""]},"supplychainpy.warehouse":{optimise_warehouse:[12,0,0,"-"]},supplychainpy:{data_cleansing:[7,0,0,"-"],demand:[8,0,0,"-"],distribution:[9,0,0,"-"],enum_formats:[7,0,0,"-"],model_demand:[7,0,0,"-"],model_distribution:[7,0,0,"-"],model_inventory:[7,0,0,"-"],model_warehouse:[7,0,0,"-"],production:[10,0,0,"-"],simulate:[7,0,0,"-"],simulations:[11,0,0,"-"],supplychain:[7,0,0,"-"],warehouse:[12,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","method","Python method"],"2":["py","attribute","Python attribute"],"3":["py","class","Python class"],"4":["py","function","Python function"],"5":["py","staticmethod","Python static method"]},objtypes:{"0":"py:module","1":"py:method","2":"py:attribute","3":"py:class","4":"py:function","5":"py:staticmethod"},terms:{"15m":6,"1650v3":6,"1st":13,"32gb":6,"4650u":6,"8gb":6,"abstract":10,"case":[6,13],"class":[7,8,10,11],"default":8,"enum":7,"final":11,"float":[4,6,7,8,11],"function":[7,8],"import":[4,6],"int":[7,8,10,11],"long":[6,8],"new":[6,7],"return":[6,7,8,11],"static":11,"true":8,"while":[6,8,13],abc:[2,4,6,8],abc_classif:8,abc_xyz:[5,7],abc_xyz_classif:[4,6,7],abcxyz:[6,7,8,11],abcxyz_classif:[4,6,8],abcxyz_summari:[6,8],abil:13,abl:6,abov:6,absolut:[2,8],accur:6,accuraci:11,achiev:6,across:[6,13],actual:11,add:10,add_down_tim:10,adequ:6,adjust:[6,8],advantag:13,affect:6,after:[6,7],again:[6,7],aggreg:6,air:6,alia:8,all:[0,6,7,11],alreadi:6,also:0,although:6,anaconda:0,analys:[2,6,7],analyse_demand_forecast:7,analyse_demand_from_file_col:7,analyse_demand_from_file_row:7,analyse_install_bas:[5,7],analyse_ord:[6,7],analyse_orders_abcxyz_from_fil:[4,6,7],analyse_orders_from_file_col:7,analyse_orders_from_file_row:7,analyse_orders_np:7,analyse_uncertain_demand:[5,7],analysed_ord:11,analyseorderssummari:8,analysi:[2,3],analyst:6,analyt:[6,7,11],ani:6,anywher:8,api:2,append:8,appli:8,apr:6,arrai:[7,8],arrang:7,assist:6,associ:11,assum:6,assumpt:[6,11],attribut:11,aug:6,autom:13,autoregress:8,averag:[2,6,7,8],average_backlog:[6,7],average_closing_stock:[6,7],average_opening_stock:[6,7],average_ord:[4,6,7,8],average_order_row:8,average_period:8,average_quantity_sold:[6,7],average_shortage_unit:[6,7],backlog:[6,7,11],backlog_at_po_plac:11,base:[2,6,7,8,10,11],base_forecast:8,becaus:6,been:6,behaviour:6,below:6,benchmark:6,benefit:13,best:6,book:13,bool:8,borg:11,both:13,bound:6,bucket:7,build:11,build_window:11,builder:10,buildfram:11,built:[7,8],busi:13,cach:6,calcul:[1,6,7,8,11,13],calculate_moving_average_forecast:8,can:[6,13],captur:6,carlo:[2,3],carri:6,chain:6,check:8,choic:13,classif:[6,8],classification_summari:8,clean_orders_data_col_csv:7,clean_orders_data_col_txt:7,clean_orders_data_row:7,clean_orders_data_row_csv:7,clone:0,close:11,closing_stock:[6,7,11],closing_stock_averag:11,closing_stock_fin:11,closing_stock_max:11,closing_stock_min:11,closing_stock_std:11,closing_stockout_percentag:11,code:6,collect:[7,8],column:7,come:0,compar:6,complex:6,complic:6,comprehens:13,comput:6,concaten:8,concret:10,consider:6,consist:13,construct_machin:10,consum:13,contain:7,content:[3,5,6],convers:6,correct:6,correspond:7,cost:[1,6,7,8,11],could:13,cover:6,cpu:6,creat:[6,7,11],create_install_bas:[5,7],critic:13,csv:[2,4,6,7],cumul:6,cumulative_percentag:8,cumulative_percentage_revenu:8,current:[6,11],cython:2,dai:7,data:[2,4,6,7,13],data_cleans:5,data_set:[6,7],ddr3:6,ddr4:6,dec:6,decim:[6,7,8,11],declar:7,decreas:8,deem:6,defin:7,deliveri:[6,7,11],demand_vari:[4,6,7,8],design:6,desir:6,desktop:[4,6],detail:[1,6],develop:6,dict:[2,6,7,8,11],dictionari:[7,11],did:6,differ:6,distribut:[5,6,7],divid:7,doe:[6,13],domain:6,dure:11,dynam:6,each:[6,7,11],easi:13,easiest:0,economic_order_qti:[4,6,8],economic_order_quant:[4,5,6,7],economic_order_variable_cost:[4,6,7,8],economicorderquant:8,edit:13,effort:6,either:8,end:8,enough:8,entri:7,enum_format:5,enumer:[6,7],equal:[8,11],etc:[6,7,11],etl:13,evalu:8,everi:6,exactli:11,exampl:[6,7,8,11],excel:[6,13],except:7,execut:6,exist:[0,6,13],expect:[6,7],experienc:7,express:1,extens:13,extract:13,factor:6,fals:8,favour:[6,13],featur:[6,10],feb:6,few:[11,13],field:8,file:[6,7],file_path:[4,6,7],file_typ:[4,6,7],fileformat:7,finish:6,first:13,fit:6,fix:11,fixed_order_quant:8,folder:6,follow:6,forecast:[2,7,8],forecast_demand:[5,7],forecast_length:8,forecasts_typ:7,formal:1,format:[6,8,11,13],frame:[7,11],frame_summari:[6,7],from:[0,2,4,6,7,8,13],fulfil:13,full:[6,7],further:6,gener:[6,7,8,10,11],generate_normal_random_distribut:11,genetic_algorithm:8,get:[8,13],ghz:6,github:0,give:6,given:[8,11],global:11,greater:8,ground:13,guid:[2,3],have:[6,8],hello:4,help:13,here:[1,6],higher:6,histor:6,histori:6,hold:[1,11],holding_cost:[8,11],holding_cost_percentag:11,hopefulli:13,howev:6,identifi:7,implement:6,includ:[6,8,13],incorrect:[7,8],increas:[6,7,8],index:[3,6,7,11],inher:6,initi:[6,7],instanc:11,instruct:6,intellig:13,interact:6,interfac:13,inventori:[2,3],ipython:0,item:7,jan:6,jul:6,jun:6,jupyt:[0,6],kei:6,knowledg:6,kr202:[6,7],kwarg:11,languag:13,larg:6,last:6,later:6,lead_tim:[6,7,8,11],lead_time_np:7,least:13,len:[8,11],length:[7,11],librari:[1,6,13],like:6,limit:6,line:8,linear_regress:8,linux:6,list:[7,8,11],load:[6,13],longer:6,lower:7,ltd:1,mac:[6,13],macbook:6,machin:10,machine_build:10,machinebuild:10,mad:8,made:6,mai:[0,6],main:7,mainfram:11,mainli:6,make:[6,8,11],make_new_machin:10,mani:[8,13],manual:[6,13],manufactur:6,mar:6,match:11,materi:6,matplotlib:[0,6],max:6,maximum_backlog:[6,7],maximum_closing_stock:[6,7],maximum_opening_stock:[6,7],maximum_quantity_sold:[6,7],maximum_shortage_unit:[6,7],maximum_throughput:10,mean:[2,8],mean_aboslute_percentage_error:8,mean_absolute_devi:8,mean_forecast_error:8,member:8,method:6,middl:13,min:6,minimum:7,minimum_backlog:[6,7],minimum_closing_stock:[6,7],minimum_opening_stock:[6,7],minimum_quantity_sold:[6,7],minimum_shortage_unit:[6,7],minimum_variable_cost:8,model:[6,7,8,11],model_demand:5,model_distribut:5,model_inventori:[4,5,6],model_warehous:5,modul:[2,3,5],mont:[2,3],monte_carlo:[5,7],monte_carlo_fram:[5,7],montecarloframesummari:11,montecarlosummari:11,montecarlowindow:11,month:[7,8,11],more:6,most:6,move:[2,8],movement:7,moving_averag:8,moving_average_forecast:8,multi:11,multipl:7,multipli:[6,7],must:[6,11],name:[6,10,13],need:6,neg:11,next:6,nich:13,nitro:6,normal:[6,11],normal_random_distribut:11,note:6,notebook:13,nov:[6,13],nr381:4,nr382:4,nr383:4,nr384:4,nr385:4,nr386:4,nr387:4,nr388:4,nr389:4,number:[6,7,8,11],numpi:[0,6],object:[7,8,10,11],occur:11,oct:6,often:13,onward:[6,7],open:11,opening_stock:[6,7,11],opening_stock_averag:11,opening_stock_fin:11,opening_stock_max:11,opening_stock_min:11,opening_stock_std:11,openpyxl:[0,6],oper:[6,7],optimis:[2,6,7,8],optimise_service_level:[6,7],optimise_warehous:[5,7],optimised_ord:6,order_count:8,orders_analysi:[6,7],orders_collect:8,orders_summari:[4,6,8],orders_summary_simpl:8,organis:7,origin:[6,8],other:[6,7],out:[6,11,13],output:8,over:[6,7,11],overview:3,packag:[0,5],page:3,panda:[0,6],paramet:[6,7,8,11],part:13,pass:[6,8],path:7,per:7,percentag:[7,11],percentage_increas:7,percentage_revenu:8,perform:7,period:[6,7,8,11],period_length:[6,7,11],periodformat:7,pip:0,pivot:[6,13],place:[6,7],plan:6,pleas:[6,7,8,11],po_number_rais:11,po_number_receiv:11,po_quant:[6,7],po_rais:[6,7],po_raised_flag:11,po_receiv:[6,7],point:[6,7],popular:6,posit:[8,11],power:6,pr381:4,pr382:4,pr383:4,pr384:4,pr385:4,pr386:4,pr387:4,pr388:4,pr389:4,pre:6,predominantli:6,prefer:0,present:13,previou:[6,7],previous:8,print:[4,6,8],prior:7,probabl:[6,11],process:[6,13],processing_tim:10,product:[5,6,7],productiondirector:10,profil:[6,8],program:6,provid:[6,7],publish:13,purchas:7,purchase_order_raised_qti:11,purchase_order_receipt_qti:11,qauntity_on_hand:7,qr321:4,qr322:4,qr323:4,qr324:4,qr325:4,qr326:4,qr327:4,qr328:4,qr329:4,qr381:4,qr382:4,qr383:4,qr384:4,qr385:4,qr386:4,qr387:4,qr388:4,qr389:4,quantity_sold:[6,7,11],quarter:[7,11],quick:[2,3],rais:[7,8,11],ram:6,ran:6,random:[6,7,11],random_normal_demand:11,randomli:[6,11],rang:[4,6],read:6,readm:2,reduc:6,referenc:7,reilli:13,releas:6,relev:13,reliant:6,reorder_cost:[4,6,7,8],reorder_level:[4,6,7,8],reorder_quant:[4,6,7,8],repetit:13,replic:6,report:[6,13],repres:[7,11],request:6,requir:[6,7,13],requisit:6,respect:13,result:[2,6,7,11],retriev:6,revenu:[4,6,7,8,11],review:6,rise:13,rol:2,roll:13,row:7,rr381:[4,7],rr382:4,rr383:4,rr384:4,rr385:4,rr386:4,rr387:4,rr388:4,rr389:4,rr481:7,run:[6,7,11,13],run_monte_carlo:[6,7],rx983:6,safety_stock:[4,6,7,8],saftei:[6,7],same:[6,7,11],save:13,scalabl:13,scale:13,search:3,second:[6,7],self:13,sep:6,ser:7,servic:[1,6,7,13],service_level:[6,7],set:[7,11],setupmontecarlo:11,sever:[6,11,13],share:[11,13],shortag:11,shortage_cost:[6,7,11],shortage_cost_percentag:11,shortage_unit:[6,7,11],should:[6,7,8],sigma_:1,sim:6,sim_fram:6,sim_summari:[5,7],sim_window:6,similar:6,simpl:6,simple_exponential_smooth:8,simplemachinebuild:10,simul:[2,3,5],simulation_fram:[6,7],simulation_frame_summari:[5,7],simulation_summari:[5,7],simulation_window:[5,7],singl:7,skew:6,sku:[4,6,7,8,11],sku_id:[4,6,7,8,11],sku_ord:8,small:7,snippet:6,sold:11,some:[6,13],soon:6,sourc:0,specif:[6,7],specifi:[6,7,8,11],speed:6,spreadsheet:[6,13],stage:6,standard_devi:[4,6,7,8],standard_deviation_backlog:[6,7],standard_deviation_closing_stock:[6,7],standard_deviation_opening_stock:[6,7],standard_deviation_quantity_sold:[6,7],standard_deviation_revenu:[6,7],standard_deviation_shortage_cost:[6,7],start:[6,8],start_period:8,start_posit:8,statist:6,step:[6,13],still:13,stockout:7,stockout_percentag:[6,7],str:[4,6,7,8,10,11],string:8,submodul:5,subpackag:5,success:6,suit:13,sum:8,summar:[6,7],summari:[2,6,7,8],summaris:6,summarise_analysi:[5,7],summarise_demand:[5,7],summarise_fram:[6,7],summarize_window:[6,7],suppli:[6,8,11],supplybipi:4,supplychain:5,supplychainpi:0,support:13,sure:[8,11],system:6,take:6,taken:6,test:[2,4,6],test_row:4,text:[4,7],than:[6,7,8],therefor:6,thi:[6,7,11,13],those:6,thread:11,threshold:6,through:6,too:7,tool:[6,13],toolchain:6,total:8,total_ord:8,total_quantity_sold:7,total_shortage_unit:[6,7],toward:6,transact:[6,7],transaction_summari:6,transform:13,tupl:8,tutori:2,two:[7,11],txt:[2,4,6],type:[7,8,11],typic:6,uncertain:2,uncertaindemand:8,under:[6,7],unfamiliar:13,uniqu:7,unit:[2,6,7,11],unit_cost:[6,7,8],unspecifi:7,updat:[2,7],ur381:4,ur382:4,ur383:4,ur384:4,ur385:4,ur386:4,ur387:4,ur388:4,ur389:4,user:[6,8,11],usual:7,valu:[4,6,7,11,13],valueerror:[7,8,11],vari:6,variabl:[2,6,8],variance_backlog:[6,7],variance_closing_stock:[6,7],variance_opening_stock:[6,7],variance_quantity_sold:[6,7],variance_shortage_unit:[6,7],variou:13,vba:[6,13],veri:13,via:0,view:6,wai:[0,6],warehous:[5,7],websit:13,week:[7,11],weight:[2,8],weighted_moving_averag:8,weighted_moving_average_forecast:8,were:6,when:[6,8,11,13],where:[1,8],which:7,who:6,whole:6,window:[7,11],window_summari:7,work:13,workbook:[4,6],workflow:6,worksheet:6,write:13,xeon:6,xlsx:[4,6],xlwing:[0,4,6],xubuntu:6,xyz:[2,8],xyz_classif:8,year:7,yearly_demand:6,yosemit:6,you:[6,8,13],your:[6,13],z_valu:[4,6,7,8]},titles:["Installation","Formulas and Equations","Change Log","Welcome to supplychainpy’s documentation!","Ipython","supplychainpy","Quick Guide","supplychainpy package","supplychainpy.demand package","supplychainpy.distribution package","supplychainpy.production package","supplychainpy.simulations package","supplychainpy.warehouse package","Integrated Development Environment"],titleterms:{abc_xyz:8,agent:13,analyse_install_bas:10,analyse_uncertain_demand:8,analysi:[6,13],applic:2,base:13,carlo:6,chang:2,content:[7,8,9,10,11,12],create_install_bas:10,data_cleans:7,demand:[1,8,13],depend:0,develop:13,deviat:1,distribut:[9,13],document:[2,3],econom:1,economic_order_quant:8,enum_format:7,environ:13,eoq:[1,8],equat:1,exampl:13,forecast:13,forecast_demand:8,formula:1,guid:6,indic:3,instal:0,integr:13,inventori:[6,13],ipython:[4,13],lead:1,level:1,log:2,model:13,model_demand:7,model_distribut:7,model_inventori:7,model_warehous:7,modul:[7,8,9,10,11,12],mont:6,monte_carlo:11,monte_carlo_fram:11,optimis:13,optimise_warehous:12,option:0,order:1,overview:6,pack:13,packag:[7,8,9,10,11,12],pick:13,plan:13,product:10,python:0,quantiti:1,quick:6,reorder:1,safeti:1,sim_summari:11,simul:[6,7,11],simulation_frame_summari:11,simulation_summari:11,simulation_window:11,standard:1,stock:1,submodul:[7,8,10,11,12],subpackag:7,summarise_analysi:8,summarise_demand:8,supplychain:7,supplychainpi:[3,5,7,8,9,10,11,12],tabl:3,time:1,version:0,wareh:13,warehous:12,welcom:3}}) \ No newline at end of file diff --git a/docs/_build/html/supplychainpy.html b/docs/_build/html/supplychainpy.html index b4e8963..bec59af 100644 --- a/docs/_build/html/supplychainpy.html +++ b/docs/_build/html/supplychainpy.html @@ -499,8 +499,8 @@

    Submodules

    supplychainpy.simulate module

    -supplychainpy.simulate.optimise_service_level(frame_summary: list, orders_analysis: list, service_level: float, runs: int) → list
    -

    Optimises the safety stock based on the results of the monte carlo analysis.

    +supplychainpy.simulate.optimise_service_level(frame_summary: list, orders_analysis: list, service_level: float, runs: int, percentage_increase: float) → list +

    Optimises the safety stock for declared service level.

    Identifies which skus under performed (experiencing a service level lower than expected) after simulating transactions over a specific period. The safety stock for these items are increased and the analysis is monte carlo is run again.

    @@ -512,6 +512,7 @@

    Submodules -
    -supplychainpy.simulate.run(simulation_frame: list, period_length: int=12)
    -

    -
    supplychainpy.simulate.run_monte_carlo(orders_analysis, file_path: str, z_value: decimal.Decimal, runs: int, reorder_cost: decimal.Decimal, file_type: str, period_length: int=12) → list
    @@ -621,11 +617,6 @@

    Submodules -
    -supplychainpy.simulate.run_monte_carlo_mt(file_path: str, z_value: decimal.Decimal, runs: int, reorder_cost: decimal.Decimal, file_type: str, period_length: int=12) → list
    -

    -
    supplychainpy.simulate.summarise_frame(window_summary)
    diff --git a/docs/calculations.rst b/docs/calculations.rst index 2d181a1..e93585f 100644 --- a/docs/calculations.rst +++ b/docs/calculations.rst @@ -79,31 +79,4 @@ where: D = Demand - HC = Holding Cost - - -Purchase Order Quantity ------------------------ - -For the monte carlo siimulation, the - -In release 0.0.3 the purchase order quantity will be compared against a forecast to assess whether it requires adjustment. - - -Backlog and Shortage units --------------------------- - -To aggregate the backlog and shortage units for the `summarise_frame` - - -Normal Sum Deviation --------------------- - -The standard deviation is calculated by first summing the average variance for backlog and quantity sold. - - -.. math:: - - \sigma_{xy}^2 = \sigma_{x}^2 + \sigma_{y}^2 - - + HC = Holding Cost \ No newline at end of file