/reservoirpy

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

=================================== reservoirpy


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

Changelist in 1.3.8:

  • Fix bug in Hall & Yarborough Z-Factor algorithm

Changelist in 1.3.5:

  • Fix bug in ECL deck zip/check recursion

Changelist in 1.3.4:

  • Extend ECL deck zip/check function to handle IX formatted decks, and support zipping multiple decks at once.

Changelist in 1.3.2:

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

Changelist in v1.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.