Skip to main content

pta-learn

A Python library for automated Pressure Transient Analysis (PTA) workflows. The library provides tools to identify shut-in and flowing transients, detect PTA flow regime features and recognize stable patterns in time-lapse pressure transient responses. Feature extraction and pattern recognition modules are based on the methodology described in the peer-reviewed paper: Feature extraction and pattern recognition in time-lapse pressure transient responses. Shut-in pressure transient identification module is implemented using the methodology detailed in the conference paper: TPMR - A Novel Method for Automated Identification of Well Pressure Transients. Similarly, the flowing transient identification module employs the approach described in the conference paper: LMIR - A New Method for Automated Identification of Multi-Rate Pressure Transients.

Installation

Install the package using pip:

pip install pta-learn

Usage

Pressure Transient Identification

Integrated Transient Identification Workflow example
Shutin Transient Identification by TPMR method example
Flowing Transient Identification by LMIR method

Pressure Transient Quality Screening

Pressure Transient Quality Scores
Rate Absolute Relative Error (RARE) calculation example

Bourdet Derivative and Loglog Plot Calculation

Loglog family ploting Workflow example
Derivative Uncertainty Envelope (DUE) calculation example

Pattern Recognition in Time-lapse Pressure Transient Responses

PTA flow regime feature extraction example
Time-lapse PTA pattern recognition example

Citation

If you use this library in your research, please cite:

Pressure Transient Identification

@article{shchipanov2025new,
  title={New transient identification methods for automated pre-processing of pressure measurements with permanent well gauges},
  author={Cui, B. and Shchipanov, A. and Demyanov, V. and Zhang, N. and Rong, C.},
  journal={Geoenergy Science and Engineering},
  volume={257},
  pages={214203},
  year={2025},
  publisher={Elsevier},
  doi={10.1016/j.geoen.2025.214203},
  url={https://www.sciencedirect.com/science/article/pii/S2949891025005615}
}

Pattern Recognition in Time-Lapse PTA

@article{starikov2024feature,
  title={Feature extraction and pattern recognition in time-lapse pressure transient responses},
  author={Starikov, V. and Shchipanov, A. and Demyanov, V. and Muradov, K.},
  journal={Geoenergy Science and Engineering},
  volume={242},
  pages={213160},
  year={2024},
  publisher={Elsevier},
  doi={10.1016/j.geoen.2024.213160},
  url={https://www.sciencedirect.com/science/article/pii/S294989102400530X}
}

@conference{starikov2023unsupervised,
  title={Unsupervised Classification of Flow Regime Features in Pressure Transient Responses},
  author={Starikov, V. and Demyanov, V. and Muradov, K. and Shchipanov, A.},
  booktitle={Fifth EAGE Conference on Petroleum Geostatistics},
  year={2023},
  month={Nov},
  pages={1-5},
  publisher={European Association of Geoscientists & Engineers},
  doi={10.3997/2214-4609.202335019}
}

Derivative Uncertainty Envelope (DUE)

@inproceedings{mugisha2026breakthrough,
  title={A Breakthrough in Early Detection and Monitoring of Induced Fracture with Automated Interpretation of Step-Rate Tests},
  author={Mugisha, J. and Shchipanov, A. Midtb{\o} {\O}verland, A. Starikov, V. and Muradov, K.},
  booktitle={Paper presented at the SPE Europe Energy Conference and Exhibition},
  address={Istanbul, Turkey},
  year={2026},
  month={June},
  number={SPE-233202-MS},
  organization={Society of Petroleum Engineers},
  doi={10.2118/233202-MS},
  url={https://doi.org/10.2118/233202-MS}
}

Acknowledgements

This research code was developed within the following projects:

  • AutoWell research and development project funded by the Research Council of Norway and the industry partners including ConocoPhillips Skandinavia AS, Sumitomo Corporation Europe Norway Branch, Harbour Energy Norge AS and Aker BP ASA (grant no. 326580, PETROMAKS2 programme).
  • AutoWell Phase 2, a joint industry research and development project funded by ConocoPhillips Skandinavia AS, Aker BP ASA, Harbour Energy Norge AS and TotalEnergies EP Norge AS.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Metadata

Release files for pta-learn 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pta-learn 1.1.0
File Size Uploaded
pta_learn-1.1.0.tar.gz 220.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pta-learn 1.1.0
File Interpreter ABI Platform
pta_learn-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 276.8 kB

Release files / pta_learn-1.1.0.tar.gz

Download URL pta_learn-1.1.0.tar.gz
Size 220.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2dedc1b3580ad2dfe42ea427da498b98051fc6827d6f778b2a5d69bbe670fca4
BLAKE2b-256 checksum
How to use checksums
3303a883a723026a06d3f97b5f7563a9fea0fb1b0a078eca62028fac3b2013d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

Release files / pta_learn-1.1.0-py3-none-any.whl

Download URL pta_learn-1.1.0-py3-none-any.whl
Size 56.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4b0001dd2057e3aadcbaeafbe6633052d50181538cff7dff784f009227484508
BLAKE2b-256 checksum
How to use checksums
0c491ff6541aaf585b0abcd70157647bc027e50760c507e40afd8983f6b3df6a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.13

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page