bgd

Loading a wellbore trajectory

well_profile.load(data, **kwargs)[source]

Load an existing wellpath.

Parameters

data – Excel file, dataframe or list of dictionaries. Must contain at least md, inclination and azimuth. Can also contain tvd, northing and easting.

Keyword Arguments
  • set_start (dict, None) – set initial point in m {‘north’: 0, ‘east’: 0}.

  • change_azimuth (float, int, None) – add specific degrees to azimuth values along the entire well.

  • set_info (dict, None) – dict, {‘dlsResolution’, ‘wellType’: ‘onshore’|’offshore’, ‘units’: ‘metric’|’english’}.

  • inner_pts (num) – include certain amount of inner points between survey stations.

Returns

well – A wellpath object with 3D position

Return type

well object

Load excel file

Example of a file is shown below. In case TVD is not included, the package calculates the values using the minimum curvature method. North and East coordinates also can be included.

excel_data

>>> import well_profile as wp
>>> well = wp.load('trajectory1.xlsx',   # loading excel file
>>>               set_info={'dlsResolution': 30, 'wellType': 'offshore', 'units': 'metric'},
>>>               # (optional) define the resolution for dls calculation, well type and system of units 'metric'
>>>               # for meters or 'english' for feet
>>>               set_start={'north': 0, 'east': 0, 'depth': 0})  # (optional) set the location of initial point
>>> well.plot(names=['loaded from excel']).show()

load_excel

Load csv file

>>> import well_profile as wp           # loading csv file
>>> well = wp.load('trajectory1.csv',   # define target depth (md) in m or ft
>>>               set_info={'dlsResolution': 30, 'wellType': 'offshore', 'units': 'metric'},
>>>               # (optional) define the resolution for dls calculation, well type and system of units 'metric'
>>>               # for meters or 'english' for feet
>>>               set_start={'north': 0, 'east': 0, 'depth': 0})  # (optional) set the location of initial point
>>> well.plot(names=['loaded from csv']).show()

load_csv

Generate more data points from survey

With well_profile you can generate multiple data points between the survey stations by using the argument inner_points.

>>> import well_profile as wp
>>> well = wp.load('trajectory1.xlsx')   # loading file with only original survey points
>>> well.plot(style={'color': 'dls'}).show()

inner_pts0

>>> import well_profile as wp
>>> well = wp.load('trajectory1.xlsx', inner_points=5)   # loading file with only original survey points
>>> well.plot(style={'color': 'dls'}).show()

inner_pts1