From 0e591066d8917ba40da1a07f852e43fb164dac3d Mon Sep 17 00:00:00 2001 From: ebalogun01 <42688418+ebalogun01@users.noreply.github.com> Date: Tue, 19 Dec 2023 01:53:20 -0800 Subject: [PATCH] adding major doc changes --- __init__.py | 0 .../EV-EcoSim.analysis.cost_analysis.doctree | Bin 0 -> 2512 bytes .../build/doctrees/EV-EcoSim.analysis.doctree | Bin 0 -> 3942 bytes ...coSim.analysis.load_post_opt_costs.doctree | Bin 0 -> 2546 bytes .../EV-EcoSim.analysis.plot_results.doctree | Bin 0 -> 2507 bytes docs/build/doctrees/EV-EcoSim.app.doctree | Bin 0 -> 2415 bytes ...ntification.battery_identification.doctree | Bin 0 -> 2636 bytes .../EV-EcoSim.batt_sys_identification.doctree | Bin 0 -> 3813 bytes ...att_sys_identification.experiments.doctree | Bin 0 -> 2579 bytes .../EV-EcoSim.charging_sim.battery.doctree | Bin 0 -> 2502 bytes ...coSim.charging_sim.batteryAgingSim.doctree | Bin 0 -> 2542 bytes ...EV-EcoSim.charging_sim.batterypack.doctree | Bin 0 -> 2522 bytes ...EV-EcoSim.charging_sim.batterytest.doctree | Bin 0 -> 2522 bytes .../EV-EcoSim.charging_sim.capacitor.doctree | Bin 0 -> 2512 bytes ...coSim.charging_sim.chargingStation.doctree | Bin 0 -> 2542 bytes .../EV-EcoSim.charging_sim.clock.doctree | Bin 0 -> 2492 bytes .../EV-EcoSim.charging_sim.controller.doctree | Bin 0 -> 2517 bytes .../doctrees/EV-EcoSim.charging_sim.doctree | Bin 0 -> 8602 bytes ...Sim.charging_sim.electricityPrices.doctree | Bin 0 -> 2552 bytes .../EV-EcoSim.charging_sim.node.doctree | Bin 0 -> 2487 bytes ...V-EcoSim.charging_sim.optimization.doctree | Bin 0 -> 2527 bytes ...V-EcoSim.charging_sim.orchestrator.doctree | Bin 0 -> 2527 bytes .../EV-EcoSim.charging_sim.simulate.doctree | Bin 0 -> 2507 bytes .../EV-EcoSim.charging_sim.solar.doctree | Bin 0 -> 2492 bytes ...EV-EcoSim.charging_sim.transformer.doctree | Bin 0 -> 2522 bytes .../EV-EcoSim.charging_sim.utils.doctree | Bin 0 -> 2492 bytes docs/build/doctrees/EV-EcoSim.doctree | Bin 0 -> 4054 bytes docs/build/doctrees/EV-EcoSim.setup.doctree | Bin 0 -> 2425 bytes .../EV-EcoSim.test_cases.base_case.doctree | Bin 0 -> 5865 bytes ...est_cases.base_case.event_handlers.doctree | Bin 0 -> 2581 bytes ..._cases.base_case.feeder_population.doctree | Bin 0 -> 4022 bytes ...eeder_population.feeder_population.doctree | Bin 0 -> 2688 bytes ...eeder_population.glm_mod_functions.doctree | Bin 0 -> 2690 bytes ...EcoSim.test_cases.base_case.gblvar.doctree | Bin 0 -> 2539 bytes ...oSim.test_cases.base_case.glmptime.doctree | Bin 0 -> 2549 bytes ...im.test_cases.base_case.master_sim.doctree | Bin 0 -> 2561 bytes ...EV-EcoSim.test_cases.base_case.sim.doctree | Bin 0 -> 2524 bytes ...Sim.test_cases.base_case.voltdump2.doctree | Bin 0 -> 2554 bytes .../EV-EcoSim.test_cases.battery.doctree | Bin 0 -> 6657 bytes ....test_cases.battery.event_handlers.doctree | Bin 0 -> 2569 bytes ...ses.battery.event_handlers_oneshot.doctree | Bin 0 -> 2611 bytes ...st_cases.battery.feeder_population.doctree | Bin 0 -> 4556 bytes ...tion.feeder_population_centralized.doctree | Bin 0 -> 2738 bytes ...ation.feeder_population_collocated.doctree | Bin 0 -> 2733 bytes ...eeder_population.glm_mod_functions.doctree | Bin 0 -> 2678 bytes ...V-EcoSim.test_cases.battery.gblvar.doctree | Bin 0 -> 2527 bytes ...EcoSim.test_cases.battery.glmptime.doctree | Bin 0 -> 2537 bytes ...oSim.test_cases.battery.master_sim.doctree | Bin 0 -> 2549 bytes ....test_cases.battery.parse_voltages.doctree | Bin 0 -> 2569 bytes ...coSim.test_cases.battery.scenarios.doctree | Bin 0 -> 2542 bytes .../EV-EcoSim.test_cases.battery.sim.doctree | Bin 0 -> 2512 bytes ...coSim.test_cases.battery.voltdump2.doctree | Bin 0 -> 2542 bytes .../doctrees/EV-EcoSim.test_cases.doctree | Bin 0 -> 3322 bytes docs/build/doctrees/analysis.doctree | Bin 86912 -> 87491 bytes docs/build/doctrees/app.doctree | Bin 17524 -> 18553 bytes .../doctrees/batt_sys_identification.doctree | Bin 51117 -> 51802 bytes docs/build/doctrees/charging_sim.doctree | Bin 492912 -> 492726 bytes docs/build/doctrees/environment.pickle | Bin 27867 -> 129880 bytes docs/build/doctrees/feeder_population.doctree | Bin 45574 -> 3567 bytes docs/build/doctrees/index.doctree | Bin 10309 -> 10329 bytes docs/build/doctrees/modules.doctree | Bin 2805 -> 2770 bytes .../doctrees/test_cases.base_case.doctree | Bin 5356 -> 25815 bytes ..._cases.base_case.feeder_population.doctree | Bin 0 -> 55658 bytes .../build/doctrees/test_cases.battery.doctree | Bin 24528 -> 53984 bytes ...st_cases.battery.feeder_population.doctree | Bin 50209 -> 61820 bytes docs/build/doctrees/test_cases.doctree | Bin 3627 -> 3603 bytes docs/build/html/.buildinfo | 2 +- docs/build/html/Introduction/welcome.html | 4 + docs/build/html/_sources/analysis.rst.txt | 15 +- docs/build/html/_sources/app.rst.txt | 2 +- .../_sources/batt_sys_identification.rst.txt | 15 +- docs/build/html/_sources/charging_sim.rst.txt | 54 +- docs/build/html/_sources/index.rst.txt | 2 +- docs/build/html/_sources/modules.rst.txt | 8 +- .../_sources/test_cases.base_case.rst.txt | 10 +- ...st_cases.battery.feeder_population.rst.txt | 18 +- .../html/_sources/test_cases.battery.rst.txt | 11 +- docs/build/html/_sources/test_cases.rst.txt | 15 +- docs/build/html/analysis.html | 29 +- docs/build/html/app.html | 31 +- docs/build/html/batt_sys_identification.html | 25 +- docs/build/html/charging_sim.html | 108 +- docs/build/html/feeder_population.html | 328 ----- docs/build/html/genindex.html | 1127 +++++++++++++++++ docs/build/html/index.html | 4 + docs/build/html/modules.html | 93 +- docs/build/html/objects.inv | Bin 856 -> 3926 bytes docs/build/html/py-modindex.html | 67 +- docs/build/html/readme/README.html | 4 + docs/build/html/search.html | 4 + docs/build/html/searchindex.js | 2 +- docs/build/html/setup.html | 4 + ...est_cases.base_case.feeder_population.html | 362 ++++++ docs/build/html/test_cases.base_case.html | 140 +- .../test_cases.battery.feeder_population.html | 105 +- docs/build/html/test_cases.battery.html | 289 +++-- docs/build/html/test_cases.html | 60 +- docs/build/html/tutorials/tutorial.html | 6 + docs/source/conf.py | 18 +- docs/source/index.rst | 62 - docs/source/setup.rst | 7 - setup.py | 8 +- .../feeder_population/feeder_population.py | 697 +++++----- test_cases/base_case/gblvar.py | 108 +- test_cases/base_case/sim.py | 1 + test_cases/battery/IEEE123_secondary.glm | 696 +--------- test_cases/battery/dcfc_bus.txt | 16 - test_cases/battery/event_handlers.py | 15 +- test_cases/battery/event_handlers_oneshot.py | 48 +- .../battery/feeder_population/__init__.py | 26 - .../battery/feeder_population/config.txt | 6 +- .../feeder_population_centralized.py | 16 +- .../feeder_population_collocated.py | 12 +- .../feeder_population/glm_mod_functions.py | 3 +- test_cases/battery/master_sim.py | 8 +- test_cases/battery/sim.py | 51 - test_cases/battery/voltdump2.py | 6 +- 117 files changed, 2729 insertions(+), 2019 deletions(-) delete mode 100644 __init__.py create mode 100644 docs/build/doctrees/EV-EcoSim.analysis.cost_analysis.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.analysis.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.analysis.load_post_opt_costs.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.analysis.plot_results.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.app.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.batt_sys_identification.battery_identification.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.batt_sys_identification.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.batt_sys_identification.experiments.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.battery.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.batteryAgingSim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.batterypack.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.batterytest.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.capacitor.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.chargingStation.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.clock.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.controller.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.electricityPrices.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.node.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.optimization.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.orchestrator.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.simulate.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.solar.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.transformer.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.charging_sim.utils.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.setup.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.event_handlers.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.feeder_population.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.feeder_population.feeder_population.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.feeder_population.glm_mod_functions.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.gblvar.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.glmptime.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.master_sim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.sim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.base_case.voltdump2.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.event_handlers.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.event_handlers_oneshot.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.feeder_population_centralized.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.feeder_population_collocated.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.glm_mod_functions.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.gblvar.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.glmptime.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.master_sim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.parse_voltages.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.scenarios.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.sim.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.battery.voltdump2.doctree create mode 100644 docs/build/doctrees/EV-EcoSim.test_cases.doctree create mode 100644 docs/build/doctrees/test_cases.base_case.feeder_population.doctree delete mode 100644 docs/build/html/feeder_population.html create mode 100644 docs/build/html/test_cases.base_case.feeder_population.html delete mode 100644 docs/source/index.rst delete mode 100644 docs/source/setup.rst delete mode 100644 test_cases/battery/sim.py diff --git a/__init__.py b/__init__.py deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/build/doctrees/EV-EcoSim.analysis.cost_analysis.doctree b/docs/build/doctrees/EV-EcoSim.analysis.cost_analysis.doctree new file mode 100644 index 0000000000000000000000000000000000000000..26fbec12861f9f73148c3ba3061fa25e405442ca GIT binary patch literal 2512 zcmZ`*OK%%D5O(ZHvTRv?q$vs{ZW|P78q|`Dpob#YG$*45`U-kbKv27sNQg^rNvC0D>(aS{tEV40GR9;(Q$BDLXLK^b(Os563Y8!WdVapg>RNeYd)vbT2 zz6(_%-JBw97x=O7lQvJjY2>(h&EM9x1$xcm{qd%~_p4CNHrs43?tR(D0!#ijfU zbm;M#%Kvz3`a$^%H3vYCTg1(bR*tDO`0gtz3-qCZEI+*T{W(+2P^V1*ky5nL(JTkCU%4T$y#Tpa zlZBC>4xCO%Y+rnZyAI+q*TJ96w0256cI)xtjz5TSS4BpaGi|Z}&d>riIZ1RDr^v$O zgNnl>D>>wiaGW$Cg2!5+M%ASs7?x|}h-6nxhKp^#$Ej?|jz4Bgfm%803fl;Ed?#ho zVh(r1H`FN93KE9V44l3*Gy%$zMR@OrLgj@cOeH#nRPg=6%|_pitibof^+&>t(S~rU zQppVJ979c9@Q1o^>sC6YmEcb|UN%hd-~6yLx(c9CeYpOxq3Mre0v1)`sEJf z<^`QIlsg5zjiu!889?5oBxO0k0XG83xb)pbs~K`cIYdfwOs7}|-t|LTI89b8zb$~M zgS5zU(xMJkEg1rUGuTtn;9qBaP-6vbCweng<%krvS5SAnNq|aC&Pcjoy+a>^K-E6IKOsWtFboo z^Wg7C$ua;)62~&M$Dtj&;Ex`E^DXK*G_z#GeB`Xmf7zJFq|%7j1v6v8+^qD0nLp<) zlW^8|bczv59S;|~{uF@BNIRQt0>tJKAvgZWUMokJgo`w^oh%2~D3 zZu|~YSMiGZ-D;O$cmYMBQi0)c#8ES6*iG2?#|R40aya6EO&V|3TWq^EZgtndhP7Es zbmIu&B!b_I%<7vzX$9QhmDcwBJP9W z_Y*B83X2?YGI}p+{s$!gF8l=a;~x*q5&l)M=y&C?T^wud{gz#}Y+tBE7HNdYJa%g@ Ojk~R01M%J#)A2w4rR^sG literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.analysis.doctree b/docs/build/doctrees/EV-EcoSim.analysis.doctree new file mode 100644 index 0000000000000000000000000000000000000000..cf7e0f00f4798a3c91543ff457a2b0e2e27ad372 GIT binary patch literal 3942 zcmb7HTZ|;Qx}~j z2+4!skU|hE|3L6X@Ym%39|Lt zC>0S^&aOuyGzm?$d*^QbCBY9@Zf2``ydogc+w*&i4PT5S27YFkP&s>3|6OprehDs zD>wdE`IRfsu4V+-v}3!r6;#f!6}wvcuy0SrJf&{m42azzT1!4K8oqm9S9qknUu$7Z zl!6f7&6Fg?*Lq~KdN2S?Nrzs?*fmW?e#)^9yTG>CMYh5&*}c7c{a+N7s!s{x|Ty1#j3lxfk6+o!th4=B$C;Q1y;vYQ7+yS!|=G zWV+Zf?%X;eCVHVzx*t>_Qn)+y78Xl^ky|vDENU`-{5&!q&XBP_N5&2Myi0+PC*3K& zu7_KXO0+dowMl){-ed_bnLU$58Uf=N8oxb?##oT3A7nY1A_Jp-S9N8cPFOC}=`9<% zWg~!PW8Si+b?|w#1~ato%+cCCf>sZr>(O@sAtzaNm&mORYjV9|4&Gy*hkh)@fOHJS zH;kS%<1~s97d>*0W8A8v`5qkXyLjB&|66-RPwMEUOw^#&w zEQJ7Z427M?dEvSeid3U)R|RZIUK8RzkC3-Bgj|^;q*H_r;;7uaPSA3yhIOoqSe91R z)P8vs&t*%icc`^0ZmY((wAspx59kH|U%IO<$8P&7e!{jxBYi&%s_wTnl@wjjt}CiF zPe*9}yHz(I%AAwP+0~~cHfSu<>j3NQ+t!GtR1z(u!yqE)o|+^X2Ajn;0oFdiaHAX= z8Dq4qMHu+5>1VNB6S(A|v!{nb=u~JrGx_L*-S$_B)Fi=pC}iRwX)84A4C$Nr8;Zh` z7YYfDX)Xy~aLs~g@5YX$LD|gr?UtmOkUEIza~iuxC+!9!aW!n(T{`CAN)v6=RHkf)0){i%St7JGN@u#Ap%J zB72e}qP8QGWI+{mU^N$TB%#C=&@b4@C7?D{{_JZ}rl^TTFiw0t?a(oL0S#s?^AHJj z@SH1N#AhdnxFUntJ5r)tn`Q&MZMWczLj05b){2lR)q)}S_bJ@}&iOBFf_t3T!SVXl zBAoXoZpPIR@ww|$3SpCu5QQ;MxOR_sZrFB4GnC9BMIwedVOw4@Ai(Z3!=7haXX@Ua zI}od0cBq+1dqR%xID6J><^Z4>Xqw=7G>&5(^6s^}-+|Az9EJP$W^hCwVsQc`;TM)2eXV*9lxm7xZ}IgV#6yJQe+=|G*(;k^zm7zlVUpDAm~HYzVD`fF^{; z0iHtWhyLpS+U}N*83b!QENa@suF&+ke>~XrqLv_e5sEyGIFdsLn#d7FZ9?Ge0u(|^ z*iTqRHC92(=w0KTHjMawKVAZD(ULugMd13K=lYL?z*&e&k`s`O`m}GC*-|Pc> zZ*0qJ>B9`L{iXiXgzZgOf5Oa!y_v8N6T_~0`A57=?z1keAHq6-^_ab9Z;joaJ?4Dh z?T{l_JaAwsBtDy`dWD0tl0pw|BP^1Eh^xrSRliseR@$w(6!T`5?c2cF z#kIY}F5OwTGvTRwllcp$;xNT6RY0yY+gC2@p)0~X@(2ukS1q8LEL_%D0OL86g z5THE-hymWh{>J`|KJKp8mQd6{oaJyn-@F<6&(7cf^tY;?aOesl^>R!Z(}r;u!!9#f znRD&qhxp{L_%?nO`j){W-(EbQ z{OY)M6F#NNOn%^Q;Y~4l`KqaIf(+fH&g@#c4qH`ns<c!(rN z{9?p`smweenN)}&>J(Rjrmnxoa zrnHK%GH4qho+jH{VVIRRwTiTj8LT9AgTk)k-b+0Pg^ycK&aBa%YZgQI6;&lVvm&)P zJP-Xj*W6NXY{Y?4G}hC+z+t}*L*RRX<6d(tt-|TRn~bD}rdx#TATN6v!=0HiUK`JE zT%O$u2WcR5nUm$r*gQfqbl_2e4&`ai99-V7C0y}JLf%L($ck2o*cdcCI}ZcP3u8S| z{DP}^wjK5aRqe48j`>moD^GptR!W`FVSHN75pMW~S`DnAVL8nq>3d5v@Ge`#_hBe? zQF_94W*D?$=$C#r`hMgjz8|b#5^k-rL{QBXx4=22n)w(GP3hOYbSf_~oNU}|xDdaG zVeRxfftBfl^@|P5aFhygKuG`}g@R%@P*l%LI_H3!;k=Et74BNl-!j5@0dgRW1T)S< zH#2&M8Ucr7q`fNCX>Ae_Y}OAZe!382+3_5NB^ zI9@VCmU-gS5np2PIJs$AQ6%%^LONOV^N=v<=v1Xbnk;*(X%J7t0L3`)pH{mUlxft+ zOsaYzeVo1!1S=-#puNc(L%;X2-`gYjd7MTHw9#|0P{~~S_~X&zFf4dM01C$-W))zA zB$-m=o+cxFBD^o$^V3s^-MF~)!sxNF^V1maCCw@UXcEtJw8x_zyO56_ee)gg9NJm7 z;XX;O-G8}qk4dG8uM2L+lKWW|12care6A3z@97jH#Jq@SyWs?c%tsBHqD)2`XiqXhkq;VQ4;xUfAcXaz zED$2SlGWSSEP*Sq$7E8^z=73PxRdsTE2kTJGEd}9>$w`m^d2oDIFnB~!~9+%1;M#T zkb4=l7KGtN|4Q|v4PmR@U-Q^s zMXikPtog@owLUHLdz-$Ro2{^ijggr$?SmNhGouuMMGbf|dM_IJ2NeG<{si{pPZ7)! p{&;ZccO9@@9BbnJR$R4gU+PSiEKy{hy0ypBZfn*+dT-0=_+L1r`dt73 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.analysis.plot_results.doctree b/docs/build/doctrees/EV-EcoSim.analysis.plot_results.doctree new file mode 100644 index 0000000000000000000000000000000000000000..a455bcd4f2565df3632a0e31e52293e08211e258 GIT binary patch literal 2507 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.batt_sys_identification.doctree b/docs/build/doctrees/EV-EcoSim.batt_sys_identification.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2eff779381279cb461858236063e7b9afdac0387 GIT binary patch literal 3813 zcmb7H+inv_7!C@H6*omnL8>Bh0WDG`qtSSG>=}7?XFD?+ z992l|1riY>ZnEWR`XqgtezQm0X#!ZXwDa%$r|&=RpN+r&Z7*a$+tD!>(WFOxKaxJv zsa^G@mxL@b=}CJ3uk=lN&o&i(t!1J-mf8i}@VE$k#iI08YTNF*5rOU%{41JyM#!jQ z=MBEhS6-#}c+)nFFaeu-Wp|#u?027d@`VU{18Pj4=p)@H!iNQ7C_L(9-HNF~qv9VXYdWQrJ1}?0rrWWr#6#bSk-WAW9q{>(eP!$~u*5g{&ID zpT7*ir&9o~&H(r$JM1z~Y7ur_opcfU?rfE0bT~LqE^Mk%uSK1iMNS1o%_Y~ZO4K=_ zg4ySU>if?M6`RCN3D<>msk2B^@P9^l{)fK~$>7UELZ(8pITMnHpAN~CA>9hRqIhi0 ze`Xw}_)8$@bkWV%2@E_3{LZti=5Kj2G7j4^=TFgVu>SZmuqIPrU7G=`le^!obl3S< zysFJQ*F}hBRU@+ZKOKW|c+?7Orn7*rCeA5SmZm&JlRdj9R?~#F;M|d8%BD>O(*vj>Kd?19i{ftP)ZX?!=_&DU$7f)s7FaiCPS&h6qL5c zP>hKu!>mdn@_J5T0m~@lwJ@BNGZGpLhGJ+Q*mcEXsSF9&Aq&#|Mcd*usE!T0#U=t+ z8EO(;UTWBe&j!f|>e{cVihvbvC`Ln2nnqC%L)06m?`&H{abgIIJn7?BYMY4}c7Nz< zf#(~uF9}mhD#B^x2TTEHXR2pX+mVTxmD0$hq;`Am&727Sk8S5dYXeHw8?!IwIPIo$ zKm#QXd;&O>+KqrlqXhd8;P!D|#Oh@)D@+6B6Q9K_!nWiIWX6GAMtu$8Bj6A|iLrc$ zNy?XPnO^P*3d`Tvu%co5= zDybQn=FC#WGvrWck>_WJ_(Ib`;2bHeTq&!8@7Q%XqmlpF&Ih3z#WgY%Zc)LWb=5sV z3HBwo7b3h)nvZy|VMncw$j>cTQb?OZgV)LwBnGXrpw7#1Qt2H{u*y?f`uL*Us~LvK#JqtxQR zEybf!sms?fQ$4}VFw=pW-{mF@psZ==043xbp6;*OZ6st!s@kj^AR5h$rN?$tA4P^v z2p1zB;E&|J7)Y1*>pG;UvfmRFwFXd^vvYnVf%Iqr?Y74$>_Oo3Vgt$$5fFToD3-0*@9b9bS%G8?hIvmrwo5EJbW6Hj&3g%o7pW*BU!XV)F;tBhrW_Jy z3q~Qe3_ewmHojZQ-=N#gQ1i7NWJnuUhh@8w=iQ}TQ86}b=&WKg9`cJ-?{Vs*PYBe7X(&6qCD$VV$y#`XRy^RkLJ z3$}#@+xGmqc!lG-q@th2L{{ciz#}WVl literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.batt_sys_identification.experiments.doctree b/docs/build/doctrees/EV-EcoSim.batt_sys_identification.experiments.doctree new file mode 100644 index 0000000000000000000000000000000000000000..e7dd76d7fe06ab03b9f6c3cc2c778648c0d8dbac GIT binary patch literal 2579 zcma)8OK%%D5O(b7X-T$|rYMlO4-{z{G?I%TK#N?{oQ(R=N6>>(f?84{A?|WZavk{) zpgjbL0p7y?-+tU(ttB0b1TeDvIGpDueIw?|~ zx$q%8{wKT*-};`RZ>%m%!h_#~L?WbOhG*e*@S`a1q_UIxeaG^|Nu4#%MN70r=XDT0 z-*VC^zH#G!c=>8NewpZBWjdKr=cdG7*(s3>4#>GoXjC=ftDGAdow8r1nibGdYrOp% zUqw%&qPcef zn4$y8Y)nTdQPf(1_-LfjISlzIZ1Il>3sU~RUP9L9@=T;*$rBzFb4iVaZijzke{FLBMk8cd>3EA*Ju24 z%oA;8I*w%+L&tc#2;+?+jO!v$@iprDaO?fY_^>V_6_4=#G4de36Me*gP{l8v>^itM zw0_W3MLdabZ~0MDm{>p3RBNzCs;c>}<<7}$0gj(Eq@5d`Ii9iL+pnl9P_8xW#nFZD zEqKNab=m|R7)7-mO>-O$D>DSTmpJz8V__6dL#GoGs~m4(t_8o$Rq%J_TDwd;zHxbe z%MWA6WJO9=b8XT9WMo0EoFqCeIS-ZhD}*avBIJ#9f~>g)i}iz=d>4LTc&?2jieGXS z&i8#^P}Lk;{)De2a^{_VhTa3?&1;k_TpEH514 zS)v)Fg6|b>KK^lRCB7eQUlMMNHbl^jDQ=MG=xXAEKhlNU*3v4q1b@17v!g=%;YXFy z8wb`;A8cRjy!6L00E;XM$*$6WJw4Vu9)!gvmHz>EYlE_^%D z*&Hz<9g>k8O)OVIwEc({PNV16kl&YJ)Q}ZvP8!xBt0f>oIFnHo6&{rcQk&UW`x_{? zykMHF(#WS{w4Sz{Y`!chk~nfHt*rQYM3}U6reYwqmz{Mth$nu4U@Z7wPE;rz)?#EX zRW+qPjbAW=xf7=@${V#Y)cX(%pgDq{C$XhKn`{9VDw#?bem;KWM>)?4lETr5Ntv)g zL}nDe$IkGd3FmVA{Ok;{o#alq?;9Byl`Nc^t~o1wMZG{WIiqWai0^ z`iR`9|7NWook}BLm)uMwck|K)dj3qfRKZx!(HUBZIT6mg{uG2vNz#1R@CWkVRyy*2U{i`N`>Q}xTO{gkd9IE`>4es)Jxv6KKPY_FY{+t%LcCrU zIZVVgS}wCp|6aib!MTHx zdkLhLgr`(0f{kx@xvJj#lX_=^tZH7(v}=FBv&*>be7Bk;?rmx8t*w@i z?riDDY&9+p^Lx9x>YF{^$HYi<5$8ehhly4SiA4-p8J!n3{sFMo mdRGRU!LbD&HgH+8LzyM2V38t=__L(X;%uwOK-{;*Z1Nwa{Ria$ literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.battery.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.battery.doctree new file mode 100644 index 0000000000000000000000000000000000000000..0261ee2230947a91fe2b1e8d3fd230253d771def GIT binary patch literal 2502 zcmZuzOK%%D5O(ZHvTRwllcp$;xNQ)mY0yY6f*y)o)0~XDKp#O53J8iziG;Z1mgG9} zAwYWw5Cgo0{Wbk_{kXeYTS5#N-Wkq&zM1jgoqzx9Z&g3x&=o@J<(OufHW_y@>}H0Q zIoCdZj8FfG@8Y+iZ|PfSO3Qc*TaaKvs?2g7-^4IX;$A8@ZuEPOGcS#9)kQ~iMej`% z{m}8!D}Li8JbCqcGJ3_#Z!#YEQqRxSd z?~bN<{k5Bw#WgXdY+?B<$&{hz={!9}aVYMKfp{Qx#7X$&<%`K5j$1e3Q>x75C+-&B z6q8r4o17+y&`s*duDNZAZYDam4q1J9wvD*OR|r--L~xJ!#fUS5N{&`_9VMbE>!>L! z6_3!F$7>3o^s?#$6;Gh>6sd{t#2!-GsZ$cqHbYohUMaMN7SEFItuSPzO)Vj90|qNj z-H5R3xc5K=V0ql)Y-Wx2TxT(KUsF}011q44!}HLebImRF#zqhsMFTy}3lRIY8v@%4 zkb4bTS_SIB8%9#&(kt9`5SP7-;m*t$uZ`z79?x!tg9LJ2=43fDHjm&89q>{RX7V&U z4kqu{9Ikl9A#bG@WCb61Y!n(iori(tg|VI}e!*2d+YWnzs+R18W4@HAm8ZURE1^#4 zWPDoA;cobrT8&yk!g88})AyD#;EOHdhcJ}7C_UktnG8}f^h-Y*{Rm9p`@#An;no^U z1l5`17IjXcG9SaCDgC;YPGu#AlZ}@R6XMS>tc_j=uu^@n{;;7Lj#2^+RT8L=LP9Yd zD5~cropY2s1HFw^6z*EU-DV`?1;7C}6393YU1szQIieggBL(JCE~Ds%AuYWj*Q~HD zfvAJ5%nQ<@4pprf5`eRss$}r6;-IwJrQTn&3dhULkY%3mbi|j1ah%-LtRTWXxsXoQ z_&g+;babjxB2ARN)ij7_VSr>D@K39K3dl5KWF}R;cs@^GaDr8mWYFGZEknQev9nte z_&iP{1=#30P^e@sef;_8Nf;KqASepQAhN1pgT$Fq#GWQ2d?CCq+>6swu-&-0^up+| zvGday?j^}807w$gbF{~!9lPL<9)JG>>N&JCwqZVTuFZe5GLK2639k!o$CCS5TX5XBvFRZrnDz%ZBmBD*TaS?S0#k@qAcJdUB2p`HA~ZjD=CG_YZ9 z))L(`LO6!t_Y$-I7SF}03;o3Kmjw#@E{f+@PCUflQ!#Mi;AXQb?E@y!^5h;CYfhTU zm0TU>O-?O`;L+TCYE;|*O7yc0W-Hxav)EsGt(5Mp*~f0RJ}vWmo3@<+0oU!AzO< zK@9uMD22iz2b_%F%ZC3E$-j@k0{!@x19OCb5*+$nJ8T!n8hgKGS1sF@nyE5N5SgcL Q?PY1VHEST<+j2Vo9|8X8F#rGn literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.batteryAgingSim.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.batteryAgingSim.doctree new file mode 100644 index 0000000000000000000000000000000000000000..a6ffa5c39ffcf452c5ffdc4af5ee05597019f851 GIT binary patch literal 2542 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 TWS+XUm!;j-tbufI%jx)kRX^}_ literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.batterytest.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.batterytest.doctree new file mode 100644 index 0000000000000000000000000000000000000000..0098e2cee8b9db3012abc5e20d677d980b2d1e58 GIT binary patch literal 2522 zcmZ`*O>Y}F5OwTGvTRwllcp$;xNT6RX^==Rf*y)o)0~X@(6m7h3J8iziG;Z1mgG9} zAwYWw5Cgo0{ayV_ecWBGEdeoLcxO1@^Jd0>cmDmazg7K&Lstl?mt&e`+GO0tu$viH z=3M*uDL(lpzK=hIzNPP+DJ|nMY(atvsWQuTd>g|siF>KsxY6%9&b&0bRTmx66}`7n z^h3u>ulS9Z@buN2$>!B8L(kKBdWzyu+!q7!Kd3CSZK*bs9b1RYzCPPV?BW~rPCP__Px!@%GlQy*Ry7_a;zo%_ zO^K=a4xM_mru12FtG-b27)no&rg$p$kls$6o_Mwy%F6mmp)I<2mUM50AuDZa4{4h* zSaIs6gk8tI2TB0d;}&}}YqaM&i=q35suJB;fma-!hyI*vZmBmmg2-sX6wM0|`?VVa z+Y69;4OvcAUDQWMiF+;tF_y^P_`%owkY=QkeDZiRycd|l>bIWsno;0ztGQxInI zG*1pD@7Elzc*P;_q!(lbC3tKU8f=}1f#rp!l&F=bzH}?0 zPUvKOTF&8a_>NkQT0z2cnuF8#mNHhYt=!PLJy&>1E zuq}b8gRIO8(xMJktr!x3vzn@8@UY^bwA!WKU$Y9w%gm5vp73#|3vS1f`&s1! zGk+?4uHdZi=@cWBc@fWc!wCSHlXf=S1c)mVLaxG*yVRa8iI8)l@C)$XRwm(o;Bty7 z`>VuII~3|}Mb{)zhS8?9Cux0BhQ`;!hALMjg!ZB=;38ea>c%xo;0ow5OzIghu-XcD z(w=bTbVE+&3B1bCdKA+QT0~$bpYjazdx;PP=N?Y(F-R>4=dhuiY%5`7HE&FKYL z)vVrWS7C?ii*(DvZoNw|ynv$AnZ$5-;&F31b`v)KF@gfLJkB{_lcme`9@}n>TVFS@ zVQtnD-84ctjNtbYv;G#(#iIgnt+u`dvG07sncVzhze~+n1WDGD{Gd Sr*7?KX}2|NAl=(?I{qK6uJIWF literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.capacitor.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.capacitor.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b541481604c364c1bb6c77f8e8310632b5c31151 GIT binary patch literal 2512 zcmZ`*OK%%D5O(ZHwrp9plcp$;xNQ)mY0y|Mf*y)o)0~VN=quMl3YhV z1ZWQdVt}`>KdJw#ANOTTXbl+N8P0pYnem^!zyBF*R6pUs6+-Iem}Z$a8Fw-4WQLVF z*FJuXPydSV;@4qd>04(?%XkbMkYGZp%yJ#y#4t+YUMe?k^tT;nUK-u0i=OCj zLeERD_>GtF^wsOh$tz}lk@=VjYUfhVC&VR+7L-YE?3cO8N@z7UZvV=cDYm4#v97xD z->UCpok+i+2-`<-6b7WrQ*4EPliqo_t)%AhyqwaoOTD*pT6&Zvm0?R}E~UK96m#v=xEUt+uWedw^Nu~_jp3c)#6bItI7>WmCOB{!vUcQ+8=D2keKBdY`e&BB5 zO)+`(y2)yS2;HQP?3&w^X*Jccb;#@UvrR-UzCgI*A;NpYFHSf!sOL#r-II!Fi+j=( zmx@Q|(Bl=A|MArJgNi3md5Q$ZH)0owZPkg1XX|0Kwp)d++~Qf%y%k2Rw5c(qYs0YR z)a?j6j(ZPm0H8-5;%3%p&vh0<|20)5`p`mF9Gr*2oNI0=5EMaV6m9f0FF@?oZU}5I zK<+kVX%(n_Zx~7KORsR(LtOSUhC4H3yf&WScs#om_7mK7nUm$r*gS$WazIT%n90)= zIhed(bGYIahrE?ukQPMn*eEopIuAq33u8S|{DP}^wi$K>RUO$2M|>$!D^GptTA^O( zWqexB;coPnT8&yk!g88}Gw_x&po}fzhcJ@5C_UktnG8}f3`##c`5w5y_k-0(!mTxy z2&yy1E$W;?Wj=-jQ~Fgay~;`q$7?TZCdBVyR2#hxpjCaa`mm-M4pRaSRT8L=LP9a@ zE2`%uopY2s1HFl*6z*C;-ex4@1;7C}6393YeP;9wIieggBL${YE~Ds&5iPwT*Q~H9 zfvEkg%nQ;-IwJrQTn&3dhULkY%3mbjX*5ah%-LtRTWXxsWbx zxMYiD($T3(i8N7ex6>e=g&~r0z(1`vDhl0kcuwG92&u2|TqcL|0UP?S287!FT7E-lAy!oEL3P=J=l5eICtbhF-J+pTcxy9PF_ z%{ro=MhGVn{O!c7zr}NL>cSu~{AGc{zKi1dl@kx~_f!mB*uUAVN_!u7zCv~aNX+Apk literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.chargingStation.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.chargingStation.doctree new file mode 100644 index 0000000000000000000000000000000000000000..4424f28f4d61fedb7343f140b3627f31bdd23533 GIT binary patch literal 2542 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 NZmZWoytl=4{4WLh<8lB1 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.controller.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.controller.doctree new file mode 100644 index 0000000000000000000000000000000000000000..29e94b5870b2b729f81bb22b44b8f51b6e4a7c04 GIT binary patch literal 2517 zcmZ`*OK%%D5O(ZHvTRwllcp$;xDOO*k~Wfypob#YG$*4zq;1fH0)iqbkq~#eCAp4# z2+$q^!~kz$|5SffKkly9mVg8>vNN3bd^4lJJOBRI->UwFLsv+ZFUOSg+;HJy*yVLUx-^4IX;$CStZuEOjFt1GBs>_b-%HEqO z`=R5N*W$)Y`2OYV$>=3Bzo~4@B(-yu&nLts%H-Y}t%dzMGrWXaW90VlVwr+Vx?7vN zTc6Ni{5zosh4SUpktEQz#VNxM>6n81<9@Er0 zF!9~VX;y#j^0K%lrj#wLm?fDq^gNxXrzj8QeL0X1TEuU5SF26#&@*BkWSX_(*Gbrh3Rp3!YwDlb| z^`-J#bm`%m&Zm5>dP3zR=sZD=@&~zx+;-~RoHfZN=r&q^k8+00NXAx3HU8BqDMiL-#e+C0enU(T)2sloU%Mf& zy#Tq_kfqh24!mI`buhicT?cX5%NXv=jPbeg;>P3It#FVqpO+a~&Wz0>I70{E6oi>9 zjgo`O`!z>sQE|vy8%Q@T)-%^{SR*RHw#sUAdTCadiBSvOQ*Bj{b^aUr_DM<$HP1ZR2y^j^% zlECM28Y#dgp96(jWy;52j~<0#Aqs+`2n-^t3N}cbDMjpQGQtjoB)s+X=k%dfVd(dsKk77>`qrh;RBFA;(i!o$fu2B`%R8C9C#W?NC6p%3A>xw-(W zp4B_;D(r~-A|0}@TkjGKFQBM$t}q;)c$`~--GqgIjGzE5k4p~N@N~A`VcV^7>(d4{ ztj$`Yn??v%5&T|a*5C4(JawU;82++AVc$jh?8?b+@c*eCxNvZ@S(WwyQ)qc|4~sP? z&E!h14)Z3bmP7DpZZA{zoMLKE49_@!JD)gkK8|{jMFhi(`$w-?FQg?W>&Wk|&7F SQ@8eb+HK7mNcXm!j{gS{neMy* literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.doctree new file mode 100644 index 0000000000000000000000000000000000000000..1ae7fe815087c72e55aa8e2b032dfe8d177a5dca GIT binary patch literal 8602 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.electricityPrices.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.electricityPrices.doctree new file mode 100644 index 0000000000000000000000000000000000000000..9dbf6bee9c0b7d98493da63ece349f298a003483 GIT binary patch literal 2552 zcmaJ@TW=dh6i$=cjuXeZlp>@yK!r-FsBNftKz%KJiii-G3M5yf@$T3&^6bnqGn+aO zmEfULBh6cfpUHpVo4qBrfJl+|oIUsRopbh&&R>7`x5__%Xmc*qYE08q>6F>vcT=4d z8B;F250C#0Z^9S8Z|G~Q3zM+mw;+*lAydOtcoqCGiaR0gxYqAkmN=nRtIj*T%X_Z^ z@B5AuPO=+s{MRpDPDd{i{gcSX38!Wu)M833C?;XYh(x%{AMnHMrJZSZa41tO%Z^BG zEI}`k)LJm{+)*^Eo_5nBzb0lhSsFHvGKKFsx`?j=KjioLfZyjk{M7&U{Mqyu%Z#0} z8I^ka9kWZP^XZG1b#_xkXs1d{r)rbmwahtS2tYn=kvTV7Ii}L!yDzCM(4Pj{{P5iO7fdljoi+hP zO3_|NvmC^J<%Yoa669V@7Dj?Pa5^Eet?@0~br6@i4E|)UwNu)$8!yjp`GYtXs>sM{ zu1yxe8CswzCyCDDv{{(ES8>pUl0#k#$4LV&c&rs_w4M8bVYxPrNOr+wINSDnoXVE$ z_+z#bsFkCxu#Hg1cTzSh7H~IwO^rgWAYmBI!09_f6QD0yhIf7_R9-m3RH9Qz1>Y~+ zeDp1Fg6I3|F9|b78^WndB{QgV3^j4VAL_!bTj`WmfW7ul>i`NSh&V4u0YK|OH4v~@^ zQ!7@1cm0qSPLpev-xfgBL0V)vX;Fu&mJ9*F8AW9@cvx~!T4iJJuUWZeMXJdvi+DO> zt6W<~ZfcegNgTNlR#f;rB&o1;CSxLXl)Yve_!B=sG8Xu!orfAq)?bCweng<%k}l@a+Ma%L2<$I0*? zap!XTY%&4cj`K^$wHj-)m;`?}N|pgYk~o&3Jr3>I1%LGLt8Y-xp_wNe<|F6Y{O65% zOe&3dT{1Hk%*{(5nE45JnS`^xqce<9>UcQY^``)2M%vkI6CgH^2)Xh{_EI^zB3vxE z#6Q4$Tk44Wfz2qU?DqmgZBeK@C0&t3>V(#%J&miBCTM&$Y^ZWsLTE3G94_LmEH7Za z1g?M{od`7t2AZvK68D5HW*c%Mi{O=-R-+iN(lP)u*^H%_-%EtR8FO%QH-XfWu#5^x zaMlegZ__(}TpwnDRnDuOcI9`Nx`@}!?^e46!wV=1l?n`pBMujtVK-s#A0sG0%i-7q zHfg+NZ?NswxYfM_8`kD6(TyX7Qwe@AGOK6)luxYhM~1u1QP?+uKfSX20e&ZZVEw_( zW|i6p_!uaW9RX5t;!HMjRhTz9l^lXcbF-P2ZU0Nr4>p*sbbrlazwufsovhi%ZZ$40 z^Shh2>Ni_{4;v%VMcfC$?NBD%W=y&C?T^wud e{gz#}Y+tBE7HNdYB6e#pjk~R01M%J#v++N-aQzVg literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.node.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.node.doctree new file mode 100644 index 0000000000000000000000000000000000000000..33eb69e88a38667f035e9da36825f409efe8d78d GIT binary patch literal 2487 zcmZWrO>Y}F5OwTGvTRwllcp$;xZi0SG?I&;ha%TBC$~QIBj`Z^L2)UO5SQGNTt_|x zXb%BmfVZ&!qCc{ayQ{UO7%;pX&J1VXyqWReoqzx9Z&g3x&=o@J<(OufHW_y@>}H0Q zIoCeEkB|R}Z{oM1Z|Q4iO3Qc*ThL%as?2g7U&Sy?>Ru{0ZtQ!GGcS#9%|%CaMekJ< z{m}8!D}Li9eEs6(Wb}fW-()^!g4(&%^9gY{C3m0aCM#jknBV@LFH=~_YHQPK>jSH| zu@1jmPz39vI1YW%W+!$+w@Ky$gZU=IBk|=>yXl?XWIx`e1=HH7l`ajelg4jN7o{g$Gm}9phJNX1qaVQrd_P#fB-~nKiJ&@D z+ydtmD)TWMn$oX(=~P}~IN7+_a3TH-!`kU}04vi6>lYiA;V32GfRX?{3JJw}YBrP^PM3dhULkY%3ubi|j1ah%+=tSG`fxsXoQ{5&L? zbabjxB2ARNRX2zyVSr>D_)n_=3d%HUWF}QTZ$3_6cmxw9>7cyHTZVe?V@S70@bfse z6lkO8V4;$^^zoOYM`2j-f&dhbMr0LWgCvTY$ek3<@iI0891<-3U|_+aOHGE zPv(id%FwzM)4Ewia3-Jf4E=kF5CrEQkKAL>S`eO7sR*{R<<-)87mk~~3bLwMJ=3nj z4%ZiHZH3)>mY{h-MX581=J3R0p>oV7jQV2)1!{ThYS1Q2OX>}#-I}ysWDvvKtUYv7 z3t(em5x9O|7*$R7@7|fJu9>lQE zj8Xs=IbdbR;c5T? literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.optimization.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.optimization.doctree new file mode 100644 index 0000000000000000000000000000000000000000..ddebf54ab5a042ffca7294b3335159c321247ff4 GIT binary patch literal 2527 zcmZ`*-EUhp6z|$4Y1$-hH-?b50uvfz(4=VM0qu3{siF@sCLS_bj;|A2@x8v-zFmqm z2_7b`lHX?jGyWiczF%#ER;lVe$LIU}&N=<7^UuHit@6ho*j&hLHK9q8>4e+hcN5Ku zlxHq{2v7bFZ^JjfZ|EDV3&VKuTaaKvs>JXtybgX8#hp}kQtS6DXHM#@RTmx66}{I% z^nJ%kr}&K*fAZqhbo_$pUu8OBf|`ZQ7E@wD>D)FH@ZqP^`_|e#uucyr{jk zslD}4?RTL{r<+p*?}9k;ebQztc6_%^^4#B6GUMUAm{Gq+oilP)I20!qV@D=7Cf;L; zS_>w=I~h%@uid1`uZbCDOT*_;rtm#S7x5{G194vr!~?M-j{VE$&!)dwZtRrLsM6D) zxLrD(PhY&M6PqGJJFOzS=C;N9U$zrtk=o~H+X!BKfr!OJMEEVg7;~mk*l|ipS7;f=tDCVh=0@D zF=#kdU;M7+&H*aG>ro59xzU;9SrUBr6;%Zq(jZtIocsQQXWUSyO#qQl^wZHa2eDtd zA+Ws!xmS~gQJ{uSGZOn4U*WEUxXfkncjj8VOgnz#@$8l#M)YSzN>+1i(g4oL0zNrm zI*mhRVe)>(;fj|W@OL3yyLpptrH3{9Oa!n}j4h2RPtH0vYGN%XBtJjwpvrNRBa;t0205L<^_M zHOp^HAZnNtX--)WQS~^oPkvhs=GY#Uz50H!n{>$YEqr+N^%%!UK(5LYWPOw?x0!4eHwFLd% z$1-n8;PWVs6kwArfI@|p>%z~6kNqg;IYCi429cEo8$`~GBK9~L{xjiRZl9f=f^8@H zr4u@vXtOvC{$7+U1AruPJVkpP+OZ4%_|f-2pq?W$XB*}t=i2<&jd@Hejd)#hGm+fQ zOCOl|Q{hqtXMIO!7@@?8aJK7@0mziJv)Lvyh_0`%iQ5X=$&XRzpZ<*;2GYwZ1&UAAmrW=s`H UgvcUxYcGkrtzHB1-WIdTf05(!KL7v# literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.orchestrator.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.orchestrator.doctree new file mode 100644 index 0000000000000000000000000000000000000000..7df861b6a994e414419c8bd4b3ce869a42346501 GIT binary patch literal 2527 zcmZ`*O>Y}F5OwUxvTRwllcp$;xNQ)mXb^iIcw^99s16K&C7bBWw+GO0tu#*{9 z=3M*uF+Tk}zKh?6o~3V{DJ|nMY(RnusWQuTd=tYUiF>KssL}5_&b&0bRTmwxExK=_ z=!K4#Uhx|*;pFA(@$e-xzsY>W1hq4%XJg_(8OsEB-coPu*SX0`C^lwpzv7D&UeexJ z*WUP~_WM|;vt3XG@1r;hJ>~LA;VIpo; zdDv8$ibv?y;}xw>`&;&giYL%|icH1#Viy^1)ftMD^_a0CIUXNM;POZ_N>nw)t*Ho2g$P&Tg;5_tZT=NP|5kyAOPfzm##9r-& z!1f&EZbOzQ^q6r=wg$7>dp>KI%tS5?Ja23xs!>*vJB|G7WFC=Q^sW079 zs1rIFpOiDW8@#1fqgIfxoaW&4FjWk2WApeS45ThfPq=0#gH#N?(ocs!0Uh{$u=+^2 zwZ;-bb*8vQol~gH$8cauziOpZS&89z?Pbk`_#+Hzqt^i}RUfQAtZ9bBlz>B(1nQ%Z zPz?Ku>RCx=9OceHZ(>J}fK>7sC6(JwH7K+l`7# zFO0_0o}I>UFG*GbK$3W#qdgw&*a3g|_=g`+&w-t?HS>vcZT_33c}yxzc%5@QlH5-# zADH=5;d2FNJx?bXq0EbTwiAv4$egsZ*(N|-kq~kf4&9~pbU}oi358#P_qH+#_kEXB zOxd3$hT5S}cPqLki872fr9Dmylrl8F9yV0DDj~GzWdRrIBvyy6Spru;k6}_zfq~^# zxRdsTD<^AmGEd-DhSsB)&d@vpGx>yPnBPl;AUOAMa*si3PIykGBDmg`SI6i>IBM=M zz^bP8PP+Z#Jva-e(dmPwru{ z=A@Zi%GF`s*##IVPVQYb8Pz{%*oX!swI{QLMT(2xH>Fh}^G!J*%^!*+43u=iSa)v`UQnJTjc Uky+~2ZkBdivj)<=EhnS@0Bqp%8~^|S literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.charging_sim.simulate.doctree b/docs/build/doctrees/EV-EcoSim.charging_sim.simulate.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2f0f2f7ebda8ca7a854f9cc7521943b024c06505 GIT binary patch literal 2507 zcmZuzOK%%D5O(ZHwrp9plcp$;xDOP0p|M;9Jrud7ITIlIF&`=Ef&A z-^V(QenAnmkK!l{NSCG93jHRz^Ke^9&Et7FrD2zPZ{@V~C`u~AmdspAc$+Ee9GLj- zX`0txJ6Ty=6I03-md}z*8MZy0r>7_m#Cn40km6`m+-NKt< z^6GVy)C3W_NgdfWw=2?0reo`n)|Y3S2wZ%HXvH^(?h(H@;mn|rCv9m@646%nq^T?w z-=aGYS2RBDr|kt5kD>7t*@^GOF0$IHvl7qNgJ?~+3SF(mv!r_~j96(?S4h``Vaus| z5q2E+9*~=L2%#88ccz)yY>{i%MNY`afmNR4X2+qg>G6i8KPXpv& z@_xtB_ z&J?$(a|)ID7!FM7SFQ9aD={3ey{wrKe}++Q^g4i6^}*`Hnr1jm2{=?qpgsx-#jvla zo|kmaQSJ=%CiYRdYXNwhk&G7r2i!;?<2>}4(KF$Gn7)`m1q8~=I^oCrs!lneG z_OmiCNQXL9wPHvB&T6WX!Gnr}(rTA_f6Xc!FEc}ydBW2nUlzu3a#OQ{2=nAZI$7iM zfMn9qsY;17QEs=>AfAOGl5xO4t(Gbv(}sfdy};c{ocdk?nvPC zD2)_gqvt@OlDYKp=flTgRPchJC>(>xs)7v@XG#%!nvC#;@V;;_PEWyh4=dm)i2`0DTBY&8-Dk)vVrW zS7D3mi*&-mPQ6Poynv$AnZ$5-;&Eg-b`#e95rP7=JnlDOlcj_84%=>pTOT#BVQtnC z{WLL27gb*(1rb*&8oEbnMBKzdswVFX(n5_ zI?S7#S`NXZx%t$nuK$(jXKTz(daz<~(0Z+u?yT6yZnZuw^Ly*InwO2Ri;cldnf5^p zd(0?>!XgKpjO~{V|09xrAAbe<@m~k#2>&NI^t*Q0EshoTUdOIlwkI`HWtJc^Pu<$h O(r#&_~dN0)paFA|WohCAp4# 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 MEFk`}&c>tv0E^feB>(^b literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.setup.doctree b/docs/build/doctrees/EV-EcoSim.setup.doctree new file mode 100644 index 0000000000000000000000000000000000000000..50a8319af3fc4b00666a2354410965c1d714449e GIT binary patch literal 2425 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.base_case.event_handlers.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.base_case.event_handlers.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2064b96d351ed969b2f5438a6447de235fca35e9 GIT binary patch literal 2581 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.base_case.gblvar.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.base_case.gblvar.doctree new file mode 100644 index 0000000000000000000000000000000000000000..e2dae84f6df728104843c3c04c87f6fbf2b6c8b3 GIT binary patch literal 2539 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.base_case.master_sim.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.base_case.master_sim.doctree new file mode 100644 index 0000000000000000000000000000000000000000..76bd8553c26aae9f318810aeae6d8d9cd81abf09 GIT binary patch literal 2561 zcmai0O>Y}F5OwUxvTRwllcp$;xNT6RY0yXxf*gum)0~X@(2t-f6c7}b5(#n1Ey;D{ zLxA=WAO?5~`&WDJDH5-n<#=ug*XJ_O_}|IC6!MdNHC|rcK6O411Yj zWzMyapW>6hM>%z#+c9x6|2j8W2?LF}+rRQf z3Nu;RTD7vZVx?X;R<>5He28^=y9GruK8lmjBW?C#C+s#!UxeFAY924j2@U(ydn+d; zqOHK$k(oD{PF7L z_&3L`8}kWOX8a>}b8m|A>o-k;V?^l2b!0cv3cQu9t7VgP%6ViR68!Rf8!3pdP*m{{ zaX#ahL(UA&hY9>)h5ayLUoD3<^uu)CAWy|NsN|!yyZ`5VSv4viYP*tKt zOOA`9i_n{K%`NrDMr<;gAfb7I%|Y#k!1f&5{bpNQh25byjHJq@Q@HCOE_)TjovATi z8_!n`&u@jp)E~Oc$zp139w8Yx5UL=|Pm3}(>0kpvS!TKTL)*4F$)tTZJIHypVkKxFae%(r^vJ%7T#>s{W z@p~B5MsEUGUVX5BuyHdSrvw~O62M0xp%@Mo)w7b$IN;8(-^LURcP*O0W+dYU$N@JJ z%(w`<%;+g{1ROFW1sYc_qSy@sT6#lnL}6QkQHNQX7o=q!P^|#p5c@fX|!YK%uleRb81c)mV zL$1TIyV9O6h>$a(@CWkVRwnVj?{bPR`?Ew-I{M3l7z%|%onAB5nU^x};q&eZr$%dZH6M2=Pbt|TaX&%9ue8MyI?-fE2 zoO?LA$DlPQJf~6-yziD*&(p_n(!9_htD4p`?K^-L4nzVlMAcnPRyV*@Ggx3=CZW7jO@m!p_&`Sb;RRGxc zQ9QqP;vxQ@iM|VmtHr8rA2NxOC-<;eOHxlR_3AKJCAA)cM{)CsQEmMz)z3DBt#)tC zVsGiSx^!pFK4z=+X_(*JwAGw!g?&s6X38`VVmM$%DFBNc@MLsfHS$kL{zLp3?8k2s r^bvkVIMlm#*ba_0@j)xDN_HSMQ)QMYGE3Fk&(dsb#z1;+%gN|J;%)vq literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.base_case.sim.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.base_case.sim.doctree new file mode 100644 index 0000000000000000000000000000000000000000..65f5b8439e865fad3d8364314ee4869ad6202590 GIT binary patch literal 2524 zcmZ`*O>Y}F5OwUxvTRwllcp$;xNT6RX;4cpf*y)o)0~X@(6m7h3J8iziG;Z1mgG9} zAwYWw5Cgo0{bBt_ecWBGB>@#+nHXv-F)arDZ&ZEpRX)Rc5)4Z(|rFb}yA1HS%4@nU_Yl;-VvVMfYtK zz0mQ}E57m)&R)G44_`6!TIM6qogWiM9e1M%zU%YI$^7fwWF-U}HFtmGi{xIC-ddI3 zT9K~LtI{809nNk+;k=LHB=krdt=I{>O^}!2u9BL^%W^`)KK0(pNeS<&WbDYyrNFyP zQ3qGkxua=bpZ2n{xV=m$n_E6jJZ0#5I!jMc9EpdbFCK{LX{c+ z%-!6ZV*Kh&6WACYx^eBVca&;W0hbG5Ve1lp&SrhtSYs?6FLIy`Z<>B>_3QlL$`I7_m3 z!hn@Fm4~#&=r1XCQNo_%-b+0LSWjB?O|8+M>nw)dH&m6V#uC2b=rZ(XTysmku@RSy zrXwa@Bt-|fl8%9zQ(<{t%;FrCQ;oj63uZ`y`j~92sVS>IcbF!Ek zn@3Ov4%jIOGkNML2bB+N3Rk?MkayAxvV;;WHUbT{E<@k)!dOofzv3!hY=?b8ReSA( z6TXnhm8ZUROQuffWPDQ2U~ce^T8&(R!*ZH~(({%wV2#b=$1sq(C_UktnG9Sp^h!S+ z{scVW{Am4=aBGbvg6d3hi##V+nUCSflzv@Hr_vI`>Bh^33h_r6)Jkt1Sc*Pcf7p-= z$0-1ZED7XCA)puz71gtn&N$MY;l7Ol74BQW-ex4@1;7C_63Dm=yUge*VnjM*Mhf(( zTtu-O2DJ2s+>*k!1fmYJGA~GrI%KsXNC3`is*=K^ih|T?mui1YDjY8}Ll$|$(=lHZ z#&NPLSwVz(awVOt@p(it>F7kIKpHQ*%We>7p^so3@K38L3&=EVWGYoXgg#Fv7{ORc zJScC{mZ9DUnB?sh_&iB11=#2rP^e@sef;J4X&4l|AV>;FBeE)C{X|Lgf~3v}UkL9D z_u~8A)uU5s z!t0#dk>q|_*+9>q3!f_(>v=js3uRu!i@k6PK<1?F%{BnyiiD7xaO|$NrwbzFOep*T zymysJxbM51qRaj)(bNu!x?kPvD^Z5gCbg$bQ22ww*Ug43S1E+_yewcM?ZaxzHACPA z=rK&{DKM~{3ir~SaOGr!Pv!}{%FwzM(+-+PU?!jN4E=iz7X;@XMjkM5%?Zz`R0ONr z@@f-(3@6R<1z6Rzo@qB>hwH1f%fengOVGT4qSTp0b9myZopH=2O#Bl#1!#FJbigJ{ zo9jKM-5RytZXiS3w7u-67Q$i#y_<;jSv(i#F7y(?Ul&O1`zW5@IPn<&&qd#b!_{I{ z(uYi<Dt%UBa>BnrfJ`M8+ zo4T5pt+0=Y!AzOvK@11XD22o#2CR(k%ZC05!GDOq0{!^;fj+_y28Vjr2HU~0Mm}iC cRml#dW~$5*L}sa4`&pW8%@|1gww#Rq1JX+GF8}}l literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.base_case.voltdump2.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.base_case.voltdump2.doctree new file mode 100644 index 0000000000000000000000000000000000000000..0b5ef6dd6e8c37742bd966cb530c9c6a928b9d34 GIT binary patch literal 2554 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.event_handlers_oneshot.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.event_handlers_oneshot.doctree new file mode 100644 index 0000000000000000000000000000000000000000..f26488113ad4a79b72e34a62150c261d5c20e3d7 GIT binary patch literal 2611 zcma)8OK%%D5LWC+vSeAdlcp$;xNT6RNzh0xf*y(-dP#FK>O&tv4+;osml6qa$t}rs zE3MN~g>QznAKy z$e42BV|e;cco&}dfuV1$E=l9N?Q`DcJ>Gv4 z_`r9aaFX4)@jtzKJ)68r^lu`YI%eIBB-AoHom1zSxty{KL^30ss#G##XGAMzxprS? zIxS$THhlYcwvGWud!3v1I-j!FY3+5k?Y$3G%DtQ-K^OS3ACR^peAoBtLY({CQYaSA zi#hc}L~F#nKn7*Oc13Dqar%j*7U{(AuA*7>wU-w8^9aYNdiFE3E2s0>tJig^Gel@-Rb@Gkls|@* zr>G47jt^0h-Krw|*>G-fJog0N8W|KRow?B~#2$r%k{irLjyj%W>GR+z{Aa;W(_1g^@TNIGvD)d%T6a zF5)tm!QWYE?UZ)x#^u>9e-JxL6&YDCw8;V_V+*?FB+*%HR11^$D+!aVl#sW=ani64 z9_t4+9nby9uv{BQBw&=`Y{w5dmF=4K zCHRxAn=KRkPd~1VUI)-TeXx14_0k{31T3n=Q6Gtff(d{#uke``Osz&1LRNF@^Y{fPm_$(r@J4GX@ZQIQXpi9Macn8jMlHcYDKg>0FGr94 zIA=LQQ5YIADGN4=k~tKyw;BkOs z5Aw;Q?|(o&$7YdinU9id^WQe+(Wx}@b;Zn7Ft;dupyyAy%Oso)9G#*+)JRfA}pgq68s`CtXy6n{Bgb0K~}k_X4;kCW$GfXKfhPa5*CNx zkx;2Xb2#FtSu)Hftbk(#1!_6`P5^Dvxa{6x+HFXyg$OaME!smbwh(qHMmE{ld|0y3?e{d75^7TO?0C{u|iG&ZgMxu*24}#xMw3H|;a=^;yzpUjS zk^KAcE7*@;Ea)Tr#<0M}E+N|&Dv?DRDYA@c4bwQ=>M;=aZ84wz2T}PG Am;e9( literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.doctree new file mode 100644 index 0000000000000000000000000000000000000000..83c9d27877f05a4ed813ebdc568991f7b37a7cbd GIT binary patch literal 4556 zcmb_gZHr{Z6&`oCXQt<+XJ*Zc;I3H_<4U%B{SZR*ld!H5HqHk(Sq-!l)%R9+6?5;c zn|j&pF$l>A!Nx)m%YPvFMesM|N96zHsr%mDlVLk?pyAf3s#E8j=Q&m9%s+bH|Lb(C z_;bfP=OUYrXdGuUX4<>GSVlHwnepHGxBltB@ONEb(Pvs(6*2F&up;6ji51KIXWk9M zaw8Hws`l?{78xP4W;^fk9lraSzsvisXM{;uXUe_v@X2`iFp`f&IxrcTFFoDKDf}{? zpSnJ20>QW4PUZiZyPk-Q`7=AAZXY%(F|n|_h|{)+b%@Dslu!*P!gnvDY5BDm+q@l2 z;Dln+u*SMwLuX;i^JD%BKjgRgHoxu2gLlV&(M;(vo6tm#-)H*V$b9_pN#*4j7V2?n zSt~8Vc&Y0h&qqqb%U2&=vlD($!d&CTPwKJTe{3hIjBNrBifF&IB&wnYliw~)KI5;3 z!0=y#HT*T8^E!TS;P)neZ^2Xk+rqZ4Ue_ zNyh|?9+Rofiq}lnhE&%elx~VPlx_v3TkA?&i2uGB#PbfsFE2s-;f4^yx`5=cad;iq zR^{{I3YEd%b$71>6K-4q=J7|xb95(?nZYgDJWFfxHl%*Dkbc_<>7AvJ9>WOgWOd8gieDs1l3I%IsQ!<}Q zm3l}98f9HhBAJFdSVQG2rGzD{kdSA>a8g%!II-GLm3?RKP_bMpLlX9sCH~Phx6f(P z414aB%>`m*sIj_U)N{RGRqvD8A21e)pD>o2XZVh2sBx9`d zu5ZnB_=lku_`bC~NtjYn5l*u>VG3~$rbfoQV`D=PTE-Jn$38c=V& zwLG!1)13qdG@`^2p9Bthca+dL-~+%d-2&{nt?6$%p-lbGc!i*bwqGtS%&GH(hW z5e^ZP9Obi^d%oia)EY@zk-H|qsH51XIcZpjs1^c&i$i5J2?~!32|}CcfPE{sjS?svw`1phj2!N|3wP}rAO5=G8Lh^ zMyK#n_`)Hm_(Pimc!RbWcpsquYKGwFX-Fy1CYynUiAaUQ<05RIFT z`Gq^t7nz}R!o`dy_<_9F6B&4as8fn8`CE-2~#C!YEM7pbZCY;?Punf!l6LS~i{#L))|&?1U6T&kFf&5SHI}`Oo|({(!&7 z$NaC{a>c*lU-KXN57za=Dszz|+M&h!dBGnn_;|tXf`7B%KQ1hPEy#aD5BnY;V)qBw zO|W~;f8gI*chrTsIQJ+LAWJYDwv>{P&Gov{!LFoS2e(0sbRv_6ImOantq7ad{Uwe4 z`qX06jV1lKm6Zw4z|B=%)y$UL$6XUi8*UQs4kA>mfCN6^vDtl4$-hH{zVsg>Z}2|_ sWFY#z~;(X5+5|;0_+2kMTw0Axn=?9{W#o;)ddn>YC9SI2Wem7cmMzZ literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.feeder_population_centralized.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.feeder_population_centralized.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b399ce60d8be2272d9a7ace70bcb91ebc34a9875 GIT binary patch literal 2738 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 XRKcP|rZHPx7JFOW2I9Oe#>4*rAcsWN literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.glm_mod_functions.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.feeder_population.glm_mod_functions.doctree new file mode 100644 index 0000000000000000000000000000000000000000..d126c2890758583a80fd9a2bced973c7cf9ef660 GIT binary patch literal 2678 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 literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.parse_voltages.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.parse_voltages.doctree new file mode 100644 index 0000000000000000000000000000000000000000..1f4181257f2b37ddef595295a45274bfcbf02969 GIT binary patch literal 2569 zcmai0OK%%D5O(ayvTRv?q$vs{ZW{z?8Z?rNpaqIt)0~X@&_~dN0)paFA|WohCAp4# z2+$q^!~kz$|8CKbyQ{UO2B-nU%i%n~`DW-pJAePv+o*oRfh&a6ixJH-Z8Gj+*vSkl zbFO{-5TE=N-^Q;)&(b%}l$P-rHlV?TRGH;EzK&s#)V)-0)Yx|&XI>iJnv0Iu7TwoT z^g_o=ulS9d@cqkI`#OFLRTX@X+|X z{VQLjJd>M^n{GBf=4RtRZr;VZz-@#{6^o<>jt$Jh~O8oq66GezG&{**RnLgte zL(Yto`7kwLSm8fx@E=zA50~%{8~CYsh<-j=vHt(~%jQw>7}igKfcQr2qVlb}a`ALM zxn-E8LE8`UG}+z?16JD9Inws2zm(Md3OkN_FZB$}K5D5twMKicvlzBtQB|T*ORkH9 z^U#}d%`NrDMjSGlV4-<|!(JVR!1o---R4+Yh10$_jHLdiTZHQ%FMAoo@zfZvjpsKm z&u)eNG$*>u$zp139w8Yx(5fKJ-!Fp#<^ zJ>i;}3|cYtNMPHtLO6k(oRNGEH49*|5rI#H>RCd=+}8pPAkM==ikr`1XZWg0ay zm8#xPpQbMa!Ny5CXm9eCq2GI0`|T0@JW3-4+UOZrsAMjE{ORy<7! zNha9iBuz&6On6_o=clI-yHRoJh0!BpXQwgTO`25#&?KJcXpcubb|4=<`u02EIj~c< z<~~WT-G8-ok4dG8uXAoklKW{D12care6A3z=jj9^lz9=)cESk=nUi)l+X9Fy5<{-S zp}W+cE{Kpbq3{dx-c}~@zVC91Df^?uP&)v1r#jb1q70)Av?okZTq2w^=h z3xr6IXZ0jDOW+FZF-+ z?lNf23D2oi1n<1%)g$#j95pXB$f~CGPP+OVqKpq9t$587nuQG1JRw<4_{K8WFM+8(yk2;t3yyqkpew|FK_UFao&zbpXk+bEu0 zIq?90PetE_{hQ6ItoNBj%TsuGtR-nCmwI)YHzl2K%cAnBad2 pm;V1rxF5HRV@15zimR6GNzGK5C5p_F)ozw{TeAkzds|LM{{r4R1AhPj literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.scenarios.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.scenarios.doctree new file mode 100644 index 0000000000000000000000000000000000000000..41db4c02c00d8f961927e0216242778ff29744fc GIT binary patch literal 2542 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 WW{D#6)UCZN?Y3qOr1!R*j{gIfs_W(e literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.battery.voltdump2.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.battery.voltdump2.doctree new file mode 100644 index 0000000000000000000000000000000000000000..fba6b494bb27e8ba3aa4b6512852f596a89bdfd5 GIT binary patch literal 2542 zcmai0O>Y}F5OwUxvTRwllcp$;xNT6RY0yY2f*y)o)0~X@(2ukS1q8*VL_%D0OL86g z5THE-hymWh{=)u|KJKp8mVmYf3@?ZC`R2{ge{}x(ySG*SgdFDD38^y6b$lJeAgOz)+^DhdI?lW_x-}Oau`9Z- zqv(Z>mtOH3H(~tp)nxdRnV)1n^4$3eVbpOqno{q%y&PQ_<+Cy`o_(I1tb}dj>Gscj znKDccwr)Du`acKnVqMg3K~aK_;w1D)TeH{+yG^O*;kJ^R$MbSZ!#?t{a#|wC3X&a} zxm13aDe91L`tE3&*I#>CSzI5clr1cuC7m*KJ)NhkD2~K^(H9TIjyMg!zIZe9zs&n_}|vRa4sp8M;ZG*|oHS?B5C=S%>OAJ=;e9;xqJ7JVcU1elg_CIGGO< z-opy+VFUNDg?re*O~n`J+@m$a|BSlo6BUnP_yi@3uf;w}-Kk3zPd8IqMOYcM4G>S0 z?X56irA@6OZDaZ?N!_5Z=eYM$&q3dlmX9-QwC6gDVfPhPB|5Vrv^Y8sy*bz1Qg3X; zA)^Tlnin`6)L{sGFL2y%j-^#N9eTq^YG}GexDN8NmoeO#8RNC_{Kn=KQ3K1KFhG*xYZ+T&?CyHNi700!MSLFyQWvEsTr-nFD~4X_ zXT$G?PU8E)`X%Ak8cPJ#nc@~Wr&O7b;mDMJ-AkwP62s}n&4vr{TNu<%uM=3AK3Kol zunfnk00)!=@KGozhC@a5yrgpuxHFu$v9iKl3;NrPWV`@55JrL-=V6x_JwuIvLuRDF zyvk)1yJ0{}Z^*SMY)dfeFzqDLvJR+L0tv!dO;vJuR7n7>cB%K*qQdbqGh~@3J{|LA zVH_tnEh~yJPcEdBH9wC?CLNusR7jI$cQp;-Y3QRE2maG)?}9Ro8ktE|FQkvt7lL5L zBptLjdCSo61MK$p2!5WVkpgY>94u5amp=Y*{5T8>UJ!u7F^H@Jte+%PENhY`BYYyf zFWmF-7-BanF1;{%WbAw#!@Z+w0d5-pYv||tQ;iGT91)c*tV;k<1voC}3t zkoUGSiT8b%Q%u?KC5GAosJqpprX{7#Bg}xshxA|CT#r^Bn4`DJn^7S zmR_;9*mi5u`lW*y-e&D#H;oV;NyxiNSbvLWV(daM3H)UNVBbdZ?8=FU_&XMT7Y=VW ztFk_15-m^R;jxyanOy1BY2K97dPpA4&8J4S{jXF%+7Pzdy)}=$Rn*Gp&YFMhR_oI; zzqjeDx!DT)*ci-|X&=OJz>HD=7B%3>=)P#=A5i?e_#@ble?>4y_~*f)-*v!tajc0C eT5;8~1F4xRvqX`3>ehaic3ZOs(tBG@NB;m9JNOm= literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/EV-EcoSim.test_cases.doctree b/docs/build/doctrees/EV-EcoSim.test_cases.doctree new file mode 100644 index 0000000000000000000000000000000000000000..40789528d880a682e7d31ab9a83f3a880de462c4 GIT binary patch literal 3322 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 OV3IpeJ)hi$uKy1gWu=4w literal 17524 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 diff --git a/docs/build/doctrees/batt_sys_identification.doctree b/docs/build/doctrees/batt_sys_identification.doctree index ce2419ec2d75c7b2ea723935547577efe62c46d6..c15bd6855df86493ef7a971f38c1e1182118fbb3 100644 GIT binary patch literal 51802 zcmeHw3y>Vgc^(e92ks6yyhxbx@u;B`5)1L}2teXPCxQ|Q5+nulNCAAtpjLCcb2l^C z-C4}c;&5^)kz&gx>=COZE|u7pE!(10PC1G~>t#DORV6#JVk?zO#VIFFSyJd&sl-)@ zY%7#q6-oL2eoW8I&i2mk-i3!Gtm0v|r@Q}W|Nq~AKj!^oFFf)GJJ^5GzMyG4jmwK> zwc7BiR?v=iSG`KBZZ*R8^X;P_Xuq#riY9$?J@8t7#cD@8P@`fywW@D5+RwD38LA#S zwO~=Sp9ri<=y;8|xjkl&+Y`^UOZH?m7CK?gO1z5Z?lr^E@;8ig8$oE*jfbiL?W{T# zlXXH3(QfoH>oOtKtNI7q9OLn(3H-vgeIS}F#{}8CqH#gTax_|V8diI`wPHq7K*4ub zS|R8sdUrY1fM}bj)XX42A)dz?W}QFnuC|)$$BJ3G;9ILyrxi_v<{G_f+xzTUdyjp+ zz00199z3;l{_()_gY(vkS@X`{X9X8RuX+CdCl>Cnc;}q@d0-fv=a`*e0W#%aBPcs5 zPAvKX$hqOn&en=O&E=vPyI&SW`yTeHt(s+2yhaEH1Z~E^!=2@VQ$X_=M|0V}ftX>x z9vrZ51lQk)|8K(oNAUkqP-ox5s9NCF?Rg+G24r?bV@{)LT}}v<%e!k&(F8E_9mdU4 zG}<&Bza724&Jcf_(S`nYbOW!k(5-?!z8tnqLi27=CD4qVp3Lvk-}!RcX*glIyx81W zA^`#A#+u=+cEu138ELIpG2JEm;b@;gI+lke`6^#2QJG0rPbme8S)Gx)t;9ZcuC>A; z#S%{zDPjL;f5Lt$A?&?L?TDrV1<{OYN|z=yCrb`G)2Z#E;(f z#t@Ovl5vEwLezB0Vxh-x zqwQ~Sc+tnUmp#iW48>94=N>Ld1lAN0CZu?4pZX|y-*-DDsaLv7suWE_Nf*FuhG(>w z&}O>Aep^W)+J9<)odT?HDq+~)U~wbpon-W8iQSvhbxBI5R3Z8u9iqDlQI6$q0@fYD zzsf`KAVV;=|1}2@bwVtoG!8j}axlboyVhgeqETMX5}xSpFw6w?9h2!E9NDp>JEhS` zqhs*6`>DySy9fUy1F`H75+ZV^c=hpu)kj%%Il_ccRVZtJhQ)Z88iCX{f8W#at#LRJVql*a^w@>zXw0pHxt1))kuadTX!JZ?8&Wu2)pCzs(hL?z|6Y`N3 z_#-l8i(YrHiAmg&v4lXL0a{>h3$KYns>|j>ZKSm1-==1UBCw6nQECURqevn?eB zFwOlDCQ$c5{G(HsXdI+qcGHf2sEbuZa3ZyHBIPXaWV{MiWk22rZgMiFLVI zb1F{QzQQW3n|=e2lVG~g3HNqt44k(KPqtgs!kg0MeL*w1ZyLr*H{lA`FG z8mTbCHP<7Wm=?QlqergDN=<)7SV{wvf69cU=l>$WU3Ws;@SulA#qldGCp0d3HDn!V z#_#()^I`-Q+p1fOQ!I{V`eB6T1uHNRJ&_?=r3lzSlw1ie8LY>^L&2JJ3H`1*R;?Ns z)fSuXI*lMSk&t1bNE{|#4XCOSbxCmBo-2~$pvZc=2N+E6a+T=ZeX)FnAWIdm)~Yvx zqei_IgiwJ>tyQ(yjB3@Z)x33@CJ7@|+c3;V)u_N;E(BI1a6+iWl62Zz(zg=R2m2M1 z`xAUbjbRWbm@yemufTy=VL9XBrDwprlirkJnCl6%9NkiBVF)!sV?j?Chnjwor zr%r64%#|1k@!)koMyPO;-d8t@{9hcD{0Wf%b7-tH^JG*15doNWUx?ud{vld*e-?$Y zzkI7SDGS`F1Wk{*y);*3B^_5jORzXshUirB=<_k|1xK<}k=-EtB{beN9-R!l3iN~- z-F*JQZiXc=Ws2}03`+Q(6mYkVexxZ97CUX8PErVCoHUx%Mc*>3Wdt!Sg;H*s zp?!4GU{O!aGZDm?$o4g=CZZYX6*~;~!JV;*8nR=>ifgFP#MB`j!Y3!xGBy;RYzC~@ zkH!Vf)ZQ3QH&cE+552*y)HFPia|(R#g=H1{mwD`uk~)$XPT)04M>~w? zn~JxUMzWtKid|0+%B}-o*W<&ntGh9DzXucJejk52Eg_A-Tub==Cw;_=fzhzmpn~W@T?S!H4qe7ta#Op4lI?`iB2=$wXh(~u>q9|nRnug zQR}u-vALpzOhGb90H#f1_CbpUGh*Ua#_F`!SWAEwDMt}~XY-Gr>WkPx7ii zUZB?x@T$^+$c)2)>&Kst-nnL$jv6I0COKZM%aT`mJ;K0Zr|ng-4)*q8x>;O9Zalfe zA~uuAmwbFXFUT;=*_zC+XW~lxi?Sg4u25HIH3Bp#HCpxZn$rJ zLE2bTuA{uMcJjo$5qPz7)AGwruX*ygs6{P?XE#>$^L=610FS%hnCAlSdDSN6*s?1 zw8b4uOhlqT|9?UqnB+_DbdvIeos^4e2a?tHWvWRf>L^zlHL^>mQSKbN&n_X$Rj}_d zTMP$yfUW7#`Wr$q3{}rh`oNKs5)C{lzz4K|qYFIH^~0TS zIVPdeqXPE^Jvb~Ou9~e{SiWS|T2>l#bSP*wo1PErUpM{mV#}jFidQIZHIf*0_lcSH zz`tdTOH25gJhPT3W2Ope`zI;Rd!;yVmzD!sN#BX4NKo#_Ke3JKBGz~6p!O}S-N3A)X+d%Q zeLWPNxCE4xxON^_!w-*&nh)vW3?MKLekg%WOLK`JAx~P9@p~z&M2Vv9Q+nETlKPe6 zlKPw;icV4jN=i~AoMKE8@T6$@vL4C+a^k>;lGB_ve#?{GOuB^>U$$7${U7yo>ty)H z#bx+k^-y#&6i`w!oJj|=F_oEOMdf$(@CT4CM{6kQUKa<;JUEZT?>xcoO;wf@XG#^p z`$q?kZuX#QK_hyD9*Rz^0!m7(Q%BM)z!*&yDeC6+a0d`4M`tK;&T8gNc@n)gx4x8Y zm$!-s_v?9}8@Trrm+(0~6rF?xl$32Re@0KRPJF*sTztQyhoTdofRYm5luFb{0+U6GxX)yeXk#bxw`W@oex``hw4qZm%-WiV z^*tNAF4>01inVAwTC=bZ&Il~acy!}|d+x(t9vn+`%o>*I_z78-8D__g>Yi^Iv;o${ zX%D1}QJ1d>1-Bx`!1)#0jEVIO77_ty@Sa&tsi&gLY>4M%~=N(jrzJ%_%JWt~fCg91_uLhQ_+*UjQgt zmt;trV#jA-h4NSc7$L=UE2hk>-4xvm+}n_}Nje82a7} z2lSK)hF)Tn1=fWPOi2x_{I+V`@s~_Ea^_Fj60m_mh-i@3h*^Cs z!{XdUEO8@%lg|}&Dm5=8oGMdn`dUU7g+%++uA-$k8PPteL@No|9Ksb5S*X2b{Vz6G z*7wp-<}!n6z5im%!Fn8>2EcfwjaYasj4g}k_zChAi%w4jmg(cjO*PMPCDQgniir|M z{{PG{y^sw5va1Z~O-6>d4MvheG23Tv3H|rYmC%o7gWhDM zwloBV3eRlEy+!v!3`spbefY_xI49RBIT~~Et`+41WgC7G@8ds09O-^D;O7mI1t(Z+4nK7ie zMR~p4(bOe>E(TSXw~9N>43`TDt=3g&^d=*;V|`Ppu*-JWTXxRo%I?8XsuHvg`I*vFB$q+%6=%7rF|M-eiQg*e8_=w`^y< zMfZ`-72VTHbjWAN62r5(;$TDX28m4U`$KerG!0ouy4A*PHftLcanKl)z0f9fJ}Jx{ zhRP}?Q?8j(#hou_SY1eRFL#w3y~#-KK_1=Cxm|GZzBYP;m;sb<{=3q(9( z=P{*IlBv|3Jc8VL{FVZ}ik-(YgA^xf=q{2t`5CP|gv*rJJ~OBfcAl?L?vY1H#}<#V zgA2#;FFPb0U?1w@)RJ%E`kKa)aZb!&j7!*$%H}X}ma>{iXmTCIZ2tcQD5U`ZE2C#x zwPnZgMIMU|=18XX631I9DLw1TRCAnwPNl?2jwOCQ!#Ll1oxLJM-lcG8g6>kl1rRKV zaj&7D>|T?^?}-LB3e)X+wCB%$i47%jLPe(HNWz2NPxk3(88cRcTuXXd(H2q|}#iiILYvio+TKC@6%LfKX?6kU@i{dlp6W5x39ZxZ4G&DzDH zXz47oetfaWcGheh)3GkLtOizON@u;J2Ck^WRRU(C!s0A)%QOJ6j1t?yVY*QI_;{>P z1rJ(YEqce~aaPG=kadp+ z>p;#Mh1!qxgBo1dta}+PdL0oKQ3jFF%dLs?P1ORuiYPvv|sJk-}pP>K@-sZbBTcwW?)t8N9 zod&eCf8iHO33qxppHFf;c6+VHz{?Qd5bpN3;^xt3x4paVF0S{%$|~l+OA))M!p9e{W~~_9x`;m{bU#XscJJ01 z!OpECv+fvL6buB2Jp}`SzhqU@GoB1|R|Eo57y1eWIfK!81M zO(5_da&WCiY+SY=6nK2-P#_P#A%cNYr#a7qkP{AE*Ns~;An0B}jfOMY(a>`S{y^M3 z`uw&J3G(>589{+!g8MY_BNG(di?Xc_3UWfqTxu!3MO!*Kp3KqQCq&pYEI5@43u3#T zfFp0o6nDO>+u&vJ5C;aE(wEX=FIK~%p}|$FtxRS$C9^FG4t}B^j>_QR1Jo#1E;z!R zy^D#N{OeV4kf%hkvh=K{6yb$_&}OszkDx_C=T77mbnbtzK(E5NOIh~i+~uH+xjle$ ze;GJ(=l&&nV$PjCZH;q(gx#UFnOX4rhVtbCogrNJjcL~{>09%i>dDh)Ey%g|V2 z#O?S0g>k0)Oh#50OBhN+-ER@2GU3v{M%h+}OV{R(+&F2%(PEzV-w09mjE?Sn6juc1 zu3#h!We==;iGnVCe*t zm;1Q6n6Mb*Ggp`$%4sU0oqJj zxg~AcVnyY@(!(DhWaDTR4%z-O=T+(ox&s|UGFN(3OHw$>eki)WrKd}Gko*;nQIYWa zJ9;QO=?N$)>Fp_s?(0+sazGze;S&1lu1**;WVJ zxAy5T;xL>e%p$+%g~)q`;rBg&UA)+*i?b@YmL4HF?ecx()Dwx@q;V}bK2S-wM>o92 zLe9H5Hrt%el=76c%99tKU;Q42iSH&s_|^sPC;MTo4BVHf(VQ3d>bHaUk8pnY`;uTENo{_TNAebUHV!9zGNcz z7$I`syuC$_3>Bw$Vm3rz{&3pRcJ^JuH5TQIEwf4o87e$Si3^MI^(FRQ#gj*l;nL%( zgRiTfJk}YGAMET66D<5eWs{tG=6ox}u`l*D$y#z?Bzv!ds3 z^^gXT7Dr$xX-x=om?x((_D)hGekpnmPV3B`cCBFsO$&}FLk~qK9|0vLpON@}J3J{` z7WGgDkPQdkr)+vx7t1Il9-|OfG-?3z0)rsQ@x_X0dZ8!179qLBC5XYO>@u@I4rz(9Ym4Wu1HC(1u z!}&Ixv5aS5|2LDUM%H86k(Dojpl@z=sgMSv3m2~ zeo$c3z;(1JI1MCJ3r+(o1$q_JKq;5Lrh(E>#he>p8u$s|$ftoX(i58ovZt+?20lS1 zxanJETq0Asu!+Y@&I~;TR9Fo${kx%a`ltHM**`jy=7)@9vc<|&{SKrw#60dd9})iV_NnX`1yCm6QC z2NrJPf@g2G@X>Vo)C$52&%jr%Te!Ou-X3>s;=#lRpOKiwXJs58fdFoRS_|z!d{q>e z2SGIvjj-ro#X@k+dh~q{A&>ahy67Q}9kvxtY6ShKcnIW8vh$q%RW?$X z=6qdg&K7Occ(orsN=N_K)M!o&z@Z)e#2%e7>=fm!JBk(s9X+91(9wUJRqej{3X=?Z zj6}+%FGnxUK+L%T9Q`p+&K>=6dSZ^AJ#CGne>XX{U?V7}KkK-8Ip5*VljdVLgya9c zPSc)4eVkNEqUC$<0q`VMim)^w$E(qrON@W?cdL_vIDh(Fng*8<*YSNtvS0 zYa!VGHv7Rm`zvwh>CNrCV6Pbs?gJgy?*k}%t-$`i9_&rewCyAK|L8OAXwtV<#f?e) zR;39P@EeloBLVDvX!f`4tD(^|!A?lg*7K{=xIMdpot*je<(e41%`( zDzWS|zt-t@fm1dL(vHHSJbpz_td_?`7DB$Q?cdc6@uDPrUkgI7CMo;TC5yjjuP$aC zWb+cIY$)4ty)N>|vn2a64dj^aC|3jFCOzRg>vAKS!U=p5qEVwf-;TUl59K9vksavL zkZ>q=PeXE#7DN{f5hSEmhes*A(^wMzUUBf89&i^^;{H3(9BE7m2Q#QGd4$O(J@?Vt zlA>&`>#5DRC4$XGY{`#l``6l%q9k0=g3xP9%9f1M3_y-C{zIw7Kh#1Q#G-KehO#KL z@rqODY$ea2%%tl}TC>H9>VKxET4zrF37Qr(Cok)v=*$U+(%YPTO$(xnk_ZxpGACcx z1AcAH$)7OU^kGhlviWcH)aIKL!R8|7WPC>J*L9&uQ4+4vg3xP9adYwpEtEmb38!x; zb8@gVzmaD}MyZ;#9sGx~7;n=Prn4A#plLyi@sJ*h&SG#Vy)DL*S`c0IK#(w$#c=e1 zUmJ^IG1>HCF^aPJ$Mw|aTMWVGA{OJr+WxfxNKq0#t_7jjl$6EjvB~e#S~!E)3{K%t zHsf_{c`7genP)nt6SbuUNtG!>@)bR`Iz#ehG%aXI{zwl+XGl1d-iG8AEr>4aAxId? zkbFlE__Z-4-)6Gu!;lnZ^UOY7XrO0v5kqplwtuZ5DN4edv>@~(^kYcw)WR9WkZ=lz zG9-Ibt0lR{BT*wZ9?3FgJl>_JP-i?IMpGD%A}UeVL(xT}0!m71BPS$Pcv7^~^-u=L zgLB}0N~?Euu_IM2C%I2invb@CAZNXY<*a>v|8+7~tqvRIr+TwrynRl~kK}rEGS{0) z&_ug%Pd-lu%VaNyGiZk9rs7lf zuF0*tT$F6r!zq$#fluQ`H=mW?#eLu&wq+NKwV{P?;#Tn;G|Hy4b&Gf_OVR3TXnd}) zDi9fT3&{4qD7A|W>>C*0UlP>9I&INzlYiL{Kjm(duTY~oG1hzTHW42p?e-A>E~i=d zkI`v%@gzB%Xq`n|Nlx$!ZXx;I0=Zgi9$6l0yJ!buLu?$$TwvDGbI109v5cg}gEOwx7xxp9Ed+?~2td zZ?8zk&@#t)^=Ts$&0Cddw#a9`s~=WMpSetp=7f@Omd`As(}F&e;1~3nXA1Nxe5Pc! zw0$a|&HEUc_>6}fJTW^4@R>ge9J$Z@DSBc)lRasDW)bx4&+>Bs_BS%dDDhdYF~0f3 zN)8+Td69OE*9$RT>?wgYKV%a-2Ot= zYs#Lr_Xx7)5nJxZ{A^k-`HT2$zx*8?v@YYUno~!}9?0&*cN_CwDI4=5NbY`!BFQX5 zY9A&=zZ|!)39svt%ACSO($Aa$^^|%mvD6Zc&XxRQ_AT%kN`~Fo6@{r7gChlE4j>ey0hZ59Od*5<2DbgjLkM@)7Ok`-*oA`lmffM*L z`o4glQ{rdKui@9;(5sYJ%*q9N3vgq=%ijRkS3NImcnBWV%QGX<-T-%I)90@*(}(HX zD47Xx-m-~nDe6p*(B&*Iv1%48DbvR`%4{H60YMZEXj>I4*yCGG&kxHr>ylM#pV=8r z*=8;NITjtTE<4~Aw&At{S!pa9t6D3qHS{;LZu)ez0yTWgtfOQy^v#Mzc(aOVQH*tMhU(=W?Bhi&6totou?&xC3PyT$f-tq_Mn61|MEUfR)I z=1ryx_s^mD(G2fb;UHUIpMH^P9PK9>0x-%3i)x^$9qp}|jkOj&)(VbS@q4G$Xh(;9 z3rAY3<*L<$egKTa7&~6^8mk}^9C502YHZcHj7U40FO#0iEbY&0e2e#iC+~p1FKc_%9rb;Qu|?6Jhl^CwPadS3Cow9z`-XW zsjqU?3Cxum5hAdhkORV=kM@9=07HQ9e}vYEYUNd@2I62B4$~91dk2;u(mjS&gL9MN@l7&e2Y zTW>{iu-M!PZLhKD`D?efqid-qLjX0)$b3LNA;hs8i~>8#D4Ri<(gN)SL_*U=PEW1WLF?QKHk7( z#zM5d&}st246qBG5d7zM;0m~D*GU^ThDX3NmtBO9V*a6yp9}Hfqw1MO3tQftm#y`es2vu46 z1QqhuwLaTd*ItC!=wZ%Y42q-FG(K@^I|RV#hP)1c(ya&%*7vw;Z6jG;#)> zdY0MIigFnPVF|(}(}>RtV}8>m6@W8`6sH4!mQb`W*iSKzARv0qod-7E2zjm$A+#W$EaCNFTwz1%D_$)&Gpy=0nZmgCWU9wW36(WEnCc&1+z%;ixHj9D zc(Ws#f@7+9Epj{UXu9InYJ9XKIGH#l%Adyo`e6Gkj4W=BfVswC4PaIXAjZlJkKkmf z3X{gfm{DIjUOMeqHJshVmpO61vl_53gTbZa;=L7k+6(Lwh_@N728GHnh*dn&S9TkT zY5NdesF1os!xIBVP8QP1rEEw|pLTo?T4=-0u{fX_Wt-rmi6`$lyZq4d1LO}V&OEa} z4o%%xpr&Ld-c5L@?;K<5MsF~b_W@RPF!ueDxlG2>aWS*H)9jjb~)^QzmGM%{7G;S zX0zipt)L(6X?l%b+v7>YE%17N!|F#nP@-Wwt)_2v`cL+w87dw+ ztzc2qpA4)<=y;vDx;<`B*ppB8YxYz$9y(#mN@PWI_nBd6`Rm3b>p^I>jR%|P+F5ZL zCToN$qTcRDt!o6(u;S16Im8oP6Yzz7`(QLxj}fwWMH2##i_z|u)3N#&d&_1t4G?^1 zxfcR|!grU`3<$T$M#~HWB;tF#W48I%o@TGBek_}fE55ZtWqQ$MXs%LL-=4LP+WYKV z>|OR;^zhlG%kK&-Ke%iyn=SA1IV-pldfm(SKX&)2dczBxcCW>-y$nc$%N)YX%K)k# ztOs=`MUh2609wZ`?CdSudpUn3f$anGcQpM-Z@KL?do6&>NO&ZbB*+99PjMJ8+Q*0z z_N_qQz6~V59shqn{y&cY=Yg7iCqrq07q?FUg7IX9XgW|mnzDK(HPP6#qK|AWi%u

