From 08dd751aebfc2d02c6875fe812787468752f3a51 Mon Sep 17 00:00:00 2001
From: Hofer-Julian <Hofer-Julian@users.noreply.github.com>
Date: Tue, 14 Nov 2023 08:57:11 +0000
Subject: [PATCH] deploy: 073c089befaf4ea852e55a5bcc5a1f0bbda96dec

---
 build/index.html                              | 258 +++++++++---------
 core/equations.html                           |   2 +-
 python/examples.html                          |   2 +-
 .../figure-html/cell-55-output-1.png          | Bin 70967 -> 71077 bytes
 search.json                                   |   4 +-
 5 files changed, 133 insertions(+), 133 deletions(-)

diff --git a/build/index.html b/build/index.html
index fce0d549b..81df2d423 100644
--- a/build/index.html
+++ b/build/index.html
@@ -262,11 +262,11 @@ <h2 data-number="1.1" class="anchored" data-anchor-id="modules"><span class="hea
 <li><a href="../build/index.html#CommonSolve.solve!-Tuple{Ribasim.Model}"><code>solve!</code></a></li>
 <li><a href="../build/index.html#BasicModelInterface.finalize-Tuple{Ribasim.Model}"><code>BMI.finalize</code></a></li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/Ribasim.jl#LL1-L14" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/Ribasim.jl#LL1-L14" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.config" href="#Ribasim.config">#</a> <strong><code>Ribasim.config</code></strong> — <em>Module</em>.</p>
 <div class="sourceCode" id="cb2"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="kw">module</span> config</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Ribasim.config is a submodule of <a href="../build/index.html#Ribasim.Ribasim"><code>Ribasim</code></a> to handle the configuration of a Ribasim model. It is implemented using the <a href="https://configurations.rogerluo.dev/stable/">Configurations</a> package. A full configuration is represented by <a href="../build/index.html#Ribasim.config.Config-Tuple{AbstractString}"><code>Config</code></a>, which is the main API. Ribasim.config is a submodule mainly to avoid name clashes between the configuration sections and the rest of Ribasim.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL1-L8" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL1-L8" class="documenter-source">source</a><br></p>
 <p><a id="Types"></a></p>
 <p><a id="Types-1"></a></p>
 </section>
@@ -275,7 +275,7 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 <p><a id="Ribasim.AllocationModel" href="#Ribasim.AllocationModel">#</a> <strong><code>Ribasim.AllocationModel</code></strong> — <em>Type</em>.</p>
 <p>Store information for a subnetwork used for allocation.</p>
 <p>allocation<em>network</em>id: The ID of this allocation network node<em>id: All the IDs of the nodes that are in this subnetwork node</em>id<em>mapping: Mapping Dictionary; model</em>node<em>id =&gt; AG</em>node<em>id where such a correspondence exists (all AG node ids are in the values) node</em>id<em>mapping</em>inverse: The inverse of node<em>id</em>mapping, Dictionary; AG node ID =&gt; model node ID allocgraph<em>edge</em>ids<em>user</em>demand: AG user node ID =&gt; AG user inflow edge ID Source edge mapping: AG source node ID =&gt; subnetwork source edge ID graph<em>allocation: The graph used for the allocation problems capacity: The capacity per edge of the allocation graph, as constrained by nodes that have a max</em>flow<em>rate problem: The JuMP.jl model for solving the allocation problem Δt</em>allocation: The time interval between consecutive allocation solves</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL7-L21" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL7-L21" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.AllocationModel-Tuple{Int64, Ribasim.Parameters, Vector{Int64}, Vector{Int64}, Float64}" href="#Ribasim.AllocationModel-Tuple{Int64, Ribasim.Parameters, Vector{Int64}, Vector{Int64}, Float64}">#</a> <strong><code>Ribasim.AllocationModel</code></strong> — <em>Method</em>.</p>
 <p>Construct the JuMP.jl problem for allocation.</p>
 <p><strong>Definitions</strong></p>
@@ -287,7 +287,7 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 <p>p: Ribasim problem parameters subnetwork<em>node</em>ids: the problem node IDs that are part of the allocation subnetwork source<em>edge</em>ids:: The IDs of the edges in the subnetwork whose flow fill be taken as a source in allocation Δt_allocation: The timestep between successive allocation solves</p>
 <p><strong>Outputs</strong></p>
 <p>An AllocationModel object.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL621-L641" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL621-L641" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Basin" href="#Ribasim.Basin">#</a> <strong><code>Ribasim.Basin</code></strong> — <em>Type</em>.</p>
 <p>Requirements:</p>
 <ul>
@@ -297,24 +297,24 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 </ul>
 <p>Type parameter C indicates the content backing the StructVector, which can be a NamedTuple of vectors or Arrow Tables, and is added to avoid type instabilities. The node<em>id are Indices to support fast lookup of e.g.&nbsp;current</em>level using ID.</p>
 <p>if autodiff T = DiffCache{Vector{Float64}} else T = Vector{Float64} end</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL101-L117" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL101-L117" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Connectivity" href="#Ribasim.Connectivity">#</a> <strong><code>Ribasim.Connectivity</code></strong> — <em>Type</em>.</p>
 <p>Store the connectivity information</p>
 <p>graph<em>flow, graph</em>control: directed graph with vertices equal to ids flow: store the flow on every flow edge edge<em>ids</em>flow, edge<em>ids</em>control: get the external edge id from (src, dst) edge<em>connection</em>type<em>flow, edge</em>connection<em>types</em>control: get (src<em>node</em>type, dst<em>node</em>type) from edge id</p>
 <p>if autodiff T = DiffCache{SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Float64}} else T = SparseMatrixCSC{Float64, Int} end</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL35-L48" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL35-L48" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.DiscreteControl" href="#Ribasim.DiscreteControl">#</a> <strong><code>Ribasim.DiscreteControl</code></strong> — <em>Type</em>.</p>
 <p>node<em>id: node ID of the DiscreteControl node; these are not unique but repeated by the amount of conditions of this DiscreteControl node listen</em>feature<em>id: the ID of the node/edge being condition on variable: the name of the variable in the condition greater</em>than: The threshold value in the condition condition<em>value: The current value of each condition control</em>state: Dictionary: node ID =&gt; (control state, control state start) logic_mapping: Dictionary: (control node ID, truth state) =&gt; control state record: Namedtuple with discrete control information for results</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL390-L400" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL390-L400" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.FlatVector" href="#Ribasim.FlatVector">#</a> <strong><code>Ribasim.FlatVector</code></strong> — <em>Type</em>.</p>
 <div class="sourceCode" id="cb3"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="kw">struct</span> FlatVector{T} <span class="op">&lt;:</span><span class="dt"> AbstractVector{T}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>A FlatVector is an AbstractVector that iterates the T of a <code>Vector{Vector{T}}</code>.</p>
 <p>Each inner vector is assumed to be of equal length.</p>
 <p>It is similar to <code>Iterators.flatten</code>, though that doesn’t work with the <code>Tables.Column</code> interface, which needs <code>length</code> and <code>getindex</code> support.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL876-L885" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL876-L885" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.FlowBoundary" href="#Ribasim.FlowBoundary">#</a> <strong><code>Ribasim.FlowBoundary</code></strong> — <em>Type</em>.</p>
 <p>node<em>id: node ID of the FlowBoundary node active: whether this node is active and thus contributes flow flow</em>rate: target flow rate</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL283-L287" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL283-L287" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.FractionalFlow" href="#Ribasim.FractionalFlow">#</a> <strong><code>Ribasim.FractionalFlow</code></strong> — <em>Type</em>.</p>
 <p>Requirements:</p>
 <ul>
@@ -323,10 +323,10 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 <li>fraction must be positive.</li>
 </ul>
 <p>node<em>id: node ID of the TabulatedRatingCurve node fraction: The fraction in [0,1] of flow the node lets through control</em>mapping: dictionary from (node<em>id, control</em>state) to fraction</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL255-L265" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL255-L265" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.LevelBoundary" href="#Ribasim.LevelBoundary">#</a> <strong><code>Ribasim.LevelBoundary</code></strong> — <em>Type</em>.</p>
 <p>node_id: node ID of the LevelBoundary node active: whether this node is active level: the fixed level of this ‘infinitely big basin’</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL272-L276" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL272-L276" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.LinearResistance" href="#Ribasim.LinearResistance">#</a> <strong><code>Ribasim.LinearResistance</code></strong> — <em>Type</em>.</p>
 <p>Requirements:</p>
 <ul>
@@ -334,7 +334,7 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 <li>to: must be (Basin,) node</li>
 </ul>
 <p>node<em>id: node ID of the LinearResistance node active: whether this node is active and thus contributes flows resistance: the resistance to flow; Q = Δh/resistance control</em>mapping: dictionary from (node<em>id, control</em>state) to resistance and/or active state</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL194-L204" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL194-L204" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.ManningResistance" href="#Ribasim.ManningResistance">#</a> <strong><code>Ribasim.ManningResistance</code></strong> — <em>Type</em>.</p>
 <p>This is a simple Manning-Gauckler reach connection.</p>
 <ul>
@@ -364,39 +364,39 @@ <h2 data-number="1.2" class="anchored" data-anchor-id="types"><span class="heade
 <li>profile_slope &gt;= 0</li>
 <li>(profile<em>width == 0) xor (profile</em>slope == 0)</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL212-L244" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL212-L244" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Model" href="#Ribasim.Model">#</a> <strong><code>Ribasim.Model</code></strong> — <em>Type</em>.</p>
 <div class="sourceCode" id="cb5"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">Model</span>(config_path<span class="op">::</span><span class="dt">AbstractString</span>)</span>
 <span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="fu">Model</span>(config<span class="op">::</span><span class="dt">Config</span>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Initialize a Model.</p>
 <p>The Model struct is an initialized model, combined with the <a href="../build/index.html#Ribasim.config.Config-Tuple{AbstractString}"><code>Config</code></a> used to create it and saved results. The Basic Model Interface (<a href="https://github.com/Deltares/BasicModelInterface.jl">BMI</a>) is implemented on the Model. A Model can be created from the path to a TOML configuration file, or a Config object.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/lib.jl#LL1-L10" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/lib.jl#LL1-L10" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Outlet" href="#Ribasim.Outlet">#</a> <strong><code>Ribasim.Outlet</code></strong> — <em>Type</em>.</p>
 <p>node<em>id: node ID of the Outlet node active: whether this node is active and thus contributes flow flow</em>rate: target flow rate min<em>flow</em>rate: The minimal flow rate of the outlet max<em>flow</em>rate: The maximum flow rate of the outlet control<em>mapping: dictionary from (node</em>id, control<em>state) to target flow rate is</em>pid_controlled: whether the flow rate of this outlet is governed by PID control</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL337-L345" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL337-L345" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.PidControl" href="#Ribasim.PidControl">#</a> <strong><code>Ribasim.PidControl</code></strong> — <em>Type</em>.</p>
 <p>PID control currently only supports regulating basin levels.</p>
 <p>node<em>id: node ID of the PidControl node active: whether this node is active and thus sets flow rates listen</em>node<em>id: the id of the basin being controlled pid</em>params: a vector interpolation for parameters changing over time. The parameters are respectively target, proportional, integral, derivative, where the last three are the coefficients for the PID equation. error: the current error; basin<em>target - current</em>level</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL418-L428" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL418-L428" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Pump" href="#Ribasim.Pump">#</a> <strong><code>Ribasim.Pump</code></strong> — <em>Type</em>.</p>
 <p>node<em>id: node ID of the Pump node active: whether this node is active and thus contributes flow flow</em>rate: target flow rate min<em>flow</em>rate: The minimal flow rate of the pump max<em>flow</em>rate: The maximum flow rate of the pump control<em>mapping: dictionary from (node</em>id, control<em>state) to target flow rate is</em>pid_controlled: whether the flow rate of this pump is governed by PID control</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL294-L302" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL294-L302" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.TabulatedRatingCurve" href="#Ribasim.TabulatedRatingCurve">#</a> <strong><code>Ribasim.TabulatedRatingCurve</code></strong> — <em>Type</em>.</p>
 <div class="sourceCode" id="cb6"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="kw">struct</span> TabulatedRatingCurve{C}</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Rating curve from level to discharge. The rating curve is a lookup table with linear interpolation in between. Relation can be updated in time, which is done by moving data from the <code>time</code> field into the <code>tables</code>, which is done in the <code>update_tabulated_rating_curve</code> callback.</p>
 <p>Type parameter C indicates the content backing the StructVector, which can be a NamedTuple of Vectors or Arrow Primitives, and is added to avoid type instabilities.</p>
 <p>node<em>id: node ID of the TabulatedRatingCurve node active: whether this node is active and thus contributes flows tables: The current Q(h) relationships time: The time table used for updating the tables control</em>mapping: dictionary from (node<em>id, control</em>state) to Q(h) and/or active state</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL169-L185" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL169-L185" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.Terminal" href="#Ribasim.Terminal">#</a> <strong><code>Ribasim.Terminal</code></strong> — <em>Type</em>.</p>
 <p>node_id: node ID of the Terminal node</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL383-L385" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL383-L385" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.User" href="#Ribasim.User">#</a> <strong><code>Ribasim.User</code></strong> — <em>Type</em>.</p>
 <p>demand: water flux demand of user per priority over time active: whether this node is active and thus demands water allocated: water flux currently allocated to user per priority return<em>factor: the factor in [0,1] of how much of the abstracted water is given back to the system min</em>level: The level of the source basin below which the user does not abstract priorities: All used priority values. Each user has a demand for all these priorities, which is 0.0 if it is not provided explicitly. record: Collected data of allocation optimizations for output file.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL439-L448" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL439-L448" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.config.Config-Tuple{AbstractString}" href="#Ribasim.config.Config-Tuple{AbstractString}">#</a> <strong><code>Ribasim.config.Config</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb7"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="fu">Config</span>(config_path<span class="op">::</span><span class="dt">AbstractString</span>; kwargs<span class="op">...</span>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Parse a TOML file to a Config. Keys can be overruled using keyword arguments. To overrule keys from a subsection, e.g.&nbsp;<code>dt</code> from the <code>solver</code> section, use underscores: <code>solver_dt</code>.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL133-L138" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL133-L138" class="documenter-source">source</a><br></p>
 <p><a id="Functions"></a></p>
 <p><a id="Functions-1"></a></p>
 </section>
@@ -405,119 +405,119 @@ <h2 data-number="1.3" class="anchored" data-anchor-id="functions"><span class="h
 <p><a id="BasicModelInterface.finalize-Tuple{Ribasim.Model}" href="#BasicModelInterface.finalize-Tuple{Ribasim.Model}">#</a> <strong><code>BasicModelInterface.finalize</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb8"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a>BMI.<span class="fu">finalize</span>(model<span class="op">::</span><span class="dt">Model</span>)<span class="op">::</span><span class="dt">Model</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Write all results to the configured files.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL145-L149" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL145-L149" class="documenter-source">source</a><br></p>
 <p><a id="BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, AbstractString}" href="#BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, AbstractString}">#</a> <strong><code>BasicModelInterface.initialize</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb9"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a>BMI.<span class="fu">initialize</span>(T<span class="op">::</span><span class="dt">Type{Model}</span>, config_path<span class="op">::</span><span class="dt">AbstractString</span>)<span class="op">::</span><span class="dt">Model</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Initialize a <a href="../build/index.html#Ribasim.Model"><code>Model</code></a> from the path to the TOML configuration file.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL1-L5" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL1-L5" class="documenter-source">source</a><br></p>
 <p><a id="BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, Ribasim.config.Config}" href="#BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, Ribasim.config.Config}">#</a> <strong><code>BasicModelInterface.initialize</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb10"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a>BMI.<span class="fu">initialize</span>(T<span class="op">::</span><span class="dt">Type{Model}</span>, config<span class="op">::</span><span class="dt">Config</span>)<span class="op">::</span><span class="dt">Model</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Initialize a <a href="../build/index.html#Ribasim.Model"><code>Model</code></a> from a <a href="../build/index.html#Ribasim.config.Config-Tuple{AbstractString}"><code>Config</code></a>.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL11-L15" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL11-L15" class="documenter-source">source</a><br></p>
 <p><a id="CommonSolve.solve!-Tuple{Ribasim.Model}" href="#CommonSolve.solve!-Tuple{Ribasim.Model}">#</a> <strong><code>CommonSolve.solve!</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb11"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="fu">solve!</span>(model<span class="op">::</span><span class="dt">Model</span>)<span class="op">::</span><span class="dt">ODESolution</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Solve a Model until the configured <code>endtime</code>.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/lib.jl#LL51-L55" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/lib.jl#LL51-L55" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_basin_allocation!-Tuple{JuMP.Model, Vector{Int64}}" href="#Ribasim.add_constraints_basin_allocation!-Tuple{JuMP.Model, Vector{Int64}}">#</a> <strong><code>Ribasim.add_constraints_basin_allocation!</code></strong> — <em>Method</em>.</p>
 <p>Add the basin allocation constraints to the allocation problem; the allocations to the basins are bounded from above by the basin demand (these are set before each allocation solve). The constraint indices are allocation graph basin node IDs.</p>
 <p>Constraint: allocation to basin &lt;= basin demand</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL421-L429" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL421-L429" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_capacity!-Tuple{JuMP.Model, SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}}" href="#Ribasim.add_constraints_capacity!-Tuple{JuMP.Model, SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}}">#</a> <strong><code>Ribasim.add_constraints_capacity!</code></strong> — <em>Method</em>.</p>
 <p>Add the flow capacity constraints to the allocation problem. Only finite capacities get a constraint. The constraint indices are the allocation graph edge IDs.</p>
 <p>Constraint: flow over edge &lt;= edge capacity</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL444-L451" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL444-L451" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_flow_conservation!-Tuple{JuMP.Model, Vector{Int64}, Dict{Int64, Vector{Int64}}, Dict{Int64, Vector{Int64}}}" href="#Ribasim.add_constraints_flow_conservation!-Tuple{JuMP.Model, Vector{Int64}, Dict{Int64, Vector{Int64}}, Dict{Int64, Vector{Int64}}}">#</a> <strong><code>Ribasim.add_constraints_flow_conservation!</code></strong> — <em>Method</em>.</p>
 <p>Add the flow conservation constraints to the allocation problem. The constraint indices are allocgraph user node IDs.</p>
 <p>Constraint: sum(flows out of node node) &lt;= flows into node + flow from storage and vertical fluxes</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL500-L506" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL500-L506" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_source!-Tuple{JuMP.Model, Dict{Int64, Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}, Graphs.SimpleGraphs.SimpleDiGraph{Int64}}" href="#Ribasim.add_constraints_source!-Tuple{JuMP.Model, Dict{Int64, Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}, Graphs.SimpleGraphs.SimpleDiGraph{Int64}}">#</a> <strong><code>Ribasim.add_constraints_source!</code></strong> — <em>Method</em>.</p>
 <p>Add the source constraints to the allocation problem. The actual threshold values will be set before each allocation solve. The constraint indices are the allocation graph source node IDs.</p>
 <p>Constraint: flow over source edge &lt;= source flow in subnetwork</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL473-L480" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL473-L480" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_user_allocation!-Tuple{JuMP.Model, Dict{Int64, Int64}}" href="#Ribasim.add_constraints_user_allocation!-Tuple{JuMP.Model, Dict{Int64, Int64}}">#</a> <strong><code>Ribasim.add_constraints_user_allocation!</code></strong> — <em>Method</em>.</p>
 <p>Add the user allocation constraints to the allocation problem: The flow to a user is bounded from above by the demand of the user.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL403-L406" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL403-L406" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_constraints_user_returnflow!-Tuple{JuMP.Model, Vector{Int64}}" href="#Ribasim.add_constraints_user_returnflow!-Tuple{JuMP.Model, Vector{Int64}}">#</a> <strong><code>Ribasim.add_constraints_user_returnflow!</code></strong> — <em>Method</em>.</p>
 <p>Add the user returnflow constraints to the allocation problem. The constraint indices are allocation graph user node IDs.</p>
 <p>Constraint: outflow from user = return factor * inflow to user</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL527-L533" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL527-L533" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_objective_function!-Tuple{JuMP.Model, Dict{Int64, Int64}}" href="#Ribasim.add_objective_function!-Tuple{JuMP.Model, Dict{Int64, Int64}}">#</a> <strong><code>Ribasim.add_objective_function!</code></strong> — <em>Method</em>.</p>
 <p>Add the objective function to be maximized to the allocation problem. Objective function: Sum of flows to the users.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL551-L554" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL551-L554" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_variables_allocation_basin!-Tuple{JuMP.Model, Dict{Int64, Tuple{Int64, Symbol}}, Vector{Int64}}" href="#Ribasim.add_variables_allocation_basin!-Tuple{JuMP.Model, Dict{Int64, Tuple{Int64, Symbol}}, Vector{Int64}}">#</a> <strong><code>Ribasim.add_variables_allocation_basin!</code></strong> — <em>Method</em>.</p>
 <p>Add the basin allocation variables A_basin to the allocation problem. The variable indices are the allocation graph basin node IDs. Non-negativivity constraints are also immediately added to the basin allocation variables.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL389-L393" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL389-L393" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.add_variables_flow!-Tuple{JuMP.Model, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}}" href="#Ribasim.add_variables_flow!-Tuple{JuMP.Model, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}}">#</a> <strong><code>Ribasim.add_variables_flow!</code></strong> — <em>Method</em>.</p>
 <p>Add the flow variables F to the allocation problem. The variable indices are the allocation graph edge IDs. Non-negativivity constraints are also immediately added to the flow variables.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL375-L379" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL375-L379" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.adjust_edge_capacities!-Tuple{Ribasim.AllocationModel, Int64}" href="#Ribasim.adjust_edge_capacities!-Tuple{Ribasim.AllocationModel, Int64}">#</a> <strong><code>Ribasim.adjust_edge_capacities!</code></strong> — <em>Method</em>.</p>
 <p>Set the values of the edge capacities. 2 cases:</p>
 <ul>
 <li>Before the first allocation solve, set the edge capacities to their full capacity;</li>
 <li>Before an allocation solve, subtract the flow used by allocation for the previous priority from the edge capacities.</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL764-L769" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL764-L769" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.allocate!-Tuple{Ribasim.Parameters, Ribasim.AllocationModel, Float64}" href="#Ribasim.allocate!-Tuple{Ribasim.Parameters, Ribasim.AllocationModel, Float64}">#</a> <strong><code>Ribasim.allocate!</code></strong> — <em>Method</em>.</p>
 <p>Update the allocation optimization problem for the given subnetwork with the problem state and flows, solve the allocation problem and assign the results to the users.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL800-L803" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL800-L803" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.allocation_graph-Tuple{Ribasim.Parameters, Vector{Int64}, Vector{Int64}}" href="#Ribasim.allocation_graph-Tuple{Ribasim.Parameters, Vector{Int64}, Vector{Int64}}">#</a> <strong><code>Ribasim.allocation_graph</code></strong> — <em>Method</em>.</p>
 <p>Build the graph used for the allocation problem.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL301-L303" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL301-L303" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.allocation_problem-Tuple{Dict{Int64, Tuple{Int64, Symbol}}, Vector{Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}, Dict{Int64, Int64}, Dict{Int64, Int64}, Graphs.SimpleGraphs.SimpleDiGraph{Int64}, SparseArrays.SparseMatrixCSC{Float64, Int64}}" href="#Ribasim.allocation_problem-Tuple{Dict{Int64, Tuple{Int64, Symbol}}, Vector{Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}, Dict{Int64, Int64}, Dict{Int64, Int64}, Graphs.SimpleGraphs.SimpleDiGraph{Int64}, SparseArrays.SparseMatrixCSC{Float64, Int64}}">#</a> <strong><code>Ribasim.allocation_problem</code></strong> — <em>Method</em>.</p>
 <p>Construct the allocation problem for the current subnetwork as a JuMP.jl model.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL569-L571" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL569-L571" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.allocation_table-Tuple{Ribasim.Model}" href="#Ribasim.allocation_table-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.allocation_table</code></strong> — <em>Method</em>.</p>
 <p>Create an allocation result table for the saved data</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL213" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL213" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.assign_allocations!-Tuple{Ribasim.AllocationModel, Ribasim.Parameters, Float64, Int64}" href="#Ribasim.assign_allocations!-Tuple{Ribasim.AllocationModel, Ribasim.Parameters, Float64, Int64}">#</a> <strong><code>Ribasim.assign_allocations!</code></strong> — <em>Method</em>.</p>
 <p>Assign the allocations to the users as determined by the solution of the allocation problem.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL709-L711" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL709-L711" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.avoid_using_own_returnflow!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Vector{Int64}, Dict{Int64, Tuple{Int64, Symbol}}}" href="#Ribasim.avoid_using_own_returnflow!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Vector{Int64}, Dict{Int64, Tuple{Int64, Symbol}}}">#</a> <strong><code>Ribasim.avoid_using_own_returnflow!</code></strong> — <em>Method</em>.</p>
 <p>Remove user return flow edges that are upstream of the user itself, and collect the IDs of the allocation graph node IDs of the users that do not have this problem.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL270-L273" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL270-L273" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.basin_bottom-Tuple{Ribasim.Basin, Int64}" href="#Ribasim.basin_bottom-Tuple{Ribasim.Basin, Int64}">#</a> <strong><code>Ribasim.basin_bottom</code></strong> — <em>Method</em>.</p>
 <p>Return the bottom elevation of the basin with index i, or nothing if it doesn’t exist</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL439" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL439" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.basin_bottoms-Tuple{Ribasim.Basin, Int64, Int64, Int64}" href="#Ribasim.basin_bottoms-Tuple{Ribasim.Basin, Int64, Int64, Int64}">#</a> <strong><code>Ribasim.basin_bottoms</code></strong> — <em>Method</em>.</p>
 <p>Get the bottom on both ends of a node. If only one has a bottom, use that for both.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL452" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL452" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.basin_table-Tuple{Ribasim.Model}" href="#Ribasim.basin_table-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.basin_table</code></strong> — <em>Method</em>.</p>
 <p>Create the basin result table from the saved data</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL171" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL171" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.create_callbacks-Tuple{Ribasim.Parameters, Ribasim.config.Config}" href="#Ribasim.create_callbacks-Tuple{Ribasim.Parameters, Ribasim.config.Config}">#</a> <strong><code>Ribasim.create_callbacks</code></strong> — <em>Method</em>.</p>
 <p>Create the different callbacks that are used to store results and feed the simulation with new data. The different callbacks are combined to a CallbackSet that goes to the integrator. Returns the CallbackSet and the SavedValues for flow.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL199-L204" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL199-L204" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.create_graph-Tuple{SQLite.DB, String}" href="#Ribasim.create_graph-Tuple{SQLite.DB, String}">#</a> <strong><code>Ribasim.create_graph</code></strong> — <em>Method</em>.</p>
 <p>Return a directed graph, and a mapping from source and target nodes to edge fid.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL15" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL15" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.create_storage_tables-Tuple{SQLite.DB, Ribasim.config.Config}" href="#Ribasim.create_storage_tables-Tuple{SQLite.DB, Ribasim.config.Config}">#</a> <strong><code>Ribasim.create_storage_tables</code></strong> — <em>Method</em>.</p>
 <p>Read the Basin / profile table and return all area and level and computed storage values</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL51" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL51" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.datetime_since-Tuple{Real, Dates.DateTime}" href="#Ribasim.datetime_since-Tuple{Real, Dates.DateTime}">#</a> <strong><code>Ribasim.datetime_since</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb12"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a><span class="fu">datetime_since</span>(t<span class="op">::</span><span class="dt">Real</span>, t0<span class="op">::</span><span class="dt">DateTime</span>)<span class="op">::</span><span class="dt">DateTime</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Convert a Real that represents the seconds passed since the simulation start to the nearest DateTime. This is used to convert between the solver’s inner float time, and the calendar.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL39-L44" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL39-L44" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.datetimes-Tuple{Ribasim.Model}" href="#Ribasim.datetimes-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.datetimes</code></strong> — <em>Method</em>.</p>
 <p>Get all saved times as a Vector{DateTime}</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/lib.jl#LL35" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/lib.jl#LL35" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.discrete_control_affect!-Tuple{Any, Int64, Union{Missing, Bool}}" href="#Ribasim.discrete_control_affect!-Tuple{Any, Int64, Union{Missing, Bool}}">#</a> <strong><code>Ribasim.discrete_control_affect!</code></strong> — <em>Method</em>.</p>
 <p>Change parameters based on the control logic.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL385-L387" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL385-L387" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.discrete_control_affect_downcrossing!-Tuple{Any, Any}" href="#Ribasim.discrete_control_affect_downcrossing!-Tuple{Any, Any}">#</a> <strong><code>Ribasim.discrete_control_affect_downcrossing!</code></strong> — <em>Method</em>.</p>
 <p>An downcrossing means that a condition (always greater than) becomes false.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL352-L354" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL352-L354" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.discrete_control_affect_upcrossing!-Tuple{Any, Any}" href="#Ribasim.discrete_control_affect_upcrossing!-Tuple{Any, Any}">#</a> <strong><code>Ribasim.discrete_control_affect_upcrossing!</code></strong> — <em>Method</em>.</p>
 <p>An upcrossing means that a condition (always greater than) becomes true.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL316-L318" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL316-L318" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.discrete_control_condition-NTuple{4, Any}" href="#Ribasim.discrete_control_condition-NTuple{4, Any}">#</a> <strong><code>Ribasim.discrete_control_condition</code></strong> — <em>Method</em>.</p>
 <p>Listens for changes in condition truths.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL250-L252" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL250-L252" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.discrete_control_table-Tuple{Ribasim.Model}" href="#Ribasim.discrete_control_table-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.discrete_control_table</code></strong> — <em>Method</em>.</p>
 <p>Create a discrete control result table from the saved data</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL204" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL204" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.expand_logic_mapping-Tuple{Dict{Tuple{Int64, String}, String}}" href="#Ribasim.expand_logic_mapping-Tuple{Dict{Tuple{Int64, String}, String}}">#</a> <strong><code>Ribasim.expand_logic_mapping</code></strong> — <em>Method</em>.</p>
 <p>Replace the truth states in the logic mapping which contain wildcards with all possible explicit truth states.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL585-L588" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL585-L588" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.find_allocation_graph_edges!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Dict{Int64, Tuple{Int64, Symbol}}, Ribasim.Parameters, Vector{Int64}}" href="#Ribasim.find_allocation_graph_edges!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Dict{Int64, Tuple{Int64, Symbol}}, Ribasim.Parameters, Vector{Int64}}">#</a> <strong><code>Ribasim.find_allocation_graph_edges!</code></strong> — <em>Method</em>.</p>
 <p>This loop finds allocgraph edges in several ways:</p>
 <ul>
@@ -525,26 +525,26 @@ <h2 data-number="1.3" class="anchored" data-anchor-id="functions"><span class="h
 <li>Between allocgraph nodes whose equivalent in the subnetwork are connected with one or more non-junction nodes in between</li>
 </ul>
 <p>Here edges are added to the allocation graph that are given by a single edge in the subnetwork.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL63-L71" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL63-L71" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.findlastgroup-Tuple{Int64, AbstractVector{Int64}}" href="#Ribasim.findlastgroup-Tuple{Int64, AbstractVector{Int64}}">#</a> <strong><code>Ribasim.findlastgroup</code></strong> — <em>Method</em>.</p>
 <p>For an element <code>id</code> and a vector of elements <code>ids</code>, get the range of indices of the last consecutive block of <code>id</code>. Returns the empty range <code>1:0</code> if <code>id</code> is not in <code>ids</code>.</p>
 <div class="sourceCode" id="cb13"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a><span class="co">#                         1 2 3 4 5 6 7 8 9</span></span>
 <span id="cb13-2"><a href="#cb13-2" aria-hidden="true" tabindex="-1"></a>Ribasim.<span class="fu">findlastgroup</span>(<span class="fl">2</span>, [<span class="fl">5</span>,<span class="fl">4</span>,<span class="fl">2</span>,<span class="fl">2</span>,<span class="fl">5</span>,<span class="fl">2</span>,<span class="fl">2</span>,<span class="fl">2</span>,<span class="fl">1</span>])</span>
 <span id="cb13-3"><a href="#cb13-3" aria-hidden="true" tabindex="-1"></a><span class="co"># output</span></span>
 <span id="cb13-4"><a href="#cb13-4" aria-hidden="true" tabindex="-1"></a><span class="fl">6</span><span class="op">:</span><span class="fl">8</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL211-L222" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL211-L222" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.findsorted-Tuple{Any, Any}" href="#Ribasim.findsorted-Tuple{Any, Any}">#</a> <strong><code>Ribasim.findsorted</code></strong> — <em>Method</em>.</p>
 <p>Find the index of element x in a sorted collection a. Returns the index of x if it exists, or nothing if it doesn’t. If x occurs more than once, throw an error.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL313-L317" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL313-L317" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.flow_table-Tuple{Ribasim.Model}" href="#Ribasim.flow_table-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.flow_table</code></strong> — <em>Method</em>.</p>
 <p>Create a flow result table from the saved data</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL183" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL183" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.formulate_basins!-Tuple{AbstractVector, Ribasim.Basin, AbstractMatrix, AbstractVector}" href="#Ribasim.formulate_basins!-Tuple{AbstractVector, Ribasim.Basin, AbstractMatrix, AbstractVector}">#</a> <strong><code>Ribasim.formulate_basins!</code></strong> — <em>Method</em>.</p>
 <p>Smoothly let the evaporation flux go to 0 when at small water depths Currently at less than 0.1 m.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL567-L570" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL567-L570" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.formulate_flow!-Tuple{Ribasim.LinearResistance, Ribasim.Parameters, AbstractVector, Float64}" href="#Ribasim.formulate_flow!-Tuple{Ribasim.LinearResistance, Ribasim.Parameters, AbstractVector, Float64}">#</a> <strong><code>Ribasim.formulate_flow!</code></strong> — <em>Method</em>.</p>
 <p>Directed graph: outflow is positive!</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL836-L838" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL836-L838" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.formulate_flow!-Tuple{Ribasim.ManningResistance, Ribasim.Parameters, AbstractVector, Float64}" href="#Ribasim.formulate_flow!-Tuple{Ribasim.ManningResistance, Ribasim.Parameters, AbstractVector, Float64}">#</a> <strong><code>Ribasim.formulate_flow!</code></strong> — <em>Method</em>.</p>
 <p>Conservation of energy for two basins, a and b:</p>
 <pre><code>h_a + v_a^2 / (2 * g) = h_b + v_b^2 / (2 * g) + S_f * L + C / 2 * g * (v_b^2 - v_a^2)</code></pre>
