You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -48,22 +48,20 @@ You can run _expreccs_ as a single command line:
48
48
```
49
49
expreccs -i name(s)_of_input_file(s)
50
50
```
51
-
Run `expreccs --help` to see all possible command line argument options. Inside the `configuration_file.txt` file you provide the path to the
51
+
Run `expreccs --help` to see all possible command line argument options. Inside the `configuration_file.toml` file you provide the path to the
52
52
flow executable and simulation parameters. To write dynamic boundary conditions from a given regional model to a site model, this can be achieved by giving the path to the models (i.e., without a configuration file). See the [_examples_](https://github.com/cssr-tools/expreccs/tree/main/examples) and [_tests_](https://github.com/cssr-tools/expreccs/tree/main/tests/configs) folders.
53
53
54
54
## Getting started
55
55
See the [_examples_](https://cssr-tools.github.io/expreccs/examples.html) in the [_documentation_](https://cssr-tools.github.io/expreccs/introduction.html).
56
56
57
57
## Citing
58
-
If you would like to cite this repository:
59
-
60
58
* Landa-Marbán, D. 2024. expreccs: A Python framework using OPM Flow to simulate regional and site reservoirs for CO2 storage. https://doi.org/10.5281/zenodo.12100600.
61
59
62
60
## Publications
63
61
The following is a list of manuscripts in which _expreccs_ is used:
64
62
65
-
1. Tveit, S., Gasda, S.E., Landa-Marbán, D., Sandve, T.H., submitted. A hierarchical approach for modeling regional pressure interference in multi-site CO2 operations. http://dx.doi.org/10.2139/ssrn.5005237.
66
-
1. Gasda, S.E., et al., 2024. Quantifying the impact of regional-scale pressure interference on commercial CO2 storage targets for multiple licenses. http://dx.doi.org/10.2139/ssrn.5053633.
63
+
1. Tveit, S., Gasda, S.E., Landa-Marbán, D., Sandve, T.H., 2025. A hierarchical approach for modeling regional pressure interference in multi-site CO2 operations. Geoenergy Science and Engineering 248, 13733. https://doi.org/10.1016/j.geoen.2025.213733.
64
+
1. Gasda, S., Sandve, T.H., Tveit, S., Landa-Marbán, D., Pettersson, P., Krumscheid, S., Mykkeltvedt, T.S., Dahle, H., 2024. Quantifying the impact of regional-scale pressure interference on commercial CO2 storage targets for multiple licenses. Proceedings of the 17th Greenhouse Gas Control Technologies Conference (GHGT-17) 20-24 October 2024. http://dx.doi.org/10.2139/ssrn.5053633.
67
65
68
66
## About expreccs
69
67
The _expreccs_ package is funded by Harbour Energy, Equinor, Shell, and the Research Council of Norway [project number 336294].
Copy file name to clipboardExpand all lines: docs/_sources/about.rst.txt
+1-2
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,7 @@ About expreccs
7
7
8
8
The **expreccs** tool is funded by
9
9
Harbour Energy, Equinor, Shell, and the Research Council of Norway [project number 336294].
10
-
11
-
This is work in progress.
10
+
12
11
`Here <https://www.norceresearch.no/en/projects/expansion-of-resources-for-co2-storage-on-the-horda-platform-expreccs>`_ is the link to the project details.
13
12
14
13
Contributions are more than welcome using the fork and pull request approach.
We consider the configuration file `example1_back.txt<https://github.com/cssr-tools/expreccs/blob/main/examples/example1_back.txt>`_ in the examples folder.
86
+
We consider the configuration file `example1_back.toml<https://github.com/cssr-tools/expreccs/blob/main/examples/example1_back.toml>`_ in the examples folder.
87
87
The plan is to update properties (e.g., transmissibility multipliers) in the regional model from features (e.g., faults) in the site model (i.e., not included in the regional model).
88
88
By running:
89
89
90
90
.. code-block:: bash
91
91
92
-
expreccs -i example1_back.txt -o back-coupling -m all -p yes
92
+
expreccs -i example1_back.toml -o back-coupling -m all -p yes
93
93
94
94
This is one of the generated figures in the back-coupling/postprocessing folder (named as back-coupling_summary_BPR_regional_reference.png):
The figures in the postprocessing includes the results for the first two iterations and the last one (in this case 9 since the number of
99
-
iteration is set to 10 in line 22 of the `configuration_file <https://github.com/cssr-tools/expreccs/blob/main/examples/example1_back.txt>`_).
99
+
iteration is set to 10 in the `configuration_file <https://github.com/cssr-tools/expreccs/blob/main/examples/example1_back.toml>`_, "iterations = 10" in line 20).
100
100
101
101
For example, to show the difference in the spatial maps for pressure between iteration 4 and 7 at the third restart, this can be achieved using
102
102
`plopm <https://github.com/cssr-tools/plopm>`_ by executing:
@@ -124,7 +124,7 @@ and to show the comparison for the summary vector FPR for iterations 1, 5, 7, an
124
124
Via OPM Flow decks
125
125
==================
126
126
127
-
See/run the `test_generic_deck.py <https://github.com/cssr-tools/expreccs/blob/main/tests/test_generic_deck.py>`_
127
+
See/run the `test_2_generic_deck.py <https://github.com/cssr-tools/expreccs/blob/main/tests/test_2_generic_deck.py>`_
128
128
for an example where **expreccs** is used in two given models (regional and site, in this case they are created using
129
129
the **expreccs** package, but in general can be any given geological models), generating a new input deck where
130
130
the pressures are projected.
@@ -138,7 +138,7 @@ For example, to run the test, this can be achieved by executing:
Copy file name to clipboardExpand all lines: docs/_sources/installation.rst.txt
+3-4
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,9 @@ Installation
3
3
============
4
4
5
5
The following steps work installing the dependencies in Linux via apt-get or in macOS using brew or macports.
6
-
While using package managers such as Anaconda, Miniforge, or Mamba might work, these are not tested.
6
+
While using package managers such as Anaconda, Miniforge, or Mamba might work, these are not tested. In addition, the current
7
+
supported Python versions are 3.11 to 3.12. We will update the documentation when Python3.13 is supported (e.g., the resdata Python
8
+
package is not yet available via pip install in Python 3.13).
7
9
8
10
Python package
9
11
--------------
@@ -149,8 +151,5 @@ package (see the `prerequisites <https://opm-project.org/?page_id=239>`_, which
149
151
150
152
This builds OPM Flow as well as the opm Python package, and it exports the required PYTHONPATH. Then after execution, deactivate and activate the Python virtual environment.
151
153
152
-
Regarding the resdata Python package, it might not be available depending on the Python version (e.g., it is not found using Python 3.9, but it is installed using Python 3.10).
153
-
Then, for macOS users, you need to use a Python version equal or higher than 3.10.
154
-
155
154
For macOS, the LaTeX dependency can be installed from https://www.tug.org/mactex/. If after installation you still face an error due to LaTeX
156
155
when executing expreccs, then add the flag **-latex 0** to expreccs.
Copy file name to clipboardExpand all lines: docs/_sources/introduction.rst.txt
+6-3
Original file line number
Diff line number
Diff line change
@@ -32,20 +32,23 @@ The current implementation supports the following executable with the argument o
32
32
33
33
where
34
34
35
-
-i The base name of the :doc:`configuration file <./configuration_file>`; or paths (space between them and quotation marks) to the regional and site models ('input.txt' by default).
35
+
-i The base name of the :doc:`configuration file <./configuration_file>`; or paths (space between them and quotation marks) to the regional and site models ('input.toml' by default).
36
36
-o The base name of the :doc:`output folder <./output_folder>` ('output' by default).
37
37
-m Run the whole framework ('all'), only the reference ('reference'), only the site ('site'), or only regional and site models ('noreference') ('all' by default).
38
38
-c Generate metric plots for the current outputed folders ('compare') ('' by default).
39
39
-p Create nice figures in the postprocessing folder ('no' by default).
40
-
-r Using the 'opm' or 'resdata' python package ('resdata' by default).
41
40
-u Using 'gasoil' or 'gaswater' co2store implementation ('gaswater' by default).
41
+
-r Using the 'opm' or 'resdata' python package ('resdata' by default).
42
42
-t Grades to rotate the site geological model ('0' by default).
43
43
-b Set the number of entries to skip the bc projections on the site, where 'j=0,i=nx,j=ny,i=0', e.g., '0,2,0,0' would skip all cells with i=nx and i=nx-1; this becomes handly for models where all cells in a given site are inactive along a side ('0,0,0,0' by default).
44
44
-f Frequency to evaluate the boundary pressures on the site between report steps in the site. Write an array, e.g., '2,7,3', to set the frequency in each site report step ('1' by default).
45
45
-a Exponential 'a' coefficient for the telescopic time-discretization for the given frequency '-f'. Write an array, e.g., '2.2,0,3.1', to set the coefficient in each site report step ('3.2' by default, use 0 for an equidistance partition).
46
46
-w Set to 1 to print warnings ('0' by default).
47
47
-l Set to 0 to not use LaTeX formatting ('1' by default).
48
48
49
+
The valid flags for toml **configuration file** are -i, -o, -m, -c, -p, -u, -r, -t, -w, and -l.
50
+
The valid flags for paths to the regional and site folders are -i, -o, -b, -f, -a, and -w.
51
+
49
52
In the **configuration file** the geological model is defined by generation
50
-
of corner-point grids (cpg), adding heterogeinities (e.g., different rock properties, faults), wells, and defining schedules for the
53
+
of corner-point grids (cpg), adding heterogeinities (e.g., different rock properties, faults, hysteresis), wells, and defining schedules for the
51
54
operations (see the :doc:`configuration file <./configuration_file>` section).
<p>The <strong>expreccs</strong> tool is funded by
87
87
Harbour Energy, Equinor, Shell, and the Research Council of Norway [project number 336294].</p>
88
-
<p>This is work in progress.
89
-
<aclass="reference external" href="https://www.norceresearch.no/en/projects/expansion-of-resources-for-co2-storage-on-the-horda-platform-expreccs">Here</a> is the link to the project details.</p>
88
+
<p><aclass="reference external" href="https://www.norceresearch.no/en/projects/expansion-of-resources-for-co2-storage-on-the-horda-platform-expreccs">Here</a> is the link to the project details.</p>
90
89
<p>Contributions are more than welcome using the fork and pull request approach.</p>
91
90
<p>For new features, please request them raising an issue.</p>
0 commit comments