5o=x$zdVZ?g&#Ko|05;GqM{RL9di>2kWpgSh3;7$h2 z#qRnNNi@*ztQy|Rs8~YA#z5<-XbPj*T=mVaouGH*KWaOH5CFsWf-o>b+cNIc=@WyE zXrmWcO=HFLjTI*h2{=J#>*iq!v0|)ja?D;7Zc{tTWjU;iNNn#Bx&a!%Dr{jg(VoIxR zk4JaC_ieX_Fq})qaYl~g_na`^Ci|%eU9({=8F3Ng_&xVP+cQgjBpPQm`bz3vOiCR( zjsfNkC6J273^`EnrCRu8vW2v*iN@CYX4c?*0@CqfZ`mr=sZ-b5ttEyByppbO!N^{< zn6c`k?vL^QqL;oq_1j{Kt+45^z@Y0s&QSPc8GGsGb`@JN(NRe*k3 z2k0IGlta0PIx7b7SMmTn!~l%#LCb*ymSD?n8jqaTa!|x&3(GNT(P*z{5l=LC1nPp? zR%m{s7|m#`GdP024t&0rbkn3`CjC0enLj|m-z!t_s{<5D49^cT#}EE95bMMD1KGW0 z7t?`$N*tmI;k89frIr_Ic;Q?t*%Q&8m0qjGh-be_vh`7Wj%4b>7y$e*kts2l8eS(% zPH3dVT(ezibfTN@GvVnk8B1_lSSL$QaoC@VRpO*5q8Q>H8QZZV$rBpCU8~cCQL10V zv>+(}hYFg8gEQH3FoMliqPY7yYMP7vgrH(92<{!3e$(0%{w3=?+Sy$v#kjt}$(G^* zh~|DDHFMN8@Q;r9(F9O|C)ba@r$7hwF-N2#ZPV%W-P335~hz64y@&{b*o@NYm!@BvH7zYffkz9^}zzIDVt&gvM2`g(<3K zG(6wu({v+f*jC$GoMzrMlM^E}uULTr--*=E3i-hXeC0-P)nF|K9uiiat7vz{v0BZ* zX!e+k?{tFD#O$3pBC)f)9Y9qh>!P5xJy&K7ip5N;!2X>UKg+M|U=Q7)qVcSdf#*lMSoYGGub- zw23S<^A{r`9>i`)pl}sGQZowut5wmT1o}QI>(oB!*e-Q&)NRN82>QWSb)QCJY(L*3 zRm%cbE?KFE6p=kZ{5mRc8ja2bUITK%ly5$L zpg%(>+ZCf>lfg4|bo!K{(*_$>w0fy3t)@V$Pi`iy&U%fjdRpZgwj{x(xekiQTXf&X z+mvc;Gn!Il|9n-lBaG_4yfLyT{P#@IH=5uou^)}So+j1q6#{ck4i8cx2@R^qy!Rd6 znh|;wWsA)~Dor8&TU8O?m+IVYp&hA;gvL&*r!(Zr7-x)bbJ4fVW*yE93#8P$W@yhZ z8qE7?c_y406S2Qe(}Y(et>S><{sw`~Rn!I>R;2i5RZ`4=6kkW>l4|OY;(m%$`7PWP z2end@@I>HA&70h@oiQo&^%SPNs0v#e8Brl)QN{h=n~CYI9MeU=*U6cM)_9aHf$U8R z*`ZYxzTaCF-vhw+2r6$HXYUmFc3WPEl_xm|sPj1hQrZYzIDyxx%?~Kg*O#v=mES0H%qZ<6#4XhIr+xtj2~$9?#Vfzh$ndXqv@@6NOPg(tByHMCDyFv zh0ya_@f_^62SoArLRJ1APLp{mnr5?=e2<+Ln^|_kSy#TisF@AEO+Os3`bZg0CMg`O zQE+e@RQjm<6#c`aR2b3#P(ZQlHP;8AR9Yu`fZ48v1*wh=h*Zd|6JMHIvz>;`1tnwx zk_iSdX%e#!S~8ds6Sq26=Df~oqH7Uw6s9c`eRMxC64K9bq_5#0Ad3YB;}4#DA+a3b zQcltgpv*los!^=zB}F`UEd3 zHHeHnR9g|VpO5~=s#%*iYNSkZtXipMECWlQw%5dJ*xNVK%;G8{v>vY27ClH(AYknfv zY?@t)y&#A8QxB{bkMha-L6EG5ej5OXK^mNSBYKZp?E2pFncAtvA2?y0T0A|U1chZ? z^g5PYg#6W*5Ic$A+%Kk2H5~sfiFl#QSF?Z1{_Rw7TCPiALB{<;Tz9*P%Uw^m1L}gxnDsgwkC9tt>@9& z8yqnVP|r_Vz_BwD0DP$~|3uqmH0BK~zPbO2s>J7Ga1+OCuN`imq)#THQxJ}e5lzkw>C znquhX?0nW9KqbT@zYbVqu`1x>>$L5=-$D~v>5+^S zy?iIt%Uu$!vAYuNJEiYs9NDQ}hVzVfUXf=rX(Kbht-XnSiBBp`@#jG;W(EAYAC*e- z=W%WOTK<_SKD$bP5Nu(&0KA=UZfHm(g z&zeZvzLqtjmlSKpIHK_S@ujf%xW1PPjNzSEWXzn_1sh=1OuD$_S2kIp`xz~|1x)*= z<(c+xwC!t|CVELRZ6@u4#`tBD6@I^_@4o^&Ian3hc~k7*a)&y0nFlzzKUGp9nn_i7 zeqD=a0Uy6so{!(wwy))*=q1I+>Emh4F$$AO3a{O}b@te;z&{R7MgAStOl$^Ncw=s1 z$;yIUh5DQp^#YdOj7lX<-JRO@wJa6Aq*ywBJizQuVkdqnY~G^ptpX!C5EU7Db3DAV zlh6S+9?35%F)hkgs9(~eUcktUuwtX!lMK38v?tG*2S@5aw=;-^Yz(U@AMHVVu znh6#Ra8PMYDk&M4NmY1$P>W{)zy3~netk^azLsC2mlVIIRhUGgmP}H3{j|Q{3jE{X zROH`b<*URYodMP*JeMTzvdId`f2l>XfO(%Q&%9sJwy$NL=q1Ix-4w`@Y~w!^F2Aks zs{+F~2%|7;cv)=8O~lCDU&s8E?X6Zd-OsUUEtdCd?jBmkn!=w{yv^N@l##dNy0fTd zzv>>K$_KJRP__>r+j0d&Z2Q^g2{^Ww(LIDpa<(oPX5u{r@21_amwFw3q=(|6q0=zT z)~bgEH5=O<*-pcTwP-xtvas>Y2rSEZc>Vmn=dgJOhX)^B0j**36*=e7)=UWEt zKs9m50&!WCTd@3#!I zf$d&qgKvZjx|Y>EffGq<79zJNu&}pITOoX-ZLVW256gV!G*()dofrt-6X9xx#+v6} zL07a8$bdG*R?EN&+kUudrdog!q4o%JB2v zgVeMTyY+#jn%hjIMadOK5iCz8DIgDx>wNDFkaCf6mMYD;0$lP%!$jwNpbgzF!;2-B zAP=Q&g@MILZYtbo6Rk&CvmnsRCMy&dMnX|6DbAx({*of)B$pYK3d|mSkgI-ou(tH8 zeqs;g?W|~OThRcW-XcRaV&R7fb+Ol8##qLtzQl^qqH#`W8JuA}ed-h+%C$5(2SVV2 zo&)KMpqDZf&|@YDdXZt4w?<1jNrIxx9VPKmFl8GV&Xo%cAU*6OaOE;_B^`}UGe+c* zPUo5#J1?>C!t>i~J-vf7bYxe8E^Tv9vF@&1#^uGh1@H2*6sdkFLvK9^1pC$s*+)4U z_C283w;`+*%-K$cvp3va_O2wt*J-{Y19uZ(0oK4Q)4&p|IB0LwOc-)zPuW_lfk6mA zkQQTEd8~Khz(dS&BY=_5WppY^E;yV@Q)GH6!;4a^{bV6)DJR3)#}#WOBAbJ_LL%Gi za9;m|&E@rdG?Y2dpjz*Ly60dCjJDrnywc7mWD8}>JUV`Wd)cDn3V~(%IP22PGhB&) zy5M3WMWO%iGDI)M!!H%`ka99Syt^7o3dC%i!#VUzo6DiUsayq$vC@D%heMaRUjrNA z;1n}9u`&y^vw>XQHFB)^mI!7earOwiZ!sWq$6UgjVCTyO!?MYWB;U@ExfIv_tdMJz zli}LZ1~61`W*Z*Py8pVltXqmBZG)VnF&A$SQ6^A^k@E(X3h*TPlu1?S-#U?|YbiDz zMWuXSka99?npbQZhK>R&+s<&V+{9qggFk}z@*uaqRu-qRMulH9F}v1Orx9((@u?yrGhTo+;HCAySco3M?9iZ zVQyj`MH)mRoyZi^0}%x1;c^*&)l&m5Z+sO+z6I}!vK4ur&QQA)^V)^Xqnr%$7DvQV z!Io`oIP2WaW!)2sbqHF=9K*M{>|h7&IUyOc3bP@anKl)tpN9MV*glNL`9^FBWo+ax$EI2jkpkV5^|cb~Bu(FO14lZIk=}6VAJr zFq>klFNIS|ZuQ+)qSYr5EkU?eMv&q_4PE^a2S20b2XU7X+u8;3!B%f<@|RxHsl`+5 zq`+zX%TDD6*zmbHz2sZCHKwyVG`S37HvfO4D9J+Aww;q@eUsSB9G705oWvmW~>~A7O&;b(+^G$YXxIR>YxVVfLMZK?q@M z*NUR0OHBFkwIbVDwQ(%Qdb($Iupm>rF$VaCV7l6uUCAjvivbAxFtt*{9DoSzES8X7e3xjmF9$4U&vqhNZ8ne zmy}S{F4evHSQc_}6ljl(0vasXQTJig7 z-t*cQ)>96?n4&2~K^1k@)BSI-lI}Br(fw2UdX~QaEdKiM_{y=A!f;fzlJ6sHAr7@# z&APa1BG^2u`N)Q?<{)$%u%dSiD$>FBg>k4Qtm=_`I?3@^l&!|Vi{NH*wlIp-{fW44 z^!aULbqC2RZtJUPg%uIpmxvx2EBq0pZM7BtzB0lSTV)O<)BZmy7&z1_-}^&vf|nn+3a5%g|5HtZ4P!M6dQpf;%1^Lohf3T`T*mh=mX z3#id>JNR1FGq^Rb8~v+o;~C@;cVoVRB7=LHD3b9Fz87g*?HlAcmbrLRtc&({ayXft zxkWH>sCRHS_VUVjcTVwci+qI3 zqfl1*2v1O@Sjb=xb2c<4=JmHKA0bbeVxbvYP60fQU%e6kRwDd!U`AEL{OP!E^yzJ3m}7EeBIVPHh}@}Bw;E)#YPPzd zVmDQjUJ(DG2>Z)1adM4C{(S|%h)U37W$r8Zine|2aTn3ccaj^l$C(I8WW+Cp%^&J} zt8n0j15q4ul#3H|*TlbOWJyPplDphxSz5?YLg{{ifX=u{KZCTbc9U+*9jS55goDK_ z>pvD`9qJXm`C(klm%EOUSi)dS8rXY~w~kT00VM=eQ#xIdWC-6xKez4F0%OXAKod;a zB6sK5D1?;m&QYo~Cxm)v94$O1drtYDw4SrV_0R*G2MW zB-cfbu$XccT$gtPM((;iL0`;uVP9M0x;V^CiRc72@8w;>xmlOEy>H`AjSkQaxI2&M zC{bNkwQDV>eWrHTDg1ZB_<=X#A8giN=ZTANx*KVWZ@zne@M^N#hLT%a#S$ge0P`U# zRUNBNTsQiq?c-SKxHAy?xT74q80nK2haJwTCkiDTGb$vxwwwJ>jJX~YcLc}mc~mOt znEj--eXV0AdPzBEGii~QSY?wHe*Z|{e+5^KgH_H|`(Z|?#I;}t2ZrDvyQqjnY&ZL% z(D{NEoq}WIuP`V|`O#n2wy$NE=q1IjeYLxkvXMBY6BTa1qwl){t2jubuxfZ&@~V|a za-SohGhVfWw5|54PmX91Vt<7AhkoNIB$gifA*wVd z2FP#^U3TukH0r%OcTB zibcDiN+dq)TVe7W`kpGVhXYWNJ(EJ;4KQY$Wk@8%FNMZ8v}hDCg0pr$AR|(1qtFo~of{RE9XFyoNWnU~-!D(kScN zcUEyJRtx9Ua8@#&SN(NHQH`k++A)7z?jzUv8y}O4h%?Wie ze0n!z0p`*uAg~GEL#R=5f=8g1oZ!8+M5|(gC;2kc1Wzigm~s^+cs~Rf`2_D7`eGA2 z_O&$=yvIlt_jiIBF{Udb&w;fQ0Z96F}0KPnhD)Fb)u zCAzi~q*~zP3Kwg^z;}Cie4HLDftTSKcqO`rt2klwab+exOgxy3$SWRZaeVj#xX@`e zv;*-fC+-4*WWp(7PQtPUAECo;SMa7qI~}y>`<@@aSuR?LU5M{0nA8CJ7x5s-ok8cE z7u}{~g-Ot7l>}{(y?=ESdP;l$t5j)D48#rF``;f01ZMBQiW(*DJ%L)%-hZ(~tHRz( zzKmq=r8 zOiSb0Ni$3ro;McmG2)xJQ-@WH$ila}9x2FHI`(xCt*TDSvAFIwIjmYh4d!6j>agnb z-xW+3u`?B<-kg}{TVkf=8rA$Axp$*d$*}Z!ZTs2~o9HDKV$;Mt-=*)VLd=r`Fg$cd zA?eeMB#Dsp3=3_>x?$ANXGe=oLFm)vKs?Ed!DyM6If^J7bi zP~``-y+&i*^y7I5#ktQ=m7}ic`lsae-q9Gp@){S>;7ci(k7#?ae>U~d8-@Blp&D0f zFT0>|8AaV&2kym3k1SjD`BVBn6OLmvnrEXtc~A=-aOny^itwmi``K8t`NCM_XCazM@A{ zN7_=$7hlx2uN}%|QTR=57h36XQ+lEx6#q4C`&B~m9J7i#;uf91FrYDJGo@JpNc%v# zlKj8Y;#;6azJp58?$6>MHJbDF#oqlocfq}mCb9!sDh%F>Jyc=btnH#eBt+v%VeBSH zOrtS)z9QV6`d$lEhWk%|aHLTgyql^z<2ZmSsWZw__kKN|`8q=gNSOmUk7(Q1>Ws1| znA$G10+QAlyU9zJgNpx90^wRIA+p?C5qW(h3tp4$QG!L zzl%yG)y9k3_O)t*_cB~P!R&N^A!Vc zyp&>awC!sZLs=Bov|VTgWCX?VytbDrih<)-Q8C<96l)yN4|@|OrJ6{kDQ)oyEsh1+ z;^U}PQd@jl+rCy?@Lq;%i&wN=6bOT8yt=mdvcA{XMq7N5F{YHZC`;Wx*5jG4EqLRl zw8giy?Q69~Srm58YAvD`g;c~sJNr1G?WKyg;P{QAEryq+Ere1UiOjE(^^U-H-05!d6|iMv5 zy_2BNCz2wsdov50Z0-A_nHwz&mO|uSOU_ERE`5}^TH;O8=#ESBLDKX0vWFh9oEBPm zjI@ads3=;>g3|G(gR;eyd3n6FC=eQSfAsdao3elx_Ay5PM+Mffkz2Gcpfw6z<-P!i zD$R*8KXhM!cnPxT4tCD3qwf3BsBTzMJY8G{P5qZ#>|ZI-s#xro#2#s}UyhKN92FM( z{~=)HoBKXRUu?0TeQnKR{}X}JrpNxQy1XuK^Vaz#lcR#^oCoIIbiSUxnCWC+TGOfA@8V}3><@FDZoiyS zN{I&^#`#*mm7Iz2_Z{98!}aDEF7}m$%YI;xW;J^ynj=GsXIK`}9`u6PZeU5kjYfPJ$QI&uUz&OZrTC)J33@t!&xJz4G%t$&58H( z^0Jh!IS-VJ4Pug5q-$m|M>-eRunDdMNk1?Jhs2*51!^gkE1}dPjmEP`*KCFL>^r?? zuVq0OcS6Ekx&Q;|3g4$<=*#FQqgy$n-^$+Y$=So%kB;#Y3k9xO z#>Y~iMNe4Mu4+(c>52=uMif@dy?v@=Dr`Kie?20F;kTMi!8-2 zE%QNXHTdJPv%qJonX!iLPnec7A(Nxg$eq@rU}li*N({1{Nnw^P$_mj$;Pw0l)?iN1 zSQv|D8a>~K+|@<;#b}>Qp#y{ci_spu&K-h`K|eYOn&MIJRlkt?o)>mJOdwR|g|TRVfV-;c4eD$3I(#1~GsN&NZi#3!C4wf8@)WCOv6MQ!bx~(p z)C#CaQGvElv4nlT)%EiX;qU+Nh7RZbpnTr=xn{|1m<#!5D`#L$^l`Yi1q=Q07HOpbcEE1 zV)YfL1>|59j?fo$Phk1<#yxmLtu?{&y}r2?|AdGhq)`RQp;I*&1#Ktnzw^NHXr^m* zF+E;_9GPa-*hdJAo@v*`J&C;QQjRFVOJl66GEz@8B7 z*n{+i??3eh&~wILX=IwG6xIA4vUv;s?G`$l3e9DVqGo9K zFYJltAd~HSJUn9r>Oq$zbM1Nnqy0Q>lO1C<#GQTs}-i!NpWUFd|MKi31-Aw6Eh>8wBoq+&Qk zsv_tuXUaKk65f_)^3k}PX(h-E-mPz92(JSK+rn(Px3l)6&4+NRU0o6ROBR-`aK z6dk0NiRE~Hc7?08>(MT&bF~leGTOt{3C1r(5zkWMNEHN+@9|{V9RyGitq@ujZ8Wjl zv;Qmg>)+n6G6?-b05SvzC z=u2NN8-iPjO6tQ0;XDi{1_Lh6m{-o|; z!o0uXKm*ZefPnK9G7+*IA2rDoUJgnax~9GCwPJO|ir$b(j7v|YTAY%-vPy?i?Zevp zA-NYfX4?`uJECbAu!h$o^VE;_HoR7gYXvwllV?Tx3m9V0_b)*i<9Z0FbqwkN>W4bS z7@Fapo=jEl)VLT+>Ph0I2OO(~lbLu&6Q?(u0eip;rXTm_EyE&TVK+Uz)#!C-J_W_u z#3wz8+eyTDHqeBchb$f(W!^;(Fy4t8TK9B3cD#18jq%as=_~6C!WH-nky>K9Q zVcl0S{z!ey6CCPMV$AO;2cvcteMN_2A3+kA@px~X%(U}f_JVVhtidW-^ywzKF~Z{W Ifxq~F0Qr}qlK=n! diff --git a/docs/build/doctrees/charging_sim.doctree b/docs/build/doctrees/charging_sim.doctree index 4bf07e0b4be15482191f09539d79d0b0b0a0fc7b..ccedae9379c0a305369864804445e7f3be2e56d7 100644 GIT binary patch literal 492726 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 OePp@iO1(CQ2L3-j`JB-J literal 492912 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ⅆooCB65wK2$8$ENh0!u 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 diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle index 82565b03ebaeccfdf9481ad5dc45afe43cfef9d3..a6690af16740d922c43fe2ed0a69ca78b016a56a 100644 GIT binary patch literal 129880 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 literal 27867 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 literal 45574 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 h!7xn4nm2~cQ*S2$H2{{NhNVa7gBX0 z4GbupQ4w7Qbm2y1M5LevAGoTo^$iTq7&F|wQ&(EUfC|n7iCJ$jH_>4Y51119rXziok zX{PWdJQzJkUcg=&dBnpVSPC7_{1DlL$oLjtQaA1Ec9MB{*L~mT!d6J5 z+h`%RDkb@6SP#el0sZO)A|9AgkHj`G*Ye{=%GHu_)i&8--h+1%fqr)JMD)EMF9PSo zS|;k*3$g3=Ax7bG_#mCaioFnZxT78t`y$5#-lU7?s~h=Rk^K*M3UT6?KTRfJRn>_D zTWXdxomAwhL>@UUZBtq@aSpEusR-dh3?T&+)?#a%-~w2O&kOScifIj1^A+RrwM%$I zaMxV4Xt?DKx3s}p%Wl=OThuUFSfq&|EbUHUg`M`m0&DCO>#%LNGjBTC*eybd)V)+b zN#PymcYK0)htaJAks~1%V{!2x4xodd*b$BKw!lSs9C+gBSX&qhOS1%%cCV4&Ebu?@ vGVz>ddYV&(Pf2iB)u5ah*0_#G7F{S;4LcXGeDy`MRy1su6tmi}sptO!tH&5?u`C7(OjhJmn|y(b zg;hU8ENj8!)uO(P+a~`MRR)r>VzNNeT1<}R5JaKW}h?gKy$Q0-oj7$cj^WD6;2 zrn8KbL#1>k3y4b#?*>V$XJ}+-dfNb%?SLp#n5-bc!2uH30u|s`3FK@9aVGFeOkO9h zp!*J_lO5>LJwS$L2E{`b$cRp`_D-QWeDloG0Gczz0Pi7R57RXS} zPys~}FHi*N$3K&!)WR5lP2Q*`#`t^k3AObs+CT}I0c>Jf8XztxAZyhGnX*(T-%*za JD*vIL2mrXc)V=@! diff --git a/docs/build/doctrees/modules.doctree b/docs/build/doctrees/modules.doctree index dadd41c84a69a0d979bab4617677e872308cf9a4..cd5da778e506ec754a54f20e8c455e1e70639fea 100644 GIT binary patch delta 154 zcmew=dP$U}fpzNfjVw-#iWbgRF`>n&Ma40xNr^f6F)pda*(Lb}F|J{{uF3hqnYokm z8GCqnk~0#E(lhhY=2RAELU_!H1qG8+ znG`m+Gs!SBwr^g-`hZy`F(an&Ma40xNr^f6F)pda*(Lb}F|J{z2Jy-H#hJOK zIf*5i`FWGm8GAT667v#sDvL9VCow5a{>&((E0~s=nvz-+Uyxq_RX3$=ieC?FacW6v z0hq~El3H96pPX2nT0Gf>Nr5TDYjX;d3^QZr=0?^B%reOt3B^5}d5O8HC6xuK#Zzjh SWF&VMXD9;cgw3^_p^N~2n?cq9 diff --git a/docs/build/doctrees/test_cases.base_case.doctree b/docs/build/doctrees/test_cases.base_case.doctree index e8de5a00b6559808799f813316a363c8bb5ca5bc..bed2f49fb7f7187922bc79b4a1f2676a20746fe9 100644 GIT binary patch literal 25815 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 delta 769 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 P2g|rF;VzuXYV!X9^zh_u literal 0 HcmV?d00001 diff --git a/docs/build/doctrees/test_cases.battery.doctree b/docs/build/doctrees/test_cases.battery.doctree index e29f5440fd93a4ce620ca95bd4f32f6a6d91a305..aebfbe933d5b9f4d2c1e9389f1f0e4d450f9d2ec 100644 GIT binary patch literal 53984 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 B^Q!;= literal 24528 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 diff --git a/docs/build/doctrees/test_cases.battery.feeder_population.doctree b/docs/build/doctrees/test_cases.battery.feeder_population.doctree index 7922698b950200ee984d5753f0a01090dba097d2..7be779bc3cf519918370e38ca1f29ddcde9a77b3 100644 GIT binary patch literal 61820 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 literal 50209 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 R9uqE@BTADt-{1*m1OSiUR2cvO delta 275 zcmbO%vs#9wfpx0FMiw_lM(4@ijFSAO2Jy-H#hJOKIf*5i`FWGG8SN&2U^bq7h0%U; z5=$koU50dqZiY+-bB1hBI944TtWJ!+lf7BJCSPQhpS+S$n=yLwRYpDD2#Br>oeVi| z-pK+?+n8%I>L#CL%Hqw-kOhnK1I^B!?7(cynh9h@Os-&#WaQmEjn#+EAT%Q=V|vDv z(jLyd#N5=9%7WD5DYa8HGUj(?gmz|3?<~zw1aaqN@BkI+X82AP<52~=!Ujm