@@ -572,91 +572,91 @@ <h2 data-number="1.3" class="anchored" data-anchor-id="functions"><span class="h
 <pre><code>R_h = A / P</code></pre>
 <p>Where P is the wetted perimeter.</p>
 <p>The average of the upstream and downstream water depth is used to compute cross-sectional area and hydraulic radius. This ensures that a basin can receive water after it has gone dry.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL900-L938" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL900-L938" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.formulate_flow!-Tuple{Ribasim.TabulatedRatingCurve, Ribasim.Parameters, AbstractVector, Float64}" href="#Ribasim.formulate_flow!-Tuple{Ribasim.TabulatedRatingCurve, Ribasim.Parameters, AbstractVector, Float64}">#</a> <strong><code>Ribasim.formulate_flow!</code></strong> — <em>Method</em>.</p>
 <p>Directed graph: outflow is positive!</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL866-L868" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL866-L868" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_area_and_level-Tuple{Ribasim.Basin, Int64, Real}" href="#Ribasim.get_area_and_level-Tuple{Ribasim.Basin, Int64, Real}">#</a> <strong><code>Ribasim.get_area_and_level</code></strong> — <em>Method</em>.</p>
 <p>Compute the area and level of a basin given its storage. Also returns darea/dlevel as it is needed for the Jacobian.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL123-L126" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL123-L126" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_compressor-Tuple{Ribasim.config.Results}" href="#Ribasim.get_compressor-Tuple{Ribasim.config.Results}">#</a> <strong><code>Ribasim.get_compressor</code></strong> — <em>Method</em>.</p>
 <p>Get the compressor based on the Results section</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL469" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL469" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_fractional_flow_connected_basins-Tuple{Int64, Ribasim.Basin, Ribasim.FractionalFlow, Graphs.SimpleGraphs.SimpleDiGraph{Int64}}" href="#Ribasim.get_fractional_flow_connected_basins-Tuple{Int64, Ribasim.Basin, Ribasim.FractionalFlow, Graphs.SimpleGraphs.SimpleDiGraph{Int64}}">#</a> <strong><code>Ribasim.get_fractional_flow_connected_basins</code></strong> — <em>Method</em>.</p>
 <p>Get the node type specific indices of the fractional flows and basins, that are consecutively connected to a node of given id.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL847-L850" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL847-L850" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_jac_prototype-Tuple{Ribasim.Parameters}" href="#Ribasim.get_jac_prototype-Tuple{Ribasim.Parameters}">#</a> <strong><code>Ribasim.get_jac_prototype</code></strong> — <em>Method</em>.</p>
 <p>Get a sparse matrix whose sparsity matches the sparsity of the Jacobian of the ODE problem. All nodes are taken into consideration, also the ones that are inactive.</p>
 <p>In Ribasim the Jacobian is typically sparse because each state only depends on a small number of other states.</p>
 <p>Note: the name ‘prototype’ does not mean this code is a prototype, it comes from the naming convention of this sparsity structure in the differentialequations.jl docs.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL643-L654" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL643-L654" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_level-Tuple{Ribasim.Parameters, Int64, Float64}" href="#Ribasim.get_level-Tuple{Ribasim.Parameters, Int64, Float64}">#</a> <strong><code>Ribasim.get_level</code></strong> — <em>Method</em>.</p>
 <p>Get the current water level of a node ID. The ID can belong to either a Basin or a LevelBoundary. storage: tells ForwardDiff whether this call is for differentiation or not</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL405-L409" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL405-L409" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_node_id_mapping-Tuple{Ribasim.Parameters, Vector{Int64}, Vector{Int64}}" href="#Ribasim.get_node_id_mapping-Tuple{Ribasim.Parameters, Vector{Int64}, Vector{Int64}}">#</a> <strong><code>Ribasim.get_node_id_mapping</code></strong> — <em>Method</em>.</p>
 <p>Get:</p>
 <ul>
 <li>The mapping from subnetwork node IDs to allocation graph node IDs</li>
 <li>The mapping from allocation graph source node IDs to subnetwork source edge IDs</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL1-L5" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL1-L5" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_node_in_out_edges-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}}" href="#Ribasim.get_node_in_out_edges-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}}">#</a> <strong><code>Ribasim.get_node_in_out_edges</code></strong> — <em>Method</em>.</p>
 <p>Get two dictionaries, where:</p>
 <ul>
 <li>The first one gives the IDs of the inedges for each node ID in the graph</li>
 <li>The second one gives the IDs of the outedges for each node ID in the graph</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL949-L953" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL949-L953" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_scalar_interpolation-Tuple{Dates.DateTime, Float64, AbstractVector, Int64, Symbol}" href="#Ribasim.get_scalar_interpolation-Tuple{Dates.DateTime, Float64, AbstractVector, Int64, Symbol}">#</a> <strong><code>Ribasim.get_scalar_interpolation</code></strong> — <em>Method</em>.</p>
 <p>Linear interpolation of a scalar with constant extrapolation.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL238" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL238" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_storage_from_level-Tuple{Ribasim.Basin, Int64, Float64}" href="#Ribasim.get_storage_from_level-Tuple{Ribasim.Basin, Int64, Float64}">#</a> <strong><code>Ribasim.get_storage_from_level</code></strong> — <em>Method</em>.</p>
 <p>Get the storage of a basin from its level.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL72" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL72" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_storages_and_levels-Tuple{Ribasim.Model}" href="#Ribasim.get_storages_and_levels-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.get_storages_and_levels</code></strong> — <em>Method</em>.</p>
 <p>Get the storage and level of all basins as matrices of nbasin × ntime</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL148" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL148" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_storages_from_levels-Tuple{Ribasim.Basin, Vector}" href="#Ribasim.get_storages_from_levels-Tuple{Ribasim.Basin, Vector}">#</a> <strong><code>Ribasim.get_storages_from_levels</code></strong> — <em>Method</em>.</p>
 <p>Compute the storages of the basins based on the water level of the basins.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL110" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL110" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_tstops-Tuple{Any, Dates.DateTime}" href="#Ribasim.get_tstops-Tuple{Any, Dates.DateTime}">#</a> <strong><code>Ribasim.get_tstops</code></strong> — <em>Method</em>.</p>
 <p>From an iterable of DateTimes, find the times the solver needs to stop</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL399" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL399" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.get_value-Tuple{Ribasim.Parameters, Int64, String, Float64, AbstractVector{Float64}, Float64}" href="#Ribasim.get_value-Tuple{Ribasim.Parameters, Int64, String, Float64, AbstractVector{Float64}, Float64}">#</a> <strong><code>Ribasim.get_value</code></strong> — <em>Method</em>.</p>
 <p>Get a value for a condition. Currently supports getting levels from basins and flows from flow boundaries.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL271-L274" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL271-L274" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.id_index-Tuple{Dictionaries.Indices{Int64}, Int64}" href="#Ribasim.id_index-Tuple{Dictionaries.Indices{Int64}, Int64}">#</a> <strong><code>Ribasim.id_index</code></strong> — <em>Method</em>.</p>
 <p>Get the index of an ID in a set of indices.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL431" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL431" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.input_path-Tuple{Ribasim.config.Config, String}" href="#Ribasim.input_path-Tuple{Ribasim.config.Config, String}">#</a> <strong><code>Ribasim.input_path</code></strong> — <em>Method</em>.</p>
 <p>Construct a path relative to both the TOML directory and the optional <code>input_dir</code></p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL123" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL123" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.is_flow_constraining-Tuple{Ribasim.AbstractParameterNode}" href="#Ribasim.is_flow_constraining-Tuple{Ribasim.AbstractParameterNode}">#</a> <strong><code>Ribasim.is_flow_constraining</code></strong> — <em>Method</em>.</p>
 <p>Whether the given node node is flow constraining by having a maximum flow rate.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL922" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL922" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.is_flow_direction_constraining-Tuple{Ribasim.AbstractParameterNode}" href="#Ribasim.is_flow_direction_constraining-Tuple{Ribasim.AbstractParameterNode}">#</a> <strong><code>Ribasim.is_flow_direction_constraining</code></strong> — <em>Method</em>.</p>
 <p>Whether the given node is flow direction constraining (only in direction of edges).</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL925" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL925" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.load_data-Tuple{SQLite.DB, Ribasim.config.Config, Type{<:Legolas.AbstractRecord}}" href="#Ribasim.load_data-Tuple{SQLite.DB, Ribasim.config.Config, Type{<:Legolas.AbstractRecord}}">#</a> <strong><code>Ribasim.load_data</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb18"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a><span class="fu">load_data</span>(db<span class="op">::</span><span class="dt">DB</span>, config<span class="op">::</span><span class="dt">Config</span>, nodetype<span class="op">::</span><span class="dt">Symbol</span>, kind<span class="op">::</span><span class="dt">Symbol</span>)<span class="op">::</span><span class="dt">Union{Table, Query, Nothing}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Load data from Arrow files if available, otherwise the database. Returns either an <code>Arrow.Table</code>, <code>SQLite.Query</code> or <code>nothing</code> if the data is not present.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL47-L52" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL47-L52" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.load_structvector-Union{Tuple{T}, Tuple{SQLite.DB, Ribasim.config.Config, Type{T}}} where T<:Tables.AbstractRow" href="#Ribasim.load_structvector-Union{Tuple{T}, Tuple{SQLite.DB, Ribasim.config.Config, Type{T}}} where T<:Tables.AbstractRow">#</a> <strong><code>Ribasim.load_structvector</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb19"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a><span class="fu">load_structvector</span>(db<span class="op">::</span><span class="dt">DB</span>, config<span class="op">::</span><span class="dt">Config</span>, <span class="op">::</span><span class="dt">Type{T}</span>)<span class="op">::</span><span class="dt">StructVector{T}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Load data from Arrow files if available, otherwise the database. Always returns a StructVector of the given struct type T, which is empty if the table is not found. This function validates the schema, and enforces the required sort order.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL78-L84" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL78-L84" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.nodefields-Tuple{Ribasim.Parameters}" href="#Ribasim.nodefields-Tuple{Ribasim.Parameters}">#</a> <strong><code>Ribasim.nodefields</code></strong> — <em>Method</em>.</p>
 <p>Get all node fieldnames of the parameter object.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL637" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL637" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.nodetype-Union{Tuple{Legolas.SchemaVersion{T, N}}, Tuple{N}, Tuple{T}} where {T, N}" href="#Ribasim.nodetype-Union{Tuple{Legolas.SchemaVersion{T, N}}, Tuple{N}, Tuple{T}} where {T, N}">#</a> <strong><code>Ribasim.nodetype</code></strong> — <em>Method</em>.</p>
 <p>From a SchemaVersion(“ribasim.flowboundary.static”, 1) return (:FlowBoundary, :static)</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL36-L38" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL36-L38" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.parse_static_and_time-Tuple{SQLite.DB, Ribasim.config.Config, String}" href="#Ribasim.parse_static_and_time-Tuple{SQLite.DB, Ribasim.config.Config, String}">#</a> <strong><code>Ribasim.parse_static_and_time</code></strong> — <em>Method</em>.</p>
 <p>Process the data in the static and time tables for a given node type. The ‘defaults’ named tuple dictates how missing data is filled in. ‘time_interpolatables’ is a vector of Symbols of parameter names for which a time interpolation (linear) object must be constructed. The control mapping for DiscreteControl is also constructed in this function. This function currently does not support node states that are defined by more than one row in a table, as is the case for TabulatedRatingCurve.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/create.jl#LL1-L9" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/create.jl#LL1-L9" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.path_exists_in_graph-Tuple{Graphs.SimpleGraphs.SimpleDiGraph, Int64, Int64}" href="#Ribasim.path_exists_in_graph-Tuple{Graphs.SimpleGraphs.SimpleDiGraph, Int64, Int64}">#</a> <strong><code>Ribasim.path_exists_in_graph</code></strong> — <em>Method</em>.</p>
 <p>Find out whether a path exists between a start node and end node in the given graph.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL929" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL929" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.process_allocation_graph_edges!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Vector{Int64}}, Dict{Int64, Tuple{Int64, Symbol}}, Ribasim.Parameters}" href="#Ribasim.process_allocation_graph_edges!-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Vector{Int64}}, Dict{Int64, Tuple{Int64, Symbol}}, Ribasim.Parameters}">#</a> <strong><code>Ribasim.process_allocation_graph_edges!</code></strong> — <em>Method</em>.</p>
 <p>For the composite allocgraph edges:</p>
 <ul>
@@ -664,77 +664,77 @@ <h2 data-number="1.3" class="anchored" data-anchor-id="functions"><span class="h
 <li>Compute their capacity</li>
 <li>Find out their allowed flow direction(s)</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL146-L151" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL146-L151" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.profile_storage-Tuple{Vector, Vector}" href="#Ribasim.profile_storage-Tuple{Vector, Vector}">#</a> <strong><code>Ribasim.profile_storage</code></strong> — <em>Method</em>.</p>
 <p>Calculate a profile storage by integrating the areas over the levels</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL36" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL36" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.qh_interpolation-Tuple{Int64, StructArrays.StructVector}" href="#Ribasim.qh_interpolation-Tuple{Int64, StructArrays.StructVector}">#</a> <strong><code>Ribasim.qh_interpolation</code></strong> — <em>Method</em>.</p>
 <p>From a table with columns node<em>id, discharge (Q) and level (h), create a LinearInterpolation from level to discharge for a given node</em>id.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL300-L303" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL300-L303" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.reduction_factor-Union{Tuple{T}, Tuple{T, Real}} where T<:Real" href="#Ribasim.reduction_factor-Union{Tuple{T}, Tuple{T, Real}} where T<:Real">#</a> <strong><code>Ribasim.reduction_factor</code></strong> — <em>Method</em>.</p>
 <p>Function that goes smoothly from 0 to 1 in the interval [0,threshold], and is constant outside this interval.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL907-L910" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL907-L910" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.results_path-Tuple{Ribasim.config.Config, String}" href="#Ribasim.results_path-Tuple{Ribasim.config.Config, String}">#</a> <strong><code>Ribasim.results_path</code></strong> — <em>Method</em>.</p>
 <p>Construct a path relative to both the TOML directory and the optional <code>results_dir</code></p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL128" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL128" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.run-Tuple{AbstractString}" href="#Ribasim.run-Tuple{AbstractString}">#</a> <strong><code>Ribasim.run</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb20"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a><span class="fu">run</span>(config_file<span class="op">::</span><span class="dt">AbstractString</span>)<span class="op">::</span><span class="dt">Model</span></span>
 <span id="cb20-2"><a href="#cb20-2" aria-hidden="true" tabindex="-1"></a><span class="fu">run</span>(config<span class="op">::</span><span class="dt">Config</span>)<span class="op">::</span><span class="dt">Model</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Run a <a href="../build/index.html#Ribasim.Model"><code>Model</code></a>, given a path to a TOML configuration file, or a Config object. Running a model includes initialization, solving to the end with <code>[</code>solve!<code>](@ref)</code> and writing results with <a href="../build/index.html#BasicModelInterface.finalize-Tuple{Ribasim.Model}"><code>BMI.finalize</code></a>.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL575-L581" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL575-L581" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.save_flow-Tuple{Any, Any, Any}" href="#Ribasim.save_flow-Tuple{Any, Any, Any}">#</a> <strong><code>Ribasim.save_flow</code></strong> — <em>Method</em>.</p>
 <p>Copy the current flow to the SavedValues</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL478" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL478" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.scalar_interpolation_derivative-Tuple{DataInterpolations.LinearInterpolation{Vector{Float64}, Vector{Float64}, true, Float64}, Float64}" href="#Ribasim.scalar_interpolation_derivative-Tuple{DataInterpolations.LinearInterpolation{Vector{Float64}, Vector{Float64}, true, Float64}, Float64}">#</a> <strong><code>Ribasim.scalar_interpolation_derivative</code></strong> — <em>Method</em>.</p>
 <p>Derivative of scalar interpolation.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL265" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL265" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.seconds_since-Tuple{Dates.DateTime, Dates.DateTime}" href="#Ribasim.seconds_since-Tuple{Dates.DateTime, Dates.DateTime}">#</a> <strong><code>Ribasim.seconds_since</code></strong> — <em>Method</em>.</p>
 <div class="sourceCode" id="cb21"><pre class="sourceCode julia code-with-copy"><code class="sourceCode julia"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true" tabindex="-1"></a><span class="fu">seconds_since</span>(t<span class="op">::</span><span class="dt">DateTime</span>, t0<span class="op">::</span><span class="dt">DateTime</span>)<span class="op">::</span><span class="dt">Float64</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <p>Convert a DateTime to a float that is the number of seconds since the start of the simulation. This is used to convert between the solver’s inner float time, and the calendar.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL31-L36" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL31-L36" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.set_current_value!-Tuple{NamedTuple, Vector{Int64}, StructArrays.StructVector, Dates.DateTime}" href="#Ribasim.set_current_value!-Tuple{NamedTuple, Vector{Int64}, StructArrays.StructVector, Dates.DateTime}">#</a> <strong><code>Ribasim.set_current_value!</code></strong> — <em>Method</em>.</p>
 <p>From a timeseries table <code>time</code>, load the most recent applicable data into <code>table</code>. <code>table</code> must be a NamedTuple of vectors with all variables that must be loaded. The most recent applicable data is non-NaN data for a given ID that is on or before <code>t</code>.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL363-L367" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL363-L367" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.set_demands_priority!-Tuple{Ribasim.AllocationModel, Ribasim.User, Int64, Float64}" href="#Ribasim.set_demands_priority!-Tuple{Ribasim.AllocationModel, Ribasim.User, Int64, Float64}">#</a> <strong><code>Ribasim.set_demands_priority!</code></strong> — <em>Method</em>.</p>
 <p>Set the demands of the users of the current time and priority in the allocation problem.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL684-L687" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL684-L687" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.set_source_flows!-Tuple{Ribasim.AllocationModel, Ribasim.Parameters}" href="#Ribasim.set_source_flows!-Tuple{Ribasim.AllocationModel, Ribasim.Parameters}">#</a> <strong><code>Ribasim.set_source_flows!</code></strong> — <em>Method</em>.</p>
 <p>Set the source flows as capacities on edges in the AG.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL747-L749" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL747-L749" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.set_static_value!-Tuple{NamedTuple, Vector{Int64}, StructArrays.StructVector}" href="#Ribasim.set_static_value!-Tuple{NamedTuple, Vector{Int64}, StructArrays.StructVector}">#</a> <strong><code>Ribasim.set_static_value!</code></strong> — <em>Method</em>.</p>
 <p>Load data from a source table <code>static</code> into a destination <code>table</code>. Data is matched based on the node_id, which is sorted.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL345-L348" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL345-L348" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.set_table_row!-Tuple{NamedTuple, Any, Int64}" href="#Ribasim.set_table_row!-Tuple{NamedTuple, Any, Int64}">#</a> <strong><code>Ribasim.set_table_row!</code></strong> — <em>Method</em>.</p>
 <p>Update <code>table</code> at row index <code>i</code>, with the values of a given row. <code>table</code> must be a NamedTuple of vectors with all variables that must be loaded. The row must contain all the column names that are present in the table. If a value is NaN, it is not set.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL329-L334" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL329-L334" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.sorted_table!-Tuple{StructArrays.StructVector{<:Legolas.AbstractRecord}}" href="#Ribasim.sorted_table!-Tuple{StructArrays.StructVector{<:Legolas.AbstractRecord}}">#</a> <strong><code>Ribasim.sorted_table!</code></strong> — <em>Method</em>.</p>
 <p>Depending on if a table can be sorted, either sort it or assert that it is sorted.</p>
 <p>Tables loaded from the database into memory can be sorted. Tables loaded from Arrow files are memory mapped and can therefore not be sorted.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL388-L393" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL388-L393" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.timesteps-Tuple{Ribasim.Model}" href="#Ribasim.timesteps-Tuple{Ribasim.Model}">#</a> <strong><code>Ribasim.timesteps</code></strong> — <em>Method</em>.</p>
 <p>Get all saved times in seconds since start</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/lib.jl#LL32" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/lib.jl#LL32" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_allocation!-Tuple{Any}" href="#Ribasim.update_allocation!-Tuple{Any}">#</a> <strong><code>Ribasim.update_allocation!</code></strong> — <em>Method</em>.</p>
 <p>Solve the allocation problem for all users and assign allocated abstractions to user nodes.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL508" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL508" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_basin-Tuple{Any}" href="#Ribasim.update_basin-Tuple{Any}">#</a> <strong><code>Ribasim.update_basin</code></strong> — <em>Method</em>.</p>
 <p>Load updates from ‘Basin / time’ into the parameters</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL483" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL483" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.AbstractParameterNode}" href="#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.AbstractParameterNode}">#</a> <strong><code>Ribasim.update_jac_prototype!</code></strong> — <em>Method</em>.</p>
 <p>Method for nodes that do not contribute to the Jacobian</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL705-L707" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL705-L707" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.PidControl}" href="#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.PidControl}">#</a> <strong><code>Ribasim.update_jac_prototype!</code></strong> — <em>Method</em>.</p>
 <p>The controlled basin affects itself and the basins upstream and downstream of the controlled pump affect eachother if there is a basin upstream of the pump. The state for the integral term and the controlled basin affect eachother, and the same for the integral state and the basin upstream of the pump if it is indeed a basin.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL783-L788" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL783-L788" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.LinearResistance, Ribasim.ManningResistance}}" href="#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.LinearResistance, Ribasim.ManningResistance}}">#</a> <strong><code>Ribasim.update_jac_prototype!</code></strong> — <em>Method</em>.</p>
 <p>If both the unique node upstream and the unique node downstream of these nodes are basins, then these directly depend on eachother and affect the Jacobian 2x Basins always depend on themselves.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL669-L673" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL669-L673" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.User, Ribasim.Outlet, Ribasim.Pump, Ribasim.TabulatedRatingCurve}}" href="#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.User, Ribasim.Outlet, Ribasim.Pump, Ribasim.TabulatedRatingCurve}}">#</a> <strong><code>Ribasim.update_jac_prototype!</code></strong> — <em>Method</em>.</p>
 <p>If both the unique node upstream and the nodes down stream (or one node further if a fractional flow is in between) are basins, then the downstream basin depends on the upstream basin(s) and affect the Jacobian as many times as there are downstream basins Upstream basins always depend on themselves.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL733-L738" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL733-L738" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.update_tabulated_rating_curve!-Tuple{Any}" href="#Ribasim.update_tabulated_rating_curve!-Tuple{Any}">#</a> <strong><code>Ribasim.update_tabulated_rating_curve!</code></strong> — <em>Method</em>.</p>
 <p>Load updates from ‘TabulatedRatingCurve / time’ into the parameters</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/bmi.jl#LL516" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/bmi.jl#LL516" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_discrete_control-Tuple{Ribasim.Parameters, Ribasim.config.Config}" href="#Ribasim.valid_discrete_control-Tuple{Ribasim.Parameters, Ribasim.config.Config}">#</a> <strong><code>Ribasim.valid_discrete_control</code></strong> — <em>Method</em>.</p>
 <p>Check:</p>
 <ul>
@@ -742,41 +742,41 @@ <h2 data-number="1.3" class="anchored" data-anchor-id="functions"><span class="h
 <li>Whether the supplied truth states have the proper length;</li>
 <li>Whether look_ahead is only supplied for condition variables given by a time-series.</li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL484-L489" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL484-L489" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_edge_types-Tuple{SQLite.DB}" href="#Ribasim.valid_edge_types-Tuple{SQLite.DB}">#</a> <strong><code>Ribasim.valid_edge_types</code></strong> — <em>Method</em>.</p>
 <p>Check that only supported edge types are declared.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/utils.jl#LL1" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/utils.jl#LL1" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_edges-Tuple{Dictionaries.Dictionary{Tuple{Int64, Int64}, Int64}, Dictionaries.Dictionary{Int64, Tuple{Symbol, Symbol}}}" href="#Ribasim.valid_edges-Tuple{Dictionaries.Dictionary{Tuple{Int64, Int64}, Int64}, Dictionaries.Dictionary{Int64, Tuple{Symbol, Symbol}}}">#</a> <strong><code>Ribasim.valid_edges</code></strong> — <em>Method</em>.</p>
 <p>Test for each node given its node type whether the nodes that</p>
 <p><strong>are downstream (‘down-edge’) of this node are of an allowed type</strong></p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL409-L412" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL409-L412" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_flow_rates-Tuple{Vector{Int64}, Vector, Dict{Tuple{Int64, String}, NamedTuple}, Symbol}" href="#Ribasim.valid_flow_rates-Tuple{Vector{Int64}, Vector, Dict{Tuple{Int64, String}, NamedTuple}, Symbol}">#</a> <strong><code>Ribasim.valid_flow_rates</code></strong> — <em>Method</em>.</p>
 <p>Test whether static or discrete controlled flow rates are indeed non-negative.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL468-L470" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL468-L470" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_fractional_flow-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Vector{Int64}, Dict{Tuple{Int64, String}, NamedTuple}}" href="#Ribasim.valid_fractional_flow-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Vector{Int64}, Dict{Tuple{Int64, String}, NamedTuple}}">#</a> <strong><code>Ribasim.valid_fractional_flow</code></strong> — <em>Method</em>.</p>
 <p>Check that nodes that have fractional flow outneighbors do not have any other type of outneighbor, that the fractions leaving a node add up to ≈1 and that the fractions are non-negative.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL545-L548" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL545-L548" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_n_neighbors-Tuple{Ribasim.Parameters}" href="#Ribasim.valid_n_neighbors-Tuple{Ribasim.Parameters}">#</a> <strong><code>Ribasim.valid_n_neighbors</code></strong> — <em>Method</em>.</p>
 <p>Test for each node given its node type whether it has an allowed number of flow/control inneighbors and outneighbors</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL488-L491" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL488-L491" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_profiles-Tuple{Dictionaries.Indices{Int64}, Vector{Vector{Float64}}, Vector{Vector{Float64}}}" href="#Ribasim.valid_profiles-Tuple{Dictionaries.Indices{Int64}, Vector{Vector{Float64}}, Vector{Vector{Float64}}}">#</a> <strong><code>Ribasim.valid_profiles</code></strong> — <em>Method</em>.</p>
 <p>Check whether the profile data has no repeats in the levels and the areas start positive.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/validation.jl#LL436-L438" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/validation.jl#LL436-L438" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.valid_sources-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Dict{Int64, Tuple{Int64, Symbol}}}" href="#Ribasim.valid_sources-Tuple{Graphs.SimpleGraphs.SimpleDiGraph{Int64}, Dict{Int64, Tuple{Int64, Symbol}}}">#</a> <strong><code>Ribasim.valid_sources</code></strong> — <em>Method</em>.</p>
 <p>The source nodes must only have one outneighbor.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/allocation.jl#LL247-L249" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/allocation.jl#LL247-L249" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.water_balance!-Tuple{ComponentArrays.ComponentVector, ComponentArrays.ComponentVector, Ribasim.Parameters, Float64}" href="#Ribasim.water_balance!-Tuple{ComponentArrays.ComponentVector, ComponentArrays.ComponentVector, Ribasim.Parameters, Float64}">#</a> <strong><code>Ribasim.water_balance!</code></strong> — <em>Method</em>.</p>
 <p>The right hand side function of the system of ODEs set up by Ribasim.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/solve.jl#LL1221-L1223" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/solve.jl#LL1221-L1223" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.write_arrow-Tuple{AbstractString, NamedTuple, TranscodingStreams.Codec}" href="#Ribasim.write_arrow-Tuple{AbstractString, NamedTuple, TranscodingStreams.Codec}">#</a> <strong><code>Ribasim.write_arrow</code></strong> — <em>Method</em>.</p>
 <p>Write a result table to disk as an Arrow file</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/io.jl#LL230" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/io.jl#LL230" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.config.algorithm-Tuple{Ribasim.config.Solver}" href="#Ribasim.config.algorithm-Tuple{Ribasim.config.Solver}">#</a> <strong><code>Ribasim.config.algorithm</code></strong> — <em>Method</em>.</p>
 <p>Create an OrdinaryDiffEqAlgorithm from solver config</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL217" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL217" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.config.snake_case-Tuple{AbstractString}" href="#Ribasim.config.snake_case-Tuple{AbstractString}">#</a> <strong><code>Ribasim.config.snake_case</code></strong> — <em>Method</em>.</p>
 <p>Convert a string from CamelCase to snake_case.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL35" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL35" class="documenter-source">source</a><br></p>
 <p><a id="Constants"></a></p>
 <p><a id="Constants-1"></a></p>
 </section>
@@ -797,7 +797,7 @@ <h2 data-number="1.4" class="anchored" data-anchor-id="constants"><span class="h
 <li><code>ImplicitEuler</code></li>
 <li><code>Euler</code></li>
 </ul>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL188-L204" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL188-L204" class="documenter-source">source</a><br></p>
 <p><a id="Macros"></a></p>
 <p><a id="Macros-1"></a></p>
 </section>
@@ -805,10 +805,10 @@ <h2 data-number="1.4" class="anchored" data-anchor-id="constants"><span class="h
 <h2 data-number="1.5" class="anchored" data-anchor-id="macros"><span class="header-section-number">1.5</span> Macros</h2>
 <p><a id="Ribasim.config.@addfields-Tuple{Expr, Any}" href="#Ribasim.config.@addfields-Tuple{Expr, Any}">#</a> <strong><code>Ribasim.config.@addfields</code></strong> — <em>Macro</em>.</p>
 <p>Add fieldnames with Union{String, Nothing} type to struct expression. Requires <span class="citation" data-cites="option">(<a href="#ref-option" role="doc-biblioref"><strong>option?</strong></a>)</span> use before it.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL43-L45" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL43-L45" class="documenter-source">source</a><br></p>
 <p><a id="Ribasim.config.@addnodetypes-Tuple{Expr}" href="#Ribasim.config.@addnodetypes-Tuple{Expr}">#</a> <strong><code>Ribasim.config.@addnodetypes</code></strong> — <em>Macro</em>.</p>
 <p>Add all TableOption subtypes as fields to struct expression. Requires <span class="citation" data-cites="option">(<a href="#ref-option" role="doc-biblioref"><strong>option?</strong></a>)</span> use before it.</p>
-<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/afad226f51ce73d9a725233526198aa7220e36b6/core/src/config.jl#LL56-L58" class="documenter-source">source</a><br></p>
+<p><a target="_blank" href="https://github.com/Deltares/Ribasim.jl/blob/073c089befaf4ea852e55a5bcc5a1f0bbda96dec/core/src/config.jl#LL56-L58" class="documenter-source">source</a><br></p>
 <p><a id="Index"></a></p>
 <p><a id="Index-1"></a></p>
 </section>
@@ -818,8 +818,8 @@ <h2 data-number="1.6" class="anchored" data-anchor-id="index"><span class="heade
 <li><a href="../build/index.html#Ribasim.Ribasim"><code>Ribasim.Ribasim</code></a></li>
 <li><a href="../build/index.html#Ribasim.config"><code>Ribasim.config</code></a></li>
 <li><a href="../build/index.html#Ribasim.config.algorithms"><code>Ribasim.config.algorithms</code></a></li>
-<li><a href="../build/index.html#Ribasim.AllocationModel"><code>Ribasim.AllocationModel</code></a></li>
 <li><a href="../build/index.html#Ribasim.AllocationModel-Tuple{Int64, Ribasim.Parameters, Vector{Int64}, Vector{Int64}, Float64}"><code>Ribasim.AllocationModel</code></a></li>
+<li><a href="../build/index.html#Ribasim.AllocationModel"><code>Ribasim.AllocationModel</code></a></li>
 <li><a href="../build/index.html#Ribasim.Basin"><code>Ribasim.Basin</code></a></li>
 <li><a href="../build/index.html#Ribasim.Connectivity"><code>Ribasim.Connectivity</code></a></li>
 <li><a href="../build/index.html#Ribasim.DiscreteControl"><code>Ribasim.DiscreteControl</code></a></li>
@@ -838,8 +838,8 @@ <h2 data-number="1.6" class="anchored" data-anchor-id="index"><span class="heade
 <li><a href="../build/index.html#Ribasim.User"><code>Ribasim.User</code></a></li>
 <li><a href="../build/index.html#Ribasim.config.Config-Tuple{AbstractString}"><code>Ribasim.config.Config</code></a></li>
 <li><a href="../build/index.html#BasicModelInterface.finalize-Tuple{Ribasim.Model}"><code>BasicModelInterface.finalize</code></a></li>
