From 991c4d341af289824b812e36a3cd0073ff3fd403 Mon Sep 17 00:00:00 2001 From: Tapajyoti Ghosh Date: Fri, 30 Sep 2022 08:47:25 -0600 Subject: [PATCH 1/2] Add detailed information about pyLCIA submodules --- docs/doc_pylcia.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/doc_pylcia.rst b/docs/doc_pylcia.rst index 01eda0a6..41689e7f 100644 --- a/docs/doc_pylcia.rst +++ b/docs/doc_pylcia.rst @@ -1,5 +1,12 @@ Python Life Cycle Inventory Analysis ==================================== +The PyLCIA module links to the DES material model through the DES interface code. The DES interface preprocesses the incoming materials dataframe and prepares it for the LCA calculations. The interface calls on five main subcomponents of the pyLCIA module. +It calls the concrete life cycle inventory updater to check for glass fiber materials in the incoming stream. If yes, it creates a modified cement coprocessing inventory based on the amount of glass fiber present in the incoming stream. This modified inventory is then used for LCA calculations. +It calls the insitu_emission module to calculation insitu emissions. The foreground system for the study has direct emissions. To calculation those emissions, these systems are required to be scaled up based on their usage and then direct emissions derived using the scaling variables. These calculations are done using a modified LCA approach using a static inventory with just just product flows. +It calls the pylca_opt_foreground module to calculate the first set of LCA calculations only for the foreground activities. All input flows to the foreground system from the background life cycle inventory are derived based on the scale up or scale down of these processes. This module also preprocesses the inventory and allows replacement of electricity production with dynamic grid mixes from electricity capacity expansion models. +It call the pylca_opt_background module to perform the major LCA calculations of the background inventory. The final demand to the background LCI is obtained from the pylca_opt_foreground module. This module calculates the complete cradle to gate life cycle emissions for the foreground processes. +The final module used by PyLCIA is the pylca_celavi_background_postprocess which has two main functions. It combines background and foreground emissions to complete our system boundary for the life cyle analysis. Finally, it converts emissions to impact factors and prepares the results to be sent to DES for final processing and visualization. + ReEDS Data Importer ------------------- @@ -71,4 +78,4 @@ Background Emissions Postprocessing .. autofunction:: postprocessing -.. autofunction:: impact_calculations \ No newline at end of file +.. autofunction:: impact_calculations From b876d0039ad61cf26c5dee295bb168fb3be7a348 Mon Sep 17 00:00:00 2001 From: rhanes Date: Fri, 30 Sep 2022 09:11:06 -0600 Subject: [PATCH 2/2] recompiles HTML with additional pyLCIA explanation --- docs/docs/doctrees/doc_costgraph.doctree | Bin 175889 -> 175889 bytes docs/docs/doctrees/doc_pylcia.doctree | Bin 202671 -> 207055 bytes docs/docs/doctrees/environment.pickle | Bin 58515 -> 58332 bytes docs/docs/html/_sources/doc_pylcia.rst.txt | 9 ++++++++- docs/docs/html/doc_costgraph.html | 4 ++-- docs/docs/html/doc_pylcia.html | 6 ++++++ docs/docs/html/searchindex.js | 2 +- 7 files changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/docs/doctrees/doc_costgraph.doctree b/docs/docs/doctrees/doc_costgraph.doctree index 1bf37ed4441edf79418446a86540d5e2cd922179..fd51617c95cf67335892aea350e1cac958adc12d 100644 GIT binary patch delta 143 zcmbPuk89#Rt_^aWoGxw_2Ih`VE@qq6IZauRxT(AfOh{aQSr%mOY{67EF1TKU>D7xE gtv0(ztU*@uQ;HXvi)uo%jC{L{JmYp5d8V)Z0DNO4D7xE gtv0(ztU*@uQ;HXvi)uo%jC{L{JmYp5d8V)Z0IUrqi~s-t diff --git a/docs/docs/doctrees/doc_pylcia.doctree b/docs/docs/doctrees/doc_pylcia.doctree index 289efde97fca642b80f077703226491e4c1af177..24b03976701d59af299ac03233c2d8fb0e381b0d 100644 GIT binary patch literal 207055 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 EA9Poo8~^|S literal 202671 zcmeFa3!G&|buT=_yxeL&(x#VE{ zFxi;u&%I@C&$d(jk#nAP}G{OcD>t}n!9bTxg=TDYt;I!&XlHa zu4t}ouDWe*1QJ*DTm5#!N=i<>VYc7wOhwnUCK}OYv$b|3x@u}a)Ys|GMwd=i+q1n^ zZw~WA_T@Jz*b6K)d3UFPryxp2=%w0FLr0H8$5KXI{4LCA)f!Zto@CW_7C3d&w28{*^O(UQ%nctNU9ofrjqk|Hh|h z+qG78tlI-_*Ij+k%${aNw7hA_!_|l6=o=fCZ{HbhulB3aRg=@5ZoknL%{9cQnMTY`E&u(Ag=frcb*q0tCIFltTlENq-hPGK9vEoP2w8qxX9i<0G_@wH6XjX=s_ zm@?jL0jm2mT}Od0cBCJ18n8Y-(P}qP6E;U8p)=E;p6Tn)8wsjd!{Jmzb!w{9ucn5N zWTg;Z!CL)kkh~K5d0!ZklSA&DY;WsLS8?<@c)HsFh1}mDfVZHOhSb#qh!#*hkpEC2 zKj;yT8)~d=u1JpM`&BhYUb5RbuL^6N=4|ujs5ifETB7+18XADZLx{sPduyETS6rpO zy3D+(95V^W%u&P)jOox?FyggaFj!iR=8hO%7-|#>oao#pp&IjbJg@H{Q+pLhtrfck?P}zfbao;-h0(Jl?<^eD&+gUAgZCf zGF(YMo#F2ztQ?=p&{B&+v8Yc~4hDWx{6$U`t?ywz_^ z+RgNe8@iqSEzrWKIu&*H#IOvF?r64Z&8P>9N%-7{X2kiZ7hzZRU`D!qrqylKqlr#8 zg3fMD%;Gdp3#y8ksG>Tot9p%ok7#P0$!VCJ_O#lq{%mwdtKW>KXRo>Js!PX&l02oA zW*N{g_tVD*QPIt(1+XzI%%$-%_^LbN zw9BgPw&;57%4o7W)ta7Z(-I?ssiWDc_r@ye?mIOkm&i1fgb|wt*+5*!kzYX6Lu!x} z&>-vl^n8O@qg-lLpR5#`HkT|Nr4`W6Wqr^AO{0&MiB_Xs=hYGSbd+pqqES?tGd&?z zZcy{K+}RB!_9xv`P|$FEWq{l}M3Y{IKg7rjSOeB%{d+p~*$jWpUnr1BejVV5Z%w1o z*X2zA(Fp7gHb$eP(RDDW;2r^o8GzXg0B<&G)M1#ai!lXO@38izAxI1uw6cb=q|vRm z$Dx?c)Lx6t{B;5ChC|m4@m@~@CaZDZI^C$XCR(+*H-I9>4bh%e$_X>fLD9&Z+bc2& z)~(ZxsX7ds<99+S7Wc9NFG`M30yZY6n^oM*TkEuCAhpsX`rWPN)gIQ7*WVDl{3?(a~Z{PKnC@*!i99ndd|EDPFs`W31CDiblxgd z>P^l%SGO?@JD>2hfq{fnmXA^fR#`++{0fUjp&s#F)~Cdy3}5tcWGTbvJ*2iW#BT%Q zP-XZs&>G35GHA&&%AiwNWzeaY*vc>f0(8$M^DPO~1-UAxE+6u=Hg=3ysz`My*1(?w z6T1V7d=WA_9OI-nv!}4g_)Smk!D?eNOm}zDqY-wHmv(~xd$7@ z#174T&`_m8X7nHzYxxFPwTT5|NW4+!N~RBxQB$`KSftTj^)4-|+n=G97GreCHGa@w zZOjhEbis?E?a+3asg1Qh#LweMc>_dz5z#&awv_lK9GAR6yE)QAf$~Qcg-0-|Sa^&t zgenLjCTDyqe9Kr@n%~JYt2DpYd~@^r$+5g{(l!OmE3ziE9K_GTN`;Z-3583g>}COf z!A`USXd?jbNm3>NagvhRCd$qIP%@7awA#n7MP`TNS4*DNFqNonSy#?9QIDlO7%~rLd|4Z)i zu3gYQ9_?#J+=b}^jbeY~X(qEolZ(?2QU-Q$Dw5{AIQ@)=BWrQ`X%DHrI4!kP`zt8e zNG=zrTJp@|RHv|uQ=PimUYz>&^=7-5l*2b8^)tFp zd)m_m1`tve{*5xQsvwf)s|v>~^N(TDXmO;6)K-P~TflheKJ8d2*hnr_K}()d1)ajG zf=*?3S0xajXF-0SR-zR5I#f7BT6=As}tyKJDRvBIP~}=c~Yd+M5GP z75lVUP0nf^QOxq=z_MB`>A4fu^KLFensXqRtdy2B0m4;qxzIR1`s4TMb}Px{y23o3{|h5w7;e|qqZ+xY3z z_`gZ`UwXuqETY+FP&?i=;PwSBop4IEAOr8EAp>t=l{sVY-3Myy^)Tlfen(yPEG&%~ zfln;Vpax+NmBv1e!+!_BDL)QBrgJ6Fs-_=sC^q86PoQL}q4-Pit^81YMv1=Gqp_%- zM&rMgZCp4SS7|f`FBR!-S#CI1a0(fb4?s;Cneme4G%Ei>!z{#48As)>Q1?;${hMw- z|ER3m8cJXQP&6tJ0jJ!kd;)%FM`gjHGud;y445p03z=|i$k5aA9Wzb54UA!eA?c?ac#$vr zDcf7US{M8|qs#FIK(w)f->{v(I?yvtUPW)yAPXE049X8^^=?ad5Zp zx76wZYC;$9bf%de7SeCjnpR2TV`H+_>%saXlQ7-w)EYfUh<>NG&!SUVdnp$C-73`P zvOUvljH^a~r0RIB+OA0e_BKcR8{Ivf9(c0%X7=>p9t&KP0hYSZF5uigGj;J6wN;9h zi9E=0J>I1e=EJ1g0)eA?{6d{8X$7r%@KyY+k7aM1N@mUcGEj zf7W_PYmK^QJyc-uN4EryYghnrVs@pgEp)3f!ujU%&@Iga?mJDRTRiB+#_pRy$$q6+ z3$IwzpCi`k>XDgN7F}+Ri}NUk5+=ok#v1?{nKLNxw3dv{V7aLrF1_E9J*I)_EyE%#nslc?>t< zrKKw%f<9wQaHaVY$09Gy=Q+|)X-+DhsMB%iXs;ZXv%pJ>Q%ncmKY8W2 zVr}7g<-xX@BMlYnSiw$ud7750kZdT)OLk?tl4F#YX*)+6D$`+bi^f`7r)6Q2hm!PX zm-m-(4Dr0bgd+{*{aAh*kd~p44EiId6j!D@IYxPz`W$JfOh;w6Fll*mNrnu)-{@?TXZ#BQq>&ERRedGC#o~;{`mfCd#2%52`inMX^bN=-kYp;`?t?@ zFdPORD#eFGS(+1LDpUqRW%tRHh$cT{hcd4I(ok(axcYxhs!#JzCzL*+1?ozjE9o9Ev!BLL+WY@k z7B8^!fGJtdT;`etW3@_MkjSG5uz1w~RDl++agH=+R=$;J54gqa6&#EF zEPe+^8Y)e(eJa&E0mS7jUT@)8=cW8jjxfGu7D`a;`N_77I|sj&yj{oQ%u*`znq!RIEH(RZ6NtvQUfHDIBAGSFPtrLuE?au2QnF z$v%tMg&adX@8@x(p}gnWs!}o(l7(8lc5;mJGF{J+hRVd*tWxsil7v{i_HoSda_r?u zL*?*Tr&1z?P?xlLy_Vyi7xXtc(ojLQB`YP8`#sm<^}Af%JezOlNJH6VtX3(8^C$u= zULWE(<*!SZ?>Aq#%p5;`r3KXQM^|9!tW=q^8sMH{m=AH&xGjSg1^&8bXM!4%XMwK?B>S}fF zb|&e1S4#zOXZ4l$TB8+Lm`mFmJxyt_E4B6>%D`%^NSd$KKIq}d(%N@4E+`awL}sOa|`2vafpv_$bj?ov1kWS*Bg6g_U^^e zV0xxI4Q}$Vc${j_vID?^+rq!$X;GsVazOYhWnc#cku=`{;VBPC)`0M&hjicp;m1(0 zkz5W4TJp?*pi|fZL8so~3#xxeezG2-; zfn()ew1{r9i={2be}_vLdR+|nx_V>LwKKgwtbQvSC|bdW2#7YQo3a~N#aWc&!mg+F z45XwoO;H9`nMBfjmFXT2N0u_Z&O*uX&BwHMVmMcV2oKH{Gi3gJ|fOi=BZE zb4yiT!RgPs5$Qhep_P)$wSy@G3w)6@U*MnY;m891NgmRHfqx1VoB_U;JOg~4!UA8X zZnS}4+`YP!k`kE!+E`aPXs__JVM%CT?A{bI(B2`Vlh9*2Xl<(po6Vg&0Kd!#a*E64L)l!1k{NSZIKr#u{4u-@k(9T?WrP_U6)j^|qP46Jnu z3u~QvT3FZW4oU(u0GzRoa&W%U({?4{d?|nJD+kt^7!2m}8B=zoUJ%clM?8|6j+PLA zh%&Gc7fJJl_@8<>vLOC(59z=Ve-sKfl1qqd$ukhwDJ;Zw>d6ko*={!Q4j=|-W7*}P z{cca2m4x=rtnYdbtZ%yUQdov;9ovFSakxkUJ^`(li;XozQN%IBy!K;fGOcuyjct{5Zc?AkKl1q?l$ul6=DJ;l!>Uj>xOLV${ z{=h|mLLeXI6yk>-aFkSt2MRB4L?h4dblQ#T6utK)e~%{G)xET$nIT68=A6|Wl8Rti zpe=B4GKHVPYFFt@gDF;NQw^ToMn4GajJ2UoSXtd#1pmP2c|dD$CpGRO%D`%zNb+jj zD%qN9X{Z0zz@jzXE)Qpx=H2Ka9a!^jhJsBCNX^qNkkLGy!fKvQ?L8B4(v6!uBh`b( zqx|JG{sK?Gmely04;TI#{UX1@yC7Km*NZ-ApS6U6(P1h1rC znVUN!`1bGO)TQlDxXN3bkhYiyAEUNlH6!t zR4J%pq&^`c0YeCdVvi0LSJwpDSX)r8nsy6mw4%{${Qi_KeL^&(37(`s!F%A4>Neq@af1tgk?a#3sdaZnwJ`=w z{V35|e664jSeiBaE4;idXj}##<7(v@{0c`J%3zQWkZIH)^0E;Ie#8mD%lafoS}1G& zte`p$ufG}Ph(7{Vq_4j{0N;XQIjQS!rw5KI`UM41D_zWb5E<~^h?^7F9%iO!dlSJG z2)gzF>#9Aocu5H!B?sM$L;!8aRjhJVAIx>tdM{F^0+D4Ck0$V1gt7|as;wt)TEGcW zRHd{0it~65Rx?qB+ZJ81nuCSbvy(ZkVe!x!XyW1cX#7#?zFyd~AqQaOB%~Z6`G@FW z=BnfsH-Y;*o>s%AbplL5(GMn9@fKxe_t$yvCows)#E(SnOJ{b*(y z&P2$Vi)SOcFBhyl)BLB3=HF1Z`Qwu@$GWRmK;IeJnd^%q3;fROxlnK5{l&A8#kF!2 zS&;jSyKjN__39JR$TX;3wKujMdS^!$-UBA{-?hr3F@csnQcUs60H`ZIZY2)Aa2eLB zYcoc){qmh-mCHKqnaQc%wgVTKt6(*-?SgI5$mKWQc>RsfJ!@mMYpQW4xWo2=V|xplDA!bHYBWV7#c4I zZksE9JUcngj2%&A4IV=FCCT9sW3)BZqDNBN5G^2E{t^g=@6wF7U}UiflOa<{x{8tJ zl4LndyAJ&!nqGB*^~E&gABu+jFYv=R3;h9-u2n4v4;sZEpj=RU#c*%&EE~@NYIT}( zP+aGm;p@|aufOo~MQ;zv*}DQv{h2>Y{7F%|;6HyEk1G5Kk~&hqH=u&|hzi~nKq{{~ z{|=ElSDlkntjQ;e_}PbgH+~3mtB4k&+2i+HpOTZUk_yThi9cxPvL-(TBKwo+t$&7G z(DeTVKgywKHRSpc<%%D*YR(|%*aD^jM0v@E!xe`Shs)rHheI1rhXQ*`{8<#9gd}C~ zg!2C&pw%Rv9uFWbz|$4(LInmZdxaOiQVGM{-7Z+Vz^;XtUGdz3)GK8~3OMCD?C|21zA>9fQ&NR80L~AJMp8$5BFSq? zS_Vc!H5kzE8q&}Z;HTi>$TAp39#Y$26u$x*J~TAaX;83{TpEnD_xX7H;*lo`H^3nwu#Dt282M zzDhIg;mA^&Ne}73O4EgcjpR~kwB#A3(J8Fb=+p&@uz(>IXjDB=5f*YWIvk^H<<#{i zPoHJfwRi+TPps_$QmaMw5(Vyu~_0&9||JI`) z%>^F~kXuGA{SY>)@6=D*Sa-i0o^?teX>5j5C-;0W8Xb);mv4#V$t}Eqg{S=T9*%wh z-8tN+1Ar<_%Me77ZtqOsNui8H0jEcJN(hI+80fU#q3OF>-QS?IVC@Yct1<_KmCCc@ zh;Zw90cV7jiZ-ejoD%MY3lkVxvRQ3GAYnW{gkv|yVg;F%;cZU?+gv`6*{F*HM`byv z$a!^2p2kTs6?2$B%mY{S)QKGJR-j}K1UGcr?U_EF(TnaQ7Y#bwY{IEuZKe-F7cQm4 z{>?ZkK@`l!XTwTe{|@{F#yArOr0*HBR~6k`>c=?;Yx+hy{7==^03r27Jh^l zC4w0^+EJ&e@GIU0n08uK5#Bxn?F`4q+pw*xaL{bZqk>dA(C6U{ylGl(D1r`f>9Bf- z{1RQY9r6*}Br_}yX{t~JwE7m2ELFjHSPUm&08hkXIBK08aiu~V(mW)JvGEt_adeqA zj_!U0{@9cTY<3*m^z0ePBKS8NnU2H1@t<|(Rl&bU#h4)a06*YAuCMU>sJ>R>(&vvK zBA3<8_yPZU#u6kM6&?WEI{?4oKYwqISYARO{H5wQvAu*d%!6TIYgT)$o^^tmoEjpF zn(H_C@tWFLej{KR@EFej!|_*$6js{z!HVxK&yLC4NR!Fj=3M7Uu2p}!M&_;J1 zW}Vxow+~@pI^8WVcQHYwrBIbRWtSsB>Z|F$H-O~OR<93e02f>9A=hgtS24CuDCQmz zRzP9+e23uk?S4LOoJGLooIi`gnUJRp&af4JBcK9_vsVO=7U1j*XW3Z1U<^arMytet z@={o{53eQA>`$imJ_~X~OZ`=V_%6y$hFt%RauuWOqyXjtYCbZ<@wWuW-}G~A<81@5 z`h2mtHX7cE@(j1kfUS$W&Ptu)s`1S!)vSBt zLysinRp3Xt_0}oS(km%fG4f9IO8~(0P#N5vDEM9L=hw#Fsle><{wxZ2Las8n!`4_9 zP=UnV(`9j&&r9yvDlQZMF<|W{&sN3$A-^8WlKr{tGI94+a1kT3*CgwPYb1gw66$Rk z_3q8WTIg`UKT5_x703c^KHx|EXLu0?F#INojTH<(;=f%v#xP8inUuv#S;R02|CxGH zhA~VGGqNaymbR2(R{ZA}%>-4p&%!8Xaf?%4n> zxtjbspkM87tor zG3(FT+|eE)8lZ4+vWNTAAj?i_v-0+k?9gGvr9mTX;dl}$zOlV?g``%Chq+l4j?$ma zTzC(N2$J3%03>(Scsk^IwP>G0Tgl-Z*8s!Jcf-?v5x*iI3+6kQR(j>zNIVy>$tj`cBN0k|`rK{v46cp~jwUg3;*T1X-bV?hg>z zMbC2~*S(ah7(It(*oLvj{b;y(P;m2rpBo!LTY#0{^=DD|5nPwS56b%bfC?mjUK2oC zfS+H2bEhwZgwQ5m3=q^s&6$wvbCjzXHSF1v9DCR_gQ0H=-u}CvHycA+fwBL`pG9Fv z$WR7DDEVInR3I_*-vUSrFf{7eI($}+uo1~VV+blSH9pw~0EK4)M;}e-Iud@ATML~9 zZM=qZ6{E{*_E96JpU~j$RKfKIKi4+y&IXp(`?DzA3F*q<4%?&>P=UnV$^g;=-2D=t zckTkop{;fXG=Mv%oddb9r(DITD>%)R>QF#oa5f?Mto!-2ads{+S@ma8I1}=e!5Ox~ zH31b!oLw0}T7a{E2j@?3hZcY~duu>LxOh7ca{U(ND#n}VWJzMqLuGLH0m1JhetvD- zoe#{u*Plhy|f<$hRAB zzzC6-HQLqvtueP$3U(`Bnz(pNHlXccF1cDmr9bNtg|5@Aheoz99_3?GMdnPPv)Afe z$(;x87D`&aRHWK97^zmb4~aiwMSa!b(@fx0{fUc4doIYBS^n|?P`7fVIRQ||h}Pok zkTlDNzrg1{uH&lbIeh_<#!s)XP7;@1te^tFx#)NaQ*yj|WlD{4-1r5Q2*8l#9|0u# zq;lyNUH+C-`7u}ix^(%;(LJ~r1ea>Ydy^0YkRpxs=I+I64+mOZZT`rnu#4ey7eu|5Nl z5J_`X*x3mgo>n}oAtQt1T`Ih<)P;zM`|(m!t=h&|ix_%Mh9d;K(SfK+BQXAL6n{8= zvup)57v&F8fCyasJfmY0b=>{B;|@R^)b~MUnSsh0eNa#2jmU?PueB1(d2vwnjmYH8 zumGph4*1;#TpyFYacB>6NT zFP3C4Bl3q=p`*j`hdeEWjVYJ7h}ysi$p8DA70QDTEc4QGvDb1E@6XuEq!_Yh~t{ zJ>CP%yEG7NcRp|nOkZ$KyUnHVD3bS{x-jjy@{Ov;A_X4QpAH~g-`|53Q>y>W2i>Ca z6{2S@r=BUC#nlZf*+Lk%>r%?aSzHRQ!zR{UFVc05u&2V>L@*+hn2N*|7I^Rr6^ z7s)F|cYU!xiwdRkA|aM@@hN*=nBu%^IM31=0f-DtA%1Rb0WcEmv_DIc0I54IDemtz z+@}Z)>qIjgztPW!%{s;ey~m%WkacIk6lgY(dC+3rB{ZxP4ZO?j=fh_GP+q2CW7JkOMVV)rZIBo z=lxlVm_F2=F4Js(&#>*%8ODiZIDXvEh0QpQg5U9HDPnw0c4jx%&*PsN&QpYjb)td$ zu6{mj)-kfSX(pEB>@#kYqy%#)z-DJ zDrhjcD-uw+To&VsbAgw|t3?c+s6RX15V(dgx^AA- zAWoQV9ZcLVoy*-$4|nz+EdDO6#R5aYr7F$r#;*6&t9C%w`03OR2wSgIR~G_J8Tpl! zA`G2q<0w$^R*8>5Z=5PxyB*P4`evrz~$ z)9AvwyfLS(goZpKa(L`Vk>e98n*20am!5tb83kcQ*<3B;Yi@%5!fJR~sG_W^pog%8 z9cdn}J|yd|n(DRsGbYZ(WtJsRDRnWC)}#1+&=Sz^@5LX%uSMVt`=HK2JRb!-U!qtP zJU35#CGfo--FSkn{JoMgZ2vkm`G3{9l1}+UnKZA{v)k$&2n!A`mhZ*DOqq1MHReR? z-LFMo<206%JN4BS`fHl~P@(Z8$_O2Q6$?n62_2c~CgR0D7g~-afFr(ORcNt1X13narlaY;DuKEH67QnB}KSvup;$v^p#C z@H~a_Kr@%MY{2u7Z_v5c4n_%;=!F(iopRDhng3mZw!I<-e zLZlie^6t-ogl_P(4>qOr3A>g^ojZ>i7@loSf$Dum6Lpo|XH;W5tZH!0 z-s#SAsC4F1GGZ3aukZ7SVR}kp^gWb;#i&T~VpN`38tKFmL0Nd%sSEsP()u~4@eXC_pxKwBk%v}z%4|rN7gV|y= z!0^j22q;pTesJ(k?{V!d6xMzz3}#U3xkT!pXY>iE1iJoPHy#0J$??o0lAmFI4mEpc z7&Ci(O0JXeR8+pIYT!#+d+C(XR}nm!mQ-qeC6BHl)-J8RaNmOKIBSumD8*u{Qh|Zu zj#j@pUTwF>DLC`ED1)zFj}@Zssg7RRQ7)l+#fMS*H*GRf!tv>d4B}t}-Lx2z3f6Q} z$HUNxv{{W$1skGTk|c+@+^MmoVpvWc$F2_mgFKF1N2KYoj+{6Eq#`wD16){bqd3YA zdoD<~2Jj^VTxh;_ZKQMJ1;&_Zu;ix2=~>ly#p4Tx>^ukcaoyE;zIS{;1IZb8h)A6o zH`%#qQ;zBsU^+;B3`TcCy$nXz7F4a^aa;~_rZZ?L+a1sd61}^KG!MNZb-~cPFMuzJ zUd`8O0=>RA)@qWRN@(=a15`v6!RW#x*cS!};GiqNbaB%2UA#0P-|w+dd?eH(_WAh+ zGR%hODu)H|Bqvv#w@OW}`RwC7EIsPgJ}_%R=9a~1Y*%IsJ%?t@+O*ta%-XL834~eu zVCC#7E!!W4X2_b`$qXtj+XI_vPwjQu;L7Z?&mNny<&24J^DxYwFDu509^CoSjFqq2sf!S*vcSJGU3gRN?3vXI`dC;gS`yYPfj zf9jEfhRSbhPRrP4jePMpuz-|pc1zg~qw(D~-LAGu5QD$5;AYcc^Jde#68;z%47BI| zfFre*z^aSUp8Gh_TK3$fJJO7*FGC6Z<}$VFgkYwYaipP4t&*yeX3hORl<2=*HrI1? z^S1D{9BC+Yl{tV4-sN+cUNYF%P*GY-ehrx(lb9H+mYw*u|u+@E*#L-ht5MERwvo z!b5GL#YhkSGtNhiVJi1Q50BVk(!%{N52d7Y;%vDxMB>D5H)?9DU4f6fjC_iDFWoh7vIXidST zuzF(>-ZqnCDu?NUmB}|fOqxEE`28AXVDT%Gy!c%$ph{9G_&VQoHxYV&o(6#nUb&k$8z*Wkw_I zRpQcpJLZdWAebJKOxk`nYhvKt^sCFoEF zRtZFsR|#x8JvD<;h-`w(>l-}0TFP;^hjd`&xDN_8Z6cLJw@F4hbPB5+I`tHY?%)N1 zZj2;|98>|zFQ*D^PrGGQp?Kwj2bix4m@lM_6<7FyHrAL(7wiD@3juP=ZOG@aQGMGG zv&DEq-r*eYclxlrf}5S{C>lJt&=Cy1wZzM>)d}$DiL9&l>3y-;G=oD}<)&r>yw9rO zWhUt+!B;u;RAx_SY1C=kEthxT#{o9cMz;kl?EwcebYFw3OR(^h({ZCWrY`TnL#M)5 zP2L05VVWzI{nhpiJmv`}omDZdjaZwjN9q11zJx1e7Z*c+S)`W>3+E{G$c#j4=vw3S za>`)$cmTNMk!(wf_pl{Pb$cP`ls|#8-G?C+{Rz}DkM7m1Kfy;}zGM6e@H6jE@C}e{k^BiR zf=E;~ILxo%qwTd$w@YU~5;Uja$ke_Rb%Xlo9c8Y(71*AL{bR?_yYWE5K$s9lH zPh3>Nqt`JDHU3cfaE{bk)2V}E^fOo;NQ;NcoRDV7iN6PempN2^8t8FU#7kJB(dcaP zaoGXIm$3fOJydS>A~;p9<1sQ^FKoljSy(_fqODuDZiy_E$ZJsfwqjviLqjs%+p@Dx z!YwQG*R9ChyLLioAj=|ixfyjfN7a6GMYmPo9PQe<8Mrue%js$x_{YCwjKk|{X0IAw z0B`{$oQFS39Z^3UMh}A5*^>1Ga&&!-N4s#@DVI%GAzxY%VBY7hRq4%A(j#YgE7k!S zil1Mt?Q@MZ2B2e+++C7As1Amm{b=w}Ph0LWSrOOjf*{;dME?m?uJSSZsvhypB1&40 zZ=(#Xq7VPl^fSVZzrvWGH9kX<9-j1*hTWNy5}LamzSjutM7z@O5=#Tw;SE>z>S77qB52>jHk} ztqT`GH!YHN;S30qJ=N%r3oC)on2-r7H;#_64Iq+3*MYd}a6NQN*kG?VsCd`mYMtvqL}GASHDhpClS&r$ zh16Gfz<8-v_S6_$ExtPSoWVL*H%~HP0igZJgRT8${LQn^zQfbD*bVZ!(%Xo% z_`1>+a9xSk8tQsd4^BAXUWmB)Nziwa!MznnV{5?e&G!0@NkWe6NFRR-z4^puFLTxU zM;Q&?@#si!&3l-u9BIg-E(fOf2-9NHiEv|UNGA3F>25+Up};riN6 zz0r$KQ}c)bocGcY9M`b@9|KQ=s0^0XIqyq!(2T-t)Tmnr?o&lOp zVS%PohYNa5w?R@w1u(?Y%E9n&Jgrm`hHLj_VW=)Tv7=nRmG9)Jc87JNGO2n9afR|ay~GyodrEC;kIX6!A5ckL@jv+h&qJ@qE0eD!{`C9SVK9$?)9`>Nx-&g!{nY2 zo5kQ&@W{+wVR(#GSS4qNg?7y9{!Xio4ugBDb(q)bl)0|oD6rm>VNFV`v0u*oY?^Lm zntA`!(;Nm1QVTvt8CWe4Nq#LT-pqW-!;z&0f8!w?SPQ-a1slnw7HG*cTA)){Ezqgg zFEkuDNu3=)B)Y>z3aJ!Q(<{5Jyw>}9xemeN% zl53Ualz~+ak>phlZzz)!Jv>?JG3+57SUuK5!5Q_?vS-vor?BdwQ_mWtbBziNlpSD> z^_PSBQct^VAl3fG1%1 zE)KkOquiI+*<^tZICptk$bhG@6j~pm7*hsTaYT|=aa<2XIRUyKHCAZmi#?+?qMI#Q;DTkpms7s$JbjT-zT#6A45jjx06Vkv z^~K}HKnKv@Akqc%djG=!xuuWq2Z7XkCaSN+?7nL0k|hvl1D&!jpKSGdI7Z008){O; zgL5=JSz%SiDk|{8;@@#}TnM*qJ$G9)a`}xnUVr0r&)OL6nrhrR4YyTk1yG0gWkf(z zIo=h=R;g6*0AL$P*{@WTMR2@TmtV-XCQDE|X!)mkkDBt*u9cF+YQsbgNS;T*O+=8E zftpvYUz|$_MT58@$3y17keR_t;caWoV;eBu<4I&;5L56bx5Dv=hSfR}KZym4(@d96i!Dfo z;~!FE=HC>C@d+I{6xYMR^%MRq>Qwi8MCzRCCRPXyV$pEDbc5#FA~GyfIz%P`vW%0d zdz@*rycSq~dVVas@iS6fA8)vJ=?vpUG8_+=V|*Pjeyl%BVO#3~BaM*f8mr8R*i5enrf>CUDPnq!Ghw9p?i;>SgobsZ8IJe+`LJ1!fc36FOCjsd z#gv{kP{LEi|JLMEenOwGH$-USx zFQo;jd{=$GPxYJwuctTK?w(Gsv49bHE`WZqcLVwBYUSLH_utOZxsut% z-<{?(V&*2?ak+$IW09M#=P0sUU8#jDb34v7Nqhwskh&dr$^3ep776whxMfhDSUH$G zALbiuSTWs|>!rX}W*5R=inxU%wKgmY3wYJ-MMP^|b<}3 zYo*Y&bgMa^!DU=hxo!6*u410Y`#9229`RURx*Ii3^Vwg;)hVEH8GMARm1poFjx?0P zgVhL?ZpKu?P+~r~ocTAv|w8ywwc?Q42k%lsOs6Do) zo0Ca|AOKDdw^@J0vBGoxBu5&`^(r|Br5Sd=!-X?N=d!u-)ZjtrAda+<&HVL{8nEzY z7B^CxobeWDoiaDGUVyDBZ)S;+pYHQ)h0i##7T?VJx68T>Kq4T%59kotU{CIiRnm97AnKS5$qnY$UaLQ21@KmHTv1L4!8C>T=bk3e)@dliwn#@e zG`fPa)@jd7PJxSLqqYy22PcbeV+!0SA#OLN^dexW(VywcduMtLW5R}u<1tv}|A%e^ ztsU`ZfIFab6aFZ5W9=DTff3eEmpmVkyKBGZ85VHsBe$j(Azy3ddTe3tu5E^OmGdA5 zU4cxU9aH?W?U(PQF*4;g>{+DU;*rkmL*>ElizoxA(LvEjYE2-Ln60&YH!Zu%mWKFj zf<`MXlsg_?u_t7dvbKlR-l>A)a76bd$yOAu7kveyC@0H0^r4Z%7OPsp3W}`-VL;^w!GdmH+cbZ>^Wg8gQ%G-a_HbmO^d=AKz$kq&6l^4yDAkf@P^wc{lCNEuixilq5s@nH`~ z78c**AsrZtk3hjja*0JPc?OF*g~g&yJwCSwb)O{pG=NGhsT?Zb;Ax?fs65*;CgtpC z$WaN53t&Ll4~}1*?kqQ(ueJ&jRv~yS*#4$lgi!kT9x+T`NtAwrGO#EWNnVs@H!^`c zoPYH2YT@@s9@2sF`%@^`w28#8Zj%gtbqb4Loq810x4NGaE)_6~xyxbpYo1ogV77SE zgwCYb1}qKaIXdqD0}oU$AkqbMCOz*t{-vTcQk)H>UL%FxK5R+kLw^Ut8FjDajJlZJBgf&gKC3qbz*73GUPGiX>Q>2Tby0;e z1JBFQwRKVJf)NBoD>IC(jn9YC0X$&w0kkV+=0QAQ4|8EFCQGf_@$Fc&II2!l>J}12 z!*P$gC;zk_23GQ-lAIp{oOk?Ll(nf%q>i;I5iDsPOEdq5H1meiFi%9o@qK2UlWKUcOO$ATd5@@FX$#BzNls2KEo)NpSR8I~!1 zIR3c5ew*dvfaMSSvlOwM^?6Nk{x^p6EUgiM$cE!D`njoBCEf2?xt(7l@Vk9{317#aUq{LK5u{yxZ7>>q1{N!GP!=Qpan zDn@O8jydhTqUelYM~dz=xU+ToZFATahct(qtHq+Yxe1rL;I~py?*amt0D~jV!_|l6 z1n?Pw@WA~BEY_uID7w7f0uzx~R1FnTXpqJq2dSY!KZ-wseI5>j93Rp-h}%{YbN}J|uSqRWMQ?pAas|;&Bf2 zMn(_1R&9Ku)h6d2{LrcGv;I~9>{;J>Gkbcl>z=`@@Z()*yR5hJX~i6g_S61Bfz%pR zH1vH_10>Xm7yX*QrgJ5KRNk*SNUG`CZS_tKj&0ER0_UbdnTm-tM9Am(e%{Cnv_Zn)t@r#F2(F zWuMd<#_X>-e$zX+T6qSa&yj{Qcz9|oO}8PRK9pp>yI_1N#}m)~EgWem`-izBf0}zX zc_>MLc6r~=F~sxUdPrL(q}ddPwGEASZ?pvBJGzYeZit%+H1i5AMN=WgY@je$M%%8?#xu7f)_ z#Gk9S+SNV6Jqo6L`55k=cD3HnH@@(7W(>esYfQrWRK*a&MFRP*=+)3O%Y+6^{CPkD zblPX}NAS`eAK3V%Tv!oG{!+>cC^7r>_gpm*rFs%VXJTL|+3jsuNF!okP@WR<%vR%;ZH=y0M`>Hd}Q4gTnfl7gxZ29e@N`fvmxL$9dMt2X8EH5Mwct zejdvy1MBA@k{BZx>&b2!Ky{lmlvxRG=bh-`6+2IQvJZPmZJSytPxkdtuxS(N=b_sq zMRYb2L|){r}@v-oVoN3{XM(a^Sk&(+(xUb*dH7UF)Fm_LNgKA6Yv-1*5_WlT79X$M<@8 zG|er6_HN3+0!<|OfmZBo{4ozl7SKNIAsrZKe*y&?$tBRVfDY-*tP@YW*S)0!$}L_?}N0Son&h`NH>w9*!*dUgsel7`{89U?aJNua-OmU!B6j zSErskU~lUlO9m|glmNLXrv&GCTDPPUTVQa^uMYgc!;z%}Pk2ZN)`6#>U?aKI0WEn(2XqRn13L8_ zM+bsCTz6P9U;&^9$U`|j_@bw6OX@*4b8HihY;V=XE1CEUoElWSvuNwJDI;{9=+Od6 zjTgPB-s(-a!5&wS_RNx`D6PnNEn;~^bbSGGaHMs}$yTK0^t=oD60bn1&12@|^glEtb4v<;;w zr)}#zy_3VJyPh^f9nn)rFvC> z-15BO71*f0^8#}s^ zn52iaAkNbjJ8rx|9c|Hx=2)d-UH0t3DMY$XW-=FzQyedTX457u3553_*<=^IiOx0_ zK^noCZq4{VVdJCsW9(eETH`RM`uY&faLQ@uT>-r#vo z$zg8GC}xV@X8FSaejbB5bdA8zi#O6uu*GO|ts2Sh#p_qqc*O$5b^HI+X5O& z9yz>)NSz~xvXf)O~dfZP&fm_BhuyT&bM_k1;)n$WRhU~TO!Q^qez`M z82=%F9|=ay&j|vIT+10S9Zz85XrO0BQNduqdqiIhVAKIae(B<##dnW}=?4zCe(r+q zH=!P!MLp-qbS9Pr@FXWYoJUGccKPh%tStTK)hT`Yt`}2bbs7XfWQ0}?)z9lsVT2`Ba7cF{#^yd288EUH_vpS?wKA&9>=(y+TO7_ z5+Bt7lu3{Wf!6oj0N+Dw(Bq&oHea^u$us! z>JRQv@(Zqdp3{HjNJBZr?p0yU4V(7YoM7k2js|P=Q5F_f&guxV%2X}cW zQN*>va<94UQa3if!0=G=OUb*|ocNu9F@VJH;E&)v9$vY47A@QfX>XSj*cT~w?*=3K zW#T;n`EEg@UO96t+F_#vjM6D|VP{K($uluTgxp{&=!pv%FK=`^V-eifz+d3O0`WXS zV{#gz7Msv%h^1a@at5wY;C&u274%zEGhh@)3wZ}Hxd$$8>=U8W>W#6=*0D&kt+3bY zv|%47D*!ap+YTU;sf4&lR}6PT1Wyfk52^+CNBaFLz+644K;h1MXqLx%Tz+d1L%M)d zaUj?n`c)e*W*Zwt{m(*Cf3K{f#vi~O>#kl7T5fdY09;;q6za|F>#W%e&3*DP>J!M~ zTDiqtn9D1-T5l?tD;i|G#j7kLqM?ez5A%q;ltO^7wx&=O)e$*easd*2rNkK1%00pG z4Nqg3BVT#k{Z-14Hj`0dHpv`=>lF4FT&G?-|E|{xnJhqIppwX&J@J}#Sb7DAt1G;)@?}q(WB14d zgD()Nb9w{_Lfe%-i%gE?A9$eUO$y_M?>jtatXSPmZ%Tx3pbRX+MUofcp8F~ndN{Ih ze7=X&#&LWQ5QpAZxfp1TsHTVk-Jr9qju_eqpl!1krNSZIq-r(WLg4x|3(t%-i9~5jPmoU?kXJDpN zSeWV5)%pbo=rA+zIiCS&NM8fv51*#VCD=Ym z8CbB1BtO`SuSR{%!;uBHuXsoY2HV%6U?aH%o0dESHl4zPO{X5k^qRpOmkQ9s+~uJ6 zC!SU*2|eZ+hHKU3*wn>54uiqg={3(SIlCT08CWEWr1>IogNGvviR(S210(TNC^&;e zEqMlsI)z1|PCY)i2Mr$cX#ka2QaMzv^t4b(R9>u34$PRiYpQiSIN-JF5C{YVxOc@h zscvCI zeD&mzEyc?vOHWpMNC(!F)ljgJT`Zg-r2U)zPx1JTcm)O zdN6EYC>8Kx%D^h1NSdz#zR1IorGPs4%Z!YZIny){Px7X%=> zTa!ht1{4wHDW{0rJpEKs5g*C%c=2kY@_g-u>7pU0)1GRr-*4@2^&wWbQclaQKy{*a z;bwI<*U3gIZEm{mUeek(c^cGUS8DBjl!4V+k@VKXmcW5G{F|@(zSqN=rM?e(NC#Hm z_d&s?38eb!CdjC-PGQwor{0~Tz6K^iBfKFW3{@Hl$+LtZ7!t6J$_)wkc>2ENkg!jB zs+$von>u^SeD>ggzv1of^ zqB_&=lY7IKXk-fAGh`+{>_wml*S9=U8_-I<{W@h}^;RVL)fEn?mBSI8dTIR7Nb(a8 zN0z!iz0<@r7OD8H^LezBa}yn#@BN%@XPq7JgeS}e^_f~< zKH#Ze3#?T3SKBl2t|z?MSM48wH#>J<0P8S%wsR|7&;1qT%0W(^lsR|f4_2+IrorW~ z4A^Q;rD-0#K4AEemyoX}QgC0~3Oz-4(0?^5lo%CE!|y&58}L^UFAMSE7$I0@S+G{Q za;}Hz{0fk@ea)=($(_G(UxVDH4%alGG-|MfR-a(Wsp8_o3?axxg@}c(3ljiyX!?jCi7$=h9 z_(4AxHshxP- zrc-adruhC>!*`0%uue3?@z4Bx*sPBL>;KE2rI2;yC$SCI;aDL=gJrd?V3QIJ@ z@zFr)@pZRZ-w3Q9?$1)hy8Ya1s>w$T-!_$LZz33uH~BfRncf6UKgXZNWjcRfntc@3 znkSk8{rc85&^=}%3=0*44%FKN3YR-!++;5BPPpWwurCd0ak(SD75m+Hi$cRYaYH#F zh8Qyx7_D47jUrlb_dMJUYE4R2nz1W&JoSQo1fV+{xBYbLAy{m^QeB-7ZM4qFKsM^e zO&B`yAy{=|Qukywkj+8h!^i}(!Owgko8JT3vVm+UvWX02V_gX7-q3Eqg-LvF2zJab zD+q(}vZz@F!^zAP#hZi(Zw}oWu}~1T zsVouD<0Apk`VjIcScPkeL&=p3)?iu<7qCpGQ42ASlLN)~ITLcKFgdmgB_|tOniUlZ zLiCupMEat!O$@WKdH^^@To5A(qYM?rNZMhpaC%}S`6+et$KMiN{LK^^i+4pBBk3`n zgWB-ydBjNCG7SeC`l+tGs7PQBlvh|GD$)jHq%+^goN`iekPN^6I7qiT1&z!$s$Ct^ zNJlf=9Mxy1s*~^*Fa|lA(C+~^+Kn2xSJYbl+3~&IR(-rT4c@8M_Bb5^Wgq^v;uKk; zD2>iZ)g4IF*w1udga+rqC`SKF=SpVh6UE5lI^Rla6WP6;iCeVBX?xWSsjsg1tIu+W z(tPl$C;}Lp$cP_Tuz*x-qH7ki*GUXJ&d_o!T?l7FlUN^z67h#C=*hrmW|_{%UO15> zwQjGfmcUR$ClIX_YRL92HSF16b0Vi)z}3n#cn(Jz%Agfflr|5B$#lw4VtsL2^MxD- zJhRtwq@m0n!;KT^zAqpeO87)qnij_*FHM6Z4VC7k;_)plR}lG7;v;iqeKjWlFY7Bg z(n4AD*9=N$Fa`-XdYGK?Pho7;O9MUzi5U@943ag-tBgS+h9rs%@jvA_4Kr*(43e+j z)CAuFwU`C30yU+A`vD#cn(CB$pS4PnAw!TZb!JFTf^nxcB}$P{MyiTg1_oxBYIvmgD-g60h>%lGx!{lIwwM~dUvB4 zT!bU2eHGZfDx^Fm;Idn9!LA9Na(1y&nck2%Tu&KT9Ezm*;_!SAM-~px@sQd$jGu-c z2#tKO4GK1rOB`y+GdR>KEDm+*XzH4fr$Y@=OJ)QtW1Z!&yw1~>C9%9!Z{^#4gYHM&iL_V0+ry)U?bmon z2gde2P_StWiEZ5$8Eoqm7TY@Y*qlDq@+Wx|fL1J}99mnR)+veBbGTiane4XN)M>5lO62^Z*8CV#LBrl9T3xltCII=+dMGxt~p#3ToY$TVU)skmG zt5aCe>eS=%I#zc{l1l=x#d6BQ_M@Km$-uUF4T7$*e-*F>kq3gfDz;7B%(5oF6da7L1*jN~%+VT+nCAt6OFB-TO{D3uQavRkQs@18%L@Ydk*~LCe$E%Kw+zszW~e%k z0t60F1n9e9qCV&gSl{Ri{Rg= zhw z5zngC=6u9D&Axtt8;Eo%rEY5r>QK6O94zL!Zb~WQ?E#38ia1H6d5S1f=dFmZ3*bj8 zqUPr`p@<%&8NriNN$Y&{pf93|U=_n-)|Swlhrn4#`2q-|LHvH}Q}R1{lF2|`elT#C zAJR}CjSS3zBn|OVaoIvZc~sxWP=C9yCSnKD@ds^o4_53dc$p7+FpD1n(V+z%4(P%^ zKwm07G~u&U4~lks)T&jqn`hoT%$=hJe`dn^1o9-ji_?^baUz1?UVg^OKTQs(M*`O$ z_h(Voq>l&zm%$jSfRPB6bWf+5|8kmnLur^NB6tbR&xy_aQNa8c{aK2bKZaU9h03%D zPZ$w+dLsyt4#!XWxv~X08U*>iKTDAymQyi7#h~YD!@WghSf=#hcfY!vA~kVeU{b;KxD)5@#O><0s)TkXDMoP+ow3i`lw;urZP+u!EpRsKL>WJ z9}7&M;m=aUbjqPP#rJl@cZ$%kPBg>u4nH3@>-dJ_^Zi*0S$D?!w3gm#vF;KY)`y#JwdCEWw*oTu8Jyy5Ow5J*<4?_%w% z{?sEQSz-QJ^Bn4ih<9cf0@m!SlHbD7$})x)-fD~ctT4YEQ77-S;(2z zlK4)*2XyCt{1G%^UhV%yHOG6jdaq-QTr6j}@ zBx&^SJ=tZ=BM^>hW^#H~0+;N6m^#&IclN5U#-Y*ja*$)AIfD|@RXkyF=gvShY!%K* zk9eBJoSMq>;)f_h+Vo0uxJdGz7awYiFD3-IY3F>@xTbRd)WaioopdexxQEm}K`!N5 z_9zr=+CrWn>$b?8AnO$N1X-t^H)zM}21*7l0!9nu!yYZnz@J{Ii_u~@ez&K6u`A@Z z?43mFoZ4j6;^ZCCh!|x_4VQCK8gyDnFXI6jK{B2=)g@@F}aQr1;Kh!O)0tFlSC5E;984T+b7Q;IAXs*|^ z@Clm?*u(tgu=kXwYfED9IyIb*VAMmx-!&NE*2J)tF9g;)U5K|c-I=Q6qCj5Xbk_(` zk99xOt67Ow{kLu&!p8GF9d7zeV)i1+z+zS;c`>^jWmaRa_`~ICmxm_{uQz%~2gd8o zP_U6*;#JF@!K+ST@v2iVnpZFDR!Zhq4rl;!R89jf@U(PE4cL{lOJUq#cIXR~X7$1Q ztgwoZyC0H@k(;iYn-t}KkNgHKQc>=u46LGvB(I{l?wFEY_oK_>LmnP2#d)`fbYR7K z7z#FRAr(irMMiOS3adCe^^7tg(2bIm$_8qI^_5eL*L&JAqZY;M9CV9&N5EVoO})5V z2sHKHO{DQcxy3yZAh+Dod=DGdx24hBmED)ZjsoU9j37JS@AM&VBL+FU>{5s#OCM>s zZS73dyTBsiJ0xUcM2gp>tyqt#yJ9^E^r++4ny8Lqt1d2iVc^@_XIfnq>Jcpf=90ZK z(BkeMu7yEOco_m|EI#Fw-{_4+*L8FNOc_cNV>Pses7t}?fg#JueoQ$YRM45s zA8S!8U5!7^?qi`i9Ys>%r9#{jmPG%nXJk zpD)%{J;sdUfMy1n(MUVoR7RsrV7-w6e56hRO#$vs4p12BBPC@*KbI3JS6tdh%8jc? z>nT0$#OEPLVq@>pX;cc5;rIeS({ze1IYt+wbNpG9>0+x8&hd}3LMx`YzRqxM5gC># zeK@|sU%$;VHu5$8EJZB4aTQZsHw@P=Lj5P;3E2N#LbW5I&?a6kppV?k+o*x@`z==v9$e~ND;%S9%x-xhe0Suz;g`vY1+ zE;b(q((uJ*D&85wl-ZTR9jz8k3Q^DA<^-6Vh zF{Y*Kh&pQtLnj7fQ^$3>C$p|2UxGP~aUH?Wyz9t6fozN9I&!HUTZBw@wSK2NE}~Ox z-4f(dau(}SQe5ynTun9X|)t)l?lkqgrpN10r)#Ymx zip_+y;Qa?Sa-`PzgX(H@DLE~W7X1e}A9E92|zwsXITtVH#3CI0U|`&c_&+U zQvQmLLSvaF#Df&3m<^Yk7;l>+2oZS&#Ch8c4^(ajrq0~5K_T?h&vH4web+mSCHeMU z?=o#iE|wN?%` zd0}hxZY$ZuUU=QXSo&F;e&NXU3J=$2Atf#KcTfh_QZJI2HK7}y#$6ujZDf6Hd$nKP z(S>V#297kUzuChhwybn3xZgu+FE2~E75p|7Y}!Iv>UCRWEcH5twbbj>A-)s!d<#{dveNWq9Gs;~I0yJ=G`!XV3FjM*G0+^Iq^jAO{u0^{)17+Qk1mk-|9qCNhXWd*n8Q*Zt2bWkc&QHd>iMb8S41Io4gh3Nrt_%na7y zw=M9E(-jv&EyA9ff8&&hhT~O0>se=zl}~bB0nV5CvnVUy5+Ze+!F)GP*QJ@)BZ8U7 zV;H?vF;KY)`?~~{(zqkn{~XF|FAzx5$pC{(iGp18oq5R!!!{L$Di_Z zU^9(pWq<0=;xe7TO~{_#STo4aX|+*k1c>EZH)@(xmV^8nh2>y4{$@boa$|yP{srEc zlssPfX+Vq14a!fj-@~{0*?lpymG&I39DGsn;=tbj#_xm140K8M9j`3+)T_FBsh>{m zL9z8pb#)=o)XiLF5(+~n9%&5;`I^#dL7h7UZpQEyDb zv%ur%;@tppxd+O<`3nV3!2`pSjd}}Q&QxymsE2&neNoPGZh{`ScOLmesWR~6SQ=I0RDEIYDgPE%6VKHB9BC+1 z2hC<)R?(l}1P)SNp#2_K8PC`IIMPtQmbQd-$7(G31sbcBV(Krrns}xjiZe{f zFThlsV(Ob*O*~Uy<4A*<+LvKUegUTTrI`9ht|p$Tr#RA3rVds!O`5k@!I6e?YCqItz-E8VdA{dlu2#M&Pvl5L89bVqqtmULPcxLTX>MCz!12e6at=ot zDvG`imKw0#@3}z{UdYwWvw1B?8p>ww<(w4T#dN_z5n3FtyjTs6G*qm0MXRSD!KYh3*>$Wj43*o&3ABh^K8DABQ0bze`lo@4(MURt;$T! z_-YuJOM93!a4?r1CSs{a2m9B;XTOKZ%w-VRSzJuP12_@g#=M>cyQB2A6MaS(!M+0C z-so1R_QE|C{G$g>YBC^&x?2NIDAi~h65)Z-I-Ffk;Muh}f`@JTGgP~VMf@q~XXutk z@kfvsnb@SSeRga$sGmO}c|Rb5C%)p*3uqqY!0|=oYpvXTeA4{no;lgITU zgjGZv;hb0#duCc~>j^Ehy;oab>yVkokr6lK#7a?z7-HZ8y!=x`hPGr+d78m^K}e5~ zf1nJkM~Fyb%vi2R$a37UDXzpHE>8zt!Yrz+Aq%@kdVoCbVc)iZmGS^t4m=pyr3Z+X zJ>vnQQ&Y8#zSgrMtmF)2ik_?7XqzmC#e~_oiduCQ&`Q= zsq39)VtQIPMB*g{Y-73Quzj|ty-H$x-7GvS2TNH(F+DN|GF8EhIooUX7}$~#gC+^i zo^g+dIny5!x38rPEN(@T7q`oRc?D4VU3UN>@tq!yEF`|eLpm@LAAo|5X6#d6^>AgH zT7v9Llz|1ANSZImp73yFf$V!8(t$ztBou5Ummt%UXF#S?Sdi(|)pkD_d^w*1T1a0G zT7Tndhmz1bA~x@3(OVcCs2;OGm9{TNzgE1KGfgW&wT?2dpb|-bP^m{Zpb&ZlOSdnL zTxWYYvOsmFhjd_2oeKpU$t9??ioiOc|%HVd~sESVOSSZY!R7E2;&zF4};!;yuhS9(YX#?ot`U?aK2 zl9oJ!C7r@zNv9sHJITPwd;>%wWjRDOJS|WXQ5P!Xy#dy)T~}?7T6G9s-I|!Cs9>;N z=!01Y!i074b;{0^I9z6sXPNlr1es^^|F}mE(-{(mAEpc}3`Np>VfZ&5jw~2{)J%1+I(1`sml~Xw$OJ&fy2=6hk34Ny63D+sZ$%jti$B5Kct^7Z zfppUmc`}a#b6^fQ8CvnYk~8yC%D}={B+VDb!yb+-7$4^$9T>*zpx_LQwd5HX>l7Bo zI(19wJ~e1ApBF%lHJ1bRFBTTmSJHl7dEE$~9kWZ(VH&Hj4gf<=1Yu_PG{8U)(Vwbt zjnfM6#G#u#ER>@*o2FZnR)9Bpz+?Jf4&c{O1{V1u$&dWv-Sl1$M;7wy9@2r4--3dT zwQ&{Bd)HBL-weF^*R5rjn)>jViS9{vANtC8YZU1P~-}jy8eat;~)*Ecq5{I30zjMxa&iTIY zJif>ILkCV4S^u5`bkSt}JSsMQmt?K`o+4}gC6lc6*LN&tat(PesyN7;+8>V0pLC4t zkYs+gcx+Pg?`0jS2uLb?ETt#E(Y%U1PQ6oZcfxX`I`5UCWEBy%Xtyr8D$~<>i3}UQ zkPn#D-}>*&s+8EGYOFk>MZNsmQ} zk@S~LM$%u8FD;qqVT+cyVlW@!JRI}A=9r5V^X04HC<5x&3#j0v_XMe}3!2pbjnLLD zRRq*K3y`bynz$XHPTjiJo1fgaoFkx;tLX_Z>~-71;6v&Up<+?j7I5cYNZNbIaHuj= zxD^b<#7Sl0gCM1?1!WIXH^v@9kip8N9Q5Yqpnk+f17ff?+fdD;U3#xX#|bPJi}bB< zmwtu=b_###i*n55rY9CeQ}P05nUg- zXvv$dl4&r95rY%{UqiaUtGa~3CuQLRF*iS;d8u&BO@!dQ$R0fYdFpS;f0PMuuonm| z1TvVX9IUHR>Swvs5(o4AFkvJ#fP;d0GDyjP(v37bC`ydC0^`2Bh%ylQ716nZ!91Tc zSZ4Vcz zc68vo?jm^|uwBO!sE;1hY-vLoq#2;(uK`@j4Jd9KXCu7>NUwGm$wNBfH=e+|Z17G1 z8q^u4pcac2Q zZP)R{kWU-DZ772@1HeMtje(8yH9-29yGR`A!3UPKgSoX%{Bi+4k^zFnA~?7mS~_Kb zU~B1IDA0fm5UjQ&#e9S*YV3UlDwk(4I^Hbt8Ei-o_QwlMsXUAQ5)qcm&RO$M;=+Q6 zG~?pKak23U2X>3Stw`N(JrV8yixK$>V{Ju>@<2qO?5s^%K*X3CcYSTk_Wr; zme4bq_F%sPMnV}L?3A7D!TvS$&EdhmELvUb%+is#|3qJhPTf}Rg`JsRyGEzu1LfIH z-D_29UaLCath8#{SJDNhWgFjy{exptq??NWD&R06`~)_;L^Sr`7;?~_q-eV_tDn@j zl9QdeusPd&FQ4iA+Kt5qHn#V8)FcLc4GjISd#FzoG}^wq>ibvL07;s zyBh0NMzr%_wRYw-mLix!AD(Rn0mdvS|9B?|I7aoh``lFFjbRT3|P-5GePN4 z(Wz8kTNGkoi!K#Cx!4c`j?rH@Q18@Wf=Bi@xR5I{4)JkLMIIPWeiz5rWOjUfcI%!F z6KlYXkH3p5NW>Ztmin0_z;kK8Q9dd(;B;}t8#v>(oBXmlvU1|R_)#E{+U{pN`rVoZ zYMl%e8Iafi%?xXK{f`KOPGTC%h6|B|isN{HR>Rpi-jfAd6i4j~nHbJ^{y?9}PFCC5 zXr9Re%|&zYTCRqjd?vG~%arstqFKGzG~_zc_~&S60Uqi%UV~WphW~a#UAj;T3TD^3 zO~@v}pC6?A1KGi?$#s%gP-){NXES~4r^mEQr|#k?RG`>iieFKir!Rm4`+ z%bxzK9V;&?oHXJ4AEE&*`A^7kRok=ND?U1HUDRTiN#$`(DsMp;?N6eylzg)|4Wz8R zFh4@`uT*>T6(kj-^ktzKAd!y^;Xg3B`QE!@>Ib<>tW zXK9rq;{U=i1m^4__0NCC1#qxhQQno%iHJ`b$FR5u=7wZv)kY-!K~p?$I={rfZCMpe;e~t)U$FIDmG&xDO-<8in8^WOv=_@x4S1;Pg_&~7!*x) z4@c2sjxigOqL0dRm$4{4)MlfWHrnSlc%i;U+Spo=Es9x66Hmt?Gao+4xYC6kQx*8}G< z!-l@krxp-CVKW@z-|raZ6yfKu4rBuKe1X+LUO&^G$-eH&Sa5uLR2a2>Oe`czWdii6 z0{xcP&d<}Jx;A#^+W8x1(*`S`L!H@E%{IT&K(;vg{E)QTX}0Ul`DVQb7_-t@mOI+m zKs;;EMr@Y@hyv41KYL&-491ibXQf$Z4bzyVx*Ho)rbx1$n2L!Z!&noEmlWiEg6a1I zd-mv_3u~UG>bq#lj~U>si?ycqht{@M^As=jFBh0@X^itl289ef&c--P)(MSJbd2n0 zmaJaz2BAC*+fVq@br;D) z-m(};4Ej3_-WHJNTA#m{{9D}Z+bB~Q`WxLv@=#8jiX<>UZZJ>7nhr2n$-mo;jokqX zMt{^@B(DS3sv`uoq4c^z-G(wqGeF6oabsX3O~L3-xr^i>ov;>34EfI(yc2*1b%rVV zkGS!$QKtu-7u-d1QI9R<$szxsg?b#&pw2KbmviG`qfSpaKkhD)hq`Srk{I&eG!JHcd8)*{bzu_*DhjjKMEeZ7h+@PNgZ#u%DFraf|Wp`u?I`XIPBJqw4-p!}& zW2_ZqS%G$>eT-Nl2e(593~3)@Ev)}mU^$ldF>3#!uDElX!hn_h&lRX#9#ClSzr+WW zA?;&U+~Hi`)eZFbiNuN@RN@XjM6Ma9d+dYbaGFecUwwrGyTu;T6OE>h>zf?yf~t6` zH@M-HeGHA>P*a^tXzGOrrL8DNon#-QRAG81)AliRX_sLiL)qE(F~>0sY5N$qotThz z28*?tINY3_tJcDb?mrOI{R!l_=uu3xnxIC(WRoNFCIIJjPXtxQ*6ov5{IG8Z*hUt)g2$ktilYJ|1edM zFssPqV%~hShR+Q)YiKoR5N%?i*7C}NFLaE?AuS%{gRub|5TS11O9e81Qc5*gLm;$8 zd%oH2w3XW+%XRoEBH%^63}5GaPuzCsNO}L%4dq&+3ND}^S;7RdJnMyxPF>x?{lDpt zreyy`n#hv>Svj9-H6JXD#Rg>J;+MWmr!QzaeG6%q#7) z^zB@9FugZ0VZi84nsnG?A;)lXSum>t?V7VVB5TvYEf?8O9CQ$qp$Ew$@8SZPJR&|h zd4z*>N(3_kcHZy6hz4D9!o3bqn-lzP04{2p@c>{=&m|}5o~JlLf63$o{q@>{b8Kk7 zXbDg^wK5!a-|85>6m{n_4C$(0FTgPJDu~vig7*Vo61=rky6UG3^jj{NPtl;d7EHt7 zA3?YrxVcnGA!)C66xHv@ZEDL23zc3g47BnuL$6$1myAerr_k^eo|x8nja7+S=vK>WjdqIHx91BCy3`o|K7&HST+13`H)e)kt|>I~ z6xM(m8HQaZ{Fgz6(DA~_$Nz0vxPXo~)YA+_D~`IYX1Jj32PSp=5;13!`YlXhUoZ)i z1O(4jAFa8bl*A+_Tm6j9w*Q>2C+}*g+-pWxSwbsjA zYIyB!TFDk)H~nuBR^rMc4Qr5RFes7T$n!nF#GD>)f5Tlwt@E#oPR8OGBve)j>{s5U zu}=UR)ETDauL7uJD{rGtkGL;)7s*9EuChv?Ub0Y+0~*vB1`(&-c-W|u-uy~;kv!CG ztyKc=8w}nyltG#SO8z_C7}!XYzI>m%hzn^cuLU3K#lycVj%V*PImG$3_{YF$+KIk`()bh-$zr(Q!!A+SXPdu^{<1=1)#isOfejrZ&veykDAR8aRB{2Y@%d)*d(tqVJ~3e6XNMRTiwS9hTw zT{hF{ga~))Ss#xskJbfVEkqpb$~g)r*hkJdc~Q?*Y9g#cfGQ_MjwfOd1{HFltkhai zIRIs}C=2L}wZiYA!VVGrqbs7ZMzs~HpR1yc-nk~m3TKL5U~*U0y;Hr@sBipiwcEy6 z0ix?wXOS~XH&GsSs{dFt-fYkH!iv|fb?SiXN29%PX7ZNFpozcn>Z<**;&r>7ZlwV) zyO!7Oe`xO&%lIE=5S^@r{b+rs7uqE-U|d~4+M4*1sLQ_@92AX<1`IN)^xNVe5{07; z)R_Py*1%Y`(7ArJu7!s{dpJg8=DCd^d=7+yX5jjV0U3efX9oSn z&@}6nxvn?UJO`C|G){ppaIRBX(TXOhYhArJJ6F*Zh!N%t1Sj&k;0CI2J?CJU+X2ym z$(jqiUcFN}H%qj&!8-@0_bPTtCKp%=%r_C6fN6DorQQrEzB)Q0v0SYGii_Qe# z1rg=~PO>q-W=Q`XFTv!jr+Tna!6%WAtH~;jWC=G4(!`^_UzdyAsnVU z-P8N(-uym52K)NaW-38fl~keW$Dky!XHwR?KA%wzah~W`@|9%ijr$(L$Mi5*^q9N#=iozU>{rhAR69_jC5gc@rYo5tH4#~RC`5itrz_OFsR_FDnp zxC&SI$Mn*s*34*CGeA_E{$sRPUI2D*@qVC?MM&54>Olnu5;&%LT`*5PZia}mF%^e` zH3#Vvfv-?{KiKg6t5;xLc2n}+l}H|?7uGhenXxMaf6kBKbHa zTP{a3K?zUAGc+@QLdj<+dErVVFH-W_1d=x>xnnDmqm*2~6Uj}S(B%CA&E-p!yuyFc zG~P-dPEzs^B|M=Nm&gAPO8$$ISKo=`A1V3%47oabFwb^WmztRpCI8} z?LrQN69cSO)Zi`<@wfRNQHjDL1OS^7=? zj#CgT4m3L@VK9H{&Ru|%%eP_P=5e))_E>`_W<|osZ}U}=7|!IX8a8mpcDljkG1pDErj*KdAW!g(OC9ZvaYUtcQHx0%mL@>>d$R6 zVz6X&)fR)%>sH)%WpSaS^+>5iqL6G1szy7R5`Ykr^LN|RU8v^*P}kiKs!`N+%mL@3u1`)H>e?}gy8cyB*M4DcaLgFu z8WNMSIy~6O>Ih+p=MdHYDnpXx(j|6;gC6maM2lBIs8S}|YKyjBw3`yN988Vf+wkyE zUA5~8i(hT&%VZnq7wo_g+>86}fyD>!anf&wt4HQ3c0ebvZq%KS&l$q%?K%bnz%U*e|HV^bs~R*e75&DA zpxtaN_>HI=Z+NN`)GJ4fPao>;d3X16cXzzJ)M|B4#S@igIcocUC1`i!eTN=-;knRn zhcC3NrG_8Aa5RXX>CC=R_Uok!!3)S5CV!|<*p0`+cA3lGHn=Qumz#~bV7?nqN^aHf zu|pyuVQ+Qwg5Pcj70|fcjVJs|k>3b|W+Uvr2y^XM zn+xiY0C--<`K(Wq{HbPSniQ11uroIofYzFFvtEbXSZ(o|XNg0)b5m{4w56Nx*Numjm`pEiZ|D6FO(u~vE!k@LM6_M|0~=L+n+;AX_S30Y?aWImn6}!+PvtA4i>79>spKRWb8sOj24-fw~~^k zs_2|`>Y$0ppgGC4tmQ_Xr`Zy%R8{nrYN5(F>s4R%W?_w3U;KUYyzjTXi=}o05=@xc z7$SQhO2oeW4VfbuMe61ycKs*EV3_At3e;-BYLN+XnH?Fszr6LYWsz z4YqtnRv3+5YSk6sjI$3(AHy4fTSF?XJvw;RLk2QqrFvbJ-pJqmmmw!*22^KJCD18U^(Ufw=%Hr@bBpTJ8v0a5 z18PU1s>nnK4cbG;gL_nHA;cEF+(FArggIq=^Ge*HyYcdu52K5-L^qr1(t@)EiC3#$ z$lZ8Ztppptij6sSBywKMAz;`(HgtYR;7zj0orMkIK3%<0sDi&Lb93~`Rnph5pzmyp zCOC)iYt=7Tzf208(%(FzU2~euA4KRW)f+|rHJo4iEtovcC>T<8L1Xe8U6CTZ0~n|W zVHGY%m5^Q|@r%`)ME>;*4^Q5Rg1LZv)Oe?HzR|p>00sT9%+9&`pGB!vT&fdPy74K9NxeooHBP7&t22V45S#MGR;E};BWjjq6J9Pr z1?Tj+(^8Et$r>U=fRH1TK03UIPD){gv}v2Uo(m=U-Mbi6sE=GHN{QOA*+XX}XBRZ; zK?AU?B$133?FsMxy7;_-F%deI+X34(k|7rmDG0h?MrIK=L3=V~BbT|@4#+Q(jivws zflTlUGMDOtV0CYGt2B%3{JGt!ut6kD83{(?6DCfiapQ}(h)}9ffHCWk0Y?Y|pDIvf zSOWTy7Y&hLL^YNJSk1&>I-BU{OnxnYnL{KC0mzTlebxP(T0Ky`SNzXC)oGD`J?Dpk zY?tghZV}LkuDnjGg4hmTk6pX)44fLGP0qr5lI!Hpq7WP)B;0J2>VTwXpprLnDPg)v zn?ae45f>F{$jup$yDg7svq__|2g zELbNmD-wtl8aBgi6^R^N()T3HTTzS3$)|3SoIL8*Q?xC)oo?p;KsB5tajN zX`P6wlG`9(t>i55*heCYqM*C2d>t3K&!c{hkFq_$<44sROc0My;&)V|s1-gkGgGcK zYGJWlZ+0q(G}?X%^WQ#w@Z{O) zlP6Dj&zw7XqS?m(Nm;SWCyHrNtW&H=J4gO<*$cbT+F#hy^@S>u!j&Mz&}xyL>arK! zL784unGztujj{pj=Y5Q_E=3fCk&?Tw$K&!7`_m07ox*Q6NUzsQ*I#!X2SzHbLvCp) z`97t-(}+xt+hk03W0Iu%eN<}WD}@5W#^0dw)XAX0*fc`Ol7^7mpMLJdiNdLaCyx{! zJ96^iu@g@oJbd`fk+Wx?=qALs=+a_9fx%^Ip&M^Laq!g9=MEl4(Gw@0tOvzrd)_Fv zmeh3#{a~KFNxZ5>8pan9#;q5r$})4<%BP3Ia-chgsHOu)5p_%4awi0a zFu?p}gZP4Z2Q*5yZ!&7!Ari=Hi2qx_$O1;X-dSkKcvEsjSuVjksxWlB$R9OZb^n52 z_v8qX1~nqe-7GSs?JDylF%9p!tN~|1s@^1uaT3{SgrM-)oU~3PVZg_u4%ip|yj6TQ z?7NB}IC+go7J*vr6>3oi9pOiHU*I$;F3ZPqg5&_&DWl1d3z7L@7!X92&!>X&b!0I_ z0tI<0R^P5axBZtf0FJz>UxKwr5I34R5HY|b9lxGw87Wb);KQm)c^e5Ao9*)ic6?>J zNU2eVXNPI!gl(FNOwjzt%l_f5vOTRv`;tBrMggsHOteOXlQNQ^9<{S{{Cd>_C#i(i zu2A2m5RIem+djIs1quf)4=Fen6OQpMgdCVAd`_4 z(Pd~kz_T2u2<$ImMhc_hC`v|d>&sqH@h~CAVJgTeV>v~$RB&opX*ZNxEfMIrLu@9r zkuzlCZl4F{c%@JWQ%IN;I?O&6djN zVcNs0iv71h|7ePSy#=q)sK`kXjLYKHNeX+VP03G{5f127?MKovZPv*Z{{m)D=6QB% zrQeuFt4p$N)7d0BHL{Ga->8tI}fYhDb=C)vc@&5IgqtH$DrBgho-*!r1H z*q)gU8Z*_P69si$#E?~jE6Qw4%BTcgs-OuWf}$Bx4_y>f&lr?M%_fGKTGSiRphN@J zQxi0e#vi$DZX{D`XTj_^FBrgtQXGqZ!m%-D%834TB6$K8S^yt0AO)&&)#n`ut)xsd`m_Ng!+7(LJm%1Ys5+0Iq(s_vFC8|6gx zU=+kOsP^3=!;T~a)=XdrFs4onfto4MGx(U4MsVN4XjfZ0W`;;ai!C23J4lLGYYahV zt0E&OA_GirwGle1@KYrR4b0SF7zjMUO=6z6tCbROzS)Fh)L9hBwj>8EIEIV~hRU!r z$q+QeQbvH;LCj=eRu7q#wY$~Hh6&3H2s($z8Mgd#faaOTygk9B$gotwyebc`X}%DR zx`d?{I1f41q8Z4@O!Ll3&O7_TCX>@i_Kj9{)QLt`>~W^76!;f}=2ACyQk%4_k~UkV z&ijjGyi}rAN4W#TwxGOrGQ)X;TGEnXl$>zqmc^ZMdpd)fve#K04DJQO4`*Yv7MruQ zMy4^=CuEY9C1DJvj0E^9{}OO9N@rY`u!oWALRJPI!*a+<5edY@05>P#;dyvpxK(r^ zI0-q?A^r9aor@+r7J`t%LP<*G>2zk}NilfD$^tw%1;23kJh+u#$ZobvU_Bng@PoSO zDPys4om@~%!ol&=avd>Q10qQlzpz@S)>exmCdE`i_xQ4So2+*75lhLK z>GC6z-wo-+K+gLiO)css1+hSVe0jV%RYZsZ`M0MMYNZP$G37~YsMTPFMiUG4eM_oT zYZ2?U4N6JVr?tt9&tX)dnv4mY?(v5@@n#uFQ5%9j#1vn5DW0;vW5NL|B}=40k~6jG zcopPAGp_Ul@}#9)1ktpRg}HTzY$@J?`Ipjp&qt9uEL??Fm!SODl_ z>g5@P-!v6QMn){tR+q#oDEZ+`V-Kfb)T_I~y2<2%3k7qvL~^^uSNQSC$O*C*oleWmt6 z_3M*2{qFD8-kbdT9JYKy& zUL#`=OsUYix>#&Nn}UH@PQC6!-CydS>F%z588~ECwib&sB0if58f3Ma?L{=0ZoES$ zR4lu}sn3=lK}?AO{fyWfGJ_}*bKj*IR>=&SJ!p11m>_JFs1KCxoxwVKs7PVPkn_M| z;(rNZE2`$NQFV65^rc}_P zG^{PQYQWZ1Le8>HXCW@lq~ll4CuR|0Wr)xl+$j6XWrJn~er4DS{QQ-3Y3vV~@!+Kq zHF`|GXB*w6S>>5hikW$ymL^Wim~Z0ZC$F3}TGpYdtu#9{Z`^F4*HFS6+{H<@J2hXF zql2iH`UROXAyBh(q1VtNB!*nD{7hiGE>3;Q!^{=UI&#`Oue>tZt#+nVpT`1UR9y&X zFniJFEd|u0!kLRc?VRu{%)m=mn}J#rYsa%Q*tn!j&t_f!HYO95SQf4}9iYI zzi8lJUgoUNumcq8BpXfYyi4;#u~EsB1{2)_%@m58!>$4rPO(Q$Q4GUEpqJ0jqgD+e z&A|oWHhrVO<9#Uz#tb4Jt#QksjX8XxM|l|OGA7;7P=h(&D=(HY_)8puhYf*n3=Cj2 zUD_xJ3Gh%=HqSjh;NgIRsDrqLV(Vr@$d|kx$@lb?E0+3+9F;JahRLw4{%F=MSBG}J zr6Du!&~|s3?j%xma2ZyB|Ox0iRSN?q$~BN7i_S3^TaQ7>9HmyK;EJ!5>Xgg~bLbRZ=fd+rh{dMh z6=7i!;V^t{oG|hgjmLP}H|o|_qHt%n6i*oQ&J>j|4={6xfOA|Af-$Sa+t=`Q750AU zAJo}-vFJr?EF6z8`r<8mQVgA0jvi|(KuHLMIj)|pt-=?`U=8uV=@1X;I&H38;c4Ek zV%0D+M{Oet*9!Q9O4O$C@0BoL+ev848I2>W0ZdOEg1!nzdF*NNY9&p!LJ@A^Y=9+27N^}*`s5S59t3?uoVj_W zA;17$rw*fw6;4|tZA*e#83cFFULkkn?gnso`)M8@7f!%Q6b_M-C>&FxhQdKi883!G zXbW|?BBBN_USSQ$p$w?OseD7T!4ebqDx7rNf<`lWhDIoZN?F#v)VerqA{|{do z|DAZE-oz3WZD!LBlYNfx31qm1p(XpsgSHx3A0A@VsHgJ`LXCP1&mPpM#j^9SQQP2I zgBnShXAEl0FLs$?#-AoN*gp#&yJoh7ZTVt> z!`~=3*3e>VNlZm5=buR;nNI3KLb$|yF5T?swGAW@c8&iA|7Y6r&G-$!vsL`FP5g7C z_~$16hoU91Fot=kF|gWc2VD{AOo(MkcJI}b!a>EWb!`O6-vLZMk`gIHi~{kuMnyD~ zDUd!pDw5THR7msBftDH4{L3B*yKDcdM@sEWy%L5Ck7{?Jyr|=!>m|%lWqIQv%pVudMxDxHK}4N}bMm~B zZRh)C6rvtqag9VB@7Pram(w9}IgL>(mOG}^sf@0ap;p6++ z^fhwh-=>0@{_5(TO(<(`?ivo+FXHXH)QEPls&?n*!co;74DlxRn01K)p60_hrmu<9 zi9*;Xa#wR$VXxQ17TZaj-f%28ZAZjUj|!oC!y%!iUcF&d>$RQ7oK{ecSqIGR&D+MS zPd=fcR_-betDzfr(PY%Lu?R3tXDgUTM_CKG*>IFq8x9xZds)x!G`<%*RHBxaP{bA+fbG zHpx^~&s;)Le~`O+!zyZ8Yl#=4QfC(^p1?NULdtZmD~=h)_p>&|Lf(hepW^ zWj_0Y;Rda^_jLF@Bjk}IE_43UboRAJ5_9*{+^WfLVpOw1ql_QtrscGxA2Gz6D8jYu zr!yzK>?F}+Z(4bEMiP!V<4NI-695w!u*%yaECymT!7P@?Tn*VX<6CxJgxqnV1munlAyIXj zB!xk$;!L&-JurP_RJrK+fd@y0(AM|9Q6aPs5KTOfP^Bz17n`n}3t`2sh>O1-)s~Vh z;E8x4s@G)A)%Qew7OO1B^i1NIKAKz1+0CCSI><5oN^V+??fei!^t7E^U+ftn(*^=aH=cl8JR(sSRGel35)6Q9E-p;&hW8qeAFz zvTald9omTIa797IHL{dj&(XyI$#&NQe$sYVyTA6zB$~_5<(AK|HuR2EpUvKy>vrH% zxjAy$&GAtobh{B68$s#1-H6C#1PIN=8>1RC8I1Byqc<-Y&DxY?MWN3pQRsVft0=qO zQ4I%0p|9np<+P|@WQd+F;p#`BYk33MNwMYI?$CCU=*FMTUBw~AiRlsA?Kv$spS#`l zGr1`{!u|B95W1s$O6ccmhoT!P6ve*%!U?r+-&RFNy3ofrb606teN1s^3ZABuvjnbE zzLA@}qm-|Y3USSqvW~k3cEF0W61GOti9#L!J9lMBxNjs1RwHj}QRp7()1+ z5g;@d?;f@B$QXk61HXAO#Bdvht*D}sL=~rUD=oX9Q=JDz6~}Yaa@yE44DlvL6`RiZ zM-HDYumL@W2@V|ZN{tpWbBK<-kh{V|3OBwvHB_(_4sYLudt>-`#WY`gfQzHm@d`{AD83y_{r=nx zIjVf$s1Vm&l{aBN2j|@iN91|8!l6>VEYF;zW_J2#70UZU?urhpyqkB4lX=tXWZpDp zqco?E);^z`6Gv;G8x`W3YYjWY#34vM16nx3Cm-!@*C(IQ*LQMPaaeuP4l=(p@-3r6q*Xb>@KBF1#TaA+2+hTjQ4Nb6Ve)y++#}3USKIU%Piqj_P6mCjPH!Y_bT^bcaE3h*vgj66ObA8hkn0X%7(&f7nU4Axq&9Ze#H5{bN&*Y}% z=*|4Z)5W~-MfJxIOZ%1z5r?;kNl z&-tF(Z=+(kAVNI8*6Zx+6f)7--64)GCbw8{{l>AIh41TrvAbKm@uuzxd=IWD%(&W* zKHK*V(wF3_LHd!pV30o1<8hw6Jdl1n*9+3etlQMyg9psk%9}_qpN_o`V6^rV$gK8L z`tx`6=la$7vz-2{q(9^IXEpx#xS6DMNxa1J*1yAlxS69Q-Z{ap(fN9F7MISARf7sH zNyGn5N;=7hRpKUUTrPJUEkT^fZZ_(;Q$C)+^(0z!QmOxon0XG%v++HH-?)2$uP5Yp z&1%o1%<)MP)%*{DX^9DpKod5x7Sir9$6WLT=qbr z`Q$QWw~jYqq62$!{csw0$4pDEq)_$p!JWD3J6(O(s1Vwc3%!h>T4~Aoa)iI%mi*(1 zC4WA*ys}kJl^$ft&*rA(sP{BO^tR+bK%dGy`96yE<~se1toQJS`c;UecA5VCBl`1h z`tu9)=a=ZuYxwiCv(dx6VVYcX>)Po$n9paA96K!<%m|%X+k=zL#os48{TsREGGwP6 z(oX+cZu(9~{%4~?r1dg_YK5Kd#Oo39(Nl-G-&O=@>S~tb*YhyIyM7q`O@RGtuwiBf?fOhG5!z%d>k7r^bo;$2%*+q%9Q_t%LFY{&qZO7rqRyA;i>wBd-f(N4n>Xmab>Ke#6t7ubnQC5`)B5-xz`{iz} zOAYb54&Hr8?)oMLkISE^QIcg5=J9P%s5$&cJZC)F>yYnr}v;^lZ}h2&EE0s3(5 zqaauNA^y)6MeVQf=~V5n>2JK6tNm>IS$gDpow_dMG~K{Yx3sTSUkML*jGpZslWH;)OIBxnz_btEJ-Mu?r(JIm7+Bb{C9*-8( zX^-SKLvc6zO{v2mb~0|ak08=9x`>^gHZJPR5T6fTDeUIE2@63Z8+}hV-jzw#hQUqt zM5VTK0`2WVbtCWYJ%Hy2J&LJ&p=}<-u}YA-XNcTIg>KP2JCBoe^ge3??*#j}9~^Hm z@gnL4->c#>DqL6Vhq?KAW*B~kp=|N`INp%O)8V*4wN-CM`MEkU6jv4vLEmRjfwoBp zT+J4?E!D#4>IwN8zzufe(kbb7bqAf*HkFiuj&GFQC*O)mK_#XA)QS>48(PaK zQ%D+*YNr{Q5-f|tqj&+&qua;ClhOm|&{GaUS(Dq-yBPkfeRQu03>>Ztp`T0dr~aC3VAAWe^Q<_#@nT;%qrh#r%@P0gyQo#_7h7m)M70?jkAbJL@Mem_@6OkM}RNJOzpNFLBJhQ53 zBU@DO3;lU|vNdNVP3M_KQKMSao-8-&rx+!Rj?t@{qjc20dDa$-m2T9igwrS#2SOJm3q^Xog;^z!D+MbBMnI7n7d7p&qeUK9db4s=}{DQX;S5KJb@67NtMqce* zcDO*<9%bJmjBH3VZxJ4|2_rlNX0(?~>^m~BT@|_gZFkJL!~oEpaBD{GP)y;l6>+Cz)LkR7GbN)^OpAc&82Qbfn zspPqKb79z~qC*;owPFUWqMO-IlA{jYbU)E4WXC&PIl9WV$xlQUl`BroQ z6o1^RAIR{`eadQ8sNk|s=Inm-B-ZEfKsp92=t3oaQQS~OA2>~04IuhtF1l2#dOu}& zE-?YWI3ySFoGrZNxd>qo!-q@9;^P@3UA#FuGB=M7R(-J-HH)W19DpMvruRxmX6Jz+ z*vTMdadJ$EBqLjXWj!_oKRwAQuDDO%k&2+@cqR2iCt4yt=(Gkg0J=d8uika}LZfp;ZX4r!~V7ikkdFLseZ83gc_vN55OAihrdTU@De%>_U zdFW^^PmLfj!?vXP5wi4ocY_{s?MO8kS`=4LVPeI}ZYEZu**JFbk!N>7)Br;Z*d{Av z!W5~brRIAw)a;bdQo6MlXtu(3<7MZH(L?(n-`o?KFl?Ub$QjM%4Ts#DXN6;K>Cr)&&Eh1P`P`SKj*Jr7dVj>u zc?xTn$)z){5i_fW+Nu!Q{G6(-1!&d!P`+AQK)RVH!#bl&^S=xr7LgL}8m`pdARm{e+>iNW=dS+v26)J~rRW`d&c8&L)kZT~rS2k0h4vbaL zf%ndjI)5+hXc4u*iV+G4C>P3ZcwASjtmw{PifOE0XDrGy$gu94Z%5kq-^raov%AL%bW`VuwF&4l@S2?~nlK)0iCq z_!hm^l_JkGLtrSuv*h%6M(=gt9SAKlz4>4eSx0&tj31$^*zxZ5MeH1F)iG8!BA+~b zJR-gN;4;NDMOz-=f!9+<iNvhE31n50=d(h{5Q(ojftTezK@qd>yVeF}*KEWN#|W!_vdUvy>vJxZ(cq>0q_38>jb%+R0YW7p1i2AnjvYsIVT%?obN=J>Lp}62iqam|~i{-F}(MH?y%$2h&m0 z$!ta)Is!=%VaaSwSw_mjBH3cwL-pO1Md1wJ8Rxn>nHlxoBK0S~6h#Te0atTRhIO;E z>lUiKi=CcrweF^UYLw9&O4$W9@GY5q@(x9YusD8zkZCI+Cz-u11s|q1L#iEbb~dJ> z;RGq4k0j`^d%6Xu?)6Hy;8e1ywc;7yuY~H#vJB->vKL^EnXWX04pp17F>M%2K3O}P z`xVw|P!sF@a%XG%7|9wA9T#RnFIE){`)nuJRnS~0JJ>IGu{S+S7AG3~EIQWst_o`h zRXeq6Xji1zm!!oVZV1F$wa?c`K&bRfrl-v_elf1uYo?;(xtCshQ^Eo+BI5cow1~G3lMfr+ z#06-5>02y6;nYjt!)2>MbQWC5<>?$?Y+u%QtYW65uFF{D_gM|Q7eRfi6bRm?3F_~C zI>?@^4w8id>>XL(iy2+zVE?u~R7IruA&D9l=?`oP?;$dDvgvDtp=jToS$FSFHW{v42&ky?Lvm^*Mtv%(QkHzOR$`nI z+MTI&2PaFm=iW~dGlnC6`uu`ZUXxHmCMOHW%L$lO3!_7ma#O-cYOaZ>*w!VYO^iih zPw3-t&~V^twBmv@h=se?zvP$gv5Henv#rLNPL`sCv9M>1elZ;9YM|oc8&DRFM`fGG z%#7E;w7oeha!?BCfsvXRb8;5buolsSsyD-H25q`z6|d?n(guHoBmFr@rt#JO0GD)M zaEp)q@Ytm`h8v;$xL7uCieYkrwJ{No7SrwE-aS*j!y^2H~JXK|JEMFeB?{wm2 zHE~@3r#O|2v;5--NIG6F<2BFD(tO|%T!gTQ3$XaSbnPZO3^XRH)qSn|ZauoUVN>UpYk#^1N5ZLEwE`im zz8u@9kGlro9tUuPbTrB7E}5O5 zQl1gnxh08e_B-1v=y1V%sh}xo<*X7inDdv1iPHjRfCn5#m7UE(AQw$XF2yllvjz`4 zI4Ug3!pS&eYgFnn2df`XsnfFt&RZNDwJ?;$6Q3%SCvDA|J>{S%&zFTl65>;|Cd854 z5G3T#gm}h*P@534xX3)KYDng|gQnVhZ#4JtsR4M(0qiGg>tLyY@^cPKzax#TFy|1e zDYSDAo?0BwswU$ZXFv_c-sS-HtDdpF-O}Mda8UYHug8f^gR2)EyeY%Th$zBh;3X8O z{T0kKTXhwBk}PCqHWnwv@l8{ZWuj!78MFEsWiw69oWriEjVu)Nu%uD%AUBX&qN5R? z0aSN@Orw>>QR-}?fz@=dOrw>BWt>_xaM})z+Pd3APrc3{8kijiQ*C4z64MmgB?nA- z_g-N3c|n7(R~;y|Rl66IdA`tO>YWbKpcwcn47+F&T_f=n?}<;))>RMSXgodHwR|5ABeuh$RkAX7v?oWnXrY@Q zKE`aWIyhsVbTj$;ltV=sP(vd&C4EZs+8TS?Kdb!))X_;C9NTy&yOCFE~uJHBVC+AitLj#5^ixfPBRPQOeKaBy|=kYML_sssp8sxvGk; zR0@htOPOGQ;DD({ku0B>*}snLx={>sM9GlBH;9(mIFvg}NV!LxG8@S^9i~+f&<{zU zJy55W%$oi2NSMYc9C^IP#QYNn^NLRP7^3{PgRCau`bi+7Gb#3IAd}tiIH2m}M?cWs zCv6OVzw1D&4b#k1@@O=jq~}MYjk14+vbxRPD?LYcxzrx-b1vHVh!e9BsygNY%xsn4 zcj|a*1YY|cNil@-=MJ$=%B30`o27R7;pP8niBT%vT-scwcX(?Q&K0=hYn1pZb~ziDJcgclb>6L-nY%!;Iog!p(A=ul;AA;~z5j^}jCC?Tk~@b@o}aaNR&|sa)rM<>#WMtNx=v*o z>>`;x;W;X6Iq`uTrwz()cS@_(mK14wf3;cJcQ_D9g{>X2vJ5}C?V*fTsv6Vx+uUoG zo+XN=xYW?MA3$1o%!lvru6j{lC|b|Y-q>uiS#`j#!d79SJ7)g8gWqRUuu-m&7T++N zevR@kJ9J0f!fRkg4(9N?a}Ah_4ve$IRBs~Es}n5FSEy{tPW0MrYmmI0Q7rEUS_AG~ z8E{S=>|L@(>0ihwJ@f`x1Lr*%I9GGyszGWggH-;ls0Lu10XWQ7Qv>1y84!JUlp1A! zIiu`I8$=Dv4`*QJ+4yNdeIx^Fl#QGQPf{d->c#ix4gC8(&XV^I3UU&x**zknFzn- zAgK7kMG)H@g_OAtzwH$6y*o|qWHgHZj#FF(5H4+VqoM)vMF&ESFcEb-Q_Q zUXAu=>C^*j?Nr)Up;H%hYO;o^Q$LbQr9~*6`o&Z#tw!k7Z>Lge-dLx8U#IdAfu=)s z>SL1$&zwqQXr20wR4R>ebn09xl|~afby24#p|no@W1X7V#3WU3WL(}3BV#9HvcYkA z7**(dyawC+=W(Dx?w_p5jg@2d(yU+S9hLDaY{$bPbpKMfR)p%RC*w)E?XliO_rilM z8$F)R#Qmj!Io)nvqD_yxYct3lulMSuR~E%Zw{*cNQt;9XZ=1v>PqEXl-i=otV+!0# z?nSxUee~yk`ttz(yw-hBclNa|UdL?W#%baOoG(r%zp5u|`;l#T%`O|S6^#WLnY=I`LSr0DeP=P3jIujUo08Pvc+!J(Yy( zUS2*Nlq2z6>j%1c1gTQTfSHEJ&jT)=JdEqiX|kP4gd$r!g-2`Vg9c7mGQ5Wil+mi< b)${_9M?-!3wFXZe;i^ZmuK_O}%@+SZ2gksW literal 58515 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 Graph
-class celavi.costgraph.CostGraph(step_costs_file: str, fac_edges_file: str, transpo_edges_file: str, locations_file: str, routes_file: str, pathway_crit_history_filename: str, circular_components: list, component_initial_mass: float, path_dict: dict, sc_begin: List[str] = ['manufacturing'], sc_end: List[str] = ['landfilling'], sc_in_circ: List[str] = [], sc_out_circ: List[str] = [], year: float = 2000.0, start_year: float = 2000.0, verbose: int = 0, save_copy=False, save_name='netw.csv', run=0, random_state=Generator(PCG64) at 0x1B89DEBBC80)
+class celavi.costgraph.CostGraph(step_costs_file: str, fac_edges_file: str, transpo_edges_file: str, locations_file: str, routes_file: str, pathway_crit_history_filename: str, circular_components: list, component_initial_mass: float, path_dict: dict, sc_begin: List[str] = ['manufacturing'], sc_end: List[str] = ['landfilling'], sc_in_circ: List[str] = [], sc_out_circ: List[str] = [], year: float = 2000.0, start_year: float = 2000.0, verbose: int = 0, save_copy=False, save_name='netw.csv', run=0, random_state=Generator(PCG64) at 0x1DF807ABD60)

