From 1d9d63b7a4f1c200c05a553a191b24cccbf2f229 Mon Sep 17 00:00:00 2001
From: LarrySnyder <LarrySnyder@users.noreply.github.com>
Date: Tue, 28 Jun 2022 22:39:16 -0400
Subject: [PATCH] Update CHANGELOG, rebuild docs

---
 CHANGELOG.md                            |   4 ++-
 docs/_build/doctrees/environment.pickle | Bin 203261 -> 210420 bytes
 docs/_build/doctrees/index.doctree      | Bin 35663 -> 35945 bytes
 docs/_build/html/_sources/index.rst.txt |   8 +++--
 docs/_build/html/genindex.html          |  40 +++++++++++++++++++-----
 docs/_build/html/index.html             |  10 +++---
 docs/_build/html/objects.inv            | Bin 5011 -> 5042 bytes
 docs/_build/html/searchindex.js         |   2 +-
 8 files changed, 48 insertions(+), 16 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ca4e9e3..e1bd025 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,8 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.9] -- 2022-06-28
+
 ### Fixed
-- Bug that prevented named instances from being loaded correctly
+- Bug that prevented named instances from being loaded correctly using ``load_instance()``
 
 ### Added
 - Methods to convert objects to and from dicts
diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle
index 6aa9b37a017ea98afa7aefe04144152180b3890b..28473eb0598231b562f472543ef4298af646be1b 100644
GIT binary patch
literal 210420
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
Peez_tReJA*-!<)Dhl|qe

literal 203261
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

diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree
index 4699af2263730b5fdcb075ecb90400b51db8f516..d06a808a3017855777944a1e5d646c337c5ca439 100644
GIT binary patch
delta 448
zcmX><jp^kKCe{Ylsc}6US=ZWg>}6zNs3|U}ne6MR&!v!<m!eRdnOmB(`Js~`BL|mb
zUW$%FX36CLneJ>;GT39MXiWZRCpOv8QG#*jWG_b}ygGQMv`%T9QaeQ>gEfM%>ditf
zQ<>O!GsLqVu};2NEjQW0g=O-2w=72f$yV-b7=<=JcMoP_6xnR;70bjZHu*xB^yV!-
zznB>1H?Q}1WnxqUiwFemXJOO^GXFB_O<wOWwfRN(WM)PKklf_y(YqKO!Gbw4^O+f)
z!5Y*PW-&5`f<^BninB9DfJON;MVJ`#!J>BATUi;4A)<wc7#W+vqHl^?Ss2?U7nKJv
zPTqXDJe84g`ee<@b&NujZ&dzbT)6piRUISiVxV8RCr_-E2YN*a%wvc0SSA<LNpC(?
l<H5+f1gOX!t_Z}lMp6{QxOno>x?IMElNW}`EcUPG0RUArr0xI!

