Code
using Ribasim
@@ -648,45 +648,45 @@ 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_basin[Basin #5] + F_abs_basin[Basin #12] + F_abs_basin[Basin #2]
+Min F_abs_user_demand[UserDemand #6] + F_abs_user_demand[UserDemand #3] + F_abs_user_demand[UserDemand #13] + F_abs_basin[Basin #5] + F_abs_basin[Basin #2] + F_abs_basin[Basin #12]
Subject to
- flow_conservation[Basin #5] : F[(Basin #5, UserDemand #6)] - F[(Basin #2, Basin #5)] + F[(Basin #5, Basin #2)] + F[(Basin #5, TabulatedRatingCurve #7)] + F_basin_in[Basin #5] - F_basin_out[Basin #5] = 0
+ flow_conservation[Basin #5] : -F[(Basin #2, Basin #5)] + F[(Basin #5, TabulatedRatingCurve #7)] + F[(Basin #5, UserDemand #6)] + F[(Basin #5, Basin #2)] + F_basin_in[Basin #5] - F_basin_out[Basin #5] = 0
+ flow_conservation[Basin #2] : F[(Basin #2, Basin #5)] + F[(Basin #2, UserDemand #3)] - F[(Basin #5, Basin #2)] - F[(FlowBoundary #1, 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 #2] : F[(Basin #2, Basin #5)] - F[(Basin #5, Basin #2)] + F[(Basin #2, UserDemand #3)] - F[(FlowBoundary #1, Basin #2)] + F_basin_in[Basin #2] - F_basin_out[Basin #2] = 0
abs_positive_user_demand[UserDemand #6] : -F[(Basin #5, UserDemand #6)] + F_abs_user_demand[UserDemand #6] ≥ -1.5
- 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_positive_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] ≥ 1.5
- 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] ≥ 0
+ abs_negative_user_demand[UserDemand #13] : F[(Basin #12, UserDemand #13)] + F_abs_user_demand[UserDemand #13] ≥ 0
abs_positive_basin[Basin #5] : -F_basin_in[Basin #5] + F_abs_basin[Basin #5] ≥ 0
- abs_positive_basin[Basin #12] : -F_basin_in[Basin #12] + F_abs_basin[Basin #12] ≥ 0
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_negative_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
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 #5] : F_basin_out[Basin #5] ≤ 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
F[(TabulatedRatingCurve #7, Basin #12)] ≥ 0
- F[(Basin #5, UserDemand #6)] ≥ 0
F[(Basin #2, Basin #5)] ≥ 0
- F[(Basin #5, Basin #2)] ≥ 0
- F[(Basin #2, UserDemand #3)] ≥ 0
- F[(UserDemand #13, Terminal #10)] ≥ 0
F[(Basin #5, TabulatedRatingCurve #7)] ≥ 0
+ F[(Basin #12, UserDemand #13)] ≥ 0
+ F[(Basin #2, UserDemand #3)] ≥ 0
+ F[(Basin #5, UserDemand #6)] ≥ 0
F[(TabulatedRatingCurve #7, Terminal #10)] ≥ 0
+ F[(Basin #5, Basin #2)] ≥ 0
F[(FlowBoundary #1, Basin #2)] ≥ 0
- F[(Basin #12, UserDemand #13)] ≥ 0
+ F[(UserDemand #13, Terminal #10)] ≥ 0
F_basin_in[Basin #5] ≥ 0
- F_basin_in[Basin #12] ≥ 0
F_basin_in[Basin #2] ≥ 0
+ F_basin_in[Basin #12] ≥ 0
F_basin_out[Basin #5] ≥ 0
- F_basin_out[Basin #12] ≥ 0
F_basin_out[Basin #2] ≥ 0
+ F_basin_out[Basin #12] ≥ 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 c02d7e4f9..474d387c2 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-71-output-1.png b/python/examples_files/figure-html/cell-71-output-1.png
index 3ef67556a4b1daf5bd1e46703b82c70452f4ebdb..933e31732e59c8c4fbb04f446c5eac7e3da2d350 100644
GIT binary patch
literal 190242
zcmeFZXH-;ayDeI3t8Ic-K|uu!D1r(q3X*LRp%g)~WD_|`lx(*OiYN#ON|c-gBqsq|
zBnt=yB3UG7$r;Xk?QidW?iu&b9pnDG<2u@wZlP+ecRgV~bIzxpT$7R9wt3HH3Wc(b
zDs@qwLfNpLLRokB_YL?zgP&eG;|~EViR)GhX1Z3kH!XB1S8rOG8=F}f8{FD&qhn!d
zU}nn8eU6*=_ 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
diff --git a/core/validation.html b/core/validation.html
index c02d7e4f9..474d387c2 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-71-output-1.png b/python/examples_files/figure-html/cell-71-output-1.png
index 3ef67556a4b1daf5bd1e46703b82c70452f4ebdb..933e31732e59c8c4fbb04f446c5eac7e3da2d350 100644
GIT binary patch
literal 190242
zcmeFZXH-;ayDeI3t8Ic-K|uu!D1r(q3X*LRp%g)~WD_|`lx(*OiYN#ON|c-gBqsq|
zBnt=yB3UG7$r;Xk?QidW?iu&b9pnDG<2u@wZlP+ecRgV~bIzxpT$7R9wt3HH3Wc(b
zDs@qwLfNpLLRokB_YL?zgP&eG;|~EViR)GhX1Z3kH!XB1S8rOG8=F}f8{FD&qhn!d
zU}nn8eU6*=_ flow_in_min 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