opm-simulators/opm/simulators/wells/GasLiftStage2.hpp
Bård Skaflestad 26cd7ab993 Move opm/core/props to opm/simulators/utils
The opm/core directory is no longer meaningful, and it contains only
components which might collectively be described as simulator
utilities.
2024-06-25 12:22:09 +02:00

269 lines
10 KiB
C++

/*
Copyright 2021 Equinor ASA.
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 <http://www.gnu.org/licenses/>.
*/
#ifndef OPM_GASLIFT_STAGE2_HEADER_INCLUDED
#define OPM_GASLIFT_STAGE2_HEADER_INCLUDED
#include <opm/simulators/wells/GasLiftSingleWellGeneric.hpp>
#include <opm/simulators/utils/BlackoilPhases.hpp>
#include <map>
#include <memory>
#include <optional>
#include <string>
#include <tuple>
#include <vector>
namespace Opm {
class DeferredLogger;
class GasLiftOpt;
template<class Scalar> class GasLiftWellState;
class Group;
template<class Scalar> class GroupState;
class Schedule;
template<class Scalar> class WellInterfaceGeneric;
template<class Scalar> class WellState;
template<class Scalar>
class GasLiftStage2 : public GasLiftCommon<Scalar>
{
using GasLiftSingleWell = GasLiftSingleWellGeneric<Scalar>;
using GLiftOptWells = std::map<std::string,std::unique_ptr<GasLiftSingleWell>>;
using GLiftProdWells = std::map<std::string,const WellInterfaceGeneric<Scalar>*>;
using GLiftWellStateMap = std::map<std::string,std::unique_ptr<GasLiftWellState<Scalar>>>;
using GradPair = std::pair<std::string, Scalar>;
using GradPairItr = typename std::vector<GradPair>::iterator;
using GradInfo = typename GasLiftSingleWellGeneric<Scalar>::GradInfo;
using GradMap = std::map<std::string, GradInfo>;
using MessageType = typename GasLiftCommon<Scalar>::MessageType;
static const int Water = BlackoilPhases::Aqua;
static const int Oil = BlackoilPhases::Liquid;
static const int Gas = BlackoilPhases::Vapour;
public:
GasLiftStage2(const int report_step_idx,
const Parallel::Communication& comm,
const Schedule& schedule,
const SummaryState& summary_state,
DeferredLogger& deferred_logger,
WellState<Scalar>& well_state,
const GroupState<Scalar>& group_state,
GLiftProdWells& prod_wells,
GLiftOptWells& glift_wells,
GasLiftGroupInfo<Scalar>& group_info,
GLiftWellStateMap& state_map,
bool glift_debug);
void runOptimize();
protected:
void addOrRemoveALQincrement_(GradMap& grad_map,
const std::string& well_name,
bool add);
std::optional<GradInfo> calcIncOrDecGrad_(const std::string name,
const GasLiftSingleWell& gs_well,
const std::string& gr_name_dont_limit,
bool increase);
bool checkRateAlreadyLimited_(const std::string& well_name,
GasLiftWellState<Scalar>& state,
bool increase);
GradInfo deleteDecGradItem_(const std::string& name);
GradInfo deleteIncGradItem_(const std::string& name);
GradInfo deleteGrad_(const std::string& name, bool increase);
void displayDebugMessage_(const std::string& msg) const override;
void displayDebugMessage2B_(const std::string& msg);
void displayDebugMessage_(const std::string& msg,
const std::string& group_name);
void displayWarning_(const std::string& msg,
const std::string& group_name);
void displayWarning_(const std::string& msg);
std::tuple<Scalar, Scalar, Scalar, Scalar>
getCurrentGroupRates_(const Group& group);
std::optional<Scalar> getGroupMaxALQ_(const Group& group);
std::optional<Scalar> getGroupMaxTotalGas_(const Group& group);
std::vector<GasLiftSingleWell*> getGroupGliftWells_(const Group& group);
void getGroupGliftWellsRecursive_(const Group& group,
std::vector<GasLiftSingleWell*>& wells);
void optimizeGroup_(const Group& group);
void optimizeGroupsRecursive_(const Group& group);
void recalculateGradientAndUpdateData_(GradPairItr& grad_itr,
const std::string& gr_name_dont_limit,
bool increase,
std::vector<GradPair>& grads,
std::vector<GradPair>& other_grads);
void redistributeALQ_(std::vector<GasLiftSingleWell*>& wells,
const Group& group,
std::vector<GradPair>& inc_grads,
std::vector<GradPair>& dec_grads);
void removeSurplusALQ_(const Group& group,
std::vector<GradPair>& inc_grads,
std::vector<GradPair>& dec_grads);
void saveGrad_(GradMap& map, const std::string& name, GradInfo& grad);
void saveDecGrad_(const std::string& name, GradInfo& grad);
void saveIncGrad_(const std::string& name, GradInfo& grad);
void sortGradients_(std::vector<GradPair>& grads);
std::optional<GradInfo> updateGrad_(const std::string& name,
GradInfo& grad, bool increase);
void updateGradVector_(const std::string& name,
std::vector<GradPair>& grads,
Scalar grad);
void mpiSyncGlobalGradVector_(std::vector<GradPair>& grads_global) const;
void mpiSyncLocalToGlobalGradVector_(const std::vector<GradPair>& grads_local,
std::vector<GradPair>& grads_global) const;
GLiftProdWells& prod_wells_;
GLiftOptWells& stage1_wells_;
GasLiftGroupInfo<Scalar>& group_info_;
GLiftWellStateMap& well_state_map_;
int report_step_idx_;
const SummaryState& summary_state_;
const Schedule& schedule_;
const GasLiftOpt& glo_;
GradMap inc_grads_;
GradMap dec_grads_;
int max_iterations_ = 1000;
//int time_step_idx_;
struct OptimizeState
{
OptimizeState(GasLiftStage2& parent_, const Group& group_)
: parent{parent_}
, group{group_}
, it{0}
{}
GasLiftStage2& parent;
const Group& group;
int it;
using GradInfo = typename GasLiftStage2::GradInfo;
using GradPair = typename GasLiftStage2::GradPair;
using GradPairItr = typename GasLiftStage2::GradPairItr;
using GradMap = typename GasLiftStage2::GradMap;
void calculateEcoGradients(std::vector<GasLiftSingleWell*>& wells,
std::vector<GradPair>& inc_grads,
std::vector<GradPair>& dec_grads);
bool checkAtLeastTwoWells(std::vector<GasLiftSingleWell*>& wells);
void debugShowIterationInfo();
std::pair<std::optional<GradPairItr>,std::optional<GradPairItr>>
getEcoGradients(std::vector<GradPair>& inc_grads,
std::vector<GradPair>& dec_grads);
void recalculateGradients(std::vector<GradPair>& inc_grads,
std::vector<GradPair>& dec_grads,
GradPairItr& min_dec_grad_itr,
GradPairItr &max_inc_grad_itr);
void redistributeALQ( GradPairItr& min_dec_grad,
GradPairItr& max_inc_grad);
private:
void displayDebugMessage_(const std::string& msg);
void displayWarning_(const std::string& msg);
};
struct SurplusState
{
SurplusState(GasLiftStage2& parent_,
const Group& group_,
Scalar oil_rate_,
Scalar gas_rate_,
Scalar water_rate_,
Scalar alq_,
Scalar min_eco_grad_,
Scalar oil_target_,
Scalar gas_target_,
Scalar water_target_,
Scalar liquid_target_,
std::optional<Scalar> max_glift_,
std::optional<Scalar> max_total_gas_)
: parent{parent_}
, group{group_}
, oil_rate{oil_rate_}
, gas_rate{gas_rate_}
, water_rate{water_rate_}
, alq{alq_}
, min_eco_grad{min_eco_grad_}
, oil_target{oil_target_}
, gas_target{gas_target_}
, water_target(water_target_)
, liquid_target{liquid_target_}
, max_glift{max_glift_}
, max_total_gas{max_total_gas_}
, it{0}
{}
GasLiftStage2 &parent;
const Group &group;
Scalar oil_rate;
Scalar gas_rate;
Scalar water_rate;
Scalar alq;
const Scalar min_eco_grad;
const Scalar oil_target;
const Scalar gas_target;
const Scalar water_target;
const Scalar liquid_target;
std::optional<Scalar> max_glift;
std::optional<Scalar> max_total_gas;
int it;
void addOrRemoveALQincrement(GradMap &grad_map,
const std::string& well_name,
bool add);
bool checkALQlimit();
bool checkEcoGradient(const std::string& well_name, Scalar eco_grad);
bool checkGasTarget(Scalar delta_gas);
bool checkLiquidTarget(Scalar delta_liquid);
bool checkOilTarget(Scalar delta_oil);
bool checkWaterTarget(Scalar delta_water);
std::array<Scalar, 4> computeDelta(const std::string& name);
void updateRates(const std::array<Scalar, 4>& delta);
};
};
} // namespace Opm
#endif // OPM_GASLIFT_STAGE2_HEADER_INCLUDED