Code
using Ribasim
@@ -589,44 +589,44 @@ println(p.allocation.allocation_models[1].problem)
Min F_abs_user_demand[UserDemand #3] + F_abs_user_demand[UserDemand #13] + F_abs_user_demand[UserDemand #6] + F_abs_basin[Basin #12] + F_abs_basin[Basin #2] + F_abs_basin[Basin #5]
+Min F_abs_user_demand[UserDemand #6] + F_abs_user_demand[UserDemand #13] + F_abs_user_demand[UserDemand #3] + F_abs_basin[Basin #2] + F_abs_basin[Basin #12] + F_abs_basin[Basin #5]
Subject to
- flow_conservation[Basin #12] : F[(Basin #12, UserDemand #13)] - F[(TabulatedRatingCurve #7, Basin #12)] + F_basin_in[Basin #12] - F_basin_out[Basin #12] = 0
- flow_conservation[Basin #2] : F[(Basin #2, UserDemand #3)] - F[(Basin #5, Basin #2)] - F[(FlowBoundary #1, Basin #2)] + F[(Basin #2, Basin #5)] + F_basin_in[Basin #2] - F_basin_out[Basin #2] = 0
- flow_conservation[Basin #5] : F[(Basin #5, UserDemand #6)] + F[(Basin #5, Basin #2)] + F[(Basin #5, TabulatedRatingCurve #7)] - F[(Basin #2, Basin #5)] + F_basin_in[Basin #5] - F_basin_out[Basin #5] = 0
- abs_positive_user_demand[UserDemand #3] : -F[(Basin #2, UserDemand #3)] + F_abs_user_demand[UserDemand #3] ≥ -1.5
- abs_positive_user_demand[UserDemand #13] : -F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
+ flow_conservation[Basin #2] : F[(Basin #2, UserDemand #3)] - F[(FlowBoundary #1, Basin #2)] + F[(Basin #2, Basin #5)] - F[(Basin #5, Basin #2)] + F_basin_in[Basin #2] - F_basin_out[Basin #2] = 0
+ flow_conservation[Basin #12] : -F[(TabulatedRatingCurve #7, Basin #12)] + F[(Basin #12, UserDemand #13)] + F_basin_in[Basin #12] - F_basin_out[Basin #12] = 0
+ flow_conservation[Basin #5] : F[(Basin #5, UserDemand #6)] + F[(Basin #5, TabulatedRatingCurve #7)] - F[(Basin #2, Basin #5)] + F[(Basin #5, Basin #2)] + F_basin_in[Basin #5] - F_basin_out[Basin #5] = 0
abs_positive_user_demand[UserDemand #6] : -F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ 0
- abs_negative_user_demand[UserDemand #3] : F[(Basin #2, UserDemand #3)] + F_abs_user_demand[UserDemand #3] ≥ 1.5
- abs_negative_user_demand[UserDemand #13] : F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
+ abs_positive_user_demand[UserDemand #13] : -F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
+ abs_positive_user_demand[UserDemand #3] : -F[(Basin #2, UserDemand #3)] + F_abs_user_demand[UserDemand #3] ≥ -1.5
abs_negative_user_demand[UserDemand #6] : F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ 0
- abs_positive_basin[Basin #12] : -F_basin_in[Basin #12] + F_abs_basin[Basin #12] ≥ 0
+ abs_negative_user_demand[UserDemand #13] : F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
+ abs_negative_user_demand[UserDemand #3] : F[(Basin #2, UserDemand #3)] + F_abs_user_demand[UserDemand #3] ≥ 1.5
abs_positive_basin[Basin #2] : -F_basin_in[Basin #2] + F_abs_basin[Basin #2] ≥ 0
+ abs_positive_basin[Basin #12] : -F_basin_in[Basin #12] + F_abs_basin[Basin #12] ≥ 0
abs_positive_basin[Basin #5] : -F_basin_in[Basin #5] + F_abs_basin[Basin #5] ≥ 0
- abs_negative_basin[Basin #12] : F_basin_in[Basin #12] + F_abs_basin[Basin #12] ≥ 0
abs_negative_basin[Basin #2] : F_basin_in[Basin #2] + F_abs_basin[Basin #2] ≥ 0
+ abs_negative_basin[Basin #12] : F_basin_in[Basin #12] + F_abs_basin[Basin #12] ≥ 0
abs_negative_basin[Basin #5] : F_basin_in[Basin #5] + F_abs_basin[Basin #5] ≥ 0
source[(FlowBoundary #1, Basin #2)] : F[(FlowBoundary #1, Basin #2)] ≤ 1
return_flow[UserDemand #13] : F[(UserDemand #13, Terminal #10)] ≤ 0
fractional_flow[(TabulatedRatingCurve #7, Basin #12)] : F[(TabulatedRatingCurve #7, Basin #12)] - 0.4 F[(Basin #5, TabulatedRatingCurve #7)] ≤ 0
- basin_outflow[Basin #12] : F_basin_out[Basin #12] ≤ 0
basin_outflow[Basin #2] : F_basin_out[Basin #2] ≤ 0
+ basin_outflow[Basin #12] : F_basin_out[Basin #12] ≤ 0
basin_outflow[Basin #5] : F_basin_out[Basin #5] ≤ 0
F[(Basin #5, UserDemand #6)] ≥ 0
- F[(Basin #12, UserDemand #13)] ≥ 0
- F[(Basin #2, UserDemand #3)] ≥ 0
F[(TabulatedRatingCurve #7, Basin #12)] ≥ 0
+ F[(Basin #2, UserDemand #3)] ≥ 0
F[(UserDemand #13, Terminal #10)] ≥ 0
- F[(Basin #5, Basin #2)] ≥ 0
F[(TabulatedRatingCurve #7, Terminal #10)] ≥ 0
F[(Basin #5, TabulatedRatingCurve #7)] ≥ 0
F[(FlowBoundary #1, Basin #2)] ≥ 0
F[(Basin #2, Basin #5)] ≥ 0
- F_basin_in[Basin #12] ≥ 0
+ F[(Basin #5, Basin #2)] ≥ 0
+ F[(Basin #12, UserDemand #13)] ≥ 0
F_basin_in[Basin #2] ≥ 0
+ F_basin_in[Basin #12] ≥ 0
F_basin_in[Basin #5] ≥ 0
- F_basin_out[Basin #12] ≥ 0
F_basin_out[Basin #2] ≥ 0
+ F_basin_out[Basin #12] ≥ 0
F_basin_out[Basin #5] ≥ 0
Here \(p > 0\) is the threshold value which determines the interval \([0,p]\) of the smooth transition between \(0\) and \(1\), see the plot below.
-
+
Code
import numpy as np
diff --git a/core/validation.html b/core/validation.html
index 0f797e13c..12612d3ce 100644
--- a/core/validation.html
+++ b/core/validation.html
@@ -262,7 +262,7 @@ Validation
1 Connectivity
In the table below, each column shows which node types are allowed to be downstream (or ‘down-control’) of the node type at the top of the column.
-
+
Code
using Ribasim
@@ -546,7 +546,7 @@ 1 Connectivity
2 Neighbor amounts
The table below shows for each node type between which bounds the amount of in- and outneighbors must be, for both flow and control edges.
-
+
Code
= Vector{String}()
diff --git a/python/examples_files/figure-html/cell-59-output-1.png b/python/examples_files/figure-html/cell-59-output-1.png
index baad4bc0ba8284b7fd3a485ade56812b2b92e95c..1072244fe458fd0025ca42ad75877033ee995382 100644
GIT binary patch
literal 181864
zcmdqJXHZmI7X{cxOn?DY@>4-T1XOZX5D<`@vxsB~l2ZdFP!v#d&N)iX4T^w( flow_in_min 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
)JGP5Q&^1Rh9r=vy|&)
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
Here \(p > 0\) is the threshold value which determines the interval \([0,p]\) of the smooth transition between \(0\) and \(1\), see the plot below.
-Code
import numpy as np
diff --git a/core/validation.html b/core/validation.html
index 0f797e13c..12612d3ce 100644
--- a/core/validation.html
+++ b/core/validation.html
@@ -262,7 +262,7 @@ Validation
1 Connectivity
In the table below, each column shows which node types are allowed to be downstream (or ‘down-control’) of the node type at the top of the column.
-
+
Code
using Ribasim
@@ -546,7 +546,7 @@ 1 Connectivity
2 Neighbor amounts
The table below shows for each node type between which bounds the amount of in- and outneighbors must be, for both flow and control edges.
-
+
Code
= Vector{String}()
diff --git a/python/examples_files/figure-html/cell-59-output-1.png b/python/examples_files/figure-html/cell-59-output-1.png
index baad4bc0ba8284b7fd3a485ade56812b2b92e95c..1072244fe458fd0025ca42ad75877033ee995382 100644
GIT binary patch
literal 181864
zcmdqJXHZmI7X{cxOn?DY@>4-T1XOZX5D<`@vxsB~l2ZdFP!v#d&N)iX4T^w( flow_in_min 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
)JGP5Q&^1Rh9r=vy|&)
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