+

Modules

+ diff --git a/docs/build/html/_sources/analysis.rst.txt b/docs/build/html/_sources/analysis.rst.txt index 9761211d2..5a866b953 100644 --- a/docs/build/html/_sources/analysis.rst.txt +++ b/docs/build/html/_sources/analysis.rst.txt @@ -1,6 +1,14 @@ Post-simulation Analysis ================ +Module contents +--------------- + +.. automodule:: analysis + :members: + :undoc-members: + :show-inheritance: + Submodules ---------- @@ -28,10 +36,3 @@ analysis.plot\_results module :undoc-members: :show-inheritance: -Module contents ---------------- - -.. automodule:: analysis - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/build/html/_sources/app.rst.txt b/docs/build/html/_sources/app.rst.txt index ceb7f40d8..f8d69d9fa 100644 --- a/docs/build/html/_sources/app.rst.txt +++ b/docs/build/html/_sources/app.rst.txt @@ -1,4 +1,4 @@ -app module +App - runs the platform ========== .. automodule:: app diff --git a/docs/build/html/_sources/batt_sys_identification.rst.txt b/docs/build/html/_sources/batt_sys_identification.rst.txt index af1ffd124..530b35981 100644 --- a/docs/build/html/_sources/batt_sys_identification.rst.txt +++ b/docs/build/html/_sources/batt_sys_identification.rst.txt @@ -1,6 +1,14 @@ Battery System Identification ================================= +Module contents +--------------- + +.. automodule:: batt_sys_identification + :members: + :undoc-members: + :show-inheritance: + Submodules ---------- @@ -20,10 +28,5 @@ experiments module :undoc-members: :show-inheritance: -Module contents ---------------- -.. automodule:: batt_sys_identification - :members: - :undoc-members: - :show-inheritance: + diff --git a/docs/build/html/_sources/charging_sim.rst.txt b/docs/build/html/_sources/charging_sim.rst.txt index 034687f64..f45eb5523 100644 --- a/docs/build/html/_sources/charging_sim.rst.txt +++ b/docs/build/html/_sources/charging_sim.rst.txt @@ -1,10 +1,18 @@ -Charging Simulator +Charging Sim ===================== +Module contents +--------------- + +.. automodule:: charging_sim + :members: + :undoc-members: + :show-inheritance: + Submodules ---------- -charging\_sim.battery module +Battery module ---------------------------- .. automodule:: charging_sim.battery @@ -12,7 +20,7 @@ charging\_sim.battery module :undoc-members: :show-inheritance: -charging\_sim.batteryAgingSim module +Battery Aging Sim module ------------------------------------ .. automodule:: charging_sim.batteryAgingSim @@ -20,7 +28,7 @@ charging\_sim.batteryAgingSim module :undoc-members: :show-inheritance: -charging\_sim.batterypack module +Battery pack module -------------------------------- .. automodule:: charging_sim.batterypack @@ -28,15 +36,7 @@ charging\_sim.batterypack module :undoc-members: :show-inheritance: -charging\_sim.batterytest module --------------------------------- - -.. automodule:: charging_sim.batterytest - :members: - :undoc-members: - :show-inheritance: - -charging\_sim.capacitor module +Capacitor module ------------------------------ .. automodule:: charging_sim.capacitor @@ -44,7 +44,7 @@ charging\_sim.capacitor module :undoc-members: :show-inheritance: -charging\_sim.chargingStation module +Charging Station module ------------------------------------ .. automodule:: charging_sim.chargingStation @@ -52,7 +52,7 @@ charging\_sim.chargingStation module :undoc-members: :show-inheritance: -charging\_sim.clock module +Clock module -------------------------- .. automodule:: charging_sim.clock @@ -60,7 +60,7 @@ charging\_sim.clock module :undoc-members: :show-inheritance: -charging\_sim.controller module +Controller module ------------------------------- .. automodule:: charging_sim.controller @@ -68,7 +68,7 @@ charging\_sim.controller module :undoc-members: :show-inheritance: -charging\_sim.electricityPrices module +Electricity prices module -------------------------------------- .. automodule:: charging_sim.electricityPrices @@ -76,7 +76,7 @@ charging\_sim.electricityPrices module :undoc-members: :show-inheritance: -charging\_sim.node module +Node module ------------------------- .. automodule:: charging_sim.node @@ -84,7 +84,7 @@ charging\_sim.node module :undoc-members: :show-inheritance: -charging\_sim.optimization module +Optimization module --------------------------------- .. automodule:: charging_sim.optimization @@ -92,7 +92,7 @@ charging\_sim.optimization module :undoc-members: :show-inheritance: -charging\_sim.orchestrator module +Orchestrator module --------------------------------- .. automodule:: charging_sim.orchestrator @@ -100,7 +100,7 @@ charging\_sim.orchestrator module :undoc-members: :show-inheritance: -charging\_sim.simulate module +Simulate module ----------------------------- .. automodule:: charging_sim.simulate @@ -108,7 +108,7 @@ charging\_sim.simulate module :undoc-members: :show-inheritance: -charging\_sim.solar module +Solar module -------------------------- .. automodule:: charging_sim.solar @@ -116,7 +116,7 @@ charging\_sim.solar module :undoc-members: :show-inheritance: -charging\_sim.transformer module +Transformer module -------------------------------- .. automodule:: charging_sim.transformer @@ -124,7 +124,7 @@ charging\_sim.transformer module :undoc-members: :show-inheritance: -charging\_sim.utils module +Utils -------------------------- .. automodule:: charging_sim.utils @@ -132,10 +132,4 @@ charging\_sim.utils module :undoc-members: :show-inheritance: -Module contents ---------------- -.. automodule:: charging_sim - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/build/html/_sources/index.rst.txt b/docs/build/html/_sources/index.rst.txt index 76847992d..3df68c069 100644 --- a/docs/build/html/_sources/index.rst.txt +++ b/docs/build/html/_sources/index.rst.txt @@ -48,7 +48,7 @@ Links .. toctree:: :hidden: - :maxdepth: 1 + :maxdepth: 4 :caption: Modules modules diff --git a/docs/build/html/_sources/modules.rst.txt b/docs/build/html/_sources/modules.rst.txt index e331a2232..10e2e7002 100644 --- a/docs/build/html/_sources/modules.rst.txt +++ b/docs/build/html/_sources/modules.rst.txt @@ -4,9 +4,9 @@ Packages .. toctree:: :maxdepth: 4 - analysis - batt_sys_identification charging_sim - feeder_population - setup + batt_sys_identification test_cases + analysis + app + diff --git a/docs/build/html/_sources/test_cases.base_case.rst.txt b/docs/build/html/_sources/test_cases.base_case.rst.txt index 2090ba78a..6ea0fd77e 100644 --- a/docs/build/html/_sources/test_cases.base_case.rst.txt +++ b/docs/build/html/_sources/test_cases.base_case.rst.txt @@ -1,6 +1,14 @@ -Base Case Test Cases +Base test case ============================== +Subpackages +----------- + +.. toctree:: + :maxdepth: 4 + + test_cases.base_case.feeder_population + Submodules ---------- diff --git a/docs/build/html/_sources/test_cases.battery.feeder_population.rst.txt b/docs/build/html/_sources/test_cases.battery.feeder_population.rst.txt index b4fb1f04d..723ea18c1 100644 --- a/docs/build/html/_sources/test_cases.battery.feeder_population.rst.txt +++ b/docs/build/html/_sources/test_cases.battery.feeder_population.rst.txt @@ -1,15 +1,6 @@ -test\_cases.battery.feeder\_population package +Battery test case feeder population ============================================== - -Module contents ---------------- - -.. automodule:: test_cases.battery.feeder_population - :members: - :undoc-members: - :show-inheritance: - Submodules ---------- @@ -37,3 +28,10 @@ test\_cases.battery.feeder\_population.glm\_mod\_functions module :undoc-members: :show-inheritance: +Module contents +--------------- + +.. automodule:: test_cases.battery.feeder_population + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/build/html/_sources/test_cases.battery.rst.txt b/docs/build/html/_sources/test_cases.battery.rst.txt index 2c4e507d8..b9c84147a 100644 --- a/docs/build/html/_sources/test_cases.battery.rst.txt +++ b/docs/build/html/_sources/test_cases.battery.rst.txt @@ -1,4 +1,4 @@ -Battery Test Cases +Battery test Case =========================== Module contents @@ -9,7 +9,6 @@ Module contents :undoc-members: :show-inheritance: - Subpackages ----------- @@ -77,14 +76,6 @@ test\_cases.battery.scenarios module :undoc-members: :show-inheritance: -test\_cases.battery.sim module ------------------------------- - -.. automodule:: test_cases.battery.sim - :members: - :undoc-members: - :show-inheritance: - test\_cases.battery.voltdump2 module ------------------------------------ diff --git a/docs/build/html/_sources/test_cases.rst.txt b/docs/build/html/_sources/test_cases.rst.txt index e16d54f28..f5dd0d32f 100644 --- a/docs/build/html/_sources/test_cases.rst.txt +++ b/docs/build/html/_sources/test_cases.rst.txt @@ -1,14 +1,6 @@ Test cases =================== -Module contents ---------------- - -.. automodule:: test_cases - :members: - :undoc-members: - :show-inheritance: - Subpackages ----------- @@ -18,3 +10,10 @@ Subpackages test_cases.base_case test_cases.battery +Module contents +--------------- + +.. automodule:: test_cases + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/build/html/analysis.html b/docs/build/html/analysis.html index aec615c98..d1814dfbc 100644 --- a/docs/build/html/analysis.html +++ b/docs/build/html/analysis.html @@ -19,8 +19,8 @@ - - + + @@ -54,19 +54,18 @@

