opm-common
Summary.hpp
1 /*
2  Copyright 2016 Statoil ASA.
3 
4  This file is part of the Open Porous Media project (OPM).
5 
6  OPM is free software: you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation, either version 3 of the License, or
9  (at your option) any later version.
10 
11  OPM is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU General Public License for more details.
15 
16  You should have received a copy of the GNU General Public License
17  along with OPM. If not, see <http://www.gnu.org/licenses/>.
18 */
19 
20 #ifndef OPM_OUTPUT_SUMMARY_HPP
21 #define OPM_OUTPUT_SUMMARY_HPP
22 
23 #include <opm/output/data/Aquifer.hpp>
24 #include <opm/output/data/Groups.hpp>
26 
27 #include <map>
28 #include <memory>
29 #include <optional>
30 #include <string>
31 #include <tuple>
32 #include <unordered_map>
33 #include <utility>
34 #include <vector>
35 
36 namespace Opm {
37  class EclipseGrid;
38  class EclipseState;
39  class Inplace;
40  class Schedule;
41  class SummaryConfig;
42  class SummaryState;
43 } // namespace Opm
44 
45 namespace Opm::data {
46  class GroupAndNetworkValues;
47  class InterRegFlowMap;
48  struct WellBlockAveragePressures;
49  class Wells;
50 } // namespace Opm::data
51 
52 namespace Opm::out {
53 
58 class Summary
59 {
60 public:
67  {
71  using GlobalProcessParameters = std::map<std::string, double>;
72 
75  using RegionParameters = std::map<std::string, std::vector<double>>;
76 
81  using BlockValues = std::map<std::pair<std::string, int>, double>;
82 
90  using LgrBlockValues = std::map<std::tuple<std::string, int, int>, double>;
91 
95  using InterRegFlowValues = std::unordered_map<std::string, data::InterRegFlowMap>;
96 
99  {
103  const Inplace* current {nullptr};
104 
108  const Inplace* initial {nullptr};
109  };
110 
114  const data::Wells* well_solution {nullptr};
115 
122 
128 
134 
138  const RegionParameters* region_values {nullptr};
139 
144  const BlockValues* block_values {nullptr};
145 
149  const data::Aquifers* aquifer_values {nullptr};
150 
155 
163 
168 
176  };
177 
185  using DynamicConns = std::vector<std::pair<std::string, std::vector<std::size_t>>>;
186 
216  Summary(SummaryConfig& sumcfg,
217  const EclipseState& es,
218  const EclipseGrid& grid,
219  const Schedule& sched,
220  const std::string& basename = "",
221  const bool writeEsmry = false);
222 
226  ~Summary();
227 
243  void add_timestep(const SummaryState& st,
244  const int report_step,
245  const int ministep_id,
246  const bool isSubstep);
247 
273  void recordNewDynamicWellConns(const DynamicConns& newConns);
274 
291  void eval(const int report_step,
292  const double secs_elapsed,
293  const DynamicSimulatorState& values,
294  SummaryState& summary_state) const;
295 
302  void write(const bool is_final_summary = false) const;
303 
304 private:
306  class SummaryImplementation;
307 
309  std::unique_ptr<SummaryImplementation> pImpl_;
310 };
311 
312 } // namespace Opm::out
313 
314 #endif // OPM_OUTPUT_SUMMARY_HPP
const InterRegFlowValues * interreg_flows
Inter-region flows (rates and cumulatives).
Definition: Summary.hpp:154
Definition: Groups.hpp:232
std::map< std::string, std::vector< double > > RegionParameters
Collection of named per-region quantities.
Definition: Summary.hpp:75
const data::Wells * well_solution
Dynamic state variables at the well, connection, and segment levels.
Definition: Summary.hpp:114
Definition: RegionCache.hpp:35
std::vector< std::pair< std::string, std::vector< std::size_t > >> DynamicConns
Set of well connections that have been created during the simulation run.
Definition: Summary.hpp:185
Definition: Summary.cpp:5936
Definition: Schedule.hpp:102
Collection of run&#39;s summary vectors.
Definition: SummaryConfig.hpp:320
Definition: Wells.hpp:1279
void add_timestep(const SummaryState &st, const int report_step, const int ministep_id, const bool isSubstep)
Linearise summary values into internal buffer for output purposes.
Definition: Summary.cpp:6771
void recordNewDynamicWellConns(const DynamicConns &newConns)
Activate pre-allocated summary vector slots for newly established well connections arising from dynam...
Definition: Summary.cpp:6747
VolumeInPlace inplace
Fluid phase volumes in place at the field and region levels.
Definition: Summary.hpp:167
void eval(const int report_step, const double secs_elapsed, const DynamicSimulatorState &values, SummaryState &summary_state) const
Calculate summary vector values.
Definition: Summary.cpp:6752
About cell information and dimension: The actual grid information is held in a pointer to an ERT ecl_...
Definition: EclipseGrid.hpp:63
This class implements a small container which holds the transmissibility mulitpliers for all the face...
Definition: Exceptions.hpp:30
Computational engine for calculating summary vectors (2D curves as a function of time) and writing th...
Definition: Summary.hpp:58
Volumes of fluids-in-place.
Definition: Summary.hpp:98
const Inplace * current
Current fluids-in-place.
Definition: Summary.hpp:103
std::map< std::tuple< std::string, int, int >, double > LgrBlockValues
Collection of per-block quantities for cells inside a local grid refinement (LB* summary vectors)...
Definition: Summary.hpp:90
const BlockValues * block_values
Block (cell) level dynamic state values.
Definition: Summary.hpp:144
Definition: EclipseState.hpp:66
const data::GroupAndNetworkValues * group_and_nwrk_solution
Dynamic state at the group and network levels (e.g., mode of control and node pressures).
Definition: Summary.hpp:127
std::unordered_map< std::string, data::InterRegFlowMap > InterRegFlowValues
Collection of named inter-region flows (rates and cumulatives)
Definition: Summary.hpp:95
~Summary()
Destructor.
Definition: Summary.cpp:6784
std::map< std::string, double > GlobalProcessParameters
Collection of named scalar quantities such as field-wide pressures, rates, and volumes, as well as performance related quantities such as CPU time, number of linear iterations &c.
Definition: Summary.hpp:71
Definition: TransMult.hpp:40
const RegionParameters * region_values
Per region dynamic state such as pressures.
Definition: Summary.hpp:138
const data::ReservoirCouplingGroupRates * rc_group_rates
Reservoir coupling master group rates (production and injection).
Definition: Summary.hpp:162
Facility for converting collection of region ID pairs into a sparse (CSR) adjacency matrix representa...
Production and injection rates for reservoir coupling master groups.
Definition: Groups.hpp:357
Definition: SummaryState.hpp:72
void write(const bool is_final_summary=false) const
Write all current summary vector buffers to output files.
Definition: Summary.cpp:6779
const Inplace * initial
Initial fluids-in-place.
Definition: Summary.hpp:108
Layer of indirection for transferring dynamic state objects into vector calculation engine...
Definition: Summary.hpp:66
std::map< std::pair< std::string, int >, double > BlockValues
Collection of per-block (cell) quantities.
Definition: Summary.hpp:81
const data::WellBlockAveragePressures * wbp
Well-block averaged pressures.
Definition: Summary.hpp:121
const GlobalProcessParameters * single_values
Aggregate information about the simulation process such as number of linear and non-linear iterations...
Definition: Summary.hpp:133
Definition: Wells.hpp:1198
const LgrBlockValues * lgr_block_values
LGR block (cell) level dynamic state values (LB* vectors).
Definition: Summary.hpp:175
Summary(SummaryConfig &sumcfg, const EclipseState &es, const EclipseGrid &grid, const Schedule &sched, const std::string &basename="", const bool writeEsmry=false)
Constructor.
Definition: Summary.cpp:6738
const data::Aquifers * aquifer_values
Aquifer level dynamic state values.
Definition: Summary.hpp:149
Definition: Inplace.hpp:35