/*
Copyright 2015 SINTEF ICT, Applied Mathematics.
This file is part of the Open Porous Media project (OPM).
OPM is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
OPM is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with OPM. If not, see .
*/
#ifndef OPM_BLACKOILMODELPARAMETERS_EBOS_HEADER_INCLUDED
#define OPM_BLACKOILMODELPARAMETERS_EBOS_HEADER_INCLUDED
#include
#include
#include
namespace Opm::Properties {
namespace TTag {
struct FlowModelParameters {};
}
template
struct EclDeckFileName {
using type = UndefinedProperty;
};
template
struct DbhpMaxRel {
using type = UndefinedProperty;
};
template
struct DwellFractionMax {
using type = UndefinedProperty;
};
template
struct MaxResidualAllowed {
using type = UndefinedProperty;
};
template
struct RelaxedMaxPvFraction {
using type = UndefinedProperty;
};
template
struct ToleranceMb {
using type = UndefinedProperty;
};
template
struct ToleranceCnv {
using type = UndefinedProperty;
};
template
struct ToleranceCnvRelaxed {
using type = UndefinedProperty;
};
template
struct ToleranceWells {
using type = UndefinedProperty;
};
template
struct ToleranceWellControl {
using type = UndefinedProperty;
};
template
struct MaxWelleqIter {
using type = UndefinedProperty;
};
template
struct UseMultisegmentWell {
using type = UndefinedProperty;
};
template
struct MaxSinglePrecisionDays {
using type = UndefinedProperty;
};
template
struct MinStrictCnvIter {
using type = UndefinedProperty;
};
template
struct SolveWelleqInitially {
using type = UndefinedProperty;
};
template
struct UpdateEquationsScaling {
using type = UndefinedProperty;
};
template
struct UseUpdateStabilization {
using type = UndefinedProperty;
};
template
struct MatrixAddWellContributions {
using type = UndefinedProperty;
};
template
struct EnableWellOperabilityCheck {
using type = UndefinedProperty;
};
template
struct EnableWellOperabilityCheckIter {
using type = UndefinedProperty;
};
// parameters for multisegment wells
template
struct TolerancePressureMsWells {
using type = UndefinedProperty;
};
template
struct MaxPressureChangeMsWells {
using type = UndefinedProperty;
};
template
struct MaxInnerIterMsWells {
using type = UndefinedProperty;
};
template
struct StrictInnerIterWells {
using type = UndefinedProperty;
};
template
struct RelaxedWellFlowTol {
using type = UndefinedProperty;
};
template
struct StrictOuterIterWells {
using type = UndefinedProperty;
};
template
struct RelaxedPressureTolMsw {
using type = UndefinedProperty;
};
template
struct RegularizationFactorWells {
using type = UndefinedProperty;
};
template
struct MaxNewtonIterationsWithInnerWellIterations {
using type = UndefinedProperty;
};
template
struct ShutUnsolvableWells {
using type = UndefinedProperty;
};
template
struct MaxInnerIterWells {
using type = UndefinedProperty;
};
template
struct AlternativeWellRateInit {
using type = UndefinedProperty;
};
template
struct MaximumNumberOfWellSwitches {
using type = UndefinedProperty;
};
template
struct DbhpMaxRel {
using type = GetPropType;
static constexpr type value = 1.0;
};
template
struct DwellFractionMax {
using type = GetPropType;
static constexpr type value = 0.2;
};
template
struct MaxResidualAllowed {
using type = GetPropType;
static constexpr type value = 1e7;
};
template
struct RelaxedMaxPvFraction {
using type = GetPropType;
static constexpr type value = 0.03;
};
template
struct ToleranceMb {
using type = GetPropType;
static constexpr type value = 1e-6;
};
template
struct ToleranceCnv {
using type = GetPropType;
static constexpr type value = 1e-2;
};
template
struct ToleranceCnvRelaxed {
using type = GetPropType;
static constexpr type value = 1;
};
template
struct ToleranceWells {
using type = GetPropType;
static constexpr type value = 1e-4;
};
template
struct ToleranceWellControl {
using type = GetPropType;
static constexpr type value = 1e-7;
};
template
struct MaxWelleqIter {
static constexpr int value = 30;
};
template
struct UseMultisegmentWell {
static constexpr bool value = true;
};
template
struct MaxSinglePrecisionDays {
using type = GetPropType;
static constexpr type value = 20.0;
};
template
struct MinStrictCnvIter {
static constexpr int value = 0;
};
template
struct SolveWelleqInitially {
static constexpr bool value = true;
};
template
struct UpdateEquationsScaling {
static constexpr bool value = false;
};
template
struct UseUpdateStabilization {
static constexpr bool value = true;
};
template
struct MatrixAddWellContributions {
static constexpr bool value = false;
};
template
struct TolerancePressureMsWells {
using type = GetPropType;
static constexpr type value = 0.01*1e5;
};
template
struct MaxPressureChangeMsWells {
using type = GetPropType;
static constexpr type value = 10*1e5;
};
template
struct MaxNewtonIterationsWithInnerWellIterations {
static constexpr int value = 8;
};
template
struct MaxInnerIterMsWells {
static constexpr int value = 100;
};
template
struct MaxInnerIterWells {
static constexpr int value = 50;
};
template
struct ShutUnsolvableWells {
static constexpr bool value = true;
};
template
struct AlternativeWellRateInit {
static constexpr bool value = true;
};
template
struct StrictOuterIterWells {
static constexpr int value = 6;
};
template
struct StrictInnerIterWells {
static constexpr int value = 40;
};
template
struct RegularizationFactorWells {
using type = GetPropType;
static constexpr type value = 100;
};
template
struct EnableWellOperabilityCheck {
static constexpr bool value = true;
};
template
struct EnableWellOperabilityCheckIter {
static constexpr bool value = false;
};
template
struct RelaxedWellFlowTol {
using type = GetPropType;
static constexpr type value = 1e-3;
};
template
struct RelaxedPressureTolMsw {
using type = GetPropType;
static constexpr type value = 1.0e4;
};
template
struct MaximumNumberOfWellSwitches {
static constexpr int value = 3;
};
// if openMP is available, determine the number threads per process automatically.
#if _OPENMP
template
struct ThreadsPerProcess {
static constexpr int value = -1;
};
#endif
} // namespace Opm::Properties
namespace Opm
{
/// Solver parameters for the BlackoilModel.
template
struct BlackoilModelParametersEbos
{
private:
using Scalar = GetPropType;
public:
/// Max relative change in bhp in single iteration.
double dbhp_max_rel_;
/// Max absolute change in well volume fraction in single iteration.
double dwell_fraction_max_;
/// Absolute max limit for residuals.
double max_residual_allowed_;
//// Max allowed pore volume faction where CNV is violated. Below the
//// relaxed tolerance tolerance_cnv_relaxed_ is used.
double relaxed_max_pv_fraction_;
/// Relative mass balance tolerance (total mass balance error).
double tolerance_mb_;
/// Local convergence tolerance (max of local saturation errors).
double tolerance_cnv_;
/// Relaxed local convergence tolerance (can be used when iter >= min_strict_cnv_iter_ && cnvViolatedPV < relaxed_max_pv_fraction_).
double tolerance_cnv_relaxed_;
/// Well convergence tolerance.
double tolerance_wells_;
/// Tolerance for the well control equations
// TODO: it might need to distinguish between rate control and pressure control later
double tolerance_well_control_;
/// Tolerance for the pressure equations for multisegment wells
double tolerance_pressure_ms_wells_;
/// Relaxed tolerance for for the well flow residual
double relaxed_tolerance_flow_well_;
/// Relaxed tolerance for the MSW pressure solution
double relaxed_tolerance_pressure_ms_well_;
/// Maximum pressure change over an iteratio for ms wells
double max_pressure_change_ms_wells_;
/// Maximum inner iteration number for ms wells
int max_inner_iter_ms_wells_;
/// Strict inner iteration number for wells
int strict_inner_iter_wells_;
/// Newton iteration where wells are stricly convergent
int strict_outer_iter_wells_;
/// Regularization factor for wells
int regularization_factor_wells_;
/// Maximum newton iterations with inner well iterations
int max_niter_inner_well_iter_;
/// Whether to shut unsolvable well
bool shut_unsolvable_wells_;
/// Maximum inner iteration number for standard wells
int max_inner_iter_wells_;
/// Maximum iteration number of the well equation solution
int max_welleq_iter_;
/// Tolerance for time step in seconds where single precision can be used
/// for solving for the Jacobian
double maxSinglePrecisionTimeStep_;
/// Minimum number of Newton iterations before we can use relaxed CNV convergence criterion
int min_strict_cnv_iter_;
/// Solve well equation initially
bool solve_welleq_initially_;
/// Update scaling factors for mass balance equations
bool update_equations_scaling_;
/// Try to detect oscillation or stagnation.
bool use_update_stabilization_;
/// Whether to use MultisegmentWell to handle multisegment wells
/// it is something temporary before the multisegment well model is considered to be
/// well developed and tested.
/// if it is false, we will handle multisegment wells as standard wells, which will be
/// the default behavoir for the moment. Later, we might set it to be true by default if necessary
bool use_multisegment_well_;
/// The file name of the deck
std::string deck_file_name_;
/// Whether to add influences of wells between cells to the matrix and preconditioner matrix
bool matrix_add_well_contributions_;
/// Whether to check well operability
bool check_well_operability_;
/// Whether to check well operability during iterations
bool check_well_operability_iter_;
/// Maximum number of times a well can switch to the same controt
int max_number_of_well_switches_;
/// Construct from user parameters or defaults.
BlackoilModelParametersEbos()
{
dbhp_max_rel_= EWOMS_GET_PARAM(TypeTag, Scalar, DbhpMaxRel);
dwell_fraction_max_ = EWOMS_GET_PARAM(TypeTag, Scalar, DwellFractionMax);
max_residual_allowed_ = EWOMS_GET_PARAM(TypeTag, Scalar, MaxResidualAllowed);
relaxed_max_pv_fraction_ = EWOMS_GET_PARAM(TypeTag, Scalar, RelaxedMaxPvFraction);
tolerance_mb_ = EWOMS_GET_PARAM(TypeTag, Scalar, ToleranceMb);
tolerance_cnv_ = EWOMS_GET_PARAM(TypeTag, Scalar, ToleranceCnv);
tolerance_cnv_relaxed_ = EWOMS_GET_PARAM(TypeTag, Scalar, ToleranceCnvRelaxed);
tolerance_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, ToleranceWells);
tolerance_well_control_ = EWOMS_GET_PARAM(TypeTag, Scalar, ToleranceWellControl);
max_welleq_iter_ = EWOMS_GET_PARAM(TypeTag, int, MaxWelleqIter);
use_multisegment_well_ = EWOMS_GET_PARAM(TypeTag, bool, UseMultisegmentWell);
tolerance_pressure_ms_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, TolerancePressureMsWells);
relaxed_tolerance_flow_well_ = EWOMS_GET_PARAM(TypeTag, Scalar, RelaxedWellFlowTol);
relaxed_tolerance_pressure_ms_well_ = EWOMS_GET_PARAM(TypeTag, Scalar, RelaxedPressureTolMsw);
max_pressure_change_ms_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, MaxPressureChangeMsWells);
max_inner_iter_ms_wells_ = EWOMS_GET_PARAM(TypeTag, int, MaxInnerIterMsWells);
strict_inner_iter_wells_ = EWOMS_GET_PARAM(TypeTag, int, StrictInnerIterWells);
strict_outer_iter_wells_ = EWOMS_GET_PARAM(TypeTag, int, StrictOuterIterWells);
regularization_factor_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, RegularizationFactorWells);
max_niter_inner_well_iter_ = EWOMS_GET_PARAM(TypeTag, int, MaxNewtonIterationsWithInnerWellIterations);
shut_unsolvable_wells_ = EWOMS_GET_PARAM(TypeTag, bool, ShutUnsolvableWells);
max_inner_iter_wells_ = EWOMS_GET_PARAM(TypeTag, int, MaxInnerIterWells);
maxSinglePrecisionTimeStep_ = EWOMS_GET_PARAM(TypeTag, Scalar, MaxSinglePrecisionDays) *24*60*60;
min_strict_cnv_iter_ = EWOMS_GET_PARAM(TypeTag, int, MinStrictCnvIter);
solve_welleq_initially_ = EWOMS_GET_PARAM(TypeTag, bool, SolveWelleqInitially);
update_equations_scaling_ = EWOMS_GET_PARAM(TypeTag, bool, UpdateEquationsScaling);
use_update_stabilization_ = EWOMS_GET_PARAM(TypeTag, bool, UseUpdateStabilization);
matrix_add_well_contributions_ = EWOMS_GET_PARAM(TypeTag, bool, MatrixAddWellContributions);
check_well_operability_ = EWOMS_GET_PARAM(TypeTag, bool, EnableWellOperabilityCheck);
check_well_operability_iter_ = EWOMS_GET_PARAM(TypeTag, bool, EnableWellOperabilityCheckIter);
max_number_of_well_switches_ = EWOMS_GET_PARAM(TypeTag, int, MaximumNumberOfWellSwitches);
deck_file_name_ = EWOMS_GET_PARAM(TypeTag, std::string, EclDeckFileName);
}
static void registerParameters()
{
EWOMS_REGISTER_PARAM(TypeTag, Scalar, DbhpMaxRel, "Maximum relative change of the bottom-hole pressure in a single iteration");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, DwellFractionMax, "Maximum absolute change of a well's volume fraction in a single iteration");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, MaxResidualAllowed, "Absolute maximum tolerated for residuals without cutting the time step size");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, RelaxedMaxPvFraction, "The fraction of the pore volume of the reservoir "
"where the volumetric error (CNV) may be voilated during strict Newton iterations.");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, ToleranceMb, "Tolerated mass balance error relative to total mass present");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, ToleranceCnv, "Local convergence tolerance (Maximum of local saturation errors)");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, ToleranceCnvRelaxed, "Relaxed local convergence tolerance that applies for iterations after the iterations with the strict tolerance");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, ToleranceWells, "Well convergence tolerance");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, ToleranceWellControl, "Tolerance for the well control equations");
EWOMS_REGISTER_PARAM(TypeTag, int, MaxWelleqIter, "Maximum number of iterations to determine solution the well equations");
EWOMS_REGISTER_PARAM(TypeTag, bool, UseMultisegmentWell, "Use the well model for multi-segment wells instead of the one for single-segment wells");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, TolerancePressureMsWells, "Tolerance for the pressure equations for multi-segment wells");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, RelaxedWellFlowTol, "Relaxed tolerance for the well flow residual");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, RelaxedPressureTolMsw, "Relaxed tolerance for the MSW pressure solution");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, MaxPressureChangeMsWells, "Maximum relative pressure change for a single iteration of the multi-segment well model");
EWOMS_REGISTER_PARAM(TypeTag, int, MaxInnerIterMsWells, "Maximum number of inner iterations for multi-segment wells");
EWOMS_REGISTER_PARAM(TypeTag, int, StrictInnerIterWells, "Number of inner well iterations with strict tolerance");
EWOMS_REGISTER_PARAM(TypeTag, int, StrictOuterIterWells, "Number of newton iterations for which wells are checked with strict tolerance");
EWOMS_REGISTER_PARAM(TypeTag, int, MaxNewtonIterationsWithInnerWellIterations, "Maximum newton iterations with inner well iterations");
EWOMS_REGISTER_PARAM(TypeTag, bool, ShutUnsolvableWells, "Shut unsolvable wells");
EWOMS_REGISTER_PARAM(TypeTag, int, MaxInnerIterWells, "Maximum number of inner iterations for standard wells");
EWOMS_REGISTER_PARAM(TypeTag, bool, AlternativeWellRateInit, "Use alternative well rate initialization procedure");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, RegularizationFactorWells, "Regularization factor for wells");
EWOMS_REGISTER_PARAM(TypeTag, Scalar, MaxSinglePrecisionDays, "Maximum time step size where single precision floating point arithmetic can be used solving for the linear systems of equations");
EWOMS_REGISTER_PARAM(TypeTag, int, MinStrictCnvIter, "Minimum number of Newton iterations before relaxed tolerances can be used for the CNV convergence criterion");
EWOMS_REGISTER_PARAM(TypeTag, bool, SolveWelleqInitially, "Fully solve the well equations before each iteration of the reservoir model");
EWOMS_REGISTER_PARAM(TypeTag, bool, UpdateEquationsScaling, "Update scaling factors for mass balance equations during the run");
EWOMS_REGISTER_PARAM(TypeTag, bool, UseUpdateStabilization, "Try to detect and correct oscillations or stagnation during the Newton method");
EWOMS_REGISTER_PARAM(TypeTag, bool, MatrixAddWellContributions, "Explicitly specify the influences of wells between cells in the Jacobian and preconditioner matrices");
EWOMS_REGISTER_PARAM(TypeTag, bool, EnableWellOperabilityCheck, "Enable the well operability checking");
EWOMS_REGISTER_PARAM(TypeTag, bool, EnableWellOperabilityCheckIter, "Enable the well operability checking during iterations");
EWOMS_REGISTER_PARAM(TypeTag, int, MaximumNumberOfWellSwitches, "Maximum number of times a well can switch to the same control");
}
};
} // namespace Opm
#endif // OPM_BLACKOILMODELPARAMETERS_EBOS_HEADER_INCLUDED