Modules

@@ -97,6 +96,11 @@

Post-simulation Analysis

+
+

Module contents

+

This module runs the post-simulation cost calculations for DER assets and transformer aging. +This module also estimates the voltage violations within the distribution network.

+

Submodules

@@ -382,11 +386,6 @@

Submodules -

Module contents

-

This module runs the post-simulation cost calculations for DER assets and transformer aging. -This module also estimates the voltage violations within the distribution network.

@@ -394,8 +393,8 @@

Submodules - - + +
diff --git a/docs/build/html/app.html b/docs/build/html/app.html index 8a4e236c7..a58fa2798 100644 --- a/docs/build/html/app.html +++ b/docs/build/html/app.html @@ -4,7 +4,7 @@ - app module — EV-EcoSim 1.0.0 documentation + App - runs the platform — EV-EcoSim 1.0.0 documentation - - - - - - - - - - - - - - -
- - -
- -
-
-
-
    -
    • -
  • Packages
    • -
  • Feeder Population
    • -
  • -
    • -
-
-
-
-
- -
-

Feeder Population

-
-

Module contents

-

Introduction

-

This is the feeder population module for the base test case. This file performs the pre-simulation step for -running EV-Ecosim.

-

It takes in a base Gridlab-D Model (GLM) file (for example, IEEE123.glm), and modifies that file by including -secondary distribution, home loads, and EV Charging station and transformers.

