/* 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 {}; } NEW_PROP_TAG(DbhpMaxRel); NEW_PROP_TAG(DwellFractionMax); NEW_PROP_TAG(MaxResidualAllowed); NEW_PROP_TAG(RelaxedMaxPvFraction); NEW_PROP_TAG(ToleranceMb); NEW_PROP_TAG(ToleranceCnv); NEW_PROP_TAG(ToleranceCnvRelaxed); NEW_PROP_TAG(ToleranceWells); NEW_PROP_TAG(ToleranceWellControl); NEW_PROP_TAG(MaxWelleqIter); NEW_PROP_TAG(UseMultisegmentWell); NEW_PROP_TAG(MaxSinglePrecisionDays); NEW_PROP_TAG(MaxStrictIter); NEW_PROP_TAG(SolveWelleqInitially); NEW_PROP_TAG(UpdateEquationsScaling); NEW_PROP_TAG(UseUpdateStabilization); NEW_PROP_TAG(MatrixAddWellContributions); NEW_PROP_TAG(EnableWellOperabilityCheck); // parameters for multisegment wells NEW_PROP_TAG(TolerancePressureMsWells); NEW_PROP_TAG(MaxPressureChangeMsWells); NEW_PROP_TAG(UseInnerIterationsMsWells); NEW_PROP_TAG(MaxInnerIterMsWells); NEW_PROP_TAG(StrictInnerIterMsWells); NEW_PROP_TAG(RelaxedFlowTolInnerIterMsw); NEW_PROP_TAG(RelaxedPressureTolInnerIterMsw); NEW_PROP_TAG(RegularizationFactorMsw); NEW_PROP_TAG(UseInnerIterationsWells); NEW_PROP_TAG(MaxInnerIterWells); 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 = 1.0; }; 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 = 1e9; }; 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 MaxStrictIter { static constexpr int value = 8; }; 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 UseInnerIterationsMsWells { static constexpr bool value = true; }; template struct MaxInnerIterMsWells { static constexpr int value = 100; }; template struct UseInnerIterationsWells { static constexpr bool value = false; }; template struct MaxInnerIterWells { static constexpr int value = 50; }; template struct StrictInnerIterMsWells { static constexpr int value = 40; }; template struct RegularizationFactorMsw { using type = GetPropType; static constexpr type value = 1; }; template struct EnableWellOperabilityCheck { static constexpr bool value = true; }; template struct RelaxedFlowTolInnerIterMsw { using type = GetPropType; static constexpr type value = 1; }; template struct RelaxedPressureTolInnerIterMsw { using type = GetPropType; static constexpr type value = 0.5e5; }; // 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 (used when iter >= max_strict_iter_). 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 the inner iteration for the MSW flow solution double relaxed_inner_tolerance_flow_ms_well_; /// Relaxed tolerance for the inner iteration for the MSW pressure solution double relaxed_inner_tolerance_pressure_ms_well_; /// Maximum pressure change over an iteratio for ms wells double max_pressure_change_ms_wells_; /// Whether to use inner iterations for ms wells bool use_inner_iterations_ms_wells_; /// Maximum inner iteration number for ms wells int max_inner_iter_ms_wells_; /// Strict inner iteration number for ms wells int strict_inner_iter_ms_wells_; /// Regularization factor for ms wells int regularization_factor_ms_wells_; /// Whether to use inner iterations for standard wells bool use_inner_iterations_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_; /// Maximum number of Newton iterations before we give up on the CNV convergence criterion int max_strict_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_; /// 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_inner_tolerance_flow_ms_well_ = EWOMS_GET_PARAM(TypeTag, Scalar, RelaxedFlowTolInnerIterMsw); relaxed_inner_tolerance_pressure_ms_well_ = EWOMS_GET_PARAM(TypeTag, Scalar, RelaxedPressureTolInnerIterMsw); max_pressure_change_ms_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, MaxPressureChangeMsWells); use_inner_iterations_ms_wells_ = EWOMS_GET_PARAM(TypeTag, bool, UseInnerIterationsMsWells); max_inner_iter_ms_wells_ = EWOMS_GET_PARAM(TypeTag, int, MaxInnerIterMsWells); strict_inner_iter_ms_wells_ = EWOMS_GET_PARAM(TypeTag, int, StrictInnerIterMsWells); regularization_factor_ms_wells_ = EWOMS_GET_PARAM(TypeTag, Scalar, RegularizationFactorMsw); use_inner_iterations_wells_ = EWOMS_GET_PARAM(TypeTag, bool, UseInnerIterationsWells); max_inner_iter_wells_ = EWOMS_GET_PARAM(TypeTag, int, MaxInnerIterWells); maxSinglePrecisionTimeStep_ = EWOMS_GET_PARAM(TypeTag, Scalar, MaxSinglePrecisionDays) *24*60*60; max_strict_iter_ = EWOMS_GET_PARAM(TypeTag, int, MaxStrictIter); 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); 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, RelaxedFlowTolInnerIterMsw, "Relaxed tolerance for the inner iteration for the MSW flow solution"); EWOMS_REGISTER_PARAM(TypeTag, Scalar, RelaxedPressureTolInnerIterMsw, "Relaxed tolerance for the inner iteration 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, bool, UseInnerIterationsMsWells, "Use nested iterations for multi-segment wells"); EWOMS_REGISTER_PARAM(TypeTag, int, MaxInnerIterMsWells, "Maximum number of inner iterations for multi-segment wells"); EWOMS_REGISTER_PARAM(TypeTag, int, StrictInnerIterMsWells, "Number of inner iterations for multi-segment wells with strict tolerance"); EWOMS_REGISTER_PARAM(TypeTag, bool, UseInnerIterationsWells, "Use nested iterations for standard wells"); EWOMS_REGISTER_PARAM(TypeTag, int, MaxInnerIterWells, "Maximum number of inner iterations for standard wells"); EWOMS_REGISTER_PARAM(TypeTag, Scalar, RegularizationFactorMsw, "Regularization factor for ms 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, MaxStrictIter, "Maximum number of Newton iterations before relaxed tolerances are 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"); } }; } // namespace Opm #endif // OPM_BLACKOILMODELPARAMETERS_EBOS_HEADER_INCLUDED