-<li><a href="../build/index.html#BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, Ribasim.config.Config}"><code>BasicModelInterface.initialize</code></a></li>
 <li><a href="../build/index.html#BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, AbstractString}"><code>BasicModelInterface.initialize</code></a></li>
+<li><a href="../build/index.html#BasicModelInterface.initialize-Tuple{Type{Ribasim.Model}, Ribasim.config.Config}"><code>BasicModelInterface.initialize</code></a></li>
 <li><a href="../build/index.html#CommonSolve.solve!-Tuple{Ribasim.Model}"><code>CommonSolve.solve!</code></a></li>
 <li><a href="../build/index.html#Ribasim.add_constraints_basin_allocation!-Tuple{JuMP.Model, Vector{Int64}}"><code>Ribasim.add_constraints_basin_allocation!</code></a></li>
 <li><a href="../build/index.html#Ribasim.add_constraints_capacity!-Tuple{JuMP.Model, SparseArrays.SparseMatrixCSC{Float64, Int64}, Vector{Graphs.SimpleGraphs.SimpleEdge{Int64}}}"><code>Ribasim.add_constraints_capacity!</code></a></li>
@@ -878,9 +878,9 @@ <h2 data-number="1.6" class="anchored" data-anchor-id="index"><span class="heade
 <li><a href="../build/index.html#Ribasim.findsorted-Tuple{Any, Any}"><code>Ribasim.findsorted</code></a></li>
 <li><a href="../build/index.html#Ribasim.flow_table-Tuple{Ribasim.Model}"><code>Ribasim.flow_table</code></a></li>
 <li><a href="../build/index.html#Ribasim.formulate_basins!-Tuple{AbstractVector, Ribasim.Basin, AbstractMatrix, AbstractVector}"><code>Ribasim.formulate_basins!</code></a></li>
-<li><a href="../build/index.html#Ribasim.formulate_flow!-Tuple{Ribasim.TabulatedRatingCurve, Ribasim.Parameters, AbstractVector, Float64}"><code>Ribasim.formulate_flow!</code></a></li>
-<li><a href="../build/index.html#Ribasim.formulate_flow!-Tuple{Ribasim.LinearResistance, Ribasim.Parameters, AbstractVector, Float64}"><code>Ribasim.formulate_flow!</code></a></li>
 <li><a href="../build/index.html#Ribasim.formulate_flow!-Tuple{Ribasim.ManningResistance, Ribasim.Parameters, AbstractVector, Float64}"><code>Ribasim.formulate_flow!</code></a></li>
+<li><a href="../build/index.html#Ribasim.formulate_flow!-Tuple{Ribasim.LinearResistance, Ribasim.Parameters, AbstractVector, Float64}"><code>Ribasim.formulate_flow!</code></a></li>
+<li><a href="../build/index.html#Ribasim.formulate_flow!-Tuple{Ribasim.TabulatedRatingCurve, Ribasim.Parameters, AbstractVector, Float64}"><code>Ribasim.formulate_flow!</code></a></li>
 <li><a href="../build/index.html#Ribasim.get_area_and_level-Tuple{Ribasim.Basin, Int64, Real}"><code>Ribasim.get_area_and_level</code></a></li>
 <li><a href="../build/index.html#Ribasim.get_compressor-Tuple{Ribasim.config.Results}"><code>Ribasim.get_compressor</code></a></li>
 <li><a href="../build/index.html#Ribasim.get_fractional_flow_connected_basins-Tuple{Int64, Ribasim.Basin, Ribasim.FractionalFlow, Graphs.SimpleGraphs.SimpleDiGraph{Int64}}"><code>Ribasim.get_fractional_flow_connected_basins</code></a></li>
@@ -922,9 +922,9 @@ <h2 data-number="1.6" class="anchored" data-anchor-id="index"><span class="heade
 <li><a href="../build/index.html#Ribasim.timesteps-Tuple{Ribasim.Model}"><code>Ribasim.timesteps</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_allocation!-Tuple{Any}"><code>Ribasim.update_allocation!</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_basin-Tuple{Any}"><code>Ribasim.update_basin</code></a></li>
-<li><a href="../build/index.html#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.AbstractParameterNode}"><code>Ribasim.update_jac_prototype!</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.PidControl}"><code>Ribasim.update_jac_prototype!</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.LinearResistance, Ribasim.ManningResistance}}"><code>Ribasim.update_jac_prototype!</code></a></li>
+<li><a href="../build/index.html#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Ribasim.AbstractParameterNode}"><code>Ribasim.update_jac_prototype!</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_jac_prototype!-Tuple{SparseArrays.SparseMatrixCSC{Float64, Int64}, Ribasim.Parameters, Union{Ribasim.User, Ribasim.Outlet, Ribasim.Pump, Ribasim.TabulatedRatingCurve}}"><code>Ribasim.update_jac_prototype!</code></a></li>
 <li><a href="../build/index.html#Ribasim.update_tabulated_rating_curve!-Tuple{Any}"><code>Ribasim.update_tabulated_rating_curve!</code></a></li>
 <li><a href="../build/index.html#Ribasim.valid_discrete_control-Tuple{Ribasim.Parameters, Ribasim.config.Config}"><code>Ribasim.valid_discrete_control</code></a></li>
diff --git a/core/equations.html b/core/equations.html
index b9f1d3e2c..2ac1b3d84 100644
--- a/core/equations.html
+++ b/core/equations.html
@@ -424,7 +424,7 @@ <h2 data-number="2.1" class="anchored" data-anchor-id="sec-reduction_factor"><sp
 <div class="cell-output cell-output-stderr">
 <pre><code>&lt;&gt;:31: SyntaxWarning: invalid escape sequence '\p'
 &lt;&gt;:31: SyntaxWarning: invalid escape sequence '\p'
-/tmp/ipykernel_7197/665069857.py:31: SyntaxWarning: invalid escape sequence '\p'
+/tmp/ipykernel_5390/665069857.py:31: SyntaxWarning: invalid escape sequence '\p'
   ax.set_ylabel("$\phi(x;p)$", fontsize=fontsize)</code></pre>
 </div>
 <div class="cell-output cell-output-display">