delta 367
zcmaDkgX#P<Ce{YlsV?0cS=ZWg#4|E5)D#!gOkVA%zj>px4&&rvM-#^A$py|vU@p&;
z)+vosYNu#qutp$68K+F1=qS9|!L^ZzjVD7q>k;eZ!dj)tFWs|v_<-E)tPBhpni<TK
z9jjF)H+$4F3T|ff3}#{!-W=*3%fu);nLk*1^EuyNOpJ1q?Q*0xKMv4lVpQDBAAF02
zQ41tFnKj}Oqb^WRdNXt6BxXi^u;9j+U5pN3!S>jB%#2Q8V;mD_F*1gLMZYJBu``B)
zMK!ZTm>Bam+vS{RWh{b-6dht@YyzueFKJ<6Y@OUw5x_WU^WBP6M#gEAovYR{3Qqo1
z^^0-A=C{>#jI4`*{@|W$SZ@esu>)Dkle_ArH$SQMU}Ri8S-0MlbumzhHB=&mana=a
W^|_1-COfi<Ocvna+MM0+j~f7hqJHB5

diff --git a/docs/_build/html/_sources/index.rst.txt b/docs/_build/html/_sources/index.rst.txt
index c14c644..ebe5374 100644
--- a/docs/_build/html/_sources/index.rst.txt
+++ b/docs/_build/html/_sources/index.rst.txt
@@ -4,10 +4,11 @@
 Stockpyl
 ========
 
-|sp| is a Python package for inventory optimization. It implements
+|sp| is a Python package for inventory optimization and simulation. It implements
 classical single-node inventory models like the economic order quantity (EOQ), newsvendor,
 and Wagner-Whitin problems. It also contains algorithms for multi-echelon inventory optimization
 (MEIO) under both stochastic-service model (SSM) and guaranteed-service model (GSM) assumptions. 
+And, it has extensive features for simulating multi-echelon inventory systems.
 
 .. note:: |fosct_notation|
 
@@ -16,7 +17,7 @@ and Wagner-Whitin problems. It also contains algorithms for multi-echelon invent
 Some Examples
 -------------
 
-Solve the EOQ problem with :math:`K=8`, :math:`h=0.225`, and :math:`\lambda=1300` (Example 3.1 in *FoSCT*):
+Solve the EOQ problem with a fixed cost of 8, a holding cost of 0.225, and a demand rate of 1300 (Example 3.1 in *FoSCT*):
 
 .. doctest::
     
@@ -27,7 +28,8 @@ Solve the EOQ problem with :math:`K=8`, :math:`h=0.225`, and :math:`\lambda=1300
     >>> cost
     68.41052550594829
 
-Or the newsvendor problem with :math:`h=0.18`, :math:`p=0.70`, and :math:`D\sim N(50, 8^2)` (Example 4.3 in *FoSCT*):
+Or the newsvendor problem with a holding cost of 0.18, a stockout cost of 0.70, and demand that is normally
+distributed with mean 50 and standard deviation 8 (Example 4.3 in *FoSCT*):
 
 .. doctest::
     
diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html
index 3d691ae..d99055c 100644
--- a/docs/_build/html/genindex.html
+++ b/docs/_build/html/genindex.html
@@ -163,14 +163,14 @@ <h2 id="C">C</h2>
 <h2 id="D">D</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="api/datatypes/supply_chain_network.html#stockpyl.supply_chain_network.SupplyChainNetwork.deep_equal_to">deep_equal_to() (SupplyChainNetwork method)</a>
+      <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.deep_equal_to">deep_equal_to() (NodeStateVars method)</a>
 
       <ul>
+        <li><a href="api/datatypes/supply_chain_network.html#stockpyl.supply_chain_network.SupplyChainNetwork.deep_equal_to">(SupplyChainNetwork method)</a>
+</li>
         <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.SupplyChainNode.deep_equal_to">(SupplyChainNode method)</a>
 </li>
       </ul></li>
-      <li><a href="api/other/instances.html#stockpyl.instances.DEFAULT_JSON_FILEPATH">DEFAULT_JSON_FILEPATH (in module stockpyl.instances)</a>
-</li>
       <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.demand_cumul">demand_cumul (NodeStateVars attribute)</a>
 </li>
       <li><a href="api/datatypes/demand_source.html#stockpyl.demand_source.DemandSource.demand_distribution">demand_distribution (DemandSource property)</a>
@@ -277,12 +277,24 @@ <h2 id="F">F</h2>
 </li>
       <li><a href="api/other/helpers.html#stockpyl.helpers.find_nearest">find_nearest() (in module stockpyl.helpers)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="api/seio/finite_horizon.html#stockpyl.finite_horizon.finite_horizon_dp">finite_horizon_dp() (in module stockpyl.finite_horizon)</a>
 </li>
       <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.SupplyChainNode.forward_echelon_lead_time">forward_echelon_lead_time (SupplyChainNode property)</a>
 </li>
+      <li><a href="api/datatypes/demand_source.html#stockpyl.demand_source.DemandSource.from_dict">from_dict() (DemandSource class method)</a>
+
+      <ul>
+        <li><a href="api/datatypes/disruption_process.html#stockpyl.disruption_process.DisruptionProcess.from_dict">(DisruptionProcess class method)</a>
+</li>
+        <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.from_dict">(NodeStateVars class method)</a>
+</li>
+        <li><a href="api/datatypes/policy.html#stockpyl.policy.Policy.from_dict">(Policy class method)</a>
+</li>
+        <li><a href="api/datatypes/supply_chain_network.html#stockpyl.supply_chain_network.SupplyChainNetwork.from_dict">(SupplyChainNetwork class method)</a>
+</li>
+        <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.SupplyChainNode.from_dict">(SupplyChainNode class method)</a>
+</li>
+      </ul></li>
   </ul></td>
 </tr></table>
 
@@ -939,12 +951,26 @@ <h2 id="S">S</h2>
 <h2 id="T">T</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.total_cost_incurred">total_cost_incurred (NodeStateVars attribute)</a>
+      <li><a href="api/datatypes/demand_source.html#stockpyl.demand_source.DemandSource.to_dict">to_dict() (DemandSource method)</a>
+
+      <ul>
+        <li><a href="api/datatypes/disruption_process.html#stockpyl.disruption_process.DisruptionProcess.to_dict">(DisruptionProcess method)</a>
 </li>
-      <li><a href="api/meio/meio_general.html#stockpyl.meio_general.truncate_and_discretize">truncate_and_discretize() (in module stockpyl.meio_general)</a>
+        <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.to_dict">(NodeStateVars method)</a>
+</li>
+        <li><a href="api/datatypes/policy.html#stockpyl.policy.Policy.to_dict">(Policy method)</a>
+</li>
+        <li><a href="api/datatypes/supply_chain_network.html#stockpyl.supply_chain_network.SupplyChainNetwork.to_dict">(SupplyChainNetwork method)</a>
 </li>
+        <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.SupplyChainNode.to_dict">(SupplyChainNode method)</a>
+</li>
+      </ul></li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/datatypes/supply_chain_node.html#stockpyl.supply_chain_node.NodeStateVars.total_cost_incurred">total_cost_incurred (NodeStateVars attribute)</a>
+</li>
+      <li><a href="api/meio/meio_general.html#stockpyl.meio_general.truncate_and_discretize">truncate_and_discretize() (in module stockpyl.meio_general)</a>
+</li>
       <li><a href="api/datatypes/demand_source.html#stockpyl.demand_source.DemandSource.type">type (DemandSource attribute)</a>
 
       <ul>
diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html
index 018edce..f1dee3e 100644
--- a/docs/_build/html/index.html
+++ b/docs/_build/html/index.html
@@ -71,10 +71,11 @@
              
   <section id="stockpyl">
 <h1>Stockpyl<a class="headerlink" href="#stockpyl" title="Permalink to this heading">¶</a></h1>
-<p>Stockpyl is a Python package for inventory optimization. It implements
+<p>Stockpyl is a Python package for inventory optimization and simulation. It implements
 classical single-node inventory models like the economic order quantity (EOQ), newsvendor,
 and Wagner-Whitin problems. It also contains algorithms for multi-echelon inventory optimization
-(MEIO) under both stochastic-service model (SSM) and guaranteed-service model (GSM) assumptions.</p>
+(MEIO) under both stochastic-service model (SSM) and guaranteed-service model (GSM) assumptions.
+And, it has extensive features for simulating multi-echelon inventory systems.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
 <p>The notation and references (equations, sections, examples, etc.) used below refer to Snyder and Shen, <em>Fundamentals of Supply Chain Theory</em> (<em>FoSCT</em>), 2nd edition (2019).</p>
@@ -82,7 +83,7 @@ <h1>Stockpyl<a class="headerlink" href="#stockpyl" title="Permalink to this head
 <hr class="docutils" />
 <section id="some-examples">
 <h2>Some Examples<a class="headerlink" href="#some-examples" title="Permalink to this heading">¶</a></h2>
-<p>Solve the EOQ problem with <span class="math notranslate nohighlight">\(K=8\)</span>, <span class="math notranslate nohighlight">\(h=0.225\)</span>, and <span class="math notranslate nohighlight">\(\lambda=1300\)</span> (Example 3.1 in <em>FoSCT</em>):</p>
+<p>Solve the EOQ problem with a fixed cost of 8, a holding cost of 0.225, and a demand rate of 1300 (Example 3.1 in <em>FoSCT</em>):</p>
 <div class="highlight-pycon3 notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">stockpyl.eoq</span> <span class="kn">import</span> <span class="n">economic_order_quantity</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">Q</span><span class="p">,</span> <span class="n">cost</span> <span class="o">=</span> <span class="n">economic_order_quantity</span><span class="p">(</span><span class="n">fixed_cost</span><span class="o">=</span><span class="mi">8</span><span class="p">,</span> <span class="n">holding_cost</span><span class="o">=</span><span class="mf">0.225</span><span class="p">,</span> <span class="n">demand_rate</span><span class="o">=</span><span class="mi">1300</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">Q</span>
@@ -91,7 +92,8 @@ <h2>Some Examples<a class="headerlink" href="#some-examples" title="Permalink to
 <span class="go">68.41052550594829</span>
 </pre></div>
 </div>
-<p>Or the newsvendor problem with <span class="math notranslate nohighlight">\(h=0.18\)</span>, <span class="math notranslate nohighlight">\(p=0.70\)</span>, and <span class="math notranslate nohighlight">\(D\sim N(50, 8^2)\)</span> (Example 4.3 in <em>FoSCT</em>):</p>
+<p>Or the newsvendor problem with a holding cost of 0.18, a stockout cost of 0.70, and demand that is normally
+distributed with mean 50 and standard deviation 8 (Example 4.3 in <em>FoSCT</em>):</p>
 <div class="highlight-pycon3 notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">stockpyl.newsvendor</span> <span class="kn">import</span> <span class="n">newsvendor_normal</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">S</span><span class="p">,</span> <span class="n">cost</span> <span class="o">=</span> <span class="n">newsvendor_normal</span><span class="p">(</span><span class="n">holding_cost</span><span class="o">=</span><span class="mf">0.18</span><span class="p">,</span> <span class="n">stockout_cost</span><span class="o">=</span><span class="mf">0.70</span><span class="p">,</span> <span class="n">demand_mean</span><span class="o">=</span><span class="mi">50</span><span class="p">,</span> <span class="n">demand_sd</span><span class="o">=</span><span class="mi">8</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">S</span>
diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv
index c6ead750630e65a600908e5644323b5861d8d1e2..de8f2fc223c2e0376e431534e89858562cc3f9a1 100644
GIT binary patch
delta 4867
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

delta 4835
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
J{{=<5=OpHGYuf+-

diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js
index 248c13b..add8fb1 100644
--- a/docs/_build/html/searchindex.js
+++ b/docs/_build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["api/api", "api/datatypes/datatypes", "api/datatypes/demand_source", "api/datatypes/disruption_process", "api/datatypes/policy", "api/datatypes/supply_chain_network", "api/datatypes/supply_chain_node", "api/meio/gsm_helpers", "api/meio/gsm_serial", "api/meio/gsm_tree", "api/meio/meio", "api/meio/meio_general", "api/meio/ssm_serial", "api/other/helpers", "api/other/instances", "api/other/loss_functions", "api/other/optimization", "api/other/other", "api/seio/eoq", "api/seio/finite_horizon", "api/seio/newsvendor", "api/seio/rq", "api/seio/seio", "api/seio/ss", "api/seio/supply_uncertainty", "api/seio/wagner_whitin", "api/simulation/sim", "api/simulation/sim_io", "api/simulation/simulation", "index", "install", "tutorial/tutorial", "tutorial/tutorial_meio", "tutorial/tutorial_seio", "tutorial/tutorial_sim", "tutorial/tutorial_su"], "filenames": ["api/api.rst", "api/datatypes/datatypes.rst", "api/datatypes/demand_source.rst", "api/datatypes/disruption_process.rst", "api/datatypes/policy.rst", "api/datatypes/supply_chain_network.rst", "api/datatypes/supply_chain_node.rst", "api/meio/gsm_helpers.rst", "api/meio/gsm_serial.rst", "api/meio/gsm_tree.rst", "api/meio/meio.rst", "api/meio/meio_general.rst", "api/meio/ssm_serial.rst", "api/other/helpers.rst", "api/other/instances.rst", "api/other/loss_functions.rst", "api/other/optimization.rst", "api/other/other.rst", "api/seio/eoq.rst", "api/seio/finite_horizon.rst", "api/seio/newsvendor.rst", "api/seio/rq.rst", "api/seio/seio.rst", "api/seio/ss.rst", "api/seio/supply_uncertainty.rst", "api/seio/wagner_whitin.rst", "api/simulation/sim.rst", "api/simulation/sim_io.rst", "api/simulation/simulation.rst", "index.rst", "install.rst", "tutorial/tutorial.rst", "tutorial/tutorial_meio.rst", "tutorial/tutorial_seio.rst", "tutorial/tutorial_sim.rst", "tutorial/tutorial_su.rst"], "titles": ["API Documentation", "Data Types", "<code class=\"docutils literal notranslate\"><span class=\"pre\">demand_source</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">disruption_process</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">policy</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_chain_network</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_chain_node</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_helpers</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_serial</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_tree</span></code> Module", "Multi-Echelon Inventory Optimization", "<code class=\"docutils literal notranslate\"><span class=\"pre\">meio_general</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">ssm_serial</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">helpers</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">instances</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">loss_functions</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">optimization</span></code> Module", "Other Modules", "<code class=\"docutils literal notranslate\"><span class=\"pre\">eoq</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">finite_horizon</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">newsvendor</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">rq</span></code> Module", "Single-Echelon Inventory Optimization", "<code class=\"docutils literal notranslate\"><span class=\"pre\">ss</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_uncertainty</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">wagner_whitin</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">sim</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">sim_io</span></code> Module", "Simulation", "Stockpyl", "Installing Stockpyl", "Tutorial", "Multi-Echelon Inventory Optimization", "Single-Echelon Inventory Optimization", "Simulation", "Supply Uncertainty"], "terms": {"singl": [0, 5, 7, 11, 16, 18, 19, 20, 21, 23, 24, 25, 29, 31, 34, 35], "echelon": [0, 4, 5, 6, 7, 8, 9, 11, 12, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 31, 34, 35], "inventori": [0, 4, 5, 6, 7, 8, 9, 11, 12, 15, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 31, 35], "optim": [0, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35], "eoq": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34], "modul": [0, 1, 10, 22, 28, 29, 32, 33, 34, 35], "newsvendor": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34], "rq": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "ss": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "wagner_whitin": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 26, 27, 28, 29, 30, 32, 33, 34, 35], "finite_horizon": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "supply_uncertainti": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "multi": [0, 5, 6, 7, 8, 9, 11, 12, 26, 27, 29, 31, 34], "ssm_serial": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_tree": [0, 2, 3, 4, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_serial": [0, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_helper": [0, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "meio_gener": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "simul": [0, 5, 6, 11, 26, 27, 29, 31, 32], "sim": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 27, 28, 29, 30, 32, 33, 34, 35], "sim_io": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 34, 35], "data": [0, 5, 6, 8, 9, 12, 13, 14, 26, 27, 29, 31, 32], "type": [0, 2, 3, 4, 5, 6, 7, 9, 11, 12, 13, 14, 20, 21, 23, 24, 26, 27, 29, 32, 33, 34, 35], "supply_chain_nod": [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "supply_chain_network": [0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "demand_sourc": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "polici": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35], "disruption_process": [0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "other": [0, 4, 5, 6, 9, 12, 13, 14, 16, 21, 26, 29, 32, 33, 34], "instanc": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "loss_funct": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "helper": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "stockpyl": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 32, 33, 34, 35], "fosct": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "The": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34], "notat": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "equat": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "section": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "exampl": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 35], "etc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "us": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "below": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "snyder": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "shen": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "fundament": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "suppli": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33], "chain": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "theori": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "2nd": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "edit": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "2019": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "term": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "node": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "stage": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "ar": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "interchang": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "document": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, 32, 33, 34, 35], "supplychainnetwork": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35], "supplychainnod": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "nodestatevar": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "demandsourc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "disruptionprocess": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "r": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "q": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "s": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "thi": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 15, 16, 19, 21, 27, 32, 34], "contain": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34, 35], "class": [2, 3, 4, 5, 6, 15, 29, 31, 34], "A": [2, 3, 4, 5, 6, 7, 8, 11, 12, 13, 14, 19, 20, 21, 23, 24, 27, 32, 34], "object": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 20, 24, 26, 32, 33, 34, 35], "repres": [2, 3, 4, 5, 13, 15, 25, 27, 34], "extern": [2, 4, 6, 7, 8, 27], "demand": [2, 4, 5, 6, 7, 8, 9, 12, 14, 15, 18, 19, 20, 21, 23, 24, 25, 27, 29, 31, 32, 33, 35], "observ": [2, 34], "can": [2, 3, 5, 6, 11, 12, 14, 29, 32, 33, 34, 35], "random": [2, 3, 13, 15, 26], "determinist": [2, 24, 34, 35], "attribut": [2, 3, 4, 5, 6, 9, 12, 13, 14, 32, 34], "specifi": [2, 3, 4, 5, 7, 12, 13, 14, 19, 32, 33, 34], "distribut": [2, 5, 8, 12, 13, 14, 15, 19, 20, 21, 23, 24, 32, 33, 34, 35], "its": [2, 3, 5, 6, 8, 11, 13, 18, 20, 26, 32, 33, 34], "paramet": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34], "gener": [2, 3, 5, 12, 13, 15, 19, 20, 24, 26, 29, 31, 34], "from": [2, 3, 4, 5, 6, 7, 8, 9, 13, 14, 15, 16, 19, 20, 24, 25, 27, 29, 32, 33, 35], "creat": [2, 3, 4, 5, 6, 13, 14, 32], "ha": [2, 4, 5, 6, 9, 12, 13, 14, 15, 16, 27, 29, 34], "normal": [2, 8, 12, 14, 15, 19, 20, 21, 23, 24, 32, 33, 35], "mean": [2, 5, 6, 7, 8, 12, 13, 15, 19, 20, 21, 23, 24, 25, 26, 29, 32, 34, 35], "50": [2, 13, 18, 19, 20, 23, 29, 33, 34], "standard": [2, 6, 8, 12, 15, 19, 20, 21, 23, 24, 26, 34, 35], "deviat": [2, 6, 8, 12, 15, 19, 20, 21, 23, 24, 35], "10": [2, 7, 11, 13, 15, 23, 29, 32, 33, 34], "ds": 2, "n": [2, 8, 12, 13, 15, 18, 20, 21, 24, 26, 29, 32, 34], "standard_devi": [2, 29, 32, 34], "generate_demand": 2, "46": [2, 32, 34], "75370030596123": 2, "tell": [2, 34], "round": [2, 12, 13, 18, 19], "integ": [2, 9, 12, 13, 15, 19, 20, 21, 23], "round_to_int": [2, 5], "true": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 26, 27, 33, 34, 35], "63": 2, "kwarg": [2, 3, 4, 5, 6], "keyword": [2, 3, 4, 5], "argument": [2, 3, 4, 5, 6, 11, 13, 15, 24, 32], "valu": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 23, 24, 25, 27, 33, 34], "one": [2, 3, 4, 5, 6, 7, 9, 11, 13, 15, 21, 32, 34], "more": [2, 3, 4, 5, 6, 7, 11, 13, 24, 29, 32, 34], "e": [2, 3, 4, 5, 6, 12, 13, 14, 15, 19, 20, 24, 26, 32, 33, 34], "g": [2, 3, 4, 7, 12, 14, 18, 19, 20, 21, 23, 24, 25, 34], "string": [2, 3, 4, 6, 12, 13, 26, 27, 34], "current": [2, 3, 4, 5, 6, 9, 11, 20, 26, 27, 34, 35], "support": [2, 3, 4, 6, 12, 13, 15, 23, 26, 27, 33, 34, 35], "none": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 23, 24, 26, 27, 32, 34], "p": [2, 6, 7, 9, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 27, 29, 33, 34, 35], "poisson": [2, 14, 15, 20, 21, 23, 33, 34], "ud": 2, "uniform": [2, 13, 15, 24, 35], "discret": [2, 11, 12, 13, 14, 15, 19, 20, 23, 32, 33], "uc": 2, "continu": [2, 13, 15, 20, 21, 33], "d": [2, 12, 13, 19, 20, 23, 24, 25, 29, 33, 34, 35], "cd": 2, "custom": [2, 6, 8, 13, 15, 23, 27], "str": [2, 3, 4, 6, 13, 14, 26, 27], "nearest": [2, 12, 13, 19], "bool": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 26, 27], "per": [2, 3, 6, 7, 8, 11, 12, 16, 18, 19, 20, 21, 23, 24, 25, 27, 29, 32, 34], "period": [2, 3, 5, 6, 7, 11, 13, 14, 19, 20, 23, 24, 25, 26, 27, 29, 32, 33, 34], "requir": [2, 3, 4, 5, 8, 12, 13, 15, 19, 20, 23, 24, 27, 32], "mu": [2, 8, 12, 15, 18, 19, 20, 21, 23, 24, 29, 33], "float": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26], "option": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 20, 23, 24, 25, 26, 27, 33], "sigma": [2, 15, 19, 20, 21, 23, 29, 33], "demand_list": [2, 34], "list": [2, 3, 5, 6, 7, 8, 11, 12, 13, 14, 18, 19, 23, 25, 27, 32, 34], "possibl": [2, 13, 19, 20, 34], "For": [2, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 32, 33, 34], "beyond": [2, 3], "length": [2, 3, 8, 13, 14, 19, 23, 24, 25], "restart": [2, 3, 19], "begin": [2, 3, 12, 19, 34], "also": [2, 5, 6, 15, 29, 32, 33], "allow": [2, 4, 5, 32, 34], "singleton": [2, 5, 8, 11, 12, 13, 19, 20, 25, 32], "which": [2, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 19, 20, 24, 25, 26, 27, 32, 33, 34], "case": [2, 4, 5, 6, 8, 9, 12, 13, 14, 19, 25, 27, 34], "everi": [2, 9, 11, 13, 18, 19, 25, 34], "probabl": [2, 3, 12, 13, 15, 19, 20, 24, 33, 34], "each": [2, 3, 5, 6, 7, 8, 9, 11, 12, 13, 14, 16, 19, 21, 25, 26, 27, 32, 33, 34], "lo": [2, 11, 13], "low": [2, 11, 19], "rang": [2, 5, 11, 12, 13, 19, 20, 32, 33, 34], "hi": [2, 11, 13, 23], "high": [2, 11, 19], "properti": [2, 5, 6, 21], "demand_distribut": 2, "scipi": [2, 15, 20, 24, 33, 34, 35], "stat": [2, 15, 20, 24, 33, 34, 35], "rv_continu": [2, 13, 15, 20, 24, 33, 35], "rv_discret": [2, 13, 15, 20, 24, 33, 35], "read": [2, 5, 6], "onli": [2, 3, 4, 5, 6, 14, 24, 32, 33, 34, 35], "initi": [2, 3, 4, 5, 6, 11, 14, 19, 25, 26], "overwrit": [2, 3, 4, 5, 6], "default": [2, 3, 4, 5, 6, 12, 13, 14, 19, 20, 26, 27, 34], "If": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 26, 27, 33, 34, 35], "all": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 19, 26, 27, 32, 34], "reset": [2, 3, 4, 5, 6], "even": [2, 3, 4, 5, 6, 9, 14, 27, 32], "thei": [2, 3, 4, 5, 6, 11, 12, 13, 14, 19, 32, 34], "alreadi": [2, 3, 4, 5, 6, 9, 14, 34], "exist": [2, 3, 4, 5, 6, 13, 14], "how": [2, 3, 4, 5, 6, 32, 34], "method": [2, 3, 4, 5, 6, 11, 15, 23, 32], "should": [2, 3, 4, 5, 6, 11, 13, 34], "call": [2, 3, 4, 5, 6, 9, 11, 12, 13, 33], "__init": [2, 3, 4, 5, 6], "__": [2, 3, 4, 5, 6], "fals": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 27, 34], "miss": [2, 3, 4, 5, 6, 9, 13, 14], "ad": [2, 3, 4, 5, 6, 19, 34], "overwritten": [2, 3, 4, 5, 6], "when": [2, 3, 4, 5, 6, 11, 12, 13, 16, 19, 21, 27, 32, 34], "load": [2, 3, 4, 5, 6, 14, 29, 32, 34], "an": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 32, 33, 34, 35], "file": [2, 3, 4, 5, 6, 14, 26, 27, 34], "make": [2, 3, 4, 5, 6, 13, 32, 34], "sure": [2, 3, 4, 5, 6], "present": [2, 3, 4, 5, 6, 12, 13, 14, 24], "those": [2, 3, 4, 5, 6, 12, 34], "return": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 33, 34, 35], "int": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 15, 18, 19, 20, 23, 25, 26, 27], "omit": [2, 3, 4, 5, 11, 12, 14, 27, 32], "first": [2, 3, 5, 6, 12, 13, 21, 32, 34], "validate_paramet": [2, 3, 4], "check": [2, 3, 4, 5, 6, 13, 26], "appropri": [2, 3, 4], "have": [2, 3, 4, 5, 6, 7, 8, 9, 11, 13, 14, 19, 27, 34, 35], "been": [2, 3, 4, 5, 6, 7, 9, 15, 27, 34], "provid": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 19, 20, 23, 24, 32, 34, 35], "given": [2, 3, 4, 5, 6, 7, 11, 12, 13, 15, 16, 18, 19, 20, 21, 23, 24, 25, 27, 33, 34], "rais": [2, 3, 4, 5, 12, 13, 14, 15, 19, 20, 21, 23, 24, 25, 26], "except": [2, 3, 4, 5, 6, 12, 15, 26], "cdf": [2, 13, 15, 20], "x": [2, 12, 13, 15, 16, 18, 19, 24, 34], "cumul": [2, 6, 27, 34], "function": [2, 5, 6, 9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 23, 24, 27, 29, 32, 33, 35], "In": [2, 5, 6, 13, 19, 25, 27, 32, 34, 35], "some": [2, 6, 18, 19, 20, 25, 27, 32, 33], "just": [2, 3, 12, 32, 34], "wrapper": [2, 12], "around": [2, 19], "calcul": [2, 3, 4, 6, 7, 12, 13, 15, 18, 19, 20, 21, 23, 24, 26, 33, 34], "f": [2, 12, 13, 15, 16, 19, 20, 21, 24, 29, 33, 34], "lead_time_demand_distribut": 2, "lead_tim": [2, 6, 12, 13, 20, 21, 32, 33, 34], "lead": [2, 6, 7, 9, 12, 14, 19, 20, 21, 23, 29, 31], "time": [2, 6, 7, 8, 9, 12, 13, 14, 18, 19, 20, 21, 23, 24, 25, 26, 29, 31, 32, 33], "sum": [2, 6, 12, 13], "independ": [2, 9], "variabl": [2, 4, 6, 13, 14, 15, 26, 27, 34], "therefor": [2, 6, 34], "valueerror": [2, 5, 12, 13, 14, 15, 19, 20, 21, 23, 24, 25, 26], "l": [2, 6, 8, 12, 14, 15, 20, 21, 23, 33, 34], "disrupt": [3, 6, 14, 24, 27, 29, 31], "process": [3, 6, 8, 9, 34, 35], "subject": [3, 34], "govern": [3, 24], "well": [3, 5, 6, 11, 20, 27, 32], "itself": [3, 5, 6, 24], "i": [3, 4, 5, 6, 12, 13, 15, 19, 25, 27, 32, 33, 34], "effect": [3, 34], "keep": 3, "track": 3, "state": [3, 4, 6, 14, 19, 26, 27, 34, 35], "new": [3, 5, 6, 9, 13, 14, 19, 20], "accord": [3, 34], "follow": [3, 5, 6, 8, 12, 19, 24, 27, 32, 33, 34, 35], "2": [3, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 29, 32, 33, 34, 35], "markov": [3, 34, 35], "0": [3, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34, 35], "1": [3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34, 35], "recoveri": [3, 34], "3": [3, 7, 8, 9, 12, 13, 14, 15, 18, 19, 20, 21, 24, 25, 29, 32, 33, 34, 35], "order": [3, 4, 5, 6, 12, 13, 15, 18, 19, 21, 23, 24, 25, 27, 29, 33, 34, 35], "paus": [3, 34], "cannot": [3, 6, 14, 15, 27, 34], "place": [3, 4, 6, 13, 27, 34], "assum": [3, 5, 6, 8, 11, 12, 13, 15, 19, 20, 21, 23, 25, 34, 35], "dp": [3, 7, 8, 9, 19, 25, 32, 33], "random_process_typ": [3, 34], "m": [3, 21, 23, 33, 34], "markovian": 3, "disruption_typ": [3, 34], "op": [3, 34], "disruption_prob": [3, 24, 34], "recovery_prob": [3, 24, 34], "update_disruption_st": 3, "steadi": 3, "being": [3, 6, 16, 34], "up": [3, 4, 12, 13, 14, 19, 23, 24, 29, 33], "down": [3, 12, 13, 24], "pi_up": 3, "pi_down": 3, "steady_state_prob": 3, "7499999999999999": 3, "25": [3, 14, 24, 29, 34, 35], "explicit": [3, 14, 20, 33], "explicitli": [3, 34], "dure": [3, 6, 34], "sp": [3, 6, 27, 34], "shipment": [3, 6, 12, 27, 34], "supplier": [3, 4, 6, 8, 24, 27, 35], "ship": [3, 34], "them": [3, 13, 29, 32, 34], "tp": [3, 34], "transit": [3, 6, 27, 34], "item": [3, 6, 12, 13, 18, 19, 20, 21, 23, 24, 25, 27, 34], "rp": [3, 6, 27, 34], "receipt": [3, 6, 34], "receiv": [3, 6, 27, 34], "accumul": [3, 34], "befor": [3, 4, 6, 9, 13, 34], "end": [3, 6, 11, 12, 13, 16, 19, 27, 34], "t": [3, 18, 19, 20, 21, 24, 25, 29, 33, 34], "alpha": [3, 20, 21, 24, 26, 34, 35], "beta": [3, 15, 24, 35], "disruption_state_list": 3, "otherwis": [3, 5, 6, 12, 13, 14, 15, 19, 20, 23, 27, 34], "updat": [3, 5, 6, 34], "set": [3, 5, 6, 7, 8, 11, 12, 13, 14, 16, 19, 20, 23, 24, 26, 27, 29, 32, 34], "accordingli": 3, "non": [3, 6, 13, 19, 20, 23, 32, 33], "encapsul": 4, "quantiti": [4, 6, 18, 19, 21, 24, 25, 27, 29, 33, 34, 35], "base": [4, 5, 7, 11, 12, 14, 20, 24, 26, 29, 32, 33, 34, 35], "stock": [4, 5, 6, 7, 8, 9, 11, 12, 14, 20, 21, 24, 26, 27, 29, 32, 33, 34, 35], "level": [4, 5, 6, 7, 9, 11, 12, 19, 20, 21, 23, 24, 26, 27, 29, 32, 33, 34, 35], "60": [4, 20], "posit": [4, 6, 19, 27, 34], "52": 4, "5": [4, 7, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34, 35], "pol": 4, "bs": [4, 5, 29, 32, 34], "base_stock_level": [4, 5, 7, 11, 20, 24, 29, 32, 33, 34], "get_order_quant": 4, "inventory_posit": [4, 6], "7": [4, 13, 14, 15, 19, 20, 21, 23, 29, 32, 33, 34], "fq": 4, "fix": [4, 18, 19, 21, 23, 24, 25, 33, 34], "eb": [4, 34], "beb": 4, "balanc": 4, "applic": 4, "order_quant": [4, 6, 18, 21, 24, 25, 34], "reorder_point": [4, 19, 21, 23, 34], "reorder": [4, 19, 21, 23, 29, 33], "point": [4, 16, 19, 21, 23, 29, 33, 34], "order_up_to_level": [4, 19, 23], "predecessor_index": [4, 6], "echelon_inventory_position_adjust": 4, "obtain": [4, 29], "necessari": [4, 8, 12], "typic": [4, 6, 14, 32, 34], "sometim": [4, 11, 12, 32], "self": [4, 6, 15], "network": [4, 5, 6, 7, 8, 9, 11, 12, 26, 27, 29, 32, 34], "overrid": 4, "indic": [4, 5, 6, 7, 8, 9, 11, 12, 13, 19, 26, 27, 33], "queri": 4, "predecessor": [4, 5, 6, 7, 27, 34], "includ": [4, 5, 6, 9, 13, 18, 21, 27, 29, 33, 34], "immedi": [4, 34], "after": [4, 19, 26, 27, 34], "subtract": [4, 19], "ip": 4, "instead": [4, 6, 12, 14, 15, 32, 34], "adjust": [4, 14, 15, 19, 34], "where": [4, 5, 6, 13, 15, 18, 19, 20, 21, 23, 24, 34], "eipa": 4, "consist": [5, 13, 24, 26, 32, 34], "togeth": [5, 13], "problem": [5, 6, 7, 8, 12, 14, 18, 19, 20, 21, 23, 24, 25, 29, 31, 32], "primarili": [5, 6], "meio": [5, 6, 10, 11, 29, 31, 34], "most": [5, 6, 12, 13, 14, 19, 21, 25, 26, 29], "within": [5, 16, 21], "rather": [5, 6, 13, 15, 29], "than": [5, 6, 9, 11, 13, 15, 16, 19, 20, 29, 32, 33, 34], "problem_specific_data": [5, 6], "placehold": [5, 6], "specif": [5, 6, 8, 12], "max_max_replenishment_tim": [5, 9], "largest": [5, 13, 19], "max_replenishment_tim": [5, 9], "among": [5, 34], "node_indic": [5, 7, 11, 13], "source_nod": 5, "sourc": [5, 6, 34], "sink_nod": 5, "sink": [5, 34], "successor": [5, 6, 27, 34], "edg": [5, 32, 34], "tupl": [5, 24], "whose": [5, 6, 13, 33, 34], "element": [5, 13, 19, 25], "has_directed_cycl": 5, "whether": [5, 6, 9, 13, 26, 34], "direct": [5, 6, 26, 32], "cycl": [5, 26, 33], "handl": [5, 13], "_node": 5, "replac": [5, 6, 14], "empti": 5, "doe": [5, 6, 9, 13, 14, 19, 32, 34], "fill": [5, 6, 9, 13, 26, 27, 34], "noth": [5, 6, 14], "least": [5, 13], "ensur": [5, 6, 13, 14], "deep_equal_to": [5, 6], "rel_tol": [5, 6, 13], "1e": [5, 6, 13, 16, 21], "08": [5, 6], "deepli": [5, 6], "equal": [5, 6, 8, 11, 13, 14, 16, 19, 20, 33, 34], "themselv": [5, 6], "compar": [5, 6, 34], "rel": [5, 6, 11, 13, 14, 32], "toler": [5, 6, 11, 13, 16, 19, 21], "two": [5, 6, 13, 15, 19, 34], "get_node_from_index": [5, 32, 34], "index": [5, 6, 7, 8, 9, 11, 12, 13, 19, 25, 27, 29, 32, 34], "match": [5, 13, 34], "found": [5, 11, 14], "find": [5, 20, 21, 23, 32], "reindex_nod": 5, "old_to_new_dict": [5, 6], "new_nam": 5, "chang": [5, 6, 12, 13], "name": [5, 6, 13, 14, 27, 29, 32, 34], "dict": [5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 20, 32, 33], "kei": [5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 20], "old": [5, 6], "add_nod": [5, 32], "add": [5, 6, 32], "connect": 5, "might": [5, 6, 13], "determin": [5, 6, 7, 9, 11, 12, 13, 21, 23, 34], "do": [5, 9, 11, 12, 13, 14, 26, 34], "add_edg": 5, "from_index": 5, "to_index": 5, "either": [5, 8, 11, 12, 15, 19, 20, 24, 32, 33, 35], "add_edges_from_list": 5, "edge_list": 5, "multipl": [5, 13, 14, 24, 33, 35], "ani": [5, 6, 7, 11, 12, 13, 14, 19, 20, 25, 26, 32, 34], "ignor": [5, 6, 8, 9, 11, 12, 13, 14, 15, 19, 20, 23, 24, 25, 27], "add_successor": [5, 6, 32], "successor_nod": 5, "must": [5, 6, 8, 9, 11, 12, 13, 15, 19, 20, 23, 25, 32, 34], "_successor": 5, "_predecessor": 5, "add_predecessor": [5, 6], "predecessor_nod": 5, "remove_nod": [5, 6], "remov": [5, 6], "networkx_digraph": 5, "build": [5, 13, 26, 29, 32, 34], "networkx": 5, "digraph": 5, "same": [5, 7, 11, 12, 13, 14, 15, 19, 25, 29, 32, 34], "structur": [5, 7, 8, 9, 14, 29, 31, 32], "network_from_edg": [5, 32, 34], "node_order_in_list": [5, 12, 13, 32, 34], "construct": [5, 34], "correspond": [5, 8, 12, 13, 27, 33, 34], "That": [5, 6, 12, 13], "slot": [5, 12, 13], "k": [5, 8, 12, 13, 18, 19, 21, 23, 24, 25, 29, 33, 35], "assign": [5, 12, 29], "sort": [5, 13], "unless": [5, 9, 13, 24], "rule": 5, "abov": [5, 20, 27, 29, 34, 35], "appli": 5, "supply_typ": [5, 6, 34], "u": [5, 6, 13, 15], "matter": 5, "you": [5, 6, 32, 33, 34, 35], "mai": [5, 8, 9, 11, 12, 13, 19, 25, 32, 33, 34], "pass": [5, 13, 32, 33, 34], "individu": [5, 8, 11, 12, 18, 32], "latter": [5, 19, 25, 27], "note": [5, 6, 15, 24, 26, 27, 29, 34], "demand_typ": [5, 29, 32, 34], "avoid": [5, 19], "ambigu": 5, "similarli": 5, "inventory_polici": [5, 6, 29, 34], "policy_typ": [5, 32, 34], "attributeerror": 5, "though": 5, "see": [5, 13, 15, 32, 33], "valid": [5, 19, 34], "b": [5, 13, 14, 15, 16, 20], "th": [5, 8, 12, 13], "single_stage_system": [5, 34], "serial_system": [5, 12, 29, 32, 34], "num_nod": [5, 8, 12, 13, 29, 32, 34], "node_order_in_system": [5, 12, 29, 32, 34], "serial": [5, 8, 11, 12, 14, 29, 31, 34], "system": [5, 6, 7, 8, 9, 11, 12, 14, 21, 26, 29, 31, 34], "number": [5, 6, 8, 11, 12, 13, 14, 15, 19, 21, 25, 26, 27, 33, 34], "By": [5, 12], "upstream": [5, 6, 12, 34], "downstream": [5, 6, 12, 34], "stockout_cost": [5, 6, 9, 12, 13, 18, 19, 20, 21, 23, 24, 29, 32, 33, 34], "appear": [5, 12, 13, 34], "owmr_system": 5, "num_retail": 5, "warehous": [5, 14], "retail": [5, 14], "owmr": 5, "last": [5, 13], "mwor_system": 5, "num_warehous": 5, "mwor": 5, "assembl": [5, 6, 14], "local_to_echelon_base_stock_level": [5, 32], "s_local": 5, "convert": [5, 9, 29, 32], "local": [5, 6, 7, 8, 9, 16, 29, 32], "anyth": [5, 9, 14], "about": [5, 23, 34], "label": [5, 7, 9, 23, 27, 34], "s_echelon": 5, "echelon_to_local_base_stock_level": [5, 29, 34], "rare": 6, "ever": 6, "standalon": [6, 11, 34], "describ": [6, 8, 9, 12, 23], "complet": [6, 34], "mani": [6, 34], "differ": [6, 11, 15, 34, 35], "optimize_base_stock_level": [6, 12, 29, 32, 34], "take": [6, 11, 13, 15, 24, 34], "echelon_holding_cost": [6, 12, 29, 32], "while": [6, 32], "optimize_committed_service_tim": [6, 8, 9, 29, 32], "local_holding_cost": [6, 8, 13, 29, 32, 34], "processing_tim": [6, 8, 13, 32], "need": [6, 7, 9, 12, 13, 34], "perform": [6, 9, 12, 18, 19, 20, 24, 26, 32], "measur": [6, 26], "hold": [6, 8, 9, 12, 18, 19, 20, 21, 23, 24, 25, 27, 33], "cost": [6, 7, 8, 9, 11, 12, 14, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 35], "unit": [6, 8, 12, 18, 20, 21, 24, 34], "h": [6, 8, 12, 18, 19, 20, 21, 23, 24, 25, 29, 33, 34, 35], "local_holding_cost_funct": [6, 34], "exactli": [6, 9, 12, 32, 35], "il": [6, 19, 27, 34], "in_transit_holding_cost": 6, "coeffici": [6, 34], "en": [6, 13, 16], "rout": 6, "To": [6, 26, 30, 32, 34], "stockout": [6, 9, 12, 18, 19, 20, 21, 23, 24, 27, 33], "backord": [6, 18, 21, 26, 27, 33, 34], "stockout_cost_funct": [6, 34], "purchase_cost": [6, 19, 20, 25, 33], "incur": [6, 27, 34], "revenu": [6, 20, 27, 33, 34], "earn": 6, "met": [6, 27, 34], "shipment_lead_tim": [6, 27, 29, 32, 34], "alia": 6, "order_lead_tim": [6, 27, 34], "initial_inventory_level": [6, 19, 26], "initial_ord": 6, "outbound": [6, 7, 8, 27, 34], "inbound": [6, 7, 8, 27, 34], "decis": 6, "unlimit": 6, "state_var": 6, "include_extern": 6, "predecessor_indic": 6, "successor_indic": 6, "descend": 6, "necessarili": [6, 11, 32], "directli": [6, 26, 32, 34], "adjac": [6, 9], "reach": 6, "via": 6, "path": [6, 14, 27], "ancestor": 6, "we": [6, 14, 15, 19, 29, 32, 33, 34], "neighbor": 6, "neighbor_indic": 6, "holding_cost": [6, 12, 14, 18, 19, 20, 21, 23, 24, 25, 29, 33, 34], "forward_echelon_lead_tim": 6, "total": [6, 19, 26, 27, 29, 34], "rosl": [6, 14], "1989": [6, 14], "m_i": 6, "zipkin": [6, 15, 19, 20, 34], "2000": [6, 7, 9, 15, 19, 20, 24, 29, 32, 34, 35], "underlin": [6, 12, 19, 20], "_j": [6, 12], "algorithm": [6, 7, 8, 9, 11, 12, 16, 19, 21, 23, 25, 29, 32, 33, 34], "forward": 6, "equivalent_lead_tim": 6, "between": [6, 11, 18, 34], "decreas": 6, "consecut": [6, 9, 18], "wai": [6, 15, 32], "result": [6, 15, 19, 27, 29, 31, 33], "unreli": 6, "smallest": [6, 9, 13, 19, 20], "equival": [6, 27, 34], "l_i": 6, "derived_demand_mean": 6, "deriv": 6, "derived_demand_standard_devi": 6, "state_vars_curr": 6, "recent": [6, 13, 26], "Is": 6, "work": [6, 13], "fulli": 6, "caveat": 6, "simpli": 6, "It": [6, 20, 29, 34], "remove_successor": 6, "remove_predecessor": 6, "get_one_successor": 6, "get": 6, "get_one_predecessor": 6, "reindex_all_state_vari": 6, "intermedi": 6, "until": [6, 15, 34], "inbound_shipment_pipelin": 6, "arriv": [6, 27, 34], "inbound_ship": 6, "inbound_order_pipelin": 6, "inbound_ord": 6, "demand_cumul": 6, "intern": [6, 8, 9, 24], "through": 6, "fill_rat": 6, "outbound_ship": 6, "on_order_by_predecessor": 6, "yet": [6, 27, 34], "inventory_level": 6, "neg": [6, 15, 23, 27, 34], "zero": [6, 20, 27, 33, 34], "backorders_by_successor": 6, "outbound_disrupted_item": 6, "held": [6, 27, 34], "due": [6, 15, 21, 27, 34], "sinc": [6, 11, 12, 14, 32, 34], "alwai": [6, 12, 34, 35], "over": [6, 16, 19, 20, 26, 27], "max": [6, 13, 15, 19, 34], "inbound_disrupted_item": 6, "raw_material_inventori": 6, "product": [6, 8, 18, 24, 33, 34], "raw": [6, 27, 34], "materi": [6, 27, 34], "wa": [6, 9, 14, 27, 34], "holding_cost_incur": 6, "stockout_cost_incur": 6, "in_transit_holding_cost_incur": 6, "revenue_earn": 6, "total_cost_incur": 6, "less": [6, 11, 15, 16, 19, 20], "demand_met_from_stock": 6, "demand_met_from_stock_cumul": 6, "rate": [6, 15, 27, 34], "on_hand": 6, "hand": [6, 34], "in_transit_to": 6, "declar": [6, 15], "becaus": [6, 19, 34], "deliv": [6, 35], "in_transit_from": 6, "in_transit": 6, "count": [6, 13], "divid": 6, "on_ord": 6, "raw_material_aggreg": 6, "inbound_disrupted_items_aggreg": 6, "plu": [6, 13, 21, 33], "On": [6, 19, 20, 21], "aggreg": 6, "consid": [6, 12, 16, 19, 32, 34], "exclud": 6, "echelon_on_hand_inventori": 6, "echelon_inventory_level": 6, "minu": [6, 7], "termin": [6, 11, 16, 19, 21], "echelon_inventory_posit": 6, "reindex_state_vari": 6, "code": [7, 8, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 32, 33, 34, 35], "dynam": [7, 8, 9, 19, 25, 29, 32, 33], "program": [7, 8, 9, 19, 25, 29, 32, 33], "solv": [7, 11, 12, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 35], "guarante": [7, 8, 29, 32], "servic": [7, 8, 9, 12, 29, 32], "model": [7, 8, 12, 24, 29, 32, 33, 34, 35], "gsm": [7, 8, 9, 14, 29, 31], "tree": [7, 9, 11, 14, 29, 31], "grave": [7, 9, 29, 32], "willem": [7, 9, 29, 32], "2003": [7, 9, 12, 14, 34], "implement": [7, 8, 9, 12, 16, 19, 29, 32, 33], "tutori": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 34], "page": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "c": [7, 9, 12, 13, 14, 15, 19, 20, 23, 25, 29, 33], "strateg": [7, 9], "safeti": [7, 8, 9, 21, 33], "placement": [7, 9], "manufactur": [7, 9], "oper": [7, 9, 21, 23], "manag": [7, 9, 12, 15, 19, 20, 21, 23, 34], "68": [7, 9, 18, 29, 33], "83": [7, 9], "erratum": [7, 9], "176": [7, 9], "177": [7, 9], "solution_cost_from_cst": 7, "cst": [7, 8, 9, 29, 32], "expect": [7, 8, 9, 11, 12, 19, 20, 21, 23, 24, 29, 32, 33, 34, 35], "solut": [7, 11, 12, 18, 19, 20, 21, 23, 24, 32, 33, 34], "commit": [7, 8, 9, 29, 32], "relabel": [7, 9], "6": [7, 8, 9, 11, 12, 13, 14, 15, 19, 20, 21, 23, 24, 29, 32, 33, 34], "import": [7, 8, 9, 15, 20, 24, 29, 32, 33, 34, 35], "load_inst": [7, 8, 9, 14, 29, 32, 34], "preprocess_tre": [7, 9], "example_6_5": [7, 9, 14, 29, 32], "4": [7, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34], "8": [7, 9, 13, 14, 15, 18, 19, 20, 21, 23, 24, 29, 32, 33, 34, 35], "277916867529369": [7, 9, 29, 32], "solution_cost_from_base_stock_level": 7, "local_bsl": 7, "graph": 7, "y": [7, 12, 15, 19, 20, 21, 23, 24, 34], "45": [7, 34], "00": [7, 33], "41": [7, 15, 20, 24, 34], "27": [7, 14, 15, 18, 20, 21, 24, 34], "inbound_cst": 7, "node_index": 7, "si": 7, "maximum": 7, "iter": [7, 11, 13, 16, 21], "dictionari": [7, 11, 13, 14, 33], "9": [7, 14, 15, 18, 21, 24, 25, 33, 34], "problem_6_9": [7, 14], "31": [7, 14, 15, 18, 34], "net_lead_tim": 7, "net": 7, "nlt": 7, "35": [7, 20], "cst_to_base_stock_level": 7, "4494897427831783": 7, "4142135623730951": 7, "safety_stock_level": 7, "inderfurth": [8, 32], "1991": [8, 23, 24, 32, 33, 35], "multistag": 8, "journal": [8, 24], "econom": [8, 18, 24, 29, 33, 35], "24": [8, 20, 24, 34], "103": [8, 21], "113": 8, "demand_bound_const": [8, 9, 32], "external_outbound_cst": [8, 9, 32], "external_inbound_cst": [8, 9, 32], "demand_mean": [8, 12, 13, 19, 20, 21, 23, 29, 32, 33], "demand_standard_devi": [8, 12, 32], "ldot": [8, 12, 13, 19], "entri": [8, 13], "constant": 8, "bound": [8, 11, 12, 13, 15, 16, 19, 32, 34], "opt_cst": [8, 9, 29, 32], "opt_cost": [8, 9, 29, 32], "example_6_3": [8, 14, 32], "8284271247461903": [8, 32], "primari": [9, 26], "pre": 9, "relabel_nod": 9, "so": [9, 20, 32, 34], "output": [9, 11, 13, 19, 25, 34], "express": 9, "origin": [9, 14], "preprocess": 9, "copi": [9, 13], "correctli": 9, "net_demand_mean": 9, "net_demand_standard_devi": 9, "larger_adjacent_nod": 9, "start_index": 9, "start": [9, 11, 19, 27, 34], "new_tre": 9, "force_relabel": 9, "modifi": [9, 20, 25], "input": [9, 32, 34], "original_label": 9, "larger_adjacent_node_is_downstream": 9, "relabeled_tre": 9, "is_correctly_label": 9, "highest": 9, "greater": [9, 19], "gsm_to_ssm": 9, "ssm": [9, 12, 14, 29, 31], "field": 9, "ssm_tree": 9, "represent": 9, "refer": [10, 22, 28, 29, 30, 31, 32, 33, 35], "overview": [10, 22, 28], "arbitrari": [11, 15, 32, 33, 34, 35], "topolog": [11, 32], "approxim": [11, 12, 21, 23, 24, 32, 33, 34, 35], "brute": [11, 32], "forc": [11, 32], "approach": [11, 32], "coordin": [11, 32], "descent": [11, 32], "enumer": [11, 32], "These": [11, 12, 14, 32, 33, 34], "heurist": [11, 12, 18, 23, 32, 33, 34, 35], "tend": [11, 32], "quit": [11, 32], "slow": [11, 32], "particularli": [11, 32], "accur": [11, 24, 32], "best": [11, 32], "avail": [11, 30, 32], "complex": [11, 32], "literatur": [11, 32, 34], "meio_by_enumer": [11, 32], "truncation_lo": [11, 32], "truncation_hi": [11, 32], "discretization_step": 11, "discretization_num": 11, "group": [11, 27, 34], "objective_funct": [11, 32], "sim_num_tri": [11, 32], "sim_num_period": [11, 32], "1000": [11, 12, 29, 34], "sim_rand_se": [11, 32], "progress_bar": [11, 26, 34], "print_solut": 11, "combin": [11, 34], "evalu": [11, 12, 16, 18, 20, 23, 24, 32, 33], "test": [11, 13, 32], "15": [11, 15, 24, 34, 35], "truncat": [11, 12, 19, 32], "automat": [11, 12], "interv": [11, 12, 16, 18, 24, 26, 34], "width": [11, 16], "speed": [11, 32], "trial": [11, 15, 26, 32], "run": [11, 26, 32], "rand": 11, "seed": [11, 26], "displai": [11, 26, 29, 31], "progress": [11, 26], "bar": [11, 15, 19, 20, 24, 26], "print": [11, 16, 27, 29, 34], "best_": [11, 32], "best_cost": [11, 32], "base_stock_level_bisection_search": 11, "node_to_optim": 11, "01": 11, "bisect": [11, 21], "search": [11, 13, 16, 21, 24, 32], "usual": [11, 25], "subroutin": 11, "meio_by_coordinate_desc": [11, 32], "absolut": [11, 13, 21], "converg": [11, 21], "initial_solut": 11, "search_lo": [11, 32], "search_hi": [11, 32], "tol": [11, 16, 21], "line_search_tol": 11, "0001": 11, "verbos": [11, 16], "fail": [11, 26], "improv": 11, "line": 11, "golden": [11, 16, 24], "compon": 11, "messag": [11, 13, 16], "truncate_and_discret": 11, "without": [11, 12, 13, 19, 33], "modif": 11, "100": [11, 12, 19, 21, 29, 32, 33, 34], "truncated_discretized_valu": 11, "under": [12, 21, 23, 29, 32, 33, 34], "stochast": [12, 19, 21, 29, 31, 32, 34], "chen": [12, 29, 32, 34], "zheng": [12, 21, 23, 29, 32, 33, 34], "1994": [12, 24, 29, 32, 34, 35], "turn": [12, 32], "clark": [12, 29, 32], "scarf": [12, 29, 32], "1960": [12, 29, 32], "newsvendor_heurist": [12, 32, 34], "shang": [12, 14, 32, 34], "song": [12, 14, 32, 34], "1996": [12, 32], "lower": [12, 13, 15, 16, 19, 23, 32, 34], "multiechelon": [12, 34], "scienc": [12, 21, 23, 34], "40": [12, 15, 20, 21, 23, 29, 32, 33, 34], "11": [12, 32, 34], "1426": [12, 34], "1443": [12, 34], "475": 12, "490": 12, "j": [12, 19, 20, 34], "49": [12, 20, 34], "618": [12, 23, 34], "638": [12, 34], "plot": 12, "x_num": [12, 32], "d_num": [12, 32], "ltd_lower_tail_prob": 12, "167124183311998e": 12, "05": [12, 16], "ltd_upper_tail_prob": 12, "sum_ltd_lower_tail_prob": 12, "sum_ltd_upper_tail_prob": 12, "661338147750939e": 12, "16": [12, 14, 20, 21, 34], "correpond": 12, "here": [12, 14, 15, 32], "account": [12, 15, 19, 34], "cdot": [12, 13, 15, 19, 20, 21, 23, 24], "ndarrai": [12, 13, 19], "arrai": [12, 13, 19, 20, 25, 29, 33], "tail": 12, "upper": [12, 13, 15, 16, 19, 23, 32], "s_star": [12, 29, 32], "c_star": [12, 29, 32], "_0": 12, "_1": 12, "gather": 12, "hat": [12, 18], "h_jx": 12, "_": [12, 19, 29, 33, 34], "g_j": 12, "left": [12, 15, 20, 21, 23, 24, 25], "d_j": 12, "right": [12, 13, 15, 20, 21, 23, 24, 25], "mathrm": 12, "argmin": [12, 13], "min": [12, 13, 15, 19], "s_j": 12, "outsid": [12, 19], "limit": [12, 23], "linear": [12, 34], "13": [12, 15, 16, 34], "lim_": 12, "rightarrow": 12, "infti": [12, 15, 24], "sum_": [12, 15, 18, 21, 23, 24, 25], "h_i": 12, "d_k": 12, "g_": 12, "text": [12, 15, 18, 19, 20, 24], "37": [12, 15, 20, 32, 34], "12": [12, 14, 15, 20, 21, 32, 33, 34], "22": [12, 14, 15, 24, 32, 34], "700237234889784": [12, 32], "012332294949644": [12, 32], "5144388073261155": [12, 32], "47": [12, 32, 34], "668653127136345": [12, 32], "weight": 12, "round_typ": [12, 13], "discuss": [12, 19, 34], "625": 12, "next": [12, 13, 20, 25, 29, 33, 34], "larger": [12, 13, 19], "s_heur": [12, 32, 34], "tild": 12, "32": [12, 14, 15, 18, 34], "texttt": 12, "frac": [12, 15, 18, 20, 21, 23, 24], "634032391786285": [12, 32], "027434723327854": [12, 32], "490880975286938": [12, 32], "expected_cost": [12, 32], "echelon_": 12, "680099140842174": [12, 32], "descript": [12, 14, 29], "docstr": [12, 34], "expected_holding_cost": 12, "basic": [12, 27, 29, 31, 33], "idea": 12, "43": [12, 34], "15945901616041": 12, "throughout": 13, "packag": [13, 29], "min_of_dict": 13, "numer": [13, 14, 15, 24, 32, 35], "min_valu": 13, "minimum": [13, 16, 19], "min_kei": 13, "attain": [13, 18, 20, 24], "typeerror": 13, "dict_match": 13, "d1": 13, "d2": 13, "require_pres": 13, "09": 13, "abs_tol": 13, "treat": [13, 14], "comparison": 13, "second": [13, 15, 21], "0s": 13, "is_iter": 13, "vs": 13, "is_list": 13, "ness": 13, "is_integ": 13, "integr": [13, 15], "is_discrete_distribut": 13, "both": [13, 15, 20, 21, 29, 32, 33, 34, 35], "rv_frozen": 13, "subclass": 13, "http": [13, 15, 16], "stackoverflow": 13, "com": 13, "61530461": 13, "3453768": 13, "Not": 13, "reliabl": 13, "is_continuous_distribut": 13, "find_nearest": 13, "closest": 13, "neither": 13, "execut": [13, 19, 32], "faster": [13, 19, 32], "boolean": 13, "ind": 13, "check_iterable_s": 13, "iterable_list": 13, "size": [13, 34], "ensure_list_for_time_period": 13, "num_period": [13, 19, 25, 26, 27, 29, 34], "var_nam": 13, "suitabl": 13, "0th": [13, 19, 25], "shift": 13, "traceback": 13, "ifi": 13, "error": [13, 26, 34], "desir": [13, 15, 19], "offload": 13, "x_new": 13, "ensure_list_for_nod": 13, "build_node_data_dict": 13, "attribute_dict": 13, "default_valu": 13, "data_dict": 13, "similar": [13, 26, 29], "ensure_dict_for_nod": 13, "simultan": 13, "sever": [13, 32], "form": [13, 32, 33], "len": 13, "know": [13, 34], "99": [13, 34], "sort_dict_by_kei": 13, "ascend": 13, "return_valu": 13, "depend": [13, 19, 24], "special": 13, "come": 13, "return_list": 13, "change_dict_kei": 13, "dict_to_chang": 13, "old_kei": 13, "new_kei": 13, "pair": 13, "keyerror": 13, "undefin": 13, "convolve_mani": 13, "convolv": 13, "dimension": 13, "fast": 13, "fourier": 13, "transform": 13, "fft": 13, "pmf": [13, 15, 20, 23, 33], "x_1": [13, 19], "x_n": 13, "space": [13, 19, 32], "sum_i": 13, "x_i": 13, "adapt": [13, 16], "29236193": 13, "convolut": 13, "let": 13, "x_2": 13, "x_3": 13, "x_4": 13, "327": 13, "342": 13, "182": 13, "052": 13, "007": 13, "word": 13, "irwin_hall_cdf": 13, "irwin": [13, 15, 19, 20, 34], "hall": [13, 21], "wikipedia": [13, 16], "org": [13, 15, 16], "wiki": [13, 16], "e2": 13, "80": [13, 23, 25, 29, 33, 34], "93hall_distribut": 13, "sum_of_continuous_uniforms_distribut": 13, "ident": 13, "sum_of_discrete_uniforms_pmf": 13, "69842911": 13, "sum_of_discrete_uniforms_distribut": 13, "sum_of_discretes_distribut": 13, "round_dict_valu": 13, "the_dict": 13, "save": [14, 16, 27], "taken": 14, "example_3_1": 14, "problem_3_1": 14, "example_3_8": 14, "eoqb": [14, 18, 19, 21, 33], "problem_3_2b": 14, "problem_3_22": 14, "epq": [14, 18, 33], "example_3_9": 14, "wagner": [14, 25, 29, 31], "whitin": [14, 21, 25, 29, 31], "problem_3_27": 14, "problem_3_29": 14, "29": [14, 18, 20, 21], "scmo_ww_hw_c": 14, "scmo": 14, "nonstationari": 14, "purchas": [14, 19, 20, 25, 33], "scmo_jrp_ex": 14, "jrp": [14, 18, 33], "spp_jrp": 14, "428": 14, "silver": [14, 18, 33], "pyke": 14, "peterson": 14, "1998": 14, "scmo_jrp_hw_1": 14, "scmo_jrp_hw_2": 14, "scmo_jrp_hw_3": 14, "silver_jrp": 14, "1976": [14, 18, 33], "example_4_1_network": 14, "example_4_1": 14, "example_4_2": 14, "example_4_2_network": 14, "example_4_3": 14, "problem_4_1": 14, "problem_4_3b": 14, "example_4_4": 14, "example_4_7": 14, "problem_4_7b": 14, "problem_4_8a": 14, "problem_4_8b": 14, "lognorm": [14, 15, 20, 33], "problem_4_31": 14, "example_4_8": 14, "problem_4_32": 14, "problem_4_29": 14, "finit": [14, 19, 29, 31], "horizon": [14, 19, 25, 27, 29, 31], "problem_4_30": 14, "30": [14, 15, 20, 23, 33, 34], "example_5_1": 14, "problem_5_1": 14, "problem_5_2": 14, "problem_5_3": 14, "example_5_8": 14, "example_6_1": [14, 32, 34], "problem_6_1": 14, "problem_6_2a": 14, "problem_6_2a_adj": 14, "review": [14, 21, 23], "problem_6_2b_adj": 14, "problem_6_16": 14, "figure_6_12": 14, "figur": 14, "figure_6_14": 14, "14": [14, 15, 19, 20, 24, 34, 35], "problem_6_7": 14, "example_9_1": 14, "problem_9_8": 14, "example_9_3": 14, "example_9_5": 14, "yield": [14, 24, 29, 31], "uncertainti": [14, 24, 29, 31, 33], "example_9_4": 14, "addit": [14, 24, 35], "problem_9_4a": 14, "problem_9_4b": 14, "example_9_6": 14, "problem_9_5": 14, "assembly_3_stag": 14, "rosling_figure_1": 14, "made": [14, 34], "rong_atan_snyder_figure_1a": 14, "rong": 14, "atan": 14, "2017": 14, "rong_atan_snyder_figure_1b": 14, "rong_atan_snyder_figure_1c": 14, "problem_6_8": 14, "shang_song_1": 14, "tabl": [14, 27, 34], "row": [14, 27, 34], "shang_song_9": 14, "shang_song_17": 14, "17": [14, 15, 20, 21, 34], "shang_song_25": 14, "default_json_filepath": 14, "dataset": 14, "stockpyl_inst": 14, "json": [14, 27], "src": 14, "directori": 14, "instance_nam": [14, 27], "filepath": [14, 27], "initialize_missing_attribut": 14, "ignore_state_var": 14, "debug": [14, 27], "purpos": 14, "save_inst": 14, "instance_data": 14, "instance_descript": 14, "create_if_non": 14, "omit_state_var": 14, "later": [14, 34], "retrev": 14, "jsonpickl": 14, "longer": [14, 29], "descrtipt": 14, "write": [14, 27], "issu": [14, 19, 26, 32], "warn": [14, 19, 26], "part": 14, "todo": 14, "loss": [15, 20, 21, 24, 33], "complementari": [15, 20, 24], "defin": [15, 19, 20, 32], "standard_normal_loss": 15, "z": [15, 19, 23, 24, 34], "mathscr": 15, "l_bar": 15, "23": [15, 24, 34], "phi": [15, 20], "04552796208651397": 15, "345527962086514": 15, "standard_normal_second_loss": 15, "l2": 15, "l2_bar": 15, "28": [15, 21, 24, 34], "frac12": 15, "01880706693657111": 15, "326192933063429": 15, "normal_loss": 15, "sd": [15, 24], "n_bar": 15, "18": [15, 20, 21, 23, 24, 29, 33, 34], "1683073521514889": 15, "7683073521514903": 15, "normal_second_loss": 15, "n2": [15, 32], "n2_bar": 15, "33": [15, 18, 20, 33, 34], "34": [15, 29, 34], "21486028212500707": 15, "765139717874998": 15, "lognormal_loss": 15, "ln": 15, "102": 15, "28364973888106326": 15, "5544912009711833": 15, "exponential_loss": 15, "exponenti": [15, 24], "exp": [15, 20, 33], "457": 15, "foundat": [15, 19, 20, 34], "mcgraw": [15, 19, 20, 34], "hill": [15, 19, 20, 34], "0936537653899085": 15, "09365376538990855": 15, "exponential_second_loss": 15, "19": [15, 34], "var": [15, 24], "20": [15, 18, 19, 21, 29, 32, 33, 34], "46826882694954": 15, "031731173050459915": 15, "gamma_loss": 15, "gamma": [15, 19, 20], "shape": 15, "scale": 15, "pdf": [15, 20], "xf": 15, "respect": [15, 19, 20, 24, 34], "635971381157268": 15, "gamma_second_loss": 15, "280288386513346": 15, "7197116134866537": 15, "uniform_loss": [15, 24], "3333333333333333": 15, "uniform_second_loss": 15, "7777777777777777": 15, "2222222222222222": 15, "continuous_loss": [15, 24], "distrib": 15, "int_x": 15, "dy": [15, 21], "int_": 15, "math": [15, 19, 20, 33, 34, 35], "my_exp": 15, "def": [15, 34], "_pdf": 15, "els": 15, "my_dist": 15, "013533528323661264": 15, "10522318598177341": 15, "Or": [15, 29, 32, 33], "frozen": [15, 24], "built": [15, 32, 34], "expon": 15, "013533528103402742": 15, "11353352830366131": 15, "give": [15, 19, 32, 33], "slightli": 15, "continuous_second_loss": 15, "int_0": 15, "0013533528323661267": 15, "007824431159359786": 15, "001353352589297054": 15, "008646647165633875": 15, "poisson_loss": 15, "poi": 15, "42": [15, 29, 32, 34], "5176095282584724": 15, "5176095282584723": 15, "poisson_second_loss": 15, "848340302917789": 15, "651659697082211": 15, "geometric_loss": 15, "geometr": 15, "geom": [15, 33], "version": [15, 20, 33], "success": 15, "failur": 15, "0485760000000004": 15, "0485760000000006": 15, "geometric_second_loss": 15, "194304000000002": 15, "805695999999998": 15, "negative_binomial_loss": 15, "binomi": 15, "nb": 15, "choos": 15, "doc": 15, "nbinom": 15, "html": 15, "bernoulli": 15, "stop": 15, "447304632028364": 15, "326459980156931": 15, "32645998015693145": 15, "negative_binomial_second_loss": 15, "2r": 15, "877804945158942": 15, "122195054841043": 15, "67": [15, 34], "10108087745232": 15, "8989191225476816": 15, "discrete_loss": [15, 24], "36": [15, 34], "my_geom": 15, "_pmf": 15, "np": [15, 20, 24], "0479999999999743": 15, "048": 15, "discrete_second_loss": 15, "38": [15, 21, 24, 34], "relat": 16, "golden_section_search": 16, "section_search": 16, "reus": 16, "minim": [16, 18, 19, 20], "lambda": [16, 18, 21, 24, 29, 32, 34], "fx": 16, "0000005374905": 16, "888960377059731e": 16, "x_star": 16, "f_star": 16, "variant": [18, 20, 33], "economic_order_quant": [18, 29, 33], "fixed_cost": [18, 19, 21, 23, 24, 25, 29, 33], "demand_r": [18, 24, 29, 33, 35], "sqrt": [18, 21, 23, 24, 34, 35], "2k": [18, 21], "hq": [18, 21, 24], "225": [18, 21, 24, 29, 33, 35], "1300": [18, 21, 24, 29, 33, 35], "304": [18, 21, 29, 33], "0467800264368": [18, 21, 29, 33], "41052550594829": [18, 29, 33], "economic_order_quantity_with_backord": 18, "stockout_fract": 18, "fraction": 18, "hp": [18, 21], "pqx": 18, "310": 18, "81255515896464": 18, "0430622009569378": 18, "66": [18, 19], "92136355097325": 18, "economic_production_quant": 18, "production_r": 18, "rho": 18, "1700": 18, "626": 18, "8084945889684": 18, "183979125298336": 18, "joint_replenishment_problem_silver_heurist": [18, 33], "shared_fixed_cost": [18, 33], "individual_fixed_cost": [18, 33], "joint": [18, 33], "replenish": [18, 33], "share": 18, "k_n": 18, "h_n": 18, "lambda_n": 18, "q_n": 18, "base_cycle_tim": 18, "order_multipl": 18, "m_n": 18, "m_": 18, "h_": 18, "lambda_": 18, "k_": 18, "h_nm_n": 18, "tm_n": 18, "600": [18, 33], "120": [18, 25, 29, 33], "840": [18, 33], "300": [18, 21, 33], "160": [18, 33], "103164454170876": [18, 33], "309493362512628": [18, 33], "837": [18, 33], "8544026261366": [18, 33], "finite_horizon_dp": [19, 29, 33], "terminal_holding_cost": 19, "terminal_stockout_cost": 19, "demand_sd": [19, 20, 21, 23, 29, 33], "discount_factor": [19, 20], "trunc_tol": 19, "02": [19, 34], "d_spread": 19, "s_spread": 19, "discount": [19, 20], "_t": [19, 20], "action": 19, "matric": 19, "entir": [19, 25], "cost_matrix": 19, "total_cost": [19, 29, 34], "x_rang": 19, "theta_t": [19, 25], "column": [19, 27, 34], "oul_matrix": 19, "theta_": [19, 25], "h_t": [19, 20], "p_t": [19, 20], "former": [19, 25], "mix": [19, 25], "scalar": [19, 25], "_5": 19, "done": 19, "like": [19, 29, 32], "suboptim": 19, "detail": [19, 34], "straightforward": 19, "87": [19, 21, 33, 34], "recalcul": 19, "don": 19, "computation": 19, "expens": 19, "factor": [19, 20], "d_rang": 19, "s_t": 19, "x_": 19, "estim": 19, "theta_1": 19, "matrix": 19, "il_t": 19, "act": 19, "thereaft": 19, "vector": 19, "min_": [19, 25], "ge": [19, 20, 24], "delta": 19, "mathbb": 19, "_d": 19, "pm": [19, 26, 34], "conserv": 19, "variat": 19, "across": [19, 26], "q_": 19, "buffer": 19, "final": [19, 34], "further": 19, "fall": 19, "suggest": 19, "uppper": 19, "too": 19, "doubl": 19, "could": 19, "bring": 19, "reason": 19, "bump": 19, "against": 19, "user": 19, "wish": [19, 32], "try": 19, "again": [19, 34], "110": [19, 29, 33], "111": [19, 29, 33], "133": [19, 29, 33], "126": [19, 21, 29, 33], "1558": 19, "6946467384012": 19, "myopic_bound": 19, "myopic": [19, 20], "denot": [19, 20, 34], "analog": 19, "s_underbar": 19, "s_5": 19, "s_overbar": 19, "invalid": 19, "g_t": [19, 20], "gamma_tk_": 19, "le": [19, 20, 25], "k_t": 19, "g_i": [19, 20], "veinott": [19, 20], "1966": [19, 20], "fourth": 19, "jr": [19, 20], "condit": [19, 20, 25], "proof": [19, 20], "siam": [19, 20], "appl": [19, 20], "1067": [19, 20], "1083": [19, 20], "36782387894158": 19, "191": 19, "66022942788436": 19, "26036848597217": 19, "newsvendor_norm": [20, 29, 33], "z_": [20, 21, 26, 34], "pn": [20, 21], "70": [20, 23, 25, 29, 33, 34], "56": [20, 29, 33], "60395592743389": [20, 29, 33], "9976051931766445": [20, 29, 33], "newsvendor_normal_cost": [20, 33], "156131552870387": 20, "newsvendor_poisson": [20, 33], "797235211809178": [20, 33], "newsvendor_poisson_cost": 20, "newsvendor_continu": [20, 33], "demand_distrib": [20, 33], "demand_pdf": [20, 23], "norm": [20, 34], "997605188935892": 20, "35613154776623": 20, "1765": 20, "295": 20, "6266448071368": 20, "44254351324322": 20, "newsvendor_discret": [20, 33], "demand_pmf": [20, 23, 33], "5701069457709416": 20, "590296024616343": 20, "d_val": [20, 33], "zip": [20, 33], "570106945770941": 20, "purchase_cost_next_p": 20, "c_": 20, "c_t": [20, 25], "c_ty": 20, "gamma_tc_": 20, "d_t": 20, "98": 20, "58": 20, "09891883213067": 20, "682411764618777": 20, "62": [20, 32, 34], "850319828088736": 20, "myopic_cost": 20, "726131552870388": 20, "set_myopic_cost_to": 20, "left_half": 20, "distrbut": 20, "394684658734164": 20, "999999999999996": 20, "71": [20, 23, 34], "84861989932769": 20, "newsvendor_normal_explicit": [20, 33], "selling_revenu": [20, 33], "salvage_valu": [20, 33], "profit": [20, 33], "maxim": [20, 33], "sold": 20, "unsold": 20, "v": 20, "bui": 20, "sell": [20, 33], "salvag": [20, 33], "pi": 20, "002394806823354": [20, 33], "r_q_cost": [21, 33], "exact": [21, 23, 32, 33, 34], "tau": 21, "int_r": 21, "328": [21, 33], "150": [21, 25, 29, 33], "78": [21, 33], "07116250928294": 21, "r_q_optimal_r_for_q": 21, "06": [21, 24, 35], "129": [21, 24], "4272799263067": 21, "r_q_eil_approxim": [21, 33], "eil": [21, 33], "oldest": 21, "wide": 21, "known": 21, "date": 21, "back": 21, "1953": [21, 33], "hadlei": [21, 33], "1963": [21, 33], "previou": 21, "epsilon": 21, "qh": 21, "princeton": 21, "univers": 21, "press": 21, "nj": 21, "analysi": 21, "prentic": 21, "englewood": 21, "cliff": 21, "213": [21, 33], "97044213580244": [21, 33], "318": [21, 33], "5901810768729": [21, 33], "95": [21, 34], "45114022285196": 21, "r_q_eoqb_approxim": [21, 33], "1992": [21, 33], "thorough": 21, "explor": 21, "128": [21, 33], "63781442427097": [21, 33], "308": [21, 33], "5737801203754": [21, 33], "r_q_eoqss_approxim": [21, 33], "21": [21, 34], "190": [21, 33], "3369965715624": [21, 33], "r_q_loss_function_approxim": [21, 33], "8670634479628": [21, 33], "4491421980451": [21, 33], "r_q_cost_poisson": 21, "48": [21, 32, 34], "107": [21, 24, 33, 34], "92358063314975": [21, 33], "r_q_poisson_exact": [21, 33], "federgruen": [21, 23, 33], "effici": 21, "comput": [21, 23], "research": [21, 23, 24], "808": 21, "813": 21, "s_s_cost_discret": 23, "use_poisson": [23, 33], "demand_hi": 23, "introduc": 23, "provi": 23, "75": [23, 24, 35], "simpl": 23, "39": [23, 25], "654": 23, "665": 23, "034111561471642": [23, 33], "s_s_discrete_exact": [23, 33], "s_s_power_approxim": [23, 33], "power": [23, 33], "ehrhardt": [23, 33], "mosier": [23, 33], "1984": [23, 33], "revis": 23, "622": 23, "77": 23, "494": 23, "506": 23, "sigma_l": 23, "116": 23, "973": 23, "mu_l": 23, "183": 23, "063": 23, "192z": 23, "eq": 23, "ss_power_approx3": 23, "2_l": 23, "2l": 23, "19461695647407": [23, 33], "74": [23, 33, 34], "29017010980579": [23, 33], "eoq_with_disrupt": [24, 35], "disruption_r": [24, 35], "recovery_r": [24, 35], "eoqd": [24, 35], "parlar": [24, 35], "berkin": [24, 35], "berk": [24, 35], "arreola": [24, 35], "risa": [24, 35], "2014": [24, 35], "2d": 24, "pd": 24, "psi": 24, "2h": 24, "kd": 24, "2p": 24, "dh": 24, "futur": 24, "naval": 24, "logist": 24, "121": 24, "132": 24, "tight": 24, "continuousreview": 24, "155": 24, "91": 24, "108": 24, "772": [24, 35], "8110739983106": [24, 35], "173": [24, 35], "95000257319708": [24, 35], "773": [24, 35], "1432417118889": [24, 35], "957229385175": [24, 35], "eoq_with_disruptions_cost": 24, "700": 24, "174": 24, "78711738886236": 24, "80614234644133": 24, "newsvendor_with_disrupt": [24, 35], "lemma": 24, "df": 24, "pi_n": 24, "pi_0": 24, "quad": 24, "04": [24, 34, 35], "8000": [24, 34], "2737": 24, "0689302470355": 24, "1200": 24, "5710": 24, "344790717086": 24, "eoq_with_additive_yield_uncertainti": [24, 35], "yield_mean": [24, 35], "yield_sd": [24, 35], "2kd": 24, "18500": [24, 35], "75000": [24, 35], "15000": [24, 35], "9000": [24, 35], "230246": [24, 35], "37046881882": [24, 35], "12914": [24, 35], "78222812913": [24, 35], "300000": 24, "13426": 24, "947368421053": 24, "eoq_with_multiplicative_yield_uncertainti": [24, 35], "qe": 24, "2e": 24, "8333": [24, 35], "0198": [24, 35], "254477": [24, 35], "46130342316": [24, 35], "13086": [24, 35], "16169098594": [24, 35], "13263": 24, "770562822512": 24, "newsvendor_with_additive_yield_uncertainti": [24, 35], "yield_distribut": [24, 35], "f_y": 24, "hn": 24, "5e6": 24, "500000": [24, 35], "1000000": [24, 35], "1833333": [24, 35], "3333333335": [24, 35], "6249999": [24, 35], "997499999": [24, 35], "6250000": 24, "000000001": 24, "costs_to_go": 25, "go": [25, 29, 33], "theta": [25, 29, 33], "next_order_period": 25, "d_i": 25, "500": [25, 29, 33], "90": [25, 29, 33], "210": [25, 29, 33], "1380": [25, 29, 33], "940": [25, 29, 33], "640": [25, 29, 33], "rand_se": [26, 29, 34], "consistency_check": 26, "what": [26, 29], "No": 26, "w": 26, "dump": 26, "wf": 26, "ef": 26, "run_multiple_tri": [26, 34], "num_trial": [26, 34], "sem": [26, 34], "averag": [26, 29, 34], "confid": [26, 34], "mean_cost": [26, 34], "sem_cost": [26, 34], "main": 27, "write_result": [27, 34], "stdout": 27, "csv": [27, 34], "request": 27, "format": [27, 34], "disr": [27, 34], "io": [27, 34], "iopl": [27, 34], "pipelin": [27, 34], "succesor": [27, 34], "oq": [27, 34], "oo": [27, 34], "IS": [27, 34], "ispl": [27, 34], "idi": [27, 34], "rm": [27, 34], "os": [27, 34], "dmf": [27, 34], "fr": [27, 34], "bo": [27, 34], "ow": [27, 34], "odi": [27, 34], "hc": [27, 34], "sc": [27, 34], "ithc": [27, 34], "rev": [27, 34], "tc": [27, 34], "ext": [27, 34], "periods_to_print": [27, 34], "columns_to_print": [27, 34], "print_cost_summari": [27, 34], "write_csv": 27, "csv_filenam": 27, "consol": [27, 34], "middl": 27, "skip": 27, "abbrevi": 27, "altern": [27, 32, 34, 35], "shortcut": [27, 34], "unrecogn": 27, "filenam": 27, "write_instance_and_st": 27, "histori": 27, "mostli": [27, 34], "python": [29, 32], "classic": 29, "assumpt": 29, "textbook": 29, "wilei": [], "ed": [], "much": 32, "older": [], "shorter": 29, "articl": 29, "And": [29, 32, 34], "h_termin": [29, 33], "p_termin": [29, 33], "precis": 29, "rework": 29, "44": 29, "1689463285519": 29, "93248526934437": 29, "69602421013684": 29, "227": 29, "15328525645054": 29, "extens": 29, "featur": [29, 31], "theoret": 29, "predict": [29, 34], "s_star_loc": 29, "226": 29, "16794575837224": 29, "acycl": 29, "instal": 29, "sequenc": [29, 31], "event": [29, 31], "advanc": [29, 31], "api": [29, 34], "pypi": 30, "pip": 30, "tutorial_meio": 32, "my_nod": 32, "my_other_nod": 32, "other_nod": 32, "now": [32, 34], "access": 32, "member": 32, "n1": 32, "quickli": 32, "certain": [32, 34], "serial_3": 32, "There": 32, "inform": [32, 34], "example_6_1_network": 32, "example_6_3_network": 32, "snippet": 32, "example_6_5_network": 32, "candid": 32, "obvious": 32, "slower": 32, "control": [32, 34], "veri": [32, 34], "coars": 32, "small": 32, "994095842987605": 32, "good": [32, 34], "wors": [32, 34], "although": 32, "stack": 32, "deck": 32, "pretti": [32, 34], "narrow": 32, "fairer": 32, "experi": 32, "would": [32, 34], "broader": 32, "accuraci": 32, "still": [32, 34], "trivial": 32, "produc": [32, 34], "inaccur": 32, "obj_fcn": 32, "21449789525488": 32, "principl": 32, "global": 32, "jointli": 32, "convex": 32, "762": 32, "5135882931757045": 32, "758375187638261": 32, "0631099655841": 32, "90365729191992": 32, "892036436905893": 32, "995771265226075": 32, "99995914365099": 32, "33491040676202": 32, "want": 33, "53": 33, "223748044859164": 33, "overag": 33, "underag": 33, "519": 33, "3023987673176": 33, "198": 33, "42277610622506": 33, "194304": 33, "19102133030678": 33, "r_eil": 33, "q_eil": 33, "r_eoqb": 33, "q_eoqb": 33, "r_eoqss": 33, "q_eoqss": 33, "r_lf": 33, "q_lf": 33, "92": 33, "28687665608078": 33, "20243187688158": 33, "04837003438256": 33, "07114627035178": 33, "vari": 33, "270": 33, "1020": 33, "varieti": 34, "your": 34, "own": 34, "variou": 34, "implic": 34, "interpret": 34, "send": 34, "At": 34, "occur": 34, "header": 34, "o_i": 34, "earlier": 34, "sent": 34, "s_i": 34, "ago": 34, "soe": 34, "somewhat": 34, "atyp": 34, "common": 34, "step": 34, "swap": 34, "howev": 34, "hyperlink": 34, "Then": 34, "move": 34, "commonli": 34, "aris": 34, "paper": 34, "bullwhip": 34, "ref": 34, "never": 34, "out": 34, "larg": 34, "soon": 34, "revers": 34, "flexibl": 34, "sens": 34, "equivalentlli": 34, "57": 34, "9906261152138731": 34, "close": 34, "0000": 34, "264": 34, "475292852532866": 34, "exogen": 34, "creation": 34, "relev": 34, "manual": 34, "someth": 34, "suffici": 34, "26": 34, "face": 34, "serv": 34, "shown": 34, "Its": 34, "began": 34, "show": 34, "insuffici": 34, "reflect": 34, "were": 34, "worth": 34, "finish": 34, "remain": 34, "7692307692307693": 34, "8695652173913043": 34, "90625": 34, "9555555555555556": 34, "9210526315789473": 34, "9152542372881356": 34, "9183673469387755": 34, "9264705882352942": 34, "9166666666666666": 34, "9342105263157895": 34, "9285714285714286": 34, "9411764705882353": 34, "8823529411764706": 34, "9803921568627451": 34, "9484536082474226": 34, "51": 34, "8333333333333334": 34, "85": 34, "9519230769230769": 34, "55": 34, "8050847457627118": 34, "download": 34, "10000": 34, "2831": 34, "four": 34, "104": 34, "79": 34, "awar": 34, "upcom": 34, "categori": 34, "evid": 34, "increas": 34, "clear": 34, "65": 34, "82": 34, "prevent": 34, "often": 34, "kept": 34, "sytem": 34, "report": 34, "259837154163556": 34, "As": 34, "equiv": 34, "1421": 34, "statist": 34, "s_opt": 34, "s_opt_loc": 34, "mean_opt": 34, "sem_opt": 34, "78528000921442": 34, "26119040852187103": 34, "s_heur_loc": 34, "mean_heur": 34, "sem_heur": 34, "789138050714946": 34, "27039814681794694": 34, "ppf": 34, "lo_opt": 34, "hi_opt": 34, "lo_heur": 34, "hi_heur": 34, "ci": 34, "27335621540425": 34, "29720380302459": 34, "2591674214654": 34, "31910867996449": 34, "overlap": 34, "sai": 34, "Of": 34, "cours": 34, "randomli": 35, "74000": 35, "25317": 35, "887604785075": 35, "1500000": 35, "250000": 35, "200000": 35, "1443484": 35, "3132203403": 35, "4497316": 35, "9310527835": 35}, "objects": {"stockpyl": [[2, 0, 0, "-", "demand_source"], [3, 0, 0, "-", "disruption_process"], [18, 0, 0, "-", "eoq"], [19, 0, 0, "-", "finite_horizon"], [7, 0, 0, "-", "gsm_helpers"], [8, 0, 0, "-", "gsm_serial"], [9, 0, 0, "-", "gsm_tree"], [13, 0, 0, "-", "helpers"], [14, 0, 0, "-", "instances"], [15, 0, 0, "-", "loss_functions"], [11, 0, 0, "-", "meio_general"], [20, 0, 0, "-", "newsvendor"], [16, 0, 0, "-", "optimization"], [4, 0, 0, "-", "policy"], [21, 0, 0, "-", "rq"], [26, 0, 0, "-", "sim"], [27, 0, 0, "-", "sim_io"], [23, 0, 0, "-", "ss"], [12, 0, 0, "-", "ssm_serial"], [5, 0, 0, "-", "supply_chain_network"], [6, 0, 0, "-", "supply_chain_node"], [24, 0, 0, "-", "supply_uncertainty"], [25, 0, 0, "-", "wagner_whitin"]], "stockpyl.demand_source": [[2, 1, 1, "", "DemandSource"]], "stockpyl.demand_source.DemandSource": [[2, 2, 1, "", "cdf"], [2, 3, 1, "", "demand_distribution"], [2, 4, 1, "", "demand_list"], [2, 2, 1, "", "generate_demand"], [2, 4, 1, "", "hi"], [2, 2, 1, "", "initialize"], [2, 2, 1, "", "lead_time_demand_distribution"], [2, 4, 1, "", "lo"], [2, 4, 1, "", "mean"], [2, 4, 1, "", "probabilities"], [2, 4, 1, "", "round_to_int"], [2, 4, 1, "", "standard_deviation"], [2, 4, 1, "", "type"], [2, 2, 1, "", "validate_parameters"]], "stockpyl.disruption_process": [[3, 1, 1, "", "DisruptionProcess"]], "stockpyl.disruption_process.DisruptionProcess": [[3, 4, 1, "", "disrupted"], [3, 4, 1, "", "disruption_probability"], [3, 4, 1, "", "disruption_state_list"], [3, 4, 1, "", "disruption_type"], [3, 2, 1, "", "initialize"], [3, 4, 1, "", "random_process_type"], [3, 4, 1, "", "recovery_probability"], [3, 2, 1, "", "steady_state_probabilities"], [3, 2, 1, "", "update_disruption_state"], [3, 2, 1, "", "validate_parameters"]], "stockpyl.eoq": [[18, 5, 1, "", "economic_order_quantity"], [18, 5, 1, "", "economic_order_quantity_with_backorders"], [18, 5, 1, "", "economic_production_quantity"], [18, 5, 1, "", "joint_replenishment_problem_silver_heuristic"]], "stockpyl.finite_horizon": [[19, 5, 1, "", "finite_horizon_dp"], [19, 5, 1, "", "myopic_bounds"]], "stockpyl.gsm_helpers": [[7, 5, 1, "", "cst_to_base_stock_levels"], [7, 5, 1, "", "inbound_cst"], [7, 5, 1, "", "net_lead_time"], [7, 5, 1, "", "safety_stock_levels"], [7, 5, 1, "", "solution_cost_from_base_stock_levels"], [7, 5, 1, "", "solution_cost_from_cst"]], "stockpyl.gsm_serial": [[8, 5, 1, "", "optimize_committed_service_times"]], "stockpyl.gsm_tree": [[9, 5, 1, "", "gsm_to_ssm"], [9, 5, 1, "", "is_correctly_labeled"], [9, 5, 1, "", "optimize_committed_service_times"], [9, 5, 1, "", "preprocess_tree"], [9, 5, 1, "", "relabel_nodes"]], "stockpyl.helpers": [[13, 5, 1, "", "build_node_data_dict"], [13, 5, 1, "", "change_dict_key"], [13, 5, 1, "", "check_iterable_sizes"], [13, 5, 1, "", "convolve_many"], [13, 5, 1, "", "dict_match"], [13, 5, 1, "", "ensure_dict_for_nodes"], [13, 5, 1, "", "ensure_list_for_nodes"], [13, 5, 1, "", "ensure_list_for_time_periods"], [13, 5, 1, "", "find_nearest"], [13, 5, 1, "", "irwin_hall_cdf"], [13, 5, 1, "", "is_continuous_distribution"], [13, 5, 1, "", "is_discrete_distribution"], [13, 5, 1, "", "is_integer"], [13, 5, 1, "", "is_iterable"], [13, 5, 1, "", "is_list"], [13, 5, 1, "", "min_of_dict"], [13, 5, 1, "", "round_dict_values"], [13, 5, 1, "", "sort_dict_by_keys"], [13, 5, 1, "", "sum_of_continuous_uniforms_distribution"], [13, 5, 1, "", "sum_of_discrete_uniforms_distribution"], [13, 5, 1, "", "sum_of_discrete_uniforms_pmf"], [13, 5, 1, "", "sum_of_discretes_distribution"]], "stockpyl.instances": [[14, 6, 1, "", "DEFAULT_JSON_FILEPATH"], [14, 5, 1, "", "load_instance"], [14, 5, 1, "", "save_instance"]], "stockpyl.loss_functions": [[15, 5, 1, "", "continuous_loss"], [15, 5, 1, "", "continuous_second_loss"], [15, 5, 1, "", "discrete_loss"], [15, 5, 1, "", "discrete_second_loss"], [15, 5, 1, "", "exponential_loss"], [15, 5, 1, "", "exponential_second_loss"], [15, 5, 1, "", "gamma_loss"], [15, 5, 1, "", "gamma_second_loss"], [15, 5, 1, "", "geometric_loss"], [15, 5, 1, "", "geometric_second_loss"], [15, 5, 1, "", "lognormal_loss"], [15, 5, 1, "", "negative_binomial_loss"], [15, 5, 1, "", "negative_binomial_second_loss"], [15, 5, 1, "", "normal_loss"], [15, 5, 1, "", "normal_second_loss"], [15, 5, 1, "", "poisson_loss"], [15, 5, 1, "", "poisson_second_loss"], [15, 5, 1, "", "standard_normal_loss"], [15, 5, 1, "", "standard_normal_second_loss"], [15, 5, 1, "", "uniform_loss"], [15, 5, 1, "", "uniform_second_loss"]], "stockpyl.meio_general": [[11, 5, 1, "", "base_stock_level_bisection_search"], [11, 5, 1, "", "meio_by_coordinate_descent"], [11, 5, 1, "", "meio_by_enumeration"], [11, 5, 1, "", "truncate_and_discretize"]], "stockpyl.newsvendor": [[20, 5, 1, "", "myopic"], [20, 5, 1, "", "myopic_cost"], [20, 5, 1, "", "newsvendor_continuous"], [20, 5, 1, "", "newsvendor_discrete"], [20, 5, 1, "", "newsvendor_normal"], [20, 5, 1, "", "newsvendor_normal_cost"], [20, 5, 1, "", "newsvendor_normal_explicit"], [20, 5, 1, "", "newsvendor_poisson"], [20, 5, 1, "", "newsvendor_poisson_cost"], [20, 5, 1, "", "set_myopic_cost_to"]], "stockpyl.optimization": [[16, 5, 1, "", "golden_section_search"]], "stockpyl.policy": [[4, 1, 1, "", "Policy"]], "stockpyl.policy.Policy": [[4, 4, 1, "", "base_stock_level"], [4, 2, 1, "", "get_order_quantity"], [4, 2, 1, "", "initialize"], [4, 4, 1, "", "node"], [4, 4, 1, "", "order_quantity"], [4, 4, 1, "", "order_up_to_level"], [4, 4, 1, "", "reorder_point"], [4, 4, 1, "", "type"], [4, 2, 1, "", "validate_parameters"]], "stockpyl.rq": [[21, 5, 1, "", "r_q_cost"], [21, 5, 1, "", "r_q_cost_poisson"], [21, 5, 1, "", "r_q_eil_approximation"], [21, 5, 1, "", "r_q_eoqb_approximation"], [21, 5, 1, "", "r_q_eoqss_approximation"], [21, 5, 1, "", "r_q_loss_function_approximation"], [21, 5, 1, "", "r_q_optimal_r_for_q"], [21, 5, 1, "", "r_q_poisson_exact"]], "stockpyl.sim": [[26, 5, 1, "", "run_multiple_trials"], [26, 5, 1, "", "simulation"]], "stockpyl.sim_io": [[27, 5, 1, "", "write_instance_and_states"], [27, 5, 1, "", "write_results"]], "stockpyl.ss": [[23, 5, 1, "", "s_s_cost_discrete"], [23, 5, 1, "", "s_s_discrete_exact"], [23, 5, 1, "", "s_s_power_approximation"]], "stockpyl.ssm_serial": [[12, 5, 1, "", "expected_cost"], [12, 5, 1, "", "expected_holding_cost"], [12, 5, 1, "", "newsvendor_heuristic"], [12, 5, 1, "", "optimize_base_stock_levels"]], "stockpyl.supply_chain_network": [[5, 1, 1, "", "SupplyChainNetwork"], [5, 5, 1, "", "echelon_to_local_base_stock_levels"], [5, 5, 1, "", "local_to_echelon_base_stock_levels"], [5, 5, 1, "", "mwor_system"], [5, 5, 1, "", "network_from_edges"], [5, 5, 1, "", "owmr_system"], [5, 5, 1, "", "serial_system"], [5, 5, 1, "", "single_stage_system"]], "stockpyl.supply_chain_network.SupplyChainNetwork": [[5, 2, 1, "", "add_edge"], [5, 2, 1, "", "add_edges_from_list"], [5, 2, 1, "", "add_node"], [5, 2, 1, "", "add_predecessor"], [5, 2, 1, "", "add_successor"], [5, 2, 1, "", "deep_equal_to"], [5, 3, 1, "", "edges"], [5, 2, 1, "", "get_node_from_index"], [5, 2, 1, "", "has_directed_cycle"], [5, 2, 1, "", "initialize"], [5, 4, 1, "", "max_max_replenishment_time"], [5, 2, 1, "", "networkx_digraph"], [5, 3, 1, "", "node_indices"], [5, 3, 1, "", "nodes"], [5, 4, 1, "", "period"], [5, 4, 1, "", "problem_specific_data"], [5, 2, 1, "", "reindex_nodes"], [5, 2, 1, "", "remove_node"], [5, 3, 1, "", "sink_nodes"], [5, 3, 1, "", "source_nodes"]], "stockpyl.supply_chain_node": [[6, 1, 1, "", "NodeStateVars"], [6, 1, 1, "", "SupplyChainNode"]], "stockpyl.supply_chain_node.NodeStateVars": [[6, 3, 1, "", "backorders"], [6, 4, 1, "", "backorders_by_successor"], [6, 4, 1, "", "demand_cumul"], [6, 4, 1, "", "demand_met_from_stock"], [6, 4, 1, "", "demand_met_from_stock_cumul"], [6, 4, 1, "", "disrupted"], [6, 3, 1, "", "echelon_inventory_level"], [6, 2, 1, "", "echelon_inventory_position"], [6, 3, 1, "", "echelon_on_hand_inventory"], [6, 4, 1, "", "fill_rate"], [6, 4, 1, "", "holding_cost_incurred"], [6, 3, 1, "", "in_transit"], [6, 2, 1, "", "in_transit_from"], [6, 4, 1, "", "in_transit_holding_cost_incurred"], [6, 2, 1, "", "in_transit_to"], [6, 4, 1, "", "inbound_disrupted_items"], [6, 3, 1, "", "inbound_disrupted_items_aggregate"], [6, 4, 1, "", "inbound_order"], [6, 4, 1, "", "inbound_order_pipeline"], [6, 4, 1, "", "inbound_shipment"], [6, 4, 1, "", "inbound_shipment_pipeline"], [6, 4, 1, "", "inventory_level"], [6, 2, 1, "", "inventory_position"], [6, 4, 1, "", "node"], [6, 3, 1, "", "on_hand"], [6, 3, 1, "", "on_order"], [6, 4, 1, "", "on_order_by_predecessor"], [6, 4, 1, "", "order_quantity"], [6, 4, 1, "", "outbound_disrupted_items"], [6, 4, 1, "", "outbound_shipment"], [6, 4, 1, "", "period"], [6, 3, 1, "", "raw_material_aggregate"], [6, 4, 1, "", "raw_material_inventory"], [6, 2, 1, "", "reindex_state_variables"], [6, 4, 1, "", "revenue_earned"], [6, 4, 1, "", "stockout_cost_incurred"], [6, 4, 1, "", "total_cost_incurred"]], "stockpyl.supply_chain_node.SupplyChainNode": [[6, 2, 1, "", "add_predecessor"], [6, 2, 1, "", "add_successor"], [6, 3, 1, "", "ancestors"], [6, 2, 1, "", "deep_equal_to"], [6, 4, 1, "", "demand_source"], [6, 3, 1, "", "derived_demand_mean"], [6, 3, 1, "", "derived_demand_standard_deviation"], [6, 3, 1, "", "descendants"], [6, 3, 1, "", "disrupted"], [6, 4, 1, "", "disruption_process"], [6, 4, 1, "", "echelon_holding_cost"], [6, 3, 1, "", "equivalent_lead_time"], [6, 3, 1, "", "forward_echelon_lead_time"], [6, 2, 1, "", "get_one_predecessor"], [6, 2, 1, "", "get_one_successor"], [6, 3, 1, "", "holding_cost"], [6, 4, 1, "", "in_transit_holding_cost"], [6, 4, 1, "", "initial_inventory_level"], [6, 4, 1, "", "initial_orders"], [6, 2, 1, "", "initialize"], [6, 4, 1, "", "inventory_policy"], [6, 4, 1, "", "lead_time"], [6, 4, 1, "", "local_holding_cost"], [6, 4, 1, "", "local_holding_cost_function"], [6, 3, 1, "", "neighbor_indices"], [6, 3, 1, "", "neighbors"], [6, 4, 1, "", "network"], [6, 4, 1, "", "order_lead_time"], [6, 2, 1, "", "predecessor_indices"], [6, 2, 1, "", "predecessors"], [6, 4, 1, "", "problem_specific_data"], [6, 4, 1, "", "purchase_cost"], [6, 2, 1, "", "reindex_all_state_variables"], [6, 2, 1, "", "remove_predecessor"], [6, 2, 1, "", "remove_successor"], [6, 4, 1, "", "revenue"], [6, 4, 1, "", "shipment_lead_time"], [6, 4, 1, "", "state_vars"], [6, 3, 1, "", "state_vars_current"], [6, 4, 1, "", "stockout_cost"], [6, 4, 1, "", "stockout_cost_function"], [6, 2, 1, "", "successor_indices"], [6, 2, 1, "", "successors"], [6, 4, 1, "", "supply_type"]], "stockpyl.supply_uncertainty": [[24, 5, 1, "", "eoq_with_additive_yield_uncertainty"], [24, 5, 1, "", "eoq_with_disruptions"], [24, 5, 1, "", "eoq_with_disruptions_cost"], [24, 5, 1, "", "eoq_with_multiplicative_yield_uncertainty"], [24, 5, 1, "", "newsvendor_with_additive_yield_uncertainty"], [24, 5, 1, "", "newsvendor_with_disruptions"]], "stockpyl.wagner_whitin": [[25, 5, 1, "", "wagner_whitin"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:property", "4": "py:attribute", "5": "py:function", "6": "py:data"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "property", "Python property"], "4": ["py", "attribute", "Python attribute"], "5": ["py", "function", "Python function"], "6": ["py", "data", "Python data"]}, "titleterms": {"api": [0, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27], "document": [0, 29], "content": [0, 1, 10, 17, 22, 28, 29, 32, 33, 34, 35], "data": [1, 34], "type": 1, "demand_sourc": 2, "modul": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27], "overview": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27], "refer": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 34], "disruption_process": 3, "polici": [4, 34], "supply_chain_network": 5, "supply_chain_nod": 6, "gsm_helper": 7, "see": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "also": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "gsm_serial": 8, "gsm_tree": 9, "multi": [10, 32], "echelon": [10, 22, 32, 33], "inventori": [10, 22, 32, 33, 34], "optim": [10, 16, 22, 32, 33], "meio_gener": 11, "ssm_serial": 12, "helper": 13, "instanc": 14, "built": 14, "In": 14, "loss_funct": 15, "other": 17, "eoq": [18, 33, 35], "finite_horizon": 19, "newsvendor": [20, 33, 35], "rq": 21, "singl": [22, 33], "ss": 23, "supply_uncertainti": 24, "wagner_whitin": 25, "sim": 26, "sim_io": 27, "simul": [28, 34], "stockpyl": [29, 30, 31], "some": 29, "exampl": [29, 34], "indic": 29, "tabl": 29, "instal": 30, "tutori": 31, "The": [32, 33, 35], "supplychainnetwork": 32, "class": 32, "serial": 32, "ssm": 32, "system": 32, "tree": 32, "gsm": 32, "gener": 32, "meio": 32, "problem": [33, 35], "r": 33, "q": 33, "s": 33, "wagner": 33, "whitin": 33, "finit": 33, "horizon": 33, "stochast": 33, "basic": 34, "structur": 34, "sequenc": 34, "event": 34, "lead": 34, "time": 34, "suppli": [34, 35], "demand": 34, "extern": 34, "custom": 34, "supplier": 34, "displai": 34, "result": 34, "advanc": 34, "featur": 34, "disrupt": [34, 35], "convert": 34, "from": 34, "continu": 34, "review": 34, "hold": 34, "stockout": 34, "cost": 34, "function": 34, "run": 34, "multipl": 34, "trial": 34, "uncertainti": 35, "yield": 35}, "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": 56}})
\ No newline at end of file
+Search.setIndex({"docnames": ["api/api", "api/datatypes/datatypes", "api/datatypes/demand_source", "api/datatypes/disruption_process", "api/datatypes/policy", "api/datatypes/supply_chain_network", "api/datatypes/supply_chain_node", "api/meio/gsm_helpers", "api/meio/gsm_serial", "api/meio/gsm_tree", "api/meio/meio", "api/meio/meio_general", "api/meio/ssm_serial", "api/other/helpers", "api/other/instances", "api/other/loss_functions", "api/other/optimization", "api/other/other", "api/seio/eoq", "api/seio/finite_horizon", "api/seio/newsvendor", "api/seio/rq", "api/seio/seio", "api/seio/ss", "api/seio/supply_uncertainty", "api/seio/wagner_whitin", "api/simulation/sim", "api/simulation/sim_io", "api/simulation/simulation", "index", "install", "tutorial/tutorial", "tutorial/tutorial_meio", "tutorial/tutorial_seio", "tutorial/tutorial_sim", "tutorial/tutorial_su"], "filenames": ["api/api.rst", "api/datatypes/datatypes.rst", "api/datatypes/demand_source.rst", "api/datatypes/disruption_process.rst", "api/datatypes/policy.rst", "api/datatypes/supply_chain_network.rst", "api/datatypes/supply_chain_node.rst", "api/meio/gsm_helpers.rst", "api/meio/gsm_serial.rst", "api/meio/gsm_tree.rst", "api/meio/meio.rst", "api/meio/meio_general.rst", "api/meio/ssm_serial.rst", "api/other/helpers.rst", "api/other/instances.rst", "api/other/loss_functions.rst", "api/other/optimization.rst", "api/other/other.rst", "api/seio/eoq.rst", "api/seio/finite_horizon.rst", "api/seio/newsvendor.rst", "api/seio/rq.rst", "api/seio/seio.rst", "api/seio/ss.rst", "api/seio/supply_uncertainty.rst", "api/seio/wagner_whitin.rst", "api/simulation/sim.rst", "api/simulation/sim_io.rst", "api/simulation/simulation.rst", "index.rst", "install.rst", "tutorial/tutorial.rst", "tutorial/tutorial_meio.rst", "tutorial/tutorial_seio.rst", "tutorial/tutorial_sim.rst", "tutorial/tutorial_su.rst"], "titles": ["API Documentation", "Data Types", "<code class=\"docutils literal notranslate\"><span class=\"pre\">demand_source</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">disruption_process</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">policy</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_chain_network</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_chain_node</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_helpers</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_serial</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">gsm_tree</span></code> Module", "Multi-Echelon Inventory Optimization", "<code class=\"docutils literal notranslate\"><span class=\"pre\">meio_general</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">ssm_serial</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">helpers</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">instances</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">loss_functions</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">optimization</span></code> Module", "Other Modules", "<code class=\"docutils literal notranslate\"><span class=\"pre\">eoq</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">finite_horizon</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">newsvendor</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">rq</span></code> Module", "Single-Echelon Inventory Optimization", "<code class=\"docutils literal notranslate\"><span class=\"pre\">ss</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">supply_uncertainty</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">wagner_whitin</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">sim</span></code> Module", "<code class=\"docutils literal notranslate\"><span class=\"pre\">sim_io</span></code> Module", "Simulation", "Stockpyl", "Installing Stockpyl", "Tutorial", "Multi-Echelon Inventory Optimization", "Single-Echelon Inventory Optimization", "Simulation", "Supply Uncertainty"], "terms": {"singl": [0, 5, 7, 11, 16, 18, 19, 20, 21, 23, 24, 25, 29, 31, 34, 35], "echelon": [0, 4, 5, 6, 7, 8, 9, 11, 12, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 31, 34, 35], "inventori": [0, 4, 5, 6, 7, 8, 9, 11, 12, 15, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 31, 35], "optim": [0, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35], "eoq": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34], "modul": [0, 1, 10, 22, 28, 29, 32, 33, 34, 35], "newsvendor": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34], "rq": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "ss": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "wagner_whitin": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 26, 27, 28, 29, 30, 32, 33, 34, 35], "finite_horizon": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "supply_uncertainti": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "multi": [0, 5, 6, 7, 8, 9, 11, 12, 26, 27, 29, 31, 34], "ssm_serial": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_tree": [0, 2, 3, 4, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_serial": [0, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "gsm_helper": [0, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "meio_gener": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "simul": [0, 5, 6, 11, 26, 27, 29, 31, 32], "sim": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 27, 28, 29, 30, 32, 33, 34, 35], "sim_io": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 34, 35], "data": [0, 5, 6, 8, 9, 12, 13, 14, 26, 27, 29, 31, 32], "type": [0, 2, 3, 4, 5, 6, 7, 9, 11, 12, 13, 14, 20, 21, 23, 24, 26, 27, 29, 32, 33, 34, 35], "supply_chain_nod": [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "supply_chain_network": [0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "demand_sourc": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "polici": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35], "disruption_process": [0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "other": [0, 4, 5, 6, 9, 12, 13, 14, 16, 21, 26, 29, 32, 33, 34], "instanc": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "loss_funct": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "helper": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "stockpyl": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 32, 33, 34, 35], "fosct": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "The": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34], "notat": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "equat": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "section": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "exampl": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 35], "etc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "us": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "below": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "snyder": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "shen": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "fundament": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "suppli": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33], "chain": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "theori": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "2nd": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "edit": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "2019": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "term": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "node": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "stage": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "ar": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "interchang": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "document": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, 32, 33, 34, 35], "supplychainnetwork": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35], "supplychainnod": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "nodestatevar": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "demandsourc": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "disruptionprocess": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35], "r": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "q": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "s": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "thi": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 15, 16, 19, 21, 27, 32, 34], "contain": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34, 35], "class": [2, 3, 4, 5, 6, 15, 29, 31, 34], "A": [2, 3, 4, 5, 6, 7, 8, 11, 12, 13, 14, 19, 20, 21, 23, 24, 27, 32, 34], "object": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 20, 24, 26, 32, 33, 34, 35], "repres": [2, 3, 4, 5, 13, 15, 25, 27, 34], "extern": [2, 4, 6, 7, 8, 27], "demand": [2, 4, 5, 6, 7, 8, 9, 12, 14, 15, 18, 19, 20, 21, 23, 24, 25, 27, 29, 31, 32, 33, 35], "observ": [2, 34], "can": [2, 3, 5, 6, 11, 12, 14, 29, 32, 33, 34, 35], "random": [2, 3, 13, 15, 26], "determinist": [2, 24, 34, 35], "attribut": [2, 3, 4, 5, 6, 9, 12, 13, 14, 32, 34], "specifi": [2, 3, 4, 5, 7, 12, 13, 14, 19, 32, 33, 34], "distribut": [2, 5, 8, 12, 13, 14, 15, 19, 20, 21, 23, 24, 29, 32, 33, 34, 35], "its": [2, 3, 5, 6, 8, 11, 13, 18, 20, 26, 32, 33, 34], "paramet": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34], "gener": [2, 3, 5, 12, 13, 15, 19, 20, 24, 26, 29, 31, 34], "from": [2, 3, 4, 5, 6, 7, 8, 9, 13, 14, 15, 16, 19, 20, 24, 25, 27, 29, 32, 33, 35], "creat": [2, 3, 4, 5, 6, 13, 14, 32], "ha": [2, 4, 5, 6, 9, 12, 13, 14, 15, 16, 27, 29, 34], "normal": [2, 8, 12, 14, 15, 19, 20, 21, 23, 24, 29, 32, 33, 35], "mean": [2, 5, 6, 7, 8, 12, 13, 15, 19, 20, 21, 23, 24, 25, 26, 29, 32, 34, 35], "50": [2, 13, 18, 19, 20, 23, 29, 33, 34], "standard": [2, 6, 8, 12, 15, 19, 20, 21, 23, 24, 26, 29, 34, 35], "deviat": [2, 6, 8, 12, 15, 19, 20, 21, 23, 24, 29, 35], "10": [2, 7, 11, 13, 15, 23, 29, 32, 33, 34], "ds": 2, "n": [2, 8, 12, 13, 15, 18, 20, 21, 24, 26, 29, 32, 34], "standard_devi": [2, 29, 32, 34], "generate_demand": 2, "46": [2, 32, 34], "75370030596123": 2, "tell": [2, 34], "round": [2, 12, 13, 18, 19], "integ": [2, 9, 12, 13, 15, 19, 20, 21, 23], "round_to_int": [2, 5], "true": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 26, 27, 33, 34, 35], "63": 2, "kwarg": [2, 3, 4, 5, 6], "keyword": [2, 3, 4, 5], "argument": [2, 3, 4, 5, 6, 11, 13, 15, 24, 32], "valu": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 23, 24, 25, 27, 33, 34], "one": [2, 3, 4, 5, 6, 7, 9, 11, 13, 15, 21, 32, 34], "more": [2, 3, 4, 5, 6, 7, 11, 13, 24, 29, 32, 34], "e": [2, 3, 4, 5, 6, 12, 13, 14, 15, 19, 20, 24, 26, 32, 33, 34], "g": [2, 3, 4, 7, 12, 14, 18, 19, 20, 21, 23, 24, 25, 34], "string": [2, 3, 4, 6, 12, 13, 26, 27, 34], "current": [2, 3, 4, 5, 6, 9, 11, 20, 26, 27, 34, 35], "support": [2, 3, 4, 6, 12, 13, 15, 23, 26, 27, 33, 34, 35], "none": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 23, 24, 26, 27, 32, 34], "p": [2, 6, 7, 9, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 27, 29, 33, 34, 35], "poisson": [2, 14, 15, 20, 21, 23, 33, 34], "ud": 2, "uniform": [2, 13, 15, 24, 35], "discret": [2, 11, 12, 13, 14, 15, 19, 20, 23, 32, 33], "uc": 2, "continu": [2, 13, 15, 20, 21, 33], "d": [2, 12, 13, 19, 20, 23, 24, 25, 29, 33, 34, 35], "cd": 2, "custom": [2, 6, 8, 13, 15, 23, 27], "str": [2, 3, 4, 6, 13, 14, 26, 27], "nearest": [2, 12, 13, 19], "bool": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 26, 27], "per": [2, 3, 6, 7, 8, 11, 12, 16, 18, 19, 20, 21, 23, 24, 25, 29, 32, 34], "period": [2, 3, 5, 6, 7, 11, 13, 14, 19, 20, 23, 24, 25, 26, 27, 29, 32, 33, 34], "requir": [2, 3, 4, 5, 8, 12, 13, 15, 19, 20, 23, 24, 27, 32], "mu": [2, 8, 12, 15, 18, 19, 20, 21, 23, 24, 29, 33], "float": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26], "option": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 20, 23, 24, 25, 26, 27, 33], "sigma": [2, 15, 19, 20, 21, 23, 29, 33], "demand_list": [2, 34], "list": [2, 3, 5, 6, 7, 8, 11, 12, 13, 14, 18, 19, 23, 25, 27, 32, 34], "possibl": [2, 13, 19, 20, 34], "For": [2, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 32, 33, 34], "beyond": [2, 3], "length": [2, 3, 8, 13, 14, 19, 23, 24, 25], "restart": [2, 3, 19], "begin": [2, 3, 12, 19, 34], "also": [2, 5, 6, 15, 29, 32, 33], "allow": [2, 4, 5, 32, 34], "singleton": [2, 5, 8, 11, 12, 13, 19, 20, 25, 32], "which": [2, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 19, 20, 24, 25, 26, 27, 32, 33, 34], "case": [2, 4, 5, 6, 8, 9, 12, 13, 14, 19, 25, 27, 34], "everi": [2, 9, 11, 13, 18, 19, 25, 34], "probabl": [2, 3, 12, 13, 15, 19, 20, 24, 33, 34], "each": [2, 3, 5, 6, 7, 8, 9, 11, 12, 13, 14, 16, 19, 21, 25, 26, 27, 32, 33, 34], "lo": [2, 11, 13], "low": [2, 11, 19], "rang": [2, 5, 11, 12, 13, 19, 20, 32, 33, 34], "hi": [2, 11, 13, 23], "high": [2, 11, 19], "properti": [2, 5, 6, 21], "demand_distribut": 2, "scipi": [2, 15, 20, 24, 33, 34, 35], "stat": [2, 15, 20, 24, 33, 34, 35], "rv_continu": [2, 13, 15, 20, 24, 33, 35], "rv_discret": [2, 13, 15, 20, 24, 33, 35], "read": [2, 5, 6], "onli": [2, 3, 4, 5, 6, 14, 24, 32, 33, 34, 35], "initi": [2, 3, 4, 5, 6, 11, 14, 19, 25, 26], "overwrit": [2, 3, 4, 5, 6], "default": [2, 3, 4, 5, 6, 12, 13, 14, 19, 20, 26, 27, 34], "If": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 26, 27, 33, 34, 35], "all": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 19, 26, 27, 32, 34], "reset": [2, 3, 4, 5, 6], "even": [2, 3, 4, 5, 6, 9, 14, 27, 32], "thei": [2, 3, 4, 5, 6, 11, 12, 13, 14, 19, 32, 34], "alreadi": [2, 3, 4, 5, 6, 9, 14, 34], "exist": [2, 3, 4, 5, 6, 13, 14], "how": [2, 3, 4, 5, 6, 32, 34], "method": [2, 3, 4, 5, 6, 11, 15, 23, 32], "should": [2, 3, 4, 5, 6, 11, 13, 34], "call": [2, 3, 4, 5, 6, 9, 11, 12, 13, 33], "__init": [2, 3, 4, 5, 6], "__": [2, 3, 4, 5, 6], "fals": [2, 3, 4, 5, 6, 9, 11, 12, 13, 14, 16, 20, 23, 24, 27, 34], "miss": [2, 3, 4, 5, 6, 9, 13, 14], "ad": [2, 3, 4, 5, 6, 19, 34], "overwritten": [2, 3, 4, 5, 6], "when": [2, 3, 4, 5, 6, 11, 12, 13, 16, 19, 21, 27, 32, 34], "load": [2, 3, 4, 5, 6, 14, 29, 32, 34], "an": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 32, 33, 34, 35], "file": [2, 3, 4, 5, 6, 14, 26, 27, 34], "make": [2, 3, 4, 5, 6, 13, 32, 34], "sure": [2, 3, 4, 5, 6], "present": [2, 3, 4, 5, 6, 12, 13, 14, 24], "those": [2, 3, 4, 5, 6, 12, 34], "to_dict": [2, 3, 4, 5, 6], "convert": [2, 3, 4, 5, 6, 9, 29, 32], "dict": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 20, 32, 33], "deep": [2, 3, 6], "copi": [2, 3, 4, 5, 6, 9, 13], "so": [2, 3, 6, 9, 20, 32, 34], "chang": [2, 3, 5, 6, 12, 13], "origin": [2, 3, 6, 9, 14], "do": [2, 3, 5, 6, 9, 11, 12, 13, 14, 26, 34], "get": [2, 3, 6], "propag": [2, 3, 6], "return": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 33, 34, 35], "represent": [2, 3, 4, 5, 6, 9], "classmethod": [2, 3, 4, 5, 6], "from_dict": [2, 3, 4, 5, 6], "the_dict": [2, 3, 4, 5, 6, 13], "new": [2, 3, 4, 5, 6, 9, 13, 14, 19, 20], "typic": [2, 3, 4, 5, 6, 14, 32, 34], "int": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 15, 18, 19, 20, 23, 25, 26, 27], "omit": [2, 3, 4, 5, 11, 12, 14, 27, 32], "first": [2, 3, 5, 6, 12, 13, 21, 32, 34], "validate_paramet": [2, 3, 4], "check": [2, 3, 4, 5, 6, 13, 26], "appropri": [2, 3, 4], "have": [2, 3, 4, 5, 6, 7, 8, 9, 11, 13, 14, 19, 27, 34, 35], "been": [2, 3, 4, 5, 6, 7, 9, 15, 27, 34], "provid": [2, 3, 4, 5, 6, 8, 9, 11, 12, 13, 14, 15, 19, 20, 23, 24, 32, 34, 35], "given": [2, 3, 4, 5, 6, 7, 11, 12, 13, 15, 16, 18, 19, 20, 21, 23, 24, 25, 27, 33, 34], "rais": [2, 3, 4, 5, 12, 13, 14, 15, 19, 20, 21, 23, 24, 25, 26], "except": [2, 3, 4, 5, 6, 12, 15, 26], "cdf": [2, 13, 15, 20], "x": [2, 12, 13, 15, 16, 18, 19, 24, 34], "cumul": [2, 6, 27, 34], "function": [2, 4, 5, 6, 9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 23, 24, 27, 29, 32, 33, 35], "In": [2, 5, 6, 13, 19, 25, 27, 32, 34, 35], "some": [2, 6, 18, 19, 20, 25, 27, 32, 33], "just": [2, 3, 12, 32, 34], "wrapper": [2, 12], "around": [2, 19], "calcul": [2, 3, 4, 6, 7, 12, 13, 15, 18, 19, 20, 21, 23, 24, 26, 33, 34], "f": [2, 12, 13, 15, 16, 19, 20, 21, 24, 29, 33, 34], "lead_time_demand_distribut": 2, "lead_tim": [2, 6, 12, 13, 20, 21, 32, 33, 34], "lead": [2, 6, 7, 9, 12, 14, 19, 20, 21, 23, 29, 31], "time": [2, 6, 7, 8, 9, 12, 13, 14, 18, 19, 20, 21, 23, 24, 25, 26, 29, 31, 32, 33], "sum": [2, 6, 12, 13], "independ": [2, 9], "variabl": [2, 4, 6, 13, 14, 15, 26, 27, 34], "therefor": [2, 6, 34], "valueerror": [2, 5, 12, 13, 14, 15, 19, 20, 21, 23, 24, 25, 26], "l": [2, 6, 8, 12, 14, 15, 20, 21, 23, 33, 34], "disrupt": [3, 6, 14, 24, 27, 29, 31], "process": [3, 6, 8, 9, 34, 35], "subject": [3, 34], "govern": [3, 24], "well": [3, 5, 6, 11, 20, 27, 32], "itself": [3, 5, 6, 24], "i": [3, 4, 5, 6, 12, 13, 15, 19, 25, 27, 32, 33, 34], "effect": [3, 34], "keep": 3, "track": 3, "state": [3, 4, 6, 14, 19, 26, 27, 34, 35], "accord": [3, 34], "follow": [3, 5, 6, 8, 12, 19, 24, 27, 32, 33, 34, 35], "2": [3, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 29, 32, 33, 34, 35], "markov": [3, 34, 35], "0": [3, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34, 35], "1": [3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 34, 35], "recoveri": [3, 34], "3": [3, 7, 8, 9, 12, 13, 14, 15, 18, 19, 20, 21, 24, 25, 29, 32, 33, 34, 35], "order": [3, 4, 5, 6, 12, 13, 15, 18, 19, 21, 23, 24, 25, 27, 29, 33, 34, 35], "paus": [3, 34], "cannot": [3, 6, 14, 15, 27, 34], "place": [3, 4, 6, 13, 27, 34], "assum": [3, 5, 6, 8, 11, 12, 13, 15, 19, 20, 21, 23, 25, 34, 35], "dp": [3, 7, 8, 9, 19, 25, 32, 33], "random_process_typ": [3, 34], "m": [3, 21, 23, 33, 34], "markovian": 3, "disruption_typ": [3, 34], "op": [3, 34], "disruption_prob": [3, 24, 34], "recovery_prob": [3, 24, 34], "update_disruption_st": 3, "steadi": 3, "being": [3, 6, 16, 34], "up": [3, 4, 12, 13, 14, 19, 23, 24, 29, 33], "down": [3, 12, 13, 24], "pi_up": 3, "pi_down": 3, "steady_state_prob": 3, "7499999999999999": 3, "25": [3, 14, 24, 29, 34, 35], "explicit": [3, 14, 20, 33], "explicitli": [3, 34], "dure": [3, 6, 34], "sp": [3, 6, 27, 34], "shipment": [3, 6, 12, 27, 34], "supplier": [3, 4, 6, 8, 24, 27, 35], "ship": [3, 34], "them": [3, 13, 29, 32, 34], "tp": [3, 34], "transit": [3, 6, 27, 34], "item": [3, 6, 12, 13, 18, 19, 20, 21, 23, 24, 25, 27, 34], "rp": [3, 6, 27, 34], "receipt": [3, 6, 34], "receiv": [3, 6, 27, 34], "accumul": [3, 34], "befor": [3, 4, 6, 9, 13, 34], "end": [3, 6, 11, 12, 13, 16, 19, 27, 34], "t": [3, 18, 19, 20, 21, 24, 25, 29, 33, 34], "alpha": [3, 20, 21, 24, 26, 34, 35], "beta": [3, 15, 24, 35], "disruption_state_list": 3, "otherwis": [3, 5, 6, 12, 13, 14, 15, 19, 20, 23, 27, 34], "updat": [3, 5, 6, 34], "set": [3, 4, 5, 6, 7, 8, 11, 12, 13, 14, 16, 19, 20, 23, 24, 26, 27, 29, 32, 34], "accordingli": 3, "non": [3, 6, 13, 19, 20, 23, 32, 33], "encapsul": 4, "quantiti": [4, 6, 18, 19, 21, 24, 25, 27, 29, 33, 34, 35], "base": [4, 5, 7, 11, 12, 14, 20, 24, 26, 29, 32, 33, 34, 35], "stock": [4, 5, 6, 7, 8, 9, 11, 12, 14, 20, 21, 24, 26, 27, 29, 32, 33, 34, 35], "level": [4, 5, 6, 7, 9, 11, 12, 19, 20, 21, 23, 24, 26, 27, 29, 32, 33, 34, 35], "60": [4, 20], "posit": [4, 6, 19, 27, 34], "52": 4, "5": [4, 7, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34, 35], "pol": 4, "bs": [4, 5, 29, 32, 34], "base_stock_level": [4, 5, 7, 11, 20, 24, 29, 32, 33, 34], "get_order_quant": 4, "inventory_posit": [4, 6], "7": [4, 13, 14, 15, 19, 20, 21, 23, 29, 32, 33, 34], "fq": 4, "fix": [4, 18, 19, 21, 23, 24, 25, 29, 33, 34], "eb": [4, 34], "beb": 4, "balanc": 4, "applic": 4, "order_quant": [4, 6, 18, 21, 24, 25, 34], "reorder_point": [4, 19, 21, 23, 34], "reorder": [4, 19, 21, 23, 29, 33], "point": [4, 16, 19, 21, 23, 29, 33, 34], "order_up_to_level": [4, 19, 23], "index": [4, 5, 6, 7, 8, 9, 11, 12, 13, 19, 25, 27, 29, 32, 34], "ani": [4, 5, 6, 7, 11, 12, 13, 14, 19, 20, 25, 26, 32, 34], "rather": [4, 5, 6, 13, 15, 29], "than": [4, 5, 6, 9, 11, 13, 15, 16, 19, 20, 29, 32, 33, 34], "like": [4, 6, 19, 29, 32], "recurs": [4, 5, 6], "predecessor_index": [4, 6], "echelon_inventory_position_adjust": 4, "obtain": [4, 29], "necessari": [4, 8, 12], "sometim": [4, 11, 12, 32], "self": [4, 6, 15], "network": [4, 5, 6, 7, 8, 9, 11, 12, 26, 27, 29, 32, 34], "overrid": 4, "indic": [4, 5, 6, 7, 8, 9, 11, 12, 13, 19, 26, 27, 33], "queri": 4, "predecessor": [4, 5, 6, 7, 27, 34], "includ": [4, 5, 6, 9, 13, 18, 21, 27, 29, 33, 34], "immedi": [4, 34], "after": [4, 19, 26, 34], "subtract": [4, 19], "ip": 4, "instead": [4, 6, 12, 14, 15, 32, 34], "adjust": [4, 14, 15, 19, 34], "where": [4, 5, 6, 13, 15, 18, 19, 20, 21, 23, 24, 34], "eipa": 4, "consist": [5, 13, 24, 26, 32, 34], "togeth": [5, 13], "problem": [5, 6, 7, 8, 12, 14, 18, 19, 20, 21, 23, 24, 25, 29, 31, 32], "primarili": [5, 6], "meio": [5, 6, 10, 11, 29, 31, 34], "most": [5, 6, 12, 13, 14, 19, 21, 25, 26, 29], "within": [5, 16, 21], "problem_specific_data": [5, 6], "placehold": [5, 6], "specif": [5, 6, 8, 12], "max_max_replenishment_tim": [5, 9], "largest": [5, 13, 19], "max_replenishment_tim": [5, 9], "among": [5, 34], "node_indic": [5, 7, 11, 13], "source_nod": 5, "sourc": [5, 6, 34], "sink_nod": 5, "sink": [5, 34], "successor": [5, 6, 27, 34], "edg": [5, 32, 34], "tupl": [5, 24], "whose": [5, 6, 13, 33, 34], "element": [5, 13, 19, 25], "has_directed_cycl": 5, "whether": [5, 6, 9, 13, 26, 34], "direct": [5, 6, 26, 32], "cycl": [5, 26, 33], "handl": [5, 13], "_node": 5, "replac": [5, 6, 14], "empti": 5, "doe": [5, 6, 9, 13, 14, 19, 32, 34], "fill": [5, 6, 9, 13, 26, 27, 34], "noth": [5, 6, 14], "least": [5, 13], "ensur": [5, 6, 13, 14], "deep_equal_to": [5, 6], "rel_tol": [5, 6, 13], "1e": [5, 6, 13, 16, 21], "08": [5, 6], "deepli": [5, 6], "equal": [5, 6, 8, 11, 13, 14, 16, 19, 20, 33, 34], "themselv": [5, 6], "compar": [5, 6, 34], "rel": [5, 6, 11, 13, 32], "toler": [5, 6, 11, 13, 16, 19, 21], "two": [5, 6, 13, 15, 19, 34], "get_node_from_index": [5, 32, 34], "match": [5, 13, 34], "found": [5, 11, 14], "find": [5, 20, 21, 23, 32], "reindex_nod": 5, "old_to_new_dict": [5, 6], "new_nam": 5, "name": [5, 6, 13, 14, 27, 29, 32, 34], "kei": [5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 20], "old": [5, 6], "add_nod": [5, 32], "add": [5, 6, 32], "connect": 5, "might": [5, 6, 13], "determin": [5, 6, 7, 9, 11, 12, 13, 14, 21, 23, 34], "add_edg": 5, "from_index": 5, "to_index": 5, "either": [5, 8, 11, 12, 15, 19, 20, 24, 32, 33, 35], "add_edges_from_list": 5, "edge_list": 5, "multipl": [5, 13, 14, 24, 33, 35], "ignor": [5, 6, 8, 9, 11, 12, 13, 14, 15, 19, 20, 23, 24, 25, 27], "add_successor": [5, 6, 32], "successor_nod": 5, "must": [5, 6, 8, 9, 11, 12, 13, 15, 19, 20, 23, 25, 32, 34], "_successor": [5, 6], "_predecessor": [5, 6], "add_predecessor": [5, 6], "predecessor_nod": 5, "remove_nod": [5, 6], "remov": [5, 6], "networkx_digraph": 5, "build": [5, 13, 26, 29, 32, 34], "networkx": 5, "digraph": 5, "same": [5, 7, 11, 12, 13, 14, 15, 19, 25, 29, 32, 34], "structur": [5, 7, 8, 9, 14, 29, 31, 32], "network_from_edg": [5, 32, 34], "node_order_in_list": [5, 12, 13, 32, 34], "construct": [5, 34], "correspond": [5, 8, 12, 13, 27, 33, 34], "That": [5, 6, 12, 13], "slot": [5, 12, 13], "k": [5, 8, 12, 13, 18, 19, 21, 23, 24, 25, 29, 33, 35], "assign": [5, 12, 29], "sort": [5, 13], "unless": [5, 9, 13, 24], "rule": 5, "abov": [5, 20, 27, 29, 34, 35], "appli": 5, "supply_typ": [5, 6, 34], "u": [5, 6, 13, 15], "matter": 5, "you": [5, 6, 32, 33, 34, 35], "mai": [5, 8, 9, 11, 12, 13, 19, 25, 32, 33, 34], "pass": [5, 13, 32, 33, 34], "individu": [5, 8, 11, 12, 18, 32], "latter": [5, 19, 25, 27], "note": [5, 6, 15, 24, 26, 27, 29, 34], "demand_typ": [5, 29, 32, 34], "avoid": [5, 19], "ambigu": 5, "similarli": [5, 6], "inventory_polici": [5, 6, 29, 34], "policy_typ": [5, 32, 34], "attributeerror": 5, "though": 5, "see": [5, 13, 15, 32, 33], "valid": [5, 19, 34], "b": [5, 13, 14, 15, 16, 20], "th": [5, 8, 12, 13], "single_stage_system": [5, 34], "serial_system": [5, 12, 29, 32, 34], "num_nod": [5, 8, 12, 13, 29, 32, 34], "node_order_in_system": [5, 12, 29, 32, 34], "serial": [5, 8, 11, 12, 14, 29, 31, 34], "system": [5, 6, 7, 8, 9, 11, 12, 14, 21, 26, 29, 31, 34], "number": [5, 6, 8, 11, 12, 13, 14, 15, 19, 21, 25, 26, 27, 33, 34], "By": [5, 12], "upstream": [5, 6, 12, 34], "downstream": [5, 6, 12, 34], "stockout_cost": [5, 6, 9, 12, 13, 18, 19, 20, 21, 23, 24, 29, 32, 33, 34], "appear": [5, 12, 13, 34], "owmr_system": 5, "num_retail": 5, "warehous": [5, 14], "retail": [5, 14], "owmr": 5, "last": [5, 13], "mwor_system": 5, "num_warehous": 5, "mwor": 5, "assembl": [5, 6, 14], "local_to_echelon_base_stock_level": [5, 32], "s_local": 5, "local": [5, 6, 7, 8, 9, 16, 29, 32], "anyth": [5, 9, 14], "about": [5, 23, 34], "label": [5, 7, 9, 23, 27, 34], "s_echelon": 5, "echelon_to_local_base_stock_level": [5, 29, 34], "rare": 6, "ever": 6, "standalon": [6, 11, 34], "describ": [6, 8, 9, 12, 23], "complet": [6, 34], "mani": [6, 34], "differ": [6, 11, 15, 34, 35], "optimize_base_stock_level": [6, 12, 29, 32, 34], "take": [6, 11, 13, 15, 24, 34], "echelon_holding_cost": [6, 12, 29, 32], "while": [6, 32], "optimize_committed_service_tim": [6, 8, 9, 29, 32], "local_holding_cost": [6, 8, 13, 29, 32, 34], "processing_tim": [6, 8, 13, 32], "need": [6, 7, 9, 12, 13, 34], "perform": [6, 9, 12, 18, 19, 20, 24, 26, 32], "measur": [6, 26], "hold": [6, 8, 9, 12, 18, 19, 20, 21, 23, 24, 25, 27, 29, 33], "cost": [6, 7, 8, 9, 11, 12, 14, 18, 19, 20, 21, 23, 24, 25, 26, 27, 29, 32, 33, 35], "unit": [6, 8, 12, 18, 20, 21, 24, 34], "h": [6, 8, 12, 18, 19, 20, 21, 23, 24, 25, 29, 33, 34, 35], "local_holding_cost_funct": [6, 34], "exactli": [6, 9, 12, 32, 35], "il": [6, 19, 27, 34], "in_transit_holding_cost": 6, "coeffici": [6, 34], "en": [6, 13, 16], "rout": 6, "To": [6, 26, 30, 32, 34], "stockout": [6, 9, 12, 18, 19, 20, 21, 23, 24, 27, 29, 33], "backord": [6, 18, 21, 26, 27, 33, 34], "stockout_cost_funct": [6, 34], "purchase_cost": [6, 19, 20, 25, 33], "incur": [6, 27, 34], "revenu": [6, 20, 27, 33, 34], "earn": 6, "met": [6, 27, 34], "shipment_lead_tim": [6, 27, 29, 32, 34], "alia": 6, "order_lead_tim": [6, 27, 34], "initial_inventory_level": [6, 19, 26], "initial_ord": 6, "outbound": [6, 7, 8, 27, 34], "inbound": [6, 7, 8, 27, 34], "decis": 6, "unlimit": 6, "state_var": 6, "include_extern": 6, "predecessor_indic": 6, "successor_indic": 6, "descend": 6, "necessarili": [6, 11, 32], "directli": [6, 26, 32, 34], "adjac": [6, 9], "reach": 6, "via": 6, "path": [6, 14, 27], "ancestor": 6, "we": [6, 14, 15, 19, 29, 32, 33, 34], "neighbor": 6, "neighbor_indic": 6, "holding_cost": [6, 12, 14, 18, 19, 20, 21, 23, 24, 25, 29, 33, 34], "forward_echelon_lead_tim": 6, "total": [6, 19, 26, 27, 29, 34], "rosl": [6, 14], "1989": [6, 14], "m_i": 6, "zipkin": [6, 15, 19, 20, 34], "2000": [6, 7, 9, 15, 19, 20, 24, 29, 32, 34, 35], "underlin": [6, 12, 19, 20], "_j": [6, 12], "algorithm": [6, 7, 8, 9, 11, 12, 16, 19, 21, 23, 25, 29, 32, 33, 34], "forward": 6, "equivalent_lead_tim": 6, "between": [6, 11, 18, 34], "decreas": 6, "consecut": [6, 9, 18], "wai": [6, 15, 32], "result": [6, 15, 19, 27, 29, 31, 33], "unreli": 6, "smallest": [6, 9, 13, 19, 20], "equival": [6, 27, 34], "l_i": 6, "derived_demand_mean": 6, "deriv": 6, "derived_demand_standard_devi": 6, "state_vars_curr": 6, "recent": [6, 13, 26], "Is": 6, "work": [6, 13], "fulli": 6, "caveat": 6, "store": 6, "simpli": 6, "It": [6, 20, 29, 34], "remove_successor": 6, "remove_predecessor": 6, "get_one_successor": 6, "get_one_predecessor": 6, "reindex_all_state_vari": 6, "intermedi": 6, "until": [6, 15, 34], "inbound_shipment_pipelin": 6, "arriv": [6, 27, 34], "inbound_ship": 6, "inbound_order_pipelin": 6, "inbound_ord": 6, "demand_cumul": 6, "intern": [6, 8, 9, 24], "through": 6, "fill_rat": 6, "outbound_ship": 6, "on_order_by_predecessor": 6, "yet": [6, 27, 34], "inventory_level": 6, "neg": [6, 15, 23, 27, 34], "zero": [6, 20, 27, 33, 34], "backorders_by_successor": 6, "outbound_disrupted_item": 6, "held": [6, 27, 34], "due": [6, 15, 21, 27, 34], "sinc": [6, 11, 12, 14, 32, 34], "alwai": [6, 12, 34, 35], "over": [6, 16, 19, 20, 26], "max": [6, 13, 15, 19, 34], "inbound_disrupted_item": 6, "raw_material_inventori": 6, "product": [6, 8, 18, 24, 33, 34], "raw": [6, 27, 34], "materi": [6, 27, 34], "wa": [6, 9, 14, 27, 34], "holding_cost_incur": 6, "stockout_cost_incur": 6, "in_transit_holding_cost_incur": 6, "revenue_earn": 6, "total_cost_incur": 6, "less": [6, 11, 15, 16, 19, 20], "demand_met_from_stock": 6, "demand_met_from_stock_cumul": 6, "rate": [6, 15, 27, 29, 34], "on_hand": 6, "hand": [6, 34], "in_transit_to": 6, "declar": [6, 15], "becaus": [6, 19, 34], "deliv": [6, 35], "in_transit_from": 6, "in_transit": 6, "count": [6, 13], "divid": 6, "on_ord": 6, "raw_material_aggreg": 6, "inbound_disrupted_items_aggreg": 6, "plu": [6, 13, 21, 33], "On": [6, 19, 20, 21], "aggreg": 6, "consid": [6, 12, 16, 19, 32, 34], "exclud": 6, "echelon_on_hand_inventori": 6, "echelon_inventory_level": 6, "minu": [6, 7], "termin": [6, 11, 16, 19, 21], "echelon_inventory_posit": 6, "reindex_state_vari": 6, "entir": [6, 19, 25], "code": [7, 8, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 32, 33, 34, 35], "dynam": [7, 8, 9, 19, 25, 29, 32, 33], "program": [7, 8, 9, 19, 25, 29, 32, 33], "solv": [7, 11, 12, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 35], "guarante": [7, 8, 29, 32], "servic": [7, 8, 9, 12, 29, 32], "model": [7, 8, 12, 24, 29, 32, 33, 34, 35], "gsm": [7, 8, 9, 14, 29, 31], "tree": [7, 9, 11, 14, 29, 31], "grave": [7, 9, 29, 32], "willem": [7, 9, 29, 32], "2003": [7, 9, 12, 14, 34], "implement": [7, 8, 9, 12, 16, 19, 29, 32, 33], "tutori": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 34], "page": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "c": [7, 9, 12, 13, 14, 15, 19, 20, 23, 25, 29, 33], "strateg": [7, 9], "safeti": [7, 8, 9, 21, 33], "placement": [7, 9], "manufactur": [7, 9], "oper": [7, 9, 21, 23], "manag": [7, 9, 12, 15, 19, 20, 21, 23, 34], "68": [7, 9, 18, 29, 33], "83": [7, 9], "erratum": [7, 9], "176": [7, 9], "177": [7, 9], "solution_cost_from_cst": 7, "cst": [7, 8, 9, 29, 32], "expect": [7, 8, 9, 11, 12, 19, 20, 21, 23, 24, 29, 32, 33, 34, 35], "solut": [7, 11, 12, 18, 19, 20, 21, 23, 24, 32, 33, 34], "commit": [7, 8, 9, 29, 32], "relabel": [7, 9], "6": [7, 8, 9, 11, 12, 13, 14, 15, 19, 20, 21, 23, 24, 29, 32, 33, 34], "import": [7, 8, 9, 15, 20, 24, 29, 32, 33, 34, 35], "load_inst": [7, 8, 9, 14, 29, 32, 34], "preprocess_tre": [7, 9], "example_6_5": [7, 9, 14, 29, 32], "4": [7, 9, 11, 12, 13, 14, 15, 18, 19, 20, 21, 23, 24, 25, 29, 32, 33, 34], "8": [7, 9, 13, 14, 15, 18, 19, 20, 21, 23, 24, 29, 32, 33, 34, 35], "277916867529369": [7, 9, 29, 32], "solution_cost_from_base_stock_level": 7, "local_bsl": 7, "graph": 7, "y": [7, 12, 15, 19, 20, 21, 23, 24, 34], "45": [7, 34], "00": [7, 33], "41": [7, 15, 20, 24, 34], "27": [7, 14, 15, 18, 20, 21, 24, 34], "inbound_cst": 7, "node_index": 7, "si": 7, "maximum": 7, "iter": [7, 11, 13, 16, 21], "dictionari": [7, 11, 13, 14, 33], "9": [7, 14, 15, 18, 21, 24, 25, 33, 34], "problem_6_9": [7, 14], "31": [7, 14, 15, 18, 34], "net_lead_tim": 7, "net": 7, "nlt": 7, "35": [7, 20], "cst_to_base_stock_level": 7, "4494897427831783": 7, "4142135623730951": 7, "safety_stock_level": 7, "inderfurth": [8, 32], "1991": [8, 23, 24, 32, 33, 35], "multistag": 8, "journal": [8, 24], "econom": [8, 18, 24, 29, 33, 35], "24": [8, 20, 24, 34], "103": [8, 21], "113": 8, "demand_bound_const": [8, 9, 32], "external_outbound_cst": [8, 9, 32], "external_inbound_cst": [8, 9, 32], "demand_mean": [8, 12, 13, 19, 20, 21, 23, 29, 32, 33], "demand_standard_devi": [8, 12, 32], "ldot": [8, 12, 13, 19], "entri": [8, 13], "constant": 8, "bound": [8, 11, 12, 13, 15, 16, 19, 32, 34], "opt_cst": [8, 9, 29, 32], "opt_cost": [8, 9, 29, 32], "example_6_3": [8, 14, 32], "8284271247461903": [8, 32], "primari": [9, 26], "pre": 9, "relabel_nod": 9, "output": [9, 11, 13, 19, 25, 34], "express": 9, "preprocess": 9, "correctli": 9, "net_demand_mean": 9, "net_demand_standard_devi": 9, "larger_adjacent_nod": 9, "start_index": 9, "start": [9, 11, 19, 27, 34], "new_tre": 9, "force_relabel": 9, "modifi": [9, 20, 25], "input": [9, 32, 34], "original_label": 9, "larger_adjacent_node_is_downstream": 9, "relabeled_tre": 9, "is_correctly_label": 9, "highest": 9, "greater": [9, 19], "gsm_to_ssm": 9, "ssm": [9, 12, 14, 29, 31], "field": 9, "ssm_tree": 9, "refer": [10, 22, 28, 29, 30, 31, 32, 33, 35], "overview": [10, 22, 28], "arbitrari": [11, 15, 32, 33, 34, 35], "topolog": [11, 32], "approxim": [11, 12, 21, 23, 24, 32, 33, 34, 35], "brute": [11, 32], "forc": [11, 32], "approach": [11, 32], "coordin": [11, 32], "descent": [11, 32], "enumer": [11, 32], "These": [11, 12, 14, 32, 33, 34], "heurist": [11, 12, 18, 23, 32, 33, 34, 35], "tend": [11, 32], "quit": [11, 32], "slow": [11, 32], "particularli": [11, 32], "accur": [11, 24, 32], "best": [11, 32], "avail": [11, 30, 32], "complex": [11, 32], "literatur": [11, 32, 34], "meio_by_enumer": [11, 32], "truncation_lo": [11, 32], "truncation_hi": [11, 32], "discretization_step": 11, "discretization_num": 11, "group": [11, 27, 34], "objective_funct": [11, 32], "sim_num_tri": [11, 32], "sim_num_period": [11, 32], "1000": [11, 12, 29, 34], "sim_rand_se": [11, 32], "progress_bar": [11, 26, 34], "print_solut": 11, "combin": [11, 34], "evalu": [11, 12, 16, 18, 20, 23, 24, 32, 33], "test": [11, 13, 32], "15": [11, 15, 24, 34, 35], "truncat": [11, 12, 19, 32], "automat": [11, 12], "interv": [11, 12, 16, 18, 24, 26, 34], "width": [11, 16], "speed": [11, 32], "trial": [11, 15, 26, 32], "run": [11, 26, 32], "rand": 11, "seed": [11, 26], "displai": [11, 26, 29, 31], "progress": [11, 26], "bar": [11, 15, 19, 20, 24, 26], "print": [11, 16, 27, 29, 34], "best_": [11, 32], "best_cost": [11, 32], "base_stock_level_bisection_search": 11, "node_to_optim": 11, "01": 11, "bisect": [11, 21], "search": [11, 13, 16, 21, 24, 32], "usual": [11, 25], "subroutin": 11, "meio_by_coordinate_desc": [11, 32], "absolut": [11, 13, 21], "converg": [11, 21], "initial_solut": 11, "search_lo": [11, 32], "search_hi": [11, 32], "tol": [11, 16, 21], "line_search_tol": 11, "0001": 11, "verbos": [11, 16], "fail": [11, 26], "improv": 11, "line": 11, "golden": [11, 16, 24], "compon": 11, "messag": [11, 13, 16], "truncate_and_discret": 11, "without": [11, 12, 13, 19, 33], "modif": 11, "100": [11, 12, 19, 21, 29, 32, 33, 34], "truncated_discretized_valu": 11, "under": [12, 21, 23, 29, 32, 33, 34], "stochast": [12, 19, 21, 29, 31, 32, 34], "chen": [12, 29, 32, 34], "zheng": [12, 21, 23, 29, 32, 33, 34], "1994": [12, 24, 29, 32, 34, 35], "turn": [12, 32], "clark": [12, 29, 32], "scarf": [12, 29, 32], "1960": [12, 29, 32], "newsvendor_heurist": [12, 32, 34], "shang": [12, 14, 32, 34], "song": [12, 14, 32, 34], "1996": [12, 32], "lower": [12, 13, 15, 16, 19, 23, 32, 34], "multiechelon": [12, 34], "scienc": [12, 21, 23, 34], "40": [12, 15, 20, 21, 23, 29, 32, 33, 34], "11": [12, 32, 34], "1426": [12, 34], "1443": [12, 34], "475": 12, "490": 12, "j": [12, 19, 20, 34], "49": [12, 20, 34], "618": [12, 23, 34], "638": [12, 34], "plot": 12, "x_num": [12, 32], "d_num": [12, 32], "ltd_lower_tail_prob": 12, "167124183311998e": 12, "05": [12, 16], "ltd_upper_tail_prob": 12, "sum_ltd_lower_tail_prob": 12, "sum_ltd_upper_tail_prob": 12, "661338147750939e": 12, "16": [12, 14, 20, 21, 34], "correpond": 12, "here": [12, 14, 15, 32], "account": [12, 15, 19, 34], "cdot": [12, 13, 15, 19, 20, 21, 23, 24], "ndarrai": [12, 13, 19], "arrai": [12, 13, 19, 20, 25, 29, 33], "tail": 12, "upper": [12, 13, 15, 16, 19, 23, 32], "s_star": [12, 29, 32], "c_star": [12, 29, 32], "_0": 12, "_1": 12, "gather": 12, "hat": [12, 18], "h_jx": 12, "_": [12, 19, 29, 33, 34], "g_j": 12, "left": [12, 15, 20, 21, 23, 24, 25], "d_j": 12, "right": [12, 13, 15, 20, 21, 23, 24, 25], "mathrm": 12, "argmin": [12, 13], "min": [12, 13, 15, 19], "s_j": 12, "outsid": [12, 19], "limit": [12, 23], "linear": [12, 34], "13": [12, 15, 16, 34], "lim_": 12, "rightarrow": 12, "infti": [12, 15, 24], "sum_": [12, 15, 18, 21, 23, 24, 25], "h_i": 12, "d_k": 12, "g_": 12, "text": [12, 15, 18, 19, 20, 24], "37": [12, 15, 20, 32, 34], "12": [12, 14, 15, 20, 21, 32, 33, 34], "22": [12, 14, 15, 24, 32, 34], "700237234889784": [12, 32], "012332294949644": [12, 32], "5144388073261155": [12, 32], "47": [12, 32, 34], "668653127136345": [12, 32], "weight": 12, "round_typ": [12, 13], "discuss": [12, 19, 34], "625": 12, "next": [12, 13, 20, 25, 29, 33, 34], "larger": [12, 13, 19], "s_heur": [12, 32, 34], "tild": 12, "32": [12, 14, 15, 18, 34], "texttt": 12, "frac": [12, 15, 18, 20, 21, 23, 24], "634032391786285": [12, 32], "027434723327854": [12, 32], "490880975286938": [12, 32], "expected_cost": [12, 32], "echelon_": 12, "680099140842174": [12, 32], "descript": [12, 14, 29], "docstr": [12, 34], "expected_holding_cost": 12, "basic": [12, 27, 29, 31, 33], "idea": 12, "43": [12, 34], "15945901616041": 12, "throughout": 13, "packag": [13, 29], "min_of_dict": 13, "numer": [13, 14, 15, 24, 32, 35], "min_valu": 13, "minimum": [13, 16, 19], "min_kei": 13, "attain": [13, 18, 20, 24], "typeerror": 13, "dict_match": 13, "d1": 13, "d2": 13, "require_pres": 13, "09": 13, "abs_tol": 13, "treat": [13, 14], "comparison": 13, "second": [13, 15, 21], "0s": 13, "is_iter": 13, "vs": 13, "is_list": 13, "ness": 13, "is_integ": 13, "integr": [13, 15], "is_discrete_distribut": 13, "both": [13, 15, 20, 21, 29, 32, 33, 34, 35], "rv_frozen": 13, "subclass": 13, "http": [13, 15, 16], "stackoverflow": 13, "com": 13, "61530461": 13, "3453768": 13, "Not": 13, "reliabl": 13, "is_continuous_distribut": 13, "find_nearest": 13, "closest": 13, "neither": 13, "execut": [13, 19, 32], "faster": [13, 19, 32], "boolean": 13, "ind": 13, "check_iterable_s": 13, "iterable_list": 13, "size": [13, 34], "ensure_list_for_time_period": 13, "num_period": [13, 19, 25, 26, 27, 29, 34], "var_nam": 13, "suitabl": 13, "0th": [13, 19, 25], "shift": 13, "traceback": 13, "ifi": 13, "error": [13, 26, 34], "desir": [13, 15, 19], "offload": 13, "x_new": 13, "ensure_list_for_nod": 13, "build_node_data_dict": 13, "attribute_dict": 13, "default_valu": 13, "data_dict": 13, "similar": [13, 26, 29], "ensure_dict_for_nod": 13, "simultan": 13, "sever": [13, 32], "form": [13, 32, 33], "len": 13, "know": [13, 34], "99": [13, 34], "sort_dict_by_kei": 13, "ascend": 13, "return_valu": 13, "depend": [13, 19, 24], "special": 13, "come": 13, "return_list": 13, "change_dict_kei": 13, "dict_to_chang": 13, "old_kei": 13, "new_kei": 13, "pair": 13, "keyerror": 13, "undefin": 13, "convolve_mani": 13, "convolv": 13, "dimension": 13, "fast": 13, "fourier": 13, "transform": 13, "fft": 13, "pmf": [13, 15, 20, 23, 33], "x_1": [13, 19], "x_n": 13, "space": [13, 19, 32], "sum_i": 13, "x_i": 13, "adapt": [13, 16], "29236193": 13, "convolut": 13, "let": 13, "x_2": 13, "x_3": 13, "x_4": 13, "327": 13, "342": 13, "182": 13, "052": 13, "007": 13, "word": 13, "irwin_hall_cdf": 13, "irwin": [13, 15, 19, 20, 34], "hall": [13, 21], "wikipedia": [13, 16], "org": [13, 15, 16], "wiki": [13, 16], "e2": 13, "80": [13, 23, 25, 29, 33, 34], "93hall_distribut": 13, "sum_of_continuous_uniforms_distribut": 13, "ident": 13, "sum_of_discrete_uniforms_pmf": 13, "69842911": 13, "sum_of_discrete_uniforms_distribut": 13, "sum_of_discretes_distribut": 13, "round_dict_valu": 13, "save": [14, 16, 27], "taken": 14, "example_3_1": 14, "problem_3_1": 14, "example_3_8": 14, "eoqb": [14, 18, 19, 21, 33], "problem_3_2b": 14, "problem_3_22": 14, "epq": [14, 18, 33], "example_3_9": 14, "wagner": [14, 25, 29, 31], "whitin": [14, 21, 25, 29, 31], "problem_3_27": 14, "problem_3_29": 14, "29": [14, 18, 20, 21], "scmo_ww_hw_c": 14, "scmo": 14, "nonstationari": 14, "purchas": [14, 19, 20, 25, 33], "scmo_jrp_ex": 14, "jrp": [14, 18, 33], "spp_jrp": 14, "428": 14, "silver": [14, 18, 33], "pyke": 14, "peterson": 14, "1998": 14, "scmo_jrp_hw_1": 14, "scmo_jrp_hw_2": 14, "scmo_jrp_hw_3": 14, "silver_jrp": 14, "1976": [14, 18, 33], "example_4_1_network": 14, "example_4_1": 14, "example_4_2": 14, "example_4_2_network": 14, "example_4_3": 14, "problem_4_1": 14, "problem_4_3b": 14, "example_4_4": 14, "example_4_7": 14, "problem_4_7b": 14, "problem_4_8a": 14, "problem_4_8b": 14, "lognorm": [14, 15, 20, 33], "problem_4_31": 14, "example_4_8": 14, "problem_4_32": 14, "problem_4_29": 14, "finit": [14, 19, 29, 31], "horizon": [14, 19, 25, 29, 31], "problem_4_30": 14, "30": [14, 15, 20, 23, 33, 34], "example_5_1": 14, "problem_5_1": 14, "problem_5_2": 14, "problem_5_3": 14, "example_5_8": 14, "example_6_1": [14, 32, 34], "problem_6_1": 14, "problem_6_2a": 14, "problem_6_2a_adj": 14, "review": [14, 21, 23], "problem_6_2b_adj": 14, "problem_6_16": 14, "figure_6_12": 14, "figur": 14, "figure_6_14": 14, "14": [14, 15, 19, 20, 24, 34, 35], "problem_6_7": 14, "example_9_1": 14, "problem_9_8": 14, "example_9_3": 14, "example_9_5": 14, "yield": [14, 24, 29, 31], "uncertainti": [14, 24, 29, 31, 33], "example_9_4": 14, "addit": [14, 24, 35], "problem_9_4a": 14, "problem_9_4b": 14, "example_9_6": 14, "problem_9_5": 14, "assembly_3_stag": 14, "rosling_figure_1": 14, "made": [14, 34], "rong_atan_snyder_figure_1a": 14, "rong": 14, "atan": 14, "2017": 14, "rong_atan_snyder_figure_1b": 14, "rong_atan_snyder_figure_1c": 14, "problem_6_8": 14, "shang_song_1": 14, "tabl": [14, 27, 34], "row": [14, 27, 34], "shang_song_9": 14, "shang_song_17": 14, "17": [14, 15, 20, 21, 34], "shang_song_25": 14, "instance_nam": [14, 27], "filepath": [14, 27], "initialize_missing_attribut": 14, "ignore_state_var": 14, "json": [14, 27], "dataset": 14, "stockpyl_inst": 14, "debug": [14, 27], "purpos": 14, "save_inst": 14, "instance_data": 14, "instance_descript": 14, "create_if_non": 14, "omit_state_var": 14, "later": [14, 34], "retrev": 14, "jsonpickl": 14, "longer": [14, 29], "descrtipt": 14, "write": [14, 27], "issu": [14, 19, 26, 32], "warn": [14, 19, 26], "part": 14, "todo": 14, "loss": [15, 20, 21, 24, 33], "complementari": [15, 20, 24], "defin": [15, 19, 20, 32], "standard_normal_loss": 15, "z": [15, 19, 23, 24, 34], "mathscr": 15, "l_bar": 15, "23": [15, 24, 34], "phi": [15, 20], "04552796208651397": 15, "345527962086514": 15, "standard_normal_second_loss": 15, "l2": 15, "l2_bar": 15, "28": [15, 21, 24, 34], "frac12": 15, "01880706693657111": 15, "326192933063429": 15, "normal_loss": 15, "sd": [15, 24], "n_bar": 15, "18": [15, 20, 21, 23, 24, 29, 33, 34], "1683073521514889": 15, "7683073521514903": 15, "normal_second_loss": 15, "n2": [15, 32], "n2_bar": 15, "33": [15, 18, 20, 33, 34], "34": [15, 29, 34], "21486028212500707": 15, "765139717874998": 15, "lognormal_loss": 15, "ln": 15, "102": 15, "28364973888106326": 15, "5544912009711833": 15, "exponential_loss": 15, "exponenti": [15, 24], "exp": [15, 20, 33], "457": 15, "foundat": [15, 19, 20, 34], "mcgraw": [15, 19, 20, 34], "hill": [15, 19, 20, 34], "0936537653899085": 15, "09365376538990855": 15, "exponential_second_loss": 15, "19": [15, 34], "var": [15, 24], "20": [15, 18, 19, 21, 29, 32, 33, 34], "46826882694954": 15, "031731173050459915": 15, "gamma_loss": 15, "gamma": [15, 19, 20], "shape": 15, "scale": 15, "pdf": [15, 20], "xf": 15, "respect": [15, 19, 20, 24, 34], "635971381157268": 15, "gamma_second_loss": 15, "280288386513346": 15, "7197116134866537": 15, "uniform_loss": [15, 24], "3333333333333333": 15, "uniform_second_loss": 15, "7777777777777777": 15, "2222222222222222": 15, "continuous_loss": [15, 24], "distrib": 15, "int_x": 15, "dy": [15, 21], "int_": 15, "math": [15, 19, 20, 33, 34, 35], "my_exp": 15, "def": [15, 34], "_pdf": 15, "els": 15, "my_dist": 15, "013533528323661264": 15, "10522318598177341": 15, "Or": [15, 29, 32, 33], "frozen": [15, 24], "built": [15, 32, 34], "expon": 15, "013533528103402742": 15, "11353352830366131": 15, "give": [15, 19, 32, 33], "slightli": 15, "continuous_second_loss": 15, "int_0": 15, "0013533528323661267": 15, "007824431159359786": 15, "001353352589297054": 15, "008646647165633875": 15, "poisson_loss": 15, "poi": 15, "42": [15, 29, 32, 34], "5176095282584724": 15, "5176095282584723": 15, "poisson_second_loss": 15, "848340302917789": 15, "651659697082211": 15, "geometric_loss": 15, "geometr": 15, "geom": [15, 33], "version": [15, 20, 33], "success": 15, "failur": 15, "0485760000000004": 15, "0485760000000006": 15, "geometric_second_loss": 15, "194304000000002": 15, "805695999999998": 15, "negative_binomial_loss": 15, "binomi": 15, "nb": 15, "choos": 15, "doc": 15, "nbinom": 15, "html": 15, "bernoulli": 15, "stop": 15, "447304632028364": 15, "326459980156931": 15, "32645998015693145": 15, "negative_binomial_second_loss": 15, "2r": 15, "877804945158942": 15, "122195054841043": 15, "67": [15, 34], "10108087745232": 15, "8989191225476816": 15, "discrete_loss": [15, 24], "36": [15, 34], "my_geom": 15, "_pmf": 15, "np": [15, 20, 24], "0479999999999743": 15, "048": 15, "discrete_second_loss": 15, "38": [15, 21, 24, 34], "relat": 16, "golden_section_search": 16, "section_search": 16, "reus": 16, "minim": [16, 18, 19, 20], "lambda": [16, 18, 21, 24, 32, 34], "fx": 16, "0000005374905": 16, "888960377059731e": 16, "x_star": 16, "f_star": 16, "variant": [18, 20, 33], "economic_order_quant": [18, 29, 33], "fixed_cost": [18, 19, 21, 23, 24, 25, 29, 33], "demand_r": [18, 24, 29, 33, 35], "sqrt": [18, 21, 23, 24, 34, 35], "2k": [18, 21], "hq": [18, 21, 24], "225": [18, 21, 24, 29, 33, 35], "1300": [18, 21, 24, 29, 33, 35], "304": [18, 21, 29, 33], "0467800264368": [18, 21, 29, 33], "41052550594829": [18, 29, 33], "economic_order_quantity_with_backord": 18, "stockout_fract": 18, "fraction": 18, "hp": [18, 21], "pqx": 18, "310": 18, "81255515896464": 18, "0430622009569378": 18, "66": [18, 19], "92136355097325": 18, "economic_production_quant": 18, "production_r": 18, "rho": 18, "1700": 18, "626": 18, "8084945889684": 18, "183979125298336": 18, "joint_replenishment_problem_silver_heurist": [18, 33], "shared_fixed_cost": [18, 33], "individual_fixed_cost": [18, 33], "joint": [18, 33], "replenish": [18, 33], "share": 18, "k_n": 18, "h_n": 18, "lambda_n": 18, "q_n": 18, "base_cycle_tim": 18, "order_multipl": 18, "m_n": 18, "m_": 18, "h_": 18, "lambda_": 18, "k_": 18, "h_nm_n": 18, "tm_n": 18, "600": [18, 33], "120": [18, 25, 29, 33], "840": [18, 33], "300": [18, 21, 33], "160": [18, 33], "103164454170876": [18, 33], "309493362512628": [18, 33], "837": [18, 33], "8544026261366": [18, 33], "finite_horizon_dp": [19, 29, 33], "terminal_holding_cost": 19, "terminal_stockout_cost": 19, "demand_sd": [19, 20, 21, 23, 29, 33], "discount_factor": [19, 20], "trunc_tol": 19, "02": [19, 34], "d_spread": 19, "s_spread": 19, "discount": [19, 20], "_t": [19, 20], "action": 19, "matric": 19, "cost_matrix": 19, "total_cost": [19, 29, 34], "x_rang": 19, "theta_t": [19, 25], "column": [19, 27, 34], "oul_matrix": 19, "theta_": [19, 25], "h_t": [19, 20], "p_t": [19, 20], "former": [19, 25], "mix": [19, 25], "scalar": [19, 25], "_5": 19, "done": 19, "suboptim": 19, "detail": [19, 34], "straightforward": 19, "87": [19, 21, 33, 34], "recalcul": 19, "don": 19, "computation": 19, "expens": 19, "factor": [19, 20], "d_rang": 19, "s_t": 19, "x_": 19, "estim": 19, "theta_1": 19, "matrix": 19, "il_t": 19, "act": 19, "thereaft": 19, "vector": 19, "min_": [19, 25], "ge": [19, 20, 24], "delta": 19, "mathbb": 19, "_d": 19, "pm": [19, 26, 34], "conserv": 19, "variat": 19, "across": [19, 26], "q_": 19, "buffer": 19, "final": [19, 34], "further": 19, "fall": 19, "suggest": 19, "uppper": 19, "too": 19, "doubl": 19, "could": 19, "bring": 19, "reason": 19, "bump": 19, "against": 19, "user": 19, "wish": [19, 32], "try": 19, "again": [19, 34], "110": [19, 29, 33], "111": [19, 29, 33], "133": [19, 29, 33], "126": [19, 21, 29, 33], "1558": 19, "6946467384012": 19, "myopic_bound": 19, "myopic": [19, 20], "denot": [19, 20, 34], "analog": 19, "s_underbar": 19, "s_5": 19, "s_overbar": 19, "invalid": 19, "g_t": [19, 20], "gamma_tk_": 19, "le": [19, 20, 25], "k_t": 19, "g_i": [19, 20], "veinott": [19, 20], "1966": [19, 20], "fourth": 19, "jr": [19, 20], "condit": [19, 20, 25], "proof": [19, 20], "siam": [19, 20], "appl": [19, 20], "1067": [19, 20], "1083": [19, 20], "36782387894158": 19, "191": 19, "66022942788436": 19, "26036848597217": 19, "newsvendor_norm": [20, 29, 33], "z_": [20, 21, 26, 34], "pn": [20, 21], "70": [20, 23, 25, 29, 33, 34], "56": [20, 29, 33], "60395592743389": [20, 29, 33], "9976051931766445": [20, 29, 33], "newsvendor_normal_cost": [20, 33], "156131552870387": 20, "newsvendor_poisson": [20, 33], "797235211809178": [20, 33], "newsvendor_poisson_cost": 20, "newsvendor_continu": [20, 33], "demand_distrib": [20, 33], "demand_pdf": [20, 23], "norm": [20, 34], "997605188935892": 20, "35613154776623": 20, "1765": 20, "295": 20, "6266448071368": 20, "44254351324322": 20, "newsvendor_discret": [20, 33], "demand_pmf": [20, 23, 33], "5701069457709416": 20, "590296024616343": 20, "d_val": [20, 33], "zip": [20, 33], "570106945770941": 20, "purchase_cost_next_p": 20, "c_": 20, "c_t": [20, 25], "c_ty": 20, "gamma_tc_": 20, "d_t": 20, "98": 20, "58": 20, "09891883213067": 20, "682411764618777": 20, "62": [20, 32, 34], "850319828088736": 20, "myopic_cost": 20, "726131552870388": 20, "set_myopic_cost_to": 20, "left_half": 20, "distrbut": 20, "394684658734164": 20, "999999999999996": 20, "71": [20, 23, 34], "84861989932769": 20, "newsvendor_normal_explicit": [20, 33], "selling_revenu": [20, 33], "salvage_valu": [20, 33], "profit": [20, 33], "maxim": [20, 33], "sold": 20, "unsold": 20, "v": 20, "bui": 20, "sell": [20, 33], "salvag": [20, 33], "pi": 20, "002394806823354": [20, 33], "r_q_cost": [21, 33], "exact": [21, 23, 32, 33, 34], "tau": 21, "int_r": 21, "328": [21, 33], "150": [21, 25, 29, 33], "78": [21, 33], "07116250928294": 21, "r_q_optimal_r_for_q": 21, "06": [21, 24, 35], "129": [21, 24], "4272799263067": 21, "r_q_eil_approxim": [21, 33], "eil": [21, 33], "oldest": 21, "wide": 21, "known": 21, "date": 21, "back": 21, "1953": [21, 33], "hadlei": [21, 33], "1963": [21, 33], "previou": 21, "epsilon": 21, "qh": 21, "princeton": 21, "univers": 21, "press": 21, "nj": 21, "analysi": 21, "prentic": 21, "englewood": 21, "cliff": 21, "213": [21, 33], "97044213580244": [21, 33], "318": [21, 33], "5901810768729": [21, 33], "95": [21, 34], "45114022285196": 21, "r_q_eoqb_approxim": [21, 33], "1992": [21, 33], "thorough": 21, "explor": 21, "128": [21, 33], "63781442427097": [21, 33], "308": [21, 33], "5737801203754": [21, 33], "r_q_eoqss_approxim": [21, 33], "21": [21, 34], "190": [21, 33], "3369965715624": [21, 33], "r_q_loss_function_approxim": [21, 33], "8670634479628": [21, 33], "4491421980451": [21, 33], "r_q_cost_poisson": 21, "48": [21, 32, 34], "107": [21, 24, 33, 34], "92358063314975": [21, 33], "r_q_poisson_exact": [21, 33], "federgruen": [21, 23, 33], "effici": 21, "comput": [21, 23], "research": [21, 23, 24], "808": 21, "813": 21, "s_s_cost_discret": 23, "use_poisson": [23, 33], "demand_hi": 23, "introduc": 23, "provi": 23, "75": [23, 24, 35], "simpl": 23, "39": [23, 25], "654": 23, "665": 23, "034111561471642": [23, 33], "s_s_discrete_exact": [23, 33], "s_s_power_approxim": [23, 33], "power": [23, 33], "ehrhardt": [23, 33], "mosier": [23, 33], "1984": [23, 33], "revis": 23, "622": 23, "77": 23, "494": 23, "506": 23, "sigma_l": 23, "116": 23, "973": 23, "mu_l": 23, "183": 23, "063": 23, "192z": 23, "eq": 23, "ss_power_approx3": 23, "2_l": 23, "2l": 23, "19461695647407": [23, 33], "74": [23, 33, 34], "29017010980579": [23, 33], "eoq_with_disrupt": [24, 35], "disruption_r": [24, 35], "recovery_r": [24, 35], "eoqd": [24, 35], "parlar": [24, 35], "berkin": [24, 35], "berk": [24, 35], "arreola": [24, 35], "risa": [24, 35], "2014": [24, 35], "2d": 24, "pd": 24, "psi": 24, "2h": 24, "kd": 24, "2p": 24, "dh": 24, "futur": 24, "naval": 24, "logist": 24, "121": 24, "132": 24, "tight": 24, "continuousreview": 24, "155": 24, "91": 24, "108": 24, "772": [24, 35], "8110739983106": [24, 35], "173": [24, 35], "95000257319708": [24, 35], "773": [24, 35], "1432417118889": [24, 35], "957229385175": [24, 35], "eoq_with_disruptions_cost": 24, "700": 24, "174": 24, "78711738886236": 24, "80614234644133": 24, "newsvendor_with_disrupt": [24, 35], "lemma": 24, "df": 24, "pi_n": 24, "pi_0": 24, "quad": 24, "04": [24, 34, 35], "8000": [24, 34], "2737": 24, "0689302470355": 24, "1200": 24, "5710": 24, "344790717086": 24, "eoq_with_additive_yield_uncertainti": [24, 35], "yield_mean": [24, 35], "yield_sd": [24, 35], "2kd": 24, "18500": [24, 35], "75000": [24, 35], "15000": [24, 35], "9000": [24, 35], "230246": [24, 35], "37046881882": [24, 35], "12914": [24, 35], "78222812913": [24, 35], "300000": 24, "13426": 24, "947368421053": 24, "eoq_with_multiplicative_yield_uncertainti": [24, 35], "qe": 24, "2e": 24, "8333": [24, 35], "0198": [24, 35], "254477": [24, 35], "46130342316": [24, 35], "13086": [24, 35], "16169098594": [24, 35], "13263": 24, "770562822512": 24, "newsvendor_with_additive_yield_uncertainti": [24, 35], "yield_distribut": [24, 35], "f_y": 24, "hn": 24, "5e6": 24, "500000": [24, 35], "1000000": [24, 35], "1833333": [24, 35], "3333333335": [24, 35], "6249999": [24, 35], "997499999": [24, 35], "6250000": 24, "000000001": 24, "costs_to_go": 25, "go": [25, 29, 33], "theta": [25, 29, 33], "next_order_period": 25, "d_i": 25, "500": [25, 29, 33], "90": [25, 29, 33], "210": [25, 29, 33], "1380": [25, 29, 33], "940": [25, 29, 33], "640": [25, 29, 33], "rand_se": [26, 29, 34], "consistency_check": 26, "what": [26, 29], "No": 26, "w": 26, "dump": 26, "wf": 26, "ef": 26, "run_multiple_tri": [26, 34], "num_trial": [26, 34], "sem": [26, 34], "averag": [26, 29, 34], "confid": [26, 34], "mean_cost": [26, 34], "sem_cost": [26, 34], "main": 27, "write_result": [27, 34], "stdout": 27, "csv": [27, 34], "request": 27, "format": [27, 34], "disr": [27, 34], "io": [27, 34], "iopl": [27, 34], "pipelin": [27, 34], "succesor": [27, 34], "oq": [27, 34], "oo": [27, 34], "IS": [27, 34], "ispl": [27, 34], "idi": [27, 34], "rm": [27, 34], "os": [27, 34], "dmf": [27, 34], "fr": [27, 34], "bo": [27, 34], "ow": [27, 34], "odi": [27, 34], "hc": [27, 34], "sc": [27, 34], "ithc": [27, 34], "rev": [27, 34], "tc": [27, 34], "ext": [27, 34], "periods_to_print": [27, 34], "columns_to_print": [27, 34], "write_csv": 27, "csv_filenam": 27, "consol": [27, 34], "middl": 27, "skip": 27, "abbrevi": 27, "altern": [27, 32, 34, 35], "shortcut": [27, 34], "unrecogn": 27, "filenam": 27, "write_instance_and_st": 27, "histori": 27, "mostli": [27, 34], "python": [29, 32], "classic": 29, "assumpt": 29, "And": [29, 32, 34], "extens": 29, "featur": [29, 31], "shorter": 29, "textbook": 29, "articl": 29, "h_termin": [29, 33], "p_termin": [29, 33], "precis": 29, "rework": 29, "44": 29, "1689463285519": 29, "93248526934437": 29, "69602421013684": 29, "227": 29, "15328525645054": 29, "theoret": 29, "predict": [29, 34], "s_star_loc": 29, "226": 29, "16794575837224": 29, "acycl": 29, "instal": 29, "sequenc": [29, 31], "event": [29, 31], "advanc": [29, 31], "api": [29, 34], "pypi": 30, "pip": 30, "tutorial_meio": 32, "my_nod": 32, "my_other_nod": 32, "other_nod": 32, "now": [32, 34], "access": 32, "member": 32, "n1": 32, "quickli": 32, "certain": [32, 34], "serial_3": 32, "There": 32, "inform": [32, 34], "example_6_1_network": 32, "example_6_3_network": 32, "snippet": 32, "example_6_5_network": 32, "candid": 32, "obvious": 32, "much": 32, "slower": 32, "control": [32, 34], "veri": [32, 34], "coars": 32, "small": 32, "994095842987605": 32, "good": [32, 34], "wors": [32, 34], "although": 32, "stack": 32, "deck": 32, "pretti": [32, 34], "narrow": 32, "fairer": 32, "experi": 32, "would": [32, 34], "broader": 32, "accuraci": 32, "still": [32, 34], "trivial": 32, "produc": [32, 34], "inaccur": 32, "obj_fcn": 32, "21449789525488": 32, "principl": 32, "global": 32, "jointli": 32, "convex": 32, "762": 32, "5135882931757045": 32, "758375187638261": 32, "0631099655841": 32, "90365729191992": 32, "892036436905893": 32, "995771265226075": 32, "99995914365099": 32, "33491040676202": 32, "want": 33, "53": 33, "223748044859164": 33, "overag": 33, "underag": 33, "519": 33, "3023987673176": 33, "198": 33, "42277610622506": 33, "194304": 33, "19102133030678": 33, "r_eil": 33, "q_eil": 33, "r_eoqb": 33, "q_eoqb": 33, "r_eoqss": 33, "q_eoqss": 33, "r_lf": 33, "q_lf": 33, "92": 33, "28687665608078": 33, "20243187688158": 33, "04837003438256": 33, "07114627035178": 33, "vari": 33, "270": 33, "1020": 33, "varieti": 34, "your": 34, "own": 34, "variou": 34, "implic": 34, "interpret": 34, "send": 34, "At": 34, "occur": 34, "header": 34, "o_i": 34, "earlier": 34, "sent": 34, "s_i": 34, "ago": 34, "soe": 34, "somewhat": 34, "atyp": 34, "common": 34, "step": 34, "swap": 34, "howev": 34, "hyperlink": 34, "Then": 34, "move": 34, "commonli": 34, "aris": 34, "paper": 34, "bullwhip": 34, "ref": 34, "never": 34, "out": 34, "larg": 34, "soon": 34, "revers": 34, "flexibl": 34, "sens": 34, "equivalentlli": 34, "57": 34, "9906261152138731": 34, "close": 34, "0000": 34, "264": 34, "475292852532866": 34, "exogen": 34, "creation": 34, "relev": 34, "manual": 34, "someth": 34, "suffici": 34, "26": 34, "face": 34, "serv": 34, "shown": 34, "Its": 34, "began": 34, "show": 34, "insuffici": 34, "reflect": 34, "were": 34, "worth": 34, "finish": 34, "remain": 34, "7692307692307693": 34, "8695652173913043": 34, "90625": 34, "9555555555555556": 34, "9210526315789473": 34, "9152542372881356": 34, "9183673469387755": 34, "9264705882352942": 34, "9166666666666666": 34, "9342105263157895": 34, "9285714285714286": 34, "9411764705882353": 34, "8823529411764706": 34, "9803921568627451": 34, "9484536082474226": 34, "51": 34, "8333333333333334": 34, "85": 34, "9519230769230769": 34, "55": 34, "8050847457627118": 34, "download": 34, "10000": 34, "2831": 34, "four": 34, "104": 34, "79": 34, "awar": 34, "upcom": 34, "categori": 34, "evid": 34, "increas": 34, "clear": 34, "65": 34, "82": 34, "prevent": 34, "often": 34, "kept": 34, "sytem": 34, "report": 34, "259837154163556": 34, "As": 34, "equiv": 34, "1421": 34, "statist": 34, "s_opt": 34, "s_opt_loc": 34, "mean_opt": 34, "sem_opt": 34, "78528000921442": 34, "26119040852187103": 34, "s_heur_loc": 34, "mean_heur": 34, "sem_heur": 34, "789138050714946": 34, "27039814681794694": 34, "ppf": 34, "lo_opt": 34, "hi_opt": 34, "lo_heur": 34, "hi_heur": 34, "ci": 34, "27335621540425": 34, "29720380302459": 34, "2591674214654": 34, "31910867996449": 34, "overlap": 34, "sai": 34, "Of": 34, "cours": 34, "randomli": 35, "74000": 35, "25317": 35, "887604785075": 35, "1500000": 35, "250000": 35, "200000": 35, "1443484": 35, "3132203403": 35, "4497316": 35, "9310527835": 35}, "objects": {"stockpyl": [[2, 0, 0, "-", "demand_source"], [3, 0, 0, "-", "disruption_process"], [18, 0, 0, "-", "eoq"], [19, 0, 0, "-", "finite_horizon"], [7, 0, 0, "-", "gsm_helpers"], [8, 0, 0, "-", "gsm_serial"], [9, 0, 0, "-", "gsm_tree"], [13, 0, 0, "-", "helpers"], [14, 0, 0, "-", "instances"], [15, 0, 0, "-", "loss_functions"], [11, 0, 0, "-", "meio_general"], [20, 0, 0, "-", "newsvendor"], [16, 0, 0, "-", "optimization"], [4, 0, 0, "-", "policy"], [21, 0, 0, "-", "rq"], [26, 0, 0, "-", "sim"], [27, 0, 0, "-", "sim_io"], [23, 0, 0, "-", "ss"], [12, 0, 0, "-", "ssm_serial"], [5, 0, 0, "-", "supply_chain_network"], [6, 0, 0, "-", "supply_chain_node"], [24, 0, 0, "-", "supply_uncertainty"], [25, 0, 0, "-", "wagner_whitin"]], "stockpyl.demand_source": [[2, 1, 1, "", "DemandSource"]], "stockpyl.demand_source.DemandSource": [[2, 2, 1, "", "cdf"], [2, 3, 1, "", "demand_distribution"], [2, 4, 1, "", "demand_list"], [2, 2, 1, "", "from_dict"], [2, 2, 1, "", "generate_demand"], [2, 4, 1, "", "hi"], [2, 2, 1, "", "initialize"], [2, 2, 1, "", "lead_time_demand_distribution"], [2, 4, 1, "", "lo"], [2, 4, 1, "", "mean"], [2, 4, 1, "", "probabilities"], [2, 4, 1, "", "round_to_int"], [2, 4, 1, "", "standard_deviation"], [2, 2, 1, "", "to_dict"], [2, 4, 1, "", "type"], [2, 2, 1, "", "validate_parameters"]], "stockpyl.disruption_process": [[3, 1, 1, "", "DisruptionProcess"]], "stockpyl.disruption_process.DisruptionProcess": [[3, 4, 1, "", "disrupted"], [3, 4, 1, "", "disruption_probability"], [3, 4, 1, "", "disruption_state_list"], [3, 4, 1, "", "disruption_type"], [3, 2, 1, "", "from_dict"], [3, 2, 1, "", "initialize"], [3, 4, 1, "", "random_process_type"], [3, 4, 1, "", "recovery_probability"], [3, 2, 1, "", "steady_state_probabilities"], [3, 2, 1, "", "to_dict"], [3, 2, 1, "", "update_disruption_state"], [3, 2, 1, "", "validate_parameters"]], "stockpyl.eoq": [[18, 5, 1, "", "economic_order_quantity"], [18, 5, 1, "", "economic_order_quantity_with_backorders"], [18, 5, 1, "", "economic_production_quantity"], [18, 5, 1, "", "joint_replenishment_problem_silver_heuristic"]], "stockpyl.finite_horizon": [[19, 5, 1, "", "finite_horizon_dp"], [19, 5, 1, "", "myopic_bounds"]], "stockpyl.gsm_helpers": [[7, 5, 1, "", "cst_to_base_stock_levels"], [7, 5, 1, "", "inbound_cst"], [7, 5, 1, "", "net_lead_time"], [7, 5, 1, "", "safety_stock_levels"], [7, 5, 1, "", "solution_cost_from_base_stock_levels"], [7, 5, 1, "", "solution_cost_from_cst"]], "stockpyl.gsm_serial": [[8, 5, 1, "", "optimize_committed_service_times"]], "stockpyl.gsm_tree": [[9, 5, 1, "", "gsm_to_ssm"], [9, 5, 1, "", "is_correctly_labeled"], [9, 5, 1, "", "optimize_committed_service_times"], [9, 5, 1, "", "preprocess_tree"], [9, 5, 1, "", "relabel_nodes"]], "stockpyl.helpers": [[13, 5, 1, "", "build_node_data_dict"], [13, 5, 1, "", "change_dict_key"], [13, 5, 1, "", "check_iterable_sizes"], [13, 5, 1, "", "convolve_many"], [13, 5, 1, "", "dict_match"], [13, 5, 1, "", "ensure_dict_for_nodes"], [13, 5, 1, "", "ensure_list_for_nodes"], [13, 5, 1, "", "ensure_list_for_time_periods"], [13, 5, 1, "", "find_nearest"], [13, 5, 1, "", "irwin_hall_cdf"], [13, 5, 1, "", "is_continuous_distribution"], [13, 5, 1, "", "is_discrete_distribution"], [13, 5, 1, "", "is_integer"], [13, 5, 1, "", "is_iterable"], [13, 5, 1, "", "is_list"], [13, 5, 1, "", "min_of_dict"], [13, 5, 1, "", "round_dict_values"], [13, 5, 1, "", "sort_dict_by_keys"], [13, 5, 1, "", "sum_of_continuous_uniforms_distribution"], [13, 5, 1, "", "sum_of_discrete_uniforms_distribution"], [13, 5, 1, "", "sum_of_discrete_uniforms_pmf"], [13, 5, 1, "", "sum_of_discretes_distribution"]], "stockpyl.instances": [[14, 5, 1, "", "load_instance"], [14, 5, 1, "", "save_instance"]], "stockpyl.loss_functions": [[15, 5, 1, "", "continuous_loss"], [15, 5, 1, "", "continuous_second_loss"], [15, 5, 1, "", "discrete_loss"], [15, 5, 1, "", "discrete_second_loss"], [15, 5, 1, "", "exponential_loss"], [15, 5, 1, "", "exponential_second_loss"], [15, 5, 1, "", "gamma_loss"], [15, 5, 1, "", "gamma_second_loss"], [15, 5, 1, "", "geometric_loss"], [15, 5, 1, "", "geometric_second_loss"], [15, 5, 1, "", "lognormal_loss"], [15, 5, 1, "", "negative_binomial_loss"], [15, 5, 1, "", "negative_binomial_second_loss"], [15, 5, 1, "", "normal_loss"], [15, 5, 1, "", "normal_second_loss"], [15, 5, 1, "", "poisson_loss"], [15, 5, 1, "", "poisson_second_loss"], [15, 5, 1, "", "standard_normal_loss"], [15, 5, 1, "", "standard_normal_second_loss"], [15, 5, 1, "", "uniform_loss"], [15, 5, 1, "", "uniform_second_loss"]], "stockpyl.meio_general": [[11, 5, 1, "", "base_stock_level_bisection_search"], [11, 5, 1, "", "meio_by_coordinate_descent"], [11, 5, 1, "", "meio_by_enumeration"], [11, 5, 1, "", "truncate_and_discretize"]], "stockpyl.newsvendor": [[20, 5, 1, "", "myopic"], [20, 5, 1, "", "myopic_cost"], [20, 5, 1, "", "newsvendor_continuous"], [20, 5, 1, "", "newsvendor_discrete"], [20, 5, 1, "", "newsvendor_normal"], [20, 5, 1, "", "newsvendor_normal_cost"], [20, 5, 1, "", "newsvendor_normal_explicit"], [20, 5, 1, "", "newsvendor_poisson"], [20, 5, 1, "", "newsvendor_poisson_cost"], [20, 5, 1, "", "set_myopic_cost_to"]], "stockpyl.optimization": [[16, 5, 1, "", "golden_section_search"]], "stockpyl.policy": [[4, 1, 1, "", "Policy"]], "stockpyl.policy.Policy": [[4, 4, 1, "", "base_stock_level"], [4, 2, 1, "", "from_dict"], [4, 2, 1, "", "get_order_quantity"], [4, 2, 1, "", "initialize"], [4, 4, 1, "", "node"], [4, 4, 1, "", "order_quantity"], [4, 4, 1, "", "order_up_to_level"], [4, 4, 1, "", "reorder_point"], [4, 2, 1, "", "to_dict"], [4, 4, 1, "", "type"], [4, 2, 1, "", "validate_parameters"]], "stockpyl.rq": [[21, 5, 1, "", "r_q_cost"], [21, 5, 1, "", "r_q_cost_poisson"], [21, 5, 1, "", "r_q_eil_approximation"], [21, 5, 1, "", "r_q_eoqb_approximation"], [21, 5, 1, "", "r_q_eoqss_approximation"], [21, 5, 1, "", "r_q_loss_function_approximation"], [21, 5, 1, "", "r_q_optimal_r_for_q"], [21, 5, 1, "", "r_q_poisson_exact"]], "stockpyl.sim": [[26, 5, 1, "", "run_multiple_trials"], [26, 5, 1, "", "simulation"]], "stockpyl.sim_io": [[27, 5, 1, "", "write_instance_and_states"], [27, 5, 1, "", "write_results"]], "stockpyl.ss": [[23, 5, 1, "", "s_s_cost_discrete"], [23, 5, 1, "", "s_s_discrete_exact"], [23, 5, 1, "", "s_s_power_approximation"]], "stockpyl.ssm_serial": [[12, 5, 1, "", "expected_cost"], [12, 5, 1, "", "expected_holding_cost"], [12, 5, 1, "", "newsvendor_heuristic"], [12, 5, 1, "", "optimize_base_stock_levels"]], "stockpyl.supply_chain_network": [[5, 1, 1, "", "SupplyChainNetwork"], [5, 5, 1, "", "echelon_to_local_base_stock_levels"], [5, 5, 1, "", "local_to_echelon_base_stock_levels"], [5, 5, 1, "", "mwor_system"], [5, 5, 1, "", "network_from_edges"], [5, 5, 1, "", "owmr_system"], [5, 5, 1, "", "serial_system"], [5, 5, 1, "", "single_stage_system"]], "stockpyl.supply_chain_network.SupplyChainNetwork": [[5, 2, 1, "", "add_edge"], [5, 2, 1, "", "add_edges_from_list"], [5, 2, 1, "", "add_node"], [5, 2, 1, "", "add_predecessor"], [5, 2, 1, "", "add_successor"], [5, 2, 1, "", "deep_equal_to"], [5, 3, 1, "", "edges"], [5, 2, 1, "", "from_dict"], [5, 2, 1, "", "get_node_from_index"], [5, 2, 1, "", "has_directed_cycle"], [5, 2, 1, "", "initialize"], [5, 4, 1, "", "max_max_replenishment_time"], [5, 2, 1, "", "networkx_digraph"], [5, 3, 1, "", "node_indices"], [5, 3, 1, "", "nodes"], [5, 4, 1, "", "period"], [5, 4, 1, "", "problem_specific_data"], [5, 2, 1, "", "reindex_nodes"], [5, 2, 1, "", "remove_node"], [5, 3, 1, "", "sink_nodes"], [5, 3, 1, "", "source_nodes"], [5, 2, 1, "", "to_dict"]], "stockpyl.supply_chain_node": [[6, 1, 1, "", "NodeStateVars"], [6, 1, 1, "", "SupplyChainNode"]], "stockpyl.supply_chain_node.NodeStateVars": [[6, 3, 1, "", "backorders"], [6, 4, 1, "", "backorders_by_successor"], [6, 2, 1, "", "deep_equal_to"], [6, 4, 1, "", "demand_cumul"], [6, 4, 1, "", "demand_met_from_stock"], [6, 4, 1, "", "demand_met_from_stock_cumul"], [6, 4, 1, "", "disrupted"], [6, 3, 1, "", "echelon_inventory_level"], [6, 2, 1, "", "echelon_inventory_position"], [6, 3, 1, "", "echelon_on_hand_inventory"], [6, 4, 1, "", "fill_rate"], [6, 2, 1, "", "from_dict"], [6, 4, 1, "", "holding_cost_incurred"], [6, 3, 1, "", "in_transit"], [6, 2, 1, "", "in_transit_from"], [6, 4, 1, "", "in_transit_holding_cost_incurred"], [6, 2, 1, "", "in_transit_to"], [6, 4, 1, "", "inbound_disrupted_items"], [6, 3, 1, "", "inbound_disrupted_items_aggregate"], [6, 4, 1, "", "inbound_order"], [6, 4, 1, "", "inbound_order_pipeline"], [6, 4, 1, "", "inbound_shipment"], [6, 4, 1, "", "inbound_shipment_pipeline"], [6, 4, 1, "", "inventory_level"], [6, 2, 1, "", "inventory_position"], [6, 4, 1, "", "node"], [6, 3, 1, "", "on_hand"], [6, 3, 1, "", "on_order"], [6, 4, 1, "", "on_order_by_predecessor"], [6, 4, 1, "", "order_quantity"], [6, 4, 1, "", "outbound_disrupted_items"], [6, 4, 1, "", "outbound_shipment"], [6, 4, 1, "", "period"], [6, 3, 1, "", "raw_material_aggregate"], [6, 4, 1, "", "raw_material_inventory"], [6, 2, 1, "", "reindex_state_variables"], [6, 4, 1, "", "revenue_earned"], [6, 4, 1, "", "stockout_cost_incurred"], [6, 2, 1, "", "to_dict"], [6, 4, 1, "", "total_cost_incurred"]], "stockpyl.supply_chain_node.SupplyChainNode": [[6, 2, 1, "", "add_predecessor"], [6, 2, 1, "", "add_successor"], [6, 3, 1, "", "ancestors"], [6, 2, 1, "", "deep_equal_to"], [6, 4, 1, "", "demand_source"], [6, 3, 1, "", "derived_demand_mean"], [6, 3, 1, "", "derived_demand_standard_deviation"], [6, 3, 1, "", "descendants"], [6, 3, 1, "", "disrupted"], [6, 4, 1, "", "disruption_process"], [6, 4, 1, "", "echelon_holding_cost"], [6, 3, 1, "", "equivalent_lead_time"], [6, 3, 1, "", "forward_echelon_lead_time"], [6, 2, 1, "", "from_dict"], [6, 2, 1, "", "get_one_predecessor"], [6, 2, 1, "", "get_one_successor"], [6, 3, 1, "", "holding_cost"], [6, 4, 1, "", "in_transit_holding_cost"], [6, 4, 1, "", "initial_inventory_level"], [6, 4, 1, "", "initial_orders"], [6, 2, 1, "", "initialize"], [6, 4, 1, "", "inventory_policy"], [6, 4, 1, "", "lead_time"], [6, 4, 1, "", "local_holding_cost"], [6, 4, 1, "", "local_holding_cost_function"], [6, 3, 1, "", "neighbor_indices"], [6, 3, 1, "", "neighbors"], [6, 4, 1, "", "network"], [6, 4, 1, "", "order_lead_time"], [6, 2, 1, "", "predecessor_indices"], [6, 2, 1, "", "predecessors"], [6, 4, 1, "", "problem_specific_data"], [6, 4, 1, "", "purchase_cost"], [6, 2, 1, "", "reindex_all_state_variables"], [6, 2, 1, "", "remove_predecessor"], [6, 2, 1, "", "remove_successor"], [6, 4, 1, "", "revenue"], [6, 4, 1, "", "shipment_lead_time"], [6, 4, 1, "", "state_vars"], [6, 3, 1, "", "state_vars_current"], [6, 4, 1, "", "stockout_cost"], [6, 4, 1, "", "stockout_cost_function"], [6, 2, 1, "", "successor_indices"], [6, 2, 1, "", "successors"], [6, 4, 1, "", "supply_type"], [6, 2, 1, "", "to_dict"]], "stockpyl.supply_uncertainty": [[24, 5, 1, "", "eoq_with_additive_yield_uncertainty"], [24, 5, 1, "", "eoq_with_disruptions"], [24, 5, 1, "", "eoq_with_disruptions_cost"], [24, 5, 1, "", "eoq_with_multiplicative_yield_uncertainty"], [24, 5, 1, "", "newsvendor_with_additive_yield_uncertainty"], [24, 5, 1, "", "newsvendor_with_disruptions"]], "stockpyl.wagner_whitin": [[25, 5, 1, "", "wagner_whitin"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:property", "4": "py:attribute", "5": "py:function"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "property", "Python property"], "4": ["py", "attribute", "Python attribute"], "5": ["py", "function", "Python function"]}, "titleterms": {"api": [0, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27], "document": [0, 29], "content": [0, 1, 10, 17, 22, 28, 29, 32, 33, 34, 35], "data": [1, 34], "type": 1, "demand_sourc": 2, "modul": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27], "overview": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27], "refer": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 23, 24, 25, 26, 27, 34], "disruption_process": 3, "polici": [4, 34], "supply_chain_network": 5, "supply_chain_nod": 6, "gsm_helper": 7, "see": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "also": [7, 8, 9, 10, 11, 12, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34], "gsm_serial": 8, "gsm_tree": 9, "multi": [10, 32], "echelon": [10, 22, 32, 33], "inventori": [10, 22, 32, 33, 34], "optim": [10, 16, 22, 32, 33], "meio_gener": 11, "ssm_serial": 12, "helper": 13, "instanc": 14, "built": 14, "In": 14, "loss_funct": 15, "other": 17, "eoq": [18, 33, 35], "finite_horizon": 19, "newsvendor": [20, 33, 35], "rq": 21, "singl": [22, 33], "ss": 23, "supply_uncertainti": 24, "wagner_whitin": 25, "sim": 26, "sim_io": 27, "simul": [28, 34], "stockpyl": [29, 30, 31], "some": 29, "exampl": [29, 34], "indic": 29, "tabl": 29, "instal": 30, "tutori": 31, "The": [32, 33, 35], "supplychainnetwork": 32, "class": 32, "serial": 32, "ssm": 32, "system": 32, "tree": 32, "gsm": 32, "gener": 32, "meio": 32, "problem": [33, 35], "r": 33, "q": 33, "s": 33, "wagner": 33, "whitin": 33, "finit": 33, "horizon": 33, "stochast": 33, "basic": 34, "structur": 34, "sequenc": 34, "event": 34, "lead": 34, "time": 34, "suppli": [34, 35], "demand": 34, "extern": 34, "custom": 34, "supplier": 34, "displai": 34, "result": 34, "advanc": 34, "featur": 34, "disrupt": [34, 35], "convert": 34, "from": 34, "continu": 34, "review": 34, "hold": 34, "stockout": 34, "cost": 34, "function": 34, "run": 34, "multipl": 34, "trial": 34, "uncertainti": 35, "yield": 35}, "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": 56}})
\ No newline at end of file