Code
using Ribasim
@@ -590,49 +590,49 @@ println(p.allocation.allocation_models[1].problem)
Min F_abs_user_demand[UserDemand #6] + F_abs_user_demand[UserDemand #13] + F_abs_user_demand[UserDemand #3] + F_abs_level_demand[Basin #5] + F_abs_level_demand[Basin #2] + F_abs_level_demand[Basin #12]
+Min F_abs_user_demand[UserDemand #3] + F_abs_user_demand[UserDemand #13] + F_abs_user_demand[UserDemand #6] + F_abs_level_demand[Basin #2] + F_abs_level_demand[Basin #12] + F_abs_level_demand[Basin #5]
Subject to
- abs_positive_user_demand[UserDemand #6] : -F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ 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] ≥ 0
- abs_negative_user_demand[UserDemand #6] : F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ 0
- 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 #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] ≥ 0
- abs_positive_basin[Basin #5] : -F_basin_in[Basin #5] + F_abs_level_demand[Basin #5] ≥ 0
+ abs_negative_user_demand[UserDemand #13] : F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
+ abs_negative_user_demand[UserDemand #6] : F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ 0
abs_positive_basin[Basin #2] : -F_basin_in[Basin #2] + F_abs_level_demand[Basin #2] ≥ 0
abs_positive_basin[Basin #12] : -F_basin_in[Basin #12] + F_abs_level_demand[Basin #12] ≥ 0
- abs_negative_basin[Basin #5] : F_basin_in[Basin #5] + F_abs_level_demand[Basin #5] ≥ 0
+ abs_positive_basin[Basin #5] : -F_basin_in[Basin #5] + F_abs_level_demand[Basin #5] ≥ 0
abs_negative_basin[Basin #2] : F_basin_in[Basin #2] + F_abs_level_demand[Basin #2] ≥ 0
abs_negative_basin[Basin #12] : F_basin_in[Basin #12] + F_abs_level_demand[Basin #12] ≥ 0
- F[(Basin #2, Basin #5)] ≥ 0
- F[(UserDemand #13, Terminal #10)] ≥ 0
- F[(UserDemand #6, Basin #5)] ≥ 0
- F[(FlowBoundary #1, Basin #2)] ≥ 0
- F[(Basin #2, UserDemand #3)] ≥ 0
- F[(TabulatedRatingCurve #7, Terminal #10)] ≥ 0
- F[(TabulatedRatingCurve #7, Basin #12)] ≥ 0
+ abs_negative_basin[Basin #5] : F_basin_in[Basin #5] + F_abs_level_demand[Basin #5] ≥ 0
F[(UserDemand #3, Basin #2)] ≥ 0
- F[(Basin #5, UserDemand #6)] ≥ 0
- F[(Basin #12, UserDemand #13)] ≥ 0
+ F[(TabulatedRatingCurve #7, Terminal #10)] ≥ 0
F[(Basin #5, TabulatedRatingCurve #7)] ≥ 0
F[(Basin #5, Basin #2)] ≥ 0
- F_basin_in[Basin #5] ≥ 0
+ F[(FlowBoundary #1, Basin #2)] ≥ 0
+ F[(Basin #5, UserDemand #6)] ≥ 0
+ F[(UserDemand #6, Basin #5)] ≥ 0
+ F[(Basin #12, UserDemand #13)] ≥ 0
+ F[(Basin #2, Basin #5)] ≥ 0
+ F[(TabulatedRatingCurve #7, Basin #12)] ≥ 0
+ F[(Basin #2, UserDemand #3)] ≥ 0
+ F[(UserDemand #13, Terminal #10)] ≥ 0
F_basin_in[Basin #2] ≥ 0
F_basin_in[Basin #12] ≥ 0
- F_basin_out[Basin #5] ≥ 0
+ F_basin_in[Basin #5] ≥ 0
F_basin_out[Basin #2] ≥ 0
F_basin_out[Basin #12] ≥ 0
+ F_basin_out[Basin #5] ≥ 0
source[(FlowBoundary #1, Basin #2)] : F[(FlowBoundary #1, Basin #2)] ≤ 1
- F[(UserDemand #6, Basin #5)] ≤ 0
- F[(UserDemand #13, Terminal #10)] ≤ 0
F[(UserDemand #3, Basin #2)] ≤ 0
- fractional_flow[(TabulatedRatingCurve #7, Basin #12)] : F[(TabulatedRatingCurve #7, Basin #12)] - 0.4 F[(Basin #5, TabulatedRatingCurve #7)] ≤ 0
- basin_outflow[Basin #5] : F_basin_out[Basin #5] ≤ 0
+ F[(UserDemand #13, Terminal #10)] ≤ 0
+ F[(UserDemand #6, Basin #5)] ≤ 0
+ fractional_flow[(TabulatedRatingCurve #7, Basin #12)] : -0.4 F[(Basin #5, TabulatedRatingCurve #7)] + F[(TabulatedRatingCurve #7, Basin #12)] ≤ 0
basin_outflow[Basin #2] : F_basin_out[Basin #2] ≤ 0
basin_outflow[Basin #12] : F_basin_out[Basin #12] ≤ 0
- flow_conservation_basin[Basin #5] : -F[(Basin #2, Basin #5)] - F[(UserDemand #6, Basin #5)] + F[(Basin #5, UserDemand #6)] + F[(Basin #5, TabulatedRatingCurve #7)] + F[(Basin #5, Basin #2)] + F_basin_in[Basin #5] - F_basin_out[Basin #5] = 0
- flow_conservation_basin[Basin #2] : F[(Basin #2, Basin #5)] - F[(FlowBoundary #1, Basin #2)] + F[(Basin #2, UserDemand #3)] - F[(UserDemand #3, Basin #2)] - F[(Basin #5, Basin #2)] + F_basin_in[Basin #2] - F_basin_out[Basin #2] = 0
- flow_conservation_basin[Basin #12] : -F[(TabulatedRatingCurve #7, Basin #12)] + F[(Basin #12, UserDemand #13)] + F_basin_in[Basin #12] - F_basin_out[Basin #12] = 0
+ basin_outflow[Basin #5] : F_basin_out[Basin #5] ≤ 0
+ flow_conservation_basin[Basin #2] : -F[(UserDemand #3, Basin #2)] - F[(Basin #5, Basin #2)] - F[(FlowBoundary #1, Basin #2)] + F[(Basin #2, Basin #5)] + F[(Basin #2, UserDemand #3)] + F_basin_in[Basin #2] - F_basin_out[Basin #2] = 0
+ flow_conservation_basin[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[Basin #5] : F[(Basin #5, TabulatedRatingCurve #7)] + F[(Basin #5, Basin #2)] + F[(Basin #5, UserDemand #6)] - F[(UserDemand #6, Basin #5)] - F[(Basin #2, Basin #5)] + F_basin_in[Basin #5] - 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
@@ -475,7 +475,7 @@
diff --git a/core/validation.html b/core/validation.html
index b0d68fd73..bff939113 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 a8716877a07078aeb32e3de1880b737b3eb7e373..9f7e6fea8a2550799022a9ea01ce0dcdb9632493 100644
GIT binary patch
literal 155749
zcmeFZbySsY*Dbzn1%U@86ckiI8kBAn1f;u5LAtxc08|7N3F+>XZbYOdB&AV=O?OCa
zIO`Uk=X>Apd(Us2|9)efaTq!T+53*`T5GO3=UVrEB_|_>gGGXcLZNWPA3jh(q0Zu?
zP^W^ flow_in_min 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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
@@ -475,7 +475,7 @@
diff --git a/core/validation.html b/core/validation.html
index b0d68fd73..bff939113 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 a8716877a07078aeb32e3de1880b737b3eb7e373..9f7e6fea8a2550799022a9ea01ce0dcdb9632493 100644
GIT binary patch
literal 155749
zcmeFZbySsY*Dbzn1%U@86ckiI8kBAn1f;u5LAtxc08|7N3F+>XZbYOdB&AV=O?OCa
zIO`Uk=X>Apd(Us2|9)efaTq!T+53*`T5GO3=UVrEB_|_>gGGXcLZNWPA3jh(q0Zu?
zP^W^ flow_in_min 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