A robust, Python-based desktop application for petroleum engineers to perform Nodal Analysis. This application calculates and visualizes the intersection of Inflow Performance Relationship (IPR) and Vertical Lift Performance (VLP) curves to find the operating point(s) of a well and diagnose flow stability.
- IPR Models: Supports Composite (Darcy/Vogel) and Darcy (Linear) models, with pure Vogel and Fetkovitch models planned for future releases. Automatically handles the bubble point transition.
- VLP Models: Hagedorn-Brown multiphase flow correlation with Griffith-Wallis bubble flow detection and accurate liquid holdup corrections. Duns and Ross, and Beggs and Brill correlations are coming soon.
- Black Oil PVT: Automatically calculates fluid properties (Z-factor, Rs, Bo, Bg, Bw, viscosities, and densities) across the wellbore using industry-standard correlations (Standing, Beggs-Robinson, Lee-Gonzalez-Eakin, Dranchuk-Abou-Kassem).
- Solver & Stability Analysis: Utilizes an advanced nodal solver based on SciPy's Brent's method (
brentq) to pinpoint multiple operating points accurately. Crucially, it evaluates the local derivatives (IPR vs VLP slopes) to classify each equilibrium point as Stable, Unstable, or Indeterminate.
- Modern Design: Clean white and blue accent theme built with PyQt6.
- Collapsible Sidebar: Easily manage inputs for IPR, Fluid Properties, VLP, and Rate Ranges without cluttering the screen.
- Interactive Matplotlib Charts: Includes responsive hover tooltips for exact pressure/rate readings and an auto-updating legend.
- Pressure Traverse Mini-Map: A signature floating widget that shows a detailed Depth vs. Pressure traverse for the solved operating point. Can be expanded/collapsed for closer inspection.
- Sensitivity Analysis: Run multi-curve parameter sweeps (e.g., varying THP, GOR, Tubing ID, or Water Cut) overlaying the results directly onto the chart.
- Multithreaded: Calculations are handled by background workers, keeping the UI responsive and providing a live status/loading bar.
PROPMAS_Project/
│
├── main.py # The core entry point that launches the app
│
├── core/ # Pure mathematical & physics models
│ ├── __init__.py
│ ├── pvt.py # BlackOilPVT class & correlations
│ ├── vlp.py # HagedornBrown multiphase wellbore integration
│ ├── ipr.py # Darcy & Vogel inflow equations
│ ├── solver.py # Base root-finding optimizer for Operating Point
│ └── solver_other.py # Advanced multi-point stability solver
│
├── gui/ # User interface components
│ ├── __init__.py
│ └── main.py # Main PyQt6 Window, Chart Canvas, and Threads
│
├── assets/ # Static files (Icons, images)
├── requirements.txt # Python dependencies
└── build.py # PyInstaller script to compile the .exe
Make sure you have Python 3.9+ installed. You can install the required dependencies using pip:
pip install -r requirements.txt(Key dependencies include: numpy, scipy, matplotlib, PyQt6)
To launch the application, run the main entry point from your terminal:
python main.py- Expand the IPR Model section and define your Reservoir Pressure (
$P_r$ ), Bubble Point ($P_b$ ), and Test Points. - Expand the Fluid Properties section and define Specific Gravities and Water Cut.
- Expand the VLP — Wellbore section and input tubular geometry, Tubing Head Pressure (THP), TVD, and temperatures.
- Click the ▶ Run Analysis button at the top right of the window.
- View the Operating Point(s) ($q^$, $P_{wf}^$) plotted on the chart and summarized in the status bar. The app will visually distinguish stable operating points (gold stars) from unstable ones (red circles).
To package the application into a standalone Windows .exe file, a PyInstaller script is provided. Simply run:
python build.pyThe executable will be located in the dist/ directory.