Reads in supply chain data, creates a network of processing steps and facilities in a circular supply chain, identifies preferred end-of-life pathways through the supply chain, calculates supply chain characteristics such as pathway cost.

-__init__(step_costs_file: str, fac_edges_file: str, transpo_edges_file: str, locations_file: str, routes_file: str, pathway_crit_history_filename: str, circular_components: list, component_initial_mass: float, path_dict: dict, sc_begin: List[str] = ['manufacturing'], sc_end: List[str] = ['landfilling'], sc_in_circ: List[str] = [], sc_out_circ: List[str] = [], year: float = 2000.0, start_year: float = 2000.0, verbose: int = 0, save_copy=False, save_name='netw.csv', run=0, random_state=Generator(PCG64) at 0x1B89DEBBC80)
+__init__(step_costs_file: str, fac_edges_file: str, transpo_edges_file: str, locations_file: str, routes_file: str, pathway_crit_history_filename: str, circular_components: list, component_initial_mass: float, path_dict: dict, sc_begin: List[str] = ['manufacturing'], sc_end: List[str] = ['landfilling'], sc_in_circ: List[str] = [], sc_out_circ: List[str] = [], year: float = 2000.0, start_year: float = 2000.0, verbose: int = 0, save_copy=False, save_name='netw.csv', run=0, random_state=Generator(PCG64) at 0x1DF807ABD60)

