41 return 0.5 * end_pressure_gain;
53 double driving_pressure,
double end_pressure,
double gain,
double downstream_flow)
noexcept
55 return driving_pressure - end_pressure + gain * downstream_flow;
62 double driving_pressure,
double pressure_difference,
double end_pressure)
noexcept
64 return 2.0 * (driving_pressure - pressure_difference) - end_pressure;
83template <
typename FlowLaw>
84 requires std::invocable<FlowLaw&, double>
85 && std::convertible_to<std::invoke_result_t<FlowLaw&, double>,
FlowSample>
87 FlowLaw law,
double gain,
double target,
double lower,
double upper,
double guess,
90 const auto equation = [&](
double difference) ->
RootSample {
91 const auto [flow, slope] =
static_cast<FlowSample>(law(difference));
92 return { difference + gain * flow - target, 1.0 + gain * slope };
95 const auto [difference, status] =
bracketed_newton(equation, lower, upper, guess, options);
96 return { difference,
static_cast<FlowSample>(law(difference)).first, status };
Roots of scalar functions held inside a bracket.
constexpr double centred_end_pressure(double driving_pressure, double pressure_difference, double end_pressure) noexcept
Pressure of the end cell after the step, once the difference is solved.
constexpr double flow_coupling_target(double driving_pressure, double end_pressure, double gain, double downstream_flow) noexcept
Right side of the coupling equation.
constexpr double flow_coupling_gain(double end_pressure_gain) noexcept
Gain of a time centred coupling at an end cell.
std::tuple< double, double, RootStatus > solve_pressure_flow(FlowLaw law, double gain, double target, double lower, double upper, double guess, const RootOptions &options={})
Solve a coupling for any flow law.
std::pair< double, double > FlowSample
Flow through a coupling, then its slope against the pressure difference.
RootResult bracketed_newton(Function function, double lower, double upper, double guess, const RootOptions &options={})
Root of an increasing function by Newton steps kept inside a bracket.
std::pair< double, double > RootSample
Value and slope of a function at one point.
Stopping rule of a root search.