diff --git a/python/examples.html b/python/examples.html
index ac9b04dd0..3038683c2 100644
--- a/python/examples.html
+++ b/python/examples.html
@@ -545,7 +545,7 @@ <h1 data-number="2"><span class="header-section-number">2</span> Update the basi
 <span id="cb26-4"><a href="#cb26-4" aria-hidden="true" tabindex="-1"></a>ax <span class="op">=</span> df_flow.pivot_table(index<span class="op">=</span><span class="st">"time"</span>, columns<span class="op">=</span><span class="st">"edge"</span>, values<span class="op">=</span><span class="st">"flow_m3d"</span>).plot()</span>
 <span id="cb26-5"><a href="#cb26-5" aria-hidden="true" tabindex="-1"></a>ax.legend(bbox_to_anchor<span class="op">=</span>(<span class="fl">1.3</span>, <span class="dv">1</span>), title<span class="op">=</span><span class="st">"Edge"</span>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
 <div class="cell-output cell-output-display" data-execution_count="26">
-<pre><code>&lt;matplotlib.legend.Legend at 0x7f601751f200&gt;</code></pre>
+<pre><code>&lt;matplotlib.legend.Legend at 0x7fd0bd1c4590&gt;</code></pre>
 </div>
 <div class="cell-output cell-output-display">
 <p><img src="examples_files/figure-html/cell-27-output-2.png" width="727" height="561"></p>
diff --git a/python/examples_files/figure-html/cell-55-output-1.png b/python/examples_files/figure-html/cell-55-output-1.png
index 57b010ba9dbc5a46bf0ef5c954a5373fa3c7981c..0b71330c1aa677bb7e1b06670603463fe8ced966 100644
GIT binary patch
literal 71077
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%0D5{p{r1QdxDv3C%`IHJo;ZMs{
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

literal 70967
zcmc%xcT`i`7Y2&Pu1K+=(vKRX7wIjaqCn`qm!tG95L##+6*!`R29Vw%A+$&nDS@Mi
z2uKYO=>k$ikq&{tT^oP*-ZAbS<Bj*v8;_wwgzUZ7nrqf?esjOn)mCMoW2J+^U<^pL
z2l_DB$z&Mpgv{B~;3u9!;>+M4S=2*Ql!2!M%KwqKJxuEn>WP~t%FX%lUw-!9KF*#V
z;=(e*cLe`(LZP1c$cc!!|6d;v_VjiX=`Fsj0B&;biJF-Y48{=&{XG^ty=o6T27@6V
z+%pVFTO17xFq|H2SshR2-s`+{>BIXopKqV#zghb4$E#J#ydF+P`6WiKd$q<Et|jIr
ze)o!Wy@ZydvT{EDl~W$~UiruUZw-!^@81It&nDa5mPaNb*Jzd|!n0}X-^I6)nrh26
znR|CMNfM{PGQd~mKh5Ld(a=}c`mNTJN8de_`v3oT6}$4VN-i7;Puttpz~toQ*p<Ce
z{<Ay=pSn?getrymb7kB{%3`?p0X(_(4fvev@1LIz7*8DS0VP)FzcP?@@A;6#nS9}+
zAHkf&`N0PZ3V6GwM(g|qZr}bI_UX@tpBn4x{xrL2B#nDgsV3%o!#7B@`O6nxDXD?j
zo<E=H%t27)Dl8fQ+{s-9bMF5~-#M)N!_Eq7;|%ii^ZEJs^o)!WMm(w;mG8@!nF^K<
zFGc<PuWmrVM>nYk+R?!+MK+2}yiH8RHAOP*$<w2<*4Dh4nVFFo>c)KTj~}K=sz*|r
z<5v^Ahe7T9el$Hj9hhD*=vHnjC`R9;qnAxg!tzxQ3*kufvWdyb__j9n=9ZSdJ7UlV
z@0#4hoGUCY-cT3aT<F)()6=7)qg%5zoI9J4kN^%r-_P$u-oirF$B#0DOMXhKkfp%p
z7M=DPn6F$3;N*eB3mm&L;7PRwSy_K=E)E);J9jR_$G7nS`W%d12&1VR7+3>u6{Uap
z@Zqj3EBkryhz$ET_V)InF-JG+W`1M$%u+ZJ-s(}^{&*tn<#Lt-P8PpKVS?^(*W!)d
z(=!YWb=Mlkp#MMJdhq}K$ykl0$@<t`kI<H1k_d~O?BTp~YBJ<VsI?*(P3U$opfmsX
zcd3mhV70lY&R=!<^z0O*XiuNorC_bilS@q+$9bxq7oL^9tfjrqF1H8_y8?T9_m7es
zo8}Vmn_smbR%p=?8P9(G%o}k)@(O(o+>AtI_46lv!E8F7LzPIfm47;Qdxh}x=ii(2
zB-KQl&>AU^ksrSl_O_Nt9R4HO@$pw4s;KY_3Tie*Fpx^B#|ld<s-@Ue@7?=nxn`D=
zflJZy#*G_Mv9V;?*|gkPMQVZ3_WD@R%6zYeh|%Ezjrr209H0>C0h2G$`>QQR#>NAM
zH7O(vc67<t1_ndjc4m2qUL!4Sb{=|m94i?~o{IbzNLWL!^@ZQ+OseNXEu}QBY2tU9
zeDKcuvEX$r;^D!bdAZ$7Z6(?Uy33+Ipv<8wV`)<XIaK3=^IIOlU$YLlr=vux^r&0<
zaN5RywliIhwn6g!`QNdwn&M(XA&U>1?eBz0A={&5x5e=A@Y==l_KjAa%z$)4K|%LI
ze^C{B(*<$3ziwWO!k=d199axr%0?`ohdu3_143<^mSU^l`q5j0UilDbfBmaohn4w6
zUuW?phQ*86r1x1LUH~Iyy~}-h$PGNYcDa@!@#ynOA+z!akxX31Dk>2N>zRkV{QT;S
zk;-J7Fe1=0@_GYp%fia5nb}*0U0qYNPeX*5cj62quei9ut7{?y?;kb&@~%PcEmc#N
zs>e&WYr&<nnPCl#>@t6)c3{V8%l<>PzD3^N-W$`2HVd!CJG+~hl!`?f_se^Jq-*0k
zl@5bL)>?V!7#RmV!}csn%qmoBYHEfW!y2y&nr4O4sLm}h9CBdG!^9l?jU_MWU{so8
z_(L#$AA2ZlOjle;pFZcN>`kw1x%6@=ksfxH^u35w>OZmKZk*5_Qki`m_Vl!F>kBFQ
zfZthIoy=082WozGqdo@_Y#zFHc6q{ei(*Tobtai1TgeXJlO}3H!Dia0z4@f1j0H?e
z4fXXgvqRj8mO0KOtaEQ3a;VOq;L%9)vwHIBl=b@I6xU(*2lsv&YevwrY)860*~fjT
z(%JljTXLu3o?FOj^R?)&2a6S53#pzBZ$~}Ij+r4?ya5hf+T7ec4-|-$?3jT+clovx
zIC$!;(jk6)e@5D!8Z3$XbFNOi?*xtHTrVrprtV8tn!ITE@oq_W`+!Oxy>yLK7&vYb
zrn^n78}wO}$`3EvYO_y4|KhP7VwZ-&3RJ*BH;Z>EOeMeyy}&|%gIB?9(6+~eItf6`
zl!1~s_^3}8!ulMRm5AQ#<vQF^MfPSZM{Z0+a-prlz$M&B+m@J3^)G$z2i?%rd0gu2
zx*2MR^!Q@J--SgsjiI%)tzm8?p?*z0ZoMjU>!Sz^CYQ@3?GV6`sU)SBsJS@nyZk(w
z#ap^Ot@OrVGc)=pt?x8Ji0YBqFdj#y-i?)cV}qS-94f&nj+ROW#fEaiV6{;madztJ
z>X=8@g$|O$9kq*Wa<R!iK3qVrLifhAxENR^)LL6x8LTVJOIW4clHh#e;v}B~3ZZdJ
z;b2}TY-n!enoV$-o0J7{_SfvJfRK<DM#6QVSS3@*;rsP2%HB|!ZDcQr#Eo>!2*iRX
zvC^(1(3Nm!;6{LJciY$;D*Pk-g8JTkf?t62mZGQTvrf$zlYlq<KFd$^!h0E+s{+Pm
z8^=nXl^3cI4wsjrRjb^VJGizfuNy=0O2UIVxWtui?nBG`VQaIZ$Es6=Qy_Mb-7%Ua
zl75S(VUgX=@Y}bg0ujJ_Vd|+YkOpF|0Ecw%`Dsb&NO!lcPQ_Bn3*C-&tqQ8u_qVrH
zrFN;gD$y>#gF7%1cyyq(ot<4SSE8l&OL*&&pMVHqY7FldyLTLxB~JD7%pmL6G~CHn
zN50l~dShe|xw*l*H@)RHj*~7Z?!}WE$HBQ&UL@AX_}eGC%+F|6edWO?*9NVs7*XLk
z#UYehV}QF=5r4@-;gi~p<=W@yUriDS+92bSjAgLlIt=zxWb}4x{JVG9$;rvvN-oq>
zgKkn*A)EcGG;;%-w)>jzRT1kE>uTl;F8t9c25|~+^Cl-3Y*KFCyqOXLR-Q-pf#dV?
zzN~+&k!7v3HVr^UD~I@hcGdZxeGB-{pgA(digAwDYMh&hmz8a*L|ef+=$U2HGNyir
z)*bkEJg{1*IJuIa5M<8o_$V+T^ssYAg+Tc6t|Tn9rl@(nU#*?DcTguJ--cLbEfQRz
zsuS|T%JFbXfOe3s1$LE^nRPCF+Gr@zVqhi^gf;DI=Y1;!Em9KXhiw`xF%q_4=|SA*
z+H^H5F}?)rC_u9JYZXdh9W*<9;43FJe0(JQh|BE2iby-FQ>oGUxm7J7Sa!3Nj7_E6
zrHEC2KsyhKuE0qt#9e+rLq4&*P^E9Ria&miPR+Nqp1AV3dSSpI(rGp2M8>-7HnWqX
z@ym!UkAv-M$Q05rbOfJ!Qm;&y2gKX`=O)jEBwXMaS`5Zi%GW(e?6S$9lsk6^DW)~w
z-@g~Hr(3#P5o_|M#CL^>FqBZlqcn=;>Rm6Isx(LWsn>@FX_r%5Bx!YC2AU+pP_u;M
zi0lI0R34VIu)EcGJD1KPLIXdpg37f;DXr`5>OqA_MmKOUM*6Lcjn2tLHf3AY`2`|W
zF{c^X=XS##fS=N8FxHB_WuqKHzp7we=jX2RdHKnolaq?!Pn6=?C>2$Fq?<PDb@)+~
zVVQYZ)~{BpWN11)el5Yo+)TvFcW{-)jZ_X&oy+@#s4pc}EI&<&Gg|B}Dk3J1cgWio
zG}Kchn#0cob{ffyq8CU@9i2SLd}i&@wY3!VIc%-5Tl+w!(%4YWZr%dCd!OJp-!|L0
z4o`yPd#48?*_h@>aE${Ptw?hPo9Gb?9bzZ6FedDmxK_Z9LG)e|Ps-YC*X9?V;dmSL
z214L`dr>9Yzf^Gyr8d6QX>`x5WwY@l3?+!sR28)RsEfJ6##VG*q`n&x3@*((YSzo3
z{mgjaEQih-VcF-gtt|raax8E*T_v;8nRI*UM_KMCS3W+zj8J_M;)Z_v^Od{*6Ahjv
zywJN}xM+p#a^X(F1;U+%e$9?ed#YReqki}3_z@m`B*OKw(KVepisV6h)tS_#{EasM
zy?UzXX7suKE*-AI7jwF!fm>$@Wv|HW-5<Ws1o0z2po;wL0!?@_-;P+E2<DHrwyaUj
z%;)g%Q^eN}E$C>l>ZmiD$oLKyxo*xd?O8}<!imJKr`m@UI-wmYs~X=+>XCFD)V*1G
z$t4k+xiF>WZI{^YG~d0o&2^Ijr`}tc^J}}~^Nxh#e&+Q?k{450;ozZJNmnmpwTmLM
zjo*6?a(OY*WJ(+OSZ`QpQ6Qm&<YTj_u)t~JQH@VGYo@{_4OU8&3bv)~oJJdhncr2H
zwAKx~7Xm-@tX!R-E(4qUUfbbagLNDEs7E0a65&v`0rCNl#K2LH>JbnBS3y^Oc`o19
z?DlHm!1+=J=DWfUDxk1UQ0GRrb#(NvgdGMU_3z)mPqf<g_&9NzHY45G^EH}HGVCB2
z3dxjO(tMvt*lxRutth>+|A<%Qa{an?$a;q~dZR~mvu>PL+OsO0s1dZa*wdY@Y!O&p
zLK=WvX@yx`^<AuUA%9S;Wpm)dosW@u;`LwC<mwZz2B!);>b)y0-=3!}YNfDx-v#y7
z_Tq61a(PFxH@jM#nI3Uf?eN<J=BqIVC=>`TGf5{$x5pf03rD<7;$6r?T$_E*+@jV0
zH8wPi*H+xMBkc002@}iF1pW%rG=JgPDbKZYC*pnQvQE=q&uWiZ!5s!ySk#qka3eho
zYNuKgQG4@Mb)P!ZWJ#`_m9KAtm`a$<fY0aMKx|N6p6KIoE)HEAQRfik-G1HZvw9j4
zoTDXWvgA$VGr$HcBQawjap($eFj$V#H)1a+iHdm{WBjmd$W+sSx-`sYUv^!cQMmhn
zR&@>s(rkw7qCdaM7=-P)MP^uA(`Jl!OSy>4H&EYJF@={+{DsB}JpE?obSl2`Za<08
zH!wg<Erg~=u^XX-=cR<qi6&S+0wE55YMTvD@K>{0`PP${XG&Whd7C2omoZ3lsawOI
zN0$sNwUf_}FZT2T8P;e)*9-<RbWiCKCB<&2E2aO?0mf03^nPKXB39|(2PMOyGmTF*
zK||n!J*6p{h3akbAxa?4+J*;N{&2f*wI!O2Zwi|4n?OjG+ProfSlIq;Qfi6M$r-Y`
zfYVIA8F{g|DrmjR&!%Buv4cGG`lhV<D})X1+lAEA8}oQ^9r=g0d(BR$aVLh?=i{37
zt)?3S*BuB1gWm3og>=!Rj5PhFHsSu|#Y_3K?+PnF=hv4MF<-Saax;DNxaqkBZIOkw
zPvHLZpa_9Gw+#nw`794t>)`QtF)agbX6?aTG+%MoUmV{>OjPdGlxy%CTF>hzw3mF|
z=qQ)tpsTWAW_BRwUDodVPZ7~Ce$$kA^EvZ1PIz5^&gakfLuei9Mlx3X!v1acOnQgE
zrs7S^@gu$J)9(!1rv2Jo%6R<`wG(EzjFUzS-~Uyl@|rzA`+3|I=Eo+61y*`Dq{7b(
z8&04oO|kC^KF{k1=4;p|2uG(WXg!?PW|l1kE5S62+EuCTnnlJ3{hj#C{pzVf!38p*
zQ6)xQ&-9Ja4OMHNFCIo<wS-19eEt4$pwl3tO4x0j98|t#I4w4fszbCkwv|6#(zf6!
zdi3q_^{Cgc4clI{mYWHdo6`>pMidV$94?R67!5{>DfqzQ3<jDjCyfkirctTo77T-e
zR|nm%me}lu7aQlI8JoIWaXN$skE(Bezg+E7djC1GSLri+H5qHCzQB@MaIY!OJ_Xb6
z-sYYnrq$}6GE_Mel#qC}{r&ZF)`+iKX~hL|PG&;=Wg6HKtf8T4!KSORiBgwPxXJ^k
z4X-%Fx>1-~L>^JTnon9l`6@D^x%=m%R`tbUo2$y@rt~a@2g#0YeTB@Kfs+zi&TEz8
zG3?|ornEy(<FCh-Mys?U;4J#VnGLKGkMrn_4%3Zk;|r^7<YHrIWSO1up(d+jDCYCc
zTu>D+V6)q!Ud4Ynh+N=Nr(=rkOL`f{9jJ{*J2-d62(`5pTj{4upk7Q~Chl$aYc^1e
zrhT=O<sJ<sSG6$w`qZ)+tJn4KRx2M$#ZJl4q8VP*rC+0!D&;)aojp|H7z+>)kcmkI
zuGv9ZSnXt#z)(D@t*gs(!~EX8PkLPxrY^<3Vyspwc7H!uD_zbgj7rKx4VXE$x>UJL
zw<S<%D`6{xddq{3nF*uIqy7`15~-Q#$|SfCf0+L;>_HkM2KkQqlJTmsoa!1Hq~}bE
z1tJYQ_mN1XwLGa`(sN89WM?AMyzFs!=;7WtW!ST^U#NN{XDUWsdtzb&)aZQ!B^H~z
zvze4lvJLsvHOnke2z^ji68RGxZ@X^I@XgX13*0DVOdb<_zHFHIHBD4T+pj2la?~}x
zdQsLMDYyO5d3mIUy4`rVB>5rlGjJv|yoVKGMQcws%lEEb)u_%8zjv8OJ0AY<<S<HG
zor_qfsBE+w8DF(?Z!|FPBl`1;bLJHe(d0BPH<`RNj5;%6_bxZvJ0#}dgDES^rYDFM
zCQ?NY{WIf=Ev!pJ#xN~mc<xwor(QLGi-Z>9_klx=7JmO50@)jcnOrYgnO`yCz_lM#
zsdwHAOJI&Sa_$@nY#X+yQ(gw{X|4vRb%xG&domjHs|LqP1MzDm!>kyT29tPJajp5~
zW;Ti77FYAF0fCIN!vp_Kgi*~1wb5T{zJtp(@zOxL0p|3<mNH>#d%%%bGFJ^(OQsyu
zg-**V`7c}2C^m<^<$X<{p6ZaZG)(0!+VjQaDUxYgpF#@9`}S@iY_1(nS)?mT-E-XJ
z?<w}_+I*cV`smpKb)khyj<PZ*wghdD*8)!&mFiV@vn4ZEC^Bjzl8Lkd&;vP8>^Q_A
zyK8)B;`3~X4cZ`~F!l=HzV!9zg6sY<QX87R5wufihh4^p5kDmC)tEpa8z41)Gz$7K
zAoVX-(4Laf^)Z_U5CzKNOR-!zqXR=qsHW$|>e~P6uYCKv#PT<fyZM11G05fH*x|^O
zZ+&^r7UhavRe`_Z`<u#(L)B}DeA>!6LePR&%=Wf*wDS3bzBw{p#qPaU_?ZvRhp(zU
z|2^Hzr1v=u$Cf7UKd;2PFDDtG6HEI-`LTUSWNoG>m2UgG>}P}yE+UZn4`;OPh4&L?
zKh6hHg9Mi6SqW2HH8`8S-Hg%=IgiXBYC`79JU?OT>oWeU23e<f{uWwV7Arv6Lf%en
z&o{9NF~Y>Br4?V+mdWn$nE`mAyH6%S81pqi@zk4-o=JAx03i%2h_$|Ve*|AMXM8Ui
zU^RPO2}CUTYkY=@(@pe~W0m>l21$o9`AVeJUkDC=z!m)apH7)6dJdT<cOi@1z$wvM
zUB4gF#t-NJ`{zXTZQDh^y0NgskkKbi4CVk&Qr!Qo9J2FhN=ag<sI7$WkMUf^I=eJS
zF=w1Ku>JhZ4T`CmCC=VSaOdU^#aD%tY6I>o0ZYgo^ujtXG<&9u|FgWPw+fYpE-HEz
zw&NC=6a6Ci8<$UiS&(*&?Y7l$O>9Vz=&j?c`*`2S=0J~GYh*hu?hGG@VoG85B|Ki!
zQu&_#(|v3fiv_()gi=>Ovq^+_+-7yxhju-qy;}JS_4wM>phzM}y{)!;nS{nzy2(&h
zUh+NNdiDdC@W7@B?TO(!l-mc5-Xjv1|0cSwNIWU!j^fZ3(m)j3<0E}}8%HSSK<S<}
zu?0T9tS(?>UQtawj2lVo&5dd|$!{+?u{(`vGqUV!sJng5M27gT;rLu=ZHNxmzWp75
z0}S+si;^a%rhEa2=)Ai&4f#lR#z=1;pDMf7OX-0QzQ|D~rTr`xafgD+%8-M%bBm!s
z{w~8G+^PM9(0ovD^D8J=W@l%!%ApEoI@61QvxOX?>&7kwHUdwI+8*_H{qg=0$W)EH
zG7yp>R1|T0EC~JUt!hg24KXo&;0F&kfVZOnpsD-!L=*GHi#Gry#)&}By|}F1J?cMR
zVpL>2PY9#A291U04ox)xq?n%ZYP^8Y9`$N;y18RZ4OURY-E1W%E^^Bd)ZLzcm5jyV
zDwR8UV(6Q?MY`Ar7C&O>a0iun^9+hE-_xZ`<IYIZZrdWm4WtEk?nTn2>ReAt?^W%x
z_DyrFi8l<ZY1wLOuKl?(-lrkj{GxxnV+E9;b4@my{r~Q$5!QW!OpyIHaS@j^k%-Ur
zXnSPuxG)!iq`FZkJz!${^2;OQEs0uB6w&9Ml-sjw94_QH)~av0T~yvAr0>E|LZb~B
zyaPV1`EidV*^=~q4vX0OVY}IR>dYC}neWMRvuQpOAWk6m7Av3-VxWV_4_YBs_Y?H0
z@3)x%&=vwT7i41xo}D^h`S+)14lO07WjU>s6Q}9B!H0eOyuN(-GFR5Z>H2$Jq)MR^
zplB`&eRx$4Ro6;5cB>X(Psay`LQX}=?y86LWadn6auw~gY+t!@rSIpDxX8_Tp>o{)
z(?%jp6&4I#5iF7*-3}>})WBRB@y`={bVttP?&}=orKqT=HCETE>(o}SkWDwLM^{?e
zBR{QV?|SmbS|iP^j1zsH-;o(`mBWKEjVx?z6uIC9Z$1bA+IN;~9^@aPcQWpTS$)tl
zYp!Z<zMm6B=@Z8aNPOeR*YfC(UeDZ_m+1(mx+WOPAhxf#R6AK7UT3+NT^l$NJM^nU
zetg;>!gY9JD4)wWNIgSb?w-zmUx`g)jWyORL`Skry|<lB<BD9~ch`o{vTXB!CcDvw
z!UJziHu2VGr@H}aMLrdgaL>0<TQak{*6pgY4~}7=UOaNXG=wDaF)U|x=tcI++Ta<{
zkUDYIFw6300~UvKbekFCQlDHqfr51lks{{eA0akh`w}0IRK5HZXrfJe5vM~w3>_hm
z8^%}qDTT{vzMHSl4(!@qMjiY(sdfEAQNBhxHK<diYZH&l%>O0cGT**5NOf?GSzC~J
zK-iV*e}6KZ|C@`R`ZzE6v<2;ss0z1PlcdO$Z8DZGl2r1|nkHdC^tZd5X+huXn}nIk
z1{++~oHgr+xaD(ngzFQ+69&azAH1X8dykz7fP-oo$ys^JjHbwzWp4e7chS+to1}pq
z8^4NwBVouxPr(DpWSri=_(^K8<SNa5MPf;3g$Flmm`^H+`+B>TWl&j`o4Jh-zwzDm
z9G%hJ&zI%bBNmO7?}Sh(eHV#+w-ihfH=kX(#+i2^^`Uk(UPqnB*+4frP1peZ=WT8z
zpMx3`$dDCi@7nk+={}fUk#xi04&Qb>o=b~Y>>np*ONE~vwBww=70)VVE>M93fc&(W
z7I%zx&(Cax0x^x<NI1cy=89d#H+CuG7*2#eqPKBwqYSw)NFY2bzB(AQp)E$wxA$~o
z^=ll07?CrzHy`iy(z|BVyH>Miq<^(;1ly|ur|24G)4#I2Lm$m1uG#dJhyR<y+y2LI
z+m`^~Z3wdR?UoF~(e^ntLU!x($zLd=ZI43lWHGpzpuXS4-TYX&2{q{(%IBKmBp*LX
z6I4Y%FcVbq4TCpz`{(i$6qu|mWPpy}$eWYl+fi}t#W7u?@S;Zr5`y<A2HG1N526-E
zZFpkljO1tE?gGU0pDP?st_3cKJy`pjn|{eFFU-JqQ8FZ+-$1+Xt*E_Pid20ft`U>3
zO~?;nR!(^5g~6@pO%~{>bB?uF6o16V#x;v>D7Sg>FZWwW@(o_b?D1iBRu;$#-n|m}
zpMTJWNYCUg*dq0ad-Gp@jaB&+`YpaA=Aycd_QW6m`gUVMzCP4@STwIoCG(eWr}R1N
z3i*I&&IyJ?wgIc_4zAU1bNA`apYO-%aLKYWriW||0$ko~UB~4)=;<+VDwu+>-1qOr
zTa~`9?bSK%FF|hH<y~7}uh9JU>xa2O&@eTA_%Qt0^XIY77`lUIG6(F!S<YZ3qw@_~
z+w9{q`I!eR`*+Gs7p{%STX}G7|Hko`R@f~9ce+_<zWdnqU8#+3-HSpKyZ6S2%bGgt
zb~f^i*IcOvHi0n=%I03P&a6LjYhCOC@P}2}%r~j(qWI|ay?h=df!1l)7bl{{f&V2a
zXkUA+(YG*KQ#-l4Qa@9-v~i=>RmD4Z9oY*RX5CfK4Y_L<-3<O6%>fxLVVxAQ-TR8n
zvEqDxGznNOZk$NOx8A`3za4L#CXOWDQchuaOu>%rdo^;>0*dI`SjPjGzI^gR|NeZ1
zd;6seN|T{_xKA~e5rP&gUHm<W6p({gsBZR@;23+7LVFm#cmGbaS^3^GYr#lqA?^+(
zn%o98_}d$P49hH~FHhL|qP;z})T7o5cU(L=fmN3%>1Ku0<hKcx#E(AKd+@K8GWwy@
zgG{x2xC-AF5BHv6{mohN-0tkrL2iEDB7Ns@gGZk}ES#S3dc=C++U+25o2iH^?~M2w
zi}jlsarDZN*<G_v-(RKK)<_mwdL+oC(Un;+Kd!EH7KXKS_RL&lC6x#yj|EII$g=m_
zH!t=4u9LlY?_P?m57s(h;uNT8v_Ll%=!NUSOVH4?>Kh6f3we2)>7}RWCpZ%1|2z!K
z**d*0iA^EITP*^um3E{Xgjr24=5eQINK8bts*78rle>bh)j3d%hBXZ4Dp?v5FAp^~
zj7%q7U>%iK=aHxgUIHnWobwYVLf$vpiu=2E_XQ>{Y+wgjNx0ATOzl@oxw6bq%`P&V
z(!jE?vHpZ1GJN}^7tMB~tB6M;^>0j`01uNc01}qX>puy2nUIZm=(}mNu`YVvUqtDx
z6rG=TvZQB0eG_|p^3YqOn@GBHGYNN75i3P}V<+oiUGurKubR70O<nT+^zp$`mjEd?
zXdU&j;QlA6R~YmQ*WN6dhbOC-by#0D%aq@;T-R7L7oP=ZE2NF8dhzJ`0-J%AUSCE|
z(_)mz-}AN>z?U}rt<y2WMip8OD-4A}hp@t-L+&<Vu+HB-arfD?;~33!L(sRj6gDZ!
zyvE7dStkdY*%Jlcd>uIC){A3WjnCzLO?3!x5|48-b<kNEZnQmT_AX^!@&Gu_j;~&$
zNF=r6P%0p19Oz}J@4%A;W0}oToy&8X>2j5WVeJe}-Azg?CCNHr)6UP*Y>XjPzhUf$
z(t+J;$7D+%A4M_ON_ByB>XWJL(=D%;+44{M+~%uiMke~GZ1=qQ=MHr{v91c`gN3py
zu`gKXCiMJ_^K;3DFwIx9g%?34lP<0@*U56raIpYGvghaT8=EZ5`nnN&-r!Is)c^F;
zy94fVn)3e3ebwWk0!XMWdxdqVVda7Z7TfwUPbx9{Qy9Ra@K9T`ziSvIn-~mcNa-)o
z4a<%`Lx-qKL-s!XD7qQtR(o+f`PP*0VGurJ%6E?r!tTE$>4M&JZjKzYER<@n^zM{@
zV1<l+s{I4s`ZsNh82;*veN-wVvrPRY8;FdvuRRo<|KR6jQY1x0qgqmK#>A0<RB3ET
z`cZNf;nVB|RRLWgWd=2>=$|i6nMpdTV?qN5L{ANyH?S9}tbDsL>VLos{jC{wh)b|3
zVP@$)U>1ix{jVQv^bnu{h}hU>eOV;v`cikMV!4r^;npHp23Rr|oZ8yjD$zLq{+<`d
z?sO;;JT(hq*e>LP-6+f|j-}z*aEyi3oBOi4m(45P1iv}-L>ru$kM;Enw%8bLKu?8+
zQoD_fruG;6ZnW|8dOj(Iu+2b6iAK%N#OB9y5%}j4dwKs1d3}7KU2V~XR{c=GTA06n
z0`{cRe4MZJyr`A|BxShsw>LMI%5zN}930}>aRC3A=}5&XM;5lH4%fzU?7M=3NKC7u
zpUd#hF_`X>%^@{$xi%nbP3bVU(3?pObDQ4HEMYs)w%(sPD2#TGL)g2I(t<iLUGdUN
z4(Ywiu-LPsUp#gC%iQD?^+SN-{I~L&S1Obh6HXiwSr!#bHvkY!L`ZW0!mss*6gO(o
z_>~H`inCi|lAnesXaX6JinVU^o7nIn5LWu_MM<FB80+@d$qB%<o288hR0`C$T&`PD
zgj!8|+bbrI9%XN>j1#KI&>En)Agy;Pi6B`)Q!*4(`qktm;HOahpv*hi-!0_jGwfkn
z;hhS%Fe=|&ci6krpEMt5H}oV+7i!uO^WAwQ%TA;bF4P%?)dkl-bKeX@#4uD)k_BSq
z3-jJQGL$Yo7%wrXq;5OThgEC$Je=C=&AkZg=Jo|mZ%KwmU}}ql6~pdhh@h>xx2l{y
zw_+7~=aN7MZbTq%u`)Cs18t*C&;xcF{vbz;5;SgROfC4O_*MuVI-aDPE|rrA+A~{e
zd!afR<Rl6fUM0te8hL6;44yhiU9w=S;=vi}Z+f`v?4#HjaK~Uy|9B+Y@e2r$CYxVz
z8}S4Wx$gEBn^geB%(%onzpu~G-qBG&Ny!E<In>qEx_`CC`A#R8ER6VcO{WXMVBIB9
z=XBz255JIbJUpC1UhlFhql?~Q9&5EG+hl@WVUcRU8{y<1D+P~J6?nDVS7eOpeAGd-
zDDc$eZL9-Fb$?X2^~%+&SU{<oIYU(geP`#CXlpK+CxCoFv8kX345us>vZYV7{&URc
zewd9xYeat3b${(wiEaHd&T33nGQxT*p5F@mmk!RW@ZH>*3+t#drDs^;@apS21Iwyg
z@I&4P$G0<%ZJLg{9ujd=CG!TdL|Y8mn<>JQ`&c!hK}NsFuHt&_UfRW4r(g;z3h-#Q
z0Lutm)M99sZ(za59F#8aaaXfw_T2gM`DWR;c)tR*J@0l2ufL1Ys^OIe@nDHnYGQz?
z^D}AaeWPxvoct$-1(s6Ii=R{_6CYg%wZ5_XV^mQ185k@^zr9Z2IJo!H&lc25`p+0_
z6nN4}&LdXO+!KJt4^_D)!kwo}*$J+3n92Q%mq2&a5e|rdu<nVg!j=VqAh1wefu*$P
zbA3Y@1(s@Y43T2r9s`TMf3#?hHVLhcOeGskW$><JTkxzNGi|2<jt{deptgkXiUYo1
zxAxIuvy@BBtJDD`Ud2QI>a&4%;sfT(AReDPk{5~>aNREJDD?QS%PpQ9yji#>nyv}%
z|5W%n{PIs#zz53=rQ)GJ4g_Zc`T}Ou!$ec_^=<96f}rIZ)u8R=P5&f7=xeQXCRMuh
z^9$`Q$UoGUv3c8)&Vv-Ap9ihSeRdA8Hxa3@Gcc4R)L;T-{X)7304sqEs{EGBX}}SZ
zl@3;!to%oPL;t-1_E<q)%>OuFjgH~rZpN!Vc+YhU2y^MB`tAQ>LFs5$W-0-I0BHNE
z(w@d19;Kj*S~8mvq>Vst=$e@&1LH>n!p)cQiQ}**eVU{`3s<Iqba|fq*vuSoejNWm
zH-dUwqbQOVt77m+@-Co~(e`JR$SjU&*;BDf)_?~Gcq4Tvz;UAT0Z!(S!_+_b-8%%g
z*e&SiNA8>peSH>eTbe%^rbKPGInWpRWN6~;T@F1Nsc&x1N&`okKA>c>xF)CQ{=jqd
zCF81r1kj*cZ|sgAADQdPMZ}7WiS1tpY9VBztDEIN9%5o-WMp0?V4`6lPAu(G^vcS-
z30Q?3;qc2Bell_?E(Wr5a4fZ`0bwT70_~}dEr)os3J1JuW&^dAq47<HXuD5{=C~8&
z9Jp=)`W?qV8JbQNc|nS6{%2brP&2#M+bMu&G>j?SlZd{4=d;Kipd^>(W%H>t`P52p
z#~4PUgbl_pEwN;hU~N!2oRbtsh=)VrizQ;BOBZ;gGk>+7Jo!G+8jWO=a(e?G^==m`
zH!lf|ISYFlvD7KtV}E#{4NAYl??14GiyK3)A|76}#c5zXltKz_GexcIya57GF0*7j
ztLyCSoFeU+0eAlS-#^qP&oIg?AbmNRf(p{&T8W-EG92D|i535^*X*~mbP4cq#^k)8
zbJo;;v!;#I3bygzKpRjVhGNH#@d^lN0KQi?;FkahA`gIw389*RAy@T#80D^HIVt<0
zWwYN|`XDpn%Lpz+DHMD07G|@eU5E6P^HJz)V00)6jHZ)#*e3r%AxKsw0Ucp!s7k}Q
z$cWHDEyQXjPp-TN3)2lJ<?q_8Y{~h9iX4jkpljhQbr=CWo7H=;pTB^*$Ze1KRE5&e
zED_m&Lt_n*MjD$ydsC0gv(3=YD|}W)@LQphr9`dVCvZ5m%oxqPPoK!J*Z%%|eiN{|
z)G-->Gb~nNw9U{MI@nVzK<u)}tM)D1CYAwjj@0%5kPOelfRfby!f0#&lwSkG8M2`_
z3aC_nE}2d+UP$E_w4N<Z8X4DtD5PP4QoEDfKHY0%VwKOW@lFl1Ox(7H=txIb%!Je+
zG(0M(Wpz1*9~e9ZKAZg-&jNJDaiFC8-z2m~1E!)OKomZ2(nw9<4BdI8qzV`|?ZFLI
zAENLQOBze&)EvNAC^#?t@osyf$hNH=4E7(_4=cvsxq<65&J&-*F?oRaU=C2g_uz<F
zIk+xex|tg7X#snBSTl-kP%Jm>l+a=(9PWGztcGA$tuz@uh%clBv2I(gCulz9f}pI7
z7QlXrx_RqX>b_~E(_60GQ?RUonBq&I9e~8}i~ASwyT;C@08ETQdgLde8*CvHYyr>+
zi$XFpW&_<~DMgnZ$4km=ThuX73VH0r=^X)Jjz4*d>yAM?4Fja;|MYer>9}KBFR_=p
zdL|WF=+G)ccP7rf^E(0S)>>r);)IzuOK8z_aTp{9=ySrO>nRF><(WC)K?h&GWx?+&
z+de(>=HN#K#5{Mq8okW6)B<rC{{m(MmSjAL%Ic;BST;JH8ZHiv0zA``bVmWfDWQX9
z42iuHV!MACc$Krff8qdtD&y5wD?RMuHmAYvvLtK5g^3klL3d$)Zg*8&%K(4oyix76
zK!Q8X-0U#uZexmX)WL377*!tH+yBDJ<K%~o)9;K6?V7~8YM!6j;=6ULDOL|elDl`0
zB8kw4`McSm9d49d)8x}BN)H|S5l{3aC^*2LoXR>_9+q#j7wi-r=KSt){C4$9F+g;A
z`S@DLvw=5Nf=JUR8A%c}j^i;m03r5iZrSeN+4N1iYK?ky^U~_uN;GLLwhIf8B^@mu
zP<@d4e;CGsSLsG-<*J8E3Jdv>RW@Nj#E;iM-6u@NsWA3+zu;AR2wdRtbAu;&B`T?-
zsw4>`L&IOQPEQ1{Ff#}8Cx8C@d7qsDPzb*9d-E23{OrSSSK;Kea#l$N2>dvRalC+T
zy}kqJ25qgadiM7DhsW<n;){z7wY6gyIpluHnrs6`?_C3Z@%r)Ctb;uIegci!fXnD2
znE3qJGk{TD!vUZI3Gt1~D=O?O20`cn)ZNTm4=ez*me|gn*goy6C@icExQ;qNrgEu$
z^eg$^xtDTjSAb_f3pnC`AptiQc=$JB;^K(eG;JK$t^2AJ5-t{yT4)@nVOep!LPGt@
z($>7Q|6OLjGb3o$WE+oB69MUr?ko6Z1@JLu78ZPOuYN*&d;se|xvua3-;8XbZ7PKz
zz!Opw-(YmgMnwPD4vYHkZu<e_d7xw$4%%K^1DN>SoYO;9g9DIixzN^a4oeYF<n7Nf
z8hCSoAO^cDBqs^<I135#WHMlN)OY5mDQaZjGgf*CiSpu6x*&lMJ3K(|mv}M<QKQS7
zHx1N!z2rhQ%OO7pI~FnR4XMjOgIH?L?JoUad70mqc(dmrl4PVhl$}WkNapHdfc%QH
z->M_?!fwG}zyGk6A+A`Zc+nRMdje3o|E~RcnsboD%QO#?&xrJG!#j`e9fjPJH~%Q5
zF2IcPhVs27RrH#{0$J})d4ebO85kR50l9DfyLeYT!oF6sB9Xr7%@=)Oo86*E7Z%Kd
zq}tHf_?>mok|dJA_t7SbYDoia9K++#Lv^{@r@?)6yY_e2i80UjZU=F4N&mHF8VS@;
z?%2^Ce(Qs94ftyWpNqC#@8A&Y*ZS?JgR_vRW&V8P(&fv!OT*O^l8#cp7p~LrTh`0+
zmdymXRvwfFN<7Pe?5d#UaoJpPMQ87e=RIv&?Hg&CqHo|JHFE-95B%EcjdO~5g|tnC
z-k!kJ1L(e47ytN$EQD-+n@G_byXwhd2?fR8*o%-c{}Chupd~htSG`U=wyV1S$H&MW
zt?3OMO5w52=$OXAw^P0$$F-mm<ML68co&fKS(QTTzrJS41<qGxP_~BZ9rS^m<lGcQ
z<pUr?Hw!8iZU8vC^i58yEr7lrL#<j{U-umk*>?V(bO+)cfTS=+=^y}curtLkBI4PY
z3N*s$dAb=lHJI`!e>UD_b+VbCmsi)tr7(22-Nt3(hZn%1e!q@BSK%5QcBFw*ZU>Bi
z=|*$NZxv)z1D01unydl94mac)9XePc$}*sOVH9Z_2Ae>(h|l2EovM22aG~onr-igS
zHqwd$W|4$Dv{)qrSzo^dc~?6H8c0p=#?@+Z8<?A?M7?^Ix}S8%HUi%2P%*zyMDW;j
z1v$gq{(2Yr)AKWsk?pR}Qb0#gT}OuunC$#@qosf>KKJ>&NIYrYZN&n5;ydS*+Nq9B
z>vOkBX8HHS)!z--F!)@;p%E*ey<WBmssLfh`lhO5-@ku<o8V|~5B0?`d62(URBY%c
ztp2c#bsldB5u;aLY1k`;+LB#WP$s>)x>`FC!Bz?KVd6%wM(yrQss)V|=z;sH^Ux#E
zuv_%)d_UM9G;r8zhT$O(blG3w#5{J1Q$I2J8MUTMy#sUr3q5$Ip1M$!v5*6j*V6tj
zf4TG&rLYD-jQXAoF_0m`xk?N>9}*1`+o20Wz}R|rXA|pKi4L#+HTb=n$UpbpCLq0W
zKK`Cy0?_%6o2{rXpTo~{Bg@Llpj5?zw(r@ns}dL(h{<agX{_(@k|ayH{m9zb*cdni
zh6|p=>x<J>dD#3zuG#ifGP}k_4j_C3g=?+%+Ed0DdXR9Pf+xe>|DP<hO?E&XUR6+>
z&x>Q_FxeggrGW(vXdX<}wH2#u-GT#MhcepZjW7075-Z;yi3LX`P#=WPjaTrrc}$x?
zQm^+Q#o_rRjWm0Egc9QNz>tDEM)2w@01>frNC*7>iSBZa-rwI>A%GE)O0*)lB4lUl
zF|~DPf$nybD5_;+B1KWm`p}}nCOMoDgzl0-9!5jAfHz9_0UVRATdgAofHxwLEhg{R
zFT3<7pU<gE>VPnkw=nJJS4ZseA_i@5DRg#pxNlOvG&ff%%78~KaqtV0!Dv8NS;u4E
zoWB$4&fj9@;1EKxl0?jHsSo!A9)J(E`tA+Q9(7bJ(C5c<OCDqLfVW5LtEs8QP2E>k
zM#O5UtEWJfLU*X~(pspGt7fLImG59PG${}*Jyy_PWYR97rSuRKp0&?BY#{Wo6Zn=C
z*HYPqK$lQH@!(XJ9j9fqk4wrc>AbA0|6FAO1N<(-INZSWD{I#ZGa#Ad0CpvZy`7!J
zUIYvHoo%fz2LJxO?n>if1AHEMDgDM!S`51M-+#{{^}*rCO#ysr0fCbQ;mLx=4ze47
zz!76e4FN5b9Z)#kf^yuUJPVP;ps8r-Ur%J<RqpsSI5dl+?`ykUSXiji0`TEL&TUW%
zX%V2kT>`9DKL@ffNm{GAGdUDXW^<Ds53W$U57f{~ty){GUohcSR1}0;3`sz>))6He
zfdHZhltTPAw1}8Wp$b!BfA_}x1Fs46##<#P&@`t0e9naGLTo$r73hV&z5uD<s9()U
zXS)2Ky!(jc7%`%1JNe~hMhoz1=@ATU13y24zHuO@PLgQ$|JIi(UZ2<&tzA5JuM;>B
z$Zdced?gmjYOayo1(FXyD;mvN?F;q^Rm)ypUYNqf3CS4{aN^<7Y|`3*$KxJq1(rFJ
z=Wr#E0|!^x<pU*1cY<#_JkB`<y*r%<0LKXWo<6+6umY~bfizO%!;RE<C)g9kEU*x5
z_VGzJ;QetUt4IATQf)x2$l_k$PNrg@RCkGBaXYzzx*(u4p7+l9PCgFTE=mt-5m}!Z
z37MJdMp_9N^ARCQ`1U-!HXnY?S{F>BY%LAr8uzC~GT?nL&Rs^)Hp$g3CBWz;TIao8
zDL2N|u}((`SZ%q-U>qJhQ4KO)M37%y2O9`*(1?e)V`m@moopld_P@TpMIX|(?JIoS
zbr3L^%vZnJ_`=Wg@8AjUd&Y>%)Ixu|_nEn1p;mg;MgJETg~Vl`UFx<UvWh#rmU17;
z1HEb!!0V-BVln}YO$cUa;SACQzCjN-&EZW+kZ-caq4Vae=Zp21%N?txGpnI-5y-~@
z=0RpIq$@8UrC<m5MNy}BcXu;prhv9aMMrP?08{&KoO4%H3*xEgTQul*?uD(U#lC#0
zr=p^g>i+{WbCaOii?vqVK(crJ%XihdAsEVf7R-`qJp(FQDR2}@t>T?i)aA=7EPuT?
ze?=@H2V@xVt_V1g+fw*43H)Q#_s_mJAkky;-cRu0x04JuKBZj*O)<PmEa%ef9JslO
z^3gM{8Id;XzJlI118aPqg(tCJ2MXn-uc0*H?zIH89o{lJzCkZE3K$dW%u)2OEkGl&
zU%;^dN!FhD-+ETOYvLaq#n6`QRgiDpy%uj}nVoJ!<Y{_rWV*&jckVo?d+g#-I*5Ao
z=RR4R^Mm|5=(i*Gr`jwI>Q8HCWPjcVJ<<wXqcSALD@Tb?ZI<*HT6MYnI1*!KhW%cZ
z$tNiIz40DcrEv70RaP#RnAFGUB+G(i6;La5|9AH<>mDY3=Mvj4UA={@UB#yEvjM}K
zTbqL_q3-4@@`WhVvM7Xm%wz2ubLKti`5bZVj=UiBJH0<2ag#M%40JPHVnqa|+<#tt
zl>GglGDzw;bDkJua4B~m%ChJF09~j%c$SCOEztA-D?2J}vR)xOewW&@re9yesX<42
zA4(FR3Qq!-@~bT_nS#nSJ2N!>?=-H5&~eC|KFWqr$3TgVUclqxlau+7bj$MUh)!BQ
z<}{O$rs<m_4I4f7M>bDES=${4`bceyh;o%LJ+WXh?Bag}@DxB1{S=wtKId}KoDT<}
z1nlSa8%J9^C1_r$22kD<G-D>H4%owD;La!;==lCCyQc$^(5J$G$;g;05f{A?@vON&
z)943trnmw41)}SB-J@GPTx{jj3ruK_`+MOcXWmZ1-%wo+t3CfmA0D`<yd|#|e1UKq
zoD;NhWvJ52di7gNtjrMP|Lht^i<AQcm`lECDSC6hX&5yUkj<0Dqq2D}k2Co9z4TD(
zJbI~$47@jMf!$5$!7&_ui9k8#UVu90XpHUFEoA}YVqG^&rc;?gvCsBm06cugETQk#
zNS7X{qn2MltA48O)QaJ5`}XZOdtzc@`<PGGY=GVUc)_bFp#X)ojXY8$o(<q912|%p
zmV(WmH7T?lr5`P<P*VOBW(+3mhC+4$6+R&S5WsCY9jVfk#K!%65PtfD)@rQDgJ#ga
zT#xp3ysx(-5;d9mjxre*Ty&Y!sx(qjEn(OlU5d-gn*#%IsbXSc@y;uh%@I8SB7r6R
zu{fAIm}U{Nw!lr&;oz+j`H99@N|#3U09z_W)c502by?*U5d7=TD`p_nBY|9ald)r$
zT4?D&Twe!`Ldl@@`c7KXa)?4{SmiUf{S*ib77E=1PT{QRne%O%fGh?EnO1X!#5#sf
z_Ax0Uu}GvB$5j9>+_gQ@zLQD*WRCc{(2H>+3DaU$M&@;dyY2c+L7icZM{@eDbackY
zW&j1mx+Ux*??cDv#gd$r@t%LeED8I}=Qn-|v`?dIszj<ahnW%szOqJ0Ji5DB#t21q
z2!jRUGzZk^lF`%^-{sf8#!?hSRnCX5z65@N-<)V#WFj(PRhF-=IH5@>i;J7Q!r`Fw
z?glt>wH!!?{>s{alfmPdUgZra*F`pNNq!|3d?sEov-OXd2BIbdh^tMZgxN0k(b=SC
zkPYe{RdP>Z<-2#Y$*V7w(P|hV`YSBV)3RLe6ts4Yq?S7QHd(_u=U&7xfl!!r?9TzJ
z9cl2~7bj#d(28PZ78dF}N0|PT$K^L$ItsQ&#N&dBbWq>!yaZ<Z-!%j<9oTWTg&QmC
z*!V9)3;Dl)KOz2Zk@rP^Uj+^E4OT}0{7)@Tw7^xs?jw#&=)zxgU?fF}FyiA@b)B_`
zr`J`}@L#LL6oj7Mjj9!9bNYFvYthDSZwq<Ay~DDO_I}q*_7~C6!-;S<{71>=SI~YZ
z&H86xxl<YO#l87}!Bv|08n|Vdfj=jCc05!wcR?^=9io<#GvfO`0q+j0WIu8q#~-*v
z_$y)mnGgn%dXMKiSeWr2jryxMm_NB!(WV##R*2Gto=x{RG%}jTeFG~=Q9W7-%uvQ^
zDA{OIR%%pOD1;)JjKu?*<N}~P4ul=7b1A8u1)dZjo8XFLfB&zFX3t13r0s2?W0ddT
zM>R8>?A!t%(bKC(KIsB1c<&DP=Ig#MFE1lnpdsMLj~~Z)8G`GD{`bT@j<w|$Xk3d1
zI+fJb7B1g*q3XE-3(rjhJLqG!V1gWcz0nUz35`{Mje!Fwucs&n(iz<&m;TdHxEe2{
zn4rn0dbF_gQ%6<4(r~IpVYzzZtc=w6(id|Vj-Z=v^pPIyfA_~*sz0uzZ~6^^=P=bH
z6L^~04^Ott-{l|PC1R$UXzUk(YE#}qNzm_#zSsAW`mJAe5@-Wl8`Y^@0}zQCOpWZx
zih<p}J9@>yPgSflzfi6kcHVe3!XA@1(iFMTtqiD>)njWuC}=ZBd;TxBJW3$m!kkZ)
zimsspCV1w|8Oo3=Vbd1caLJKR{V&$#UEAQzAim)5D6{8<{t0_vG_nvh6T%`+gCpSo
zV{zT-`JBZbRQHuZ8$=f^U$|!P9)r+WR%;y3pJfdk9l}pl=g6q~7#>Cnu1Gs+67t-z
z7|tVY+2@sPl5dsZztg7k7W}l5;g9I}ybYagtdnPdxZDAgO-DcgjGgF_Zf9QOo$paQ
zf180#N)s@{qhex=q2|QLNje%xQWXnjXTK-kY7$MM$v`u|yB<J*j&U;v%@TPgAMY;$
z%m)~Jx727kj{$&LJZh$|3R!-9KUS5Ka}y$Vc-F5*KtEJ^0972XR`mUgeh*7uQJfJ3
zlHldOGc<k!C^~x;=s9}VSk~@LzJmCm$RiLs)uR^ba)Vb23=xB>6%Tf7iTi8q?&x$t
zG+Y3U7mtnFj)5h`O<>n8!-U41X9OGLPtpWl)Q@xJ+qC?=)uSZlX922Cvn5VPaULm3
z1XXG6>Q^>m={Be?;&^lhPB1BSW65RaCE%?EP9#tlWKq29M$Ok-Cl^kTO4gQ&e#uCX
zpd<!Xd9Qk*)ezu0XSjlOF(}aU9Dq8@Fm{1VL7UR@wC7bk#Zt62<4|ev!*r8sbul3j
zyY21!<v)%9*6Y#B0#J@`Up6rZ%~%cw(Z7LjvLm#VPs6FQ{6O7u$tCaF`vv1D<Bg3m
z^2;(^fdDdW616L<4D0Mz@@rr6BRvNO5+JMVz`L+>o>_MFxDoqEVVvsby1yDYXZPL`
z{$vP)MuHqS4mg4Q7OpT$C_g@T4jOX?ScN3usYBy%9fT?XnJ{q38T!>(fj^)V*8M$M
zyvnKPrfhnrR2LJ#uc`r02nhy$0Vu1F)6Dn@^;}>>*kO2bTYGy#T-+@rz(`1ZxU`(Q
zl?DsYqVbkX2Z9@__RP!(I|u~Gj4_x-_aIRKUgS(JwF1A(n1blpTZ@A!V)jvB933!@
zXJ%)msd~D)-PojKAft)%gSQ&q0!r~mb7R5SF&I?XP&fedWJREIrBsr%Nrgs5hSt`l
zi;Hg1+<nx`mv5UUx&gm6cauV{ruzPW;26&&V+sWd!AN;_Z*Q-07uU6G<hhogpPpMF
zxPT|#8u0*~-QC;CIr~=_fRgWtf|rocIKGs<dHXiIA!H97qa!nMG6WPpKq0NCpk_GG
z!?q<q3IKijKrur0xRZp%gI>lwG_(On?Eh}61^i<R$w)9a%?h#^+>akWj9Y-al^X*y
zO6jX#5;LZfMC%4drHRdloxqGLBLU$JjG-f4G8OKFNl>7ZzvV)I{&Qx5I|&Su#cB6~
zu|^&wG|SG;s9M+j_w|U3fXQ<@<*q$B4@)v`iHHz-V!?|;sx69vBGaaS{hEssDD4*T
z4C5uCf;vGF`Sx$%`O>Yckz&w`8f0XC_yo7{;Uwff%$Nh~1#d(cEcH5h>J$V4Ve)|e
z0{pw!s4F%)+I{2J?b}!@TaY>~xq_EVph2mQIxI2aw>_{-aNB=y=?Fg~cY}HAh)2A#
zvSt{&iopdVseYqsh2nyOf*vo`BL9`Kj1~zBz_Eh>X=Hu2YnxsEyx26q$UAtndKMQ{
z671J%K@AhF6gUznl-BK7KoCd7%IC;|*Bg-5lNykqxM2b>0qBe2kay8Bb&I-gMdUks
zgio4umtZsj3u;Zly6o}8+$opR@W@Dr55C0u9B2rz20^5{wzjd8lT%$MQ1Rm=@E(U^
zW&z{5$xLfuGj}?+P)zZ}9Y9@^_-Hc4JOK1PJ-lQ57`p~E7=ww6tMa87BX)j1mjg{E
z@TQ7M$(dIo4c+DT?QkS$b2>lo_{0_m-cDjoM1vU~sesWXKi9GPKsnUh8~8kgue8ZS
zjv@Ndb-B$xgXtJ9{K{ovP$>x`)t4`G7lmWT!I`a7j1x4aQnk7i)?XJJ7l9ES8~}!`
zpjRP4RC)guYXo>d1q80yr$D3LP%H{WC;?JS#G`Mb^c~6KxUqdg<3TNeC9r$TbvmHa
zMn0hJ8JU_wk&ObvRxfD3ZvaF>0|QFT62QYDw@iKj_%00D!5c3rq5fem0NKm?t_`Z&
zax9DhEn;Jyv<WVtI4bQWH|#CTYh@}D$C7q-0*K%VtTIpjE}9(&3@gsSUl$Q;-)=?6
z$bt=Sg6Ibdz~X+u6nfezB-vCa0zc9blb$7vCI$i!C|@q?^nuqQ<mxEyK44*C0d@tk
zaD?lB-=|GpYt*&0v@DuUmvnsxy7Iv4<5N-!fz?lg7YKk!4e**4sH0X2-gJ--Kv6OJ
zw#j3#xtIl><eZ~^%H2J&Bl|r$q#7F9z$5!EF|no77vSzmH&qk9D(<|T{qb1MIZQ_N
z##Y3hEU*ex-d5)=RM8RM-l7kP0-&>j<H-oPFDolMG<g*7PM!l5Mz{T+y5}#5lvU+5
zr7{YPa$&fdz*!FlW61L@p!TW701yOt>nw!bRXM=fi~)3{PR@SSdmo0jSHNyS#{kg+
zy`M(!U-J5&D=r-+I;xL4#)7R5d$;+$WdOx1<mTo=2M@onf*PjMeOPK~q=qCu=1|e9
zxQ4=4`o;XINQ7S;HB(A{6?o5IBb07}v1?~nhqC1$&x%<YV2NiK*}H9H5!f5b5p&Og
zt7=&Lix6lk48`L=4=vf4_^RB-i|Ug<?D?t;a>Yg281Rl3XdVLUOms$O#*?h-@ScE8
z)coR9e=6`)SrtbKXt%nCG?xqL-V2Z@=@q7ea=HsN*J~Qnz<rwhsUw-&_|vIqRqb4|
z(#V@^bzI%pE=aowQ+ns1tnDuOh@q0jJg_XJ`!F4@e;@Vl<EF)oshg1o0{#O!_wym}
ziv$(RD9NKV&-_#MP3MK~3^_;Cv)Lag<M~{zvG(~tt{a|ARq?lc0}MCxPfgFvTBrtQ
zr+hK3)4V<Z%sNn-mBs)ikZO)K8=VW%@xX&ImW<giF9s8?b9gU416kPr>iWw2<|mku
zJoGUJhW~2i<8455O79?|3pIo%p#b=a#7J@S{zi8uHS~zlPnm|(gKAjwNGqJO*VGgJ
z91{c5HI^^)f#FbbOi+;>t;L!QO%x-+jMkXO;@2%(JjgWW&_}s{W%s-9H)}eErt&x+
zMbYCusEGfAuJ?|o`hWk&wTDVeLnvj05TUGy(6O_(<j5v_)8tiVheOE9-g_R0O5u>b
zcNy6ud;4Awy+60#U%%V!^}5yTRnB>i$K!fj*ZsQR?-$=dAfe^4YxC1)XrIuxXJM&&
zIT8&HK<J%6fE<3{M{iB88l+}C+8~kQc-B@fsuUaeN%7taI^lEN@6obD$&`>4HA?%M
z4(+A7#<ASd*k&m58;7&6MI@e_%V^X-N6GK>S*A5ZzJ<$>MVC^p$VfY@=E)DqLs#?Q
zEGF}(45@=(@)b0_9IX;cF^m{~SLLgX29??4L2Z>A4n~=sAFa2a8gIZ+SxS!p2{O$u
zfCR$A>nu4RP2U=J!?o^dO=}VJjKYWatf?T<7R;CQu7WrDivtzXWcgn*r(0a=05bA&
z@|!qwCVe<)sH_2~v8(*|?VYmx$)U#k67cU4iS*Dxs}ulxKyN>obXfA;ohmN(Yv4?@
z%0ImNe*7aDeBRc-!kj#wcFANT@^k`_U=!lwjknhRZd42J#DYq<o<B3oMS{DpYZL4q
z{Kb>eLfNBr#T-&}cL<Tj_;#>nm3;<#D%5iT;50%`@bAMzy|-L`y?VSH6%B>}!b0VP
zIma);O?=!d51LN2a^oindD^1!I}i?BBMA$&tcI7o*e``9OLEZ0B?nFlsUlIzt0|^B
z=ss}3JF(9pz}pwO1Ju{Fn%_&PHFy5vh$^(q0I(f(AQ<MT+f|;t>r|!9=lsG0c*&{S
ziGXVD9EHmN*T;YR?!;h%&5d){p+S(aI_Rl~wm2L{$-cfPmZ!#u)D6!HY9u_+t~s~2
zYr>lqgcGT@H<nw$Y{oNP48q;fd)%<z$&4k!t%MW5L-QQ|-|6DL$IX4CJ_+}~CMTKR
zzYhr1(@gOd^&ac8<oUloBH2O4y_h9CKU3Wn=M>6PE4{s!IsN)~jc?lcw?Fn#8fxCz
zwPavqoD9*jY!2r!+q#6{g(v^;tvC5%1$dbR6V{RR=gIN$4<RY&6u+oL554m0ak#ww
zN6<2U!Ps^y6etWorb1nG2#~)U7HDptxd0#Y<=@Br_ixuJUoF--euWF;zCr&8HFPY?
z{z?c-K%hIV4*f#-xN8a)q+2*(RG6z<Pzg_6a9^1c-x!Yz$k(qt43hdU75m^R96Y^u
zTYirgyEQD8p9Y)rMzEKTU)Ql~7Wa4$K*hD&KudxUcqRoPnc)B7tEbogJ-X{`alqSv
zpNhT?Yx1bu-qWM{1t1GgUe}cN@x9xT__r&+%zjb?%^i#ErXpU0uqP_NA+|-ccVD0P
zu-OC9AREoRsRZz~p=wB)>GSuxGG$_j`v{DKEgICB`4YQ_*X>I=;-d`ojxap55I^;&
zpv)82Ve}0M7e{6OT}5E{<9OW3y0Qi&UWCKe<2~e}*Rl(GZAuV>iI`~G1PT2&0dKU<
zAVW*J{PsQn@3VMwbw<eze&`QCLH3WwaWLIMnk&+w$Al*2AhajJ84U<gQ-SMn%ai=-
z3YieTf0L9bqXbnRBxsbHrAtFQW9Jlvifc~_T!*b%xqDru;I$gC@Wj;s%cb^czuV&Z
zf0ZO(zAKKIho_*Q#UBnz$j*BW+2OB-EXZ<!q;)}w9$sUlB!MXmxI{I%ys)2A64vR%
z6#qw~5E=VAYXg7fehU}$m?Rk#_b|{;4r$m8Ks@L%ARwIKG4yVL4t!If<nF?o!mOVP
zUH=6c<{YW}x3mZK;VupeR>mtihJJ{S&Vm9Rqo}JJ1@Pe>d=M#ZVv^!gz4}<g<lU{W
zzmH#a_hQtuNxQ$<U$S?LG5rOOv@iFLWXUpEt1PT+ALvV1rBq6n&HONvGh-<3@E`ei
z-2aRg9-O-O^rr@uK#cbub8B3CZy{0VJpV0v^4^S%hG^OqcS+yKuMOz7*xD@pDk5^-
zHyyS?blnaHWcK4tbokKFv=mhZFMVUEw5qQo_#<H7Yp+_DA@k)3r?=Ec6b%Dpn`#as
z43#YZp*K_5&RVtbWUMzWu5Q#6a9*IK(oiFy(p~G0&j>F=<uf(o7AHhks5wp8V{D9{
z=jSFZ)v{)dLk1W`57omYcxZJ5(utj?qU!m;0nhWfvf>@UB>oR-7a41f#Uvt*0FK+R
z_PqQ2*CQ4K$06~KxzR4qwFiL5B=G0|b%ZuQh$o>y$Dqc^!Ls~+`N6+KLfKoD>+PF2
z$z^5QU>`VF6ACZqo+$*e3Xm+?SNh#WsZJ-)zr#u!{xSm-lQa$}kbNIG;AWpIL+^13
z7#`!0?6-{vKknHaB#hpw1#3p%qpEYsr-db94>UR38RI6vKn^<g2*u`KFoZ|wU%R`r
zDolBygZ)EVZ9j*Z)ACu*RA32^X(ovU$sjX46c)CDL)8IPX@P|V^hfope%b#u8`Wm_
zFks^T9bQu2D_C6o-2o>tVEqLkU_~~JOZ?8Wp9)W(eoj|43u+{+^q2|o!)t4*CoVP!
zAQ~N#`lIIgnc-(nng7}x{4`NmFjrB5)D)gqEuOW&X0-NMw85prdq@3mX#euKu9)lC
z*7Hy;Plc+`wp7}(K{1V}z+`s!X~MC!KYzACzYrf4#oo%TwN=*P3pqt{-3%|-JRHw0
zC}aHsl(ejaN=|_)2Zq1#Ul)Xp$DStU%7xN;q}YX$WM^)7M?QkrLJ_#LU<H$RwfY-e
zihZl>T@$3eg=QR>t3b7653u3*Ajs$={xmc;c7lUm5~o4cO_1Soa&qzm^<x>Z!L+in
zvdCF@Zf(nd0ycSODWZ)>wx#W>Bc?`^Z3@Pn_qsGU&VjY&C7LtWVSR=gexy<7<#w8X
zf+#BTf`8w5ET`$&x7FpN`t|?NCz7?~W=eOyNf6@iy*@(0>*NkC#|=<=w-;Fr#)VgK
zLc0&}iy(SHC%{&&P-pB2*|k9TA^|nEpSulHeLPI3nr;YRZk@J`-moJ?>6Ta8y7glY
zEH{bA^$JPAQxRzyaDH<t13l4TdL4&uLz;E2j3Myd1B*7-vodNr_W1j|Tei?7zbPP~
zm8O=phb=+|PTjtB=+Gf#pJzY+>j7*dq#)pb{_6z@5|-g4s<kXK14AcN;f>ny_bx&i
zI^Ger`P7JLo0U0`^i$Nkv&4%f(VaDH92FW(F7R4`G!{w^pK3o+mtPC}C}oemiKJCT
z$VQN%AwDoLCQ8WFbYX<#0&qgUt<kogvepntcUuA30G8E&`>GDa;CfWYAd)6jRMmMW
ztbpI@GLaD4GgA(i(ZEGcgHn0oqNS3H717b~ua(E*6(|OEkg!@=LxULuO_3$4JMSY$
z(N@TSUDBE)A4<PHUr7PahYc)D|3C0-vg(SJdFMJf4#HCBz#uUgFkF0H3=l2akD5;r
zw*-=cf~hHBRO+}F2oajiAZ?u&War@M1d_=zU@Q~4b?i#OHCS496lRH&D+sE8YOL<|
z(7Or+cS?KM(je$i1uIhcrTm4l0}%i&D7r8>@L9}sh~5PQz{e2S=_eNIIIQfn>k9w^
zy$K|N{$U7Ggzo1tG0kQGvj%G^(qUYnbPkS=o-6s|Kp6FvnWqxIbzku-ubKCEh*{8;
zH^w374;PT2!|uvdlH(JH$~&~KJy%DUU$ma91Zwc9;$i>APmU$pppxl_L`X0|o_``<
zqPm?}=rGg6TVbh|^USI|B;nbHzzH%DCeRcllcok|GCj^2x2LM;jsXrEM^iE&6rrfj
z0y)idWpf(7bvPgyR4Sy4E&KVAoDyl@vvi5r0^XfdvHF*Q8ly(2R?0KC0#Fc$6fJ{0
zD|gw{vqgG~tU`NdRN>(vm>zsYbfEH9hdLgtA?Zm^bAYj#0(70|(9%Yel+wBK4d7!L
zw`;$Q&rX+Ggs#`?L!+hZ!4EdJOKuomGN(C7W*k*#VLBE2G|Tp)pZt<0<LXQ%b>v;%
z2f(HHgtq0LM<&p5Ez8%RZ5u>7zB2tsqI(h745x%w$Scr;&H(gD8nb_B6ARIvkFWjY
zgW;heJHV%m!P!;U05K2{TN<g2bUoG$bzo^`xcG&y8yFZE7WH1C=_EK>H4gXn^{Emi
z>N{TPyfX<$0vG%27#GawqTXCHsKHC0Xn#gYk=<ce8!2U76)k2O5En=L&Q0O5nnhV(
z7M-TMayDQ+!!lgXLXUG&QqQGc5;c9lG*2|qw<5&&Lu-+gzWz)mC&B<!G&E9L<pgAr
zpJ`RV)hrzDECNQ5Bmlw1W|<`tV&13P!IMsFiwel!xcI=pK*s8~US2M=p~1oVvl68-
zVD_=x9a5<~c7HHj91^;w>nWE9@Q;|^J*FBIuA1sAto*@}Wyj2&T!`a`e(xxreWqb$
zr|9F}PV<)oJg<GG1h!xbIAT1Ac3XItG;|X{lDqwOL5hls-1d{oK!zQEd4#qJ0hL3Y
zkliUR;?*ru+EPt!4Fp21l$GEV`2$MCZR-x>?UfAKC|iNt_YqD|BNVi_;befOdj1M+
zJk+RCjTr;;m7~1)@W;u+L1nD3ik@8{S#;1+pll(qDh-`BO~t1ywrCz*zg|{!9pRT$
z+AR((7^aD`#fBhyWU6|~J8t0PAKkc;$R$&UVzZl>f4)~$@ot<scdj+HWIw4*ADj^H
zkh7wmeN5h8iw&JtC6iC`JgpnshnAzJv<`_2qp~0l**AXp@Bv=a3U#ziEwi70Mv3a<
z$FY$Dj)iMHE-TZ_DW!al(4&tV&dtpg3~*f<Zys7F<PLoJnyU2+ucR0&Wz_4q1<S!A
z(S$c!n_UwpDE$X&7A_sR46_Hgcc>RnCYc4WH*l2qctp?gcr+e>1>KahwsPB2NR55_
z&p8Le6>}F|1K<xWN455YICJ^^QQ-d<Cy%ONp|Q=JR})*-BGqV}+@JbDsFI;wm5Van
zP36e0{p<T{jX}#h?kgFuQZb;KAd6Y<VIwVh3vWH}T&uh~0w;i3twXdU>|PvwQfoJM
zA$iu{DnsKHul3Nw#$iMYY_?8Q%~%kOx~(tjGd4Fl^zC(-KY87itiuP$L{bL>nEB`w
zRi*7srhz%4(Wk=Fzg42m;M}vj&PpZdl#LjY7+mXUM~4fBaj%H?S0ylnp^m-~K#RzG
z(<3|j55nNa{sONE_;$8zV8a298)kpEz*tg6Tiaf&8FHJrW+0QUC(@hr6<Y&)-}LX6
zj*fD&V?g?KRKba~hHK7Vcv{55Xh!TCEikzL`7;l!NlXi>fZ8;|`|n(TM7&N+Gev91
zrvF*VCwdgkqDD<9?yo(0ElaFe8zM*R24@Gy5pNfD87F|Gwqp%=deH8~e|^{iM*==P
zoCQ-lQ`oENO0J_B+-P}Ud~`;O@(2JelQXwMe-ZmKk_u!b6q3iBwk}^}0h0JVp17vX
zl6TD(J^P^OiXr3`tiD0w0kzjNB2V+WQQl|_NVsN^Wh6KV+aW}sf3|oS9B4ly4Gxr8
zSzzF(t^JACWgHaANl8g&O)(E}@v!sd$S>SVUZtwop0Qentl1dcjZ4Qr`z!(EIS%I<
z9{lgX9yJp|w2I4ICGh+5%DIv|?~X6;41NG2gov#og)`H8w@^a=R-T@*SsOjxa$O3%
zk(eF6$u#l|9;8Gl8+2s)gJeLXXyz*4or%nJQGgWQ>~35F^v(nfwwJ5ES65HLf3!mb
zNK42QxVQH=#&7(OFWUwkb8V}iH6Ly)?`+Q1Ju_RC_e@f)z`X;SMT|9a<BV3D<tx-Y
z;WvJ6g6Emr?j_(`oafu27WWsH-0X7zVteK7{D~*6$DoBpmM=$OhcZ2{U)c1Ig*>8<
zBK#V-N-B_psXlu2ABZw|z~2~w=*V#79iXdiivgGKNI*W>0$wd?;A{t=JuAqW!8NK4
zftEaG9m!UM<ugu_I%3;VGPi(I!fojz-#SZ2{05>ym&hx9tfFVW7FbP=gsLzl0uUHM
z;Ues5KKStzVqU}u7#As074`OS#gK8?j6B)~KV|cFTVQ%>ewqiWS3B}P_P*+|X8dg`
z<g=(-NFB<xjYYQ;2b-6x)Y-hMmi#(W`wIlBGeI=ZQl!N|Szz_-p?6QaFnj*M;=kpZ
z`uFbsD+GYcG~+y4=e$A*ep6S$K}p~9CGX}f{FT;F1nrYqh$~$?=v(t-ZkI+Hp|8fT
z=4PMs2;qV24*@Cx5(H^n)#_^Ib6|2;3}_pG?aeDdBSfaaEBVD4s*!%lxU$+&L{55{
z`E8;Fn4(#>asKpSQEm$u1_p+SSLEzX(3*_Nc{fo1<u2{brn>?*Wet84(tG$o#v?Ae
zCvP^m&Fm3Q$^EqY_gTLF0{63<Rc}}rZ#@D(c9iIiI1rY>YIqWLv@Tw)NILVk;2mQT
zvxR{6G|$yN=%Vljx|$0kL~VbxN)6mVbg9gVe0FL{DH)2;j%)sLQ7;|X;Jo~5yTuC2
zJ_(4`FQWAUEBfW=$%UQ4oOB#oUHat$b?w~Sr^v}$i>-$R5pga9Om^$3gPO**TP0Wa
z!~h}!*U;Au5w!i$&z$-9Gmu#?7C^$|4jjVLiNpwQ=xbtHK&;Q5?)dPvt<JssIR>wx
zvKeOtb<w^`$ha<}&iKja1X&Bdksxeps}k6`%Z77ff*55N_#Hca&xCI-P-Trp3bE)8
zZ&uqGm%;n$KZKV#da2y6qAmqJu_so#VNz3DS3sMt_SEiCUZa3OLcpw$Rs1*q>1Qr0
z$xcGf>udhUAx((s1xRM!jjlhDi|NlxM;#(^)yISOktL7zE(tJjrv4DZTk;!bXMPj}
zBTE*p?*nIk!!okdQid0#eoJE8lriMzJ~Fp8-tEkZ>NZ7iPC1JXA(|KT=k`k(pWch6
zZV?`<T<;6)CKOAww<6%jf631jYR`h1w{cbqr1K#hdIOe=v5PSr@YMLq@iJy1<tbV_
zJMk#DM{RW!vCp18yLBG)mLjX|mY76ngh2x-EV27fiDr-5J{|f0`U%B*?^s9U$End^
zWzZ>|2pw=Y_&{$mH$a4(aI>w*N)L(9c8&w9BBs~0h`zO;Q&-yNsKtc~Bij{N$8>Bh
zYerjn85cN9kSq<wS;^W)wSJtBBt8~^)3_Rp^pSAi-(DT=PeFh&3=GDbbd_SSEb6eU
zb=2cz24{aZ_l0&QgR>ma!Zo+@nBO0LcJ2{b^6%aNIMF^(+0PWXfNALH^LuvnJe@ZM
z1^eWi(ZjR~#$1bev&OySV3#*)gG}wgm1(alGO(s!5q)F-i!VbFSbmGzznZ|41)9+w
zM1U;z_H>kF7{-Iaw+E{R`)`s)Y$7y?OpQ~0?=3X^d=JBE4u{6nJqAvxJtJDZt)Yuj
z7|dVEfA_#1YW5EC%^;*GfDj0Hrn42hI|l0u;|E1wmjd?^^cc$xh8NYiZ=WSAO@gax
zv8@xV_M!u)k0pbL@Enq-KGKJw+OZ$ZRl&GCsB^s(lL)O?#9f76{$m%HQjjwFiyI%k
z{groas8lMcSN;RFYx!J*G&)Yh5;02dWP$mkfvbuoUxg~CEH1$lA={mpAGLuqsmb^9
zoqT9o0SgFxuWGpKU4|umFU7t)$Ha2?t{TvXC&sf+$Gn1!kFsG_i4^>2u{uaO63fcs
zxIsrnc2qFsh<j+Q_$J~alX1sGg$I>HCs2<^q4sT8QA0}u$Qq7u!^mqFz670-H!4NR
zrW)`v<@M%f*wAe3DYEz;Y+2rX_VEg>bPqZ_5`~hH*`tCDj)Xus8j&5LxX%S7A(Ca^
z<oo^R96bhzy%ROrr@u_9aoGnT4zwR*m<@(&-wS%?<(fv)(8=iJUv-Bzwhfh*TcdZB
z5jT4e{e02(6_eN~ysPb{KMsYUW%C*+`X1qcfY9_opYFw>-m)v6j-gVCmEx4OY!+)Y
z>s1X0L>v_-?93oWhOs9}-SxPRvEhqEs0^>wz%(M|l3lZZj+=nm3m5-5PNKlr?fLU;
zdeZObcIq-m&HD?Ol*D8!%+BN0Xeu88Ts-rW<uMqfE$9r^sf5q*T|ILqmNm2Z+a4|x
zBjL>$2A*>CDY?0Z_)B47(0Bj%@uUCoWBW1*D_B!=V2D%l0gxmj%XPna*Z4=2b<pQ?
zIC>0lMhn2bdk;+~GX?xA<=J{Kl0tBM?8!)eS9&}C-_@9&!z4aE0w<J+Y^#--aqwrx
z?T4%7OF4)Fj;wkA+G63Jl2IiF?N}vnrJG2KwsbJJw$9nv=&Y!P#_~tbIP@CHa~)cx
z62$;dj$tk*tu?#H*`xXlke@v;nXDX8LgXn1qc+^ZogQ?%x^Z=X9HzTsCt8zOp-m0=
zYw2=_mH^kSgV|3Aj>B`u)jH+5z``k?BP*RWMb;DvTF=6@{{gyy7?V*U7!mkwQ@|q&
z1$+*~C~aAK!qDojw%rD%Op{4cWFjOE2xR~)8rf>PK)s0G?Yb(Lin9GSebC%hx$<P}
z{-%DK8V)sU@tMYN;3>QD!)t>RKqWHn?;Xt?x8bS*Lz#e2Q~;^QfXAlAWiL8Rl%X9&
zX(**U0puX!6vjPX&D^gWEq%ZcG<P-->WEsF%z5gIN~D7^5sUpVZIwlX#~c9?AUo&}
z@KCBXzy_vJ7a-Kd4k{pK(Eov8xVgDG9Lyg*RtbY9Xz&BT!~x>>jz0Oi%o3*U@qVQ1
z?@YDbw_min)#9UogN_fBYgCAL&k3_vm-~TTEfiy0G-wA>HT}lR@Brmy`O5(cRNmcF
z<#;FepA_Q+7zk}V5%U@=E`9~)bbqg;kDf|*2!~4HsC4(x1`EezQOhCbJ$@9~eSZwY
zxhBO2s?k-0I%P~sAgl(LXx%ZnOCvg@hd?s!4{M!J?zuSEK|4mH?CTfp1K<2I8TLLT
z!9}no0BU{7&REkyWC;T^LGZj<qGpotPPX!Oywkf-n^}Q9O-7Zsw#|^r(y&Z@W#x2z
zge!4Rr7vQDK;_Pg9hKoKKV;etya9PI3(UKrcS=Vj+X_eOE(nq--~I?z9-W)i%J=$h
z2(tS`9NUcAj!n9+-#9LPUp%*~ZEh{E?FMhv9&jJC4*_DnzQDWhDYlM7b_8e$4_Mv#
zBNZPY<&GoLaX}04Zk{{Lutepb0A&l%i^b^f6H};lwie0A{JLF=AI4&a+owJcrVch<
z9N(Jyvo3)84&0yNrZqG)T!6e_4}D<ZdDM>DOd#nVA|L@H0v(4Nz?Bf-I%vn$pNS(e
zk%Dco)$s}dO|ZbZKAt&g>Hp+pK=UyJuXRqO+2T%s&;0uJ>)vFMuSc%l1e!Ere;|b%
z#7_Vd_K<$yV6<0wdcyRM3J|DiN_xGPi}7Gk>XhXIznJY&n`0-L!fGK*j3+|Ni0E&I
z`wO3aRIu9Iu>^p>Nif6gMAJ%u!m_=yT7lSLKp;6qE0~Nl9Y|4u^b<+o;Gq8YE!jEq
zMY&A7QK`i3bwiev<bFD4mhXukIqk9)Vz0`CDg0A2!QLcDDK+B4PI8*wnw)U_*t!5U
z*}inJ5QhUU%Ahh3_fIZ(Fx4Ogn`*W;{~Osb=DV(1f*Y<HO4`nYwyBjHrE%z>14-n*
zFP1!I{*jhSne07F`~@#PWV{}`@9IO3ZGjyJ<Um=S)uC17%?{o?X;XR|51bS5uz*Eg
z^w=b;Ka2F-4?aq)*Sr2yyns7zqOYJ2n+)f-PenjFXoHmYI#5SEo?VhCny6FuJoYGm
z%vx=Rln?Ubl~KI2zckAy%^bEm5J(<<h}x-;lrFUm?l7u3=ZtOb(P79Aa#xho6hrR?
z5&L{Du(f~(@Al>6`yU0?54HQGv`nZb%Nxq8DOeem@Jow`x&_JT#N$XsNAUE>PS1yF
zX;F-uY=1jy)Plsv6xKYhJ#+jVhsw{kG@=J+iOH_bQ!mmhLHN=2+_pz#M?{`w!2J23
zxdww*kPxv0tY8A{)sJ2S<EZyj)N1#1aML@-lPcH1Eqy|3vsy_l1G|thfQz5;_PKKD
zSPTJJl`g;EUYz`tjN`c_aTZaf$oBWcr~(8CLEhf_S==Yzyqk+JQcnIU^Y!bZ$czA{
z<Yd6A?r#k`+#hPSIG0&msSUOSz;P9<h9L-EOYi5YH&rd|!=w^@H}EpvJ}gw|yEH32
zh>%P{KEtN|n>h)ypsNbhh!<Z_1P9bk5g~Ulhaw$DPnaHR<%TY<JvbhlAW9%04A8$2
z;5uQ)_29lxSm{$7$+5c&Ofb7M3RZQpa4F=#<3$9$_AE_)?UDJtCkYJX0?%C!p`BIF
zskz;?&{s!%KQP?W25atiR<5o=lvl?bgLsgdB9oe;Np;uq6S}dq%u*?LD2;1EC73#B
zs601Sm)6+#rKpkG4u#Z#b2#tETdWTERCFgMaqdNA)RAxA9F!$4F%n0^Z|3D{pWUmw
z`Cp&XV-E#X9er4*u4@Kxsrs8ayxGyF9FxypTbPj@AsFDS7=q%+mATeeVp3Vtx?*1n
zeGAZsHK3y@@!>?}^&7<-MhE`A5j{u)LfEtt^BVYl?n@ivEgzHYlHu{P7i(w6CJyqz
zqleu+uV`g^5a~CeO?FC_3lXtyBuQQz)gmcROlo2hLE;K7j4t42CpFu;WK)vMp8fB~
zkJqL8>(i6%k2DFdXB>u~KkejCnzi8phm?F!%z~v)-S6k)K-m%s;RulXY<a*O0}hA6
z;w_wo&o0!Z+e*KN%_Z2isl^%Z!-i`733??y3}XzdwQ@;5C^*j=h-zvlj6c5z6H~5Z
zpand;Y)f~&D{-H-KFwKH*pNMqu;eVd!3G|BU?I0Ot``vsSrRO9CNMjy6hy3O^b?*{
z4cZ@9eVR_cKzk<x$6RmJ-BojVAd+J0sb59j9>cnO+#cL8IzPa43LcL1j+IIVFfiX9
z@{L7~9}#YHAXNj=YKk;_$wR=0R33a6$(jPDgketh612;&HED!jZQ+#;Wp4+TEE=l=
z0i47w+h}QPkH%9$AV!ANfQz;IpCaG)({g!7>~m@wLzrgv!T7XgtZC}iAbObhwZGIC
zbRw<r?Kt|--nPN}y|Hr+W4!C1V9w2BXosU>8lCqOjzxpx_K|x4K%^MFV-#}h*a<Qq
zXyhLaR@$4v1Xi?u{uQv>AtXa1rr-Yr`M!oCTnc=xTSPbSQnk{5Rt!oiV>{H`1<G=`
z_plIjL}5FInDZ;oZGE0w;oYDHS7h)u`8uWjsN#H<!Cs@+?i5X__AF%73K+~gL_Y#V
z%_z6qoP~|e!fq>=S&1G4jj374segeo@RLpwQxHM|e*%Voa{I3`?75ciSZjOk!S6lb
zD+c0{FSb8z_+re~K&8#2ke*K2o2&BMj=AeuhNA_f{Wc}0X*{487@_4-Nlm7?^ZwsW
zi$YHpA$O2{1H=?s-{E#2O~J#(yKk=8W7Us7*C}CY&74+*kxFw(;LPYEez@~WXM0H9
zI{O(xaC6EUewACb$+K@<5M}~c&AWk>uJE+US`Q@OsM7+nDg|Wf!oD*x%CG%+Q{eUg
znn2&73G`y69U>3WHLY%#N$ykE=f9AB;@YqU=Ss`3MMudrum@wM1V;KJl5^Nf#0Uz*
zb3hGT`4i&o&*o*f_2pg`XF}xK4q4lR?9EOXN>B+TD6p{MpDSBjLPN_sTz7};E!5qx
zuPGJw4qJ#cT)vao2mLgo;kXE`{!83kT)CA`MSrCY2Bl2h3Y8Y>aua669G?_z*VdwN
z=AfW%VHE{?)3OG<{le%AveeBni^f|fOB>+i%@%Hy)=2Hg@Ncg|niTx;<4sIYnX|1=
z733J5IMdMjSl3+p*n>VCg98u!c=ApbZn~ZN6uD~qi;&j`K>pixWmCKg2w3bKzyLaY
z%bDom`QSC7ZX<Q|&g;Ft0ly!_kVufPK}re48!HEMaJ@i;VxW3J9gqhJ{|hL^J5?Oe
zjvr9ORfTtNu%ApBZ^JMSe%B2C_NvS^9}f%*JD2josiaeLqwRX^Mfr*_R;pY+t$KBg
ze$SmCQWDlZ3|QlZk40T@=-NJv8-^);cHM@dCX0XS;h}DHH+pnH%KimDq0{-?EqgR3
zqeq+#LdZ*N{geJD3!Obrv83|Pja_4_bbR+D|C>8F9A@Aqs+R<H78<SWn{8Q_+gHpz
zy$>8bI5@Y==^i)5Gd<u??65wK@}GLJJ~UA)bkwW*u*ZejyLF_qbsTU`0-g!tI$94`
zO~4Xe)%FDYaBiapYBbgg8G=K%U5r8~{^fxq4rswTL?86Y^I5_!Y#%VkipJl%5cf6b
zK{<xeXiVx`Te4kg!HqfsQ)}|~WEa1BY1T+KO^I_yVf04nPQulEXz=k)b2Mf6bmS-V
z9~hr>3oQX`#N=U_W55rKuy$bza2kn+(rpTw<DI|~1$^Dz0~ik4vpvy=K)w$nBj$e9
zK>TjfHLs^Ii9m{1*jbPzbb?h@K8(YV7n?_%Ufjs~@WL)M>zB|ll{hhYlNs1a7NIb=
zP#kx=(f4PZSkCzHih{mp%j~Y@+o}8e{nMXjRm~i0rh8AGWw}9vEpRF?w9IqCJo!&(
z-Z2oFP5q!OsN1Y%(b?dh$<E~0e{nT#|5jSg=ob*H5gROoa9GXkCoe(m*O9Ifr)60p
z&QUi1svIWpxsaR?otVsyy?TVBLwI++5yjX{;)*5%Jv|ueG)e-5j)=UdgmZzZ1*jH!
zt^;NC_Wc_t?{0^rIzF2|?jA-pS*?8IR#(!xqv2R`$HMjvb;QHGxAKx~--w7u$$Odt
zQfJMRh>dD5laKNY5LC{V^jo6FqwZK%=_Ct=dmFl0<J0_QxRfd=HVU46-H%ZOG7oT<
zzzRGz`KHIqH+Kh3BUy~b)Fs+Kxe(ulJA2>nvV82UVlkBPZ9>)Qx%Zn6{mDUFi>GXY
zHHoisduUZ)3X(it>Dr<!I7&u+YB?;izu$Xq^+ye~TW)!It*p$F@>$a!g0L8I&jGuE
zh5>*DaPvKf$1oFha|rr~e5cnj@CJZyPR_p{8Id=k;Ux*5`yMa@G0w#gRN48)J77Rq
z5jmG>Hu2uCg1nZ67~<D;OM>WCT>dIOvVubi0Bd`euvh#>46PxkJl8WRr+g%d8$b4#
zPFLV32#mR2-$2TmneIGEXi`U`fq9@bAdT_@F>OZz-VWKgpuYwx1RVxPZDt$vNFx#E
zmwN<057^w(`|1!qpd4vl@~Ky+Legi|hHvhwZ~|WLQ0Z1nt&7kzdgioZQM{ZZ(Q8J;
z@p0Bz--kJSa6A2_`&+jY=9wi!SVzF4@YZjNs72_zjwI&=Jqwt>_CwM>cR?27v}Gm;
z(jhDO42|=I<|%#slUA&QiqKzb2ikt$xP3&1mPe1)&!SgJsX+{CR4w5iGCcgQ^8f0S
z)@uTL<w<PR@a<^EK|{)ydZac5N+my-*~L)xhS!B=yf$3wCdCBhV-Awt&@bBMKgKs7
ztK>aKkDlM#q0Zq1tza=R5!5bw{qp)TR&H+PGiPKuR7}a!+IwOb9qo0jOSBE<7Va{1
zC9x!aPPKKXrJ8)8vPx0)9E#@1SX@dhT+ykE0Mx{4A<Q%Oe^kkIM~liiI-=Vq7f)GP
zeu4WGeC25;=<x+dMGfdG{cSM3YqW~VRCaht-`Z?mH$zxT&0EH%hN>@4WSj*MbvP*<
z7@TftJd=Pk-1GWC_OfzytT%h$gRXFe*V3ug(sEWp{8#76ISI^ON3<caA16a0I4|NV
z`_{6-^6vzxjT9t<+!8jn9`ocL>b2Qa<+3k~k}22vu*ulr#u~;iHf%NMnwl1qzHmum
z|3Uvh<(+0MVYRKDtoJxez5>q1+h2)bm`JfAIWCyU$#OG!xKPHC0Ht{U(i2k#5dO2M
zjahCHx1Z-|+lPm)29T@RB@?^H>{sAhJa2EXyF+Sy{+Cb~cx}(rTDn~<feC#EmrkC(
z7rv=`we61fY_6N(_T0Y9g-<Ab@9U&B`Zgb{mY??}-LkovmCyV5ifIu`inrsT^KcRS
z^@{qAPe3uN1|#dh2AYzZIvqhj3!xQl;L*@)xbwdeEWmDre<qvbyb%QmphVKdi7kc)
zJAZnENZlmXut|<9X5ECvWfv~{&!aZrLkBZE2yVA(Oq-hq2HZ8iz2;YwPqYXdAc^X|
z9i<Oz65=WP$@bk6Z$GAn>t)ExmHA;N+(H?u$KIO0?XjR^bC(O+tmM*Tu#fm7EW@x;
zva%`|jD3j*oTwl+Lh$lU1_p5iBJ~P-0_g-89}J+V=F^3_p{OW<AyDH`luHUZdU$xm
zT?Hh{!e8igSH^&+y0XK9RN}_=N6ikScn|r+h9L7r;@EHZ>yr!=m9N}gxehs;%}DW(
z!6^gjy<Y)_2N9;&j`%O}^U5lfn3Xwd3vDy0xh(4mhSvj3533I(Ho)*Oh6-o{=61y)
z(hESpFeX&1$g&-*8d72YFuZ6}5U-##)_)QKO#gp#8$eSP5ACxDh|XqWGF)dFeiq59
zBwc6c$K)UAm^<<fdN8nMVJFM#MnMil-zJ~lo`y|5IxWRGm=$Mbs7hBi+H?}k5*7RR
zS3r4m{_+r!y6g9I<E?yK>@lB|`}zeY^TD>ns<yeQhe&q*q9M7Lo1E(QlNa~bM}l0&
zBmuofrZ~duBzeSh82$5SvO!?34GjoQPVOKEZGeqVyTC<QDPebvCO_FWG?zIqE&+KF
z@?cqcq2*w(xf_TpkIwvAG?Z|M>0gxz2A|Rsz2E4Ai09O})_LbGenm~qv0v;05c^#o
zvzQAE2edeJ1TLMXeX6=m<g5@xjG_VO=oQAuq}<5Cx-id2-mI@9K6(F3f|bx%KRMtJ
zphhvKy{;ExT}$TT6|Yz%Fo8@M`q-NJ<H>(Wb#-P-2CK9EGnaD*yPzGZV*h#Meb!Q+
zB3`YXQ697rljkT~K96-wk(4RBFds`b6^WD`?*KJ~+SncUR>^B=o}c}ukt3g-@bV@n
z&nIfC7FKPq_RRS+OspH<r3>nq9uWRd$xM5-y9seck3I*iWQ`>6G2~nZ>(U`w_~uPy
z*AYzrKWlD~mH|nwIRJoZ2mdbNNw!e4&)qgLX32Dx{rBl*C(`RiLFNI75P`bwcKnDJ
zP6kT&+5`9A6*5%|Xj}q<%^CNyIc5dcFqzii8!v>5#``pTq)q;7TxjX%W3aip-d+A9
z>AlIGSeod$1Dhzu_8Li95~>Oif2F=#$#L>)$Yf;;U9@=7AO5TmnsTfH7@SF6?9=vc
zZYh|JL3u{o)6nw2#_dBk*W+Uu9&pAExEmecpUu<?ebUJF@1a!oyNcTj%l45TNfHMy
zB-LePEQgfv^hu|H8|~*Qx5j&^eYH2!Gj&Z(c=iI#RZJp3a$ySqa*@D{nVo|}^oW>|
zF1uPqm_^;LQ)-cRW{?~0Bm<VJ#As0Jkfh450X;Fj>YLH@N;#FxYA;m!w|8b_dm@!s
zikOK-_r)4LiPeL2vE<!BN|VdB=v!SR58u7lar?x{3CdY}OEm}k9|pwHf`8d58&1Z)
z4D2_fs=)-+cy%3yKi=OdcDXVJc0#}#D%>=)JLE7JC6oDOqmq~))0z(8MIpV?FV&4U
ze8;!`B~U@_U)=%qOP=Nl@wZND#*~Mea3$XsSdhh`y`_ffvm0?QJIrpzYCH1H|D#S!
z^3k@`xstSH^%4t}-4GU)4MtwAko1O^m4jRqHSKZnK!%o|iw{Ax$GY~lt1$6e3ljKN
zaG<5f04-fM?a!Rt^o3}{r|d;Cd5a9;|5VYvC-}cxHpfJrkrk}e$|l-EUt^*r^mKIp
zBK5xThh{7q;{+8~3>go{s-H$`=A~mJSX%y2FPDb)8WO1)noB$`OUB41hx{VDvf`)J
z#3L|u59Xyg&$Qg+iTVghoye~#UQFWO;c7I=2XR4=z!l_=H#s=u%{nvNLG_RoB*#x`
zy)luJ6s4#fyvk8BF);z{0^m#|3+O+nrs6U0x($VZyJopt3G#jh$p}!=^sI=>A&^`r
zB5DPW8!lxVdLpyqTC@288>{*_@&w)a5<*w-X71`b$^G+WznapkjL58i#k9<vP8a_s
z%u>X?{rz=d^|S&eQEWL#MulAoZh`93$$VWU%17w73=Nl8>w!qSTyrD9*tl%9@s&<D
zLr;{((DEV?{Jfujd&Pg-6!xlJ{6@bM0a@`v<su2Cs9c-@v;&vGv_}?jsF}yaDyVms
z;8T!Qw29qMxZhOx16h52eaU62{<r<6PRm8sr84$~^<F(aM)X|+>n>a{Hg8$VYx(^N
z)w!C$!_{70{M9ymgINasSp8yovBefLDX#S@9Rp8Y=eYW?mm%Qe-5h26&;44r6H)q3
z`UEWT7qJqQO}zcft)Qt)wqG7dX~>>z19;W>FeMv}RDwa$aJnb}2?b#^fOSbDh8i@Y
z{Y`hkpB8|a{}~Y1HZ-V$Y)@2FG#EfO5Wi0WiKeY&EUI^iZJKb0&_1NntvF%BsvOB$
zH=>1U=@E{aT*e-6q6gS${dJD+SvC>Yu<*&WQG%JShzb`^wzeE@WeiU<{HTf2@B&}3
zo{{7a1%e7jDD{df0g415J0V}7a-bPO>k4{Hk~!A;F!@eCnm9dl+`ZsNwVCc7?q+8R
zb9P~N@vZuBo~h*M=-}WstX>T4l1XS|@YMb4!2~uc=A_CMFPB<X;5t?=ADetbs7s(V
zUl%&k3*+ol{`97{jKcVVLQ~A|9EG_l^|63o^VcAY`ts-?f9m9FNs9HgX!>(K4Xdv1
zP+g9>cA6GUA{8&CnszM6@ywvNHQ7%nqBk*~dt{Lk^kUa|m@dn?Y9+1~iBj&sMqspK
zUy+N#!i-xJE6bUyix=Wt!c@!-Y7kkA_{HQCH`=xQcE1{5@_J=4KxsxP7y9kh{;6t3
zrPcGvb)yc{>?ZjE8gh|4ieH*djg3mYP5>+h)caLx`AesV@z@0(YZ2|ugD7{d80Yn?
zXfElp7-+wx($LVp=2}NL_owr<tN2asWc#{p$S(H_HLLc=CD?0yIMO*)cV2x}y-g(d
z`NPO^t~2|3)_NVgpX!t_P*&eQYo`LoRYCfGlc6tN5?Ln$0u<~%5}Q%Fj5IW-10kp!
z^byF$QPgA1;^{2SATxSbSW70)Wq6)nSzWg`jzO>{^`*7!-C~Nr6Lsf}>nn;j=*hj;
z=*bTh;7E77)zmDH;bn{oE_fL>?NfsG#*GqLveb`|zqN=FSUBuU$>Rt$GZSV^0RT6K
z1F)L$NcAgWrx~R0Y~w|zUlJ>|Z3PZ)FosF72mmi|)W$dt!YNX#QERbzNi4lHAG%xs
z-rq1m=;Prm9{dYL-5G<7?B55=T79mvEBrH7{?0E%+3M}VHJg$@vm{5y5|L!A4WXXV
zbpYr~we6287-JaR9NDRRSVid^(ssaQdJ0VI@s+=g7uGwY?qv^@M4frSZ>Buw;0ISu
zR!s{`1$tOKB6=*UYS6fw@g|09(9{?9K_hYhmTgmu#25Q^E%vb!>5y*;CrUCnF_BMk
zgf4n+P3#U1xL1=@IybL+Mu&Cl<}yTJ&po>F^59X1easg#mp&_>VOAr?e4`W>5&y6m
z<oe+K{{6aVC~y7uYCp?0shh9<lM1@da8i+uIBi*26t=#zb5tOV&*+(BZCIGCgI;6x
z>my;gcgB8tIOZ-kj4iIiSX`qgW7cgdA;#K28u;#3O&<+^Va~9rVP#^{47ZrEyB4t9
z1omp5vw+b*IXf%2v79t}SHrt;K%)Sw(ZZ87J@c^{LOt0o9rhK|dWnwZj}Z2g5)P{G
zxdT|$#8gbG0*0MV3hLGyQeazB23QuK6Z%B%rH*QOQIHewt@Ub%tEK&Ie>W9SB2)9$
zcHA)o2?tUtJgXJfLqaYfY9B<VM;ptrPeg>*m-dzJED@KZy=7YGIQW&X_9yYpRYMi@
zVr#KO_xG10(-}{H|5tP%#L1uUzQ#`j+?EO{pJ*g9RW$dh`RsA^aG@NR?^$_`*vVA|
zLf-;g<PER4y3|{d=CoZ;z8jBrM5-_dIDC}0^78K;=<iFpa)G`534N;1eL-pO`e&yC
z2D=W7mIRsFebsSf(02TK=;F=OkGAL3M;RV$S3hVd<b#K>b_FjpA0KF8#3QW2Wq2pz
z=4B&>AV<9e)xIIe+D!_|gL_|bbEt47EV?g=)#P`MSexd*HRyfMy+t58Di{qe<90S0
zRD~)&i$@d3C^IZ(m}_&c32guVPt|-vs@O7%c^JV)a-lj7VUtr+l*ixN?W~VooHz=Z
znS#t4nR$BQMr`df-p5>qg=C3?m01r8UpLSY>YR-kgKTMo7B`KrZq2-N;M=s8&s2%a
z(8(-Fs|fTyzt}b;YwAZ{yixgBXycF9XKM1?JU83WZ`QAeliF00Gjo+8kxxQMAq?5l
zl^5R52O|LG?{T1W5Xm{s^)+a#Fs~=jxXsw)Lf$(ZhBvhKl2zeJe$D)r6CKpAD}>r$
zotu3ctUg{XlQKlR8{&W8!iPMtR&-xIwI2TVnih_K<NY}=BC)*Rx}Vid)8{#TO-LL~
z*Gir)P=+ahaQjveb$OkR(w!4b`JOamGu7kLep#(vQHi#NeVODv=udws`}~P%HyYo^
zqK96F-t+cIy29mbJMYMCiaXU*n08ZEaA)B9)!nDPoQ)=#DmO1F$T~l*Y3shLUQ_u#
z$NK|rsVAIQT&Ohjcd*=B@SGs4Vi#p}!VNm8Ucs4<7a3|W&kAt~zp-$CeI}zT{9c@)
zW%yOWNV=fA4OSLf@}g5(7Vop0bV+Rj3VnghDr5>uQC%IK&01?xiI3WhCnSvEtFCtZ
zX()enl_Gbz<0o1uzH;!o;sb@S?_F-VUBVRRy;IC7I(f?J`PwQWLV)sJ+QaUG*l*2I
z`1kJfjun#6xELbLf^Xf*_r?-mfB0O;&Dg7{i!+_U%WS{R!fLj*WJH~(>kGFyvAgox
z7#DN9H_R5k<Wl6(uwR&jmE*J&UaTanK*UYFqSn#jAN$7rZ5v|T6Mx3xWg2XyXfGT-
z5Mm(W%GpS#agWhC4oC7Z|2tqd!T#&RHLbaVm1F_-o6|eJ{iWLioyIUOL|hQDN}Z0u
z>mczh^<15?>26?@`auC7HW{{*R#e6x#2o1?BUZ*0nv!RwV5aGydhpOKli7F*mN1t0
z!a>a4f{AofMXML)9|dNtMK3?n3+>U}jzeZQ^-)4v)zr4Wh34Ig-;opGi;HN1Nx3O}
zHRx<<&yuAPFschad?1`BmOrUFzv7hciC&w_2h9g{8dzs+Zp_3`HgblhJfdsOm5n?W
zYQ(Ejy+2#il|ku@Lug(_;@=_1@2?$y?4~<%c&L8(`m$>j*mX#W{Nvs&bVq1`ku*pn
z+kqtA?cB|H(`sjI?G#={z>AN`>x!!^=^FO9bC!;!mRbd`<Mat3iR0u%t}WNUE@MsW
zbpBy7hcdBTRVRAciwc4QNfbkA%`PE3Lca@<v-(T23PtqV?YAV3%I7v>kGp2Ss%8)E
zewgAUWUkfP5~)z4q^I#2Q!r}cNxaxQI;~&xNIzDsLBCk1!ql8jDb|R~Vq#iNdR3&h
z_gL5#-Tg<=^Y5%Cyymta0l75$)z_E?;oYt4w4mW7D|;1qENY}nr@`R26jy_@Ov%hG
zCcYz{tFGxd(q(gB=~8knmK6s+jyE#?wo;r+u8$Hd7?o0K+7{|{F&77i)O61(V6>kL
zoPKv<si3f^mPZxOsLhC7C})dwKQ@@OP%Gs=Geo`&89f?^3uX^CX96I_A=7<Ob5K54
z&3{dwQHjykt;NtPbWyV_WGcqil``<6X#VeS;n=d<Yp&O*+X)dC7CzQ=NroB?riuFt
zf3oRDuZ4R!1th+y(;{pb%IK$3>S?s5+RnOQqSyZVY*a5;9CB`G{<4#I-$+q*`sxA5
z`&E6BT>8b4Gq66UXKZvM#Ic=sPIshQyz9+ww2#$k&?Su&1TuF%$@uviui4PQ;3drD
zs-Wr{Cc|22$8h4U6|Gw4VXXoMKZ`X-qkZ0<y=j%FK6b=R=0;ZExx{HYSMNDqkddYr
zU9w3@EKU{Q)ox8)^!zKIk+a=*z2tWfYWBXMLowHt@Tt>?i><dUWlhv~!ViD!>gPO_
zq2JkT-M7bNgq=e84triK(#bTsmfmh1``Qp=D{+*3=5>XS^(p^s4iaatx2NOzYi*Zv
zo#O8Jnx`^L7iXSkv!y7@RgK&hs4V#UU-O)<R_N*&%}HuX5B4{R<#x#(?Q8#+osZ|<
zu#!d$XoE&(q!>4Ek1gO{JoA+&l526TgvtEK#A=o{(_T>ZyL5ryA(U0BhTEn~EnO;c
zW#9oEEq*$u4&SN|Q;tiV{N^pQ>*7fmE=>wCuiaeqKP=5_SMxDaING&zi54VHFPa%v
z70ItrOj8Q#W?^lnZ;dIkz7sNMbvSyikuNSm^{dE+SOtR-gOX=)F<z!y*{sWmi_&1;
zk>55x)m&erQAA%fF`>|)HzP#~4ogXZ!uP+Ckv6B)!!6DJVYgp8$<IQ}R#Nj+H`6R_
z-}p{(e%AbPy+^fKQB~Y~cSPWvzs7=YSc;KCWuD$(cYac}W+WZEAlLP$DrS+(m7(>C
zbwy*h+tnG^D7~YfAIBw_D7UC|`{xlVZdZqy9}&g)hdu6fJsd1=(SM+)X&`i|(C~^t
zkZu4?h{d!*e3n+fbd=KIWM}^J?<?GnD>6tY^y5ClV4O}sOkl>Q{r6X~_~}LehXv+A
z7DgPQfAC$7p^GgtjCT+3bG4Xv<h_$fJ!1p=U$e6#;<iz8qF}tvBrEl59*`n0CgYgf
z%aTiLzt_gjI7gi^%vyP0^i*0+H@bH&#C%#|b*Q5DjiYMBTTwa?Nm%|bx}HI?NSAbe
zWnLyxrML9lw-0~Y4Z{_*W@`;xof(6!ynaFCUK7wz|ES8K^udUWf!z95U3cO5(Xivn
zq+pifD{A`WVJ-_-xVrU{oZ!4%*y!^pa&q_HxO+>wc-A(0^V6%ZPu^$29ez>&Ap?h9
zbkFECj2|||2Yt$Vt;Q0@zj1h3x2}QW&pxwinM4_eGze|<Cov24v=?~WgH1&1YxMP<
zO>)E%m%JL(_@7CRR^U>EsjZcd&4gXYnl{=p1Z~^DFUrigJ8IFDBk*f2s5~|NfSgKa
zguGOmZj;gd#jvMWLEJ$m2&_0K#hc^N4t%a}AM#olq;#={9Tq%W*lpA`-Jv}5Q8w6L
z<cm$=!3z`AN(J_Q@wqiKHWMedL*i3gzNv8$2`SRQ#~Y&ine8c4)A~4lOvZP`7HGJ-
zD}OnerC_B@Zl8r{<8bh;VbHUbziS+(-KnbupaZ$EUISnLOB`+B%~_kMOl;4`P4myn
zWtyass-`(Q-LSggdO=1K-x{HbPN|eGDNl!e7cWyu6JfxpL<_<6)Wdumv&j-^Wv+xm
zc$uQ}0y%{;N>u%>0dQ)485f0EX!8@hV9XH2S=H<nR1cpmB}4_wu7-XXPxFU*u-Z;6
z@p=Qcr=vZqo<_i%GxXo7HsPLDYfh-6jM1?yW?_X#F9?15-nQ7{S1htAX$o5d`?Ul%
z7kMen>kBQnJF|4#*By72cD4J%L&s{EBn7g4<^YU^2=S40Q2zL#EzTel16RFoUxsR1
zViNDFmaMG#JMc9sb9D<lF-9K<KD9YNxAXkBw<i-hxl%oEE-S~=8Y~5wL$vbDQDblA
zo}N*c;|kV1eP)_Q(WKz&uY)VYT}Gia)j1xU4aXCgdtD2(lonpFYr)>KThZY#QId?N
zpIFDUxvY_UClU+GuJuMkzn{!kRvDe*Vgu>Fa`HUMB6_vcM7|JX+jXg5+&}Gax*qb=
zQD6GU0DGs}8>z&TGw#RkyiApP9p0f3*3sG1J9@lCEb0c?CB|u6Wv<Z@9rm+4n*1`X
zCKkA_gH<C*PdPQDr@r^(zL_d?SgEsEC2o1#dV+J<n(q5MeY`W8Nw3gqFjIU=^K7QA
ztpU6oGT-}qVVgl|YyJs`b)Lno%N(b6bjuU&=%037EVkiM#-CcGtjvox;A9EAkR|_#
zCK#h`JXnwscqgodW`m94@>b-SLkSOC|FL$(Wjuo^ZINwJ`2sGcc36|4@^Rd(Akl%8
zY8`HRRxHs%XVzP$k(k$R-QOx*c;3xYt&qK9%SLFyFTi9|cvh*{z=wWy5Ol3%w@Xo?
zLk-D#yzEc*UK&!%DD{@kR(Ac&lllQmRo}0JVQ+XGAgsSN7Q2EYHF&K^B}NI(v4@&h
z;SCvfv^!Pky@J*+?a)Asx<y*;q~$8nA)WW5s$P}sIdi_E#FCKKh^L^Tq1mY4UNy@$
zi0Fyl_3PMOvpsI^tVZZaQu~bpea<^b9k7EP9!+U@8Gl}C$1!}D7O6~uG_n$7TRm$d
zZX9Z>S{m;uw-T7HFk>ThKtE%kgN9(P(eg>Z{32Z4dM4J!>qA5I$+1(mvyFzD#0&wt
zVro5|)MGq`RC<wvffL&uQNef(tIYn{N!!s%BvoFvo72|&n(9)o_xwfL%olhV{|-1h
z_`)9)YSTTghtCz>r-0KcYJB$BlWG}83S~P!hlpBEbyiprl;!xElGmymW7ueta`M+f
z>AMar9&ehLs#sJ)69(#HYaO(9Si>YTbESAgN!!EEGu7&H7Y5jkJO`X06DZlxUT^B@
zNo~n}-!(ev?%z5<;64BMKe&irN2b}2$g|`W)rps>k+4}$!-Zmd9=GFICB@Y~R2CYy
z(bIhX<nxqbXJFt?V0NAQ&C2X1Si%CAKERHr`cufTqFR5ZoMNT>asPqeWi&~gj2VTs
zJqzChQ}P<OCsUR6)s&)G!*B()CpB`~H|bjOYPu;2%SWbiygidL??x*xmsfKwfwv6V
zjq6ZZJ6o&q5ZoFKaPemY3hFW}rXH*HWnv3P>1Gu5IDe}7{%mGf`z6KbYRt=8nSJ|G
zwldXm<6o~??ie`y#M=lw&$s>gfl7ZHfAGMu>dQO=`-NN?Lay*SE~O>7j=3f5<qeL9
z9ScU^c^<M~DbXVZPufHHVtLM>ME9yjo6X86_1SJfGW`4K={V?y$Rs2P)Pl_Cv(>nq
zIk2^c>UO2mc$ov@mZ7$VwS3-uMyXw|D}o}G5~<r|4qe)btfx*%rEiy6&&C=&B@-}G
z%y@-)wyrE7%IFwSeJN<czIIh6@waGVLwR;uW9QvV&F6f0C;k@QEnT5)?h%Udn{m&n
zV|XB)$JAE5(1q3qF&Q4op#veeq;taVJkE<#sgo8n>OaaPp-3eqIQUeJi_hC*?EZM4
z21yx8vWVX^lnh_rIExZrpJ^X+!=}8w@fc!i*mE8JY8{meiducoXQFog8=1YtiD?;H
zo;dV`r!bJYT&m&Zm7dMBUhmXG4)YLmq;PkzrZcq9GfIu6jr6|xCgm!K+=)mn;Aa1*
zTacl3&a}?fBXf2qyJ73EPY&pLnG0OzD^6LTaA^$Q9(%g-h6?Ys=Ew|Je<EP;(r-+N
zVG8||LH!1Sb{VKE*@{li_1C@q@*|V`qq?)=^n3QAF;0x4MvW>-Ip%A(SYH=gR#Rn#
zn&pgKvbsqsvu(a7P|v~#6^#DNbGf<RDB)+o7(|${@#$nzRj#+l^gGl}neYG~I_(y4
z+4o~G;j7_RS>a;zofL^XRcegdML9$@%i_fn{4wEBpAN@yCQq%%#o?Z`=8wp|;DsH;
zqC8Pr+8rX`0N0x#BTmQ^9X9XHA;f;yB`J?M@KsZ@+!am44XJP~pOl~$`<Tba<XWd!
z-aFdTUBVVtoBMrunxsVN8}gf=iFUs$SR|J9L9}_Jw&hKog|%(GjmrSNK#weK=skjY
z<;wk07AhW>U+o3{Q*-X?LgH~@6?&OkMRI6BS+I@(D2mBMY7RE$QtX~`HD*^Tyt;5_
zv`;6~=|OK{riaCBSNDEpsuRW?Z~9y_P!g7ob#b&c5>+pjc7I!?f~CFC<7hcmx5#%-
z)R#LgYdY3n3or1u$Mr}-p}i4a?)DRt01U}!y{i{^YEdL^MFmA8@~|PTDH~VavCYbn
z((i#LI$E=MnY2QCrY)IM-96n|MIA{4{p@%oCq-Nc5M^Xm2rU|gjW;ZR2=GH)`P&=l
z2}->h2$wvcbs8ndO{za(cV_3Hs`9U4CG6HOwsvWnmG{>OOmmPl*MG?M))#U%4%IT<
z?C#1)VHuTkT?r)3d>w4K&HmRuwMgY^;mSxFRB&7tT~V%ZO6Ls`b4z*RswXEWTab;%
zBl^#hw9XH$ww8`BXS(n>2+Sa7nny=oSNzs!kYb$6uQS}F6INPbiGF(6!oTB2=raZU
z#T*^W_|w;QR%~kksN!Ut3d}owCyZ;oI~zbU8*9eam8g9g0pvEK`=kl-Qt4%RMRgXA
zblA!1D{bK+QC*`i80sUH({LhBwGyw;1-Wlmxe8QDC2r1D=;`PP1aPYN$GpExPLFA&
zVx<{mg{!%C84`I7I45+Eg?)ZJoZNAV9L|}2-RzNhdAOA4Gd7k5Lj2FTMme#X6~w#x
zOoYkYz(gKpIFAMRjJQfXKZTVguBT&jkKE2<R2Jya1gaUyFHA=IF5~RR-Mkb{So5-(
z(tQ}q?G@e2LA|cw+eTaipHGM-mX`8^fsAfWoywv=p0e-ncB~4jStlU08g)Y|FGc7J
z51D;KF=mfv2p42u&8P{=vAV4Lvww7f$Ges<DCPFprFT?py}_4`Vy}Ga7E5%CdM%{>
zu~++CFQ)~)3KajdYFvg~94yhVD_T>MZBFbsKpC7G9pshT@+NvL>g6N3F*D!Gg*uk)
zg|og6Q=4G)lL<3&wGbKW4~_Ht)KxxShbv-;1|Eper;s=u_DR1$=5BwL5d47mmW*=(
zE(O()y`=`BY|`PwiuSMF9ZSmht3a;%ZKL)qkJ04|Jw{xkc{t|Y*g;&LPG-_z|M2t`
zU*jJkOO8`{MNdjJNWl$q|1GP`7S$ze?5Kw%Bu?hO=`C~svQ3g1q=}+8RW+#EekP{A
z*(@WJwC)&I=H8O_rndR-S=3*9e4Ffhokl^l8{>T-OBii;;FIiCr`5ttS2k8Y4r=ch
zDbXy=QTiJx)OscD|MB*gVNtGq-zc`Ch=qZKED1?v2ti6=2?7JCFm!i=q%;PgC?V+}
zq0-&pFoa4ogmercQUU`=H@yFAyzl4T&#}MmWBX|x%W<xA&g+bS{DKa1qu-&3Km)l?
zzx||j^>@iuxF#6hd;KXT@?oRw<{t~$dMT!7+LL}>ys5#WT$8*S$91a2@${ZcVi^1C
zx|w9Q2UB?A=WJCEG<vYsZncEL#8Spj&%m@5W=MYpip^$zB#bD7MRZ}n`OO^)Q;jG&
zu|Idl9dB0{Qti1oKJ{RN$v{yz!<9VdfY(mpj{N4E%%SyXLi(iMi2lEvr7mpR(M2FZ
z_-*9SXj+t=Y!*YH4;7eK>EK?XTYKHNHfrQj1c>MKUN~h9_as+-`B<8tp>p1`$$yg)
z=0KkfUXp4$X#Ot^%Kh@gq2)>0GCZnwG**8~uL}`IV@XWPdhr?g17&d{DJ}8pV$EvI
z4z0!x>&30CUkEaUL8L-O^9V1fk|x+VZyx+@MA#p_U_0NXKe*jB{$%0=x0`~%W~T8#
zAx@RgnyGV!OESfH!EV#?7!=#T{+5CRk@83&V@@BGg*r>V%)CHuBO6B2ps5{}vre1U
zY&GfwlkzAh_APJlPp)W32Y>YDi6+vwKGJJ};80tk;0&f{;zU9E)69~&TfGyK4dd#$
zEsfPY^*<Np2L~pk@9dutc+FSkZ~_~KQ5hI{qZ)Jug?R8H<=@XwmgmEY-$D81?*@u|
z`tf;v>t61TBWt(Nz}DbomNAF*eKnzT&Ni1yj7cx5PC^=DWmZ+<JeQ@(e)0$%<{CDS
zdaqThA!1B4k5a3lYs`>Enc0#q+jIJ`D{}XS)3-mCEwyRG;lZ~Y-RjHAJLr%Z#;$Rn
zI3J!7UP8DMzP0<yV`Mu%SZqxlDH@J!wz?uPOEuyHSRc36zVP8LHM|J(U5B5tbp}ga
zJ8XdLyq7bdQ({mu_oaDAkwSh@B0GCguy+z%Z7u(}rtpQ3ApXV)g|icfwwBs?rjE;{
zF#E(=Hc3$)%~H40X}kOH?&t&QZiCltB0KB#3@DpMlyQL?x+UgecEQ7k$(RF}$fHI!
zp%7&hyHKa)4+tx#<MCPu)soo)q+-fI^#^$KT-^QdH{zq({&P_P61c5kfoIB3F2%4Y
z43b|;u?=EAO*w(_4n5pvX~uG9Q~7B4|4RZJBE1Jl7!z0(a;gWyTe%WwiLq&|bXpr>
zbHOEMfiAeaUmxq-H*6>tBhXKNe#B>}m97P|cgw1NQzI&weU;`!X|0-Qtp||ay4v%X
zp91(gjhg;RtR~)7)e#eM*fHY|lDzgIi>pBG&#AJaVmF?_(`+3EBRV-h42Zv0H^t1h
zMH40AbQ2Nctoga%<chwk=vNVzKGG7}xE7P*W^G$aU?I}m7~0GXwbx<F&Z8=N2f}YX
z@Y25jI;D%{sQ8-BK*5ks>y_Vgp4oG4xJqufh9clBBR<6#i|OE~Zy>a#L?~q)cC`gH
zy#xM;G}<*UNZ7b!8dP3B>s>6{sy=}i(CC39cXKk$nB&iEsMTuogFxO5;@rK-HQeJ(
z^XS5b_kzWrP}9K{)%nzWE|9wudyC4NhaicX4>rv;hUy-Vv7F#d!d`h$_iMh7nq^z(
zD^sUw1&!qj!z@5X8KF@l;)6q=FNA15ovd_34nAo{<Ye|zE4DBC0@q#IV)G&<gR5m<
zolmAu^{X7K5qkL8flGJ(*Zqhcx5aCVOQvWCc*}2I-Kj7ttt3gZmYShVXd}A%{eA4(
z95!6<EEhCM-s`T#DBce`H_+M9E^?+lBU|T0Z*9Vuu@*~b*@Z~76z$cks}nbUGynpG
zE;B-!`JpGs<2mE_$rV$`S@*-Pv7bk+;cp5ZNsocc&??PoRao-dT}gRGX3HhoB<`X2
zUzCTNQ!HgR!qO#+2orZ!v<C8{B%kCu3t4JwD18vw>OOZVDkAzYzmcc2rrxXz9G&-G
zL(wBD5<PwTs$E72_5M8Jw_B9$%tOz`&Z4@emmgb)c}kh?vnZq9+@5sZL)dfD66Aro
z;vhY88I$rBlnWHv@L1fcag0ZDe+JW{3k5M2vJ6MDmkj@uUbT4>Wx|qf>R@!cw5Hdo
zHEE#849N~sNFio26FR06sl{t9I4(0(vex45;fttZCll31e(lUy=D9Fae5{Vg!pEMH
z`EolXmOEH<2v&@~6LLZH6KlRh6|}&o;pUI3rArWDJcNE&b=7i_$OrzVfE8;YPVAuA
z9yDpN*#|j^swo`Xf9x)4PC8(pV60AJ%N+W2Y>hk;27XC?4h)0x$>}N)O&ybYK5U88
znuXTjnFZv`RVFnF4h!z!lSK+gN7h2SDo?{YSEWsX(i`!at5t?WmK98hJ~Og}J@DF0
zoKHzduRp55v#-)ccydtnbCywFDxtAFV}B2}_^k%f5ePL)omoUDABdz-rJ`;^Y}mGx
z&Le-y4bEbcf!ZB>qA+m+mC$G`u`e8MNw=UUMVoof?5@phGXz7G-fUeFEX{?)VZO9^
zYTZu6QUVe9EU_U<dumT2RqJb4k)gmj|BosvyRReijDtcJw_{Po_#3!+!>TwK@sd;r
zc~lzs&jim5wY;XeXRDF~A=0d?8>?~(GNyv&UHGLM;#d_FuAe7b;o&dnp}Mgsvn~(R
z5nbLBqwYaLmN~=Z1Bu4wb*}R@{d70&r6?TZ?r)hgVABYI>R_B>t1zPI_c-Cu@_S?<
zA3@ejqE5~$D19yKZ9>!1@8tOsn}sV6%!^MPfz1E?FjUhc{jBF4Mt2TdASHa2=L#9z
zYKbQe3^Z<h+-NqtcCN+JYD*=SNqX(TT@zWuw9cUfqE*~1SHcVmu7LvV2f<eHaP~JY
zICOk3gQD5vMyTMaN#d=Q6|k&b5hC-qaXgD<R78*N&dx-=-5Is8q-W0#4EgNuYJzaN
z>J$u<A_-+GiD;iR6l4|cc>rb7(LJZ6L{P`M8-sWuTUuJGsHvqMIxTb;@jY|*=p30g
z%R1T5fenO>+3YiMvsi8O!f)ri(nz>8=8nG@G|WBRR6lS1cu)L+R#fuR!@WrqPMEqG
zA~h|1?5^4MP7QI0mTgs0$>-~W9Ffin(?_wcW@FY)$WvP?W2_-U=o?NQ0RrkkrI!b(
zEG2~%G5ra1d0EC;av_!eGK@Nr@csmrasnKRdjMnU1hQflAWRQ=!($H*JVL+q0t5Hn
z=SNN!0h`f~G390-vF1Mmb_GqO8^#<zL|NHo@!Ii6eWr{UIzt^~9!|CjllpjDD&+1=
zp;HEfJB8`Q3ymN>a9%Yl#cO%A=}S)Nz<ykReO*mO*c4^b$J5(?J57LFET3>dK1Rgi
zi(E<#ya|_Rc~^5U$1u4RL?H{2zc6iyVUb11JSv)HW9sBcF=xqEPRB1X2<)dQ9@M`-
zg+<)eTU%Qr_Q5|~BC~#|(hIM6XPOylPYVbLAPQeaKww4uCP7%O6a%_I$UcZrR(vEB
zyPY@G&T}D;x|~N5$#|xyJ8)3Npvm~08Or@U7~=g4NfSn9IHpb7y^8cirR*V*7q4LV
zn<n+)xacF{0}dWHn*@BbZ=B%Rlc}(~71P~T=Ec)Rg8n{61(FmK!B-yXHoa9?h3<?S
z3cKaOF1Vai99Zc-4ci9DCgE@<Zu5iM4tdT+7Rt$Xorqk8QRyYrLvnC;k#>_OQ3-?-
zGctz~xE(>#e+H0p(Iy%QS=XuSkxZ@acHQktL>*#=FJbd7!b%;26tL{)^OM>V{_QoD
zBFapzm^VoI{gYp63K!ChfUwmS4x2z#sN-Jz23NRXoq76L?BK~((ldW8ZlAS<>R5gk
zxXvSqk!azg7oa{-#+4NOB_ThjGH)gmm6_D&QZYbWy|eW_@Lz?2+$SkaT1H`T=QY22
zF&G{&G+jcN%lbok_}~ej+p?{W`s6ZEfdDI<YD{#e;g!sXF~>dq^*UJZ7Yo^Wk8F(R
zI`~B9UPxO=?3_bwIs{Wy&2ex)oQ4!1+J~I~vM3{=ddWpwX?dojKDjn?7_-5L(=kh-
zE;jaHKkxVwJs<mm*sVqrEC-iGq1~;|6L2tT9KIkh@tWJJ|I~h~Ac^wGp$zuIHb1#4
zlUCkimM@ocxu{r*xK983`NRP&4lAuVgY}%%NZAD|klyPXzD+Vpy{ZexB*k?mV~0k>
z)4sT*L@uoL&TLl1`qi>IkY?%vS}f%g^GXxO9i1!}9LxPZwLQZkLIobjXW&|-bCrV*
zZ;ylKO+*M(BL(kNg<Qvk7=Qjpi4Pk~a|egf6XwJg*hOnq;y4ZBj712kb&nJxT29;b
zm%0uF_?V%h8~1i)r`+PY(br3x`!j?5PvSq+_Y)`FP0&knKg_#+AR6%$y>F*OE%dJy
z_Ft`bgOk+IM|?a~>hbW+y%JD(8Y-S*45B-ft21~`{Cw@6nl}VbzOdag`5a6}ba)uy
zQXz>(z4k07^qWylz(}9Q4(;|=_1IF?<d$I0Ihz2nI49E8c`cN^g?{qr_eb0#VGtL`
z^?ntOwivH^gGx8g<fdjRPuU$c|E`_;bfFYb0y!}@<S36O=f9`UDJ)OrhGBPCS6WsU
zLahWMYXzbdW(g<)4T(v_qhap7D=)BqBi28F(&U&Gs=cQtYN={tE`4_f`1-KsAq7n(
z-M+75w=3+T<%u8s`BR_d4U030**UU>+WXIom)p9Yi?!?vc#xQ29$W`21vy&9a&W9U
zv3`|D{jCHWp}+~KHEb1n8IByq7$>TiiNXoWsKqI#`Fov3i)wm7L#DZ{4Xd#v2*I4o
z*JLVO$7J0X>cUqVU!>x_6{8s?*m9>LtpB*?jHHr#rwW6-*)}boV|#QXxqnR4zcSuk
zc51!X*|jyrSZfP7gK6&s_a5#buZ0o(B6Hk+{utk#R98V3)nTaBergKs5KnEnxyLlR
znY&r1raXLmFSbeU`ONSa4i_RMe)$@Yt1D#qRayMe`wN6iL0{G`+L=ecerZ(ybd}vB
zRTO^C1#b@nQe_3FUc3L7xb<_4y;pAFHU8G`P0;>mFnCc_>kal<Ww?C#M;MFz3Wy=<
zdCV0@1G#7|i@}jtViT6MwY6m+(Tsk7i)n2tDk|!2Lh7eaOcOqf2YSp^pxH22@#4fX
zTJCw2snTUPEvMW4oY=s2LG|BqDU$Zvv9Xb8oSG4LF{XX4M`hx@USzr)fGmRXgjzxg
zphwW{r!p@(W(yV_dwJ*`snT^?RY{<mxrDHq`e@aZ`i1mkt^8%-lAU?lxRp`rX^=a1
z7;GDsZX(wf#toZaqMzNp3k<p}@3q2&Y1nTn^73zByhT8V_u3|osM^?MA3b{1sgWf*
zDNFydqN{5ub9#BXXWuqPg=8&tnX)W2-tZ+Sr;SvQnNr%5m*ShMZ(W4(6)EGw#!b9J
zjVczmK5CpF95U!&K&?XCWddb(BeLl+6u`6!Z0;2?Dht)_d{l|G@xWFnP9(2=TkhX|
zJBOWI9^eEcgQu0*ak~Q@!b^iGPscdU>2<EFajOZDPF+|Yl7_l~Z$1nEl8$r$Vub_{
zUkB|f_#wZqj%@fVip=rTyYv}Y0<dl(S}%vMRY<D1czVA;j9<k$N$`a>@r=L!8@57V
z9X!%$QHcm`6r4)Fyx*kvc4*>Pw_23><GDYh7CDejFWaouSoT(bci7fuza+^z^<zO(
zwvia$5t$2o6et9R5NzYdH5(&lPvs-8B?|hN3)E}hMy|J9D-1B7e#O{j7peODM~J5+
zs6d;B)w@VEK+*SWp8&)*@4#?K1`#qxHZB}|mZRVO5M!0jy{(xUdd%61ifSJU()9Eb
zPX$(hpz-a|O5mVbZWL(@J;)5D!A(O_iM=*n8)O}thQdhjEx!!RMr#V&-r`pFd}IgC
z;6+z*cc7;9V4#iBN3mMgSuq(78Ec0-sVe@h(;;@YKcc;tbNg036d0zC%Q%X$;UUN_
zKB=fW_dJ|Mc50vKw7bygkzDSRGPN=`r8*-LvJm?$it7~Y-!Q7Z*46EzjhjC5U&?#O
zHR(}SrixYzdJCm2+VfXl8Luv{{Qhv&sqy$M^Uy+P{5JhZ3$-0~m(9=DUFF^MwuSG1
zmcG5a5Po94-%8F#dTQleVO!_b;$!tZjLUX>kB41<#{#mzO-%xOi(kZBhiaX{fN{sG
z!A)(t#f(9AGgj(eD9tI00UDo<{$ukQ3$gi1Gv~vcdVF+0s%4%I)EV{}X$)Ryi)t0O
z3CaxRpgO`|m~Pou4|-@6{(Pnb6CF<mEK+OtVy9c}#_B_&i;Qlq|J0v}dks*ibK8zU
zcQ8FBR2R{ARQHmRtMJVo&MGJnwnd_A%@f!;pQP%rM~>6no0k*Z5V=Ig3pRS!7pai4
zEyOfR2)N?HSmy2svnu@HjLp!ATxSH98R@!+kq9fQa2+2S9wr#53Bpp5U;mSBzqb0J
z)k>`2h3jhgsl5`3`B+(j;3ioZ=C$)Xf>+qQZ@8w26eCdVunR%b#SpGVtZP-c7mrzm
z#_m?P>OV6(y9&+mrXHT#rMNt)s$}Cx^nA+?*}9fL*K{VBJTkHP5vzJ(g(nhRMWv8`
zZg^}?^7xHC?<RNfx#%Z3JB;iUW~bY7pgJ=+k*AnpBQor4dIr^BRoYJq7R>o)(RuE-
z!Y=g@sjwr_)8cmF*<lu1y?;JMdF8p?DNG<`ziD)dCOGRO*3<ej4HwKhQxx(g%m$)L
z^uImtOV9)IRK&W+Vr|@<9<Zz1ehb&pdNf=Jz9?v{S&}ZbSgQ=xYK(Hc`_xy@C-Xef
zRe?N4XjRO4oP#O~cPVN0)XQQ^E!XePj;uJwi)B!&IUE0F#moLBT7xc?I1BBOF6=!h
zGCq8)W|3(;a|MnZmbW%eFVX3oSSVd+(wBO3b5`ULbsLLtg?eYT1k7^^vtXnYknRdC
z5=G2tDafaUxp^qF*q^V5*caBp`&ce)ZOBy*bS1==U(iWOLN+W4h(4i=V}UCNvO@8M
zzu2(WjKII0JlDTvw;}6jt&()*#l$BmQ|w%5!Ep9Vo0f~21sJN;6*DMb%|Fm)gT`2F
zkF2xCul4KUF2c7tGU%9;X`v>sI&jKGKP&Ubqg#2)yV->|V+)pS(&xO)CpS1`2u3Kt
z@d&8QW&H^JHwcnp7V(m?Vk2_I=fDT2i1Ta@mB%*Gt|~h-w^B2#>&K6e=aocx6YHt{
zB$09oi!5*}x_}R@R__J6Q4HL=<?3N8wKu)tBaCn44z5wge^*5bPw~>Q0o;fux<0fK
za7Kco)%KNrQYqS6Ex&O6Jpy!Q4G~r>%HBPCNCId#eU~|Au`Q}1&`i-$L2<T*H=Ml%
z!qc~$j-4}*HckT|cfb6ZZ{!&Y*~eC{kdW5S&e14OON11f*aAdzh_PoTs)jP%Q)L6G
zFk4^YW9szYo=Xk!A{muU#e1v(z0nG;PD>k`ZbTw<e=}jfohg9s+=pr>qD^UfiQwWP
zL_XSBBZ`ZF7=lHw2qU8MbC8ap>VAWQQn!-Nma<J>-aW*T8_<p^>c<6q_B`W!_BJ;~
zhaP=mj@bAlpbb~-Kc~Jbri8*l-~Cx2tl;4u0LUz#;sFTC!=%h_Nk_wF3*90v&Z*H6
z+hh9Ouox=eNioO{bhSsHX(gqlHF>)7Z~t5f9{y(FnnLX8kN)vX^&+LYsec>M{3KTM
zakEL&M6oSHbRX)HM6^YJO7Kg{sw-nqvbTk0csHf4*)C$#UL6!1@)*FlE@B<b#=6!k
z*TuZHIulxFgduNS0q)*3;u5vBI_nHTXrXyN(0UXD%MMDvx@P%=;)iEBvHv_uH2Dx%
zRTzteP7Dw~@E`9J=O?y=ra!a^u|2(~SmM|}{scSsUNE+)LtnD^;lkaTvqh)s`<tSP
zZPE%FF0cxl@LZf3P4WlfxHOc|I`l5h{n&MOVh8D48=Oj%CSN$UAbF3nnR%<DC=ksa
z9qJ^f^DCymuaeK$kO2YWFBvp5(<5?Ndy64Hzv0^LDRZ9f>gf2qx98p6-EA>Hh`TfS
z-e?8a=B3!u(jqL@hL8~9P0xZWCRv0OlKmT(Pa*brTQzLrpKf|h%V(rLu=_BZp93o_
z-5x6QHaaKxoa@x0EhQEDZ|S|0@XI#lXg#JR!xAnJ)rtoy1j-As5I;EpZp1px2`Qn}
zi|^n)t`*WxUbJ&^JthgrIrsW8)%%eq8X1{4+M`<I?zOGOe~W+yNE7dJXbZ&WT*kD=
zWr{uJ&AvNd!JxX~>s(3*!pBPa5Dz8_+*MetNE;Hwfy8EW6U4o?^5)Jj!UYXVjJ-1u
zcDHP8{*1k^(f|k^>RiXdzKcWLei`ICr3X1BM?hYZH#i&HgmZ>_;vUinRF<L7TMlI&
z4>TKLx*7d#WRrGFtcD?e#q<YH@32T(akdDj;qwFX9^*oU)X&Um`d<U*yn7gfEw9lz
zg9}OUS}Pq##ta95q`d-4RN6i$d=VJVuZ}I$nICG2JF(yqULTn`d{Gf*BHW@6R($c_
zs@)YnKI~74wV{dc?cXsdw`sl2ImV)8Onb4Dkzs8Olr1rR9J)&^dQc@=dQtR&59`nm
zSve$s{KQV?skXYT6wCS_%V?-}&v0o@4q7i1m7Xl2F078dI-AiBg+u0a<ECQ6CWbI7
z42nwnv%8t&ueQH^Qu{*yxFg{3v9kCWE;ZdPwLQr>p3)k>nYY%EdJPWfv<3x+JK==G
z8?VHFx$2-ga4;_ZRIq?v^(Z}4=W%XFTQ!xSLg=InfABoxS`b);(@@zFPz@R6iJsjm
z4nRvqqM_r&QXYa%V^>ywH}DMUQXr6@!h;70yfwG!T6`Le-?9%-kc>%%>E9nEnltDI
z7@j^@QcA#K0M-H>J-Tku{u1P*@9b$Ebm6%wn>?rPvDHb9U0N-CWRyVYlGr)z2;JSG
zm<)%Ew2Vx2mhr%F_|E1~#)ee^;1ETmvbD_=6|&fsceH+&<Qzb5vZocU!-xnjc_^Kd
zYoX~Bj@U4pH{uoTL)4qtJg&@Z)m4uDwH#^_5I~L&BJHFcDu2ZQtrt~8eK>38NRxi3
z@Rrz5uo=^)hc#+UgcIGf3yTRhO3*)1b&jnFV;5JCNCI*|x)^iIADrYjUl*G+^cUMz
zDA=kY>J$1T=)tD;2k25?)aMD`m0B6(D!uO-ZnRNKU{Ws7$)fE4NBvyU1qn5;TZV>G
z9}A1~D{g+GO)lWCGWZ0&PJAf49+RTzHaf)#P<d3+MF7V8?(8vf%UUG90-D?OlY=>F
za;~i5S~NcJ6V^g46y!_G#wu@)amewr)LvT}?aTbBYCG4eMYxU}e}LO7q~2#}?iBs}
zR5zxczvfZn_|j~ir~EG-)t0fQ?$B>Ms<;9!0`HDUuOqrdO8;7jfkDCOM1PUM<Q<YQ
zJ*H%6q9fZ_6O#K+CeBc{s_P$UF2Lx-ZwOt7zNE-o`BI(MY=r}?eVYB6Wyj7vZ#2d{
z?I+pew3MB{Pef{!g~duO{zZh{f#uOjlFEhdS);rNf$E8h6HdEv+>biWmU`di<r%kl
zUYg@VFAA(p<!KC|wd(({ED|j*IB6GJmKbL7J~SOEhm-_nXjfH@amX<2#AW@uN$kCL
z;gq?gg4=gzDD@lqxMX%arf?f?Z7*fdyvjV6$#c@8cS~*?v2&r&fEs!#jip)f(>FGZ
zNfmj;uCh1spMRU{{q$a{D&Wi6A2pogtqxKoZbxjZ$;=G36};0v6T$!t*9O^=$9$#=
zn{owTV9|uzt}I2$(C&SxV`3ZW3auMi4(#wytoq_@H*MUEW7>vQj{GUCpmhi}b`UEp
zP{^LIGrziC%BDTc*GA(FW4WvakY@|H>O9p@xC-tvEjm7|_Gv5~K9A;;I{{a%9SlXQ
z(+aKrUK_3{-Rf)i+W6|#(mO65$9;R$$p2m!S}>VAv3%IafS3!R;Ei(;F4bCL4Uvz{
zFUt3-_Xy#wE1r=ABzN4UzgyECnR`H!xb<PU<9DUJbBLeu$z45ilaoIeki~p#U?Nte
z*~BM!PV9wdZ`9?B^Wwbw1_n6p8w7r1jv7%`*$imvMN6}UU&Y5!r4Hye@}pr4a3<PB
zKC}^Qh38lIO+I-YiM~p7Re@0Kx0?Lm>F5cT12ROdvKY%Iy0-HnZiv9J{dqW;xQ(sG
z>^;;3M5gE>ejy;R4*k7>iJszB*5;~oc4~|0t!CH!rbu}0x3(RN0uB_$WSl&AadLo1
zE$yO&hqH<jEgyE+YVHZiMbPd2pMR7AJUBWqF=)y1rdK`gGBi}E8s675$(B}0w3H0}
z60}}W*b;?i?qpH*gg3q?xqQxdno2{02ZjR?^<gDPRn!DP+J97k?u=|3njlrju3NX-
zUdq(&hj-q=qxRMf4PdDm!mS&eH9zcRGm44{t4aBI?SeJ#+r6?uHm<nf3rx`PEwT<5
zsV*JEMERf7jehn(g}y>0go)NU*U#paSkl!DV+X6>>!G`;JuDU8p3c~m+kf$J^T@i4
z?BjSkIE-n@Q6H^&Kw|3r_{Km>9Drxv#WzGceOYyRCwXOYEylEO|6QGDb#+C{vwQ%E
ze49V9UR61M7@dN^H|w?ZG*H$e>a1{ivuF<wbTe){7RcqWJL51r$y$vOR>?i@JkSr^
zckl7h2A;ct^p#eS!^-dZ=1DcuR`uEJJi9mZ??M~%3A)UspZXS;gqwxWw+>AdNXV2P
z<4@&`{?F2Xp@?)UxL54u!A5kABa?l;GNrggE~ORPdX18gN}q=<mPFxfp1^?@%H2D~
zt-{g?ZTbO`#`W2v-PG}wFEH`G^so+EDl;{OVyfg)CO+WLx#T(;X*rdSJGu(j2dw>5
ze0)HwrGS2C==SeZC)X``(DqRTxYSkkFeaErV?8!_=GxHEfJe9*YJ%@Vu^Os20Bu{^
zL?x!@S!@a|G{KVfJN`ZR{OSoH^<`&#v0rQui*Z_s9j8%*$KNd(9JzYc{!yCmoWmOR
zJ4Z28h^#{iVWMDJvpfo5STnzgo1))*O%)oDbpUr3u$Ab{PTpFog%;7?dU|Mf3{s>W
z)tdzx$-n@P&z_x}0ylLV75Iddu=NiqG%d^;=h6{-u7JjkH;dXeeG3O2Kj0y~)+zln
zr*LBZiIw^8bBk5?@i+S^Y?tghHfB&>)_XjZ<G0XY+(+@iA5bY5DK9|Yn7RC(87b%F
zzNm0Fg<^@!N6ZaCSZK5wb4;%1a|J-_I4wdpIfH9a2)`WwrPwmwCqLGZME7E=c6Wr|
zg;VN*o@dUuQ2z@}FxD&?quA=wp{#N%K(x%ADqAXE9)G)tIl<J)I5Md3!LZ(Hw^l<7
zEh-NTqEQe^Ip^@FsN>-QXyq3bstGO?L)Y&`(7T9<TWvRV^ZmW$;mQ=O6ABRt;r5;g
zj@$X1Z_kGHq~48UCKT}J7;Z%2xZ`#$r-!fXAZ^&f#)>BVqCg{YqQq&1rKmO1?_iAZ
zaGYEYcI<q}eo!&-JdcM74>AFvr=f`!12=ALs$7aOG2COiI*!lS!R${dU*8SGhVjSp
z`js4t9q;CTE)-{1oOqFA)g(Dk%v2gj@IQZCJ$Q6vsQT1CkIH3@spHslT9YJ$-dNdU
z%Cf$tNK4jELt<MaGC>L_3IrY#4f2mJ!giqOzec_ySUb1f`r-!_)_Ryrk%Q5hX5mma
z)F<AAveOD^&U}(XF6W#5?=QzUJ3oQCgk{rtd@}wqX_A%3wp4sdI|bSzwX@3}bgiKl
zG7S@=KI`6!(lNV}$$1F=^)kXV<JK#DMGBkCi&}uV#2z}2XG)MVgQe9k9&5)BZ*J$-
z>K=(``MH4XYpJYR4tY9a%~ZJ8UB@zrRE7)0>AOu{Gbx(|hNj~svbwp4@(EGJiO+8^
z0&F!nl)Wvt^C?8YKu}u}nzCw})J*26i{VSJYnMC@19*A`*?K_62%bz0Yt)tfm5iKk
z){aK5IFk=|E=c&BX&NP4HoaMY))Vw?q;X)M^2$Y1BF~hy48i9<cGqL5TjKqSH$l+3
zsU|!8N)RT4gU}X#);aPulhOy90O6@Yepfv<h+v?y2qcU24abGuPoMeI#2&wNIo4us
zKj#Kx@RdZS8amp8v`=lK+o<2!Le~n{F8I6n-W0?&{f8}T(;!#}MHl)9Hvu0a8*K--
zWiT8t@`6HIn@c8NzKzg(y>PE`p5n1SU?r0r^1-r6@<d?<us*Y`W)=E&x%Fiob#lh<
z7>1-I^)m7ows#}4ITTAlu&qp~vEQpnzL9SXRl<zF1G7rHPxY<7kr47^5|0{bbS^Ua
z^*042S|(+AAjdhc)bfz|4Bsl~J0Ir<pwkB?D6dHOQ1OK~?o|wBrw^Q+nP@8DQYdLL
z++GfAAyf4-KX(mH?KTXz1kVEG=8osuQ?&%7(a~@lmbGSsU>0+1z_$@#KNKfBPOXh6
zfBO1LM4ToDPQObWSka4FINlBXdl7={V-t;E!YfH<Bl@Lc`_E_6k1Tkmu|r6j4BQwP
z194!Yq<#)AM*4Zuq5TBS0``SA5xeLoU|Ya`qF2YEi}bl97lAhQH?-+fePx0Eohaa4
zY~SdPJsmc5go=<>!vzEiIG%m+oAxmuyJ^xJD$6Jr6=|Te_T}X@K?Nwmy}pF07D_EH
zDkx|P{tw((`~`lL14~JB4NA$nn%$Nj!#kcnwtE}m14fU7;G}E+#&^}JsWN<d2`t_y
z?urAqty2!E_&#imuvRbX{i4%Y<gTUmz11uTlN_Ue)m_^hr;6&AdIdm$3mo?9>K0as
zGm6kgSEn(VE+S+P4#eg4Krqo2QSXczM6-Haj?I1O6ulK_VAs~W&UWF{?`6he?wcV9
zWc5NIQ2i)ANCN76E$_Dz)LHiEs!NPtw4TKM<&$CO;YI(w*y$gnhNa&ceH{mrKb1e=
zs?+RBVKt&-n}%?J+5@?DPLxi}PC2=c{pq&T_4I*n|4T|V&Hc9#K>hM!XB6Kib*Z)s
zydRtW>36rTwGywb=RfDr>d3M4Ha(-DX6EBN4y^mp@0yTjj+Wt$WF%#>7XnDiI-0YK
zE{Vw*?#@qt@7BZ3$}=2v&my$^ua?EPO(Eq}=|jjlh~Ot}|5Mh9V_ZTYlS^ykw)TK|
zQEwa{<jvZ^PYVxBpa4y(c9<sdS54(?-vfXq+RQ|}=4|~ite!qo@ZE`*NSuJWvZCr@
zloBlVY@I`lbTXsh$r+NXa_#=3giGJm;fY@fNOTH>JOfwa1boATjZlfi{H8}izm6n-
ztNHU!G*Uyn=Xy#$8b<X(E+uC#ucv6GhG*gUNh@uU5+_WQkZUv_>uL=5r0vtzZzHdn
z!g*7E8W`K$zrmzF&+sbE?3(tERn3c(mZr)}mMIltXX=m@sw)k#*vWo5%A-0t#vD$`
z(j_Ds9UO_L6ql$6ed|*H+#4q>rJn(}CZ(Kt8+ws81`TAy61S)NWy+)HzN3sHZs`x@
zytjD+AcMHw*K-aC;N8VFlY`1qQ_4g)q_KcY0K<0r;z*D1!#^bz)Gg)^4ecq<E^Q%J
z9KIvS0tJfq^?6m4+Y{iO+s^Zt*@?w;YA5Pv?0q~4CDUY|VBPnSMnQ-^69uhO+AZ#&
zK_Fi!ObPaKJoI%&4VQQfO}2{5y!z4`vE%JSJ(S)4M8{d<!Lb%JgE(>k^*w_FXwp2I
z@Z{n<9bRH2YP3&>Cm^)(Y{S!!7)3d#YVHD=wb_W)F!$q(0_0_MuPysiT3^mmx(y;3
zp9{|LNFD^dYQ04)ryeq@J^I`@*0k(?s=hhy_tW5zn|-zUWSu=`a%e|qV>tgmwSfT7
z+`~LB$vplxx>P-}c!J5p#-etSZyFd4(5pZI;V=EhG70>jSgS^5MP=}@+{O+-|NUV#
zV4P{}K0m~LB6>YWo0HIFcOT;>`%q#dWHTdoaFI4Hub0_tZbNKoD;8Ni=07V=)ZeAM
zT}^|J)WV+|XazKiu=r1RzYlnV@WCq~MaKuKdI6*QmiPKm$`|j_hKIT$?R9wD(!Z-V
zb`2$fY+_%x8e|TB2cy2X(|?=0%bc-i&#aoQoJD_pPU6MQY|CPL83WzaP376u4j;zs
zwc&5i{gF-Sn*gplO2AR{(*ds0Z-ehRdn;CDnURmfc0;h~KR&?cu|Q;?QG6r^!3mWC
zPN;KZ=9ixzrUZ)|>46n{Tm(6IvmR|9As4C3A#-%zd)5n-D&%BdUR#qq`pV?fwF5{c
zF7yC$ir>%&{%EdF>rFVPTl-b|{n7F^Q{`I9#YSqShE1j$rM(0DB*@Z=32p|v$+UYm
zWY&%Sta0?#s8oufj}NjSl8|N3N!3pVJ2&DPb?0cr`~7WNFW#^_Vg+H$=(_+P51UXN
zz@y`tVJFp{A616}w{}W!<vrQj5B1El_%5}S@@%dPKVUZ;5kY8(6j&swfU??m9t>)3
zBUG=Px&tdGn0w=@Zd&}6U?j1M0}MThiw&WF0sO{)O}u#h^!!c?@ahDTPOB{?=lsKK
zY&qNi1YH|T6u|K~dkn-*YWh9jDMrqur!-aB)tw|8Lt6|gdt^8>_{&gH20=1L^Ck7>
zw8KmEJ9?>nzKPWt?(Nf#*D<IoMxwVH%0DybAK~stLuhpVMLw>jnDX!v-bfQg)t!7I
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
KEs4LF{`x-$!UF36

diff --git a/search.json b/search.json
index fea72163a..81bf252cf 100644
--- a/search.json
+++ b/search.json
@@ -277,7 +277,7 @@
     "href": "python/examples.html",
     "title": "Examples",
     "section": "",
-    "text": "1 Basic model with static forcing\n\nfrom pathlib import Path\n\nimport geopandas as gpd\nimport matplotlib.pyplot as plt\nimport numpy as np\nimport pandas as pd\nimport ribasim\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\n        \"node_id\": [1, 1, 3, 3, 6, 6, 9, 9],\n        \"area\": [0.01, 1000.0] * 4,\n        \"level\": [0.0, 1.0] * 4,\n    }\n)\n\n# Convert steady forcing to m/s\n# 2 mm/d precipitation, 1 mm/d evaporation\nseconds_in_day = 24 * 3600\nprecipitation = 0.002 / seconds_in_day\nevaporation = 0.001 / seconds_in_day\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [0],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [evaporation],\n        \"infiltration\": [0.0],\n        \"precipitation\": [precipitation],\n        \"urban_runoff\": [0.0],\n    }\n)\nstatic = static.iloc[[0, 0, 0, 0]]\nstatic[\"node_id\"] = [1, 3, 6, 9]\n\nbasin = ribasim.Basin(profile=profile, static=static)\n\nSetup linear resistance:\n\nlinear_resistance = ribasim.LinearResistance(\n    static=pd.DataFrame(\n        data={\"node_id\": [10, 12], \"resistance\": [5e3, (3600.0 * 24) / 100.0]}\n    )\n)\n\nSetup Manning resistance:\n\nmanning_resistance = ribasim.ManningResistance(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [2],\n            \"length\": [900.0],\n            \"manning_n\": [0.04],\n            \"profile_width\": [6.0],\n            \"profile_slope\": [3.0],\n        }\n    )\n)\n\nSet up a rating curve node:\n\n# Discharge: lose 1% of storage volume per day at storage = 1000.0.\nq1000 = 1000.0 * 0.01 / seconds_in_day\n\nrating_curve = ribasim.TabulatedRatingCurve(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [4, 4],\n            \"level\": [0.0, 1.0],\n            \"discharge\": [0.0, q1000],\n        }\n    )\n)\n\nSetup fractional flows:\n\nfractional_flow = ribasim.FractionalFlow(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [5, 8, 13],\n            \"fraction\": [0.3, 0.6, 0.1],\n        }\n    )\n)\n\nSetup pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [7],\n            \"flow_rate\": [0.5 / 3600],\n        }\n    )\n)\n\nSetup level boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [11, 17],\n            \"level\": [0.5, 1.5],\n        }\n    )\n)\n\nSetup flow boundary:\n\nflow_boundary = ribasim.FlowBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [15, 16],\n            \"flow_rate\": [1e-4, 1e-4],\n        }\n    )\n)\n\nSetup terminal:\n\nterminal = ribasim.Terminal(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [14],\n        }\n    )\n)\n\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: Basin,\n        (1.0, 0.0),  # 2: ManningResistance\n        (2.0, 0.0),  # 3: Basin\n        (3.0, 0.0),  # 4: TabulatedRatingCurve\n        (3.0, 1.0),  # 5: FractionalFlow\n        (3.0, 2.0),  # 6: Basin\n        (4.0, 1.0),  # 7: Pump\n        (4.0, 0.0),  # 8: FractionalFlow\n        (5.0, 0.0),  # 9: Basin\n        (6.0, 0.0),  # 10: LinearResistance\n        (2.0, 2.0),  # 11: LevelBoundary\n        (2.0, 1.0),  # 12: LinearResistance\n        (3.0, -1.0),  # 13: FractionalFlow\n        (3.0, -2.0),  # 14: Terminal\n        (3.0, 3.0),  # 15: FlowBoundary\n        (0.0, 1.0),  # 16: FlowBoundary\n        (6.0, 1.0),  # 17: LevelBoundary\n    ]\n)\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_id, node_type = ribasim.Node.get_node_ids_and_types(\n    basin,\n    manning_resistance,\n    rating_curve,\n    pump,\n    fractional_flow,\n    linear_resistance,\n    level_boundary,\n    flow_boundary,\n    terminal,\n)\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(node_id, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array(\n    [1, 2, 3, 4, 4, 5, 6, 8, 7, 9, 11, 12, 4, 13, 15, 16, 10], dtype=np.int64\n)\nto_id = np.array(\n    [2, 3, 4, 5, 8, 6, 7, 9, 9, 10, 12, 3, 13, 14, 6, 1, 17], dtype=np.int64\n)\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\n            \"from_node_id\": from_id,\n            \"to_node_id\": to_id,\n            \"edge_type\": len(from_id) * [\"flow\"],\n        },\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    level_boundary=level_boundary,\n    flow_boundary=flow_boundary,\n    pump=pump,\n    linear_resistance=linear_resistance,\n    manning_resistance=manning_resistance,\n    tabulated_rating_curve=rating_curve,\n    fractional_flow=fractional_flow,\n    terminal=terminal,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2021-01-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nWrite the model to a TOML and GeoPackage:\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"basic\")\n\n\n\n2 Update the basic model with transient forcing\nThis assumes you have already created the basic model with static forcing.\n\nimport numpy as np\nimport pandas as pd\nimport ribasim\nimport xarray as xr\n\n\nmodel = ribasim.Model.from_toml(datadir / \"basic/ribasim.toml\")\n\n\ntime = pd.date_range(model.starttime, model.endtime)\nday_of_year = time.day_of_year.to_numpy()\nseconds_per_day = 24 * 60 * 60\nevaporation = (\n    (-1.0 * np.cos(day_of_year / 365.0 * 2 * np.pi) + 1.0) * 0.0025 / seconds_per_day\n)\nrng = np.random.default_rng(seed=0)\nprecipitation = (\n    rng.lognormal(mean=-1.0, sigma=1.7, size=time.size) * 0.001 / seconds_per_day\n)\n\nWe’ll use xarray to easily broadcast the values.\n\ntimeseries = (\n    pd.DataFrame(\n        data={\n            \"node_id\": 1,\n            \"time\": time,\n            \"drainage\": 0.0,\n            \"potential_evaporation\": evaporation,\n            \"infiltration\": 0.0,\n            \"precipitation\": precipitation,\n            \"urban_runoff\": 0.0,\n        }\n    )\n    .set_index(\"time\")\n    .to_xarray()\n)\n\nbasin_ids = model.basin.static[\"node_id\"].to_numpy()\nbasin_nodes = xr.DataArray(\n    np.ones(len(basin_ids)), coords={\"node_id\": basin_ids}, dims=[\"node_id\"]\n)\nforcing = (timeseries * basin_nodes).to_dataframe().reset_index()\n\n\nstate = pd.DataFrame(\n    data={\n        \"node_id\": basin_ids,\n        \"level\": 1.4,\n        \"concentration\": 0.0,\n    }\n)\n\n\nmodel.basin.time = forcing\nmodel.basin.state = state\n\n\nmodel.write(datadir / \"basic_transient\")\n\nNow run the model with ribasim basic-transient/ribasim.toml. After running the model, read back the results:\n\ndf_basin = pd.read_feather(datadir / \"basic_transient/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\ndf_basin_wide[\"level\"].plot()\n\n&lt;Axes: xlabel='time'&gt;\n\n\n\n\n\n\ndf_flow = pd.read_feather(datadir / \"basic_transient/results/flow.arrow\")\ndf_flow[\"edge\"] = list(zip(df_flow.from_node_id, df_flow.to_node_id))\ndf_flow[\"flow_m3d\"] = df_flow.flow * 86400\nax = df_flow.pivot_table(index=\"time\", columns=\"edge\", values=\"flow_m3d\").plot()\nax.legend(bbox_to_anchor=(1.3, 1), title=\"Edge\")\n\n&lt;matplotlib.legend.Legend at 0x7f601751f200&gt;\n\n\n\n\n\n\ntype(df_flow)\n\npandas.core.frame.DataFrame\n\n\n\n\n3 Model with discrete control\nThe model constructed below consists of a single basin which slowly drains trough a TabulatedRatingCurve, but is held within a range around a target level (setpoint) by two connected pumps. These two pumps behave like a reversible pump. When pumping can be done in only one direction, and the other direction is only possible under gravity, use an Outlet for that direction.\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: Basin\n        (1.0, 1.0),  # 2: Pump\n        (1.0, -1.0),  # 3: Pump\n        (2.0, 0.0),  # 4: LevelBoundary\n        (-1.0, 0.0),  # 5: TabulatedRatingCurve\n        (-2.0, 0.0),  # 6: Terminal\n        (1.0, 0.0),  # 7: DiscreteControl\n    ]\n)\n\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_type = [\n    \"Basin\",\n    \"Pump\",\n    \"Pump\",\n    \"LevelBoundary\",\n    \"TabulatedRatingCurve\",\n    \"Terminal\",\n    \"DiscreteControl\",\n]\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(np.arange(len(xy)) + 1, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array([1, 3, 4, 2, 1, 5, 7, 7], dtype=np.int64)\nto_id = np.array([3, 4, 2, 1, 5, 6, 2, 3], dtype=np.int64)\n\nedge_type = 6 * [\"flow\"] + 2 * [\"control\"]\n\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\"from_node_id\": from_id, \"to_node_id\": to_id, \"edge_type\": edge_type},\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\n        \"node_id\": [1, 1],\n        \"area\": [1000.0, 1000.0],\n        \"level\": [0.0, 1.0],\n    }\n)\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [1],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [0.0],\n        \"infiltration\": [0.0],\n        \"precipitation\": [0.0],\n        \"urban_runoff\": [0.0],\n    }\n)\n\nstate = pd.DataFrame(data={\"node_id\": [1], \"level\": [20.0]})\n\nbasin = ribasim.Basin(profile=profile, static=static, state=state)\n\nSetup the discrete control:\n\ncondition = pd.DataFrame(\n    data={\n        \"node_id\": 3 * [7],\n        \"listen_feature_id\": 3 * [1],\n        \"variable\": 3 * [\"level\"],\n        \"greater_than\": [5.0, 10.0, 15.0],  # min, setpoint, max\n    }\n)\n\nlogic = pd.DataFrame(\n    data={\n        \"node_id\": 5 * [7],\n        \"truth_state\": [\"FFF\", \"U**\", \"T*F\", \"**D\", \"TTT\"],\n        \"control_state\": [\"in\", \"in\", \"none\", \"out\", \"out\"],\n    }\n)\n\ndiscrete_control = ribasim.DiscreteControl(condition=condition, logic=logic)\n\nThe above control logic can be summarized as follows: - If the level gets above the maximum, activate the control state “out” until the setpoint is reached; - If the level gets below the minimum, active the control state “in” until the setpoint is reached; - Otherwise activate the control state “none”.\nSetup the pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": 3 * [2] + 3 * [3],\n            \"control_state\": 2 * [\"none\", \"in\", \"out\"],\n            \"flow_rate\": [0.0, 2e-3, 0.0, 0.0, 0.0, 2e-3],\n        }\n    )\n)\n\nThe pump data defines the following:\n\n\n\nControl state\nPump #2 flow rate (m/s)\nPump #3 flow rate (m/s)\n\n\n\n\n“none”\n0.0\n0.0\n\n\n“in”\n2e-3\n0.0\n\n\n“out”\n0.0\n2e-3\n\n\n\nSetup the level boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(data={\"node_id\": [4], \"level\": [10.0]})\n)\n\nSetup the rating curve:\n\nrating_curve = ribasim.TabulatedRatingCurve(\n    static=pd.DataFrame(\n        data={\"node_id\": 2 * [5], \"level\": [2.0, 15.0], \"discharge\": [0.0, 1e-3]}\n    )\n)\n\nSetup the terminal:\n\nterminal = ribasim.Terminal(static=pd.DataFrame(data={\"node_id\": [6]}))\n\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    pump=pump,\n    level_boundary=level_boundary,\n    tabulated_rating_curve=rating_curve,\n    terminal=terminal,\n    discrete_control=discrete_control,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2021-01-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nListen edges are plotted with a dashed line since they are not present in the “Edge / static” schema but only in the “Control / condition” schema.\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"level_setpoint_with_minmax\")\n\nNow run the model with level_setpoint_with_minmax/ribasim.toml. After running the model, read back the results:\n\nfrom matplotlib.dates import date2num\n\ndf_basin = pd.read_feather(datadir / \"level_setpoint_with_minmax/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\n\nax = df_basin_wide[\"level\"].plot()\n\ngreater_than = model.discrete_control.condition.greater_than\n\nax.hlines(\n    greater_than,\n    df_basin.time[0],\n    df_basin.time.max(),\n    lw=1,\n    ls=\"--\",\n    color=\"k\",\n)\n\ndf_control = pd.read_feather(\n    datadir / \"level_setpoint_with_minmax/results/control.arrow\"\n)\n\ny_min, y_max = ax.get_ybound()\nax.fill_between(df_control.time[:2], 2 * [y_min], 2 * [y_max], alpha=0.2, color=\"C0\")\nax.fill_between(df_control.time[2:4], 2 * [y_min], 2 * [y_max], alpha=0.2, color=\"C0\")\n\nax.set_xticks(\n    date2num(df_control.time).tolist(),\n    df_control.control_state.tolist(),\n    rotation=50,\n)\n\nax.set_yticks(greater_than, [\"min\", \"setpoint\", \"max\"])\nax.set_ylabel(\"level\")\nplt.show()\n\n\n\n\nThe highlighted regions show where a pump is active.\nLet’s print an overview of what happened with control:\n\nmodel.print_discrete_control_record(\n    datadir / \"level_setpoint_with_minmax/results/control.arrow\"\n)\n\n0. At 2020-01-01 00:00:00 the control node with ID 7 reached truth state TTT:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &gt; 10.0\n    For node ID 1 (Basin): level &gt; 15.0\n\n   This yielded control state \"out\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.002\n\n1. At 2020-02-08 19:02:21.861000 the control node with ID 7 reached truth state TFF:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &lt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"none\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.0\n\n2. At 2020-07-05 08:56:10.319000 the control node with ID 7 reached truth state FFF:\n    For node ID 1 (Basin): level &lt; 5.0\n    For node ID 1 (Basin): level &lt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"in\":\n    For node ID 2 (Pump): flow_rate = 0.002\n    For node ID 3 (Pump): flow_rate = 0.0\n\n3. At 2020-08-11 06:05:15.592000 the control node with ID 7 reached truth state TTF:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &gt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"none\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.0\n\n\n\nNote that crossing direction specific truth states (containing “U”, “D”) are not present in this overview even though they are part of the control logic. This is because in the control logic for this model these truth states are only used to sustain control states, while the overview only shows changes in control states.\n\n\n4 Model with PID control\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: FlowBoundary\n        (1.0, 0.0),  # 2: Basin\n        (2.0, 0.5),  # 3: Pump\n        (3.0, 0.0),  # 4: LevelBoundary\n        (1.5, 1.0),  # 5: PidControl\n        (2.0, -0.5),  # 6: outlet\n        (1.5, -1.0),  # 7: PidControl\n    ]\n)\n\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_type = [\n    \"FlowBoundary\",\n    \"Basin\",\n    \"Pump\",\n    \"LevelBoundary\",\n    \"PidControl\",\n    \"Outlet\",\n    \"PidControl\",\n]\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(np.arange(len(xy)) + 1, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array([1, 2, 3, 4, 6, 5, 7], dtype=np.int64)\nto_id = np.array([2, 3, 4, 6, 2, 3, 6], dtype=np.int64)\n\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\n            \"from_node_id\": from_id,\n            \"to_node_id\": to_id,\n            \"edge_type\": 5 * [\"flow\"] + 2 * [\"control\"],\n        },\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\"node_id\": [2, 2], \"level\": [0.0, 1.0], \"area\": [1000.0, 1000.0]}\n)\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [2],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [0.0],\n        \"infiltration\": [0.0],\n        \"precipitation\": [0.0],\n        \"urban_runoff\": [0.0],\n    }\n)\n\nstate = pd.DataFrame(\n    data={\n        \"node_id\": [2],\n        \"level\": [6.0],\n    }\n)\n\nbasin = ribasim.Basin(profile=profile, static=static, state=state)\n\nSetup the pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [3],\n            \"flow_rate\": [0.0],  # Will be overwritten by PID controller\n        }\n    )\n)\n\nSetup the outlet:\n\noutlet = ribasim.Outlet(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [6],\n            \"flow_rate\": [0.0],  # Will be overwritten by PID controller\n        }\n    )\n)\n\nSetup flow boundary:\n\nflow_boundary = ribasim.FlowBoundary(\n    static=pd.DataFrame(data={\"node_id\": [1], \"flow_rate\": [1e-3]})\n)\n\nSetup flow boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [4],\n            \"level\": [1.0],  # Not relevant\n        }\n    )\n)\n\nSetup PID control:\n\npid_control = ribasim.PidControl(\n    time=pd.DataFrame(\n        data={\n            \"node_id\": 4 * [5, 7],\n            \"time\": [\n                \"2020-01-01 00:00:00\",\n                \"2020-01-01 00:00:00\",\n                \"2020-05-01 00:00:00\",\n                \"2020-05-01 00:00:00\",\n                \"2020-07-01 00:00:00\",\n                \"2020-07-01 00:00:00\",\n                \"2020-12-01 00:00:00\",\n                \"2020-12-01 00:00:00\",\n            ],\n            \"listen_node_id\": 4 * [2, 2],\n            \"target\": [5.0, 5.0, 5.0, 5.0, 7.5, 7.5, 7.5, 7.5],\n            \"proportional\": 4 * [-1e-3, 1e-3],\n            \"integral\": 4 * [-1e-7, 1e-7],\n            \"derivative\": 4 * [0.0, 0.0],\n        }\n    )\n)\n\nNote that the coefficients for the pump and the outlet are equal in magnitude but opposite in sign. This way the pump and the outlet equally work towards the same goal, while having opposite effects on the controlled basin due to their connectivity to this basin.\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    flow_boundary=flow_boundary,\n    level_boundary=level_boundary,\n    pump=pump,\n    outlet=outlet,\n    pid_control=pid_control,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2020-12-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nWrite the model to a TOML and GeoPackage:\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"pid_control\")\n\nNow run the model with ribasim pid_control/ribasim.toml. After running the model, read back the results:\n\nfrom matplotlib.dates import date2num\n\ndf_basin = pd.read_feather(datadir / \"pid_control/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\nax = df_basin_wide[\"level\"].plot()\nax.set_ylabel(\"level [m]\")\n\n# Plot target level\ntarget_levels = model.pid_control.time.target.to_numpy()[::2]\ntimes = date2num(model.pid_control.time.time)[::2]\nax.plot(times, target_levels, color=\"k\", ls=\":\", label=\"target level\")\npass"
+    "text": "1 Basic model with static forcing\n\nfrom pathlib import Path\n\nimport geopandas as gpd\nimport matplotlib.pyplot as plt\nimport numpy as np\nimport pandas as pd\nimport ribasim\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\n        \"node_id\": [1, 1, 3, 3, 6, 6, 9, 9],\n        \"area\": [0.01, 1000.0] * 4,\n        \"level\": [0.0, 1.0] * 4,\n    }\n)\n\n# Convert steady forcing to m/s\n# 2 mm/d precipitation, 1 mm/d evaporation\nseconds_in_day = 24 * 3600\nprecipitation = 0.002 / seconds_in_day\nevaporation = 0.001 / seconds_in_day\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [0],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [evaporation],\n        \"infiltration\": [0.0],\n        \"precipitation\": [precipitation],\n        \"urban_runoff\": [0.0],\n    }\n)\nstatic = static.iloc[[0, 0, 0, 0]]\nstatic[\"node_id\"] = [1, 3, 6, 9]\n\nbasin = ribasim.Basin(profile=profile, static=static)\n\nSetup linear resistance:\n\nlinear_resistance = ribasim.LinearResistance(\n    static=pd.DataFrame(\n        data={\"node_id\": [10, 12], \"resistance\": [5e3, (3600.0 * 24) / 100.0]}\n    )\n)\n\nSetup Manning resistance:\n\nmanning_resistance = ribasim.ManningResistance(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [2],\n            \"length\": [900.0],\n            \"manning_n\": [0.04],\n            \"profile_width\": [6.0],\n            \"profile_slope\": [3.0],\n        }\n    )\n)\n\nSet up a rating curve node:\n\n# Discharge: lose 1% of storage volume per day at storage = 1000.0.\nq1000 = 1000.0 * 0.01 / seconds_in_day\n\nrating_curve = ribasim.TabulatedRatingCurve(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [4, 4],\n            \"level\": [0.0, 1.0],\n            \"discharge\": [0.0, q1000],\n        }\n    )\n)\n\nSetup fractional flows:\n\nfractional_flow = ribasim.FractionalFlow(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [5, 8, 13],\n            \"fraction\": [0.3, 0.6, 0.1],\n        }\n    )\n)\n\nSetup pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [7],\n            \"flow_rate\": [0.5 / 3600],\n        }\n    )\n)\n\nSetup level boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [11, 17],\n            \"level\": [0.5, 1.5],\n        }\n    )\n)\n\nSetup flow boundary:\n\nflow_boundary = ribasim.FlowBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [15, 16],\n            \"flow_rate\": [1e-4, 1e-4],\n        }\n    )\n)\n\nSetup terminal:\n\nterminal = ribasim.Terminal(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [14],\n        }\n    )\n)\n\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: Basin,\n        (1.0, 0.0),  # 2: ManningResistance\n        (2.0, 0.0),  # 3: Basin\n        (3.0, 0.0),  # 4: TabulatedRatingCurve\n        (3.0, 1.0),  # 5: FractionalFlow\n        (3.0, 2.0),  # 6: Basin\n        (4.0, 1.0),  # 7: Pump\n        (4.0, 0.0),  # 8: FractionalFlow\n        (5.0, 0.0),  # 9: Basin\n        (6.0, 0.0),  # 10: LinearResistance\n        (2.0, 2.0),  # 11: LevelBoundary\n        (2.0, 1.0),  # 12: LinearResistance\n        (3.0, -1.0),  # 13: FractionalFlow\n        (3.0, -2.0),  # 14: Terminal\n        (3.0, 3.0),  # 15: FlowBoundary\n        (0.0, 1.0),  # 16: FlowBoundary\n        (6.0, 1.0),  # 17: LevelBoundary\n    ]\n)\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_id, node_type = ribasim.Node.get_node_ids_and_types(\n    basin,\n    manning_resistance,\n    rating_curve,\n    pump,\n    fractional_flow,\n    linear_resistance,\n    level_boundary,\n    flow_boundary,\n    terminal,\n)\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(node_id, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array(\n    [1, 2, 3, 4, 4, 5, 6, 8, 7, 9, 11, 12, 4, 13, 15, 16, 10], dtype=np.int64\n)\nto_id = np.array(\n    [2, 3, 4, 5, 8, 6, 7, 9, 9, 10, 12, 3, 13, 14, 6, 1, 17], dtype=np.int64\n)\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\n            \"from_node_id\": from_id,\n            \"to_node_id\": to_id,\n            \"edge_type\": len(from_id) * [\"flow\"],\n        },\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    level_boundary=level_boundary,\n    flow_boundary=flow_boundary,\n    pump=pump,\n    linear_resistance=linear_resistance,\n    manning_resistance=manning_resistance,\n    tabulated_rating_curve=rating_curve,\n    fractional_flow=fractional_flow,\n    terminal=terminal,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2021-01-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nWrite the model to a TOML and GeoPackage:\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"basic\")\n\n\n\n2 Update the basic model with transient forcing\nThis assumes you have already created the basic model with static forcing.\n\nimport numpy as np\nimport pandas as pd\nimport ribasim\nimport xarray as xr\n\n\nmodel = ribasim.Model.from_toml(datadir / \"basic/ribasim.toml\")\n\n\ntime = pd.date_range(model.starttime, model.endtime)\nday_of_year = time.day_of_year.to_numpy()\nseconds_per_day = 24 * 60 * 60\nevaporation = (\n    (-1.0 * np.cos(day_of_year / 365.0 * 2 * np.pi) + 1.0) * 0.0025 / seconds_per_day\n)\nrng = np.random.default_rng(seed=0)\nprecipitation = (\n    rng.lognormal(mean=-1.0, sigma=1.7, size=time.size) * 0.001 / seconds_per_day\n)\n\nWe’ll use xarray to easily broadcast the values.\n\ntimeseries = (\n    pd.DataFrame(\n        data={\n            \"node_id\": 1,\n            \"time\": time,\n            \"drainage\": 0.0,\n            \"potential_evaporation\": evaporation,\n            \"infiltration\": 0.0,\n            \"precipitation\": precipitation,\n            \"urban_runoff\": 0.0,\n        }\n    )\n    .set_index(\"time\")\n    .to_xarray()\n)\n\nbasin_ids = model.basin.static[\"node_id\"].to_numpy()\nbasin_nodes = xr.DataArray(\n    np.ones(len(basin_ids)), coords={\"node_id\": basin_ids}, dims=[\"node_id\"]\n)\nforcing = (timeseries * basin_nodes).to_dataframe().reset_index()\n\n\nstate = pd.DataFrame(\n    data={\n        \"node_id\": basin_ids,\n        \"level\": 1.4,\n        \"concentration\": 0.0,\n    }\n)\n\n\nmodel.basin.time = forcing\nmodel.basin.state = state\n\n\nmodel.write(datadir / \"basic_transient\")\n\nNow run the model with ribasim basic-transient/ribasim.toml. After running the model, read back the results:\n\ndf_basin = pd.read_feather(datadir / \"basic_transient/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\ndf_basin_wide[\"level\"].plot()\n\n&lt;Axes: xlabel='time'&gt;\n\n\n\n\n\n\ndf_flow = pd.read_feather(datadir / \"basic_transient/results/flow.arrow\")\ndf_flow[\"edge\"] = list(zip(df_flow.from_node_id, df_flow.to_node_id))\ndf_flow[\"flow_m3d\"] = df_flow.flow * 86400\nax = df_flow.pivot_table(index=\"time\", columns=\"edge\", values=\"flow_m3d\").plot()\nax.legend(bbox_to_anchor=(1.3, 1), title=\"Edge\")\n\n&lt;matplotlib.legend.Legend at 0x7fd0bd1c4590&gt;\n\n\n\n\n\n\ntype(df_flow)\n\npandas.core.frame.DataFrame\n\n\n\n\n3 Model with discrete control\nThe model constructed below consists of a single basin which slowly drains trough a TabulatedRatingCurve, but is held within a range around a target level (setpoint) by two connected pumps. These two pumps behave like a reversible pump. When pumping can be done in only one direction, and the other direction is only possible under gravity, use an Outlet for that direction.\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: Basin\n        (1.0, 1.0),  # 2: Pump\n        (1.0, -1.0),  # 3: Pump\n        (2.0, 0.0),  # 4: LevelBoundary\n        (-1.0, 0.0),  # 5: TabulatedRatingCurve\n        (-2.0, 0.0),  # 6: Terminal\n        (1.0, 0.0),  # 7: DiscreteControl\n    ]\n)\n\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_type = [\n    \"Basin\",\n    \"Pump\",\n    \"Pump\",\n    \"LevelBoundary\",\n    \"TabulatedRatingCurve\",\n    \"Terminal\",\n    \"DiscreteControl\",\n]\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(np.arange(len(xy)) + 1, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array([1, 3, 4, 2, 1, 5, 7, 7], dtype=np.int64)\nto_id = np.array([3, 4, 2, 1, 5, 6, 2, 3], dtype=np.int64)\n\nedge_type = 6 * [\"flow\"] + 2 * [\"control\"]\n\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\"from_node_id\": from_id, \"to_node_id\": to_id, \"edge_type\": edge_type},\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\n        \"node_id\": [1, 1],\n        \"area\": [1000.0, 1000.0],\n        \"level\": [0.0, 1.0],\n    }\n)\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [1],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [0.0],\n        \"infiltration\": [0.0],\n        \"precipitation\": [0.0],\n        \"urban_runoff\": [0.0],\n    }\n)\n\nstate = pd.DataFrame(data={\"node_id\": [1], \"level\": [20.0]})\n\nbasin = ribasim.Basin(profile=profile, static=static, state=state)\n\nSetup the discrete control:\n\ncondition = pd.DataFrame(\n    data={\n        \"node_id\": 3 * [7],\n        \"listen_feature_id\": 3 * [1],\n        \"variable\": 3 * [\"level\"],\n        \"greater_than\": [5.0, 10.0, 15.0],  # min, setpoint, max\n    }\n)\n\nlogic = pd.DataFrame(\n    data={\n        \"node_id\": 5 * [7],\n        \"truth_state\": [\"FFF\", \"U**\", \"T*F\", \"**D\", \"TTT\"],\n        \"control_state\": [\"in\", \"in\", \"none\", \"out\", \"out\"],\n    }\n)\n\ndiscrete_control = ribasim.DiscreteControl(condition=condition, logic=logic)\n\nThe above control logic can be summarized as follows: - If the level gets above the maximum, activate the control state “out” until the setpoint is reached; - If the level gets below the minimum, active the control state “in” until the setpoint is reached; - Otherwise activate the control state “none”.\nSetup the pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": 3 * [2] + 3 * [3],\n            \"control_state\": 2 * [\"none\", \"in\", \"out\"],\n            \"flow_rate\": [0.0, 2e-3, 0.0, 0.0, 0.0, 2e-3],\n        }\n    )\n)\n\nThe pump data defines the following:\n\n\n\nControl state\nPump #2 flow rate (m/s)\nPump #3 flow rate (m/s)\n\n\n\n\n“none”\n0.0\n0.0\n\n\n“in”\n2e-3\n0.0\n\n\n“out”\n0.0\n2e-3\n\n\n\nSetup the level boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(data={\"node_id\": [4], \"level\": [10.0]})\n)\n\nSetup the rating curve:\n\nrating_curve = ribasim.TabulatedRatingCurve(\n    static=pd.DataFrame(\n        data={\"node_id\": 2 * [5], \"level\": [2.0, 15.0], \"discharge\": [0.0, 1e-3]}\n    )\n)\n\nSetup the terminal:\n\nterminal = ribasim.Terminal(static=pd.DataFrame(data={\"node_id\": [6]}))\n\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    pump=pump,\n    level_boundary=level_boundary,\n    tabulated_rating_curve=rating_curve,\n    terminal=terminal,\n    discrete_control=discrete_control,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2021-01-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nListen edges are plotted with a dashed line since they are not present in the “Edge / static” schema but only in the “Control / condition” schema.\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"level_setpoint_with_minmax\")\n\nNow run the model with level_setpoint_with_minmax/ribasim.toml. After running the model, read back the results:\n\nfrom matplotlib.dates import date2num\n\ndf_basin = pd.read_feather(datadir / \"level_setpoint_with_minmax/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\n\nax = df_basin_wide[\"level\"].plot()\n\ngreater_than = model.discrete_control.condition.greater_than\n\nax.hlines(\n    greater_than,\n    df_basin.time[0],\n    df_basin.time.max(),\n    lw=1,\n    ls=\"--\",\n    color=\"k\",\n)\n\ndf_control = pd.read_feather(\n    datadir / \"level_setpoint_with_minmax/results/control.arrow\"\n)\n\ny_min, y_max = ax.get_ybound()\nax.fill_between(df_control.time[:2], 2 * [y_min], 2 * [y_max], alpha=0.2, color=\"C0\")\nax.fill_between(df_control.time[2:4], 2 * [y_min], 2 * [y_max], alpha=0.2, color=\"C0\")\n\nax.set_xticks(\n    date2num(df_control.time).tolist(),\n    df_control.control_state.tolist(),\n    rotation=50,\n)\n\nax.set_yticks(greater_than, [\"min\", \"setpoint\", \"max\"])\nax.set_ylabel(\"level\")\nplt.show()\n\n\n\n\nThe highlighted regions show where a pump is active.\nLet’s print an overview of what happened with control:\n\nmodel.print_discrete_control_record(\n    datadir / \"level_setpoint_with_minmax/results/control.arrow\"\n)\n\n0. At 2020-01-01 00:00:00 the control node with ID 7 reached truth state TTT:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &gt; 10.0\n    For node ID 1 (Basin): level &gt; 15.0\n\n   This yielded control state \"out\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.002\n\n1. At 2020-02-08 19:02:21.861000 the control node with ID 7 reached truth state TFF:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &lt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"none\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.0\n\n2. At 2020-07-05 08:56:10.319000 the control node with ID 7 reached truth state FFF:\n    For node ID 1 (Basin): level &lt; 5.0\n    For node ID 1 (Basin): level &lt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"in\":\n    For node ID 2 (Pump): flow_rate = 0.002\n    For node ID 3 (Pump): flow_rate = 0.0\n\n3. At 2020-08-11 06:05:15.592000 the control node with ID 7 reached truth state TTF:\n    For node ID 1 (Basin): level &gt; 5.0\n    For node ID 1 (Basin): level &gt; 10.0\n    For node ID 1 (Basin): level &lt; 15.0\n\n   This yielded control state \"none\":\n    For node ID 2 (Pump): flow_rate = 0.0\n    For node ID 3 (Pump): flow_rate = 0.0\n\n\n\nNote that crossing direction specific truth states (containing “U”, “D”) are not present in this overview even though they are part of the control logic. This is because in the control logic for this model these truth states are only used to sustain control states, while the overview only shows changes in control states.\n\n\n4 Model with PID control\nSet up the nodes:\n\nxy = np.array(\n    [\n        (0.0, 0.0),  # 1: FlowBoundary\n        (1.0, 0.0),  # 2: Basin\n        (2.0, 0.5),  # 3: Pump\n        (3.0, 0.0),  # 4: LevelBoundary\n        (1.5, 1.0),  # 5: PidControl\n        (2.0, -0.5),  # 6: outlet\n        (1.5, -1.0),  # 7: PidControl\n    ]\n)\n\nnode_xy = gpd.points_from_xy(x=xy[:, 0], y=xy[:, 1])\n\nnode_type = [\n    \"FlowBoundary\",\n    \"Basin\",\n    \"Pump\",\n    \"LevelBoundary\",\n    \"PidControl\",\n    \"Outlet\",\n    \"PidControl\",\n]\n\n# Make sure the feature id starts at 1: explicitly give an index.\nnode = ribasim.Node(\n    static=gpd.GeoDataFrame(\n        data={\"type\": node_type},\n        index=pd.Index(np.arange(len(xy)) + 1, name=\"fid\"),\n        geometry=node_xy,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the edges:\n\nfrom_id = np.array([1, 2, 3, 4, 6, 5, 7], dtype=np.int64)\nto_id = np.array([2, 3, 4, 6, 2, 3, 6], dtype=np.int64)\n\nlines = ribasim.utils.geometry_from_connectivity(node, from_id, to_id)\nedge = ribasim.Edge(\n    static=gpd.GeoDataFrame(\n        data={\n            \"from_node_id\": from_id,\n            \"to_node_id\": to_id,\n            \"edge_type\": 5 * [\"flow\"] + 2 * [\"control\"],\n        },\n        geometry=lines,\n        crs=\"EPSG:28992\",\n    )\n)\n\nSetup the basins:\n\nprofile = pd.DataFrame(\n    data={\"node_id\": [2, 2], \"level\": [0.0, 1.0], \"area\": [1000.0, 1000.0]}\n)\n\nstatic = pd.DataFrame(\n    data={\n        \"node_id\": [2],\n        \"drainage\": [0.0],\n        \"potential_evaporation\": [0.0],\n        \"infiltration\": [0.0],\n        \"precipitation\": [0.0],\n        \"urban_runoff\": [0.0],\n    }\n)\n\nstate = pd.DataFrame(\n    data={\n        \"node_id\": [2],\n        \"level\": [6.0],\n    }\n)\n\nbasin = ribasim.Basin(profile=profile, static=static, state=state)\n\nSetup the pump:\n\npump = ribasim.Pump(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [3],\n            \"flow_rate\": [0.0],  # Will be overwritten by PID controller\n        }\n    )\n)\n\nSetup the outlet:\n\noutlet = ribasim.Outlet(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [6],\n            \"flow_rate\": [0.0],  # Will be overwritten by PID controller\n        }\n    )\n)\n\nSetup flow boundary:\n\nflow_boundary = ribasim.FlowBoundary(\n    static=pd.DataFrame(data={\"node_id\": [1], \"flow_rate\": [1e-3]})\n)\n\nSetup flow boundary:\n\nlevel_boundary = ribasim.LevelBoundary(\n    static=pd.DataFrame(\n        data={\n            \"node_id\": [4],\n            \"level\": [1.0],  # Not relevant\n        }\n    )\n)\n\nSetup PID control:\n\npid_control = ribasim.PidControl(\n    time=pd.DataFrame(\n        data={\n            \"node_id\": 4 * [5, 7],\n            \"time\": [\n                \"2020-01-01 00:00:00\",\n                \"2020-01-01 00:00:00\",\n                \"2020-05-01 00:00:00\",\n                \"2020-05-01 00:00:00\",\n                \"2020-07-01 00:00:00\",\n                \"2020-07-01 00:00:00\",\n                \"2020-12-01 00:00:00\",\n                \"2020-12-01 00:00:00\",\n            ],\n            \"listen_node_id\": 4 * [2, 2],\n            \"target\": [5.0, 5.0, 5.0, 5.0, 7.5, 7.5, 7.5, 7.5],\n            \"proportional\": 4 * [-1e-3, 1e-3],\n            \"integral\": 4 * [-1e-7, 1e-7],\n            \"derivative\": 4 * [0.0, 0.0],\n        }\n    )\n)\n\nNote that the coefficients for the pump and the outlet are equal in magnitude but opposite in sign. This way the pump and the outlet equally work towards the same goal, while having opposite effects on the controlled basin due to their connectivity to this basin.\nSetup a model:\n\nmodel = ribasim.Model(\n    node=node,\n    edge=edge,\n    basin=basin,\n    flow_boundary=flow_boundary,\n    level_boundary=level_boundary,\n    pump=pump,\n    outlet=outlet,\n    pid_control=pid_control,\n    starttime=\"2020-01-01 00:00:00\",\n    endtime=\"2020-12-01 00:00:00\",\n)\n\nLet’s take a look at the model:\n\nmodel.plot()\n\n&lt;Axes: &gt;\n\n\n\n\n\nWrite the model to a TOML and GeoPackage:\n\ndatadir = Path(\"data\")\nmodel.write(datadir / \"pid_control\")\n\nNow run the model with ribasim pid_control/ribasim.toml. After running the model, read back the results:\n\nfrom matplotlib.dates import date2num\n\ndf_basin = pd.read_feather(datadir / \"pid_control/results/basin.arrow\")\ndf_basin_wide = df_basin.pivot_table(\n    index=\"time\", columns=\"node_id\", values=[\"storage\", \"level\"]\n)\nax = df_basin_wide[\"level\"].plot()\nax.set_ylabel(\"level [m]\")\n\n# Plot target level\ntarget_levels = model.pid_control.time.target.to_numpy()[::2]\ntimes = date2num(model.pid_control.time.time)[::2]\nax.plot(times, target_levels, color=\"k\", ls=\":\", label=\"target level\")\npass"
   },
   {
     "objectID": "python/reference/utils.connectivity_from_geometry.html",
@@ -830,7 +830,7 @@
     "href": "core/equations.html#sec-reduction_factor",
     "title": "Equations",
     "section": "2.1 The reduction factor",
-    "text": "2.1 The reduction factor\nAt several points in the equations below a reduction factor is used. This is a term that makes certain transitions more smooth, for instance when a pump stops providing water when its source basin dries up. The reduction factor is given by\n\\[\\begin{align}\n    \\phi(x; p) =\n    \\begin{cases}\n    0 &\\text{if}\\quad x &lt; 0 \\\\\n        -2 \\left(\\frac{x}{p}\\right)^3 + 3\\left(\\frac{x}{p}\\right)^2 &\\text{if}\\quad 0 \\le x \\le p \\\\\n        1 &\\text{if}\\quad x &gt; p\n    \\end{cases}\n\\end{align}\\]\nHere \\(p &gt; 0\\) is the threshold value which determines the interval \\([0,p]\\) of the smooth transition between \\(0\\) and \\(1\\), see the plot below.\n\n\nCode\nimport numpy as np\nimport matplotlib.pyplot as plt\n\ndef f(x, p = 3):\n    x_scaled = x / p\n    phi = (-2 * x_scaled + 3) * x_scaled**2\n    phi = np.where(x &lt; 0, 0, phi)\n    phi = np.where(x &gt; p, 1, phi)\n\n    return phi\n\nfontsize = 15\np = 3\nN = 100\nx_min = -1\nx_max = 4\nx = np.linspace(x_min,x_max,N)\nphi = f(x,p)\n\nfig,ax = plt.subplots(dpi=80)\nax.plot(x,phi)\n\ny_lim = ax.get_ylim()\n\nax.set_xticks([0,p], [0,\"$p$\"], fontsize=fontsize)\nax.set_yticks([0,1], [0,1], fontsize=fontsize)\nax.hlines([0,1],x_min,x_max, color = \"k\", ls = \":\", zorder=-1)\nax.vlines([0,p], *y_lim, color = \"k\", ls = \":\")\nax.set_xlim(x_min,x_max)\nax.set_xlabel(\"$x$\", fontsize=fontsize)\nax.set_ylabel(\"$\\phi(x;p)$\", fontsize=fontsize)\nax.set_ylim(y_lim)\n\nfig.tight_layout()\nplt.show()\n\n\n&lt;&gt;:31: SyntaxWarning: invalid escape sequence '\\p'\n&lt;&gt;:31: SyntaxWarning: invalid escape sequence '\\p'\n/tmp/ipykernel_7197/665069857.py:31: SyntaxWarning: invalid escape sequence '\\p'\n  ax.set_ylabel(\"$\\phi(x;p)$\", fontsize=fontsize)"
+    "text": "2.1 The reduction factor\nAt several points in the equations below a reduction factor is used. This is a term that makes certain transitions more smooth, for instance when a pump stops providing water when its source basin dries up. The reduction factor is given by\n\\[\\begin{align}\n    \\phi(x; p) =\n    \\begin{cases}\n    0 &\\text{if}\\quad x &lt; 0 \\\\\n        -2 \\left(\\frac{x}{p}\\right)^3 + 3\\left(\\frac{x}{p}\\right)^2 &\\text{if}\\quad 0 \\le x \\le p \\\\\n        1 &\\text{if}\\quad x &gt; p\n    \\end{cases}\n\\end{align}\\]\nHere \\(p &gt; 0\\) is the threshold value which determines the interval \\([0,p]\\) of the smooth transition between \\(0\\) and \\(1\\), see the plot below.\n\n\nCode\nimport numpy as np\nimport matplotlib.pyplot as plt\n\ndef f(x, p = 3):\n    x_scaled = x / p\n    phi = (-2 * x_scaled + 3) * x_scaled**2\n    phi = np.where(x &lt; 0, 0, phi)\n    phi = np.where(x &gt; p, 1, phi)\n\n    return phi\n\nfontsize = 15\np = 3\nN = 100\nx_min = -1\nx_max = 4\nx = np.linspace(x_min,x_max,N)\nphi = f(x,p)\n\nfig,ax = plt.subplots(dpi=80)\nax.plot(x,phi)\n\ny_lim = ax.get_ylim()\n\nax.set_xticks([0,p], [0,\"$p$\"], fontsize=fontsize)\nax.set_yticks([0,1], [0,1], fontsize=fontsize)\nax.hlines([0,1],x_min,x_max, color = \"k\", ls = \":\", zorder=-1)\nax.vlines([0,p], *y_lim, color = \"k\", ls = \":\")\nax.set_xlim(x_min,x_max)\nax.set_xlabel(\"$x$\", fontsize=fontsize)\nax.set_ylabel(\"$\\phi(x;p)$\", fontsize=fontsize)\nax.set_ylim(y_lim)\n\nfig.tight_layout()\nplt.show()\n\n\n&lt;&gt;:31: SyntaxWarning: invalid escape sequence '\\p'\n&lt;&gt;:31: SyntaxWarning: invalid escape sequence '\\p'\n/tmp/ipykernel_5390/665069857.py:31: SyntaxWarning: invalid escape sequence '\\p'\n  ax.set_ylabel(\"$\\phi(x;p)$\", fontsize=fontsize)"
   },
   {
     "objectID": "core/equations.html#precipitation",