/* 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