-

Once this script is done running, it reads and writes new GLM as <initial_glm_name>_populated.glm and -<initial_glm_name>_secondary.glm, and saves them within the test case folder. These saved files are used to run the -simulation. These files are saved in the ‘test_case_dir’ field specified in config.txt.

-

Input file description

-

Config config.txt: configuration file describing the pre-simulation parameters. -This can be modified directly or with the help of our Graphic User Interface (GUI). The return outputs of this module -are files that are read in to run the EV-Ecosim environment.

-

Output file description

-

real_power.csv - Real power; this is residential real load timeseries file per node_name/bus

-

reactive_power.csv - Reactive power; this is residential reactive load timeseries file per node_name/bus.

-

XXXX.glm - GridLabD model files. These are usually the synthetic feeders.

-
-
-

Submodules

-
-
-

feeder_population.feeder_population module

-
-
-

feeder_population.glm_mod_functions module

-

Functions for modifying GridLAB-D power system simulation models

-
-
-feeder_population.glm_mod_functions.load_base_glm(base_file_dir, base_glm_file)
-

Loads the glm as list and populates it into dict and returns the output

-
-
Parameters:
-
    -

  • base_file_dir –

    • -

  • base_glm_file –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.replace_load_w_meter(glm_dict, match_str, rep_str, obj_type)
-

Replace all instances of load in glm_dict with meter.

-
-
Parameters:
-
    -

  • glm_dict –

    • -

  • match_str –

    • -

  • rep_str –

    • -

  • obj_type –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.replace_load_w_meter_old(glm_dict, match_str, rep_str, obj_type)
-

Replace all instances of load in glm_dict with meter.

-
-
Parameters:
-
    -

  • glm_dict –

    • -

  • match_str –

    • -

  • rep_str –

    • -

  • obj_type –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_base_glm(glm_dict, obj_type, globals_list, include_list, out_dir, file_name, sync_list)
-

Writes the glm file from the dict structure.

-
-
Parameters:
-
    -

  • glm_dict –

    • -

  • obj_type –

    • -

  • globals_list –

    • -

  • include_list –

    • -

  • out_dir –

    • -

  • file_name –

    • -

  • sync_list –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_class_dict(file, gld_dict, class_name)
-

Write dictionary corresponding to GLD class to .glm file.

-
-
Parameters:
-
    -

  • file –

    • -

  • gld_dict –

    • -

  • class_name –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_clock_dict(file, gld_dict)
-

Write dictionary corresponding to GLD clock to .glm file.

-
-
Parameters:
-
    -

  • file –

    • -

  • gld_dict –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_filter_dict(file, gld_dict, class_name)
-

Write dictionary corresponding to GLD filter to .glm file.

-
-
Parameters:
-
    -

  • file –

    • -

  • gld_dict –

    • -

  • class_name –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_mod_dict(file, gld_dict, mod_name)
-

Write dictionary corresponding to GLD module to .glm file.

-
-
Parameters:
-
    -

  • file –

    • -

  • gld_dict –

    • -

  • mod_name –

    • -
-
-
Returns:
-

-
-
-
- -
-
-feeder_population.glm_mod_functions.write_obj_dict(file, gld_dict, dict_key, obj_type)
-

Write dictionary corresponding to GLD objects to .glm file.

-
-
Parameters:
-
    -

  • file –

    • -

  • gld_dict –

    • -

  • dict_key –

    • -

  • obj_type –

    • -
-
-
Returns:
-

-
-
-
- -
-
- - -
-
- -
-
-
-
- - - - \ No newline at end of file diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html index 39adf1890..8445ed6b1 100644 --- a/docs/build/html/genindex.html +++ b/docs/build/html/genindex.html @@ -47,6 +47,10 @@ +

Modules

+ @@ -76,8 +80,1131 @@

Index

+ A + | B + | C + | D + | E + | F + | G + | I + | L + | M + | N + | O + | P + | R + | S + | T + | U + | V + | W
+

A

+ + + +
    +
  • + analysis.load_post_opt_costs + +
    • +
  • + analysis.plot_results + +
    • +
  • + app + +
    • +
+ +

B

+ + + +
+ +

C

+ + + +
+ +

D

+ + + +
+ +

E

+ + + +
+ +

F

+ + + +
+ +

G

+ + + +
+ +

I

+ + + +
+ +

L

+ + + +
+ +

M

+ + + +
+ +

N

+ + + +
+ +

O

+ + + +
+ +

P

+ + + +
+ +

R

+ + + +
+ +

S

+ + + +
+ +

T

+ + + +
    +
  • test() (in module charging_sim.battery) +
    • +
  • + test_cases + +
    • +
  • + test_cases.base_case + +
    • +
  • + test_cases.base_case.event_handlers + +
    • +
  • + test_cases.base_case.feeder_population + +
    • +
  • + test_cases.base_case.feeder_population.feeder_population + +
    • +
  • + test_cases.base_case.feeder_population.glm_mod_functions + +
    • +
  • + test_cases.base_case.gblvar + +
    • +
  • + test_cases.battery + +
    • +
+ +

U

+ + + +
+ +

V

+ + +
+ +

W

+ + + +
+ diff --git a/docs/build/html/index.html b/docs/build/html/index.html index e0c83c3d6..ba7d55992 100644 --- a/docs/build/html/index.html +++ b/docs/build/html/index.html @@ -49,6 +49,10 @@ +

Modules

+ diff --git a/docs/build/html/modules.html b/docs/build/html/modules.html index 4b5537cfe..6e96416b7 100644 --- a/docs/build/html/modules.html +++ b/docs/build/html/modules.html @@ -19,7 +19,7 @@ - + @@ -54,12 +54,11 @@

Modules

@@ -91,57 +90,40 @@

Packages

@@ -177,7 +168,7 @@

Packages - +
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv index 0a30d278ab8b22bb7a6d01983a698fc82ad6f388..9dc8e3de78e1b1665f9955201e42c64f9fd5a919 100644 GIT binary patch delta 3843 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 FwhL{}iID&R delta 749 zcmVt$!^;)5WVv&SR~iUa?K@35f?F#plMtrM}elsHW5lx$&p?E zeMxHfQYr97Cf|FrXy$32lQn56Ntyh5hgzBpxuf(hHIlrM#t1Q4Fz?<5Zf+%r&m#EZNtX4|KeoYV}0?&g3o>#Og zU8{V}X@fjfPMSPNNqmX4L(F+eN-I+6xbQXO)*&yf*?Jx8rnaDo0X_zFF`$kCZ4B@+ zAjE(!#`iBJIDdOz%(?`b+z1=UiBs8VlNvAtFtAi-CPh7Ejvk+1em>5g7YsGZ#0tW3 zR)9hU1%_KdX+qpW3tAaFo^4BkmNI*XnKX-@3R@xiMkIwPN47cTY!5#`^AV8m57VF~F zzSRryQM;Olb}hfXy1BaH9$aRA#bW2a1r;Uh(Im0dhjY=1UewUI0yT7g#AaIMpXW6$ z`E$5uesE9psn|nv(HL%8YOFh!weCCJ*?Nv$7)N1onxUEO!UsfXiLYlAS+9S;}N@#c8JXNVjDL7t47)bq!0grcc(Ag?2N5aw_?+tG- zy)kq6Z+cM@x*3lie8M|omWwL>(=h%CTN%8^{+1lS;L~)Uo5ipwQ%vQp2WJk2m75`} zI;+Ahs{2>5MvtYk=%*JCDqMA!#nE8>KZnu{<7Og0LJb1uj23pPython Module Index

a | b | c | - f | t @@ -219,52 +218,78 @@

Python Module Index

charging_sim.utils   - - f + + t - feeder_population + test_cases     - feeder_population.glm_mod_functions + test_cases.base_case -   - - t - - - - test_cases + + +     + test_cases.base_case.event_handlers - +     - test_cases.base_case + test_cases.base_case.feeder_population + + + +     + test_cases.base_case.feeder_population.feeder_population + + + +     + test_cases.base_case.feeder_population.glm_mod_functions + + + +     + test_cases.base_case.gblvar - +     test_cases.battery - + + +     + test_cases.battery.event_handlers + + + +     + test_cases.battery.event_handlers_oneshot + +     test_cases.battery.feeder_population - +     - test_cases.battery.feeder_population.glm_mod_functions + test_cases.battery.feeder_population.feeder_population_centralized - +     - test_cases.battery.scenarios + test_cases.battery.feeder_population.feeder_population_collocated + + + +     + test_cases.battery.feeder_population.glm_mod_functions diff --git a/docs/build/html/readme/README.html b/docs/build/html/readme/README.html index 9ee8516b8..077c8d9e6 100644 --- a/docs/build/html/readme/README.html +++ b/docs/build/html/readme/README.html @@ -70,6 +70,10 @@ +

Modules

+ diff --git a/docs/build/html/search.html b/docs/build/html/search.html index 967507885..a77d0bd11 100644 --- a/docs/build/html/search.html +++ b/docs/build/html/search.html @@ -50,6 +50,10 @@ +

Modules

+ diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js index 0c25dfe8a..07060d04a 100644 --- a/docs/build/html/searchindex.js +++ b/docs/build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["Introduction/welcome", "index", "readme/README", "setup", "tutorials/tutorial"], "filenames": ["Introduction\\welcome.md", "index.rst", "readme\\README.md", "setup.rst", "tutorials\\tutorial.md"], "titles": ["Motivation", "Welcome to EV-EcoSim 1.0.0 documentation!", "EV-EcoSim platform", "setup module", "Tutorials"], "terms": {"thi": [0, 1, 2], "contain": 2, "costestim": 2, "class": 2, "which": [0, 2], "estim": 2, "cost": 2, "differ": 2, "grid": [0, 1, 2], "der": [0, 1, 2], "compon": [0, 2], "from": 2, "us": 2, "calcul": 2, "num_dai": [], "base": [1, 2], "object": [], "level": 2, "asset": [], "ev": 0, "ecosim": 0, "The": [0, 1, 2], "lcoe": [], "energi": [0, 1, 2], "defin": [], "revenu": [], "total": 2, "net": [], "expenditur": [], "requir": 0, "build": 2, "oper": 0, "an": [0, 2], "system": [1, 2], "over": [], "specifi": 2, "recoveri": [], "period": [], "normal": 2, "entir": [], "throughput": [], "compar": [], "econom": [], "devic": [], "would": 0, "otherwis": [], "challeng": [], "paramet": 2, "number": [], "dai": 2, "run": [], "calculate_battery_cost": [], "result_dir": [], "batteri": [0, 1, 2], "updat": [], "includ": 2, "directori": [], "save": 2, "result": 2, "dictionari": [], "return": [], "dict": [], "result_dict": [], "calculate_electricity_cost_pgebev2": [], "pge_separate_fil": [], "true": [], "overal": 2, "electr": [0, 1, 2], "pgebev2": [], "given": [], "scenario": 2, "str": [], "A": 2, "compris": [], "all": 2, "dollar": [], "amount": 2, "calculate_solar_cost": [], "valu": 2, "ar": 2, "pull": [], "nrel": 2, "solar": [0, 1, 2], "ref": [], "http": [], "www": [], "gov": [], "market": [], "research": [], "html": [], "To": [], "deprec": [], "soon": 1, "none": [], "calculate_trans_loss_of_lif": [], "expect": 0, "transform": [0, 2], "loss": [], "life": [], "lol": [], "model": [1, 2], "function": 2, "hot": [], "spot": 2, "temperatur": 2, "refer": [], "5": [], "11": [], "3": 1, "ieee": 2, "std": [], "c57": [], "12": 2, "00": [], "2010": [], "minimum": [], "insul": [], "180": [], "000": [], "hour": [], "static": [], "plot_load": [], "total_load": [], "net_load": [], "prefix": [], "label": 2, "option": [], "list": 2, "creat": 2, "plot": 2, "overlai": [], "load": 2, "visual": [], "demand": 0, "node": 2, "can": [0, 2], "control": [0, 1, 2], "minu": [], "buffer": [], "file": 2, "legend": [], "each": 2, "curv": [], "plot_pow": [], "power": [0, 1, 2], "power_pr": [], "predict": [], "plot_soc": [], "soc": [], "soc_pr": [], "state": 2, "charg": [0, 1, 2], "solar_cost": [], "capit": [], "give": [], "station": [0, 1, 2], "design": [0, 2], "problem": [], "Not": [], "fulli": [], "implement": 2, "locat": 0, "pv": [0, 2], "transformer_cost": [], "cannot": [], "find": [], "good": [], "resourc": [0, 1, 2], "data": 2, "yet": [], "overview": [], "popul": 2, "tabl": 2, "matric": 2, "respect": 2, "folder": [], "collate_result": [], "month": [0, 2], "tran": [], "oneshot": [], "fals": [], "collat": [], "them": [], "matrix": [], "being": [], "bool": [], "boolean": [], "decid": 0, "ag": 2, "tell": [], "were": [], "obtain": [], "mpc": [], "plot_stacked_bar": [], "elec_cost": [], "batt_cost": [], "save_plot_path": [], "stack": [], "bar": [], "portion": [], "contribut": [], "datafram": [], "string": 2, "path": 2, "plot_tabl": [], "batt_dtabl": [], "elec_cost_dt": [], "trans_cost_dt": [], "batt_aging_t": [], "solar_cost_t": [], "save_plots_fold": [], "chart": [], "run_result": [], "case_dir": [], "days_count": [], "trans_cost": [], "case": 2, "int": [], "usual": 2, "30": [], "now": 2, "pars": 2, "voltag": [0, 2], "percentag": 2, "violat": 2, "per": 2, "ansi": 2, "c84": 2, "1": 2, "also": 2, "gener": 2, "distribut": [0, 1, 2], "user": 2, "modifi": 2, "simulation_fold": [], "variabl": 2, "where": [0, 2], "powerflow": 2, "output": 2, "exist": [0, 2], "iter": [], "through": [], "same": [], "csv": 2, "applic": [], "main": [], "start": [], "change_run_d": [], "chang": [], "date": [], "simul": [0, 1], "create_results_fold": [], "dir": [], "one": 2, "doe": [], "create_temp_config": [], "temporari": [], "configur": 2, "load_default_input": [], "default": 2, "input": 2, "skeleton": [], "make_month_str": [], "month_int": [], "make": 0, "integ": [], "add": [], "0": [], "less": [], "than": [], "10": [], "januari": 2, "2": 2, "februari": [], "etc": [0, 2], "user_input": [], "sequential_run": [], "parallel_run": [], "validate_opt": [], "front_input": [], "valid": [], "ensur": 2, "select": [], "match": [], "workflow": [], "backend": [], "host": 2, "fit": [], "ecm": 2, "batteryparam": [], "open": 2, "circuit": 2, "correct": 2, "scheme": [], "take": 0, "some": 2, "field": 2, "dure": 2, "instanti": [], "column": 2, "must": 2, "follow": 2, "liter": [], "sensit": 2, "current": [], "cell": 2, "time": 2, "seri": [], "correspond": [], "ocv": 2, "how": [], "pd": [], "read_csv": [], "data_path": [], "panda": [], "run_sys_identif": [], "plot_correction_scheme_comparison": [], "write": 2, "new": [0, 2], "within": [0, 1, 2], "download": [], "via": [], "web": 1, "tool": 1, "test": 2, "param": 2, "ga": [], "num_gener": [], "100": 0, "num_parents_m": [], "sol_per_pop": [], "num_gen": [], "7": [], "crossover_typ": [], "single_point": [], "mutation_typ": [], "adapt": [], "parent_selection_typ": [], "sss": [], "mutation_percent_gen": [], "60": [], "mutation_prob": [], "crossover_prob": [], "genet": 2, "algorithm": 2, "instanc": [], "pleas": 2, "see": 2, "pygad": [], "offici": [], "document": [], "more": 2, "explan": [], "have": 2, "been": [], "optim": [0, 1, 2], "accuraci": [], "speed": [], "howev": 0, "ani": 2, "mai": [], "combin": [], "work": [0, 2], "better": [], "set": 2, "parent": [], "form": [], "next": [], "offspr": [], "solut": [], "gene": [], "size": 2, "equival": 2, "search": 1, "describ": 2, "cross": [], "between": [], "mate": [], "done": 2, "mutat": [], "undergo": [], "probabl": [], "appli": [], "Its": [], "inclus": 2, "vector": [], "get_ro": [], "high": [], "frequenc": [], "ro": [], "resist": [], "r_o": [], "get_corrected_voltag": [], "respons": [], "get_uncorrected_voltag": [], "uncorrect": [], "plot_ro": [], "xlim": [], "20000": [], "36000": [], "ylim": [], "75": [], "85": [], "non": [], "run_ocv_correct": [], "use_quadrat": [], "cell_nam": [], "diagn": [], "attribut": [], "quadrat": [], "linear": [], "wa": [], "origin": 2, "paper": 2, "run_pre_check": [], "pre": 2, "check": [], "thei": 2, "desir": 0, "length": [], "begin": [], "error": 2, "use_initial_pop": [], "quadratic_bia": [], "simulate_respons": [], "complet": 0, "battery_typ": [], "config": 2, "least": 2, "physic": 2, "constraint": [], "properti": [], "mainli": [], "json": 2, "max": [], "c": [], "rate": 2, "determin": 0, "capac": 0, "multipl": [], "v": [], "maximum": [], "allow": [], "min": [], "nomin": [], "kwh": [], "deliver": [], "id": [], "ambient": 2, "celsiu": [], "type": 2, "inconsequenti": [], "dynam": [], "bu": [], "network": [1, 2], "resid": [], "self": [], "battery_setup": [], "up": [], "parallel": [], "scale": [], "ah": [], "setup": [], "fix": [], "while": 0, "float": [], "pack": 2, "wh": [], "topolog": [], "battery_setup_2": [], "instead": [], "therebi": [], "pack_max_ah": [], "watt": [], "amp": [], "cell_amp_hr": [], "cell_voltag": [], "propag": [], "forward": [], "step": [], "It": 2, "amper": [], "np": [], "cycl": [], "est_calendar_ag": [], "constant": [], "calendar": [], "sole": [], "depend": [], "later": [], "est_cyc_ag": [], "hess": [], "et": [], "al": [], "its": [], "cvx": [], "cvxpy": [], "get_ocv": [], "map": [], "store": [], "interpol": [], "priori": [], "s": 0, "possibl": [], "get_aging_valu": [], "ha": 2, "experienc": [], "so": 2, "far": [], "get_power_profil": [], "profil": [], "certain": 0, "get_properti": [], "get_roundtrip_effici": [], "get_total_ag": [], "get_true_pow": [], "save_sim_data": [], "save_prefix": [], "relev": 2, "call": [], "upon": [], "conclus": [], "save_st": [], "state_eqn": [], "append": [], "discret": [], "equat": [], "here": [], "g": [], "l": [], "plett": [], "manag": [], "volum": [], "i": 0, "artech": [], "hous": [], "2015": [], "vol": [], "track": [], "b": [], "post": [], "analys": [], "histori": [], "thermal_dynam": [], "futur": 0, "track_soc": [], "update_soc": [], "update_capac": [], "anticip": [], "update_max_curr": [], "verbos": [], "update_param": [], "update_voltag": [], "method": 2, "batteryag": [], "enact": [], "datetim": [], "num_step": [], "re": [], "15": 2, "linimncoo2": [], "nmc": 2, "ad": [], "link": 2, "sciencedirect": [], "com": [], "scienc": [], "articl": [], "pii": [], "s0378775314001876": [], "beta_cap": [], "fade": [], "factor": [], "alpha_cap": [], "beta_r": [], "growth": 0, "alpha_r": [], "assumpt": [], "homogen": [], "uniform": [], "across": [], "vicin": [], "lfp_cal_ag": [], "lfp_cyc_ag": [], "nmc_cal_ag": [], "nmc_cyc_ag": [], "get_calendar_ag": [], "tupl": [], "due": [], "get_cyc_ag": [], "THe": [], "batt": 2, "both": [], "adopt": [], "schmalsteig": [], "update_resist": [], "structur": [], "compos": [], "individu": [], "connect": [], "achiev": [], "exampl": [], "usag": [], "battery_config_path": [], "r": [], "f": 2, "battery_config": [], "params_list": [], "kei": 0, "params_": [], "Then": 0, "params_kei": [], "actual": [], "those": [], "prior": [], "loadtxt": [], "path_prefix": [], "constructor": [], "buffer_batteri": [], "r_pack": [], "initi": 2, "sum": [], "aging_c": [], "lost": [], "after": [], "round": [], "trip": [], "effici": [], "_eff": [], "out": 2, "last": [], "load_pack_prop": [], "balogun": 2, "dx": [], "doi": [], "org": [], "36227": [], "techrxiv": [], "23596725": [], "v2": [], "nominal_pack_cap": [], "py": 2, "meth": [], "thermal": 2, "intern": [], "surfac": 2, "avail": 0, "version": 2, "defer": [], "TO": [], "BE": [], "need": [0, 2], "anymor": [], "onli": [], "right": [], "name": 2, "storag": 0, "statu": [], "idl": [], "produc": [], "reactiv": [], "retain": [], "inform": [], "inject": 2, "ingest": [], "assign": [], "get_current_load": [], "kw": 0, "is_ev_arriv": [], "arriv": [], "indic": [], "is_charg": [], "unit": 0, "set_current_load": [], "update_load": [], "net_grid_load": [], "ev_load": [], "mode": 2, "vehicl": [0, 1, 2], "update_load_oneshot": [], "offlin": 2, "update_statu": [], "bess": [], "compute_control": [], "price_vector": [], "action": [], "comput": [], "pass": [], "tou": 2, "control_act": [], "signal": [], "arbitrag": [], "get_battery_constraint": [], "satisfi": [], "storage_constraint": [], "initialize_forecast_data": [], "forecast": 2, "load_battery_ocv": [], "learn": [], "reset_load": [], "full": 2, "96": [], "feedback": 2, "price": 2, "sampl": 2, "detail": 2, "pge_bev2_": [], "california": [], "own": [], "numpi": [], "arrai": [], "year": 2, "priceload": [], "evs": [], "profit": [], "loader": [], "first": [], "your": 2, "repositori": [1, 2], "downscal": 2, "input_r": [], "output_r": [], "finer": [], "resolut": 2, "similar": [], "typic": [], "onc": 2, "get_pric": [], "start_idx": [], "assum": [], "do": [], "index": [1, 2], "cardin": [], "jan": [], "decemb": 2, "ndarrai": [], "set_month_data": [], "solv": [], "objective_typ": [], "power_demand": [], "time_r": [], "solver": 1, "gurobi": [], "degrad": [], "limit": 2, "convex": [], "mix": [], "program": [], "note": 2, "instal": [0, 2], "separ": [], "pc": [], "success": 0, "counter": [], "identifi": [], "invok": [], "eco": [], "mosek": [], "add_demand_charg": [], "aggregate_constraint": [], "aggreg": [], "build_battery_cost": [], "build_emissions_cost": [], "emiss": [], "build_transformer_cost": [], "get_constraint": [], "chargingsim": [], "num_charging_sit": [], "6": [], "num_ev": [], "1600": [], "custom_ev_data": [], "custom_ev_data_path": [], "custom_solar_data": [], "custom_solar_data_path": [], "organ": 2, "other": [], "sequenti": [], "manner": [], "secondari": 2, "If": [], "site": [], "help": [0, 2], "access": 2, "proper": [], "os": [], "minut": 2, "create_battery_object": [], "idx": [], "node_prop": [], "identif": 2, "l2": [], "dcfc": [], "create_charging_st": [], "power_nod": [], "buse": [], "create_charging_stations_oneshot": [], "create_solar_object": [], "loc": [], "get_act": [], "get_charger_obj_by_loc": [], "get_charging_sit": [], "initialize_aging_sim": [], "initialize_control": [], "initialize_price_load": [], "memori": [], "initialize_solar_modul": [], "load_battery_param": [], "directli": [], "sim": 2, "unless": [], "load_config": [], "walk": [], "load_results_summari": [], "save_path_prefix": [], "multistep": [], "much": 2, "faster": [], "horizon": [], "perfect": [], "foresight": [], "daili": [], "reset": [], "power_nodes_list": [], "accordingli": [], "specif": [], "stepsiz": [], "update_scenario": [], "update_step": [], "move": [], "without": 0, "studi": 0, "effect": 2, "character": [], "what": [], "occur": [], "situ": [], "app": [], "global": 2, "horizont": 2, "irradi": 2, "ghi": 2, "dataset": 2, "namepl": [], "p_": [], "eta": [], "area": 2, "panel": [], "decis": [], "flow": 1, "get_pow": [], "desired_shap": [], "get_solar_output": [], "modify_r": [], "new_r": [], "update_histori": [], "purpos": [], "schedul": [], "pge": [], "doc": [], "found": [], "add_power_profile_to_object": [], "battery_power_profil": [], "build_cost_pge_bev2": [], "energy_prices_t": [], "penalize_max_pow": [], "max_power_pen": [], "1000": [], "heurist": [], "averag": [], "conserv": [], "gamma": [], "build_electricity_cost": [], "demand_charg": [], "home": 2, "mayb": [], "opt": [], "build_object": [], "electricity_cost": [], "battery_degradation_cost": [], "we": [], "minim": 2, "load_pric": [], "time_interv": [], "gridlab": [1, 2], "d": [1, 2], "load_base_glm": [], "base_file_dir": [], "base_glm_fil": [], "glm": 2, "replace_load_w_met": [], "glm_dict": [], "match_str": [], "rep_str": [], "obj_typ": [], "replac": [], "meter": [], "replace_load_w_meter_old": [], "write_base_glm": [], "globals_list": [], "include_list": [], "out_dir": [], "file_nam": [], "sync_list": [], "write_class_dict": [], "gld_dict": [], "class_nam": [], "gld": [], "write_clock_dict": [], "clock": [], "write_filter_dict": [], "filter": 2, "write_mod_dict": [], "mod_nam": [], "write_obj_dict": [], "dict_kei": [], "python": [1, 2], "multi": 1, "timescal": 1, "awar": [1, 2], "co": [0, 1, 2], "platform": [0, 1], "infrastructur": [0, 1], "develop": [1, 2], "integr": [0, 1, 2], "interfac": 1, "phase": 1, "unbalanc": 1, "captur": [1, 2], "impact": [1, 2], "fast": 1, "preprint": [], "come": [0, 1], "modul": [1, 2], "page": 1, "analysi": [], "cost_analysi": 2, "load_post_opt_cost": 2, "plot_result": 2, "batt_sys_identif": [], "battery_identif": [], "charging_sim": [], "batteryagingsim": 2, "batterypack": 2, "batterytest": [], "capacitor": [], "chargingst": 2, "electricitypric": 2, "orchestr": 2, "util": 2, "content": 2, "feeder": [], "feeder_popul": [], "glm_mod_funct": [], "subpackag": [], "submodul": [], "test_cas": [], "base_cas": 2, "event_handl": [], "gblvar": [], "glmptime": [], "master_sim": 2, "voltdump2": [], "event_handlers_oneshot": [], "parse_voltag": [], "feeder_population_old": [], "introduct": [], "perform": 0, "ieee123": [], "script": 2, "read": 2, "initial_glm_nam": [], "_popul": [], "_secondari": [], "These": [], "test_case_dir": [], "txt": 2, "descript": [], "our": [], "graphic": [], "gui": [], "environ": 2, "real_pow": [], "real": [], "residenti": 2, "timeseri": [], "reactive_pow": [], "dcfc_bu": [], "dc": [], "l2charging_bu": [], "electrif": 0, "transport": 0, "decarbon": 0, "sector": 0, "inevit": 0, "increas": 0, "expans": 0, "leverag": [0, 2], "technolog": 0, "clever": 0, "wai": 0, "coordin": 0, "todai": 0, "fundament": 0, "suppli": 0, "equip": 0, "rapid": 0, "deploy": 0, "difficult": 0, "present": 0, "serv": 0, "testb": 0, "mind": 0, "sai": 0, "e": 0, "chargepoint": 0, "electrifi": 0, "america": 0, "want": 0, "deploi": 0, "san": [0, 2], "francisco": [0, 2], "ca": 0, "contact": 0, "pg": 0, "process": 0, "sometim": 0, "eventu": 0, "might": 0, "support": 0, "let": 0, "even": 0, "get": 0, "chain": 0, "issu": 0, "abl": 0, "avoid": [0, 2], "upgrad": 0, "imagin": 0, "guarante": 0, "exce": 0, "threshold": 0, "approv": 0, "In": 0, "fact": 0, "agreement": 0, "servic": 0, "peak": 0, "shave": 0, "regul": 0, "realiti": 0, "emmanuel": 2, "ebalogun": 2, "stanford": 2, "edu": 2, "hipa": 2, "master": 2, "branch": 2, "recommend": 2, "aw": 2, "ec2": 2, "slac": 2, "gismo": 2, "ami": 2, "beauharnoi": 2, "x": 2, "below": 2, "_": 2, "environment": 2, "condit": 2, "subsystem": 2, "uncontrol": 2, "proprietari": 2, "pecan": 2, "street": 2, "exmapl": 2, "prototyp": 2, "sy": 2, "experiment": 2, "2nd": 2, "order": 2, "rc": 2, "One": 2, "custom": 2, "upload": 2, "shown": 2, "addit": 2, "ocv_corr": 2, "abov": 2, "battery_data": 2, "encompass": 2, "legaci": 2, "elec": 2, "365": 2, "format": 2, "should": 2, "coarser": 2, "librari": 2, "pnnl": 2, "taxonomi": 2, "primari": 2, "vari": 2, "necessari": 2, "repo": 2, "nation": 2, "radiat": 2, "databas": 2, "nsrdb": 2, "bai": 2, "renew": 2, "laboratori": 2, "hourli": 2, "interv": 2, "oversampl": 2, "4": 2, "repres": 2, "w": 2, "m": 2, "shortwav": 2, "receiv": 2, "ground": 2, "timestep": 2, "rlsf": 2, "plu": 2, "recurs": 2, "squar": 2, "onlin": 2, "conda": 2, "env": 2, "yml": 2, "OR": 2, "packag": 2, "manual": 2, "gridlabd": 2, "For": 2, "navig": 2, "prepar": 2, "confirm": 2, "successfulli": 2, "ieee123_secondari": 2, "ieee123_popul": 2, "you": 2, "prep": 2, "python3": 2, "ev50_cosimul": 2, "section": 2, "quick": [], "quickstart": [], "click": [], "expand": [], "collaps": 4, "total_load_color": [], "blue": [], "net_load_color": [], "orang": [], "node_nam": [], "color": [], "user_input_path": [], "40": [], "error_stat": [], "stall": [], "port": [], "load_charging_data": [], "uniqu": [], "chargingstationcentr": [], "central": [], "mpccentral": [], "central_der_dict": [], "rhc": [], "create_charging_stations_centr": [], "charging_nodes_list": [], "share": [], "provid": [], "fleet": [], "offset": [], "consumpt": [], "especi": [], "block": [], "soh": [], "reced": [], "account": [], "easili": [], "uncertainti": [], "step_centr": [], "reason": [], "becaus": [], "like": [], "tariff": [], "zone": [], "territori": [], "emissions_cost": [], "public": [1, 2], "enough": [], "cpu": [], "rerun": [], "load_input_config": [], "make_scenario": [], "No": [], "preload": [], "run_scenario_singl": [], "run_scenarios_parallel": [], "multicor": [], "processor": [], "core": [], "ram": [], "lead": [], "freez": [], "run_scenarios_sequenti": [], "associ": [], "statement": [], "written": [], "sync": [], "eas": [], "tempor": [], "understand": [], "deriv": [], "pf_dt": [], "second": [], "trans_dt": [], "battery_dt": [], "dt": [], "children": [], "colloc": [], "singl": [], "thu": [], "when": [], "know": [], "child": [], "add_child": [], "oiltypetransform": [], "global_clock": [], "temperature_data": [], "plot_stat": [], "previou": [], "increment": [], "nonlinear": [], "swift": [], "2001": [], "xxxx": [], "synthet": [], "experi": [], "feeder_population_centr": [], "feeder_population_colloc": []}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"post": 2, "simul": 2, "analysi": 2, "cost_analysi": [], "modul": 3, "load_post_opt_cost": [], "plot_result": [], "app": [], "batteri": [], "system": [], "identif": [], "batt_sys_identif": 2, "battery_identif": [], "charg": [], "charging_sim": 2, "batteryagingsim": [], "batterypack": [], "batterytest": [], "capacitor": [], "chargingst": [], "control": [], "electricitypric": [], "optim": [], "orchestr": [], "solar": [], "util": 0, "content": [], "feeder": 2, "popul": [], "feeder_popul": 2, "glm_mod_funct": [], "welcom": 1, "ev": [1, 2, 4], "ecosim": [1, 2, 4], "1": 1, "0": 1, "document": 1, "what": [1, 4], "link": 1, "indic": 1, "tabl": 1, "packag": [], "setup": 3, "test": [], "case": [], "subpackag": [], "base": [], "submodul": [], "test_cas": 2, "base_cas": [], "event_handl": [], "gblvar": [], "glmptime": [], "master_sim": [], "sim": [], "voltdump2": [], "event_handlers_oneshot": [], "parse_voltag": [], "scenario": [], "feeder_population_old": [], "motiv": 0, "background": 0, "bridg": 0, "disconnect": 0, "between": 0, "evs": 0, "provid": 0, "platform": [2, 4], "author": 2, "requir": 2, "folder": 2, "descript": 2, "ambient_data": 2, "base_load_data": 2, "dlmodel": 2, "elec_r": 2, "solar_data": 2, "how": [2, 4], "run": [2, 4], "tutori": 4, "quick": 4, "introduct": 4, "quickstart": 4, "experi": [], "clock": [], "node": [], "transform": [], "feeder_population_centr": [], "feeder_population_colloc": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.todo": 2, "sphinx": 56}}) \ No newline at end of file +Search.setIndex({"docnames": ["Introduction/welcome", "analysis", "app", "batt_sys_identification", "charging_sim", "index", "modules", "readme/README", "setup", "test_cases", "test_cases.base_case", "test_cases.base_case.feeder_population", "test_cases.battery", "test_cases.battery.feeder_population", "tutorials/tutorial"], "filenames": ["Introduction\\welcome.md", "analysis.rst", "app.rst", "batt_sys_identification.rst", "charging_sim.rst", "index.rst", "modules.rst", "readme\\README.md", "setup.rst", "test_cases.rst", "test_cases.base_case.rst", "test_cases.base_case.feeder_population.rst", "test_cases.battery.rst", "test_cases.battery.feeder_population.rst", "tutorials\\tutorial.md"], "titles": ["Motivation", "Post-simulation Analysis", "App - runs the platform", "Battery System Identification", "Charging Sim", "Welcome to EV-EcoSim 1.0.0 documentation!", "Packages", "EV-EcoSim platform", "setup module", "Test cases", "Base test case", "Base case feeder population", "Battery test Case", "Battery test case feeder population", "Tutorials"], "terms": {"thi": [0, 1, 2, 3, 4, 5, 7, 10, 11, 12, 13], "contain": [1, 4, 7, 13], "costestim": [1, 7], "class": [1, 3, 4, 7, 11, 13], "which": [0, 1, 3, 4, 7, 10, 12], "estim": [1, 4, 7], "cost": [1, 4, 7], "differ": [1, 4, 7, 10, 12], "grid": [0, 1, 3, 4, 5, 7, 10, 12], "der": [0, 1, 4, 5, 7, 13], "compon": [0, 1, 7], "from": [1, 2, 3, 4, 7, 10, 11, 12, 13], "us": [1, 2, 3, 4, 7, 11, 12, 13], "calcul": [1, 4, 7], "num_dai": 1, "base": [1, 3, 4, 5, 6, 7, 9, 13], "object": [1, 3, 4, 10, 11, 12, 13], "level": [1, 4, 7], "asset": [1, 4], "ev": [0, 1, 2, 4, 10, 11, 12, 13], "ecosim": [0, 1, 2, 4, 10, 11, 12, 13], "The": [0, 1, 3, 4, 5, 7, 11, 13], "lcoe": 1, "energi": [0, 1, 4, 5, 7], "defin": [1, 4, 10, 12], "revenu": 1, "total": [1, 4, 7], "net": [1, 4], "expenditur": 1, "requir": [0, 1, 2, 4, 10, 12], "build": [1, 4, 7], "oper": [0, 1, 3], "an": [0, 1, 4, 7], "system": [1, 2, 4, 5, 6, 7, 11, 13], "over": [1, 3, 4], "specifi": [1, 4, 7, 11, 13], "recoveri": 1, "period": 1, "normal": [1, 7], "entir": [1, 4], "throughput": 1, "compar": 1, "econom": 1, "devic": [1, 4], "would": [0, 1, 2, 4], "otherwis": [1, 4], "challeng": 1, "paramet": [1, 2, 3, 4, 7, 10, 11, 12, 13], "number": [1, 3, 4], "dai": [1, 4, 7], "run": [1, 3, 4, 6, 10, 11, 12, 13], "calculate_battery_cost": 1, "result_dir": 1, "batteri": [0, 1, 2, 5, 6, 7, 9], "updat": [1, 3, 4], "includ": [1, 3, 4, 7, 10, 11, 12, 13], "directori": [1, 4, 13], "save": [1, 2, 3, 4, 7, 10, 11, 12, 13], "result": [1, 2, 4, 7], "dictionari": [1, 4, 11, 13], "return": [1, 2, 3, 4, 10, 11, 12, 13], "dict": [1, 2, 4, 11], "result_dict": 1, "calculate_electricity_cost_pgebev2": 1, "pge_separate_fil": 1, "true": [1, 2, 3, 4, 10, 12], "overal": [1, 4, 7], "electr": [0, 1, 5, 6, 7], "pgebev2": 1, "given": [1, 3, 4], "scenario": [1, 4, 6, 7, 9], "str": [1, 4, 10, 12, 13], "A": [1, 4, 7], "compris": 1, "all": [1, 3, 4, 7, 10, 11, 12], "dollar": 1, "amount": [1, 7], "calculate_solar_cost": 1, "valu": [1, 3, 4, 7, 10, 12], "ar": [1, 2, 3, 4, 7, 11, 12, 13], "pull": [1, 4], "nrel": [1, 7], "solar": [0, 1, 5, 6, 7], "ref": [1, 4], "http": [1, 4], "www": [1, 4], "gov": 1, "market": 1, "research": 1, "html": 1, "To": 1, "deprec": [1, 4], "soon": [1, 5], "none": [1, 2, 3, 4, 11, 13], "calculate_trans_loss_of_lif": 1, "expect": [0, 1], "transform": [0, 1, 6, 7, 10, 11, 12, 13], "loss": [1, 4], "life": [1, 4], "lol": 1, "model": [1, 3, 4, 5, 7, 11, 13], "function": [1, 4, 7, 11, 12, 13], "hot": 1, "spot": [1, 7], "temperatur": [1, 4, 7], "refer": 1, "5": 1, "11": 1, "3": [1, 3, 5], "ieee": [1, 7], "std": 1, "c57": 1, "12": [1, 4, 7], "00": 1, "2010": 1, "minimum": [1, 4], "insul": 1, "180": 1, "000": 1, "hour": [1, 4], "static": [1, 4], "plot_load": 1, "total_load": 1, "net_load": 1, "prefix": [1, 4], "label": [1, 7], "option": [1, 2, 4], "list": [1, 4, 7, 10, 11, 12, 13], "creat": [1, 2, 4, 7], "plot": [1, 3, 4, 7], "overlai": 1, "load": [1, 2, 3, 4, 7, 10, 11, 12, 13], "visual": [1, 4], "demand": [0, 1, 4], "node": [6, 7], "can": [0, 1, 2, 3, 4, 7, 10, 11, 12, 13], "control": [0, 1, 5, 6, 7], "minu": 1, "buffer": 1, "file": [1, 2, 3, 4, 7, 10, 11, 12, 13], "legend": 1, "each": [1, 2, 4, 7], "curv": 1, "plot_pow": 1, "power": [0, 1, 2, 4, 5, 7, 10, 11, 12, 13], "power_pr": 1, "predict": [1, 4], "plot_soc": 1, "soc": [1, 3, 4], "soc_pr": 1, "state": [1, 2, 3, 4, 7, 10, 12], "charg": [0, 1, 3, 5, 6, 7, 11, 12, 13], "solar_cost": 1, "capit": 1, "give": 1, "station": [0, 1, 5, 6, 7, 11, 13], "design": [0, 1, 4, 7], "problem": [1, 4], "Not": [1, 3, 4], "fulli": [1, 2, 4], "implement": [1, 4, 7], "locat": [0, 1, 4, 13], "pv": [0, 1, 4, 7], "transformer_cost": [1, 4], "cannot": [1, 4], "find": [1, 3, 4, 10, 12], "good": 1, "resourc": [0, 1, 4, 5, 7], "data": [1, 3, 4, 7, 10, 11, 12], "yet": [1, 3, 4], "overview": [1, 4, 12], "popul": [1, 3, 7, 9, 10, 12], "tabl": [1, 7], "matric": [1, 7], "respect": [1, 4, 7], "folder": [1, 3, 4, 11, 13], "collate_result": 1, "month": [0, 1, 2, 4, 7], "tran": 1, "oneshot": [1, 4], "fals": [1, 2, 3, 4], "collat": 1, "them": [1, 4, 11, 13], "matrix": 1, "being": [1, 3, 4], "bool": [1, 3, 4, 12], "boolean": [1, 4], "decid": [0, 1, 4], "ag": [1, 6, 7], "tell": 1, "were": 1, "obtain": [1, 4, 10, 12], "mpc": [1, 4, 12], "plot_stacked_bar": 1, "elec_cost": 1, "batt_cost": 1, "save_plot_path": 1, "stack": 1, "bar": 1, "portion": 1, "contribut": [1, 4], "datafram": [1, 3], "string": [1, 2, 4, 7, 10, 12], "path": [1, 4, 7], "plot_tabl": 1, "batt_dtabl": 1, "elec_cost_dt": 1, "trans_cost_dt": 1, "batt_aging_t": 1, "solar_cost_t": 1, "save_plots_fold": 1, "chart": 1, "run_result": 1, "case_dir": 1, "days_count": 1, "trans_cost": 1, "case": [1, 3, 6, 7], "int": [1, 2, 3, 4], "usual": [1, 4, 7, 11], "30": 1, "now": [1, 4, 7], "pars": [1, 7], "voltag": [0, 1, 3, 4, 7, 10, 11, 12], "percentag": [1, 3, 7], "violat": [1, 7], "per": [1, 3, 4, 7, 11, 13], "ansi": [1, 7], "c84": [1, 7], "1": [1, 2, 3, 4, 7], "also": [1, 4, 7, 11], "gener": [1, 3, 4, 7], "distribut": [0, 1, 4, 5, 7, 11, 13], "user": [1, 2, 3, 4, 7, 10, 11, 12, 13], "modifi": [1, 4, 7, 11, 13], "simulation_fold": 1, "variabl": [1, 4, 7], "where": [0, 1, 4, 7, 13], "powerflow": [1, 4, 7, 10, 12], "output": [1, 4, 7, 11, 13], "exist": [0, 1, 2, 4, 7], "iter": [1, 4], "through": [1, 4], "same": [1, 4], "csv": [1, 3, 4, 7, 11, 12, 13], "applic": 2, "main": [2, 4, 10, 11, 12, 13], "start": [2, 4], "change_run_d": [2, 4], "chang": [2, 4, 10, 12], "date": [2, 4], "simul": [0, 2, 3, 5, 6, 10, 11, 12, 13], "create_results_fold": [2, 4], "dir": [2, 4], "one": [2, 3, 4, 7], "doe": [2, 4], "create_temp_config": [2, 4], "temporari": [2, 4], "configur": [2, 4, 7, 11, 13], "load_default_input": [2, 4], "default": [2, 3, 4, 7, 10, 12], "input": [1, 2, 3, 4, 7, 11, 13], "skeleton": [2, 4], "make_month_str": [2, 4], "month_int": [2, 4], "make": [0, 2, 4], "integ": [2, 4], "add": [2, 4], "0": [2, 3, 4], "less": [2, 4], "than": [2, 4], "10": [2, 3, 4], "januari": [2, 4, 7], "2": [2, 3, 4, 7], "februari": [2, 4], "etc": [0, 2, 4, 7, 10, 12], "user_input": [1, 2, 4], "sequential_run": [2, 4], "parallel_run": [2, 4], "validate_opt": [2, 4], "front_input": [2, 4], "valid": [2, 4], "ensur": [2, 3, 4, 7], "select": [2, 3, 4], "match": [2, 4], "workflow": [2, 4], "backend": [2, 4], "host": [3, 4, 7], "fit": 3, "ecm": [3, 7], "batteryparam": 3, "open": [3, 4, 7], "circuit": [3, 4, 7], "correct": [3, 4, 7], "scheme": [3, 4], "take": [0, 3, 4, 10, 11, 12, 13], "some": [3, 4, 7], "field": [1, 3, 7, 11, 13], "dure": [3, 4, 7], "instanti": [3, 4], "column": [3, 7], "must": [3, 4, 7], "follow": [3, 4, 7], "liter": 3, "sensit": [3, 7], "current": [3, 4], "cell": [3, 4, 7], "time": [2, 3, 4, 7, 12], "seri": [3, 4], "correspond": [3, 11, 13], "ocv": [3, 4, 7], "how": 3, "pd": 3, "read_csv": 3, "data_path": 3, "panda": [3, 4], "run_sys_identif": 3, "plot_correction_scheme_comparison": 3, "write": [3, 7, 11, 13], "new": [0, 3, 4, 7, 11, 13], "within": [0, 1, 3, 4, 5, 7, 11, 13], "download": 3, "via": [3, 4], "web": [3, 5], "tool": [3, 5], "test": [2, 3, 4, 6, 7, 11], "param": [3, 4, 7], "ga": 3, "num_gener": 3, "100": [0, 3], "num_parents_m": 3, "sol_per_pop": 3, "num_gen": 3, "7": [3, 4], "crossover_typ": 3, "single_point": 3, "mutation_typ": 3, "adapt": 3, "parent_selection_typ": 3, "sss": 3, "mutation_percent_gen": 3, "60": 3, "mutation_prob": 3, "crossover_prob": 3, "genet": [3, 7], "algorithm": [3, 7], "instanc": [3, 4, 11], "pleas": [3, 7], "see": [3, 4, 7, 10, 12], "pygad": 3, "offici": 3, "document": 3, "more": [3, 4, 7, 10, 12], "explan": 3, "have": [1, 2, 3, 4, 7], "been": [1, 3], "optim": [0, 2, 3, 5, 6, 7, 12], "accuraci": 3, "speed": 3, "howev": [0, 3, 4], "ani": [1, 3, 4, 7, 12], "mai": 3, "combin": 3, "work": [0, 3, 4, 7], "better": 3, "set": [3, 4, 7, 11], "parent": [3, 4], "form": 3, "next": 3, "offspr": 3, "solut": 3, "gene": 3, "size": [3, 7], "equival": [3, 7], "search": [3, 5], "describ": [3, 4, 7, 11, 13], "cross": 3, "between": [3, 10, 12], "mate": 3, "done": [2, 3, 4, 7, 11, 12, 13], "mutat": 3, "undergo": 3, "probabl": 3, "appli": 3, "Its": 3, "inclus": [3, 7], "vector": [3, 4], "get_ro": [3, 4], "high": 3, "frequenc": 3, "ro": 3, "resist": [3, 4], "r_o": 3, "get_corrected_voltag": 3, "respons": [3, 4], "get_uncorrected_voltag": 3, "uncorrect": 3, "plot_ro": 3, "xlim": 3, "20000": 3, "36000": 3, "ylim": 3, "75": 3, "85": 3, "non": [3, 4, 12], "run_ocv_correct": 3, "use_quadrat": 3, "cell_nam": 3, "diagn": 3, "attribut": [3, 4], "quadrat": 3, "linear": [3, 4], "wa": [2, 3, 4], "origin": [3, 7], "paper": [3, 4, 7], "run_pre_check": 3, "pre": [3, 4, 7, 11, 13], "check": [3, 4], "thei": [3, 7], "desir": [0, 3, 4], "length": 3, "begin": [3, 10, 12], "error": [3, 4, 7], "use_initial_pop": 3, "quadratic_bia": 3, "simulate_respons": 3, "complet": [0, 3], "battery_typ": 4, "config": [4, 7, 11, 13], "least": [4, 7], "physic": [4, 7, 10, 12], "constraint": 4, "properti": [4, 10, 11, 12], "mainli": 4, "json": [1, 4, 7], "max": 4, "c": 4, "rate": [4, 7], "determin": [0, 4], "capac": [0, 4], "multipl": 4, "v": 4, "maximum": 4, "allow": [4, 10, 12], "min": 4, "nomin": 4, "kwh": 4, "deliver": 4, "id": 4, "ambient": [4, 7], "celsiu": 4, "type": [4, 7, 10, 12, 13], "inconsequenti": 4, "dynam": 4, "bu": [4, 11, 13], "network": [1, 4, 5, 7], "resid": 4, "self": 4, "battery_setup": 4, "up": 4, "parallel": 4, "scale": 4, "ah": 4, "setup": 4, "fix": 4, "while": [0, 4], "float": [4, 10, 12], "pack": [6, 7], "wh": 4, "topolog": 4, "battery_setup_2": 4, "instead": 4, "therebi": 4, "pack_max_ah": 4, "watt": 4, "amp": 4, "cell_amp_hr": 4, "cell_voltag": 4, "propag": [2, 4, 10, 12], "forward": 4, "step": [2, 4, 11, 13], "It": [4, 7, 10, 11, 12, 13], "amper": 4, "np": 4, "cycl": 4, "est_calendar_ag": 4, "constant": 4, "calendar": 4, "sole": 4, "depend": 4, "later": 4, "est_cyc_ag": 4, "hess": 4, "et": 4, "al": 4, "its": 4, "cvx": 4, "cvxpy": 4, "get_ocv": 4, "map": 4, "store": 4, "interpol": 4, "priori": 4, "s": [0, 4], "possibl": 4, "get_aging_valu": 4, "ha": [4, 7], "experienc": 4, "so": [4, 7], "far": 4, "get_power_profil": 4, "profil": 4, "certain": [0, 4, 10, 12], "get_properti": 4, "get_roundtrip_effici": 4, "get_total_ag": 4, "get_true_pow": 4, "save_sim_data": 4, "save_prefix": 4, "relev": [4, 7, 10, 12], "call": [4, 11], "upon": 4, "conclus": 4, "save_st": 4, "state_eqn": 4, "append": 4, "discret": 4, "equat": 4, "here": 4, "g": [4, 10, 12], "l": 4, "plett": 4, "manag": 4, "volum": 4, "i": [0, 4], "artech": 4, "hous": 4, "2015": 4, "vol": 4, "track": 4, "b": 4, "post": [2, 4, 6], "analys": 4, "histori": 4, "thermal_dynam": 4, "futur": [0, 4], "track_soc": 4, "update_soc": 4, "update_capac": 4, "anticip": [1, 4], "update_max_curr": 4, "verbos": 4, "update_param": 4, "update_voltag": 4, "method": [4, 7], "batteryag": 4, "enact": 4, "datetim": 4, "num_step": 4, "re": 4, "15": [4, 7], "linimncoo2": 4, "nmc": [4, 7], "ad": 4, "link": [4, 7], "sciencedirect": 4, "com": 4, "scienc": 4, "articl": 4, "pii": 4, "s0378775314001876": 4, "beta_cap": 4, "fade": 4, "factor": 4, "alpha_cap": 4, "beta_r": 4, "growth": [0, 4], "alpha_r": 4, "assumpt": 4, "homogen": 4, "uniform": 4, "across": 4, "vicin": 4, "lfp_cal_ag": 4, "lfp_cyc_ag": 4, "nmc_cal_ag": 4, "nmc_cyc_ag": 4, "get_calendar_ag": 4, "tupl": 4, "due": 4, "get_cyc_ag": 4, "THe": 4, "batt": [4, 7], "both": 4, "adopt": 4, "schmalsteig": 4, "update_resist": 4, "structur": [4, 11, 13], "compos": 4, "individu": 4, "connect": [4, 12], "achiev": 4, "exampl": [4, 11, 13], "usag": 4, "battery_config_path": 4, "r": 4, "f": [4, 7], "battery_config": 4, "params_list": 4, "kei": [0, 4], "params_": 4, "Then": [0, 4], "params_kei": 4, "actual": 4, "those": 4, "prior": 4, "loadtxt": 4, "path_prefix": 4, "constructor": 4, "buffer_batteri": 4, "r_pack": 4, "initi": [4, 7], "sum": 4, "aging_c": 4, "lost": 4, "after": [4, 12], "round": 4, "trip": 4, "effici": 4, "_eff": 4, "out": [4, 7, 10, 12], "last": 4, "load_pack_prop": 4, "balogun": [4, 7], "dx": 4, "doi": 4, "org": 4, "36227": 4, "techrxiv": 4, "23596725": 4, "v2": 4, "nominal_pack_cap": 4, "py": [4, 7, 12], "meth": 4, "thermal": [4, 7], "intern": 4, "surfac": [4, 7], "avail": [0, 4], "version": [4, 7], "defer": 4, "TO": 4, "BE": 4, "need": [0, 4, 7], "anymor": 4, "onli": [4, 12], "right": 4, "name": [4, 7, 13], "storag": [0, 4], "statu": 4, "idl": 4, "produc": 4, "reactiv": [4, 11, 13], "retain": 4, "inform": [4, 10, 12], "inject": [4, 7], "ingest": 4, "assign": 4, "get_current_load": 4, "kw": [0, 4], "is_ev_arriv": 4, "arriv": 4, "indic": 4, "is_charg": 4, "unit": [0, 4], "set_current_load": 4, "update_load": 4, "net_grid_load": 4, "ev_load": 4, "mode": [4, 7, 12], "vehicl": [0, 4, 5, 7], "update_load_oneshot": 4, "offlin": [2, 4, 7, 12], "update_statu": 4, "bess": 4, "compute_control": 4, "price_vector": 4, "action": [4, 10, 12], "comput": [4, 12], "pass": 4, "tou": [4, 7], "control_act": 4, "signal": 4, "arbitrag": 4, "get_battery_constraint": 4, "satisfi": [4, 10, 12], "storage_constraint": 4, "initialize_forecast_data": 4, "forecast": [4, 7], "load_battery_ocv": 4, "learn": 4, "reset_load": 4, "full": [4, 7], "96": 4, "feedback": [2, 4, 7, 12], "price": [6, 7], "sampl": [4, 7], "detail": [4, 7, 11], "pge_bev2_": 4, "california": 4, "own": 4, "numpi": 4, "arrai": [4, 10, 12], "year": [4, 7], "priceload": 4, "evs": 4, "profit": 4, "loader": 4, "first": 4, "your": [4, 7], "repositori": [4, 5, 7], "downscal": [4, 7], "input_r": 4, "output_r": 4, "finer": 4, "resolut": [4, 7], "similar": [4, 12], "typic": 4, "onc": [2, 4, 7, 11, 13], "get_pric": 4, "start_idx": 4, "assum": 4, "do": [4, 10, 12], "index": [4, 5, 7], "cardin": 4, "jan": 4, "decemb": [4, 7], "ndarrai": [10, 12], "set_month_data": 4, "solv": 4, "objective_typ": 4, "power_demand": 4, "time_r": 4, "solver": [4, 5], "gurobi": 4, "degrad": 4, "limit": [4, 7], "convex": 4, "mix": 4, "program": [4, 12], "note": [4, 7], "instal": [0, 4, 7], "separ": 4, "pc": 4, "success": [0, 4], "counter": 4, "identifi": 4, "invok": 4, "eco": 4, "mosek": 4, "add_demand_charg": 4, "aggregate_constraint": 4, "aggreg": 4, "build_battery_cost": 4, "build_emissions_cost": 4, "emiss": 4, "build_transformer_cost": 4, "get_constraint": 4, "chargingsim": 4, "num_charging_sit": 4, "6": 4, "num_ev": 4, "1600": 4, "custom_ev_data": 4, "custom_ev_data_path": 4, "custom_solar_data": 4, "custom_solar_data_path": 4, "organ": [4, 7], "other": 4, "sequenti": 4, "manner": 4, "secondari": [4, 7, 11, 13], "If": 4, "site": 4, "help": [0, 4, 7, 11, 13], "access": [4, 7], "proper": 4, "os": 4, "minut": [4, 7], "create_battery_object": 4, "idx": 4, "node_prop": [], "identif": [4, 6, 7], "l2": [4, 13], "dcfc": 4, "create_charging_st": 4, "power_nod": 4, "buse": 4, "create_charging_stations_oneshot": 4, "create_solar_object": 4, "loc": 4, "get_act": 4, "get_charger_obj_by_loc": 4, "get_charging_sit": 4, "initialize_aging_sim": 4, "initialize_control": 4, "initialize_price_load": 4, "memori": 4, "initialize_solar_modul": [], "load_battery_param": 4, "directli": [4, 11, 13], "sim": [6, 7, 9], "unless": 4, "load_config": 4, "walk": 4, "load_results_summari": 4, "save_path_prefix": 4, "multistep": 4, "much": [4, 7], "faster": 4, "horizon": 4, "perfect": 4, "foresight": 4, "daili": 4, "reset": 4, "power_nodes_list": 4, "accordingli": 4, "specif": [1, 4], "stepsiz": 4, "update_scenario": 4, "update_step": 4, "move": 4, "without": [0, 2, 4, 12], "studi": [0, 2, 4], "effect": [2, 4, 7, 12], "character": [2, 4], "what": [2, 4], "occur": [2, 4], "situ": [2, 4], "app": [4, 6], "global": [4, 7, 13], "horizont": [4, 7], "irradi": [4, 7], "ghi": [4, 7], "dataset": [4, 7], "namepl": 4, "p_": 4, "eta": 4, "area": [4, 7], "panel": 4, "decis": 4, "flow": [4, 5], "get_pow": 4, "desired_shap": 4, "get_solar_output": 4, "modify_r": 4, "new_r": 4, "update_histori": 4, "purpos": 4, "schedul": 4, "pge": 4, "doc": 4, "found": 4, "add_power_profile_to_object": 4, "battery_power_profil": 4, "build_cost_pge_bev2": 4, "energy_prices_t": 4, "penalize_max_pow": 4, "max_power_pen": 4, "1000": 4, "heurist": 4, "averag": 4, "conserv": 4, "gamma": 4, "build_electricity_cost": 4, "demand_charg": 4, "home": [4, 7, 11, 13], "mayb": 4, "opt": 4, "build_object": 4, "electricity_cost": 4, "battery_degradation_cost": 4, "we": 4, "minim": [4, 7], "load_pric": 4, "time_interv": 4, "gridlab": [5, 7, 10, 11, 12, 13], "d": [5, 7, 10, 11, 12, 13], "load_base_glm": [11, 13], "base_file_dir": [11, 13], "base_glm_fil": [11, 13], "glm": [7, 11, 13], "replace_load_w_met": [11, 13], "glm_dict": [11, 13], "match_str": [11, 13], "rep_str": [11, 13], "obj_typ": [11, 13], "replac": [11, 13], "meter": [11, 13], "replace_load_w_meter_old": [11, 13], "write_base_glm": [11, 13], "globals_list": [11, 13], "include_list": [11, 13], "out_dir": [11, 13], "file_nam": [11, 13], "sync_list": [11, 13], "write_class_dict": [11, 13], "gld_dict": [11, 13], "class_nam": [11, 13], "gld": [11, 13], "write_clock_dict": [11, 13], "clock": [6, 11, 13], "write_filter_dict": [11, 13], "filter": [7, 11, 13], "write_mod_dict": [11, 13], "mod_nam": [11, 13], "write_obj_dict": [11, 13], "dict_kei": [11, 13], "python": [5, 7], "multi": 5, "timescal": [4, 5], "awar": [5, 7], "co": [0, 4, 5, 7, 10, 12, 13], "platform": [0, 5, 6], "infrastructur": [0, 5], "develop": [5, 7, 10, 12], "integr": [0, 5, 7], "interfac": [5, 11, 13], "phase": [5, 10, 12], "unbalanc": 5, "captur": [5, 7], "impact": [5, 7], "fast": [5, 13], "preprint": [], "come": [0, 5], "modul": [2, 5, 6, 7], "page": 5, "analysi": 6, "cost_analysi": [6, 7], "load_post_opt_cost": [6, 7], "plot_result": [6, 7], "batt_sys_identif": 3, "battery_identif": 6, "charging_sim": 4, "batteryagingsim": [4, 7], "batterypack": [4, 7], "batterytest": [], "capacitor": 6, "chargingst": [4, 7], "electricitypric": [4, 7], "orchestr": [6, 7], "util": [6, 7], "content": [6, 7], "feeder": [4, 9, 10, 12], "feeder_popul": [9, 10, 12], "glm_mod_funct": [9, 10, 12], "subpackag": 6, "submodul": [6, 9], "test_cas": [6, 9], "base_cas": [6, 7, 9], "event_handl": [6, 9], "gblvar": [6, 9], "glmptime": [6, 9], "master_sim": [6, 7, 9], "voltdump2": [6, 9], "event_handlers_oneshot": [6, 9], "parse_voltag": [6, 9], "feeder_population_old": [], "introduct": [11, 13], "perform": [0, 11, 13], "ieee123": [11, 13], "script": [7, 11, 13], "read": [7, 11, 13], "initial_glm_nam": [11, 13], "_popul": [11, 13], "_secondari": [11, 13], "These": [11, 13], "test_case_dir": [11, 13], "txt": [7, 11, 13], "descript": [11, 13], "our": [11, 13], "graphic": [11, 13], "gui": [11, 13], "environ": [7, 10, 11, 12, 13], "real_pow": [11, 13], "real": [10, 11, 12, 13], "residenti": [7, 11, 13], "timeseri": [11, 13], "reactive_pow": [11, 13], "dcfc_bu": 13, "dc": 13, "l2charging_bu": 13, "electrif": 0, "transport": 0, "decarbon": 0, "sector": 0, "inevit": 0, "increas": 0, "expans": 0, "leverag": [0, 7], "technolog": 0, "clever": 0, "wai": 0, "coordin": 0, "todai": 0, "fundament": 0, "suppli": 0, "equip": 0, "rapid": 0, "deploy": 0, "difficult": 0, "present": 0, "serv": 0, "testb": 0, "mind": 0, "sai": 0, "e": [0, 10, 12], "chargepoint": 0, "electrifi": 0, "america": 0, "want": [0, 12], "deploi": 0, "san": [0, 7], "francisco": [0, 7], "ca": 0, "contact": 0, "pg": 0, "process": [0, 10, 12], "sometim": 0, "eventu": 0, "might": 0, "support": 0, "let": 0, "even": 0, "get": [0, 10, 12], "chain": 0, "issu": 0, "abl": 0, "avoid": [0, 7], "upgrad": 0, "imagin": 0, "guarante": 0, "exce": 0, "threshold": 0, "approv": 0, "In": [0, 4], "fact": 0, "agreement": 0, "servic": [0, 4], "peak": 0, "shave": 0, "regul": 0, "realiti": 0, "emmanuel": 7, "ebalogun": 7, "stanford": 7, "edu": 7, "hipa": 7, "master": 7, "branch": [7, 11], "recommend": 7, "aw": 7, "ec2": 7, "slac": 7, "gismo": 7, "ami": 7, "beauharnoi": 7, "x": 7, "below": 7, "_": 7, "environment": 7, "condit": 7, "subsystem": 7, "uncontrol": 7, "proprietari": 7, "pecan": 7, "street": 7, "exmapl": 7, "prototyp": 7, "sy": 7, "experiment": 7, "2nd": 7, "order": 7, "rc": 7, "One": 7, "custom": [4, 7, 10, 12], "upload": 7, "shown": 7, "addit": 7, "ocv_corr": 7, "abov": 7, "battery_data": 7, "encompass": 7, "legaci": 7, "elec": 7, "365": 7, "format": [7, 10, 12], "should": 7, "coarser": 7, "librari": 7, "pnnl": 7, "taxonomi": 7, "primari": [4, 7], "vari": 7, "necessari": [4, 7, 10, 12], "repo": 7, "nation": 7, "radiat": 7, "databas": 7, "nsrdb": 7, "bai": 7, "renew": 7, "laboratori": 7, "hourli": 7, "interv": 7, "oversampl": 7, "4": 7, "repres": 7, "w": 7, "m": 7, "shortwav": 7, "receiv": 7, "ground": 7, "timestep": [4, 7], "rlsf": 7, "plu": 7, "recurs": 7, "squar": 7, "onlin": 7, "conda": 7, "env": 7, "yml": 7, "OR": 7, "packag": 7, "manual": 7, "gridlabd": [7, 10, 11, 12, 13], "For": [4, 7, 10, 12], "navig": 7, "prepar": 7, "confirm": 7, "successfulli": 7, "ieee123_secondari": 7, "ieee123_popul": 7, "you": 7, "prep": 7, "python3": 7, "ev50_cosimul": 7, "section": 7, "quick": [], "quickstart": [], "click": [], "expand": [], "collaps": 14, "total_load_color": 1, "blue": 1, "net_load_color": 1, "orang": 1, "node_nam": [1, 4, 10, 11, 12, 13], "color": 1, "user_input_path": 1, "40": 3, "error_stat": 3, "stall": 4, "port": 4, "load_charging_data": 4, "uniqu": 4, "chargingstationcentr": 4, "central": [4, 11, 13], "mpccentral": 4, "central_der_dict": 4, "rhc": 4, "create_charging_stations_centr": 4, "charging_nodes_list": 4, "share": 4, "provid": 4, "fleet": 4, "offset": 4, "consumpt": 4, "especi": 4, "block": 4, "soh": 4, "reced": 4, "account": 4, "easili": 4, "uncertainti": 4, "step_centr": 4, "reason": 4, "becaus": 4, "like": [4, 10, 12], "tariff": 4, "zone": 4, "territori": 4, "emissions_cost": 4, "public": [5, 7], "enough": [], "cpu": [], "rerun": [], "load_input_config": [], "make_scenario": [], "No": [], "preload": [], "run_scenario_singl": [], "run_scenarios_parallel": [], "multicor": [], "processor": [], "core": [], "ram": [], "lead": [], "freez": [], "run_scenarios_sequenti": [], "associ": 13, "statement": 13, "written": 13, "sync": 13, "eas": 4, "tempor": 4, "understand": 4, "deriv": 4, "pf_dt": 4, "second": 4, "trans_dt": 4, "battery_dt": 4, "dt": 4, "children": [4, 10, 12], "colloc": [4, 11], "singl": 4, "thu": [4, 10, 12], "when": [4, 12], "know": 4, "child": 4, "add_child": 4, "oiltypetransform": 4, "global_clock": 4, "temperature_data": 4, "plot_stat": 4, "previou": 4, "increment": 4, "nonlinear": 4, "swift": 4, "2001": 4, "xxxx": 11, "synthet": 11, "experi": 6, "feeder_population_centr": [9, 12], "feeder_population_colloc": [9, 12], "get_repository_nam": 4, "modif": [], "hors": [10, 12], "interact": [10, 12], "built": [10, 12], "import": [10, 12], "criteria": [10, 12], "criterion": [10, 12], "find_subset_tran": 12, "get_trans_pow": [10, 12], "trans_power_str": [10, 12], "kva": 12, "pmag": [10, 12], "magnitud": [10, 12], "deg": [10, 12], "angl": [10, 12], "appar": [10, 12], "axi": [10, 12], "complex": [10, 12], "plane": [10, 12], "get_voltag": [10, 12], "variou": [10, 12], "guid": [10, 12], "on_init": [10, 12], "t": [10, 12], "veri": [10, 12], "arbitrari": [10, 12], "placehold": [10, 12], "on_precommit": [10, 12], "on_term": [10, 12], "taken": [10, 12], "end": [10, 12], "whole": [10, 12], "comment": [10, 12], "line": [10, 12], "save_transformer_st": 12, "vs": 11}, "objects": {"": [[1, 0, 0, "-", "analysis"], [2, 0, 0, "-", "app"], [3, 0, 0, "-", "batt_sys_identification"], [4, 0, 0, "-", "charging_sim"], [9, 0, 0, "-", "test_cases"]], "analysis": [[1, 0, 0, "-", "cost_analysis"], [1, 0, 0, "-", "load_post_opt_costs"], [1, 0, 0, "-", "plot_results"]], "analysis.cost_analysis": [[1, 1, 1, "", "CostEstimator"]], "analysis.cost_analysis.CostEstimator": [[1, 2, 1, "", "calculate_battery_cost"], [1, 2, 1, "", "calculate_electricity_cost_PGEBEV2s"], [1, 2, 1, "", "calculate_solar_cost"], [1, 2, 1, "", "calculate_trans_loss_of_life"], [1, 2, 1, "", "plot_loads"], [1, 2, 1, "", "plot_power"], [1, 2, 1, "", "plot_soc"], [1, 2, 1, "", "solar_cost"], [1, 2, 1, "", "transformer_cost"]], "analysis.load_post_opt_costs": [[1, 3, 1, "", "collate_results"], [1, 3, 1, "", "plot_stacked_bar"], [1, 3, 1, "", "plot_tables"], [1, 3, 1, "", "run"], [1, 3, 1, "", "run_results"]], "analysis.plot_results": [[1, 3, 1, "", "run"]], "app": [[2, 3, 1, "", "change_run_date"], [2, 3, 1, "", "create_results_folder"], [2, 3, 1, "", "create_temp_configs"], [2, 3, 1, "", "load_default_input"], [2, 3, 1, "", "make_month_str"], [2, 3, 1, "", "simulate"], [2, 3, 1, "", "validate_options"]], "batt_sys_identification": [[3, 0, 0, "-", "battery_identification"]], "batt_sys_identification.battery_identification": [[3, 1, 1, "", "BatteryParams"]], "batt_sys_identification.battery_identification.BatteryParams": [[3, 2, 1, "", "ga"], [3, 2, 1, "", "get_Ro"], [3, 2, 1, "", "get_corrected_voltages"], [3, 2, 1, "", "get_uncorrected_voltages"], [3, 2, 1, "", "plot_Ro"], [3, 2, 1, "", "plot_correction_scheme_comparison"], [3, 2, 1, "", "run_ocv_correction"], [3, 2, 1, "", "run_pre_checks"], [3, 2, 1, "", "run_sys_identification"], [3, 2, 1, "", "simulate_response"]], "charging_sim": [[4, 0, 0, "-", "battery"], [4, 0, 0, "-", "batteryAgingSim"], [4, 0, 0, "-", "batterypack"], [4, 0, 0, "-", "capacitor"], [4, 0, 0, "-", "chargingStation"], [4, 0, 0, "-", "clock"], [4, 0, 0, "-", "controller"], [4, 0, 0, "-", "electricityPrices"], [4, 0, 0, "-", "node"], [4, 0, 0, "-", "optimization"], [4, 0, 0, "-", "orchestrator"], [4, 0, 0, "-", "simulate"], [4, 0, 0, "-", "solar"], [4, 0, 0, "-", "transformer"], [4, 0, 0, "-", "utils"]], "charging_sim.battery": [[4, 1, 1, "", "Battery"], [4, 3, 1, "", "test"]], "charging_sim.battery.Battery": [[4, 2, 1, "", "battery_setup"], [4, 2, 1, "", "battery_setup_2"], [4, 2, 1, "", "dynamics"], [4, 2, 1, "", "est_calendar_aging"], [4, 2, 1, "", "est_cyc_aging"], [4, 2, 1, "", "get_OCV"], [4, 2, 1, "", "get_Ro"], [4, 2, 1, "", "get_aging_value"], [4, 2, 1, "", "get_power_profile"], [4, 2, 1, "", "get_properties"], [4, 2, 1, "", "get_roundtrip_efficiency"], [4, 2, 1, "", "get_total_aging"], [4, 2, 1, "", "get_true_power"], [4, 2, 1, "", "save_sim_data"], [4, 2, 1, "", "save_states"], [4, 2, 1, "", "state_eqn"], [4, 2, 1, "", "thermal_dynamics"], [4, 2, 1, "", "track_SOC"], [4, 2, 1, "", "update_SOC"], [4, 2, 1, "", "update_capacity"], [4, 2, 1, "", "update_max_current"], [4, 2, 1, "", "update_params"], [4, 2, 1, "", "update_voltage"], [4, 2, 1, "", "visualize"]], "charging_sim.batteryAgingSim": [[4, 1, 1, "", "BatteryAging"]], "charging_sim.batteryAgingSim.BatteryAging": [[4, 2, 1, "", "LFP_cal_aging"], [4, 2, 1, "", "LFP_cyc_aging"], [4, 2, 1, "", "NMC_cal_aging"], [4, 2, 1, "", "NMC_cyc_aging"], [4, 2, 1, "", "get_aging_value"], [4, 2, 1, "", "get_calendar_aging"], [4, 2, 1, "", "get_cyc_aging"], [4, 2, 1, "", "get_total_aging"], [4, 2, 1, "", "run"], [4, 2, 1, "", "update_capacity"], [4, 2, 1, "", "update_resistance"]], "charging_sim.batterypack": [[4, 1, 1, "", "Battery"]], "charging_sim.batterypack.Battery": [[4, 4, 1, "", "R_pack"], [4, 2, 1, "", "battery_setup"], [4, 2, 1, "", "battery_setup_2"], [4, 4, 1, "", "battery_type"], [4, 4, 1, "", "config"], [4, 4, 1, "", "controller"], [4, 2, 1, "", "dynamics"], [4, 2, 1, "", "est_calendar_aging"], [4, 2, 1, "", "est_cyc_aging"], [4, 2, 1, "", "get_OCV"], [4, 2, 1, "", "get_aging_value"], [4, 2, 1, "", "get_power_profile"], [4, 2, 1, "", "get_roundtrip_efficiency"], [4, 2, 1, "", "get_total_aging"], [4, 2, 1, "", "get_true_power"], [4, 2, 1, "", "load_pack_props"], [4, 4, 1, "", "nominal_pack_cap"], [4, 2, 1, "", "save_sim_data"], [4, 2, 1, "", "state_eqn"], [4, 2, 1, "", "thermal_dynamics"], [4, 2, 1, "", "track_SOC"], [4, 2, 1, "", "update_capacity"], [4, 2, 1, "", "update_max_current"], [4, 2, 1, "", "update_voltage"], [4, 2, 1, "", "visualize"]], "charging_sim.capacitor": [[4, 1, 1, "", "Capacitor"]], "charging_sim.chargingStation": [[4, 1, 1, "", "ChargingStation"], [4, 1, 1, "", "ChargingStationCentralized"]], "charging_sim.chargingStation.ChargingStation": [[4, 2, 1, "", "get_current_load"], [4, 2, 1, "", "is_EV_arrived"], [4, 2, 1, "", "is_charging"], [4, 2, 1, "", "load_charging_data"], [4, 2, 1, "", "save_sim_data"], [4, 2, 1, "", "set_current_load"], [4, 2, 1, "", "update_load"], [4, 2, 1, "", "update_load_oneshot"], [4, 2, 1, "", "update_status"], [4, 2, 1, "", "visualize"]], "charging_sim.chargingStation.ChargingStationCentralized": [[4, 2, 1, "", "get_current_load"], [4, 2, 1, "", "is_EV_arrived"], [4, 2, 1, "", "is_charging"], [4, 2, 1, "", "load_charging_data"], [4, 2, 1, "", "save_sim_data"], [4, 2, 1, "", "set_current_load"], [4, 2, 1, "", "update_load"], [4, 2, 1, "", "update_load_oneshot"], [4, 2, 1, "", "update_status"], [4, 2, 1, "", "visualize"]], "charging_sim.clock": [[4, 1, 1, "", "Clock"]], "charging_sim.clock.Clock": [[4, 2, 1, "", "reset"], [4, 2, 1, "", "update"]], "charging_sim.controller": [[4, 1, 1, "", "MPC"], [4, 1, 1, "", "MPCCentralized"], [4, 1, 1, "", "Oneshot"]], "charging_sim.controller.MPC": [[4, 2, 1, "", "compute_control"], [4, 2, 1, "", "get_battery_constraints"], [4, 2, 1, "", "initialize_forecast_data"], [4, 2, 1, "", "load_battery_ocv"], [4, 2, 1, "", "reset_load"]], "charging_sim.controller.MPCCentralized": [[4, 2, 1, "", "compute_control"], [4, 2, 1, "", "get_battery_constraints"], [4, 2, 1, "", "initialize_forecast_data"], [4, 2, 1, "", "load_battery_ocv"], [4, 2, 1, "", "reset_load"]], "charging_sim.controller.Oneshot": [[4, 2, 1, "", "compute_control"], [4, 2, 1, "", "get_battery_constraints"], [4, 2, 1, "", "load_battery_ocv"], [4, 2, 1, "", "reset_load"]], "charging_sim.electricityPrices": [[4, 1, 1, "", "PriceLoader"]], "charging_sim.electricityPrices.PriceLoader": [[4, 2, 1, "", "downscale"], [4, 2, 1, "", "get_prices"], [4, 2, 1, "", "set_month_data"]], "charging_sim.node": [[4, 1, 1, "", "Node"]], "charging_sim.node.Node": [[4, 2, 1, "", "add_child"], [4, 2, 1, "", "get_current_load"], [4, 2, 1, "", "save_sim_data"], [4, 2, 1, "", "set_current_load"], [4, 2, 1, "", "update_load"]], "charging_sim.optimization": [[4, 1, 1, "", "Optimization"]], "charging_sim.optimization.Optimization": [[4, 2, 1, "", "add_demand_charge"], [4, 2, 1, "", "aggregate_constraints"], [4, 2, 1, "", "build_battery_cost"], [4, 2, 1, "", "build_emissions_cost"], [4, 2, 1, "", "build_transformer_cost"], [4, 2, 1, "", "get_battery_constraint"], [4, 2, 1, "", "get_constraints"], [4, 2, 1, "", "run"]], "charging_sim.orchestrator": [[4, 1, 1, "", "ChargingSim"]], "charging_sim.orchestrator.ChargingSim": [[4, 2, 1, "", "create_battery_object"], [4, 2, 1, "", "create_charging_stations"], [4, 2, 1, "", "create_charging_stations_centralized"], [4, 2, 1, "", "create_charging_stations_oneshot"], [4, 2, 1, "", "create_solar_object"], [4, 2, 1, "", "get_action"], [4, 2, 1, "", "get_charger_obj_by_loc"], [4, 2, 1, "", "get_charging_sites"], [4, 2, 1, "", "initialize_aging_sim"], [4, 2, 1, "", "initialize_controllers"], [4, 2, 1, "", "initialize_price_loader"], [4, 2, 1, "", "load_battery_params"], [4, 2, 1, "", "load_config"], [4, 2, 1, "", "load_results_summary"], [4, 2, 1, "", "multistep"], [4, 2, 1, "", "reset_loads"], [4, 2, 1, "", "setup"], [4, 2, 1, "", "step"], [4, 2, 1, "", "step_centralized"], [4, 2, 1, "", "update_scenario"], [4, 2, 1, "", "update_steps"]], "charging_sim.simulate": [[4, 3, 1, "", "change_run_date"], [4, 3, 1, "", "create_results_folder"], [4, 3, 1, "", "create_temp_configs"], [4, 3, 1, "", "get_repository_name"], [4, 3, 1, "", "load_default_input"], [4, 3, 1, "", "make_month_str"], [4, 3, 1, "", "simulate"], [4, 3, 1, "", "validate_options"]], "charging_sim.solar": [[4, 1, 1, "", "Solar"], [4, 3, 1, "", "main"]], "charging_sim.solar.Solar": [[4, 2, 1, "", "downscale"], [4, 2, 1, "", "get_constraints"], [4, 2, 1, "", "get_power"], [4, 2, 1, "", "get_solar_output"], [4, 2, 1, "", "modify_res"], [4, 2, 1, "", "update_history"]], "charging_sim.transformer": [[4, 1, 1, "", "OilTypeTransformer"]], "charging_sim.transformer.OilTypeTransformer": [[4, 2, 1, "", "plot_states"], [4, 2, 1, "", "thermal_dynamics"]], "charging_sim.utils": [[4, 3, 1, "", "PGE_BEV2_S"], [4, 3, 1, "", "add_power_profile_to_object"], [4, 3, 1, "", "build_cost_PGE_BEV2S"], [4, 3, 1, "", "build_electricity_cost"], [4, 3, 1, "", "build_objective"], [4, 3, 1, "", "load_prices"]], "test_cases": [[10, 0, 0, "-", "base_case"], [12, 0, 0, "-", "battery"]], "test_cases.base_case": [[10, 0, 0, "-", "event_handlers"], [11, 0, 0, "-", "feeder_population"], [10, 0, 0, "-", "gblvar"]], "test_cases.base_case.event_handlers": [[10, 3, 1, "", "find"], [10, 3, 1, "", "get_trans_power"], [10, 3, 1, "", "get_voltage"], [10, 3, 1, "", "on_init"], [10, 3, 1, "", "on_precommit"], [10, 3, 1, "", "on_term"]], "test_cases.base_case.feeder_population": [[11, 0, 0, "-", "feeder_population"], [11, 0, 0, "-", "glm_mod_functions"]], "test_cases.base_case.feeder_population.feeder_population": [[11, 3, 1, "", "main"]], "test_cases.base_case.feeder_population.glm_mod_functions": [[11, 3, 1, "", "load_base_glm"], [11, 3, 1, "", "replace_load_w_meter"], [11, 3, 1, "", "replace_load_w_meter_old"], [11, 3, 1, "", "write_base_glm"], [11, 3, 1, "", "write_class_dict"], [11, 3, 1, "", "write_clock_dict"], [11, 3, 1, "", "write_filter_dict"], [11, 3, 1, "", "write_mod_dict"], [11, 3, 1, "", "write_obj_dict"]], "test_cases.battery": [[12, 0, 0, "-", "event_handlers"], [12, 0, 0, "-", "event_handlers_oneshot"], [13, 0, 0, "-", "feeder_population"]], "test_cases.battery.event_handlers": [[12, 3, 1, "", "find"], [12, 3, 1, "", "find_subset_trans"], [12, 3, 1, "", "get_trans_power"], [12, 3, 1, "", "get_voltage"], [12, 3, 1, "", "on_init"], [12, 3, 1, "", "on_precommit"], [12, 3, 1, "", "on_term"], [12, 3, 1, "", "save_transformer_states"]], "test_cases.battery.event_handlers_oneshot": [[12, 3, 1, "", "find"], [12, 3, 1, "", "get_trans_power"], [12, 3, 1, "", "get_voltage"], [12, 3, 1, "", "on_init"], [12, 3, 1, "", "on_precommit"], [12, 3, 1, "", "on_term"]], "test_cases.battery.feeder_population": [[13, 0, 0, "-", "feeder_population_centralized"], [13, 0, 0, "-", "feeder_population_collocated"], [13, 0, 0, "-", "glm_mod_functions"]], "test_cases.battery.feeder_population.feeder_population_centralized": [[13, 3, 1, "", "main"]], "test_cases.battery.feeder_population.feeder_population_collocated": [[13, 3, 1, "", "main"]], "test_cases.battery.feeder_population.glm_mod_functions": [[13, 3, 1, "", "load_base_glm"], [13, 3, 1, "", "replace_load_w_meter"], [13, 3, 1, "", "replace_load_w_meter_old"], [13, 3, 1, "", "write_base_glm"], [13, 3, 1, "", "write_class_dict"], [13, 3, 1, "", "write_clock_dict"], [13, 3, 1, "", "write_filter_dict"], [13, 3, 1, "", "write_mod_dict"], [13, 3, 1, "", "write_obj_dict"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:function", "4": "py:attribute"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "function", "Python function"], "4": ["py", "attribute", "Python attribute"]}, "titleterms": {"post": [1, 7], "simul": [1, 4, 7], "analysi": [1, 7], "cost_analysi": 1, "modul": [1, 3, 4, 8, 9, 10, 11, 12, 13], "load_post_opt_cost": 1, "plot_result": 1, "app": 2, "batteri": [3, 4, 12, 13], "system": 3, "identif": 3, "batt_sys_identif": 7, "battery_identif": 3, "charg": 4, "charging_sim": 7, "batteryagingsim": [], "batterypack": [], "batterytest": [], "capacitor": 4, "chargingst": [], "control": 4, "electricitypric": [], "optim": 4, "orchestr": 4, "solar": 4, "util": [0, 4], "content": [1, 3, 4, 9, 10, 11, 12, 13], "feeder": [7, 11, 13], "popul": [11, 13], "feeder_popul": [7, 11, 13], "glm_mod_funct": [11, 13], "welcom": 5, "ev": [5, 7, 14], "ecosim": [5, 7, 14], "1": 5, "0": 5, "document": 5, "what": [5, 14], "link": 5, "indic": 5, "tabl": 5, "packag": 6, "setup": 8, "test": [9, 10, 12, 13], "case": [9, 10, 11, 12, 13], "subpackag": [9, 10, 12], "base": [10, 11], "submodul": [1, 3, 4, 10, 11, 12, 13], "test_cas": [7, 10, 11, 12, 13], "base_cas": [10, 11], "event_handl": [10, 12], "gblvar": [10, 12], "glmptime": [10, 12], "master_sim": [10, 12], "sim": [4, 10], "voltdump2": [10, 12], "event_handlers_oneshot": 12, "parse_voltag": 12, "scenario": 12, "feeder_population_old": [], "motiv": 0, "background": 0, "bridg": 0, "disconnect": 0, "between": 0, "evs": 0, "provid": 0, "platform": [2, 7, 14], "author": 7, "requir": 7, "folder": 7, "descript": 7, "ambient_data": 7, "base_load_data": 7, "dlmodel": 7, "elec_r": 7, "solar_data": 7, "how": [7, 14], "run": [2, 7, 14], "tutori": 14, "quick": 14, "introduct": 14, "quickstart": 14, "experi": 3, "clock": 4, "node": 4, "transform": 4, "feeder_population_centr": 13, "feeder_population_colloc": 13, "ag": 4, "pack": 4, "station": 4, "electr": 4, "price": 4, "central": [], "colloc": [], "gridlab": [], "d": [], "model": [], "modif": [], "function": []}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.todo": 2, "sphinx": 56}}) \ No newline at end of file diff --git a/docs/build/html/setup.html b/docs/build/html/setup.html index fd3f25e8a..2ed1f946a 100644 --- a/docs/build/html/setup.html +++ b/docs/build/html/setup.html @@ -48,6 +48,10 @@ +

