resqpy: Python API for working with RESQML models
Introduction
resqpy is a pure python package which provides a programming interface (API) for reading, writing, and modifying reservoir models in the RESQML format. It gives you the ability to work with reservoir models programmatically, without having to know the details of the RESQML standard.
The package is written and maintained by bp, and is made available under the MIT license as a contribution to the open-source community.
resqpy was created by Andy Beer. For enquires about resqpy, please contact Nathan Lane ([email protected])
Documentation
See the complete package documentation on readthedocs.
About RESQML
RESQML™ is an industry initiative to provide open, non-proprietary data exchange standards for reservoir characterization, earth and reservoir models. It is governed by the Energistics consortium.
Resqpy provides specialized classes for a subset of the RESQML high level object classes, as described in the docs. Furthermore, not all variations of these object types are supported; for example, radial IJK grids are not yet catered for, although the RESQML standard does allow for such grids.
It is envisaged that the code base will be expanded to include other classes of object and more fully cover the options permitted by the RESQML standard.
Modification functionality at the moment focuses on changes to grid geometry.
Installation
Resqpy can be installed with pip:
pip install resqpy
Alternatively, to install your working copy of the code in "editable" mode:
pip install -e /path/to/repo/
Contributing
Contributions of all forms are welcome and encouraged! See the Contributing Guide for guidance on how you can contribute, including bug reports, features requests and pull requests.
Repository structure
resqpy: high level modules providing classes for main RESQML object types and high level modification functionsresqpy/olio: low level modules, not often imported directly by calling codetests: unit testsexample_data: small example datasets
Unit tests
Run the test suite locally with:
pytest tests/
Making a release
To make a release at a given commit, simply make a git tag:
# Make a tag
git tag -a v0.0.1 -m "Incremental release with some bugfixes"
# Push tag to github
git push origin v0.0.1
The tag must have the prefix v and have the form MAJOR.MINOR.PATCH.
Following semantic versioning, increment the:
- MAJOR version when you make incompatible API changes,
- MINOR version when you add functionality in a backwards compatible manner, and
- PATCH version when you make backwards compatible bug fixes.
6 Jul 05, 2022
3 Dec 28, 2022
32 Dec 25, 2022
1.8k Jan 09, 2023
96 Jan 01, 2023
16 Dec 10, 2022
6 May 19, 2022
2 Dec 22, 2021
75 Nov 26, 2022
12 Sep 09, 2022
32 Jun 21, 2022
58 Dec 16, 2022
33 Nov 13, 2022
1 Sep 18, 2021
42 Nov 26, 2022
2 Dec 08, 2021
28 Dec 30, 2022
10 Oct 14, 2022
19 Dec 24, 2022
2 Dec 01, 2021