petrodc - petroleum data collector

Version License

Find here the documentation of petrodc. Here you will find all the relevant information about any function included in this package.

Installation

petrodc is written to be compatible with Python 3+. The best way to install is using pip.

$ pip install pwploads

This will make sure that all the dependencies are installed. This requirements are listed below.

Topo-bathymetry data

petrodc.usgs_eros.elevation(lat=(40, 41), lon=(- 65, - 60))[source]

Function to request data from SRTM30. Bathymetry / Topography (SRTM30) is a global bathymetry/topography data product distributed by the USGS EROS data center. The data product has a resolution of 30 seconds (roughly 1 km).

Keyword Arguments

  • lat (tuple) – with min and max latitude

  • lon (tuple) – with min and max longitude

Returns

ElevationSurface object.

  • Attributes:

    df (pandas dataframe): lat, lon and elev columns

  • Methods:

    plot: generate a 3D surface plot

Example

Let’s select an squared area within the following coordinates:

  • Latitude from 56° to 56.5°

  • Longitude from 4° to 4.5°

>>> import petrodc.usgs_eros as elev
>>> lat_min = 56
>>> lat_max = 56.5
>>> lon_min = 4
>>> lon_max = 4.5
>>> elev_surface = elev.elevation(lat=(lat_min, lat_max), lon=(lon_min, lon_max)).plot().show()

elevation_surface

Web Application

There is also the web-app based on petrodc:

Athabasca well logs

petrodc.ags.get_las(number_of_files)[source]

Function to get well logs data as dataframes from Special Report 006 Athabasca Oil Sands Data McMurray/Wabiskaw Oil Sands Deposit (Alberta, Canada). By Alberta Geological Survey (AGS).

Parameters

number_of_files (int) – number of files to get, max. of 2173

Returns

data

Return type

dictionary {key -> ‘Unique well identifier’, value -> dataframe}

petrodc.ags.plot_log(logs, title=None)[source]

Function to plot well logs data using matplotlib.

Parameters

logs (dataframe) – each log is a column

Keyword Arguments

title (str or None) – text to add as title if required

Returns

plot

Return type

plotly figure

Example

>>> import petrodc.ags as ags
>>> las_files = ags.get_las(2)      # fetch the first 2 well logs from the Special Report 006 Athabasca Oil Sands Data
>>> my_las = list(las_files.values())[1]        # get its respective df from dict
>>> ags.plot_log(my_las).show()     # plotting logs

well-log

Web Application

There is also the web-app based on petrodc:

Norwegian Wellbore Data

petrodc.npd.wellbore(dataset_number)[source]

Function to request wellbore data from NPD Database.

Parameters

dataset_number (int) – to select the dataset (1: oil samples, 2: NPD ID, 3: lithostratigraphy, 4: history, 5: drilling mud, 6: drill stem tests, 7: documents, 8: cores, 9: core photos, 10: coordinates, 11: casing and leak off, 12: exploration, 13: development, 14: shallow)

Returns

requested data

Return type

dataframe

Example

>>> import petrodc.npd as npd
>>> data = npd.wellbore(11)     # load dataset 11 - casing and leak off

npd_data

Web Application

There is also the web-app based on petrodc:

About Pro Well Plan

Pro Well Plan offers an easy and effective well planning platform for the entire team. Check out our website to know more about us.