Modules

+ diff --git a/docs/build/html/test_cases.base_case.feeder_population.html b/docs/build/html/test_cases.base_case.feeder_population.html new file mode 100644 index 000000000..4fc4b7734 --- /dev/null +++ b/docs/build/html/test_cases.base_case.feeder_population.html @@ -0,0 +1,362 @@ + + + + + + + Base case feeder population — EV-EcoSim 1.0.0 documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Base case feeder population

+
+

Module contents

+

Introduction

+

This is the feeder population module for the base test case. This file performs the pre-simulation step for +running EV-Ecosim.

+

It takes in a base Gridlab-D Model (GLM) file (for example, IEEE123.glm), and modifies that file by including +secondary distribution, home loads, and EV Charging station and transformers.

+

Once this script is done running, it reads and writes new GLM as <initial_glm_name>_populated.glm and +<initial_glm_name>_secondary.glm, and saves them within the test case folder. These saved files are used to run the +simulation. These files are saved in the ‘test_case_dir’ field specified in config.txt.

+

Input file description

+

Config config.txt: configuration file describing the pre-simulation parameters. +This can be modified directly or with the help of our Graphic User Interface (GUI). The return outputs of this module +are files that are read in to run the EV-Ecosim environment.

+

Output file description

+

real_power.csv - Real power; this is residential real load timeseries file per node_name/bus

