SingleWellState.hpp

Go to the documentation of this file.

/*
  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_SINGLE_WELL_STATE_HEADER_INCLUDED
#define OPM_SINGLE_WELL_STATE_HEADER_INCLUDED
 
#include <functional>
#include <vector>
 
#include <opm/input/eclipse/Schedule/Well/WellEnums.hpp>
#include <opm/input/eclipse/Schedule/Events.hpp>
#include <opm/input/eclipse/Schedule/Group/Group.hpp>
 
#include <opm/material/fluidsystems/PhaseUsageInfo.hpp>
 
#include <opm/simulators/wells/SegmentState.hpp>
#include <opm/simulators/wells/PerfData.hpp>
#include <opm/simulators/wells/ParallelWellInfo.hpp>
#include <opm/simulators/wells/ALQState.hpp>
 
namespace Opm {
 
template<class Scalar> struct PerforationData;
class SummaryState;
class Well;
 
template<typename Scalar, typename IndexTraits>
class SingleWellState {
public:
    static const int waterPhaseIdx = PhaseUsageInfo<IndexTraits>::waterPhaseIdx;
    static const int oilPhaseIdx = PhaseUsageInfo<IndexTraits>::oilPhaseIdx;
    static const int gasPhaseIdx = PhaseUsageInfo<IndexTraits>::gasPhaseIdx;
 
    SingleWellState(const std::string& name,
                    const ParallelWellInfo<Scalar>& pinfo,
                    const PhaseUsageInfo<IndexTraits>& pu,
                    bool is_producer,
                    Scalar pressure_first_connection,
                    const std::vector<PerforationData<Scalar>>& perf_input,
                    Scalar temp);
 
    static SingleWellState serializationTestObject(const ParallelWellInfo<Scalar>& pinfo);
 
    template<class Serializer>
    void serializeOp(Serializer& serializer)
    {
        serializer(name);
        serializer(status);
        serializer(producer);
        serializer(bhp);
        serializer(thp);
        serializer(network_thp_limit);
        serializer(pressure_first_connection);
        serializer(temperature);
        serializer(energy_rate);
        serializer(efficiency_scaling_factor);
        serializer(phase_mixing_rates);
        serializer(well_potentials);
        serializer(productivity_index);
        serializer(implicit_ipr_a);
        serializer(implicit_ipr_b);
        serializer(surface_rates);
        serializer(reservoir_rates);
        serializer(prev_surface_rates);
        serializer(frac_rate);
        serializer(segments);
        serializer(events);
        serializer(injection_cmode);
        serializer(production_cmode);
        serializer(filtrate_conc);
        serializer(perf_data);
        serializer(primaryvar);
        serializer(alq_state);
        serializer(group_target);
        serializer(group_target_fallback);
        serializer(use_group_target_fallback);
        serializer(was_shut_before_action_applied);
        serializer(weldraw_max_rate);
        serializer(weldraw_cmode);
    }
 
    bool operator==(const SingleWellState&) const;
 
    std::string name;
    std::reference_wrapper<const ParallelWellInfo<Scalar>> parallel_info;
 
    WellStatus status{WellStatus::OPEN};
    bool producer;
    PhaseUsageInfo<IndexTraits> pu;
    Scalar bhp{0};
    Scalar thp{0};
    // Network-imposed THP limit retained until the schedule re-specifies the
    // well's THP limit or VFP table.
    std::optional<Scalar> network_thp_limit;
    Scalar pressure_first_connection{0};
 
    // thermal related
    Scalar temperature{0};
    Scalar energy_rate{0.};
 
    Scalar efficiency_scaling_factor{1.0};
 
    // filtration injection concentration
    Scalar filtrate_conc{0};
 
    std::array<Scalar,4> phase_mixing_rates{};
    enum RateIndices {
      dissolved_gas = 0,
      dissolved_gas_in_water = 1,
      vaporized_oil = 2,
      vaporized_water = 3
    };
 
    struct GroupTarget {
        std::string group_name;
        Scalar target_value{0.0};
        Group::ProductionCMode production_cmode {Group::ProductionCMode::NONE};
        Group::InjectionCMode injection_cmode {Group::InjectionCMode::NONE};
        Scalar guiderate_ratio{1.0}; // well to group guide rate ratio for diagnostics
 
        bool operator==(const GroupTarget& other) const {
            return (group_name == other.group_name
                 && target_value == other.target_value
                 && production_cmode == other.production_cmode
                 && injection_cmode == other.injection_cmode
                 && guiderate_ratio == other.guiderate_ratio);
        }
 
        template<class Serializer>
        void serializeOp(Serializer& serializer) {
            serializer(group_name);
            serializer(target_value);
            serializer(production_cmode);
            serializer(injection_cmode);
            serializer(guiderate_ratio);
        }
    };
 
    std::vector<Scalar> well_potentials;
    std::vector<Scalar> productivity_index;
    std::vector<Scalar> implicit_ipr_a;
    std::vector<Scalar> implicit_ipr_b;
    std::vector<Scalar> surface_rates;
    std::vector<Scalar> reservoir_rates;
    std::vector<Scalar> prev_surface_rates;
    Scalar frac_rate{0.0};
    PerfData<Scalar> perf_data;
    std::optional<GroupTarget> group_target;
    std::optional<GroupTarget> group_target_fallback;
    bool use_group_target_fallback;
    SegmentState<Scalar> segments;
    Events events;
    WellInjectorCMode injection_cmode{WellInjectorCMode::CMODE_UNDEFINED};
    WellProducerCMode production_cmode{WellProducerCMode::CMODE_UNDEFINED};
    std::vector<Scalar> primaryvar;
    ALQState<Scalar> alq_state;
    // This is used to indicate whether the well was shut before applying an action
    // if it was SHUT, even the action set the well to OPEN, the data in the well state
    // is not well-defined. We do not use it to overwrite the current well state.
    bool was_shut_before_action_applied {false};
    // Maximum production rate of the WELDRAW target phase derived from the
    // well's drawdown limit; updated during the first NUPCOL iterations of
    // each timestep and unset when no drawdown limit is active.
    std::optional<Scalar> weldraw_max_rate{};
    // The rate control which carries that limit, set only while the limit is
    // at least as restrictive as the well's own target for the same phase.
    // The well is under drawdown control when this is its active control.
    std::optional<WellProducerCMode> weldraw_cmode{};
 
    void reset_connection_factors(const std::vector<PerforationData<Scalar>>& new_perf_data);
    void update_producer_targets(const Well& ecl_well, const SummaryState& st);
    void update_injector_targets(const Well& ecl_well, const SummaryState& st);
    void update_type_and_targets(const Well& ecl_well, const SummaryState& st);
    bool updateStatus(WellStatus status);
    void init_timestep(const SingleWellState& other);
    void shut();
    void stop();
    void open();
 
    // The sum_xxx_rates() functions sum over all connection rates of pertinent
    // types. In the case of distributed wells this involves an MPI
    // communication.
    Scalar sum_solvent_rates() const;
    Scalar sum_polymer_rates() const;
    Scalar sum_brine_rates() const;
    Scalar sum_microbial_rates() const;
    Scalar sum_oxygen_rates() const;
    Scalar sum_urea_rates() const;
    Scalar sum_wat_mass_rates() const;
 
    Scalar sum_filtrate_rate() const;
    Scalar sum_filtrate_total() const;
 
private:
    Scalar sum_connection_rates(const std::vector<Scalar>& connection_rates) const;
};
 
}
 
#endif