Skip to main content

pyResToolbox - A collection of Reservoir Engineering Utilities

Project description

pyrestoolbox

-----------------------------A collection of Reservoir Engineering Utilities -----------------------------

This set of functions focuses on those that the author uses often while crafting programming solutions. These are the scripts that are often copy/pasted from previous work - sometimes slightly modified - resulting in a trail of slightly different versions over the years. Some attempt has been made here to make this implementation flexible enough such that it can be relied on as-is going forward.

Includes functions to perform simple calculations including;

  • Inflow for oil and gas
  • PVT Calculations for oil
  • PVT calculation for gas
  • Return critical parameters for typical components
  • Creation of Black Oil Table information
  • Creation of layered permeability distribution consistent with a Lorenze heterogeneity factor
  • Extract problem cells information from Intesect (IX) print files
  • Generation of AQUTAB include file influence functions for use in ECLIPSE
  • Creation of Corey and LET relative permeability tables in Eclipse format

Apologies in advance that it is only in oilfield units with no current plans to add multi-unit support.

Changelist in 1.3.0:

  • Added robust Rachford Rice solver in Simulation Helpers
  • Moved relative permeability functions and simulation helpers to seperate .simtools module

Changelist in 1.2.0

  • Added Component Critical Property Library

Changelist in v1.1.4:

  • Attempting to fix reported issue with required dependencies not installing correctly

Changelist in v1.1:

  • Fix API to SG calculation (141.4 vs 141.5)
  • Added lower limit to first rho_po estimate for Oil Density with McCain method to avoid negative values with high Rs
  • Added oil_sg and oil_api functions
  • Modified HY Z-Factor solve algorithm to improve robustness
  • Modified DAK Z-Factor solve algorithm to improve robustness
  • Added Gas Z-Factor correlation from Wang, Ye & Wu (2021)
  • Removed 'LIN' Z-Factor method due to significant errors above 12,000 psi. Use WYW method instead if speed needed.

Head to the project site for more information & documentation; https://github.com/mwburgoyne/pyResToolbox

Start by importing the package; from pyrestoolbox import pyrestoolbox as rtb

Function List includes

  • Gas Flow Rate Radial
  • Gas Flow Rate Linear
  • Oil Flow Rate Radial
  • Oil Flow Rate Linear

  • Gas Tc & Pc Calculation
  • Gas Z-Factor
    Calculation
  • Gas Viscosity
  • Gas Viscosity * Z
  • Gas Compressibility
  • Gas Formation Volume Factor
  • Gas Density
  • Gas Water of Condensation
  • Convert P/Z to P
  • Convert Gas Gradient to SG
  • Delta Pseudopressure
  • Gas Condensate FWS SG

  • Component Critical Properties Library

  • Oil Density from MW
  • Oil Critical Properties with Twu
  • Incrememtal GOR post Separation
  • Oil Bubble Point Pressure
  • Oil GOR at Pb
  • Oil GOR at P
  • Oil Compressibility
  • Oil Density
  • Oil Formation Volume Factor
  • Oil Viscosity
  • Generate Black Oil Table data
  • Estimate soln gas SG from oil
  • Estimate SG of gas post separator
  • Calculate weighted average surface gas SG
  • Oil API to SG
  • Oil SG to API

  • Calculate suite of brine properties

  • Lorenz coefficient from Beta value
  • Lorenz coefficient from flow fraction
  • Lorenz coefficient to flow fraction
  • Lorenz coefficient to permeability array

  • Summarize IX convergence errors from PRT file
  • Create Aquifer Influence Functions
  • Solve Rachford Rice for user specified feed Zis and Ki's
  • Create sets of rel perm tables

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyrestoolbox-1.3.0.tar.gz (95.1 kB view details)

Uploaded Source

Built Distribution

pyrestoolbox-1.3.0-py3-none-any.whl (89.6 kB view details)

Uploaded Python 3

File details

Details for the file pyrestoolbox-1.3.0.tar.gz.

File metadata

  • Download URL: pyrestoolbox-1.3.0.tar.gz
  • Upload date:
  • Size: 95.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.1 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for pyrestoolbox-1.3.0.tar.gz
Algorithm Hash digest
SHA256 c180191cbc5b310a7848d9bb2f5eb6009719890a61805289671b839c358a6c9e
MD5 9101f3b8d2f3a996041d12902028d8ae
BLAKE2b-256 58c9bca03cd9830a1f1515f149d13def000994e608c8ef3f3df2de05404de7c7

See more details on using hashes here.

File details

Details for the file pyrestoolbox-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: pyrestoolbox-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 89.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.1 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for pyrestoolbox-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14da3e9c2d9c859304546800857884ef9d2d7dc86ab9f3b7293285baf735bb12
MD5 854290cd4de4352b76cf84bb30243e18
BLAKE2b-256 11a346d30860e678bc723b7f7f2f3c5ea6d1c9295fe98721f2af65a52ef5da8c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page