+

reactive_power.csv - Reactive power; this is residential reactive load timeseries file per node_name/bus.

+

XXXX.glm - GridLabD model files. These are usually the synthetic feeders.

+
+
+

Submodules

+
+
+

test_cases.base_case.feeder_population.feeder_population module

+

Introduction

+

This is the feeder population module for the base test case. This file performs the pre-simulation step for +running EV-Ecosim.

+

It takes in a base Gridlab-D Model (GLM) file (for example, IEEE123.glm), and modifies that file by including +secondary distribution, home loads, and EV Charging station and transformers.

+

Details

+

Once this script is done running, it reads and writes new GLM as <initial_glm_name>_populated.glm and +<initial_glm_name>_secondary.glm, and saves them within the test case folder. These saved files are used to run the +simulation. These files are saved in the ‘test_case_dir’ field specified in config.txt.

+

Input file description

+

Config config.txt: configuration file describing the pre-simulation parameters. +This can be modified directly or with the help of our Graphic User Interface (GUI). The return outputs of this module +are files that are read in to run the EV-Ecosim environment.

+

Output file description

+

real_power.csv - Real power; this is residential real load timeseries file per node_name/bus

+

reactive_power.csv - Reactive power; this is residential reactive load timeseries file per node_name/bus.

+

XXXX.glm - GridLabD model files. These are usually the synthetic feeders.

+

Settings for collocated vs. centralized charging stations are included in this branch.

+
+
+test_cases.base_case.feeder_population.feeder_population.main()
+

This is the main function for the feeder population module. It reads in the config file, and then calls the +functions to modify the GLM file and write the new GLM file. It also saves the load data for the homes. The +function also saves the voltage objects and properties for the homes.

+
+
Returns:
+

None.

+
+
+
+ +
+
+

test_cases.base_case.feeder_population.glm_mod_functions module

+

Functions for modifying GridLAB-D power system simulation models

+
+
+test_cases.base_case.feeder_population.glm_mod_functions.load_base_glm(base_file_dir, base_glm_file)
+

Loads the glm as list and populates it into dict and returns the output

+
+
Parameters:
+
    +

  • base_file_dir –

    • +

  • base_glm_file –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.replace_load_w_meter(glm_dict, match_str, rep_str, obj_type)
+

Replace all instances of load in glm_dict with meter.

+
+
Parameters:
+
    +

  • glm_dict –

    • +

  • match_str –

    • +

  • rep_str –

    • +

  • obj_type –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.replace_load_w_meter_old(glm_dict, match_str, rep_str, obj_type)
+

Replace all instances of load in glm_dict with meter.

+
+
Parameters:
+
    +

  • glm_dict –

    • +

  • match_str –

    • +

  • rep_str –

    • +

  • obj_type –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_base_glm(glm_dict, obj_type, globals_list, include_list, out_dir, file_name, sync_list)
+

Writes the glm file from the dict structure.

+
+
Parameters:
+
    +

  • glm_dict –

    • +

  • obj_type –

    • +

  • globals_list –

    • +

  • include_list –

    • +

  • out_dir –

    • +

  • file_name –

    • +

  • sync_list –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_class_dict(file, gld_dict, class_name)
+

Write dictionary corresponding to GLD class to .glm file.

+
+
Parameters:
+
    +

  • file –

    • +

  • gld_dict –

    • +

  • class_name –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_clock_dict(file, gld_dict)
+

Write dictionary corresponding to GLD clock to .glm file.

+
+
Parameters:
+
    +

  • file –

    • +

  • gld_dict –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_filter_dict(file, gld_dict, class_name)
+

Write dictionary corresponding to GLD filter to .glm file.

+
+
Parameters:
+
    +

  • file –

    • +

  • gld_dict –

    • +

  • class_name –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_mod_dict(file, gld_dict, mod_name)
+

Write dictionary corresponding to GLD module to .glm file.

+
+
Parameters:
+
    +

  • file –

    • +

  • gld_dict –

    • +

  • mod_name –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+test_cases.base_case.feeder_population.glm_mod_functions.write_obj_dict(file, gld_dict, dict_key, obj_type)
+

Write dictionary corresponding to GLD objects to .glm file.

+
+
Parameters:
+
    +

  • file –

    • +

  • gld_dict –

    • +

  • dict_key –

    • +

  • obj_type –

    • +
+
+
Returns:
+

+
+
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/docs/build/html/test_cases.base_case.html b/docs/build/html/test_cases.base_case.html index b6da89778..70f348e81 100644 --- a/docs/build/html/test_cases.base_case.html +++ b/docs/build/html/test_cases.base_case.html @@ -4,7 +4,7 @@ - Base Case Test Cases — EV-EcoSim 1.0.0 documentation + Base test case — EV-EcoSim 1.0.0 documentation