Reads in small datasets to DataFrames and stores the path to the large locations dataset for later use.

diff --git a/docs/docs/html/doc_pylcia.html b/docs/docs/html/doc_pylcia.html index 853aa96a..80e637b1 100644 --- a/docs/docs/html/doc_pylcia.html +++ b/docs/docs/html/doc_pylcia.html @@ -164,6 +164,12 @@

Python Life Cycle Inventory Analysis

+

The PyLCIA module links to the DES material model through the DES interface code. The DES interface preprocesses the incoming materials dataframe and prepares it for the LCA calculations. The interface calls on five main subcomponents of the pyLCIA module. +It calls the concrete life cycle inventory updater to check for glass fiber materials in the incoming stream. If yes, it creates a modified cement coprocessing inventory based on the amount of glass fiber present in the incoming stream. This modified inventory is then used for LCA calculations. +It calls the insitu_emission module to calculation insitu emissions. The foreground system for the study has direct emissions. To calculation those emissions, these systems are required to be scaled up based on their usage and then direct emissions derived using the scaling variables. These calculations are done using a modified LCA approach using a static inventory with just just product flows. +It calls the pylca_opt_foreground module to calculate the first set of LCA calculations only for the foreground activities. All input flows to the foreground system from the background life cycle inventory are derived based on the scale up or scale down of these processes. This module also preprocesses the inventory and allows replacement of electricity production with dynamic grid mixes from electricity capacity expansion models. +It call the pylca_opt_background module to perform the major LCA calculations of the background inventory. The final demand to the background LCI is obtained from the pylca_opt_foreground module. This module calculates the complete cradle to gate life cycle emissions for the foreground processes. +The final module used by PyLCIA is the pylca_celavi_background_postprocess which has two main functions. It combines background and foreground emissions to complete our system boundary for the life cyle analysis. Finally, it converts emissions to impact factors and prepares the results to be sent to DES for final processing and visualization.

