pyResToolbox - your Python Companion

Doesn’t time fly…. It only seems a short while ago that I wrote an article detailing the beginning of my journey of learning with Python. But that was almost 2 years ago…

Since then, I've found myself increasingly using this tool in day-to-day workflows. It will of course never replace commercial applications for Material Balance, EOS creation, Reservoir Simulation and the like, but I've found that there are many times when a couple of lines of code can save days of work, or provide new insights that weren't previously feasible to easily generate.

Over those two years, I've written and rewritten many functions for things like inflow calculations, PVT correlations, relative permeability table generation, and so on. Copy and paste is normally the starting point, but then each of them often becomes just a little different for the specific application.

These holidays – as is my tradition - I chose a project to work on, and this time it was to release the foundation of what I hope will become useful for many subsurface engineers. A package that should reduce the amount of time spent duplicating and tweaking those common functions

pyResToolbox

It took a surprising amount of time to put this together. I'd thought that it would be simple to copy/paste all my 'old faithfuls' together into a bundle for general consumption, but as I thought through ways that these functions might all be working together, and common options that reservoir engineers (and coders) may appreciate, it became apparent that significant rework was needed

To this end, I need to send a quick mention of thanks to Markus Hays Nielsen for some early suggestions that helped shape some of that architecture rework thoughts.

Documentation was another area that you tend to forget about when coding bespoke solutions on the fly – I probably spent a couple of days just getting that in a half-decent state. It did, however, have the added benefit of highlighting some inconsistencies and helping with overall QC.

Is it perfect? Well no… But IMHO it's a decent start, and I'll be improving it.

If you are interested in taking a look, you can find the code and documentation on Github.

Installation is simply via;

pip install pyrestoolbox

Then you import the package into your project with

from pyrestoolbox import pyrestoolbox as rtb

Happy coding!

Mark