Skip to main content

Well Temperature Distribution

Project description




Pwptemp is a small LGPL licensed library for easy calculation of the temperature distribution along the well. Features are added as they are needed; suggestions and contributions of all kinds are very welcome.

To catch up on the latest development and features, see the changelog.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Get pwptemp

  • Wheels for Python from PyPI
    • pip install pwptemp
  • Source code from github
    • git clone

Code Distribution

The code is compound different files as follows: â–· contains a function to define the MD, and TVD values from the wellpath. â–· creates a class (WellTemperature) to have access to the parameters of the case. â–· defines the initial and boundary conditions. â–· contains a function to calculate the coefficients for the heat tranfer equations that will be used. â–· contains a function to generate the entire temperature profile. â–· contains a function to plot Tfm, Ta(bottom), Ta(outlet) vs time. And another function to plot the temperature profile. â–· contains a function to determine the temperature profile at any time and another function to calculate for the stabilization time.


Around 43 data inputs (such as depths, diameters, temperatures, densities and operation parameters) are involved in pwptemp. However default values are provided in order to only change the parameters that the user wants to load.


Pwptemp allows users to count with heat data for different sections of a well and also to calculate the temperature values at certain circulation times (drilling operation).

Temperature of the fluid inside the Drill String (Tdsi)
Temperature of the Drill String Wall (Tds)
Temperature of the fluid inside the Annular (Ta)
Temperature of the Casing (Tcsg)
Temperature of the Riser (Tr)
Temperature of the Surrounding Space (Tsr)
Temperature of the Formation (Tfm)


Note 1: Above seabed, casing section is replaced with the riser and surrounding space would be sea water.

Note 2: Beyond the 'undisturbed formation zone' the temperature keeps constant (Tfm).

Distribution Scheme


Please read CONTRIBUTING for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the tags on this repository.


See also the list of contributors who participated in this project.


Pwptemp was initially written and is maintained by Pro Well plan AS as a free, simple, easy-to-use way of getting temperature data that can be tailored to our needs, and as contribution to the free software community.


This project is licensed under the GNU Lesser General Public License v3.0 - see the LICENSE file for details

Project details

Download files

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

Files for pwptemp, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size pwptemp-0.0.4-py3-none-any.whl (14.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pwptemp-0.0.4.tar.gz (11.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page