ReEDS Data Importer

diff --git a/docs/docs/html/searchindex.js b/docs/docs/html/searchindex.js index 2cc735f8..26fe25e4 100644 --- a/docs/docs/html/searchindex.js +++ b/docs/docs/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["doc_config","doc_costgraph","doc_des","doc_diagnostic_viz","doc_preprocessing","doc_pylcia","doc_scenario","doc_uncertainty","index","main_page"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["doc_config.rst","doc_costgraph.rst","doc_des.rst","doc_diagnostic_viz.rst","doc_preprocessing.rst","doc_pylcia.rst","doc_scenario.rst","doc_uncertainty.rst","index.rst","main_page.rst"],objects:{"celavi.component":{Component:[2,1,1,""]},"celavi.component.Component":{__init__:[2,2,1,""],bol_process:[2,2,1,""],create_pathway_queue:[2,2,1,""],eol_process:[2,2,1,""],move_component_from:[2,2,1,""],move_component_to:[2,2,1,""]},"celavi.compute_locations":{ComputeLocations:[4,1,1,""]},"celavi.compute_locations.ComputeLocations":{__init__:[4,2,1,""],capacity_projections:[4,2,1,""],join_facilities:[4,2,1,""],landfill:[4,2,1,""],other_facility:[4,2,1,""],wind_power_plant:[4,2,1,""]},"celavi.costgraph":{CostGraph:[1,1,1,""]},"celavi.costgraph.CostGraph":{__init__:[1,2,1,""],all_element_combos:[1,2,1,""],build_facility_graph:[1,2,1,""],build_supplychain_graph:[1,2,1,""],choose_paths:[1,2,1,""],find_downstream:[1,2,1,""],find_nearest:[1,2,1,""],find_upstream_neighbor:[1,2,1,""],get_edges:[1,2,1,""],get_node_names:[1,2,1,""],get_nodes:[1,2,1,""],list_of_tuples:[1,2,1,""],save_costgraph_outputs:[1,2,1,""],update_costs:[1,2,1,""]},"celavi.costmethods":{CostMethods:[1,1,1,""]},"celavi.costmethods.CostMethods":{__init__:[1,2,1,""],blade_transpo:[1,2,1,""],coarse_grinding:[1,2,1,""],coarse_grinding_onsite:[1,2,1,""],coprocessing:[1,2,1,""],fine_grinding:[1,2,1,""],landfilling:[1,2,1,""],manufacturing:[1,2,1,""],rotor_teardown:[1,2,1,""],segment_transpo:[1,2,1,""],segmenting:[1,2,1,""],shred_transpo:[1,2,1,""],zero_method:[1,2,1,""]},"celavi.data_filtering":{filter_locations:[4,3,1,""],filter_routes:[4,3,1,""]},"celavi.data_manager":{Data:[4,1,1,""],LandfillLocations:[4,1,1,""],Locations:[4,1,1,""],OtherFacilityLocations:[4,1,1,""],RoutePairs:[4,1,1,""],StandardScenarios:[4,1,1,""],TechUnitLocations:[4,1,1,""],TransportationGraph:[4,1,1,""],TransportationNodeLocations:[4,1,1,""]},"celavi.data_manager.Data":{__init__:[4,2,1,""],backfill:[4,2,1,""],load:[4,2,1,""],validate:[4,2,1,""]},"celavi.data_manager.LandfillLocations":{__init__:[4,2,1,""]},"celavi.data_manager.Locations":{__init__:[4,2,1,""]},"celavi.data_manager.OtherFacilityLocations":{__init__:[4,2,1,""]},"celavi.data_manager.RoutePairs":{__init__:[4,2,1,""]},"celavi.data_manager.StandardScenarios":{__init__:[4,2,1,""]},"celavi.data_manager.TechUnitLocations":{__init__:[4,2,1,""]},"celavi.data_manager.TransportationGraph":{__init__:[4,2,1,""]},"celavi.data_manager.TransportationNodeLocations":{__init__:[4,2,1,""]},"celavi.des":{Context:[2,1,1,""]},"celavi.des.Context":{__init__:[2,2,1,""],average_total_component_mass_for_year:[2,2,1,""],cumulative_mass_for_component_in_process_at_timestep:[2,2,1,""],populate:[2,2,1,""],pylca_interface_process:[2,2,1,""],run:[2,2,1,""],timesteps_to_years:[2,2,1,""],update_cost_graph_process:[2,2,1,""],years_to_timesteps:[2,2,1,""]},"celavi.diagnostic_viz":{DiagnosticViz:[3,1,1,""]},"celavi.diagnostic_viz.DiagnosticViz":{__init__:[3,2,1,""],gather_and_melt_cumulative_histories:[3,2,1,""],generate_plots:[3,2,1,""]},"celavi.inventory":{FacilityInventory:[2,1,1,""]},"celavi.inventory.FacilityInventory":{__init__:[2,2,1,""],cumulative_history:[2,2,1,""],cumulative_input_history:[2,2,1,""],increment_quantity:[2,2,1,""],input_transaction_history:[2,2,1,""],transaction_history:[2,2,1,""]},"celavi.reeds_importer":{ReedsImporter:[5,1,1,""]},"celavi.reeds_importer.ReedsImporter":{__init__:[5,2,1,""],national_level_reeds_importer:[5,2,1,""],state_level_reeds_importer:[5,2,1,""]},"celavi.routing":{Router:[4,1,1,""]},"celavi.routing.Router":{__init__:[4,2,1,""],get_all_routes:[4,2,1,""],get_route:[4,2,1,""]},"celavi.scenario":{Scenario:[6,1,1,""]},"celavi.scenario.Scenario":{__init__:[6,2,1,""],calculate_circularity_metrics:[6,2,1,""],clear_results:[6,2,1,""],execute:[6,2,1,""],get_filepaths:[6,2,1,""],impact_and_units:[6,2,1,""],postprocess:[6,2,1,""],preprocess:[6,2,1,""],setup:[6,2,1,""],simtime:[6,2,1,""]},"celavi.transportation_tracker":{TransportationTracker:[2,1,1,""]},"celavi.transportation_tracker.TransportationTracker":{__init__:[2,2,1,""],increment_inbound_tonne_km:[2,2,1,""]},"des_interface.PylcaCelavi":{__init__:[5,2,1,""],lca_performance_improvement:[5,2,1,""],pylca_run_main:[5,2,1,""]},celavi:{component:[2,0,0,"-"],compute_locations:[4,0,0,"-"],costgraph:[1,0,0,"-"],costmethods:[1,0,0,"-"],data_filtering:[4,0,0,"-"],data_manager:[4,0,0,"-"],des:[2,0,0,"-"],diagnostic_viz:[3,0,0,"-"],inventory:[2,0,0,"-"],reeds_importer:[5,0,0,"-"],routing:[4,0,0,"-"],scenario:[6,0,0,"-"],transportation_tracker:[2,0,0,"-"]},concrete_life_cycle_inventory_editor:{concrete_life_cycle_inventory_updater:[5,3,1,""]},des_interface:{PylcaCelavi:[5,1,1,""]},insitu_emission:{electricity_corrector_before20:[5,3,1,""],model_celavi_lci_insitu:[5,3,1,""],preprocessing:[5,3,1,""],runner_insitu:[5,3,1,""],solver:[5,3,1,""]},pylca_celavi_background_postprocess:{impact_calculations:[5,3,1,""],postprocessing:[5,3,1,""]},pylca_opt_background:{model_celavi_lci_background:[5,3,1,""]},pylca_opt_foreground:{electricity_corrector_before20:[5,3,1,""],lca_runner_foreground:[5,3,1,""],preprocessing:[5,3,1,""],solver:[5,3,1,""]},uncertainty_methods:{apply_array_uncertainty:[7,3,1,""],apply_stoch_uncertainty:[7,3,1,""]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","method","Python method"],"3":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:class","2":"py:method","3":"py:function"},terms:{"0x1b89debbc80":1,"0x1e558628c80":[],"0x238cf936e40":[],"0x24ab19d5ba0":[],"30m":1,"4a8a":4,"66af71889958":4,"9bff":4,"boolean":[0,4,5],"break":5,"case":[1,2,4,8,9],"class":[1,2,3,4,5,6],"default":[0,1,2,4,5,7],"final":[3,5],"float":[0,1,2,4,5,6,7],"function":[1,2,4,5],"import":[0,8,9],"int":[1,2,3,4,5,7],"long":[1,4],"new":[0,1,2,4],"return":[1,2,3,4,5,6,7],"static":[1,4,5,6],"throw":[8,9],"true":[0,1,2,4],"try":[8,9],"var":3,"while":0,AND:1,DES:[0,1,2,3,5,6],For:[0,2,5],IDs:1,Not:0,One:0,THEN:1,The:[0,1,2,3,4,5,6,7],There:[0,2],These:[0,2,5],Use:[1,4,7],Uses:4,Using:[0,4],Will:2,__init__:[1,2,3,4,5,6],_annual_st:4,_continuous_distn:7,_cost:1,_fee:1,_nearest_facility_id:1,about:[0,1,2],absolut:3,access:[5,7],accompani:[8,9],accord:1,accumul:[0,2],across:1,activ:5,acttiv:5,actual:1,add:5,added:[1,4],addit:[0,4,6],adjust:[0,4],aeberl:4,after:[0,3,5],again:2,aggreg:4,air:4,algorithm:4,all:[0,1,2,4,5,6],all_element_combo:1,allianc:4,allow:[0,1,2,4,5],along:[1,2,5],alreadi:[0,4],also:[0,1,2,4,5],altern:0,aluminum:2,alwai:[0,2],amount:[2,5],amt:2,analysi:[0,1,4,8,9],ani:[0,1,4,5],annual:4,anoth:[5,7],anyth:2,append:5,appli:[0,1],apply_array_uncertainti:7,apply_stoch_uncertainti:7,argument:[1,2,4],arrai:[0,1,5],arrang:5,assembl:[0,6],assign:[0,2,7],associ:1,assumpt:0,attach:5,attempt:2,attribut:[1,2],author:[4,6],autodoc:5,automat:[0,6],avail:[2,4,5,7],averag:[1,2,4],average_total_component_mass_for_year:2,avgmass:0,avoid:[0,5],back:[2,5],backfil:[0,4],background:[8,9],badli:5,balanc:[],base:[0,1,4,5],baselin:1,basi:1,basic:2,becaus:[0,1,2],becom:1,been:[3,7],befor:[0,1,2,4,5],began:6,begin:[0,1,2,4],begin_lif:2,behavior:[8,9],being:[0,1,2,4,5],belong:2,below:[0,2],between:[0,1,4],bidirectional_dijkstra:4,blade:[0,2,5,8,9],blade_transpo:1,blank:0,block:0,bol:2,bol_process:2,bool:[1,2,4],both:[0,4],broadli:0,build:4,build_facility_graph:1,build_supplychain_graph:1,built:[0,1,5],bypass:[0,5],c3fec8d8:4,cach:4,calcul:[0,1,2,4,6,8,9],calculate_circularity_metr:6,calendar:[0,2,4],call:[0,1,2,4,5,6],callabl:2,cambium:4,can:[0,1,2,3,4,5],can_be_neg:2,cannot:6,capac:[0,4],capacity_project:[0,4],care:0,ceat:[],celavi:[0,1,2,3,4,5,6,7],cement:[0,1,5],central_summari:0,certain:[0,2,5],cg_updat:0,cg_verbos:0,chain:[0,1,2,4,5],chang:[0,2,4,5],characer:5,character:5,characterist:[1,4],check:[4,5,6],child:4,choic:2,choose_path:1,circul:1,circular:[0,1,4,5,6,8,9],circular_compon:[0,1],circular_pathwai:[0,1],circumst:1,citi:4,clean:[5,6],clear_result:[0,6],closest:1,closur:4,coal:0,coars:[0,1,2],coarse_grind:1,coarse_grinding_onsit:1,code:[1,2,4,5,8,9],column:[0,1,2,3,4,5],com:[1,4,9],combin:[0,4,5],come:0,comment:[1,2],compar:[0,1],compat:5,complet:[0,1,4],compon:[0,1,3,5,6,8,9],component_count:[0,3],component_counts_plot:0,component_fixed_lifetim:0,component_initial_mass:1,component_kind:2,component_list:0,component_materi:[0,2],component_material_mass:0,component_material_masses_filenam:2,component_materials_deposit:2,component_weibull_param:0,composit:[0,2],comput:[0,6,8,9],compute_loc:[0,4],computeloc:4,concret:[0,8,9],concrete_life_cycle_inventory_editor:5,concrete_life_cycle_inventory_updat:5,config:[1,4,6,7,8,9],configur:[2,8,9],conform:5,connect:[1,4],connect_to:1,consider:0,consist:2,constitu:[0,2],construct:[2,5],consum:[0,2],contain:[1,2,4,5,7],content:[0,2],context:[3,6,8,9],contigu:4,continu:5,control:[0,2,5],convers:2,convert:[1,2,5],copi:[0,8,9],coprocess:[0,1],copyright:4,core:[1,2,3],correspond:[1,2,5],cost:[2,6,8,9],cost_graph:2,cost_graph_update_interval_timestep:2,cost_uncertainti:[],costgraph:[0,1,2,6],costgraph_csv:0,costgraph_pickl:0,costmethod:1,count:[2,3],count_cumulative_histori:0,counti:[0,4],countri:4,countyfp:4,creat:[0,1,3,4,5,6],create_pathway_queu:2,crit:1,criteria:1,criterion:1,criteron:1,critic:[8,9],csv:[0,1,4,5,6],cumul:[0,1,2,3,6],cumulative_histori:2,cumulative_input_histori:2,cumulative_mass_for_component_in_process_at_timestep:2,current:[0,1,2,4,5,6,7],custom:[0,4],cut:1,cycl:[8,9],d_f:5,data:[0,1,7,8,9],data_filt:4,data_manag:4,databas:[0,4,5],datafil:0,datafram:[1,2,3,4,5,6,8,9],dataset:[0,1,2,4,5,8,9],datatyp:4,deal:[0,4],debug:[0,5],decid:1,decim:6,decis:2,decreas:2,decrement:2,default_rng:[1,7],defin:[0,1,2,4,5,7],definit:1,delet:[0,4,5],demand:5,depend:[0,1,2,4],deposit:2,dequ:2,deriv:5,des:2,des_interfac:[2,5],destin:[2,4],destination_facility_typ:4,detail:[1,5],determin:[1,2],determinist:0,develop:[0,4],df_emiss:5,df_lcia:5,df_static:5,df_with_all_other_flow:5,diagnost:[0,6,8,9],diagnostic_viz:3,diagnosticviz:3,dict:[1,2,3,4,5,7],dictionari:[0,1,2,3,5],differ:[0,1,4],digraph:1,dijkstra:4,dimension:[],direct:1,directli:[0,4],directori:[0,1,4,6],disaggreg:0,discret:[8,9],discuss:0,displac:5,dispos:1,dist:[1,2],distanc:[0,1,2,4],distance_filt:[0,4],distinguish:2,distn:7,distribut:[0,2,7],divid:1,djikstra:4,doc:[0,9],document:4,doe:[0,1,2,4,5,6,8,9],doesn:5,doing:[0,1,2],done:[0,2],down:[0,4],download:[4,8,9],downstream:[0,1],draw:[0,7],drawn:[0,7],due:5,dummi:5,durat:0,dure:[0,1,2,7],dynam:5,dynamic_lci_filenam:5,each:[0,1,2,4],eas:5,econom:1,economi:[8,9],edg:[0,1,4],edge_id:4,edit:[4,5,7],editor:[8,9],eerscmap:4,eia_id:4,either:[0,2,4,6],electr:[0,4,5],electricity_corrector_before20:5,electricity_grid_spatial_level:5,electricity_mix_level:0,element:[0,1,7],emiss:[0,4,8,9],emissions_filenam:5,emissions_inventori:0,emissions_lci:0,emissions_lci_filenam:5,emisson:5,emissons_filenam:5,empti:[2,4,5],enabl:[],end:[0,1,2,4],end_year:[0,2],energi:[2,4],enter:[0,2],entir:2,env:2,environ:2,environment:[1,5],eol:[0,2],eol_process:2,epa:4,epoxi:[0,1],equal:0,equat:[0,5],equival:1,error:[0,4],est:[8,9],etc:4,evalu:[1,5],even:0,event:[8,9],everi:[0,2,5],exactli:1,examin:0,exampl:[2,8,9],except:[2,6],execut:[0,2,3,6,8,9],exist:[0,1,4,5,6,7],exit:2,expans:4,expect:0,explan:0,explicitli:0,explor:0,extens:0,extract:[0,2],f_d:5,fac_edg:0,fac_edges_fil:1,fac_id:5,facil:[0,1,3,4,5,8,9],facility_1:[0,1],facility_2:[0,1],facility_df:1,facility_id:[1,2,4,5],facility_inventori:3,facility_loc:4,facility_typ:[0,1,2,4],facilityid:1,facilityinventori:[2,3],facilitytype_facilityid:1,factor:[0,5],fals:[0,1,2,4],faster:5,fclass:4,fee:[0,1],feedstock:4,fiber:0,file:[1,2,4,5,6,7,8,9],filenam:[0,1,3,5],filepath:[4,6],fill:0,filter:[0,8,9],filter_loc:4,filter_rout:4,filtered_locations_filenam:4,final_demand_scal:5,final_lcia_results_to_d:0,final_r:5,find:[1,2,4],find_downstream:1,find_nearest:1,find_upstream_neighbor:1,fine:[0,1,2],fine_grind:1,fine_grinding_revenu:[],fip:4,first:[0,2,4],fisher:4,fix:[0,2],flag:[4,5,8,9],flexibl:0,floor:2,flow:[2,4,5,6],follow:[0,1,2],foregound:5,foreground:[8,9],foreground_process_inventori:0,form:[2,5],format:[1,4,5],found:0,foundat:0,four:4,fpath:4,fpeam:4,fraction:[0,1,2],frame:[1,2,3,4,5],framework:[8,9],frequenc:2,fresh:[],fri:4,from:[0,1,2,3,4,5,6,7,8,9],from_facility_id:2,full:1,further:[0,2],futur:[0,4],gather:3,gather_and_melt_cumulative_histori:3,gener:[0,1,3,4],generate_plot:3,generate_step_cost:0,get_all_rout:4,get_dist:1,get_edg:1,get_filepath:6,get_nod:1,get_node_nam:1,get_rout:4,gfrp:5,github:[4,8,9],give:0,given:[1,2],glass:0,goe:2,gov:4,gradual:1,graph:[0,2,4,6,8,9],great:0,grid:[0,4,5],gride:2,grind:[0,1,2],ground:[1,5],has:[0,2,3,4,5,7],have:[0,1,2,4,5],header:4,held:2,help:4,here:[0,1,4],histor:[1,4],histori:[1,2,3,6],hold:[2,3],hous:5,how:[0,1],howev:0,html:[0,4,9],http:[0,1,4,9],human:0,identifi:[0,1,2,3,4,5],ignor:0,impact:[0,1,5,6],impact_and_unit:6,impact_calcul:5,implement:[0,4],improv:4,in_state_onli:4,in_use_facility_id:2,inbound:2,includ:[0,1,4,5],incorrect:0,incorrectli:[8,9],increas:2,increment:2,increment_inbound_tonne_km:2,increment_quant:2,index:[4,7,8,9],indic:[1,2],individu:5,industri:[0,1],inflow:[0,6],info:1,inform:[0,1,2,4,5,7],ingest:4,initi:[0,1,2,4,6],initialize_costgraph:0,input:[0,2,4,5,6,7],input_transaction_histori:2,inputs_opt:0,inputs_to_preprocess:0,insitu:[8,9],insitu_emiss:5,instal:4,instanc:[0,6,7,8,9],instantan:2,instanti:[1,2,6],instead:[0,5],integ:[0,1,2,5],intend:0,inter:1,intercept:0,interconnect:[0,1],interfac:[8,9],intermedi:4,intermediate_demand:0,intermediate_demand_filenam:5,intern:0,intra:1,inventori:[3,8,9],involv:[0,4],ioerror:6,isn:2,item_nam:2,its:[2,4],jan:4,januari:6,joblib:4,join:5,join_facil:4,keep:[0,5],keep_col:3,kei:[0,1,2,3,7],keyword:2,kilomet:1,kind:2,kwarg:4,lambda:2,landfil:[0,1,2,4],landfill_loc:[0,4],landfill_locations_no_nul:4,landfilllmopdata:0,landfillloc:4,larg:[0,1],lat:[1,4],later:[1,5],latest:[2,8,9],latitud:4,lca:[2,5],lca_db:0,lca_performance_improv:5,lca_runner_foreground:5,lci:5,lci_activity_loc:0,lcia:[0,2,5,6],lcia_des_filenam:5,lcia_facility_result:0,lcia_locations_join:0,lcia_shortcut_db:0,lcia_to_d:0,lcia_transpo_result:0,lcia_transport:0,lcia_upd:0,lcia_verbos:0,lead:0,learn:[0,1,2],leav:0,left:[0,2],length:[0,1,4],lengthen:0,lengthi:0,level:[2,4,5],life:[0,1,2,8,9],lifecycl:[2,8,9],lifespan:2,lifespan_fn:2,lifespan_timestep:2,lifetim:[0,2],like:[2,3],limit:0,line:[1,4],line_item:6,linear:[0,1],linearli:0,link:2,list1:1,list2:1,list3:1,list4:1,list:[0,1,2,3,4,5,7],list_of_tupl:1,llc:4,lmop:[0,4],load:[2,4],loc:[0,1,2],loc_filenam:4,local:0,locat:[0,1,2,5,6,8,9],location_filt:0,locations_comput:0,locations_fil:[1,4],locations_filenam:2,locations_output_fil:4,logic:1,longer:0,longitud:4,look:2,lookup_facility_typ:[0,4],lookup_step:0,lookup_step_cost:0,lookup_step_cost_method:0,lookup_transpo_cost_method:0,loop:2,loss:[0,1],machin:0,made:[0,2],mai:[0,1,2,4],main:0,manag:[0,8,9],mani:[0,2],manipul:5,manual:[0,4,5],manuf_facility_id:2,manufactur:[0,1,2],map:2,mass:[0,1,2,5,6],mass_cumulative_histori:0,mass_kg:2,mass_tonn:2,materi:[0,1,2,3,4,5],material_mass:0,material_mass_plot:0,matrix:5,max:0,max_timestep:2,maximum:2,mean:[8,9],mechan:1,memori:4,memory_map:4,merg:[4,5],methan:[0,4],method:[0,2,3,4,5,6,8,9],metric:[1,6],midpoint:[],min_lifespan:0,min_year:2,minimum:[0,4],minu:1,miscellan:4,mix:[0,4,5,6],model:[1,2,3,4,5,6,7,8,9],model_celavi_lci_background:5,model_celavi_lci_insitu:5,model_run:[0,2],modif:1,modifi:[2,5],modul:[0,4,8,9],monthli:2,more:[0,2,4],most:[0,2],move:[0,2,6],move_component_from:2,move_component_to:2,much:[0,1],multi:0,multipl:[0,1,6],murrai:1,must:[0,1,2,4,5,7],nacel:[0,2],name:[0,1,2,3,4,5,6,7],nan:4,nation:[0,1,5],national_dynamic_grid_mix:0,national_electricity_lci:0,national_level_grid_mix:0,national_level_reeds_import:5,national_reeds_grid_mix:0,nearest:[1,2],necessari:[5,6],necessarili:2,need:[0,4,5,7],neg:[0,2],neighbor:1,net:1,netw:[0,1],network:[1,4],networkx:1,newli:[],next:[0,1],next_step:1,noah:4,node:[1,4],node_id:[1,4],node_loc:[0,4],node_map:4,node_nam:1,non:5,none:[1,2,4,5],normal:[0,8,9],note:[0,2,4,5,8,9],nrel:[4,9],number:[0,1,2,3,4,5,6,7],number_of_technology_unit:[0,4],numer:7,numpi:5,obj:0,object:[0,1,2,5,6,7],obtain:4,occur:[0,5],old:[5,6],onc:[0,2,7],one:[0,1,2,3,4,6,7],onli:[0,2,4,5],ons_mw:4,onsit:[0,1],onto:1,open:6,oper:[4,5],optim:[8,9],option:[0,1,2,5],org:[0,9],origin:[1,4],other:[0,1,2,4,7],other_facil:4,other_facility_loc:[0,4],other_facility_locations_all_u:0,otherfacilityloc:4,otherwis:[0,4],out:[0,2],outflow:[0,6],output:[0,1,4,5],output_plot_filenam:3,outreach:[0,4],outsid:[0,1,4],over:[1,2,4],overwrit:[0,4],overwritten:0,p_cap:4,p_name:4,p_tnum:4,p_year:4,page:[8,9],pair:[0,4,7],panda:[1,2,3,4,5,6,8,9],paramet:[0,1,2,3,4,5,6,7],parent:4,parser:6,part:2,particular:[0,1,2,5],pass:[0,1,2,5,7],past:4,path:[1,2,3,4,5,6],path_dict:[2,8,9],path_split:[0,1],pathwai:[1,2],pathway_crit_history_filenam:1,pathway_criterion_histori:0,pcg64:1,per:[0,1,2,3],perform:[0,1,4,5],period:[0,2],permanent_lifespan_facil:[0,1],phase:0,physic:2,pickl:[0,5],pickle_costgraph:0,place:[2,5],plant:[0,1,2,4],pleas:[5,8,9],plot:3,plu:1,png:0,point:[2,4,6],pollut:5,popul:[0,2],posit:2,possibl:[0,1,2,3],possible_compon:2,possible_item:2,possible_materi:2,post:[5,6],postprocess:[1,6,8,9],power:[0,1,2,4],power_plant_loc:[0,4],pre:[0,5],precomput:0,predict:2,prefer:1,preprocess:[0,5,6,8,9],previou:[0,5],previous:[4,5],print:[0,2,5],probabl:[0,2],problem:5,procedur:2,process:[0,1,2,4,5,6],process_df:5,process_emissions_corr:0,process_nam:2,process_names_add:0,produc:[0,4],product:[0,4,5],product_df:5,program:[0,4],programmat:0,progress:5,project:[0,4],pron:[8,9],proper:5,properli:5,properti:2,provid:[0,1,2,4,5,6,7],proxi:1,purpos:5,pydata:9,pylca:5,pylca_celavi:2,pylca_celavi_background_postprocess:5,pylca_interface_process:2,pylca_opt_background:5,pylca_opt_foreground:5,pylca_run_main:5,pylcacelavi:[2,5],pylcia:[2,5,6],python:[0,2,8,9],qualiti:[],quality_check:[],quantifi:[0,6],quantiti:[1,2,5,7],quantity_unit:2,queri:[1,2],question:1,queue:2,rais:[2,6],random:[0,1,7],random_st:1,rang:[0,7],rapidli:[],rate:[0,1,5],rather:[0,2],raw:[0,4],reach:2,read:[0,1,4,5,6],read_tabl:4,readabl:0,readi:4,receiv:[],recent:0,recircul:0,recommend:0,record:[2,6],recycl:[1,2],reduc:[0,1],reed:[4,8,9],reeds_import:5,reeds_imported_filenam:5,reeds_output_filenam:5,reedsimport:5,refer:0,region:[0,1,4],region_id_1:[1,4],region_id_2:[0,1,4],region_id_3:[1,4],region_id_4:[1,4],region_transport:4,releas:[8,9],relev:[1,5,7],remain:[0,4],remaind:4,remov:[0,1,4,5,6],renam:5,renew:[2,4],repeat:0,repeatedli:0,replac:[4,5],report:5,repositori:[8,9],repres:[0,1,2,7],represent:[1,4],reproduc:[0,7],requir:[0,4,5],res2:5,res:5,res_df:5,reset:[5,6],resolut:2,resourc:[0,2],result:[0,2,5,6],results_tot:5,reult:[],reusabl:1,revenu:[0,1],rhane:6,road:[0,4],rotor:[0,1],rotor_teardown:1,round:2,rout:[0,1,2,4,5,6],route_id:[1,2,5],route_pair:0,route_pair_fil:4,routepair:4,router:[0,8,9],routes_comput:0,routes_custom:0,routes_fil:1,routes_filenam:4,routes_output_fil:4,routing_output_fold:4,row:[1,2,4],run:[0,1,2,3,5,6,7,8,9],run_rout:0,runner:[],runner_insitu:5,sale:1,same:[0,1,2,4],sampl:2,sand:0,save:[0,1,4,6],save_cg_csv:0,save_copi:1,save_costgraph_output:1,save_nam:1,sc_begin:[0,1],sc_end:[0,1],sc_in_circ:[0,1],sc_out_circ:[0,1],scalar:0,scale:[0,1,5],scenario:[1,2,3,4,7,8,9],scipi:[0,7],scope:[],search:[8,9],second:4,secondari:0,section:[0,1],see:[0,2,4],seed:[0,1,7],segment:[0,1],segment_transpo:1,select:2,self:[2,5],sell:1,sent:0,separ:[0,1,6],sequenc:2,seri:[5,8,9],set:[0,1,2,4,6,8,9],setup:6,sever:0,shortcut:5,shortcutlca_filenam:5,shorten:0,shortest:1,should:[0,1,2],shred:[0,1],shred_transpo:1,sign:2,signific:5,similar:2,simpi:2,simtim:6,simul:[0,1,4,6,8,9],simultan:0,sinc:[2,6],singl:[0,1,4,6,7],site:1,slice:[8,9],slope:0,small:1,solv:5,solver:5,solver_optim:[],some:0,sourc:[1,4],source_facility_typ:4,space:0,span:2,sparingli:2,spatial:5,specif:[0,1,4,5],specifi:[0,1,2,4,6],speed:0,spend:2,split:0,sqlite:4,stabl:0,stackoverflow:1,stage:[2,5],standard:[1,4],standard_scenarios_filenam:4,standardscenario:4,start:[1,2,3,4],start_year:[0,1,3,4],starttim:6,stat:[0,7],stata:[],state:[0,2,4,5,7],state_dynamic_grid_mix:0,state_electricity_lci:0,state_level_grid_mix:0,state_level_reeds_import:5,state_reeds_grid_mix:0,statefp:4,statement:[2,5],states_includ:0,static_filenam:5,static_lci:0,static_lci_filenam:5,statu:4,steel:0,step:[0,1,2,4,6],step_cost:[0,2],step_cost_method:[0,1],step_costs_custom:0,step_costs_default:0,step_costs_fil:1,step_costs_filenam:2,stochast:0,stock:5,stock_filenam:[0,5],stop:1,storag:[0,5],store:[0,1,2,5,7],str:[1,2,3,4,5,6],stream:0,string:[0,1,2,4,6],strongli:0,structur:[0,2,7,8,9],stscen20a_midcase_annual_st:0,studi:[1,2,4,8,9],sub:[0,6],subgraph_step:1,subsequ:2,subset:4,substanc:6,substitut:[0,5],substitution_r:[0,5],suffici:0,sum:[1,2],superstructur:1,supplement:5,suppli:[0,1,2,4,5],suppoet:[],suppress:5,sustain:4,system:5,t_cap:4,t_counti:4,t_fip:4,t_model:4,t_state:4,tabl:2,take:[0,1,2,5],taken:0,target:1,teardown:[0,1],tech:5,tech_matrix:5,tech_matrix_corr:0,tech_units_filenam:4,techno:1,technolog:[0,1,2,3,4,5,6],technology_compon:0,technology_data:0,technology_data_filenam:4,techunitloc:4,templat:[8,9],termin:[1,4],text:4,than:[0,1,4],thei:[0,3],them:0,thermoplast:1,thermoset:1,thi:[0,1,2,3,4,5,7,8,9],third:1,three:[0,1],through:[1,2,4,5],throughout:1,thrown:0,thu:[0,2],thw:6,time:[0,1,2,4,5,6],timeout:2,timestamp:[0,6],timestep:[0,2,3],timesteps_per_year:[0,2,3],timesteps_to_year:2,tip:[0,1],togeth:[3,6],toggl:[2,5],ton:1,tonn:[1,2,3],tonne_km:2,top:0,total:[1,2,5],tower:0,traci21:0,traci:5,traci_lci:0,traci_lci_filenam:5,track:[2,5],tracker:[8,9],transact:2,transaction_histori:2,transit:2,translat:[2,7],transpo:[0,1],transpo_cost_method:0,transpo_edg:0,transpo_edges_fil:1,transport:[0,1,4,5,8,9],transportation_graph:[0,4],transportation_track:2,transportationgraph:4,transportationnodeloc:4,transportationtrack:2,travel:4,triang_gen:7,triangular:[0,7],truck:1,tupl:[1,6],turbin:[0,1,4],turbineloc:4,two:[0,1],type:[0,1,2,3,4,5,6,7],typic:[0,2],u_edg:1,u_of_edg:4,uncertain:1,uncertainti:[1,3,6,8,9],uncertainty_method:7,under:[0,1,7],underli:[0,4],unequ:0,unfilt:4,union:1,uniqu:[1,2,4,5],unit:[0,1,2,3,4,5,6],unless:0,unmodifi:4,unrealist:0,unspecifi:2,until:2,updat:[0,1,2,5],update_cost:1,update_cost_graph_process:2,upstream:1,usd:[0,1],use:[0,1,2,4,5,7],use_computed_rout:0,use_fixed_lifetim:0,use_lcia_shortcut:0,use_shortcut_lca_calcul:5,used:[0,1,2,4,5,7],useful:[0,2],user:[0,1,4,6],uses:[0,1,2,4],usg:4,using:[0,1,4,5],uslci:5,uslci_emiss:0,uslci_emission_filenam:5,uslci_filenam:5,uslci_process_add:0,uslci_process_filenam:5,uslci_tech:0,uslci_tech_filenam:5,usnrellci_processesv2017_loc_debug:[],uswtdb:4,uswtdb_v4_1_20210721:0,uuid:[2,5],v_edg:1,v_of_edg:4,valid:[4,6],valu:[0,1,2,3,4,5,7,8,9],value_nam:3,var_nam:3,vari:[0,1,2],variabl:[1,5,8,9],variat:4,variou:[],vector:5,verbos:[1,2,5],version:[0,1],vertic:4,vie:[8,9],viewabl:4,virgin:2,visit:[8,9],visual:[0,6,8,9],vkmt:[0,1,4],vkmt_max:[0,4],wai:[2,3],want:[0,2],warn:[0,8,9],weibul:[0,2],weight:4,well:[0,1,7],what:2,whatev:[0,1],when:[0,1,2,4,7,8,9],where:[0,1,2,3,4,5],whether:[0,1],which:[0,1,2,5],wih:5,wind:[0,4,8,9],wind_plant_loc:4,wind_power_pl:4,withdraw:2,withdrawn:2,within:[0,1,2,3,4,5,6],without:[0,5],word:6,work:[1,2,4],would:0,written:[0,1],www:4,xlong:4,yaml:0,year:[0,1,2,3,4,5],years_to_timestep:2,yet:0,ylat:4,you:[0,2],your:[0,2],zero:[1,2,5],zero_method:1},titles:["Configuration Files","Cost Graph","Discrete Event Simulation","Postprocessing and Diagnostic Visualizations","Data Preprocessing","Python Life Cycle Inventory Analysis","Scenario","Uncertainty Methods","Welcome to CELAVI\u2019s documentation!","Welcome to CELAVI\u2019s documentation!"],titleterms:{"case":0,"import":5,analysi:5,background:5,blade:1,calcul:5,celavi:[8,9],compon:2,comput:4,concret:5,config:0,configur:0,context:2,cost:[0,1],critic:2,cycl:5,data:[4,5],diagnost:3,discret:[2,5],document:[8,9],editor:5,emiss:5,event:[2,5],exampl:0,facil:2,file:0,filter:4,flag:0,foreground:5,graph:1,indic:[8,9],insitu:5,instanc:2,interfac:5,inventori:[2,5],life:5,locat:4,manag:4,method:[1,7],model:0,optim:5,path_dict:1,postprocess:[3,5],preprocess:4,python:5,reed:5,router:4,scenario:[0,6],simul:[2,5],structur:1,studi:0,tabl:[8,9],templat:0,tracker:2,transport:2,uncertainti:[0,7],variabl:2,visual:3,welcom:[8,9],wind:1}}) \ No newline at end of file +Search.setIndex({docnames:["doc_config","doc_costgraph","doc_des","doc_diagnostic_viz","doc_preprocessing","doc_pylcia","doc_scenario","doc_uncertainty","index","main_page"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["doc_config.rst","doc_costgraph.rst","doc_des.rst","doc_diagnostic_viz.rst","doc_preprocessing.rst","doc_pylcia.rst","doc_scenario.rst","doc_uncertainty.rst","index.rst","main_page.rst"],objects:{"celavi.component":{Component:[2,1,1,""]},"celavi.component.Component":{__init__:[2,2,1,""],bol_process:[2,2,1,""],create_pathway_queue:[2,2,1,""],eol_process:[2,2,1,""],move_component_from:[2,2,1,""],move_component_to:[2,2,1,""]},"celavi.compute_locations":{ComputeLocations:[4,1,1,""]},"celavi.compute_locations.ComputeLocations":{__init__:[4,2,1,""],capacity_projections:[4,2,1,""],join_facilities:[4,2,1,""],landfill:[4,2,1,""],other_facility:[4,2,1,""],wind_power_plant:[4,2,1,""]},"celavi.costgraph":{CostGraph:[1,1,1,""]},"celavi.costgraph.CostGraph":{__init__:[1,2,1,""],all_element_combos:[1,2,1,""],build_facility_graph:[1,2,1,""],build_supplychain_graph:[1,2,1,""],choose_paths:[1,2,1,""],find_downstream:[1,2,1,""],find_nearest:[1,2,1,""],find_upstream_neighbor:[1,2,1,""],get_edges:[1,2,1,""],get_node_names:[1,2,1,""],get_nodes:[1,2,1,""],list_of_tuples:[1,2,1,""],save_costgraph_outputs:[1,2,1,""],update_costs:[1,2,1,""]},"celavi.costmethods":{CostMethods:[1,1,1,""]},"celavi.costmethods.CostMethods":{__init__:[1,2,1,""],blade_transpo:[1,2,1,""],coarse_grinding:[1,2,1,""],coarse_grinding_onsite:[1,2,1,""],coprocessing:[1,2,1,""],fine_grinding:[1,2,1,""],landfilling:[1,2,1,""],manufacturing:[1,2,1,""],rotor_teardown:[1,2,1,""],segment_transpo:[1,2,1,""],segmenting:[1,2,1,""],shred_transpo:[1,2,1,""],zero_method:[1,2,1,""]},"celavi.data_filtering":{filter_locations:[4,3,1,""],filter_routes:[4,3,1,""]},"celavi.data_manager":{Data:[4,1,1,""],LandfillLocations:[4,1,1,""],Locations:[4,1,1,""],OtherFacilityLocations:[4,1,1,""],RoutePairs:[4,1,1,""],StandardScenarios:[4,1,1,""],TechUnitLocations:[4,1,1,""],TransportationGraph:[4,1,1,""],TransportationNodeLocations:[4,1,1,""]},"celavi.data_manager.Data":{__init__:[4,2,1,""],backfill:[4,2,1,""],load:[4,2,1,""],validate:[4,2,1,""]},"celavi.data_manager.LandfillLocations":{__init__:[4,2,1,""]},"celavi.data_manager.Locations":{__init__:[4,2,1,""]},"celavi.data_manager.OtherFacilityLocations":{__init__:[4,2,1,""]},"celavi.data_manager.RoutePairs":{__init__:[4,2,1,""]},"celavi.data_manager.StandardScenarios":{__init__:[4,2,1,""]},"celavi.data_manager.TechUnitLocations":{__init__:[4,2,1,""]},"celavi.data_manager.TransportationGraph":{__init__:[4,2,1,""]},"celavi.data_manager.TransportationNodeLocations":{__init__:[4,2,1,""]},"celavi.des":{Context:[2,1,1,""]},"celavi.des.Context":{__init__:[2,2,1,""],average_total_component_mass_for_year:[2,2,1,""],cumulative_mass_for_component_in_process_at_timestep:[2,2,1,""],populate:[2,2,1,""],pylca_interface_process:[2,2,1,""],run:[2,2,1,""],timesteps_to_years:[2,2,1,""],update_cost_graph_process:[2,2,1,""],years_to_timesteps:[2,2,1,""]},"celavi.diagnostic_viz":{DiagnosticViz:[3,1,1,""]},"celavi.diagnostic_viz.DiagnosticViz":{__init__:[3,2,1,""],gather_and_melt_cumulative_histories:[3,2,1,""],generate_plots:[3,2,1,""]},"celavi.inventory":{FacilityInventory:[2,1,1,""]},"celavi.inventory.FacilityInventory":{__init__:[2,2,1,""],cumulative_history:[2,2,1,""],cumulative_input_history:[2,2,1,""],increment_quantity:[2,2,1,""],input_transaction_history:[2,2,1,""],transaction_history:[2,2,1,""]},"celavi.reeds_importer":{ReedsImporter:[5,1,1,""]},"celavi.reeds_importer.ReedsImporter":{__init__:[5,2,1,""],national_level_reeds_importer:[5,2,1,""],state_level_reeds_importer:[5,2,1,""]},"celavi.routing":{Router:[4,1,1,""]},"celavi.routing.Router":{__init__:[4,2,1,""],get_all_routes:[4,2,1,""],get_route:[4,2,1,""]},"celavi.scenario":{Scenario:[6,1,1,""]},"celavi.scenario.Scenario":{__init__:[6,2,1,""],calculate_circularity_metrics:[6,2,1,""],clear_results:[6,2,1,""],execute:[6,2,1,""],get_filepaths:[6,2,1,""],impact_and_units:[6,2,1,""],postprocess:[6,2,1,""],preprocess:[6,2,1,""],setup:[6,2,1,""],simtime:[6,2,1,""]},"celavi.transportation_tracker":{TransportationTracker:[2,1,1,""]},"celavi.transportation_tracker.TransportationTracker":{__init__:[2,2,1,""],increment_inbound_tonne_km:[2,2,1,""]},"des_interface.PylcaCelavi":{__init__:[5,2,1,""],lca_performance_improvement:[5,2,1,""],pylca_run_main:[5,2,1,""]},celavi:{component:[2,0,0,"-"],compute_locations:[4,0,0,"-"],costgraph:[1,0,0,"-"],costmethods:[1,0,0,"-"],data_filtering:[4,0,0,"-"],data_manager:[4,0,0,"-"],des:[2,0,0,"-"],diagnostic_viz:[3,0,0,"-"],inventory:[2,0,0,"-"],reeds_importer:[5,0,0,"-"],routing:[4,0,0,"-"],scenario:[6,0,0,"-"],transportation_tracker:[2,0,0,"-"]},concrete_life_cycle_inventory_editor:{concrete_life_cycle_inventory_updater:[5,3,1,""]},des_interface:{PylcaCelavi:[5,1,1,""]},insitu_emission:{electricity_corrector_before20:[5,3,1,""],model_celavi_lci_insitu:[5,3,1,""],preprocessing:[5,3,1,""],runner_insitu:[5,3,1,""],solver:[5,3,1,""]},pylca_celavi_background_postprocess:{impact_calculations:[5,3,1,""],postprocessing:[5,3,1,""]},pylca_opt_background:{model_celavi_lci_background:[5,3,1,""]},pylca_opt_foreground:{electricity_corrector_before20:[5,3,1,""],lca_runner_foreground:[5,3,1,""],preprocessing:[5,3,1,""],solver:[5,3,1,""]},uncertainty_methods:{apply_array_uncertainty:[7,3,1,""],apply_stoch_uncertainty:[7,3,1,""]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","method","Python method"],"3":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:class","2":"py:method","3":"py:function"},terms:{"0x1b89debbc80":[],"0x1df807abd60":1,"0x1e558628c80":[],"0x238cf936e40":[],"0x24ab19d5ba0":[],"30m":1,"4a8a":4,"66af71889958":4,"9bff":4,"boolean":[0,4,5],"break":5,"case":[1,2,4,8,9],"class":[1,2,3,4,5,6],"default":[0,1,2,4,5,7],"final":[3,5],"float":[0,1,2,4,5,6,7],"function":[1,2,4,5],"import":[0,8,9],"int":[1,2,3,4,5,7],"long":[1,4],"new":[0,1,2,4],"return":[1,2,3,4,5,6,7],"static":[1,4,5,6],"throw":[8,9],"true":[0,1,2,4],"try":[8,9],"var":3,"while":0,AND:1,DES:[0,1,2,3,5,6],For:[0,2,5],IDs:1,Not:0,One:0,THEN:1,The:[0,1,2,3,4,5,6,7],There:[0,2],These:[0,2,5],Use:[1,4,7],Uses:4,Using:[0,4],Will:2,__init__:[1,2,3,4,5,6],_annual_st:4,_continuous_distn:7,_cost:1,_fee:1,_nearest_facility_id:1,about:[0,1,2],absolut:3,access:[5,7],accompani:[8,9],accord:1,accumul:[0,2],across:1,activ:5,acttiv:5,actual:1,add:5,added:[1,4],addit:[0,4,6],adjust:[0,4],aeberl:4,after:[0,3,5],again:2,aggreg:4,air:4,algorithm:4,all:[0,1,2,4,5,6],all_element_combo:1,allianc:4,allow:[0,1,2,4,5],along:[1,2,5],alreadi:[0,4],also:[0,1,2,4,5],altern:0,aluminum:2,alwai:[0,2],amount:[2,5],amt:2,analysi:[0,1,4,8,9],ani:[0,1,4,5],annual:4,anoth:[5,7],anyth:2,append:5,appli:[0,1],apply_array_uncertainti:7,apply_stoch_uncertainti:7,approach:5,argument:[1,2,4],arrai:[0,1,5],arrang:5,assembl:[0,6],assign:[0,2,7],associ:1,assumpt:0,attach:5,attempt:2,attribut:[1,2],author:[4,6],autodoc:5,automat:[0,6],avail:[2,4,5,7],averag:[1,2,4],average_total_component_mass_for_year:2,avgmass:0,avoid:[0,5],back:[2,5],backfil:[0,4],background:[8,9],badli:5,balanc:[],base:[0,1,4,5],baselin:1,basi:1,basic:2,becaus:[0,1,2],becom:1,been:[3,7],befor:[0,1,2,4,5],began:6,begin:[0,1,2,4],begin_lif:2,behavior:[8,9],being:[0,1,2,4,5],belong:2,below:[0,2],between:[0,1,4],bidirectional_dijkstra:4,blade:[0,2,5,8,9],blade_transpo:1,blank:0,block:0,bol:2,bol_process:2,bool:[1,2,4],both:[0,4],boundari:5,broadli:0,build:4,build_facility_graph:1,build_supplychain_graph:1,built:[0,1,5],bypass:[0,5],c3fec8d8:4,cach:4,calcul:[0,1,2,4,6,8,9],calculate_circularity_metr:6,calendar:[0,2,4],call:[0,1,2,4,5,6],callabl:2,cambium:4,can:[0,1,2,3,4,5],can_be_neg:2,cannot:6,capac:[0,4,5],capacity_project:[0,4],care:0,ceat:[],celavi:[0,1,2,3,4,5,6,7],cement:[0,1,5],central_summari:0,certain:[0,2,5],cg_updat:0,cg_verbos:0,chain:[0,1,2,4,5],chang:[0,2,4,5],characer:5,character:5,characterist:[1,4],check:[4,5,6],child:4,choic:2,choose_path:1,circul:1,circular:[0,1,4,5,6,8,9],circular_compon:[0,1],circular_pathwai:[0,1],circumst:1,citi:4,clean:[5,6],clear_result:[0,6],closest:1,closur:4,coal:0,coars:[0,1,2],coarse_grind:1,coarse_grinding_onsit:1,code:[1,2,4,5,8,9],column:[0,1,2,3,4,5],com:[1,4,9],combin:[0,4,5],come:0,comment:[1,2],compar:[0,1],compat:5,complet:[0,1,4,5],compon:[0,1,3,5,6,8,9],component_count:[0,3],component_counts_plot:0,component_fixed_lifetim:0,component_initial_mass:1,component_kind:2,component_list:0,component_materi:[0,2],component_material_mass:0,component_material_masses_filenam:2,component_materials_deposit:2,component_weibull_param:0,composit:[0,2],comput:[0,6,8,9],compute_loc:[0,4],computeloc:4,concret:[0,8,9],concrete_life_cycle_inventory_editor:5,concrete_life_cycle_inventory_updat:5,config:[1,4,6,7,8,9],configur:[2,8,9],conform:5,connect:[1,4],connect_to:1,consider:0,consist:2,constitu:[0,2],construct:[2,5],consum:[0,2],contain:[1,2,4,5,7],content:[0,2],context:[3,6,8,9],contigu:4,continu:5,control:[0,2,5],convers:2,convert:[1,2,5],copi:[0,8,9],coprocess:[0,1,5],copyright:4,core:[1,2,3],correspond:[1,2,5],cost:[2,6,8,9],cost_graph:2,cost_graph_update_interval_timestep:2,cost_uncertainti:[],costgraph:[0,1,2,6],costgraph_csv:0,costgraph_pickl:0,costmethod:1,count:[2,3],count_cumulative_histori:0,counti:[0,4],countri:4,countyfp:4,cradl:5,creat:[0,1,3,4,5,6],create_pathway_queu:2,crit:1,criteria:1,criterion:1,criteron:1,critic:[8,9],csv:[0,1,4,5,6],cumul:[0,1,2,3,6],cumulative_histori:2,cumulative_input_histori:2,cumulative_mass_for_component_in_process_at_timestep:2,current:[0,1,2,4,5,6,7],custom:[0,4],cut:1,cycl:[8,9],cyle:5,d_f:5,data:[0,1,7,8,9],data_filt:4,data_manag:4,databas:[0,4,5],datafil:0,datafram:[1,2,3,4,5,6,8,9],dataset:[0,1,2,4,5,8,9],datatyp:4,deal:[0,4],debug:[0,5],decid:1,decim:6,decis:2,decreas:2,decrement:2,default_rng:[1,7],defin:[0,1,2,4,5,7],definit:1,delet:[0,4,5],demand:5,depend:[0,1,2,4],deposit:2,dequ:2,deriv:5,des:2,des_interfac:[2,5],destin:[2,4],destination_facility_typ:4,detail:[1,5],determin:[1,2],determinist:0,develop:[0,4],df_emiss:5,df_lcia:5,df_static:5,df_with_all_other_flow:5,diagnost:[0,6,8,9],diagnostic_viz:3,diagnosticviz:3,dict:[1,2,3,4,5,7],dictionari:[0,1,2,3,5],differ:[0,1,4],digraph:1,dijkstra:4,dimension:[],direct:[1,5],directli:[0,4],directori:[0,1,4,6],disaggreg:0,discret:[8,9],discuss:0,displac:5,dispos:1,dist:[1,2],distanc:[0,1,2,4],distance_filt:[0,4],distinguish:2,distn:7,distribut:[0,2,7],divid:1,djikstra:4,doc:[0,9],document:4,doe:[0,1,2,4,5,6,8,9],doesn:5,doing:[0,1,2],done:[0,2,5],down:[0,4,5],download:[4,8,9],downstream:[0,1],draw:[0,7],drawn:[0,7],due:5,dummi:5,durat:0,dure:[0,1,2,7],dynam:5,dynamic_lci_filenam:5,each:[0,1,2,4],eas:5,econom:1,economi:[8,9],edg:[0,1,4],edge_id:4,edit:[4,5,7],editor:[8,9],eerscmap:4,eia_id:4,either:[0,2,4,6],electr:[0,4,5],electricity_corrector_before20:5,electricity_grid_spatial_level:5,electricity_mix_level:0,element:[0,1,7],emiss:[0,4,8,9],emissions_filenam:5,emissions_inventori:0,emissions_lci:0,emissions_lci_filenam:5,emisson:5,emissons_filenam:5,empti:[2,4,5],enabl:[],end:[0,1,2,4],end_year:[0,2],energi:[2,4],enter:[0,2],entir:2,env:2,environ:2,environment:[1,5],eol:[0,2],eol_process:2,epa:4,epoxi:[0,1],equal:0,equat:[0,5],equival:1,error:[0,4],est:[8,9],etc:4,evalu:[1,5],even:0,event:[8,9],everi:[0,2,5],exactli:1,examin:0,exampl:[2,8,9],except:[2,6],execut:[0,2,3,6,8,9],exist:[0,1,4,5,6,7],exit:2,expans:[4,5],expect:0,explan:0,explicitli:0,explor:0,extens:0,extract:[0,2],f_d:5,fac_edg:0,fac_edges_fil:1,fac_id:5,facil:[0,1,3,4,5,8,9],facility_1:[0,1],facility_2:[0,1],facility_df:1,facility_id:[1,2,4,5],facility_inventori:3,facility_loc:4,facility_typ:[0,1,2,4],facilityid:1,facilityinventori:[2,3],facilitytype_facilityid:1,factor:[0,5],fals:[0,1,2,4],faster:5,fclass:4,fee:[0,1],feedstock:4,fiber:[0,5],file:[1,2,4,5,6,7,8,9],filenam:[0,1,3,5],filepath:[4,6],fill:0,filter:[0,8,9],filter_loc:4,filter_rout:4,filtered_locations_filenam:4,final_demand_scal:5,final_lcia_results_to_d:0,final_r:5,find:[1,2,4],find_downstream:1,find_nearest:1,find_upstream_neighbor:1,fine:[0,1,2],fine_grind:1,fine_grinding_revenu:[],fip:4,first:[0,2,4,5],fisher:4,five:5,fix:[0,2],flag:[4,5,8,9],flexibl:0,floor:2,flow:[2,4,5,6],follow:[0,1,2],foregound:5,foreground:[8,9],foreground_process_inventori:0,form:[2,5],format:[1,4,5],found:0,foundat:0,four:4,fpath:4,fpeam:4,fraction:[0,1,2],frame:[1,2,3,4,5],framework:[8,9],frequenc:2,fresh:[],fri:4,from:[0,1,2,3,4,5,6,7,8,9],from_facility_id:2,full:1,further:[0,2],futur:[0,4],gate:5,gather:3,gather_and_melt_cumulative_histori:3,gener:[0,1,3,4],generate_plot:3,generate_step_cost:0,get_all_rout:4,get_dist:1,get_edg:1,get_filepath:6,get_nod:1,get_node_nam:1,get_rout:4,gfrp:5,github:[4,8,9],give:0,given:[1,2],glass:[0,5],goe:2,gov:4,gradual:1,graph:[0,2,4,6,8,9],great:0,grid:[0,4,5],gride:2,grind:[0,1,2],ground:[1,5],has:[0,2,3,4,5,7],have:[0,1,2,4,5],header:4,held:2,help:4,here:[0,1,4],histor:[1,4],histori:[1,2,3,6],hold:[2,3],hous:5,how:[0,1],howev:0,html:[0,4,9],http:[0,1,4,9],human:0,identifi:[0,1,2,3,4,5],ignor:0,impact:[0,1,5,6],impact_and_unit:6,impact_calcul:5,implement:[0,4],improv:4,in_state_onli:4,in_use_facility_id:2,inbound:2,includ:[0,1,4,5],incom:5,incorrect:0,incorrectli:[8,9],increas:2,increment:2,increment_inbound_tonne_km:2,increment_quant:2,index:[4,7,8,9],indic:[1,2],individu:5,industri:[0,1],inflow:[0,6],info:1,inform:[0,1,2,4,5,7],ingest:4,initi:[0,1,2,4,6],initialize_costgraph:0,input:[0,2,4,5,6,7],input_transaction_histori:2,inputs_opt:0,inputs_to_preprocess:0,insitu:[8,9],insitu_emiss:5,instal:4,instanc:[0,6,7,8,9],instantan:2,instanti:[1,2,6],instead:[0,5],integ:[0,1,2,5],intend:0,inter:1,intercept:0,interconnect:[0,1],interfac:[8,9],intermedi:4,intermediate_demand:0,intermediate_demand_filenam:5,intern:0,intra:1,inventori:[3,8,9],involv:[0,4],ioerror:6,isn:2,item_nam:2,its:[2,4],jan:4,januari:6,joblib:4,join:5,join_facil:4,just:5,keep:[0,5],keep_col:3,kei:[0,1,2,3,7],keyword:2,kilomet:1,kind:2,kwarg:4,lambda:2,landfil:[0,1,2,4],landfill_loc:[0,4],landfill_locations_no_nul:4,landfilllmopdata:0,landfillloc:4,larg:[0,1],lat:[1,4],later:[1,5],latest:[2,8,9],latitud:4,lca:[2,5],lca_db:0,lca_performance_improv:5,lca_runner_foreground:5,lci:5,lci_activity_loc:0,lcia:[0,2,5,6],lcia_des_filenam:5,lcia_facility_result:0,lcia_locations_join:0,lcia_shortcut_db:0,lcia_to_d:0,lcia_transpo_result:0,lcia_transport:0,lcia_upd:0,lcia_verbos:0,lead:0,learn:[0,1,2],leav:0,left:[0,2],length:[0,1,4],lengthen:0,lengthi:0,level:[2,4,5],life:[0,1,2,8,9],lifecycl:[2,8,9],lifespan:2,lifespan_fn:2,lifespan_timestep:2,lifetim:[0,2],like:[2,3],limit:0,line:[1,4],line_item:6,linear:[0,1],linearli:0,link:[2,5],list1:1,list2:1,list3:1,list4:1,list:[0,1,2,3,4,5,7],list_of_tupl:1,llc:4,lmop:[0,4],load:[2,4],loc:[0,1,2],loc_filenam:4,local:0,locat:[0,1,2,5,6,8,9],location_filt:0,locations_comput:0,locations_fil:[1,4],locations_filenam:2,locations_output_fil:4,logic:1,longer:0,longitud:4,look:2,lookup_facility_typ:[0,4],lookup_step:0,lookup_step_cost:0,lookup_step_cost_method:0,lookup_transpo_cost_method:0,loop:2,loss:[0,1],machin:0,made:[0,2],mai:[0,1,2,4],main:[0,5],major:5,manag:[0,8,9],mani:[0,2],manipul:5,manual:[0,4,5],manuf_facility_id:2,manufactur:[0,1,2],map:2,mass:[0,1,2,5,6],mass_cumulative_histori:0,mass_kg:2,mass_tonn:2,materi:[0,1,2,3,4,5],material_mass:0,material_mass_plot:0,matrix:5,max:0,max_timestep:2,maximum:2,mean:[8,9],mechan:1,memori:4,memory_map:4,merg:[4,5],methan:[0,4],method:[0,2,3,4,5,6,8,9],metric:[1,6],midpoint:[],min_lifespan:0,min_year:2,minimum:[0,4],minu:1,miscellan:4,mix:[0,4,5,6],model:[1,2,3,4,5,6,7,8,9],model_celavi_lci_background:5,model_celavi_lci_insitu:5,model_run:[0,2],modif:1,modifi:[2,5],modul:[0,4,5,8,9],monthli:2,more:[0,2,4],most:[0,2],move:[0,2,6],move_component_from:2,move_component_to:2,much:[0,1],multi:0,multipl:[0,1,6],murrai:1,must:[0,1,2,4,5,7],nacel:[0,2],name:[0,1,2,3,4,5,6,7],nan:4,nation:[0,1,5],national_dynamic_grid_mix:0,national_electricity_lci:0,national_level_grid_mix:0,national_level_reeds_import:5,national_reeds_grid_mix:0,nearest:[1,2],necessari:[5,6],necessarili:2,need:[0,4,5,7],neg:[0,2],neighbor:1,net:1,netw:[0,1],network:[1,4],networkx:1,newli:[],next:[0,1],next_step:1,noah:4,node:[1,4],node_id:[1,4],node_loc:[0,4],node_map:4,node_nam:1,non:5,none:[1,2,4,5],normal:[0,8,9],note:[0,2,4,5,8,9],nrel:[4,9],number:[0,1,2,3,4,5,6,7],number_of_technology_unit:[0,4],numer:7,numpi:5,obj:0,object:[0,1,2,5,6,7],obtain:[4,5],occur:[0,5],old:[5,6],onc:[0,2,7],one:[0,1,2,3,4,6,7],onli:[0,2,4,5],ons_mw:4,onsit:[0,1],onto:1,open:6,oper:[4,5],optim:[8,9],option:[0,1,2,5],org:[0,9],origin:[1,4],other:[0,1,2,4,7],other_facil:4,other_facility_loc:[0,4],other_facility_locations_all_u:0,otherfacilityloc:4,otherwis:[0,4],our:5,out:[0,2],outflow:[0,6],output:[0,1,4,5],output_plot_filenam:3,outreach:[0,4],outsid:[0,1,4],over:[1,2,4],overwrit:[0,4],overwritten:0,p_cap:4,p_name:4,p_tnum:4,p_year:4,page:[8,9],pair:[0,4,7],panda:[1,2,3,4,5,6,8,9],paramet:[0,1,2,3,4,5,6,7],parent:4,parser:6,part:2,particular:[0,1,2,5],pass:[0,1,2,5,7],past:4,path:[1,2,3,4,5,6],path_dict:[2,8,9],path_split:[0,1],pathwai:[1,2],pathway_crit_history_filenam:1,pathway_criterion_histori:0,pcg64:1,per:[0,1,2,3],perform:[0,1,4,5],period:[0,2],permanent_lifespan_facil:[0,1],phase:0,physic:2,pickl:[0,5],pickle_costgraph:0,place:[2,5],plant:[0,1,2,4],pleas:[5,8,9],plot:3,plu:1,png:0,point:[2,4,6],pollut:5,popul:[0,2],posit:2,possibl:[0,1,2,3],possible_compon:2,possible_item:2,possible_materi:2,post:[5,6],postprocess:[1,6,8,9],power:[0,1,2,4],power_plant_loc:[0,4],pre:[0,5],precomput:0,predict:2,prefer:1,prepar:5,preprocess:[0,5,6,8,9],present:5,previou:[0,5],previous:[4,5],print:[0,2,5],probabl:[0,2],problem:5,procedur:2,process:[0,1,2,4,5,6],process_df:5,process_emissions_corr:0,process_nam:2,process_names_add:0,produc:[0,4],product:[0,4,5],product_df:5,program:[0,4],programmat:0,progress:5,project:[0,4],pron:[8,9],proper:5,properli:5,properti:2,provid:[0,1,2,4,5,6,7],proxi:1,purpos:5,pydata:9,pylca:5,pylca_celavi:2,pylca_celavi_background_postprocess:5,pylca_interface_process:2,pylca_opt_background:5,pylca_opt_foreground:5,pylca_run_main:5,pylcacelavi:[2,5],pylcia:[2,5,6],python:[0,2,8,9],qualiti:[],quality_check:[],quantifi:[0,6],quantiti:[1,2,5,7],quantity_unit:2,queri:[1,2],question:1,queue:2,rais:[2,6],random:[0,1,7],random_st:1,rang:[0,7],rapidli:[],rate:[0,1,5],rather:[0,2],raw:[0,4],reach:2,read:[0,1,4,5,6],read_tabl:4,readabl:0,readi:4,receiv:[],recent:0,recircul:0,recommend:0,record:[2,6],recycl:[1,2],reduc:[0,1],reed:[4,8,9],reeds_import:5,reeds_imported_filenam:5,reeds_output_filenam:5,reedsimport:5,refer:0,region:[0,1,4],region_id_1:[1,4],region_id_2:[0,1,4],region_id_3:[1,4],region_id_4:[1,4],region_transport:4,releas:[8,9],relev:[1,5,7],remain:[0,4],remaind:4,remov:[0,1,4,5,6],renam:5,renew:[2,4],repeat:0,repeatedli:0,replac:[4,5],report:5,repositori:[8,9],repres:[0,1,2,7],represent:[1,4],reproduc:[0,7],requir:[0,4,5],res2:5,res:5,res_df:5,reset:[5,6],resolut:2,resourc:[0,2],result:[0,2,5,6],results_tot:5,reult:[],reusabl:1,revenu:[0,1],rhane:6,road:[0,4],rotor:[0,1],rotor_teardown:1,round:2,rout:[0,1,2,4,5,6],route_id:[1,2,5],route_pair:0,route_pair_fil:4,routepair:4,router:[0,8,9],routes_comput:0,routes_custom:0,routes_fil:1,routes_filenam:4,routes_output_fil:4,routing_output_fold:4,row:[1,2,4],run:[0,1,2,3,5,6,7,8,9],run_rout:0,runner:[],runner_insitu:5,sale:1,same:[0,1,2,4],sampl:2,sand:0,save:[0,1,4,6],save_cg_csv:0,save_copi:1,save_costgraph_output:1,save_nam:1,sc_begin:[0,1],sc_end:[0,1],sc_in_circ:[0,1],sc_out_circ:[0,1],scalar:0,scale:[0,1,5],scenario:[1,2,3,4,7,8,9],scipi:[0,7],scope:[],search:[8,9],second:4,secondari:0,section:[0,1],see:[0,2,4],seed:[0,1,7],segment:[0,1],segment_transpo:1,select:2,self:[2,5],sell:1,sent:[0,5],separ:[0,1,6],sequenc:2,seri:[5,8,9],set:[0,1,2,4,5,6,8,9],setup:6,sever:0,shortcut:5,shortcutlca_filenam:5,shorten:0,shortest:1,should:[0,1,2],shred:[0,1],shred_transpo:1,sign:2,signific:5,similar:2,simpi:2,simtim:6,simul:[0,1,4,6,8,9],simultan:0,sinc:[2,6],singl:[0,1,4,6,7],site:1,slice:[8,9],slope:0,small:1,solv:5,solver:5,solver_optim:[],some:0,sourc:[1,4],source_facility_typ:4,space:0,span:2,sparingli:2,spatial:5,specif:[0,1,4,5],specifi:[0,1,2,4,6],speed:0,spend:2,split:0,sqlite:4,stabl:0,stackoverflow:1,stage:[2,5],standard:[1,4],standard_scenarios_filenam:4,standardscenario:4,start:[1,2,3,4],start_year:[0,1,3,4],starttim:6,stat:[0,7],stata:[],state:[0,2,4,5,7],state_dynamic_grid_mix:0,state_electricity_lci:0,state_level_grid_mix:0,state_level_reeds_import:5,state_reeds_grid_mix:0,statefp:4,statement:[2,5],states_includ:0,static_filenam:5,static_lci:0,static_lci_filenam:5,statu:4,steel:0,step:[0,1,2,4,6],step_cost:[0,2],step_cost_method:[0,1],step_costs_custom:0,step_costs_default:0,step_costs_fil:1,step_costs_filenam:2,stochast:0,stock:5,stock_filenam:[0,5],stop:1,storag:[0,5],store:[0,1,2,5,7],str:[1,2,3,4,5,6],stream:[0,5],string:[0,1,2,4,6],strongli:0,structur:[0,2,7,8,9],stscen20a_midcase_annual_st:0,studi:[1,2,4,5,8,9],sub:[0,6],subcompon:5,subgraph_step:1,subsequ:2,subset:4,substanc:6,substitut:[0,5],substitution_r:[0,5],suffici:0,sum:[1,2],superstructur:1,supplement:5,suppli:[0,1,2,4,5],suppoet:[],suppress:5,sustain:4,system:5,t_cap:4,t_counti:4,t_fip:4,t_model:4,t_state:4,tabl:2,take:[0,1,2,5],taken:0,target:1,teardown:[0,1],tech:5,tech_matrix:5,tech_matrix_corr:0,tech_units_filenam:4,techno:1,technolog:[0,1,2,3,4,5,6],technology_compon:0,technology_data:0,technology_data_filenam:4,techunitloc:4,templat:[8,9],termin:[1,4],text:4,than:[0,1,4],thei:[0,3],them:0,thermoplast:1,thermoset:1,thi:[0,1,2,3,4,5,7,8,9],third:1,those:5,three:[0,1],through:[1,2,4,5],throughout:1,thrown:0,thu:[0,2],thw:6,time:[0,1,2,4,5,6],timeout:2,timestamp:[0,6],timestep:[0,2,3],timesteps_per_year:[0,2,3],timesteps_to_year:2,tip:[0,1],togeth:[3,6],toggl:[2,5],ton:1,tonn:[1,2,3],tonne_km:2,top:0,total:[1,2,5],tower:0,traci21:0,traci:5,traci_lci:0,traci_lci_filenam:5,track:[2,5],tracker:[8,9],transact:2,transaction_histori:2,transit:2,translat:[2,7],transpo:[0,1],transpo_cost_method:0,transpo_edg:0,transpo_edges_fil:1,transport:[0,1,4,5,8,9],transportation_graph:[0,4],transportation_track:2,transportationgraph:4,transportationnodeloc:4,transportationtrack:2,travel:4,triang_gen:7,triangular:[0,7],truck:1,tupl:[1,6],turbin:[0,1,4],turbineloc:4,two:[0,1,5],type:[0,1,2,3,4,5,6,7],typic:[0,2],u_edg:1,u_of_edg:4,uncertain:1,uncertainti:[1,3,6,8,9],uncertainty_method:7,under:[0,1,7],underli:[0,4],unequ:0,unfilt:4,union:1,uniqu:[1,2,4,5],unit:[0,1,2,3,4,5,6],unless:0,unmodifi:4,unrealist:0,unspecifi:2,until:2,updat:[0,1,2,5],update_cost:1,update_cost_graph_process:2,upstream:1,usag:5,usd:[0,1],use:[0,1,2,4,5,7],use_computed_rout:0,use_fixed_lifetim:0,use_lcia_shortcut:0,use_shortcut_lca_calcul:5,used:[0,1,2,4,5,7],useful:[0,2],user:[0,1,4,6],uses:[0,1,2,4],usg:4,using:[0,1,4,5],uslci:5,uslci_emiss:0,uslci_emission_filenam:5,uslci_filenam:5,uslci_process_add:0,uslci_process_filenam:5,uslci_tech:0,uslci_tech_filenam:5,usnrellci_processesv2017_loc_debug:[],uswtdb:4,uswtdb_v4_1_20210721:0,uuid:[2,5],v_edg:1,v_of_edg:4,valid:[4,6],valu:[0,1,2,3,4,5,7,8,9],value_nam:3,var_nam:3,vari:[0,1,2],variabl:[1,5,8,9],variat:4,variou:[],vector:5,verbos:[1,2,5],version:[0,1],vertic:4,vie:[8,9],viewabl:4,virgin:2,visit:[8,9],visual:[0,5,6,8,9],vkmt:[0,1,4],vkmt_max:[0,4],wai:[2,3],want:[0,2],warn:[0,8,9],weibul:[0,2],weight:4,well:[0,1,7],what:2,whatev:[0,1],when:[0,1,2,4,7,8,9],where:[0,1,2,3,4,5],whether:[0,1],which:[0,1,2,5],wih:5,wind:[0,4,8,9],wind_plant_loc:4,wind_power_pl:4,withdraw:2,withdrawn:2,within:[0,1,2,3,4,5,6],without:[0,5],word:6,work:[1,2,4],would:0,written:[0,1],www:4,xlong:4,yaml:0,year:[0,1,2,3,4,5],years_to_timestep:2,yes:5,yet:0,ylat:4,you:[0,2],your:[0,2],zero:[1,2,5],zero_method:1},titles:["Configuration Files","Cost Graph","Discrete Event Simulation","Postprocessing and Diagnostic Visualizations","Data Preprocessing","Python Life Cycle Inventory Analysis","Scenario","Uncertainty Methods","Welcome to CELAVI\u2019s documentation!","Welcome to CELAVI\u2019s documentation!"],titleterms:{"case":0,"import":5,analysi:5,background:5,blade:1,calcul:5,celavi:[8,9],compon:2,comput:4,concret:5,config:0,configur:0,context:2,cost:[0,1],critic:2,cycl:5,data:[4,5],diagnost:3,discret:[2,5],document:[8,9],editor:5,emiss:5,event:[2,5],exampl:0,facil:2,file:0,filter:4,flag:0,foreground:5,graph:1,indic:[8,9],insitu:5,instanc:2,interfac:5,inventori:[2,5],life:5,locat:4,manag:4,method:[1,7],model:0,optim:5,path_dict:1,postprocess:[3,5],preprocess:4,python:5,reed:5,router:4,scenario:[0,6],simul:[2,5],structur:1,studi:0,tabl:[8,9],templat:0,tracker:2,transport:2,uncertainti:[0,7],variabl:2,visual:3,welcom:[8,9],wind:1}}) \ No newline at end of file